Registre de construcció de kdesrc-buildEl registre és una característica de kdesrc-build per la qual el resultat de cada ordre que executa es desa en un fitxer per al seu posterior examen, si cal. Això es fa perquè sovint és necessari tenir la sortida d'aquests programes quan hi ha una fallada de construcció, perquè hi ha moltes raons per les quals una construcció pot fallar.
Els registres sempre s'emmagatzemen sota el directori de registre. La destinació del directori de registre està controlada per l'opció log-dir, la qual de manera predeterminada és ${source-dir}/log (on ${source-dir} és el valor de l'opció source-dir. A la resta d'aquesta secció, aquest valor s'anomenarà ${log-dir}).
Sota ${log-dir}, hi ha un conjunt de directoris, un per a cada vegada que s'ha executat el kdesrc-build. Cada directori s'anomena amb la data i el número d'execució. Per exemple, la segona vegada que s'executa el kdesrc-build el 26 de maig de 2004, crearia un directori anomenat 2004-05-26-02, on 2004-05-26 és per a la data, i -02 és el número d'execució.
Per a la vostra comoditat, el kdesrc-build també crearà un enllaç amb els registres per a la vostra última execució, anomenada latest (última). Per tant, els registres de la darrera execució de kdesrc-build sempre estaran sota ${log-dir}/latest.
Ara, cada directori per a una execució de kdesrc-build contindrà un conjunt de directoris, un per a cada mòdul del KDE que intenteu construir. A més, d'un fitxer anomenat build-status (estat de la construcció), el qual us permetrà determinar quins mòduls s'han compilat i quins han fallat.
Nota
Si un mòdul en si té un submòdul (com extragear/multimèdia, playground/utils o KDE/kdelibs), llavors hi haurà d'haver una disposició coincident en el directori de registre. Per exemple, els registres per a KDE/kdelibs després de l'última execució de kdesrc-build es trobaran a ${log-dir}/latest/KDE/kdelibs, i no a ${log-dir}/latest/kdelibs.
A cada directori de registre del mòdul, trobareu un conjunt de fitxers per a cada operació que realitza el kdesrc-build. Si el kdesrc-build actualitza un mòdul, és possible que vegeu noms de fitxer com git-checkout-update.log (per a extreure un mòdul o en actualitzar un mòdul que ja s'ha extret). Si s'ha executat l'ordre configure, llavors esperaríeu veure un configure.log en aquest directori.
Si succeeix un error, hauríeu de poder veure una explicació de per què en un dels fitxers. Per a ajudar a determinar quin fitxer conté l'error, el kdesrc-build crearà un enllaç des del fitxer que conté l'error (com build-1.log cap a un fitxer anomenat error.log).
El resultat de tot això és que per a veure perquè un mòdul no s'ha pogut construir després de l'última execució de kdesrc-build, el fitxer que haureu de mirar primer és ${log-dir}/latest/. nom_mòdul/error.log
Suggeriment
Si el fitxer error.log està buit (especialment després d'una instal·lació), llavors potser no hi ha hagut cap error. Algunes de les eines utilitzades pel sistema de construcció del KDE, de vegades informen erròniament d'un error quan no n'hi havia cap.
A més, algunes ordres evadiran la redirecció de la sortida de kdesrc-build i obviaran el fitxer de registre en certes circumstàncies (normalment quan es realitza la primera extracció des de Git), i la sortida d'error en aquest cas no estarà en el fitxer de registre sinó al Konsole o terminal on vàreu executar el kdesrc-build.