KDE-programvara är uppdelad i olika komponenter, där en stor del kan byggas av kdesrc-build. Att förstå organisationen hjälper till att välja programvarumoduler att bygga.

Att välja vilka av möjliga moduler som ska byggas styrs av inställningsfilen. Efter sektionen global finns en lista av moduler att bygga, omgivna av raderna module ... end module. Ett exempel på en post för en modul visas i Exempel 2.4, ”Exempel på modulpost i inställningsfilen”.

module kdesrc-build-git
    # Alternativ för modulen anges här, exempelvis:
    repository kde:kdesrc-build
    make-options -j4 # Kör 4 kompileringar samtidigt
end module

När bara poster som module används, bygger kdesrc-build dem i ordningen som anges, och försöker inte ladda ner några andra arkiv utom de som är direkt angivna.

KDE:s källkod är uppdelad i ett stort antal relativ små Git-baserade arkiv. För att göra det enklare att hantera det stora antalet arkiv som är inblandade i alla användbara KDE-baserade installationer, stöder kdesrc-build gruppering av flera moduler och att behandla gruppen som en ”moduluppsättning”.

global
    git-repository-base kde-git kde:
end global

module qt
    # Alternativ borttagna för korthets skull
end module

module-set kde-support-libs
    repository kde-git
    use-modules automoc attica akonadi
end module-set

# Övriga moduler efter behov...
module kdesupport
end module

# Lägger bara till en modul för juk (arkivet kde/kdemultimedia/juk)
module-set juk-set
    repository kde-projects
    use-modules juk
end module-set

# Lägger till alla moduler som finns i kde/multimedia/*, inklusive juk,
# men inga andra beroenden
module-set multimedia-set
    repository kde-projects
    use-modules kde/multimedia
end module-set

# Lägger till alla moduler som finns i kde/multimedia/*, och alla beroenden
# på kde-projects utanför kde/kdemultimedia
module-set multimedia-deps-set
    repository kde-projects
    use-modules kde/multimedia
    include-dependencies true
end module-set

# Alla moduler som skapas av dessa tre moduluppsättningar läggs automatiskt i
# korrekt beroendeordning, oberoende av inställningen av include-dependencies

KDE:s Git-arkiv tillåter att relaterade Git-moduler grupperas i samlingar av relaterade moduler (t.ex. kdegraphics). Git känner inte till sådana grupperingar, men kdesrc-build kan förstå grupperna genom att använda moduluppsättningar med alternativet repository inställt till ”kde-projects”.

kdesrc-build förstår att arkivet kde-projects kräver särskild hantering, och justerar kompileringsprocessen därefter. Bland annat kommer kdesrc-build att:

Nästa exempel visar hur man använder KDEs moduldatabas för att installera multimediabiblioteket Phonon.

module-set media-support
    # Denna väljare måste vara kde-projects för att använda moduldatabasen.
    repository kde-projects

    # Denna väljare anger vilken modul som ska sökas efter i databasen.
    use-modules phonon/phonon phonon-gstreamer phonon-vlc
end module-set

Nästa exempel är kanske mer realistiskt, och visar en funktion som bara är tillgänglig med KDEs moduldatabas: Att bygga alla KDE:s grafikprogram med en enda deklaration.

module-set kdegraphics
    # Denna väljare måste vara kde-projects för att använda moduldatabasen.
    repository kde-projects

    # Denna väljare anger vilka moduler som ska sökas efter i databasen.
    use-modules kdegraphics/libs kdegraphics/*
end module-set

Här åskådliggörs två viktiga möjligheter:

Du kan bestämma dig för att du vill bygga alla program i en gruppering av KDE-moduler utom ett visst program.

Exempelvis inkluderar gruppen kdeutils ett program som heter kremotecontrol. Om datorn inte har lämplig hårdvara för att ta emot signaler som skickas från fjärrkontroller kanske du bestämmer att du inte vill ladda ner, bygga och installera kremotecontrol varje gång som kdeutils uppdateras.

Du kan åstadkomma det genom att använda inställningsalternativet ignore-modules. På kommandoraden gör väljaren --ignore-modules samma sak, men är bekvämare för att bara filtrera bort en modul en enstaka gång.

module-set utils
    repository kde-projects

     # Denna väljare anger vilka moduler som ska sökas efter i databasen.
    use-modules kdeutils

    # Denna väljare "subtraherar bort" moduler från modulerna som väljes av use-modules ovan.
    ignore-modules kremotecontrol
end module-set

module-set graphics
    repository kde-projects

    # Denna väljare anger vilka moduler som ska sökas efter i databasen.
    use-modules extragear/graphics

    #  Denna väljare "subtraherar bort" moduler från modulerna som väljes av use-modules ovan.
    # I detta fall, ignoreras *både* extragear/graphics/kipi-plugins
    # och extragear/graphics/kipi-plugins/kipi-plugins-docs
    ignore-modules extragear/graphics/kipi-plugins
end module-set