Hoofdstuk 4. kdesrc-build configureren

Het configuratiebestand start met de globale optie, die als volgt is gespecificeerd:

global
option-name option-value
[...]
end global

Het wordt dan gevolgd door een of meer module secties, gespecificeerd in een van de volgende twee vormen:

Bij Git-modules, moet module-name een module zijn uit de KDE Git repository (bijvoorbeeld, kdeartwork of kde-wallpapers).

Bij Git modules, kunt u de module naam naar wens kiezen, zolang het geen duplicaat is van een andere module naam in de configuratie. Vergeet niet dat de layout van de broncode-map en de bouwmap gebaseerd zijn op de modulenaam als u de optie dest-dir niet gebruikt.

Echter, bij Git module sets moeten de module-names overeenkomen met de daadwerkelijke git modules in de gekozen repository. Zie git-repository-base of use-modules voor meer informatie.

In het algemeen wordt de gehele inhoud van de regel na de optienaam gebruikt als de optiewaarde.

Een wijziging die kdesrc-build uitvoert is dat een reeks "${naam-van-optie}" vervangen wordt door de waarde van die optie uit de globale configuratie. Dit biedt u om naar de waarde van bestaande opties te refereren, inclusief opties die al ingesteld zijn door kdesrc-build.

Om een hiervan een voorbeeld in gebruik te zien, zie Voorbeeld 2.1, “Make configureren om alle beschikbare CPU's te gebruiken, met uitzonderingen”.

U kunt ook uw eigen niet-standaard globale variabelen introduceren om naar te refereren verderop in de configuratie. Om dat te doen, moet uw optienaam vooraf worden gegaan door een underscore-symbool. Voorbeeld:

global
  _ver 6  # ← uw eigen variabele (begint met underscore)
  _kde ~/kde${_ver}  # ← eigen variabele kan een andere gedefinieerde variabele bevatten
  source-dir ${_kde}/src  # ← merk op dat geneste variabele (_kde → _ver) ook wordt opgelost
end global

options kdepim
  log-dir /custom/path/logs${_ver} # ← u kunt eigen variabele gebruiken net als een standaard
end options

Er is tenslotte een laatste type entry in een configuratiebestand, options groups, welke u kunt gebruiken waar een module of module-set kan worden gebruikt.

options module-name
option-name option-value
[...]
end options

In een options group kunt u opties ingesteld hebben net zoals bij een module declaratie, en hoort bij een bestaande module. De hierin ingestelde opties overschrijven de in de bijbehorende module ingestelde opties.

Dit is handig bij het declareren van een complete module-set van modules, die allemaal dezelfde opties gebruiken, om daarna options groups te gebruiken voor individuele wijzigingen.

options groups kunt u ook toepassen op benoemde module sets. Hierdoor kunnen expert gebruikers een algemene configuratiebestand (waarin module-set declaraties voorkomen) als startpunt gebruiken, en vervolgens wijzigingen op de opties toepassen die door die module-sets in configuratiebestanden worden gebruikt die het commando include gebruiken om naar het basisconfiguratie te refereren.

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

# kmix is een onderdeel van kde/kdemultimedia groep, ook als we 
# kmix nooit eerder in dit bestand hebben genoemd, zal kdesrc-build de wijziging ontdekken.
options kmix
  branch KDE/4.12
end options