Re: Custom subcommand help handlers

[Philip Oakley <philipoakley@iee.email>]

On 24/12/2021 00:16, Junio C Hamano wrote:
> Philip Oakley <philipoakley@iee.email> writes:
>
>> They had the issue that their windows users, using Git for Windows, do
>> not have the `man` package installed. Rather the `web` help of using the
>> .html version of the man page is used (needs administrator install in
>> some case). So user commands would need to provide both the man page for
>> Linux systems and some process to get the html equivalent into the right
>> folder - this latter case was the problem step.
> So are they willing to prepare `web` help pages, because that is
> what the users of Git for Windows are already familiar with, if "git
> foo --help" is capable of showing it, just like "git commit --help"
> shows the `web` help page for the subcommand?
>
> As I said elsewhere on this thread, lack of equivalent for MANPATH
> and INFOPATH makes `web` help harder to customize in that direction,
> but that is a problem we can solve in our code.  Once it is there,
> they can let the user install their `web` help pages into somewhere
> the user has write access to and point at the "folder" with
> GIT_HTMLPATH, I would presume?
>
> Thanks.
>
I'm not sure if they are willing to create web versions of the man page
or not. The request was that we should let their code decide by passing
the --help option so they could link out to whatever process they have -
maybe it's a SharePoint server with fancy presentations (I never liked
them, but many places have drunk the cool aid).

Having an alternate GIT_HTMLPATH could help some users who do have html
documents, but I was cautious about letting ourselves over automate the
mechanisation and still leave the users out of the picture.

Hopefully Sean will be able to clarify if I've misunderstood the details
of their problems.

Philip
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>