documentation: improve italian manpage
Signed-off-by: Davide Madrisan <davide.madrisan@gmail.com>
This commit is contained in:
Davide Madrisan
parent
4c0d56f1a1
commit
f38c13e4f6
@ -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 document `autospec-it-HOWTO'.
|
||||
Remove the partially obsolete document `autospec-it-HOWTO'.
|
||||
Update/improve the italian manpage by merging part of the italian HOWTO.
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
|
||||
@ -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
|
||||
|
||||
@ -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
|
||||
QiLinux (http://www.qilinux.org), permettendo la creazione di specfile standard e
|
||||
|
||||
.B @package@
|
||||
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
|
||||
(http://www.openmamba.org) per creare specfile, per aggiornare i pacchetti dei branch
|
||||
E' utilizzato attualmente nello sviluppo di
|
||||
.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.
|
||||
.br
|
||||
\fI\fR
|
||||
.br
|
||||
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.
|
||||
.if t .sp 0.5
|
||||
.if n .sp 1
|
||||
.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
|
||||
\fI\fR
|
||||
.br
|
||||
~/.@package@.d/00-devel.conf
|
||||
.br
|
||||
~/.@package@.d/01-devel-my.conf
|
||||
.br
|
||||
~/.@package@.d/02-devel-kde4.conf
|
||||
.br
|
||||
~/.@package@.d/03-devel-makedist.conf
|
||||
.br
|
||||
~/.@package@.d/04-devel-autodist.conf
|
||||
.br
|
||||
~/.@package@.d/05-devel-future.conf
|
||||
.if t .sp 0.5
|
||||
.if n .sp 1
|
||||
.RS
|
||||
.PD 0
|
||||
.TP
|
||||
~/.@package@.d/00-devel.conf
|
||||
.TP
|
||||
~/.@package@.d/01-devel-my.conf
|
||||
.TP
|
||||
~/.@package@.d/02-devel-kde4.conf
|
||||
.TP
|
||||
~/.@package@.d/03-devel-makedist.conf
|
||||
.TP
|
||||
~/.@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:
|
||||
.br
|
||||
\fI\fR
|
||||
.br
|
||||
@package@ \-s \\
|
||||
.br
|
||||
\fIEsempi\fR
|
||||
.TP
|
||||
.PD 0
|
||||
\fB@package@\fR \fB\-s\fR ~/software/@package@-@version@.tar.bz2 \fB\-t\fR standard \fB\-o\fR @package@.spec
|
||||
.TP
|
||||
\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
|
||||
-t library -n libavifile -v 0.7.45 \\
|
||||
-o /usr/src/RPM/SPECS/libavifile.spec
|
||||
\fB\-t\fR library \fB\-n\fR libavifile \fB\-v\fR 0.7.45 \\
|
||||
\fB\-o\fR /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>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user