Questa opzione attiva la modalità di operazione asincrona, nella quale l'aggiornamento del codice sorgente e il processo di generazione saranno effettuati in parallelo, invece che attendere la fine di tutti gli aggiornamenti prima di avviare il processo di generazione.

Opzione per riga di comando correlata: --async, --no-async

Imposta questa opzione a false (falso) per disattivare l'output colorato di kdesrc-build. Nota che kdesrc-build non passerà codici di colore a nient'altro che a un terminale (come xterm, Konsole, o la normale console di Linux®).

Opzione per riga di comando correlata: --color (o --colorful-output), --no-color (o --no-colorful-output)

Se stai usando SSH per scaricare i sorgenti da Git (come nel caso in cui stessi usando il protocollo git+ssh), questa opzione controlla se kdesrc-build cercherà di assicurarsi che se stai usando ssh-agent, questo stia effettivamente gestendo delle identità SSH. Questo è per cercare di prevenire che SSH chieda la password per ogni modulo.

Opzione per riga di comando correlata: --disable-agent-check, --no-disable-agent-check

Questa opzione si applica solo ai moduli di un deposito del progetto KDE.

Quello che fa questa opzione è configurare quale protocollo di rete preferire quando si esegue il push del codice sorgente per questi moduli. Normalmente si usa l'efficientissimo protocollo git, ma potrebbe essere bloccato in alcune reti (come intranet aziendali o WiFi pubbliche). Un protocollo alternativo molto meglio supportato è il protocollo https usato per i siti Web su Internet.

Se stai usando una di queste reti ristrette puoi impostare questa opzione a http per preferire le comunicazioni https.

In qualsiasi altra situazione non dovresti impostare questa opzione, perché il protocollo predefinito è il più efficiente.

Questa opzione si usa per creare un nome breve per riferirsi a un particolare URL di un deposito di Git nelle dichiarazioni di insiemi di moduli seguenti, il che è utile per dichiarare molti moduli d iGit da generare.

Devi specificare due cose (separate da uno spazio): il nome da assegnare all'URL di base, e il suo nome esatto. Per esempio:

global
    # altre opzioni
    # Questo è il percorso comune a tutti i moduli su server Git.
    git-repository-base kde-git kde:
end global

# Dichiarazioni di moduli

module-set
    # Adesso puoi usare l'alias prima definito, ma solo in un insieme di moduli.
    repository kde-git
    use-modules modulo1.git modulo2.git
end module-set

L'opzione use-modules dell'insieme di moduli ha creato due moduli interni, e kdesrc-build si è comportato come se avesse letto:

module modulo1
    repository kde:modulo1.git
end module

module modulo2
    repository kde:modulo2.git
end module

Il prefisso del deposito Git kde: usato sopra è una scorciatoia che verrà configurata automaticamente da kdesrc-build. Vedi l'articolo di Techbase sulla rinomina degli URL per maggiori informazioni. Nota che al contrario della maggior parte delle altre opzioni, questa può essere specificata più volte per creare tanti alias quanti sono richiesti.

Installa uno script di shell che può essere originato in script di configurazione del profilo di un utente, in modo da stabilire le variabili d'ambiente necessarie per avviare il desktop Plasma costruito da kdesrc-build.

Questo driver altera le seguenti righe:

kde-env-user.sh è facoltativo. Serve per le personalizzazioni utente (per esempi di impostazioni personalizzabili consulta la sezione Troubleshooting and Debugging della KDE UserBase), ma queste impostazioni possono essere impostate dall'utente altrove negli script di configurazione del profilo esistenti.

Puoi disabilitare questa funzionalità impostando questa opzione a false e assicurandoti che sia disabilitata anche l'opzione install-session-driver.

Opzione per riga di comando correlata: --install-environment-driver, --no-install-environment-driver

Se abilitata, kdesrc-build prova ad installare un driver per il gestore degli accessi grafico che permetta di accedere al desktop KDE generato con kdesrc-build.

Questo driver altera le seguenti righe:

Se mantieni il tuo driver d'accesso personale, puoi disattivare questa funzionalità impostando questa opzione a false. Se abilitata, essa abilita anche la funzionalità install-environment-driver.

Opzione per riga di comando correlata: --install-session-driver, --no-install-session-driver

Imposta questa opzione a un numero tra 20 e 0. Maggiore è il numero, minore la priorità che kdesrc-build si assegnerà, ossia più alto è il numero, più «cortese» è il programma.

