oracular (3) Locale::Po4a::Pod.3pm.gz

NOMBRE

       Locale::Po4a::Pod - Convierte datos POD desde/a ficheros PO

SINOPSIS

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

           # Lee el POD por la entrada estándar y escribe por la salida estándar.
           $parser->parse_from_filehandle;

           # Lee POD desde «fichero.pod» y escribe en «fichero.txt».
           $parser->parse_from_file ('fichero.pod', 'fichero.txt');

DESCRIPCIÓN

       Locale::Po4a::Pod es un módulo que asiste en la traducción de documentación en formato POD (el lenguaje
       preferido para documentar Perl) a otros lenguajes (humanos).

ESTADO DE ESTE MODULO

       Opino que este módulo es muy estable, y sólo hay un fallo conocido con /usr/lib/perl5/Tk/MainWindow.pod
       (y algunas otras páginas, consulte más abajo) que contiene:

         C<" #n">

       Mala suerte, en la versión de po4a esto se separó en el espacio debido al justificado. Como resultado, en
       la versión original la página del manual contiene:

        " #n"

       y el mio contiene:

        "" #n""

       lo cual es lógico ya que C<foobar> se reescribe como "foobar".

       Lista completa de páginas que tienen este problema en mi caja (de 564 páginas; tenga en cuenta que
       depende de la columna de envoltura elegida):

        /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

FUNCIONAMIENTO INTERNO

       Como clase derivada de Pod::Parser, Locale::Po4a::Pod es compatible con los mismos métodos e interfaces.
       Consulte Pod::Parser para más detalles; brevemente, uno crea un nuevo analizador con
       "Locale::Po4a::Pod->new()" y luego invoca «parse_from_filehandle()» o bien «parse_from_file()».

VÉASE TAMBIÉN

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

AUTORES

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

TRADUCCION

        Jordi Vilalta <jvprat@gmail.com>
        Omar Campagne <ocampagne@gmail.com>

DERECHO DE COPIA Y LICENCIA

       Copyright © 2002 SPI, Inc.

       Este programa es software libre; puede redistribuirlo y/o modificarlo bajo los términos de la GPL v2.0 o
       posterior (consulte el archivo COPYING).