<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "Kdesvn-build">
  <!ENTITY package "kdesdk">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Estonian  "INCLUDE"
> <!-- Change language only here -->
  <!ENTITY kdesvn-build "<application
>Kdesvn-build</application
>">
  <!ENTITY autoconf '<application
>Autoconf</application
>'>
  <!ENTITY automake '<application
>Automake</application
>'>
  <!ENTITY BSD '<acronym
>BSD</acronym
>'>
  <!ENTITY cmake '<application
>CMake</application
>'>
  <!ENTITY make '<application
>Make</application
>'>
  <!ENTITY ssh '<application
>SSH</application
>'>
  <!ENTITY subversion '<application
>Subversion</application
>'>
  <!ENTITY sudo '<application
>Sudo</application
>'>
  <!ENTITY url '<acronym
>URL</acronym
>'>

  <!-- These define shortcut entities for some of the configuration options.
       Just add them as necessary.
  -->

  <!ENTITY configure-flags '<link linkend="conf-configure-flags"
>configure-flags</link
>'>
  <!ENTITY apply-qt-patches '<link linkend="conf-apply-qt-patches"
>apply-qt-patches</link
>'>
  <!ENTITY kdedir '<link linkend="conf-kdedir"
>kdedir</link
>'>
  <!ENTITY qtdir '<link linkend="conf-qtdir"
>qtdir</link
>'>
  <!ENTITY build-dir '<link linkend="conf-build-dir"
>build-dir</link
>'>
  <!ENTITY module-base-path '<link linkend="conf-module-base-path"
>module-base-path</link
>'>
  <!ENTITY override-url '<link linkend="conf-override-url"
>override-url</link
>'>
  <!ENTITY source-dir '<link linkend="conf-source-dir"
>source-dir</link
>'>
  <!ENTITY email-address '<link linkend="conf-email-address"
>email-address</link
>'>
  <!ENTITY email-on-compile-error '<link linkend="conf-email-on-compile-error"
>email-on-compile-error</link
>'>
  <!ENTITY colorful-output '<link linkend="conf-colorful-output"
>colorful-output</link
>'>
  <!ENTITY tag '<link linkend="conf-tag"
>tag</link
>'>
  <!ENTITY apidox '<link linkend="conf-apidox"
>apidox</link
>'>
  <!ENTITY branch '<link linkend="conf-branch"
>branch</link
>'>
  <!ENTITY no-rebuild-on-fail '<link linkend="conf-no-rebuild-on-fail"
>no-rebuild-on-fail</link
>'>
  <!ENTITY inst-apps '<link linkend="conf-inst-apps"
>inst-apps</link
>'>
  <!ENTITY do-not-compile '<link linkend="conf-do-not-compile"
>do-not-compile</link
>'>
  <!ENTITY checkout-only '<link linkend="conf-checkout-only"
>checkout-only</link
>'>
  <!ENTITY svn-server '<link linkend="conf-svn-server"
>svn-server</link
>'>
  <!ENTITY make-install-prefix '<link linkend="conf-make-install-prefix"
>make-install-prefix</link
>'>
  <!ENTITY niceness '<link linkend="conf-niceness"
>niceness</link
>'>
  <!ENTITY set-env '<link linkend="conf-set-env"
>set-env</link
>'>
  <!ENTITY libpath '<link linkend="conf-libpath"
>libpath</link
>'>
  <!ENTITY binpath '<link linkend="conf-binpath"
>binpath</link
>'>

  <!-- These define shortcut entities for some of the command line options.
       Just add them as necessary.
  -->
  <!ENTITY cmd-nice '<link linkend="cmdline-nice"
>--nice</link
>'>
  <!ENTITY cmd-ignore-modules '<link linkend="cmdline-ignore-modules"
>--ignore-modules</link
>'>
  <!ENTITY cmd-resume-from '<link linkend="cmdline-resume-from"
>--resume-from</link
>'>
  <!ENTITY cmd-no-rebuild-on-fail '<link linkend="cmdline-no-rebuild-on-fail"
>--no-rebuild-on-fail</link
>'>
  <!ENTITY cmd-reconfigure '<link linkend="cmdline-reconfigure"
>--reconfigure</link
>'>
  <!ENTITY cmd-refresh-build '<link linkend="cmdline-refresh-build"
>--refresh-build</link
>'>
]>

<book lang="&language;">

<bookinfo>
<title
>Skripti &kdesvn-build; käsiraamat</title>

<authorgroup id="authors">
<author
><firstname
>Michael</firstname
><surname
>Pyne</surname
> <affiliation
><address
><email
>michael.pyne@kdemail.net</email
></address
></affiliation>
</author
> 
<author
><firstname
>Carlos</firstname
><surname
>Woelz</surname
> <affiliation
><address
><email
>carloswoelz@imap-mail.com</email
></address
></affiliation>
</author
> 


<othercredit role="translator"
><firstname
>Marek</firstname
> <surname
>Laane</surname
> <affiliation
><address
><email
>bald@smail.ee</email
></address
></affiliation
><contrib
>Tõlge eesti keelde</contrib
></othercredit
> 

</authorgroup>

<copyright>
<year
>2006</year>
<year
>2007</year>
<year
>2008</year>
<holder
>Michael Pyne</holder>
</copyright>

<copyright>
<year
>2005</year>
<holder
>Carlos Woelz</holder>
</copyright>


<legalnotice
>&FDLNotice;</legalnotice>

<date
>2009-03-13</date>
<releaseinfo
>1.8</releaseinfo>

<abstract>
<para
>&kdesvn-build; on skript, mis ehitab ja paigaldab &kde; otse &kde; &subversion;i hoidlast leiduvast lähtetekstist.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdesdk</keyword>
<keyword
>SVN</keyword>
<keyword
>Subversion</keyword>
<keyword
>KDE arendus</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Sissejuhatus</title>

<para
>&kdesvn-build; on skript, mis aitab kasutajatel paigaldada <ulink url="http://www.kde.org/"
>&kde;</ulink
> otse <ulink url="http://subversion.tigris.org/"
>&subversion;i</ulink
> hoidlast. </para>

<para
>Alljärgnevalt tuleb juttu &kdesvn-build;'i <link linkend="configure-data"
>konfiguratsioonifaili</link
> süntaksist ja võtmetest, <link linkend="cmdline"
>käsureavõtmetest</link
>, <link linkend="features"
>omadustest</link
> ja <link linkend="getting-started"
>sammudest</link
>, 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 &kdesvn-build; ei tee ise automaatselt. </para>

</chapter>

<chapter id="getting-started">
<title
>Alustamine</title>

<para
>Käesolevas peatükis selgitame, kuidas kasutada &kdesvn-build;'i moodulite väljavõtmiseks &kde; hoidlast ja nende ehitamiseks. Me selgitame ka &kde; &subversion;i põhimõttelist struktuuri ning samme, mida on vaja ette võtta enne skripti käivitamist. </para>

<para
>Kõiki peatükis vaadeldavaid teemasid käsitleb veelgi põhjalikumalt dokument <ulink url="http://techbase.kde.org/Getting_Started/Build/KDE4"
> Building &kde; 4 from Source</ulink
>, mille leiab <ulink url="http://techbase.kde.org/"
>&kde; Techbase'i leheküljelt</ulink
>. 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>

<sect1 id="before-building">
<title
>Süsteemi ettevalmistamine &kde; ehitamiseks</title>

<sect2 id="before-building-users">
<title
>Uue kasutajakonto loomine</title>

<para
>Soovitatav on &kde; alla laadida ja ehitada eraldi 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. Kui mitte, siis tasuks uurida oma distributsiooni dokumentatsiooni või abimaterjale, et süsteem korrektselt ette valmistada ja süsteemne paigaldus õigesti läbi viia. </para>

</sect2>
<sect2 id="before-building-preparation">
<title
>Süsteemi valmisoleku kontrollimine &kde; ehitamiseks lähtekoodist</title>

<para
>Enne skripti &kdesvn-build; (või muude ehitamisstrateegiate) kasutamist tuleb paigaldada arendustööriistad ja teegid, mida &kde; vajab. Täieliku nimekirja toob ära lehekülg <ulink url="http://www.kde.org/info/requirements/3.5.php"
>&kde; Compilation Requirements</ulink
>). &kde; 4 nõuded leiab <ulink url="http://techbase.kde.org/"
>KDE TechBase'ist</ulink
>. </para>

<para
>Loetleme siin mõningad vajalikud asjad:</para>
<itemizedlist>

<listitem
><para
>&kde;3 ehitamise korral on vajalikud GNU Autotools (s.t &automake; ja &autoconf;).</para
></listitem>

<listitem
><para
>&kde; 4 ehitamise korral on vajalik &cmake;. Nõutav versioon sõltub sellest, millises &kde; 4 versioonis ehitamise ette võtad, vaata täpsemaid asjaolusid Techbase'ist.</para
></listitem>

<listitem
><para
>&subversion;i klientprogramm, mis toetab turvalist HTTP-d (https). Vajaliku toetuse tagamiseks anna käsk <userinput
><command
>svn <option
>--version</option
></command
></userinput
> ja uuri tulemust. Kui väljund teatab, et suudab käsitleda https skeemi (kirjutamisõigusega ligipääsuks svn.kde.org-is) või svn skeemi (kirjutuskaitstud ligipääsuks anonsvn.kde.org-is), siis on asi korras.</para
></listitem>

<listitem
><para
>C++ toetusega <application
>gcc</application
> kompilaator. Parim oleks versioon 3.3 või uuem.</para
></listitem>

<listitem
><para
>Kontrolli saidil <ulink url="http://www.kde.org/info/requirements/3.5.php"
>&kde; Compilation Requirements</ulink
>, et sul oleksid olemas ka teised vajalikud teegid.</para
></listitem>

</itemizedlist>

<para
>Üks erand on &Qt; teek. &kdesvn-build; paigaldab tavaliselt &Qt; koopia sõltumata sellest, kas see on sul paigaldatud või mitte, nii et selle eelnev olemasolu pole vajalik. Kui sa ei soovi kasutada &Qt; koopiat, talita nii: </para>

<itemizedlist>
<listitem>
  <para
>Eemalda moodul qt-copy oma <link linkend="configure-data"
>seadistustefailist</link
>, sest seda ei lähe sul ju sel juhul vaja ning selle olemasolu seal pikendab lihtsalt ehitamisaega.</para>
</listitem>

<listitem>
  <para
>Muuda <link linkend="configure-data"
>seadistustefailis</link
> sätet <link linkend="conf-qtdir"
>qtdir</link
>, nii et see osutaks sinu süsteemi &Qt;-le. Enamasti on selleks keskkonnamuutuja $<envar
>QTDIR</envar
> määratlus.</para>
</listitem>

<listitem>
  <para
>Kui sul pole veel &Qt; paigaldatud, paigalda see, kaasa arvatud kõik asjakohased -dev- või -devel-paketid. Vajalik on vähemalt &Qt; 3.3, kui ehitad &kde; 3.5, või &Qt; 4.5, kui ehitad &kde; 4.</para>

  <note
><para
>&kde; 4 ehitamisel on äärmiselt soovitav kasutada &Qt; qt-copy versiooni, mis tagab vajalike paikade olemasolu (see on vaikeseadistus, mida määrab võti <link linkend="conf-apply-qt-patches"
>apply-qt-patches</link
>).</para
></note>
</listitem>
</itemizedlist>

<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 <ulink url="http://techbase.kde.org/Getting_Started/Build/KDE4#Required_packages_from_your_distribution"
>&kde; TechBase</ulink
>. </para>

</sect2>

<sect2 id="before-building-prepare-script">
<title
>&kdesvn-build;'i häälestamine</title>

<sect3 id="get-kdesvn-build">
<title
>&kdesvn-build;'i paigaldamine</title>
<para
>Tõenäoliselt on skript &kdesvn-build; juba sinu süsteemi paigaldatud. Kui see aga nii ei ole, saad selle alla laadida <ulink url="http://kdesvn-build.kde.org/"
>&kdesvn-build;'i koduleheküljelt</ulink
> või &kde; lähtekoodi hoidlast.</para>

<note
><para
>&kdesvn-build; kuulub moodulisse kdesdk, mis on distributsioonidega enamasti juba vaikimisi kaasas. Kui oled &kdesvn-build;i alla laadinud, kontrolli, kas kasutad ikka allalaaditud versiooni. Seda saab kontrollida võtmega --version.</para
></note>

<orderedlist>
<listitem
><para
>&kdesvn-build;i allalaadimiseks koduleheküljelt mine lihtsalt <ulink url="http://kdesvn-build.kde.org/"
>&kdesvn-build;'i koduleheküljele</ulink
> ja tõmba sealt uusim versioon. See on pakitud arhiivi, mille saab lahti pakkida rakendusega &ark; või programmiga <command
>tar</command
>. Arhiivi kuulub skript &kdesvn-build; ning näidisseadistustefail (<filename
>kdesvn-buildrc-sample</filename
>).</para
></listitem>

<listitem
><para
>&kdesvn-build;i võib hankida ka lähtekoodi hoidlast aadressil <ulink url="http://websvn.kde.org/trunk/KDE/kdesdk/scripts/"
>http://websvn.kde.org/trunk/KDE/kdesdk/scripts/</ulink
>. See on &kde; tarkvaraarenduse komplekti skriptide kataloog, kus &kdesvn-build; pesitsebki. Klõpsates kirjele <filename
>kdesvn-build</filename
>, satud leheküljele, kus saad alla laadida uusima versiooni. Salvesta see oma kõvakettal meelepärasesse kohta. Soovi korral laadi alla ka <filename
>kdesvn-buildrc-sample</filename
>.</para
></listitem>
</orderedlist>

<para
>Igal juhul pead kontrollima, et fail <filename
>kdesvn-build</filename
> oleks käivitatav. Mugavuse huvides oleks hea, kui see asuks kataloogis, mida hõlmab keskkonnamuutuja <envar
>PATH</envar
>, vastasel juhul saad teate, et käsku ei leitud, või võid eksikombel käivitada varasema süsteemis leiduva versiooni.</para>
</sect3>

<sect3 id="setup-rcfile">
<title
>Seadistustefaili häälestamine</title>

<para
>Kuigi &kdesvn-build; ei nõua <link linkend="configure-data"
>seadistustefaili</link
> loomist, on selle abil töö märksa lihtsam. <link linkend="configure-data"
>Seadistustefailiga</link
> saad kontrollida, millised moodulid paigaldatakse, või eemaldada moodulid, mida sa ei soovi paigaldada. Vaikimisi paigaldab &kdesvn-build; tavapärase &kde; üsna üldiste paigaldusvõtmetega, mis ei pruugi sulle sobida. Seepärast ongi mõttekas kasutada <link linkend="configure-data"
>seadistustefaili</link
>. </para>

