Capítol 5. Opcions de la línia d'ordres i les variables d'entorn

Ús de la línia d'ordres

El kdesrc-build està dissenyat per a executar-se de la següent manera:

kdesrc-build [--options...] [mòduls a construir...]

Si no s'especifica cap mòdul per a construir a la línia d'ordres, llavors el kdesrc-build construirà tots els mòduls definits al fitxer de configuració, en l'ordre indicat en aquest fitxer (encara que això pot ser modificat per diverses opcions del fitxer de configuració).

Opcions d'ús habitual a la línia d'ordres

La llista completa d'opcions de línia d'ordres es proporciona als «Paràmetres admesos de la línia d'ordres». Les opcions utilitzades més sovint inclouen:

--pretend (o -p)

Aquesta opció fa que el kdesrc-build indiqui quines accions prendria, sense fer-les. Això pot ser útil per a assegurar-vos que els mòduls que creieu que està construint, en realitat es construiran.

--refresh-build

Aquesta opció força al kdesrc-build a construir els mòduls indicats des d'un punt d'inici absolutament nou. Qualsevol directori de construcció existent per a aquest mòdul s'eliminarà i es reconstruirà. Aquesta opció és útil si obteniu errors en construir un mòdul, i de vegades és necessària quan canvien les biblioteques de les Qt™ o del KDE.

--no-src

Aquesta opció omet el procés d'actualització del codi font. Podeu utilitzar-la si heu actualitzat recentment el codi font (potser ho heu fet manualment o executant recentment el kdesrc-build) però encara voleu reconstruir alguns mòduls.

--no-build

Aquesta opció és similar a --no-src anterior, però aquesta vegada s'omet el procés de construcció.

Especificar els mòduls a construir

En general, especificar els mòduls per a construir és tan senzill com passar el nom del mòdul tal com l'heu definit al fitxer de configuració. També podeu passar mòduls que formen part d'un conjunt de mòduls, ja sigui com s'anomena a use-modules, o el nom de tot el conjunt de mòduls, si li heu donat un nom.

En el cas específic dels conjunts de mòduls basats en la base de dades del projecte KDE, el kdesrc-build expandirà els components del nom del mòdul per a determinar el mòdul exacte que voleu. Per exemple, l'entrada del projecte KDE que el kdesrc-build situa el projecte a extragear/utils/kdesrc-build. Podreu especificar qualsevol dels següents per a construir el kdesrc-build:

% kdesrc-build +extragear/utils/kdesrc-build
% kdesrc-build +utils/kdesrc-build
% kdesrc-build +kdesrc-build

Nota

Les ordres a l'exemple anterior van precedides pel nom del mòdul amb un +. Això forçarà que el nom del mòdul s'interpreti com un mòdul des de la base de dades del projecte KDE, encara que aquest mòdul no s'ha definit en el fitxer de configuració.

Aneu amb compte especificant projectes molt genèrics (p. ex., extragear/utils), ja que això pot conduir a la construcció d'una gran quantitat de mòduls. Hauríeu d'utilitzar l'opció --pretend abans de construir un conjunt de mòduls nou per a assegurar-vos que només esteu construint els mòduls que voleu.