Re: help2man: minor change request for coreutils

[Jim Meyering]

"Brendan O'Dea" <address@hidden> wrote:

> On Tue, Nov 23, 2004 at 11:57:15PM +0100, Jim Meyering wrote:
>>It's an odd situation, since test doesn't support --help or --version,
>>but the alternate-name for that code is `[', which does accept
>>those options.
>
> Odd indeed.
>
>>I hesitated to request it, thinking this may be the only
>>case in which it's needed, but who knows...
>
> Rather than another option, attached is an alternative I'd prefer.  If
> this suits I'll apply/upload when I get home.
>
> The idea is to override $program from the NAME paragraph given in your
> include files, so if test.x contains either of:
>
>   test \- check file types and compare values
>   test, [ \- check file types and compare values
>
> You'll end up with "test", even if the program was invoked as "[".

Thanks for the quick work!

> I checked all of the help2man generated pages under /usr/share/man/man1
> and came up with the following list affected by this change:
>
>     install.1         install         ginstall
>     test.1            [               test
>     texi2dvi4a2ps.1   texi2dvi        texi2dvi4a2ps
>     psset.1           psset           psmandup
>
> Columns are:  the page, current value of $program (as pulled from .TH)
> and what will be used with this change given the contents of the NAME
> paragraph.
>
> Not sure which of install/ginstall is correct, but it does fixes your
> test/[ problem.

Unfortunately, ginstall is another exception -- but in the other
direction.  coreutils can't create that binary via `make install'
because that would conflict with the standard make target, so in the
case of install.c, the binary (in the build directory) is called ginstall.
Of course, it gets installed as `install' or with whatever --prefix=P
was used with ./configure.