<para
><link linkend="configure-data"
>Seadistustefaili</link
> nimeks peab olema <filename
>.kdesvn-buildrc</filename
>. See peab asuma kodukataloogis (<filename class="directory"
>~/</filename
>) 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
>kdesvn-buildrc-sample</filename
>, mille võidki kopeerida nimega <filename
>~/.kdesvn-buildrc</filename
> ja seejärel vastavalt oma vajadustele redigeerida. </para>

<para
>Rohkem infot <link linkend="configure-data"
>seadistustefaili</link
> süntaksi kohta annavad <xref linkend="configure-data"/> ja <xref linkend="kdesvn-buildrc"/>. </para>

</sect3>
</sect2>
</sect1>

<sect1 id="configure-data">
<title
>Konfiguratsiooniandmete määramine</title>

<para
>Skripti &kdesvn-build; kasutamiseks peab sinu kodukataloogis asuma fail nimega <filename
>.kdesvn-buildrc</filename
>, mis määrab üldised võtmed ning moodulid, mida soovid alla laadida ja ehitada. </para>

<note
><para
>&kdesvn-build; võimaldab kasutada erinevaid seadistustefaile, sellest kõneleb lähemalt <xref linkend="kdesvn-buildrc"/>. Kui tahad kasutada erinevaid seadistusi, tutvu palun selle osaga. Siinkohal eeldame, et seadistustefail paikneb asukohas <filename
>~/.kdesvn-buildrc</filename
>.</para
></note>

<para
>Kasuta globaalsete võtmete ja ehitatavate moodulite määramisel eeskujuna faili <filename
>kdesvn-buildrc-sample</filename
>. </para>

<para
>Vaikimisi seadistused peaksid üldiselt sobima &kde; ehitamiseks. Seadistused, mida võib olla mõttekas muuta, on järgmised: <itemizedlist>
<listitem
><para
><link linkend="conf-binpath"
>binpath</link
> võimaldab muuta kataloogide nimekirja, kust käske otsitakse. See võrdub shelli keskkonnamuutujaga <envar
>PATH</envar
>.</para
></listitem>

<listitem
><para
><link linkend="conf-use-stable-kde"
>use-stable-kde</link
> võimaldab muuta &kde; moodulite ehitamise vaikeversiooni. Vaikimisi ehitab &kdesvn-build; &kde; tüves paikneva versiooni (praegu &kde; 4). Kui soovid ehitada aga &kde; uusima stabiilse versiooni (praegu on stabiilne versioon &kde; 3.5 haru), siis tuleks see võti määrata tõeseks (<replaceable
>true</replaceable
>). </para
></listitem>

<listitem
><para
><link linkend="conf-kdedir"
>kdedir</link
> võimaldab muuta sihtkataloogi, kuhu &kde; paigaldatakse. Vaikimisi on selleks <filename class="directory"
>~/kde</filename
>, mis vastab üksikkasutaja paigaldusele.</para
></listitem>

<listitem
><para
><link linkend="conf-qtdir"
>qtdir</link
> võimaldab määrata kasutatava &Qt; paigalduse asukoha. Vaikimisi kasutatakse &kde; &subversion;i hoidla moodulit qt-copy (<filename class="directory"
>~/kdesvn/build/qt-copy</filename
>).</para>

<para
>Paigaldamist toetavate Qt versioonide korral määrab see ka asukohta, kuhu paigaldada qt-copy.</para
></listitem>

<listitem
><para
><link linkend="conf-svn-server"
>svn-server</link
> võimaldab määrata &url;-i, kust lähtekood alla laadida. See on kasulik juhul, kui oled arendaja, kellel on <ulink url="http://techbase.kde.org/Contribute/First_Steps_with_your_KDE_SVN_Account"
>&kde; &subversion;i konto</ulink
>.</para
></listitem>
</itemizedlist>
</para>

<para
>Globaalse sektsiooni järel tuleb ehitatavate moodulite nimekiri kujul module ... end module. Kontrolli, kas kirjasolevad moodulid on ikka need, mida soovid ehitada. Faili <filename
>kdesvn-buildrc-sample</filename
> vaikevõtmed peaksid sobima üsna hästi korraliku &kde; paigalduse tekitamiseks. Salvesta lõplik <filename
>.kdesvn-buildrc</filename
> oma kodukataloogi. </para>

<para
>Kui soovid faili <filename
>.kdesvn-buildrc</filename
> väga täpselt oma vajadustele kohandada, räägib konfiguratsioonivõtmetest lähemalt <xref linkend="kdesvn-buildrc"/>. </para>

</sect1>

<sect1 id="building-and-troubleshooting">
<title
>Skripti &kdesvn-build; kasutamine</title>

<para
>Nüüd oled valmis skripti käivitama. Logi terminaliaknas sisse selle kasutaja õigustega, kelle lõid &kde; kompileerimiseks, ning käivita skript: <screen
><prompt
>&percnt;</prompt
><command
>su</command
> <option
>-</option
> <replaceable
>kasutajanimi</replaceable>
<prompt
>&percnt;</prompt
><command
>kdesvn-build</command
>
</screen>
</para>

<para
>Nüüd peaks skript hakkama lähtekoodi alla laadima ja kompileerima. Sõltuvalt sellest, kui palju mooduleid alla laadid, võib juhtuda, et &kdesvn-build; ei lõpeta esimesel korral &kde; kompileerimist edukalt. Kuid ära heida meelt! </para>

<para
>&kdesvn-build; logib kõigi käivitatud käskude väljundi. Vaikimisi paiknevad logid asukohas <filename class="directory"
>~/kdesvn/log</filename
>. Kui tahad näha, mis põhjustas viimase skripti &kdesvn-build; käsu korral moodulis vea, piisab enamasti sellest, kui uurida logi <filename class="directory"
>~/kdesvn/log/latest/<replaceable
>mooduli-nimi</replaceable
>/error.log</filename
>.</para>

<para
>Selles failis näed viga, mis põhjustas antud mooduli ehitamise nurjumise. Kui failis seisab kirjas, et mõned paketid puuduvad, ürita need paigaldada (kaasa arvatud vastavad -dev paketid), enne kui hakkad seda moodulit uuesti ehitama, ning kasuta pärast puuduvate pakettide paigaldamist võtit <link linkend="cmdline-reconfigure"
>--reconfigure</link
>.</para>

<para
>Kui aga tegemist on ehitamisveaga, on see arvatavasti &kde; lähtekoodi viga, mis usutavasti parandatakse mõne tunni või päeva jooksul. Kui seda ei juhtu, on mõttekas ehitamisveast teada anda postiloendis <email
>kde-devel@kde.org</email
> (eelnevalt on vaja ennast selle liikmeks registreerida).</para>

<para
>Rohkem näiteid asjadest, mis võivad valesti minna, ning nende lahendusi, aga ka mitmeid üldiseid näpunäiteid ja soovitusi &kde; ehitamiseks leiab veebist: <ulink url="http://techbase.kde.org/Getting_Started/Build/KDE4"
>Building &kde; 4 from Source</ulink
>. </para>

<note
><para
>Täpsemalt kõneleb &kdesvn-build;i logimisvõimalustest <xref linkend="kdesvn-build-logging"/>.</para
></note>

</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>

<sect2 id="changing-profile">
<title
>Käivitusprofiili seadistuste muutmine</title>

<important
><para
>Failis <filename
>.bash_profile</filename
> on kirjas sisselogimisseadistused paljudes &Linux; distributsioonides kasutatava shelli <application
>bash</application
> jaoks. Kui kasutad mõnda muud shelli, võib olla vajalik siinkohal antud näidet veidi kohandada.</para
></important>

