>Alljärgnevalt tuleb juttu &tdesvn-build;'i konfiguratsioonifaili süntaksist ja võtmetest, käsureavõtmetest, omadustest ja sammudest, mida on vaja ette võtta &kde; ehitamiseks lähtekoodist, kaasa arvatud sammudest, mida tuleb sooritada muude tööriistadega, see tähendab, sammudest, mida skript &tdesvn-build; ei tee ise automaatselt. </para>
>Käesolevas peatükis selgitame, kuidas kasutada &tdesvn-build;'i moodulite väljavõtmiseks &kde; hoidlast ja nende ehitamiseks. Me selgitame ka &kde; &svn;i põhimõttelist struktuuri ning samme, mida on vaja ette võtta enne skripti käivitamist. </para>
>. Kui kompileerid KDE-d esimest korda, tasuks seda lugeda kas või põgusalt. Sealt leiab põhjaliku info pakendamistööriistade ja nõuete kohta, levinud kompileerimisprobleemide ja -strateegiate kirjelduse ning juhiseid oma uue &kde; paigalduse kasutamiseks. </para>
>Soovitatav on &kde; alla laadida ja ehitada kasutajakontot tarvitades. Kui sul on juba &kde; tarkvarapaketid paigaldatud, on kõige mõistlikum luua uus spetsiaalne kasutaja oma uue &kde; ehitamiseks ja kasutamiseks. &kde; kasutamine spetsiaalse kasutajakontoga tagab selle, et sa ei riku oma põhisüsteemi ja saad alati kuhugi tagasi pöörduda, kui midagi peaks viltu minema. </para>
<para
>Hiljem võid muidugi soovi korral paigaldada ka administraatori õigustes. Käesolevas käsiraamatus me seda siiski ei puuduta. Kui paigaldad süsteemselt, siis arvatavasti tead juba nagunii, mida ja kuidas teha. </para>
>Enne skripti &tdesvn-build; (või muude ehitamisstrateegiate) kasutamist tuleb paigaldada arendustööriistad ja teegid, mida &kde; vajab. Vajalikud on Qt teek versiooniga 3.3.0 või uuem, Automake 1.8, Autoconf 2.5X (parem oleks
>=2.57, sest väiksemate versioonidega on teada mõned vead), Subversioni (svn) klient, C++ toetusega gcc kompilaator, libxml2, openssl, libbz2 ja veel terve rida asju (täieliku nimekirja toob ära sait <ulink url="http://www.kde.org/info/requirements/3.4.php"
>KDE Compilation Requirements</ulink
>). Üldiselt peaks neid juba eelnevalt kompileerituna tarkvarapakettidena jagama sinu distributsiooni looja. </para>
<para
>Osa neist tarkvarapakettidest on jagatud teekide, programmide või utiliitide ja arenduspakettideks. Sul läheb vaja vähemalt programmi- või teegi- ja arenduspaketti. Kahtluse korral paigalda kõik. Vajalikud teegid sõltuvad moodulitest, mida kavatsed ehitada, sest igal moodulil on oma nõuded. Täpsemalt kõneleb paigaldamiseks vajalikest tööriistadest ja võtetest ning nõutud tarkvarast dokument <ulink url="http://quality.kde.org/develop/cvsguide/buildstep.php#step1"
> Building &kde; from Source Step by Step Guide</ulink
>Tõenäoliselt on skript &tdesvn-build; juba sinu süsteemi paigaldatud, kui sa käesolevat käsiraamatut loed. &tdesvn-build; nõuab, et looksid konfiguratsioonifaili nimega <filename
>. See peab asuma kodukataloogis (~/) ja sisaldama kõiki konfiguratsiooniandmeid, mida skript tööks vajab, näiteks konfiguratsioonivõtmeid, kompileerimisvõtmeid, lähtetekstide asukohti, paigalduse sihtkohta (prefiksit), ehitatavate moodulite nimekirja &etc; Vaikimisi konfiguratsiooniandmeid pakub fail <filename
> kataloogi tdesdk/scripts. Seal näed kõiki faile, mida pakub &kde; &svn;i hoidla alljaotus tdesdk/scripts. Klõpsa &tdesvn-build;'i lingil ja tõmba skripti värskeim versioon. Võta samasugune operatsioon ette failiga <filename
>). Muutujaid tdedir ja qtdir pead teadma ka hiljem, et määrata keskkonnamuutujad, mida läheb tarvis uue paigalduse tööks. Kontrolli, kas kirjasolevad moodulid on ikka need, mida soovid ehitada. Faili <filename
>Nüüd oled valmis skripti käivitama. Logi terminaliaknas sisse selle kasutaja õigustega, kelle lõid &kde; kompileerimiseks, ning käivita skript: <screen
>Nüüd peaks skript hakkama lähteteksti alla laadima ja seda kompileerima. Pole väga usutav, et sul õnnestub kohe esimese korraga &kde; igati edukalt kompileerida. Kuid ära heida meelt! Kontrolli logifaile, kust peaks selguma, kas sul puudusid mingid tööriistad või arenduspaketid (logifailide asukoha määrab konfiguratsioonifailis võti log-dir). Mõnikord on arendusharu üsna ebastabiilne ega taha lasta kuidagi ennast ehitada, eriti siis, kui arenduse külmutamispunkt peaks lähedal olema. Nii et ole kannatlik. Rohkem näiteid asjade kohta, mis saavad valesti minna, ja võimaluste kohta neid probleeme lahendada, samuti üldisi &kde; ehitamise nippe ja strateegiaid pakub dokument <ulink url="http://quality.kde.org/develop/cvsguide/buildstep.php#step1"
> Building &kde; from Source Step by Step Guide</ulink
>. </para>
</sect1>
<sect1 id="environment">
<title
>Värske &kde; töökeskkonna määramine</title>
<para
>Eeldusel, et lõid &kde; ehitamiseks spetsiaalse kasutaja ja sul on juba paigaldatud &kde; versioon, on oma uue &kde; töölepanek mõnevõrra keerulisem, sest vana asemel peab ju käivituma uus &kde;. Selleks tuleb muuta keskkonnamuutujaid. </para>
>Nüüd käivita oma uus &kde;: virtuaalsete terminalide toetusega BSD ja Linuxi süsteemides kasutatakse klahvikombinatsioone Ctrl+Alt+F1...F12 lülitumiseks vastavalt virtuaalsele konsoolile 1 kuni 12. See võimaldab korraga panna tööle enam kui ühe töökeskkonna. Esimesed kuus on tekstiterminalid, viimased kuus graafilised kuvad. </para>
<para
>Kui sinu ette ilmub pärast arvuti käivitamist graafiline kuvahaldur, võid uue KDE töökeskkonna käivitada ka siis, kui seda valikute seas ei leidu. Selleks vajuta lihtsalt Crtl + Alt + F2 ning sinu ette ilmub tekstiterminal. Logi sisse spetsiaalse kasutajana ja anna käsk: </para>
<screen
>startx -- :1
</screen>
<tip>
<para
>Lähtekoodist paigaldatud ja vana KDE võivad isegi korraga töötada! Logi sisse tavalise kasutajana ja käivita stabiilne KDE töölaud. Vajuta Crtl + Alt + F2 (või F1, F3 jne.) ning sinu ette ilmub tekstiterminal. Logi sisse spetsiaalse kasutajana ja anna käsk "startx -- :1". Tavalise kasutaja töölauale saad tagasi liikuda klahvikombinatsiooniga Crtl + Alt + F6 (või F7, F8 jne. - proovi, milline on see õige!). Lähtekoodist paigaldatud KDE juurde pääsed uuesti klahvikombinatsiooniga Crtl + Alt + F7 (või F6, F8 jne.). Nüüd võid lülituda erinevate KDE seansside vahel ja testida uut keskkonda teadmises, et saad alati turvaliselt naasta stabiilsele KDE töölauale. </para>
>Moodulite automaatne väljavõtmine või uuendamine &svn;ist (kui vaja). </para
></listitem>
<listitem
><para
>Mõõdab moodulite ehitamise aega. </para
></listitem>
<listitem
><para
>Püüab automaatselt ümber ehitada mooduelid, mis kasutavad kasvavat make'i (tõsi, see ei pruugi alati õnnestuda). </para
></listitem>
<listitem
><para
>Võib jätkata kohast, kus eelmine skript pooleli jäi, või alustada ehitamist konkreetsest moodulist. </para
></listitem>
<listitem
><para
>Pakub omalt poolt välja mõistliku valiku vaikevõtmeid &kde; elementaarse ühekasutajapaigalduse tekitamiseks anonüümse &svn;i hoidla lähtekoodi põhjal. </para
>Seadistatavad ehitamis-, lähtekoodi- ja logikataloogid </para
></listitem>
<listitem
><para
>Automaatne ehitussüsteemi loomine, milles lähtekoodikataloog erineb ehitamiskataloogist, et tagada lähtekoodikataloogi rikkumatus. Erandiks on <application
>qt-copy</application
>, mille ehitamine ei olegi nii mõeldud (kui sa ei soovi just testida <link linkend="conf-use-qt-builddir-hack"
><quote
>qt'd eraldi ehituskataloogi võttega</quote
></link
>). </para
></listitem>
<listitem
><para
>Saab määrata globaalsed võtmed kõigile väljavõetavale moodulile, samuti võtmed igale moodulile eraldi. </para
>Kuna auto-tööriistad ei suuda mõnikord käia kaasas lähtekoodipuu muudatustega, saab mooduli ümberehitamise peale sundida, luues vajaliku mooduli ehituskataloogis faili .refresh-me või käivitates &tdesvn-build;'i võtmega <option
>Käskude logimine. Logid dateeritakse ja nummerdatakse, nii et iga skripti käivitamise kohta on alati omaette logi. Samuti osutab spetsiaalne link nimega latest alati logikataloogi kõige uuemale logile. </para
></listitem>
<listitem
><para
>Kui ehitad &kde; kasutajale, mitte süsteemsena (viimaseks peab olema administraator), saab lasta skriptil enda eest paigaldamine ära teha. See kood ei ole küll saanud vajalikku tähelepanu ning kasutab ohtralt funktsiooni <function
>system()</function
> väljakutseid, mistõttu hetkel ei ole ilmselt soovitatav seda administraatorina tarvitada. </para
></listitem>
<listitem
><para
><link linkend="conf-make-install-prefix"
>make-install-prefix</link
> võimaldab anda käsule make install prefiksi omaette käsuna, mis on kasulik näiteks sudo pruukimisel. </para
></listitem>
<listitem
><para
>Võtmega <link linkend="conf-apidox"
>apidox</link
> saab lastada automaatselt ehitada ja paigaldada mõne mooduli API dokumentatsiooni. </para
></listitem>
<listitem
><para
>Välja võib võtta ainult osa &kde; &svn;i moodulist. Näiteks võib välja võtta ainult <application
> andes pakub skript väga põhjaliku käivitatavate käskude kirjelduse ilma neid tegelikult käivitatamata. </para
></listitem>
<listitem
><para
>Välja võib võtta &svn;i moodulite konkreetseid harusid. See võimalus ei ole veel küll veatu, kuid igatahes saab valida ehitamiseks vajaliku haru, kasutades <link linkend="conf-module-base-path"
> peab olema &kde; &svn;i hoidlas leiduva mooduli nimi (näiteks tdelibs või tdebase). Mõned võtmed tühistavad globaalsed võtmed, mõned täiendavad globaalseid võtmeid, mõningaid globaalseid võtmeid aga ei saagi millegagi tühistada. </para>
>Järgnevalt toome tähestiku järjekorras ära kasutatavate võtmete nimekirja. Klõpsuga võtme nimele näeb selle kohta rohkem infot. Kui mõni võti pole dokumenteeritud, saada palun autoritele e-kiri, kasutades aadressi, mille leiad <link linkend="authors"
>eestpoolt</link
>. </para>
<itemizedlist>
<listitem
><para
><link linkend="conf-apidox"
>apidox</link
> ehitab API dokumentatsiooni.</para
></listitem>
<listitem
><para
><link linkend="conf-apply-qt-patches"
>apply-qt-patches</link
> võimaldab kasutada qt-copy parandusi.</para
></listitem>
<listitem
><para
><link linkend="conf-binpath"
>binpath</link
> määrab muutuja <envar
>PATH</envar
>.</para
></listitem>
<listitem
><para
><link linkend="conf-branch"
>branch</link
> teeb väljavõtte harust, mitte aga tüvest (trunk).</para
> muudab serverit, kust lähtekood alla laaditakse.</para
></listitem>
<listitem
><para
><link linkend="conf-use-qt-builddir-hack"
>use-qt-builddir-hack</link
> võimaldab Qt korral kasutada lähtekoodikataloogist erinevat ehitamiskataloogi (nagu KDE puhul).</para
></listitem>
<listitem
><para
><link linkend="conf-use-unsermake"
>use-unsermake</link
> võimaldab kasutada täiustatud unsermake'i ehitamissüsteemi.</para
></listitem>
</itemizedlist>
<para
>Toome siin ära erinevate võtmete tabeli, kus neid on ka kommenteeritud. Kõik võtmed, mis tühistavad globaalse võtme, tühistavad ka käsureamääratluse. </para>
>, et &tdesvn-build; ehitaks ja paigaldaks mooduli API dokumentatsiooni automaatselt pärast tavalist ehitamist/paigaldamist. See toimib ainult moodulite korral, kus käsk <command
>See võti käib ainult qt-copy kohta. Kui väärtuseks on midagi muud kui null, siis käivitatakse enne ehitamist qt-copy kataloogis skript apply-patches, millega qt-copy'le lisatakse mitteametlikud paigad. Kuna need paigad ongi enamasti põhjuseks, miks kasutada qt-copy't, mitte aga tavalist Qt'd, siis ei tohiks üldiselt mingit kahju sündida. Vaikimisi on paikade kasutamine sisse lülitatud.</entry>
</row>
<row id="conf-binpath">
<entry
>binpath</entry>
<entry
>Ei ole tühistatav</entry>
<entry
><para
>Selle võtmega saab ehitamiseks määrata keskkonnamuutuja PATH. Seda ei saa moodulivõtmega tühistada. Vaikimisi on väärtuseks <filename class="directory"
> lisatakse automaatselt. Selle võtme juures võib iga asukoha määramisel tarvitada ka tildet (~).</para>
</entry>
</row>
<row id="conf-branch">
<entry
>branch</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
><para
>Selle võtmega saab määrata KDE haru väljavõtmise, mitte aga vaikimisi väljavõetava tüve ("trunk"), kus üldiselt käib põhiline arendustegevus. Näiteks KDE 3.4 haru väljavõtmiseks määra võtme väärtuseks "3.4".</para>
<para
>Pane tähele, et mõned moodulid kasutavad teistsugust harunime. Eriti paistab selles mõttes silma nõutav moodul arts. KDE 3.4 korral on õigeks versiooniks 1.4.</para>
>Kui tdesvn-build ei suuda antud võtmega haru korralikult alla laadida, võib olla vajalik käsitsi määrata allalaadimiskoha URL võtmega <link linkend="conf-override-url"
>Selle võtmega saab muuta ehitamiseks kasutatava lähtekoodikataloogi asukohta. Seda saab määrata kolmel viisil: <itemizedlist
> <listitem
><para
>Suhteline &kde; &svn;i lähtekoodikataloogi suhtes (vaata <link linkend="conf-source-dir"
>the source-dir option</link
>). See on vaikevalik, mida skript kasutas versiooni 0.61. See valitakse juhul, kui annad kataloogi nime, mille alguses ei seisa tilde (~) või kaldkriips (/).</para
> <para
>Vaikeväärtus on <filename class="directory"
>build</filename
>.</para
></listitem
> <listitem
><para
>Absoluutne asukoht. Kui määrad asukoha, mille alguses seisab kaldkriips (/), kasutatakse täpselt määratud asukohta. Näide: <filename class="directory"
>/tmp/kde-obj-dir/</filename
>.</para
></listitem
> <listitem
><para
>Suhteline kodukataloogi suhtes. Kui määrad asukoha, mille alguses seisab tilde (~), arvestatakse seda asukohta sinu kodukataloogist lähtudes. Näide: <filename class="directory"
>~/builddir</filename
> määrab ehitamiskataloogiks <filename class="directory"
>/home/user-name/builddir</filename
>.</para
></listitem
> </itemizedlist
> Mõnevõrra üllatuslikult saab seda võtit muuta ka igas moodulis eraldi. </entry>
</row>
<row id="conf-checkout-only">
<entry
>checkout-only</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Selle võtmega saab määrata &svn;i lähtekoodi väljavõtmise jupphaaval. Võtme väärtus kujutab endast tühikutega eraldatud väljavõetavate kataloogide nimekirja. Kui kataloog admin andmata jätta, lisatakse see automaatselt (vajaduse korral muidugi). Jupphaaval välja võttes hangitakse kataloog admin moodulist kde-common, kus see &svn;i serveris vaikimisi paiknebki. Ehkki see võti tühistab globaalse võtme, pane tähele, et selle määramine globaalse võtmena pole just eriti mõttekas. </entry>
>Selle võtmega saab määrata, millised lipud edastada käsule ./configure mooduli ehitamissüsteemi loomisel. Kasutamisel globaalse võtmena rakendatakse seda kõigile moodulitele, mida skriptiga ehitatakse. qt-copy kasutab märksa teistsugust konfiguratsioonivõtmete valikut kui ülejäänud &kde;. mis tähendab, et see võti <emphasis
>tühistab</emphasis
> globaalsed seadistused, kui seda rakendatakse ka qt-copy jaoks.</entry>
>Selle võtmega saab määrata, millised lipud edastada käsule <command
>./configure</command
> kui <envar
>CXXFLAGS</envar
> mooduli ehitamissüsteemi loomisel. See võti on siin võtme <link linkend="conf-configure-flags"
>configure-flags</link
> asemel, sest see määrab ka ehitamise ajal keskkonnamuutuja <envar
>CXXFLAGS</envar
>. </entry>
</row>
<row id="conf-dest-dir">
<entry
>dest-dir</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Selle vätmega saab määrata moodulile kettal antava nime. Kui näiteks moodul on extragear/network, saab selle võtmega anda sellele nimeks extragear-network. </entry>
>Kui kasutad Subversion-lähtekoodi allalaadimiseks SSH-d (näiteks protokolli svn+ssh puhul), siis tdesvn-build püüab tavaliselt kontrollida, et ssh-agent haldaks tõepoolest mingeid SSH-identiteete. Nii saab vältida seda, et SSH päriks iga mooduli korral paroolifraasi. Soovi korral võib selle kontrolli välja lülitada, andes võtmele väärtuseks 'true'. </entry>
>Selle võtmega saab määrata enne konfigureerimisskripti käivitamist keskkonnamuutuja <envar
>DO_NOT_COMPILE</envar
>. Vastavalt dokumendile <ulink url="http://developer.kde.org/documentation/other/developer-faq.html"
>&kde; Developer FAQ</ulink
> ei ehitata selle korral ühtegi määratud tipptaseme kataloogi. Kataloogid tuleb eraldada tühikuga.</para>
<para
>Pane tähele, et programmide lähtekood laaditakse sellele vaatamata alla. Määramaks, milliseid katalooge alla laaditakse, kasuta võtit <link linkend="conf-checkout-only"
>Selle võtmega saab määrata e-posti aadressi, mida tdesvn-build kasutab, kui tal peaks tekkima vajadus e-kirja saata. Selle üle ei peaks muret tundma, kui sa ei kasuta mõnda e-posti võimalusega omadust (vaikimisi on need välja lülitatud). </para>
>Selle võtmega võib määrata e-posti aadressi, kuhu saata kiri, kui mooduli ehitamine ebaõnnestub. tdesvn-build ootab, kuni kõigi moodulite ehitamine on lõppenud ja koondab siis kõik tulemused rapordisse. Raport saadetakse ainult siis, kui mooduli ehitamine ebaõnnestus. </para>
>See on vastupidine võtmele <link linkend="conf-do-not-compile"
>do-not-compile</link
>. Sellega saab määrata, et ehitatakse ainult kindlad tipptaseme kataloogid. Kataloogid tuleb eraldada tühikuga.</para>
<para
>Muudatused jõustuvad alles siis, kui käsk <command
>make <option
>-f</option
> Makefile.cvs</command
> uuesti käivitatakse - kas automaatselt skripti poolt või käsitsi võtmega <link linkend="cmdline-refresh-build"
><option
>--refresh-build</option
></link
> või <link linkend="cmdline-recreate-configure"
><option
>--recreate-configure</option
></link
>. </para>
<para
>Pane tähele, et programmide lähtekood laaditakse sellele vaatamata alla. Määramaks, milliseid katalooge alla laaditakse, kasuta võtit <link linkend="conf-checkout-only"
>checkout-only</link
>.</para>
</entry>
</row>
<row id="conf-install-after-build">
<entry
>install-after-build</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Selle võtmega saab paketi paigaldada pärast edukat ehitamist. Vaikimisi on see sisse lülitatud. Kui soovid seda keelata, määra selle võtme väärtuseks konfiguratsioonifailis 0. Samuti võib tarvitada käsurealippu <link linkend="cmdline-no-install"
>Selle võtmega määratakse kataloog, kuhu &kde; pärast ehitamist paigaldatakse. Vaikimisi on selleks <filename class="directory"
>~/kde</filename
>. Kui määrad siin kataloogi, mille ligipääs nõuab administraatori õigusi, tasuks tutvuda ka võtme <link linkend="conf-make-install-prefix"
>make-install-prefix</link
> kirjeldusega.</entry>
</row>
<row id="conf-libpath">
<entry
>libpath</entry>
<entry
>Ei ole tühistatav</entry>
<entry
>Selle võtmega saab määrata ehitamise ajal kasutatava keskkonnamuutuja LD_LIBRARY_PATH. Seda ei saa moodulivõtmega tühistada. Vaikimisi on see tühi, kuid asukohad <filename class="directory"
> lisatakse automaatselt. Võtme juures võib iga asukoha määramisel kasutada tildet (~). </entry>
</row>
<row id="conf-log-dir">
<entry
>log-dir</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Selle võtmega saab muuta kataloogi, kus hoitakse skripti tekitatud logifaile. Alates skripti versioonist 0.64 saab seda määrata igale moodulile eraldi. </entry>
</row>
<row id="conf-make-install-prefix">
<entry
>make-install-prefix</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Selle võtmega saab tühikutega eraldatult määrata nimekirja, mida tõlgendatakse käsu ja selle võtmetena, mis lisatakse moodulite paigaldamiseks kasutatava käsu make install ette. See on kasulik näiteks pakettide paigaldamisel sudo'ga, kuid palun ole ettevaatlik, kui tegemist on administraatori õigustega.</entry>
</row>
<row id="conf-make-options">
<entry
>make-options</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Selle muutujaga saab edastada käsule make käsureavõtmeid. See on kasulik sellistele programmidele nagu <ulink url="http://distcc.samba.org/"
><application
>distcc</application
></ulink
>. <application
>distcc</application
> võimaldab jagada kompileerimise tulemust enam kui ühele arvutile. Selle kasutamiseks tuleb edastada käsule make võti <option
>-j</option
>. Vastavalt dokumentatsioonile on soovitatav lisada sellele arv kujul 2 * võrguprotsessorite_arv. Kui sul on kokku ainult üks protsessor, siis peaks see olema <option
>-j2</option
>.</entry>
</row>
<row id="conf-manual-build">
<entry
>manual-build</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Määra võtme väärtuseks <quote
>true</quote
>, kui soovid, et ehitamisel ei ehitataks antud moodulit. &svn;ist uuendamisel seda siiski uuendatakse. See on samaväärne käsureavõtmega <link linkend="cmdline-no-build"
><option
>--no-build</option
></link
>. </entry>
</row>
<row id="conf-manual-update">
<entry
>manual-update</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Määra võtme väärtuseks <quote
>true</quote
>, kui soovid, et ehitamisel ei üritataks moodulit uuendada (ja seeläbi ka ehitada ega paigaldada). Kui määrad selle võtme moodulile, siis tähendab see sisuliselt selle kõrvalejätmist ehitamisest. </entry>
>Selle võtmega saab tühistada &tdesvn-build;'i vaikimisi kataloogiasukoha antud moodulile. Seda saab kasutada näiteks konkreetse haru või sildi väljavõtmiseks. Õige asukoha määratlemisel on kindlasti hindamatuks abiks <ulink url="http://websvn.kde.org/"
>Selle võtme väärtus on arv vahemikus 20 kuni 0. Mida suurem arv, seda väiksem on prioriteet, mida &tdesvn-build; endale omistab. Vaikeväärtus on 10. </entry>
>, kui soovid vältida, et &tdesvn-build; hakkaks moodulit ümberehitama, kui inkrementehitamine ei õnnestu. Tavaliselt püüab &tdesvn-build; mooduli algusest peale ümber ehitada, et takistada &svn;i uuendamise halba mõju ehitamissüsteemile.</entry>
>. Üldiselt tuleks seda kasutada siis, kui soovid alla laadida konkreetset väljalaset, kuid tdesvn-build ei suuda sinu soovides võtme <link linkend="conf-branch"
>Selle võtmega saab määrata ehitamisel kasutatava keskkonnamuutuja QTDIR. Seda ei saa moodulivõtmega tühistada. Kui see pole määratud, kasutatakse vaikimisi asukohta <filename class="directory"
><varname
>$(source-dir)</varname
>/build/qt-copy</filename
>, mis kasutab &kde; lähtekoodihoidlas leiduvat qt-copy moodulit. Kodukataloogi tähistamiseks võib kasutada tildet (~). </entry>
</row>
<row id="conf-remove-after-install">
<entry
>remove-after-install</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
><para
>Kui sul napib kõvakettal ruumi, võib selle võtmega lasta automaatselt kustutada ehitamiskataloogi (või ka korraga nii lähtekoodi- kui ka ehitamiskataloogi) pärast mooduli edukat paigaldamist. </para>
<para
>Võtme võimalikud väärtused on järgmised: <itemizedlist>
<listitem
><para
>none - midagi ei kustutata (vaikimisi).</para
></listitem>
<listitem
><para
>builddir - kustutatakse ehitamiskataloog, aga mitte lähtekoodikataloog.</para
></listitem>
<listitem
><para
>all - kustutatakse nii lähtekoodi- kui ehitamiskataloog.</para
>Pane tähele, et selle võtme kasutamine mõjutab päris negatiivselt nii sinu tekitatavat võrgukoormust (kui kasutad väärtust 'all') kui ka KDE kompileerimiseks kuluvat aega, sest tdesvn-build ei saa sel juhul kasutada inkrementehitamist.</para>
>Selle võtme juures saab anda tühikuga eraldatult väärtuste nimekirja, mille esimene väärtus on määratav keskkonnamuutuja ja ülejäänud selle muutuja väärtused. Näiteks muutujale RONALD väärtuse McDonald andmine käib nii:</para>
<screen
><command
>set-env</command
> <envar
>RONALD</envar
> <userinput
>McDonald</userinput
></screen>
<para
>See võti on eriline selle poolest, et seda võib korrata ilma varasemaid set-env määratlusi konfiguratsioonifaili samas sektsioonis tühistamata. Sel moel võid moodulis (või ka globaalselt) määrata mitu keskkonnamuutujat.</para>
</entry>
</row>
<row id="conf-source-dir">
<entry
>source-dir</entry>
<entry
>Ei ole tühistatav</entry>
<entry
>Selle võtmega saab määrata kataloogi oma arvutis, kuhu salvestatakse &kde; &svn;i lähtekood. Kui see pole määratud, kasutatakse vaikeväärtusena <filename class="directory"
>Kui kasutad tdesvn-build'i sellepärast, et sul on probleeme sinu distributsioonile mõeldud KDE väljalasetega, võiks kaaluda mõte pruukida <ulink url="http://developer.kde.org/build/konstruct/"
> srcdir != builddir režiimi. Sisselülitamise korral kopeerib &tdesvn-build; qt-copy lähtemooduli ehitamiskataloogi ja sooritab ehitamise seal. See tähendab, et keskkonnamuutuja QTDIR väärtuseks tuleb määrata <filename class="directory"
>. Samuti tuleb vastavalt muuta võtit <link linkend="conf-qtdir"
>qtdir</link
>. Selles režiimis saab kasutada ka inkrement-make'i, sest kopeerimise järel säilitatakse ajatemplid. Kui tarvitad võtit <link linkend="conf-apply-qt-patches"
>apply-qt-patches</link
>, rakendatakse paigad ehitamis-, mitte lähtekoodikataloogis. Vaikimisi on võtme väärtuseks <quote
>true</quote
>. </entry>
</row>
<row id="conf-use-unsermake">
<entry
>use-unsermake</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
><para
>Määra võtme väärtuseks <quote
>true</quote
>, kui soovid konfigureerimisskripti käivitamisel kasutada atuomake'i asemel eksperimentaalset unsermake'i. See võib mõnikord suurendada tublisti ehitamisaega, eriti <ulink url="http://www.csh.rit.edu/slashdot/distcc.html"
>jagatud ehitamissüsteemi</ulink
> korral. Vaikimisi on väärtuseks enamiku moodulite korral <quote
>Tavaliselt püüab tdesvn-build selle võtme kasutamisel hoida unsermake'i alati värskena. See võib muutuda tülikaks, eriti kui soovid unsermake'i ise hallata. Sel juhul anna võtmele väärtuseks <quote
>Skript ei kasuta keskkonnamuutujaid. Kui sul on vaja ehitamiseks või paigaldamiseks määrata keskkonnamuutujaid, uuri võtme <link linkend="conf-set-env"
>Tegelikult EI VÕETA midagi ette, vaid ainult teeseldakse. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-quiet">
<term
><option
>--quiet</option
> (või <option
>-q</option
>)</term>
<listitem
><para
>Väljund on väheminformatiivsem, näidatakse ainult kõige olulisemaid teateid. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-really-quiet">
<term
><option
>--really-quiet</option
></term>
<listitem
><para
>Väljund näitab ainult hoiatusi ja veateateid. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-verbose">
<term
><option
>--verbose</option
></term>
<listitem
><para
>Väljund näitab põhjalikult kõike, mis toimub. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-svn-only">
<term
><option
>--svn-only</option
></term>
<listitem
><para
>Võetakse ette ainult lähtekoodi uuendamine. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-build-only">
<term
><option
>--build-only</option
></term>
<listitem
><para
>Võetakse ette ainult ehitamine. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-ignore-modules">
<term
><option
>--ignore-modules</option
></term>
<listitem
><para
>Uuendamisse/ehitamisse ei kaasata ülejäänud käsureal antud mooduleid. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-no-svn">
<term
><option
>--no-svn</option
></term>
<listitem
><para
>Ei looda ühendust &svn;i serveriga. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-no-build">
<term
><option
>--no-build</option
></term>
<listitem
><para
>Ehitamine jäetakse vahele. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-no-install">
<term
><option
>--no-install</option
></term>
<listitem
><para
>Pakette ei paigaldata pärast ehitamist automaatselt. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-debug">
<term
><option
>--debug</option
></term>
<listitem
><para
>Lülitab sisse silumisrežiimi. Praegu tähendab see seda, et lisaks logimisele logikataloogi saadetakse kogu väljund ka standardväljundisse (STDOUT). Samuti annavad paljud funktsioonid silumisrežiimis märksa enam infot oma tegevuse kohta. </para
>Ei üritata algusest peale ümber ehitada mooduleid, mille ehitamine ebaõnnestus. &tdesvn-build; ei ürita seda kunagi mooduli korral, mida on juba püütud algusest peale ehitada. </para
>Taasluuakse ehitamissüsteem ja alustatakse algusest peale. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-reconfigure">
<term
><option
>--reconfigure</option
></term>
<listitem
><para
>Käivitatakse uuesti konfigureerimisskript ilma ehitamiskataloogi puhastamata. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-recreate-configure">
<term
><option
>--recreate-configure</option
></term>
<listitem
><para
>Antakse uuesti käsk <command
>make <option
>-f</option
> Makefile.cvs</command
>, et luua konfigureerimisskript ja jätkata ehitamist normaalselt. See eeldab võtit <option
><link linkend="cmdline-reconfigure"
>--reconfigure</link
></option
>. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-resume">
<term
><option
>--resume</option
></term>
<listitem
><para
>See üritab jätkata ehitamist sealt, kus skript eelmisel korral pooleli jäi. Skript hakkab ehitama moodulit, mis järgneb moodulile, mida kompoleeriti skripti viimasel töökorral (sõltumata sellest, kas ehitamine oli edukas või mitte). See eeldab võtit <link linkend="cmdline-no-svn"
><option
>--no-svn</option
></link
>. Käsureal ei tohi määrata teisi moodulinimesid. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-resume-from">
<term
><option
>--resume-from</option
></term>
<listitem
><para
>Sarnaneb võtmega <link linkend="cmdline-resume"
><option
>--resume</option
></link
>, ainult et sul tuleb anda käsureal parameetrina moodul, millest ehitamist alustada. See eeldab võtit <link linkend="cmdline-no-svn"
><option
>--no-svn</option
></link
>. Käsureal ei tohi määrata teisi moodulinimesid. </para
> täitmist. Konfiguratsiooniskripti paneb &tdesvn-build; tööle siis alles järgmisel käivitamisel. See võimaldab kõik konfiguratsiooniskriptid korraga ette valmistada, nii et saad vaadata igas moodulis <command
>Kui see on ainus käsureavõti, üritatakse paigaldada kõik edukalt ehitatud moodulid, välja arvatud qt-copy, mis ei vaja paigaldamist. Kui pärast võtit <option
>--install</option
> esineb veel käsureavõtmeid, tõlgendatakse neid paigaldatavate moodulitena. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-global-option">
<term
><option
>--<võtme-nimi>=</option
></term>
<listitem
><para
>Selle võtmega saab kõigi mooduli jaoks tühistada konfiguratsioonifailis leiduva võtme. Kui näiteks soovid tühistada võtit <link linkend="conf-log-dir"
>Selle võtmega saab iga mooduli jaoks tühistada konfiguratsioonifailis leiduva võtme. Kui näiteks soovid tühistada võtit <link linkend="conf-use-unsermake"
