Re: git help user-manual looks for incorrect filename

[Junio C Hamano <gitster@pobox.com>]

John Wilson <jwilso3@ed.ac.uk> writes:

> 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.`

Thanks for reporting.  I can see that this is not GfW specific.

    $ git help --guides
    The Git concept guides are:
       core-tutorial    A Git core tutorial for developers
       credentials      Providing usernames and passwords to Git
       cvs-migration    Git for CVS users
       datamodel        Git's core data model
       diffcore         Tweaking diff output
       everyday         A useful minimum set of commands for Everyday Git
       faq              Frequently asked questions about using Git
       glossary         A Git Glossary
       namespaces       Git namespaces
       remote-helpers   Helper programs to interact with remote repositories
       submodules       Mounting one repository inside another
       tutorial         A tutorial introduction to Git
       tutorial-2       A tutorial introduction to Git: part two
       workflows        An overview of recommended workflows with Git

    'git help -a' and 'git help -g' list available subcommands and some
    concept guides. See 'git help <command>' or 'git help <concept>'
    to read about a specific subcommand or concept.
    See 'git help git' for an overview of the system.

Any of the documents that are listed above can be seen correctly

    $ git help -w everyday

But user-manual is not even listed among the above.

A few things probably needs to happen.

 * user-manual and any other "missing" documents need to be
   identified and added to the above list of --guides.

 * any of these "missing" documents are not installed with "git"
   prefix (e.g., "user-manual" becomes "gituser-manual"), their
   install path may need to be adjusted.  The old paths for them
   may also need to be retained if users have been accessing them
   via the old pathnames.