Schakelt de asynchronous modus in, zodat de update van de broncode en het bouwproces van modules tegelijk kan gebeuren. Dit is de standaardinstelling, u hoeft deze optie alleen op te geven als u het in het configuratiebestand heeft uitgeschakeld.

Toont voor dit script alleen een eenvoudige hulp.

Toont de programma-versie.

Toont informatie over kdesrc-build en het besturingssysteem wat nuttig kan zijn in bugrapporten of bij vragen om hulp in forums of op e-maillijsten.

Beschikbare sinds versie 18.11.

Laat kdesrc-build de eenmalige initiële instelling doen nodig om het systeem voor te bereiden om kdesrc-build te laten werken en om de nieuw geïnstalleerde KDE software uit te voeren.

Dit omvat:

Deze optie is exact gelijk aan het gebruiken van --install-distro-packages --generate-config --update-shellrc op hetzelfde moment.

Installeert pakketten uit de distribution (op ondersteunde Linux® distributies) nodig om het systeem voor te bereiden op gebruik van kdesrc-build en om de nieuw geïnstalleerde KDE software te draaien.

Zie ook --initial-setup

Genereert het configuratiebestand van kdesrc-build.

Zie ook --initial-setup

Bewerk de "~/.bashrc" (of een ander shell-rc bestand) om kdesrc-build toe te voegen aan uw variabele $PATH en automatisch aanvullen in te schakelen.

Zie ook --initial-setup

Toont contactinformatie van de auteur.

Kleurrijke uitvoer inschakelen (dit is de standaard voor interactieve terminals).

Een map .vscode genereren met configuraties voor bouwen en debuggen in Visual Studio Code.

Deze waarde wijzigt de prioriteit voor de computer CPU zoals verlangt door kdesrc-build, en zou in de range van 0-20 moeten liggen. 0 is de hoogste prioriteit (omdat dat het minste “nice” is), 20 is de laagste prioriteit. De standaardinstelling van kdesrc-build is 10.

Schakelt de asynchronous modus van de update uit. In plaats daarvan zal de update in zijn geheel worden uitgevoerd voordat de bouw start. Deze optie vertraagt het gehele proces, maar als u last heeft van IPC fouten tijdens het gebruik van kdesrc-build, probeer dan het gebruik van deze optie, en dien een bug rapport in.

Schakelt "gekleurde uitvoer" uit.

