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

Re: [PATCH] git-clone.txt: document -4 and -6

From
Taylor Blau <me@ttaylorr.com>
Date
Jan 2, 2024, 22:25 UTC
Message-ID
<ZZSNRk6W7VC23LaC@nand.local>
In-Reply-To
<xmqqr0izcrfm.fsf@gitster.g>
On Tue, Jan 02, 2024 at 02:15:57PM -0800, Junio C Hamano wrote:
Show 20 quoted lines
> Taylor Blau <me@ttaylorr.com> writes:
>
> > Note that the 'clone' and 'fetch' versions for many of these options
> > have different wording. For example, in Documentation/git-clone.txt we
> > have:
> >
> >     -j::
> >     --jobs=<n>::
> >            Number of parallel children to be used for all forms of fetching.
> >
> > Whereas the description in the original fetch-options.txt is more
> > verbose.
>
> Yes, so it will be impossible to unify without changing the
> resulting text.  But unless one description is clearly better for
> one subcommand while the other description is also clearly better
> for the other subcommand, we should be able to pick a better one
> that would serve both subcommands, and that way we would improve
> description for one subcommand while keeping the other one the same,
> right?

Right. I meant to illustrate merely that this would probably involve some word-smithing instead of just pure cut-and-paste, so that it may not be worth the effort.

Thanks, Taylor

Previous: Junio C Hamano
Message 7 of 7 in “git-clone.txt: document -4 and -6”
  1. git-clone.txt: document -4 and -6Jakub Wilk, May 27, 2023
  2. Junio C HamanoJun 1, 2023
  3. Jakub WilkJan 2, 2024
  4. Taylor BlauJan 2, 2024
  5. Taylor BlauJan 2, 2024
  6. Junio C HamanoJan 2, 2024
  7. Taylor BlauJan 2, 2024

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.