El kdesrc-build s'executarà a través del procés d'actualització i construcció, però en lloc de realitzar cap acció per a actualitzar o compilar, generarà el que l'script hauria fet (p. ex., quines ordres executar, passos generals que s'estan prenent, etc.).

Aquesta opció fa que el kdesrc-build inclogui automàticament altres mòduls del KDE i les Qt™ a la construcció, si és necessari per als mòduls que heu sol·licitat construir a la línia d'ordres o al fitxer de configuració.

Els mòduls que s'afegeixen són registrats dins del sistema de gestió del codi font del KDE. Vegeu la «La base de dades oficial de mòduls del KDE».

L'opció del fitxer de configuració corresponent és include-dependencies.

Aquesta opció està activa de manera predeterminada.

No inclourà els mòduls passats a la resta de la línia d'ordres en el procés d'actualització/construcció (això és útil si voleu construir la majoria dels mòduls en el fitxer de configuració i ometre'n alguns).

Tingueu en compte que aquesta opció no substitueix l'opció ignore-modules de l'opció «config» a la secció global. En lloc d'això, l'afegeix.

Aquesta opció interpreta l'element següent a la línia d'ordres com un programa per a executar, i el kdesrc-build acabarà de llegir el fitxer de configuració, inclourà el «prefix.sh» per a aplicar les variables d'entorn, i després executarà el programa indicat.

Aquesta opció farà que el kdesrc-build extregui una revisió numerada específica per a cada mòdul de Git, superposant qualsevol opció branch, tag o revision ja establertes per a aquests mòduls.

És probable que aquesta opció no sigui una bona idea, i només està admesa per compatibilitat amb scripts antics.

Aquesta opció s'utilitza per a permetre que el kdesrc-build suprimeixi els directoris de codi font que poden contenir dades de l'usuari, de manera que el mòdul es pugui tornar a descarregar. Això normalment només seria útil per als desenvolupadors del KDE (podrien tenir canvis locals que seran suprimits).

No heu d'utilitzar aquesta opció normalment, si cal, el kdesrc-build sol·licitarà que es torni a executar amb ella.

Aquesta opció s'utilitza per a permetre que el kdesrc-build sobreescrigui els fitxers existents que poden contenir dades de l'usuari.

Actualment, això només s'utilitza per a la configuració d'xsession per al gestor d'inici de la sessió. No heu d'utilitzar aquesta opció normalment, si cal, el kdesrc-build sol·licitarà que es torni a executar amb ella.

Podeu utilitzar aquesta opció per a superposar una opció en el fitxer de configuració per a cada mòdul. Per exemple, per a superposar l'opció log-dir, faríeu el següent: --log-dir /camí/al/dir.

Podeu utilitzar aquesta opció per a superposar una opció en el fitxer de configuració per a un mòdul específic.

Aquesta opció s'utilitza per a reprendre la construcció a partir del mòdul indicat. No haureu d'especificar altres noms de mòduls a la línia d'ordres.

Vegeu també: --resume-after i «Reprendre una construcció fallida o interrompuda». Preferiríeu utilitzar aquesta opció de la línia d'ordres si heu solucionat l'error de construcció i voleu que el kdesrc-build completi la construcció.

Aquesta opció s'utilitza per a reprendre la construcció després del mòdul indicat. No haureu d'especificar altres noms de mòduls a la línia d'ordres.

Vegeu també: --resume-from i «Reprendre una construcció fallida o interrompuda». Preferiríeu utilitzar aquesta opció de la línia d'ordres si heu solucionat l'error de construcció, i també heu construït i instal·lat el mòdul, i voleu que el kdesrc-build comenci de nou amb el següent mòdul.

Aquesta opció es pot utilitzar per a executar kdesrc-build després que s'hagi produït un error de construcció.

Reprèn la construcció des del mòdul que va fallar, utilitzant la llista de mòduls que esperen a ser compilats, i també inhabilita les actualitzacions del codi font i les metadades. El cas d'ús és quan un error senzill o manca d'una dependència causa la falla de la construcció. Una vegada corregiu l'error, podreu tornar ràpidament a construir els mòduls que es construïen abans, sense tocar --resume-from i --stop-before.

Aquesta opció s'utilitza per a aturar el procés de construcció normal just abans que es construeixi normalment un mòdul.

Per exemple, si la llista de construcció normal era mòdul_A, mòdul_B, mòdul_C, llavors --stop-before mòdul_B farà que el kdesrc-build només construeixi el mòdul_A.

Aquesta opció s'utilitza per a aturar el procés de construcció normal just després que es construeixi normalment un mòdul.

Per exemple, si la llista de construcció normal era mòdul_A, mòdul_B, mòdul_C, llavors --stop-after mòdul_B farà que el kdesrc-build construeixi el mòdul_A i el mòdul_B.

Aquesta opció controla si la construcció s'interromprà tan aviat com passi una fallada. El comportament predeterminat és --stop-on-failure. Si voleu, podeu substituir per a continuar amb la resta dels mòduls en la construcció, per a evitar perdre temps en cas que el problema sigui amb un sol mòdul.

Vegeu també l'opció del fitxer de configuració stop-on-failure.

Aquesta opció permet construir només aquells mòduls que no s'han pogut construir en una execució anterior de kdesrc-build. Això és útil si s'ha produït un nombre significatiu de fallades mesclades amb construccions amb èxit. Després de solucionar el problema que causa les fallades de construcció, podreu construir amb facilitat només els mòduls que van fallar anteriorment.

Aquesta ordre fa que el kdesrc-build consulti un paràmetre dels mòduls a la llista de construcció (ja sigui passat sobre la línia d'ordres o llegit des del fitxer de configuració), enviant el resultat a la pantalla (un mòdul per línia).

Aquesta opció s'haurà de proporcionar amb un «mode», el qual haurà de ser un dels següents:

kactivities: master
kdepim: master

Imprimeix informació sobre les dependències en els mòduls que es construiran utilitzant un format en arbre (recursiu). La informació llistada també inclou de quin commit/branch/tag específic es depèn i si es construirà la dependència. Nota: la sortida generada pot ser molt gran per a aplicacions amb moltes dependències.

Imprimeix informació sobre les dependències en els mòduls que es construiran utilitzant un format en arbre (recursiu). En format de camí complet. Nota: la sortida generada pot ser molt gran per a aplicacions amb moltes dependències.

Imprimeix els mòduls instal·lats i surt. Això es pot utilitzar per a generar la compleció automàtica per a l'opció --run.

No descarrega automàticament les metadades addicionals necessàries per als mòduls git del KDE. Les actualitzacions del codi font per als mòduls en si seguiran succeint a menys que també passeu l'opció --no-src.

Això pot ser útil si esteu tornant a executar sovint el kdesrc-build, ja que les metadades no canvien amb molta freqüència. Fixeu-vos, que moltes altres característiques requereixen que les metadades estiguin disponibles. És possible que vulgueu considerar executar el kdesrc-build una vegada amb l'opció --metadata-only i aleshores utilitzar aquesta opció per a les execucions posteriors.

Omet contactar amb el servidor Git.

Omet el procés de construcció.

No instal·la automàticament els paquets després de construir-los.

Només realitza el procés de descàrrega de les metadades. El kdesrc-build normalment gestiona això automàticament, però pot fer-ho manualment per a permetre que funcioni l'opció --pretend de la línia d'ordres.

Només realitza l'actualització del codi font.

Només realitza el procés de construcció.

Si aquesta és l'única opció de la línia d'ordres, intentarà instal·lar tots els mòduls continguts a log/latest/build-status. Si les opcions de la línia d'ordres s'especifiquen després d'aquesta opció, s'assumirà que són mòduls per a instal·lar (encara que no s'hagin construït correctament en la darrera execució).

Aquesta opció fa que el kdesrc-build interrompi la construcció d'un mòdul just abans que s'hagi executat l'ordre make. Això només està admès per a la compatibilitat amb versions antigues, aquest efecte no és útil per al sistema de compilació actual del KDE.

Activant aquesta opció explícitament desactiva l'omissió del procés de construcció (una optimització controlada per l'opció build-when-unchanged). Això és útil per a fer que el kdesrc-build executi la construcció quan heu canviat quelcom que el kdesrc-build no pot comprovar. Aquesta opció està activa de manera predeterminada.

Torna a crear el sistema de construcció i el crea des de zero.

Executa de nou el cmake (per als mòduls del KDE) o el configure (per a les Qt™), sense netejar el directori de construcció. Normalment no hauríeu d'especificar això, ja que el kdesrc-build detectarà quan es canviïn les opcions rellevants i tornarà a executar automàticament la configuració de la construcció. Aquesta opció està implícita si s'utilitza l'opció --refresh-build.

Això permet canviar el directori en el qual s'instal·laran els mòduls. Aquesta opció implica --reconfigure, però encara podria ser necessari utilitzar --refresh-build.

Genera un directori .vscode amb configuracions per a construir i depurar en el Visual Studio Code. Aquesta opció està activa de manera predeterminada.

Activa o desactiva el mode asíncron, el qual pot realitzar actualitzacions de codi font i construccions de mòduls a la vegada. Si està desactivada, l'actualització es realitzarà completament abans que comenci la construcció. Desactivar aquesta opció alentirà el procés general, però si trobeu errors d'IPC mentre s'executa el kdesrc-build, proveu-ho desactivant-la i envieu un informe d'error. Aquesta opció està activa de manera predeterminada.

Activa o desactiva la sortida amb color. De manera predeterminada, aquesta opció està activada per als terminals interactius.

Aquest valor ajusta la prioritat de la CPU de l'ordinador sol·licitada pel kdesrc-build, i haurà d'estar en l'interval de 0 a 20. 0 és la prioritat més alta (perquè és la menys «nice»), 20 és la prioritat més baixa. L'opció predeterminada és 10.

El fitxer des del qual llegir les opcions de configuració. El valor predeterminat per a aquest paràmetre és kdesrc-buildrc (marcat en el directori de treball actual). Si aquest fitxer no existeix, en el seu lloc s'emprarà ~/.config/kdesrc-buildrc ($XDG_CONFIG_HOME/kdesrc-buildrc, si està establerta $XDG_CONFIG_HOME). Vegeu també Capítol 4, Configurar el kdesrc-build.

Fa que el kdesrc-build realitzi una única configuració inicial necessària per a preparar el sistema, de manera que funcioni el kdesrc-build i perquè s'executi el programari KDE instal·lat.

Això inclou:

Aquesta opció és exactament equivalent a utilitzar --install-distro-packages --generate-config a la vegada. En el kdesrc-build (implementació del Perl) a més fa servir «--install-distro-packages-perl».

Instal·la els paquets necessaris de la distribució (en les distribucions Linux® implementades) per a preparar el sistema de manera que funcioni el kdesrc-build, i perquè s'executi el programari KDE nou instal·lat.

Vegeu també --initial-setup

Genera el fitxer de configuració del kdesrc-build.

Vegeu també --initial-setup

Habilita el mode de depuració per a l'script. Actualment, això vol dir que tota la sortida es bolcarà a la sortida estàndard a més de registrar-se al directori de registre com de costum. A més, moltes funcions són molt més detallades sobre el que estan fent que en el mode de depuració.

No serà tan sorollós amb la sortida. Amb aquest interruptor només sortiran els elements bàsics.

Només surten els avisos i errors.

Serà molt descriptiu sobre el que està succeint i el que està fent el kdesrc-build.

Mostra la versió del programa.

Només mostra una ajuda senzilla sobre aquest script.

Mostra informació sobre el kdesrc-build i el sistema operatiu, el qual pot ser útil en els informes d'error o en demanar ajuda en els fòrums o les llistes de correu.

Imprimeix les línies especificadores (en el format que accepta GetOpts::Long) per a totes les opcions de la línia d'ordres admeses per l'script. Això pot ser utilitzat pels desenvolupadors, per exemple, per a generar funcions d'autocompleció zsh.