Re: Errors in man pages of make
Hello Paul, On Mon, Feb 07, 2022 at 12:48:56PM -0500, Paul Smith wrote: > On Mon, 2022-02-07 at 18:18 +0100, Helge Kreutzmann wrote: > > > 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. > > I see. It's unfortunate that our man page doesn't include the version > it documents in the page itself. I will look into adding that. Yes, then this could be tracked. > > > 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. > > Currently all our translations are handled through the TP > (https://translationproject.org/html/welcome.html ). I'm not sure if > they support translations of man pages etc. or what would be involved > with distributing other translations in the GNU make package. The (po4a or different) framework would need to be on your side, still. > At first glance I lean towards documentation translations being > provided separately from the GNU make package: it seems more useful to > allow these to be updated and distributed asynchronously. Both options have pros and cons. Having it in your package means the translations are always current and maintainers and users more easily spot them - probably not all non-english users will know about the separate package "manpages-yy" where "yy" is there language code, e.g. fr, it, de, es, ... Greetings Helge -- Dr. Helge Kreutzmann deb...@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
Re: Errors in man pages of make
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 -> B; > > > > "Internal option B uses to pass the jobserver pipe read and write > > file " > > "descriptor numbers to B see the section B > THE " > > "JOBSERVER> for details" > > -- > > Man page: make.1 > > Issue: I → I, > > > > "If the job to be run is not a B then B will close the " > > "jobserver pipe file descriptors before invoking the commands, so that the " > > "command can not interfere with the I 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 deb...@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
Re: Errors in man pages of make
On Mon, 2022-02-07 at 18:18 +0100, Helge Kreutzmann wrote: > > 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. I see. It's unfortunate that our man page doesn't include the version it documents in the page itself. I will look into adding that. > > 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. Currently all our translations are handled through the TP (https://translationproject.org/html/welcome.html ). I'm not sure if they support translations of man pages etc. or what would be involved with distributing other translations in the GNU make package. At first glance I lean towards documentation translations being provided separately from the GNU make package: it seems more useful to allow these to be updated and distributed asynchronously.
Re: Errors in man pages of make
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 doesn't appear in SYNOPSIS, why not format »target« > instead? I addressed this, thanks! > -- > Man page: make.1 > Issue: B -> B; > > "Internal option B uses to pass the jobserver pipe read and write file " > "descriptor numbers to B see the section B "JOBSERVER> for details" > -- > Man page: make.1 > Issue: I → I, > > "If the job to be run is not a B then B will close the " > "jobserver pipe file descriptors before invoking the commands, so that the " > "command can not interfere with the I 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.
Errors in man pages of make
Dear make maintainer, the manpage-l10n project maintains a large number of translations of man pages both from a large variety of sources (including make) as well for a large variety of target languages. During their work translators notice different possible issues in the original (english) man pages. Sometimes this is a straightforward typo, sometimes a hard to read sentence, sometimes this is a convention not held up and sometimes we simply do not understand the original. We use several distributions as sources and update regularly (at least every 2 month). This means we are fairly recent (some distributions like archlinux also update frequently) but might miss the latest upstream version once in a while, so the error might be already fixed. We apologize and ask you to close the issue immediately if this should be the case, but given the huge volume of projects and the very limited number of volunteers we are not able to double check each and every issue. Secondly we translators see the manpages in the neutral po format, i.e. converted and harmonized, but not the original source (be it man, groff, xml or other). So we cannot provide a true patch (where possible), but only an approximation which you need to convert into your source format. Finally the issues I'm reporting have accumulated over time and are not always discovered by me, so sometimes my description of the problem my be a bit limited - do not hesitate to ask so we can clarify them. I'm now reporting the errors for your project. If future reports should use another channel, please let me know. Man page: make.1 Issue: I doesn't appear in SYNOPSIS, why not format »target« instead? "B executes commands in the I to update one or more target " "I, where I is typically a program. If no B<-f> option is " "present, B will look for the makefiles I, I, " "and I, in that order." -- Man page: make.1 Issue: B -> B; "Internal option B uses to pass the jobserver pipe read and write file " "descriptor numbers to B see the section B for details" -- Man page: make.1 Issue: I → I, "If the job to be run is not a B then B will close the " "jobserver pipe file descriptors before invoking the commands, so that the " "command can not interfere with the I and the command does not " "find any unusual file descriptors." -- Dr. Helge Kreutzmann deb...@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