LOCALE::PO4A::POD.3PM(1)                   User Contributed Perl Documentation


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 estandar y escribe por la salida estandar.
           $parser->parse_from_filehandle;

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

DESCRIPCION
       Locale::Po4a::Pod es un modulo que asiste en la traduccion de
       documentacion en formato POD (el lenguaje preferido para documentar
       Perl) a otros lenguajes (humanos).

ESTADO DE ESTE MODULO
       Opino que este modulo es muy estable, y solo hay un fallo conocido con
       /usr/lib/perl5/Tk/MainWindow.pod (y algunas otras paginas, consulte mas
       abajo) que contiene:

         C<" #n">

       Mala suerte, en la version de po4a esto se separo en el espacio debido
       al justificado. Como resultado, en la version original la pagina del
       manual contiene:

        " #n"

       y el mio contiene:

        "" #n""

       lo cual es logico ya que C<foobar> se reescribe como "foobar".

       Lista completa de paginas que tienen este problema en mi caja (de 564
       paginas; 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 metodos e interfaces. Consulte Pod::Parser para mas
       detalles; brevemente, uno crea un nuevo analizador con
       "Locale::Po4a::Pod->new()" y luego invoca <<parse_from_filehandle()>> o
       bien <<parse_from_file()>>.

VEASE TAMBIEN
       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 (C) 2002 SPI, Inc.

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

perl v5.38.2                      2024-06-26          LOCALE::PO4A::POD.3PM(1)