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

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

From
Patrick Steinhardt <ps@pks.im>
Date
Feb 20, 2026, 08:51 UTC
Message-ID
<aZggm7R-4VohiCYm@pks.im>
In-Reply-To
<xmqq4inc5zlt.fsf@gitster.g>
On Thu, Feb 19, 2026 at 10:59:10AM -0800, Junio C Hamano wrote:
Show 26 quoted lines
> Patrick Steinhardt <ps@pks.im> writes:
> 
> > On Wed, Feb 18, 2026 at 07:32:39PM +0000, Daniel D. Beck via GitGitGadget wrote:
> >> 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.
> >
> > Can't we do better though than saying "some reasonable default"? As a
> > user I would wonder what this is even supposed to mean. True, we don't
> > do so either in the documentation of "fetch.parallel". But arguably, we
> > should update both sites to reflect the status quo.
> >
> > Going into the code we seem to fall back to `online_cpus()`. So should
> > we document this accordingly?
> 
> I do not have time to dig this out myself from ancient discussion
> threads, but we probably had the same discussion when "git config
> --help" described the fetch.parallel with exactly the same phrasing
> and decided to leave the exact implementation detail out of the
> end-user facing documentation.

Doesn't look like it. The thread in question is [1], and neither the commit message nor the discussion around the patch mentioned why we don't document what the reasonable default is.

Dscho, do you remember by chance why you decided to not be more specific here?

Thanks!
Patrick
[1]: <pull.369.git.gitgitgadget@gmail.com>
Previous: Junio C HamanoNext: Daniel Beck
Message 4 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.