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

po4a-updatepo - aggiorna la traduzione (in formato PO) di un documento

=head1 SINTASSI

B<po4a-updatepo> B<-f> I<fmt> (B<-m> I<master.doc>)+ (B<-p> I<XX.po>)+

dove I<XX.po> sono output e tutti gli altri sono input.

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

Il programma B<po4a-updatepo> si occupa di aggiornare i file PO affinché riflettano le modifiche fatte ai documenti originali; per far ciò, prima converte il documento in un file POT e quindi richiama L<msgmerge(1)> su questo nuovo POT e sui file PO specificati.

È possibile fornire sia più di un file PO, così da aggiornare più lingue contemporaneamente, sia diversi documenti, permettendo così di raggruppare le traduzioni di più documenti nello stesso file PO.

Se il documento originale contiene dei caratteri non ASCII, questo script convertirà i file PO in UTF-8 (se già non lo erano), in modo da permettere la gestione trasparente di caratteri non standard.

=head1 OPZIONI

=over 4

=item B<-f>, B<--format>

Formato del documento in questione. L'opzione B<--help-format> mostra l'elenco dei formati disponibili.

=item B<-m>, B<--master>

Uno o più file contenenti il documento originale da tradurre.

=item B<-M>, B<--master-charset>

Set di caratteri dei file contenenti il documento da tradurre. Tutti i file devono usare la stessa codifica.

=item B<-p>, B<--po>

Uno o più file PO da aggiornare. Se qualche file non esiste, verrà creato da B<po4a-updatepo>.

=item B<-o>, B<--option>

Opzioni extra da passare al plugin di formato. Vedere la documentazione per ogni plugin per ulteriori informazioni sulle opzioni valide e sul loro significato. Per esempio si può passare "-o tablecells" al parser AsciiDoc mentre il parser di testo semplice accetta "-o tabs=split".

=item B<--no-previous>

Questa opzione rimuove B<--previous> dalle opzioni passate a B<msgmerge>. Ciò aiuta a supportare le vecchie versioni di B<gettext> (precedenti la 0.16).

=item B<--previous>

Questa opzione aggiunge B<--previous> alle opzioni passate a B<msgmerge>. Richiede B<gettext> 0.16 o successive, ed è attivata come impostazione predefinita.

=item B<--msgmerge-opt> I<opzioni>

Opzioni extra per B<msgmerge>(1).

=item B<-h>, B<--help>

Mostra un breve messaggio di aiuto.

=item B<--help-format>

Elenca i formati di documento gestiti da po4a.

=item B<-V>, B<--version>

Mostra la versione del programma ed esce.

=item B<-v>, B<--verbose>

Rende il programma più prolisso.

=item B<-d>, B<--debug>

Mostra delle informazioni di debug

=item B<--porefs> I<type>[,B<wrap>|B<nowrap>]

Specifica il formato di riferimento. L'argomento I<type> può essere un valore qualsiasi tra: B<never> per non produrre nessun riferimento, B<file> per specificare solo il file senza il numero di riga, B<counter> per rimpiazzare il numero di riga con un contatore incrementale, e B<full> per includere il riferimento completo (valore predefinito: full).

L'argomento può essere seguito da una virgola e da una delle due parole chiave B<wrap> o B<nowrap>.  I riferimenti, come impostazione predefinita, vengono scritti su una singola riga.  L'opzione B<wrap> manda a capo i riferimento su più righe, per emulare il comportamento degli strumenti di B<gettext> (B<xgettext> e B<msgmerge>).  Questa opzione diventerà predefinita in una versione futura, perchè è il comportamento più logico. L'opzione B<nowrap> è disponibile per permettere agli utenti che lo desiderassero, di mantenere il vecchio comportamento.

=item B<--wrap-po> B<no>|B<newlines>|I<numero> (predefinito: 76)

Specifica come il file po deve essere mandato a capo. Consente di scegliere tra file con righe mandate capo ben formattate e quindi ben leggibili ma che potrebbero portare a conflitti in git o file che sono più facili da gestire automaticamente, ma più difficili da leggere per le persone.

Storicamente, la suite gettext riformattava i file po alla 77a colonna per questioni estetiche. Questa opzione specifica il comportamento di po4a. Se impostato su un valore numerico, po4a manderà a capo il file po a questo numero di colonna e dopo i caratteri di a capo nel testo. Se impostato su B<newlines>, po4a dividerà msgstr e msgstr solo dopo i caratteri di a capo nel testo. Se impostato su B<no>, po4a non metterà a capo nel testo del file po. L'andare a capo nei commenti di riferimento viene controllato dall'opzione B<--porefs>.

Si noti che questa opzione non ha alcun impatto sul modo in cui msgstr e msgstr vanno a capo, cioè su come i caratteri di a capo vengono aggiunti al contenuto di queste stringhe.

=item B<--msgid-bugs-address> I<indirizzo@email>

Imposta l'indirizzo a cui inviare i rapporti di errore per i msgid. Come impostazione predefinita, i file POT creati non hanno campi Report-Msgid-Bugs-To.

=item B<--copyright-holder> I<stringa>

Imposta l'intestatario del copyright nell'intestazione del POT. Il valore predefinito è "Free Software Foundation, Inc."

=item B<--package-name> I<stringa>

Imposta il nome del pacchetto nell'intestazione del POT. Il valore predefinito è "PACKAGE".

=item B<--package-version> I<stringa>

Imposta la versione del pacchetto nell'intestazione del POT. Il valore predefinito è "VERSION".

=back

=head1 VEDERE ANCHE

L<po4a-gettextize(1)>, L<po4a-normalize(1)>, L<po4a-translate(1)>, L<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-2023 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).

