>Her dokumenterer vi syntaksen for &tdesvn-build;'s indstillingsfiler, dets kommandolinjeflag, funktioner og en oversigt over alle nødvendige skridt som kræves for at bygge &kde; fra kildekode, inklusive de skridt du skal udføre ved brug af andre værktøjer, eller med andre ord, skridt som ikke automatisk udføres af scriptet &tdesvn-build;. </para>
>I dette kapitel viser vi hvordan &tdesvn-build; bruges til at tjekke moduler ud fra &kde;-arkivet og bygge dem. Vi sørger også efor n grundlæggende forklaring af &kde;'s &svn;-struktur og de skridt du skal udføre inden scriptet køres. </para>
>Alle emner som præsenteres i dette kapitel dækkes med endnu flere detaljer i guiden <ulink url="http://quality.kde.org/develop/cvsguide/buildstep.php"
>Building &kde; from Source Step by Step Guide</ulink
> på <ulink url="http://quality.kde.org"
>hjemmesiden for &kde;'s kvalitetsgruppe</ulink
>. Hvis du kompilerer KDE første gang, er det en god idé at læse den, eller rådspørge den som en referencekilde. Du finder detaljeret information om pakkeværktøj og krav, almindelige faldgreb ved kompilering og strategier og information om at køre den nye &kde;-installation. </para>
<sect1 id="before-building">
<title
>Forbered systemet til at bygge &kde;</title>
<para
>Du anbefales at hente og bygge &kde; med en brugerkonto. Hvis du allerede har &kde;-pakker installerede, er det bedste valg at oprette en anden (særlig) brugere til at bygge og køre den nye &kde;. Fordelen ved at bygge &kde; for en særlig bruger er at du ikke kan forstyrre basissystemet, og du har altid en måde at arbejde bekvemt når ting går galt. </para>
<para
>Senere kan du installere som systemadministrator hvis du vil. Dette dokument dækker ikke en installation som systemadministrator. Hvis du udfører en systeminstallation, véd du formodentlig alligevel hvad du fortager dig. </para>
>Inden du bruger scriptet &tdesvn-build; (eller en anden byggestrategi) skal du installere udviklingsværktøjer og biblioteker som behøves for &kde;. Du behøver Qt-biblioteket, version 3.3.0 eller senere, Automake 1.8, Autoconf 2.5X (bedre med
>= 2.57 eftersom en fejl rapporteredes med tidligere versioner), subversion-klienten (svn), gcc-oversætteren med understøttelse for C++, libxml2, openssl, libbz2 og mange flere (for en fuldstændig liste, besøg <ulink url="http://www.kde.org/info/requirements/3.4.php"
>KDE kompileringskrav</ulink
>). Du kan oftest få værktøjerne pakkede for dit system fra din distribution eller leverandør. </para>
<para
>Visse af pakkerne er opdelte i biblioteker, programmer eller værktøjer og udviklingspakker. Du behøver i det mindste programmet eller biblioteket og dets udviklingspakke. Hvis du er i tvivl installér alle. Bibliotekerne du behøver ændres afhængig af modulerne du har til hensigt at bygge, eftersom hvert modul har sine egne krav. Guiden <ulink url="http://quality.kde.org/develop/cvsguide/buildstep.php#step1"
>Building &kde; from Source Step by Step</ulink
> har flere detaljer om specifikke værktøjer og tekniker som bruges til at installere og finde programmellet som kræves. </para>
>Du har formodentlig allerede en version af scriptet &tdesvn-build; installeret på dit system. &tdesvn-build; kræver at du laver en indstillingsfil, som hedder <filename
>. Filen skal installeres i hjemmemappen (~/), og indeholde alle indstillingsdata som kræves for at scriptet skal kunne køres, såsom indstillingstilvalg, kompileringsflag, plads for kildekoden, målet for installationen (præfix), modulerne som skal bygges, osv. Der sørges for standardindstillingsdata i filen <filename
>. Du ser en liste med filer tilgængelige i mappen tdesdk/scripts i &kde;:s &svn;-arkiv. Klik på linket &tdesvn-build; og hent seneste version af scriptet. Gør det samme med filen <filename
> som en skabelon, for at indstille globale tilvalg og modulerne du vil bygge. </para>
<para
>Vælg serveren som skal bruges til at tjekke ud fra &svn; ved at indstille det globale tilvalg for svn-server. Det anonyme &svn;-arkiv <emphasis
>svn://anonsvn.kde.org/</emphasis
> er standard, men lav det om du har en <ulink url="http://developer.kde.org/documentation/misc/firststepsaccount"
>&kde; &svn;-konto</ulink
>, eller hvis der er et <ulink url="http://developer.kde.org/source/anonsvn.html"
>spejl tæt ved dig</ulink
>. </para>
<para
>Vær særlig opmærksom på de globale variabler kdedir og qtdir, eftersom den første angiver hvor det byggede &kde; skal installeres (normalt i <filename
>~/kde</filename
>), og den anden hvor (og om) Qt-biblioteket skal bygges og installeres (normalt <filename
>). Du skal kende stederne for kdedir og qtdir senere, for at indstille miljøvariablerne som er nødvendige for at køre den nye installationen. Kontrollér om de listede moduler virkeligheden er modulerne som du vil bygge. Standardvalgmulighederne i filen <filename
>Nu skulle scriptet begynde at hente kildekoden og kompilere den. Det er ikke sandsynligt at det lykkes første gang du kompilerer &kde;. Fortvivl ikke! Kontrollér logfilerne for at se om du mangler nogle værktøjer eller udviklingspakker (stedet for logfilerne angives af variablen log-dir i indstillingsfilen). Sommetider bliver hovedudviklingsgrenen meget ustabil og svær at bygge, især når en frysning af udviklingen er nær. Vær tålmodig. Du kan finde flere almindelige eksempler på ting som kan gå galt og deres løsning, samt generelle vink og strategier for at bygge &kde; i guiden <ulink url="http://quality.kde.org/develop/cvsguide/buildstep.php#step1"
>Building &kde; from Source Step by Step</ulink
>. </para>
</sect1>
<sect1 id="environment">
<title
>Opsætning af miljøet for at køre den friske &kde;</title>
<para
>Under antagelse af at du bruger en særlig bruger til at bygge &kde; og allerede har en installeret version af &kde;, kan det være noget tricket at køre det nye &kde;, eftersom den nye &kde; skal foretrækkes frem for den gamle. Ændr miljøvariabler for at sikre dig at dette sker. </para>
<para
>Åbn eller oprette filen <filename
>.bash_profile</filename
> i hjemmemappen med din favoriteditor, og tilføj følgende i slutningen af filen: <programlisting>
>Start nu den friske &kde;: i BSD- og Linux-systemer med understøttelse for virtuelle terminaler, bruges tastekombinationerne Ctrl+Alt+F1..F12 til at skifte mellem virtuelle konsoller 1 til og med 12. Det lader dig køre mere end et desktopmiljø samtidigt. De første seks er tekstterminaler, og de følgende seks er grafiske skærme. </para>
<para
>Hvis den grafiske skærmhåndtering i stedet vises når du starter, kan du bruge det nye KDE-miljø også selvom det ikke listes som en mulighed. Tryk på Ctrl+Alt+F2, så vises en tekstterminal. Log ind som den særlige bruger og skriv: </para>
<screen
>startx -- :1
</screen>
<tip>
<para
>Du kan køre KDE fra kildekode og det gamle KDE samtidigt. Log ind som din almindelige bruger, og starte den stabile KDE-desktop. Tryk på Ctrl+Alt+F2 (eller F1, F3, etc.), så vises en tekstterminal. Log ind som den særlige bruger og skriv "startx -- :1". Du kan gå tilbage til den almindelige bruger ved at trykke på Ctrl+Alt+F6 (eller F7, F8 osv. Prøv dem. En af dem er den rigtige.). For at gå tilbage til KDE fra kildekode, tryk på Ctrl+Alt+F7 (eller F6, F8, etc.). Nu kan du skifte mellem dine KDE-versioner, og teste den nye mens du véd at du hurtigt kan gå tilbage til sikkerheden hos den stabile KDE-desktop. </para>
>Tjekker automatisk ud eller opdaterer moduler fra &svn;, ifølge hvad som er passende. </para
></listitem>
<listitem
><para
>Beregner tiden for at bygge moduler. </para
></listitem>
<listitem
><para
>Forsøger automatisk at genbygge moduler som bruger en inkrementel byggeproces, hvilket tenderer at mislykkes efter visse typer af indtjekninger. </para
></listitem>
<listitem
><para
>Kan genoptage et tidligere script, eller starte byggeprocessen fra en bestemt modul. </para
></listitem>
<listitem
><para
>Levereres med et indbygget rimeligt sæt standardtilvalg passende til at bygge en grundlæggende enbrugerinstallation af &kde; fra det anonyme &svn;-arkivet. </para
></listitem>
<listitem
><para
>Levereres med understøttelse for <ulink url="http://www.kde.me.uk/index.php?page=unsermake"
>Unsermake</ulink
>. </para
></listitem>
<listitem
><para
>Ekspanderer dine indstillingstilvalg med tilde. Du kan for eksempel angive: <programlisting
>Eftersom autoværktøjerne sommetider bliver usynkroniserede med ændringer i kildekodetræet, kan du tvinge til at et modul bygges om ved at oprette en fil som hedder refresh-me i byggemappen for modulet det drejer sig om, eller ved at køre &tdesvn-build; med flaget <option
>Kommandologning. Logger dateres og nummereres så du altid har en log af en kørsel af scriptet. Desuden skabes et symbolsk link som hedder latest, som altid peger på den seneste log i logmappen. </para
></listitem>
<listitem
><para
>Hvis du bruger en brugerbygget &kde; i stedet for en systembygget (som du skal være systemadministrator for at installere), kan du lada scriptet installere for dig. Jeg har ikke gransket koden, og den bruger kaldet <function
>system()</function
> flitigt, så jeg anbefaler for øjeblikket ikke at køre den som systemadministrator. </para
></listitem>
<listitem
><para
>Du kan bruge <link linkend="conf-make-install-prefix"
>make-install-prefix</link
> til at indlede byggekommandolinjen med en separat kommando, hvilket er nyttigt for sudo. </para
></listitem>
<listitem
><para
>Du kan bruge tilvalget <link linkend="conf-apidox"
>apidox</link
> for automatisk at bygge og installere dokumentation om programmeringsgrænsefladen for visse moduler. </para
></listitem>
<listitem
><para
>Du kan nøjes med at tjekke en delmængde af en &kde; &svn;-modul ud. Du vil for eksempel kunne kunne nøjes med at tjekke <application
> hvis det behøves for at få byggeprocessen til at fungere. </para
></listitem>
<listitem
><para
>Du kan <quote
>lade som om</quote
> du udfører handlingen. Hvis du sender med <option
>--pretend</option
> eller <option
>-p</option
> på kommandolinjen, giver scriptet en meget udførlig beskrivelse af de kommandoer som skal gøres, uden i virkeligheden at udføre dem. </para
></listitem>
<listitem
><para
>Støtte for at tjekke specifikke grene af &svn;-moduler ud. Arbejdet behøver stadigvæk at gøres færdigt, men du kan allerede vælge grenen du vil bygge med indstillingstilvalget <link linkend="conf-module-base-path"
>Finde det hurtigste spejl for &kde; &svn;. Der er ikke engang en liste medsendt med scriptet for øjeblikket, selvom standardserveren skulle virke godt. </para
></listitem>
<listitem
><para
>Børste dine tænder. Du skal huske at gøre det selv. </para
></listitem>
<listitem
><para
>Desværre er scriptet formodentlig ikke fejlfrit. </para
> skal være et modul i &kde;:s &svn;-arkiv (for eksempel tdelibs eller tdebase). Visse tilvælg sætter de globale valgmuligheder ud af kraft, visse tilføjes til de globale valgmuligheder og visse globale tilvalg kan simpelthen ikke sættes ud af kraft. </para>
>Følgende er en alfabetisk liste med tilvalg du kan bruge. Klik på tilvalget for at finde ud af mere om det. Hvis noget ikke er dokumenteret, så send gerne e-mail til forfatterne med adressen som du finder <link linkend="authors"
>ovenfor</link
>. </para>
<itemizedlist>
<listitem
><para
><link linkend="conf-apidox"
>apidox</link
>, for at bygge dokumentation over programmeringsgrænsefladen</para
></listitem>
<listitem
><para
><link linkend="conf-apply-qt-patches"
>apply-qt-patches</link
>, for at forbedre qt-copy</para
></listitem>
<listitem
><para
><link linkend="conf-binpath"
>binpath</link
>, for at indstille variablen <envar
>PATH</envar
>.</para
></listitem>
<listitem
><para
><link linkend="conf-branch"
>branch</link
>, for at tjekke ud fra en gren i stedet for /trunk.</para
></listitem>
<listitem
><para
><link linkend="conf-build-dir"
>build-dir</link
>, for at angive mappe at bygge i.</para
></listitem>
<listitem
><para
><link linkend="conf-checkout-only"
>checkout-only</link
>, for kun at tjekke dele af et modul ud.</para
></listitem>
<listitem
><para
><link linkend="conf-colorful-output"
>colorful-output</link
> for at tilføje farve til scriptets uddata.</para
></listitem>
<listitem
><para
><link linkend="conf-configure-flags"
>configure-flags</link
> for at angive hvilke flag et modul skal indstilles med.</para
>, for at ændre serveren som kildekoden automatisk hentes fra.</para
></listitem>
<listitem
><para
><link linkend="conf-use-qt-builddir-hack"
>use-qt-builddir-hack</link
>, for at give Qt en separat byggemappe fra kildekoden, såsom KDE.</para
></listitem>
<listitem
><para
><link linkend="conf-use-unsermake"
>use-unsermake</link
>, for at bruge det avancerede byggesystem unsermake.</para
></listitem>
</itemizedlist>
<para
>Her er en tabel over de forskellige valgmuligheder, og nogle kommentarer om dem. Alle tilvalg som sætter et globat tilvalg ud af kraft, gør det også for et kommandolinjeflag. </para>
> for at få &tdesvn-build; til automatisk at bygge og installere dokumentation om programmeringsgrænsefladen for modulet efter den normale byggeproces. Det virker kun for moduler hvor <quote
>Dette er kun nyttigtt for qt-copy. Hvis det er stillet til en værdi andet end nul, køres scriptet apply-patches i qt-copy inden byggeprocessen, for at udføre uofficielle programrettelser i qt-copy. Eftersom disse programrettelser normalt er grunden til at bruge qt-copy i stedet for en standardversion af Qt, skulle det ikke være skadligt at aktivere dette. Standardværdi er at aktivere programrettelserne.</entry>
</row>
<row id="conf-binpath">
<entry
>binpath</entry>
<entry
>Kan ikke sættes udf af kraft</entry>
<entry
><para
>Sæt dette for at bruge miljøvariablen PATH under byggeprocessen. Du kan ikke dette ud af kraft i et modultilvalg. Standatdværdi er <filename class="directory"
> tilføjes automatisk. Du kan bruge tilde (~) for eventuelle søgestier du tilføjer med dette tilvalg.</para>
</entry>
</row>
<row id="conf-branch">
<entry
>branch</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
><para
>Angiv dette for at tjekk ud fra en gren af KDE i stedet for standarden "trunk", hvor KDE-udvikling sker. For eksempel for at tjekke grenen KDE 3.4 ud, skal du angive tilvalget "3.4".</para>
<para
>Bemærk at visse moduler bruger et anderledes grennavn. I særdeleshed følger det krævede modul arts ikke KDE's versionsnummer. Modulet arts som hørte sammen med KDE 3.4 var version 1.4.</para>
>Hvis det mislykkes for tdesvn-build at hente en gren med dette tilvalg, kan du behøve at angive URL'en for at hente fra manuelt med tilvalget <link linkend="conf-override-url"
>Brug dette for at skifte mappen som indeholder kildekoden at bygge. Der er tre forskellige måder at bruge det: <itemizedlist
><listitem
><para
>Relativt til &kde;:&svn;-kildekodemappe (se <link linkend="conf-source-dir"
>tilvalget source-dir</link
>). Det er standard, og måden som scriptet virkede frem til version 0.61. Denne tilstand vælges hvis du indskriver et mappenavn som ikke begynder med tilde (~) eller skråstreg (/).</para
><para
>Standardværdi er <filename class="directory"
>build</filename
></para
></listitem
><listitem
><para
>Absolut søgesti. Hvis du angiver en søgesti som begynder med /, bruges søgestien direkte. For eksempel <filename class="directory"
>/tmp/kde-obj-dir/</filename
></para
></listitem
><listitem
><para
>Relativt til din hjemmemappe. Hvis du angiver en søgesti som begynder med ~, bruges søgestien relativt til din hjemmemappe, på tilsvarende måde som skallens ekspansion af tilde. Forl eksempel ville <filename class="directory"
>~/builddir</filename
> indstille byggemappen til <filename class="directory"
>/home/brugernavn/builddir</filename
></para
></listitem
> </itemizedlist
>Dette kan, måske noget uventet, ændres pr modul. </entry>
</row>
<row id="conf-checkout-only">
<entry
>checkout-only</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Sæt dette for kun at tjekke kildekode ud fra &svn; del for del. Værdien af tilvalget skal være en liste med mapper adskilte med mellemrum at tjekke ud. Hvis du ikke inkluderer mappen admin, inkluderes den automatisk (hvis det behøves). Når du tjekker ud del for del hentes mappen admin ind fra kde-common, hvilket er stedet den findes på &svn;-serveren. Selvom tilvalget sætter det globale tilvalg ud af kraft, skal være klar over at det at angive dette som et globalt tilvalg ikke giver mening. </entry>
</row>
<row id="conf-configure-flags">
<entry
>configure-flags</entry>
<entry
>Tilføjer globale tilvalg (undtagen for qt-copy)</entry>
<entry
>Brug dette tilvalg for at angive hvilke flag som skal sendes til ./configure når byggesystemet for modulet laves. Når det bruges som et globalt tilvalg, bruges det for alle moduler som scriptet bygger. qt-copy bruger et meget anderledes sæt indstillingstilvalg end resten af &kde;, så dette tilvalg <emphasis
>sætter de globale indstillinger ud af kraft</emphasis
>. Bemærk at &tdesvn-build; ikke sender farvekoderne ud til noget andet end en terminal (såsom xterm, &konsole; eller den normale Linux-konsol). </entry>
>Brug dette tilvalg for at angive hvilke flag som skal sendes til <command
>./configure</command
> som <envar
>CXXFLAGS</envar
> når byggesystemet for modulet laves. Dette tilvalg angives her i stedet for med <link linkend="conf-configure-flags"
>configure-flags</link
> eftersom tilvalget også sætter miljøvariablen <envar
>CXXFLAGS</envar
> under byggprocessen. </entry>
</row>
<row id="conf-dest-dir">
<entry
>dest-dir</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Brug dette tilvalg for at ændre navnet et modul gives på disken. Hvis modulet for eksempel var extragear/network, ville du kunne skifte navn på det til extragear-network med dette tilvalg. </entry>
>Normalt, hvis du bruger SSH for at hente Subversion-kildekoden (såsom hvis du bruger protokollen svn+ssh), forsøger tdesvn-build at sørge for at du bruger SSH-agenten, så håndterer den virkelig nogle SSH-identiteter. Dette er for at forsøge at forhindre at SSH spørger efter dit løsen for hvert modul. Du kan deaktivere kontrollen ved at sætte disable-agent-check til true. </entry>
>Indstil dette tilvalg til e-mail-adressen som tdesvn-build skal sende fra hvis det nogensinde behøver at sende e-mail. Du behøver ikke bekymre dig om det hvis du ikke bruger nogen funktion som sender e-mail (De er alle normalt deaktiverede). </para>
>Du kan indstille dette tilvalg til e-mail-adressen hvorhen en rapport skal sendes når et modul mislykkes at bygge. tdesvn-build venter til alle moduler er færdige og samler alle resultater i rapporten. Rapporten sendes kun hvis det mislykkes at bygge et modul. </para>
>Dette er modsætningen til tilvalget <link linkend="conf-do-not-compile"
>do-not-compile</link
>. Dette tilvalg gør at kun angivne topniveaumapper bygges. Katalogerna skal adskilles med mellemrum.</para>
<para
>Eventuelle ændringer får ingen virkning førend næste gang <command
>make <option
>-f</option
> Makefile.cvs</command
> køres, enten automatisk af scriptet, eller manuelt med tilvalgene <link linkend="cmdline-refresh-build"
><option
>--refresh-build</option
></link
> eller <link linkend="cmdline-recreate-configure"
><option
>--recreate-configure</option
></link
>. </para>
<para
>Bemærk at kildekoden for programmerne stadigvæk hentes. Du kan bruge direktivet <link linkend="conf-checkout-only"
>checkout-only</link
> for at vælge mapper som du vil tjekke ud.</para>
</entry>
</row>
<row id="conf-install-after-build">
<entry
>install-after-build</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Dette tilvalg bruges til at installere pakken efter det er lykkedes at bygge den. Dette tilvalg er normalt aktiveret. Hvis du vil deaktivere det, skal du sætte tilvalget til 0 i indstillingsfilen. Du kan også bruge kommandolinjeflaget <link linkend="cmdline-no-install"
><option
>--no-install</option
></link
>. </entry>
</row>
<row id="conf-kdedir">
<entry
>kdedir</entry>
<entry
>Kan ikke sættes udf af kraft</entry>
<entry
>Dette tilvalg angiver mappen som &kde; installeres i efter det er bygget. Standardværdien er <filename class="directory"
>~/kde</filename
>. Hvis du ændrer det til en mappe som kræver adgang som systemadministrator, bør du også læse om tilvalget <link linkend="conf-make-install-prefix"
>make-install-prefix</link
>.</entry>
</row>
<row id="conf-libpath">
<entry
>libpath</entry>
<entry
>Kan ikke sættes udf af kraft</entry>
<entry
>Angiv dette tilvalg for at sætte miljøvariablen LD_LIBRARY_PATH under byggeprocessen. Du kan ikke sætte denne indstilling ud af kraft med et modultilvalg. Standardværdi er tomt, men søgestierne <filename class="directory"
> tilføjes automatisk. Du kan bruge tilde (~) i alle søgestier du tilføjer med dette tilvalg. </entry>
</row>
<row id="conf-log-dir">
<entry
>log-dir</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Brug dette tilvalg for at ændre mappen som bruges til at opbevare logfiler som laves af scriptet. Indstillingen kan ændres pr modul fra og med version 0.64 eller senere. </entry>
</row>
<row id="conf-make-install-prefix">
<entry
>make-install-prefix</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Sæt denne variabel til en liste adskilt med mellemrum, som tolkes som en kommando og dens flag til at gå forud for kommandoen make install som bruges til at installere moduler. Dette er nyttigt for eksempel til at installere pakker med sudo, men vær forsigtig når du håndterer systemadministratorens rettigheder.</entry>
</row>
<row id="conf-make-options">
<entry
>make-options</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Angiv denne variabel for at sende kommandolinjeflag til kommandoen make. Dette er nyttigt for programmer såsom <ulink url="http://distcc.samba.org/"
><application
>distcc</application
></ulink
>. Programmet <application
>distcc</application
> lader dig opdele dit kompileringsarbejde på mere end en maskine. For at bruge det, skal du bruge flaget <option
>-j</option
> til make. Nu kan du det. Ifølge dokumentationen anbefales 2 * antal_processorer_i_netværket. Jeg har i alt en processor, så det ville være <option
>-j2</option
> i mit tilfælde.</entry>
</row>
<row id="conf-manual-build">
<entry
>manual-build</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Sæt tilvalgsværdien til <quote
>true</quote
> for at forhindre at byggeprocessen forsøger at bygge modulet. Den holdes stadigvæk opdateret ved opdatering fra &svn;. Dette tilvalg svarer nøjagtigt til kommandolinjeflaget <link linkend="cmdline-no-build"
><option
>--no-build</option
></link
>. </entry>
</row>
<row id="conf-manual-update">
<entry
>manual-update</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Sæt tilvalgsværdien til <quote
>true</quote
> for at forhindre at byggeprocessen forsøger at opdatere (og følgelig, bygge eller installere) modulet. Hvis du angiver tilvalget for et modul, er det stort set det samme som at kommentere det bort. </entry>
>Sæt dette tilvalg for at sætte &tdesvn-build;s standardmappesti til modulet det drejer sig omd ud af kraft. Det kan for eksempel bruges til at hente specifikke grene eller mærkede versioner af biblioteker. <ulink url="http://websvn.kde.org/"
>Sæt dette tilvalg til et tal mellem 20 og 0. Jo højere nummer, desto lavere prioritet sætter &tdesvn-build; for sig selv. Standardværdi er 10. </entry>
> for altid at forhindre at &tdesvn-build; forsøger at genbygge modulet hvis en inkrementel byggeproces skulle mislykkes. Normalt forsøger &tdesvn-build; at genbygge modulet fra begyndelsen for at modvirke virkningen at enkelt &svn;-opdatering forårsager problemer med byggesystemet.</entry>
>. Du bør generelt bruge dette hvis du vil hente en specifik udgave, men tdesvn-build kan ikke regne ud hvad du mener ved at bruge <link linkend="conf-branch"
>Sæt dette tilvalg for at bruge miljøvariablen QTDIR under byggeprocessen. Du kan ikke sætte dette tilvalg ud af kraft i et modultilvalg. Standardværdi er <filename class="directory"
><varname
>$(source-dir)</varname
>/build/qt-copy</filename
>, som bruger modulet qt-copy som indgår i &kde;:s kildekodearkiv. Du kan bruge tilde (~) til at repræsentere din hjemmemappe. </entry>
</row>
<row id="conf-remove-after-install">
<entry
>remove-after-install</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
><para
>Hvis du kun har lidt om harddiskplads kan du ville bruge dette tilvalg til at automatisk at fjerne byggemappen (eller både kildemappen og byggemappen for engangsinstallationer) efter det er lykkedes at installere modulet. </para>
<para
>Mulige værdier for dette tilvalg er: <itemizedlist>
<listitem
><para
>none - Slet ikke bort noget (dette er standardværdien).</para
></listitem>
<listitem
><para
>builddir - Slet byggemappen men ikke kildekoden.</para
>Bemærk at brug af dette tilvalg kan give en signifikant skadelig indvirkning både på din brug af båndbredde (hvis du bruger 'all') og tiden det tager at kompilere KDE, eftersom tdesvn-build ikke kan udføre inkrementel bygning.</para>
>Dette tilvalg accepterer et sæt værdier adskilte af mellemrum, hvor den første værdi er miljøvariabel at sætte, og følgende værdier er hvad du vil sætte variabelen til. For eksempel for at sætte variablen ANDERS til AND, ville du skrive følgende kommando i det dertil passende afsnit:</para>
<screen
><command
>set-env</command
> <envar
>ANDERS</envar
> <userinput
>AND</userinput
></screen>
<para
>Dette tilvalg er specielt på den måde at det kan gentages uden at sætte tidligere indstillinger ud af kraft med set-env i samme afsnit af indstillingsfilen. På den måde du angive mere end en miljøvariabel pr modul (eller globalt).</para>
</entry>
</row>
<row id="conf-source-dir">
<entry
>source-dir</entry>
<entry
>Kan ikke sættes udf af kraft</entry>
<entry
>Dette tilvalg bruges til at angive mappen på maskinen hvor &kde;'s &svn;-kildekode skal opbevares. Hvis du ikke angiver denne værdi, er standardværdien <filename class="directory"
>. Hvis du angiver denne værdi, brug en absolut søgesti. </entry>
</row>
<row id="conf-svn-server">
<entry
>svn-server</entry>
<entry
>Kan ikke sættes udf af kraft</entry>
<entry
>Dette tilvalg bruges til at angive serveren som bruges ved udtjekning fra &svn;. Standard er det anonyme &svn;-arkiv, <emphasis
>svn://anonsvn.kde.org/</emphasis
>.</entry>
</row>
<row id="conf-stop-on-failure">
<entry
>stop-on-failure</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Sæt denne tilvalgsværdi til <quote
>true</quote
> for at gøre at scriptet holder op med at køre efter en fejl opstår i bygge- eller installationsprocessen. Dette tilvalg er normalt slået fra. </entry>
</row>
<row id="conf-tag">
<entry
>tag</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
><para
>Brug dette tilvalg for at hente en specifik udgave af et modul.</para>
<para
><emphasis
>Bemærk:</emphasis
> Der er høje odds for at du IKKE ØNSKER at bruge dette tilvalg. KDE-udgaver er tilgængelige på arkivform fra <ulink url="ftp://ftp.kde.org/"
>KDE's FTP-sted</ulink
> eller et af dets <ulink url="http://download.kde.org/download.php"
>Hvis du bruger tdesvn-build fordi du har svært ved at få fat på en KDE-udgave at bygge på din distribution, så overvej at bruge byggeværktøjet <ulink url="http://developer.kde.org/build/konstruct/"
> tilstand med kildemappe adskilt fra byggemappe. Når det er aktiveret, kopierer &tdesvn-build; qt-copy's kildekodemodul til byggemappen, og udfører byggeprocessen derfra. Det betyder at miljøvariablen QTDIR i stedet skal være indstillet til <filename class="directory"
>. Du skal også ændre tilvalget <link linkend="conf-qtdir"
>qtdir</link
> på tilsvarende måde. At bygge inkrementelt skulle stadigvæk virke i denne tilstand, eftersom tidsstempler bevaras efter kopieringen. Hvis du bruger tilvalget <link linkend="conf-apply-qt-patches"
>apply-qt-patches</link
>, udføres programrettelserne i byggemappen, ikke i kildekodemappen. Tilvalgets standardværdi er <quote
>true</quote
>. </entry>
</row>
<row id="conf-use-unsermake">
<entry
>use-unsermake</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
><para
>Sæt dette tilvalg til <quote
>true</quote
> for at bruge det eksperimentelle program unsermake i stedet for automake når scriptet configure køres. Det kan forårsage væsentlig mindskning af byggetiden, især for <ulink url="http://www.csh.rit.edu/slashdot/distcc.html"
>Normalt, hvis du bruger dette tilvalg kommer tdesvn-build automatisk til at holde unsermake opdateret. Det kan begynde at blive irriterende, især hvis du håndterer unsermake selv. Hvis dette er tilfældet, kan du sætte tilvalget til <quote
>Scriptet bruger ikke miljøvariabler. Hvis du behøver at sætte miljøvariabler for bygge- eller installationsprocessen, så se tilvalget <link linkend="conf-set-env"
>set-env</link
>. </para>
<para
>Scriptet accepterer følgende kommandolinjeflag: </para>
<variablelist>
<varlistentry id="cmdline-help">
<term
><option
>--help</option
></term>
<listitem
><para
>vis kun simpel hjælp om scriptet. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-version">
<term
><option
>---version</option
></term>
<listitem
><para
>vis programmets version. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-author">
<term
><option
>--author</option
></term>
<listitem
><para
>vis forfatterens kontaktinformation. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-color">
<term
><option
>--color</option
></term>
<listitem
><para
>aktivér farvelagt uddata. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-no-color">
<term
><option
>--no-color</option
></term>
<listitem
><para
>deaktivér farvelagt uddata. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-pretend">
<term
><option
>--pretend</option
> (eller <option
>-p</option
>)</term>
<listitem
><para
>udfører IKKE noget, men opfør sig som om du gjorde det. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-quiet">
<term
><option
>--quiet</option
> (eller <option
>-q</option
>)</term>
<listitem
><para
>Vær ikke så støjende med uddata. Med dette flag meddeles kun det vigtigste. </para
>inkludér ikke moduler som sendes på resten af kommandolinjen under opdaterings- og byggeprocessen. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-no-svn">
<term
><option
>--no-svn</option
></term>
<listitem
><para
>spring over at kontakte &svn;-serveren. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-no-build">
<term
><option
>--no-build</option
></term>
<listitem
><para
>spring over byggeprocessen. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-no-install">
<term
><option
>--no-install</option
></term>
<listitem
><para
>installér ikke automatisk pakker efter de er bygget. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-debug">
<term
><option
>--debug</option
></term>
<listitem
><para
>aktiverer fejlsøgningstilstand for scriptet. For øjeblikket betyder det at al uddata sendes til STDOUT foruden at logges i logmappen som sædvanligt. Desuden er mange funktioner meget udførligere om hvad de gør i fejlsøgningstilstand. </para
>forsøg ikke at genbygge moduler som det er mislykket at bygge fra begyndelsen. &tdesvn-build; forsøger aldrig at gøre dette med et modul hvor et forsøg på at bygge fra begyndelsen allerede er gjort. </para
>genopret om byggesystemet og byg fra grunden. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-reconfigure">
<term
><option
>--reconfigure</option
></term>
<listitem
><para
>kør scriptet configure igen uden at rense byggemappen. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-recreate-configure">
<term
><option
>--recreate-configure</option
></term>
<listitem
><para
>kør <command
>make <option
>-f</option
> Makefile.cvs</command
> igen for at oprette scriptet configure, og fortsæt med at bygge som sædvanligt. Dette tilvalg implicerer <option
><link linkend="cmdline-reconfigure"
>--reconfigure</link
></option
>. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-resume">
<term
><option
>--resume</option
></term>
<listitem
><para
>som forsøger at fortsætte med at bygge fra stedet hvor scriptet sluttede sidste gangen. Scriptet begynder at bygge modulet efter det seneste modul som kompileredes sidst da scriptet kørtes, havd enten det lykkedes eller ej. Dette tilvalg implicerer <link linkend="cmdline-no-svn"
><option
>--no-svn</option
></link
>. Du bør ikke angive andre modulnavne på kommandolinjen. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-resume-from">
<term
><option
>--resume-from</option
></term>
<listitem
><para
>som er ligesom <link linkend="cmdline-resume"
><option
>--resume</option
></link
>, bortset fra at du angiver modulet hvor byggeprocessen skal begynde som næste parameter på kommandolinjen. Alternativet implicerer <link linkend="cmdline-no-svn"
><option
>--no-svn</option
></link
>. Du bør ikke angive andre modulnavne på kommandolinjen. </para
>. Scriptet configure skal stadigvæk køres, hvilket &tdesvn-build; gør næste gang. Dette lader dig forberede alle configure-scripter på en gang så du kan kigge på <command
> for hvert modul, og redigere dine flag til configure i overensstemmelse med dette. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-install"
><term
><option
>--install</option
></term>
<listitem
><para
>hvis dette er det eneste kommandolinjeflag, forsøger scriptet at installere alle moduler som det er lykkedes at bygge, bortset fra qt-copy som ikke behøver at installeres. Hvis kommandolinjeflag angives efter <option
>--install</option
>, antages de alle at være moduler at installere. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-global-option">
<term
><option
>--<option-name>=</option
></term>
<listitem
><para
>Du kan bruge dette tilvalg til at sætte et tilvalg i din indstillingsfil ud af kraft for hvert modul. For eksempel for at sætte tilvalget <link linkend="conf-log-dir"
>log-dir</link
> ud af kraft, skulle du angive <option
>--log-dir=/søgesti/til/mappe</option
>. </para
></listitem>
</varlistentry>
<varlistentry id="cmdline-module-option">
<term
><option
>--<modulnavn>,<tilvalgnavn>=</option
></term>
<listitem
><para
>Du kan bruge dette flag til at sætte et tilvalg i indstillingsfilen for et vist modul ud af kraft. For eksempel for at sætte tilvalget <link linkend="conf-use-unsermake"
