[buildd-tools-devel] Bug#588962: Bug#588962: [Was: Bug#588962: schroot: Please provide documentation as po4a for translation]

[Roger Leigh]

On Tue, Jul 13, 2010 at 10:06:44PM -0400, David Prévot wrote:
> > Currently the documentation is all in manual page format with some
> > GNU troff extensions; can po4a cope with this?
> 
> Sure, it is presented as such in po4a(7). Some native packages
> already provide a way to do so (for example adduser), and some not
> native packages too (for example man-db). Some quality advices are
> probably available in "Internationalisation and localisation in
> Debian" [1] too.
> 
> Since it seems to be created directly from the manual page (that
> shouldn't be modified in the process), the only change I can
> think of will be the ability to provides such document in foreign
> languages.

Hi there,

Sorry for the long delay--I had to finish my PhD, and this got
pushed to the back of my TODO list.

Many thanks for doing the patch for po4a.
I've had a look at applying your patch to the current schroot
sources.  It's available at
  git://git.debian.org/git/users/rleigh/schroot.git
(branch po4a)

Due to changes in the meantime, I've not been able to apply
it directly.  I've separately done the .EX/.EE example fixes,
and then applied your patch afterward.  Note it's lacking the
translator comments in the manual page--I think I'll generate
the examples and include them directly with .so, rather than
requiring translators to update them by hand; we can probably
even generate localised examples automatically this way,
providing that we have the appropriate locales available on
the system.

I'm having some difficulty in initially getting things working;
while being familiar with gettext for over a decade, po4a is a
bit new, and I'm not sure if your patch includes the needed
logic for actually generating the .pot file or if that needs
doing in addition.  Some pointers would be much appreciated.
I'm also unsure of how to generate the localised manpages and
include them in the build infrastructure.


Regards,
Roger

-- 
  .''`.  Roger Leigh
 : :' :  Debian GNU/Linux             http://people.debian.org/~rleigh/
 `. `'   Printing on GNU/Linux?       http://gutenprint.sourceforge.net/
   `-    GPG Public Key: 0x25BFB848   Please GPG sign your mail.