Re: How do Git on Linux users launch/read the user-manual?

Philip Oakley [off-list ref] writes:

quoted

Or are you asking something else?

I was more coming at the question from the other direction, that is,
about accessing, normally, the git manuals, and discovering the desired
information, both for existing and new users.

In your example, you needed to include the extra -w option, specific to
this 'special' manual, while all the other hundreds of man pages would
be accessed without it (even on Windows, as the config is set by default).

For those who have help.format set to html, it is no "extra" thing
required.  I said "git help -w" so that people would understand what
I meant regardless of their personal settings are.

Or are you saying that nobody on Linux uses the html format?  I
should stop keeping the git-htmldocs.git repository up to date,
if that is the case, but I suspect it is not.

We do have the advised `git help -g` to list the concept guides, but
that doesn't advise about the user-manual, which surely we should
mention to those asking for help (without them needing a long journey of
discovery). The list does include `git everyday`...

I appreciate that, for some, there is a view that new users are other
peoples problems and that knowledgable users already know, roughly,
which command they wish to use and thus then peruse the appropriate
reference manual to confirm the correct form for their command. I'd
rather we direct uncertain users to their appropriate guide quickly,
using their expected viewer method. Hence the question.

Or are you volunteering to update the mark-up (if necessary) so that
user-manual would become part of "man" ("man git-user-manual",
perhaps) suite?  That would be an excellent suggestion.

Whatever proposal/volunteering comes from you after your question is
answered would be quite interesting.  Hopefully that would be one
that is beneficial to the project as a whoel ;-)

Thanks.