Re: Errors in man pages of make

[Helge Kreutzmann]

Hello Paul,
On Sun, Feb 06, 2022 at 05:52:45PM -0500, Paul Smith wrote:
> On Sat, 2022-02-05 at 11:24 +0100, Helge Kreutzmann wrote:
> > I'm now reporting the errors for your project. If future reports
> > should use another channel, please let me know.
> 
> This channel is fine, but please always do include the release of GNU
> make that you're looking at when you submit changes (run "make
> --version").

This I don't know. I receive the man pages from Fedora, SUSE,
Archlinux, Debian without any further information, so the string
appears in any, some or all of those version.

> Note that there are no translations of the man page provided with GNU
> make.

Yes, that's why it is included in manpages-l10n. If you are interested
in establishing man page translations within GNU make (using po4a or
similar), please let me know.

> > --
> > Man page: make.1
> > Issue: B<sub-makes;> -> B<sub-makes>;
> > 
> > "Internal option B<make> uses to pass the jobserver pipe read and write 
> > file "
> > "descriptor numbers to B<sub-makes;> see the section B<PARALLEL MAKE AND 
> > THE "
> > "JOBSERVER> for details"
> > --
> > Man page: make.1
> > Issue: I<jobserver,> → I<jobserver>,
> > 
> > "If the job to be run is not a B<sub-make> then B<make> will close the "
> > "jobserver pipe file descriptors before invoking the commands, so that the "
> > "command can not interfere with the I<jobserver,> and the command does not "
> > "find any unusual file descriptors."
> 
> I can't find either of the above two texts in the GNU make man page,
> neither the current latest nor any other previous version going back to
> the first committed version, in 1990.  There has never been any
> description of the jobserver in any version of the man page.
> 
> All I can assume is that your distribution has provided you with a
> version of the man page that is modified from the standard one.

I do know that distributions sometimes add strings and this string is
only coming from Debian, so this is likely. I marked it in our file,
so it won't be reported again.

Thanks for the quick and smooth resolution.

Greetings

          Helge

-- 
      Dr. Helge Kreutzmann                     debian@helgefjell.de
           Dipl.-Phys.                   http://www.helgefjell.de/debian.php
        64bit GNU powered                     gpg signed mail preferred
           Help keep free software "libre": http://www.ffii.de/

signature.asc
Description: PGP signature