NOM

       Locale::Po4a::Pod - Convertir des données POD depuis ou vers des fichiers PO

SYNOPSIS

           use Locale::Po4a::Pod;
           my $parser = Locale::Po4a::Pod->new();

           # Lecture dans STDIN et écriture dans STDOUT.
           $parser->parse_from_filehandle;

           # Lecture d’un POD dans file.pod, et écriture dans file.txt.
           $parser->parse_from_file ('file.pod', 'file.txt');

DESCRIPTION

       Locale::Po4a::Pod est un module qui permet d’aider la traduction de documentation au
       format POD (le langage de préférence pour la documentation Perl) vers d’autres langues.

ÉTAT DE CE MODULE

       Je pense que ce module est extrêmement stable, et il n’y a qu’un seul problème connu avec
       /usr/lib/perl5/Tk/MainWindow.pod (et certaines autres pages, voir ci-dessous), qui
       contient :

         C<" #n">

       Manque de chance, dans la version créée par po4a, c’est découpé par les retours à la
       ligne. Comme résultat, dans la version d’origine, la page de manuel contient :

        " #n"

       et le mien contient :

        "" #n""

       Ce qui est logique puisque « C<blabla> » est converti en « "blabla" ».

       Voici la liste complète des pages présentant ce problème sur ma machine (pour un total de
       564 pages ; notez également que cela dépend de la colonne de retour à la ligne) :

        /usr/lib/perl5/Tk/MainWindow.pod
        /usr/share/perl/5.8.0/overload.pod
        /usr/share/perl/5.8.0/pod/perlapi.pod
        /usr/share/perl/5.8.0/pod/perldelta.pod
        /usr/share/perl/5.8.0/pod/perlfaq5.pod
        /usr/share/perl/5.8.0/pod/perlpod.pod
        /usr/share/perl/5.8.0/pod/perlre.pod
        /usr/share/perl/5.8.0/pod/perlretut.pod

FONCTIONNEMENT INTERNE

       En tant que classe dérivée de Pod::Parser, Locale::Po4a::Pod comprend les mêmes méthodes
       et interfaces. Consultez Pod::Parser pour en savoir plus; en bref, on crée un nouvel
       analyseur avec "Locale::Po4a::Pod->new()" puis on appelle parse_from_filehandle() ou
       parse_from_file().

VOIR AUSSI

       Pod::Parser, Locale::Po4a::Man(3pm), Locale::Po4a::TransTractor(3pm), po4a(7)

AUTEURS

        Denis Barbier <barbier@linuxfr.org>
        Martin Quinson (mquinson#debian.org)

TRADUCTION

        Martin Quinson (mquinson#debian.org)

COPYRIGHT ET LICENCE

       Copyright © 2002 SPI, Inc.

       Ce programme est un logiciel libre ; vous pouvez le copier et / ou le modifier sous les
       termes de la GPL v2.0 ou suivante (voir le fichier COPYING).