Re: Errors in man pages of make

[Helge Kreutzmann]

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