Opzione per riga di comando correlata: --nice (o --niceness) valore

Questa opzione è definita da kdesrc-build (quando utilizzi kdesrc-build --generate-config), impostata al valore del numero delle CPU disponibili (come indicato dall'applicazione esterna nproc). Se kdesrc-build non è in grado di rilevare il numero di CPU, il valore viene impostato a 4.

Per un esempio d'uso dell'opzione vedi Esempio 2.1, «Configurare Make per utilizzare tutte le CPU disponibili, con eccezioni».

Opzione per riga di comando correlata: --num-cores valore

Questa opzione è definita da kdesrc-build (quando utilizzi kdesrc-build --generate-config), impostata al valore del numero delle CPU ritenuto adeguato per moduli «pesanti» o comunque con elevata complessità, tipo qtwebengine, al fine di evitare l'esaurimento delle memoria durante la generazione.

Il calcolo tipico è un core di CPU per ogni 2 gigabyte (GiB) di memoria totale. Andrà specificato almeno un core e non più di num-cores core.

Sebbene questa opzione sia pensata per supportare i moduli Qt™, puoi utilizzarla per qualsiasi altro tuo modulo nello stesso modo in cui viene utilizzato num-cores.

Se kdesrc-build non è in grado di rilevare la memoria disponibile, il valore verrà impostato a 2.

Opzione per riga di comando correlata: --num-cores-low-mem valore

Usa questa opzione per cambiare dove kdesrc-build memorizza i suoi dati permanenti. La posizione predefinita è un file chiamato .kdesrc-build-data, localizzato nella stessa cartella del file di configurazione in uso. Se il file di configurazione globale è in uso, sarà salvato in ~/.local/state/kdesrc-build-data ($XDG_STATE_HOME/kdesrc-build-data, se $XDG_STATE_HOME è impostato). Se hai più configurazioni disponibili nella stessa cartella, potresti voler impostare manualmente questa opzione in modo che configurazioni differenti non producano dati permanenti in conflitto tra loro.

Opzione per riga di comando correlata: --persistent-data-file file

Imposta questa opzione per controllare quale file chiave SSH viene passato al comando ssh-add quando kdesrc-build scarica il codice sorgente dai depositi che richiedono un'autenticazione. Vedi anche la sezione chiamata «Controlli dell'agente SSH».

Usa la priorità minore per l'accesso al disco e ad altro I/O, che può significativamente migliorare i tempi di reazione del resto del sistema al prezzo di tempi di esecuzione di kdesrc-build leggermente più lunghi.

Opzione per riga di comando correlata: --use-idle-io-priority, --no-use-idle-io-priority

Consente a kdesrc-build anche di clonare e estrarre dai depositi contrassegnati come inattivi.

Opzione per riga di comando correlata: --use-inactive-modules, --no-use-inactive-modules

Imposta questa opzione per impostare la variabile d'ambiente PATH durante la generazione. Non puoi sostituire questa impostazione nelle opzioni di un modulo. Il valore predefinito è quello di $PATH così com'è all'avvio dello script. Questa variabile d'ambiente dovrebbe includere i percorsi, separati da due punti, della toolchain di sviluppo. I percorsi ${install-dir}/bin e ${qt-install-dir}/bin sono aggiunti automaticamente. Puoi usare la tilde (~) per qualsiasi percorso che aggiungi con questa opzione.

Opzione per riga di comando correlata: --binpath path

Ritira il ramo specificato anziché quello predefinito.

Opzione per riga di comando correlata: --branch valore

Imposta questa opzione a un gruppo generale da cui vuoi scegliere i moduli.

Per i tipi di moduli su Git supportati, kdesrc-build determinerà automaticamente il ramo effettivo da usare in base a delle regole stese dagli sviluppatori di KDE (queste sono visibili nel deposito del codice sorgente kde-build-metadata nella tua cartella del codice). Quando viene determinato un ramo, questo viene usato come se lo avessi specificato tu con l'opzione branch.

Questo è utile se stai solo cercando di tenerti aggiornato sullo sviluppo senza dover prestare attenzione a tutti i cambi dei nomi dei rami.

Nota che se scegli un ramo da te con branch, questo si sostituirà alle impostazioni appena presentate. Lo stesso vale per qualsiasi altra opzione di selezione dei rami come tag.

Opzione per riga di comando correlata: --branch-group valore

Usa questa opzione per cambiare la cartella usata in cui contenere le sorgenti generate. Si può utilizzare in tre modi differenti:

Questa opzione può essere, sorprendentemente, cambiata per modulo.

Opzione per riga di comando correlata: --build-dir percorso

Controlla se kdesrc-build debba sempre cercare di generare un modulo che non ha avuto alcun aggiornamento al codice sorgente.

Se impostata a true, kdesrc-build cercherà sempre di generare un modulo, anche se il modulo non ha avuto alcun aggiornamento al codice sorgente. Con questo valore sarà portato con più probabilità a una generazione corretta.

Se impostata a false, kdesrc-build cercherà di generare il modulo solo se ha ricevuto degli aggiornamenti, o in altre situazioni in cui è probabile che una rigenerazione sia effettivamente necessaria. Questo può far risparmiare tempo, specialmente se esegui kdesrc-build ogni giorno, o anche più spesso.

Opzione per riga di comando correlata: --build-when-unchanged (o --force-build), --no-build-when-unchanged (o --no-force-build)

Specifica quale generatore deve essere usato con CMake. Al momento sono supportati Ninja e Unix Makefiles e pure i generatori aggiuntivi basati su di essi, come Eclipse CDT4 - Ninja . I valori non validi (non supportati) vengono ignorati e trattati come non impostati.

È da notare che se viene specificato anche un generatore valido mediante cmake-options, esso ignorerà il valore per cmake-generator.

Opzione per riga di comando correlata: --cmake-generator valore

Specifica un file di toolchain da usare con CMake.

Quando viene configurato un file di toolchain valido, kdesrc-build non imposterà più le variabili d'ambiente in modo automatico. Puoi utilizzare i parametri set-env, binpath e libpath per correggere manualmente l'ambiente, se il tuo file di toolchain non funziona subito con kdesrc-build. Per maggiori informazioni, consulta la panoramica dei flag standard aggiunti da kdesrc-build.

È da notare che se una toolchain valida è specificata anche mediante cmake-options, questo valore verrà usato al posto di quello di cmake-toolchain.

Opzione per riga di comando correlata: --cmake-toolchain valore

Si aggiunge alle opzioni globali per il sistema di generazione predefinito, si sostituisce ad esse per gli altri sistemi di generazione.

Usa questa opzione per specificare quali flag passare a CMake quando crei il sistema di generazione per il modulo. Quando usata come opzione globale, viene applicata a tutti i moduli generati da questo script. Quando usata come opzione per un modulo, viene aggiunta in fondo alle opzioni globali. Ciò ti permette di specificare opzioni comuni di CMake nella sezione globale.

Questa opzione non si applica a qt (che non usa CMake). Usa invece configure-flags.

Se viene specificato un generatore valido tra le opzioni elencate, esso ignorerà il valore del cmake-generator. I generatori non validi (non supportati) vengono ignorati e non saranno passati a CMake.

Se viene specificato un file di toolchain valido tra le opzioni elencate, esso ignorerà il valore del cmake-toolchain. Le toolchain non valide saranno ignorate e non saranno passate a CMake.

Siccome queste opzioni sono passate direttamente alla riga di comando di CMake, dovrebbero essere date come sarebbero passate a CMake. Per esempio:

cmake-options -DCMAKE_BUILD_TYPE=RelWithDebInfo

Siccome è un po' fastidioso, kdesrc-build si dà da fare per assicurarsi che, fintanto che le altre opzioni sono correttamente impostate, dovresti poter lasciare questa opzione in bianco. In altre parole, i parametri necessari di CMake sono impostati automaticamente.

Opzione per riga di comando correlata: --cmake-options valore

Abilita la generazione del comando compile_commands.json tramite CMake all'interno della cartella di generazione.

Opzione per riga di comando correlata: --compile-commands-export, --no-compile-commands-export

Abilita la creazione di collegamenti simbolici da compile_commands.json generato tramite CMake all'interno della cartella di generazione alla corrispondente cartella sorgente.

Opzione per riga di comando correlata: --compile-commands-linking, --no-compile-commands-linking

Si aggiunge alle opzioni globali per il sistema di generazione predefinito, si sostituisce ad esse per gli altri sistemi di generazione.

Usa questa opzione per specificare quali flag passare a ./configure quando crei il sistema di generazione per il modulo. Quando usata come opzione globale, viene applicata a tutti i moduli generati da questo script. Questa opzione funziona solo per qt.

Per cambiare le impostazioni di configurazione dei moduli di KDE, vedi cmake-options.

Opzione per riga di comando correlata: --configure-flags valore

Questa opzione può essere impostata per eseguire un altro comando (al posto di make, per esempio) per effettuare il processo di generazione. kdesrc-build di solito dovrebbe fare la cosa giusta, quindi non ci dovrebbe essere bisogno di questa opzione. È comunque utile per usare metodi di generazione alternativi.

Il valore di questa opzione si usa come la riga di comando da eseguire, modificata dall'opzione make-options come normalmente.

Opzione per riga di comando correlata: --custom-build-command valore

Si aggiunge alle opzioni globali per il sistema di generazione predefinito, si sostituisce ad esse per gli altri sistemi di generazione.

Usa questa opzione per specificare quali flag usare per generare il modulo. Questa opzione viene specificata qui invece che con configure-flags o cmake-options perché questa opzione imposterà anche la variabile d'ambiente CXXFLAGS durante il processo di generazione.

Nota che per KDE 4 e ogni altro modulo che usi CMake è necessario impostare l'opzione CMAKE_BUILD_TYPE a none quando si configura il modulo. Questo si può fare usando l'opzione cmake-options.

Opzione per riga di comando correlata: --cxxflags valore

Usa questa opzione per cambiare il nome che viene dato a un modulo sul disco. Per esempio, se il modulo era extragear-network, usando questa opzione puoi rinominarlo a extragear-network. Nota che sebbene ciò cambi il nome del modulo sul disco, non è una buona idea includere cartelle o separatori di cartelle nel nome, perché ciò interferirà con le opzioni build-dir o source-dir.

Opzione per riga di comando correlata: --dest-dir percorso

Usa questa opzione per selezionare un insieme specifico di cartelle da non generare in un modulo (invece che tutte). Le cartelle da non generare dovrebbero essere separate da spazi.

Nota che il codice sorgente dei programmi sarà comunque scaricato.

Per esempio, per disabilitare la generazione delle cartelle codeeditor e minimaltest del framework syntaxhighlighting, dovresti aggiungere la compilazione do-not-compile codeeditor minimaltest, e aggiungere «do-not-compile juk kscd» alle tue opzioni syntaxhighlighting.

Vedi la sezione chiamata «Rimuovere delle cartelle da una generazione» per un esempio.

Opzione per riga di comando correlata: --do-not-compile valore

Questa opzione è per gli sviluppatori di KDE. Se impostata, verrà usata per configurare automaticamente le informazioni do identificazione per il programma di controllo del codice sorgente Git per i moduli Git scaricati da quel momento in avanti, inclusi la maggior parte dei moduli di KDE.

In particolare, il nome e l'indirizzo di posta dell'utente di ogni deposito di Git vengono configurati con i valori impostati da questa opzione.

Il valore deve essere specificato nella forma Nome <posta@esempio.it>.

Per esempio, lo sviluppatore «Pinco Pallino» con indirizzo «pinco@pallino.it» scriverebbe:

git-user Pinco Pallino <pinco@pallino.it>

Questa opzione, se impostata, usa l'URL specificato come server proxy da usare per tutte le comunicazioni su reti HTTP (per esempio, quando si scarica la banca dati dei progetti di KDE).

Inoltre, kdesrc-build cercherà di assicurarsi che gli strumenti da cui dipende usino quel server proxy, se possibile, impostando la variabile d'ambiente http_proxy al server indicato, se quella variabile non è già impostata.

Opzione per riga di comando correlata: --http-proxy valore

Questa opzione è utilizzata per configurare lo schema che kdesrc-build deve utilizzare durante la creazione di cartelle sorgente e di generazione.

Lo schema flat raggruppa tutti i moduli direttamente al di sotto delle cartelle sorgenti e di generazione di livello superiore. Per esempio, source/extragear/network/telepathy/ktp-text-ui nello schema metadata diventerebbe invece source/ktp-text-ui utilizzando lo schema flat.

Lo schema invent crea una gerarchia di cartelle che rispecchia i percorsi relativi dei repository contenuti in invent.kde.org. Per esempio, source/kde/applications/kate nello schema metadata diventerebbe invece source/utilities/kate utilizzando lo schema invent. Questo schema riguarda solo i progetti KDE. È una buona scelta per i programmatori alle prime armi con kdesrc-build.

Infine, lo schema metadata è lo stesso schema del precedente comportamento predefinito. Questo schema organizza i progetti KDE in base ai percorsi di progetto specificati nei metadati del progetto per questi moduli. È una buona scelta se vuoi uno schema di cartelle che tenga traccia di determinati processi KDE, ma tieni presente che questo percorso non è sempre stabile. Come risultato, kdesrc-build potrebbe lasciare da parte una vecchia copia del repository di un progetto e clonarne una nuova a causa di modifiche ai metadati del progetto.

Opzione per riga di comando correlata: --directory-layout valore

L'impostazione del modulo ha precedenza su quella globale

Imposta questa opzione a true per far creare a kdesrc-build i file del progetto VS Code (cartella .vscode) all'interno della cartella sorgente del modulo.

La cartella .vscode sarà creata all'interno della cartella sorgente del progetto, se non esiste già. Le configurazioni abiliteranno l'uso di LSP, la generazione, il debug e l'esecuzione del progetto dall'interno di VS Code.

La configurazione raccomanda anche le estensioni da installare, utili per lavorare sulla maggior parte dei progetti KDE.

Opzione per riga di comando correlata: --generate-vscode-project-config, --no-generate-vscode-project-config

Controlla se kdesrc-build includerà le dipendenze note di questo modulo nella sua generazione, senza richiederne menzione (neanche indiretta).

Serve per supportare le applicazioni di compilazione che necessitano di versioni di Qt™ o Plasma™ più recenti rispetto a quelle supportate dai comuni sistemi operativi.

Opzione per riga di comando correlata: --include-dependencies (o -d), --no-include-dependencies (o -D)

Questa opzione viene usata per installare il pacchetto a seguito di una generazione riuscita.

Opzione per riga di comando correlata: --install-after-build, --no-install-after-build

Questa opzione dove installare il modulo dopo essere stato generato. Se la cambi a una cartella che richiede accesso come amministratore di sistema, potresti essere interessato anche all'opzione make-install-prefix.

Cambiare questa opzione per un modulo specifico ti permette di installarlo in una cartella diversa da quella dove sono installate le librerie della piattaforma di KDE, come se stessi usando kdesrc-build solo per generare le applicazioni.

Puoi usare ${MODULE} o {MODULE} nel percorso per farle espandere nel nome del modulo.

Opzione per riga di comando correlata: --install-dir percorso

Imposta questa opzione per cambiare il nome predefinito della cartella delle librerie installate all'interno di ${install-dir} e ${qt-install-dir}. In molti sistemi è «lib» o «lib64». Viene avviato il rilevamento automatico per impostare il nome corretto, ma se il rilevamento fallisce può essere cambiato tramite questa impostazione.

Opzione per riga di comando correlata: --libname valore

Imposta questa opzione per impostare la variabile d'ambiente LD_LIBRARY_PATH. Non puoi sostituire questa impostazione per un singolo modulo. Il valore predefinito è vuoto, ma i percorsi ${install-dir}/$LIBNAME e ${qt-install-dir}/$LIBNAME vengono aggiunti automaticamente. Puoi usare la tilde (~) per qualsiasi percorso che aggiungi con questa opzione.

Opzione per riga di comando correlata: --libpath percorso

Usa questa opzione per cambiare la cartella usata per contenere i file di registro generati dallo script.

Opzione per riga di comando correlata: --log-dir percorso

Imposta questa variabile a un elenco separato da spazi, che verrà interpretato come un comando con le sue opzioni con cui far precedere il comando make install usato per installare i moduli. È comodo per installare i pacchetti con per esempio Sudo, ma sii cauto quando usi i privilegi di amministratore.

Opzione per riga di comando correlata: --make-install-prefix valore

Imposta questa variabile per passare le opzioni della riga di comando al comando make. È utile per programmi come distcc o per sistemi con più di un nucleo nel processore.

Nota che non tutti i sistemi di generazione supportati usano make. Per i sistemi di generazione che usano ninja (come il sistema Meson), consulta le impostazioni ninja-options.

Opzione per riga di comando correlata: --make-options valore

Imposta il valore dell'opzione a true (vero) per impedire al processo di cercare di generare questo modulo. Sarà comunque aggiornato quando si aggiorna da Git. Questa opzione è esattamente equivalente all'opzione da riga di comando --no-build .

Imposta il valore dell'opzione a true (vero) per impedire che il processo di generazione cerchi di aggiornare (e di conseguenza generare o installare) questo modulo. Se imposti questa opzione per un modulo, lo stai in pratica escludendo.

Imposta questa variabile per passare le opzioni a riga di comando al comando di generazione ninja. Questo può essere utile per abilitare l'output «verboso» o ridurre manualmente il numero di operazioni parallele di generazione che ninja potrebbe utilizzare.

options qtwebengine
    # Imponi a make e ninja di utilizzare non più di 6 operazioni di compilazione separate anche
    # quando sono disponibili più CPU, in modo da evitare l'esaurimento di memoria
    make-options -j6 NINJAFLAGS=-j6
end options

Opzione per riga di comando correlata: --ninja-options valore

Normalmente kdesrc-build rileverà il sistema di generazione giusto da usare per un modulo dopo averlo scaricato. Questo avviene controllando l'esistenza di certi file nella cartella del codice sorgente del modulo.

Alcuni moduli potrebbero avere più di una serie di file richiesti, che potrebbe confondere il rilevamento automatico. In questo caso puoi specificare manualmente il tipo di generazione giusto.

I tipi di generazione attualmente supportati che possono essere impostati sono:

Opzione per riga di comando correlata: --override-build-system valore

Questa opzione decide se le vecchie cartelle dei registri debbano essere automaticamente eliminate o no.

Opzione per riga di comando correlata: --purge-old-logs, --no-purge-old-logs

Tutte le opzioni qui specificate vengono passate al comando qmake, per i moduli che usano il sistema di generazione qmake. Per esempio, puoi usare l'opzione PREFIX=/percorso/a/qt per imporre a qmake dove installare il modulo.

Opzione per riga di comando correlata: --qmake-options valore

Questa opzione controlla dove installare i moduli qt dopo la generazione. Se non la specifichi, kdesrc-build presumerà che Qt™ sia fornito dal sistema operativo.

Opzione per riga di comando correlata: --qt-install-dir percorso

Se hai poco spazio su disco, potrebbe interessarti questa opzione per eliminare automaticamente la cartella di generazione (o entrambe le cartelle del codice sorgente e di generazione per le installazioni singole) dopo che sarà riuscita l'installazione del modulo.

I valori possibili di questa opzione sono:

Nota che l'uso di questa opzione può avere un significativo impatto negativo sul tuo uso di banda (se usi all) e sul tempo necessario a compilare software KDE, perché kdesrc-build non potrà effettuare generazioni incrementali.

Opzione per riga di comando correlata: --remove-after-install valore

Questa opzione si usa per specificare il deposito Git da cui scaricare il codice sorgente del modulo. Qt™ (e quindi qt) avrebbero bisogno di questa opzione, oltre a diversi moduli di KDE che sono nel processo di conversione a Git.

Se questa opzione è impostata a un valore diverso da zero, kdesrc-build costringerà l'aggiornamento del codice sorgente a portare un modulo all'esatta revisione data, anche se ci sono opzioni come branch. Se il modulo è già alla revisione data non sarà aggiornato di nuovo, a meno che questa opzione sia cambiata o rimossa dalla configurazione.

Opzione per riga di comando correlata: --revision id

Se impostata a true, il modulo sarà generato con supporto per eseguire i suoi test, che verranno eseguiti come parte del processo di generazione. kdesrc-build visualizzerà un breve rapporto dei risultati dei test. Ciò è utile per gli sviluppatori o coloro che vogliono assicurarsi che il loro sistema sia correttamente configurato.

Opzione per riga di comando correlata: --run-tests, --no-run-tests

Questa opzione accetta un insieme di valori separati da spazi, dove il primo è la variabile d'ambiente da impostare, e il resto i valori a cui vuoi impostarla. Per esempio, per impostare la variabile PINCO a pallino, inseriresti questo comando nella sezione opportuna:

set-env PINCO pallino

Questa opzione è speciale perché può essere ripetuta senza sostituire le impostazioni di set-env precedenti nella stessa sezione del file di configurazione. In questo modo puoi impostare diverse variabili d'ambiente per modulo (o globalmente).

Questa opzione si usa per impostare la cartelle in cui tenere il codice sorgente Git di KDE sul tuo computer. Puoi usare la tilde (~) per rappresentare la cartella Home usando questa opzione.

Opzione per riga di comando correlata: --source-dir percorso

L'impostazione di questa opzione a false consente di continuare l'esecuzione dello script a seguito del verificarsi di un errore durante il processo di generazione o installazione.

Opzione per riga di comando correlata: --stop-on-failure, --no-stop-on-failure

Usa questa opzione per scaricare un rilascio specifico di un modulo.

Nota: è molto probabile che usare questa opzione non è quello che vuoi fare. I rilasci di KDE sono disponibili come tarball dal sito degli scaricamenti di KDE.

Opzione per riga di comando correlata: --tag valore

Imposta questa opzione a true per far eseguire make uninstall a kdesrc-build appena prima di eseguire make uninstall.

Questo può essere utile per assicurarsi che non ci siano delle vecchie librerie abbandonate, metadati di CMake, eccetera, che possono causare problemi in installazioni di KDE di lunga data. Questo però funziona solo sui sistemi di generazione che supportano make uninstall.

Opzione per riga di comando correlata: --use-clean-install, --no-use-clean-install

Rimuove la fase update. Le altre fasi presentate saranno ancora elaborate.

Opzione per riga di comando correlata: --no-src (o -S)

Rimuove la fase install. Le altre fasi presentate saranno ancora elaborate.

Opzione per riga di comando correlata: --no-install

Rimuove la fase test. Le altre fasi presentate saranno ancora elaborate.

Opzione per riga di comando correlata: --no-tests

Rimuove la fase build. Le altre fasi presentate saranno ancora elaborate.

Opzione per riga di comando correlata: --no-build

Se la fase build è stata eseguita, rimuove qualsiasi altra fase. In caso contrario, rimuove tutte le fasi.

Opzione per riga di comando correlata: --build-only

Se la fase install è stata eseguita, rimuove qualsiasi altra fase. In caso contrario, rimuove tutte le fasi.

Opzione per riga di comando correlata: --install-only >

Se la fase uninstall è stata eseguita, rimuove qualsiasi altra fase. In caso contrario, rimuove tutte le fasi.

Opzione per riga di comando correlata: --uninstall

Rimuove quelle fasi che sono elencate (separate da spazio) in questa opzione. Le altre fasi presentate saranno ancora elaborate.

Nota che quando specificata nella sezione globale, l'opzione a riga di comando --ignore-modules non la ignora, ma piuttosto la aggiunge.

I moduli indicati da questa opzione, che sarebbero altrimenti stati scelti da kdesrc-build tramite un'opzione use-modules, sono invece completamente saltati. Usa questa opzione se vuoi generare un intero gruppo del progetto kde-projects tranne alcuni moduli specifici.

Il valore dell'opzione non deve necessariamente fare direttamente il nome del modulo. Qualsiasi modulo che contenga delle parti contigue e complete del suo percorso nei progetti di KDE corrispondenti a uno dei valori dell'opzione verrà ignorato; in questo modo puoi ignorare più moduli alla volta.

Per esempio, un valore dell'opzione come libs farebbe escludere sia kde/kdegraphics/libs che playground/libs (ma non kde/kdelibs perché è la parte intera «kdelibs» che viene considerata).

Opzione per riga di comando correlata: --ignore-modules (o -!) module [modulo ...]

Questa opzione permette di specificare facilmente molti moduli da generare in un solo punto del file di configurazione.

Ogni identificativo passato a questa opzione viene convertito internamente in un modulo di kdesrc-build, con un'opzione repository impostata al deposito dell'insieme di moduli combinato con l'identificativo per configurare il deposito finale da cui scaricare. Tutte le altre opzioni assegnate all'insieme di moduli sono passate ai moduli generati senza modifica.

L'ordine in cui i moduli vengono definiti in questa opzione è importante, perché è anche l'ordine in cui kdesrc-build elaborerà i moduli generati durante aggiornamento, generazione e installazione. Tutti i moduli definiti nell'insieme di moduli dato saranno gestiti prima che kdesrc-build passerà al modulo seguente dopo l'insieme di moduli.

Se devi cambiare le opzioni di un modulo generato, basta ridichiararlo dopo averlo definito nell'insieme, e impostare le opzioni come necessario. Anche se cambierai le opzioni del modulo in questo modo, il modulo sarà ancora aggiornato e. generato nell'ordine impostato dall'insieme di moduli (non puoi quindi riordinare la sequenza di generazione in questo modo).

Vedi la sezione chiamata «Insiemi di moduli» e git-repository-base per avere una descrizione di come si usa e un esempio.