
        *****************************************************
        *           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 NOM

Locale::Po4a::Pod - Converteix dades POD des de/a fitxers PO

=head1 SINOPSI

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

    # Llegim el POD de l'entrada estàndard i escrivim a la sortida estàndard.
    $analitzador->parse_from_filehandle;

    # Llegim el POD de fitxer.pod i escrivim a fitxer.txt.
    $analitzador->parse_from_file ('fitxer.pod', 'fitxer.txt');

=head1 DESCRIPCIÓ

Locale::Po4a::Pod és un mòdul per ajudar en la traducció de documents en el format POD (el llenguatge preferit per documentar Perl) a altres llenguatges [humans].

=head1 ESTAT D'AQUEST MÒDUL

Tinc un altre problema amb F</usr/lib/perl5/Tk/MainWindow.pod> (i algunes altres pàgines, vegeu més avall) que contenen:

  C<" #n">

Per mala sort, a la versió de po4a, això es parteix per l'espai per justificar. Com a resultat, a la versió original, la pàgina de manual conté

 " #n"

i la meva conté

 "" #n""

que és lògic, ja que CE<lt>foobarE<gt> es reescriu com a "foobar".

Llistat complet de les pàgines de la meva màquina que tenen aquest problema (de 564 pàgines; tingueu en compte que això depèn de la columna escollida per justificar): /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 FUNCIONAMENT INTERN

Com a classe derivada de Pod::Parser, Locale::Po4a::Pod suporta els mateixos mètodes i interfícies.  Consulteu L<Pod::Parser> per tots els detalls; breument, es crea un nou analitzador amb C<< Locale::Po4a::Pod->new() >> i després es crida la funció parse_from_filehandle() o la funció parse_from_file().

new() pot rebre opcions, en la forma de parells clau/valor, que controlen el comportament de l'analitzador.  Tots els fills de Pod::Parser reconeixen aquestes opcions:

=over 4

=item B<alt>

Si té valor cert, selecciona un format de sortida alternativa, que entre d'altres coses, utilitza un estil d'encapçalament diferent i marca les entrades B<=item> amb un punt al marge esquerre.  Per defecte té el valor fals.

=item B<code>

Si té valor cert, les parts no-POD del fitxer d'entrada s'inclouran també a la sortida.  És útil per veure el codi documentat amb blocs POD, amb el POD tractat i el codi deixat intacte.

=item B<indent>

És el nombre d'espais per indentar el text regular, i la indentació per defecte pels blocs B<=over>. Per defecte val 4.

=item B<loose>

Si té valor cert, s'afegeix una línia en blanc després de les capçaleres B<=head1>.  Si té valor fals (per defecte), no s'afegeixen línies en blanc després de B<=head1>, encara que se segueix afegint després de B<=head2>. Aquest és el comportament per defecte perquè és el format esperat per les pàgines de manual; si esteu formatejant documents de text arbitraris, obtindreu una sortida més amena si li doneu valor cert.

=item B<quotes>

Indica les marques que s'utilitzaran al voltant del text CE<lt>>.  Si el valor és un únic caràcter, s'utilitzarà com a marca esquerra i dreta; si són dos caràcters, el primer s'utilitzarà com a marca esquerra, i el segon com a marca dreta; i si són quatre caràcters, els dos primers s'utilitzaran com a marca esquerra, i els dos últims com a marca dreta.

També es pot assignar el valor especial B<none>. En aquest cas no s'afegiran marques al voltant del text CE<lt>>.

=item B<sentence>

Si té valor cert, Locale::Po4a::Pod assumirà que cada frase acaba en dos espais, i intentarà conservar aquest espaiat.  Si té valor fals, es comprimiran a un tots els espais consecutius dels paràgrafs no-verbatim. Per defecte val cert.

=item B<width>

La columna a la que es justificarà el text.  Per defecte val 76.

=back

=head1 CONSULTEU TAMBÉ

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

=head1 AUTORS

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


=head1 TRADUCCIÓ

 Carme Cirera <menxu@hotmail.com>
 Jordi Vilalta <jvprat@gmail.com>

=head1 DRET DE CÒPIA I LLICÈNCIA

Copyright © 2002 SPI, Inc.

Aquest programa és programari lliure; podeu redistribuir-lo i/o modificar-lo sota els termes de la GPL (consulteu el fitxer COPYING).

