build-parallel: Rename --jobs option to --max-workers to avoid conflict

The --jobs option in the build-parallel command conflicted with the
main program's option of the same name. This change renames the
option to --max-workers (short form -m) and updates all references
and help text accordingly, ensuring clear and unambiguous usage for
users.

Signed-off-by: Doug Hellmann <dhellmann@redhat.com>

Author: dhellmann

src/fromager/commands/build.py

@@ -500,11 +500,11 @@ def _build_parallel(
     help="url to a wheel server from where fromager can check if it had already built the wheel",
 )
 @click.option(
-    "-j",
-    "--jobs",
+    "-m",
+    "--max-workers",
     type=int,
     default=None,
-    help="number of parallel jobs to run (default: unlimited)",
+    help="maximum number of parallel workers to run (default: unlimited)",
 )
 @click.argument("graph_file")
 @click.pass_obj
@@ -513,7 +513,7 @@ def build_parallel(
     graph_file: str,
     force: bool,
     cache_wheel_server_url: str | None,
-    jobs: int | None,
+    max_workers: int | None,
 ) -> None:
     """Build wheels in parallel based on a dependency graph
 
@@ -522,7 +522,7 @@ def build_parallel(
     Performs parallel builds of wheels based on their dependency relationships.
     Packages that have no dependencies or whose dependencies are already built
     can be built concurrently. By default, all possible packages are built in
-    parallel. Use --jobs to limit the number of concurrent builds.
+    parallel. Use --max-workers to limit the number of concurrent builds.
 
     """
     wkctx.enable_parallel_builds()
@@ -594,8 +594,10 @@ def build_parallel(
                 ", ".join(n.canonicalized_name for n in buildable_nodes),
             )
 
-            # Build up to jobs nodes concurrently (or all if jobs is None)
-            with concurrent.futures.ThreadPoolExecutor(max_workers=jobs) as executor:
+            # Build up to max_workers nodes concurrently (or all if max_workers is None)
+            with concurrent.futures.ThreadPoolExecutor(
+                max_workers=max_workers
+            ) as executor:
                 futures = []
                 for node in buildable_nodes:
                     req = Requirement(f"{node.canonicalized_name}=={node.version}")