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

Re: Why are there multiple ways to get the manual in Git?

From
Philip Oakley <philipoakley@iee.org>
Date
Sep 18, 2016, 10:51 UTC
Message-ID
<630656BFF8F84E43A2E4C67138A9A675@PhilipOakley>
In-Reply-To
<223e818d-6d10-2679-c2d0-150011e74a59@gmail.com>
From: "Jakub Narębski" <jnareb@gmail.com>
Show 32 quoted lines
>W dniu 17.09.2016 o 20:39, Fredrik Gustafsson pisze:
>> On Sat, Sep 17, 2016 at 01:47:52PM -0400, Andrew Johnson wrote:
>
>>> $ git help <verb>
>>> $ git <verb> --help
>>> $ man git-<verb>
>>>
>>> I tested all three to confirm they were equivalent.
>>
>> While I'm not able to answer your question, I can shred a little light
>> about them not being equal. For example using a windows machine
>>
>> $ man git-<verb>
>>
>> does not work and
>>
>> $ git help <verb>
>>
>> opens a webbrowser instead of a man page. Using a unix system I would
>> however assume that
>>
>> $ man git-<verb>
>>
>> would work since it's the standard way of getting help on those systems.
>
> There is also additional difference.  There are help pages which are
> not about specific Git command, but about concepts (gitcli, gitrevisions,
> githooks, gitrepository-layout, gitglossary), or about files (gitignore,
> gitattributes, to some extent githooks).
>
> Those are only accessible with `git help <concept>` or, on OS with
> installed 'man', also `man <gitconcept>`.

The `git revisions --help` does work ;-) But like you say, its apparent "command" name is 'gitrevisions'.

Thus real commands gave a git-command name, while concepts have a gitconcept name which can then be found via the man command.

-- Philip

Previous: Jakub NarębskiNext: Junio C Hamano
Message 6 of 8 in “Why are there multiple ways to get the manual in Git?”
  1. Andrew JohnsonSep 17, 2016
  2. Fredrik GustafssonSep 17, 2016
  3. Philip OakleySep 17, 2016
  4. Christian CouderSep 17, 2016
  5. Jakub NarębskiSep 18, 2016
  6. Philip OakleySep 18, 2016
  7. Junio C HamanoSep 19, 2016
  8. Philip OakleySep 19, 2016

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.