NOME¶

deb-substvars - variabili sostituite nei sorgenti Debian

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

L'attuale architettura di compilazione (da dpkg --print-architecture).

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

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 dpkg-gencontrol viene usato du -k debian/tmp per trovare il valore predefinito.

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.

BUG¶

Il punto in cui avviene la sovrascrittura dei campi in relazione a certe impostazioni di campi di output standard non è molto chiaro.

VEDERE ANCHE¶

dpkg(1), dpkg-genchanges(1), dpkg-gencontrol(1), dpkg-shlibdeps(1), dpkg-source(1).