.\" dpkg manual page - deb-substvars(5) .\" .\" Copyright © 1995-1996 Ian Jackson .\" Copyright © 2000 Wichert Akkerman .\" Copyright © 2009-2010 Raphaël Hertzog .\" .\" This is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation; either version 2 of the License, or .\" (at your option) any later version. .\" .\" This is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program. If not, see . . .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH deb\-substvars 5 "15 luglio 2009" "Progetto Debian" "utilità dpkg" .SH NOME deb\-substvars \- variabili sostituite nei sorgenti Debian . .SH SINTASSI substvars . .SH DESCRIZIONE Prima che \fBdpkg\-source\fP, \fBdpkg\-gencontrol\fP e \fBdpkg\-genchanges\fP scrivano le loro informazioni di controllo (nel file sorgente di controllo \fB.dsc\fP per quanto riguarda \fBdpkg\-source\fP e sullo standard output per \fBdpkg\-gencontrol\fP e \fBdpkg\-genchanges\fP), effettuano alcune sostituzioni di variabili nel file di output. Una sostituzione di variabile ha la forma \fB${\fP\fInome\-variabile\fP\fB}\fP. I nomi di variabile sono formati da caratteri alfanumerici, trattini («\-») e due punti («:») e iniziano con un carattere alfanumerico. Le sostituzioni di variabili vengono eseguite ripetutamente fino a che non ne rimangono più; il testo completo del campo dopo la sostituzione viene analizzato di nuovo per cercare nuove sostituzioni. Una volta fatte tutte le sostituzioni, ciascuna occorrenza della stringa \fB${}\fP (che non è una sostituzione permessa) viene sostituita da un carattere \fB$\fP. Sebbene la sostituzione delle variabili viene fatta in tutti i campi di controllo, alcuni di tali campi sono usati e necessari durante la compilazione, quando la sostituzione non è ancora avvenuta. Questo è il motivo per cui non si possono usare variabili nei campi \fBPackage\fP, \fBSource\fP e \fBArchitecture\fP. La sostituzione delle variabili avviene nel contenuto dei campi dopo che sono stati analizzati, perciò se si desidera che una variabile si estenda su più righe non si deve aggiungere uno spazio dopo il ritorno a capo. Ciò viene fatto implicitamente quando il campo viene prodotto in output. Per esempio, se la variabile \fB${Description}\fP è impostata a «pinco è questo.${Newline}pinco è quest'altro.» e se si ha il campo seguente: Description: applicazione pinco ${Description} . Altro testo. Il risultato è: Description: applicazione pinco pinco è questo. pinco è quest'altro. . Altro testo. Le variabili possono essere impostate usando l'opzione comune \fB\-V\fP. Possono anche essere specificate nel file \fBdebian/substvars\fP (o qualsiasi altro file venga specificato usando l'opzione \fB\-T\fP). Il file è formato da righe nella forma \fInome\fP\fB=\fP\fIvalore\fP. Gli spazi bianchi alla fine di ogni riga, le righe vuote e le righe che iniziano con un simbolo \fB#\fP (commenti) vengono ignorati. In aggiunta, sono disponibili le seguenti variabili standard: .TP \fBArch\fP L'attuale architettura di compilazione (da \fBdpkg \-\-print\-architecture\fP). .TP \fBsource:Version\fP La versione del pacchetto sorgente. .TP \fBsource:Upstream\-Version\fP La versione del pachetto sorgente originale, inclusa l'epoca di versione Debian se presente. .TP \fBbinary:Version\fP La versione del pacchetto binario (che può essere diversa da source:Version ad esempio in un NMU binario). .TP \fBSource\-Version\fP La versione del pacchetto sorgente (dal file changelog). Questa variabile è ora \fBdeprecata\fP dato che il suo significato è diverso dalla sua funzione; usare \fBsource:Version\fP o \fBbinary:Version\fP a seconda delle necessità. .TP \fBInstalled\-Size\fP La dimensione totale dei file installati del pacchetto. Questo valore viene copiato nel campo corrispondente del file di controllo; impostandolo si modifica il valore di tale campo. Se questa variabile non è impostata \fBdpkg\-gencontrol\fP viene usato \fBdu \-k debian/tmp\fP per trovare il valore predefinito. .TP \fBExtra\-Size\fP Lo spazio su disco aggiuntivo usato quando il pacchetto viene installato. Se questa variabile viene impostata, il suo valore viene sommato a quello della variabile \fBInstalled\-Size\fP (usando il valore impostato esplicitamente oppure quello predefinito), prima di essere copiato nel campo \fBInstalled\-Size\fP del file di controllo. .TP \fBF:\fP\fInomecampo\fP Il valore in output del campo \fInomecampo\fP (che deve essere specificato usando le minuscole e maiuscole appropriate). L'impostazione di queste variabili non ha effetto, tranne dove esse vengono esplicitamente espanse. .TP \fBFormat\fP Il formato del file \fB.changes\fP generato da questa versione degli script di pacchettizzazione dei sorgenti. Se si imposta questa variabile, anche il contenuto del campo \fBFormat\fP nel file \fB.changes\fP cambia. .TP \fBNewline\fP, \fBSpace\fP, \fBTab\fP Queste variabili contengono ciascuna il carattere corrispondente: nuova riga, spazio e tabulazione. .TP \fBshlibs:\fP\fIcampodipendenza\fP L'impostazione di variabili con nomi in questa forma è generata da \fBdpkg\-shlibdeps\fP. .TP \fBdpkg:Upstream\-Version\fP La versione originale di dpkg. .TP \fBdpkg:Version\fP La versione completa di dpkg. .LP Se viene fatto riferimento a una variabile ma questa non è definita, viene generato un avvertimento e viene assunto un valore vuoto. . .SH FILE .TP \fBdebian/substvars\fP Elenco di variabili da sostituire e di valori. . .SH "VEDERE ANCHE" .ad l .nh \fBdpkg\fP(1), \fBdpkg\-genchanges\fP(1), \fBdpkg\-gencontrol\fP(1), \fBdpkg\-shlibdeps\fP(1), \fBdpkg\-source\fP(1).