git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] doc: fetch: document `--jobs=0` behavior

From
Junio C Hamano <gitster@pobox.com>
Date
Feb 19, 2026, 17:38 UTC
Message-ID
<xmqq342w7hx2.fsf@gitster.g>
In-Reply-To
<pull.2047.git.1771443159369.gitgitgadget@gmail.com>
"Daniel D. Beck via GitGitGadget" <gitgitgadget@gmail.com> writes:
Show 7 quoted lines
> From: "Daniel D. Beck" <daniel@ddbeck.com>
>
> In c39952b92 (fetch: choose a sensible default with --jobs=0 again,
> 2023-02-20), the `--jobs=0` behavior was (re)introduced, but it went
> undocumented. Since this is the same behavior as `git -c fetch.parallel=0
> fetch`, which is documented, this change creates symmetry between the two
> documentation sections.

Makes sense. In hindsight, we might have been better off if we also called this "--jobs=auto", but documenting the behaviour is a good first step.

Will queue.  Thanks.
Show 27 quoted lines
>
> Signed-off-by: Daniel D. Beck <daniel@ddbeck.com>
> ---
>     doc: fetch: document --jobs=0 behavior
>
> Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-2047%2Fddbeck%2Fdoc-git-fetch-jobs-0-v1
> Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-2047/ddbeck/doc-git-fetch-jobs-0-v1
> Pull-Request: https://github.com/gitgitgadget/git/pull/2047
>
>  Documentation/fetch-options.adoc | 2 ++
>  1 file changed, 2 insertions(+)
>
> diff --git a/Documentation/fetch-options.adoc b/Documentation/fetch-options.adoc
> index fcba46ee9e..e15cbc51f2 100644
> --- a/Documentation/fetch-options.adoc
> +++ b/Documentation/fetch-options.adoc
> @@ -234,6 +234,8 @@ endif::git-pull[]
>  `--jobs=<n>`::
>  	Parallelize all forms of fetching up to _<n>_ jobs at a time.
>  +
> +A value of 0 will use some reasonable default.
> ++
>  If the `--multiple` option was specified, the different remotes will be fetched
>  in parallel. If multiple submodules are fetched, they will be fetched in
>  parallel. To control them independently, use the config settings
>
> base-commit: 852829b3dd2fe4e7c7fc4d8badde644cf1b66c74
Previous: Junio C Hamano
Message 8 of 8 in “doc: fetch: document `--jobs=0` behavior”
  1. doc: fetch: document `--jobs=0` behaviorDaniel D. Beck via GitGitGadget, Feb 18, 2026
  2. Patrick SteinhardtFeb 19, 2026
  3. Junio C HamanoFeb 19, 2026
  4. Patrick SteinhardtFeb 20, 2026
  5. Daniel BeckFeb 24, 2026
  6. Johannes SchindelinMar 2, 2026
  7. Junio C HamanoMar 2, 2026
  8. Junio C HamanoFeb 19, 2026

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.