Capítol 4. Configurar el kdesrc-build

El fitxer de configuració comença amb les opcions globals, especificades com les següents:

global
nom_opció valor_opció
[...]
end global

Després li segueixen una o més seccions de mòdul, especificades en una de les dues formes següents:

Per als mòduls Git, el nom_mòdul haurà de ser un mòdul del repositori Git del KDE (per exemple, kdeartwork o kde-wallpapers).

Per als mòduls basats en Git, el nom_mòdul podrà ser essencialment el que vulgueu, sempre que no dupliqueu cap altre nom de mòdul a la configuració. Recordeu que la disposició del directori de codi font i de construcció es basarà en el nom del mòdul si no utilitzeu l'opció dest-dir.

No obstant això, per als conjunts de mòduls de Git, els noms_mòduls s'hauran de correspondre amb els mòduls git reals en el repository triat. Vegeu git-repository-base o use-modules per a més informació.

En general, s'utilitza el contingut de tota la línia després de la secció nom_opció, així com el valor_opció.

Una modificació que realitza el kdesrc-build és que se substitueix una seqüència "${nom_opció}" pel valor d'aquesta opció des de la configuració global. Això permet fer referència al valor de les opcions existents, incloses les opcions ja establertes pel kdesrc-build.

Per a veure un exemple d'aquest ús, vegeu l'Exemple 2.1, «Configurar el Make per a emprar totes les CPU disponibles, amb excepcions».

També podeu presentar les vostres pròpies variables globals no estàndards per a referenciar-les més endavant a la configuració. Per a fer-ho, el nom de la vostra opció s'hauria d'anteposar amb el símbol de subratllat. Exemple:

global
  _ver 6  # ← la variable personalitzada (comença amb subratllat)
  _kde ~/kde${_ver}  # ← la variable personalitzada pot contenir una altra variable definida
  source-dir ${_kde}/src  # ← fixeu-vos en la variable imbricada (_kde → _ver) també es resol
end global

options kdepim
  log-dir /custom/path/logs${_ver} # ← podeu fer servir una variable personalitzada com una d'estàndard
end options

Hi ha un tipus final d'entrada al fitxer de configuració, grups options, els quals es poden indicar sempre que es pugui utilitzar module o module-set.

options nom_mòdul
nom_opció valor_opció
[...]
end options

Un grup options pot tenir conjunts d'opcions com una declaració de mòdul, i està associat amb un mòdul existent. Qualsevol opció establerta d'aquesta manera s'utilitzarà per a superposar les opcions establertes per al mòdul associat.

Això és útil per a permetre la declaració de tot un module-set, tots amb les mateixes opcions i després utilitzant grups options per a fer canvis individuals.

Els grups options també poden aplicar-se a conjunts de mòduls amb nom. Això permet als usuaris experts utilitzar un fitxer de configuració comú (el qual inclourà les declaracions de module-set) com a línia de base, i després fer canvis a les opcions utilitzades per aquests conjunts de mòduls en els fitxers de configuració que fan servir l'ordre include per a fer referència a la configuració base.

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

# kmix forma part del grup kde/kdemultimedia, encara que no hem anomenat
# mai el kmix en aquest fitxer, el kdesrc-build esbrinarà el canvi.
options kmix
  branch KDE/4.12
end options