Det möjligt att ladda ner ett helt arkiv men låta byggsystemet utelämna ett antal kataloger när byggprocessen utförs. Det kräver att modulen använder CMake och att modulens byggsystem tillåter att katalogen som ska tas bort är valfri.

Det bestäms med alternativet do-not-compile.

module kdebindings
  do-not-compile python
end module

Git stöder hantering av historik för KDE:s källkod. KDE använder stödet för att skapa grenar för utveckling, och att ge arkivet en tagg då och då med utgåvan av en ny version.

Till exempel kan utvecklarna av KMail arbeta med en ny funktion i en annan gren för att undvika att förstöra versionen som används av de flesta utvecklare. Grenen har pågående utveckling, samtidigt som huvudgrenen (som kallas master) kan ha pågående utveckling.

En tagg är å andra sidan en ögonblicksbild av källkodsarkivet vid en viss tid. Det används av KDE:s administrationsgrupp för att markera en version av koden som är lämplig för en utgåva och fortfarande tillåta att utvecklare arbetar med koden.

Stöd för grenar och taggar hanteras med en uppsättning alternativ, som rör sig från en generell begäran om en version, till en specifik webbadress att ladda ner för avancerade användare.

Det enklaste sättet är att använda alternativen branch och tag. Du använder helt enkelt alternativet tillsammans med namnet på den önskade grenen eller taggen för en modul, så försöker kdesrc-build avgöra lämplig plats i KDE:s arkiv att ladda ner från. För de flesta moduler i KDE fungerar det mycket bra.

module kdelibs
  branch 4.6
  # övriga alternativ...
end module

module kdemultimedia
  tag 4.6.1
  # övriga alternativ...
end module

kdesrc-build stöder två alternativ i situationer då branch och tag gissar fel angående den riktiga sökvägen: module-base-path och override-url.

kdesrc-build uppdaterar, bygger och installerar normalt alla moduler i den angivna listan över moduler att bygga, även om en modul misslyckas att bygga. Detta är vanligtvis en bekvämlighet för att du ska kunna uppdatera programvarupaket även om ett enkelt misstag görs i ett av källkodsarkiven under utvecklingen som gör att bygget fallerar.

Du kan dock önska att kdesrc-build stoppar vad det gör när det inte lyckas att bygga och installera en modul. Det kan hjälpa dig att spara tid som kommer att gå till spillo på att komma vidare när moduler som finns kvar i bygglistan inte heller kommer att kunna byggas med lyckat resultat, särskilt om du aldrig har lyckats bygga modulerna i listan.

Den primära metoden för att göra det är att använda kommandoradsväljaren --no-stop-on-failure när kdesrc-build körs.

Väljaren kan också anges i inställningsfilen för att göra den till normalt beteende.

Det är också möjligt att tala om för kdesrc-build att sluta bygga under körning efter att ha slutfört den aktuella modulen den arbetar med. Det är i motsats till att avbryta kdesrc-build med ett kommando som Ctrl+C, vilket avbryter kdesrc-build omedelbart, och förlorar arbetet för den aktuella modulen.

Som nämnts ovan är det möjligt att få kdesrc-build att snyggt avsluta tidigt när det väl har slutfört modulen det arbetar med. För att göra det måste du skicka signalen POSIX HUP till kdesrc-build

Du kan göra detta med ett kommando som pkill (på Linux®-system) enligt följande:

$ pkill -HUP kdesrc-build

Om det lyckas kommer du att se ett meddelande i utmatningen från kdesrc-build som liknar:

[ build ] tog emot SIGHUP, kommer att avsluta efter den här modulen

När kdesrc-build har bekräftat signalen kommer den att sluta bearbetningen efter att den aktuella modulen har byggts och installerats. Om kdesrc-build fortfarande uppdaterar källkoden när begäran tas emot, kommer kdesrc-build att stoppa efter uppdateringen av modulens källkod är klar. När både uppdaterings- och byggprocessen har stoppats tidigt, kommer kdesrc-build skriva ut sina delresultat och avsluta.

kdesrc-build innehöll tidigare funktioner för att automatiskt försöka bygga om modulen efter ett fel (eftersom ibland fungerade försöket att göra om, på grund av fel i byggsystemet vid den tiden). Tack vare bytet till CMake lider inte byggsystemet längre av dessa fel, och därför försöker inte kdesrc-build bygga en modul mer än en gång. Det finns dock situationer då kdesrc-build automatiskt utför åtgärder.

Om du gör en ändring i en moduls inställningsalternativ, eller om modulens källkod ändras på ett sätt som kdesrc-build inte känner igen, kan du behöva bygga om modulen manuellt.

Du kan göra det genom att helt enkelt köra kdesrc-build --refresh-build modul.

Om du skulle vilja att kdesrc-build istället automatiskt bygger om modulen under nästa normala bygguppdatering, kan du skapa en särskild fil. Varje modul har en byggkatalog. Om du skapar en fil som heter .refresh-me i en moduls byggkatalog, bygger kdesrc-build om modulen nästa gång byggprocessen sker, även om det normalt skulle utföra den snabbare inkrementella byggprocessen.

% touch ~/kdesrc/build/kdelibs/.refresh-me
% kdesrc-build

Du kan tala om för kdesrc-build att börja bygga från en annan modul än det normalt skulle göra. Det kan vara användbart när en uppsättning moduler misslyckades, eller om du avbröt en körning i mitten. Du kan styra det med väljarna --resume-from och --resume-after.

% kdesrc-build --resume-from=kdebase

% kdesrc-build --resume-after=kdebase

Om det senaste bygget med kdesrc-build slutade med ett byggfel, kan du också använda kommandoradsväljaren --resume, som återupptar det senaste bygget med modulen som misslyckades. Källkods- och metadatauppdateringar hoppas också över (men om du behöver dem, är det i allmänhet bättre att använda --resume-from istället).

På samma sätt som du kan återuppta byggprocessen från en modul, kan du istället välja att uppdatera och bygga normalt, men ignorera en uppsättning moduler.

Du kan göra det med väljaren --ignore-modules. Den talar om för kdesrc-build att ignorera alla följande moduler på kommandoraden när en uppdatering och byggprocess utförs.

% kdesrc-build --ignore-modules extragear/multimedia kdereview

Du kan ändra uppsättningen alternativ som läses från inställningsfilen direkt från kommandoraden. Ändringen överskrider inställningen i filen, men är bara tillfällig. Den gäller bara så länge den fortfarande är närvarande på kommandoraden.

kdesrc-build låter dig ändra alternativ namngivna som alternativnamn genom att ange en väljare på kommandoraden på formen --alternativnamn=värde. kdesrc-build känner igen om det inte vet vad alternativet är, ock söker efter namnet i sin lista med alternativnamn. Om det inte känner igen namnet, får du en varning, annars kommer det ihåg värdet du ställde in det till och överskrider en eventuell inställning från filen.

% kdesrc-build --pretend --källkodskatalog=/dev/null

Det är också möjligt att bara ändra alternativ för en viss modul. Syntaxen är liknande: --modul,alternativnamn=värde.

Ändringen överskrider eventuell duplicerad inställning för modulen som hittas i inställningsfilen, och gäller bara när alternativet skickas med på kommandoraden.

% kdesrc-build --kdeedu,byggkatalog=temporärbygg