I programmi di KDE sono divisi in diversi componenti, molti dei quali possono essere generati da kdesrc-build. Comprenderne l'organizzazione aiuterà a selezionare correttamente i moduli che vuoi generare.

La selezione di quali generare tra i moduli possibili è controllata dal file di configurazione. Dopo la sezione global c'è un elenco di moduli da generare, delimitato da righe module e end module. Una voce esemplificativa per un modulo viene mostrata nelEsempio 2.4, «Voce esemplificativa di un modulo nel file di configurazione».

module kdesrc-build-git
    # Le opzioni del modulo vanno qui, per esempio:
    repository kde:kdesrc-build
    make-options -j4 # Esegue 4 compilazioni alla volta
end module

Quando usi solo le voci module, kdesrc-build le genera nell'ordine elencato e non tenta di scaricare altri depositi oltre quelli che hai direttamente specificato.

Il codice sorgente di KDE è decomposto in un gran numero di depositi basati su Git relativamente piccoli. Per rendere più semplice la gestione del gran numero di depositi coinvolti in una qualsiasi installazione utile basata su KDE, kdesrc-build supporta il raggruppamento multiplo dei moduli e tratta il gruppo come un «insieme di moduli».

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

module qt
    # Opzioni rimosse per brevità
end module

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

# Altri moduli secondo necessità...
module kdesupport
end module

# Aggiunge solo un modulo per juk (il deposito kde/kdemultimedia/juk)
module-set juk-set
    repository kde-projects
    use-modules juk
end module-set

# Aggiunge tutti i moduli presenti in kde/multimedia/*, incluso juk,
# ma nessun altra dipendenza
module-set multimedia-set
    repository kde-projects
    use-modules kde/multimedia
end module-set

# Aggiunge tutti i moduli presenti in kde/multimedia/*, e tutte le dipendenze
# kde-projects che si trovano fuori da kde/kdemultimedia
module-set multimedia-deps-set
    repository kde-projects
    use-modules kde/multimedia
    include-dependencies true
end module-set

# Tutti i moduli creati al di fuori di questi tre gruppi di moduli sono automaticamente inseriti
# nell'ordine di dipendenza corretto, a prescindere dalle impostazioni di include-dependencies

I depositi Git di KDE consentono il raggruppamento dei moduli collegati a Git all'interno di collezioni di moduli collegati (per es. kdegraphics). Git non riconosce questi raggruppamenti, ma kdesrc-build lo può fare utilizzando gli insiemi di moduli con un'opzione repository impostata a «kde-projects».

kdesrc-build riconoscerà che il deposito kde-projects va trattato in modo speciale, e modificherà il processo di generazione conseguentemente. Tra le altre cose, kdesrc-build:

L'esempio seguente mostra come usare la banca dati dei moduli di KDE per installare la libreria multimediale Phonon.

module-set media-support
    # Questa opzione deve essere kde-projects per usare la banca dati dei moduli.
    repository kde-projects

    # Questa opzione sceglie quali moduli cercare nella banca dati.
    use-modules phonon/phonon phonon-gstreamer phonon-vlc
end module-set

L'esempio seguente è forse più realistico, e mostra una funzionalità disponibile solo con la banca dati dei moduli di KDE: generare tutte le applicazioni grafiche di KDE con una sola dichiarazione.

module-set kdegraphics
    # Questa opzione deve essere kde-projects per usare la banca dati dei moduli.
    repository kde-projects

    # Questa opzione sceglie quali moduli cercare nella banca dati.
    use-modules kdegraphics/libs kdegraphics/*
end module-set

Due importanti capacità sono qui dimostrate:

Potresti decidere di voler generare tutti i programmi di un certo gruppo di moduli di KDE tranne uno in particolare.

Per esempio, il gruppo kdeutils contiene un programma chiamato kremotecontrol. Se la tua macchina non ha l'hardware necessario per ricevere i segnali inviati da un telecomando, potresti decidere di non voler scaricare, generare e installare kremotecontrol ogni volta che aggiorni kdeutils.

Puoi farlo utilizzando l'opzione di configurazione ignore-modules. Sulla riga di comando l'opzione --ignore-modules esegue la stessa cosa, ma è più comoda per filtrare un modulo solo una volta.

module-set utils
    repository kde-projects

    # Questa opzione sceglie quali moduli cercare nella banca dati.
    use-modules kdeutils

    # Questa opzione «sottrae» i moduli da quelli scelti da use-modules sopra.
    ignore-modules kremotecontrol
end module-set
module-set graphics
    repository kde-projects

    # Questa opzione sceglie quali moduli cercare nella banca dati.
    use-modules extragear/graphics

    # Questa opzione «sottrae» i moduli da quelli scelti da use-modules sopra.
    # In questo caso, sia extragear/graphics/kipi-plugins che
    # extragear/graphics/kipi-plugins/kipi-plugins-docs vengono ignorati.
    ignore-modules extragear/graphics/kipi-plugins
end module-set