[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#493007: debian-policy: Please recommend tracking translation status of l10n man pages



clone 493007
reassign -1 developers-reference
retitle -1 suggest to use po4a for man page translations
block -1 by 493007
thanks

Hello Christian,
On Thu, Jul 31, 2008 at 07:37:15AM +0200, Christian Perrier wrote:
> Quoting Helge Kreutzmann (debian@helgefjell.de):
> 
> > +    If a loclized man page for a certain command is provided, it should
> 
> s/loclized/localized

Yes, of course.

> > +    either be up to date or it should be clearly visible that this version
> > +    is outdated (either by a note in the beginning or by showing the
> > +    missing/changed parts in English instead of the target language).
> > +    Where the build system of the localized man page does not provide the 
> > +    option to enable this Debian developers and maintainers are asked to
> > +    take this issue to their upstream to resolve. 
> 
> I'm not sure that the policy talks about "Debian developers". It
> probably talks about package maintainers or so....

This sounds better, so:

+    Where the build system of the localized man page does not provide the
+    option to enable this package maintainers are asked to take this issue
+    to their upstream to resolve.

> I would also recommend turning the "should" to "must" for native
> packages. It probably needs the following to be included in the
> Developer's Reference:

I am not sure, do you mean the first should: 
it should be clearly visible -> it must be clearly visible?

Could you suggest a sentence, so I can grab the idea?

> > +    
> > +    If Debian developers themselves provide a framework to support
> > +    localized man pages this framework must fulfill the requirements of
> > +    the previous paragraphs. In this case it is recommended to use po4a
> > +    for localization.
> > +    
> 
> 
> That latter part probably belongs more to the Developer's
> Reference. Indeed, a section about po4a and a simple way to setup a
> framework for localized manpages would be a great addition to it.

Fine with me, thus cloned and reassigned.

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/

Attachment: signature.asc
Description: Digital signature


Reply to: