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