Kommandoradsväljare och miljövariablerInnehållsförteckning
kdesrc-build är konstruerat för att köras på följande sätt:
kdesrc-build [--väljare...] [moduler att bygga...]
Om inga moduler att bygga anges på kommandoraden, bygger kdesrc-build alla moduler som är definierade i inställningsfilen, i den ordning de anges i filen (även om det kan ändras av diverse alternativ i inställningsfilen).
Den fullständiga listan med kommandoradsväljare anges i ”Kommandoradsväljare som stöds”. De oftast använda väljarna omfattar:
--pretend(eller-p)Väljaren gör att kdesrc-build indikerar vilka åtgärder som skulle utföras, utan att verkligen implementera dem. Det kan vara användbart för att försäkra dig om att modulerna som du tror du bygger verkligen kommer att byggas.
--refresh-buildVäljaren tvingar kdesrc-build att bygga de angivna modulerna från en fullständigt ren utgångspunkt. Eventuella befintliga byggkataloger för modulerna tas bort och byggs om. Väljaren är användbar om du får fel när en modul byggs, och krävs ibland när Qt™- eller KDE-bibliotek ändras.
--no-srcAlternativet hoppar över uppdateringsprocessen av källkoden. Du kan vilja använda det om du uppdaterade källkoden nyligen (kanske gjorde du det manuellt, eller körde nyligen kdesrc-build), men ändå vill bygga om vissa moduler.
--no-buildVäljaren liknar
--no-srcovan, men den här gången hoppas byggprocessen över.
I allmänhet är det så enkelt som att ange modulnamnet definierat i inställningsfilen för att ange moduler att bygga. Du kan också ange moduler som ingår i en moduluppsättning, antingen som de namnges under use-modules, eller med hela moduluppsättningen, om du har givit den ett namn.
I det specifika fallet med moduluppsättningar baserade på KDE:s projektdatabas, expanderar kdesrc-build modulnamnets komponenter för att bestämma exakt den modul du vill ha. Exempelvis placerar KDE:s projektposten för kdesrc-build projektet i extragear/utils/kdesrc-build. Du måste ange något av följande för att bygga kdesrc-build:
%kdesrc-build+extragear/utils/kdesrc-build%kdesrc-build+utils/kdesrc-build%kdesrc-build+kdesrc-build
Notera
Kommandona i föregående exempel inledde modulnamn med +. Det tvingar modulnamnet att tolkas som en modul från KDE:s projektdatabas, även om modulen inte har definierats i inställningsfilen.
Var försiktig med att ange mycket generella projekt (t.ex. extragear/utils ensamt), eftersom det kan leda till att ett stort antal moduler byggs. Du bör använda väljaren --pretend innan en ny modul byggs för att försäkra dig om att bara de moduler du vill kommer att byggas.