
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NOMBRE

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

=head1 SINOPSIS

    use Locale::Po4a::Pod;
    my $parser = Locale::Po4a::Pod->new (sentence => 0, width => 78);

    # 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');

=head1 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).

=head1 ESTADO DE ESTE MODULO

Opino que este módulo es muy estable, y sólo hay un fallo conocido con F</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 de manual contiene

 " #n"

y el mio contiene

 "" #n""

lo cual es lógico ya que CE<lt>foobarE<gt> se reescribe como "foobar".

La lista completa de las páginas que dan este problema en mi máquina (de 564 páginas; observe que esto depende de la puntuación elegida para el justificado): /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





=head1 FUNCIONAMIENTO INTERNO

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

new() puede tomar opciones, en forma de pares llave/valor, que controlan el comportamiento del analizador. Las opciones comunes reconocidas por todos los hijos de Pod::Parser son:

=over 4

=item B<alt>

Si tiene un valor verdadero («true»), selecciona un formato alternativo de salida que, entre otras cosas, utiliza un estilo de cabecera diferente y marca las entradas B<=item> con dos puntos en el margen izquierdo. Falso por omisión.

=item B<code>

Si tiene un valor verdadero, las partes no POD del fichero de entrada se incluirán en la salida. Esto es útil para visualizar código documentado con bloques POD, con el POD tratado y el código dejado intacto.

=item B<indent>

El número de espacios con el que sangrar texto regular, y el sangrado por omisión de los bloques B<=over>. Por omisión vale 4.

=item B<loose>

Si toma valor verdadero, se imprime una línea en blanco después de las cabeceras B<=head1>. De ser falso (predefinido), no se imprimen líneas en blanco después de B<=head1>, pero sí después de B<=head2>. Este es el comportamiento predefinido porque éste es el formato esperado para las páginas de manual; si está formateando documentos de texto arbitrario, introducir ésta opción puede resultar en una salida más agradable.

=item B<quotes>

Ajusta las marcas de cita CE<lt>> alrededor del texto. Si el valor es un único carácter, se utilizará para las marcas izquierda y derecha; si son dos caracteres, se utilizará el primero para la marca izquierda, y el segundo para la derecha; y si son cuatro caracteres, los dos primeros se utilizarán como marca izquierda, y los dos últimos como marca derecha.

También se le puede dar el valor especial B<none>, en cuyo caso no se añadirán comillas alrededor del texto CE<lt>>.

=item B<sentence>

Si se define como verdadero, Locale::Po4a::Pod asumirá que cada frase termina con dos espacios e intentará preservar éste espaciado. Si se define como falso, todos los espacios consecutivos encontrados en un párrafo que no se deba mantener tal cual se comprimirán a un único espacio. Por omisión tiene valor verdadero.

=item B<width>

La columna a la cual se justifica el texto en el lado derecho. Por omisión tiene un valor de 76.

=back

=head1 VÉASE TAMBIÉN

L<Pod::Parser>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::TransTractor(3pm)>, L<po4a(7)|po4a.7>

=head1 AUTORES

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


=head1 TRADUCCION

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

=head1 DERECHO DE COPIA Y LICENCIA

Copyright © 2002 SPI, Inc.

Esto es software libre; puede redistribuirlo y/o modificarlo bajo las condiciones de la licencia GPL (consulte el fichero COPYING).

