Manuale dello script kdesvn-build
Copyright © 2005 Michael Pyne
Copyright © 2005 Carlos Woelz
È concesso il permesso di copiare, distribuire ovvero modificare questo documento sotto i termini della GNU Free Documentation License, versione 1.1 o qualsiasi versione successiva pubblicata dalla Free Software Foundation; con nessuna sezione invariante, con nessun testo di copertina anteriore e con nessun testo di copertina posteriore. Una copia di questa licenza è inclusa nella sezione intitolata "GNU Free Documentation License".
kdesvn-build è uno script Perl che genera e installa KDE direttamente dal codice sorgente del deposito Subversion di KDE.
Sommario
Lista delle Tabelle
kdesvn-build è uno script Perl che aiuta gli utenti ad installare KDE da Subversion. Potresti anche considerare lo script kde-build incluso con il modulo kdesdk di KDE.
Qui documentiamo la sintassi e le opzioni del file di configurazione di kdesvn-build, le sue opzioni alla riga di comando, le sue funzionalità, e una panoramica di tutti i passi necessari a generare KDE dal codice sorgente, inclusi i passi che dovresti effettuare con altri strumenti, ovvero quelli non effettuati automaticamente dallo script kdesvn-build.
In questo capitolo, mostriamo come usare kdesvn-build per ritirare i moduli dal deposito di KDE e generarli. Diamo anche una rapida spiegazione della struttura del deposito Subversion di KDE e di cosa devi fare prima di eseguire lo script.
Tutti gli argomenti qui presenti sono trattati in maggiore dettaglio nella guida a generare KDE dai file sorgente, al sito Web della squadra di qualità di KDE. Se stai compilando KDE per la prima volta, è una buona idea leggerla, o almeno consultarla come riferimento. Troverai informazioni dettagliate sugli strumenti di gestione dei pacchetti e su requisiti, errori comuni di compilazione, strategie e informazioni su come far funzionare la tua nuova installazione di KDE.
Si raccomanda di scaricare e generare KDE usando un account utente. Se hai già installato i pacchetti di KDE, la scelta migliore sarebbe creare un utente diverso (apposito) per generare ed avviare il nuovo KDE. Il vantaggio di generare KDE con un utente apposito è che non puoi rovinare il sistema di base, e avrai sempre il modo di continuare a lavorare tranquillamente anche se qualcosa va storto.
In seguito, se vorrai, potrai fare un'installazione come amministratore. Questo documento non considera l'installazione come amministratore. Se stai facendo un'installazione per tutto il sistema, probabilmente sai comunque lo stesso quello che stai facendo.
Prima di usare lo script kdesvn-build (o qualsiasi altra strategia di generazione) devi installare gli strumenti di sviluppo e le librerie necessarie a KDE. Ti serve la libreria Qt™, versione 3.3.0 o successiva, Automake 1.8, Autoconf 2.5X (meglio se successivo a 2.57, siccome è stato segnalato un errore nelle versioni precedenti), il client di Subversion (SVN), il compilatore gcc con supporto per C++, libxml2, openssl, libbz2 e molti altri (per un elenco completo, vedi i requisiti di compilazione di KDE). Normalmente ci dovrebbero essere dei pacchetti di questi strumenti forniti dalla tua distribuzione o dal tuo fornitore.
Alcuni di questi pacchetti sono divisi in librerie, programmi e pacchetti di sviluppo. Ti serviranno almeno il programma o la libreria, e il suo pacchetto di sviluppo. Nel dubbio, installa tutto. Le librerie di cui avrai bisogno cambieranno a seconda dei moduli che intendi generare, perché ogni modulo ha i suoi requisiti. La guida passo-passo per la generazione di KDE dal codice sorgente ha maggiori dettagli sugli strumenti e tecniche specifici usati per installare e trovare i programmi necessari.
Probabilmente hai già una versione dello script kdesvn-build installata sul tuo sistema. kdesvn-build ti richiede di creare un file di configurazione, chiamato .kdesvn-buildrc. Questo file dovrebbe venire installato nella cartella Home (cioè ~/), e contenere tutti i dati di configurazione necessari per l'esecuzione dello script, come le opzioni di configurazione, di compilazione, la posizione dei sorgenti, la destinazione dell'installazione (il prefisso), i moduli da costruire, eccetera. I dati di configurazione predefiniti sono forniti nel file kdesvn-buildrc-sample. Puoi trovare maggiori informazioni sulla sintassi del file di configurazione nella sezione chiamata “Impostare i dati della configurazione” e nel Capitolo 4, Il formato di .kdesvn-buildrc.
Un buon modo di prendere l'ultima versione è andare alla pagina kdesdk/scripts del sito Web websvn.kde.org. Vedrai un elenco dei file disponibili nella cartella kdesdk/scripts del deposito Subversion di KDE. Fai clic sul collegamento a kdesvn-build e scarica l'ultima versione dello script. Fai lo stesso per il file kdesvn-buildrc-sample. Rendi eseguibile lo script, e assicurati che sia nel tuo percorso.
Per usare lo script, devi avere un file nella tua cartella Home chiamato .kdesvn-buildrc, che imposta le opzioni generali e i moduli che vuoi scaricare e generare.
Usa il file kdesvn-buildrc-sample come modello per impostare le opzioni globali e i moduli da generare.
Seleziona il server usato per ritirare i file da Subversion impostando l'opzione globale svn-server. Il valore predefinito è il deposito Subversion anonimo, svn://anonsvn.kde.org/, ma cambialo se hai un account Subversion di KDE, o se hai un mirror vicino.
Fai molta attenzione alle variabili globali kdedir e qtdir, perché la prima imposta dove sarà generato KDE (come impostazione predefinita ~/kde), e la seconda dove (e se) sarà compilata e installata la libreria Qt™ (come impostazione predefinita ~/kdesvn/build/qt-copy). Più avanti dovrai ricordarti il valore di kdedir e qtdir, per impostare le variabili d'ambiente necessarie a far funzionare la tua installazione. Controlla se i moduli elencati sono effettivamente quelli che vuoi generare. Le opzioni predefinite del file kdesvn-buildrc-sample dovrebbero essere sufficienti per avere un'installazione di KDE piuttosto completa. Salva il risultato come .kdesvn-buildrc nella tua cartella Home.
Se vuoi affinare il file .kdesvn-buildrc, consulta Capitolo 4, Il formato di .kdesvn-buildrc per informazioni dettagliate su tutte le opzioni di configurazione.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Adesso sei pronto per eseguire lo script. Da una finestra di terminale, accedi come l'utente che vuoi usare per compilare KDE ed esegui lo script:
%su-nome utente%kdesvn-build
Adesso lo script dovrebbe cominciare a scaricare il codice sorgente e a compilarlo. È improbabile che funzioni tutto al primo colpo nella compilazione di KDE. Non disperare! Controlla i file di registro per vedere se ti mancano degli strumenti o dei pacchetti di sviluppo (i file di registro sono messi dove indicato dalla variabile log-dir nel file di configurazione). A volte, il ramo di sviluppo principale diventa molto instabile e difficile da generare, specialmente quando si avvicina una scadenza di sviluppo. Abbi pazienza. Puoi trovare gli esempi più comuni di cose che possono andare storte e le loro soluzioni, oltre a diversi suggerimenti e strategie per generare KDE, nella guida passo-passo per generare KDE dal codice sorgente.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Supponendo che tu stia usando un utente apposito per generare KDE, e che tu abbia già installato una versione di KDE, far funzionare il nuovo KDE potrebbe essere un po' difficile, perché il nuovo deve prendere la precedenza sul vecchio. Cambia le variabili d'ambiente per assicurarti che sia così.
Apri o crea il file .bash_profile nella cartella Home con un qualsiasi editor di testo, e aggiungi alla fine del file:
KDEDIR=(percorso a kdedir)
KDEDIRS=$KDEDIR
PATH=$KDEDIR/bin:$QTDIR/bin:$PATH
LD_LIBRARY_PATH=$KDEDIR/lib:$LD_LIBRARY_PATH
export KDEDIRS PATH LD_LIBRARY_PATH
Se stai generando il modulo qt-copy, aggiungi invece: QTDIR=(percorso a qtdir)KDEDIR=(percorso a kdedir)KDEDIRS=$KDEDIR PATH=$KDEDIR/bin:$QTDIR/bin:$PATH MANPATH=$QTDIR/doc/man:$MANPATH LD_LIBRARY_PATH=$KDEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH export QTDIR KDEDIRS PATH MANPATH LD_LIBRARY_PATH
Se non stai usando un utente apposito, imposta una diversa variabile $KDEHOME per il tuo nuovo ambiente nel tuo .bash_profile:
export KDEHOME="${HOME}/.kde-svn"
# Crealo se necessario
[ ! -e ~/.kde-svn ] && mkdir ~/.kde-svn
Se in seguito il menu è vuoto o troppo affollato da applicazioni della tua distribuzione, potresti dover impostare le variabili d'ambiente XDG nel tuo .bash_profile:
XDG_CONFIG_DIRS="/etc/xdg"
XDG_DATA_DIRS="${KDEDIR}/share:/usr/share"
export XDG_CONFIG_DIRS XDG_DATA_DIRS
Adesso che abbiamo finito, devi assicurarti che venga usato lo script di avvio startkde giusto:
Apri il file di testo .xinitrc (o .xsession, a seconda della distribuzione) dalla cartella Home, o crealo se necessario. Aggiungi la riga:
exec ${KDEDIR}/bin/startkde
Adesso, avvia il tuo nuovo KDE: nei sistemi BSD e Linux con supporto per i terminali virtuali, le combinazioni di tasti Ctrl+Alt+F1...F12 vengono usate per selezionare le console virtuali dalla 1 alla 12. Ciò permette di avere più di un ambiente desktop allo stesso tempo. Le prime sei sono terminali di testo, e le seguenti sono terminali grafici.
Se quando avvii la macchina ti viene invece presentato il gestore grafico, puoi usare il nuovo ambiente KDE, anche se non è elencato come opzione. Premi Ctrl+Alt+F2, e ti troverai davanti a un terminale testuale. Accedi usando l'utente apposito e scrivi:
startx -- :1
Puoi far girare il KDE compilato dal codice sorgente e il vecchio KDE allo stesso tempo! Puoi tornare al tuo utente normale premendo Ctrl+Alt+F7 (o F6, F8... provali, uno dev'essere quello giusto). Per tornare alla versione di KDE dal codice sorgente, premi Ctrl+Alt+F8 (o il tasto giusto). Adesso puoi passare da una versione di KDE all'altra, e provare quella nuova sapendo che puoi tornare rapidamente alla sicurezza del desktop KDE stabile.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Le funzionalità di kdesvn-build includono:
Ritira o aggiorna automaticamente i moduli da Subversion, a seconda di cosa è appropriato.
Prende il tempo di generazione dei moduli.
Cerca automaticamente di rigenerare i moduli che usano il make incrementale, che tende a non riuscire dopo alcuni tipi di deposito.
Può far ripartire uno script precedente, o avviare il processo di generazione da un modulo particolare.
Ha già un insieme di opzioni predefinite appropriate per generare un'installazione monoutente di KDE dal deposito anonimo di Subversion.
Contiene supporto per Unsermake.
Espansione della tilde per le opzioni di configurazione. Per esempio, puoi specificare:
qtdir ~/kdesvn/build/qt-copy
Cartelle di generazione, sorgente e registro configurabili
Configura automaticamente un sistema di generazione, con la cartella del codice sorgente diversa da quella di generazione, per mantenere pulita la cartella sorgente. L'eccezione è qt-copy, che non è progettato per essere costruito in questo modo (a meno che tu voglia provare il “trucco per usare una cartella di generazione separata con Qt”.
Puoi specificare che le opzioni globali si applichino a ogni modulo da ritirare, e puoi anche specificare opzioni da applicare a singoli moduli.
Siccome gli Autotools a volte non sono sincronizzati con le modifiche nell'albero del codice sorgente, puoi forzare la rigenerazione di un modulo creando un file .refresh-me nella cartella di generazione del modulo, o eseguendo kdesvn-build con l'opzione --refresh-build.
Puoi specificare varie variabili d'ambiente da usare durante la generazione, incluse KDEDIR, QTDIR, DO_NOT_COMPILE e CXXFLAGS.
I registri dei comandi hanno data e ora, in modo da avere sempre un registro dell'esecuzione dello script. Inoltre, uno speciale collegamento simbolico chiamato latest viene creato e punta sempre al file più recente della cartella dei registri.
Se stai usando una versione utente di KDE invece di una di sistema (per installare la quale devi essere amministratore), puoi usare lo script per installarla al posto tuo. Non ho verificato bene il codice, e fa ampio uso della chiamata system(), quindi non raccomanderei di usarlo come amministratore per ora.
Puoi usare make-install-prefix per prefissare la riga di comando di make install con un altro comando, cosa utile per sudo.
Puoi usare l'opzione apidox per generare e installare automaticamente la documentazione dell'API per alcuni moduli.
Puoi ritirare anche solo una parte di un modulo Subversion di KDE. Per esempio, potresti ritirare solo taglib da kdesupport, o solo K3B da extragear/multimedia. Lo script includerà automaticamente kde-common quando necessario per far funzionare la generazione.
Puoi “far finta” di fare le operazioni. Se passi le opzioni --pretend o -p sulla riga di comando, lo script darà una descrizione logorroica dei comandi che sta per eseguire, senza però eseguirli.
Supporto per ritirare particolari rami dei moduli Subversion. Questo lavoro deve ancora essere completato, ma puoi già selezionare il ramo che vuoi generare usando l'opzione di configurazione module-base-path.
Cose che kdesvn-build non fa:
Trovare il mirror Subversion di KDE. Per ora non c'è nemmeno un elenco nello script, però il server predefinito dovrebbe funzionare senza problemi.
Spazzolarti i denti. Quello te lo devi ricordare tu.
Lo script probabilmente non è esente da errori. Scusa.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
.kdesvn-buildrcPer usare lo script, devi avere un file chiamato .kdesvn-buildrc nella tua cartella Home, il quale descrive i moduli che vuoi scaricare e generare.
Parte con le opzioni globali, specificate come segue:
globalnome-opzione valore-opzione[...]end global
Seguono quindi una o più sezioni per i moduli, specificate come segue:
modulenome-modulonome-opzione valore-opzione[...]end module
nome-modulo deve essere un modulo del deposito Subversion di KDE (per esempio, kdelibs o kdebase). Alcune opzioni sostituiscono quelle globali, alcune si aggiungono ad esse, e alcune opzioni globali non si possono sostituire.
Segue un elenco alfabetico delle opzioni disponibili. Fai clic sull'opzione per saperne di più. Se ne trovi una non documentata, scrivi agli autori usando l'indirizzo che trovi sopra.
apidox, per generare la documentazione dell'API.
apply-qt-patches, per migliorare qt-copy.
binpath, per impostare la variabile PATH.
branch, per ritirare da un ramo invece che dal tronco principale.
build-dir, per impostare la cartella in cui generare.
checkout-only, per ritirare soltanto alcune parti di un modulo.
colorful-output, per aggiungere del colore all'output dello script.
configure-flags, per definire quali flag con cui configurare un modulo.
cxxflags, per definire la variabile CXXFLAGS.
dest-dir, per cambiare il nome della cartella di un modulo.
disable-agent-check, per evitare che kdesvn-build controlli lo stato dell'agente ssh.
do-not-compile, per segnare le cartelle da non generare.
inst-apps, per generare e installare solo alcune cartelle.
install-after-build, per evitare di installare dopo il processo di generazione.
kdedir, per impostare la cartella in cui installare KDE.
libpath, per impostare la variabile LD_LIBRARY_PATH.
make-install-prefix, per avviare un programma di aiuto (come sudo) durante make install.
make-options, per passare opzioni al programma make.
manual-build, per evitare di generare il modulo automaticamente.
manual-update, per evitare di fare qualsiasi cosa sul modulo in automatico.
module-base-path, per cambiare da dove scaricare il modulo (utile per rami e tag).
niceness, per cambiare la priorità nell'uso della CPU.
no-rebuild-on-fail, per evitare di far ripartire make se non riesce.
qtdir, per impostare il percorso alle librerie Qt™.
set-env, per impostare una variabile d'ambiente.
source-dir, per cambiare da dove scaricare il codice sorgente.
stop-on-failure, per far fermare kdesvn-build non appena qualcosa non riesce.
svn-server, per cambiare il server da cui si scarica il codice sorgente.
use-qt-builddir-hack, per dare a Qt™ una cartella di generazione separata dal suo codice sorgente, come per KDE.
use-unsermake, per usare il sistema di generazione avanzato unsermake.
Questa è una tabella delle varie opzioni con alcuni commenti. Ogni opzione che ne sostituisca una globale sostituirà anche un'impostazione della riga di comando.
Tabella 4.1. Tabella delle opzioni
| Nome dell'opzione | Sostituibilità | Note |
|---|---|---|
| apidox | Sostituisce globale | Imposta questa opzione a true (vero) per fare in modo che kdesvn-build generi e installi la documentazione dell'API per il modulo dopo il normale processo di generazione e installazione. Questo funziona soltanto per i moduli nei quali make apidox ha effetto, tra cui kdelibs, kdebase, koffice e altri. |
| apply-qt-patches | Sostituisce globale | Questa opzione è utile solo per qt-copy. Se è impostata ad un valore non nullo, lo script apply-patches sarà eseguito prima della generazione, per applicare le patch non ufficiali a qt-copy. Siccome queste patch sono normalmente la ragione per cui si installa qt-copy invece di un normale Qt™, non dovrebbe far male abilitarle. L'impostazione predefinita è abilitare le patch. |
| binpath | Non sostituibile | Imposta questa opzione per impostare la variabile d'ambiente |
| branch | Sostituisce globale | Imposta questa opzione per ritirare i file da un ramo di KDE invece che dal tronco, che è predefinito ed è dove avviene lo sviluppo di KDE. Per esempio, per ritirare KDE 3.4, imposteresti questa opzione a Nota che alcuni moduli usano un diverso nome su alcuni rami. In particolare, il modulo aRts richiesto non segue i numeri di versione di KDE. La versione di aRts corrispondente a KDE 3.4 era la versione 1.4. Se kdesvn-build non riesce a scaricare correttamente un ramo con questa opzione, potresti dover specificare manualmente l'URL da cui scaricare usando l'opzione override-url. |
| build-dir | Sostituisce globale | Usa questa opzione per cambiare la cartella che conterrà il codice costruito. Ci sono tre diversi modi di usarla:
|
| checkout-only | Sostituisce globale | Imposta questa opzione per ritirare il codice sorgente Subversion un pezzo alla volta. Il valore di questa opzione dovrebbe essere un elenco separato da spazi di cartelle da ritirare. Se non includi la cartella admin, essa verrà inclusa automaticamente (se necessario). Quando ritiri un pezzo alla volta, la cartella admin sarà presa da kde-common, che è dove si trova sul server Subversion. Sebbene questa opzione sostituisca l'opzione globale, tieni presente che impostare questa opzione come globale non ha senso. |
| configure-flags | Si aggiunge alle opzioni globali (eccetto qt-copy) | 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. qt-copy usa un insieme molto diverso di opzioni rispetto al resto di KDE, quindi questa opzione sostituisce le impostazioni globali quando applicata a qt-copy. |
| colorful-output | Non sostituibile | Imposta questa opzione a false (falso) per disattivare l'output colorato di kdesvn-build. Questa opzione ha valore predefinito true (vero). Nota che kdesvn-build non passerà codici di colore a nient'altro che a un terminale (come xterm, Konsole, o la normale console di Linux). |
| cxxflags | Si aggiunge alle opzioni globali | Usa questa opzione per specificare quali flag passare a ./configure nella forma della variabile CXXFLAGS quando crei il sistema di generazione del modulo. Questa opzione viene specificata qui invece che con configure-flags perché questa opzione imposterà anche la variabile d'ambiente CXXFLAGS durante il processo di generazione. |
| dest-dir | Sostituisce globale | Usa questa opzione per cambiare il nome che viene dato a un modulo sul disco. Per esempio, se il modulo era extragear/network, potresti rinominarlo a extragear-network usando questa opzione. |
| disable-agent-check | Non sostituibile | Normalmente, se stai usando ssh per scaricare i sorgenti da Subversion (come nel caso in cui stessi usando il protocollo svn+ssh), kdesvn-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. Puoi disabilitare questa opzione impostando disable-agent-check a true (vero). |
| do-not-compile | Sostituisce globale | Usa questa opzione per impostare la variabile d'ambiente Nota che il codice sorgente dei programmi sarà comunque scaricato. Puoi usare la direttiva checkout-only per scegliere le cartelle che vuoi ritirare. |
| email-address | Non sostituibile |
Imposta questa opzione all'indirizzo di posta elettronica da cui kdesvn-build dovrebbe inviare una lettera se mai ne avesse bisogno. Non te ne devi curare se non usi nessuna funzionalità che usa la posta (come impostazione predefinita sono tutte disattivate). Attualmente solo email-on-compile-error ha bisogno di questa opzione. |
| email-on-compile-error | Non sostituibile |
Puoi impostare questa opzione all'indirizzo di posta elettronica a cui mandare un rapporto quando un modulo non può essere generato. kdesvn-build aspetterà fino a quando tutti i moduli saranno stati generati e metterà assieme tutti i risultati in un rapporto. Il rapporto viene inviato solo se almeno un modulo non è potuto essere generato. Vedi anche l'opzione email-address per impostare l'indirizzo da cui kdesvn-build dovrebbe inviare la lettera, perché il valore predefinito normalmente non è quello che vuoi. |
| inst-apps | Sostituisce globale | Questo è il contrario dell'opzione do-not-compile. Questa opzione fa in modo che solo le cartelle di massimo livello siano generate. Le cartelle devono essere separate da spazi. Nessun cambiamento avrà effetto fino alla prossima volta che verrà eseguito make Nota che il codice sorgente dei programmi sarà comunque scaricato. Puoi usare la direttiva checkout-only per scegliere le cartelle che vuoi ritirare. |
| install-after-build | Sostituisce globale | Questa opzione viene usata per installare il pacchetto a seguito di una generazione riuscita. Come impostazione predefinita, questa opzione è attiva. Se vuoi disattivarla, devi impostarla a 0 nel file di configurazione. Puoi anche usare l'opzione --no-install dalla riga di comando. |
| kdedir | Non sostituibile | Questa opzione imposta la cartella in cui KDE sarà installato dopo essere stato generato. Il suo valore predefinito è ~/kde. Se la cambi a una cartella che richiede accesso come amministratore di sistema, potresti essere interessato anche all'opzione make-install-prefix. |
| libpath | Non sostituibile | 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 $ e $ vengono aggiunti automaticamente. Puoi usare la tilde (~) per qualsiasi percorso che aggiungi con questa opzione. |
| log-dir | Sostituisce globale | Usa questa opzione per cambiare la cartella usata per contenere i file di registro generati dallo script. Questa opzione può essere impostata singolarmente per ogni modulo dalla versione 0.64 in avanti. |
| make-install-prefix | Sostituisce globale | 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. |
| make-options | Sostituisce globale | Imposta questa variabile per passare le opzioni della riga di comando al comando make. È utile per programmi come distcc. distcc ti permette di condividere il lavoro di compilazione tra diversi computer. Per usarlo, devi usare l'opzione j di make. La documentazione raccomanda di usare 2×(numero di cpu in rete). Se hai una sola CPU, sarebbe -j2. |
| manual-build | Sostituisce globale | 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 Subversion. Questa opzione è esattamente equivalente all'opzione da riga di comando --no-build. |
| manual-update | Sostituisce globale | 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. |
| module-base-path | Sostituisce globale | Imposta questa opzione per sostituire il percorso alla cartella predefinita di kdesvn-build per il modulo. Si può usare, per esempio, per ritirare particolari rami o versioni di alcune librerie. Il visore del sorgente di KDE è utilissimo per capire quale percorso scegliere. Nota che kdesvn-build costruisce il percorso finale secondo il modello seguente: Il valore predefinito è |
| niceness | Non sostituibile | Imposta questa opzione a un numero tra 20 e 0. Maggiore è il numero, minore la priorità che kdesvn-build si assegnerà. Il valore predefinito è 10. |
| no-rebuild-on-fail | Sostituisce globale | Imposta questa opzione a true (vero) per impedire sempre che kdesvn-build cerchi di ricostruire questo modulo se una generazione incrementale non dovesse riuscire. Normalmente kdesvn-build cercherà di ricostruire il modulo da zero per annullare l'effetto di aggiornamenti Subversion mancanti che danneggiano il sistema di generazione. |
| override-url | Sostituisce globale | Se imposti questa opzione, kdesvn-build userà il suo valore come l'URL da passare a Subversion esattamente com'è. Generalmente dovresti usarla se vuoi scaricare un rilascio particolare ma kdesvn-build non riesce a capire quello che vuoi fare usando branch. |
| qtdir | Non sostituibile | Imposta questa opzione per impostare la variabile d'ambiente QTDIR durante la generazione. Non puoi sostituire questa impostazione nelle opzioni di un modulo. Se non specifichi l'opzione, il suo valore predefinito sarà |
| remove-after-install | Sostituisce globale | 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 |
| set-env | Sostituisce globale | 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 set-env Questa opzione è speciale perché può essere ripetuta senza sostituire le impostazioni di |
| source-dir | Non sostituibile | Questa opzione viene usata per impostare la cartelle in cui tenere il codice sorgente Subversion di KDE sul tuo computer. Se non specifichi questo valore, quello predefinito sarà ~/kdesvn. Se invece lo specifichi, usa un percorso assoluto. |
| svn-server | Non sostituibile | Questa opzione viene usata per impostare il server usato per ritirare i file da Subversion. Il valore predefinito è il deposito Subversion anonimo, svn://anonsvn.kde.org/. |
| stop-on-failure | Sostituisce globale | Imposta questa opzione a true (vero) per far fermare l'esecuzione dello script a seguito del verificarsi di un errore durante il processo di generazione o installazione. Il valore predefinito di questa opzione è spento. |
| tag | Sostituisce globale | 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 FTP di KDE o da uno dei suoi mirror. Se stai usando kdesvn-build perché hai dei problemi ad ottenere un rilascio di KDE per la tua distribuzione, considera piuttosto lo strumento di generazione Konstruct, che funziona con le tarball dei rilasci. |
| use-qt-builddir-hack | Sostituisce globale | Sebbene questa opzione sostituisca quella globale, ha senso solo per qt-copy. Imposta questa opzione a true (vero) per abilitare la modalità sperimentale dello script, con srcdir diverso da builddir. Quando abilitata, kdesvn-build copierà il modulo del codice sorgente qt-copy nella cartella di generazione, ed effettuerà la generazione da lì. Ciò vuol dire che la tua variabile d'ambiente QTDIR dovrebbe invece essere impostata a $(qt-copy-build-dir)/qt-copy/lib. Dovresti anche cambiare l'opzione qtdir corrispondentemente. La compilazione incrementale dovrebbe funzionare ancora in questa modalità, perché le date e le ore dei file saranno mantenute dopo la copia. Se usi l'opzione apply-qt-patches, le patch saranno applicate nella cartella di generazione, non in quella del codice sorgente. Questa opzione ha valore predefinito true (vero). |
| use-unsermake | Sostituisce globale | Imposta questa opzione a Normalmente, se usi questa opzione kdesvn-build manterrà automaticamente unsermake aggiornato. Questo potrebbe essere fastidioso, specialmente se gestisci unsermake a mano. Se questo è il caso, puoi impostare questa opzione a |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Questo script non usa variabili d'ambiente. se devi impostare delle variabili d'ambiente per il processo di generazione o installazione, vedi l'opzione set-env.
Lo script accetta le seguenti opzioni dalla riga di comando:
--helpmostra soltanto un semplice aiuto sull'uso di questo script.
--versionmostra la versione del programma.
--authormostra informazioni per contattare l'autore.
--colorabilita l'output colorato.
--no-colordisabilita l'output colorato.
--pretend (o -p)non fare nulla, fai solo finta di farlo.
--quiet (o -q)non scrivere tanto output. Con questa opzione vengono scritte solo le cose fondamentali.
--really-quietscrivi solo avvertimenti ed errori.
--verbosescrivi molte cose su quello che sta succedendo, e su cosa sta facendo kdesvn-build.
--svn-onlyfai solo l'aggiornamento del codice sorgente.
--build-onlyfai solo la generazione.
--ignore-modulesnon includere i moduli passati sul resto della riga di comando nel processo di aggiornamento e generazione.
--no-svnsalta la connessione al server Subversion.
--no-buildsalta il processo di generazione.
--no-installnon installare automaticamente i pacchetti dopo averli generati.
--debugabilita la modalità di debug per lo script. Attualmente ciò vuol dire che tutto l'output sarà riversato sullo standard output oltre ad essere registrato nella cartella di registro, come sarebbe normale. Inoltre, molte funzioni sono molto più verbose riguardo a quello che stanno facendo in modalità di debug.
--no-rebuild-on-failnon cercare di rigenerare da zero i moduli che non è stato possibile generare. kdesvn-build non cercherà mai di farlo con un modulo che si è già cercato di generare da zero.
--refresh-buildricrea il sistema di generazione e compila da zero.
--reconfigureesegui lo script di configurazione senza pulire la cartella di generazione.
--recreate-configureesegui di nuovo make -f Makefile.cvs per creare lo script di configurazione, e continua a generare come normalmente. Questa opzione implica --reconfigure.
--resumecerca di riprendere la generazione da dove lo script si è fermato l'ultima volta. Lo script comincia la generazione del modulo dopo l'ultimo compilato all'ultima esecuzione dello script, che sia riuscito o meno. Questa opzione implica --no-svn. Non dovresti specificare altri nomi di moduli sulla riga di comando.
--resume-fromè come --resume, tranne che indichi il modulo da cui cominciare a generare nel successivo parametro della riga di comando. Questa opzione implica --no-svn. Non dovresti specificare altri nomi di moduli sulla riga di comando.
--rc-fileinterpreta il prossimo parametro della riga di comando come il file da cui leggere le opzioni di configurazione. Il valore predefinito di questo parametro è ~/.kdesvn-buildrc.
--prefix=</percorso/a/kde>permette di cambiare la cartella in cui sarà installato KDE dalla riga di comando. Questa opzione implica --reconfigure.
--build-system-onlyferma dopo aver eseguito make -f Makefile.cvs. Lo script di configurazione dovrà ancora essere eseguito, cosa che kdesvn-build farà la volta successiva. Ciò ti permette di preparare tutti gli script di configurazione in una volta, in modo da poter eseguire ./configure --help per ogni modulo, e modificare i tuoi flag di configurazione opportunamente.
--installSe questa è l'unica opzione dalla riga di comando, cerca di installare tutti i moduli contenuti nella cartella successfully-built, tranne per qt-copy che non richiede installazione. Se sono specificate opzioni da riga di comando dopo --install, sono considerate essere i moduli da installare.
--<nome-opzione>=Puoi usare questa opzione per sostituire un'opzione nel tuo file di configurazione per ogni modulo. Per esempio, per sostituire l'opzione log-dir, scriveresti: --log-dir=. /percorso/a/cartella
--<nome-modulo>,<nome-opzione>=Puoi usare questa opzione per sostituire un'opzione nel tuo file di configurazione per un modulo particolare. Per esempio, per sostituire l'opzione use-unsermake per kdemultimedia, scriveresti --kdemultimedia,use-unsermake=false.
Tutte le altre opzioni da riga di comando sono considerate come moduli da aggiornare e generare. Non confondere la generazione con l'installazione.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Questa documentazione è concessa in licenza sotto i termini della GNU Free Documentation License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team