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

Re: git glossary --help ?

From
Duy Nguyen <pclouds@gmail.com>
Date
Apr 7, 2019, 03:20 UTC
Message-ID
<CACsJy8DE4WfbU2y8+__4qD7V5FLodKjxX-bu+seE8mh65q8FYQ@mail.gmail.com>
In-Reply-To
<05e6a0ad-36ea-e594-f253-ded3e5392375@iee.org>
On Sun, Apr 7, 2019 at 12:31 AM Philip Oakley <philipoakley@iee.org> wrote:
Show 18 quoted lines
>
> Following the discussions about the tag peeling issue, I thought to have
> a look at what the git glossary says.
>
> I had it in my head that when the git guides were linked to the help
> system, that the --help option provided a short circuit direct to help
> item. However this did not happen.
>
> I found that the capability had been lost, which given that a lot of the
> underpinning knowledge is in the guides this would appear to be a loss.
>
> I don't have an older version to test, but I thought I remember the
> capability from about the time of my 65f98358c0 ("builtin/help.c: add
> --guide option", 2013-04-02).
>
> Have I misremembered the --help capability?
>
> cc'ing Duy in case he remembers something from the recent update
Phew... I didn't break anything!

That behavior has been gone since 2c6b6d9f7d (help: make option --help open man pages only for Git commands, 2016-08-26). Ralf did not mention why he thought "git <concept> --help" was a bad idea. But it was considered a bug by Junio [1]

[1] https://public-inbox.org/git/CAPc5daXicjUDi6B-MA8Sn=_UZ_jHvc8SE4ZXt2dHbbDQkD7=WA@mail.gmail.com/
-- 
Duy
Previous: Philip OakleyNext: Philip Oakley
Message 4 of 8 in “git glossary --help ?”
  1. Philip OakleyApr 6, 2019
  2. Andreas SchwabApr 6, 2019
  3. Philip OakleyApr 6, 2019
  4. Duy NguyenApr 7, 2019
  5. Philip OakleyApr 7, 2019
  6. Junio C HamanoApr 7, 2019
  7. Philip OakleyApr 7, 2019
  8. Junio C HamanoApr 8, 2019

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.