Re: Debian Policy 18.104.22.168 released: localized manpages
Christian Perrier <email@example.com> writes:
> Before people "blindly" update their Standards-Version, I deeply
> suggest looking at this item:
>> * Localized man pages should either be kept up-to-date with the
>> original version or warn that they're not up-to-date, either with
>> warning text or by showing missing or changed portions in the
>> original language. [12.1]
> *many* packages do provide localized manpages where l10n is handled
> "manually" (the translated manpages are just a copy of the original
> ones....where English is manually replaced by the said language). With
> such setup, it is nearly impossible to guarantee that the localized
> manpage is in sync with the original one.
The intention in those cases is for the maintainer to add a warning to the
page saying that it may not be up-to-date (preferrably after doing some
analysis based on when they know the English manpage last changed).
> (thankfully for our release date, this "should" is not a "must"...:-))
Yes, very intentional. :)
The rationale in the Policy discussion about this is that out-of-date man
page translations without any warning is *already* a bug, so putting it in
Policy saying that it's a bug doesn't make any packages more buggy than
they already are.
Russ Allbery (firstname.lastname@example.org) <http://www.eyrie.org/~eagle/>