kdesrc-build zal door het update en bouwproces gaan, maar in plaats van enige actie voor het updaten en bouwen daadwerkelijk uit te voeren, zal het de uitvoer tonen van wat het script zou hebben gedaan (b.v. welke commando's uit te voeren, welke algemene stappen zijn genomen, enz.).

Wees niet zo luidruchtig met de uitvoer. Met dit ingeschakeld zal alleen het minimum in de uitvoer te zien zijn.

Alleen waarschuwingen/fouten worden getoond.

Beschrijft uitgebreid wat er gebeurt, en wat kdesrc-build aan het doen is.

Voert alleen het bijwerken van de broncode uit.

Voert alleen het bouwproces uit.

Als dit de enige commandoregelparameter is, dan probeert het alle modules te installeren die voorkomen in log/latest/build-status. Als u commandoregelparameters specificeert na --install-only, dan wordt aangenomen dat dit allemaal te installeren modules zijn (zelfs als ze bij de laatste run niet succesvol gebouwd zijn).

Voert alleen het metadata downloadproces uit. kdesrc-build doet dit normaal automatisch, maar u wilt dit wellicht handmatig doen zodat de commandoregelparameter --pretend kan werken.

Gebruik deze optie om alleen die modules te bouwen die eerder mislukt zijn bij uitvoeren van kdesrc-build. Dit is handig als een belangrijk aantal mislukkingen optraden gemend met succesvol bouwen. Na het repareren van de oorzaken van de mislukkingen kunt u dan gemakkelijk alleen de modulen bouwen die eerder mislukten.

Deze optie is toegevoegd in kdesrc-build 15.09.

Deze optie veroorzaakt dat kdesrc-build automatisch andere KDE en Qt™ modulen invoegt in het bouwen, indien vereist voor de modulen die u hebt gevaagd om te bouwen op de opdrachtregel of in uw configuratiebestand.

De modulen die zijn toegevoegd zijn zoals opgenomen in de broncode van het KDE beheersysteem. Zie de paragraaf met de naam “De officiële database voor KDE-modulen”.

Het corresponderende configuratiebestandsoptie is include-dependencies.

U kunt ook --no-include-dependencies gebruiken, die automatisch invoegen van extra afhankelijkheidsmodulen uitsluitent.

Neem niet de modulen mee die in de rest van de commandoregel worden doorgegeven in het bijwerken/bouwprocess (dit is handig als u de meeste modulen in uw configuratiebestand wilt bouwen en alleen een paar overslaan).

Contact maken met de Git-server overslaan.

Het bouwproces overslaan.

Download niet automatisch de voor KDE git modules benodigde extra metadata. De updates van de broncode voor de modules zelf zal nog gewoon gebeuren tenzij u ook --no-src opgeeft.

Dit kan handig zijn als u frequent kdesrc-build herhaalt omdat de metadata niet vaak wijzigt. Maar merk op dat het voor veel andere functionaliteiten nodig is dat de metadata beschikbaar is. U kunt overwegen om eenmalig kdesrc-build met de optie --metadata-only te gebruiken en daarna deze optie voor de daaropvolgende runs te gebruiken.

Installeert niet automatisch pakketten nadat ze zijn gebouwd.

Deze optie schakelt expliciet het overslaan van het bouwproces uit (een optimalisatie gecontroleerd door de optie build-when-unchanged). Dit is handig om te zorgen dat kdesrc-build het bouwproces uitvoert als u iets heeft gewijzigd dat kdesrc-build niet kan controleren.

--force-build heeft dezelfde functie, en is misschien makkelijker te onthouden.

Schakelt de debug modus van het script in. Op dit moment houd dat in dat alle uitvoer naast dat het zoals normaal naar de log-map gaat ook naar de gewone uitvoer gaat. Daarnaast geven veel functies in de debug modus meer commentaar over wat ze aan het doen zijn.

Dit commando veroorzaakt dat kdesrc-build een parameter opvraagt van de modules in de bouwlijst (ofwel doorgegeven op de commandoregel of gelezen uit het configuratiebestand), waarna het resultaat op het scherm wordt getoond (één module per regel).

Deze optie moet geleverd worden met een “query-modus”, die één van de volgende zou moeten zijn:

Als een enkele module wordt doorgegeven op de opdrachtregel, dan is de uitvoer gewoon de waarde van de parameter die wordt afgevraagd. Als meerdere (of geen) modulen worden doorgegeven op de opdrachtregel, dan wordt elke regel voorafgegaan door de naam van de module. In alle gevallen zal kdesrc-build stoppen met de uitvoering wanneer elke waarde is uitgevoerd.

Deze optie is toegevoegd in kdesrc-build 16.05.

kactivities: master
kdepim: master

Maakt het bouwsysteem en make opnieuw vanaf het begin aan.

Start cmake (voor KDE modules) of configure (voor Qt™) opnieuw, zonder de bouwmap op te ruimen. U zou normaal gesproken dit niet hoeven te specificeren, omdat kdesrc-build het zal detecteren als u relevante optiewaarden heeft gewijzigd en automatisch de build setup opnieuw zal uitvoeren. Deze optie is wordt uitgevoerd als u --refresh-build gebruikt.

Deze optie gebruikt u om de bouw te hervatten vanaf de opgegeven module, wat de volgende optie op de commandoregel zou zijn. Specificeer geen andere modulenamen op de commandoregel.

Zie ook: --resume-after (of --after of -a) en de paragraaf met de naam “Hervatten na een mislukte of afgebroken bouwproces”. U geeft waarschijnlijk de voorkeur aan deze commandoregelparameter als u het probleem met het bouwen heeft opgelost en wilt dat kdesrc-build verder gaat met het bouwen.

Deze optie gebruikt u om de bouw te hervatten na de opgegeven module, wat de volgende optie op de commandoregel zou zijn. Specificeer geen andere modulenamen op de commandoregel.

Zie ook: --resume-after (of --after of -a) en de paragraaf met de naam “Hervatten na een mislukte of afgebroken bouwproces”. U geeft waarschijnlijk de voorkeur aan deze commandoregeloptie als u het probleem met het bouwen heeft opgelost en de module zelf heeft gebouwd en geïnstalleerd, en wilt dat kdesrc-build verder gaat met het bouwen van de volgende module.

Deze optie kan gebruikt worden om kdesrc-build uit te voeren nadat het bouwen is mislukt.

Het hervat het bouwen vanaf de module die is mislukt, met gebruik van de lijst van modules die eerder wachten om te worden gebouwd en schakelt eveneens het bijwerken van broncode en metagegevens uit. Dit is te gebruiken wanneer een eenvoudige vergissing of ontbrekende afhankelijkheid het bouwen laat mislukken. Nadat u de fout hebt gerepareerd kunt u snel terug gaan naar het bouwen van de modules die u eerder aan het bouwen was, zonder te rommelen met --resume-from en --stop-before.

Deze optie is toegevoegd in kdesrc-build 1.16.

Deze commandoregeloptie gebruikt u om het bouwproces te stoppen net voor een module normaal gesproken zou worden gebouwd.

Bijvoorbeeld, als het normale bouwproces is moduleA, moduleB, moduleC, dan zal --stop-before=moduleB veroorzaken dat kdesrc-build alleen moduleA zal bouwen.

Deze optie voor de opdrachtregel is toegevoegd in kdesrc-build 1.16.

Deze commandoregeloptie gebruikt u om het bouwproces te stoppen net na een module normaal gesproken zou worden gebouwd.

Bijvoorbeeld, als het normale bouwproces is moduleA, moduleB, moduleC, dan zal --stop-after=moduleB veroorzaken dat kdesrc-build zowel moduleA en moduleB zal bouwen.

Deze optie voor de opdrachtregel is toegevoegd in kdesrc-build 1.16.

Deze optie bestuurt of het bouwen wordt afgebroken zodra er iets mislukt. Standaard gedrag is--stop-on-failure. U kunt er overheen gaan om te proberen door te gaan met de rest van de modules in het bouwen om tijdverspilling te voorkomen in het geval er een probleem is met een enkele module.

Deze optie is toegevoegd in kdesrc-build 1.16. Zie ook de optie van het configuratiebestand stop-on-failure.

Dit interpreteert de volgende commandoregelparameter als het bestand waarvan de configuratiegegevens moeten worden ingelezen. De standaardwaarde voor deze parameter is kdesrc-buildrc (deze wordt in de huidige werkmap gezocht). Als dit bestand niet bestaat, zal ~/.config/kdesrc-buildrc ($XDG_CONFIG_HOME/kdesrc-buildrc, als $XDG_CONFIG_HOME is ingesteld) in plaats daarvan worden gebruikt. Zie ook Hoofdstuk 4, De kdesrc-build configureren.

Neemt alle acties tot en met opnieuw ordenen van moduleafhankelijkheid gespecificeerd op de opdrachtregel (of configuratiebestand), toont één per regel de modules die verwerkt zouden worden en eindigt dan zonder verdere actie.

De metagegevens van kde-project wordt eerst gedownload (maar, zie --pretend of --no-src).

De meldingen zijn niet volledig compatibel met gebruik door scripts omdat andere meldingen gegenereerd kunnen worden totdat de lijst met modules wordt getoond.

Dit is vooral handig om snel te bepalen wat kdesrc-build begrijpt wat de afhankelijkheden van een module zijn, wat inhoud dat het alleen bruikbaar is bij modules van kde-projects. Deze optie is ook te combineren met --resume-from, --resume-after, --stop-before, --stop-after.

Maakt een lijsts met de modules die gebouwd zouden worden, in de volgorde waarin ze gebouwd worden. Indien van toepassing, bevat de uitvoerlijst ook welke commit/branch/tag geselecteerd zou worden voor checkout.

Deze optie is gelijk aan --print-modules. Voor meer gedetailleerde informatie over hoe modules in relatie staan tot elkaar, zie ook: --dependency-tree.

Drukt informatie over afhankelijkheden af over de modulen die gebouwd zouden worden in boomstructuurformaat (recursief). Getoonde informatie omvat ook waarvan specifieke commit/branch/tag afhankelijk is en of wel of niet de afhankelijkheid zou worden gebouwd. Let op: de gegenereerde uitvoer kan behoorlijk groot worden voor toepassingen met veel afhankelijkheden.

Deze optie interpreteert het volgende item op de commandoregel als een uit te voeren programma, en kdesrc-build zal dan het inlezen van het configuratiebestand beëindigen, de omgevingsvariabelen zoals normaal bijwerken, en het opgegeven programma opstarten.

Dit zal in de meeste gevallen echter geen shell met de omgevingsvariabelen van kdesrc-build opstarten, omdat interactieve shells tijdens de start standaard tenminste een gedeelte van de omgevingsvariabelen (zoals PATH en KDEDIRS) resetten.

$ kdesrc-build --run printenv
KDE_SESSION_VERSION=4
SDL_AUDIODRIVER=alsa
LANGUAGE=
XCURSOR_THEME=Oxygen_Blue
LESS=-R -M --shift 5
QMAIL_CONTROLDIR=/var/qmail/control
... etc.

Hiermee kunt u de map wijzigen waar in KDE vanaf de commandoregel zal worden geïnstalleerd. Deze optie houd --reconfigure in, maar het gebruik van --refresh-build kan nodig zijn.

Deze optie zorgt ervoor dat kdesrc-build voor elke Git module een specifieke genummerde revisie uitcheckt, daarmee alle voor deze modules ingestelde branch, tag, of revision optie's overschrijvent.

Deze optie is waarschijnlijk geen good idee, en is alleen ondersteund vanwege compatibiliteit met oudere versies van het script.

Deze optie zorgt er voor dat kdesrc-build het bouwen van een module afbreekt net voordat het commando make zou worden opgestart. Dit wordt alleen ondersteund vanwege de compatibiliteit met oudere versies, Deze functionaliteit is niet behulpzaam bij het huidige KDE build systeem.

Deze optie zorgt er voor dat kdesrc-build de mappen met broncode verwijdert waarin gebruikersdata kan voorkomen, zodat de module opnieuw kan worden gedownload. Dit is normaal gesproken alleen zinnig voor KDE-ontwikkelaars (die wellicht lokaal wijzigingen hebben die verwijderd zouden kunnen worden).

Normaal gesproken heeft u deze optie niet nodig, kdesrc-build zal vragen om opnieuw te worden gestart als dat nodig is.

Deze optie gebruikt u om kdesrc-build bestaande bestanden waarin gebruikersdata kan voorkomen te laten overschrijven.

Dit wordt op dit moment alleen gebruikt voor de xsession setup van de login manager. Normaal gesproken heeft u deze optie niet nodig, kdesrc-build zal vragen om opnieuw te worden gestart als dat nodig is.

U kunt dit gebruiken om een optie in uw configuratiebestand voor elke module te overschrijven. Bijvoorbeeld, om de optie log-dir te overschrijven, zou u kunnen doen: --log-dir=/path/to/dir.

U kunt dit gebruiken om een optie in uw configuratiebestand voor specifieke module te overschrijven.