Re: Custom subcommand help handlers

From: Sean Allred <allred.sean@gmail.com>
Date: Feb 12, 2022, 22:23 UTC
Message-ID: <87tud3wwlx.fsf@gmail.com>
In-Reply-To: <nycvar.QRO.7.76.6.2112202324110.347@tvgsbejvaqbjf.bet>

> I think you might need to be a bit more careful than just looking whether
> the command in question is a built-in or not. It could be delivered as a
> script or executable inside `libexec/git-core`.

I apologize, yes -- I used 'built-in' as a synonym for 'distributed with Git', but this of course is not how this project uses the term :-)

Show 6 quoted lines

> Of course, this might break existing users' setups where they ship a Git
> command together with a manual page.
>
> A potential remedy against that would be, as you say, a config option.
> Maybe defaulting to the manual page if `help.format` is `man`, otherwise
> defaulting to passing `--help` to the command.

It's worth noting that Git for Windows does not distribute a manpage-viewer :-(

-- Sean Allred