Re: Errors in man pages of make

[Paul Smith]

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").

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

> Man page: make.1
> Issue: I<name> doesn't appear in SYNOPSIS, why not format »target«
> instead?

I addressed this, thanks!

> --
> 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.