Hoofdstuk 4. De 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), ofschoon het mogelijk is om dit te omzeilen als u handmatig de Git URL specificeert.

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.

Eén 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 voorbeeld van dit gebruik te zien, zie Voorbeeld 2.1, “Make configureren om alle beschikbare CPU's te gebruiken, met uitzonderingen”.

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