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

Locale::Po4a::Man - converte pagine di manuale da/a file PO

=head1 DESCRIZIONE

L'obiettivo del progetto po4a (PO per tutto) è di facilitare le traduzioni
(e cosa più interessante, la manutenzione delle traduzioni) usando gli
strumenti associati a gettext in aree inaspettate come la documentazione.

Locale::Po4a::Man è un modulo che aiuta la traduzione in altre lingue della
documentazione in formato nroff (il linguaggio delle pagine di manuale).

=head1 TRADURRE CON PO4A::MAN

Questo modulo prova fortemente a facilitare la vita ai traduttori. Per far
ciò, il testo presentato ai traduttori non è una fotocopia del testo trovato
nella pagina man. Infatti, le parti più grezze del formato nroff vengono
nascoste, in modo che i traduttori non possano rovinarle.

=head2 A capo del testo

I paragrafi non indentati vengono formattati automaticamente per il
traduttore.  Ciò può portare ad alcune differenze minori nel risultato
generato, dato che le regole del portare a capo usate da groff non sono
molto chiare. Per esempio, due spazi dopo una parentesi alle volte vengono
conservati.

Comunque, la differenza riguarderà solamente la posizione degli spazi extra
nei paragrafi riformattati, e dovrebbe valere la pena.

=head2 Indicazione font

Il primo cambiamento riguarda le specifiche del cambiamento del font.  In
nroff, ci sono diversi modi per specificare se una data parola dovrebbe
essere scritta in minuscolo, grassetto o corsivo. Nel testo da tradurre, c'è
un unico modo, preso a prestito dal formato POD (Perl online documentation):

=over

=item IE<lt>testoE<gt> -- testo in corsivo

equivalente a \fItesto\fP o ".I testo"

=item BE<lt>testoE<gt> -- testo in grassetto

equivalente a \fBtesto\fP or ".B testo"

=item RE<lt>testoE<gt> -- testo con grazie

equivalente a \fRtesto\fP

=item CWE<lt>testoE<gt> -- testo a larghezza costante

