documentation: improve italian manpage

Signed-off-by: Davide Madrisan <davide.madrisan@gmail.com>

ChangeLog

@@ -52,9 +52,10 @@ Changes in version 1.12.0
   * pck-update - Davide Madrisan:
     Update help message.
 
++ improvement
   * documentation - Davide Madrisan:
-    Updated the italian man page.
+    Remove the partially obsolete document `autospec-it-HOWTO'.
-    Remove the document `autospec-it-HOWTO'.
+    Update/improve the italian manpage by merging part of the italian HOWTO.
 
 -------------------------------------------------------------------------------
 

autospec.spec.in

@@ -135,7 +135,6 @@ make install DESTDIR=%{buildroot} prefix=%{_prefix}
 %lang(it) %{_mandir}/it/man1/%{name}.*
 %lang(it) %{?_localedir:%{_localedir}}%{!?_localedir:%_datadir/locale}/it/LC_MESSAGES/autospec_fe.mo
 %doc AUTHORS BUGS ChangeLog COPYING NEWS TODO
-%doc %{name}-it-HOWTO
 
 %files plugins
 %defattr(-,root,root)
@@ -183,6 +182,7 @@ make install DESTDIR=%{buildroot} prefix=%{_prefix}
 %changelog
 * @date@ Davide Madrisan <davide.madrisan@gmail.com> @version@-@release@
 - update to @version@
+- new subpackages %{name}-config-openmamba and %{name}-templates-openmamba
 
 * Mon May 01 2012 Davide Madrisan <davide.madrisan@gmail.com> 1.10.0-1mamba
 - update to 1.10.0

man/it/autospec.1.in

@@ -2,7 +2,7 @@
 .SH NOME
 \fB@package@\fR - script di frontend per la creazione e l'aggiornamento e la verifica di pacchetti rpm.
 .br
-\fBconfig-getvar\fR - plugin per la visualizzazione di variabili presenti nei file di configurazione di autospec.
+\fBconfig-getvar\fR - plugin per la visualizzazione di variabili presenti nei file di configurazione.
 .br
 \fBpck-extract\fR - plugin per l'estrazione di file da archivi srpm.
 .br
@@ -13,90 +13,145 @@
 \fB@pck_lib@\fR - libreria di funzioni per l'analisi degli specfile.
 
 .SH VERSIONE
-Questo documento e' aggiornato alla versione 1.12.0 di @package@.
+Questo documento e' aggiornato alla versione 1.12.0 di
+.B @package@.
 
 .SH DESCRIZIONE
-@package@ e' una suite di script che permette di velocizzare ed automatizzare una parte
+.B @package@
+e' una suite di script che permette di \fIvelocizzare\fP ed \fIautomatizzare\fP una parte
 delle operazioni necessarie alla creazione, al mantenimento (aggiornamento) dei pacchetti
 rpm di una intera distribuzione ed al controllo di comuni errori e vulnerabilita'.
-.br
+
-@package@ e' modulare ed altamente configurabile e quindi facilmente adattabile alle
+.B @package@
+e' modulare ed altamente \fIconfigurabile\fP e quindi facilmente adattabile alle
 particolarita' specifiche di ogni distribuzione basata su pacchetti rpm.
-.br
+
-@package@ fornisce inoltre la libreria @pck_lib@, utilizzabile anche da script di shell
+.B @package@
+fornisce inoltre la libreria \fB@pck_lib@\fR, utilizzabile anche da script di shell
 esterni per ricavare in modo semplice informazioni su un qualsiasi specfile dato in input.
