[Pkg-shadow-devel] Should NAME be translated in localized man pages?

[Nicolas François]

On Fri, Dec 16, 2005 at 08:06:07PM +0100, bubulle at debian.org wrote:
> While working on the shadow package, I was puzzled by the huge amount
> of warnings outputted by linda about translated man pages.
>
> It indeed turns that linda calls lexgrog...which parses man pages
> headers.
> 
> Many translated man pages indeed have translated the "NAME" section
> name...which confuses lexgrog.
> 
> So, is this correct or are these man pages wrong?

IMHO, it should be translated...at least for some languages.

Here is an extract from the lexgrog.l file:
===========================================================================
 /* Please add to this list if you know how. */
cs_name         J[Mm][ÉéEe][Nn][Oo]
de_name         B[Ee][Zz][Ee][Ii][Cc][Hh][Nn][Uu][Nn][Gg]
en_name         N[Aa][Mm][Ee]
es_name         N[Oo][Mm][Bb][Rr][Ee]
fi_name         N[Ii][Mm][Ii]
fr_name         N[Oo][Mm]
hu_name         N[ÉéEe][Vv]
 /* NOME also works for gl, pt */
it_name         N[Oo][Mm][Ee]
ja_name         \314\276\301\260
latin_name      N[Oo][Mm][Ee][Nn]
nl_name         N[Aa][Aa][Mm]
pl_name         N[Aa][Zz][Ww][Aa]
sv_name         N[Aa][Mm][Nn]
name            ({cs_name}|{de_name}|{en_name}|{es_name}|{fi_name}|{fr_name}|{hu_name}|{it_name}|{ja_name}|{latin_name}|{nl_name}|{pl_name}|{sv_name})
name_sec        {dbl_quote}?{style_change}?{name}{style_change}?({blank}*{dbl_quote})?
===========================================================================

It would be nice if translators who don't have her language here could
file a bug (e.g. ru: #338991)

Maybe lexgrog could use the first .SH section when there is no lang_name
specified.

> I guess the same stands for DESCRIPTION, SYNOPSIS, SEE ALSO, etc.

I don't know of any tools using these sections. If there is none, they
should be translated.


-- 
Nekral