equivalente a \f(CWtesto\fP or ".CW testo"

=back

Nota: il CW face non è disponibile per tutti i dispositivi groff. Se ne
sconsiglia l'uso. Viene fornito solo per comodità dell'utente.

=head2 Transliterazione automatica caratteri

Po4a automaticamente translitera alcuni caratteri per facilitarne la
traduzione o la revisione della traduzione.  Ecco l'elenco delle
transliterazioni:

=over

=item trattino

Trattini (-) e segni meno (\-) nelle pagine man vengono transliterati come
semplici lineette (-) nei file PO.  Poi tutte le lineette sono transliterate
in segni meno di roff (\-) quando la traduzione viene inserita nel documento
in uscita.

I traduttori possono forzare un trattino usando il glifo roff '\[hy]' nelle
loro traduzioni.

=item spazi non interrompenti

I traduttori possono usare spazi non interrompenti nelle loro traduzioni.
Questi spazi non interrompenti (0xA0 in latin1) verranno transliterati in
uno spazio non interrompente roff ('\ ').

=item transliterazione apici

`` e '' vengono transliterati rispettivamente in \*(lq e \*(rq.

Per evitare queste transliterazioni, i traduttori possono inserire un
carattere nroff di larghezza zero (cioè, usando rispettivamente `\&` o
'\&').

=back

=head2 Mettere 'E<lt>' e 'E<gt>' nelle traduzioni

Siccome questi caratteri vengono usati per delimitare parti sottoposte a
modifiche del font, non si possono usare direttamente. In alternativa si
consiglia di usare EE<lt>ltE<gt> e EE<lt>gtE<gt> (ancora una volta, come nei
POD).

=head1 OPZIONI ACCETTATE DA QUESTO MODULO

Queste sono le opzioni speciali per questo modulo:

=over

=item B<debug>

Attiva il debug per alcuni meccanismi interni di questo modulo.  Usare i
sorgenti per vedere quali parti possono essere controllate.

=item B<verbose>

Rende il programma più prolisso.

=item B<groff_code>

Questa opzione controlla il comportamento del modulo quando questo incontra
una sezione un .de, .ie o .if . Può prendere i seguenti valori:

=over

=item I<fail>

È il valore predefinito.  Il modulo fallirà quando incontrerà una sezione
.de, .ie o .if .

=item I<verbatim>

Indica che le sezioni .de, .ie o .if devono venir copiate come sono
dall'originale nel documento tradotto.

=item I<translate>

Indica che le sezioni .de, .ie o .if verranno proposte per la traduzione.
Si dovrebbe usare questa opzione solo se una stringa traducibile fosse
presente in una di dette sezioni. Altrimenti, sarebbe preferibile
I<verbatim>.

=back

=item B<generated>

Questa opzione specifica che il file è un file generato, e che quindi po4a
non dovrebbe cercare di rilevare se le pagine man siano state generate da un
altro formato. Questa opzione è necessaria per usare po4a su pagine man
generate. Si noti che tradurre pagine generate invece di quelle sorgenti è
spesso più fragile (N.d.T: è più facile fare errori), e quindi una cattiva
idea.

=item B<mdoc>

Questa opzione è utile solo per le pagine mdoc.

Seleziona un supporto più stringente del formato mdoc indicando a po4a di
non tradurre la sezione 'NAME'. Le pagine mdoc la cui sezione 'NAME' è
tradotta non genereranno alcuna intestazione o piè di pagina.

According to the groff_mdoc page, the NAME, SYNOPSIS and DESCRIPTION
sections are mandatory.
There are no known issues with translated SYNOPSIS or DESCRIPTION section,
but you can also specify these sections this way:
 -o mdoc=NAME,SYNOPSIS,DESCRIPTION

This mdoc issue can also be solved with an addendum like this one:
 PO4A-HEADER:mode=before;position=^.Dd
 .TH DOCUMENT_TITLE 1 "Month day, year" OS "Section Name"

=back

Le opzioni seguenti specificano il comportamento di una macro personalizzata
(definita con una richiesta .de), o di una macro classica non supportata da
po4a.  Prendono come argomento un elenco separato da virgole di macro.  Per
esempio:

 -o noarg=FO,OB,AR -o translate_joined=BA,ZQ,UX

Nota: se una macro non è supportata da po4a e si ritiene che sia una macro
standard roff, sarebbe desiderabile comunicarlo al team di sviluppo di po4a
(N.d.T. per un'eventuale inclusione in una prossima versione di po4a).

=over

=item B<untranslated>

B<untranslated> indica che questa macro (ed i suoi argomenti) non deve
essere tradotta.

=item B<noarg>

B<noarg> è come B<untranslated>, eccetto per il fatto che po4a verificherà
che non venga aggiunto nessun argomento a questa macro.

=item B<translate_joined>

B<translate_joined> indica che po4a deve proporre di tradurre gli argomenti
della macro.

=item B<translate_each>

Anche con B<translate_each>, gli argomenti verranno proposti per la
traduzione, ma ognuno verrà tradotto separatamente.

=item B<no_wrap>

Questa opzione prende come argomento un elenco di coppie separate da virgole
I<begin>:I<end>, dove I<begin> e I<end> sono comandi che delimitano
rispettivamente l'inizio e la fine di una sezione che non dovrebbe essere
riformattata.

Nota: non viene effettuata nessuna prova per assicurare che il comando
I<end> corrisponda al suo comando I<begin>; qualunque comando di fine
interrompe la modalità no_wrap.  Se si ha una macro I<begin> (o
rispettivamente I<end>) che non ha un I<end> (o rispettivamente I<begin>),
si può specificare un I<end> esistente (come fi) o I<begin> (come nf) come
controparte.  Queste macro (ed i loro argomenti) non verranno tradotte.

=item B<inline>

Questa opzione specifica un elenco separato da virgole di macro che non
devono spezzare il paragrafo corrente. La stringa da tradurre conterrà
perciò I<foo E<lt>.bar baz quxE<gt> quux>, dove I<bar> è il comando che
dovrebbe essere messo sulla stessa riga, e I<baz qux> i suoi argomenti.

=item B<unknown_macros>

Questa opzione indica come po4a dovrebbe comportarsi quando trova una macro
sconosciuta.  Per impostazione predefinita, po4a fallisce con un
avvertimento.  Può prendere i seguenti valori: B<failed> (il valore
predefinito), B<untranslated>, B<noarg>, B<translate_joined>, o
B<translate_each> (vedere sopra per una spiegazione di questi valori).

=back

=head1 CREAZIONE DI PAGINE COMPATIBILI MAN CON PO4A::MAN

Questo modulo è ancora molto limitato, e lo sarà sempre, perché non è un
vero interprete nroff. Sarebbe possibile fare un vero interprete nroff, per
consentire agli autori di utilizzare tutte le macro esistenti, o anche
definirne di nuove nelle loro pagine, ma non abbiamo voluto. Sarebbe stato
troppo difficile, e pensavamo che non fosse necessario. Pensiamo che se gli
autori delle manpage vogliono vedere le loro produzioni tradotte, potrebbero
doversi adattare per facilitare il lavoro dei traduttori.

Perciò, il parser man implementato in po4a ha alcune limitazioni note, che
non abbiamo intenzione di correggere, e che potranno presentare dei problemi
che sarà necessario evitare se si vuole che i traduttori si prendano cura
della propria documentazione.

=head2 Non programmare in nroff

nroff è un linguaggio di programmazione completo, con definizione di macro,
condizionali e così via. Poiché questo parser non è un interprete nroff
completo, non funzionerà sulle pagine che utilizzano queste funzionalità (ci
sono circa 200 di queste pagine sul mio sistema).

=head2 Usare l'insieme di macro di base

Ci sono ancora alcune macro che non sono supportate da po4a::man. Questo
solo perché non siamo riusciti a trovare nessuna documentazione su di
esse. Ecco l'elenco delle macro non supportate utilizzate sul mio
sistema. Si noti che questo elenco non è esaustivo poiché il programma non
riesce sulla prima macro non supportata incontrata. Se potete fornire
informazioni su alcune di queste macro, aggiungeremo volentieri il supporto
per esse. A causa di queste macro, circa 250 pagine del mio sistema sono
inaccessibili a po4a::man.

 ..               ."              .AT             .b              .bank
 .BE              ..br            .Bu             .BUGS           .BY
 .ce              .dbmmanage      .do                             .En
 .EP              .EX             .Fi             .hw             .i
 .Id              .l              .LO             .mf
 .N               .na             .NF             .nh             .nl
 .Nm              .ns             .NXR            .OPTIONS        .PB
 .pp              .PR             .PRE            .PU             .REq
 .RH              .rn             .S<             .sh             .SI
 .splitfont       .Sx             .T              .TF             .The
 .TT              .UC             .ul             .Vb             .zZ

=head2 Nascondere il testo a po4a

A volte, l'autore sa che alcune parti non vanno tradotte e non dovrebbero
essere estratte da po4a. Ad esempio, un'opzione potrebbe accettare un
argomento I<other> e I<other> potrebbe apparire anche come ultimo elemento
di un elenco. Nel primo caso, I<other> non dovrebbe essere traducibile. E
nel secondo caso, I<other> dovrebbe essere tradotto.

In tal caso, l'autore può evitare che po4a estragga alcune stringhe,
utilizzando alcuni costrutti groff speciali:

 .if !'po4a'hide' .B other

(ciò richiederà l'opzione B<-o groff_code=verbatim>)

A new macro can also be defined to automate this:
 .de IR_untranslated
 .    IR \\$@
 ..

 .IR_untranslated \-q ", " \-\-quiet

(questo richiederà le opzioni B<-o groff_code=verbatim> e B<-o
untranslated=IR_untranslated>; con questo costrutto, il condizionale B<.if
!'po4a'hide'> non è strettamente necessario dato che po4a non analizzerà
l'interno della definizione della macro)

or using an alias:
 .als IR_untranslated IR

 .IR_untranslated \-q ", " \-\-quiet

Ciò richiederà l'opzione B<-o untranslated=als,IR_untranslated>.

=head2 Conclusione

Per riassumere, fare le cose semplicemente non cercando trucchi complessi
nella creazione delle pagine man. Molte cose possibili in nroff non sono
supportate da questo parser. Ad esempio, non si provi a pasticciare con \c
per interrompere l'elaborazione del testo (come fanno 40 pagine sul mio
sistema). In alternativa, assicurarsi di inserire gli argomenti della macro
sulla stessa unica riga della macro. È valido in nroff, ma complicherebbe
troppo la gestione del parser.

Naturalmente, un'altra possibilità è usare un altro formato, più facile da
tradurre (come il formato POD usando po4a::pod, o uno della famiglia XML
come SGML), ma grazie a po4a::man, ciò non è comunque più necessario. Detto
questo, se il formato sorgente della documentazione è POD o XML, potrebbe
essere conveniente tradurre il formato sorgente e non quello generato. Nella
maggior parte dei casi, po4a::man rileverà le pagine generate ed emetterà un
avviso. Si rifiuterà persino di elaborare le pagine generate dal POD, perché
quelle pagine sono perfettamente gestite da po4a::pod e perché la loro
controparte nroff definisce molte nuove macro per le quali non si è voluto
darne supporto. Per esempio, sulla macchina di uno degli autori, 1432 delle
4323 pagine presenti vengono generate da file POD e sono ignorate da
po4a::man.

Nella maggior parte dei casi, po4a::man rileverà il problema e si rifiuterà
di elaborare la pagina, inviando un messaggio conforme. In alcuni rari casi,
il programma verrà completato senza preavviso, ma l'output sarà comunque
errato. Tali casi sono chiamati "bug" ;) Se incontra un caso del genere,
sarebbe gradita la segnalazione, insieme a una correzione se possibile…

=head1 STATO DI QUESTO MODULO

Questo modulo può essere usato per la maggior parte delle pagine man
esistenti.

Alcuni test vengono effettuati con regolarità su macchine Linux:

=over 4

=item *

un terzo delle pagine vengono rifiutate perché sono state generate da un
altro formato supportato da po4a (per es. POD o SGML).

=item *

il 10% delle pagine rimanenti vengono rifiutate con un errore (perché per
es. una macro groff non è supportata).

=item *

Poi, meno dell'1% delle pagine vengono accettate da po4a silenziosamente
(N.d.T. ovvero senza segnalazioni), ma con problemi significativi (cioè
parole mancanti, o nuove parole inserite)

=item *

Le altre pagine vengono solitamente gestite senza differenze più rilevanti
delle differenze di spaziatura o dell'andare a capo delle righe (problemi
relativi ai font in meno del 10% delle pagine elaborate).

=back

=head1 VEDERE ANCHE

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

=head1 AUTORI

 Denis Barbier <barbier@linuxfr.org>
 Nicolas François <nicolas.francois@centraliens.net>
 Martin Quinson (mquinson#debian.org)


=head1 TRADUZIONE

 Danilo Piazzalunga <danilopiazza@libero.it>
 Marco Ciampa <ciampix@posteo.net>

=head1 COPYRIGHT E LICENZA

Copyright © 2002-2008 by SPI, inc.

Questo programma è software libero; è lecito ridistribuirlo o modificarlo
secondo i termini della licenza GPL v2.0 o successive (vedere il file
COPYING).
