SINTASSI

substvars

DESCRIZIONE

Prima che dpkg-source, dpkg-gencontrol e dpkg-genchanges scrivano le loro informazioni di controllo (nel file sorgente di controllo .dsc per quanto riguarda dpkg-source e sullo standard output per dpkg-gencontrol e dpkg-genchanges), effettuano alcune sostituzioni di variabili nel file di output.

Una sostituzione di variabile ha la forma ${nome-variabile}. 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 ${} (che non è una sostituzione permessa) viene sostituita da un carattere $.

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 Package, Source e Architecture.

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 ${Description} è 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 -V. Possono anche essere specificate nel file debian/substvars (o qualsiasi altro file venga specificato usando l'opzione -T). Il file è formato da righe nella forma nome=valore. Gli spazi bianchi alla fine di ogni riga, le righe vuote e le righe che iniziano con un simbolo # (commenti) vengono ignorati.

In aggiunta, sono disponibili le seguenti variabili standard:

Arch

The current host architecture (i.e. the architecture the package is being built for, the equivalent of DEB_HOST_ARCH).

source:Version

La versione del pacchetto sorgente.

source:Upstream-Version

La versione del pachetto sorgente originale, inclusa l'epoca di versione Debian se presente.

binary:Version

La versione del pacchetto binario (che può essere diversa da source:Version ad esempio in un NMU binario).

Source-Version

La versione del pacchetto sorgente (dal file changelog). Questa variabile è ora deprecata dato che il suo significato è diverso dalla sua funzione; usare source:Version o binary:Version a seconda delle necessità.

Installed-Size

The approximate total size of the package's installed files. This value is copied into the corresponding control file field; setting it will modify the value of that field. If this variable is not set dpkg-gencontrol will compute the default value by accumulating the size of each regular file and symlink rounded to 1 KiB used units, and a baseline of 1 KiB for any other filesystem object type.

Note: Take into account that this can only ever be an approximation, as the actual size used on the installed system will depend greatly on the filesystem used and its parameters, which might end up using either more or less space than the specified in this field.

Extra-Size

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 Installed-Size (usando il valore impostato esplicitamente oppure quello predefinito), prima di essere copiato nel campo Installed-Size del file di controllo.

F:nomecampo

Il valore in output del campo nomecampo (che deve essere specificato usando le minuscole e maiuscole appropriate). L'impostazione di queste variabili non ha effetto, tranne dove esse vengono esplicitamente espanse.

Format

Il formato del file .changes generato da questa versione degli script di pacchettizzazione dei sorgenti. Se si imposta questa variabile, anche il contenuto del campo Format nel file .changes cambia.

Newline, Space, Tab

Queste variabili contengono ciascuna il carattere corrispondente: nuova riga, spazio e tabulazione.

shlibs:campodipendenza

L'impostazione di variabili con nomi in questa forma è generata da dpkg-shlibdeps.

dpkg:Upstream-Version

La versione originale di dpkg.

dpkg:Version

La versione completa di dpkg.

Se viene fatto riferimento a una variabile ma questa non è definita, viene generato un avvertimento e viene assunto un valore vuoto.

FILE

debian/substvars

Elenco di variabili da sostituire e di valori.