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

Re: git help user-manual looks for incorrect filename

From
D. Ben Knoble <ben.knoble@gmail.com>
Date
Oct 15, 2026, 16:58 UTC
Message-ID
<CALnO6CAoVsrp7UFSZLjTtYm3x6rzML72-3hUE9dtGorVb4JLyQ@mail.gmail.com>
In-Reply-To
<VI0PR05MB12991467F7BD29308AE8D5F4ED09C2@VI0PR05MB12991.eurprd05.prod.outlook.com>
Hi John
On Thu, Oct 15, 2026 at 3:50 AM John Wilson <jwilso3@ed.ac.uk> wrote:
Show 15 quoted lines
>
> Hi,
>
> I would like to raise this issue, as suggested when I erroneously posted on the git-for-windows repo (https://github.com/git-for-windows/git/issues/6466)
>
> ## Issue
>
> On Git for Windows git help user-manual looks for the wrong file.
> Git looks for gituser-manual.html, instead of user-manual.html.
>
> The Git User's Manual is installed as:
> `C:\Program Files\Git\mingw64\share\doc\git-doc\user-manual.html`
>
> However, git help user-manual fails with:
> `fatal: 'C:/Program Files/Git/mingw64/share/doc/git-doc/gituser-manual.html': documentation file not found.`

I don't think "git help" actually knows about the user-manual, surprisingly. It's not in the list of "git help --guides".

You can do something like "xdg-open $(git --html-path)/user-manual.html" (macOS: open; Windows: ???), but that's not very easy to discover.

You can of course also access versions of that manual on https://git-scm.com/ and http://git.github.io/htmldocs/.

Still, I've been wondering for a while about extending "git help" to access more of the documents installed in --html-path…

[later]

Ok, in this specific case, "git help --guides" lists whatever it can find from the compile-time built command-list.h with CAT_guide (so we could make that generator create an entry for the user manual?). But when it comes to actually opening a document, we process the command line through cmd_to_page() which adds the "git" prefix as a fallback path. So any document in "git --html-path" that doesn't start with "git" has to be opened in the rather obtuse workaround way I mentioned earlier.

Hm.
-- 
D. Ben Knoble
Previous: John WilsonNext: Junio C Hamano
Message 2 of 3 in “git help user-manual looks for incorrect filename”
  1. John WilsonOct 15, 2026
  2. D. Ben KnobleOct 15, 2026
  3. Junio C HamanoOct 15, 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.