<para
>Ava või loo kodukataloogis lemmikredaktoriga fail <filename
>.bash_profile</filename
> ja lisa selle lõppu juhul, kui ehitad moodulit qt-copy (nagu vaikimisi): <programlisting>
QTDIR=(qtdir'i asukoht)   # Such as ~/kdesvn/build/qt-copy by default.
KDEDIR=(kdedir'i asukoht) # Such as ~/kde by default.
KDEDIRS=$KDEDIR
PATH=$KDEDIR/bin:$QTDIR/bin:$PATH
MANPATH=$QTDIR/doc/man:$MANPATH

# Act appropriately if LD_LIBRARY_PATH is not already set.
if [ -z $LD_LIBRARY_PATH ]; then
  LD_LIBRARY_PATH=$KDEDIR/lib:$QTDIR/lib
else
  LD_LIBRARY_PATH=$KDEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH
fi

export QTDIR KDEDIRS PATH MANPATH LD_LIBRARY_PATH
</programlisting
> Kui sa ei ehita moodulit qt-copy, vaid kasutad oma süsteemi &Qt;-d, siis: <programlisting
>KDEDIR=(kdedir'i asukoht)  # Such as ~/kde by default.
KDEDIRS=$KDEDIR
PATH=$KDEDIR/bin:$QTDIR/bin:$PATH

# Act appropriately if LD_LIBRARY_PATH is not already set.
if [ -z $LD_LIBRARY_PATH ]; then
  LD_LIBRARY_PATH=$KDEDIR/lib
else
  LD_LIBRARY_PATH=$KDEDIR/lib:$LD_LIBRARY_PATH
fi

export KDEDIRS PATH LD_LIBRARY_PATH
</programlisting>
</para>

<para
>Kui sa ei tarvita spetsiaalset kasutajat, määra oma failis <filename
>.bash_profile</filename
> uuele keskkonnale teistsugune $<envar
>KDEHOME</envar
>: <programlisting
>export KDEHOME="${HOME}/.kde-svn"

# Create it if needed
[ ! -e ~/.kde-svn ] &amp;&amp; mkdir ~/.kde-svn
</programlisting>
</para>

<note>
<para
>Kui hiljem peaks K-menüü tühi olema või hoopis liiga täis, võib olla vajalik failis <filename
>.bash_profile</filename
> kindlaks määrata ka <acronym
>XDG</acronym
> keskkonnamuutuja: <programlisting
>XDG_CONFIG_DIRS="/etc/xdg"
XDG_DATA_DIRS="${KDEDIR}/share:/usr/share"
export XDG_CONFIG_DIRS XDG_DATA_DIRS
</programlisting>

</para>
</note>

</sect2>
<sect2 id="starting-kde">
<title
>&kde; käivitamine</title>

<para
>Kui keskkonnamuutujad on üle vaadatud, et kasutataks õiget &kde;-d, tuleb kontrollida, et ka skript <command
>startkde</command
> oleks õige. </para>

<para
>Ava kodukataloogis tekstifail <filename
>.xinitrc</filename
> või loo see vajaduse korral. Lisa rida: <programlisting
><command
>exec</command
> <option
>${KDEDIR}/bin/startkde</option
>
</programlisting>
</para>

<important
><para
>Mõne distributsiooni korral võib olla vajalik sama samm ette võtta samuti kodukataloogis paikneva failiga <filename
>.xsession</filename
>. See on eriti vajalik siis, kui kasutusel on graafiline sisselogimishaldur, näiteks &kdm;, <application
>gdm</application
> või <application
>xdm</application
>.</para>
</important>

<para
>Nüüd käivita oma uus &kde;: virtuaalsete terminalide toetusega &BSD; ja &Linux; süsteemides kasutatakse klahvikombinatsioone <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>F1</keycap
></keycombo
> ... <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>F12</keycap
></keycombo
> 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 sind ootab arvuti käivitamisel ees graafiline sisselogimishaldur, võid ometi kasutada uut &kde; keskkonda ka juhul, kui seda ei leidu halduri loendis. Enamik kuvahaldureid, sealhulgas &kdm;, pakuvad <quote
>kohandatud seansi</quote
> võimalust. Sel juhul laaditakse seansi seadistused sinu kodukataloogis asuvast failist <filename
>.xsession</filename
>. Kui oled seda juba muutnud, nagu eespool kirjeldatud, võimaldabki see sul laadida oma uue &kde; paigalduse. </para>

<para
>Kui see miskipärast siiski ei õnnestu, võib proovida veel üht asja, mis enamasti peaks aitama: vajuta <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>F2</keycap
></keycombo
>, mis avab tekstiterminali. Logi sisse vajaliku kasutaja õigustes ja kirjuta: </para>

<screen
><command
>startx</command
> <option
>--</option
> <option
>:1</option
>
</screen>

<tip>
<para
>Lähtekoodist paigaldatud &kde; ja sinu vana &kde; võivad töötada ka üheaegselt! Logi sisse tavalise kasutajana ning käivita oma stabiilne &kde; töölaud. Vajuta <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>F2</keycap
></keycombo
> (või <keycap
>F1</keycap
>, <keycap
>F3</keycap
> jne.), mis avab tekstiterminali. Logi sisse &kde;&subversion;i kasutajana ja kirjuta:</para>

<screen
><command
>startx</command
> <option
>--</option
> <option
>:1</option
>
</screen>

<para
>Oma tavalise kasutaja &kde; töölauale pääsed tagasi, kui vajutad juba töötava töölaua kiirklahvi. Tavaliselt on see <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>F7</keycap
></keycombo
>, aga võimalik, et vajalik on kasutada näiteks <keycap
>F6</keycap
> või <keycap
>F8</keycap
>. Oma &kdesvn-build;iga ehitatud &kde; juurde naasmiseks tuleb teha sedasama, ainult et funktsiooniklahv peab olema numbrilt ühe võrra suurem. Kui näiteks sul on vaja vajutada <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>F7</keycap
></keycombo
> tavalisele &kde; töölauale lülitumiseks, siis &kdesvn-build;i &kde; juurde viib tagasi <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>F8</keycap
></keycombo
>.</para>
</tip>

</sect2>
</sect1>

</chapter>

<chapter id="features">
<title
>Skripti omadused</title>

<sect1 id="features-overview">
<title
>Omaduste ülevaade</title>

<para
>&kdesvn-build;i peamised omadused on järgmised: </para>

<itemizedlist>

<listitem
><para
><link linkend="changing-verbosity"
>Väljundi teadete tasemete</link
> toetus alates väga vaiksest kuni täieliku silumistasemeni. </para
></listitem>

<listitem
><para
>&kdesvn-build; võimaldab <ulink url="http://kdesvn-build.kde.org/"
>&kdesvn-build;i veebilehekülje</ulink
> ja &kde; FTP-serveri (FTP alates versioonist &kdesvn-build; 1.4) abiga mõningate moodulite kiiret väljavõtmist. Kui soovitud moodul on veebilehel juba pakendatud, laadib &kdesvn-build; alla hetktõmmise ja valmistab selle ette sinu arvutis kasutamiseks. </para>

<para
>See on sinu jaoks palju kiirem ning aitab vähendada koormust kde.org-i anonüümse &subversion;i serverites.</para>
</listitem>

<listitem
><para
>Teine asju kiirendav tegur on mooduli ehitamise alustamine kohe pärast seda, kui mooduli lähtekood on alla laaditud (alates versioonist 1.6). </para
></listitem>

<listitem
><para
>Suurepärane <link linkend="using-qt-copy"
>qt-copy mooduli</link
> toetus, sealhulgas vajaduse korral vigu parandavate ja optimeerivate paikade rakendamine qt-copy moodulile. </para
></listitem>

<listitem
><para
>&kdesvn-build;il on <link linkend="kdesvn-build-color"
>värviline väljund</link
>. </para
></listitem>

<listitem
><para
>&kdesvn-build; ei vaja töötamiseks graafilist kasutajaliidest (<acronym
>GUI</acronym
>), mis tähendab, et võid &kde; ehitada ilma alternatiivse graafilise keskkonna vajaduseta. </para
></listitem>

<listitem
><para
>Kõigi moodulite vaikevõtmete määramise (näiteks kompileerimise seadistused või seadistusvõtmed) määramise toetus. Neid võtmeid saab muuta ka iga konkreetse mooduli korral.</para>

<para
>&kdesvn-build; lisab vajaduse korral <link linkend="kdesvn-build-std-flags"
>standarsed lipud</link
>, mis vähendab sinu vaeva ja võimalust, et kirjutad neid käsitsi kogemata valesti. </para
></listitem>

<listitem
><para
>&kdesvn-build; võib teha väljavõtte mooduli konkreetse <link linkend="using-branches"
>haru või sildi</link
> järgi. Samuti on võimalik välja võtta mooduli konkreetne <link linkend="conf-revision"
>versioon</link
>. </para
></listitem>

<listitem
><para
>&kdesvn-build;võib automaatselt vahetada lähtekataloogi, et teha väljavõte mõnest teisest hoidlast või mõne teise haru või sildi järgi. See toimub automaatselt, kui muudad võtit, mis muudab hoidla &url;-i, kuid sa pead kasutama võtit <link linkend="cmdline-svn-only"
>--svn-only</link
>, et &kdesvn-build; teaks, et ta tohib ümber lülituda. </para
></listitem>

<listitem
><para
>&kdesvn-build; võib <link linkend="partial-builds"
>teha väljavõtte ainult osast moodulist</link
>, näiteks juhul, kui vajad mõnest suurest moodulist ainult üht programmi. </para
></listitem>

<listitem
><para
>Arendajatele: &kdesvn-build; <link linkend="ssh-agent-reminder"
>tuletab meelde</link
>, kui kasutad svn+ssh://, aga <application
>ssh-agent</application
> ei tööta, sest vastasel juhul küsib &ssh; parooli korduvalt. </para
></listitem>

<listitem
><para
>Võib saata kasutajale vigade kohta <link linkend="email-reports"
>e-postiga aruandeid</link
>. </para
></listitem>

<listitem
><para
>Võib <link linkend="deleting-build-dir"
>kustutada ehitamiskataloogi</link
> pärast mooduli paigaldamist, et hoida kokku ruumi, ehkki samas pikendab see edaspidi kompileerimisaega. </para
></listitem>

<listitem
><para
>&kdesvn-build;i kasutatavad kataloogide asukohad on seadistatavad (seda isegi mooduli kaupa). </para
></listitem>

<listitem
><para
>Võib kasutada &sudo;-d või mõnda muud kasutaja määratud käsku <link linkend="root-installation"
>moodulite paigaldamisel</link
>, mistõttu &kdesvn-build;i ei pea käivitama tingimata administraatori õigustes. </para
></listitem>

<listitem
><para
>&kdesvn-build; töötab vaikimisi <link linkend="build-priority"
>vähendatud prioriteediga</link
>, mis lubab arvutit edukalt kasutada ka ajal, mil &kdesvn-build; töötab. </para
></listitem>

<listitem
><para
>&kde; &subversion;i <link linkend="using-branches"
>siltide ja harude</link
> kasutamise toetus. </para
></listitem>

<listitem
><para
>&kdesvn-build; kasutab mitmeid viise eduka ehitamise <link linkend="building-successfully"
>tagamiseks</link
>. </para
></listitem>

<listitem
><para
>Määratud mooduli <link linkend="resuming"
>ehitamise taasalustamise</link
> toetus. Võimalik on isegi konkreetse ehitamise korral <link linkend="ignoring-modules"
>eirata teatavaid mooduleid</link
>. </para
></listitem>

<listitem
><para
>&kdesvn-build; võib kiirest sooritada mooduli <link linkend="partial-builds"
>osalise ehitamise</link
> otse käsurealt, kui vajad ainult osa mooduli uuendamist. </para
></listitem>

<listitem
><para
>&kdesvn-build; laadib automaatselt alla ja loob moodulile nõutava <filename
>/admin</filename
> kataloogi, kui seda ei laaditud mingil põhjusel &subversion;ist alla juba esimesel korral. See käib ainult &kde; 3 moodulite kohta, sest qt-copy ega &kde; 4 moodulid ei vaja kataloogi /admin. </para
></listitem>

<listitem
><para
>&kdesvn-build; näitab <link linkend="build-progress"
>ehitamise edenemist</link
> &cmake;'i kasutamisel ning mõõdab alati ehitamise aega, nii et saad hiljem teada, kui palju selleks tegelikult kulus. </para
></listitem>

<listitem
><para
>Püüab automaatselt ümber ehitada mooduleid, mis kasutavad kasvavat make'i (tõsi, see ei pruugi alati õnnestuda). </para
></listitem>

<listitem
><para
>Pakub omalt poolt välja mõistliku valiku vaikevõtmeid &kde; elementaarse ühekasutajapaigalduse tekitamiseks anonüümse &subversion;i hoidla lähtekoodi põhjal. </para
></listitem>

<listitem
><para
>Võimaldab tildega seadistusvõtmeid laiendada. Nii võib näiteks määrata: <programlisting
>qtdir ~/kdesvn/build/qt-copy</programlisting>
</para
></listitem>

<listitem
><para
>Loob automaatselt ehitamissüsteemi, kus lähtekoodikataloog ja ehitamiskataloog erinevad, et lähtekoodikataloog oleks kindlasti puutumatu. </para
></listitem>

<listitem
><para
>Võimaldab määrata globaalsed võtmed kõigile väljavõetavale moodulile, samuti võtmed igale moodulile eraldi. </para
></listitem>

<listitem
><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äivitades &kdesvn-build;i võtmega <option
>--refresh-build</option
>. </para
></listitem>

<listitem
><para
>Võimaldab määrata mitmesuguseid ehitamise ajal kasutatavaid keskkonnamuutujaid, sealhulgas <envar
>KDEDIR</envar
>, <envar
>QTDIR</envar
>, <envar
>DO_NOT_COMPILE</envar
> ja <envar
>CXXFLAGS</envar
>. </para
></listitem>

<listitem
><para
>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
>Võimaldab kasutada <link linkend="conf-make-install-prefix"
>make-install-prefix</link
>, et anda käsule <userinput
><command
>make</command
> <option
>install</option
></userinput
> prefiks omaette käsuna, mis on kasulik näiteks &sudo; pruukimisel. </para
></listitem>

<listitem
><para
>Välja võib võtta ainult osa &kde; &subversion;i moodulist. Näiteks võib välja võtta ainult <application
>taglib</application
> moodulist <application
>kdesupport</application
> või ainult <application
>K3B</application
> moodulist <application
>extragear/multimedia</application
>. Skript võtab automaatselt välja <application
>kde-common</application
>, kui seda on ehitamiseks vaja. </para
></listitem>

<listitem
><para
>Võimalik on <quote
>teeselda</quote
> millegi tegemist. Käsureal võtit <option
>--pretend</option
> või <option
>-p</option
> andes pakub skript väga põhjaliku käivitatavate käskude kirjelduse ilma neid tegelikult käivitatamata. </para
></listitem>

</itemizedlist>

</sect1>

<sect1 id="kdesvn-build-logging">
<title
>&kdesvn-build;i ehitamislogi</title>

<sect2 id="logging-overview">
<title
>Logimise ülevaade</title>

<para
>Logimine on &kdesvn-build;i omadus, millega kõigi käskude väljund, mida &kdesvn-build; käivitab, salvestatakse faili, kus seda saab hiljem vajaduse korral uurida. Nimelt on sageli vaja just programmide väljundit, eriti kui ehitamine nurjub, sest sellel võib olla väga palju ja väga erinevaid põhjusi.</para>

<sect3 id="log-directory-layout">
<title
>Logimiskataloogi struktuur</title>

<para
>Logid salvestatakse alati logimiskataloogi. Logimiskataloogi sihtkoha määrab võti <link linkend="conf-log-dir"
>log.dir</link
>, milleks vaikimisi on <filename class="directory"
><symbol
>${source-dir}</symbol
>/log</filename
> (kus <symbol
>${source-dir}</symbol
> on võtme <link linkend="conf-source-dir"
>source-dir</link
> väärtus. Allpool räägitaksegi sellest väärtusest kui <symbol
>${log-dir}</symbol
>).</para>

<para
><symbol
>${log-dir}</symbol
> all paikneb rida katalooge vastavalt ajale, mil &kdesvn-build; töötas. Kataloogide nimi kajastab kuupäeva ja käivitamise järjenumbrit. Näiteks 26. mail 2004. aasta teise &kdesvn-build;i käivitamise korral luuakse kataloog nimega <filename
>2004-05-26-02</filename
>, kus 2004-05-26 tähistab kuupäeva ja -02 on käivitamise järjenumber.</para>

<para
>Puhtalt mugavuse huvides loob &kdesvn-build; ka lingi viimase käivitamise logidele, mille nimeks on <filename
>latest</filename
>. Niisiis leiab &kdesvn-build;i viimase käivitamise logid alati asukohast <filename class="directory"
><symbol
>${log-dir}</symbol
>/latest</filename
>. </para>

<para
>Iga &kdesvn-build;i käivitamise kataloog sisaldab omakorda rida katalooge, üks iga &kde; mooduli kohta, mida &kdesvn-build; üritas ehitada. Samuti leidub kataloogis fail <filename
>build-status</filename
>, mis võimaldab määrata, milliste moodulite ehitamine õnnestus ja milliste mitte.</para>

<note
><para
>Kui moodulil endal on alammooduleid (näiteks extragear/multimedia, playground/utils või KDE/kdelibs), siis kajastub see ka logimiskataloogi struktuuris. Nii leiab näiteks KDE/kdelibs logi viimase &kdesvn-build;i käivitamise ajal asukohas <filename class="directory"
><symbol
>${log-dir}</symbol
>/latest/KDE/kdelibs</filename
>, mitte aga asukohas <filename class="directory"
><symbol
>${log-dir}</symbol
>/latest/kdelibs</filename
>. </para
></note>

<para
>Iga mooduli logimiskataloogis leiab rea faile kõigi toimingute kohta, mida &kdesvn-build; ette võtab. Kui &kdesvn-build; uuendab moodulit, näeb selliseid failinimesid, nagu <filename
>svn-co.log</filename
> (mooduli väljavõtmine) või <filename
>svn-up.log</filename
> (juba varem välja võetud mooduli uuendamine). Kui tööle pandi käsk <command
>configure</command
>, leiab kataloogist faili <filename
>configure.log</filename
>.</para>

<para
>Kui tekkis vigu, näeb nende selgitust mõnes samuti failides. Et saaksid kindlaks määrata, milline fail sisaldab viga. loob &kdesvn-build; lingi, mis osutab viga sisaldavale failile (näiteks faililt <filename
>build-1.log</filename
> failile <filename
>error.log</filename
>).</para>

<para
>Lühidalt öeldes tuleb selleks, et näha, miks viimane &kdesvn-build;i käivitamine ei suutnud moodulit ehitada, kõigepealt uurida faili <filename
><symbol
>${log-dir}</symbol
>/latest/<replaceable
>mooduli-nimi</replaceable
>/error.log</filename
>. </para>

<tip
><para
>Kui fail <filename
>error.log</filename
> on tühi (eriti pärast paigaldamist), siis vahest vigu ei esinenudki. Mõned &kde; ehitamissüsteemi tööriistad annavad mõnikord ekslikult veast teada ka siis, kui viga ei olnudki.</para>

<para
>Samuti võivad mõned käsud vältida &kdesvn-build;i väljundi ümbersuunamist ning teatavates oludes mitte sattuda logifaili (sagedamini siis, kui tehakse esimene &subversion;i väljavõte). Sellisel juhul ei väljastata viga mitte logifaili, vaid seda näitab hoopis &konsole; või terminal, kus pandi tööle &kdesvn-build;.</para>
</tip>

</sect3>
</sect2>
</sect1>

</chapter>

<chapter id="kdesvn-buildrc">
<title
>Faili .kdesvn-buildrc vorming</title>

<para
>Skripti kasutamiseks peab sul kodukataloogis olema fail <filename
>.kdesvn-buildrc</filename
>, mis kirjeldab mooduleid, mida soovid alla laadida ja ehitada. </para>

<para
>See algab globaalsete võtmetega umbes nii: </para>

<programlisting
>global
<replaceable
>võtme-nimi võtme-väärtus</replaceable>
<replaceable
>[...]</replaceable>
end global
</programlisting>

<para
>Sellele järgneb üks või enam moodulisektsiooni, mis näeb välja umbes nii: </para>

<programlisting
>module <replaceable
>mooduli-nimi</replaceable>
<replaceable
>võtme-nimi võtme-väärtus</replaceable>
<replaceable
>[...]</replaceable>
end module
</programlisting>

<para
><replaceable
>mooduli-nimi</replaceable
> peab olema &kde; &subversion;i hoidlas leiduva mooduli nimi (näiteks kdelibs või kdebase). 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>

<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-apply-qt-patches"
>apply-qt-patches</link
> võimaldab kasutada qt-copy parandusi.</para
></listitem>
<listitem
><para
><link linkend="conf-async"
>async</link
> võimaldab uuendada ja ehitada ühel ja samal ajal.</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
></listitem>
<listitem
><para
><link linkend="conf-build-dir"
>build-dir</link
> määrab ehitamiskataloogi.</para
></listitem>
<listitem
><para
><link linkend="conf-checkout-only"
>checkout-only</link
> teeb väljavõtte ainult osast moodulist.</para
></listitem>
<listitem
><para
><link linkend="conf-cmake-options"
>cmake-options</link
> määrab, milliste lippudega moodulit konfigureerida &cmake;'i kasutades.</para
></listitem>
<listitem
><para
><link linkend="conf-colorful-output"
>colorful-output</link
> muudab skripti väljundi värviliseks.</para
></listitem>
<listitem
><para
><link linkend="conf-configure-flags"
>configure-flags</link
> määrab, milliste lippudega moodulit konfigureerida.</para
></listitem>
<listitem
><para
><link linkend="conf-cxxflags"
>cxxflags</link
> määrab muutuja <envar
>CXXFLAGS</envar
>.</para
></listitem>
<listitem
><para
><link linkend="conf-dest-dir"
>dest-dir</link
> muudab mooduli kataloogi nime.</para
></listitem>
<listitem
><para
><link linkend="conf-disable-agent-check"
>disable-agent-check</link
> takistab &kdesvn-build;il kontrollimast ssh-agent'i olekut.</para
></listitem>
<listitem
><para
><link linkend="conf-do-not-compile"
>do-not-compile</link
> määrab ehitamisest väljajäetavad kataloogid.</para
></listitem>
<listitem
><para
><link linkend="conf-inst-apps"
>inst-apps</link
> määrab täpselt, millised kataloogid ehitada ja paigaldada.</para
></listitem>
<listitem
><para
><link linkend="conf-install-after-build"
>install-after-build</link
> väldib paigaldamist pärast ehitamist.</para
></listitem>
<listitem
><para
><link linkend="conf-kdedir"
>kdedir</link
> määrab kataloogi, kuhu &kde; paigaldada.</para
></listitem>
<listitem
><para
><link linkend="conf-kde-languages"
>kde-languages</link
> määrab kataloogi, kuhu alla laadida ja paigaldada tõlkepaketid.</para
></listitem>
<listitem
><para
><link linkend="conf-libpath"
>libpath</link
> määrab muutuja <envar
>LD_LIBRARY_PATH</envar
>.</para
></listitem>
<listitem
><para
><link linkend="conf-make-install-prefix"
>make-install-prefix</link
> paneb paigaldamise ajal (<userinput
><command
>make</command
> <option
>install</option
></userinput
>) tööle abiprogrammi (näiteks &sudo;).</para
></listitem>
<listitem
><para
><link linkend="conf-make-options"
>make-options</link
> edastab võtmed programmile &make;.</para
></listitem>
<listitem
><para
><link linkend="conf-manual-build"
>manual-build</link
> takistab mooduli automaatset ehitamist.</para
></listitem>
<listitem
><para
><link linkend="conf-manual-update"
>manual-update</link
> takistab mooduli juures igasugust automaatset tegevust.</para
></listitem>
<listitem
><para
><link linkend="conf-module-base-path"
>module-base-path</link
> muudab asukohta, kuhu moodul alla laadida (kasulik harude ja siltide puhul).</para
></listitem>
<listitem
><para
><link linkend="conf-niceness"
>niceness</link
> muudab protsessori prioriteeti.</para
></listitem>
<listitem
><para
><link linkend="conf-no-rebuild-on-fail"
>no-rebuild-on-fail</link
> takistab programmi &make; taaskäivitamist, kui see nurjub.</para
></listitem>
<listitem
><para
><link linkend="conf-qtdir"
>qtdir</link
> määrab &Qt; asukoha.</para
></listitem>
<listitem
><para
><link linkend="conf-set-env"
>set-env</link
> määrab keskkonnamuutuja.</para
></listitem>
<listitem
><para
><link linkend="conf-source-dir"
>source-dir</link
> muudab asukohta, kuhu laaditakse alla lähtekood.</para
></listitem>
<listitem
><para
><link linkend="conf-stop-on-failure"
>stop-on-failure</link
> sunnib &kdesvn-build;i peatuma kohe vea tekkimisel.</para
></listitem>
<listitem
><para
><link linkend="conf-svn-server"
>svn-server</link
> muudab serverit, kust lähtekood alla laaditakse.</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>

<table id="option-table">
<title
>Võtmete tabel</title>
<tgroup cols="3">

<thead>
<row>
<entry
>Võtme nimi</entry>
<entry
>Mooduli ja globaalse võtme suhe</entry>
<entry
>Märkused</entry>
</row>
</thead>

<tbody>

<row id="conf-apidox">
<entry
>apidox</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
><para
>Selle võtmega sai lubada KDE mooduli API dokumentatsiooni ehitamise. See eemaldati &kdesvn-build;i versioonist 1.6.3, sest KDE 4 seda enam ei toetanud. API dokumentatsioon on saadaval võrgus aadressil <ulink url="http://api.kde.org/"
> org</ulink
>. Lisaks saab ehitada ka KDE 4 API dokumentatsiooni, kasutades skripti, mille leiab moodulist kdesdk (kataloogis /scripts). Täpsemalt kõneleb sellest <ulink url="http://techbase.kde.org/Development/Tools/apidox"
>KDE TechBase</ulink
>. Vanematele moodulitele saab muidugi endiselt API dokumentatsiooni käsitsi ehitada.</para>
</entry>
</row>

<row id="conf-apply-qt-patches">
<entry
>apply-qt-patches</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>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-copyle lisatakse mitteametlikud paigad. Kuna need paigad ongi enamasti põhjuseks, miks kasutada qt-copyt, 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-async">
<entry
>async</entry>
<entry
>Ei ole tühistatav</entry>
<entry
><para
>Selle võtmega saab sisse lülitada asünkroonse režiimi, mille puhul lähtekoodi uuendamine ja ehitamine käib paralleelselt, mitte ei oodata kogu lähtekoodi allalaadimist, enne kui alustada ehitamist. Vaikimisi on asünkroonne režiim sisse lülitatud. Kui sa seda ei soovi, määra võtme väärtuseks <replaceable
>false</replaceable
>.</para>
<para
>Võti on kasutatav alates versioonist 1.6.</para
></entry>
</row>

<row id="conf-binpath">
<entry
>binpath</entry>
<entry
>Tühistab globaalse väärtuse</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"
>/bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin</filename
>. Keskkonnamuutuja peab koolonitega eraldatult sisaldama sinu arendustööriistade asukohti. Asukohad <filename class="directory"
>$<envar
>KDEDIR</envar
>/bin</filename
> ja <filename class="directory"
>$<envar
>QTDIR</envar
>/bin</filename
> 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 (<replaceable
>trunk</replaceable
>), kus üldiselt käib põhiline arendustegevus. Näiteks &kde; 3.4 haru väljavõtmiseks määra võtme väärtuseks <replaceable
>3.4</replaceable
>.</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>
<para
>Kui &kdesvn-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"
>override-url</link
>.</para>
</entry>
</row>

<row id="conf-build-dir">
<entry
>build-dir</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Selle võtmega saab muuta ehitamiseks kasutatava lähtekoodikataloogi asukohta. Seda saab määrata kolmel viisil: <itemizedlist
> <listitem
><para
>Suhteline &kde; &subversion;i lähtekoodikataloogi suhtes (vaata <link linkend="conf-source-dir"
>võtit source-dir</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 &subversion;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 &subversion;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>
</row>

<row id="conf-cmake-options">
<entry
>cmake-options</entry>
<entry
>Täiendab globaalset võtit (v.a. qt-copy korral)</entry>
<entry
><para
>Selle võtmega saab määrata, millised lipud edastada &cmake;'ile mooduli ehitamissüsteemi loomisel. Kasutamisel globaalse võtmena rakendatakse seda kõigile moodulitele, mida skriptiga ehitatakse. Mooduli võtmena lisatakse see globaalsete võtmete lõppu. See võimaldab määrata globaalses sektsioonis üldised &cmake;'i võtmed.</para>

<para
>See võti asendab võtme <link linkend="conf-configure-flags"
>configure-flags</link
> kõigi &kde; 4 moodulite puhul, sest nende ehitamisel on kasutusel &cmake;.</para>

<para
>Et need võtmed edastatakse otse &cmake;'ile, tuleb need anda nii, nagu olekski nad kirjutatud otse &cmake;'i, näiteks:</para>

<screen
>cmake-options -DCMAKE_BUILD_TYPE=RelWithDebInfo
</screen>

<para
>Selle segaduse tõttu püüab &kdesvn-build; igati tagada, et kui ülejäänud võtmed on korrektselt määratud, saaks selle üldse andmata jätta.</para
></entry>
</row>

<row id="conf-configure-flags">
<entry
>configure-flags</entry>
<entry
>Täiendab globaalset võtit (v.a. qt-copy korral)</entry>
<entry
><para
>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. </para>

<para
>See võti kehtib qt-copy ja kõigi &kde; 3 moodulite kohta. &kde; 4 moodulite puhul on kasutusel &cmake;, mida saab juhtida võtmega <link linkend="conf-cmake-options"
>cmake-options</link
>.</para>
</entry>
</row>

<row id="conf-colorful-output">
<entry
>colorful-output</entry>
<entry
>Ei ole tühistatav</entry>
<entry
>Määra väärtuseks <replaceable
>false</replaceable
>, kui soovid keelata &kdesvn-build;i värvilise väljundi. Vaikimisi on väärtuseks <replaceable
>true</replaceable
>. Pane tähele, et &kdesvn-build; saadab värvikoodid ainult terminali (näiteks xterm, &konsole; või tavaline &Linux; konsool). </entry>
</row>

<row id="conf-cxxflags">
<entry
>cxxflags</entry>
<entry
>Täiendab globaalset võtit</entry>
<entry
><para
>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
> või <link linkend="conf-cmake-options"
>cmake-options</link
> asemel, sest see määrab ka ehitamise ajal keskkonnamuutuja <envar
>CXXFLAGS</envar
>.</para>

<para
>Pane tähele, et &kde; 4 ja kõigi teiste moodulite korral, mille puhul on kasutusel &cmake;, tuleb mooduli konfigureerimisel võtme CMAKE_BUILD_TYPE väärtuseks määrata "none". Seda saab teha võtmega <link linkend="conf-cmake-options"
>cmake-options</link
>.</para>
</entry>
</row>

<row id="conf-dest-dir">
<entry
>dest-dir</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Selle võtmega saab muuta moodulile kettal antavat nime. Kui moodul on näiteks extragear/network, võib sellele käesoleva võtmega anda nimeks extragear-network. Pane tähele, et kuigi see muudab mooduli nime kettal, ei ole sugugi hea mõte kasutada nimes katalooge või kataloogide eraldajaid, sest see häiriks võtmete <link linkend="conf-build-dir"
>build-dir</link
> või <link linkend="conf-source-dir"
>source-dir</link
> kasutamist. </entry>
</row>

<row id="conf-disable-agent-check">
<entry
>disable-agent-check</entry>
<entry
>Ei ole tühistatav</entry>
<entry
>Kui kasutad &subversion;i lähtekoodi allalaadimiseks &ssh;-d (näiteks protokolli svn+ssh puhul), siis &kdesvn-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 <option
>disable-agent-check</option
> väärtuseks <replaceable
>true</replaceable
>. </entry>
</row>

<row id="conf-do-not-compile">
<entry
>do-not-compile</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
><para
>Selle võtmega saab määrata kindlad kataloogid, mida mooduli korral ei ehitata. Ehitamata jäävad kataloogid tuleb eraldada tühikuga.</para>

<para
>See võti on toetatud nii &kde; 3 kui ka &kde; 4 korral. KDE 4 toetus lisati alates &kdesvn-build;i versioonist 1.6.3.</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>

<para
>Kui näiteks soovid jätta kdemultimedia moodulis kompileerimata rakendused &juk; ja &kscd;, lisagi kdemultimedia seadistustele "do-not-compile juk kscd".</para>
</entry>
</row>

<row id="conf-email-address">
<entry
>email-address</entry>
<entry
>Ei ole tühistatav</entry>
<entry>
<para
>Selle võtmega saab määrata e-posti aadressi, mida &kdesvn-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>

<para
>Praegu vajab seda võtit ainult võti <link linkend="conf-email-on-compile-error"
>email-on-compile-error</link
>. </para>
</entry>
</row>

<row id="conf-email-on-compile-error">
<entry
>email-on-compile-error</entry>
<entry
>Ei ole tühistatav</entry>
<entry>
<para
>Selle võtmega võib määrata e-posti aadressi, kuhu saata kiri, kui mooduli ehitamine nurjub. &kdesvn-build; ootab, kuni kõigi moodulite ehitamine on lõppenud ja koondab siis kõik tulemused raportisse. Raport saadetakse ainult siis, kui mooduli ehitamine nurjus. </para>

<para
>Võtmega <link linkend="conf-email-address"
>email-address</link
> saab määrata aadressi, mida &kdesvn-build; saatmisel kasutab. Kontrolli seda, sest vaikimisi ei ole see arvatavasti sugugi selline, nagu vaja. </para>
</entry>
</row>

<row id="conf-inst-apps">
<entry
>inst-apps</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
><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>

<important
><para
>See võti ei toimi veel moodulite puhul, mis on ehitatud &cmake;'i ehitamissüsteemi abil.</para
></important>

<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 <link linkend="configure-data"
>konfiguratsioonifailis</link
> 0. Samuti võib tarvitada käsurealippu <link linkend="cmdline-no-install"
><option
>--no-install</option
></link
>. </entry>
</row>

<row id="conf-kdedir">
<entry
>kdedir</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>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-kde-languages">
<entry
>kde-languages</entry>
<entry
>Ei ole tühistatav</entry>
<entry
><para
>See võti võimaldab &kde; kõrval alla laadida ja paigaldada lokaliseerimispaketid. See on eriti mõttekas, kui sa ei ela näiteks Ameerika Ühendriikides ja soovid, et &kde; oleks tõlgitud ka sinu emakeelde.</para>

<para
>Võtme kasutamisel tuleb tühikutega eraldatult määrata paigaldatavad keeled. Iga keelega on seotud kindel keelekood, mille leiab näiteks veebilehelt <ulink url="http://i18n.kde.org/teams/"
>http://i18n.kde.org/teams/</ulink
>. </para>

<para
>Valida võib ka ainult ühe keele. Vaikimisi ei laadita alla ühtegi keelt, mis ühtlasi tähendab, et &kde; on Ameerika inglise keeles.</para>

<para
>Näiteks prantsuse keele paigaldamiseks peaks võti välja nägema umbes nii: <userinput
><option
>kde-languages</option
> <replaceable
>fr</replaceable
></userinput
>. Aga ka pärast seda tuleb Süsteemi seadistustes prantsuse keele kasutamine sisse lülitada.</para>
</entry>
</row>

<row id="conf-libpath">
<entry
>libpath</entry>
<entry
>Tühistab globaalse väärtuse</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"
>$<envar
>KDEDIR</envar
>/lib</filename
> ja <filename class="directory"
>$<envar
>QTDIR</envar
>/lib</filename
> 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 <userinput
><command
>make</command
> <option
>install</option
></userinput
> 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 <command
>make</command
> käsureavõtmeid. See on kasulik sellistele programmidele nagu <ulink url="http://distcc.samba.org/"
><application
>distcc</application
></ulink
> või süsteemides, kus on enam kui üks protsessorituum. </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 <replaceable
>true</replaceable
>, kui soovid, et ehitamisel ei ehitataks antud moodulit. &subversion;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 <replaceable
>true</replaceable
>, 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>
</row>

<row id="conf-module-base-path">
<entry
>module-base-path</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
><para
>Selle võtmega saab tühistada &kdesvn-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/"
>&kde; lähtekoodi hoidla veebis</ulink
>.</para>
<para
>Pane tähele, et &kdesvn-build; loob lõpliku asukohta järgmise malli põhjal: <varname
>$svn-server</varname
>/home/kde/<varname
>$module-base-path</varname
>/<varname
>$module-name</varname
>. </para>
<para
>Vaikeväärtus on sõltuvalt moodulinimest <quote
>trunk</quote
> või <quote
>trunk/KDE</quote
>.</para>
<tip
><para
>Võimaluse korral kasuta selle asemel võtmeid <link linkend="conf-branch"
>branch</link
> või <link linkend="conf-tag"
>tag</link
>. </para
></tip>
</entry>
</row>

<row id="conf-niceness">
<entry
>niceness</entry>
<entry
>Ei ole tühistatav</entry>
<entry
>Selle võtme väärtus on arv vahemikus 20 kuni 0. Mida suurem arv, seda väiksem on prioriteet, mida &kdesvn-build; endale omistab. Vaikeväärtus on 10. </entry>
</row>

<row id="conf-no-svn">
<entry
>no-svn</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Kui võtme väärtuseks on määratud 'true', ei uuenda &kdesvn-build; automaatselt mooduli lähtekoodi. Siiski püütakse moodul ehitada, kui see on muidu ette nähtud.</entry>
</row>

<row id="conf-no-rebuild-on-fail">
<entry
>no-rebuild-on-fail</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Määra selle võtme väärtuseks <replaceable
>true</replaceable
>, kui soovid vältida, et &kdesvn-build; hakkaks moodulit ümberehitama, kui inkrementehitamine ei õnnestu. Tavaliselt püüab &kdesvn-build; mooduli algusest peale ümber ehitada, et takistada &subversion;i uuendamise halba mõju ehitamissüsteemile.</entry>
</row>

<row id="conf-override-url">
<entry
>override-url</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Selle võtme kasutamisel tarvitab &kdesvn-build; selle väärtust &url;-ina, mis edastatakse &subversion;ile <emphasis
>täiesti muutmatult</emphasis
>. Üldiselt tuleks seda kasutada siis, kui soovid alla laadida konkreetset väljalaset, kuid &kdesvn-build; ei suuda sinu soovidest võtme <link linkend="conf-branch"
>branch</link
> põhjal aru saada. </entry>
</row>

<row id="conf-qtdir">
<entry
>qtdir</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Selle võtmega saab määrata ehitamisel kasutatava keskkonnamuutuja <envar
>QTDIR</envar
>. Seda ei saa moodulivõtmega tühistada. Kui see pole määratud, kasutatakse vaikimisi asukohta <filename class="directory"
><symbol
>$(source-dir)</symbol
>/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
></listitem>
</itemizedlist>
</para>

<para
>Pane tähele, et selle võtme kasutamine mõjutab päris negatiivselt nii sinu tekitatavat võrgukoormust (kui kasutad väärtust <replaceable
>all</replaceable
>) kui ka &kde; kompileerimiseks kuluvat aega, sest &kdesvn-build; ei saa sel juhul kasutada inkrementehitamist.</para>
</entry>
</row>

<row id="conf-revision">
<entry
>revision</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Kui võtmele on antud muu väärtus kui 0 (null), sunnib &kdesvn-build; &subversion;i uuendama, et saada mooduli täpselt nõutud versioon, isegi kui toimib mõni selline võti nagu <link linkend="conf-branch"
>branch</link
>. Kui mooduli versioon on juba nõutav, seda enam ei uuendata, kui just võtit ei muudeta või ei eemaldata seadistusest.</entry>
</row>

<row id="conf-set-env">
<entry
>set-env</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
><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 <envar
>RONALD</envar
> 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 <link linkend="configure-data"
>konfiguratsioonifaili</link
> 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
>Tühistab globaalse väärtuse</entry>
<entry
>Selle võtmega saab määrata kataloogi oma arvutis, kuhu salvestatakse &kde; &subversion;i lähtekood. Kui see pole määratud, kasutatakse vaikeväärtusena <filename class="directory"
>~/kdesvn</filename
>. Väärtuse määramisel tuleks kasutada absoluutset asukohta. </entry>
</row>

<row id="conf-stop-on-failure">
<entry
>stop-on-failure</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Määra selle võtme väärtuseks <replaceable
>true</replaceable
>, kui soovid, et skript peataks töö pärast vea tekkimist ehitamisel või paigaldamisel. Vaikimisi on see välja lülitatud. </entry>
</row>

<row id="conf-svn-server">
<entry
>svn-server</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Selle võtmega saab määrata serveri, kust &subversion; välja võetakse. Vaikimisi on see anonüümne &subversion;i hoidla <filename
>svn://anonsvn.kde.org/</filename
>.</entry>
</row>

<row id="conf-tag">
<entry
>tag</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
><para
>Selle võtmega saab alla laadida mooduli konkreetse väljalaske.</para>
<para
><emphasis
>Märkus:</emphasis
> on üsna usutav, et <emphasis
>sa ei soovi</emphasis
> seda võtit kasutada. &kde; väljalasked asuvad tar-failidena <ulink url="ftp://ftp.kde.org/"
>&kde; FTP-saidil</ulink
> ning selle <ulink url="http://download.kde.org/download.php"
>peegelsaitidel</ulink
>.</para>
<para
>Kui kasutad &kdesvn-build;i sellepärast, et sul on probleeme sinu distributsioonile mõeldud &kde; väljalasetega, võiks kaaluda mõte pruukida <ulink url="http://techbase.kde.org/Getting_Started/Build/Konstruct"
>ehitamistööriista Konstruct</ulink
>, mis kasutab väljalasete tar-faile.</para>
</entry>
</row>

<row id="conf-use-cmake">
<entry
>use-cmake</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>See võti eemaldati &kdesvn-build;i versioonis 1.4, sest kõigi &kde; 4 moodulite puhul on vajalik &cmake; ning &cmake;'i kasutamine ei ole lubatud ühegi teise mooduli puhul. </entry>
</row>

<row id="conf-use-qt-builddir-hack">
<entry
>use-qt-builddir-hack</entry>
<entry
>Tühistab globaalse väärtuse</entry>
<entry
>Kuigi see võti tühistab globaalse võtme, on sel mõtet ainult qt-copy korral. Määra võtme väärtuseks <replaceable
>true</replaceable
>, kui soovid lubada skriptil tarvitada srcdir != builddir režiimi. Sisselülitamise korral kopeerib &kdesvn-build; qt-copy lähtemooduli ehitamiskataloogi ja sooritab ehitamise seal. See tähendab, et keskkonnamuutuja <envar
>QTDIR</envar
> väärtuseks tuleb määrata <filename class="directory"
>$<symbol
>{qt-copy-build-dir}</symbol
>/qt-copy/lib</filename
>. 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 <replaceable
>true</replaceable
>. </entry>
</row>

<row id="conf-use-stable-kde">
<entry
>use-stable-kde</entry>
<entry
>Ei ole tühistatav</entry>
<entry
><para
>Et &kdesvn-build; toetab &kde; 3 ja 4 ehitamist, tuleb mingil moel teada anda, millist versiooni ehitada. Vaikimisi ehitab &kdesvn-build; &kde; arenduse põhiliini (kannab nimetust /trunk). Kuid see on mõeldud &kde; 4 jaoks, mis ei ole veel laiemaks kasutamiseks valmis. </para>

<para
>Võtit &branch; saab kasutada globaalselt või mooduli korral &kde; 3.5 (või 3.4 jne.) allalaadimiseks. See ei ole aga väga mugav, sest mõningaid mooduleid (näiteks kdesupport) kasutavad nii 3.5 kui ka 4. Lisaks tuleb konfiguratsioonifailile lisada terve hulk haru võtmeid.</para>

<para
>Niisiis, kui määrad sellele globaalsele võtmele väärtuseks <replaceable
>true</replaceable
>, laadib &kdesvn-build; automaatselt alla näiteks mooduli kdelibs ja qt-copy &kde; 3.5, mitte aga &kde; 4 versiooni. Konkreetse mooduli puhul võib samas endiselt pruukida võtmeid &branch; või &tag;, mis tühistavad &kdesvn-build;i võtmed. Sel moel saab hõlpsasti valida &kde; 4 asemel &kde; 3.5 allaalaadimise..</para>
</entry>
</row>

</tbody>

</tgroup>
</table>

</chapter>

<chapter id="cmdline">
<title
>Käsureavõtmed ja keskkonnamuutujad</title>

<para
>Skript ei kasuta keskkonnamuutujaid. Kui sul on vaja ehitamiseks või paigaldamiseks määrata keskkonnamuutujaid, uuri võtme <link linkend="conf-set-env"
>set-env</link
> kirjeldust. </para>

<para
>Skript tunnistab järgmisi käsureavõtmeid: </para>

<variablelist>

<varlistentry id="cmdline-async">
<term
><option
>--async</option
></term>
<listitem
><para
>Lülitab sisse <link linkend="conf-async"
>asünkroonse režiim</link
>, mis lubab uuendada ja ehitada ühel ja samal ajal. Vaikimisi on see sisse lülitatud, see vajab määramist ainult siis, kui keelad selle seadistuses. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-help">
<term
><option
>--help</option
></term>
<listitem
><para
>Näitab lihtsat abiinfot skripti kohta. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-version">
<term
><option
>--version</option
></term>
<listitem
><para
>Näitab programmi versiooni. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-author">
<term
><option
>--author</option
></term>
<listitem
><para
>Näitab autori kontaktinfot. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-color">
<term
><option
>--color</option
></term>
<listitem
><para
>Lubab värvilise väljundi. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-nice">
<term
><option
>--nice=<replaceable
>väärtus</replaceable
></option
></term>
<listitem
><para
>Määrab töö ajaks viisakuse <replaceable
>väärtus</replaceable
>e. <replaceable
>Väärtus</replaceable
> peab olema 0 ja 20 vahel. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-no-async">
<term
><option
>--no-async</option
></term>
<listitem
><para
>Keelab uuendamisel <link linkend="conf-async"
>asünkroonse režiimi</link
>. Uuendamine võetakse sel juhul enne ehitamist ette täielikult. See aeglustab protsessi tervikuma, aga kui sul esineb &kdesvn-build;i kasutamisel IPC vigu, võiks seda võtit tarvitada ning ühtlasi esitada ka <ulink url="http://bugs.kde.org/"
>veateate</ulink
>. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-no-color">
<term
><option
>--no-color</option
></term>
<listitem
><para
>Keelab värvilise väljundi. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-pretend">
<term
><option
>--pretend</option
> (või <option
>-p</option
>)</term>
<listitem
><para
>Tegelikult <emphasis
>ei võeta</emphasis
> 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 ja mida &kdesvn-build; teeb. </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 &subversion;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
></listitem>
</varlistentry>

<varlistentry id="cmdline-no-rebuild-on-fail">
<term
><option
>--no-rebuild-on-fail</option
></term>
<listitem
><para
>Ei üritata algusest peale ümber ehitada mooduleid, mille ehitamine nurjus. &kdesvn-build; ei ürita seda kunagi mooduli korral, mida on juba püütud algusest peale ehitada. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-refresh-build">
<term
><option
>--refresh-build</option
></term>
<listitem
><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-from">
<term
><option
>--resume-from</option
></term>
<listitem
><para
>Selle võtmega taasalustatakse ehitamist alates määratud moodulist, mis ongi käsureal järgmine võti. 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-rc-file">
<term
><option
>--rc-file</option
></term>
<listitem
><para
>Järgmist käsureal antud parameetrit tõlgendatakse failina, millest lugeda konfiguratsioonivõtmed. Vaikeväärtus on ~/.kdesvn-buildrc. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-run">
<term
><option
>--run</option
></term>
<listitem
><para
>See võti tõlgendab järgmiste käsurea elementi programmina, mis tuleb käivitada, ning &kdesvn-build; lõpetab seejärel konfiguratsioonifaili lugemise, uuendab tavapäraselt keskkonda ja käivitab määratud programmi.</para>

<para
>Siiski ei sobi see enamasti shelli käivitamiseks &kdesvn-build;i keskkonnas, sest interaktiivsed shellid lähtestavad käivitusjadas tavaliselt vähemalt osa keskkonnamuutujaid (näiteks <envar
>PATH</envar
> ja <envar
>KDEDIRS</envar
>). </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-prefix">
<term
><option
>--prefix=&lt;/kde/asukoht&gt;</option
></term>
<listitem
><para
>Võimaldab muuta kataloogi, kuhu &kde; paigaldatakse. See eeldab võtit <link linkend="cmdline-reconfigure"
><option
>--reconfigure</option
></link
>. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-build-system-only">
<term
><option
>--build-system-only</option
></term>
<listitem
><para
>Peatab skripti töö pärast käsu <command
>make <option
>-f</option
> Makefile.cvs</command
> täitmist. Konfiguratsiooniskripti paneb &kdesvn-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
>./configure <option
>--help</option
></command
> ja muuta vastavalt konfigureerimislippe. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-install"
><term
><option
>--install</option
></term>
<listitem
><para
>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
>--&lt;võtme-nimi&gt;=</option
></term>
<listitem
><para
>Selle võtmega saab kõigi moodulite jaoks tühistada <link linkend="configure-data"
>konfiguratsioonifailis</link
> leiduva võtme. Kui näiteks soovid tühistada võtit <link linkend="conf-log-dir"
>log-dir</link
>, siis see käib nii: <userinput
><option
>--log-dir=<filename class="directory"
><replaceable
>/kataloogi/asukoht</replaceable
></filename
></option
></userinput
>. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-module-option">
<term
><option
>--&lt;mooduli-nimi&gt;,&lt;võtme-nimi&gt;=</option
></term>
<listitem
><para
>Selle võtmega saab konkreetse mooduli jaoks tühistada <link linkend="configure-data"
>konfiguratsioonifailis</link
> leiduva võtme. </para
></listitem>
</varlistentry>

</variablelist>

<para
>Kõiki muid käsureavõtmeid tõlgendatakse uuendatavate ja ehitatavate moodulitena. Palun ära aja ehitamist segamini paigaldamisega. </para>

</chapter>

<chapter id="using-kdesvn-build">
<title
>&kdesvn-build;i kasutamine</title>

<sect1 id="using-kdesvn-build-preface">
<title
>Eessõna</title>

<para
>Tavaliselt on &kdesvn-build;i kasutamine pärast seda, kui läbi on töötatud <xref linkend="getting-started"/>, äärmiselt lihtne, piirdudes lihtsalt terminalis antava käsuga:</para>

<screen
><prompt
>&percnt;</prompt
> <command
><userinput
>kdesvn-build</userinput
></command
>
</screen>

<para
>&kdesvn-build; laadib seejärel alla &kde; lähtekoodi, püüab seda konfigureerida ja ehitada ning ka paigaldada.</para>

<para
>Loe edasi, kuidas &kdesvn-build; seda teeb, ja mida kõike selle tööriistaga veel annab ette võtta.</para>

</sect1>

<sect1 id="basic-features">
<title
>&kdesvn-build;i põhiomadused</title>

<sect2 id="using-qt-copy">
<title
>qt-copy toetus</title>
<para
>&kdesvn-build; püüab igakülgselt toetada &kde; &subversion;i hoidlas leiduvat qt-copy moodulit.</para>

<note
><para
>qt-copy kujutab endast &Qt; tööriistakomplekti, mida kasutab ka &kde;, uusimat lähtekoodi. Samuti sisaldab see optimeerimiseks ja vigade parandamiseks mõeldud paiku, mida võib, aga ei pruugi rakendada. Paigad ühilduvad igati &Qt; teegiga, nii et qt-copy abil loodud kood käivitub kenasti ka tavalise &Qt; puhul. </para
></note>

<para
>Enamiku qt-copy erinevustega tegeleb &kdesvn-build; automaatselt. Siiski on teatud detaile, mida võib olla kasulik teada.</para>

<itemizedlist>
<listitem
><para
>Tavaliselt lisatakse mooduli võtme &configure-flags; väärtus võtme &configure-flags; globaalsesse seadistusse. Kuid qt-copy korral  asendab võtme &configure-flags; seadistust globaalset seadistust, sest nende käsud ei ole päris samasugused. </para
></listitem>

<listitem
><para
>&kdesvn-build; defineerib automaatselt teatavad täiendavad keskkonnamuutujad qt-copy ehitamiseks, mida muidu ülejäänud &kde; ei vaja. </para
></listitem>

<listitem
><para
>qt-copy toetab ka paikade kasutamist, mis sisaldavad teatavaid veaparandusi ja optimeerimisi, mis ei ole aga veel jõudnud ametliku &Qt; sisse. Nende lubamiseks tuleb määrata võtme &apply-qt-patches; väärtuseks <userinput
>true</userinput
>. Seejärel tasuks anda käsk <userinput
><command
>kdesvn-build</command
> <option
>--refresh-build</option
> <option
>qt-copy</option
></userinput
>. </para
></listitem>

</itemizedlist>

</sect2>

<sect2 id="kdesvn-build-std-flags">
<title
>&kdesvn-build;i lisatavad standardsed lipud</title>
<para
>Sinu aja säästmiseks lisab &kdesvn-build; sinu keskkonnale mõned standardsed asukohad: </para>

<itemizedlist>
<listitem
><para
>&kde; ja &Qt; teekide asukoht lisatakse automaatselt muutujale <envar
>LD_LIBRARY_PATH</envar
>. See tähendab, et nende kaasamiseks ei ole vaja enam muuta &libpath;'i. </para
></listitem>

<listitem
><para
>&kde; ja &Qt; arendusprogrammide asukoht lisatakse automaatselt muutujale <envar
>PATH</envar
>. See tähendab, et nende kaasamiseks ei ole vaja enam muuta &binpath;'i. </para
></listitem>

<listitem
><para
>&kde; pakutava <application
>pkg-config</application
> asukoht lisatakse automaatselt muutujale <envar
>PKG_CONFIG_PATH</envar
>. See tähendab, et nende lisamiseks ei ole enam vajalik kasutada võtit &set-env;. </para
></listitem>

<listitem
><para
>&kdedir; määratlus edastatakse ehitamise ajal automaatselt keskkonnamuutujale <envar
>KDEDIR</envar
> (see ei puuduta muutujat <envar
>KDEDIRS</envar
>). </para
></listitem>

<listitem
><para
>&qtdir; määratlus edastatakse ehitamise ajal automaatselt keskkonnamuutujale <envar
>QTDIR</envar
>. </para
></listitem>

</itemizedlist>

</sect2>

<sect2 id="build-priority">
<title
>&kdesvn-build;i ehitamisprioriteedi muutmine</title>
<para
>Tänapäeva operatsioonisüsteemides (sealhulgas &Linux; ja &BSD;) võivad programmid töötada erineva prioriteediga. See võimaldab süsteemil eraldada eri programmidele aega vastavalt nende tähtsusele. </para>

<para
>&kdesvn-build; prioriteet on üldiselt väike, nii et sinu süsteemi teised programmid saavad rahumeeli edasi töötada. Sel moel saab &kdesvn-build; kasutada protsessori lisavõimsust siis, kui seda jagub. </para>

<para
>&kdesvn-build;i prioriteet on siiski piisavalt kõrge, et talle pööratakse tähelepanu enne rutiinseid taustaprotsesse ja selliseid samuti protsessori jääkidest elatuvaid programme nagu <ulink url="http://setiathome.ssl.berkeley.edu/"
>Seti@Home</ulink
>. </para>

<para
>&kdesvn-build;i muutmiseks, et ta kasutaks püsivalt suuremat või väiksemat prioriteeti, tuleb muuta <link linkend="configure-data"
>konfiguratsioonifailis</link
> leiduvat viisakust (&niceness;). See määrab, kui <quote
>viisakas</quote
> on &kdesvn-build; teiste programmide suhtes. Teisisõnu, mida suurem viisakus, seda väiksem on &kdesvn-build;i prioriteet. Seepärast tuleb &kdesvn-build;i prioriteedi suurendamiseks viisakust vähendada (ning vastupidi). Viisakus võib olla vahemikus 0 (täiesti ebaviisakas, suurim prioriteet) kuni 20 (üliviisakas, väikseim prioriteet).</para>

<para
>&kdesvn-build;i prioriteeti võib ajutiselt muuta <link linkend="cmdline"
>käsureavõtmega</link
> &cmd-nice;. Võtmele antav väärtus määrabki viisakuse.</para>

<note
><para
>Mõningatel programmidel, mis on käivitatud administraatori õigustes, võib olla isegi negatiivne viisakuse väärtus, mis annab neile väga suure prioriteedi. Negatiivse või isegi nullväärtuse määramine &kdesvn-build;ile pole siiski kuigi hea mõte, sest see ei aita kuigi palju vähendada käitusaega, küll aga muudab muu tegevuse arvutis õige venivaks. </para
></note>

<informalexample>
<para
>&kdesvn-build;i käivitamine viisakusega 15 (tavalisest väiksem prioriteet):</para>

<screen
><prompt
>&percnt;</prompt
> <userinput
><command
>kdesvn-build</command
> <option
>--nice=<replaceable
>15</replaceable
></option
></userinput
>
</screen>

<para
>Soovi korral võib muuta <link linkend="configure-data"
>seadistustefaili</link
>, et muuta see püsivaks:</para>

<screen
>&niceness; <replaceable
>15</replaceable
>
</screen>

</informalexample>
</sect2>

<sect2 id="root-installation">
<title
>Paigaldamine administraatorina</title>
<para
>&kdesvn-build;i saab enesestmõistetavalt käivitada ka administraatori õigustes, näiteks kui soovid teha süsteemse paigalduse (mis ei ole siiski soovitatav). Aga sellest võib olla kasu ka &kde; ehitamisel ühele kasutajale: nimelt paigaldavad mõned moodulid, eriti kdebase, programme, mis vajavad töötamisel lühiajaliselt suuremaid õigusi. See ei ole aga võimalik, kui nad ei ole juba paigaldatud suuremate õigustega. </para>

<para
>&kdesvn-build;i võib kohe algusest peale käivitada administraatori õigustes, aga see pole siiski soovitatav, sest programmi ei ole seni selles osas põhjalikult üle vaadatud ja nii võib see kujutada turvariski. Seepärast oleks mõttekam programmi otseselt administraatori õigustes mitte käivitada.</para>

<para
>Sellest aitab üle saada &kdesvn-build;i võti &make-install-prefix;. Sellega saab määrata käsu, mida kasutatakse paigaldamisel teise kasutaja õigustes. Kõige soovitavam on kasutada seda käsku koostöös programmiga &sudo;, mis käivitab paigaldamiskäsu administraatori õigustes. </para>

<informalexample>
<para
>Näiteks kõigi moodulite paigaldamiseks &sudo; abil võib talitada nii:</para>

<screen
>global
  &make-install-prefix; <replaceable
>sudo</replaceable>
  # Teised võtmed
end global
</screen>

<para
>&make-install-prefix; kasutamiseks ainult ühe mooduli puhul peaks talitama nii: </para>

<screen
>module <replaceable
>kdemultimedia</replaceable>
  &make-install-prefix; <replaceable
>sudo</replaceable>
end module
</screen>
</informalexample>

</sect2>

<sect2 id="build-progress">
<title
>Mooduli ehitamise edenemise näitamine</title>
<para
>See võimalus on alati olemas ning lülitatakse automaatselt sisse, kui vähegi võimalik. See näitab mooduli ehitamise ajal selle hinnangulist edenemist, andes teada, kui kaua tõenäoliselt veel kulub ehitamise lõpuni. </para>

</sect2>

</sect1>

<sect1 id="advanced-features">
<title
>Muud omadused</title>

<sect2 id="partial-builds">
<title
>Mooduli osaline ehitamine</title>
<para
>Võimalik on ehitada ka ainult osa mõnest &kde; moodulist, kui näiteks soovid kasutada ainult üht moodulisse kuuluvat programmi. &kdesvn-build;i abil on see õige lihtne. Selleks on isegi mitu võimalust. </para>

<sect3 id="checking-out-parts">
<title
>Mooduli üksikute osade väljavõte</title>

<para
>See on vahest parim viis. Kui see toimib, säästab see nii allalaadimise aega kui ka kettaruumi. Sel juhul laadib &kdesvn-build; alla ainult osa määratud moodulist. Seda tehakse võtit &checkout-only; kasutades, mis määrab kindlaks allalaaditavad kataloogid. </para>

<tip
><para
>Kui sa veel ei tea, mida moodul õieti sisaldab, tasuks esmalt uurida selle &subversion;i struktuuri näiteks <ulink url="http://websvn.kde.org/branches/KDE/3.5/"
>WebSVN-i</ulink
> vahendusel. </para
></tip>

<informalexample>
<para
>Ainult programmide &kuser; ja &kdat; hankimiseks moodulist kdeadmin tuleb võtit &checkout-only; kasutada nii:</para>

<screen
>module <replaceable
>kdeadmin</replaceable>
  &checkout-only; <replaceable
>kuser kdat</replaceable>
end module
</screen>

</informalexample>

<important
><para
>Kataloogid ehitatakse selles järjekorras, nagu nad on parameetritena loetletud. Kui mõni kataloog vajab kompileerimiseks moodulist veel midagi, tuleb kontrollida, et mõlemad oleks määratud &checkout-only; real ja et sõltuvus paikneks enne kataloogi, mis seda vajab.</para>

<para
>Mõnikord võib rakendus vajada ka teisi katalooge, mille selgitamine ei pruugi olla nii lihtne. Seepärast vajab selline võimalus sageli lihtsalt proovimist katse-eksituse meetodil ning vajalike kataloogide lisamist võtmele.</para>
</important>

<para
>Veel üks märkus antud võtme kohta. Selle väärtust muutes tuleks anda ka käsk <userinput
><command
>kdesvn-build</command
> <option
>&cmd-refresh-build;</option
> <option
><replaceable
>moodul</replaceable
></option
></userinput
>, mis tagab mooduli korrektse ümberseadistamise. Lisaks ei eemalda &kdesvn-build; kunagi olemasolevaid faile, kui eemaldad näiteks katalooge võtme &checkout-only; alt või lisad võtme moodulile, mille väljavõtte oled juba varem teinud.</para>

</sect3>

<sect3 id="not-compiling">
<title
>Kataloogide eemaldamine ehitamisest</title>
<para
>Allalaadimise piiramise asemel võib ka kõik alla laadida, kuid lasta ehitamissüsteemil jätta ehitamise ajal teatavad kataloogid välja. See võib olla kasulik näiteks juhul, kui mõne kataloogiga tekib pidevalt vigu ning see ei ole ülejäänud mooduli jaoks iseenesest vajalik. </para>

<para
>Seda saab määrata võtmega &do-not-compile;. See toimib sarnaselt äsja kirjeldatud võtmega &checkout-only; selles mõttes, et kujutab endast lihtsalt loendit kataloogidega, mis tuleb kompileerimisel arvestamata jätta.</para>

<important
><para
>Nagu &checkout-only;, nõuab ka see võti, et skript <command
>configure</command
> käivitataks pärast võtme muutmist uuesti. Seda saab teha käsuga <userinput
><command
>kdesvn-build</command
> <option
>&cmd-reconfigure;</option
> <option
><replaceable
>moodul</replaceable
></option
></userinput
>. </para
></important>

<informalexample>
<para
>Kataloogi <filename
>dcoppython</filename
> eemaldamine mooduli kdebindings ehitamisest:</para>

<screen
>module <replaceable
>kdebindings</replaceable>
  &do-not-compile; <replaceable
>dcoppython</replaceable>
end module
</screen>
</informalexample>

</sect3>

<sect3 id="limiting-using-inst-apps">
<title
>Täielikust moodulist vaid mõne kataloogi kompileerimine</title>

<para
>Võtmega &inst-apps; saab määrata, et täielikust moodulist ehitatakse ainult teatavad kataloogid (samas laaditakse siiski alla kogu moodul). </para>

<para
>See võti on otsekui võtmete &checkout-only; ja &do-not-compile; kombinatsioon: alla laaditakse kogu moodul, nagu teeb ka &do-not-compile;, kuid kompileeritakse ainult määratud kataloogid, nagu teeb &checkout-only;. Seepärast on enamasti lihtsam kasutada võtit &checkout-only;. </para>

<para
>Kehtivad samad märkused, nagu kahe eelneva võtme korral: kui oled muutnud võtme &inst-apps; väärtust, tuleb moodul uuesti konfigureerida. </para>
</sect3>

</sect2>

<sect2 id="using-branches">
<title
>Harude ja siltide toetus &kdesvn-build;is</title>

<sect3 id="branches-and-tags">
<title
>Mis on harud ja sildid?</title>

<para
>&subversion; toetab &kde; lähtekoodi ajalo haldamist. &kde; kasutab seda ära harude loomiseks arendamise käigus ning hoidla sildistamiseks teatava ajavahemiku järel uute väljalasete tarbeks. </para>

<para
>Näiteks võivad mõned &kmail;i arendajad töötada omaette harus mõne uue võimaluse kallal, et vältida võimalikke probleeme versioonis, mida kasutab enamik arendajaid. Selles harus käib arendus omaette, sõltumata sellest, kuidas kulgeb arendustegevus põhiharus (/trunk). </para>

<para
>Silt on aga nii-öelda hetkvõte lähtekoodihoidlast teataval ajahetkel. Seda kasutab &kde; haldusmeeskond väljalaskeks sobiva versiooni tähistamiseks, mis samal ajal võimaldab arendajatel jätkata tööd koodi kallal. </para>

<para
>&subversion; õieti ei erista koodi mõttes harusid, silte ega tüve (trunk). Need on mõeldud ainult arendajate elu lihtsustamiseks. Sel põhjusel on ka harude ja siltide toetus &kdesvn-build;is mõnevõrra raskendatud, aga siiski võimalik. </para>

</sect3>

<sect3 id="branch-support">
<title
>Harude ja siltide kasutamine</title>

<para
>Harude ja siltide toetust tagab rida võtmeid, mis ulatuvad konkreetse versiooni väljavõttest kuni kindlate &url;-ideni, kust kogenenumad kasutajad saavad vajalikke asju alla laadida. </para>

<para
>Kõige lihtsam ongi tarvitada võtmeid &branch; ja &tag;. Piisab, kui lisada neile võtmetele soovitud haru või sildi nimi, ning &kdesvn-build; püüab ise &kde; hoidlas üles leida koha, kust nõutu alla laadida. Enamiku &kde; moodulite puhul sellest täiesti piisab.</para>

<informalexample>
<para
>&kde; 3.5 (ehk 3.5 haru) mooduli kdelibs allalaadimine: </para>

<screen
>module kdelibs
  branch <replaceable
>3.5</replaceable>
  # teised võtmed...
end module
</screen>

<para
>&kde; 3.4.3 väljalaske mooduli kdemultimedia allalaadimine:</para>

<screen
>module kdemultimedia
  tag <replaceable
>3.4.3</replaceable>
  # teised võtmed...
end module
</screen>

</informalexample>

<tip
><para
>Võib kindlaks määrata ka haru globaalse väärtuse. Kuid sel juhul ei tohi unustada määramast konkreetset haru, kui soovid moodulit, mida ei leidu globaalses harus, või selle uuemat või vanemat versiooni! </para
></tip>
</sect3>

<sect3 id="advanced-branches">
<title
>Muud harudega seotud võtmed</title>

<para
>&kdesvn-build; toetab veel kaht võtit juhtudeks, kus &branch; ja &tag; ei suuda õiget asukohta tuvastada: &module-base-path; ja &override-url;. </para>

<itemizedlist>
<listitem
><para
>&module-base-path; aitab &kdesvn-build; tuvastada mooduli asukoha puuduvad lülid. &kde; hoidlas on kõik asukohad kujul <filename class="directory"
>svnRoot/module-base-path/<replaceable
>moodulinimi</replaceable
></filename
>. Tavaliselt suudab &kdesvn-build; keskmise osa ise välja selgitada. Kui see aga miskipärast ei õnnestu, võib kasutada võtit &module-base-path;: </para>

<informalexample>
<screen
>module qt-copy
  # branch siin veel ei toimi
  module-base-path branches/qt/3.3
end module
</screen>

<para
>See sunnib &kdesvn-build;i qt-copy alla laadima asukohast <filename
>svn://anonsvn.kde.org/home/kde/<replaceable
>branches/qt/3.3</replaceable
>/qt-copy</filename
>. </para>
</informalexample>
</listitem>

<listitem
><para
>Võti &override-url; aga nõuab, et määraksid täpse asukoha, kust alla laadida. Samas võimaldab see alla laadida kohtadest, kust &kdesvn-build; seda ise kindlasti ei teeks. </para>

<informalexample>
<screen
>module qt-copy
  # Täpse allalaadimise asukoha määramine.
  override-url svn://anonsvn.kde.org/home/kde/branches/qt/3.3/qt-copy
end module
</screen>
</informalexample>

<important
><para
>&kdesvn-build; ei muuda mingil moel väärtust, mille annad võtmele &override-url;, nii et kui muudad võtme &svn-server; määratlust, tuleb ka seda uuendada. </para
></important>

</listitem>
</itemizedlist>

</sect3>

</sect2>

<sect2 id="building-successfully">
<title
>&kdesvn-build; ja edukas ehitamine</title>

<sect3 id="automatic-rebuilds">
<title
>Automaatne taasehitamine</title>

<para
>&kde; ehitamissüsteemi mitmesuguste probleemide tõttu võtab &kdesvn-build; automaatselt ette mitmeid samme, püüdes panna mooduli automaatselt kompileerima ka siis, kui see ei kipu algul õnnestuma.</para>

<orderedlist>
<listitem
><para
>Esimese nurjumise järel käivitab &kdesvn-build; lihtsalt uuesti käsu <command
>make</command
>. Päris uskumatult see sageli aitabki ning kui ei, selgub uus nurjumine väga kiiresti. </para
></listitem>

<listitem
><para
>Teise nurjumise järel püüab &kdesvn-build; mooduli ümber konfigureerida ja seejärel uuesti ehitada. See aitab enamasti puhkudel, kus on muutunud ehitamissüsteemi fail, mis nõuab ümberkonfigureerimist, kuid ehitamissüsteem ei ole seda ise automaatselt teinud. </para>

<para
>Mooduli ehitamiskataloogi sel sammul ei puudutata, nii et kui jätta kõrvale ümberkonfigureerimine, selgub ka siin kiiresti, kas ehitamine õnnestub või mitte. </para>
</listitem>

<listitem
><para
>Kui mooduli ehitamine ikkagi nurjub, loobub &kdesvn-build; ja asub järgmise mooduli kallale. Siiski on mõningaid asju, mida võib proovida, et <link linkend="manual-rebuilds"
>moodul käsitsi ehitada</link
>. </para
></listitem>
</orderedlist>

<note
><para
>&kdesvn-build; tuvastab enamiku juhtudest, kui ehitamissüsteem vajab ümberkonfigureerimist ning võtab selle ise automaatselt ette. </para>

<para
>Kui aga &kdesvn-build; ehitab moodulit esimest korda, jäetakse need sammud vahele, sest puhas taasehitamine tavaliselt ei nurju, kui tegemist ei ole just tõsise veaga.</para>
</note>
</sect3>

<sect3 id="manual-rebuilds">
<title
>Mooduli taasehitamine käsitsi</title>
<para
>Kui oled muutnud mooduli võtmeid või on mooduli lähtekood sedavõrd muutunud, et &kdesvn-build; ei tunne seda enam ära, võib olla vajalik mooduli taasehitamine käsitsi.</para>

<para
>Selleks piisab ka käsust <userinput
><command
>kdesvn-build</command
> <option
>--refresh-build</option
> <option
><replaceable
>moodul</replaceable
></option
></userinput
>. </para>

<para
>Kui soovid, et &kdesvn-build; ehitaks järgmise ehitamise uuendamise ajal mooduli automaatselt uuesti, võid luua spetsiaalse faili. Igal moodulil on oma ehitamiskataloog. Kui lood mooduli ehitamiskataloogis faili <filename
>.refresh-me</filename
>, ehitab &kdesvn-build; mooduli uuesti järgmise ehitamise ajal isegi siis, kui muidu võetakse ette märksa kiirem inkrementehitamine.</para>

<tip>
<para
>Vaikimisi on ehitamiskataloogiks <filename class="directory"
>~/kdesvn/build/<replaceable
>moodul</replaceable
>/</filename
>. Kui muudad võtme &build-dir; seadistusi, kasuta aga <filename class="directory"
>~/kdesvn/build</filename
>.</para>
</tip>

<informalexample>
<para
>Mooduli <replaceable
>arts</replaceable
> taasehitamine <filename
>.refresh-me</filename
> abil:</para>
<screen
><prompt
>%</prompt
> <userinput
><command
>touch</command
> <filename class="directory"
>~/kdesvn/build/<replaceable
>arts</replaceable
>.refresh-me</filename
></userinput>
<prompt
>%</prompt
> <userinput
><command
>kdesvn-build</command
></userinput
>
</screen>
</informalexample>
</sect3>

<sect3 id="controlling-rebuild-behavior">
<title
>Taasehitamise käitumise juhtimine</title>
<para
>Sa ei pruugi soovida, et &kdesvn-build; püüab alati moodulit taasehitada. Selle võib püsivalt keelata, kui anda võtmele &no-rebuild-on-fail; väärtuseks <userinput
>true</userinput
>.</para>

<para
>Ajutiselt saab selle keelata käsureavõtmega &cmd-no-rebuild-on-fail;.</para>

<informalexample>
<screen
><prompt
>%</prompt
> <userinput
><command
>kdesvn-build</command
> <option
>--no-rebuild-on-fail</option
></userinput
>
</screen>
</informalexample>

</sect3>

</sect2>

<sect2 id="changing-environment">
<title
>Keskkonnamuutujate seadistuste muutmine</title>
<para
>Erinevalt enamikust programmidest ei ole &kdesvn-build; keskkonda sisse väljakutsujalt, kasutades selle asemel keskkonna loomiseks hoopis seadistusi, mis leiduvad <link linkend="configure-data"
>seadistustefailis</link
>. Selle mõte on tagada ehitamise korratavus. Teisisõnu võib &kdesvn-build; mooduli ehitada ka siis, kui oled unustanud, millised keskkonnamuutujad kehtivad shellis, kus sa &kdesvn-build;i käivitasid.</para>

<para
>Kuid võib esineda juhuseid, kus tekib vajadus määrata kindlaks keskkonnamuutujad, mille jaoks &kdesvn-build;il puudub vahetu võti. See on võimalik võtmega &set-env;.</para>

<para
>Erinevalt enamikust võtmetest saab seda määrata mitu korda ning see tunnustab kaht kirjet, mida eraldab tühik. Esimene neist on määratava keskkonnamuutuja nimi ja teine selle väärtus.</para>

<informalexample>
<para
>Kõigile moodulitele <userinput
><envar
>DISTRO</envar
>=<replaceable
>BSD</replaceable
></userinput
> määramine:</para>
<screen
>global
  set-env <replaceable
>DISTRO</replaceable
> <replaceable
>BSD</replaceable>
end global
</screen>
</informalexample>

</sect2>

<sect2 id="resuming">
<title
>Ehitamise jätkamine</title>

<sect3 id="resuming-failed">
<title
>Nurjunud või katkestatud ehitamise jätkamine</title>

<para
>&kdesvn-build;ile võib anda korralduse alustada ehitamist mõnest muust moodulist kui tavaliselt. See võib olla mõttekas näiteks siis, kui mitme mooduli ehitamine on nurjunud või kui katkestasid ehitamise poole pealt. Seda saab määrata võtmega &cmd-resume-from;.</para>

<note
><para
>Võtme &cmd-resume-from; kasutamisel lähtekoodi ei uuendata.</para>
</note>

<informalexample>
<para
>Ehitamise jätkamine alates moodulist kdebase:</para>

<screen
><prompt
>%</prompt
> <userinput
><command
>kdesvn-build</command
> <option
>--resume-from=<replaceable
>kdebase</replaceable
></option
></userinput
>
</screen>
</informalexample>

</sect3>

<sect3 id="ignoring-modules">
<title
>Moodulite eiramine ehitamisel</title>

<para
>Nii nagu võib <link linkend="resuming-failed"
>jätkata ehitamist kindlast moodulist</link
>, võib ka kõike uuendada ja ehitada nagu tavaliselt, kuid eirata teatavaid mooduleid.</para>

<para
>Selleks on mõeldud võti &cmd-ignore-modules;. See annab &kdesvn-build;ile korralduse eirata uuendamisel ja ehitamisel kõiki määratud mooduleid.</para>

<informalexample>
<para
>extragear/multimedia ja kdereview eiramine:</para>
<screen
><prompt
>%</prompt
> <userinput
><command
>kdesvn-build</command
> <option
>--ignore-modules</option
> <replaceable
>extragear/multimedia kdereview</replaceable
></userinput
>
</screen>
</informalexample>

</sect3>
</sect2>

<sect2 id="changing-env-from-cmd-line">
<title
>Võtmete muutmine käsureal</title>

<sect3 id="changing-global-opts">
<title
>Globaalsete võtmete muutmine</title>
<para
><link linkend="configure-data"
>Seadistustefailist</link
> loetavate võtmete seadistusi saab muuta otse käsurealt. See tühistab seadistustefailis määratu ainult ajutiselt, mõjudes vaid nii kaua, kuni töötab käsk, millega muutus rakendati.</para>

<para
>&kdesvn-build; võimaldab anda võtmetele, mis on esitatud <replaceable
>võtmenimena</replaceable
>, argumente otse käsureal kujul <userinput
><option
>--<replaceable
>võtmenimi</replaceable
>=väärtus</option
></userinput
>. &kdesvn-build; tuvastab võtme ning otsib sellele vastet võtmete loendist. Kui nime ära ei tunta, näidatakse hoiatust, kui aga tuntakse, jäetakse meelde määratud väärtus ning jäetakse arvestamata samale võtmele seadistustefailis määratud väärtus.</para>

<informalexample>
<para
>Võtmele &source-dir; testimiseks väärtuse <filename
>/dev/null</filename
> määramine:</para>

<screen
><prompt
>%</prompt
> <userinput
><command
>kdesvn-build</command
> <option
>--pretend</option
> <option
>--<replaceable
>source-dir</replaceable
>=<replaceable
>/dev/null</replaceable
></option
></userinput
>
</screen>

</informalexample>

</sect3>

<sect3 id="changing-module-opts">
<title
>Mooduli võtmete muutmine</title>
<para
>Võtmeid võib muuta ka ainult kindla mooduli puhul. Süntaks on samasugune: --<replaceable
>moodul</replaceable
>,<replaceable
>võtmenimi</replaceable
>=<replaceable
>väärtus</replaceable
>. </para>

<para
>See tühistab igasuguse moodulile määratud samalaadse seadistuse <link linkend="configure-data"
>seadistustefailis</link
> ja rakendub ainult siis, kui võti edastatakse käsureal.</para>

<informalexample>
<para
>Teistsuguse ehitamiskataloogi määramine moodulile kdeedu:</para>

<screen
><prompt
>%</prompt
> <userinput
><command
>kdesvn-build</command
> <option
>--<replaceable
>kdeedu</replaceable
>,<replaceable
>build-dir</replaceable
>=<replaceable
>temp-build</replaceable
></option
></userinput
>
</screen>

</informalexample>

</sect3>

</sect2>

</sect1>

<sect1 id="developer-features">
<title
>Võimalused &kde; arendajatele</title>

<sect2 id="ssh-agent-reminder">
<title
>&ssh; agendi kontrollimine</title>
<para
>&kdesvn-build; võib kontrollida, et &kde; arendajad, kes tarvitavad ligipääsuks &kde; lähtekoodihoidlale &ssh;-d, ei unustaks väljumisel kogemata &ssh; agenti tööle. See paneb &kdesvn-build;i sõna otseses mõttes hanguma, sest ta muudkui ootab, kuni arendaja kirjutab oma &ssh; parooli. Seepärast kontrollib &kdesvn-build; enne lähtekoodi uuendamist, kas agent töötab või mitte. </para>

<note
><para
>Seda tehakse ainult nende &kde; arendajate korral, kes kasutavad &ssh;-d, sest vaikimisi anonüümse väljavõtte jaoks ei ole mingit parooli vaja. &subversion; tuleb toime paroolidega ka &kde; arendajate teise võimaliku protokolli ehk https korral. </para
></note>

<para
>&ssh; agendi kontrollimise võib ka välja lülitada, eriti juhtudel, kus &kdesvn-build; kipub selle tegelikku olemasolu eirama. Agendi kontrollimise vältimiseks tuleb võtme <option
>disable-agent-check</option
> väärtuseks määrata <userinput
>true</userinput
>.</para>

<informalexample>
<para
>&ssh; agendi kontrollise keelamine:</para>
<screen
>global
  disable-agent-check true
end global
</screen>
</informalexample>

</sect2>

</sect1>

<sect1 id="other-features">
<title
>&kdesvn-build;i lisaomadused</title>

<sect2 id="changing-verbosity">
<title
>&kdesvn-build;i väljundi mahu muutmine</title>
<para
>&kdesvn-build;il on mitu võtit, millega saam kindlaks määrata skripti loodava väljundi mahu. Igal juhul näidatakse alati vigu.</para>

<itemizedlist>
<listitem
><para
>Võti <option
>--quiet</option
> (lühemal kujul <option
>-q</option
>) paneb &kdesvn-build;i peaaegu vaikima: näidatakse ainult olulisi teateid, hoiatusi ja vigu. Võimaluse korral näidatakse siiski ka ehitamise edenemise teavet.</para
></listitem>

<listitem
><para
>Võti <option
>--really-quiet</option
> sunnib &kdesvn-build;i näitama ainult olulisi hoiatusi ja vigu.</para
></listitem>

<listitem
><para
>Võti <option
>--verbose</option
> (lühemal kujul <option
>-v</option
>) muudab &kdesvn-build;i väljundi väga üksikasjalikuks.</para
></listitem>

<listitem
><para
>Võti <option
>--debug</option
> on mõeldud ainult silumiseks, pannes &kdesvn-build;i tööle nii, nagu oleks sisse lülitatud võti <option
>--verbose</option
>. Samuti saadavad käsud oma väljundi terminali ning lisaks on näha paljude funktsioonide silumisteave.</para
></listitem>
</itemizedlist>

</sect2>

<sect2 id="kdesvn-build-color">
<title
>Värviline väljund</title>
<para
>Käivitamisel &konsole;'ist või mõnest muust terminalist näitab &kdesvn-build; tavaliselt värvilist teksti.</para>

<para
>Selle saab keelata, kui anda käsureal võti <option
>--no-color</option
> või määrata <link linkend="configure-data"
>seadistustefailis</link
> võtme &colorful-output; väärtuseks <userinput
>false</userinput
>. </para>

<informalexample>
<para
>Värvilise väljundi keelamine seadistustefailis:</para>
<screen
>global
  colorful-output false
end global
</screen>
</informalexample>

</sect2>

<sect2 id="email-reports">
<title
>Teatamine ehitamise nurjumisest e-kirjaga</title>
<para
>&kdesvn-build; võib saata sinu valitud e-posti aadressile aruande, kui mõne mooduli ehitamine mis tahes põhjusel nurjub. Selleks tuleb sul määrata e-posti aadress, millelt &kdesvn-build; aruande saadab, ning aadress, kuhu aruanne vea korral saadetakse.</para>

<para
>Seejärel koostab &kdesvn-build; iga töökorra lõpul e-kirja, kui leidus mooduleid, mille ehitamine ei õnnestunud. E-kiri sisaldab lühidalt iga mooduli nurjumise kohta käivat logi. Ühe töökorra kohta saadetakse ainult üks e-kiri ka siis, kui nurjus näiteks 15 mooduli ehitamine. </para>

<para
>Vaikimisi ei ole see võimalus sisse lülitatud. Selle lubamiseks tuleb määrata võtmed &email-address; ja &email-on-compile-error;. Võti <option
>email-address</option
> määrab kindlaks aadressi, mille alt &kdesvn-build; kirja saadab, ning võti <option
>email-on-compile-error</option
> aadressi, kuhu kiri saadetakse. </para>

<tip>
<para
>&kdesvn-build; kasutab kirja saatmiseks Perli standardset moodulit Mail::Mailer. Perl 5.8 sisaldab seda, Perl 5.6 korral tuleb see eraldi paigaldada. Mail::Mailer toetab järgmisi programme: <application
>Sendmail</application
> (kaasa arvatud <application
>Sendmail</application
>iga ühilduvad e-posti kliendid), loomupärane <acronym
>SMTP</acronym
> ning <application
>qmail</application
>. </para>
</tip>

<informalexample>
<para
>Ehitamise veast teatava e-kirja saatmine aadressilt jama@kuskil.ee aadressile suva@kuskil.ee:</para>

<screen
>global
  email-address          jama@kuskil.ee    # Saatja: kõigi kdesvn-buildi e-kirjade aadress
  email-on-compile-error suva@kuskil.ee    # Saaja: ehitamisveast teatamise aadress
end global
</screen>
</informalexample>

</sect2>

<sect2 id="deleting-build-dir">
<title
>Ebavajalike kataloogide eemaldamine pärast ehitamist</title>
<para
>Sul ei ole küll kettal palju ruumi, aga tahad siiski tööle panna kõige-kõige uuema &kde;? &kdesvn-build; aitab vähendada kettakasutust ka &kde; ehitamisel &subversion;ist.</para>

<note
><para
>Arvesta, et &kde; ehitamine nõuab tublisti ruumi. &kdesvn-build;i kasutamisel tuleb ruumi osas silmas pidada järgmisi asju:</para
></note>

<orderedlist>
<listitem
><para
>Lähtekoodi väljavõte võtab päris palju ruumi. Ainuüksi vaikimisi moodulid hõivavad umbes 1.6 gigabaiti. Seda saab küll vähendada, kui ehitada ainult need moodulid, mida sul tõepoolest vaja läheb. &kdesvn-build; ei kustuta lähtekoodi kettalt isegi siis, kui kustutad vastava kirje <link linkend="configure-data"
>seadistustefailist</link
>, nii et kindlasti tuleks ise kustutada lähtekoodikataloogist kogu ebavajalik lähtekood. Pane tähele, et lähtekoodi failid laaditakse alla internetist, mistõttu neid <emphasis
>ei tasu</emphasis
> kustutada, kui sa neid ikkagi kasutad - vähemalt seni, kuni töötab &kdesvn-build;.</para>

<para
>Kui sul on juba nagunii paigaldatud &Qt;, ei ole erilist mõtet paigaldada qt-copy moodulit. Sellest loobumine hoiab kokku umbes 200 megabaiti.</para>

<para
>Tähele tasub panna üht iseärasust &subversion;i töös: iga hoidlast välja võetud faili kohta on kettal tegelikult kaks faili. &kdesvn-build; ei võimalda praegu minimeerida lähtekoodi suurust juhtudel, kus seda ei kasutata. </para>
</listitem>

<listitem>
<para
>&kdesvn-build; loob lähtekoodi ehitamiseks eraldi ehitamiskataloogi. Mõnikord peab &kdesvn-build; kopeerima lähtekoodikataloogi, et luua liba-ehitamiskataloog. Sel juhul kasutatakse ruumisäästlikke nimeviitu, nii et see ei vähenda kettaruumi. Ehitamiskataloog on reeglina palju suurem kui sama mooduli lähtekoodikataloog. Näiteks mooduli kdebase ehitamiskataloog on umbes 1050 megabaiti, samas kui lähtekoodi ennast on vaid 550 megabaidi jagu.</para>

<para
>Õnnekombel ei ole pärast mooduli edukat ehitamist ja paigaldamist enam mingit vajadust ehitamiskataloogi järele. &kdesvn-build; võib pärast mooduli paigaldamist automaatselt eemaldada ehitamiskataloogi (vaata lähemalt allpool olevaid näiteid). Pane siiski tähele, et see muudab &kdesvn-build;il võimatuks teostada aega kokkuhoidvat inkrementehitamist.</para>
</listitem>

<listitem
><para
>Lõpuks nõuab oma osa kettaruumist ka &kde; paigaldus. Reeglina on vajalik ruum väiksem kui ehitamiskataloogil, aga siin on raske tuua konkreetseid arve. </para
></listitem>
</orderedlist>

<para
>Kuidas siis vähendada &kde; ruuminõudeid? Üks võimalus on kasutada vastavaid kompileerimislippe, mis võimaldavad kiiruse arvel ruumi kokku hoida. Teine ja enamasti märksa tõhusam viis on eemaldada &kde; ehitamisest silumisteave. </para>

<warning
><para
>Enne silumisteabe eemaldamist peaksid oma sammu siiski väga tõsiselt kaaluma. Uhiuue tarkvara kasutamine sisaldab endas väga suurt tõenäosust, et see jookseb kokku palju kergemini kui stabiilne väljalase. Kui kasutad seda aga ilma silumisteabeta, on väga keeruline koostada veateateid ning sul tuleb tõenäoliselt silumisteave vähemalt krahhi üle elanud rakenduse puhul uuesti sisse lülitada ning rakendus uuesti ehitada, et saaksid aidata arendajatel viga parandada. Niisiis, silumisteabe eemaldamine jääb vaid sinu enda südametunnistusele! </para
></warning>

<informalexample>
<para
>Ehitamiskataloogi eemaldamine pärast mooduli paigaldamist. Lähtekoodikataloog jääb alles ning silumine on sisse lülitatud:</para>

<screen
>global
  configure-flags      --enable-debug
  remove-after-install builddir        # Ehitamiskataloogi eemaldamine pärast paigaldamist
end global
</screen>

<para
>Ehitamiskataloogi eemaldamine pärast ehitamist. Silumine on välja lülitatud ning suurust optimeeritakse.</para>

<screen
>global
  cxxflags             -Os             # Suuruse optimeerimine
  configure-flags      --disable-debug
  remove-after-install builddir        # Ehitamiskataloogi eemaldamine pärast paigaldamist
end global
</screen>
</informalexample>
</sect2>

</sect1>

</chapter>

<chapter id="kde-cmake">
<title
>&cmake; - &kde; 4 ehitamissüsteem</title>

<sect1 id="kde-cmake-intro">
<title
>&cmake;'i sissejuhatus</title>

<para
>2006. aasta märtsis võitis &cmake; mitmeid konkurente ning valiti &kde; 4 ehitamissüsteemiks, asendades muidu &kde; algusest peale kasutatud autotoolsi-põhise süsteemi.</para>

<para
>&cmake;'i sissejuhatuse leiab <ulink url="http://techbase.kde.org/Development/Tutorials/CMake"
>&kde; TechBase'ist</ulink
>. Põhimõtteliselt võib selle kokku võtta nii: selle asemel, et käivitada <userinput
><command
>make</command
> <option
>-f</option
> <filename
>Makefile.cvs</filename
></userinput
>, siis <command
>configure</command
> ja siis &make;, tuleb nüüd käivitada &cmake; ja siis &make;. </para>

<para
>&kdesvn-build; toetab &cmake;'i. Mõned &kdesvn-build;i omadused õieti kuuluvadki selle aluseks olevale ehitamissüsteemile, näiteks <link linkend="conf-inst-apps"
>inst-apps</link
>, <link linkend="conf-configure-flags"
>configure-flags</link
> ja <link linkend="conf-do-not-compile"
>do-not-compile</link
>. Samaväärsete omaduste korral saab neid ka kasutada. Näiteks võtme configure-flags vaste on <link linkend="conf-cmake-options"
>cmake-options</link
> ning võti <link linkend="conf-do-not-compile"
>do-not-compile</link
> on alates &kdesvn-build;i versioonist 1.6.3 toetatud ka &cmake;'i puhul. </para>

<para
>Mõnel võtmel, näiteks <link linkend="conf-inst-apps"
>inst-apps</link
>, ei ole aga otsest vastet ning neid ei saa sestap kasutada. Kui autor peaks avastama viisi, kuidas neid &cmake;'is teostada, saab niisugused võtmed taas kasutatavaks muuta. Kuid üldiselt ei tohiks töös erilist vahet olla.</para>

</sect1>
</chapter>

<chapter id="credits-and-licenses">
<title
>Autorid ja litsents</title>

<para
>Tõlge eesti keelde: Marek Laane<email
>bald@smail.ee</email
></para
> 
&underFDL; </chapter>

</book>