Capitolo 4. Configurare kdesrc-build

Il file di configurazione parte con le opzioni globali, specificate come segue:

global
nome-opzione valore-opzione
[...]
end global

Seguono quindi una o più sezioni per i moduli, specificate in una delle due seguenti forme:

Per i moduli di Git, nome-modulo deve essere un modulo del deposito Git di KDE (per esempio, kdeartwork o kde-wallpapers).

Per i moduli di Git, il nome del modulo può essere fondamentalmente qualsiasi cosa vuoi, finché non duplica altri nomi di moduli nella configurazione. Tieni presente che la disposizione delle cartelle del codice sorgente e di generazione sarà basata sul nome del modulo se non usi l'opzione dest-dir.

Tuttavia, per gli insiemi di moduli di Git, i nomi-moduli devono corrispondere a dei veri moduli Git nel deposito (repository) scelto. Vedi git-repository-base o use-modules per maggiori informazioni.

In generale, l'intero contenuto della riga dopo nome-opzione viene utilizzato come valore-opzione.

Una modifica che kdesrc-build esegue è la sequenza «${nome-della-opzione}» sostituita dal valore di quella opzione preso dalla configurazione globale. Questo ti permette di fare riferimento al valore di opzioni esistenti, incluse le opzioni già impostate da kdesrc-build.

Per osservarne un esempio d'uso, vedi Esempio 2.1, «Configurare Make per utilizzare tutte le CPU disponibili, con eccezioni».

Nella configurazione puoi anche introdurre le variabili globali non standard personalizzate per futuro riferimento. Per farlo, il nome della tua opzione deve essere prefissato con trattino basso (underscore). Esempio:

global
  _ver 6  # ← la tua variabile personalizzata (inizia col trattino basso)
  _kde ~/kde${_ver}  # ← la variabile personalizzata può contenere un'altra variabile definita
  source-dir ${_kde}/src  # ← nota che è risolta anche la variabile annidata (_kde → _ver)
end global

options kdepim
  log-dir /custom/path/logs${_ver} # ← puoi usare una variabile personalizzata proprio come una standard
end options

C'è un ultimo tipo di voce del file di configurazione, i gruppi options, che possono essere presenti ovunque ci sia un module o un module-set.

options nome-modulo
nome-opzione valore-opzione
[...]
end options

Un gruppo options può includere opzioni impostate per sé stesso come qualsiasi dichiarazione di modulo, e viene associato al modulo corrente. Tutte le opzioni impostate in questo modo verranno usate per sostituirsi alle opzioni impostate nel modulo associato.

Questo è utile a dichiarare un intero module-set in cui tutti i moduli devono usare le stesse opzioni, e poi usare i gruppi options per fare modifiche individuali.

I gruppi options si applicano anche agli insiemi di moduli specificati. Questo consente agli utenti esperti di usare un file di configurazione comune (che include le dichiarazioni module-set) come base, e poi eseguire modifiche alle opzioni utilizzate da questi insiemi nei file di configurazione che utilizzano il comando include per fare riferimento alla configurazione di base.

module-set kde-multimedia-set
  repository kde-projects
  use-modules kde/kdemultimedia
  branch master
end module-set

# kmix fa parte del gruppo kde/kdemultimedia, e anche se non lo abbiamo mai
# nominato fin qui nel file, kdesrc-build capirà la modifica.
options kmix
  branch KDE/4.12
end options