Re: [PATCH 2/3] ls-remote: remove documentation for custom -h option

From: Jeff King <peff@peff.net>
Date: Sep 24, 2021, 17:54 UTC
Message-ID: <YU4QxcORBBR01iV8@coredump.intra.peff.net>
In-Reply-To: <20210924171113.GA3311029@szeder.dev>

On Fri, Sep 24, 2021 at 07:11:13PM +0200, SZEDER Gábor wrote:

Show 14 quoted lines

> > diff --git a/Documentation/git-ls-remote.txt b/Documentation/git-ls-remote.txt
> > index 492e573856f..6e241640bd9 100644
> > --- a/Documentation/git-ls-remote.txt
> > +++ b/Documentation/git-ls-remote.txt
> > @@ -21,7 +21,6 @@ commit IDs.
> >  
> >  OPTIONS
> >  -------
> > --h::
> 
> The description of this option contains the following:
> 
>   Note that git ls-remote -h used without anything else on the command
>   line gives help, consistent with other git subcommands.

Yup. That comes from this thread discussing an identical patch:

  https://lore.kernel.org/git/b0397b3285eab3448a3fd5dd2c50abb9@pascalroeleven.nl/

which in turn references more discussion of this behavior:

  https://lore.kernel.org/git/xmqqk1ztmkbn.fsf@gitster.mtv.corp.google.com/

It's gross and weird, but kept for backwards compatibility.

-Peff