{"thread":{"id":"66541","subject":"git help user-manual looks for incorrect filename","startedAt":"2026-10-15T07:17:03Z","lastAt":"2026-10-15T18:20:59Z","messageCount":3,"participants":["John Wilson","D. Ben Knoble","Junio C Hamano"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"555117","messageId":"VI0PR05MB12991467F7BD29308AE8D5F4ED09C2@VI0PR05MB12991.eurprd05.prod.outlook.com","threadId":"66541","inReplyTo":null,"subject":"git help user-manual looks for incorrect filename","fromName":"John Wilson","fromEmail":"jwilso3@ed.ac.uk","sentAt":"2026-10-15T07:17:03Z","receivedAt":"2026-10-15T07:17:03Z","isPatch":false,"sender":{"key":"jwilso3@ed.ac.uk","avatar":null},"body":"Hi,\n\nI 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)\n\n## Issue\n\nOn Git for Windows git help user-manual looks for the wrong file.\nGit looks for gituser-manual.html, instead of user-manual.html.\n\nThe Git User's Manual is installed as:\n`C:\\Program Files\\Git\\mingw64\\share\\doc\\git-doc\\user-manual.html`\n\nHowever, git help user-manual fails with:\n`fatal: 'C:/Program Files/Git/mingw64/share/doc/git-doc/gituser-manual.html': documentation file not found.`\n\n## Actual behaviour\n\n$ git help user-manual\nfatal: 'C:/Program Files/Git/mingw64/share/doc/git-doc/gituser-manual.html': documentation file not found.\n\nMany thanks,\n\nJohn\nThe University of Edinburgh is a charitable body, registered in Scotland, with registration number SC005336. Is e buidheann carthannais a th’ ann an Oilthigh Dhùn Èideann, clàraichte an Alba, àireamh clàraidh SC005336.\n"},{"id":"555162","messageId":"CALnO6CAoVsrp7UFSZLjTtYm3x6rzML72-3hUE9dtGorVb4JLyQ@mail.gmail.com","threadId":"66541","inReplyTo":"VI0PR05MB12991467F7BD29308AE8D5F4ED09C2@VI0PR05MB12991.eurprd05.prod.outlook.com","subject":"Re: git help user-manual looks for incorrect filename","fromName":"D. Ben Knoble","fromEmail":"ben.knoble@gmail.com","sentAt":"2026-10-15T16:58:27Z","receivedAt":"2026-10-15T16:58:27Z","isPatch":false,"sender":{"key":"ben.knoble@gmail.com","avatar":"https://avatars.githubusercontent.com/u/22802209?v=4"},"body":"Hi John\n\nOn Thu, Oct 15, 2026 at 3:50 AM John Wilson <jwilso3@ed.ac.uk> wrote:\n>\n> Hi,\n>\n> 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)\n>\n> ## Issue\n>\n> On Git for Windows git help user-manual looks for the wrong file.\n> Git looks for gituser-manual.html, instead of user-manual.html.\n>\n> The Git User's Manual is installed as:\n> `C:\\Program Files\\Git\\mingw64\\share\\doc\\git-doc\\user-manual.html`\n>\n> However, git help user-manual fails with:\n> `fatal: 'C:/Program Files/Git/mingw64/share/doc/git-doc/gituser-manual.html': documentation file not found.`\n\nI don't think \"git help\" actually knows about the user-manual,\nsurprisingly. It's not in the list of \"git help --guides\".\n\nYou can do something like \"xdg-open $(git\n--html-path)/user-manual.html\" (macOS: open; Windows: ???), but that's\nnot very easy to discover.\n\nYou can of course also access versions of that manual on\nhttps://git-scm.com/ and http://git.github.io/htmldocs/.\n\nStill, I've been wondering for a while about extending \"git help\" to\naccess more of the documents installed in --html-path…\n\n[later]\n\nOk, in this specific case, \"git help --guides\" lists whatever it can\nfind from the compile-time built command-list.h with CAT_guide (so we\ncould make that generator create an entry for the user manual?). But\nwhen it comes to actually opening a document, we process the command\nline through cmd_to_page() which adds the \"git\" prefix as a fallback\npath. So any document in \"git --html-path\" that doesn't start with\n\"git\" has to be opened in the rather obtuse workaround way I mentioned\nearlier.\n\nHm.\n\n-- \nD. Ben Knoble\n\n"},{"id":"555181","messageId":"xmqqzewen7uc.fsf@gitster.g","threadId":"66541","inReplyTo":"VI0PR05MB12991467F7BD29308AE8D5F4ED09C2@VI0PR05MB12991.eurprd05.prod.outlook.com","subject":"Re: git help user-manual looks for incorrect filename","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2026-10-15T18:20:59Z","receivedAt":"2026-10-15T18:20:59Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"John Wilson <jwilso3@ed.ac.uk> writes:\n\n> Hi,\n>\n> I would like to raise this issue, as suggested when I erroneously\n> posted on the git-for-windows repo\n> (https://github.com/git-for-windows/git/issues/6466)\n>\n> ## Issue\n>\n> On Git for Windows git help user-manual looks for the wrong file.\n> Git looks for gituser-manual.html, instead of user-manual.html.\n>\n> The Git User's Manual is installed as:\n> `C:\\Program Files\\Git\\mingw64\\share\\doc\\git-doc\\user-manual.html`\n>\n> However, git help user-manual fails with: `fatal: 'C:/Program\n> Files/Git/mingw64/share/doc/git-doc/gituser-manual.html':\n> documentation file not found.`\n\nThanks for reporting.  I can see that this is not GfW specific.\n\n    $ git help --guides\n    The Git concept guides are:\n       core-tutorial    A Git core tutorial for developers\n       credentials      Providing usernames and passwords to Git\n       cvs-migration    Git for CVS users\n       datamodel        Git's core data model\n       diffcore         Tweaking diff output\n       everyday         A useful minimum set of commands for Everyday Git\n       faq              Frequently asked questions about using Git\n       glossary         A Git Glossary\n       namespaces       Git namespaces\n       remote-helpers   Helper programs to interact with remote repositories\n       submodules       Mounting one repository inside another\n       tutorial         A tutorial introduction to Git\n       tutorial-2       A tutorial introduction to Git: part two\n       workflows        An overview of recommended workflows with Git\n\n    'git help -a' and 'git help -g' list available subcommands and some\n    concept guides. See 'git help <command>' or 'git help <concept>'\n    to read about a specific subcommand or concept.\n    See 'git help git' for an overview of the system.\n\nAny of the documents that are listed above can be seen correctly\n\n    $ git help -w everyday\n\nBut user-manual is not even listed among the above.\n\nA few things probably needs to happen.\n\n * user-manual and any other \"missing\" documents need to be\n   identified and added to the above list of --guides.\n\n * any of these \"missing\" documents are not installed with \"git\"\n   prefix (e.g., \"user-manual\" becomes \"gituser-manual\"), their\n   install path may need to be adjusted.  The old paths for them\n   may also need to be retained if users have been accessing them\n   via the old pathnames.\n\n\n\n"}]}