-.br
+
-@package@ e' stato utilizzato con successo dagli sviluppatori della distribuzione
+.B @package@
-QiLinux (http://www.qilinux.org), permettendo la creazione di specfile standard e
+e' stato utilizzato con successo dagli sviluppatori della distribuzione
+.B QiLinux
+(\fIhttp://www.qilinux.org\fP), permettendo la creazione di specfile standard e
 l'aggiornamento (semi)automatico dei pacchetti.
-E' utilizzato attualmente nello sviluppo di openmamba GNU/Linux 
+E' utilizzato attualmente nello sviluppo di
-(http://www.openmamba.org) per creare specfile, per aggiornare i pacchetti dei branch
+.B openmamba GNU/Linux 
+(\fIhttp://www.openmamba.org\fP) per creare specfile, per aggiornare i pacchetti dei branch
 di sviluppo e dei contributors e per effettuare il porting (amche in cross-compilazione)
 dei pacchetti in architetture diverse.
 
 .SH FILE DI CONFIGURAZIONE
-@package@ legge all'avvio i file globali \fI@sysconfdir@/@package@.conf\fR
+.B @package@
+legge all'avvio i file globali \fI@sysconfdir@/@package@.conf\fR
 e \fI@sysconfdir@/@package@.d/*.conf\fR e quindi i file privati dell'utente:
 \fI~/.@package@\fR e/o \fI~/.@package@.d/*.conf\fR.
+
 E' buona norma non modificare direttamente i file globali.
 Utilizzare i file privati per ridefinire variabili oppure modularizzare la configurazione.
 .TP
-Qui di seguito e' presentato un esempio di file di configurazione utente per @package@ che potra' essere utilizzato da un contributore come fac-simile per creare il proprio file di configurazione personale.
+Qui di seguito e' presentato un esempio di file di configurazione utente per \fB@package@\fR che potra' essere utilizzato da un contributore come fac-simile per creare il proprio file di configurazione personale.
-.br
+.if t .sp 0.5
-\fI\fR
+.if n .sp 1
-.br
+.RS
+.PD 0
+.TP
 [~/.@package@]
-.br
+.TP
 # [configuration file for `@package@']
-.br
+.TP
 proxy=
-.br
+.TP
 proxy_user=
-.br
+.TP
 packager_fullname="<Your Name>"
-.br
+.TP
 packager_email="<email>@openmamba.org"
-.br
+.TP
 ftp_rw_user[1]="<user>"
-.br
+.TP
 ftp_rw_passwd[1]="<passwd>"
-.br
+.TP
 arch_list=(i586 ppc arm x86_64)
-.br
+.TP
 curl_opts_netlink="--connect-timeout 15 --retry 3 --limit-rate 250k"
+.PD
+.RE
 .TP
 Ecco un esempio di modularizzazione possibile:
-.br
+.if t .sp 0.5
-\fI\fR
+.if n .sp 1
-.br
+.RS
-~/.@package@.d/00-devel.conf
+.PD 0
-.br
+.TP
-~/.@package@.d/01-devel-my.conf
+~/.@package@.d/00-devel.conf
-.br
+.TP
-~/.@package@.d/02-devel-kde4.conf
+~/.@package@.d/01-devel-my.conf
-.br
+.TP
-~/.@package@.d/03-devel-makedist.conf
+~/.@package@.d/02-devel-kde4.conf
-.br
+.TP
-~/.@package@.d/04-devel-autodist.conf
+~/.@package@.d/03-devel-makedist.conf
-.br
+.TP
-~/.@package@.d/05-devel-future.conf
+~/.@package@.d/04-devel-autodist.conf
+.TP
+~/.@package@.d/05-devel-future.conf
+.PD
+.RE
+.TP
+In ogni file vi sono le informazioni di connessione al \fIrepository\fP specificato dal nome del file. Ad esempio (repository in sola lettura):
+.if t .sp 0.5
+.if n .sp 1
+.RS
+.PD 0
+.TP
+$ cat ~/.@package@.d/05-devel-autodist.conf 
 .TP
-In ogni file vi sono le informazioni di connessione al repository specificato dal nome del file. Ad esempio:
-.br
-\fI\fR
-.br
-$ cat ~/.autospec.d/05-devel-autodist.conf 
-.br
 ftp_alias[5]="autodist"
-.br
+.TP
 ftpurl_ro_rpms[5]="http://www.openmamba.org/pub/openmamba/devel-autodist/RPMS.@arch@"
-.br
+.TP
 ftpurl_ro_srpms[5]="http://www.openmamba.org/pub/openmamba/devel-autodist/SRPMS.base"
-.br
+.TP
 ftp_enable[5]="1"
+.PD
+.RE
+.TP
+e (repository personale in lettura e scrittura):
+.if t .sp 0.5
+.if n .sp 1
+.RS
+.PD 0
+.TP
+$ cat ~/.@package@.d/01-devel-my.conf
+.TP
+ftp_alias[2]="\fI<myrepos>\fP"
+.TP
+ftpurl_ro_rpms[2]="http://www.openmamba.org/pub/openmamba/devel-\fI<my_alias>\fP/RPMS.@arch@"
+.TP
+ftpurl_ro_srpms[2]="http://www.openmamba.org/pub/openmamba/devel-\fI<my_alias>\fP/SRPMS.base"
+.TP
+ftp_rw_server[2]="ftp://ftpaccounts.openmamba.org"
+.TP
+ftp_rw_passive_mode[2]=on
+.TP
+ftp_rw_user[2]="\fI<my_repository_alias>\fP"
+.TP
+ftp_rw_passwd[2]="\fI<passwd>\fP"
+.TP
+ftp_rw_rpms_dir[2]="/RPMS.@arch@"
+.TP
+ftp_rw_srpms_dir[2]="/SRPMS.base"
+.TP
+arch_list[2]="i586"
+.TP
+arch_noarch_upload[2]="@arch@"
+.TP
+ftp_enable[2]="1"
+.PD
+.RE
 
 .SH SINTASSI
-@package@ e' lo script principale ed ha funzione di frontend per una serie di script e
+\fB@package@\fR e' lo script principale ed ha funzione di \fIfrontend\fP per una serie di script e
 librerie specializzate.
 Per questo motivo sono possibili differenti modalita' distinte di utilizzo.
 Si ricorda che le opzioni indicate tra parentesi quadre sono opzionali.
@@ -139,27 +194,31 @@ categoria dello specfile da generare:
 .TP
 \fB\-o\fR, \fB\-\-output\fR
 redirige lo standard output sul file \fIoutfile\fR
-.br
-\fI\fR
 .TP
-Esempio:
+\fIEsempi\fR
-.br
+.TP
-\fI\fR
+.PD 0
-.br
+\fB@package@\fR \fB\-s\fR ~/software/@package@-@version@.tar.bz2 \fB\-t\fR standard \fB\-o\fR @package@.spec
-@package@ \-s \\
+.TP
-.br
+\fB@package@\fR \fB\-s\fR ftp://ftp.gnu.org/pub/gnu/bash/bash-4.2.tar.gz
+.TP
+\fB@package@\fR \fB\-s\fR \\
+.TP
   http://ovh.dl.sourceforge.net/sourceforge/avifile/avifile-0.7-0.7.45.tar.bz2 \\
-.br
+  \fB\-t\fR library \fB\-n\fR libavifile \fB\-v\fR 0.7.45 \\
-  -t library -n libavifile -v 0.7.45 \\
+  \fB\-o\fR /usr/src/RPM/SPECS/libavifile.spec
-  -o /usr/src/RPM/SPECS/libavifile.spec
+.TP
+\fB@package@\fR \fB\-s\fR \fB\-\-help\fR
+.PD
+.RE
 
 .SS "Aggiornamento di pacchetti rpm"
 \fB@package@\fR \
-\fB\-u\fR \fIpck\fR \fB\-a\fR \fIlst\fR [\fIver\fR] [\fIrel\fR] \
+\fB\-u\fR \fIpck\fR \fB\-a\fR \fIazioni\fR [\fIver\fR] [\fIrel\fR] \
 [\fB\-d\fR \fIv1=r1\fR[,\fIv2=r2\fR,...]] \
 [\fB\-\-server\-download\fR \fIint\fR] \
 [\fB\-\-server\-upload\fR \fIint\fR] \
-[\fB\-l\fR \fIusr\fR:\fIpswd\fR] \
+[\fB\-l\fR \fIutente\fR:\fIpasswd\fR] \
 [\fB\-S\fR \fIspecfile\fR] \
 [\fB\-A\fR \fIarch\fR] \
 [\fB\-\-changelog\fR "\fImsg\fR" ] \
@@ -169,11 +228,11 @@ Esempio:
 [\fB\-c\fR] [\fB\-f\fR] [\fB\-L\fR] [\fB\-R\fR]
 .TP
 \fB\-u\fR, \fB\-\-update\fR
-aggiorna automaticamente il pacchetto \fIpck\fR, versione \fIver\fR,
+aggiorna il pacchetto \fIpck\fR, versione \fIver\fR,
 release \fIrel\fR
 .TP
 \fB\-a\fR, \fB\-\-action\fR
-Esegue la lista di azioni separate da virgole \fIlst\fR
+Esegue la lista di azioni separate da virgole \fIazioni\fR:
 .br
 \fI0\fR. indica le versioni del pacchetto disponibili nei repository
 .br
@@ -232,7 +291,7 @@ server dove effettuare l'upload dei pacchetti
 server per l'upload e il download dei pacchetti
 .TP
 \fB\-l\fR, \fB\-\-login\fR
-user \fIusr\fR e password \fIpswd\fR per effettuare l'upload sul sito FTP
+user \fIutente\fR e password \fIpasswd\fR per effettuare l'upload sul sito FTP
 .TP
 \fB\-S\fR, \fB\-\-specfile\fR
 nome dello specfile (default: \fIname\fR.spec)
@@ -271,6 +330,33 @@ attiva modalita' ed impostazioni di rebuild (azione 4)
 .TP
 \fB\-R\fR, \fB\-\-root\fR
 definisce una root directory alternativa per rpm
+.TP
+\fIEsempi\fR
+.TP
+.PD 0
+\fB@package@\fR \fB\-u\fR @package@ @version@ \fB\-a\fR4 \fB\-\-changelog\fR "update to @version@"
+.TP
+\fB@package@\fR \fB\-u\fR @package@ \fB\-a\fR4 \fB\-\-rebuild\fR
+.TP
+\fB@package@\fR \fB\-u\fR @package@ \fB\-\-log\fR \fB\-a\fR5,6:9 \fB\-\-define\fR addons_ver=0.9
+.TP
+\fB@package@\fR \fB\-u\fR @package@ \fB\-r\fR \fB\-a\fR5 \fB\-\-force-build\fR
+.TP
+\fB@package@\fR \fB\-u\fR @package@ \fB\-a\fR1,4,5,8 \fB\-\-arch\fR=noarch \fB\-\-rebuild\fR
+.TP
+\fB@package@\fR \fB\-u\fR @package@ \fB\-a\fR6
+.TP
+\fB@package@\fR \fB\-u\fR \fB\-c\fR \fB\-l\fR usr:pswd @package@ @version@ \fB\-a\fR10 \fB--server-upload\fR=0
+.TP
+\fB@package@\fR \fB\-u\fR @package@ @version@ \fB\-a\fR10 \fB--server-upload\fR=myrepos
+.TP
+\fB@package@\fR \fB\-u\fR @package@ \fB\-a\fR10 \fB\-\-norpm\fR \fB\-S\fR /var/tmp/specs/@package@.spec
+.TP
+\fB@package@\fR \fB\-u\fR @package@ \fB\-a\fR11 \fB\-\-force\fR
+.TP
+\fB@package@\fR \fB\-u\fR \fB\-\-help\fR
+.PD
+.RE
 
 .SS "Estrazione di file da pacchetti srpm"
 \fB@package@\fR \
@@ -284,6 +370,17 @@ estrae dal pacchetto srpm \fIsrpm_pck\fR...
 .TP
 \fB\-\-destdir\fR
 salva i file estratti nella cartella \fIdir\fR
+.TP
+\fIEsempi\fR
+.TP
+.PD 0
+\fB@package@\fR \fB\-x\fR @package@\-@version@\-1mamba.src.rpm \fB\-\-destdir=\fR/tmp/
+.TP
+\fB@package@\fR \fB\-x\fR @package@\-@version@\-1mamba.src.rpm \fB\-F\fR \e*.spec \fB\-\-destdir=\fR/tmp/
+.TP
+\fB@package@\fR \fB\-x\fR \fB\-\-help\fR
+.PD
+.RE
 
 .SS "Richiesta del valore di variabili presenti nei file di configurazione"
 \fB@package@\fR \
@@ -292,10 +389,21 @@ salva i file estratti nella cartella \fIdir\fR
 \fB\-C\fR, \fB\-\-config\fR
 utilizza un file di configurazione alternativo \fIconf_file\fR
 .br
-file di default: \fI@sysconfdir@/@pck_conf@\fR, \fI~/.@package@\fR
+file di default: vedere alla sezione \fBFILE DI CONFIGURAZIONE\fR
 .TP
 \fB\-\-eval\fR
 stampa il valore che \fIvar\fR assume nei file di configurazione
+.TP
+\fIEsempi\fR
+.TP
+.PD 0
+\fB@package@\fR \fB\-q\fR \fB\-\-eval\fR="logging_dir"
+.TP
+\fB@package@\fR -C /etc/@package@.d/02-specfile-rpm-groups.conf \fB\-\-eval\fR=rpm_allowed_groups
+.TP
+\fB@package@\fR \fB\-\-eval\fR \fB\-\-help\fR
+.PD
+.RE
 
 .SS "Modalita' operative"
 Sono inoltre disponibili alcune opzioni standard ed alcune opzioni di uso generale
@@ -316,47 +424,6 @@ abilita l'output colorato
 \fB\-D\fR, \fB\-\-debug\fR
 attiva la modalita' di debugging (output prolisso)
 
-.SH "ESEMPI"
-.B
-@package@
-\fB\-s\fR ~/software/@package@\-@version@.tar.bz2 \fB\-t\fR standard \fB\-o\fR @package@.spec
-.br
-.B
-@package@
-\fB\-s\fR ftp://ftp.gnu.org/pub/gnu/bash/bash-3.2.tar.gz
-.br
-.B
-@package@
-\fB\-u\fR @package@ @version@ \fB\-a\fR4 \fB\-f\fR \fB\-\-changelog\fR "changelog entry"
-.br
-.B
-@package@
-\fB\-\-log\fR \fB\-u\fR @package@ \fB\-a\fR5,7:9 \fB\-\-define\fR addons_ver=0.9
-.br
-.B
-@package@
-\fB\-c\fR \fB\-u\fR \fB\-l\fR usr:pswd @package@ @version@ \fB\-a\fR10 \fB--server-upload\fR=0
-.br
-.B
-@package@
-\fB\-u\fR @package@ \fB\-a\fR1,4,5 \fB\-\-arch\fR=noarch \fB\-\-rebuild\fR \fB\-\-ignore-test\fR 6,7
-.br
-.B
-@package@
-\fB\-u\fR @package@ \fB\-a\fR10 \fB\-\-norpm\fR \fB\-S\fR /var/tmp/specs/@package@.spec
-.br
-.B
-@package@
-\fB\-u\fR @package@ \fB\-a\fR11 \fB\-\-force\fR
-.br
-.B
-@package@
-\fB\-x\fR @package@\-@version@\-1mamba.src.rpm \fB\-F\fR \e*.spec \fB\-\-destdir=\fR/tmp/specs
-.br
-.B
-@package@
-\fB\-q\fR \fB\-C\fR @sysconfdir@/@package@.conf \fB\-\-eval=\fR"logging_dir"
-
 .SH AUTORI
 Davide Madrisan <davide.madrisan@gmail.com>
 .br
@@ -377,7 +444,14 @@ Mofiche per permettere l'utilizzo di autospec in multi-architettura.
 .SH "BACHI"
 Inviare patch, segnalazioni di bachi, richieste di funzionalita' a <davide.madrisan@gmail.com>.
 .br
-Nel caso di bachi riscontrati, effettuarne una descrizione accurata e possibilmente un modo per riprodurli.
+Nel caso di bachi riscontrati, effettuarne una descrizione accurata e possibilmente un modo per
+riprodurli.
+
+Per il debugging di un problema e' spesso utile il log completo dell'esecuzione
+di \fBautospec\fR con l'opzione \fB\-\-debug\fR, disattivando anche la traduzione dei messaggi,
+cioe' eseguendo:
+
+\fBLC_ALL=C autospec\fR ...
 
 .SH COPYRIGHT
 Copyright (C) 2004\-2012 Davide Madrisan <davide.madrisan@gmail.com>