From fff371d8d9ed1ea3b1c771fbc07f95a12658e723 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sl=C3=A1vek=20Banko?= Date: Mon, 16 Nov 2020 19:35:41 +0100 Subject: Move the tdesvn-build manual to the directory level in which it is installed. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Slávek Banko --- .../tdesdk/scripts/tdesvn-build/CMakeLists.txt | 6 - .../docs/tdesdk/scripts/tdesvn-build/Makefile.am | 4 - .../docs/tdesdk/scripts/tdesvn-build/index.docbook | 739 --------------------- .../docs/tdesdk/tdesvn-build/CMakeLists.txt | 6 + tde-i18n-da/docs/tdesdk/tdesvn-build/Makefile.am | 4 + tde-i18n-da/docs/tdesdk/tdesvn-build/index.docbook | 739 +++++++++++++++++++++ .../tdesdk/scripts/tdesvn-build/CMakeLists.txt | 6 - .../docs/tdesdk/scripts/tdesvn-build/Makefile.am | 4 - .../docs/tdesdk/scripts/tdesvn-build/index.docbook | 739 --------------------- .../docs/tdesdk/tdesvn-build/CMakeLists.txt | 6 + tde-i18n-de/docs/tdesdk/tdesvn-build/Makefile.am | 4 + tde-i18n-de/docs/tdesdk/tdesvn-build/index.docbook | 739 +++++++++++++++++++++ .../tdesdk/scripts/tdesvn-build/CMakeLists.txt | 6 - .../docs/tdesdk/scripts/tdesvn-build/Makefile.am | 4 - .../docs/tdesdk/scripts/tdesvn-build/index.docbook | 739 --------------------- .../docs/tdesdk/tdesvn-build/CMakeLists.txt | 6 + tde-i18n-es/docs/tdesdk/tdesvn-build/Makefile.am | 4 + tde-i18n-es/docs/tdesdk/tdesvn-build/index.docbook | 739 +++++++++++++++++++++ .../tdesdk/scripts/tdesvn-build/CMakeLists.txt | 6 - .../docs/tdesdk/scripts/tdesvn-build/Makefile.am | 4 - .../docs/tdesdk/scripts/tdesvn-build/index.docbook | 739 --------------------- .../docs/tdesdk/tdesvn-build/CMakeLists.txt | 6 + tde-i18n-et/docs/tdesdk/tdesvn-build/Makefile.am | 4 + tde-i18n-et/docs/tdesdk/tdesvn-build/index.docbook | 739 +++++++++++++++++++++ .../tdesdk/scripts/tdesvn-build/CMakeLists.txt | 6 - .../docs/tdesdk/scripts/tdesvn-build/Makefile.am | 4 - .../docs/tdesdk/scripts/tdesvn-build/index.docbook | 739 --------------------- .../docs/tdesdk/tdesvn-build/CMakeLists.txt | 6 + tde-i18n-it/docs/tdesdk/tdesvn-build/Makefile.am | 4 + tde-i18n-it/docs/tdesdk/tdesvn-build/index.docbook | 739 +++++++++++++++++++++ .../tdesdk/scripts/tdesvn-build/CMakeLists.txt | 6 - .../docs/tdesdk/scripts/tdesvn-build/Makefile.am | 4 - .../docs/tdesdk/scripts/tdesvn-build/index.docbook | 739 --------------------- .../docs/tdesdk/tdesvn-build/CMakeLists.txt | 6 + tde-i18n-pt/docs/tdesdk/tdesvn-build/Makefile.am | 4 + tde-i18n-pt/docs/tdesdk/tdesvn-build/index.docbook | 739 +++++++++++++++++++++ .../tdesdk/scripts/tdesvn-build/CMakeLists.txt | 6 - .../docs/tdesdk/scripts/tdesvn-build/Makefile.am | 4 - .../docs/tdesdk/scripts/tdesvn-build/index.docbook | 739 --------------------- .../docs/tdesdk/tdesvn-build/CMakeLists.txt | 6 + .../docs/tdesdk/tdesvn-build/Makefile.am | 4 + .../docs/tdesdk/tdesvn-build/index.docbook | 739 +++++++++++++++++++++ .../tdesdk/scripts/tdesvn-build/CMakeLists.txt | 6 - .../docs/tdesdk/scripts/tdesvn-build/Makefile.am | 4 - .../docs/tdesdk/scripts/tdesvn-build/index.docbook | 688 ------------------- .../docs/tdesdk/tdesvn-build/CMakeLists.txt | 6 + tde-i18n-sv/docs/tdesdk/tdesvn-build/Makefile.am | 4 + tde-i18n-sv/docs/tdesdk/tdesvn-build/index.docbook | 688 +++++++++++++++++++ 48 files changed, 5941 insertions(+), 5941 deletions(-) delete mode 100644 tde-i18n-da/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt delete mode 100644 tde-i18n-da/docs/tdesdk/scripts/tdesvn-build/Makefile.am delete mode 100644 tde-i18n-da/docs/tdesdk/scripts/tdesvn-build/index.docbook create mode 100644 tde-i18n-da/docs/tdesdk/tdesvn-build/CMakeLists.txt create mode 100644 tde-i18n-da/docs/tdesdk/tdesvn-build/Makefile.am create mode 100644 tde-i18n-da/docs/tdesdk/tdesvn-build/index.docbook delete mode 100644 tde-i18n-de/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt delete mode 100644 tde-i18n-de/docs/tdesdk/scripts/tdesvn-build/Makefile.am delete mode 100644 tde-i18n-de/docs/tdesdk/scripts/tdesvn-build/index.docbook create mode 100644 tde-i18n-de/docs/tdesdk/tdesvn-build/CMakeLists.txt create mode 100644 tde-i18n-de/docs/tdesdk/tdesvn-build/Makefile.am create mode 100644 tde-i18n-de/docs/tdesdk/tdesvn-build/index.docbook delete mode 100644 tde-i18n-es/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt delete mode 100644 tde-i18n-es/docs/tdesdk/scripts/tdesvn-build/Makefile.am delete mode 100644 tde-i18n-es/docs/tdesdk/scripts/tdesvn-build/index.docbook create mode 100644 tde-i18n-es/docs/tdesdk/tdesvn-build/CMakeLists.txt create mode 100644 tde-i18n-es/docs/tdesdk/tdesvn-build/Makefile.am create mode 100644 tde-i18n-es/docs/tdesdk/tdesvn-build/index.docbook delete mode 100644 tde-i18n-et/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt delete mode 100644 tde-i18n-et/docs/tdesdk/scripts/tdesvn-build/Makefile.am delete mode 100644 tde-i18n-et/docs/tdesdk/scripts/tdesvn-build/index.docbook create mode 100644 tde-i18n-et/docs/tdesdk/tdesvn-build/CMakeLists.txt create mode 100644 tde-i18n-et/docs/tdesdk/tdesvn-build/Makefile.am create mode 100644 tde-i18n-et/docs/tdesdk/tdesvn-build/index.docbook delete mode 100644 tde-i18n-it/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt delete mode 100644 tde-i18n-it/docs/tdesdk/scripts/tdesvn-build/Makefile.am delete mode 100644 tde-i18n-it/docs/tdesdk/scripts/tdesvn-build/index.docbook create mode 100644 tde-i18n-it/docs/tdesdk/tdesvn-build/CMakeLists.txt create mode 100644 tde-i18n-it/docs/tdesdk/tdesvn-build/Makefile.am create mode 100644 tde-i18n-it/docs/tdesdk/tdesvn-build/index.docbook delete mode 100644 tde-i18n-pt/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt delete mode 100644 tde-i18n-pt/docs/tdesdk/scripts/tdesvn-build/Makefile.am delete mode 100644 tde-i18n-pt/docs/tdesdk/scripts/tdesvn-build/index.docbook create mode 100644 tde-i18n-pt/docs/tdesdk/tdesvn-build/CMakeLists.txt create mode 100644 tde-i18n-pt/docs/tdesdk/tdesvn-build/Makefile.am create mode 100644 tde-i18n-pt/docs/tdesdk/tdesvn-build/index.docbook delete mode 100644 tde-i18n-pt_BR/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt delete mode 100644 tde-i18n-pt_BR/docs/tdesdk/scripts/tdesvn-build/Makefile.am delete mode 100644 tde-i18n-pt_BR/docs/tdesdk/scripts/tdesvn-build/index.docbook create mode 100644 tde-i18n-pt_BR/docs/tdesdk/tdesvn-build/CMakeLists.txt create mode 100644 tde-i18n-pt_BR/docs/tdesdk/tdesvn-build/Makefile.am create mode 100644 tde-i18n-pt_BR/docs/tdesdk/tdesvn-build/index.docbook delete mode 100644 tde-i18n-sv/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt delete mode 100644 tde-i18n-sv/docs/tdesdk/scripts/tdesvn-build/Makefile.am delete mode 100644 tde-i18n-sv/docs/tdesdk/scripts/tdesvn-build/index.docbook create mode 100644 tde-i18n-sv/docs/tdesdk/tdesvn-build/CMakeLists.txt create mode 100644 tde-i18n-sv/docs/tdesdk/tdesvn-build/Makefile.am create mode 100644 tde-i18n-sv/docs/tdesdk/tdesvn-build/index.docbook diff --git a/tde-i18n-da/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt b/tde-i18n-da/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt deleted file mode 100644 index 1c21e4471ed..00000000000 --- a/tde-i18n-da/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt +++ /dev/null @@ -1,6 +0,0 @@ -# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer - -tde_create_handbook( - DESTINATION tdesvn-build - LANG da -) diff --git a/tde-i18n-da/docs/tdesdk/scripts/tdesvn-build/Makefile.am b/tde-i18n-da/docs/tdesdk/scripts/tdesvn-build/Makefile.am deleted file mode 100644 index 589a6589189..00000000000 --- a/tde-i18n-da/docs/tdesdk/scripts/tdesvn-build/Makefile.am +++ /dev/null @@ -1,4 +0,0 @@ -KDE_LANG = da -SUBDIRS = $(AUTODIRS) -KDE_DOCS = tdesvn-build -KDE_MANS = AUTO diff --git a/tde-i18n-da/docs/tdesdk/scripts/tdesvn-build/index.docbook b/tde-i18n-da/docs/tdesdk/scripts/tdesvn-build/index.docbook deleted file mode 100644 index 921c37058ec..00000000000 --- a/tde-i18n-da/docs/tdesdk/scripts/tdesvn-build/index.docbook +++ /dev/null @@ -1,739 +0,0 @@ - - - - - - Subversion"> - tdesvn-build"> -]> - - - - -Håndbog for scriptet &tdesvn-build; - - -MichaelPyne
michael.pyne@kdemail.net
 - -CarlosWoelz
carloswoelz@imap-mail.com
 - - - -&erik.kjaer.pedersen.role; - - - - -2005 -Michael Pyne - - - -2005 -Carlos Woelz - - - -&FDLNotice; - -2005-06-18 -0.98 - - -&tdesvn-build; er et Perl-script som bygger og installerer &kde;, direkte fra kildekoden som hentes fra &kde;'s &svn;-arkiv. - - - -KDE -tdesdk -SVN -Subversion -KDE-udvikling - - - - - - -Indledning - -&tdesvn-build; er et Perl-script som hjælper brugere at installere &kde; fra &svn;. Du vil måske også overveje bruge scriptet kde-build, som er inkluderet i &kde;'s tdesdk-modul. - -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;. - - - - -Sådan kommer vi i gang - -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. - -Alle emner som præsenteres i dette kapitel dækkes med endnu flere detaljer i guiden Building &kde; from Source Step by Step Guide på hjemmesiden for &kde;'s kvalitetsgruppe. 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. - - -Forbered systemet til at bygge &kde; - -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. - -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. - -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 KDE kompileringskrav). Du kan oftest få værktøjerne pakkede for dit system fra din distribution eller leverandør. - -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 Building &kde; from Source Step by Step har flere detaljer om specifikke værktøjer og tekniker som bruges til at installere og finde programmellet som kræves. - -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 .tdesvn-buildrc. 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 tdesvn-buildrc-sample. Du finder mere information om indstillingsfilens syntaks i og i . - -En god måde at hente seneste version er at gå til siden tdesdk/scripts på websvn.kde.org. 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 tdesvn-buildrc-sample. Gør scriptet kørbart, og sørg for at der er i din søgesti. - - - - -Angiv indstillingsinformation - -For at bruge scriptet skal du have en fil i din hjemmemappe som hedder .tdesvn-buildrc, som indstiller generelle tilvalg og angiver modulerne som du vil hente og bygge. - -Brug filen tdesvn-buildrc-sample som en skabelon, for at indstille globale tilvalg og modulerne du vil bygge. - -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 svn://anonsvn.kde.org/ er standard, men lav det om du har en &kde; &svn;-konto, eller hvis der er et spejl tæt ved dig. - -Vær særlig opmærksom på de globale variabler tdedir og qtdir, eftersom den første angiver hvor det byggede &kde; skal installeres (normalt i ~/kde), og den anden hvor (og om) Qt-biblioteket skal bygges og installeres (normalt ~/tdesvn/build/qt-copy). Du skal kende stederne for tdedir 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 tdesvn-buildrc-sample bør være tilstrækkelige for at få en nogenlunde komplet installation af &kde;. Gem resultatet som .tdesvn-buildrc i din hjemmemappe. - -Hvis du vil finjustere .tdesvn-buildrc, kig så på for detaljeret information om alle indstillingstilvalg. - - - - -At bruge scriptet &tdesvn-build; - -Nu er du parat til at køre scriptet. Log ind til brugeren som du bruger for at kompilere &kde; i et terminalvindue, og kør scriptet: %su udviklings-brugernavn -%tdesvn-build - - - -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 Building &kde; from Source Step by Step. - - - - -Opsætning af miljøet for at køre den friske &kde; - -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. - -Åbn eller oprette filen .bash_profile i hjemmemappen med din favoriteditor, og tilføj følgende i slutningen af filen: -TDEDIR=(søgesti til tdedir) -TDEDIRS=$TDEDIR -PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH -LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH -export TDEDIRS PATH LD_LIBRARY_PATH - hvis du bygger modulet qt-copy, tilføj i stedet: TQTDIR=(søgesti til qtdir) -TDEDIR=(søgesti til tdedir) -TDEDIRS=$TDEDIR -PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH -MANPATH=$TQTDIR/doc/man:$MANPATH -LD_LIBRARY_PATH=$TDEDIR/lib:$TQTDIR/lib:$LD_LIBRARY_PATH -export TQTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH - - - -Hvis du ikke bruger en særlig bruger, idstillesn en anderledes $TDEHOME for det nye miljø i din .bash_profile: export TDEHOME="${HOME}/.tde-svn" - -# Opret hvis det behøves -[ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn - - - - -Hvis menuen senere er tom eller for fyldt med programmer fra din distribution, skal du måske indstille miljøvariablen xdg i .bash_profile: XDG_CONFIG_DIRS="/etc/xdg" -XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" -export XDG_CONFIG_DIRS XDG_DATA_DIRS - - - - - -Nu når vi er færdige med dette skal du sørge for at det rette starttde script bliver brugt: - -Åbn tekstfilen .xinitrc (eller .xsession, afhængig af distribution) i hjemmemappen, eller opret det hvis det behøves. Tilføj linjen: exec ${TDEDIR}/bin/starttde - - - -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. - -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: - -startx -- :1 - - - -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. - - - - - - - - -Scriptets funktioner - -Funktionerne i &tdesvn-build; omfatter: - - - - -Tjekker automatisk ud eller opdaterer moduler fra &svn;, ifølge hvad som er passende. - -Beregner tiden for at bygge moduler. - -Forsøger automatisk at genbygge moduler som bruger en inkrementel byggeproces, hvilket tenderer at mislykkes efter visse typer af indtjekninger. - -Kan genoptage et tidligere script, eller starte byggeprocessen fra en bestemt modul. - -Levereres med et indbygget rimeligt sæt standardtilvalg passende til at bygge en grundlæggende enbrugerinstallation af &kde; fra det anonyme &svn;-arkivet. - -Levereres med understøttelse for Unsermake. - -Ekspanderer dine indstillingstilvalg med tilde. Du kan for eksempel angive: qtdir ~/tdesvn/build/qt-copy - - -Indstillelige bygge-, kildekode-, og logningsmapper - -Sætter automatisk et byggesystem op, med kildekodemappen adskilt fra byggemappen for at holde kildekodemappen uberørt. Undtagelsen er qt-copy, som ikke er konstrueret til at bygges sådan (hvis du ikke vil prøve QT med separat byggemappe). - -Du kan angive globale tilvalg at bruge for alle moduler som tjekkes ud, og du kan desuden angive tilvalg som skal bruges for enkelte moduler. - -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 . - -Du kan angive diverse miljøvariabler som skal bruges under byggeprocessen, inklusive TDEDIR, TQTDIR, DO_NOT_COMPILE og CXXFLAGS. - -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. - -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 system() flitigt, så jeg anbefaler for øjeblikket ikke at køre den som systemadministrator. - -Du kan bruge make-install-prefix til at indlede byggekommandolinjen med en separat kommando, hvilket er nyttigt for sudo. - -Du kan bruge tilvalget apidox for automatisk at bygge og installere dokumentation om programmeringsgrænsefladen for visse moduler. - -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 taglib ud fra tdesupport, eller kun K3B fra extragear/multimedia. Scriptet henter automatisk kde-common hvis det behøves for at få byggeprocessen til at fungere. - -Du kan lade som om du udfører handlingen. Hvis du sender med eller på kommandolinjen, giver scriptet en meget udførlig beskrivelse af de kommandoer som skal gøres, uden i virkeligheden at udføre dem. - -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 module-base-path. - - - -Ting som &tdesvn-build; IKKE gør: - - - -Finde det hurtigste spejl for &kde; &svn;. Der er ikke engang en liste medsendt med scriptet for øjeblikket, selvom standardserveren skulle virke godt. - -Børste dine tænder. Du skal huske at gøre det selv. - -Desværre er scriptet formodentlig ikke fejlfrit. - - - - - - -Formatet for .tdesvn-buildrc - -For at bruge scriptet skal du have en fil i din hjemmemappe som hedder .tdesvn-buildrc, som beskriver modulerne som du vil hente og bygge. - - - -Det begynder med globale tilvalg, angivne som følger: - -global -tilvalg-navn tilvalg-værdi -[...] -end global - - -De følges derefter af en eller flere modulsektioner, angivne på følgende måde: - -module modul-navn -tilvalg-navn tilvalg-værdi -[...] -end module - - -modul-navn 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. - -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 ovenfor. - - -apidox, for at bygge dokumentation over programmeringsgrænsefladen -apply-qt-patches, for at forbedre qt-copy -binpath, for at indstille variablen PATH. -branch, for at tjekke ud fra en gren i stedet for /trunk. -build-dir, for at angive mappe at bygge i. -checkout-only, for kun at tjekke dele af et modul ud. -colorful-output for at tilføje farve til scriptets uddata. -configure-flags for at angive hvilke flag et modul skal indstilles med. -cxxflags for at definere variablen CXXFLAGS. -dest-dir for at ændre mappenavn for et modul. -disable-agent-check, for at forhindre at tdesvn-build kontrollerer SSH-agentens status. -do-not-compile, for at markere mapper så de springes over af byggeprocessen. -inst-apps, for at kun bygge og installere visse mapper. -install-after-build, for at undgå at installere efter byggeprocessen. -tdedir, for at angive mappe at installere KDE i. -libpath, for at sætte variablen LD_LIBRARY_PATH. -make-install-prefix, for at køre et hjælpeprogram (såsom sudo) under installationen. -make-options, for at sende flag til byggeprogrammet. -manual-build, for at undgå at modulet bygges automatisk. -manual-update, for at undgå at noget gøres automatisk med modulet. -module-base-path, for at ændre hvorfra modulet hentes. (nyttigt for grene og mærker). -niceness, for at ændre processorprioriteten. -no-rebuild-on-fail, for at undgå at køre byggeprocessen om igen hvis den mislykkes. -qtdir, for at angive søgesti til Qt. -set-env, for at sætte en miljøvariabel. -source-dir, for at ændre hvor kildekoden hentes. -stop-on-failure, for at få .tdesvn-build at stoppe så snart en alvorlig fejl findes. -svn-server, for at ændre serveren som kildekoden automatisk hentes fra. -use-qt-builddir-hack, for at give Qt en separat byggemappe fra kildekoden, såsom KDE. -use-unsermake, for at bruge det avancerede byggesystem unsermake. - - - -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. - - -Tilvalgstabel - - - - -Tilvalgsnavn -Modul -> global opførsel -Noter - - - - - - -apidox -Sætter global ud af kraft -Sæt dette til true 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 make apidox gør noget, inklusive , blandt andet tdelibs, tdebase og koffice. - - - -apply-qt-patches -Sætter global ud af kraft -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. - - - -binpath -Kan ikke sættes udf af kraft -Sæt dette for at bruge miljøvariablen PATH under byggeprocessen. Du kan ikke dette ud af kraft i et modultilvalg. Standatdværdi er /bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin. Miljøvariablen skal indeholde søgestier til udviklingsværktøjerne adskilte med kolon. Søgestierne $TDEDIR/bin og $TQTDIR/bin tilføjes automatisk. Du kan bruge tilde (~) for eventuelle søgestier du tilføjer med dette tilvalg. - - - - -branch -Sætter global ud af kraft -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". -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. -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 override-url. - - - - -build-dir -Sætter global ud af kraft -Brug dette for at skifte mappen som indeholder kildekoden at bygge. Der er tre forskellige måder at bruge det: Relativt til &kde;:&svn;-kildekodemappe (se tilvalget source-dir). 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 (/).Standardværdi er buildAbsolut søgesti. Hvis du angiver en søgesti som begynder med /, bruges søgestien direkte. For eksempel /tmp/kde-obj-dir/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 ~/builddir indstille byggemappen til /home/brugernavn/builddir Dette kan, måske noget uventet, ændres pr modul. - - - -checkout-only -Sætter global ud af kraft -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. - - - -configure-flags -Tilføjer globale tilvalg (undtagen for qt-copy) -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 sætter de globale indstillinger ud af kraft når det bruges for qt-copy. - - - -colorful-output -Kan ikke sættes udf af kraft -Sæt dette tilvalg til false for at deaktivere farvelagt uddata fra &tdesvn-build;. Dette tilvalg er normalt true. Bemærk at &tdesvn-build; ikke sender farvekoderne ud til noget andet end en terminal (såsom xterm, &konsole; eller den normale Linux-konsol). - - - -cxxflags -Tilføjer til globale tilvalg -Brug dette tilvalg for at angive hvilke flag som skal sendes til ./configure som CXXFLAGS når byggesystemet for modulet laves. Dette tilvalg angives her i stedet for med configure-flags eftersom tilvalget også sætter miljøvariablen CXXFLAGS under byggprocessen. - - - -dest-dir -Sætter global ud af kraft -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. - - - -disable-agent-check -Kan ikke sættes udf af kraft -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. - - - -do-not-compile -Sætter global ud af kraft -Brug dette tilvalg for at sætte miljøvariablen DO_NOT_COMPILE inden scriptet configure køres. Ifølge &kde;'s ofte stillede spørgsmål for udviklere, skal det gøre at alle topniveaumapper du sender med ikke bygges. Katalogerne skal adskilles med mellemrum. - -Bemærk at kildekoden for programmerne stadigvæk hentes. Du kan bruge direktivet checkout-only for at vælge mapper som du vil tjekke ud. - - - - -email-address -Kan ikke sættes udf af kraft - -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). - -For øjeblikket behøver kun email-on-compile-error tilvalget. - - - - -email-on-compile-error -Kan ikke sættes udf af kraft - -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. - -Se tilvalget email-address for at indstille adressen som tdesvn-build skal sende fra, eftersom standardværdien som oftest ikke er hvad du vil have. - - - - -inst-apps -Sætter global ud af kraft -Dette er modsætningen til tilvalget do-not-compile. Dette tilvalg gør at kun angivne topniveaumapper bygges. Katalogerna skal adskilles med mellemrum. - -Eventuelle ændringer får ingen virkning førend næste gang make Makefile.cvs køres, enten automatisk af scriptet, eller manuelt med tilvalgene eller . - -Bemærk at kildekoden for programmerne stadigvæk hentes. Du kan bruge direktivet checkout-only for at vælge mapper som du vil tjekke ud. - - - - -install-after-build -Sætter global ud af kraft -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 . - - - -tdedir -Kan ikke sættes udf af kraft -Dette tilvalg angiver mappen som &kde; installeres i efter det er bygget. Standardværdien er ~/kde. Hvis du ændrer det til en mappe som kræver adgang som systemadministrator, bør du også læse om tilvalget make-install-prefix. - - - -libpath -Kan ikke sættes udf af kraft -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 $TDEDIR/lib og $TQTDIR/lib tilføjes automatisk. Du kan bruge tilde (~) i alle søgestier du tilføjer med dette tilvalg. - - - -log-dir -Sætter global ud af kraft -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. - - - -make-install-prefix -Sætter global ud af kraft -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. - - - -make-options -Sætter global ud af kraft -Angiv denne variabel for at sende kommandolinjeflag til kommandoen make. Dette er nyttigt for programmer såsom distcc. Programmet distcc lader dig opdele dit kompileringsarbejde på mere end en maskine. For at bruge det, skal du bruge flaget 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 i mit tilfælde. - - - -manual-build -Sætter global ud af kraft -Sæt tilvalgsværdien til true 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 . - - - -manual-update -Sætter global ud af kraft -Sæt tilvalgsværdien til true 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. - - - -module-base-path -Sætter global ud af kraft -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. &kde;'s kildekodevisning er uvurderlig som hjælp til at vælge rette søgesti. -Bemærk at &tdesvn-build; konstruerer den endelige søgesti efter følgende skabelon: $svn-server/home/kde/$module-base-path/$module-name. -Standardværdien er enten trunk eller trunk/KDE, afhængig af modulnavnet. - - - - -niceness -Kan ikke sættes udf af kraft -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. - - - -no-rebuild-on-fail -Sætter global ud af kraft -Indstil denne tilvalgsværdi til true 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. - - - -override-url -Sætter global ud af kraft -Hvis du angiver dette tilvalg, bruger tdesvn-build dets værdi som URL at sende til Subversion helt uforandret. 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 branch. - - - -qtdir -Kan ikke sættes udf af kraft -Sæt dette tilvalg for at bruge miljøvariablen TQTDIR under byggeprocessen. Du kan ikke sætte dette tilvalg ud af kraft i et modultilvalg. Standardværdi er $(source-dir)/build/qt-copy, som bruger modulet qt-copy som indgår i &kde;:s kildekodearkiv. Du kan bruge tilde (~) til at repræsentere din hjemmemappe. - - - -remove-after-install -Sætter global ud af kraft -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. -Mulige værdier for dette tilvalg er: -none - Slet ikke bort noget (dette er standardværdien). -builddir - Slet byggemappen men ikke kildekoden. -all - Slet både kildekoden og byggemappen. - - - -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. - - - - -set-env -Sætter global ud af kraft -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: -set-env ANDERS AND -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). - - - - -source-dir -Kan ikke sættes udf af kraft -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 ~/tdesvn. Hvis du angiver denne værdi, brug en absolut søgesti. - - - -svn-server -Kan ikke sættes udf af kraft -Dette tilvalg bruges til at angive serveren som bruges ved udtjekning fra &svn;. Standard er det anonyme &svn;-arkiv, svn://anonsvn.kde.org/. - - - -stop-on-failure -Sætter global ud af kraft -Sæt denne tilvalgsværdi til true 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. - - - -tag -Sætter global ud af kraft -Brug dette tilvalg for at hente en specifik udgave af et modul. -Bemærk: Der er høje odds for at du IKKE ØNSKER at bruge dette tilvalg. KDE-udgaver er tilgængelige på arkivform fra KDE's FTP-sted eller et af dets spejle. -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 Konstruct i stedet for, som virker ud fra de udgivne tar-bolde. - - - - -use-qt-builddir-hack -Sætter global ud af kraft -Selvom dette tilvalg sætter det globale tilvalg ud af kraft, giver det kun mening for qt-copy. Sæt dette tilvalg til true for at aktivere scriptets eksperimentelle 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 TQTDIR i stedet skal være indstillet til $(qt-copy-build-dir)/qt-copy/lib. Du skal også ændre tilvalget qtdir på tilsvarende måde. At bygge inkrementelt skulle stadigvæk virke i denne tilstand, eftersom tidsstempler bevaras efter kopieringen. Hvis du bruger tilvalget apply-qt-patches, udføres programrettelserne i byggemappen, ikke i kildekodemappen. Tilvalgets standardværdi er true. - - - -use-unsermake -Sætter global ud af kraft -Sæt dette tilvalg til true 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 distribuerede byggesystem. Tilvalgets standardværdi er true (for de fleste moduler). - -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 self, så bruger tdesvn-build stadigvæk unsermake, men gør ingenting særligt for at holde det opdateret. - - - - - - -
- - - - -Kommandolinjeflag og miljøvariabler - -Scriptet bruger ikke miljøvariabler. Hvis du behøver at sætte miljøvariabler for bygge- eller installationsprocessen, så se tilvalget set-env. - -Scriptet accepterer følgende kommandolinjeflag: - - - - - -vis kun simpel hjælp om scriptet. - - - - -vis programmets version. - - - - -vis forfatterens kontaktinformation. - - - - -aktivér farvelagt uddata. - - - - -deaktivér farvelagt uddata. - - - - (eller ) -udfører IKKE noget, men opfør sig som om du gjorde det. - - - - (eller ) -Vær ikke så støjende med uddata. Med dette flag meddeles kun det vigtigste. - - - - -Kun advarsler og fejl. - - - - -Beskriv i detalje hvad der sker, og hvad tdesvn-build gør. - - - - -udfører kun opdatering af kildekoden. - - - - -udfører kun byggeprocessen. - - - - -inkludér ikke moduler som sendes på resten af kommandolinjen under opdaterings- og byggeprocessen. - - - - -spring over at kontakte &svn;-serveren. - - - - -spring over byggeprocessen. - - - - -installér ikke automatisk pakker efter de er bygget. - - - - -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. - - - - -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. - - - - -genopret om byggesystemet og byg fra grunden. - - - - -kør scriptet configure igen uden at rense byggemappen. - - - - -kør make Makefile.cvs igen for at oprette scriptet configure, og fortsæt med at bygge som sædvanligt. Dette tilvalg implicerer . - - - - -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 . Du bør ikke angive andre modulnavne på kommandolinjen. - - - - -som er ligesom , bortset fra at du angiver modulet hvor byggeprocessen skal begynde som næste parameter på kommandolinjen. Alternativet implicerer . Du bør ikke angive andre modulnavne på kommandolinjen. - - - - -som tolker næste kommandolinjeflag som filen at læse indstillingstilvalg fra. Standardværdien for denne parameter er ~/.tdesvn-buildrc. - - - - -som lader dig ændre mappen som &kde; installeres i fra kommandolinjen. Dette tilvalg implicerer . - - - - -stop efter at have kørt make Makefile.cvs. 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å ./configure for hvert modul, og redigere dine flag til configure i overensstemmelse med dette. - - - -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 , antages de alle at være moduler at installere. - - - - -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 log-dir ud af kraft, skulle du angive . - - - - -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 use-unsermake ud af kraft for tdemultimedia, skal du angive . - - - - -Alle øvrige kommandolinjeflag antages at være moduler at opdatere og bygge. Bland helst ikke bygge og installere sammen. - - - - -Medvirkende og licens -&underFDL; - - diff --git a/tde-i18n-da/docs/tdesdk/tdesvn-build/CMakeLists.txt b/tde-i18n-da/docs/tdesdk/tdesvn-build/CMakeLists.txt new file mode 100644 index 00000000000..1c21e4471ed --- /dev/null +++ b/tde-i18n-da/docs/tdesdk/tdesvn-build/CMakeLists.txt @@ -0,0 +1,6 @@ +# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer + +tde_create_handbook( + DESTINATION tdesvn-build + LANG da +) diff --git a/tde-i18n-da/docs/tdesdk/tdesvn-build/Makefile.am b/tde-i18n-da/docs/tdesdk/tdesvn-build/Makefile.am new file mode 100644 index 00000000000..589a6589189 --- /dev/null +++ b/tde-i18n-da/docs/tdesdk/tdesvn-build/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = da +SUBDIRS = $(AUTODIRS) +KDE_DOCS = tdesvn-build +KDE_MANS = AUTO diff --git a/tde-i18n-da/docs/tdesdk/tdesvn-build/index.docbook b/tde-i18n-da/docs/tdesdk/tdesvn-build/index.docbook new file mode 100644 index 00000000000..921c37058ec --- /dev/null +++ b/tde-i18n-da/docs/tdesdk/tdesvn-build/index.docbook @@ -0,0 +1,739 @@ + + + + + + Subversion"> + tdesvn-build"> +]> + + + + +Håndbog for scriptet &tdesvn-build; + + +MichaelPyne
michael.pyne@kdemail.net
 + +CarlosWoelz
carloswoelz@imap-mail.com
 + + + +&erik.kjaer.pedersen.role; + + + + +2005 +Michael Pyne + + + +2005 +Carlos Woelz + + + +&FDLNotice; + +2005-06-18 +0.98 + + +&tdesvn-build; er et Perl-script som bygger og installerer &kde;, direkte fra kildekoden som hentes fra &kde;'s &svn;-arkiv. + + + +KDE +tdesdk +SVN +Subversion +KDE-udvikling + + + + + + +Indledning + +&tdesvn-build; er et Perl-script som hjælper brugere at installere &kde; fra &svn;. Du vil måske også overveje bruge scriptet kde-build, som er inkluderet i &kde;'s tdesdk-modul. + +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;. + + + + +Sådan kommer vi i gang + +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. + +Alle emner som præsenteres i dette kapitel dækkes med endnu flere detaljer i guiden Building &kde; from Source Step by Step Guide på hjemmesiden for &kde;'s kvalitetsgruppe. 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. + + +Forbered systemet til at bygge &kde; + +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. + +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. + +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 KDE kompileringskrav). Du kan oftest få værktøjerne pakkede for dit system fra din distribution eller leverandør. + +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 Building &kde; from Source Step by Step har flere detaljer om specifikke værktøjer og tekniker som bruges til at installere og finde programmellet som kræves. + +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 .tdesvn-buildrc. 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 tdesvn-buildrc-sample. Du finder mere information om indstillingsfilens syntaks i og i . + +En god måde at hente seneste version er at gå til siden tdesdk/scripts på websvn.kde.org. 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 tdesvn-buildrc-sample. Gør scriptet kørbart, og sørg for at der er i din søgesti. + + + + +Angiv indstillingsinformation + +For at bruge scriptet skal du have en fil i din hjemmemappe som hedder .tdesvn-buildrc, som indstiller generelle tilvalg og angiver modulerne som du vil hente og bygge. + +Brug filen tdesvn-buildrc-sample som en skabelon, for at indstille globale tilvalg og modulerne du vil bygge. + +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 svn://anonsvn.kde.org/ er standard, men lav det om du har en &kde; &svn;-konto, eller hvis der er et spejl tæt ved dig. + +Vær særlig opmærksom på de globale variabler tdedir og qtdir, eftersom den første angiver hvor det byggede &kde; skal installeres (normalt i ~/kde), og den anden hvor (og om) Qt-biblioteket skal bygges og installeres (normalt ~/tdesvn/build/qt-copy). Du skal kende stederne for tdedir 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 tdesvn-buildrc-sample bør være tilstrækkelige for at få en nogenlunde komplet installation af &kde;. Gem resultatet som .tdesvn-buildrc i din hjemmemappe. + +Hvis du vil finjustere .tdesvn-buildrc, kig så på for detaljeret information om alle indstillingstilvalg. + + + + +At bruge scriptet &tdesvn-build; + +Nu er du parat til at køre scriptet. Log ind til brugeren som du bruger for at kompilere &kde; i et terminalvindue, og kør scriptet: %su udviklings-brugernavn +%tdesvn-build + + + +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 Building &kde; from Source Step by Step. + + + + +Opsætning af miljøet for at køre den friske &kde; + +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. + +Åbn eller oprette filen .bash_profile i hjemmemappen med din favoriteditor, og tilføj følgende i slutningen af filen: +TDEDIR=(søgesti til tdedir) +TDEDIRS=$TDEDIR +PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH +LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH +export TDEDIRS PATH LD_LIBRARY_PATH + hvis du bygger modulet qt-copy, tilføj i stedet: TQTDIR=(søgesti til qtdir) +TDEDIR=(søgesti til tdedir) +TDEDIRS=$TDEDIR +PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH +MANPATH=$TQTDIR/doc/man:$MANPATH +LD_LIBRARY_PATH=$TDEDIR/lib:$TQTDIR/lib:$LD_LIBRARY_PATH +export TQTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH + + + +Hvis du ikke bruger en særlig bruger, idstillesn en anderledes $TDEHOME for det nye miljø i din .bash_profile: export TDEHOME="${HOME}/.tde-svn" + +# Opret hvis det behøves +[ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn + + + + +Hvis menuen senere er tom eller for fyldt med programmer fra din distribution, skal du måske indstille miljøvariablen xdg i .bash_profile: XDG_CONFIG_DIRS="/etc/xdg" +XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" +export XDG_CONFIG_DIRS XDG_DATA_DIRS + + + + + +Nu når vi er færdige med dette skal du sørge for at det rette starttde script bliver brugt: + +Åbn tekstfilen .xinitrc (eller .xsession, afhængig af distribution) i hjemmemappen, eller opret det hvis det behøves. Tilføj linjen: exec ${TDEDIR}/bin/starttde + + + +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. + +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: + +startx -- :1 + + + +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. + + + + + + + + +Scriptets funktioner + +Funktionerne i &tdesvn-build; omfatter: + + + + +Tjekker automatisk ud eller opdaterer moduler fra &svn;, ifølge hvad som er passende. + +Beregner tiden for at bygge moduler. + +Forsøger automatisk at genbygge moduler som bruger en inkrementel byggeproces, hvilket tenderer at mislykkes efter visse typer af indtjekninger. + +Kan genoptage et tidligere script, eller starte byggeprocessen fra en bestemt modul. + +Levereres med et indbygget rimeligt sæt standardtilvalg passende til at bygge en grundlæggende enbrugerinstallation af &kde; fra det anonyme &svn;-arkivet. + +Levereres med understøttelse for Unsermake. + +Ekspanderer dine indstillingstilvalg med tilde. Du kan for eksempel angive: qtdir ~/tdesvn/build/qt-copy + + +Indstillelige bygge-, kildekode-, og logningsmapper + +Sætter automatisk et byggesystem op, med kildekodemappen adskilt fra byggemappen for at holde kildekodemappen uberørt. Undtagelsen er qt-copy, som ikke er konstrueret til at bygges sådan (hvis du ikke vil prøve QT med separat byggemappe). + +Du kan angive globale tilvalg at bruge for alle moduler som tjekkes ud, og du kan desuden angive tilvalg som skal bruges for enkelte moduler. + +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 . + +Du kan angive diverse miljøvariabler som skal bruges under byggeprocessen, inklusive TDEDIR, TQTDIR, DO_NOT_COMPILE og CXXFLAGS. + +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. + +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 system() flitigt, så jeg anbefaler for øjeblikket ikke at køre den som systemadministrator. + +Du kan bruge make-install-prefix til at indlede byggekommandolinjen med en separat kommando, hvilket er nyttigt for sudo. + +Du kan bruge tilvalget apidox for automatisk at bygge og installere dokumentation om programmeringsgrænsefladen for visse moduler. + +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 taglib ud fra tdesupport, eller kun K3B fra extragear/multimedia. Scriptet henter automatisk kde-common hvis det behøves for at få byggeprocessen til at fungere. + +Du kan lade som om du udfører handlingen. Hvis du sender med eller på kommandolinjen, giver scriptet en meget udførlig beskrivelse af de kommandoer som skal gøres, uden i virkeligheden at udføre dem. + +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 module-base-path. + + + +Ting som &tdesvn-build; IKKE gør: + + + +Finde det hurtigste spejl for &kde; &svn;. Der er ikke engang en liste medsendt med scriptet for øjeblikket, selvom standardserveren skulle virke godt. + +Børste dine tænder. Du skal huske at gøre det selv. + +Desværre er scriptet formodentlig ikke fejlfrit. + + + + + + +Formatet for .tdesvn-buildrc + +For at bruge scriptet skal du have en fil i din hjemmemappe som hedder .tdesvn-buildrc, som beskriver modulerne som du vil hente og bygge. + + + +Det begynder med globale tilvalg, angivne som følger: + +global +tilvalg-navn tilvalg-værdi +[...] +end global + + +De følges derefter af en eller flere modulsektioner, angivne på følgende måde: + +module modul-navn +tilvalg-navn tilvalg-værdi +[...] +end module + + +modul-navn 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. + +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 ovenfor. + + +apidox, for at bygge dokumentation over programmeringsgrænsefladen +apply-qt-patches, for at forbedre qt-copy +binpath, for at indstille variablen PATH. +branch, for at tjekke ud fra en gren i stedet for /trunk. +build-dir, for at angive mappe at bygge i. +checkout-only, for kun at tjekke dele af et modul ud. +colorful-output for at tilføje farve til scriptets uddata. +configure-flags for at angive hvilke flag et modul skal indstilles med. +cxxflags for at definere variablen CXXFLAGS. +dest-dir for at ændre mappenavn for et modul. +disable-agent-check, for at forhindre at tdesvn-build kontrollerer SSH-agentens status. +do-not-compile, for at markere mapper så de springes over af byggeprocessen. +inst-apps, for at kun bygge og installere visse mapper. +install-after-build, for at undgå at installere efter byggeprocessen. +tdedir, for at angive mappe at installere KDE i. +libpath, for at sætte variablen LD_LIBRARY_PATH. +make-install-prefix, for at køre et hjælpeprogram (såsom sudo) under installationen. +make-options, for at sende flag til byggeprogrammet. +manual-build, for at undgå at modulet bygges automatisk. +manual-update, for at undgå at noget gøres automatisk med modulet. +module-base-path, for at ændre hvorfra modulet hentes. (nyttigt for grene og mærker). +niceness, for at ændre processorprioriteten. +no-rebuild-on-fail, for at undgå at køre byggeprocessen om igen hvis den mislykkes. +qtdir, for at angive søgesti til Qt. +set-env, for at sætte en miljøvariabel. +source-dir, for at ændre hvor kildekoden hentes. +stop-on-failure, for at få .tdesvn-build at stoppe så snart en alvorlig fejl findes. +svn-server, for at ændre serveren som kildekoden automatisk hentes fra. +use-qt-builddir-hack, for at give Qt en separat byggemappe fra kildekoden, såsom KDE. +use-unsermake, for at bruge det avancerede byggesystem unsermake. + + + +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. + + +Tilvalgstabel + + + + +Tilvalgsnavn +Modul -> global opførsel +Noter + + + + + + +apidox +Sætter global ud af kraft +Sæt dette til true 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 make apidox gør noget, inklusive , blandt andet tdelibs, tdebase og koffice. + + + +apply-qt-patches +Sætter global ud af kraft +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. + + + +binpath +Kan ikke sættes udf af kraft +Sæt dette for at bruge miljøvariablen PATH under byggeprocessen. Du kan ikke dette ud af kraft i et modultilvalg. Standatdværdi er /bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin. Miljøvariablen skal indeholde søgestier til udviklingsværktøjerne adskilte med kolon. Søgestierne $TDEDIR/bin og $TQTDIR/bin tilføjes automatisk. Du kan bruge tilde (~) for eventuelle søgestier du tilføjer med dette tilvalg. + + + + +branch +Sætter global ud af kraft +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". +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. +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 override-url. + + + + +build-dir +Sætter global ud af kraft +Brug dette for at skifte mappen som indeholder kildekoden at bygge. Der er tre forskellige måder at bruge det: Relativt til &kde;:&svn;-kildekodemappe (se tilvalget source-dir). 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 (/).Standardværdi er buildAbsolut søgesti. Hvis du angiver en søgesti som begynder med /, bruges søgestien direkte. For eksempel /tmp/kde-obj-dir/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 ~/builddir indstille byggemappen til /home/brugernavn/builddir Dette kan, måske noget uventet, ændres pr modul. + + + +checkout-only +Sætter global ud af kraft +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. + + + +configure-flags +Tilføjer globale tilvalg (undtagen for qt-copy) +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 sætter de globale indstillinger ud af kraft når det bruges for qt-copy. + + + +colorful-output +Kan ikke sættes udf af kraft +Sæt dette tilvalg til false for at deaktivere farvelagt uddata fra &tdesvn-build;. Dette tilvalg er normalt true. Bemærk at &tdesvn-build; ikke sender farvekoderne ud til noget andet end en terminal (såsom xterm, &konsole; eller den normale Linux-konsol). + + + +cxxflags +Tilføjer til globale tilvalg +Brug dette tilvalg for at angive hvilke flag som skal sendes til ./configure som CXXFLAGS når byggesystemet for modulet laves. Dette tilvalg angives her i stedet for med configure-flags eftersom tilvalget også sætter miljøvariablen CXXFLAGS under byggprocessen. + + + +dest-dir +Sætter global ud af kraft +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. + + + +disable-agent-check +Kan ikke sættes udf af kraft +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. + + + +do-not-compile +Sætter global ud af kraft +Brug dette tilvalg for at sætte miljøvariablen DO_NOT_COMPILE inden scriptet configure køres. Ifølge &kde;'s ofte stillede spørgsmål for udviklere, skal det gøre at alle topniveaumapper du sender med ikke bygges. Katalogerne skal adskilles med mellemrum. + +Bemærk at kildekoden for programmerne stadigvæk hentes. Du kan bruge direktivet checkout-only for at vælge mapper som du vil tjekke ud. + + + + +email-address +Kan ikke sættes udf af kraft + +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). + +For øjeblikket behøver kun email-on-compile-error tilvalget. + + + + +email-on-compile-error +Kan ikke sættes udf af kraft + +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. + +Se tilvalget email-address for at indstille adressen som tdesvn-build skal sende fra, eftersom standardværdien som oftest ikke er hvad du vil have. + + + + +inst-apps +Sætter global ud af kraft +Dette er modsætningen til tilvalget do-not-compile. Dette tilvalg gør at kun angivne topniveaumapper bygges. Katalogerna skal adskilles med mellemrum. + +Eventuelle ændringer får ingen virkning førend næste gang make Makefile.cvs køres, enten automatisk af scriptet, eller manuelt med tilvalgene eller . + +Bemærk at kildekoden for programmerne stadigvæk hentes. Du kan bruge direktivet checkout-only for at vælge mapper som du vil tjekke ud. + + + + +install-after-build +Sætter global ud af kraft +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 . + + + +tdedir +Kan ikke sættes udf af kraft +Dette tilvalg angiver mappen som &kde; installeres i efter det er bygget. Standardværdien er ~/kde. Hvis du ændrer det til en mappe som kræver adgang som systemadministrator, bør du også læse om tilvalget make-install-prefix. + + + +libpath +Kan ikke sættes udf af kraft +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 $TDEDIR/lib og $TQTDIR/lib tilføjes automatisk. Du kan bruge tilde (~) i alle søgestier du tilføjer med dette tilvalg. + + + +log-dir +Sætter global ud af kraft +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. + + + +make-install-prefix +Sætter global ud af kraft +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. + + + +make-options +Sætter global ud af kraft +Angiv denne variabel for at sende kommandolinjeflag til kommandoen make. Dette er nyttigt for programmer såsom distcc. Programmet distcc lader dig opdele dit kompileringsarbejde på mere end en maskine. For at bruge det, skal du bruge flaget 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 i mit tilfælde. + + + +manual-build +Sætter global ud af kraft +Sæt tilvalgsværdien til true 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 . + + + +manual-update +Sætter global ud af kraft +Sæt tilvalgsværdien til true 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. + + + +module-base-path +Sætter global ud af kraft +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. &kde;'s kildekodevisning er uvurderlig som hjælp til at vælge rette søgesti. +Bemærk at &tdesvn-build; konstruerer den endelige søgesti efter følgende skabelon: $svn-server/home/kde/$module-base-path/$module-name. +Standardværdien er enten trunk eller trunk/KDE, afhængig af modulnavnet. + + + + +niceness +Kan ikke sættes udf af kraft +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. + + + +no-rebuild-on-fail +Sætter global ud af kraft +Indstil denne tilvalgsværdi til true 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. + + + +override-url +Sætter global ud af kraft +Hvis du angiver dette tilvalg, bruger tdesvn-build dets værdi som URL at sende til Subversion helt uforandret. 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 branch. + + + +qtdir +Kan ikke sættes udf af kraft +Sæt dette tilvalg for at bruge miljøvariablen TQTDIR under byggeprocessen. Du kan ikke sætte dette tilvalg ud af kraft i et modultilvalg. Standardværdi er $(source-dir)/build/qt-copy, som bruger modulet qt-copy som indgår i &kde;:s kildekodearkiv. Du kan bruge tilde (~) til at repræsentere din hjemmemappe. + + + +remove-after-install +Sætter global ud af kraft +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. +Mulige værdier for dette tilvalg er: +none - Slet ikke bort noget (dette er standardværdien). +builddir - Slet byggemappen men ikke kildekoden. +all - Slet både kildekoden og byggemappen. + + + +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. + + + + +set-env +Sætter global ud af kraft +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: +set-env ANDERS AND +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). + + + + +source-dir +Kan ikke sættes udf af kraft +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 ~/tdesvn. Hvis du angiver denne værdi, brug en absolut søgesti. + + + +svn-server +Kan ikke sættes udf af kraft +Dette tilvalg bruges til at angive serveren som bruges ved udtjekning fra &svn;. Standard er det anonyme &svn;-arkiv, svn://anonsvn.kde.org/. + + + +stop-on-failure +Sætter global ud af kraft +Sæt denne tilvalgsværdi til true 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. + + + +tag +Sætter global ud af kraft +Brug dette tilvalg for at hente en specifik udgave af et modul. +Bemærk: Der er høje odds for at du IKKE ØNSKER at bruge dette tilvalg. KDE-udgaver er tilgængelige på arkivform fra KDE's FTP-sted eller et af dets spejle. +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 Konstruct i stedet for, som virker ud fra de udgivne tar-bolde. + + + + +use-qt-builddir-hack +Sætter global ud af kraft +Selvom dette tilvalg sætter det globale tilvalg ud af kraft, giver det kun mening for qt-copy. Sæt dette tilvalg til true for at aktivere scriptets eksperimentelle 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 TQTDIR i stedet skal være indstillet til $(qt-copy-build-dir)/qt-copy/lib. Du skal også ændre tilvalget qtdir på tilsvarende måde. At bygge inkrementelt skulle stadigvæk virke i denne tilstand, eftersom tidsstempler bevaras efter kopieringen. Hvis du bruger tilvalget apply-qt-patches, udføres programrettelserne i byggemappen, ikke i kildekodemappen. Tilvalgets standardværdi er true. + + + +use-unsermake +Sætter global ud af kraft +Sæt dette tilvalg til true 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 distribuerede byggesystem. Tilvalgets standardværdi er true (for de fleste moduler). + +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 self, så bruger tdesvn-build stadigvæk unsermake, men gør ingenting særligt for at holde det opdateret. + + + + + + +
+ + + + +Kommandolinjeflag og miljøvariabler + +Scriptet bruger ikke miljøvariabler. Hvis du behøver at sætte miljøvariabler for bygge- eller installationsprocessen, så se tilvalget set-env. + +Scriptet accepterer følgende kommandolinjeflag: + + + + + +vis kun simpel hjælp om scriptet. + + + + +vis programmets version. + + + + +vis forfatterens kontaktinformation. + + + + +aktivér farvelagt uddata. + + + + +deaktivér farvelagt uddata. + + + + (eller ) +udfører IKKE noget, men opfør sig som om du gjorde det. + + + + (eller ) +Vær ikke så støjende med uddata. Med dette flag meddeles kun det vigtigste. + + + + +Kun advarsler og fejl. + + + + +Beskriv i detalje hvad der sker, og hvad tdesvn-build gør. + + + + +udfører kun opdatering af kildekoden. + + + + +udfører kun byggeprocessen. + + + + +inkludér ikke moduler som sendes på resten af kommandolinjen under opdaterings- og byggeprocessen. + + + + +spring over at kontakte &svn;-serveren. + + + + +spring over byggeprocessen. + + + + +installér ikke automatisk pakker efter de er bygget. + + + + +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. + + + + +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. + + + + +genopret om byggesystemet og byg fra grunden. + + + + +kør scriptet configure igen uden at rense byggemappen. + + + + +kør make Makefile.cvs igen for at oprette scriptet configure, og fortsæt med at bygge som sædvanligt. Dette tilvalg implicerer . + + + + +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 . Du bør ikke angive andre modulnavne på kommandolinjen. + + + + +som er ligesom , bortset fra at du angiver modulet hvor byggeprocessen skal begynde som næste parameter på kommandolinjen. Alternativet implicerer . Du bør ikke angive andre modulnavne på kommandolinjen. + + + + +som tolker næste kommandolinjeflag som filen at læse indstillingstilvalg fra. Standardværdien for denne parameter er ~/.tdesvn-buildrc. + + + + +som lader dig ændre mappen som &kde; installeres i fra kommandolinjen. Dette tilvalg implicerer . + + + + +stop efter at have kørt make Makefile.cvs. 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å ./configure for hvert modul, og redigere dine flag til configure i overensstemmelse med dette. + + + +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 , antages de alle at være moduler at installere. + + + + +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 log-dir ud af kraft, skulle du angive . + + + + +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 use-unsermake ud af kraft for tdemultimedia, skal du angive . + + + + +Alle øvrige kommandolinjeflag antages at være moduler at opdatere og bygge. Bland helst ikke bygge og installere sammen. + + + + +Medvirkende og licens +&underFDL; + + diff --git a/tde-i18n-de/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt b/tde-i18n-de/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt deleted file mode 100644 index 34b4d2ecfad..00000000000 --- a/tde-i18n-de/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt +++ /dev/null @@ -1,6 +0,0 @@ -# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer - -tde_create_handbook( - DESTINATION tdesvn-build - LANG de -) diff --git a/tde-i18n-de/docs/tdesdk/scripts/tdesvn-build/Makefile.am b/tde-i18n-de/docs/tdesdk/scripts/tdesvn-build/Makefile.am deleted file mode 100644 index fac4b6cdea0..00000000000 --- a/tde-i18n-de/docs/tdesdk/scripts/tdesvn-build/Makefile.am +++ /dev/null @@ -1,4 +0,0 @@ -KDE_LANG = de -SUBDIRS = $(AUTODIRS) -KDE_DOCS = tdesvn-build -KDE_MANS = AUTO diff --git a/tde-i18n-de/docs/tdesdk/scripts/tdesvn-build/index.docbook b/tde-i18n-de/docs/tdesdk/scripts/tdesvn-build/index.docbook deleted file mode 100644 index b08f367641f..00000000000 --- a/tde-i18n-de/docs/tdesdk/scripts/tdesvn-build/index.docbook +++ /dev/null @@ -1,739 +0,0 @@ - - - - - - Subversion"> - tdesvn-build"> -]> - - - - -Handbuch zu &tdesvn-build; - - -MichaelPyne
michael.pyne@kdemail.net
 - -CarlosWoelz
carloswoelz@imap-mail.com
 - - - -ThomasReitelbach
tr@erdfunkstelle.de
Deutsche Übersetzung - - - - -2005 -Michael Pyne - - - -2005 -Carlos Woelz - - - -&FDLNotice; - -2005-06-18 -0.98 - - -Das Skript &tdesvn-build; kompiliert und installiert &kde; direkt aus den Quelltexten des &kde;-SVN. - - - -KDE -tdesdk -SVN -Subversion -KDE-Entwicklung - - - - - - -Einführung - -Das Skript &tdesvn-build; hilft Benutzern bei der Installation von &kde; aus dem SVN. Bite beachten Sie auch das Skript kde-build, welches im &kde;-Modul "tdesdk" enthalten ist. - -An dieser Stelle sollen die Syntax der Konfigurationsdatei, die Optionen und die Befehlszeilenparameter von &tdesvn-build; beschrieben werden, die nötig sind, um &kde; aus den Quelltexten zu installieren. Dies schließt auch die Schritte ein, die Sie mit anderen Werkzeugen erledigen müssen - also Schritte, die nicht automatisch von &tdesvn-build; durchgeführt werden. - - - - -Erste Schritte - -In diesem Kapitel wird erklärt, wie Sie mit Hilfe von &tdesvn-build; die entsprechenden Module aus dem &kde;-Quellcodearchiv herunterladen und kompilieren. Desweiteren werden einige Grundlagen zur Struktur des &kde; SVN und die nötigen Schritte vor dem Ausführen des Skripts erklärt. - -Alle in diesem Kapitel angesprochene Punkte werden detaillierter in dem Dokument Building &kde; from Source Step by Step Guide auf der Webseite des &kde; Qualitäts-Sicherungsteam erklärt. Wenn Sie &kde; zum ersten Mal kompilieren, sollten Sie dieses Dokument lesen und bei Fragen als Referenz heranziehen. Darin finden Sie auch Informationen zu Paketierungs-Hilfsprogrammen, Kompilier-Voraussetzungen, häufigen Stolperfallen und allgemeinen Strategien zur Verwendung Ihrer neuen &kde;-Installation. - - -Vorbereiten des Systems zum Kompilieren von &kde; - -Zum Herunterladen und Kompilieren von &kde; sollten Sie ein normales Benutzerkonto verwenden. Wenn Sie bereits einige &kde;-Programme installiert haben, sollten Sie sogar ein neues, separates Benutzerkonto erzeugen und &kde; unter Verwendung des neuen Benutzers installieren und ausführen. Der Vorteil an dieser Vorgehensweise ist, dass Sie die bestehende &kde;-Installation nicht zerstören und das Sie normal weiterarbeiten können, falls mit der neuen Installation etwas nicht funktioniert. - -Sie können die Installation später immer noch systemweit als root durchführen. Das geht allerdings über den Rahmen dieses Handbuchs hinaus. Es wird davon ausgegangen, dass Sie wissen was Sie tun, wenn Sie eine systemweite Installation durchführen. - -Bevor Sie &tdesvn-build; (oder eine andere Kompiliermethode) verwenden, müssen Sie die Entwickler-Werkzeuge und -Bibliotheken für &kde; installieren. Sie benötigen Qt 3.3.0 oder neuer, Automake 1.8, Autoconf 2.5x (besser 2.57 oder neuer, weil es für ältere Versionen einen bekannten Bug gibt), den Subversion-Client (svn), den gcc-Compiler mit C++-Unterstützung, libxml2, openssl, libbz2 und einige weitere. Ein vollständige Liste finden Sie unter KDE Compilation Requirements. Üblicherweise werden die benötigen Hilfsprogramme und Bibliotheken mit Ihrer Distribution mitgeliefert und müssen evtl. nur nachinstalliert werden. - -Einige der benötigten Pakete werden von den Distributoren in Bibliotheken, Programmdateien oder Werkzeuge und Entwickler-Pakete unterteilt. In diesen Fällen benötigen Sie wenigstens die Programmdateien und das Entwicklungs-Paket. Wenn Sie unsicher sind, installieren Sie am besten alle Pakete zu einem Programm. Die benötigen Bibliotheken sind abhängig von dem KDE-Modul, welches Sie installieren möchten. Unter Building &kde; from Source Step by Step Guide finden Sie mehr Details über die einzelnen Hilfsprogramme und Techniken zur Installation der Abhängigkeiten. - -Wahrscheinlich haben Sie &tdesvn-build; bereits auf Ihrem System installiert. Nun müssen Sie die Konfigurationsdatei für &tdesvn-build; mit dem Namen .tdesvn-buildrc erzeugen. Die Datei sollte in Ihrem persönlichen Ordner (~/) liegen und entält alle benötigten Optionen und Einstellungen, Compiler-Optionen, den Speicherort der Quelldateien, das Installationsziel, die zu installierenden Module und so weiter. Die Voreinstellungen finden Sie in der Datei tdesvn-buildrc-sample. Weitere Informationen zur Syntax der Konfigurationsdatei können Sie in und nachlesen. - -Es ist nicht schwer, die neueste Version von &tdesvn-build; zu erhalten. Öffnen Sie die Seite tdesdk/scripts unter websvn.kde.org. In dem Ordner tdesdk/scripts finden Sie eine Liste der Dateien. Klicken Sie auf &tdesvn-build; und laden Sie die neueste Version herunter; ebenso laden Sie auch die Datei tdesvn-buildrc-sample auf Ihren Rechner. Machen Sie das Skript ausführbar und sorgen Sie dafür, dass es über die Umgebungsvariable PATH gefunden werden kann. - - - - -Festlegen der Einstellungen - -Damit das Skript funktioniert, müssen Sie die Datei .tdesvn-buildrc in Ihrem persönlichen Ordner haben, in der die allgemeinen Einstellungen festgelegt sind. - -Benutzen Sie die Datei tdesvn-buildrc-sample als Vorlage und stellen Sie die allgemeinen Optionen und die Module ein, die Sie installieren möchten. - -Wählen Sie den Server aus, den Sie für das Herunterladen der SVN-Arbeitskopie verwenden möchten. Den Server legen Sie mit der globalen Einstellung svn-server fest. Voreingestellt ist der Server für anonymes SVN: svn://anonsvn.kde.org, aber Sie können dies ändern, wenn Sie einen &kde; SVN-Zugang haben oder es einen Spiegel in Ihrer Nähe gibt. - -Geben Sie besonders acht auf die globalen Variablen tdedir und qtdir. tdedir legt den Zielordner fest, in dem &kde; installiert wird (voreingestellt ist ~/kde) und qtdir legt fest, wo Qt installiert ist bzw. ob es dort kompiliert und installiert werden soll (voreingestellt ist ~/tdesvn/build/qt-copy). Die hier festgelegten Einstellungen brauchen Sie später nochmal, um die Umgebungsvariablen zum Ausführen des neuen KDE richtig zu setzen. Prüfen Sie, ob die aufgeführten Module diejenigen sind, die Sie wirklich installieren möchten. Mit den Voreinstellungen aus tdesvn-buildrc-sample erhalten Sie eine weitgehend vollständige &kde;-Installation. Speichern Sie Ihre Einstellungen in die Datei .tdesvn-buildrc in Ihrem persönlichen Ordner. - -Wenn Sie Feineinstellungen an .tdesvn-buildrc vornehmen möchten, lesen Sie bitte in die detaillierten Informationen über alle Konfigurations-Optionen nach. - - - - -Verwenden von &tdesvn-build; - -Sie können das Skript nun ausführen. Melden Sie sich in einem Terminal-Fenster als der Benutzer an, den Sie zum Kompilieren und Installieren des neuen &kde; verwenden möchten, und führen Sie das Skript aus: %su Benutzername -%tdesvn-build - - - -Das Skript sollte nun mit dem Herunterladen der Quellen beginnen und sie kompilieren. Oft schlägt der erste Versuch, &kde; zu kompilieren, fehl. Geben Sie nicht auf! Prüfen Sie die Protokoll-Dateien; möglicherweise fehlt Ihnen noch ein Hilfsprogramm oder entsprechende Entwickler-Pakete. Der Pfad zu den Protokollen ist in der Einstellung log-dir in Ihrer Konfigurationsdatei festgelegt. Manchmal passiert es auch, dass ein KDE-Modul unstabil ist und sich daher nur unter erheblichem Aufwand kompilieren lässt. Haben Sie Geduld, derartige Probleme werden in der Regel sehr schnell behoben. Weitere Dinge, die häufig fehlschlagen, sowie die Lösungen und weitere grundsätzliche Tipps und Tricks zum Kompilieren von &kde; finden Sie im Building &kde; from Source Step by Step Guide. - - - - -Einrichten der neuen &kde;-Umgebung - -Im Folgenden wird davon ausgegangen, dass Sie einen separaten Benutzer zum Kompilieren und Installieren von &kde; verwendet haben. Des Weiteren wird davon ausgegangen, dass Sie bereits eine &kde;-Version installiert haben. Wenn dies der Fall ist, muss das neue &kde; Vorrang vor der alten Version erhalten. Bearbeiten Sie die Umgebungsvariablen entsprechend. - -Öffnen Sie die Datei .bash_profile in Ihrem persönlichen Ordner oder erzeugen Sie eine neue, falls sie noch nicht existiert. Am Ende der Datei fügen Sie folgendes ein: -TDEDIR=(pfad zu tdedir) -TDEDIRS=$TDEDIR -PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH -LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH -export TDEDIRS PATH LD_LIBRARY_PATH - Wenn Sie das Modul qt-copy installiert haben, fügen Sie dies stattdessen ein: TQTDIR=(pfad zu qtdir) -TDEDIR=(pfad zu tdedir) -TDEDIRS=$TDEDIR -PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH -MANPATH=$TQTDIR/doc/man:$MANPATH -LD_LIBRARY_PATH=$TDEDIR/lib:$TQTDIR/lib:$LD_LIBRARY_PATH -export TQTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH - - - -Wenn Sie keinen separaten Benutzer verwenden, ändern Sie die Umgebungsvariable $TDEHOME in .bash_profile für die neue Umgebung. export TDEHOME="${HOME}/.tde-svn" - -# Create it if needed -[ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn - - - - -Falls das KDE-Menü später leer oder völlig überfüllt mit Programmen Ihrer Distribution sein sollte, müssen Sie unter Umständen die xdb-Umgebungsvariable in .bash_profile anpassen: XDG_CONFIG_DIRS="/etc/xdg" -XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" -export XDG_CONFIG_DIRS XDG_DATA_DIRS - - - - - -Nun sollte die Umgebungsvariablen korrekt eingestellt sein. Stellen Sie nun sicher, dass die richtige Version des Start-Skripts starttde verwendet wird: - -Öffnen Sie die Datei .xinitrc (oder .xsession, abhängig von Ihrer Distribution) in Ihrem persönlichen Ordner. Erzeugen Sie sie, falls nötig. Fügen Sie die folgende Zeile hinzu: exec ${TDEDIR}/bin/starttde - - - -Starten Sie nun Ihre neues &kde;: In BSD und Linux mit Unterstützung für virtuelle Terminals können Sie die Tastenkombination Strg+Alt+F1...F12 zum wechseln zwischen den Terminals verwenden. Auf diese Weise können Sie mehrere Arbeitsumgebungen gleichzeitig ausführen. Die ersten sechs Terminals sind Text-Terminals, die folgenden sechs sind graphische Terminals. - -Falls beim Systemstart der graphische Anmeldungsmanager erscheint, können Sie Ihr neues KDE dennoch verwenden, auch wenn es nicht in der Liste für die graphische Anmeldung aufgeführt ist. Drücken Sie Strg+Alt+F2 um zu einem Text-Terminal zu gelangen. Melden Sie sich als der separate KDE-Benutzer an und geben Sie folgendes ein: - -startx -- :1 - - - -Sie können das frisch aus den Quellen installierte und das alte KDE gleichzeitig laufen lassen! Melden Sie sich als regulärer Benutzer wie gewohnt an und starten Sie KDE. Drücken Sie dann Strg+Alt+F2 (oder F1, F3, ...) um zu einem Text-Terminal zu gelangen. Melden Sie sich mit dem separaten KDE-Benutzer an und geben Sie "startx -- :1" ein. Mit der Tastenkombination Strg+Alt+F6 (oder F7, F8, etc.) können Sie zwischen den verschiedenen KDE-Sitzungen hin und her wechseln. Nun können Sie das neue KDE testen und wissen, dass Sie jederzeit zu Ihrer alten, stabilen Version zurückkehren können. - - - - - - - - -Besondere Funktionen des Skripts - -&tdesvn-build; beinhaltet die folgenden Funktionen und Besonderheiten: - - - - -Automatisches Herunterladen und Aktualisieren der nötigen Module aus dem SVN-Archiv. - -Zeitmessung für den Kompiliervorgang der Module. - -Automatisches Neu-Kompilieren von Modulen, die inkrementelles make verwenden (welches nach verschiedenen Arten von commits fehleranfällig ist). - -Fortsetzen eines vorherigen Skript-Durchlaufs und Starten des Kompiliervorgangs mit einem bestimmten Modul. - -Die voreingestellten Optionen sind gut geeignet für die Installation von &kde; aus dem SVN für einen einzelnen Benutzer. - -Direkte Unterstützung für Unsermake. - -Benutzung der Tilde als Platzhalter in den Optionen. Beispielsweise ist Folgendes ist möglich: qtdir ~/tdesvn/build/qt-copy - - -Kompilier-, Quell- und Protokoll-Ordner sind frei einstellbar. - -Automatisches herrichten einer Kompilierumgebung, in der der Kompilier-Ordner ungleich dem Quell-Ordner ist. Dadurch wird der Quell-Ordner "sauber" gehalten. Die einzige Ausnahme bildet hier qt-copy, welches nicht für diese Art des Kompilierens vorgesehen ist (es sei denn Sie möchten den Hack qt with a separate build directory hack ausprobieren). - -Es können sowohl globale Einstellungen für alle Module als auch spezifische Einstellungen für bestimmte Module vorgenommen werden. - -In manchen Fällen verlieren die autotools die Synchronisation mit dem Quell-Ordner; daher können Sie erzwingen, dass bestimmte Module vollständig neu kompiliert werden. Dazu müssen Sie im Quell-Ordner des fraglichen Moduls eine Datei namens .refresh-me anlegen oder &tdesvn-build; mit der Option aufrufen. - -Es können verschiedene Umgebungsvariablen benutzt werden, die den Kompiliervorgang beeinflussen. Dazu gehören unter anderem TDEDIR, TQTDIR, DO_NOT_COMPILE und CXXFLAGS. - -Befehls-Protokolle. Alle Protokolle werden durchnummeriert und mit einem Datums-Stempel versehen, sodass Sie pro Skript-Durchlauf ein Protokoll erhalten. Des Weiteren wird mit jedem Skript-Durchlauf ein symbolischer Link namens latest erzeugt, der auf das jeweils letzte Protokoll verweist. - -Wenn Sie &kde; für einen Benutzer anstatt systemweit installieren (wofür Sie Systemverwalter-Rechte benötigen würden), können Sie das Skript zum Installieren verwenden. Ich (der Autor von tdesvn-build) habe den Code des Skripts nicht begutachtet und es macht gebrauch von der Funktion system(); Sie sollten das Skript lieber nicht als Systemverwalter ausführen. - -Sie können make-install-prefix verwenden, um dem Kommando make install einen Befehl voranzustellen. Dies ist z. B. für die Verwendung von sudo nützlich. - -Mit Hilfe der Option apidox können Sie veranlassen, dass die API-Dokumentation für einige Module erzeugt und installiert wird. - -Sie können auch nur einzelne Teile von &kde; aus einem SVN-Modul herunterladen lassen. Beispielsweise könnten Sie nur taglib aus tdesupport herunterladen, oder nur K3b aus extragear/multimedia. Das Skript wird automatisch kde-common mit einbeziehen, falls dies zum Kompilieren nötig ist. - -Sie können alle Vorgänge vorgaukeln anstatt sie wirklich ausführen zu lassen. Benutzen Sie dazu die Option oder und das Skript wird eine detaillierte Beschreibung alle Befehle ausgeben, die es ausführen würde, ohne tatsächlich etwas zu unternehmen. - -Es ist möglich, verschiedene SVN-Verzweigungen für bestimmte Module zu verwenden. Die Unterstützung hierfür ist noch nicht ganz vollständig, sie können aber die zu verwendende Verzweigung (branch) mit der Einstellung module-base-path festlegen. - - - -Dinge, die &tdesvn-build; NICHT macht: - - - -Auffinden des schnellsten &kde; SVN-Spiegelservers. Derzeit wird mit dem Skript noch nichtmal eine Liste der Spiegelserver mitgeliefert. Außerdem sollte der Standard-Server problemlos funktionieren. - -Ihre Zähne putzen, das müssen Sie schon selbst erledigen ;-) - -Das Skript ist sicherlich nicht fehlerfrei - dafür schonmal vorab entschuldigung. - - - - - - -Das Format der Datei .tdesvn-buildrc - -Für die korrekte Funktion benötigt das Skript eine Datei namens .tdesvn-buildrc in Ihrem persönlichen Ordner. Diese beschreibt unter anderem die KDE-Module, die Sie herunterladen und installieren möchten. - - - -Zuerst werden die globalen Einstellungen wie folgt festgelegt: - -global -option-name option-wert -[...] -end global - - -Danach folgen eine oder mehrere Modul-Abschnitte, die wie folgt aussehen: - -module modul-name -option-name option-wert -[...] -end module - - -modul-name muss ein Modulname aus dem &kde; SVN-Archiv sein (z. B. tdelibs oder tdebase). Einige Optionen überschreiben die globalen Optionen, einige können zusätzlich zu globalen Optionen festgelegt werden und einige globale Optionen lassen sich gar nicht Modul-Spezifisch überschreiben. - -Im Folgenden sehen Sie eine alphabetisch geordnete Liste der möglichen Optionen. Klicken Sie auf eine Option, um mehr darüber zu erfahren. Falls eine Option nicht näher dokumentiert ist, schreiben Sie bitte eine E-Mail an den Autor. Die Adresse finden Sie hier. - - -apidox: Erstellen der API-Dokumentation -apply-qt-patches: Verbessern von Qt-copy mit einigen Patches -binpath: Zum Festlegen der Umgebungsvariable PATH -branch: Zum Herunterladen aus einer bestimmten branch anstelle von /trunk -build-dir: Legt den Kompilier-Ordner festO -checkout-only: Nur bestimmte Teile eines Moduls herunterladen -colorful-output: Farbige Darstellung der Skript-Ausgaben -configure-flags: Legt fest, welche Parameter an configure eines bestimmten Moduls übergeben werden sollen. -cxxflags: Legt den Inhalt der Umgebungsvariable CXXFLAGS fest -dest-dir: Zum Ändern des Ordner-Namens für ein Modul -disable-agent-check: Verhindert die Prüfung des Status für den SSH-Agenten -do-not-compile: Schließt bestimmte Ordner vom Kompiliervorgang aus -inst-apps: Hiermit werden nur bestimmte Ordner kompiliert und installiert -install-after-build: Hierdurch kann die Installation nach dem Kompilieren verhindert werden -tdedir: Legt den Zielordner für die KDE-Installation fest -libpath: Legt den Inhalt der Umgebungsvariable LD_LIBRARY_PATH fest -make-install-prefix: Zum Ausführen eines Hilfsprogrammes vor make install (z. B. sudo) -make-options: Übergibt bestimmte Optionen an das Programm make -manual-build: Verhindert das automatische Kompilieren eines Moduls -manual-update: Verhindert das automatische Aktualisieren eines Moduls -module-base-path: Ändert den Pfad, aus dem ein Modul heruntergeladen werden soll (nützlich für SVN-Verzweigungen und -Tags) -niceness: Ändert die Laufzeit-Priorität des Skripts -no-rebuild-on-fail: Verhindert den erneuten Durchlauf von make nach einem Fehler -qtdir: Legt den Pfad zu Qt fest -set-env: Zum Einstellen einer UmgebungsvariableFestlegen -source-dir: Ändert den Pfad für heruntergeladene Quellen -stop-on-failure: Beendet tdesvn-build sobald ein Fehler auftritt -svn-server: Ändert den Server, von dem die Quellen heruntergeladen werden -use-qt-builddir-hack: Legt fest, dass für Qt separate Quell- und Kompilier-Ordner verwendet werden sollen (so wie bei KDE auch) -use-unsermake: Verwendung des erweiterten Kompilier-Systems unsermake - - - -Im Folgenden finden Sie eine Tabelle mit verschiedenen Optionen und einigen Kommentaren dazu. Optionen, die eine globale Option überschreiben, werden auch den entsprechenden Parameter auf der Kommandozeile überschreiben. - - -Tabelle der Optionen - - - - -Name der Option -Modul -> Globales Verhalten -Anmerkungen - - - - - - -apidox -Überschreibt die globale Option -Stellen Sie die Option auf true, so wird &tdesvn-build; die API-Dokumentation für das Modul erzeugen und installieren. Dies funktioniert nur mit Modulen, die den Befehl make apidox unterstützen (inklusive tdelibs, tdebase, koffice und weiteren). - - - -apply-qt-patches -Überschreibt die globale Option -Diese Option ist nur für qt-copy sinnvoll. Wenn Sie auf einen Wert ungleich Null eingestellt ist, wird das apply-patches-Skript in qt-copy vor dem Kompilieren ausgeführt. Dadurch werden einige inoffizielle Patches auf qt-copy angewandt. Normalerweise sind gerade diese Patches der Grund, qt-copy zu verwenden. Daher sollten Sie diese Option bedenkenlos aktivieren können. Standardmäßig werden die Patches auf qt-copy angewandt. - - - -binpath -Kann nicht überschrieben werden -Mit dieser Option können Sie die Umgebungsvariable PATH für den Kompiliervorgang festlegen. Diese Option lässt sich nicht mit einer Modul-Option überschreiben. Die Voreinstellung ist /bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin. Diese Umgebungsvariable sollte die Pfade zu den notwendigen Entwicklungs-Werkzeugen beinhalten. Die Pfade $TDEDIR/bin und $TQTDIR/bin werden automatisch hinzugefügt. Sie können auch die Tilde (~) für Pfadangaben verwenden. - - - - -branch -Überschreibt die globale Option -Mit dieser Option legen Sie fest, dass die Quellen aus einem bestimmten SVN-Branch anstelle von "trunk" heruntergeladen werden sollen. Um beispielsweise KDE 3.4 herunterzuladen, stellen Sie die Option auf "3.4" ein. -Beachten Sie, dass einige Module unterschiedliche Namen für ein SVN-Branch verwenden. Hier ist insbesondere aRts zu erwähnen, welches andere Versionsnummern als KDE verwendet. Die mit KDE 3.4 ausgelieferte Version von aRts war beispielsweise 1.4. -Das das Herunterladen einer Branch mit dieser Option fehlschlägt, müssen Sie möglicherweise die korrekte Adresse zum Herunterladen manuell eingeben. Verwenden Sie dazu die Option override-url. - - - - -build-dir -Überschreibt die globale Option -Verwenden Sie diese Option zum Ändern des Ordners, in dem die Quellen kompiliert werden sollen. Sie können diese Option auf drei Arten verwenden: Relativ zum &kde; SVN Quellordner (siehe die Option source-dir). Dies ist die Voreinstellung und außerdem die Art und Weise, wie es bis zur Skript-Version 0.61 funktioniert hat. Dieser Modus wird automatisch verwendet, wenn Sie einen Ordner-Namen eingeben, der nicht mit einer Tilde (~) oder einem Schrägstrich (/) beginnt. Die Voreinstellung ist build. Absoluter Pfad. Wenn Sie einen Pfad eingeben, der mit einem Schrägstrich (/) beginnt, so wird dieser Pfad wie eingegeben verwendet. Beispiel: /tmp/kde-obj-dir/. Relativ zum persönlichen Ordner. Wenn Sie einen Pfad angeben, der mit einer Tile (~) beginnt, so wird der Pfad als relativ zu Ihrem persönlichen Ordner angesehen. Dies funktioniert analog zu der Art und Weise, wie die Shell eine Tilde interpretiert. Beispiel: ~/builddir würde den Kompilier-Ordner auf /home/benutzer/builddir einstellen. Diese Option kann pro Modul separat eingestellt werden. - - - -checkout-only -Überschreibt die globale Option -Mit Hilfe dieser Option können Sie SVN-Module Stück für Stück herunterladen. Die Einstellung für diese Option sollte eine durch Komma getrennte Liste der herunterzuladenden Ordner sein. Wenn Sie den admin-Ordner nicht angeben, wird er automatisch heruntergeladen (falls nötig). Wenn Sie Stück für Stück herunterladen, wird der admin-Ordner aus kde-common eingefügt. Zwar überschreibt diese Option die globale Version, es ist jedoch dennoch nicht sinnvoll, die Option global einzustellen. - - - -configure-flags -Wird der globalen Option angefügt (ausgenommen für qt-copy) -Mit Hilfe dieser Option können Sie die Parameter festlegen, die dem Skript ./configure für das jeweilige Modul übergeben werden. Wenn Sie diese Option global einstellen, wird sie für alle Module angewandt. Für qt-copy wird ein völlig anderer Satz configure-Parameter benutzt als für &kde;, daher überschreibt die Option die globale Einstellung, wenn sie für qt-copy eingestellt wird. - - - -colorful-output -Kann nicht überschrieben werden -Wenn Sie diese Option auf false setzen, wird die farbige Ausgabe von &tdesvn-build; unterbunden. Die Voreinstellung ist true. Beachten Sie, dass &tdesvn-build; die Farbcodes nur auf ein Terminal ausgibt (wie beispielsweise xterm, &konsole; oder die normale Linux-Konsole). - - - -cxxflags -Wird der globalen Option angefügt -Mit dieser Option können Sie die Parameter festlegen, die ./configure als CXXFLAGS übergeben werden sollen. Diese Option wird hier festgelegt und nicht einfach configure-flags mit angehängt, weil sie auch die Umgebungsvariable CXXFLAGS während dem Kompilieren setzt. - - - -dest-dir -Überschreibt die globale Option -Mit dieser Option können Sie den Modul-Namen für Ihre lokale Kopie auf der Festplatte festlegen. Das Modul extragear/network könnten Sie beispielsweise extragear-network nennen. - - - -disable-agent-check -Kann nicht überschrieben werden -Wenn Sie SSH zum Herunterladen der Quellen aus SVN verwenden, wird tdesvn-build versuchen sicherzustellen, dass Ihr SSH-Agent auch einige SSH-Identitäten verwaltet. Auf diese Weise soll verhindert werden, dass Sie andauern zur Passworteingabe aufgefordert werden. Sie können diese Prüfung unterbinden, indem Sie die Option auf true stellen. - - - -do-not-compile -Überschreibt die globale Option -Mit dieser Option wird die Umgebungsvariable DO_NOT_COMPILE gesetzt, bevor das configure-Skript ausgeführt wird. Laut der &kde; Entickler-FAQ sollten auf diese Weise alle Haupt-Ordner beim Kompilieren übersprungen werden, die mit dieser Variable übergeben werden. Trennen Sie mehrere Ordnerangaben durch Leerzeichen. - -Beachten Sie, dass die Quellen zu den übersprungenen Programmen dennoch heruntergeladen werden. Um auch dies zu unterbinden, können Sie die Option checkout-only verwenden. Geben Sie mit dieser Option nur die Ordner an, die Sie herunterladen möchten. - - - - -email-address -Kann nicht überschrieben werden - -Mit dieser Option können Sie die E-Mail-Adresse festlegen, die tdesvn-build; als Absender verwenden soll, falls das Senden einer E-Mail nötig sein sollte. Sie können diese Option vernachlässigen, wenn Sie keine Funktionen benutzen, die E-Mails senden. (Diese Funktionen sind in der Voreinstellung deaktiviert.) - -Derzeit benötigt nur email-on-compile-error diese Option. - - - - -email-on-compile-error -Kann nicht überschrieben werden - -Mit dieser Option können Sie die E-Mail-Adresse festlegen, an die eine Nachricht gesendet werden soll, falls sich ein Modul nicht kompilieren lässt. tdesvn-build wartet ab, bis alle Module bearbeitet wurden und sendet dann einen Sammelbericht über die fehlgeschlagenen Module per E-Mail. Es wird nur eine E-Mail gesendet, falls ein Modul fehlschlägt. - -Bitte beachten Sie die Option email-address, mit der die Absenderadresse für diese Funktion eingestellt wird. Die Voreinstellung ist üblicherweise nicht zufriedenstellend. - - - - -inst-apps -Überschreibt die globale Option -Dies ist das Gegenteil zu der Option do-not-compile. Mit dieser Option legen Sie fest, dass nur bestimmte Hauptordner kompiliert werden sollen. Mehrere Ordnerangaben müssen mit Leerzeichen getrennt werden. - -Änderungen an dieser Option werden erst angewendet, nachdem das nächste Mal make Makefile.cvs aufgerufen wurde; entweder automatisch, durch das Skript oder manuell durch die Option oder . - -Beachten Sie, dass die Quellen zu den übersprungenen Programmen dennoch heruntergeladen werden. Um auch dies zu unterbinden, können Sie die Option checkout-only verwenden. Geben Sie mit dieser Option nur die Ordner an, die Sie herunterladen möchten. - - - - -install-after-build -Überschreibt die globale Option -Diese Option legt fest, dass ein Paket nach erfolgreichem Kompilieren installiert werden soll. Dies ist in der Voreinstellung eingeschaltet. Wenn Sie dieses Verhalten nicht wünschen, stellen Sie die Option auf 0. Sie können analog auch den Befehlszeilen-Parameter verwenden. - - - -tdedir -Kann nicht überschrieben werden -Mit dieser Option wird der Zielordner festgelegt, in den &kde; nach dem Kompilieren installiert wird. Die Voreinstellung ist ~/kde. Wenn Sie hier einen Ordner einstellen, für den Systemverwalter-Rechte benötigt werden, sollten Sie auch die Anmerkungen zur Option make-install-prefix lesen. - - - -libpath -Kann nicht überschrieben werden -Mit dieser Option wird die Umgebungsvariable LD_LIBRARY_PATH für den Kompiliervorgang gesetzt. Sie können die Option für jedes Modul separat einstellen. In der Voreinstellung ist sie nicht gesetzt, aber die Pfade $TDEDIR/lib und $TQTDIR/lib werden automatisch hinzugefügt. Sie können für Pfadangaben auch die Tile (~) benutzen. - - - -log-dir -Überschreibt die globale Option -Diese Option wird zum Ändern des Ordners für Protokoll-Dateien des Skripts verwendet. Seit der Version 0.64 können Sie die Option auch pro Modul einstellen. - - - -make-install-prefix -Überschreibt die globale Option -Geben Sie für diese Variable eine Liste mit Befehlen ein. Mehrere Befehle werden durch Leerzeichen getrennt. Die hier eingegebenen Befehle werden vor jedem Aufruf von make install ausgeführt. Dies ist hilfreich, wenn Sie für die Installation einiger Pakete Systemverwalter-Rechte benötigen und daher z. B. sudo aufrufen müssen. Bitte seien Sie umsichtig im Umgang mit Systemverwalter-Rechten! - - - -make-options -Überschreibt die globale Option -Mit Hilfe dieser Variable können Sie Befehlszeilen-Parameter an make übergeben. Dies kann beispielsweise zur Verwendung von distcc nützlich sein. Mit distcc ist es möglich, den Kompiliervorgang auf mehrere Rechner zu verteilen. Um es zu verwenden, müssen Sie die Option an make übergeben; mit dieser Einstellung ist das möglich. Wenn man nach der Dokumentation geht, entspricht die richtige Einstellung 2 * anzahl_netzwerk_prozessoren. Bei nur einer CPU ist die korrekte Einstellung. - - - -manual-build -Überschreibt die globale Option -Stellen Sie diese Option auf true, um zu verhindern, dass tdesvn-build dieses Modul kompiliert. Es wird dennoch weiterhin aktualisiert werden, wenn Quellen aus SVN heruntergeladen werden. Diese Option entspricht dem Befehlszeilen-Parameter . - - - -manual-update -Überschreibt die globale Option -Stellen Sie diese Option auf true, um zu verhindern, dass tdesvn-build dieses Modul aktualisiert (und auch nicht kompiliert und installiert). Wenn Sie diese Option so verwenden, entspricht das im Grunde dem Auskommentieren - es wird völlig übergangen. - - - -module-base-path -Überschreibt die globale Option -Mit dieser Option können Sie den in &tdesvn-build; voreingestellten Pfad zu einem Modul übergehen. Dies kann zum Beispiel verwendet werden, um für ein Modul eine besondere branch oder eine als tag vorhandene Version herunterzuladen. Bei der Suche nach dem richtigen Pfad kann Ihnen das &kde; WebSVN behilflich sein. -Beachten Sie: &tdesvn-build; setzt den Pfad nach dem folgenden Schema zusammen: $svn-server/home/kde/$module-base-path$modul-name. -Die Voreinstellung ist entweder trunk oder trunk/KDE, je nach Modul-Name. - - - - -niceness -Kann nicht überschrieben werden -Diese Option können Sie auf einen Wert zwischen 20 und 0 einstellen. Je höher die Zahl, desto niedriger ist die Laufzeit-Priorität für &tdesvn-build;. Die Voreinstellung ist 10. - - - -no-rebuild-on-fail -Überschreibt die globale Option -Stellen Sie diese Option auf true, wenn Sie verhindern möchten, dass &tdesvn-build; ein Modul erneut kompiliert, wenn inkrementelles Kompilieren fehlgeschlagen ist. Normalerweise versucht &tdesvn-build;, ein Modul erneut von vorne zu kompilieren, falls ein SVN update den Kompiliervorgang durcheinander gebracht haben sollte. - - - -override-url -Überschreibt die globale Option -Wenn Sie diese Option einstellen, wird tdesvn-build den eingestellten Wert unverändert als Adresse an Subversion übergeben. Sie können diese Option grundsätzlich verwenden, um eine bestimmte Programmversion herunterzuladen. Dann kann tdesvn-build allerdings nichts mit der Option branch anfangen. - - - -qtdir -Kann nicht überschrieben werden -Diese Option setzt die Umgebungsvariable TQTDIR für den Kompiliervorgang. Sie können die Einstellung nicht für einzelne Module überschreiben. Wenn Sie dies nicht setzen, lautet die Voreinstellung $(source-dir)/build/qt-copy; somit wird die mit &kde; ausgelieferte Version von qt-copy verwendet. Sie können die Tilde (~) verwenden. - - - -remove-after-install -Überschreibt die globale Option -Wenn Sie wenig Festplattenspeicher zur Verfügung haben, können Sie mit Hilfe dieser Option alle Kompilier-Ordner (oder zusätzlich auch den Quell-Ordner) nach der erfolgreichen Installation löschen lassen. -Die möglichen Einstellungen für diese Option sind: -none - Nichts wird gelöscht (dies ist die Voreinstellung). -builddir - Kompilier-Ordner werden gelöscht, aber keine Quell-Ordner. -all - Sowohl Kompilier- als auch Quell-Ordner weren gelöscht. - - - -Beachten Sie: Die Verwendung dieser Option kann eine negative Auswirkung auf Ihre Internet-Bandbreite und die Gesamtdauer einer KDE-Installation haben, weil tdesvn-build nicht mehr inkrementell kompilieren kann und die Pakete unter Umständen immer wieder neu herunterladen muss. Dies ist insbesondere der Fall, wenn Sie die Option auf all einstellen. - - - - -set-env -Überschreibt die globale Option -Diese Option erwartet eine Liste mit durch Leerzeichen getrennten Werten. Der erste Wert ist die zu setzende Umgebungsvariable, die restlichen Werte sind der Inhalt der Variable. Wenn Sie beispielsweise die Umgebungsvariable RONALD auf McDonald setzen möchten, würden Sie diese Einstellung verwenden: -set-env RONALD McDonald -Das besondere an dieser Option ist, dass Sie sie mehrfach wiederholen können, ohne das die jeweils vorige set-evn-Option im gleichen Abschnitt der Konfigurationsdatei überschrieben wird. Auf diese Weise können Sie pro Modul und auch global mehrere Umgebungsvariablen setzen. - - - - -source-dir -Kann nicht überschrieben werden -Diese Option legt den Ordner auf Ihrer Festplatte fest, in dem die &kde; SVN-Quellen gespeichert werden sollen. Wenn Sie die Option nicht setzen, lautet die Voreinstellung ~/tdesvn. Falls Sie die Option benutzen möchten, müssen Sie einen absoluten Pfad angeben. - - - -svn-server -Kann nicht überschrieben werden -Mit dieser Option können Sie den zu verwendenden SVN-Server festlegen. Die Voreinstellung ist der Server für anonymes SVN svn://anonsvn.kde.org/.der - - - -stop-on-failure -Überschreibt die globale Option -Setzen Sie diese Option auf true, wenn tdesvn-build beendet werden soll, falls beim Kompilieren oder Installieren ein Fehler auftritt. Diese Einstellung ist in der Voreinstellung ausgeschaltet. - - - -tag -Überschreibt die globale Option -Benutzen Sie diese Option, um eine bestimmte Version eines Moduls herunterzuladen. -HINWEIS: Im Regelfall ist es sinnvoller, diese Option NICHT zu benutzen. Fertige KDE-Versionen können üblicherweise als Tar-Archiv von der KDE FTP-Seite oder einem der Softwarespiegel heruntergeladen werden. -Falls Sie tdesvn-build benutzen, weil Sie Schwierigkeiten mit der Installation einer fertigen KDE-Version haben, sollten Sie lieber Konstruct verwenden, welches grundsätzlich mit den KDE Release-Archiven arbeitet. - - - - -use-qt-builddir-hack -Überschreibt die globale Option -Zwar überschreibt diese Option die globale Option, jedoch ist sie nur sinnvoll für qt-copy einzusetzen. Wenn Sie die Option auf true einstellen, wird der experimentelle Kompilier-Modus eingeschaltet, bei dem Kompilier- und Quell-Ordner von qt-copy unterschiedlich sind. Wenn dies aktiviert ist, wird &tdesvn-build; die qt-copy-Quellen in den Kompilier-Ordner kopieren und dort kompilieren. Das hat zur Folge, dass die Umgebungsvariable TQTDIR auf $(qt-copy-build-dir)/qt-copy/lib eingestellt werden sollte. Außerdem sollten Sie die Option qtdir entsprechend anpassen. Auch in diesem Modus sollte noch inkrementelles Kompilieren möglich sein, weil die Zeitstempel auch noch nach der Kopie vorhanden sind. Wenn Sie apply-qt-patches verwenden, werden die Patches auf den Kompilier-Ordner angewandt, nicht auf den Quell-Ordner. Die Voreinstellung ist true. - - - -use-unsermake -Überschreibt die globale Option -Stellen Sie diese Option auf true, um das experimentelle Programm unsermake anstelle von automake zu verwenden. Dadurch kann die Kompilierzeit drastisch gesenkt werden, insbesondere wenn distcc eingesetzt wird. Diese Option ist voreingestellt auf true (für die meisten Module). - -Wenn Sie diese Option verwenden, wird unsermake normalerweise automatisch auf dem aktuellen Stand gehalten. Dies könnte aber lästig werden, wenn Sie unsermake lieber selbst verwalten. In dem Fall können Sie die Option auf self stellen. Dann wird unsermake verwendet, aber nicht automatisch durch tdesvn-build aktualisiert. - - - - - - -
- - - - -Befehlszeilen-Parameter und Umgebungsvariablen - -Dieses Skript verwendet keine Umgebungsvariablen. Falls Sie welche für den Kompilier- oder Installationsvorgang benötigen, lesen Sie bitte die Hinweise für die Option set-env. - -Das Skript kennt die folgenden Befehlszeilen-Parameter: - - - - - -Zeigt eine kurze Hilfe zur Verwendung an. - - - - -Zeigt die Programmversion an. - - - - -Zeigt Kontaktinformationen zum Autor des Skripts an. - - - - -Aktiviert die farbige Darstellung der Ausgaben. - - - - -Deaktiviert die farbige Darstellung der Ausgaben. - - - - (oder ) -Ein Durchlauf wird simuliert, aber nichts wirklich ausgeführt.NICHTS aus - - - - (oder ) -Reduziert die Ausgaben auf der Konsole auf ein Minimum. - - - - -Nur Warnungen und Fehler ausgeben. - - - - -Es werden ausführliche Ausgaben erzeugt, Sie können den genauen Ablauf verfolgen. - - - - -Führt nur das Aktualisieren der Quellen aus. - - - - -Führt nur den Kompiliervorgang durch. - - - - -die folgenden auf der Befehlszeile angegebenen Module werden bei der Aktualisierung/Kompilierung ignoriert. - - - - -Keine Verbindung zum SVN-Server herstellen.Nimmt - - - - -Den Kompiliervorgang überspringen. - - - - -Keine Pakete automatisch installieren, nachdem sie kompiliert wurden. - - - - -Aktiviert den Modus zur Fehlersuche. Dies bedeutet, dass alle Ausgaben auf STDOUT ausgegeben und zusätzlich im Protokoll abgelegt werden. Des Weiteren sind die meisten Funktionen wesentlich "gesprächiger". - - - - -Nicht versuchen, ein Modul nach einem Fehler erneut zu kompilieren. Es werden grundsätzlich keine Module neu kompiliert, bei denen es schon einen Versuch, erneut zu komplilieren, gegeben hat. - - - - -Aktualisiert das Kompilier-System und beginnt den Kompiliervorgang von vorne. - - - - -Führt das configure-Skript erneut aus, ohne den Kompilier-Ordner vorher zu bereinigen. - - - - -Führt make Makefile.cvs erneut aus und erzeugt das configure-Skript neu. Der restliche Kompiliervorgang ist dann ganz normal. Diese Option schließt automatisch ein. - - - - -Versucht, den Kompiliervorgang an der Stelle fortzusetzen, wo er zuletzt unterbrochen wurde. Diese Option schließt automatisch ein. Sie sollten keine weiteren Modul-Namen an der Kommandozeile übergeben. - - - - -Verhält sich wie , außer das Sie den Modul-Namen angeben können, bei dem fortgesetzt werden soll. Diese Option schließt automatisch ein. Sie sollten keine weiteren Modul-Namen auf der Kommandozeile übergeben. - - - - -Der darauf folgende Parameter ist die Konfigurationsdatei, aus der die Optionen eingelesen werden sollen. Die Voreinstellung für diesen Parameter ist ~/.tdesvn-buildrc. - - - - -Ermöglicht Ihnen, den Ordner zu wechseln, in dem &kde; installiert wird. Diese Option schließt automatisch ein. - - - - -Stoppt nach dem Ausführen von make Makefile.cvs. Das configure-Skript muss dennoch ausgeführt werden; &tdesvn-build; wird dies automatisch für Sie erledigen. Auf diese Weise können Sie alle configure-Skript in einem Durchlauf erzeugen; auf diese Weise können Sie für jedes Modul die Ausgabe von ./configure betrachten und entsprechende Optionen festlegen. - - - -Wenn dies der einzige Befehlszeilen-Parameter ist, wird versucht, alle Module zu installieren, die erfolgreich kompiliert wurden - mit Ausnahme von qt-copy, welches nicht installiert werden muss. Wenn Sie nach weiter Parameter angeben, werden diese als zu installierende Module interpretiert. - - - - -Dies können Sie verwenden, um eine Option in Ihrer Konfigurationsdatei für jedes Modul zu überschreiben. Beispiel: würde die Option log-dir überschreiben. - - - - -Dies können Sie verwenden, um eine Option in Ihrer Konfigurationsdatei für ein bestimmtes Modul zu überschreiben. Beispiel: Um die Option use-unsermake für tdemultimedia zu überschreiben, geben Sie ein. - - - - -Alle weiteren Parameter werden als Modul-Namen interpretiert, die aktualisiert oder kompiliert werden sollen. Verwechseln Sie Kompilieren nicht mit Installieren! - - - - -Danksagungen und Lizenz -&underFDL; - - diff --git a/tde-i18n-de/docs/tdesdk/tdesvn-build/CMakeLists.txt b/tde-i18n-de/docs/tdesdk/tdesvn-build/CMakeLists.txt new file mode 100644 index 00000000000..34b4d2ecfad --- /dev/null +++ b/tde-i18n-de/docs/tdesdk/tdesvn-build/CMakeLists.txt @@ -0,0 +1,6 @@ +# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer + +tde_create_handbook( + DESTINATION tdesvn-build + LANG de +) diff --git a/tde-i18n-de/docs/tdesdk/tdesvn-build/Makefile.am b/tde-i18n-de/docs/tdesdk/tdesvn-build/Makefile.am new file mode 100644 index 00000000000..fac4b6cdea0 --- /dev/null +++ b/tde-i18n-de/docs/tdesdk/tdesvn-build/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = de +SUBDIRS = $(AUTODIRS) +KDE_DOCS = tdesvn-build +KDE_MANS = AUTO diff --git a/tde-i18n-de/docs/tdesdk/tdesvn-build/index.docbook b/tde-i18n-de/docs/tdesdk/tdesvn-build/index.docbook new file mode 100644 index 00000000000..b08f367641f --- /dev/null +++ b/tde-i18n-de/docs/tdesdk/tdesvn-build/index.docbook @@ -0,0 +1,739 @@ + + + + + + Subversion"> + tdesvn-build"> +]> + + + + +Handbuch zu &tdesvn-build; + + +MichaelPyne
michael.pyne@kdemail.net
 + +CarlosWoelz
carloswoelz@imap-mail.com
 + + + +ThomasReitelbach
tr@erdfunkstelle.de
Deutsche Übersetzung + + + + +2005 +Michael Pyne + + + +2005 +Carlos Woelz + + + +&FDLNotice; + +2005-06-18 +0.98 + + +Das Skript &tdesvn-build; kompiliert und installiert &kde; direkt aus den Quelltexten des &kde;-SVN. + + + +KDE +tdesdk +SVN +Subversion +KDE-Entwicklung + + + + + + +Einführung + +Das Skript &tdesvn-build; hilft Benutzern bei der Installation von &kde; aus dem SVN. Bite beachten Sie auch das Skript kde-build, welches im &kde;-Modul "tdesdk" enthalten ist. + +An dieser Stelle sollen die Syntax der Konfigurationsdatei, die Optionen und die Befehlszeilenparameter von &tdesvn-build; beschrieben werden, die nötig sind, um &kde; aus den Quelltexten zu installieren. Dies schließt auch die Schritte ein, die Sie mit anderen Werkzeugen erledigen müssen - also Schritte, die nicht automatisch von &tdesvn-build; durchgeführt werden. + + + + +Erste Schritte + +In diesem Kapitel wird erklärt, wie Sie mit Hilfe von &tdesvn-build; die entsprechenden Module aus dem &kde;-Quellcodearchiv herunterladen und kompilieren. Desweiteren werden einige Grundlagen zur Struktur des &kde; SVN und die nötigen Schritte vor dem Ausführen des Skripts erklärt. + +Alle in diesem Kapitel angesprochene Punkte werden detaillierter in dem Dokument Building &kde; from Source Step by Step Guide auf der Webseite des &kde; Qualitäts-Sicherungsteam erklärt. Wenn Sie &kde; zum ersten Mal kompilieren, sollten Sie dieses Dokument lesen und bei Fragen als Referenz heranziehen. Darin finden Sie auch Informationen zu Paketierungs-Hilfsprogrammen, Kompilier-Voraussetzungen, häufigen Stolperfallen und allgemeinen Strategien zur Verwendung Ihrer neuen &kde;-Installation. + + +Vorbereiten des Systems zum Kompilieren von &kde; + +Zum Herunterladen und Kompilieren von &kde; sollten Sie ein normales Benutzerkonto verwenden. Wenn Sie bereits einige &kde;-Programme installiert haben, sollten Sie sogar ein neues, separates Benutzerkonto erzeugen und &kde; unter Verwendung des neuen Benutzers installieren und ausführen. Der Vorteil an dieser Vorgehensweise ist, dass Sie die bestehende &kde;-Installation nicht zerstören und das Sie normal weiterarbeiten können, falls mit der neuen Installation etwas nicht funktioniert. + +Sie können die Installation später immer noch systemweit als root durchführen. Das geht allerdings über den Rahmen dieses Handbuchs hinaus. Es wird davon ausgegangen, dass Sie wissen was Sie tun, wenn Sie eine systemweite Installation durchführen. + +Bevor Sie &tdesvn-build; (oder eine andere Kompiliermethode) verwenden, müssen Sie die Entwickler-Werkzeuge und -Bibliotheken für &kde; installieren. Sie benötigen Qt 3.3.0 oder neuer, Automake 1.8, Autoconf 2.5x (besser 2.57 oder neuer, weil es für ältere Versionen einen bekannten Bug gibt), den Subversion-Client (svn), den gcc-Compiler mit C++-Unterstützung, libxml2, openssl, libbz2 und einige weitere. Ein vollständige Liste finden Sie unter KDE Compilation Requirements. Üblicherweise werden die benötigen Hilfsprogramme und Bibliotheken mit Ihrer Distribution mitgeliefert und müssen evtl. nur nachinstalliert werden. + +Einige der benötigten Pakete werden von den Distributoren in Bibliotheken, Programmdateien oder Werkzeuge und Entwickler-Pakete unterteilt. In diesen Fällen benötigen Sie wenigstens die Programmdateien und das Entwicklungs-Paket. Wenn Sie unsicher sind, installieren Sie am besten alle Pakete zu einem Programm. Die benötigen Bibliotheken sind abhängig von dem KDE-Modul, welches Sie installieren möchten. Unter Building &kde; from Source Step by Step Guide finden Sie mehr Details über die einzelnen Hilfsprogramme und Techniken zur Installation der Abhängigkeiten. + +Wahrscheinlich haben Sie &tdesvn-build; bereits auf Ihrem System installiert. Nun müssen Sie die Konfigurationsdatei für &tdesvn-build; mit dem Namen .tdesvn-buildrc erzeugen. Die Datei sollte in Ihrem persönlichen Ordner (~/) liegen und entält alle benötigten Optionen und Einstellungen, Compiler-Optionen, den Speicherort der Quelldateien, das Installationsziel, die zu installierenden Module und so weiter. Die Voreinstellungen finden Sie in der Datei tdesvn-buildrc-sample. Weitere Informationen zur Syntax der Konfigurationsdatei können Sie in und nachlesen. + +Es ist nicht schwer, die neueste Version von &tdesvn-build; zu erhalten. Öffnen Sie die Seite tdesdk/scripts unter websvn.kde.org. In dem Ordner tdesdk/scripts finden Sie eine Liste der Dateien. Klicken Sie auf &tdesvn-build; und laden Sie die neueste Version herunter; ebenso laden Sie auch die Datei tdesvn-buildrc-sample auf Ihren Rechner. Machen Sie das Skript ausführbar und sorgen Sie dafür, dass es über die Umgebungsvariable PATH gefunden werden kann. + + + + +Festlegen der Einstellungen + +Damit das Skript funktioniert, müssen Sie die Datei .tdesvn-buildrc in Ihrem persönlichen Ordner haben, in der die allgemeinen Einstellungen festgelegt sind. + +Benutzen Sie die Datei tdesvn-buildrc-sample als Vorlage und stellen Sie die allgemeinen Optionen und die Module ein, die Sie installieren möchten. + +Wählen Sie den Server aus, den Sie für das Herunterladen der SVN-Arbeitskopie verwenden möchten. Den Server legen Sie mit der globalen Einstellung svn-server fest. Voreingestellt ist der Server für anonymes SVN: svn://anonsvn.kde.org, aber Sie können dies ändern, wenn Sie einen &kde; SVN-Zugang haben oder es einen Spiegel in Ihrer Nähe gibt. + +Geben Sie besonders acht auf die globalen Variablen tdedir und qtdir. tdedir legt den Zielordner fest, in dem &kde; installiert wird (voreingestellt ist ~/kde) und qtdir legt fest, wo Qt installiert ist bzw. ob es dort kompiliert und installiert werden soll (voreingestellt ist ~/tdesvn/build/qt-copy). Die hier festgelegten Einstellungen brauchen Sie später nochmal, um die Umgebungsvariablen zum Ausführen des neuen KDE richtig zu setzen. Prüfen Sie, ob die aufgeführten Module diejenigen sind, die Sie wirklich installieren möchten. Mit den Voreinstellungen aus tdesvn-buildrc-sample erhalten Sie eine weitgehend vollständige &kde;-Installation. Speichern Sie Ihre Einstellungen in die Datei .tdesvn-buildrc in Ihrem persönlichen Ordner. + +Wenn Sie Feineinstellungen an .tdesvn-buildrc vornehmen möchten, lesen Sie bitte in die detaillierten Informationen über alle Konfigurations-Optionen nach. + + + + +Verwenden von &tdesvn-build; + +Sie können das Skript nun ausführen. Melden Sie sich in einem Terminal-Fenster als der Benutzer an, den Sie zum Kompilieren und Installieren des neuen &kde; verwenden möchten, und führen Sie das Skript aus: %su Benutzername +%tdesvn-build + + + +Das Skript sollte nun mit dem Herunterladen der Quellen beginnen und sie kompilieren. Oft schlägt der erste Versuch, &kde; zu kompilieren, fehl. Geben Sie nicht auf! Prüfen Sie die Protokoll-Dateien; möglicherweise fehlt Ihnen noch ein Hilfsprogramm oder entsprechende Entwickler-Pakete. Der Pfad zu den Protokollen ist in der Einstellung log-dir in Ihrer Konfigurationsdatei festgelegt. Manchmal passiert es auch, dass ein KDE-Modul unstabil ist und sich daher nur unter erheblichem Aufwand kompilieren lässt. Haben Sie Geduld, derartige Probleme werden in der Regel sehr schnell behoben. Weitere Dinge, die häufig fehlschlagen, sowie die Lösungen und weitere grundsätzliche Tipps und Tricks zum Kompilieren von &kde; finden Sie im Building &kde; from Source Step by Step Guide. + + + + +Einrichten der neuen &kde;-Umgebung + +Im Folgenden wird davon ausgegangen, dass Sie einen separaten Benutzer zum Kompilieren und Installieren von &kde; verwendet haben. Des Weiteren wird davon ausgegangen, dass Sie bereits eine &kde;-Version installiert haben. Wenn dies der Fall ist, muss das neue &kde; Vorrang vor der alten Version erhalten. Bearbeiten Sie die Umgebungsvariablen entsprechend. + +Öffnen Sie die Datei .bash_profile in Ihrem persönlichen Ordner oder erzeugen Sie eine neue, falls sie noch nicht existiert. Am Ende der Datei fügen Sie folgendes ein: +TDEDIR=(pfad zu tdedir) +TDEDIRS=$TDEDIR +PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH +LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH +export TDEDIRS PATH LD_LIBRARY_PATH + Wenn Sie das Modul qt-copy installiert haben, fügen Sie dies stattdessen ein: TQTDIR=(pfad zu qtdir) +TDEDIR=(pfad zu tdedir) +TDEDIRS=$TDEDIR +PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH +MANPATH=$TQTDIR/doc/man:$MANPATH +LD_LIBRARY_PATH=$TDEDIR/lib:$TQTDIR/lib:$LD_LIBRARY_PATH +export TQTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH + + + +Wenn Sie keinen separaten Benutzer verwenden, ändern Sie die Umgebungsvariable $TDEHOME in .bash_profile für die neue Umgebung. export TDEHOME="${HOME}/.tde-svn" + +# Create it if needed +[ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn + + + + +Falls das KDE-Menü später leer oder völlig überfüllt mit Programmen Ihrer Distribution sein sollte, müssen Sie unter Umständen die xdb-Umgebungsvariable in .bash_profile anpassen: XDG_CONFIG_DIRS="/etc/xdg" +XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" +export XDG_CONFIG_DIRS XDG_DATA_DIRS + + + + + +Nun sollte die Umgebungsvariablen korrekt eingestellt sein. Stellen Sie nun sicher, dass die richtige Version des Start-Skripts starttde verwendet wird: + +Öffnen Sie die Datei .xinitrc (oder .xsession, abhängig von Ihrer Distribution) in Ihrem persönlichen Ordner. Erzeugen Sie sie, falls nötig. Fügen Sie die folgende Zeile hinzu: exec ${TDEDIR}/bin/starttde + + + +Starten Sie nun Ihre neues &kde;: In BSD und Linux mit Unterstützung für virtuelle Terminals können Sie die Tastenkombination Strg+Alt+F1...F12 zum wechseln zwischen den Terminals verwenden. Auf diese Weise können Sie mehrere Arbeitsumgebungen gleichzeitig ausführen. Die ersten sechs Terminals sind Text-Terminals, die folgenden sechs sind graphische Terminals. + +Falls beim Systemstart der graphische Anmeldungsmanager erscheint, können Sie Ihr neues KDE dennoch verwenden, auch wenn es nicht in der Liste für die graphische Anmeldung aufgeführt ist. Drücken Sie Strg+Alt+F2 um zu einem Text-Terminal zu gelangen. Melden Sie sich als der separate KDE-Benutzer an und geben Sie folgendes ein: + +startx -- :1 + + + +Sie können das frisch aus den Quellen installierte und das alte KDE gleichzeitig laufen lassen! Melden Sie sich als regulärer Benutzer wie gewohnt an und starten Sie KDE. Drücken Sie dann Strg+Alt+F2 (oder F1, F3, ...) um zu einem Text-Terminal zu gelangen. Melden Sie sich mit dem separaten KDE-Benutzer an und geben Sie "startx -- :1" ein. Mit der Tastenkombination Strg+Alt+F6 (oder F7, F8, etc.) können Sie zwischen den verschiedenen KDE-Sitzungen hin und her wechseln. Nun können Sie das neue KDE testen und wissen, dass Sie jederzeit zu Ihrer alten, stabilen Version zurückkehren können. + + + + + + + + +Besondere Funktionen des Skripts + +&tdesvn-build; beinhaltet die folgenden Funktionen und Besonderheiten: + + + + +Automatisches Herunterladen und Aktualisieren der nötigen Module aus dem SVN-Archiv. + +Zeitmessung für den Kompiliervorgang der Module. + +Automatisches Neu-Kompilieren von Modulen, die inkrementelles make verwenden (welches nach verschiedenen Arten von commits fehleranfällig ist). + +Fortsetzen eines vorherigen Skript-Durchlaufs und Starten des Kompiliervorgangs mit einem bestimmten Modul. + +Die voreingestellten Optionen sind gut geeignet für die Installation von &kde; aus dem SVN für einen einzelnen Benutzer. + +Direkte Unterstützung für Unsermake. + +Benutzung der Tilde als Platzhalter in den Optionen. Beispielsweise ist Folgendes ist möglich: qtdir ~/tdesvn/build/qt-copy + + +Kompilier-, Quell- und Protokoll-Ordner sind frei einstellbar. + +Automatisches herrichten einer Kompilierumgebung, in der der Kompilier-Ordner ungleich dem Quell-Ordner ist. Dadurch wird der Quell-Ordner "sauber" gehalten. Die einzige Ausnahme bildet hier qt-copy, welches nicht für diese Art des Kompilierens vorgesehen ist (es sei denn Sie möchten den Hack qt with a separate build directory hack ausprobieren). + +Es können sowohl globale Einstellungen für alle Module als auch spezifische Einstellungen für bestimmte Module vorgenommen werden. + +In manchen Fällen verlieren die autotools die Synchronisation mit dem Quell-Ordner; daher können Sie erzwingen, dass bestimmte Module vollständig neu kompiliert werden. Dazu müssen Sie im Quell-Ordner des fraglichen Moduls eine Datei namens .refresh-me anlegen oder &tdesvn-build; mit der Option aufrufen. + +Es können verschiedene Umgebungsvariablen benutzt werden, die den Kompiliervorgang beeinflussen. Dazu gehören unter anderem TDEDIR, TQTDIR, DO_NOT_COMPILE und CXXFLAGS. + +Befehls-Protokolle. Alle Protokolle werden durchnummeriert und mit einem Datums-Stempel versehen, sodass Sie pro Skript-Durchlauf ein Protokoll erhalten. Des Weiteren wird mit jedem Skript-Durchlauf ein symbolischer Link namens latest erzeugt, der auf das jeweils letzte Protokoll verweist. + +Wenn Sie &kde; für einen Benutzer anstatt systemweit installieren (wofür Sie Systemverwalter-Rechte benötigen würden), können Sie das Skript zum Installieren verwenden. Ich (der Autor von tdesvn-build) habe den Code des Skripts nicht begutachtet und es macht gebrauch von der Funktion system(); Sie sollten das Skript lieber nicht als Systemverwalter ausführen. + +Sie können make-install-prefix verwenden, um dem Kommando make install einen Befehl voranzustellen. Dies ist z. B. für die Verwendung von sudo nützlich. + +Mit Hilfe der Option apidox können Sie veranlassen, dass die API-Dokumentation für einige Module erzeugt und installiert wird. + +Sie können auch nur einzelne Teile von &kde; aus einem SVN-Modul herunterladen lassen. Beispielsweise könnten Sie nur taglib aus tdesupport herunterladen, oder nur K3b aus extragear/multimedia. Das Skript wird automatisch kde-common mit einbeziehen, falls dies zum Kompilieren nötig ist. + +Sie können alle Vorgänge vorgaukeln anstatt sie wirklich ausführen zu lassen. Benutzen Sie dazu die Option oder und das Skript wird eine detaillierte Beschreibung alle Befehle ausgeben, die es ausführen würde, ohne tatsächlich etwas zu unternehmen. + +Es ist möglich, verschiedene SVN-Verzweigungen für bestimmte Module zu verwenden. Die Unterstützung hierfür ist noch nicht ganz vollständig, sie können aber die zu verwendende Verzweigung (branch) mit der Einstellung module-base-path festlegen. + + + +Dinge, die &tdesvn-build; NICHT macht: + + + +Auffinden des schnellsten &kde; SVN-Spiegelservers. Derzeit wird mit dem Skript noch nichtmal eine Liste der Spiegelserver mitgeliefert. Außerdem sollte der Standard-Server problemlos funktionieren. + +Ihre Zähne putzen, das müssen Sie schon selbst erledigen ;-) + +Das Skript ist sicherlich nicht fehlerfrei - dafür schonmal vorab entschuldigung. + + + + + + +Das Format der Datei .tdesvn-buildrc + +Für die korrekte Funktion benötigt das Skript eine Datei namens .tdesvn-buildrc in Ihrem persönlichen Ordner. Diese beschreibt unter anderem die KDE-Module, die Sie herunterladen und installieren möchten. + + + +Zuerst werden die globalen Einstellungen wie folgt festgelegt: + +global +option-name option-wert +[...] +end global + + +Danach folgen eine oder mehrere Modul-Abschnitte, die wie folgt aussehen: + +module modul-name +option-name option-wert +[...] +end module + + +modul-name muss ein Modulname aus dem &kde; SVN-Archiv sein (z. B. tdelibs oder tdebase). Einige Optionen überschreiben die globalen Optionen, einige können zusätzlich zu globalen Optionen festgelegt werden und einige globale Optionen lassen sich gar nicht Modul-Spezifisch überschreiben. + +Im Folgenden sehen Sie eine alphabetisch geordnete Liste der möglichen Optionen. Klicken Sie auf eine Option, um mehr darüber zu erfahren. Falls eine Option nicht näher dokumentiert ist, schreiben Sie bitte eine E-Mail an den Autor. Die Adresse finden Sie hier. + + +apidox: Erstellen der API-Dokumentation +apply-qt-patches: Verbessern von Qt-copy mit einigen Patches +binpath: Zum Festlegen der Umgebungsvariable PATH +branch: Zum Herunterladen aus einer bestimmten branch anstelle von /trunk +build-dir: Legt den Kompilier-Ordner festO +checkout-only: Nur bestimmte Teile eines Moduls herunterladen +colorful-output: Farbige Darstellung der Skript-Ausgaben +configure-flags: Legt fest, welche Parameter an configure eines bestimmten Moduls übergeben werden sollen. +cxxflags: Legt den Inhalt der Umgebungsvariable CXXFLAGS fest +dest-dir: Zum Ändern des Ordner-Namens für ein Modul +disable-agent-check: Verhindert die Prüfung des Status für den SSH-Agenten +do-not-compile: Schließt bestimmte Ordner vom Kompiliervorgang aus +inst-apps: Hiermit werden nur bestimmte Ordner kompiliert und installiert +install-after-build: Hierdurch kann die Installation nach dem Kompilieren verhindert werden +tdedir: Legt den Zielordner für die KDE-Installation fest +libpath: Legt den Inhalt der Umgebungsvariable LD_LIBRARY_PATH fest +make-install-prefix: Zum Ausführen eines Hilfsprogrammes vor make install (z. B. sudo) +make-options: Übergibt bestimmte Optionen an das Programm make +manual-build: Verhindert das automatische Kompilieren eines Moduls +manual-update: Verhindert das automatische Aktualisieren eines Moduls +module-base-path: Ändert den Pfad, aus dem ein Modul heruntergeladen werden soll (nützlich für SVN-Verzweigungen und -Tags) +niceness: Ändert die Laufzeit-Priorität des Skripts +no-rebuild-on-fail: Verhindert den erneuten Durchlauf von make nach einem Fehler +qtdir: Legt den Pfad zu Qt fest +set-env: Zum Einstellen einer UmgebungsvariableFestlegen +source-dir: Ändert den Pfad für heruntergeladene Quellen +stop-on-failure: Beendet tdesvn-build sobald ein Fehler auftritt +svn-server: Ändert den Server, von dem die Quellen heruntergeladen werden +use-qt-builddir-hack: Legt fest, dass für Qt separate Quell- und Kompilier-Ordner verwendet werden sollen (so wie bei KDE auch) +use-unsermake: Verwendung des erweiterten Kompilier-Systems unsermake + + + +Im Folgenden finden Sie eine Tabelle mit verschiedenen Optionen und einigen Kommentaren dazu. Optionen, die eine globale Option überschreiben, werden auch den entsprechenden Parameter auf der Kommandozeile überschreiben. + + +Tabelle der Optionen + + + + +Name der Option +Modul -> Globales Verhalten +Anmerkungen + + + + + + +apidox +Überschreibt die globale Option +Stellen Sie die Option auf true, so wird &tdesvn-build; die API-Dokumentation für das Modul erzeugen und installieren. Dies funktioniert nur mit Modulen, die den Befehl make apidox unterstützen (inklusive tdelibs, tdebase, koffice und weiteren). + + + +apply-qt-patches +Überschreibt die globale Option +Diese Option ist nur für qt-copy sinnvoll. Wenn Sie auf einen Wert ungleich Null eingestellt ist, wird das apply-patches-Skript in qt-copy vor dem Kompilieren ausgeführt. Dadurch werden einige inoffizielle Patches auf qt-copy angewandt. Normalerweise sind gerade diese Patches der Grund, qt-copy zu verwenden. Daher sollten Sie diese Option bedenkenlos aktivieren können. Standardmäßig werden die Patches auf qt-copy angewandt. + + + +binpath +Kann nicht überschrieben werden +Mit dieser Option können Sie die Umgebungsvariable PATH für den Kompiliervorgang festlegen. Diese Option lässt sich nicht mit einer Modul-Option überschreiben. Die Voreinstellung ist /bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin. Diese Umgebungsvariable sollte die Pfade zu den notwendigen Entwicklungs-Werkzeugen beinhalten. Die Pfade $TDEDIR/bin und $TQTDIR/bin werden automatisch hinzugefügt. Sie können auch die Tilde (~) für Pfadangaben verwenden. + + + + +branch +Überschreibt die globale Option +Mit dieser Option legen Sie fest, dass die Quellen aus einem bestimmten SVN-Branch anstelle von "trunk" heruntergeladen werden sollen. Um beispielsweise KDE 3.4 herunterzuladen, stellen Sie die Option auf "3.4" ein. +Beachten Sie, dass einige Module unterschiedliche Namen für ein SVN-Branch verwenden. Hier ist insbesondere aRts zu erwähnen, welches andere Versionsnummern als KDE verwendet. Die mit KDE 3.4 ausgelieferte Version von aRts war beispielsweise 1.4. +Das das Herunterladen einer Branch mit dieser Option fehlschlägt, müssen Sie möglicherweise die korrekte Adresse zum Herunterladen manuell eingeben. Verwenden Sie dazu die Option override-url. + + + + +build-dir +Überschreibt die globale Option +Verwenden Sie diese Option zum Ändern des Ordners, in dem die Quellen kompiliert werden sollen. Sie können diese Option auf drei Arten verwenden: Relativ zum &kde; SVN Quellordner (siehe die Option source-dir). Dies ist die Voreinstellung und außerdem die Art und Weise, wie es bis zur Skript-Version 0.61 funktioniert hat. Dieser Modus wird automatisch verwendet, wenn Sie einen Ordner-Namen eingeben, der nicht mit einer Tilde (~) oder einem Schrägstrich (/) beginnt. Die Voreinstellung ist build. Absoluter Pfad. Wenn Sie einen Pfad eingeben, der mit einem Schrägstrich (/) beginnt, so wird dieser Pfad wie eingegeben verwendet. Beispiel: /tmp/kde-obj-dir/. Relativ zum persönlichen Ordner. Wenn Sie einen Pfad angeben, der mit einer Tile (~) beginnt, so wird der Pfad als relativ zu Ihrem persönlichen Ordner angesehen. Dies funktioniert analog zu der Art und Weise, wie die Shell eine Tilde interpretiert. Beispiel: ~/builddir würde den Kompilier-Ordner auf /home/benutzer/builddir einstellen. Diese Option kann pro Modul separat eingestellt werden. + + + +checkout-only +Überschreibt die globale Option +Mit Hilfe dieser Option können Sie SVN-Module Stück für Stück herunterladen. Die Einstellung für diese Option sollte eine durch Komma getrennte Liste der herunterzuladenden Ordner sein. Wenn Sie den admin-Ordner nicht angeben, wird er automatisch heruntergeladen (falls nötig). Wenn Sie Stück für Stück herunterladen, wird der admin-Ordner aus kde-common eingefügt. Zwar überschreibt diese Option die globale Version, es ist jedoch dennoch nicht sinnvoll, die Option global einzustellen. + + + +configure-flags +Wird der globalen Option angefügt (ausgenommen für qt-copy) +Mit Hilfe dieser Option können Sie die Parameter festlegen, die dem Skript ./configure für das jeweilige Modul übergeben werden. Wenn Sie diese Option global einstellen, wird sie für alle Module angewandt. Für qt-copy wird ein völlig anderer Satz configure-Parameter benutzt als für &kde;, daher überschreibt die Option die globale Einstellung, wenn sie für qt-copy eingestellt wird. + + + +colorful-output +Kann nicht überschrieben werden +Wenn Sie diese Option auf false setzen, wird die farbige Ausgabe von &tdesvn-build; unterbunden. Die Voreinstellung ist true. Beachten Sie, dass &tdesvn-build; die Farbcodes nur auf ein Terminal ausgibt (wie beispielsweise xterm, &konsole; oder die normale Linux-Konsole). + + + +cxxflags +Wird der globalen Option angefügt +Mit dieser Option können Sie die Parameter festlegen, die ./configure als CXXFLAGS übergeben werden sollen. Diese Option wird hier festgelegt und nicht einfach configure-flags mit angehängt, weil sie auch die Umgebungsvariable CXXFLAGS während dem Kompilieren setzt. + + + +dest-dir +Überschreibt die globale Option +Mit dieser Option können Sie den Modul-Namen für Ihre lokale Kopie auf der Festplatte festlegen. Das Modul extragear/network könnten Sie beispielsweise extragear-network nennen. + + + +disable-agent-check +Kann nicht überschrieben werden +Wenn Sie SSH zum Herunterladen der Quellen aus SVN verwenden, wird tdesvn-build versuchen sicherzustellen, dass Ihr SSH-Agent auch einige SSH-Identitäten verwaltet. Auf diese Weise soll verhindert werden, dass Sie andauern zur Passworteingabe aufgefordert werden. Sie können diese Prüfung unterbinden, indem Sie die Option auf true stellen. + + + +do-not-compile +Überschreibt die globale Option +Mit dieser Option wird die Umgebungsvariable DO_NOT_COMPILE gesetzt, bevor das configure-Skript ausgeführt wird. Laut der &kde; Entickler-FAQ sollten auf diese Weise alle Haupt-Ordner beim Kompilieren übersprungen werden, die mit dieser Variable übergeben werden. Trennen Sie mehrere Ordnerangaben durch Leerzeichen. + +Beachten Sie, dass die Quellen zu den übersprungenen Programmen dennoch heruntergeladen werden. Um auch dies zu unterbinden, können Sie die Option checkout-only verwenden. Geben Sie mit dieser Option nur die Ordner an, die Sie herunterladen möchten. + + + + +email-address +Kann nicht überschrieben werden + +Mit dieser Option können Sie die E-Mail-Adresse festlegen, die tdesvn-build; als Absender verwenden soll, falls das Senden einer E-Mail nötig sein sollte. Sie können diese Option vernachlässigen, wenn Sie keine Funktionen benutzen, die E-Mails senden. (Diese Funktionen sind in der Voreinstellung deaktiviert.) + +Derzeit benötigt nur email-on-compile-error diese Option. + + + + +email-on-compile-error +Kann nicht überschrieben werden + +Mit dieser Option können Sie die E-Mail-Adresse festlegen, an die eine Nachricht gesendet werden soll, falls sich ein Modul nicht kompilieren lässt. tdesvn-build wartet ab, bis alle Module bearbeitet wurden und sendet dann einen Sammelbericht über die fehlgeschlagenen Module per E-Mail. Es wird nur eine E-Mail gesendet, falls ein Modul fehlschlägt. + +Bitte beachten Sie die Option email-address, mit der die Absenderadresse für diese Funktion eingestellt wird. Die Voreinstellung ist üblicherweise nicht zufriedenstellend. + + + + +inst-apps +Überschreibt die globale Option +Dies ist das Gegenteil zu der Option do-not-compile. Mit dieser Option legen Sie fest, dass nur bestimmte Hauptordner kompiliert werden sollen. Mehrere Ordnerangaben müssen mit Leerzeichen getrennt werden. + +Änderungen an dieser Option werden erst angewendet, nachdem das nächste Mal make Makefile.cvs aufgerufen wurde; entweder automatisch, durch das Skript oder manuell durch die Option oder . + +Beachten Sie, dass die Quellen zu den übersprungenen Programmen dennoch heruntergeladen werden. Um auch dies zu unterbinden, können Sie die Option checkout-only verwenden. Geben Sie mit dieser Option nur die Ordner an, die Sie herunterladen möchten. + + + + +install-after-build +Überschreibt die globale Option +Diese Option legt fest, dass ein Paket nach erfolgreichem Kompilieren installiert werden soll. Dies ist in der Voreinstellung eingeschaltet. Wenn Sie dieses Verhalten nicht wünschen, stellen Sie die Option auf 0. Sie können analog auch den Befehlszeilen-Parameter verwenden. + + + +tdedir +Kann nicht überschrieben werden +Mit dieser Option wird der Zielordner festgelegt, in den &kde; nach dem Kompilieren installiert wird. Die Voreinstellung ist ~/kde. Wenn Sie hier einen Ordner einstellen, für den Systemverwalter-Rechte benötigt werden, sollten Sie auch die Anmerkungen zur Option make-install-prefix lesen. + + + +libpath +Kann nicht überschrieben werden +Mit dieser Option wird die Umgebungsvariable LD_LIBRARY_PATH für den Kompiliervorgang gesetzt. Sie können die Option für jedes Modul separat einstellen. In der Voreinstellung ist sie nicht gesetzt, aber die Pfade $TDEDIR/lib und $TQTDIR/lib werden automatisch hinzugefügt. Sie können für Pfadangaben auch die Tile (~) benutzen. + + + +log-dir +Überschreibt die globale Option +Diese Option wird zum Ändern des Ordners für Protokoll-Dateien des Skripts verwendet. Seit der Version 0.64 können Sie die Option auch pro Modul einstellen. + + + +make-install-prefix +Überschreibt die globale Option +Geben Sie für diese Variable eine Liste mit Befehlen ein. Mehrere Befehle werden durch Leerzeichen getrennt. Die hier eingegebenen Befehle werden vor jedem Aufruf von make install ausgeführt. Dies ist hilfreich, wenn Sie für die Installation einiger Pakete Systemverwalter-Rechte benötigen und daher z. B. sudo aufrufen müssen. Bitte seien Sie umsichtig im Umgang mit Systemverwalter-Rechten! + + + +make-options +Überschreibt die globale Option +Mit Hilfe dieser Variable können Sie Befehlszeilen-Parameter an make übergeben. Dies kann beispielsweise zur Verwendung von distcc nützlich sein. Mit distcc ist es möglich, den Kompiliervorgang auf mehrere Rechner zu verteilen. Um es zu verwenden, müssen Sie die Option an make übergeben; mit dieser Einstellung ist das möglich. Wenn man nach der Dokumentation geht, entspricht die richtige Einstellung 2 * anzahl_netzwerk_prozessoren. Bei nur einer CPU ist die korrekte Einstellung. + + + +manual-build +Überschreibt die globale Option +Stellen Sie diese Option auf true, um zu verhindern, dass tdesvn-build dieses Modul kompiliert. Es wird dennoch weiterhin aktualisiert werden, wenn Quellen aus SVN heruntergeladen werden. Diese Option entspricht dem Befehlszeilen-Parameter . + + + +manual-update +Überschreibt die globale Option +Stellen Sie diese Option auf true, um zu verhindern, dass tdesvn-build dieses Modul aktualisiert (und auch nicht kompiliert und installiert). Wenn Sie diese Option so verwenden, entspricht das im Grunde dem Auskommentieren - es wird völlig übergangen. + + + +module-base-path +Überschreibt die globale Option +Mit dieser Option können Sie den in &tdesvn-build; voreingestellten Pfad zu einem Modul übergehen. Dies kann zum Beispiel verwendet werden, um für ein Modul eine besondere branch oder eine als tag vorhandene Version herunterzuladen. Bei der Suche nach dem richtigen Pfad kann Ihnen das &kde; WebSVN behilflich sein. +Beachten Sie: &tdesvn-build; setzt den Pfad nach dem folgenden Schema zusammen: $svn-server/home/kde/$module-base-path$modul-name. +Die Voreinstellung ist entweder trunk oder trunk/KDE, je nach Modul-Name. + + + + +niceness +Kann nicht überschrieben werden +Diese Option können Sie auf einen Wert zwischen 20 und 0 einstellen. Je höher die Zahl, desto niedriger ist die Laufzeit-Priorität für &tdesvn-build;. Die Voreinstellung ist 10. + + + +no-rebuild-on-fail +Überschreibt die globale Option +Stellen Sie diese Option auf true, wenn Sie verhindern möchten, dass &tdesvn-build; ein Modul erneut kompiliert, wenn inkrementelles Kompilieren fehlgeschlagen ist. Normalerweise versucht &tdesvn-build;, ein Modul erneut von vorne zu kompilieren, falls ein SVN update den Kompiliervorgang durcheinander gebracht haben sollte. + + + +override-url +Überschreibt die globale Option +Wenn Sie diese Option einstellen, wird tdesvn-build den eingestellten Wert unverändert als Adresse an Subversion übergeben. Sie können diese Option grundsätzlich verwenden, um eine bestimmte Programmversion herunterzuladen. Dann kann tdesvn-build allerdings nichts mit der Option branch anfangen. + + + +qtdir +Kann nicht überschrieben werden +Diese Option setzt die Umgebungsvariable TQTDIR für den Kompiliervorgang. Sie können die Einstellung nicht für einzelne Module überschreiben. Wenn Sie dies nicht setzen, lautet die Voreinstellung $(source-dir)/build/qt-copy; somit wird die mit &kde; ausgelieferte Version von qt-copy verwendet. Sie können die Tilde (~) verwenden. + + + +remove-after-install +Überschreibt die globale Option +Wenn Sie wenig Festplattenspeicher zur Verfügung haben, können Sie mit Hilfe dieser Option alle Kompilier-Ordner (oder zusätzlich auch den Quell-Ordner) nach der erfolgreichen Installation löschen lassen. +Die möglichen Einstellungen für diese Option sind: +none - Nichts wird gelöscht (dies ist die Voreinstellung). +builddir - Kompilier-Ordner werden gelöscht, aber keine Quell-Ordner. +all - Sowohl Kompilier- als auch Quell-Ordner weren gelöscht. + + + +Beachten Sie: Die Verwendung dieser Option kann eine negative Auswirkung auf Ihre Internet-Bandbreite und die Gesamtdauer einer KDE-Installation haben, weil tdesvn-build nicht mehr inkrementell kompilieren kann und die Pakete unter Umständen immer wieder neu herunterladen muss. Dies ist insbesondere der Fall, wenn Sie die Option auf all einstellen. + + + + +set-env +Überschreibt die globale Option +Diese Option erwartet eine Liste mit durch Leerzeichen getrennten Werten. Der erste Wert ist die zu setzende Umgebungsvariable, die restlichen Werte sind der Inhalt der Variable. Wenn Sie beispielsweise die Umgebungsvariable RONALD auf McDonald setzen möchten, würden Sie diese Einstellung verwenden: +set-env RONALD McDonald +Das besondere an dieser Option ist, dass Sie sie mehrfach wiederholen können, ohne das die jeweils vorige set-evn-Option im gleichen Abschnitt der Konfigurationsdatei überschrieben wird. Auf diese Weise können Sie pro Modul und auch global mehrere Umgebungsvariablen setzen. + + + + +source-dir +Kann nicht überschrieben werden +Diese Option legt den Ordner auf Ihrer Festplatte fest, in dem die &kde; SVN-Quellen gespeichert werden sollen. Wenn Sie die Option nicht setzen, lautet die Voreinstellung ~/tdesvn. Falls Sie die Option benutzen möchten, müssen Sie einen absoluten Pfad angeben. + + + +svn-server +Kann nicht überschrieben werden +Mit dieser Option können Sie den zu verwendenden SVN-Server festlegen. Die Voreinstellung ist der Server für anonymes SVN svn://anonsvn.kde.org/.der + + + +stop-on-failure +Überschreibt die globale Option +Setzen Sie diese Option auf true, wenn tdesvn-build beendet werden soll, falls beim Kompilieren oder Installieren ein Fehler auftritt. Diese Einstellung ist in der Voreinstellung ausgeschaltet. + + + +tag +Überschreibt die globale Option +Benutzen Sie diese Option, um eine bestimmte Version eines Moduls herunterzuladen. +HINWEIS: Im Regelfall ist es sinnvoller, diese Option NICHT zu benutzen. Fertige KDE-Versionen können üblicherweise als Tar-Archiv von der KDE FTP-Seite oder einem der Softwarespiegel heruntergeladen werden. +Falls Sie tdesvn-build benutzen, weil Sie Schwierigkeiten mit der Installation einer fertigen KDE-Version haben, sollten Sie lieber Konstruct verwenden, welches grundsätzlich mit den KDE Release-Archiven arbeitet. + + + + +use-qt-builddir-hack +Überschreibt die globale Option +Zwar überschreibt diese Option die globale Option, jedoch ist sie nur sinnvoll für qt-copy einzusetzen. Wenn Sie die Option auf true einstellen, wird der experimentelle Kompilier-Modus eingeschaltet, bei dem Kompilier- und Quell-Ordner von qt-copy unterschiedlich sind. Wenn dies aktiviert ist, wird &tdesvn-build; die qt-copy-Quellen in den Kompilier-Ordner kopieren und dort kompilieren. Das hat zur Folge, dass die Umgebungsvariable TQTDIR auf $(qt-copy-build-dir)/qt-copy/lib eingestellt werden sollte. Außerdem sollten Sie die Option qtdir entsprechend anpassen. Auch in diesem Modus sollte noch inkrementelles Kompilieren möglich sein, weil die Zeitstempel auch noch nach der Kopie vorhanden sind. Wenn Sie apply-qt-patches verwenden, werden die Patches auf den Kompilier-Ordner angewandt, nicht auf den Quell-Ordner. Die Voreinstellung ist true. + + + +use-unsermake +Überschreibt die globale Option +Stellen Sie diese Option auf true, um das experimentelle Programm unsermake anstelle von automake zu verwenden. Dadurch kann die Kompilierzeit drastisch gesenkt werden, insbesondere wenn distcc eingesetzt wird. Diese Option ist voreingestellt auf true (für die meisten Module). + +Wenn Sie diese Option verwenden, wird unsermake normalerweise automatisch auf dem aktuellen Stand gehalten. Dies könnte aber lästig werden, wenn Sie unsermake lieber selbst verwalten. In dem Fall können Sie die Option auf self stellen. Dann wird unsermake verwendet, aber nicht automatisch durch tdesvn-build aktualisiert. + + + + + + +
+ + + + +Befehlszeilen-Parameter und Umgebungsvariablen + +Dieses Skript verwendet keine Umgebungsvariablen. Falls Sie welche für den Kompilier- oder Installationsvorgang benötigen, lesen Sie bitte die Hinweise für die Option set-env. + +Das Skript kennt die folgenden Befehlszeilen-Parameter: + + + + + +Zeigt eine kurze Hilfe zur Verwendung an. + + + + +Zeigt die Programmversion an. + + + + +Zeigt Kontaktinformationen zum Autor des Skripts an. + + + + +Aktiviert die farbige Darstellung der Ausgaben. + + + + +Deaktiviert die farbige Darstellung der Ausgaben. + + + + (oder ) +Ein Durchlauf wird simuliert, aber nichts wirklich ausgeführt.NICHTS aus + + + + (oder ) +Reduziert die Ausgaben auf der Konsole auf ein Minimum. + + + + +Nur Warnungen und Fehler ausgeben. + + + + +Es werden ausführliche Ausgaben erzeugt, Sie können den genauen Ablauf verfolgen. + + + + +Führt nur das Aktualisieren der Quellen aus. + + + + +Führt nur den Kompiliervorgang durch. + + + + +die folgenden auf der Befehlszeile angegebenen Module werden bei der Aktualisierung/Kompilierung ignoriert. + + + + +Keine Verbindung zum SVN-Server herstellen.Nimmt + + + + +Den Kompiliervorgang überspringen. + + + + +Keine Pakete automatisch installieren, nachdem sie kompiliert wurden. + + + + +Aktiviert den Modus zur Fehlersuche. Dies bedeutet, dass alle Ausgaben auf STDOUT ausgegeben und zusätzlich im Protokoll abgelegt werden. Des Weiteren sind die meisten Funktionen wesentlich "gesprächiger". + + + + +Nicht versuchen, ein Modul nach einem Fehler erneut zu kompilieren. Es werden grundsätzlich keine Module neu kompiliert, bei denen es schon einen Versuch, erneut zu komplilieren, gegeben hat. + + + + +Aktualisiert das Kompilier-System und beginnt den Kompiliervorgang von vorne. + + + + +Führt das configure-Skript erneut aus, ohne den Kompilier-Ordner vorher zu bereinigen. + + + + +Führt make Makefile.cvs erneut aus und erzeugt das configure-Skript neu. Der restliche Kompiliervorgang ist dann ganz normal. Diese Option schließt automatisch ein. + + + + +Versucht, den Kompiliervorgang an der Stelle fortzusetzen, wo er zuletzt unterbrochen wurde. Diese Option schließt automatisch ein. Sie sollten keine weiteren Modul-Namen an der Kommandozeile übergeben. + + + + +Verhält sich wie , außer das Sie den Modul-Namen angeben können, bei dem fortgesetzt werden soll. Diese Option schließt automatisch ein. Sie sollten keine weiteren Modul-Namen auf der Kommandozeile übergeben. + + + + +Der darauf folgende Parameter ist die Konfigurationsdatei, aus der die Optionen eingelesen werden sollen. Die Voreinstellung für diesen Parameter ist ~/.tdesvn-buildrc. + + + + +Ermöglicht Ihnen, den Ordner zu wechseln, in dem &kde; installiert wird. Diese Option schließt automatisch ein. + + + + +Stoppt nach dem Ausführen von make Makefile.cvs. Das configure-Skript muss dennoch ausgeführt werden; &tdesvn-build; wird dies automatisch für Sie erledigen. Auf diese Weise können Sie alle configure-Skript in einem Durchlauf erzeugen; auf diese Weise können Sie für jedes Modul die Ausgabe von ./configure betrachten und entsprechende Optionen festlegen. + + + +Wenn dies der einzige Befehlszeilen-Parameter ist, wird versucht, alle Module zu installieren, die erfolgreich kompiliert wurden - mit Ausnahme von qt-copy, welches nicht installiert werden muss. Wenn Sie nach weiter Parameter angeben, werden diese als zu installierende Module interpretiert. + + + + +Dies können Sie verwenden, um eine Option in Ihrer Konfigurationsdatei für jedes Modul zu überschreiben. Beispiel: würde die Option log-dir überschreiben. + + + + +Dies können Sie verwenden, um eine Option in Ihrer Konfigurationsdatei für ein bestimmtes Modul zu überschreiben. Beispiel: Um die Option use-unsermake für tdemultimedia zu überschreiben, geben Sie ein. + + + + +Alle weiteren Parameter werden als Modul-Namen interpretiert, die aktualisiert oder kompiliert werden sollen. Verwechseln Sie Kompilieren nicht mit Installieren! + + + + +Danksagungen und Lizenz +&underFDL; + + diff --git a/tde-i18n-es/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt b/tde-i18n-es/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt deleted file mode 100644 index bf1f4526fcd..00000000000 --- a/tde-i18n-es/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt +++ /dev/null @@ -1,6 +0,0 @@ -# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer - -tde_create_handbook( - DESTINATION tdesvn-build - LANG es -) diff --git a/tde-i18n-es/docs/tdesdk/scripts/tdesvn-build/Makefile.am b/tde-i18n-es/docs/tdesdk/scripts/tdesvn-build/Makefile.am deleted file mode 100644 index 989cf9ef462..00000000000 --- a/tde-i18n-es/docs/tdesdk/scripts/tdesvn-build/Makefile.am +++ /dev/null @@ -1,4 +0,0 @@ -KDE_LANG = es -SUBDIRS = $(AUTODIRS) -KDE_DOCS = tdesvn-build -KDE_MANS = AUTO diff --git a/tde-i18n-es/docs/tdesdk/scripts/tdesvn-build/index.docbook b/tde-i18n-es/docs/tdesdk/scripts/tdesvn-build/index.docbook deleted file mode 100644 index 46726200534..00000000000 --- a/tde-i18n-es/docs/tdesdk/scripts/tdesvn-build/index.docbook +++ /dev/null @@ -1,739 +0,0 @@ - - - - - - Subversion"> - tdesvn-build"> -]> - - - - -Manual del script &tdesvn-build; - - -MichaelPyne
michael.pyne@kdemail.net
 - -CarlosWoelz
carloswoelz@imap-mail.com
 - - - - Marcos Fouces Lago
mfouces@yahoo.es
 Traductor - - - - -2005 -Michael Pyne - - - -2005 -Carlos Woelz - - - -&FDLNotice; - -2005-06-18 -0.98 - - -&tdesvn-build; es un script en Perl que compila e instala &kde; directamente a partir del código fuente descargado desde el repositorio &svn; de &kde;. - - - -KDE -tdesdk -SVN -Subversion -Desarollo de KDE - - - - - - -Introducción - -&tdesvn-build; es un pequeño script escrito en Perl para ayudarle a instalar &kde; desde el repositorio &svn;. También debería echar un vistazo al script kde-build incluido en el módulo tdesdk de &kde;. - -Aquí se explican la sintaxis y opciones del archivo de configuración, sus argumentos a la hora de invocarlo, características de &tdesvn-build;. También se describen todos los pasos necesarios para compilar &kde; a partir de su código fuente, incluyendo lo que deberá hacer con otros programas, es decir lo que &tdesvn-build; no hace automáticamente. - - - - -Primeros pasos - -En este capítulo se muestra el uso de &tdesvn-build; para descargar módulos del repositorio de &kde; y compilarlos. También se explica un poco la estructura del repositorio &svn; de &kde; y los preparativos a realizar antes de ejecutar este script. - -Todos los asuntos presentes en este capítulo están explicados con mayor detalle en el artículo Building &kde; from Source Step by Step Guide (en inglés) de la web de Equipo de Calidad de &kde;. Si es la primera vez que compila KDE es recomendable que lo lea antes. Encontrará información detallada sobre la herramientas de empaquetado, programas útiles, errores más frecuentes así como mucha información para usar su nuevo &kde;. - - -Preparación del sistema para compilar &kde;. - -Es aconsejable que descargue y compile &kde; desde una cuenta de usuario corriente. Si ya tiene instalado &kde; en su sistema, lo mejor es que cree una cuenta de usuario exclusivamente para ejecutar el nuevo &kde;. La ventaja de esto es que no será posible estropear el sistema base pudiendo entrar con su cuenta habitual si algo sale mal. - -Si lo desea puede instalarlo en el sitema para que esté disponible para todos los usuarios aunque esto no se explica aquí. Si tiene intención de hacerlo seguramente ya sabrá bien lo que hace. - -Antes de usar &tdesvn-build; (o de cualquier otra herramienta de compilación) deberá instalar las herramientas y librerías de desarrollo de &kde;. Necesitará la versión 3.3.0 o superior de las librerías Qt, Automake 1.8, Autoconf 2.5x o superior (mejor si es 2.57 o superior ya que las versiones anteriores tienen un pequeño fallo), el cliente subversion (svn), el compilador gcc con soporte para C++, libxml2, openssl, libbz2 entre otros. Puede ver una lista completa en los requisitos de compilación de KDE 3.4. Es muy probable que estos paquetes ya vengan incluidos en su distribución. - -Muchos de esos paquetes se subdividen en librerías, programas, utilidades y encabezados (generalmente designados como "devel" o "dev"). Necesita como mínimo los programas y librerías así como los paquetes de desarrollo asociados a estos. Si no está seguro, es una buena idea instalarlos todos. Los paquetes necesarios dependen del módulo que quiere construir. En Building &kde; from Source Step by Step Guide encontrará más detalles sobre cómo encontrar e instalar el software necesario. - -Seguramente ya tiene instalado &tdesvn-build; en su sistema. &tdesvn-build; necesita que usted cree el archivo de configuración .tdesvn-buildrc en su directorio home (~/) con toda la información necesaria para que pueda ejecutarse: opciones de configuración, opciones de compilación, localización del código, localización de la instalación (prefijo), los módulos a compilar, &etc;. El archivo tdesvn-buildrc-sample le servirá de guía. Tiene más información sobre la sintaxis de este archivo de configuración en y en . - -Una buena manera de obtener la última versión es mirando en la página de tdesdk/scripts en websvn.kde.org. Verá una lista de archivos disponibles en ese directorio del &kde;&svn;. Pulse en &tdesvn-build; y descargue la última versión. Haga lo mismo para tdesvn-buildrc-sample. No olvide darle permiso de ejecución. - - - - -Información de configuración - -Para usar este script será necesario tener en su directorio home un archivo llamado .tdesvn-buildrc donde se definen las opciones generales así como los módulos que desea descargar y compilar. - -Utilice tdesvn-buildrc-sample como base para su archivo. - -Seleccione el servidor &svn; desde el que quiere descargar mediante la opción svn-server. Por defecto se define el repositorio &svn; anónimo en svn://anonsvn.kde.org/, pero si tiene una cuenta de acceso al &svn; de &kde; , o existe una réplica más cercana a usted. deberá modifiar este parámetro. - -Preste especial atención a las variables tdedir y qtdir, la primera define donde se instalará la versión de &kde; que se compile (por defecto irá en ~/kde), y la segunda donde se instalarán las librerías qt,en caso de que también se compilen (por defecto van en ~/tdesvn/build/qt-copy). Necesitará conocer el valor de ambas variables más adelante al definir las variables de entorno para ejecutar la nueva instalación. Compruebe si la lista de módulos es realmente la que quiere compilar, por defecto en tdesvn-buildrc-sample se define una instalación bastante completa de &kde;. Realice los cambios oportunos y guárdelos como .tdesvn-buildrc en su directorio home. - -Si desea afinar más la configuración de .tdesvn-buildrc, en tiene información detallada sobre todas las opciones de configuración. - - - - -Uso del script &tdesvn-build; - -Ahora ya puede ejecutar el script desde la shell de usuario que suele usar para compilar &kde;. %su nombre-usuario -%tdesvn-build - - - -Ahora el script debería iniciar la descarga del código y su compilación. No es muy probable que consiga compilar &kde; en este primer intento, pero no se desespere!. Busque alguna pista en el archivo de registro (logs) acerca de la falta de algún programa o archivo. Algunas veces, la rama principal de desarrollo es imposible de compilar, especialmente cuando se acerca el período de congelación del desarrollo. Tenga paciencia. Puede encontrar varios ejemplos y trucos para compilar &kde; en Building &kde; from Source Step by Step Guide. - - - - -Preparando el sistema para ejecutar su nuevo &kde;. - -Asumiendo que tiene un usuario dedicado para compilar y probar &kde; y que ya tiene una versión del mismo instalada, necesitará que el sistema cargue el nuevo &kde;, para lo cual deberá modificar las variables de entorno. - -Abra o cree un nuevo archivo .bash_profile en su directorio home y añada al final del archivo: -TDEDIR=(ruta al directorio de kde) -TDEDIRS=$TDEDIR -PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH -LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH -export TDEDIRS PATH LD_LIBRARY_PATH - Si también va a compilar qt-copy debería escribir: TQTDIR=(ruta al directorio qt) -TDEDIR=(ruta al directorio kde) -TDEDIRS=$TDEDIR -PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH -MANPATH=$TQTDIR/doc/man:$MANPATH -LD_LIBRARY_PATH=$TDEDIR/lib:$TQTDIR/lib:$LD_LIBRARY_PATH -export TQTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH - - - -Si no está usando un usuario dedicado, debería definir un nuevo valor para $TDEHOME en el archivo .bash_profile: export TDEHOME="${HOME}/.tde-svn" - -# Creelo si lo necesita -[ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn - - - - -Si se encuentra con que el menú de inicio está demasiado vacío o excesivamente lleno con las aplicaciones de su distribución, deberá definir la variable xdg en el archivo .bash_profile: XDG_CONFIG_DIRS="/etc/xdg" -XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" -export XDG_CONFIG_DIRS XDG_DATA_DIRS - - - - - -Ahora deberá asegurarse de que se inicia el script starttde correspondiente a la nueva instalación: - -Abra el archivo .xinitrc (o .xsession), según su distribución) en su directorio home, o cree uno nuevo si es necesario. Añada la siguiente línea: exec ${TDEDIR}/bin/starttde - - - -Inicie ahora el nuevo &kde; en su sistema Linux o BSD con soporte para terminales virtuales. Utlice Ctrl+Alt+F1...F12 para cambiar de la consola virtual 1 hasta la 12. Así podrá ejecutar más de un escritorio a la vez. Los primeros seis terminales son sólo texto, mientras que los otros seis son terminales gráficos. - -Si al iniciar aparece el gestor gráfico en su lugar, puede acceder al nuevo KDE aunque no esté listado como opción, simplemente pulse Ctrl + Alt + F2 y aparecerá un terminal en modo texto. Escriba el login y la contraseña de la cuenta dedicada a KDE y ejecute: - -startx -- :1 - - - -Es posible ejecutar el nuevo y el antiguo KDE al mismo tiempo! Entre al sistema como usuario normal e inicio el KDE antiguo. Pulse Ctrl + Alt + F2 (o F1, F3, etc...) verá que aparece un terminal de texto. Escriba el login y la contraseña del usuario dedicado a KDE y ejecute "startx -- :1". Podrá volver a su antiguo KDE pulsando Ctrl + Alt + F6 (o F7, F8, etc... uno de ellos será el antiguo ;-) Para volver a su nuevo KDE, pulse Crtl + Alt + F7 (o F6, F8,etc..). Ahora ya es capaz de pasar de una versión a otra de KDE, probando la nueva sabiendo que será capaz de volver a la antigua si algo sale mal. - - - - - - - - -Características del script - -Funciones de &tdesvn-build;: - - - - -Descarga y actualiza adecuada y automáticamente los módulos de &svn;. - -Contabiliza el tiempo de compilación de los módulos. - -Intenta reconstruir automáticamente los módulos que utilizan una compilación incremental y que son más dados a producir errores después de ciertas modificaciones. - -Puede continuar el trabajo donde finalizó otro programa, o compilar un módulo concreto. - -Incorpora una serie de opciones de configuración por defecto adecuadas para compilar &kde; desde un &svn; anónimo. - -Incorpora soporte de Unsermake. - -Acepta tildes en el archivo de configuración, por ejemplo: qtdir ~/tdesvn/build/qt-copy - - -Es posible definir los directorios donde se compilan, instalan y guardan los logs. - -Configura automáticamente un directorio para la compilación, distinto de aquel donde se guarda el código fuente para evitar mezclarlos. Una excepción la constituye qt-copy, salvo que quiera probar truco para compilar qt en un directorio aparte). - -Puede especificar opciones globales que se aplicarán a todos los módulos que descargue y opciones específicas paa cada módulo. - -Dado que autotools no está siempre sincronizado con los cambios del código fuente, puede forzar la recompilación de un determinado módulo creando un archivo con el nombre .refresh-me en el directorio de compilación de dicho módulo, o ejecutando &tdesvn-build; con la copcío . - -Puede definir varias variables para usar durante la compilación: TDEDIR, TQTDIR, DO_NOT_COMPILE, y CXXFLAGS. - -Archivos de registro. Los archivos de registro están numerados y fechados para facilitar la identificación en cada ejecución del script. También se crea un enlace llamado "latest" que apunta siempre al más reciente. - -Si está utilizando una instalación de &kde; en su directorio de usuario en lugar de en el sistema (para lo cual necesitaría ser root para instalarla), puede usar este script para instalarla. El código no ha sido demasiado probado, además utiliza bastante la llamada system(), por tanto no es muy recomendable ejecutarlo como root. - -Puede utilizar make-install-prefix para insertar un comando antes del propio make installl. Esto es especialmente útil para sudo. - -Puede utilizar apidox para compilar e instalar automáticamente la documentación del API de algunos módulos. - -Es posible descargar sólo una parte de un módulo de &kde;&svn;. Por ejemplo puede descargar sólo taglib del módulo tdesupport, o bien K3B de extragear/multimedia. El script usará automáticamente kde-common si fuese necesario. - -Puede que le interese saber exactamente qué es lo que el script va a hacer. Si lo ejecuta con la opción o , le dará una descripción muy detallada de los comandos que va a ejecutar aunque sin realmente ejecutarlo. - -Soporte para la descarga de ramas específicas de &svn;. Aún es necesario pulir esta opción, pero puede definir la rama que quiere compilar mediante la opción de configuración module-base-path. - - - -Cosas que &tdesvn-build; NO hace: - - - -Encontrar la réplica del servidor &svn; de &kde; más rápida. El servidor por defecto debería ir bien. No se da una lista de servidores con el programa, así que si no es así, deberá buscar usted otros servidores. - -Lavarse los dientes. Debería acordarse de hacerlo usted :-) - -Este script probablemente tenga algunos fallos. Lo sentimos. - - - - - - -Formato de .kdescn-buildrc - -Para usar el script, deberá tener un archivo en su directorio home llamado .tdesvn-buildrc, que describa los módulos que quiere descargar y compilar. - - - -Comienza con las opciones globales, especificadas del siguiente modo: - -global -nombre-opción valor-opción -[...] -end global - - -Luego le siguen una o más secciones de módulos, especificadas del siguiente modo: - -module nombre-módulo -nombre-opción valor-opción -[...] -end module - - -nombre-módulo debe ser un módulos del repositorio &svn; de &kde; (por ejemplo tdelibs o tdebase). Algunas opciones anulan las opciones generales, algunas se suman a las globales y algunas de las globales no pueden ser anuladas. - -Aquí tiene una lista de las opciones que puede usar ordenadas alfabéticamente. Puede ver más información pinchando sobre las opciones. Si encuentra alguna sin documentar, envíe un email a los autores a la dirección que encontrará más abajo. - - -apidox, para compilar la documentación del API. -apply-qt-patches, para mejorar qt-copy. -binpath, para definir la variable PATH. -branch,para decargar la versión de una determinada rama en lugar de /trunk. -build-dir, para definir el directorio de compilación. -checkout-only, para descargar sólo parte de un módulo. -colorful-output para colorear la salida del script. -configure-flags para definir las opciones de configuración de un módulo. -cxxflags para definir la variable CXXFLAGS. -dest-dir para cambiar el nombre del directorio de un determinado módulo. -disable-agent-check, para evitar que tdesvn-build compruebe el estado del agente de ssh. -do-not-compile, para marcar directorios que no desee compilar. -inst-apps, para compilar el instalar sólo algunos directorios. -install-after-build, para no instalar después de compilar. -tdedir, para definir el directorio de instalación de KDE. -libpath, para definir la variable LD_LIBRARY_PATH. -make-install-prefix, para ejecutar algún programa de apoyo (como sudo) durante la instalación. -make-options, para pasarle opciones al programa make. -manual-build, para que el módulo no se compile automáticamente. -manual-update, para evitar que se realice automáticamente cualquier acción sobre el módulo. -module-base-path, para modificar el lugar de descarga del módulo (util para las ramas y etiquetas). -niceness, para modificar la prioridad de ejecución asignada al script. -no-rebuild-on-fail, para que no se vuelva a ejecutar make en caso de fallo. -qtdir, para definir la ruta a Qt. -set-env, para definir una variable de entorno. -source-dir, para modificar el directorio a donde se descargará el código fuente. -stop-on-failure, para que tdesvn-build pare en cuanto encuentre un fallo. -svn-server, para modificar el servidor desde donde se descarga el código fuente. -use-qt-builddir-hack, para compilar Qt en un directorio aparte tal como se hace con el resto de KDE. -use-unsermake, para utilizar el sistema avanzado de compilación unsermake. - - - -Aquí tiene una tabla con varias opciones así como algunos comentarios sobre ellas. Cualquier opción que anule una opción global también anulará una opción de un comando. - - -Tabla de opciones - - - - -Nombre de la opción -Módulo -> Comportamiento general -Notas - - - - - - -apidox -Overrides global -Configure esta opción como true (verdadero) para que &tdesvn-build; compile e instale automáticamente la documentación del API de cada módulo después de compilarlo e instlarlo. Esto sólo funcionará donde make apidox hace algo como por ejemplo: tdelibs, tdebase y koffice ebtre otros. - - - -apply-qt-patches -Overrides global -Esta opción sólo es útil para qt-copy. Si su valor es distinto de cero, se ejecutará el script apply-patches en qt-copy. Dado que estos parches suelen ser el principal motivo por el cual se usa qt-copy en lugar de las librerías Qt sin tocar, no debería crearnos ningún problema si está activada. Por defecto viene activada. - - - -binpath -No se pueden anular -Use esta opción para definir la variable de entorno PATH mientr - - - - -branch -Overrides global -Defina esta opción si desea descargar una rama determinada de KDE en lugar de "trunk", como se haría por defecto que es donde se realiza el desarrollo de KDE. Por ejemplo, si desea descargar la rama KDE 3.4, debería usar el valor "3.4". -Observe que algunos módulos utilizan un nombre de rama diferente. Especialmente el módulo arts no sigue la numeración de las versiones de KDE, así la versión que usa KDE 3.4 es la 1.4. -Si tdesvn-build no es capaz de descargar una rama con esta opción, deberá especificar manualmente la URL para su descarga mediante la opción override-url. - - - - -build-dir -Overrides global -Utilice esta opción para cambiar el directorio que contiene el código fuente compilado. Puede usarse de tres formas: Relativa al directorio del código fuente del &svn; de &kde; (vea la opción source-dir). Esta es la opción por defecto actual y la única usada hasta la versión 0.61 de este script. Seleccionará este modo si escribe una ruta que no empieze con una tilde (~) o una barra (/).El valor por defecto es build Ruta absoluta. Si escribe una ruta que comienze por una barra, ésta se usará directamente. Por ejemplo, /tmp/kde-obj-dir/. Relativa a su directorio home. Si escribe una ruta que comience por una tilde (~), se interpretará como relativa a su directorio home. Por ejemplo: ~/builddir será interpretado como /home/nombre-usuario/builddir.. Quizás se sorprenda de saber que puede cambiar esta opción independientemente para cada módulo. - - - -checkout-only -Overrides global -Active esta opción si quiere descarar el código fuente del &svn; parte a parte. El valor para esta opción debería ser una lista de los directorios a descargar separados entre sí por espacios en blanco. No es necesario que incluya el directorio admin, se incluirá por defecto si fuese preciso. Dicho directorio deberá ser descargado desde kde-common. Aunque esta opción anularía la opción global equivalente, no tiene sentido definir esta variable de modo global. - - - -configure-flags -Añade a las opciones globales (salvo para qt-copy) -Utilice esta opción para definir qué parámetros le pasará a ./configure cuando prepare la compilación del módulo. Cuando se utiliza como opción global, se aplica a todos los módulos que se compilan. Dado que qt-copy utiliza una configuración muy distinta al resto de &kde;, ésta opción prevalece sobre la configuración global si se define para él. - - - -colorful-output -No se pueden anular -Si define esta oción como "false", la salida de &tdesvn-build; será del mismo color que la letra por defecto que tenga configurada en la consola. Por defecto, está definida como true. Piense que &tdesvn-build; sólo mostrará la salida en color en un terminal (como xterm, &konsole; o la consola de Linux). - - - -cxxflags -Añade a las opciones globales -Utilice esta opción para especificar qué opciones se pasan a ./configure para CXXFLAGS cuando se prepara un módulo para compilarlo. Se define aquí esta opción en lugar de hacerlo mediante configure-flags porque esta opción también define la variable de entorno CXXFLAGS durante la compilación. - - - -dest-dir -Overrides global -Utilice esta opción para cambiar el nombre del módulo en su disco duro. Por ejemplo, mediante esta opción, puede renombrar el módulo extragear/network como extragear-network. - - - -disable-agent-check -No se pueden anular -Normalmente, si usa SSH para descargar el código desde Subversion (por ejemplo mediante el protocolo svn+ssh), tdesvn-build se asegurará que ssh-agent gestione algunas identidades SSH. Esto evitará que SSH le pida la contraseña para cada módulo. Puede desctivar esta opción definiendo disable agent como true. - - - -do-not-compile -Overrides global -Utilice esta opción para definir la variable de entorno DO_NOT_COMPILE antes de ejcutar el script. Según la FAQ de los desarrolladores de &kde;, esto hará que no se compile ningún directorio de los que se especifiquen. Recuerde, que los directorios deberán ir separados entre si mediante espacios en blanco. - -Observe que el código fuente será descargado igualmente. Si no desea que lo sea, utilice la directiva checkout-only para definir qué directorios quiere descargar. - - - - -email-address -No se pueden anular - -Defina para esta opción la dirección de email que usará tdesvn-build para enviar correos. No necesita hacelo si no va a usar ninguna función que envíe emails (está descativada por defecto). - -Actualmente, sólo email-on-compile-error necesita esta opción. - - - - -email-on-compile-error -No se pueden anular - -Puede definir en esta opción la dirección de email a la que se deberá enviar el informe de fallo cuando no sea posible compilar un módulo. tdesvn-build esperará hasta que todos los módulos se hayan compilado y juntará todos los informes en uno. Sólo se enviará el informe si falla la compilación de alguno. - -Por favor, vea la opción email-address para ver la dirección de remite de tdesvn-build ya que la que viene por defecto seguramente no le agrade. - - - - -inst-apps -Overrides global -Esta es la opción contraria a do-not-compile. Con esta opción sólo se sompilan los directorios definidos. Recuerde que deben ir separados por espacios en blanco. - -Ningún cambio surte efecto hasta que se ejecuta make Makefile.cvs ya sea automáticamente mediante el script o manualmente mediante las opciones o . - -Observe que el código fuente será descargado igualmente. Si no desea que lo sea, utilice la directiva checkout-only para definir qué directorios quiere descargar. - - - - -install-after-build -Overrides global -Esta opción sirve para instalar el paquete una vez que ha sido correctamente compilado. Por defecto está activada, si desea desactivarla deberá definir su valor como 0 en el archivo de configuración. También puede utilizar'el indicador de línea de comandos . - - - -tdedir -No se pueden anular -Define el directorio en el cual se instalará &kde; una vez compilado, Por defecto se hará en ~/kde. Si desea instalarlo en un directorio donde sean necesarios permisos de root también deberá consultar la opción make-install-prefix. - - - -libpath -No se pueden anular -Esta opción define la variable de entorno LD_LIBRARY_PATH durante la compilación. Puede anular esta configuración para ciertos módulos si lo desea. Por defecto, no contiene ningún valor aunque se añaden automáticamente las rutas $TDEDIR/lib y $TQTDIR/lib. Puede utilizar la tilde (~) para definir rutas en esta opción. - - - -log-dir -Overrides global -Esta opción define el directorio que contendrá los archivos de registro (logs) que genere el script. A partir de la versión 0.64, es posible definirla para cada módulo separadamente. - - - -make-install-prefix -Overrides global -para esta variable, puede definir una lista separada por espacios. Se interpretará como comandos con sus opciones y se anepondrán al comando make install. Esto es especialmente útil para instalar paquetes con sudo, aunque se recomienda precaución al usar privilegios de root. - - - -make-options -Overrides global -Defina esta variable si desea pasar opciones al comando make. Esto es útil para programas como distcc. El programa distcc permite compartir el software compilado con otros ordenadores. Para usarla deberá utilizar make con la opción . Según la documentación, se recomienda 2 veces el número de CPU's de la red. Por tanto, si tiene una sóla CPU, la opción sería . - - - -manual-build -Overrides global -Defina esta opción como true para que no se compile este módulo junto con los demás, aunque seguirá siendo actualizado desde el &svn;. Esta opción es equivalente a la opción de línea de comandos -. - - - -manual-update -Overrides global -Defina esta variable como «true» para evitar que se actualice (y por extensión que se compile o instale) ese módulo. - - - -module-base-path -Overrides global -Esta opción permite cambiar el directorio por defecto de &tdesvn-build; para el módulo en cuestión. Esto es útil en caso de que desee usar una determinada rama o versión de alguna librería. El visor de código de &kde; suele ser muy útil para averiguar su localización. -Observe que &tdesvn-build; define la ruta final según el siguiente esquema: $svn-server/home/kde/$module-base-path/$module-name. -El valor por defecto es o bien trunk o bien trunk/KDE, según el nombre del módulo. - - - - -niceness -No se pueden anular -Defina esta opción con un número entre 20 y 0. Cuanto más alto, menor es la prioridad que &tdesvn-build; de dará a si mismo. Por defecto es 10. - - - -no-rebuild-on-fail -Overrides global -Defina esta opción como true para evitar que &tdesvn-build; intente recompilar el módulo si no consigue realizar una compilación incremental. Normalmente &tdesvn-build; volverá a intentar recompilar el módulo completamente, así se evitan los problemas en caso de que no esté totalmente actualizado con el &svn;. - - - -override-url -Overrides global -Si define esta opción, tdesvn-build pasará el valor que usted le asigne como URL para Subversion sin ningún cambio. esto suele ser útil en caso de que quiera descargar una versión concreta de pero tdesvn-build no sea capaz de hacerlo mediante branch. - - - -qtdir -No se pueden anular -Utilice esta opción para definir la variable de entorno TQTDIR durante la compilación. No es posible anular esta configuración para un módulo en concreto. Por defecto, esta opción está definida como $(source-dir)/build/qt-copy, utiliza el módulo qt-copy incluido en el repositorio de &kde;. Puede utilizar la tilde (~) para representar su directorio home. - - - -remove-after-install -Overrides global -Si tiene poco espacio en su disco duro, ésta opción le permite ahorrarlo borrando automáticamente el directorio de compilación (incluso también el del código fuente) una vez que el módulo ha sido correctamente instalado. -Los posibleas valores para esta opción son: -none - No borra nada (este es el comportamiento por defecto). -builddir - Borra el directorio de compilación, pero no el código fuente. -all - Borra el directorio de compilación y el código fuente. - - - -Obseve que al usar esta opción, es posible que malgaste mucho ancho de banda (si utiliza "all") o que lleve mucho más tiempo compilar KDE si tdesvn-build no es capaz de realizar compilaciones incrementales. - - - - -set-env -Overrides global -Esta opción permite definir una lista de valores separados entre sí por espacios en blanco. El primer valor deberá ser la variable a definir y el resto los valores que desee que dicha variable tome. Por ejemplo, si quiere definir la variable CREADOR_LINUX como Linus_Torvalds debería escribir lo siguiente: -set-env CREADOR_LINUX Linus_Torvalds -Es posible repetir esta opción sin anular las anterirores definiciones de set-env que pueda haber en una misma sección del archivo de configuración. De este modo podrá definir más de una variable de entorno por módulo (o global). - - - - -source-dir -No se pueden anular -Esta opción define el directorio de su sistema donde se guarda el código fuente que descargue desde el &svn; de &kde;. Si no especifica ningún valor, se usará ~/tdesvn. Si desea especificar otra, especifique la ruta absoluta. - - - -svn-server -No se pueden anular -Define el servidor &svn; a usar. Por defecto usará el &svn; anónimo en svn://anonsvn.kde.org/. - - - -stop-on-failure -Overrides global -Defina esta opción como true si desea que el script se pare al encontrar un error durante la compilación o la instalación. Esta opción está desactivada por defecto. - - - -tag -Overrides global -Utilice esta opción si quiere descarar una versión específica de un módulo. -NOTA: Es altaente probable que NO DESEE USAR ESTA OPCIÓN ya que las distintas versiones KDE están disponibles en paquetes en el FTP de KDE o en una de las réplicas. -Si está usando tdesvn-build porque no ha conseguido una determinada verisón en su distribución, considere usar Konstruct que compila KDE a partir de los paquetes publicados para cada versión. - - - - -use-qt-builddir-hack -Overrides global -Aunque esta opción anula su correspondiente global, sólo tiene sentido para qt-copy. Defínala como true para activar el modo experimental srcdir != builddir. Si está activada, &tdesvn-build; copiará el código del módulo qt-copy en el directorio de compilación y lo compilará desde ahí. Entonces, deberá definir la variable TQTDIR como $(qt-copy-build-dir)/qt-copy/lib, también es recomendable que modifique la opción qtdir para este caso. La compilación incremental seguirá funcionando en este caso ya que las fechas de los archivos se conservan después de copiarlos. Si utiliza la opción apply-qt-patches, se aplicarán los parches en el directorio de compilació en lugar de en el del código fuente. Por defecto esta opción viene definida como true. - - - -use-unsermake -Overrides global -Con esta opción definida como true hará que el script utilice el programa, en fase experimental, unsermake en lugar de automake. Esto puede disminuir mucho el tiempo de compilación especialemente para sistemas de compilación distribuidos. Para la mayoría de los módulos, esta opción está definida como true. - -En general, si utiliza esta opción, tdesvn-build se encarga de actualizar automáticamente unsermake. Esto puede causar problemas sobre todo si gestiona unsermake usted mismo. Si desea seguir usando unsermake pero sin que tdesvn-build lo actualice, defina esta opción como self. - - - - - - -
- - - - -Opciones de línea de comandos y variables de entorno - -Este script no usa variables de entorno. Si necesita definir alguna para la compilación o instalación de KDE, consulte la opción set-env. - -El script puede ejecutarse con las siguientes opciones - - - - - -Muestra algo de ayuda sobre el uso de este script. - - - - -Muestra la versión del programa. - - - - -Muestra información para contactar con el autor. - - - - -Activa el coloreado del texto de salida. - - - - -Desactiva el coloreado del texto de salida. - - - - (o bien ) -Emula las acciones que realizaría al ejecutarse realmente. - - - - (o bien ) -Muestra menos información en la salida del script. Sólo mostrará información básica. - - - - -Sólo muestra avisos y errores. - - - - -Muestra muy detalladamente todo lo que ocurre y lo que tdesvn-build está haciendo. - - - - -Sólo actualiza el código fuente. - - - - -Sólo compila el código fuente. - - - - -Excluye los módulos que se le indiquen durante el proceso de actualización/compilación. - - - - -No contacta con el servidor &svn;. - - - - -No realiza la compilación. - - - - -No instala automáticamente los paquetes después de compilarlos. - - - - -Activa el modo de depuración para el script. Actualmente esto quiere decir que toda la salida se enviará a STDOUT además de registrarse en archivo de log correspondiente. Muchas funciones proporcionan mucha más información sobre lo que hacen ejecutándolas en modo depuración. - - - - -Si usa esta opción, no volverá a intentar recompilar los módulos que - - - - -reconstruye el sistema de compilación desde cero. - - - - -Vuelve a ejecutar el script de configuración sin limpiar el directorio de compilación. - - - - -Ejecuta make Makefile.cvs de nuevo para crear el script de configuración y seguir normalmente la compilación. Esta opción implica . - - - - -Intenta continuar la compilación desde el donde se había parado antes, es decir desde el último módulo compilado (correctamente o no). Esta opción implica . No debería incluir otros módulos en la línea de comandos. - - - - -Similar a , salvo que aquí debe indicar el módulo desde el que comenzar la compilación como siguiente parámetro. Esta opción implica . No debería incluir otros módulos en la línea de comandos. - - - - -Esta opción hará que se interprete el siguiente parámetro como el archivo del cual tomar las opciones de configuración. Por defecto es ~/.tdesvn-buildrc. - - - - -Le permite modificar el directorio en el cual se instalará &kde;. esta opción implica . - - - - -Con esta opción el script se detendrá después de ejecutar make Makefile.cvs. Todavía sigue siendo necesario ejecutar el script configure, aunque &tdesvn-build; lo hará la siguiente vez que lo ejecute. Así, podrá crear todos los scripts configure y ejecutar ./configure para cada módulo y ver qué opciones del script es necesario modificar. - - - -Si es la única opción que define, el script intentará instalar todos lo módulos que hayan sido correctamente compilados, salvo qt-copy que no precisa instalación. Todas las opciones que se escriban a continuación de se considerarán como nombres de módulos para instalar. - - - - -Esta opción le permite anular una determinada opción de su archivo de configuración para todos los módulos. Por ejemplo, para anular la opción log-dir, tendría que escribir - - - - -Esta opción le permite anular una determinada opción de su archivo de configuración para todos los módulos. Por ejemplo, para anular la opción use-unsermake en tdemultimedia, tendría que escribir . - - - - -Cualquier otra cosa que se escriba se asume como el nombre de módulos para actualizar o compilar. No mezcle compilación e instalación. - - - - -Créditos y licencias -&underFDL; - - diff --git a/tde-i18n-es/docs/tdesdk/tdesvn-build/CMakeLists.txt b/tde-i18n-es/docs/tdesdk/tdesvn-build/CMakeLists.txt new file mode 100644 index 00000000000..bf1f4526fcd --- /dev/null +++ b/tde-i18n-es/docs/tdesdk/tdesvn-build/CMakeLists.txt @@ -0,0 +1,6 @@ +# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer + +tde_create_handbook( + DESTINATION tdesvn-build + LANG es +) diff --git a/tde-i18n-es/docs/tdesdk/tdesvn-build/Makefile.am b/tde-i18n-es/docs/tdesdk/tdesvn-build/Makefile.am new file mode 100644 index 00000000000..989cf9ef462 --- /dev/null +++ b/tde-i18n-es/docs/tdesdk/tdesvn-build/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = es +SUBDIRS = $(AUTODIRS) +KDE_DOCS = tdesvn-build +KDE_MANS = AUTO diff --git a/tde-i18n-es/docs/tdesdk/tdesvn-build/index.docbook b/tde-i18n-es/docs/tdesdk/tdesvn-build/index.docbook new file mode 100644 index 00000000000..46726200534 --- /dev/null +++ b/tde-i18n-es/docs/tdesdk/tdesvn-build/index.docbook @@ -0,0 +1,739 @@ + + + + + + Subversion"> + tdesvn-build"> +]> + + + + +Manual del script &tdesvn-build; + + +MichaelPyne
michael.pyne@kdemail.net
 + +CarlosWoelz
carloswoelz@imap-mail.com
 + + + + Marcos Fouces Lago
mfouces@yahoo.es
 Traductor + + + + +2005 +Michael Pyne + + + +2005 +Carlos Woelz + + + +&FDLNotice; + +2005-06-18 +0.98 + + +&tdesvn-build; es un script en Perl que compila e instala &kde; directamente a partir del código fuente descargado desde el repositorio &svn; de &kde;. + + + +KDE +tdesdk +SVN +Subversion +Desarollo de KDE + + + + + + +Introducción + +&tdesvn-build; es un pequeño script escrito en Perl para ayudarle a instalar &kde; desde el repositorio &svn;. También debería echar un vistazo al script kde-build incluido en el módulo tdesdk de &kde;. + +Aquí se explican la sintaxis y opciones del archivo de configuración, sus argumentos a la hora de invocarlo, características de &tdesvn-build;. También se describen todos los pasos necesarios para compilar &kde; a partir de su código fuente, incluyendo lo que deberá hacer con otros programas, es decir lo que &tdesvn-build; no hace automáticamente. + + + + +Primeros pasos + +En este capítulo se muestra el uso de &tdesvn-build; para descargar módulos del repositorio de &kde; y compilarlos. También se explica un poco la estructura del repositorio &svn; de &kde; y los preparativos a realizar antes de ejecutar este script. + +Todos los asuntos presentes en este capítulo están explicados con mayor detalle en el artículo Building &kde; from Source Step by Step Guide (en inglés) de la web de Equipo de Calidad de &kde;. Si es la primera vez que compila KDE es recomendable que lo lea antes. Encontrará información detallada sobre la herramientas de empaquetado, programas útiles, errores más frecuentes así como mucha información para usar su nuevo &kde;. + + +Preparación del sistema para compilar &kde;. + +Es aconsejable que descargue y compile &kde; desde una cuenta de usuario corriente. Si ya tiene instalado &kde; en su sistema, lo mejor es que cree una cuenta de usuario exclusivamente para ejecutar el nuevo &kde;. La ventaja de esto es que no será posible estropear el sistema base pudiendo entrar con su cuenta habitual si algo sale mal. + +Si lo desea puede instalarlo en el sitema para que esté disponible para todos los usuarios aunque esto no se explica aquí. Si tiene intención de hacerlo seguramente ya sabrá bien lo que hace. + +Antes de usar &tdesvn-build; (o de cualquier otra herramienta de compilación) deberá instalar las herramientas y librerías de desarrollo de &kde;. Necesitará la versión 3.3.0 o superior de las librerías Qt, Automake 1.8, Autoconf 2.5x o superior (mejor si es 2.57 o superior ya que las versiones anteriores tienen un pequeño fallo), el cliente subversion (svn), el compilador gcc con soporte para C++, libxml2, openssl, libbz2 entre otros. Puede ver una lista completa en los requisitos de compilación de KDE 3.4. Es muy probable que estos paquetes ya vengan incluidos en su distribución. + +Muchos de esos paquetes se subdividen en librerías, programas, utilidades y encabezados (generalmente designados como "devel" o "dev"). Necesita como mínimo los programas y librerías así como los paquetes de desarrollo asociados a estos. Si no está seguro, es una buena idea instalarlos todos. Los paquetes necesarios dependen del módulo que quiere construir. En Building &kde; from Source Step by Step Guide encontrará más detalles sobre cómo encontrar e instalar el software necesario. + +Seguramente ya tiene instalado &tdesvn-build; en su sistema. &tdesvn-build; necesita que usted cree el archivo de configuración .tdesvn-buildrc en su directorio home (~/) con toda la información necesaria para que pueda ejecutarse: opciones de configuración, opciones de compilación, localización del código, localización de la instalación (prefijo), los módulos a compilar, &etc;. El archivo tdesvn-buildrc-sample le servirá de guía. Tiene más información sobre la sintaxis de este archivo de configuración en y en . + +Una buena manera de obtener la última versión es mirando en la página de tdesdk/scripts en websvn.kde.org. Verá una lista de archivos disponibles en ese directorio del &kde;&svn;. Pulse en &tdesvn-build; y descargue la última versión. Haga lo mismo para tdesvn-buildrc-sample. No olvide darle permiso de ejecución. + + + + +Información de configuración + +Para usar este script será necesario tener en su directorio home un archivo llamado .tdesvn-buildrc donde se definen las opciones generales así como los módulos que desea descargar y compilar. + +Utilice tdesvn-buildrc-sample como base para su archivo. + +Seleccione el servidor &svn; desde el que quiere descargar mediante la opción svn-server. Por defecto se define el repositorio &svn; anónimo en svn://anonsvn.kde.org/, pero si tiene una cuenta de acceso al &svn; de &kde; , o existe una réplica más cercana a usted. deberá modifiar este parámetro. + +Preste especial atención a las variables tdedir y qtdir, la primera define donde se instalará la versión de &kde; que se compile (por defecto irá en ~/kde), y la segunda donde se instalarán las librerías qt,en caso de que también se compilen (por defecto van en ~/tdesvn/build/qt-copy). Necesitará conocer el valor de ambas variables más adelante al definir las variables de entorno para ejecutar la nueva instalación. Compruebe si la lista de módulos es realmente la que quiere compilar, por defecto en tdesvn-buildrc-sample se define una instalación bastante completa de &kde;. Realice los cambios oportunos y guárdelos como .tdesvn-buildrc en su directorio home. + +Si desea afinar más la configuración de .tdesvn-buildrc, en tiene información detallada sobre todas las opciones de configuración. + + + + +Uso del script &tdesvn-build; + +Ahora ya puede ejecutar el script desde la shell de usuario que suele usar para compilar &kde;. %su nombre-usuario +%tdesvn-build + + + +Ahora el script debería iniciar la descarga del código y su compilación. No es muy probable que consiga compilar &kde; en este primer intento, pero no se desespere!. Busque alguna pista en el archivo de registro (logs) acerca de la falta de algún programa o archivo. Algunas veces, la rama principal de desarrollo es imposible de compilar, especialmente cuando se acerca el período de congelación del desarrollo. Tenga paciencia. Puede encontrar varios ejemplos y trucos para compilar &kde; en Building &kde; from Source Step by Step Guide. + + + + +Preparando el sistema para ejecutar su nuevo &kde;. + +Asumiendo que tiene un usuario dedicado para compilar y probar &kde; y que ya tiene una versión del mismo instalada, necesitará que el sistema cargue el nuevo &kde;, para lo cual deberá modificar las variables de entorno. + +Abra o cree un nuevo archivo .bash_profile en su directorio home y añada al final del archivo: +TDEDIR=(ruta al directorio de kde) +TDEDIRS=$TDEDIR +PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH +LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH +export TDEDIRS PATH LD_LIBRARY_PATH + Si también va a compilar qt-copy debería escribir: TQTDIR=(ruta al directorio qt) +TDEDIR=(ruta al directorio kde) +TDEDIRS=$TDEDIR +PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH +MANPATH=$TQTDIR/doc/man:$MANPATH +LD_LIBRARY_PATH=$TDEDIR/lib:$TQTDIR/lib:$LD_LIBRARY_PATH +export TQTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH + + + +Si no está usando un usuario dedicado, debería definir un nuevo valor para $TDEHOME en el archivo .bash_profile: export TDEHOME="${HOME}/.tde-svn" + +# Creelo si lo necesita +[ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn + + + + +Si se encuentra con que el menú de inicio está demasiado vacío o excesivamente lleno con las aplicaciones de su distribución, deberá definir la variable xdg en el archivo .bash_profile: XDG_CONFIG_DIRS="/etc/xdg" +XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" +export XDG_CONFIG_DIRS XDG_DATA_DIRS + + + + + +Ahora deberá asegurarse de que se inicia el script starttde correspondiente a la nueva instalación: + +Abra el archivo .xinitrc (o .xsession), según su distribución) en su directorio home, o cree uno nuevo si es necesario. Añada la siguiente línea: exec ${TDEDIR}/bin/starttde + + + +Inicie ahora el nuevo &kde; en su sistema Linux o BSD con soporte para terminales virtuales. Utlice Ctrl+Alt+F1...F12 para cambiar de la consola virtual 1 hasta la 12. Así podrá ejecutar más de un escritorio a la vez. Los primeros seis terminales son sólo texto, mientras que los otros seis son terminales gráficos. + +Si al iniciar aparece el gestor gráfico en su lugar, puede acceder al nuevo KDE aunque no esté listado como opción, simplemente pulse Ctrl + Alt + F2 y aparecerá un terminal en modo texto. Escriba el login y la contraseña de la cuenta dedicada a KDE y ejecute: + +startx -- :1 + + + +Es posible ejecutar el nuevo y el antiguo KDE al mismo tiempo! Entre al sistema como usuario normal e inicio el KDE antiguo. Pulse Ctrl + Alt + F2 (o F1, F3, etc...) verá que aparece un terminal de texto. Escriba el login y la contraseña del usuario dedicado a KDE y ejecute "startx -- :1". Podrá volver a su antiguo KDE pulsando Ctrl + Alt + F6 (o F7, F8, etc... uno de ellos será el antiguo ;-) Para volver a su nuevo KDE, pulse Crtl + Alt + F7 (o F6, F8,etc..). Ahora ya es capaz de pasar de una versión a otra de KDE, probando la nueva sabiendo que será capaz de volver a la antigua si algo sale mal. + + + + + + + + +Características del script + +Funciones de &tdesvn-build;: + + + + +Descarga y actualiza adecuada y automáticamente los módulos de &svn;. + +Contabiliza el tiempo de compilación de los módulos. + +Intenta reconstruir automáticamente los módulos que utilizan una compilación incremental y que son más dados a producir errores después de ciertas modificaciones. + +Puede continuar el trabajo donde finalizó otro programa, o compilar un módulo concreto. + +Incorpora una serie de opciones de configuración por defecto adecuadas para compilar &kde; desde un &svn; anónimo. + +Incorpora soporte de Unsermake. + +Acepta tildes en el archivo de configuración, por ejemplo: qtdir ~/tdesvn/build/qt-copy + + +Es posible definir los directorios donde se compilan, instalan y guardan los logs. + +Configura automáticamente un directorio para la compilación, distinto de aquel donde se guarda el código fuente para evitar mezclarlos. Una excepción la constituye qt-copy, salvo que quiera probar truco para compilar qt en un directorio aparte). + +Puede especificar opciones globales que se aplicarán a todos los módulos que descargue y opciones específicas paa cada módulo. + +Dado que autotools no está siempre sincronizado con los cambios del código fuente, puede forzar la recompilación de un determinado módulo creando un archivo con el nombre .refresh-me en el directorio de compilación de dicho módulo, o ejecutando &tdesvn-build; con la copcío . + +Puede definir varias variables para usar durante la compilación: TDEDIR, TQTDIR, DO_NOT_COMPILE, y CXXFLAGS. + +Archivos de registro. Los archivos de registro están numerados y fechados para facilitar la identificación en cada ejecución del script. También se crea un enlace llamado "latest" que apunta siempre al más reciente. + +Si está utilizando una instalación de &kde; en su directorio de usuario en lugar de en el sistema (para lo cual necesitaría ser root para instalarla), puede usar este script para instalarla. El código no ha sido demasiado probado, además utiliza bastante la llamada system(), por tanto no es muy recomendable ejecutarlo como root. + +Puede utilizar make-install-prefix para insertar un comando antes del propio make installl. Esto es especialmente útil para sudo. + +Puede utilizar apidox para compilar e instalar automáticamente la documentación del API de algunos módulos. + +Es posible descargar sólo una parte de un módulo de &kde;&svn;. Por ejemplo puede descargar sólo taglib del módulo tdesupport, o bien K3B de extragear/multimedia. El script usará automáticamente kde-common si fuese necesario. + +Puede que le interese saber exactamente qué es lo que el script va a hacer. Si lo ejecuta con la opción o , le dará una descripción muy detallada de los comandos que va a ejecutar aunque sin realmente ejecutarlo. + +Soporte para la descarga de ramas específicas de &svn;. Aún es necesario pulir esta opción, pero puede definir la rama que quiere compilar mediante la opción de configuración module-base-path. + + + +Cosas que &tdesvn-build; NO hace: + + + +Encontrar la réplica del servidor &svn; de &kde; más rápida. El servidor por defecto debería ir bien. No se da una lista de servidores con el programa, así que si no es así, deberá buscar usted otros servidores. + +Lavarse los dientes. Debería acordarse de hacerlo usted :-) + +Este script probablemente tenga algunos fallos. Lo sentimos. + + + + + + +Formato de .kdescn-buildrc + +Para usar el script, deberá tener un archivo en su directorio home llamado .tdesvn-buildrc, que describa los módulos que quiere descargar y compilar. + + + +Comienza con las opciones globales, especificadas del siguiente modo: + +global +nombre-opción valor-opción +[...] +end global + + +Luego le siguen una o más secciones de módulos, especificadas del siguiente modo: + +module nombre-módulo +nombre-opción valor-opción +[...] +end module + + +nombre-módulo debe ser un módulos del repositorio &svn; de &kde; (por ejemplo tdelibs o tdebase). Algunas opciones anulan las opciones generales, algunas se suman a las globales y algunas de las globales no pueden ser anuladas. + +Aquí tiene una lista de las opciones que puede usar ordenadas alfabéticamente. Puede ver más información pinchando sobre las opciones. Si encuentra alguna sin documentar, envíe un email a los autores a la dirección que encontrará más abajo. + + +apidox, para compilar la documentación del API. +apply-qt-patches, para mejorar qt-copy. +binpath, para definir la variable PATH. +branch,para decargar la versión de una determinada rama en lugar de /trunk. +build-dir, para definir el directorio de compilación. +checkout-only, para descargar sólo parte de un módulo. +colorful-output para colorear la salida del script. +configure-flags para definir las opciones de configuración de un módulo. +cxxflags para definir la variable CXXFLAGS. +dest-dir para cambiar el nombre del directorio de un determinado módulo. +disable-agent-check, para evitar que tdesvn-build compruebe el estado del agente de ssh. +do-not-compile, para marcar directorios que no desee compilar. +inst-apps, para compilar el instalar sólo algunos directorios. +install-after-build, para no instalar después de compilar. +tdedir, para definir el directorio de instalación de KDE. +libpath, para definir la variable LD_LIBRARY_PATH. +make-install-prefix, para ejecutar algún programa de apoyo (como sudo) durante la instalación. +make-options, para pasarle opciones al programa make. +manual-build, para que el módulo no se compile automáticamente. +manual-update, para evitar que se realice automáticamente cualquier acción sobre el módulo. +module-base-path, para modificar el lugar de descarga del módulo (util para las ramas y etiquetas). +niceness, para modificar la prioridad de ejecución asignada al script. +no-rebuild-on-fail, para que no se vuelva a ejecutar make en caso de fallo. +qtdir, para definir la ruta a Qt. +set-env, para definir una variable de entorno. +source-dir, para modificar el directorio a donde se descargará el código fuente. +stop-on-failure, para que tdesvn-build pare en cuanto encuentre un fallo. +svn-server, para modificar el servidor desde donde se descarga el código fuente. +use-qt-builddir-hack, para compilar Qt en un directorio aparte tal como se hace con el resto de KDE. +use-unsermake, para utilizar el sistema avanzado de compilación unsermake. + + + +Aquí tiene una tabla con varias opciones así como algunos comentarios sobre ellas. Cualquier opción que anule una opción global también anulará una opción de un comando. + + +Tabla de opciones + + + + +Nombre de la opción +Módulo -> Comportamiento general +Notas + + + + + + +apidox +Overrides global +Configure esta opción como true (verdadero) para que &tdesvn-build; compile e instale automáticamente la documentación del API de cada módulo después de compilarlo e instlarlo. Esto sólo funcionará donde make apidox hace algo como por ejemplo: tdelibs, tdebase y koffice ebtre otros. + + + +apply-qt-patches +Overrides global +Esta opción sólo es útil para qt-copy. Si su valor es distinto de cero, se ejecutará el script apply-patches en qt-copy. Dado que estos parches suelen ser el principal motivo por el cual se usa qt-copy en lugar de las librerías Qt sin tocar, no debería crearnos ningún problema si está activada. Por defecto viene activada. + + + +binpath +No se pueden anular +Use esta opción para definir la variable de entorno PATH mientr + + + + +branch +Overrides global +Defina esta opción si desea descargar una rama determinada de KDE en lugar de "trunk", como se haría por defecto que es donde se realiza el desarrollo de KDE. Por ejemplo, si desea descargar la rama KDE 3.4, debería usar el valor "3.4". +Observe que algunos módulos utilizan un nombre de rama diferente. Especialmente el módulo arts no sigue la numeración de las versiones de KDE, así la versión que usa KDE 3.4 es la 1.4. +Si tdesvn-build no es capaz de descargar una rama con esta opción, deberá especificar manualmente la URL para su descarga mediante la opción override-url. + + + + +build-dir +Overrides global +Utilice esta opción para cambiar el directorio que contiene el código fuente compilado. Puede usarse de tres formas: Relativa al directorio del código fuente del &svn; de &kde; (vea la opción source-dir). Esta es la opción por defecto actual y la única usada hasta la versión 0.61 de este script. Seleccionará este modo si escribe una ruta que no empieze con una tilde (~) o una barra (/).El valor por defecto es build Ruta absoluta. Si escribe una ruta que comienze por una barra, ésta se usará directamente. Por ejemplo, /tmp/kde-obj-dir/. Relativa a su directorio home. Si escribe una ruta que comience por una tilde (~), se interpretará como relativa a su directorio home. Por ejemplo: ~/builddir será interpretado como /home/nombre-usuario/builddir.. Quizás se sorprenda de saber que puede cambiar esta opción independientemente para cada módulo. + + + +checkout-only +Overrides global +Active esta opción si quiere descarar el código fuente del &svn; parte a parte. El valor para esta opción debería ser una lista de los directorios a descargar separados entre sí por espacios en blanco. No es necesario que incluya el directorio admin, se incluirá por defecto si fuese preciso. Dicho directorio deberá ser descargado desde kde-common. Aunque esta opción anularía la opción global equivalente, no tiene sentido definir esta variable de modo global. + + + +configure-flags +Añade a las opciones globales (salvo para qt-copy) +Utilice esta opción para definir qué parámetros le pasará a ./configure cuando prepare la compilación del módulo. Cuando se utiliza como opción global, se aplica a todos los módulos que se compilan. Dado que qt-copy utiliza una configuración muy distinta al resto de &kde;, ésta opción prevalece sobre la configuración global si se define para él. + + + +colorful-output +No se pueden anular +Si define esta oción como "false", la salida de &tdesvn-build; será del mismo color que la letra por defecto que tenga configurada en la consola. Por defecto, está definida como true. Piense que &tdesvn-build; sólo mostrará la salida en color en un terminal (como xterm, &konsole; o la consola de Linux). + + + +cxxflags +Añade a las opciones globales +Utilice esta opción para especificar qué opciones se pasan a ./configure para CXXFLAGS cuando se prepara un módulo para compilarlo. Se define aquí esta opción en lugar de hacerlo mediante configure-flags porque esta opción también define la variable de entorno CXXFLAGS durante la compilación. + + + +dest-dir +Overrides global +Utilice esta opción para cambiar el nombre del módulo en su disco duro. Por ejemplo, mediante esta opción, puede renombrar el módulo extragear/network como extragear-network. + + + +disable-agent-check +No se pueden anular +Normalmente, si usa SSH para descargar el código desde Subversion (por ejemplo mediante el protocolo svn+ssh), tdesvn-build se asegurará que ssh-agent gestione algunas identidades SSH. Esto evitará que SSH le pida la contraseña para cada módulo. Puede desctivar esta opción definiendo disable agent como true. + + + +do-not-compile +Overrides global +Utilice esta opción para definir la variable de entorno DO_NOT_COMPILE antes de ejcutar el script. Según la FAQ de los desarrolladores de &kde;, esto hará que no se compile ningún directorio de los que se especifiquen. Recuerde, que los directorios deberán ir separados entre si mediante espacios en blanco. + +Observe que el código fuente será descargado igualmente. Si no desea que lo sea, utilice la directiva checkout-only para definir qué directorios quiere descargar. + + + + +email-address +No se pueden anular + +Defina para esta opción la dirección de email que usará tdesvn-build para enviar correos. No necesita hacelo si no va a usar ninguna función que envíe emails (está descativada por defecto). + +Actualmente, sólo email-on-compile-error necesita esta opción. + + + + +email-on-compile-error +No se pueden anular + +Puede definir en esta opción la dirección de email a la que se deberá enviar el informe de fallo cuando no sea posible compilar un módulo. tdesvn-build esperará hasta que todos los módulos se hayan compilado y juntará todos los informes en uno. Sólo se enviará el informe si falla la compilación de alguno. + +Por favor, vea la opción email-address para ver la dirección de remite de tdesvn-build ya que la que viene por defecto seguramente no le agrade. + + + + +inst-apps +Overrides global +Esta es la opción contraria a do-not-compile. Con esta opción sólo se sompilan los directorios definidos. Recuerde que deben ir separados por espacios en blanco. + +Ningún cambio surte efecto hasta que se ejecuta make Makefile.cvs ya sea automáticamente mediante el script o manualmente mediante las opciones o . + +Observe que el código fuente será descargado igualmente. Si no desea que lo sea, utilice la directiva checkout-only para definir qué directorios quiere descargar. + + + + +install-after-build +Overrides global +Esta opción sirve para instalar el paquete una vez que ha sido correctamente compilado. Por defecto está activada, si desea desactivarla deberá definir su valor como 0 en el archivo de configuración. También puede utilizar'el indicador de línea de comandos . + + + +tdedir +No se pueden anular +Define el directorio en el cual se instalará &kde; una vez compilado, Por defecto se hará en ~/kde. Si desea instalarlo en un directorio donde sean necesarios permisos de root también deberá consultar la opción make-install-prefix. + + + +libpath +No se pueden anular +Esta opción define la variable de entorno LD_LIBRARY_PATH durante la compilación. Puede anular esta configuración para ciertos módulos si lo desea. Por defecto, no contiene ningún valor aunque se añaden automáticamente las rutas $TDEDIR/lib y $TQTDIR/lib. Puede utilizar la tilde (~) para definir rutas en esta opción. + + + +log-dir +Overrides global +Esta opción define el directorio que contendrá los archivos de registro (logs) que genere el script. A partir de la versión 0.64, es posible definirla para cada módulo separadamente. + + + +make-install-prefix +Overrides global +para esta variable, puede definir una lista separada por espacios. Se interpretará como comandos con sus opciones y se anepondrán al comando make install. Esto es especialmente útil para instalar paquetes con sudo, aunque se recomienda precaución al usar privilegios de root. + + + +make-options +Overrides global +Defina esta variable si desea pasar opciones al comando make. Esto es útil para programas como distcc. El programa distcc permite compartir el software compilado con otros ordenadores. Para usarla deberá utilizar make con la opción . Según la documentación, se recomienda 2 veces el número de CPU's de la red. Por tanto, si tiene una sóla CPU, la opción sería . + + + +manual-build +Overrides global +Defina esta opción como true para que no se compile este módulo junto con los demás, aunque seguirá siendo actualizado desde el &svn;. Esta opción es equivalente a la opción de línea de comandos -. + + + +manual-update +Overrides global +Defina esta variable como «true» para evitar que se actualice (y por extensión que se compile o instale) ese módulo. + + + +module-base-path +Overrides global +Esta opción permite cambiar el directorio por defecto de &tdesvn-build; para el módulo en cuestión. Esto es útil en caso de que desee usar una determinada rama o versión de alguna librería. El visor de código de &kde; suele ser muy útil para averiguar su localización. +Observe que &tdesvn-build; define la ruta final según el siguiente esquema: $svn-server/home/kde/$module-base-path/$module-name. +El valor por defecto es o bien trunk o bien trunk/KDE, según el nombre del módulo. + + + + +niceness +No se pueden anular +Defina esta opción con un número entre 20 y 0. Cuanto más alto, menor es la prioridad que &tdesvn-build; de dará a si mismo. Por defecto es 10. + + + +no-rebuild-on-fail +Overrides global +Defina esta opción como true para evitar que &tdesvn-build; intente recompilar el módulo si no consigue realizar una compilación incremental. Normalmente &tdesvn-build; volverá a intentar recompilar el módulo completamente, así se evitan los problemas en caso de que no esté totalmente actualizado con el &svn;. + + + +override-url +Overrides global +Si define esta opción, tdesvn-build pasará el valor que usted le asigne como URL para Subversion sin ningún cambio. esto suele ser útil en caso de que quiera descargar una versión concreta de pero tdesvn-build no sea capaz de hacerlo mediante branch. + + + +qtdir +No se pueden anular +Utilice esta opción para definir la variable de entorno TQTDIR durante la compilación. No es posible anular esta configuración para un módulo en concreto. Por defecto, esta opción está definida como $(source-dir)/build/qt-copy, utiliza el módulo qt-copy incluido en el repositorio de &kde;. Puede utilizar la tilde (~) para representar su directorio home. + + + +remove-after-install +Overrides global +Si tiene poco espacio en su disco duro, ésta opción le permite ahorrarlo borrando automáticamente el directorio de compilación (incluso también el del código fuente) una vez que el módulo ha sido correctamente instalado. +Los posibleas valores para esta opción son: +none - No borra nada (este es el comportamiento por defecto). +builddir - Borra el directorio de compilación, pero no el código fuente. +all - Borra el directorio de compilación y el código fuente. + + + +Obseve que al usar esta opción, es posible que malgaste mucho ancho de banda (si utiliza "all") o que lleve mucho más tiempo compilar KDE si tdesvn-build no es capaz de realizar compilaciones incrementales. + + + + +set-env +Overrides global +Esta opción permite definir una lista de valores separados entre sí por espacios en blanco. El primer valor deberá ser la variable a definir y el resto los valores que desee que dicha variable tome. Por ejemplo, si quiere definir la variable CREADOR_LINUX como Linus_Torvalds debería escribir lo siguiente: +set-env CREADOR_LINUX Linus_Torvalds +Es posible repetir esta opción sin anular las anterirores definiciones de set-env que pueda haber en una misma sección del archivo de configuración. De este modo podrá definir más de una variable de entorno por módulo (o global). + + + + +source-dir +No se pueden anular +Esta opción define el directorio de su sistema donde se guarda el código fuente que descargue desde el &svn; de &kde;. Si no especifica ningún valor, se usará ~/tdesvn. Si desea especificar otra, especifique la ruta absoluta. + + + +svn-server +No se pueden anular +Define el servidor &svn; a usar. Por defecto usará el &svn; anónimo en svn://anonsvn.kde.org/. + + + +stop-on-failure +Overrides global +Defina esta opción como true si desea que el script se pare al encontrar un error durante la compilación o la instalación. Esta opción está desactivada por defecto. + + + +tag +Overrides global +Utilice esta opción si quiere descarar una versión específica de un módulo. +NOTA: Es altaente probable que NO DESEE USAR ESTA OPCIÓN ya que las distintas versiones KDE están disponibles en paquetes en el FTP de KDE o en una de las réplicas. +Si está usando tdesvn-build porque no ha conseguido una determinada verisón en su distribución, considere usar Konstruct que compila KDE a partir de los paquetes publicados para cada versión. + + + + +use-qt-builddir-hack +Overrides global +Aunque esta opción anula su correspondiente global, sólo tiene sentido para qt-copy. Defínala como true para activar el modo experimental srcdir != builddir. Si está activada, &tdesvn-build; copiará el código del módulo qt-copy en el directorio de compilación y lo compilará desde ahí. Entonces, deberá definir la variable TQTDIR como $(qt-copy-build-dir)/qt-copy/lib, también es recomendable que modifique la opción qtdir para este caso. La compilación incremental seguirá funcionando en este caso ya que las fechas de los archivos se conservan después de copiarlos. Si utiliza la opción apply-qt-patches, se aplicarán los parches en el directorio de compilació en lugar de en el del código fuente. Por defecto esta opción viene definida como true. + + + +use-unsermake +Overrides global +Con esta opción definida como true hará que el script utilice el programa, en fase experimental, unsermake en lugar de automake. Esto puede disminuir mucho el tiempo de compilación especialemente para sistemas de compilación distribuidos. Para la mayoría de los módulos, esta opción está definida como true. + +En general, si utiliza esta opción, tdesvn-build se encarga de actualizar automáticamente unsermake. Esto puede causar problemas sobre todo si gestiona unsermake usted mismo. Si desea seguir usando unsermake pero sin que tdesvn-build lo actualice, defina esta opción como self. + + + + + + +
+ + + + +Opciones de línea de comandos y variables de entorno + +Este script no usa variables de entorno. Si necesita definir alguna para la compilación o instalación de KDE, consulte la opción set-env. + +El script puede ejecutarse con las siguientes opciones + + + + + +Muestra algo de ayuda sobre el uso de este script. + + + + +Muestra la versión del programa. + + + + +Muestra información para contactar con el autor. + + + + +Activa el coloreado del texto de salida. + + + + +Desactiva el coloreado del texto de salida. + + + + (o bien ) +Emula las acciones que realizaría al ejecutarse realmente. + + + + (o bien ) +Muestra menos información en la salida del script. Sólo mostrará información básica. + + + + +Sólo muestra avisos y errores. + + + + +Muestra muy detalladamente todo lo que ocurre y lo que tdesvn-build está haciendo. + + + + +Sólo actualiza el código fuente. + + + + +Sólo compila el código fuente. + + + + +Excluye los módulos que se le indiquen durante el proceso de actualización/compilación. + + + + +No contacta con el servidor &svn;. + + + + +No realiza la compilación. + + + + +No instala automáticamente los paquetes después de compilarlos. + + + + +Activa el modo de depuración para el script. Actualmente esto quiere decir que toda la salida se enviará a STDOUT además de registrarse en archivo de log correspondiente. Muchas funciones proporcionan mucha más información sobre lo que hacen ejecutándolas en modo depuración. + + + + +Si usa esta opción, no volverá a intentar recompilar los módulos que + + + + +reconstruye el sistema de compilación desde cero. + + + + +Vuelve a ejecutar el script de configuración sin limpiar el directorio de compilación. + + + + +Ejecuta make Makefile.cvs de nuevo para crear el script de configuración y seguir normalmente la compilación. Esta opción implica . + + + + +Intenta continuar la compilación desde el donde se había parado antes, es decir desde el último módulo compilado (correctamente o no). Esta opción implica . No debería incluir otros módulos en la línea de comandos. + + + + +Similar a , salvo que aquí debe indicar el módulo desde el que comenzar la compilación como siguiente parámetro. Esta opción implica . No debería incluir otros módulos en la línea de comandos. + + + + +Esta opción hará que se interprete el siguiente parámetro como el archivo del cual tomar las opciones de configuración. Por defecto es ~/.tdesvn-buildrc. + + + + +Le permite modificar el directorio en el cual se instalará &kde;. esta opción implica . + + + + +Con esta opción el script se detendrá después de ejecutar make Makefile.cvs. Todavía sigue siendo necesario ejecutar el script configure, aunque &tdesvn-build; lo hará la siguiente vez que lo ejecute. Así, podrá crear todos los scripts configure y ejecutar ./configure para cada módulo y ver qué opciones del script es necesario modificar. + + + +Si es la única opción que define, el script intentará instalar todos lo módulos que hayan sido correctamente compilados, salvo qt-copy que no precisa instalación. Todas las opciones que se escriban a continuación de se considerarán como nombres de módulos para instalar. + + + + +Esta opción le permite anular una determinada opción de su archivo de configuración para todos los módulos. Por ejemplo, para anular la opción log-dir, tendría que escribir + + + + +Esta opción le permite anular una determinada opción de su archivo de configuración para todos los módulos. Por ejemplo, para anular la opción use-unsermake en tdemultimedia, tendría que escribir . + + + + +Cualquier otra cosa que se escriba se asume como el nombre de módulos para actualizar o compilar. No mezcle compilación e instalación. + + + + +Créditos y licencias +&underFDL; + + diff --git a/tde-i18n-et/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt b/tde-i18n-et/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt deleted file mode 100644 index 3c7ddf03b9a..00000000000 --- a/tde-i18n-et/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt +++ /dev/null @@ -1,6 +0,0 @@ -# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer - -tde_create_handbook( - DESTINATION tdesvn-build - LANG et -) diff --git a/tde-i18n-et/docs/tdesdk/scripts/tdesvn-build/Makefile.am b/tde-i18n-et/docs/tdesdk/scripts/tdesvn-build/Makefile.am deleted file mode 100644 index b2e3512e7ad..00000000000 --- a/tde-i18n-et/docs/tdesdk/scripts/tdesvn-build/Makefile.am +++ /dev/null @@ -1,4 +0,0 @@ -KDE_LANG = et -SUBDIRS = $(AUTODIRS) -KDE_DOCS = tdesvn-build -KDE_MANS = AUTO diff --git a/tde-i18n-et/docs/tdesdk/scripts/tdesvn-build/index.docbook b/tde-i18n-et/docs/tdesdk/scripts/tdesvn-build/index.docbook deleted file mode 100644 index 068585a75af..00000000000 --- a/tde-i18n-et/docs/tdesdk/scripts/tdesvn-build/index.docbook +++ /dev/null @@ -1,739 +0,0 @@ - - - - - - Subversion"> - tdesvn-build"> -]> - - - - -Skripti &tdesvn-build; käsiraamat - - -MichaelPyne
michael.pyne@kdemail.net
 - -CarlosWoelz
carloswoelz@imap-mail.com
 - - - -MarekLaane
bald@starman.ee
Tõlge eesti keelde - - - - -2005 -Michael Pyne - - - -2005 -Carlos Woelz - - - -&FDLNotice; - -2005-06-18 -0.98 - - -&tdesvn-build; on Perli skript, mis ehitab ja paigaldab &kde; otse &kde; &svn;i hoidlast leiduvast lähtetekstist. - - - -KDE -tdesdk -SVN -Subversion -KDE arendus - - - - - - -Sissejuhatus - -&tdesvn-build; on Perli skript, mis aitab kasutajatel paigaldada &kde; otse &svn;i hoidlast. Sellega sarnaneb skript kde-build, mille leiab &kde; moodulist tdesdk. - -Alljärgnevalt tuleb juttu &tdesvn-build;'i konfiguratsioonifaili süntaksist ja võtmetest, käsureavõtmetest, omadustest ja sammudest, mida on vaja ette võtta &kde; ehitamiseks lähtekoodist, kaasa arvatud sammudest, mida tuleb sooritada muude tööriistadega, see tähendab, sammudest, mida skript &tdesvn-build; ei tee ise automaatselt. - - - - -Alustamine - -Käesolevas peatükis selgitame, kuidas kasutada &tdesvn-build;'i moodulite väljavõtmiseks &kde; hoidlast ja nende ehitamiseks. Me selgitame ka &kde; &svn;i põhimõttelist struktuuri ning samme, mida on vaja ette võtta enne skripti käivitamist. - -Kõiki peatükis vaadeldavaid teemasid käsitleb veelgi põhjalikumalt dokument Building &kde; from Source Step by Step Guide, mille leiab &kde; kvaliteedimeeskonna veebileheküljelt. 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. - - -Süsteemi ettevalmistamine &kde; ehitamiseks - -Soovitatav on &kde; alla laadida ja ehitada kasutajakontot tarvitades. Kui sul on juba &kde; tarkvarapaketid paigaldatud, on kõige mõistlikum luua uus spetsiaalne kasutaja oma uue &kde; ehitamiseks ja kasutamiseks. &kde; kasutamine spetsiaalse kasutajakontoga tagab selle, et sa ei riku oma põhisüsteemi ja saad alati kuhugi tagasi pöörduda, kui midagi peaks viltu minema. - -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. - -Enne skripti &tdesvn-build; (või muude ehitamisstrateegiate) kasutamist tuleb paigaldada arendustööriistad ja teegid, mida &kde; vajab. Vajalikud on Qt teek versiooniga 3.3.0 või uuem, Automake 1.8, Autoconf 2.5X (parem oleks >=2.57, sest väiksemate versioonidega on teada mõned vead), Subversioni (svn) klient, C++ toetusega gcc kompilaator, libxml2, openssl, libbz2 ja veel terve rida asju (täieliku nimekirja toob ära sait KDE Compilation Requirements). Üldiselt peaks neid juba eelnevalt kompileerituna tarkvarapakettidena jagama sinu distributsiooni looja. - -Osa neist tarkvarapakettidest on jagatud teekide, programmide või utiliitide ja arenduspakettideks. Sul läheb vaja vähemalt programmi- või teegi- ja arenduspaketti. Kahtluse korral paigalda kõik. Vajalikud teegid sõltuvad moodulitest, mida kavatsed ehitada, sest igal moodulil on oma nõuded. Täpsemalt kõneleb paigaldamiseks vajalikest tööriistadest ja võtetest ning nõutud tarkvarast dokument Building &kde; from Source Step by Step Guide. - -Tõenäoliselt on skript &tdesvn-build; juba sinu süsteemi paigaldatud, kui sa käesolevat käsiraamatut loed. &tdesvn-build; nõuab, et looksid konfiguratsioonifaili nimega .tdesvn-buildrc. See peab asuma kodukataloogis (~/) ja sisaldama kõiki konfiguratsiooniandmeid, mida skript tööks vajab, näiteks konfiguratsioonivõtmeid, kompileerimisvõtmeid, lähtetekstide asukohti, paigalduse sihtkohta (prefiksit), ehitatavate moodulite nimekirja &etc; Vaikimisi konfiguratsiooniandmeid pakub fail tdesvn-buildrc-sample. Rohkem infot konfiguratsioonifaili süntaksi kohta annavad ja . - -Värskeima versiooni hankimiseks uuri veebisaidil websvn.kde.org kataloogi tdesdk/scripts. Seal näed kõiki faile, mida pakub &kde; &svn;i hoidla alljaotus tdesdk/scripts. Klõpsa &tdesvn-build;'i lingil ja tõmba skripti värskeim versioon. Võta samasugune operatsioon ette failiga tdesvn-buildrc-sample. Muuda skript käivitatavaks ja kontrolli, et see asuks sinu otsinguteel (PATH). - - - - -Konfiguratsiooniandmete määramine - -Skripti kasutamiseks peab sinu kodukataloogis asuma fail nimega .tdesvn-buildrc, mis määrab üldised võtmed ning moodulid, mida soovid alla laadida ja ehitada. - -Kasuta globaalsete võtmete ja ehitatavate moodulite määramisel eeskujuna faili tdesvn-buildrc-sample. - -Vali globaalset võtit svn-server määrates server, kust soovid &svn;i väljavõtte teha. Vaikimisi on see anonüümne &svn;i hoidla svn://anonsvn.kde.org/, kuid seda võib mõistagi muuta, kui sul on &kde; &svn;i konto või kui on mõni sulle lähedasem peegelsait. - -Pööra tähelepanu globaalsetele muutujatele tdedir ja qtdir, kuna esimene neist määrab, kuhu sinu ehitatav &kde; paigaldatakse (vaikimisi ~/kde), ning teine, kus (kui üldse) ehitatakse ja kuhu paigaldatakse sinu Qt teek (vaikimisi ~/tdesvn/build/qt-copy). Muutujaid tdedir ja qtdir pead teadma ka hiljem, et määrata keskkonnamuutujad, mida läheb tarvis uue paigalduse tööks. Kontrolli, kas kirjasolevad moodulid on ikka need, mida soovid ehitada. Faili tdesvn-buildrc-sample vaikevõtmed peaksid sobima üsna hästi korraliku &kde; paigalduse tekitamisesks. Salvesta lõplik .tdesvn-buildrc oma kodukataloogi. - -Kui soovid faili .tdesvn-buildrc väga täpselt oma vajadustele kohandada, räägib konfiguratsioonivõtmetest lähemalt . - - - - -Skripti &tdesvn-build; kasutamine - -Nüüd oled valmis skripti käivitama. Logi terminaliaknas sisse selle kasutaja õigustega, kelle lõid &kde; kompileerimiseks, ning käivita skript: %su kasutajanimi -%tdesvn-build - - - -Nüüd peaks skript hakkama lähteteksti alla laadima ja seda kompileerima. Pole väga usutav, et sul õnnestub kohe esimese korraga &kde; igati edukalt kompileerida. Kuid ära heida meelt! Kontrolli logifaile, kust peaks selguma, kas sul puudusid mingid tööriistad või arenduspaketid (logifailide asukoha määrab konfiguratsioonifailis võti log-dir). Mõnikord on arendusharu üsna ebastabiilne ega taha lasta kuidagi ennast ehitada, eriti siis, kui arenduse külmutamispunkt peaks lähedal olema. Nii et ole kannatlik. Rohkem näiteid asjade kohta, mis saavad valesti minna, ja võimaluste kohta neid probleeme lahendada, samuti üldisi &kde; ehitamise nippe ja strateegiaid pakub dokument Building &kde; from Source Step by Step Guide. - - - - -Värske &kde; töökeskkonna määramine - -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. - -Ava kodukataloogis lemmikredaktoriga fail .bash_profile ja lisa selle lõppu: -TDEDIR=(tdedir'i asukoht) -TDEDIRS=$TDEDIR -PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH -LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH -export TDEDIRS PATH LD_LIBRARY_PATH - Kui aga ehitad qt-copy moodulit, lisa: TQTDIR=(qtdir'i asukoht) -TDEDIR=(tdedir'i asukoht) -TDEDIRS=$TDEDIR -PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH -MANPATH=$TQTDIR/doc/man:$MANPATH -LD_LIBRARY_PATH=$TDEDIR/lib:$TQTDIR/lib:$LD_LIBRARY_PATH -export TQTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH - - - -Kui sa ei tarvita spetsiaalset kasutajat, määra oma failis .bash_profile uuele keskkonnale teistsugune $TDEHOME: export TDEHOME="${HOME}/.tde-svn" - -# Vajaduse korral loo -[ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn - - - - -Kui hiljem peaks menüü tühi olema või hoopis liiga täis, võib olla vajalik failis .bash_profile kindlaks määrata ka xdg keskkonnamuutuja: XDG_CONFIG_DIRS="/etc/xdg" -XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" -export XDG_CONFIG_DIRS XDG_DATA_DIRS - - - - - -Nüüd, kus see on tehtud, kontrolli, et kasutataks ikka õiget skripti starttde: - -Ava kodukataloogis tekstifail .xinitrc (sõltuvalt distributsioonist võib see olla ka .xsession) või loo see vajaduse korral. Lisa rida: exec ${TDEDIR}/bin/starttde - - - -Nüüd käivita oma uus &kde;: virtuaalsete terminalide toetusega BSD ja Linuxi süsteemides kasutatakse klahvikombinatsioone Ctrl+Alt+F1...F12 lülitumiseks vastavalt virtuaalsele konsoolile 1 kuni 12. See võimaldab korraga panna tööle enam kui ühe töökeskkonna. Esimesed kuus on tekstiterminalid, viimased kuus graafilised kuvad. - -Kui sinu ette ilmub pärast arvuti käivitamist graafiline kuvahaldur, võid uue KDE töökeskkonna käivitada ka siis, kui seda valikute seas ei leidu. Selleks vajuta lihtsalt Crtl + Alt + F2 ning sinu ette ilmub tekstiterminal. Logi sisse spetsiaalse kasutajana ja anna käsk: - -startx -- :1 - - - -Lähtekoodist paigaldatud ja vana KDE võivad isegi korraga töötada! Logi sisse tavalise kasutajana ja käivita stabiilne KDE töölaud. Vajuta Crtl + Alt + F2 (või F1, F3 jne.) ning sinu ette ilmub tekstiterminal. Logi sisse spetsiaalse kasutajana ja anna käsk "startx -- :1". Tavalise kasutaja töölauale saad tagasi liikuda klahvikombinatsiooniga Crtl + Alt + F6 (või F7, F8 jne. - proovi, milline on see õige!). Lähtekoodist paigaldatud KDE juurde pääsed uuesti klahvikombinatsiooniga Crtl + Alt + F7 (või F6, F8 jne.). Nüüd võid lülituda erinevate KDE seansside vahel ja testida uut keskkonda teadmises, et saad alati turvaliselt naasta stabiilsele KDE töölauale. - - - - - - - - -Skripti omadused - -&tdesvn-build;'i peamised omadused on järgmised: - - - - -Moodulite automaatne väljavõtmine või uuendamine &svn;ist (kui vaja). - -Mõõdab moodulite ehitamise aega. - -Püüab automaatselt ümber ehitada mooduelid, mis kasutavad kasvavat make'i (tõsi, see ei pruugi alati õnnestuda). - -Võib jätkata kohast, kus eelmine skript pooleli jäi, või alustada ehitamist konkreetsest moodulist. - -Pakub omalt poolt välja mõistliku valiku vaikevõtmeid &kde; elementaarse ühekasutajapaigalduse tekitamiseks anonüümse &svn;i hoidla lähtekoodi põhjal. - -Toetab Unsermake'i kasutamist. - -Võimaldab tildega konfiguratsioonivõtmeid laiendada. Nii võib näiteks määrata: qtdir ~/tdesvn/build/qt-copy - - -Seadistatavad ehitamis-, lähtekoodi- ja logikataloogid - -Automaatne ehitussüsteemi loomine, milles lähtekoodikataloog erineb ehitamiskataloogist, et tagada lähtekoodikataloogi rikkumatus. Erandiks on qt-copy, mille ehitamine ei olegi nii mõeldud (kui sa ei soovi just testida qt'd eraldi ehituskataloogi võttega). - -Saab määrata globaalsed võtmed kõigile väljavõetavale moodulile, samuti võtmed igale moodulile eraldi. - -Kuna auto-tööriistad ei suuda mõnikord käia kaasas lähtekoodipuu muudatustega, saab mooduli ümberehitamise peale sundida, luues vajaliku mooduli ehituskataloogis faili .refresh-me või käivitates &tdesvn-build;'i võtmega . - -Saab määrata mitmesuguseid ehitamise ajal kasutatavaid keskkonnamuutujaid, sealhulgas TDEDIR, TQTDIR, DO_NOT_COMPILE ja CXXFLAGS. - -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. - -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 system() väljakutseid, mistõttu hetkel ei ole ilmselt soovitatav seda administraatorina tarvitada. - -make-install-prefix võimaldab anda käsule make install prefiksi omaette käsuna, mis on kasulik näiteks sudo pruukimisel. - -Võtmega apidox saab lastada automaatselt ehitada ja paigaldada mõne mooduli API dokumentatsiooni. - -Välja võib võtta ainult osa &kde; &svn;i moodulist. Näiteks võib välja võtta ainult taglib moodulist tdesupport või ainult K3B moodulist extragear/multimedia. Skript võtab automaatselt välja kde-common, kui seda on ehitamiseks vaja - -Võimalik on teeselda millegi tegemist. Käsureal võtit või andes pakub skript väga põhjaliku käivitatavate käskude kirjelduse ilma neid tegelikult käivitatamata. - -Välja võib võtta &svn;i moodulite konkreetseid harusid. See võimalus ei ole veel küll veatu, kuid igatahes saab valida ehitamiseks vajaliku haru, kasutades konfiguratsioonivõtit module-base-path. - - - -Mida &tdesvn-build; EI TEE: - - - -Kiireima &kde; &svn;i peegli leidmine. Skriptiga pole praegu kaasas isegi nende nimekirja, ehkki vaikimisi server peaks ka edukalt töötama. - -Hammaste pesemine. Seda pead igal hommikul ja õhtul ikka ise tegema. - -Skriptis võib esineda mõningaid vigu. Vabandame juba ette. - - - - - - -Faili .tdesvn-buildrc vorming - -Skripti kasutamiseks peab sul kodukataloogis olema fail .tdesvn-buildrc, mis kirjeldab mooduleid, mida soovid alla laadida ja ehitada. - - - -See algab globaalsete võtmetega umbes nii: - -global -võtme-nimi võtme-väärtus -[...] -end global - - -Sellele järgneb üks või enam moodulisektsiooni, mis näeb välja umbes nii: - -module mooduli-nimi -võtme-nimi võtme-väärtus -[...] -end module - - -mooduli-nimi peab olema &kde; &svn;i hoidlas leiduva mooduli nimi (näiteks tdelibs või tdebase). Mõned võtmed tühistavad globaalsed võtmed, mõned täiendavad globaalseid võtmeid, mõningaid globaalseid võtmeid aga ei saagi millegagi tühistada. - -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 eestpoolt. - - -apidox ehitab API dokumentatsiooni. -apply-qt-patches võimaldab kasutada qt-copy parandusi. -binpath määrab muutuja PATH. -branch teeb väljavõtte harust, mitte aga tüvest (trunk). -build-dir määrab ehitamiskataloogi. -checkout-only teeb väljavõtte ainult osast moodulist. -colorful-output muudab skripti väljundi värviliseks. -configure-flags määrab, milliste lippudega moodulit konfigureerida. -cxxflags määrab muutuja CXXFLAGS. -dest-dir muudab mooduli kataloogi nime. -disable-agent-check takistab tdesvn-build'il kontrollimast ssh-agent'i olekut. -do-not-compile määrab ehitamisest väljajäetavad kataloogid. -inst-apps määrab täpselt, millised kataloogid ehitada ja paigaldada. -install-after-build väldib paigaldamist pärast ehitamist. -tdedir määrab kataloogi, kuhu KDE paigaldada. -libpath määrab muutuja LD_LIBRARY_PATH. -make-install-prefix paneb paigaldamise ajal tööle abiprogrammi (näiteks sudo). -make-options edastab võtmed programmile make. -manual-build takistab mooduli automaatset ehitamist. -manual-update takistab mooduli juures igasugust automaatset tegevust. -module-base-path muudab asukohta, kuhu moodul alla laadida (kasulik harude ja siltide puhul). -niceness muudab protsessori prioriteeti. -no-rebuild-on-fail takistab programmi make taaskäivitamist, kui see ebaõnnestub. -qtdir määrab Qt asukoha. -set-env määrab keskkonnamuutuja. -source-dir muudab asukohta, kuhu laaditakse alla lähtekood. -stop-on-failure sunnib tdesvn-build'i peatuma kohe vea tekkimisel. -svn-server muudab serverit, kust lähtekood alla laaditakse. -use-qt-builddir-hack võimaldab Qt korral kasutada lähtekoodikataloogist erinevat ehitamiskataloogi (nagu KDE puhul). -use-unsermake võimaldab kasutada täiustatud unsermake'i ehitamissüsteemi. - - - -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. - - -Võtmete tabel - - - - -Võtme nimi -Mooduli ja globaalse võtme suhe -Märkused - - - - - - -apidox -Tühistab globaalse väärtuse -Anna võtmele väärtuseks true, et &tdesvn-build; ehitaks ja paigaldaks mooduli API dokumentatsiooni automaatselt pärast tavalist ehitamist/paigaldamist. See toimib ainult moodulite korral, kus käsk make apidox tõesti midagi teeb, näiteks tdelibs, tdebase ja koffice. - - - -apply-qt-patches -Tühistab globaalse väärtuse -See võti käib ainult qt-copy kohta. Kui väärtuseks on midagi muud kui null, siis käivitatakse enne ehitamist qt-copy kataloogis skript apply-patches, millega qt-copy'le lisatakse mitteametlikud paigad. Kuna need paigad ongi enamasti põhjuseks, miks kasutada qt-copy't, mitte aga tavalist Qt'd, siis ei tohiks üldiselt mingit kahju sündida. Vaikimisi on paikade kasutamine sisse lülitatud. - - - -binpath -Ei ole tühistatav -Selle võtmega saab ehitamiseks määrata keskkonnamuutuja PATH. Seda ei saa moodulivõtmega tühistada. Vaikimisi on väärtuseks /bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin. Keskkonnamuutuja peab koolonitega eraldatult sisaldama sinu arendustööriistade asukohti. Asukohad $TDEDIR/bin ja $TQTDIR/bin lisatakse automaatselt. Selle võtme juures võib iga asukoha määramisel tarvitada ka tildet (~). - - - - -branch -Tühistab globaalse väärtuse -Selle võtmega saab määrata KDE haru väljavõtmise, mitte aga vaikimisi väljavõetava tüve ("trunk"), kus üldiselt käib põhiline arendustegevus. Näiteks KDE 3.4 haru väljavõtmiseks määra võtme väärtuseks "3.4". -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. -Kui tdesvn-build ei suuda antud võtmega haru korralikult alla laadida, võib olla vajalik käsitsi määrata allalaadimiskoha URL võtmega override-url. - - - - -build-dir -Tühistab globaalse väärtuse -Selle võtmega saab muuta ehitamiseks kasutatava lähtekoodikataloogi asukohta. Seda saab määrata kolmel viisil: Suhteline &kde; &svn;i lähtekoodikataloogi suhtes (vaata the source-dir option). See on vaikevalik, mida skript kasutas versiooni 0.61. See valitakse juhul, kui annad kataloogi nime, mille alguses ei seisa tilde (~) või kaldkriips (/). Vaikeväärtus on build. Absoluutne asukoht. Kui määrad asukoha, mille alguses seisab kaldkriips (/), kasutatakse täpselt määratud asukohta. Näide: /tmp/kde-obj-dir/. Suhteline kodukataloogi suhtes. Kui määrad asukoha, mille alguses seisab tilde (~), arvestatakse seda asukohta sinu kodukataloogist lähtudes. Näide: ~/builddir määrab ehitamiskataloogiks /home/user-name/builddir. Mõnevõrra üllatuslikult saab seda võtit muuta ka igas moodulis eraldi. - - - -checkout-only -Tühistab globaalse väärtuse -Selle võtmega saab määrata &svn;i lähtekoodi väljavõtmise jupphaaval. Võtme väärtus kujutab endast tühikutega eraldatud väljavõetavate kataloogide nimekirja. Kui kataloog admin andmata jätta, lisatakse see automaatselt (vajaduse korral muidugi). Jupphaaval välja võttes hangitakse kataloog admin moodulist kde-common, kus see &svn;i serveris vaikimisi paiknebki. Ehkki see võti tühistab globaalse võtme, pane tähele, et selle määramine globaalse võtmena pole just eriti mõttekas. - - - -configure-flags -Täiendab globaalset võtit (v.a. qt-copy korral) -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 tühistab globaalsed seadistused, kui seda rakendatakse ka qt-copy jaoks. - - - -colorful-output -Ei ole tühistatav -Määra väärtuseks 'false', kui soovid keelata &tdesvn-build;'i värvilise väljundi. Vaikimisi on väärtuseks true. Pane tähele, et &tdesvn-build; saadab värvikoodid ainult terminali (näiteks xterm, &konsole; või tavaline Linuxi konsool). - - - -cxxflags -Täiendab globaalset võtit -Selle võtmega saab määrata, millised lipud edastada käsule ./configure kui CXXFLAGS mooduli ehitamissüsteemi loomisel. See võti on siin võtme configure-flags asemel, sest see määrab ka ehitamise ajal keskkonnamuutuja CXXFLAGS. - - - -dest-dir -Tühistab globaalse väärtuse -Selle vätmega saab määrata moodulile kettal antava nime. Kui näiteks moodul on extragear/network, saab selle võtmega anda sellele nimeks extragear-network. - - - -disable-agent-check -Ei ole tühistatav -Kui kasutad Subversion-lähtekoodi allalaadimiseks SSH-d (näiteks protokolli svn+ssh puhul), siis tdesvn-build püüab tavaliselt kontrollida, et ssh-agent haldaks tõepoolest mingeid SSH-identiteete. Nii saab vältida seda, et SSH päriks iga mooduli korral paroolifraasi. Soovi korral võib selle kontrolli välja lülitada, andes võtmele väärtuseks 'true'. - - - -do-not-compile -Tühistab globaalse väärtuse -Selle võtmega saab määrata enne konfigureerimisskripti käivitamist keskkonnamuutuja DO_NOT_COMPILE. Vastavalt dokumendile &kde; Developer FAQ ei ehitata selle korral ühtegi määratud tipptaseme kataloogi. Kataloogid tuleb eraldada tühikuga. - -Pane tähele, et programmide lähtekood laaditakse sellele vaatamata alla. Määramaks, milliseid katalooge alla laaditakse, kasuta võtit checkout-only. - - - - -email-address -Ei ole tühistatav - -Selle võtmega saab määrata e-posti aadressi, mida tdesvn-build kasutab, kui tal peaks tekkima vajadus e-kirja saata. Selle üle ei peaks muret tundma, kui sa ei kasuta mõnda e-posti võimalusega omadust (vaikimisi on need välja lülitatud). - -Praegu vajab seda võtit ainult võti email-on-compile-error. - - - - -email-on-compile-error -Ei ole tühistatav - -Selle võtmega võib määrata e-posti aadressi, kuhu saata kiri, kui mooduli ehitamine ebaõnnestub. tdesvn-build ootab, kuni kõigi moodulite ehitamine on lõppenud ja koondab siis kõik tulemused rapordisse. Raport saadetakse ainult siis, kui mooduli ehitamine ebaõnnestus. - -Võtmega email-address saab määrata aadressi, mida tdesvn-build saatmisel kasutab. Kontrolli seda, sest vaikimisi ei ole see arvatavasti sugugi selline, nagu vaja. - - - - -inst-apps -Tühistab globaalse väärtuse -See on vastupidine võtmele do-not-compile. Sellega saab määrata, et ehitatakse ainult kindlad tipptaseme kataloogid. Kataloogid tuleb eraldada tühikuga. - -Muudatused jõustuvad alles siis, kui käsk make Makefile.cvs uuesti käivitatakse - kas automaatselt skripti poolt või käsitsi võtmega või . - -Pane tähele, et programmide lähtekood laaditakse sellele vaatamata alla. Määramaks, milliseid katalooge alla laaditakse, kasuta võtit checkout-only. - - - - -install-after-build -Tühistab globaalse väärtuse -Selle võtmega saab paketi paigaldada pärast edukat ehitamist. Vaikimisi on see sisse lülitatud. Kui soovid seda keelata, määra selle võtme väärtuseks konfiguratsioonifailis 0. Samuti võib tarvitada käsurealippu . - - - -tdedir -Ei ole tühistatav -Selle võtmega määratakse kataloog, kuhu &kde; pärast ehitamist paigaldatakse. Vaikimisi on selleks ~/kde. Kui määrad siin kataloogi, mille ligipääs nõuab administraatori õigusi, tasuks tutvuda ka võtme make-install-prefix kirjeldusega. - - - -libpath -Ei ole tühistatav -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 $TDEDIR/lib ja $TQTDIR/lib lisatakse automaatselt. Võtme juures võib iga asukoha määramisel kasutada tildet (~). - - - -log-dir -Tühistab globaalse väärtuse -Selle võtmega saab muuta kataloogi, kus hoitakse skripti tekitatud logifaile. Alates skripti versioonist 0.64 saab seda määrata igale moodulile eraldi. - - - -make-install-prefix -Tühistab globaalse väärtuse -Selle võtmega saab tühikutega eraldatult määrata nimekirja, mida tõlgendatakse käsu ja selle võtmetena, mis lisatakse moodulite paigaldamiseks kasutatava käsu make install ette. See on kasulik näiteks pakettide paigaldamisel sudo'ga, kuid palun ole ettevaatlik, kui tegemist on administraatori õigustega. - - - -make-options -Tühistab globaalse väärtuse -Selle muutujaga saab edastada käsule make käsureavõtmeid. See on kasulik sellistele programmidele nagu distcc. distcc võimaldab jagada kompileerimise tulemust enam kui ühele arvutile. Selle kasutamiseks tuleb edastada käsule make võti . Vastavalt dokumentatsioonile on soovitatav lisada sellele arv kujul 2 * võrguprotsessorite_arv. Kui sul on kokku ainult üks protsessor, siis peaks see olema . - - - -manual-build -Tühistab globaalse väärtuse -Määra võtme väärtuseks true, kui soovid, et ehitamisel ei ehitataks antud moodulit. &svn;ist uuendamisel seda siiski uuendatakse. See on samaväärne käsureavõtmega . - - - -manual-update -Tühistab globaalse väärtuse -Määra võtme väärtuseks true, 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. - - - -module-base-path -Tühistab globaalse väärtuse -Selle võtmega saab tühistada &tdesvn-build;'i vaikimisi kataloogiasukoha antud moodulile. Seda saab kasutada näiteks konkreetse haru või sildi väljavõtmiseks. Õige asukoha määratlemisel on kindlasti hindamatuks abiks &kde; lähtekoodi hoidla veebis. -Pane tähele, et &tdesvn-build; loob lõpliku asukohta järgmise malli põhjal: $svn-server/home/kde/$module-base-path/$module-name. -Vaikeväärtus on sõltuvalt moodulinimest trunk või trunk/KDE. - - - - -niceness -Ei ole tühistatav -Selle võtme väärtus on arv vahemikus 20 kuni 0. Mida suurem arv, seda väiksem on prioriteet, mida &tdesvn-build; endale omistab. Vaikeväärtus on 10. - - - -no-rebuild-on-fail -Tühistab globaalse väärtuse -Määra selle võtme väärtuseks true, kui soovid vältida, et &tdesvn-build; hakkaks moodulit ümberehitama, kui inkrementehitamine ei õnnestu. Tavaliselt püüab &tdesvn-build; mooduli algusest peale ümber ehitada, et takistada &svn;i uuendamise halba mõju ehitamissüsteemile. - - - -override-url -Tühistab globaalse väärtuse -Selle võtme kasutamisel tarvitab tdesvn-build selle väärtust URL-ina, mis edastatakse Subversionile täiesti muutmatult. Üldiselt tuleks seda kasutada siis, kui soovid alla laadida konkreetset väljalaset, kuid tdesvn-build ei suuda sinu soovides võtme branch põhjal aru saada. - - - -qtdir -Ei ole tühistatav -Selle võtmega saab määrata ehitamisel kasutatava keskkonnamuutuja TQTDIR. Seda ei saa moodulivõtmega tühistada. Kui see pole määratud, kasutatakse vaikimisi asukohta $(source-dir)/build/qt-copy, mis kasutab &kde; lähtekoodihoidlas leiduvat qt-copy moodulit. Kodukataloogi tähistamiseks võib kasutada tildet (~). - - - -remove-after-install -Tühistab globaalse väärtuse -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. -Võtme võimalikud väärtused on järgmised: -none - midagi ei kustutata (vaikimisi). -builddir - kustutatakse ehitamiskataloog, aga mitte lähtekoodikataloog. -all - kustutatakse nii lähtekoodi- kui ehitamiskataloog. - - - -Pane tähele, et selle võtme kasutamine mõjutab päris negatiivselt nii sinu tekitatavat võrgukoormust (kui kasutad väärtust 'all') kui ka KDE kompileerimiseks kuluvat aega, sest tdesvn-build ei saa sel juhul kasutada inkrementehitamist. - - - - -set-env -Tühistab globaalse väärtuse -Selle võtme juures saab anda tühikuga eraldatult väärtuste nimekirja, mille esimene väärtus on määratav keskkonnamuutuja ja ülejäänud selle muutuja väärtused. Näiteks muutujale RONALD väärtuse McDonald andmine käib nii: -set-env RONALD McDonald -See võti on eriline selle poolest, et seda võib korrata ilma varasemaid set-env määratlusi konfiguratsioonifaili samas sektsioonis tühistamata. Sel moel võid moodulis (või ka globaalselt) määrata mitu keskkonnamuutujat. - - - - -source-dir -Ei ole tühistatav -Selle võtmega saab määrata kataloogi oma arvutis, kuhu salvestatakse &kde; &svn;i lähtekood. Kui see pole määratud, kasutatakse vaikeväärtusena ~/tdesvn. Väärtuse määramisel tuleks kasutada absoluutset asukohta. - - - -svn-server -Ei ole tühistatav -Selle võtmega saab määrata serveri, kust &svn; välja võetakse. Vaikimisi on see anonüümne &svn;i hoidla svn://anonsvn.kde.org/. - - - -stop-on-failure -Tühistab globaalse väärtuse -Määra selle võtme väärtuseks true, kui soovid, et skript peataks töö pärast vea tekkimist ehitamisel või paigaldamisel. Vaikimisi on see välja lülitatud. - - - -tag -Tühistab globaalse väärtuse -Selle võtmega saab alla laadida mooduli konkreetse väljalaske. -MÄRKUS: on üsna usutav, et SA EI SOOVI seda võtit kasutada. KDE väljalasked asuvad tar-failidena KDE FTP-saidil ning selle peegelsaitidel. -Kui kasutad tdesvn-build'i sellepärast, et sul on probleeme sinu distributsioonile mõeldud KDE väljalasetega, võiks kaaluda mõte pruukida ehitamistööriista Konstruct, mis kasutab väljalasete tar-faile. - - - - -use-qt-builddir-hack -Tühistab globaalse väärtuse -Kuigi see võti tühistab globaalse võtme, on sel mõtet ainult qt-copy korral. Määra võtme väärtuseks true, kui soovid lubada skriptil tarvitada eksperimentaalset srcdir != builddir režiimi. Sisselülitamise korral kopeerib &tdesvn-build; qt-copy lähtemooduli ehitamiskataloogi ja sooritab ehitamise seal. See tähendab, et keskkonnamuutuja TQTDIR väärtuseks tuleb määrata $(qt-copy-build-dir)/qt-copy/lib. Samuti tuleb vastavalt muuta võtit qtdir. Selles režiimis saab kasutada ka inkrement-make'i, sest kopeerimise järel säilitatakse ajatemplid. Kui tarvitad võtit apply-qt-patches, rakendatakse paigad ehitamis-, mitte lähtekoodikataloogis. Vaikimisi on võtme väärtuseks true. - - - -use-unsermake -Tühistab globaalse väärtuse -Määra võtme väärtuseks true, kui soovid konfigureerimisskripti käivitamisel kasutada atuomake'i asemel eksperimentaalset unsermake'i. See võib mõnikord suurendada tublisti ehitamisaega, eriti jagatud ehitamissüsteemi korral. Vaikimisi on väärtuseks enamiku moodulite korral true. - -Tavaliselt püüab tdesvn-build selle võtme kasutamisel hoida unsermake'i alati värskena. See võib muutuda tülikaks, eriti kui soovid unsermake'i ise hallata. Sel juhul anna võtmele väärtuseks self ja kuigi tdesvn-build kasutab sel juhul endiselt unsermake'i, ei üritata seda värskena hoida. - - - - - - -
- - - - -Käsureavõtmed ja keskkonnamuutujad - -Skript ei kasuta keskkonnamuutujaid. Kui sul on vaja ehitamiseks või paigaldamiseks määrata keskkonnamuutujaid, uuri võtme set-env kirjeldust. - -Skript tunnistab järgmisi käsureavõtmeid: - - - - - -Näitab lihtsat abiinfot skripti kohta. - - - - -Näitab programmi versiooni. - - - - -Näitab autori kontaktinfot. - - - - -Lubab värvilise väljundi. - - - - -Keelab värvilise väljundi. - - - - (või ) -Tegelikult EI VÕETA midagi ette, vaid ainult teeseldakse. - - - - (või ) -Väljund on väheminformatiivsem, näidatakse ainult kõige olulisemaid teateid. - - - - -Väljund näitab ainult hoiatusi ja veateateid. - - - - -Väljund näitab põhjalikult kõike, mis toimub. - - - - -Võetakse ette ainult lähtekoodi uuendamine. - - - - -Võetakse ette ainult ehitamine. - - - - -Uuendamisse/ehitamisse ei kaasata ülejäänud käsureal antud mooduleid. - - - - -Ei looda ühendust &svn;i serveriga. - - - - -Ehitamine jäetakse vahele. - - - - -Pakette ei paigaldata pärast ehitamist automaatselt. - - - - -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. - - - - -Ei üritata algusest peale ümber ehitada mooduleid, mille ehitamine ebaõnnestus. &tdesvn-build; ei ürita seda kunagi mooduli korral, mida on juba püütud algusest peale ehitada. - - - - -Taasluuakse ehitamissüsteem ja alustatakse algusest peale. - - - - -Käivitatakse uuesti konfigureerimisskript ilma ehitamiskataloogi puhastamata. - - - - -Antakse uuesti käsk make Makefile.cvs, et luua konfigureerimisskript ja jätkata ehitamist normaalselt. See eeldab võtit . - - - - -See üritab jätkata ehitamist sealt, kus skript eelmisel korral pooleli jäi. Skript hakkab ehitama moodulit, mis järgneb moodulile, mida kompoleeriti skripti viimasel töökorral (sõltumata sellest, kas ehitamine oli edukas või mitte). See eeldab võtit . Käsureal ei tohi määrata teisi moodulinimesid. - - - - -Sarnaneb võtmega , ainult et sul tuleb anda käsureal parameetrina moodul, millest ehitamist alustada. See eeldab võtit . Käsureal ei tohi määrata teisi moodulinimesid. - - - - -Järgmist käsureal antud parameetrit tõlgendatakse failina, millest lugeda konfiguratsioonivõtmed. Vaikeväärtus on ~/.tdesvn-buildrc. - - - - -Võimaldab muuta kataloogi, kuhu &kde; paigaldatakse. See eeldab võtit . - - - - -Peatab skripti töö pärast käsu make Makefile.cvs täitmist. Konfiguratsiooniskripti paneb &tdesvn-build; tööle siis alles järgmisel käivitamisel. See võimaldab kõik konfiguratsiooniskriptid korraga ette valmistada, nii et saad vaadata igas moodulis ./configure ja muuta vastavalt konfigureerimislippe. - - - -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 esineb veel käsureavõtmeid, tõlgendatakse neid paigaldatavate moodulitena. - - - - -Selle võtmega saab kõigi mooduli jaoks tühistada konfiguratsioonifailis leiduva võtme. Kui näiteks soovid tühistada võtit log-dir, siis see käib nii: . - - - - -Selle võtmega saab iga mooduli jaoks tühistada konfiguratsioonifailis leiduva võtme. Kui näiteks soovid tühistada võtit use-unsermake moodulis tdemultimedia, siis see käib nii: . - - - - -Kõiki muid käsureavõtmeid tõlgendatakse uuendatavate ja ehitatavate moodulitena. Palun ära aja ehitamist segamini paigaldamisega. - - - - -Autorid ja litsents -&underFDL; - - diff --git a/tde-i18n-et/docs/tdesdk/tdesvn-build/CMakeLists.txt b/tde-i18n-et/docs/tdesdk/tdesvn-build/CMakeLists.txt new file mode 100644 index 00000000000..3c7ddf03b9a --- /dev/null +++ b/tde-i18n-et/docs/tdesdk/tdesvn-build/CMakeLists.txt @@ -0,0 +1,6 @@ +# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer + +tde_create_handbook( + DESTINATION tdesvn-build + LANG et +) diff --git a/tde-i18n-et/docs/tdesdk/tdesvn-build/Makefile.am b/tde-i18n-et/docs/tdesdk/tdesvn-build/Makefile.am new file mode 100644 index 00000000000..b2e3512e7ad --- /dev/null +++ b/tde-i18n-et/docs/tdesdk/tdesvn-build/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = et +SUBDIRS = $(AUTODIRS) +KDE_DOCS = tdesvn-build +KDE_MANS = AUTO diff --git a/tde-i18n-et/docs/tdesdk/tdesvn-build/index.docbook b/tde-i18n-et/docs/tdesdk/tdesvn-build/index.docbook new file mode 100644 index 00000000000..068585a75af --- /dev/null +++ b/tde-i18n-et/docs/tdesdk/tdesvn-build/index.docbook @@ -0,0 +1,739 @@ + + + + + + Subversion"> + tdesvn-build"> +]> + + + + +Skripti &tdesvn-build; käsiraamat + + +MichaelPyne
michael.pyne@kdemail.net
 + +CarlosWoelz
carloswoelz@imap-mail.com
 + + + +MarekLaane
bald@starman.ee
Tõlge eesti keelde + + + + +2005 +Michael Pyne + + + +2005 +Carlos Woelz + + + +&FDLNotice; + +2005-06-18 +0.98 + + +&tdesvn-build; on Perli skript, mis ehitab ja paigaldab &kde; otse &kde; &svn;i hoidlast leiduvast lähtetekstist. + + + +KDE +tdesdk +SVN +Subversion +KDE arendus + + + + + + +Sissejuhatus + +&tdesvn-build; on Perli skript, mis aitab kasutajatel paigaldada &kde; otse &svn;i hoidlast. Sellega sarnaneb skript kde-build, mille leiab &kde; moodulist tdesdk. + +Alljärgnevalt tuleb juttu &tdesvn-build;'i konfiguratsioonifaili süntaksist ja võtmetest, käsureavõtmetest, omadustest ja sammudest, mida on vaja ette võtta &kde; ehitamiseks lähtekoodist, kaasa arvatud sammudest, mida tuleb sooritada muude tööriistadega, see tähendab, sammudest, mida skript &tdesvn-build; ei tee ise automaatselt. + + + + +Alustamine + +Käesolevas peatükis selgitame, kuidas kasutada &tdesvn-build;'i moodulite väljavõtmiseks &kde; hoidlast ja nende ehitamiseks. Me selgitame ka &kde; &svn;i põhimõttelist struktuuri ning samme, mida on vaja ette võtta enne skripti käivitamist. + +Kõiki peatükis vaadeldavaid teemasid käsitleb veelgi põhjalikumalt dokument Building &kde; from Source Step by Step Guide, mille leiab &kde; kvaliteedimeeskonna veebileheküljelt. 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. + + +Süsteemi ettevalmistamine &kde; ehitamiseks + +Soovitatav on &kde; alla laadida ja ehitada kasutajakontot tarvitades. Kui sul on juba &kde; tarkvarapaketid paigaldatud, on kõige mõistlikum luua uus spetsiaalne kasutaja oma uue &kde; ehitamiseks ja kasutamiseks. &kde; kasutamine spetsiaalse kasutajakontoga tagab selle, et sa ei riku oma põhisüsteemi ja saad alati kuhugi tagasi pöörduda, kui midagi peaks viltu minema. + +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. + +Enne skripti &tdesvn-build; (või muude ehitamisstrateegiate) kasutamist tuleb paigaldada arendustööriistad ja teegid, mida &kde; vajab. Vajalikud on Qt teek versiooniga 3.3.0 või uuem, Automake 1.8, Autoconf 2.5X (parem oleks >=2.57, sest väiksemate versioonidega on teada mõned vead), Subversioni (svn) klient, C++ toetusega gcc kompilaator, libxml2, openssl, libbz2 ja veel terve rida asju (täieliku nimekirja toob ära sait KDE Compilation Requirements). Üldiselt peaks neid juba eelnevalt kompileerituna tarkvarapakettidena jagama sinu distributsiooni looja. + +Osa neist tarkvarapakettidest on jagatud teekide, programmide või utiliitide ja arenduspakettideks. Sul läheb vaja vähemalt programmi- või teegi- ja arenduspaketti. Kahtluse korral paigalda kõik. Vajalikud teegid sõltuvad moodulitest, mida kavatsed ehitada, sest igal moodulil on oma nõuded. Täpsemalt kõneleb paigaldamiseks vajalikest tööriistadest ja võtetest ning nõutud tarkvarast dokument Building &kde; from Source Step by Step Guide. + +Tõenäoliselt on skript &tdesvn-build; juba sinu süsteemi paigaldatud, kui sa käesolevat käsiraamatut loed. &tdesvn-build; nõuab, et looksid konfiguratsioonifaili nimega .tdesvn-buildrc. See peab asuma kodukataloogis (~/) ja sisaldama kõiki konfiguratsiooniandmeid, mida skript tööks vajab, näiteks konfiguratsioonivõtmeid, kompileerimisvõtmeid, lähtetekstide asukohti, paigalduse sihtkohta (prefiksit), ehitatavate moodulite nimekirja &etc; Vaikimisi konfiguratsiooniandmeid pakub fail tdesvn-buildrc-sample. Rohkem infot konfiguratsioonifaili süntaksi kohta annavad ja . + +Värskeima versiooni hankimiseks uuri veebisaidil websvn.kde.org kataloogi tdesdk/scripts. Seal näed kõiki faile, mida pakub &kde; &svn;i hoidla alljaotus tdesdk/scripts. Klõpsa &tdesvn-build;'i lingil ja tõmba skripti värskeim versioon. Võta samasugune operatsioon ette failiga tdesvn-buildrc-sample. Muuda skript käivitatavaks ja kontrolli, et see asuks sinu otsinguteel (PATH). + + + + +Konfiguratsiooniandmete määramine + +Skripti kasutamiseks peab sinu kodukataloogis asuma fail nimega .tdesvn-buildrc, mis määrab üldised võtmed ning moodulid, mida soovid alla laadida ja ehitada. + +Kasuta globaalsete võtmete ja ehitatavate moodulite määramisel eeskujuna faili tdesvn-buildrc-sample. + +Vali globaalset võtit svn-server määrates server, kust soovid &svn;i väljavõtte teha. Vaikimisi on see anonüümne &svn;i hoidla svn://anonsvn.kde.org/, kuid seda võib mõistagi muuta, kui sul on &kde; &svn;i konto või kui on mõni sulle lähedasem peegelsait. + +Pööra tähelepanu globaalsetele muutujatele tdedir ja qtdir, kuna esimene neist määrab, kuhu sinu ehitatav &kde; paigaldatakse (vaikimisi ~/kde), ning teine, kus (kui üldse) ehitatakse ja kuhu paigaldatakse sinu Qt teek (vaikimisi ~/tdesvn/build/qt-copy). Muutujaid tdedir ja qtdir pead teadma ka hiljem, et määrata keskkonnamuutujad, mida läheb tarvis uue paigalduse tööks. Kontrolli, kas kirjasolevad moodulid on ikka need, mida soovid ehitada. Faili tdesvn-buildrc-sample vaikevõtmed peaksid sobima üsna hästi korraliku &kde; paigalduse tekitamisesks. Salvesta lõplik .tdesvn-buildrc oma kodukataloogi. + +Kui soovid faili .tdesvn-buildrc väga täpselt oma vajadustele kohandada, räägib konfiguratsioonivõtmetest lähemalt . + + + + +Skripti &tdesvn-build; kasutamine + +Nüüd oled valmis skripti käivitama. Logi terminaliaknas sisse selle kasutaja õigustega, kelle lõid &kde; kompileerimiseks, ning käivita skript: %su kasutajanimi +%tdesvn-build + + + +Nüüd peaks skript hakkama lähteteksti alla laadima ja seda kompileerima. Pole väga usutav, et sul õnnestub kohe esimese korraga &kde; igati edukalt kompileerida. Kuid ära heida meelt! Kontrolli logifaile, kust peaks selguma, kas sul puudusid mingid tööriistad või arenduspaketid (logifailide asukoha määrab konfiguratsioonifailis võti log-dir). Mõnikord on arendusharu üsna ebastabiilne ega taha lasta kuidagi ennast ehitada, eriti siis, kui arenduse külmutamispunkt peaks lähedal olema. Nii et ole kannatlik. Rohkem näiteid asjade kohta, mis saavad valesti minna, ja võimaluste kohta neid probleeme lahendada, samuti üldisi &kde; ehitamise nippe ja strateegiaid pakub dokument Building &kde; from Source Step by Step Guide. + + + + +Värske &kde; töökeskkonna määramine + +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. + +Ava kodukataloogis lemmikredaktoriga fail .bash_profile ja lisa selle lõppu: +TDEDIR=(tdedir'i asukoht) +TDEDIRS=$TDEDIR +PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH +LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH +export TDEDIRS PATH LD_LIBRARY_PATH + Kui aga ehitad qt-copy moodulit, lisa: TQTDIR=(qtdir'i asukoht) +TDEDIR=(tdedir'i asukoht) +TDEDIRS=$TDEDIR +PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH +MANPATH=$TQTDIR/doc/man:$MANPATH +LD_LIBRARY_PATH=$TDEDIR/lib:$TQTDIR/lib:$LD_LIBRARY_PATH +export TQTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH + + + +Kui sa ei tarvita spetsiaalset kasutajat, määra oma failis .bash_profile uuele keskkonnale teistsugune $TDEHOME: export TDEHOME="${HOME}/.tde-svn" + +# Vajaduse korral loo +[ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn + + + + +Kui hiljem peaks menüü tühi olema või hoopis liiga täis, võib olla vajalik failis .bash_profile kindlaks määrata ka xdg keskkonnamuutuja: XDG_CONFIG_DIRS="/etc/xdg" +XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" +export XDG_CONFIG_DIRS XDG_DATA_DIRS + + + + + +Nüüd, kus see on tehtud, kontrolli, et kasutataks ikka õiget skripti starttde: + +Ava kodukataloogis tekstifail .xinitrc (sõltuvalt distributsioonist võib see olla ka .xsession) või loo see vajaduse korral. Lisa rida: exec ${TDEDIR}/bin/starttde + + + +Nüüd käivita oma uus &kde;: virtuaalsete terminalide toetusega BSD ja Linuxi süsteemides kasutatakse klahvikombinatsioone Ctrl+Alt+F1...F12 lülitumiseks vastavalt virtuaalsele konsoolile 1 kuni 12. See võimaldab korraga panna tööle enam kui ühe töökeskkonna. Esimesed kuus on tekstiterminalid, viimased kuus graafilised kuvad. + +Kui sinu ette ilmub pärast arvuti käivitamist graafiline kuvahaldur, võid uue KDE töökeskkonna käivitada ka siis, kui seda valikute seas ei leidu. Selleks vajuta lihtsalt Crtl + Alt + F2 ning sinu ette ilmub tekstiterminal. Logi sisse spetsiaalse kasutajana ja anna käsk: + +startx -- :1 + + + +Lähtekoodist paigaldatud ja vana KDE võivad isegi korraga töötada! Logi sisse tavalise kasutajana ja käivita stabiilne KDE töölaud. Vajuta Crtl + Alt + F2 (või F1, F3 jne.) ning sinu ette ilmub tekstiterminal. Logi sisse spetsiaalse kasutajana ja anna käsk "startx -- :1". Tavalise kasutaja töölauale saad tagasi liikuda klahvikombinatsiooniga Crtl + Alt + F6 (või F7, F8 jne. - proovi, milline on see õige!). Lähtekoodist paigaldatud KDE juurde pääsed uuesti klahvikombinatsiooniga Crtl + Alt + F7 (või F6, F8 jne.). Nüüd võid lülituda erinevate KDE seansside vahel ja testida uut keskkonda teadmises, et saad alati turvaliselt naasta stabiilsele KDE töölauale. + + + + + + + + +Skripti omadused + +&tdesvn-build;'i peamised omadused on järgmised: + + + + +Moodulite automaatne väljavõtmine või uuendamine &svn;ist (kui vaja). + +Mõõdab moodulite ehitamise aega. + +Püüab automaatselt ümber ehitada mooduelid, mis kasutavad kasvavat make'i (tõsi, see ei pruugi alati õnnestuda). + +Võib jätkata kohast, kus eelmine skript pooleli jäi, või alustada ehitamist konkreetsest moodulist. + +Pakub omalt poolt välja mõistliku valiku vaikevõtmeid &kde; elementaarse ühekasutajapaigalduse tekitamiseks anonüümse &svn;i hoidla lähtekoodi põhjal. + +Toetab Unsermake'i kasutamist. + +Võimaldab tildega konfiguratsioonivõtmeid laiendada. Nii võib näiteks määrata: qtdir ~/tdesvn/build/qt-copy + + +Seadistatavad ehitamis-, lähtekoodi- ja logikataloogid + +Automaatne ehitussüsteemi loomine, milles lähtekoodikataloog erineb ehitamiskataloogist, et tagada lähtekoodikataloogi rikkumatus. Erandiks on qt-copy, mille ehitamine ei olegi nii mõeldud (kui sa ei soovi just testida qt'd eraldi ehituskataloogi võttega). + +Saab määrata globaalsed võtmed kõigile väljavõetavale moodulile, samuti võtmed igale moodulile eraldi. + +Kuna auto-tööriistad ei suuda mõnikord käia kaasas lähtekoodipuu muudatustega, saab mooduli ümberehitamise peale sundida, luues vajaliku mooduli ehituskataloogis faili .refresh-me või käivitates &tdesvn-build;'i võtmega . + +Saab määrata mitmesuguseid ehitamise ajal kasutatavaid keskkonnamuutujaid, sealhulgas TDEDIR, TQTDIR, DO_NOT_COMPILE ja CXXFLAGS. + +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. + +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 system() väljakutseid, mistõttu hetkel ei ole ilmselt soovitatav seda administraatorina tarvitada. + +make-install-prefix võimaldab anda käsule make install prefiksi omaette käsuna, mis on kasulik näiteks sudo pruukimisel. + +Võtmega apidox saab lastada automaatselt ehitada ja paigaldada mõne mooduli API dokumentatsiooni. + +Välja võib võtta ainult osa &kde; &svn;i moodulist. Näiteks võib välja võtta ainult taglib moodulist tdesupport või ainult K3B moodulist extragear/multimedia. Skript võtab automaatselt välja kde-common, kui seda on ehitamiseks vaja + +Võimalik on teeselda millegi tegemist. Käsureal võtit või andes pakub skript väga põhjaliku käivitatavate käskude kirjelduse ilma neid tegelikult käivitatamata. + +Välja võib võtta &svn;i moodulite konkreetseid harusid. See võimalus ei ole veel küll veatu, kuid igatahes saab valida ehitamiseks vajaliku haru, kasutades konfiguratsioonivõtit module-base-path. + + + +Mida &tdesvn-build; EI TEE: + + + +Kiireima &kde; &svn;i peegli leidmine. Skriptiga pole praegu kaasas isegi nende nimekirja, ehkki vaikimisi server peaks ka edukalt töötama. + +Hammaste pesemine. Seda pead igal hommikul ja õhtul ikka ise tegema. + +Skriptis võib esineda mõningaid vigu. Vabandame juba ette. + + + + + + +Faili .tdesvn-buildrc vorming + +Skripti kasutamiseks peab sul kodukataloogis olema fail .tdesvn-buildrc, mis kirjeldab mooduleid, mida soovid alla laadida ja ehitada. + + + +See algab globaalsete võtmetega umbes nii: + +global +võtme-nimi võtme-väärtus +[...] +end global + + +Sellele järgneb üks või enam moodulisektsiooni, mis näeb välja umbes nii: + +module mooduli-nimi +võtme-nimi võtme-väärtus +[...] +end module + + +mooduli-nimi peab olema &kde; &svn;i hoidlas leiduva mooduli nimi (näiteks tdelibs või tdebase). Mõned võtmed tühistavad globaalsed võtmed, mõned täiendavad globaalseid võtmeid, mõningaid globaalseid võtmeid aga ei saagi millegagi tühistada. + +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 eestpoolt. + + +apidox ehitab API dokumentatsiooni. +apply-qt-patches võimaldab kasutada qt-copy parandusi. +binpath määrab muutuja PATH. +branch teeb väljavõtte harust, mitte aga tüvest (trunk). +build-dir määrab ehitamiskataloogi. +checkout-only teeb väljavõtte ainult osast moodulist. +colorful-output muudab skripti väljundi värviliseks. +configure-flags määrab, milliste lippudega moodulit konfigureerida. +cxxflags määrab muutuja CXXFLAGS. +dest-dir muudab mooduli kataloogi nime. +disable-agent-check takistab tdesvn-build'il kontrollimast ssh-agent'i olekut. +do-not-compile määrab ehitamisest väljajäetavad kataloogid. +inst-apps määrab täpselt, millised kataloogid ehitada ja paigaldada. +install-after-build väldib paigaldamist pärast ehitamist. +tdedir määrab kataloogi, kuhu KDE paigaldada. +libpath määrab muutuja LD_LIBRARY_PATH. +make-install-prefix paneb paigaldamise ajal tööle abiprogrammi (näiteks sudo). +make-options edastab võtmed programmile make. +manual-build takistab mooduli automaatset ehitamist. +manual-update takistab mooduli juures igasugust automaatset tegevust. +module-base-path muudab asukohta, kuhu moodul alla laadida (kasulik harude ja siltide puhul). +niceness muudab protsessori prioriteeti. +no-rebuild-on-fail takistab programmi make taaskäivitamist, kui see ebaõnnestub. +qtdir määrab Qt asukoha. +set-env määrab keskkonnamuutuja. +source-dir muudab asukohta, kuhu laaditakse alla lähtekood. +stop-on-failure sunnib tdesvn-build'i peatuma kohe vea tekkimisel. +svn-server muudab serverit, kust lähtekood alla laaditakse. +use-qt-builddir-hack võimaldab Qt korral kasutada lähtekoodikataloogist erinevat ehitamiskataloogi (nagu KDE puhul). +use-unsermake võimaldab kasutada täiustatud unsermake'i ehitamissüsteemi. + + + +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. + + +Võtmete tabel + + + + +Võtme nimi +Mooduli ja globaalse võtme suhe +Märkused + + + + + + +apidox +Tühistab globaalse väärtuse +Anna võtmele väärtuseks true, et &tdesvn-build; ehitaks ja paigaldaks mooduli API dokumentatsiooni automaatselt pärast tavalist ehitamist/paigaldamist. See toimib ainult moodulite korral, kus käsk make apidox tõesti midagi teeb, näiteks tdelibs, tdebase ja koffice. + + + +apply-qt-patches +Tühistab globaalse väärtuse +See võti käib ainult qt-copy kohta. Kui väärtuseks on midagi muud kui null, siis käivitatakse enne ehitamist qt-copy kataloogis skript apply-patches, millega qt-copy'le lisatakse mitteametlikud paigad. Kuna need paigad ongi enamasti põhjuseks, miks kasutada qt-copy't, mitte aga tavalist Qt'd, siis ei tohiks üldiselt mingit kahju sündida. Vaikimisi on paikade kasutamine sisse lülitatud. + + + +binpath +Ei ole tühistatav +Selle võtmega saab ehitamiseks määrata keskkonnamuutuja PATH. Seda ei saa moodulivõtmega tühistada. Vaikimisi on väärtuseks /bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin. Keskkonnamuutuja peab koolonitega eraldatult sisaldama sinu arendustööriistade asukohti. Asukohad $TDEDIR/bin ja $TQTDIR/bin lisatakse automaatselt. Selle võtme juures võib iga asukoha määramisel tarvitada ka tildet (~). + + + + +branch +Tühistab globaalse väärtuse +Selle võtmega saab määrata KDE haru väljavõtmise, mitte aga vaikimisi väljavõetava tüve ("trunk"), kus üldiselt käib põhiline arendustegevus. Näiteks KDE 3.4 haru väljavõtmiseks määra võtme väärtuseks "3.4". +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. +Kui tdesvn-build ei suuda antud võtmega haru korralikult alla laadida, võib olla vajalik käsitsi määrata allalaadimiskoha URL võtmega override-url. + + + + +build-dir +Tühistab globaalse väärtuse +Selle võtmega saab muuta ehitamiseks kasutatava lähtekoodikataloogi asukohta. Seda saab määrata kolmel viisil: Suhteline &kde; &svn;i lähtekoodikataloogi suhtes (vaata the source-dir option). See on vaikevalik, mida skript kasutas versiooni 0.61. See valitakse juhul, kui annad kataloogi nime, mille alguses ei seisa tilde (~) või kaldkriips (/). Vaikeväärtus on build. Absoluutne asukoht. Kui määrad asukoha, mille alguses seisab kaldkriips (/), kasutatakse täpselt määratud asukohta. Näide: /tmp/kde-obj-dir/. Suhteline kodukataloogi suhtes. Kui määrad asukoha, mille alguses seisab tilde (~), arvestatakse seda asukohta sinu kodukataloogist lähtudes. Näide: ~/builddir määrab ehitamiskataloogiks /home/user-name/builddir. Mõnevõrra üllatuslikult saab seda võtit muuta ka igas moodulis eraldi. + + + +checkout-only +Tühistab globaalse väärtuse +Selle võtmega saab määrata &svn;i lähtekoodi väljavõtmise jupphaaval. Võtme väärtus kujutab endast tühikutega eraldatud väljavõetavate kataloogide nimekirja. Kui kataloog admin andmata jätta, lisatakse see automaatselt (vajaduse korral muidugi). Jupphaaval välja võttes hangitakse kataloog admin moodulist kde-common, kus see &svn;i serveris vaikimisi paiknebki. Ehkki see võti tühistab globaalse võtme, pane tähele, et selle määramine globaalse võtmena pole just eriti mõttekas. + + + +configure-flags +Täiendab globaalset võtit (v.a. qt-copy korral) +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 tühistab globaalsed seadistused, kui seda rakendatakse ka qt-copy jaoks. + + + +colorful-output +Ei ole tühistatav +Määra väärtuseks 'false', kui soovid keelata &tdesvn-build;'i värvilise väljundi. Vaikimisi on väärtuseks true. Pane tähele, et &tdesvn-build; saadab värvikoodid ainult terminali (näiteks xterm, &konsole; või tavaline Linuxi konsool). + + + +cxxflags +Täiendab globaalset võtit +Selle võtmega saab määrata, millised lipud edastada käsule ./configure kui CXXFLAGS mooduli ehitamissüsteemi loomisel. See võti on siin võtme configure-flags asemel, sest see määrab ka ehitamise ajal keskkonnamuutuja CXXFLAGS. + + + +dest-dir +Tühistab globaalse väärtuse +Selle vätmega saab määrata moodulile kettal antava nime. Kui näiteks moodul on extragear/network, saab selle võtmega anda sellele nimeks extragear-network. + + + +disable-agent-check +Ei ole tühistatav +Kui kasutad Subversion-lähtekoodi allalaadimiseks SSH-d (näiteks protokolli svn+ssh puhul), siis tdesvn-build püüab tavaliselt kontrollida, et ssh-agent haldaks tõepoolest mingeid SSH-identiteete. Nii saab vältida seda, et SSH päriks iga mooduli korral paroolifraasi. Soovi korral võib selle kontrolli välja lülitada, andes võtmele väärtuseks 'true'. + + + +do-not-compile +Tühistab globaalse väärtuse +Selle võtmega saab määrata enne konfigureerimisskripti käivitamist keskkonnamuutuja DO_NOT_COMPILE. Vastavalt dokumendile &kde; Developer FAQ ei ehitata selle korral ühtegi määratud tipptaseme kataloogi. Kataloogid tuleb eraldada tühikuga. + +Pane tähele, et programmide lähtekood laaditakse sellele vaatamata alla. Määramaks, milliseid katalooge alla laaditakse, kasuta võtit checkout-only. + + + + +email-address +Ei ole tühistatav + +Selle võtmega saab määrata e-posti aadressi, mida tdesvn-build kasutab, kui tal peaks tekkima vajadus e-kirja saata. Selle üle ei peaks muret tundma, kui sa ei kasuta mõnda e-posti võimalusega omadust (vaikimisi on need välja lülitatud). + +Praegu vajab seda võtit ainult võti email-on-compile-error. + + + + +email-on-compile-error +Ei ole tühistatav + +Selle võtmega võib määrata e-posti aadressi, kuhu saata kiri, kui mooduli ehitamine ebaõnnestub. tdesvn-build ootab, kuni kõigi moodulite ehitamine on lõppenud ja koondab siis kõik tulemused rapordisse. Raport saadetakse ainult siis, kui mooduli ehitamine ebaõnnestus. + +Võtmega email-address saab määrata aadressi, mida tdesvn-build saatmisel kasutab. Kontrolli seda, sest vaikimisi ei ole see arvatavasti sugugi selline, nagu vaja. + + + + +inst-apps +Tühistab globaalse väärtuse +See on vastupidine võtmele do-not-compile. Sellega saab määrata, et ehitatakse ainult kindlad tipptaseme kataloogid. Kataloogid tuleb eraldada tühikuga. + +Muudatused jõustuvad alles siis, kui käsk make Makefile.cvs uuesti käivitatakse - kas automaatselt skripti poolt või käsitsi võtmega või . + +Pane tähele, et programmide lähtekood laaditakse sellele vaatamata alla. Määramaks, milliseid katalooge alla laaditakse, kasuta võtit checkout-only. + + + + +install-after-build +Tühistab globaalse väärtuse +Selle võtmega saab paketi paigaldada pärast edukat ehitamist. Vaikimisi on see sisse lülitatud. Kui soovid seda keelata, määra selle võtme väärtuseks konfiguratsioonifailis 0. Samuti võib tarvitada käsurealippu . + + + +tdedir +Ei ole tühistatav +Selle võtmega määratakse kataloog, kuhu &kde; pärast ehitamist paigaldatakse. Vaikimisi on selleks ~/kde. Kui määrad siin kataloogi, mille ligipääs nõuab administraatori õigusi, tasuks tutvuda ka võtme make-install-prefix kirjeldusega. + + + +libpath +Ei ole tühistatav +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 $TDEDIR/lib ja $TQTDIR/lib lisatakse automaatselt. Võtme juures võib iga asukoha määramisel kasutada tildet (~). + + + +log-dir +Tühistab globaalse väärtuse +Selle võtmega saab muuta kataloogi, kus hoitakse skripti tekitatud logifaile. Alates skripti versioonist 0.64 saab seda määrata igale moodulile eraldi. + + + +make-install-prefix +Tühistab globaalse väärtuse +Selle võtmega saab tühikutega eraldatult määrata nimekirja, mida tõlgendatakse käsu ja selle võtmetena, mis lisatakse moodulite paigaldamiseks kasutatava käsu make install ette. See on kasulik näiteks pakettide paigaldamisel sudo'ga, kuid palun ole ettevaatlik, kui tegemist on administraatori õigustega. + + + +make-options +Tühistab globaalse väärtuse +Selle muutujaga saab edastada käsule make käsureavõtmeid. See on kasulik sellistele programmidele nagu distcc. distcc võimaldab jagada kompileerimise tulemust enam kui ühele arvutile. Selle kasutamiseks tuleb edastada käsule make võti . Vastavalt dokumentatsioonile on soovitatav lisada sellele arv kujul 2 * võrguprotsessorite_arv. Kui sul on kokku ainult üks protsessor, siis peaks see olema . + + + +manual-build +Tühistab globaalse väärtuse +Määra võtme väärtuseks true, kui soovid, et ehitamisel ei ehitataks antud moodulit. &svn;ist uuendamisel seda siiski uuendatakse. See on samaväärne käsureavõtmega . + + + +manual-update +Tühistab globaalse väärtuse +Määra võtme väärtuseks true, 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. + + + +module-base-path +Tühistab globaalse väärtuse +Selle võtmega saab tühistada &tdesvn-build;'i vaikimisi kataloogiasukoha antud moodulile. Seda saab kasutada näiteks konkreetse haru või sildi väljavõtmiseks. Õige asukoha määratlemisel on kindlasti hindamatuks abiks &kde; lähtekoodi hoidla veebis. +Pane tähele, et &tdesvn-build; loob lõpliku asukohta järgmise malli põhjal: $svn-server/home/kde/$module-base-path/$module-name. +Vaikeväärtus on sõltuvalt moodulinimest trunk või trunk/KDE. + + + + +niceness +Ei ole tühistatav +Selle võtme väärtus on arv vahemikus 20 kuni 0. Mida suurem arv, seda väiksem on prioriteet, mida &tdesvn-build; endale omistab. Vaikeväärtus on 10. + + + +no-rebuild-on-fail +Tühistab globaalse väärtuse +Määra selle võtme väärtuseks true, kui soovid vältida, et &tdesvn-build; hakkaks moodulit ümberehitama, kui inkrementehitamine ei õnnestu. Tavaliselt püüab &tdesvn-build; mooduli algusest peale ümber ehitada, et takistada &svn;i uuendamise halba mõju ehitamissüsteemile. + + + +override-url +Tühistab globaalse väärtuse +Selle võtme kasutamisel tarvitab tdesvn-build selle väärtust URL-ina, mis edastatakse Subversionile täiesti muutmatult. Üldiselt tuleks seda kasutada siis, kui soovid alla laadida konkreetset väljalaset, kuid tdesvn-build ei suuda sinu soovides võtme branch põhjal aru saada. + + + +qtdir +Ei ole tühistatav +Selle võtmega saab määrata ehitamisel kasutatava keskkonnamuutuja TQTDIR. Seda ei saa moodulivõtmega tühistada. Kui see pole määratud, kasutatakse vaikimisi asukohta $(source-dir)/build/qt-copy, mis kasutab &kde; lähtekoodihoidlas leiduvat qt-copy moodulit. Kodukataloogi tähistamiseks võib kasutada tildet (~). + + + +remove-after-install +Tühistab globaalse väärtuse +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. +Võtme võimalikud väärtused on järgmised: +none - midagi ei kustutata (vaikimisi). +builddir - kustutatakse ehitamiskataloog, aga mitte lähtekoodikataloog. +all - kustutatakse nii lähtekoodi- kui ehitamiskataloog. + + + +Pane tähele, et selle võtme kasutamine mõjutab päris negatiivselt nii sinu tekitatavat võrgukoormust (kui kasutad väärtust 'all') kui ka KDE kompileerimiseks kuluvat aega, sest tdesvn-build ei saa sel juhul kasutada inkrementehitamist. + + + + +set-env +Tühistab globaalse väärtuse +Selle võtme juures saab anda tühikuga eraldatult väärtuste nimekirja, mille esimene väärtus on määratav keskkonnamuutuja ja ülejäänud selle muutuja väärtused. Näiteks muutujale RONALD väärtuse McDonald andmine käib nii: +set-env RONALD McDonald +See võti on eriline selle poolest, et seda võib korrata ilma varasemaid set-env määratlusi konfiguratsioonifaili samas sektsioonis tühistamata. Sel moel võid moodulis (või ka globaalselt) määrata mitu keskkonnamuutujat. + + + + +source-dir +Ei ole tühistatav +Selle võtmega saab määrata kataloogi oma arvutis, kuhu salvestatakse &kde; &svn;i lähtekood. Kui see pole määratud, kasutatakse vaikeväärtusena ~/tdesvn. Väärtuse määramisel tuleks kasutada absoluutset asukohta. + + + +svn-server +Ei ole tühistatav +Selle võtmega saab määrata serveri, kust &svn; välja võetakse. Vaikimisi on see anonüümne &svn;i hoidla svn://anonsvn.kde.org/. + + + +stop-on-failure +Tühistab globaalse väärtuse +Määra selle võtme väärtuseks true, kui soovid, et skript peataks töö pärast vea tekkimist ehitamisel või paigaldamisel. Vaikimisi on see välja lülitatud. + + + +tag +Tühistab globaalse väärtuse +Selle võtmega saab alla laadida mooduli konkreetse väljalaske. +MÄRKUS: on üsna usutav, et SA EI SOOVI seda võtit kasutada. KDE väljalasked asuvad tar-failidena KDE FTP-saidil ning selle peegelsaitidel. +Kui kasutad tdesvn-build'i sellepärast, et sul on probleeme sinu distributsioonile mõeldud KDE väljalasetega, võiks kaaluda mõte pruukida ehitamistööriista Konstruct, mis kasutab väljalasete tar-faile. + + + + +use-qt-builddir-hack +Tühistab globaalse väärtuse +Kuigi see võti tühistab globaalse võtme, on sel mõtet ainult qt-copy korral. Määra võtme väärtuseks true, kui soovid lubada skriptil tarvitada eksperimentaalset srcdir != builddir režiimi. Sisselülitamise korral kopeerib &tdesvn-build; qt-copy lähtemooduli ehitamiskataloogi ja sooritab ehitamise seal. See tähendab, et keskkonnamuutuja TQTDIR väärtuseks tuleb määrata $(qt-copy-build-dir)/qt-copy/lib. Samuti tuleb vastavalt muuta võtit qtdir. Selles režiimis saab kasutada ka inkrement-make'i, sest kopeerimise järel säilitatakse ajatemplid. Kui tarvitad võtit apply-qt-patches, rakendatakse paigad ehitamis-, mitte lähtekoodikataloogis. Vaikimisi on võtme väärtuseks true. + + + +use-unsermake +Tühistab globaalse väärtuse +Määra võtme väärtuseks true, kui soovid konfigureerimisskripti käivitamisel kasutada atuomake'i asemel eksperimentaalset unsermake'i. See võib mõnikord suurendada tublisti ehitamisaega, eriti jagatud ehitamissüsteemi korral. Vaikimisi on väärtuseks enamiku moodulite korral true. + +Tavaliselt püüab tdesvn-build selle võtme kasutamisel hoida unsermake'i alati värskena. See võib muutuda tülikaks, eriti kui soovid unsermake'i ise hallata. Sel juhul anna võtmele väärtuseks self ja kuigi tdesvn-build kasutab sel juhul endiselt unsermake'i, ei üritata seda värskena hoida. + + + + + + +
+ + + + +Käsureavõtmed ja keskkonnamuutujad + +Skript ei kasuta keskkonnamuutujaid. Kui sul on vaja ehitamiseks või paigaldamiseks määrata keskkonnamuutujaid, uuri võtme set-env kirjeldust. + +Skript tunnistab järgmisi käsureavõtmeid: + + + + + +Näitab lihtsat abiinfot skripti kohta. + + + + +Näitab programmi versiooni. + + + + +Näitab autori kontaktinfot. + + + + +Lubab värvilise väljundi. + + + + +Keelab värvilise väljundi. + + + + (või ) +Tegelikult EI VÕETA midagi ette, vaid ainult teeseldakse. + + + + (või ) +Väljund on väheminformatiivsem, näidatakse ainult kõige olulisemaid teateid. + + + + +Väljund näitab ainult hoiatusi ja veateateid. + + + + +Väljund näitab põhjalikult kõike, mis toimub. + + + + +Võetakse ette ainult lähtekoodi uuendamine. + + + + +Võetakse ette ainult ehitamine. + + + + +Uuendamisse/ehitamisse ei kaasata ülejäänud käsureal antud mooduleid. + + + + +Ei looda ühendust &svn;i serveriga. + + + + +Ehitamine jäetakse vahele. + + + + +Pakette ei paigaldata pärast ehitamist automaatselt. + + + + +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. + + + + +Ei üritata algusest peale ümber ehitada mooduleid, mille ehitamine ebaõnnestus. &tdesvn-build; ei ürita seda kunagi mooduli korral, mida on juba püütud algusest peale ehitada. + + + + +Taasluuakse ehitamissüsteem ja alustatakse algusest peale. + + + + +Käivitatakse uuesti konfigureerimisskript ilma ehitamiskataloogi puhastamata. + + + + +Antakse uuesti käsk make Makefile.cvs, et luua konfigureerimisskript ja jätkata ehitamist normaalselt. See eeldab võtit . + + + + +See üritab jätkata ehitamist sealt, kus skript eelmisel korral pooleli jäi. Skript hakkab ehitama moodulit, mis järgneb moodulile, mida kompoleeriti skripti viimasel töökorral (sõltumata sellest, kas ehitamine oli edukas või mitte). See eeldab võtit . Käsureal ei tohi määrata teisi moodulinimesid. + + + + +Sarnaneb võtmega , ainult et sul tuleb anda käsureal parameetrina moodul, millest ehitamist alustada. See eeldab võtit . Käsureal ei tohi määrata teisi moodulinimesid. + + + + +Järgmist käsureal antud parameetrit tõlgendatakse failina, millest lugeda konfiguratsioonivõtmed. Vaikeväärtus on ~/.tdesvn-buildrc. + + + + +Võimaldab muuta kataloogi, kuhu &kde; paigaldatakse. See eeldab võtit . + + + + +Peatab skripti töö pärast käsu make Makefile.cvs täitmist. Konfiguratsiooniskripti paneb &tdesvn-build; tööle siis alles järgmisel käivitamisel. See võimaldab kõik konfiguratsiooniskriptid korraga ette valmistada, nii et saad vaadata igas moodulis ./configure ja muuta vastavalt konfigureerimislippe. + + + +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 esineb veel käsureavõtmeid, tõlgendatakse neid paigaldatavate moodulitena. + + + + +Selle võtmega saab kõigi mooduli jaoks tühistada konfiguratsioonifailis leiduva võtme. Kui näiteks soovid tühistada võtit log-dir, siis see käib nii: . + + + + +Selle võtmega saab iga mooduli jaoks tühistada konfiguratsioonifailis leiduva võtme. Kui näiteks soovid tühistada võtit use-unsermake moodulis tdemultimedia, siis see käib nii: . + + + + +Kõiki muid käsureavõtmeid tõlgendatakse uuendatavate ja ehitatavate moodulitena. Palun ära aja ehitamist segamini paigaldamisega. + + + + +Autorid ja litsents +&underFDL; + + diff --git a/tde-i18n-it/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt b/tde-i18n-it/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt deleted file mode 100644 index 538d423e4f8..00000000000 --- a/tde-i18n-it/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt +++ /dev/null @@ -1,6 +0,0 @@ -# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer - -tde_create_handbook( - DESTINATION tdesvn-build - LANG it -) diff --git a/tde-i18n-it/docs/tdesdk/scripts/tdesvn-build/Makefile.am b/tde-i18n-it/docs/tdesdk/scripts/tdesvn-build/Makefile.am deleted file mode 100644 index 580b2fa7b6b..00000000000 --- a/tde-i18n-it/docs/tdesdk/scripts/tdesvn-build/Makefile.am +++ /dev/null @@ -1,4 +0,0 @@ -KDE_LANG = it -SUBDIRS = $(AUTODIRS) -KDE_DOCS = tdesvn-build -KDE_MANS = AUTO diff --git a/tde-i18n-it/docs/tdesdk/scripts/tdesvn-build/index.docbook b/tde-i18n-it/docs/tdesdk/scripts/tdesvn-build/index.docbook deleted file mode 100644 index 8b1ce20aaae..00000000000 --- a/tde-i18n-it/docs/tdesdk/scripts/tdesvn-build/index.docbook +++ /dev/null @@ -1,739 +0,0 @@ - - - - - - Subversion"> - tdesvn-build"> -]> - - - - -Manuale dello script &tdesvn-build; - - -MichaelPyne
michael.pyne@kdemail.net
 - -CarlosWoelz
carloswoelz@imap-mail.com
 - - - -FedericoZenith
zenith@chemeng.ntnu.no
Traduzione della documentazione in italiano - - - - -2005 -Michael Pyne - - - -2005 -Carlos Woelz - - - -&FDLNotice; - -2005-06-18 -0.98 - - -&tdesvn-build; è uno script Perl che genera e installa &kde; direttamente dal codice sorgente del deposito &svn; di &kde;. - - - -KDE -tdesdk -SVN -Subversion -Sviluppo di KDE - - - - - - -Introduzione - -&tdesvn-build; è uno script Perl che aiuta gli utenti ad installare &kde; da &svn;. Potresti anche considerare lo script kde-build incluso con il modulo tdesdk di &kde;. - -Qui documentiamo la sintassi e le opzioni del file di configurazione di &tdesvn-build;, le sue opzioni alla riga di comando, le sue funzionalità, e una panoramica di tutti i passi necessari a generare &kde; dal codice sorgente, inclusi i passi che dovresti effettuare con altri strumenti, ovvero quelli non effettuati automaticamente dallo script &tdesvn-build;. - - - - -Per cominciare - -In questo capitolo, mostriamo come usare &tdesvn-build; per ritirare i moduli dal deposito di &kde; e generarli. Diamo anche una rapida spiegazione della struttura del deposito &svn; di &kde; e di cosa devi fare prima di eseguire lo script. - -Tutti gli argomenti qui presenti sono trattati in maggiore dettaglio nella guida a generare &kde; dai file sorgente, al sito Web della squadra di qualità di &kde;. Se stai compilando &kde; per la prima volta, è una buona idea leggerla, o almeno consultarla come riferimento. Troverai informazioni dettagliate sugli strumenti di gestione dei pacchetti e su requisiti, errori comuni di compilazione, strategie e informazioni su come far funzionare la tua nuova installazione di &kde;. - - -Preparare il sistema per la generazione di &kde; - -Si raccomanda di scaricare e generare &kde; usando un account utente. Se hai già installato i pacchetti di &kde;, la scelta migliore sarebbe creare un utente diverso (apposito) per generare ed avviare il nuovo &kde;. Il vantaggio di generare &kde; con un utente apposito è che non puoi rovinare il sistema di base, e avrai sempre il modo di continuare a lavorare tranquillamente anche se qualcosa va storto. - -In seguito, se vorrai, potrai fare un'installazione come amministratore. Questo documento non considera l'installazione come amministratore. Se stai facendo un'installazione per tutto il sistema, probabilmente sai comunque lo stesso quello che stai facendo. - -Prima di usare lo script &tdesvn-build; (o qualsiasi altra strategia di generazione) devi installare gli strumenti di sviluppo e le librerie necessarie a &kde;. Ti serve la libreria &Qt;, versione 3.3.0 o successiva, Automake 1.8, Autoconf 2.5X (meglio se successivo a 2.57, siccome è stato segnalato un errore nelle versioni precedenti), il client di Subversion (SVN), il compilatore gcc con supporto per C++, libxml2, openssl, libbz2 e molti altri (per un elenco completo, vedi i requisiti di compilazione di &kde;). Normalmente ci dovrebbero essere dei pacchetti di questi strumenti forniti dalla tua distribuzione o dal tuo fornitore. - -Alcuni di questi pacchetti sono divisi in librerie, programmi e pacchetti di sviluppo. Ti serviranno almeno il programma o la libreria, e il suo pacchetto di sviluppo. Nel dubbio, installa tutto. Le librerie di cui avrai bisogno cambieranno a seconda dei moduli che intendi generare, perché ogni modulo ha i suoi requisiti. La guida passo-passo per la generazione di &kde; dal codice sorgente ha maggiori dettagli sugli strumenti e tecniche specifici usati per installare e trovare i programmi necessari. - -Probabilmente hai già una versione dello script &tdesvn-build; installata sul tuo sistema. &tdesvn-build; ti richiede di creare un file di configurazione, chiamato .tdesvn-buildrc. Questo file dovrebbe venire installato nella cartella Home (cioè ~/), e contenere tutti i dati di configurazione necessari per l'esecuzione dello script, come le opzioni di configurazione, di compilazione, la posizione dei sorgenti, la destinazione dell'installazione (il prefisso), i moduli da costruire, eccetera. I dati di configurazione predefiniti sono forniti nel file tdesvn-buildrc-sample. Puoi trovare maggiori informazioni sulla sintassi del file di configurazione nel e nel . - -Un buon modo di prendere l'ultima versione è andare alla pagina tdesdk/scripts del sito Web websvn.kde.org. Vedrai un elenco dei file disponibili nella cartella tdesdk/scripts del deposito &svn; di &kde;. Fai clic sul collegamento a &tdesvn-build; e scarica l'ultima versione dello script. Fai lo stesso per il file tdesvn-buildrc-sample. Rendi eseguibile lo script, e assicurati che sia nel tuo percorso. - - - - -Impostare i dati della configurazione - -Per usare lo script, devi avere un file nella tua cartella Home chiamato .tdesvn-buildrc, che imposta le opzioni generali e i moduli che vuoi scaricare e generare. - -Usa il file tdesvn-buildrc-sample come modello per impostare le opzioni globali e i moduli da generare. - -Seleziona il server usato per ritirare i file da &svn; impostando l'opzione globale svn-server. Il valore predefinito è il deposito &svn; anonimo, svn://anonsvn.kde.org/, ma cambialo se hai un account &svn; di &kde;, o se hai un mirror vicino. - -Fai molta attenzione alle variabili globali tdedir e qtdir, perché la prima imposta dove sarà generato &kde; (come impostazione predefinita ~/kde), e la seconda dove (e se) sarà compilata e installata la libreria &Qt; (come impostazione predefinita ~/tdesvn/build/qt-copy). Più avanti dovrai ricordarti il valore di tdedir e qtdir, per impostare le variabili d'ambiente necessarie a far funzionare la tua installazione. Controlla se i moduli elencati sono effettivamente quelli che vuoi generare. Le opzioni predefinite del file tdesvn-buildrc-sample dovrebbero essere sufficienti per avere un'installazione di &kde; piuttosto completa. Salva il risultato come .tdesvn-buildrc nella tua cartella Home. - -Se vuoi affinare il file .tdesvn-buildrc, consulta per informazioni dettagliate su tutte le opzioni di configurazione. - - - - -Usare lo script &tdesvn-build; - -Adesso sei pronto per eseguire lo script. Da una finestra di terminale, accedi come l'utente che vuoi usare per compilare &kde; ed esegui lo script: %su nome utente -%tdesvn-build - - - -Adesso lo script dovrebbe cominciare a scaricare il codice sorgente e a compilarlo. È improbabile che funzioni tutto al primo colpo nella compilazione di &kde;. Non disperare! Controlla i file di registro per vedere se ti mancano degli strumenti o dei pacchetti di sviluppo (i file di registro sono messi dove indicato dalla variabile log-dir nel file di configurazione). A volte, il ramo di sviluppo principale diventa molto instabile e difficile da generare, specialmente quando si avvicina una scadenza di sviluppo. Abbi pazienza. Puoi trovare gli esempi più comuni di cose che possono andare storte e le loro soluzioni, oltre a diversi suggerimenti e strategie per generare &kde;, nella guida passo-passo per generare &kde; dal codice sorgente. - - - - -Impostare l'ambiente per far funzionare il tuo nuovo &kde; - -Supponendo che tu stia usando un utente apposito per generare &kde;, e che tu abbia già installato una versione di &kde;, far funzionare il nuovo &kde; potrebbe essere un po' difficile, perché il nuovo deve prendere la precedenza sul vecchio. Cambia le variabili d'ambiente per assicurarti che sia così. - -Apri o crea il file .bash_profile nella cartella Home con un qualsiasi editor di testo, e aggiungi alla fine del file: -TDEDIR=(percorso a tdedir) -TDEDIRS=$TDEDIR -PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH -LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH -export TDEDIRS PATH LD_LIBRARY_PATH - Se stai generando il modulo qt-copy, aggiungi invece: TQTDIR=(percorso a qtdir) -TDEDIR=(percorso a tdedir) -TDEDIRS=$TDEDIR -PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH -MANPATH=$TQTDIR/doc/man:$MANPATH -LD_LIBRARY_PATH=$TDEDIR/lib:$TQTDIR/lib:$LD_LIBRARY_PATH -export TQTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH - - - -Se non stai usando un utente apposito, imposta una diversa variabile $TDEHOME per il tuo nuovo ambiente nel tuo .bash_profile: export TDEHOME="${HOME}/.tde-svn" - -# Crealo se necessario -[ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn - - - - -Se in seguito il menu è vuoto o troppo affollato da applicazioni della tua distribuzione, potresti dover impostare le variabili d'ambiente XDG nel tuo .bash_profile: XDG_CONFIG_DIRS="/etc/xdg" -XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" -export XDG_CONFIG_DIRS XDG_DATA_DIRS - - - - - -Adesso che abbiamo finito, devi assicurarti che venga usato lo script di avvio starttde giusto: - -Apri il file di testo .xinitrc (o .xsession, a seconda della distribuzione) dalla cartella Home, o crealo se necessario. Aggiungi la riga: exec ${TDEDIR}/bin/starttde - - - -Adesso, avvia il tuo nuovo &kde;: nei sistemi BSD e Linux con supporto per i terminali virtuali, le combinazioni di tasti &Ctrl;&Alt;F1...F12 vengono usate per selezionare le console virtuali dalla 1 alla 12. Ciò permette di avere più di un ambiente desktop allo stesso tempo. Le prime sei sono terminali di testo, e le seguenti sono terminali grafici. - -Se quando avvii la macchina ti viene invece presentato il gestore grafico, puoi usare il nuovo ambiente &kde;, anche se non è elencato come opzione. Premi &Ctrl;&Alt;F2, e ti troverai davanti a un terminale testuale. Accedi usando l'utente apposito e scrivi: - -startx -- :1 - - - -Puoi far girare il &kde; compilato dal codice sorgente e il vecchio &kde; allo stesso tempo! Puoi tornare al tuo utente normale premendo &Ctrl;&Alt;F7 (o F6, F8... provali, uno dev'essere quello giusto). Per tornare alla versione di &kde; dal codice sorgente, premi &Ctrl;&Alt;F8 (o il tasto giusto). Adesso puoi passare da una versione di &kde; all'altra, e provare quella nuova sapendo che puoi tornare rapidamente alla sicurezza del desktop &kde; stabile. - - - - - - - - -Funzionalità dello script - -Le funzionalità di &tdesvn-build; includono: - - - - -Ritira o aggiorna automaticamente i moduli da &svn;, a seconda di cosa è appropriato. - -Prende il tempo di generazione dei moduli. - -Cerca automaticamente di rigenerare i moduli che usano il make incrementale, che tende a non riuscire dopo alcuni tipi di deposito. - -Può far ripartire uno script precedente, o avviare il processo di generazione da un modulo particolare. - -Ha già un insieme di opzioni predefinite appropriate per generare un'installazione monoutente di &kde; dal deposito anonimo di &svn;. - -Contiene supporto per Unsermake. - -Espansione della tilde per le opzioni di configurazione. Per esempio, puoi specificare: qtdir ~/tdesvn/build/qt-copy - - -Cartelle di generazione, sorgente e registro configurabili - -Configura automaticamente un sistema di generazione, con la cartella del codice sorgente diversa da quella di generazione, per mantenere pulita la cartella sorgente. L'eccezione è qt-copy, che non è progettato per essere costruito in questo modo (a meno che tu voglia provare il trucco per usare una cartella di generazione separata con Qt. - -Puoi specificare che le opzioni globali si applichino a ogni modulo da ritirare, e puoi anche specificare opzioni da applicare a singoli moduli. - -Siccome gli Autotools a volte non sono sincronizzati con le modifiche nell'albero del codice sorgente, puoi forzare la rigenerazione di un modulo creando un file .refresh-me nella cartella di generazione del modulo, o eseguendo &tdesvn-build; con l'opzione . - -Puoi specificare varie variabili d'ambiente da usare durante la generazione, incluse TDEDIR, TQTDIR, DO_NOT_COMPILE e CXXFLAGS. - -I registri dei comandi hanno data e ora, in modo da avere sempre un registro dell'esecuzione dello script. Inoltre, uno speciale collegamento simbolico chiamato latest viene creato e punta sempre al file più recente della cartella dei registri. - -Se stai usando una versione utente di &kde; invece di una di sistema (per installare la quale devi essere amministratore), puoi usare lo script per installarla al posto tuo. Non ho verificato bene il codice, e fa ampio uso della chiamata system(), quindi non raccomanderei di usarlo come amministratore per ora. - -Puoi usare make-install-prefix per prefissare la riga di comando di make install con un altro comando, cosa utile per sudo. - -Puoi usare l'opzione apidox per generare e installare automaticamente la documentazione dell'API per alcuni moduli. - -Puoi ritirare anche solo una parte di un modulo &svn; di &kde;. Per esempio, potresti ritirare solo taglib da tdesupport, o solo K3B da extragear/multimedia. Lo script includerà automaticamente kde-common quando necessario per far funzionare la generazione. - -Puoi far finta di fare le operazioni. Se passi le opzioni o sulla riga di comando, lo script darà una descrizione logorroica dei comandi che sta per eseguire, senza però eseguirli. - -Supporto per ritirare particolari rami dei moduli &svn;. Questo lavoro deve ancora essere completato, ma puoi già selezionare il ramo che vuoi generare usando l'opzione di configurazione . - - - -Cose che &tdesvn-build; non fa: - - - -Trovare il mirror &svn; di &kde;. Per ora non c'è nemmeno un elenco nello script, però il server predefinito dovrebbe funzionare senza problemi. - -Spazzolarti i denti. Quello te lo devi ricordare tu. - -Lo script probabilmente non è esente da errori. Scusa. - - - - - - -Il formato di <filename>.tdesvn-buildrc</filename> - -Per usare lo script, devi avere un file chiamato .tdesvn-buildrc nella tua cartella Home, il quale descrive i moduli che vuoi scaricare e generare. - - - -Parte con le opzioni globali, specificate come segue: - -global -nome-opzione valore-opzione -[...] -end global - - -Seguono quindi una o più sezioni per i moduli, specificate come segue: - -module nome-modulo -nome-opzione valore-opzione -[...] -end module - - -nome-modulo deve essere un modulo del deposito &svn; di &kde; (per esempio, tdelibs o tdebase). Alcune opzioni sostituiscono quelle globali, alcune si aggiungono ad esse, e alcune opzioni globali non si possono sostituire. - -Segue un elenco alfabetico delle opzioni disponibili. Fai clic sull'opzione per saperne di più. Se ne trovi una non documentata, scrivi agli autori usando l'indirizzo che trovi sopra. - - -apidox, per generare la documentazione dell'API. -apply-qt-patches, per migliorare qt-copy. -binpath, per impostare la variabile PATH. -branch, per ritirare da un ramo invece che dal tronco principale. -build-dir, per impostare la cartella in cui generare. -checkout-only, per ritirare soltanto alcune parti di un modulo. -colorful-output, per aggiungere del colore all'output dello script. -configure-flags, per definire quali flag con cui configurare un modulo. -cxxflags, per definire la variabile CXXFLAGS. -dest-dir, per cambiare il nome della cartella di un modulo. -disable-agent-check, per evitare che &tdesvn-build; controlli lo stato dell'agente ssh. -do-not-compile, per segnare le cartelle da non generare. -inst-apps, per generare e installare solo alcune cartelle. -install-after-build, per evitare di installare dopo il processo di generazione. -tdedir, per impostare la cartella in cui installare &kde;. -libpath, per impostare la variabile LD_LIBRARY_PATH. -make-install-prefix, per avviare un programma di aiuto (come sudo) durante make install. -make-options, per passare opzioni al programma make. -manual-build, per evitare di generare il modulo automaticamente. -manual-update, per evitare di fare qualsiasi cosa sul modulo in automatico. -module-base-path, per cambiare da dove scaricare il modulo (utile per rami e tag). -niceness, per cambiare la priorità nell'uso della CPU. -no-rebuild-on-fail, per evitare di far ripartire make se non riesce. -qtdir, per impostare il percorso alle librerie &Qt;. -set-env, per impostare una variabile d'ambiente. -source-dir, per cambiare da dove scaricare il codice sorgente. -stop-on-failure, per far fermare &tdesvn-build; non appena qualcosa non riesce. -svn-server, per cambiare il server da cui si scarica il codice sorgente. -use-qt-builddir-hack, per dare a &Qt; una cartella di generazione separata dal suo codice sorgente, come per &kde;. -use-unsermake, per usare il sistema di generazione avanzato unsermake. - - - -Questa è una tabella delle varie opzioni con alcuni commenti. Ogni opzione che ne sostituisca una globale sostituirà anche un'impostazione della riga di comando. - - -Tabella delle opzioni - - - - -Nome dell'opzione -Sostituibilità -Note - - - - - - -apidox -Sostituisce globale -Imposta questa opzione a (vero) per fare in modo che &tdesvn-build; generi e installi la documentazione dell'API per il modulo dopo il normale processo di generazione e installazione. Questo funziona soltanto per i moduli nei quali make apidox ha effetto, tra cui tdelibs, tdebase, koffice e altri. - - - -apply-qt-patches -Sostituisce globale -Questa opzione è utile solo per qt-copy. Se è impostata ad un valore non nullo, lo script apply-patches sarà eseguito prima della generazione, per applicare le patch non ufficiali a qt-copy. Siccome queste patch sono normalmente la ragione per cui si installa qt-copy invece di un normale &Qt;, non dovrebbe far male abilitarle. L'impostazione predefinita è abilitare le patch. - - - -binpath -Non sostituibile -Imposta questa opzione per impostare la variabile d'ambiente PATH durante la generazione. Non puoi sostituire questa impostazione nelle opzioni di un modulo. Il valore predefinito è /bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin. Questa variabile d'ambiente dovrebbe includere i percorsi, separati da due punti, dei tuoi strumenti di sviluppo. I percorsi $TDEDIR/bin e $TQTDIR/bin sono aggiunti automaticamente. Puoi usare la tilde (~) per qualsiasi percorso che aggiungi con questa opzione. - - - - -branch -Sostituisce globale -Imposta questa opzione per ritirare i file da un ramo di &kde; invece che dal tronco, che è predefinito ed è dove avviene lo sviluppo di &kde;. Per esempio, per ritirare &kde; 3.4, imposteresti questa opzione a . -Nota che alcuni moduli usano un diverso nome su alcuni rami. In particolare, il modulo &arts; richiesto non segue i numeri di versione di &kde;. La versione di &arts; corrispondente a &kde; 3.4 era la versione 1.4. -Se &tdesvn-build; non riesce a scaricare correttamente un ramo con questa opzione, potresti dover specificare manualmente l'URL da cui scaricare usando l'opzione override-url. - - - - -build-dir -Sostituisce globale -Usa questa opzione per cambiare la cartella che conterrà il codice costruito. Ci sono tre diversi modi di usarla: Relativa alla cartella sorgente della cartella del codice sorgente &svn; di &kde; (vedi l'opzione source-dir). Questo è il modo predefinito, e il modo in cui lo script ha funzionato fino alla versione 0.61. Questa modalità viene selezionata se scrivi un nome di cartella che non comincia per tilde (~) o sbarra (/).Il valore predefinito è build.Percorso assoluto. Se specifichi un percorso che comincia per /, quel percorso sarà usato direttamente. Per esempio, /tmp/kde-obj-dir/.Relativo alla tua cartella Home. Se specifichi un percorso che comincia per ~, il percorso è inteso relativo alla tua cartella Home, analogamente all'espansione della tilde in una shell. Per esempio, ~/builddir imposterebbe la cartella di generazione a /home/nome-utente/builddir. Forse ti sorprenderà, ma questa opzione è effettivamente modificabile a seconda del modulo. - - - -checkout-only -Sostituisce globale -Imposta questa opzione per ritirare il codice sorgente &svn; un pezzo alla volta. Il valore di questa opzione dovrebbe essere un elenco separato da spazi di cartelle da ritirare. Se non includi la cartella admin, essa verrà inclusa automaticamente (se necessario). Quando ritiri un pezzo alla volta, la cartella admin sarà presa da kde-common, che è dove si trova sul server &svn;. Sebbene questa opzione sostituisca l'opzione globale, tieni presente che impostare questa opzione come globale non ha senso. - - - -configure-flags -Si aggiunge alle opzioni globali (eccetto qt-copy) -Usa questa opzione per specificare quali flag passare a ./configure quando crei il sistema di generazione per il modulo. Quando usata come opzione globale, viene applicata a tutti i moduli generati da questo script. qt-copy usa un insieme molto diverso di opzioni rispetto al resto di &kde;, quindi questa opzione sostituisce le impostazioni globali quando applicata a qt-copy. - - - -colorful-output -Non sostituibile -Imposta questa opzione a (falso) per disattivare l'output colorato di &tdesvn-build;. Questa opzione ha valore predefinito (vero). Nota che &tdesvn-build; non passerà codici di colore a nient'altro che a un terminale (come xterm, &konsole;, o la normale console di Linux). - - - -cxxflags -Si aggiunge alle opzioni globali -Usa questa opzione per specificare quali flag passare a ./configure nella forma della variabile CXXFLAGS quando crei il sistema di generazione del modulo. Questa opzione viene specificata qui invece che con configure-flags perché questa opzione imposterà anche la variabile d'ambiente CXXFLAGS durante il processo di generazione. - - - -dest-dir -Sostituisce globale -Usa questa opzione per cambiare il nome che viene dato a un modulo sul disco. Per esempio, se il modulo era extragear/network, potresti rinominarlo a extragear-network usando questa opzione. - - - -disable-agent-check -Non sostituibile -Normalmente, se stai usando ssh per scaricare i sorgenti da Subversion (come nel caso in cui stessi usando il protocollo svn+ssh), &tdesvn-build; cercherà di assicurarsi che se stai usando ssh-agent, questo stia effettivamente gestendo delle identità ssh. Questo è per cercare di prevenire che ssh chieda la password per ogni modulo. Puoi disabilitare questa opzione impostando a (vero). - - - -do-not-compile -Sostituisce globale -Usa questa opzione per impostare la variabile d'ambiente DO_NOT_COMPILE prima di eseguire lo script di configurazione. Secondo le domande ricorrenti per gli sviluppatori di &kde;, ciò dovrebbe impedire la compilazione di ogni cartella di massimo livello che passi. Le cartelle dovrebbero essere separate da spazi. - -Nota che il codice sorgente dei programmi sarà comunque scaricato. Puoi usare la direttiva checkout-only per scegliere le cartelle che vuoi ritirare. - - - - -email-address -Non sostituibile - -Imposta questa opzione all'indirizzo di posta elettronica da cui &tdesvn-build; dovrebbe inviare una lettera se mai ne avesse bisogno. Non te ne devi curare se non usi nessuna funzionalità che usa la posta (come impostazione predefinita sono tutte disattivate). - -Attualmente solo email-on-compile-error ha bisogno di questa opzione. - - - - -email-on-compile-error -Non sostituibile - -Puoi impostare questa opzione all'indirizzo di posta elettronica a cui mandare un rapporto quando un modulo non può essere generato. &tdesvn-build; aspetterà fino a quando tutti i moduli saranno stati generati e metterà assieme tutti i risultati in un rapporto. Il rapporto viene inviato solo se almeno un modulo non è potuto essere generato. - -Vedi anche l'opzione email-address per impostare l'indirizzo da cui &tdesvn-build; dovrebbe inviare la lettera, perché il valore predefinito normalmente non è quello che vuoi. - - - - -inst-apps -Sostituisce globale -Questo è il contrario dell'opzione do-not-compile. Questa opzione fa in modo che solo le cartelle di massimo livello siano generate. Le cartelle devono essere separate da spazi. - -Nessun cambiamento avrà effetto fino alla prossima volta che verrà eseguito make Makefile.cvs, automaticamente dallo script o a mano con le opzioni o . - -Nota che il codice sorgente dei programmi sarà comunque scaricato. Puoi usare la direttiva checkout-only per scegliere le cartelle che vuoi ritirare. - - - - -install-after-build -Sostituisce globale -Questa opzione viene usata per installare il pacchetto a seguito di una generazione riuscita. Come impostazione predefinita, questa opzione è attiva. Se vuoi disattivarla, devi impostarla a nel file di configurazione. Puoi anche usare l'opzione dalla riga di comando. - - - -tdedir -Non sostituibile -Questa opzione imposta la cartella in cui &kde; sarà installato dopo essere stato generato. Il suo valore predefinito è ~/kde. Se la cambi a una cartella che richiede accesso come amministratore di sistema, potresti essere interessato anche all'opzione make-install-prefix. - - - -libpath -Non sostituibile -Imposta questa opzione per impostare la variabile d'ambiente LD_LIBRARY_PATH. Non puoi sostituire questa impostazione per un singolo modulo. Il valore predefinito è vuoto, ma i percorsi $TDEDIR/lib e $TQTDIR/lib vengono aggiunti automaticamente. Puoi usare la tilde (~) per qualsiasi percorso che aggiungi con questa opzione. - - - -log-dir -Sostituisce globale -Usa questa opzione per cambiare la cartella usata per contenere i file di registro generati dallo script. Questa opzione può essere impostata singolarmente per ogni modulo dalla versione 0.64 in avanti. - - - -make-install-prefix -Sostituisce globale -Imposta questa variabile a un elenco separato da spazi, che verrà interpretato come un comando con le sue opzioni con cui far precedere il comando make install usato per installare i moduli. È comodo per installare i pacchetti con per esempio sudo, ma sii cauto quando usi i privilegi di amministratore. - - - -make-options -Sostituisce globale -Imposta questa variabile per passare le opzioni della riga di comando al comando make. È utile per programmi come distcc. distcc ti permette di condividere il lavoro di compilazione tra diversi computer. Per usarlo, devi usare l'opzione di make. La documentazione raccomanda di usare 2×(numero di cpu in rete). Se hai una sola CPU, sarebbe . - - - -manual-build -Sostituisce globale -Imposta il valore dell'opzione a (vero) per impedire al processo di cercare di generare questo modulo. Sarà comunque aggiornato quando si aggiorna da &svn;. Questa opzione è esattamente equivalente all'opzione da riga di comando . - - - -manual-update -Sostituisce globale -Imposta il valore dell'opzione a (vero) per impedire che il processo di generazione cerchi di aggiornare (e di conseguenza generare o installare) questo modulo. Se imposti questa opzione per un modulo, lo stai in pratica escludendo. - - - -module-base-path -Sostituisce globale -Imposta questa opzione per sostituire il percorso alla cartella predefinita di &tdesvn-build; per il modulo. Si può usare, per esempio, per ritirare particolari rami o versioni di alcune librerie. Il visore del sorgente di &kde; è utilissimo per capire quale percorso scegliere. -Nota che &tdesvn-build; costruisce il percorso finale secondo il modello seguente: $svn-server/home/kde/$module-base-path/$module-name. -Il valore predefinito è o , a seconda del nome del modulo. - - - - -niceness -Non sostituibile -Imposta questa opzione a un numero tra 20 e 0. Maggiore è il numero, minore la priorità che &tdesvn-build; si assegnerà. Il valore predefinito è 10. - - - -no-rebuild-on-fail -Sostituisce globale -Imposta questa opzione a (vero) per impedire sempre che &tdesvn-build; cerchi di ricostruire questo modulo se una generazione incrementale non dovesse riuscire. Normalmente &tdesvn-build; cercherà di ricostruire il modulo da zero per annullare l'effetto di aggiornamenti &svn; mancanti che danneggiano il sistema di generazione. - - - -override-url -Sostituisce globale -Se imposti questa opzione, &tdesvn-build; userà il suo valore come l'URL da passare a Subversion esattamente com'è. Generalmente dovresti usarla se vuoi scaricare un rilascio particolare ma &tdesvn-build; non riesce a capire quello che vuoi fare usando branch. - - - -qtdir -Non sostituibile -Imposta questa opzione per impostare la variabile d'ambiente TQTDIR durante la generazione. Non puoi sostituire questa impostazione nelle opzioni di un modulo. Se non specifichi l'opzione, il suo valore predefinito sarà $(source-dir)/build/qt-copy, che usa il modulo qt-copy incluso nel deposito sorgente di &kde;. Puoi usare una tilde (~) per rappresentare la tua cartella Home. - - - -remove-after-install -Sostituisce globale -Se hai poco spazio su disco, potrebbe interessarti questa opzione per eliminare automaticamente la cartella di generazione (o entrambe le cartelle del codice sorgente e di generazione per le installazioni singole) dopo che sarà riuscita l'installazione del modulo. -I valori possibili di questa opzione sono: - - Non eliminare nulla (predefinito). - - Elimina la cartella di generazione, ma non il codice sorgente. - - Elimina sia la cartella del codice sorgente che quella di generazione. - - - -Nota che l'uso di questa opzione può avere un significativo impatto negativo sul tuo uso di banda (se usi ) e sul tempo necessario a compilare &kde;, perché &tdesvn-build; non potrà effettuare generazioni incrementali. - - - - -set-env -Sostituisce globale -Questa opzione accetta un insieme di valori separati da spazi, dove il primo è la variabile d'ambiente da impostare, e il resto i valori a cui vuoi impostarla. Per esempio, per impostare la variabile PINCO a pallino, inseriresti questo comando nella sezione opportuna: -set-env PINCO pallino -Questa opzione è speciale perché può essere ripetuta senza sostituire le impostazioni di precedenti nella stessa sezione del file di configurazione. In questo modo puoi impostare diverse variabili d'ambiente per modulo (o globalmente). - - - - -source-dir -Non sostituibile -Questa opzione viene usata per impostare la cartelle in cui tenere il codice sorgente &svn; di &kde; sul tuo computer. Se non specifichi questo valore, quello predefinito sarà ~/tdesvn. Se invece lo specifichi, usa un percorso assoluto. - - - -svn-server -Non sostituibile -Questa opzione viene usata per impostare il server usato per ritirare i file da &svn;. Il valore predefinito è il deposito &svn; anonimo, svn://anonsvn.kde.org/. - - - -stop-on-failure -Sostituisce globale -Imposta questa opzione a (vero) per far fermare l'esecuzione dello script a seguito del verificarsi di un errore durante il processo di generazione o installazione. Il valore predefinito di questa opzione è spento. - - - -tag -Sostituisce globale -Usa questa opzione per scaricare un rilascio specifico di un modulo. -Nota: è molto probabile che usare questa opzione non è quello che vuoi fare. I rilasci di &kde; sono disponibili come tarball dal sito FTP di &kde; o da uno dei suoi mirror. -Se stai usando &tdesvn-build; perché hai dei problemi ad ottenere un rilascio di &kde; per la tua distribuzione, considera piuttosto lo strumento di generazione Konstruct, che funziona con le tarball dei rilasci. - - - - -use-qt-builddir-hack -Sostituisce globale -Sebbene questa opzione sostituisca quella globale, ha senso solo per qt-copy. Imposta questa opzione a (vero) per abilitare la modalità sperimentale dello script, con srcdir diverso da builddir. Quando abilitata, &tdesvn-build; copierà il modulo del codice sorgente qt-copy nella cartella di generazione, ed effettuerà la generazione da lì. Ciò vuol dire che la tua variabile d'ambiente TQTDIR dovrebbe invece essere impostata a $(qt-copy-build-dir)/qt-copy/lib. Dovresti anche cambiare l'opzione qtdir corrispondentemente. La compilazione incrementale dovrebbe funzionare ancora in questa modalità, perché le date e le ore dei file saranno mantenute dopo la copia. Se usi l'opzione apply-qt-patches, le patch saranno applicate nella cartella di generazione, non in quella del codice sorgente. Questa opzione ha valore predefinito (vero). - - - -use-unsermake -Sostituisce globale -Imposta questa opzione a (vero) per usare il programma sperimentale unsermake invece di automake quando esegui lo script di configurazione. Ciò può portare a notevoli riduzioni del tempo di generazione, specialmente per i sistemi di generazione distribuiti. Questa opzione ha valore predefinito (vero). - -Normalmente, se usi questa opzione &tdesvn-build; manterrà automaticamente unsermake aggiornato. Questo potrebbe essere fastidioso, specialmente se gestisci unsermake a mano. Se questo è il caso, puoi impostare questa opzione a , e &tdesvn-build; userà ancora unsermake, ma non farà nulla di particolare per tenerlo aggiornato. - - - - - - -
- - - - -Opzioni da riga di comando e variabili d'ambiente - -Questo script non usa variabili d'ambiente. se devi impostare delle variabili d'ambiente per il processo di generazione o installazione, vedi l'opzione set-env. - -Lo script accetta le seguenti opzioni dalla riga di comando: - - - - - -mostra soltanto un semplice aiuto sull'uso di questo script. - - - - -mostra la versione del programma. - - - - -mostra informazioni per contattare l'autore. - - - - -abilita l'output colorato. - - - - -disabilita l'output colorato. - - - - (o ) -non fare nulla, fai solo finta di farlo. - - - - (o ) -non scrivere tanto output. Con questa opzione vengono scritte solo le cose fondamentali. - - - - -scrivi solo avvertimenti ed errori. - - - - -scrivi molte cose su quello che sta succedendo, e su cosa sta facendo &tdesvn-build;. - - - - -fai solo l'aggiornamento del codice sorgente. - - - - -fai solo la generazione. - - - - -non includere i moduli passati sul resto della riga di comando nel processo di aggiornamento e generazione. - - - - -salta la connessione al server &svn;. - - - - -salta il processo di generazione. - - - - -non installare automaticamente i pacchetti dopo averli generati. - - - - -abilita la modalità di debug per lo script. Attualmente ciò vuol dire che tutto l'output sarà riversato sullo standard output oltre ad essere registrato nella cartella di registro, come sarebbe normale. Inoltre, molte funzioni sono molto più verbose riguardo a quello che stanno facendo in modalità di debug. - - - - -non cercare di rigenerare da zero i moduli che non è stato possibile generare. &tdesvn-build; non cercherà mai di farlo con un modulo che si è già cercato di generare da zero. - - - - -ricrea il sistema di generazione e compila da zero. - - - - -esegui lo script di configurazione senza pulire la cartella di generazione. - - - - -esegui di nuovo make Makefile.cvs per creare lo script di configurazione, e continua a generare come normalmente. Questa opzione implica . - - - - -cerca di riprendere la generazione da dove lo script si è fermato l'ultima volta. Lo script comincia la generazione del modulo dopo l'ultimo compilato all'ultima esecuzione dello script, che sia riuscito o meno. Questa opzione implica . Non dovresti specificare altri nomi di moduli sulla riga di comando. - - - - -è come , tranne che indichi il modulo da cui cominciare a generare nel successivo parametro della riga di comando. Questa opzione implica . Non dovresti specificare altri nomi di moduli sulla riga di comando. - - - - -interpreta il prossimo parametro della riga di comando come il file da cui leggere le opzioni di configurazione. Il valore predefinito di questo parametro è ~/.tdesvn-buildrc. - - - - -permette di cambiare la cartella in cui sarà installato &kde; dalla riga di comando. Questa opzione implica . - - - - -ferma dopo aver eseguito make Makefile.cvs. Lo script di configurazione dovrà ancora essere eseguito, cosa che &tdesvn-build; farà la volta successiva. Ciò ti permette di preparare tutti gli script di configurazione in una volta, in modo da poter eseguire ./configure per ogni modulo, e modificare i tuoi flag di configurazione opportunamente. - - - -Se questa è l'unica opzione dalla riga di comando, cerca di installare tutti i moduli contenuti nella cartella successfully-built, tranne per qt-copy che non richiede installazione. Se sono specificate opzioni da riga di comando dopo , sono considerate essere i moduli da installare. - - - - -Puoi usare questa opzione per sostituire un'opzione nel tuo file di configurazione per ogni modulo. Per esempio, per sostituire l'opzione log-dir, scriveresti: . - - - - -Puoi usare questa opzione per sostituire un'opzione nel tuo file di configurazione per un modulo particolare. Per esempio, per sostituire l'opzione use-unsermake per tdemultimedia, scriveresti . - - - - -Tutte le altre opzioni da riga di comando sono considerate come moduli da aggiornare e generare. Non confondere la generazione con l'installazione. - - - - -Riconoscimenti e licenza -&underFDL; - - diff --git a/tde-i18n-it/docs/tdesdk/tdesvn-build/CMakeLists.txt b/tde-i18n-it/docs/tdesdk/tdesvn-build/CMakeLists.txt new file mode 100644 index 00000000000..538d423e4f8 --- /dev/null +++ b/tde-i18n-it/docs/tdesdk/tdesvn-build/CMakeLists.txt @@ -0,0 +1,6 @@ +# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer + +tde_create_handbook( + DESTINATION tdesvn-build + LANG it +) diff --git a/tde-i18n-it/docs/tdesdk/tdesvn-build/Makefile.am b/tde-i18n-it/docs/tdesdk/tdesvn-build/Makefile.am new file mode 100644 index 00000000000..580b2fa7b6b --- /dev/null +++ b/tde-i18n-it/docs/tdesdk/tdesvn-build/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = it +SUBDIRS = $(AUTODIRS) +KDE_DOCS = tdesvn-build +KDE_MANS = AUTO diff --git a/tde-i18n-it/docs/tdesdk/tdesvn-build/index.docbook b/tde-i18n-it/docs/tdesdk/tdesvn-build/index.docbook new file mode 100644 index 00000000000..8b1ce20aaae --- /dev/null +++ b/tde-i18n-it/docs/tdesdk/tdesvn-build/index.docbook @@ -0,0 +1,739 @@ + + + + + + Subversion"> + tdesvn-build"> +]> + + + + +Manuale dello script &tdesvn-build; + + +MichaelPyne
michael.pyne@kdemail.net
 + +CarlosWoelz
carloswoelz@imap-mail.com
 + + + +FedericoZenith
zenith@chemeng.ntnu.no
Traduzione della documentazione in italiano + + + + +2005 +Michael Pyne + + + +2005 +Carlos Woelz + + + +&FDLNotice; + +2005-06-18 +0.98 + + +&tdesvn-build; è uno script Perl che genera e installa &kde; direttamente dal codice sorgente del deposito &svn; di &kde;. + + + +KDE +tdesdk +SVN +Subversion +Sviluppo di KDE + + + + + + +Introduzione + +&tdesvn-build; è uno script Perl che aiuta gli utenti ad installare &kde; da &svn;. Potresti anche considerare lo script kde-build incluso con il modulo tdesdk di &kde;. + +Qui documentiamo la sintassi e le opzioni del file di configurazione di &tdesvn-build;, le sue opzioni alla riga di comando, le sue funzionalità, e una panoramica di tutti i passi necessari a generare &kde; dal codice sorgente, inclusi i passi che dovresti effettuare con altri strumenti, ovvero quelli non effettuati automaticamente dallo script &tdesvn-build;. + + + + +Per cominciare + +In questo capitolo, mostriamo come usare &tdesvn-build; per ritirare i moduli dal deposito di &kde; e generarli. Diamo anche una rapida spiegazione della struttura del deposito &svn; di &kde; e di cosa devi fare prima di eseguire lo script. + +Tutti gli argomenti qui presenti sono trattati in maggiore dettaglio nella guida a generare &kde; dai file sorgente, al sito Web della squadra di qualità di &kde;. Se stai compilando &kde; per la prima volta, è una buona idea leggerla, o almeno consultarla come riferimento. Troverai informazioni dettagliate sugli strumenti di gestione dei pacchetti e su requisiti, errori comuni di compilazione, strategie e informazioni su come far funzionare la tua nuova installazione di &kde;. + + +Preparare il sistema per la generazione di &kde; + +Si raccomanda di scaricare e generare &kde; usando un account utente. Se hai già installato i pacchetti di &kde;, la scelta migliore sarebbe creare un utente diverso (apposito) per generare ed avviare il nuovo &kde;. Il vantaggio di generare &kde; con un utente apposito è che non puoi rovinare il sistema di base, e avrai sempre il modo di continuare a lavorare tranquillamente anche se qualcosa va storto. + +In seguito, se vorrai, potrai fare un'installazione come amministratore. Questo documento non considera l'installazione come amministratore. Se stai facendo un'installazione per tutto il sistema, probabilmente sai comunque lo stesso quello che stai facendo. + +Prima di usare lo script &tdesvn-build; (o qualsiasi altra strategia di generazione) devi installare gli strumenti di sviluppo e le librerie necessarie a &kde;. Ti serve la libreria &Qt;, versione 3.3.0 o successiva, Automake 1.8, Autoconf 2.5X (meglio se successivo a 2.57, siccome è stato segnalato un errore nelle versioni precedenti), il client di Subversion (SVN), il compilatore gcc con supporto per C++, libxml2, openssl, libbz2 e molti altri (per un elenco completo, vedi i requisiti di compilazione di &kde;). Normalmente ci dovrebbero essere dei pacchetti di questi strumenti forniti dalla tua distribuzione o dal tuo fornitore. + +Alcuni di questi pacchetti sono divisi in librerie, programmi e pacchetti di sviluppo. Ti serviranno almeno il programma o la libreria, e il suo pacchetto di sviluppo. Nel dubbio, installa tutto. Le librerie di cui avrai bisogno cambieranno a seconda dei moduli che intendi generare, perché ogni modulo ha i suoi requisiti. La guida passo-passo per la generazione di &kde; dal codice sorgente ha maggiori dettagli sugli strumenti e tecniche specifici usati per installare e trovare i programmi necessari. + +Probabilmente hai già una versione dello script &tdesvn-build; installata sul tuo sistema. &tdesvn-build; ti richiede di creare un file di configurazione, chiamato .tdesvn-buildrc. Questo file dovrebbe venire installato nella cartella Home (cioè ~/), e contenere tutti i dati di configurazione necessari per l'esecuzione dello script, come le opzioni di configurazione, di compilazione, la posizione dei sorgenti, la destinazione dell'installazione (il prefisso), i moduli da costruire, eccetera. I dati di configurazione predefiniti sono forniti nel file tdesvn-buildrc-sample. Puoi trovare maggiori informazioni sulla sintassi del file di configurazione nel e nel . + +Un buon modo di prendere l'ultima versione è andare alla pagina tdesdk/scripts del sito Web websvn.kde.org. Vedrai un elenco dei file disponibili nella cartella tdesdk/scripts del deposito &svn; di &kde;. Fai clic sul collegamento a &tdesvn-build; e scarica l'ultima versione dello script. Fai lo stesso per il file tdesvn-buildrc-sample. Rendi eseguibile lo script, e assicurati che sia nel tuo percorso. + + + + +Impostare i dati della configurazione + +Per usare lo script, devi avere un file nella tua cartella Home chiamato .tdesvn-buildrc, che imposta le opzioni generali e i moduli che vuoi scaricare e generare. + +Usa il file tdesvn-buildrc-sample come modello per impostare le opzioni globali e i moduli da generare. + +Seleziona il server usato per ritirare i file da &svn; impostando l'opzione globale svn-server. Il valore predefinito è il deposito &svn; anonimo, svn://anonsvn.kde.org/, ma cambialo se hai un account &svn; di &kde;, o se hai un mirror vicino. + +Fai molta attenzione alle variabili globali tdedir e qtdir, perché la prima imposta dove sarà generato &kde; (come impostazione predefinita ~/kde), e la seconda dove (e se) sarà compilata e installata la libreria &Qt; (come impostazione predefinita ~/tdesvn/build/qt-copy). Più avanti dovrai ricordarti il valore di tdedir e qtdir, per impostare le variabili d'ambiente necessarie a far funzionare la tua installazione. Controlla se i moduli elencati sono effettivamente quelli che vuoi generare. Le opzioni predefinite del file tdesvn-buildrc-sample dovrebbero essere sufficienti per avere un'installazione di &kde; piuttosto completa. Salva il risultato come .tdesvn-buildrc nella tua cartella Home. + +Se vuoi affinare il file .tdesvn-buildrc, consulta per informazioni dettagliate su tutte le opzioni di configurazione. + + + + +Usare lo script &tdesvn-build; + +Adesso sei pronto per eseguire lo script. Da una finestra di terminale, accedi come l'utente che vuoi usare per compilare &kde; ed esegui lo script: %su nome utente +%tdesvn-build + + + +Adesso lo script dovrebbe cominciare a scaricare il codice sorgente e a compilarlo. È improbabile che funzioni tutto al primo colpo nella compilazione di &kde;. Non disperare! Controlla i file di registro per vedere se ti mancano degli strumenti o dei pacchetti di sviluppo (i file di registro sono messi dove indicato dalla variabile log-dir nel file di configurazione). A volte, il ramo di sviluppo principale diventa molto instabile e difficile da generare, specialmente quando si avvicina una scadenza di sviluppo. Abbi pazienza. Puoi trovare gli esempi più comuni di cose che possono andare storte e le loro soluzioni, oltre a diversi suggerimenti e strategie per generare &kde;, nella guida passo-passo per generare &kde; dal codice sorgente. + + + + +Impostare l'ambiente per far funzionare il tuo nuovo &kde; + +Supponendo che tu stia usando un utente apposito per generare &kde;, e che tu abbia già installato una versione di &kde;, far funzionare il nuovo &kde; potrebbe essere un po' difficile, perché il nuovo deve prendere la precedenza sul vecchio. Cambia le variabili d'ambiente per assicurarti che sia così. + +Apri o crea il file .bash_profile nella cartella Home con un qualsiasi editor di testo, e aggiungi alla fine del file: +TDEDIR=(percorso a tdedir) +TDEDIRS=$TDEDIR +PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH +LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH +export TDEDIRS PATH LD_LIBRARY_PATH + Se stai generando il modulo qt-copy, aggiungi invece: TQTDIR=(percorso a qtdir) +TDEDIR=(percorso a tdedir) +TDEDIRS=$TDEDIR +PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH +MANPATH=$TQTDIR/doc/man:$MANPATH +LD_LIBRARY_PATH=$TDEDIR/lib:$TQTDIR/lib:$LD_LIBRARY_PATH +export TQTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH + + + +Se non stai usando un utente apposito, imposta una diversa variabile $TDEHOME per il tuo nuovo ambiente nel tuo .bash_profile: export TDEHOME="${HOME}/.tde-svn" + +# Crealo se necessario +[ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn + + + + +Se in seguito il menu è vuoto o troppo affollato da applicazioni della tua distribuzione, potresti dover impostare le variabili d'ambiente XDG nel tuo .bash_profile: XDG_CONFIG_DIRS="/etc/xdg" +XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" +export XDG_CONFIG_DIRS XDG_DATA_DIRS + + + + + +Adesso che abbiamo finito, devi assicurarti che venga usato lo script di avvio starttde giusto: + +Apri il file di testo .xinitrc (o .xsession, a seconda della distribuzione) dalla cartella Home, o crealo se necessario. Aggiungi la riga: exec ${TDEDIR}/bin/starttde + + + +Adesso, avvia il tuo nuovo &kde;: nei sistemi BSD e Linux con supporto per i terminali virtuali, le combinazioni di tasti &Ctrl;&Alt;F1...F12 vengono usate per selezionare le console virtuali dalla 1 alla 12. Ciò permette di avere più di un ambiente desktop allo stesso tempo. Le prime sei sono terminali di testo, e le seguenti sono terminali grafici. + +Se quando avvii la macchina ti viene invece presentato il gestore grafico, puoi usare il nuovo ambiente &kde;, anche se non è elencato come opzione. Premi &Ctrl;&Alt;F2, e ti troverai davanti a un terminale testuale. Accedi usando l'utente apposito e scrivi: + +startx -- :1 + + + +Puoi far girare il &kde; compilato dal codice sorgente e il vecchio &kde; allo stesso tempo! Puoi tornare al tuo utente normale premendo &Ctrl;&Alt;F7 (o F6, F8... provali, uno dev'essere quello giusto). Per tornare alla versione di &kde; dal codice sorgente, premi &Ctrl;&Alt;F8 (o il tasto giusto). Adesso puoi passare da una versione di &kde; all'altra, e provare quella nuova sapendo che puoi tornare rapidamente alla sicurezza del desktop &kde; stabile. + + + + + + + + +Funzionalità dello script + +Le funzionalità di &tdesvn-build; includono: + + + + +Ritira o aggiorna automaticamente i moduli da &svn;, a seconda di cosa è appropriato. + +Prende il tempo di generazione dei moduli. + +Cerca automaticamente di rigenerare i moduli che usano il make incrementale, che tende a non riuscire dopo alcuni tipi di deposito. + +Può far ripartire uno script precedente, o avviare il processo di generazione da un modulo particolare. + +Ha già un insieme di opzioni predefinite appropriate per generare un'installazione monoutente di &kde; dal deposito anonimo di &svn;. + +Contiene supporto per Unsermake. + +Espansione della tilde per le opzioni di configurazione. Per esempio, puoi specificare: qtdir ~/tdesvn/build/qt-copy + + +Cartelle di generazione, sorgente e registro configurabili + +Configura automaticamente un sistema di generazione, con la cartella del codice sorgente diversa da quella di generazione, per mantenere pulita la cartella sorgente. L'eccezione è qt-copy, che non è progettato per essere costruito in questo modo (a meno che tu voglia provare il trucco per usare una cartella di generazione separata con Qt. + +Puoi specificare che le opzioni globali si applichino a ogni modulo da ritirare, e puoi anche specificare opzioni da applicare a singoli moduli. + +Siccome gli Autotools a volte non sono sincronizzati con le modifiche nell'albero del codice sorgente, puoi forzare la rigenerazione di un modulo creando un file .refresh-me nella cartella di generazione del modulo, o eseguendo &tdesvn-build; con l'opzione . + +Puoi specificare varie variabili d'ambiente da usare durante la generazione, incluse TDEDIR, TQTDIR, DO_NOT_COMPILE e CXXFLAGS. + +I registri dei comandi hanno data e ora, in modo da avere sempre un registro dell'esecuzione dello script. Inoltre, uno speciale collegamento simbolico chiamato latest viene creato e punta sempre al file più recente della cartella dei registri. + +Se stai usando una versione utente di &kde; invece di una di sistema (per installare la quale devi essere amministratore), puoi usare lo script per installarla al posto tuo. Non ho verificato bene il codice, e fa ampio uso della chiamata system(), quindi non raccomanderei di usarlo come amministratore per ora. + +Puoi usare make-install-prefix per prefissare la riga di comando di make install con un altro comando, cosa utile per sudo. + +Puoi usare l'opzione apidox per generare e installare automaticamente la documentazione dell'API per alcuni moduli. + +Puoi ritirare anche solo una parte di un modulo &svn; di &kde;. Per esempio, potresti ritirare solo taglib da tdesupport, o solo K3B da extragear/multimedia. Lo script includerà automaticamente kde-common quando necessario per far funzionare la generazione. + +Puoi far finta di fare le operazioni. Se passi le opzioni o sulla riga di comando, lo script darà una descrizione logorroica dei comandi che sta per eseguire, senza però eseguirli. + +Supporto per ritirare particolari rami dei moduli &svn;. Questo lavoro deve ancora essere completato, ma puoi già selezionare il ramo che vuoi generare usando l'opzione di configurazione . + + + +Cose che &tdesvn-build; non fa: + + + +Trovare il mirror &svn; di &kde;. Per ora non c'è nemmeno un elenco nello script, però il server predefinito dovrebbe funzionare senza problemi. + +Spazzolarti i denti. Quello te lo devi ricordare tu. + +Lo script probabilmente non è esente da errori. Scusa. + + + + + + +Il formato di <filename>.tdesvn-buildrc</filename> + +Per usare lo script, devi avere un file chiamato .tdesvn-buildrc nella tua cartella Home, il quale descrive i moduli che vuoi scaricare e generare. + + + +Parte con le opzioni globali, specificate come segue: + +global +nome-opzione valore-opzione +[...] +end global + + +Seguono quindi una o più sezioni per i moduli, specificate come segue: + +module nome-modulo +nome-opzione valore-opzione +[...] +end module + + +nome-modulo deve essere un modulo del deposito &svn; di &kde; (per esempio, tdelibs o tdebase). Alcune opzioni sostituiscono quelle globali, alcune si aggiungono ad esse, e alcune opzioni globali non si possono sostituire. + +Segue un elenco alfabetico delle opzioni disponibili. Fai clic sull'opzione per saperne di più. Se ne trovi una non documentata, scrivi agli autori usando l'indirizzo che trovi sopra. + + +apidox, per generare la documentazione dell'API. +apply-qt-patches, per migliorare qt-copy. +binpath, per impostare la variabile PATH. +branch, per ritirare da un ramo invece che dal tronco principale. +build-dir, per impostare la cartella in cui generare. +checkout-only, per ritirare soltanto alcune parti di un modulo. +colorful-output, per aggiungere del colore all'output dello script. +configure-flags, per definire quali flag con cui configurare un modulo. +cxxflags, per definire la variabile CXXFLAGS. +dest-dir, per cambiare il nome della cartella di un modulo. +disable-agent-check, per evitare che &tdesvn-build; controlli lo stato dell'agente ssh. +do-not-compile, per segnare le cartelle da non generare. +inst-apps, per generare e installare solo alcune cartelle. +install-after-build, per evitare di installare dopo il processo di generazione. +tdedir, per impostare la cartella in cui installare &kde;. +libpath, per impostare la variabile LD_LIBRARY_PATH. +make-install-prefix, per avviare un programma di aiuto (come sudo) durante make install. +make-options, per passare opzioni al programma make. +manual-build, per evitare di generare il modulo automaticamente. +manual-update, per evitare di fare qualsiasi cosa sul modulo in automatico. +module-base-path, per cambiare da dove scaricare il modulo (utile per rami e tag). +niceness, per cambiare la priorità nell'uso della CPU. +no-rebuild-on-fail, per evitare di far ripartire make se non riesce. +qtdir, per impostare il percorso alle librerie &Qt;. +set-env, per impostare una variabile d'ambiente. +source-dir, per cambiare da dove scaricare il codice sorgente. +stop-on-failure, per far fermare &tdesvn-build; non appena qualcosa non riesce. +svn-server, per cambiare il server da cui si scarica il codice sorgente. +use-qt-builddir-hack, per dare a &Qt; una cartella di generazione separata dal suo codice sorgente, come per &kde;. +use-unsermake, per usare il sistema di generazione avanzato unsermake. + + + +Questa è una tabella delle varie opzioni con alcuni commenti. Ogni opzione che ne sostituisca una globale sostituirà anche un'impostazione della riga di comando. + + +Tabella delle opzioni + + + + +Nome dell'opzione +Sostituibilità +Note + + + + + + +apidox +Sostituisce globale +Imposta questa opzione a (vero) per fare in modo che &tdesvn-build; generi e installi la documentazione dell'API per il modulo dopo il normale processo di generazione e installazione. Questo funziona soltanto per i moduli nei quali make apidox ha effetto, tra cui tdelibs, tdebase, koffice e altri. + + + +apply-qt-patches +Sostituisce globale +Questa opzione è utile solo per qt-copy. Se è impostata ad un valore non nullo, lo script apply-patches sarà eseguito prima della generazione, per applicare le patch non ufficiali a qt-copy. Siccome queste patch sono normalmente la ragione per cui si installa qt-copy invece di un normale &Qt;, non dovrebbe far male abilitarle. L'impostazione predefinita è abilitare le patch. + + + +binpath +Non sostituibile +Imposta questa opzione per impostare la variabile d'ambiente PATH durante la generazione. Non puoi sostituire questa impostazione nelle opzioni di un modulo. Il valore predefinito è /bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin. Questa variabile d'ambiente dovrebbe includere i percorsi, separati da due punti, dei tuoi strumenti di sviluppo. I percorsi $TDEDIR/bin e $TQTDIR/bin sono aggiunti automaticamente. Puoi usare la tilde (~) per qualsiasi percorso che aggiungi con questa opzione. + + + + +branch +Sostituisce globale +Imposta questa opzione per ritirare i file da un ramo di &kde; invece che dal tronco, che è predefinito ed è dove avviene lo sviluppo di &kde;. Per esempio, per ritirare &kde; 3.4, imposteresti questa opzione a . +Nota che alcuni moduli usano un diverso nome su alcuni rami. In particolare, il modulo &arts; richiesto non segue i numeri di versione di &kde;. La versione di &arts; corrispondente a &kde; 3.4 era la versione 1.4. +Se &tdesvn-build; non riesce a scaricare correttamente un ramo con questa opzione, potresti dover specificare manualmente l'URL da cui scaricare usando l'opzione override-url. + + + + +build-dir +Sostituisce globale +Usa questa opzione per cambiare la cartella che conterrà il codice costruito. Ci sono tre diversi modi di usarla: Relativa alla cartella sorgente della cartella del codice sorgente &svn; di &kde; (vedi l'opzione source-dir). Questo è il modo predefinito, e il modo in cui lo script ha funzionato fino alla versione 0.61. Questa modalità viene selezionata se scrivi un nome di cartella che non comincia per tilde (~) o sbarra (/).Il valore predefinito è build.Percorso assoluto. Se specifichi un percorso che comincia per /, quel percorso sarà usato direttamente. Per esempio, /tmp/kde-obj-dir/.Relativo alla tua cartella Home. Se specifichi un percorso che comincia per ~, il percorso è inteso relativo alla tua cartella Home, analogamente all'espansione della tilde in una shell. Per esempio, ~/builddir imposterebbe la cartella di generazione a /home/nome-utente/builddir. Forse ti sorprenderà, ma questa opzione è effettivamente modificabile a seconda del modulo. + + + +checkout-only +Sostituisce globale +Imposta questa opzione per ritirare il codice sorgente &svn; un pezzo alla volta. Il valore di questa opzione dovrebbe essere un elenco separato da spazi di cartelle da ritirare. Se non includi la cartella admin, essa verrà inclusa automaticamente (se necessario). Quando ritiri un pezzo alla volta, la cartella admin sarà presa da kde-common, che è dove si trova sul server &svn;. Sebbene questa opzione sostituisca l'opzione globale, tieni presente che impostare questa opzione come globale non ha senso. + + + +configure-flags +Si aggiunge alle opzioni globali (eccetto qt-copy) +Usa questa opzione per specificare quali flag passare a ./configure quando crei il sistema di generazione per il modulo. Quando usata come opzione globale, viene applicata a tutti i moduli generati da questo script. qt-copy usa un insieme molto diverso di opzioni rispetto al resto di &kde;, quindi questa opzione sostituisce le impostazioni globali quando applicata a qt-copy. + + + +colorful-output +Non sostituibile +Imposta questa opzione a (falso) per disattivare l'output colorato di &tdesvn-build;. Questa opzione ha valore predefinito (vero). Nota che &tdesvn-build; non passerà codici di colore a nient'altro che a un terminale (come xterm, &konsole;, o la normale console di Linux). + + + +cxxflags +Si aggiunge alle opzioni globali +Usa questa opzione per specificare quali flag passare a ./configure nella forma della variabile CXXFLAGS quando crei il sistema di generazione del modulo. Questa opzione viene specificata qui invece che con configure-flags perché questa opzione imposterà anche la variabile d'ambiente CXXFLAGS durante il processo di generazione. + + + +dest-dir +Sostituisce globale +Usa questa opzione per cambiare il nome che viene dato a un modulo sul disco. Per esempio, se il modulo era extragear/network, potresti rinominarlo a extragear-network usando questa opzione. + + + +disable-agent-check +Non sostituibile +Normalmente, se stai usando ssh per scaricare i sorgenti da Subversion (come nel caso in cui stessi usando il protocollo svn+ssh), &tdesvn-build; cercherà di assicurarsi che se stai usando ssh-agent, questo stia effettivamente gestendo delle identità ssh. Questo è per cercare di prevenire che ssh chieda la password per ogni modulo. Puoi disabilitare questa opzione impostando a (vero). + + + +do-not-compile +Sostituisce globale +Usa questa opzione per impostare la variabile d'ambiente DO_NOT_COMPILE prima di eseguire lo script di configurazione. Secondo le domande ricorrenti per gli sviluppatori di &kde;, ciò dovrebbe impedire la compilazione di ogni cartella di massimo livello che passi. Le cartelle dovrebbero essere separate da spazi. + +Nota che il codice sorgente dei programmi sarà comunque scaricato. Puoi usare la direttiva checkout-only per scegliere le cartelle che vuoi ritirare. + + + + +email-address +Non sostituibile + +Imposta questa opzione all'indirizzo di posta elettronica da cui &tdesvn-build; dovrebbe inviare una lettera se mai ne avesse bisogno. Non te ne devi curare se non usi nessuna funzionalità che usa la posta (come impostazione predefinita sono tutte disattivate). + +Attualmente solo email-on-compile-error ha bisogno di questa opzione. + + + + +email-on-compile-error +Non sostituibile + +Puoi impostare questa opzione all'indirizzo di posta elettronica a cui mandare un rapporto quando un modulo non può essere generato. &tdesvn-build; aspetterà fino a quando tutti i moduli saranno stati generati e metterà assieme tutti i risultati in un rapporto. Il rapporto viene inviato solo se almeno un modulo non è potuto essere generato. + +Vedi anche l'opzione email-address per impostare l'indirizzo da cui &tdesvn-build; dovrebbe inviare la lettera, perché il valore predefinito normalmente non è quello che vuoi. + + + + +inst-apps +Sostituisce globale +Questo è il contrario dell'opzione do-not-compile. Questa opzione fa in modo che solo le cartelle di massimo livello siano generate. Le cartelle devono essere separate da spazi. + +Nessun cambiamento avrà effetto fino alla prossima volta che verrà eseguito make Makefile.cvs, automaticamente dallo script o a mano con le opzioni o . + +Nota che il codice sorgente dei programmi sarà comunque scaricato. Puoi usare la direttiva checkout-only per scegliere le cartelle che vuoi ritirare. + + + + +install-after-build +Sostituisce globale +Questa opzione viene usata per installare il pacchetto a seguito di una generazione riuscita. Come impostazione predefinita, questa opzione è attiva. Se vuoi disattivarla, devi impostarla a nel file di configurazione. Puoi anche usare l'opzione dalla riga di comando. + + + +tdedir +Non sostituibile +Questa opzione imposta la cartella in cui &kde; sarà installato dopo essere stato generato. Il suo valore predefinito è ~/kde. Se la cambi a una cartella che richiede accesso come amministratore di sistema, potresti essere interessato anche all'opzione make-install-prefix. + + + +libpath +Non sostituibile +Imposta questa opzione per impostare la variabile d'ambiente LD_LIBRARY_PATH. Non puoi sostituire questa impostazione per un singolo modulo. Il valore predefinito è vuoto, ma i percorsi $TDEDIR/lib e $TQTDIR/lib vengono aggiunti automaticamente. Puoi usare la tilde (~) per qualsiasi percorso che aggiungi con questa opzione. + + + +log-dir +Sostituisce globale +Usa questa opzione per cambiare la cartella usata per contenere i file di registro generati dallo script. Questa opzione può essere impostata singolarmente per ogni modulo dalla versione 0.64 in avanti. + + + +make-install-prefix +Sostituisce globale +Imposta questa variabile a un elenco separato da spazi, che verrà interpretato come un comando con le sue opzioni con cui far precedere il comando make install usato per installare i moduli. È comodo per installare i pacchetti con per esempio sudo, ma sii cauto quando usi i privilegi di amministratore. + + + +make-options +Sostituisce globale +Imposta questa variabile per passare le opzioni della riga di comando al comando make. È utile per programmi come distcc. distcc ti permette di condividere il lavoro di compilazione tra diversi computer. Per usarlo, devi usare l'opzione di make. La documentazione raccomanda di usare 2×(numero di cpu in rete). Se hai una sola CPU, sarebbe . + + + +manual-build +Sostituisce globale +Imposta il valore dell'opzione a (vero) per impedire al processo di cercare di generare questo modulo. Sarà comunque aggiornato quando si aggiorna da &svn;. Questa opzione è esattamente equivalente all'opzione da riga di comando . + + + +manual-update +Sostituisce globale +Imposta il valore dell'opzione a (vero) per impedire che il processo di generazione cerchi di aggiornare (e di conseguenza generare o installare) questo modulo. Se imposti questa opzione per un modulo, lo stai in pratica escludendo. + + + +module-base-path +Sostituisce globale +Imposta questa opzione per sostituire il percorso alla cartella predefinita di &tdesvn-build; per il modulo. Si può usare, per esempio, per ritirare particolari rami o versioni di alcune librerie. Il visore del sorgente di &kde; è utilissimo per capire quale percorso scegliere. +Nota che &tdesvn-build; costruisce il percorso finale secondo il modello seguente: $svn-server/home/kde/$module-base-path/$module-name. +Il valore predefinito è o , a seconda del nome del modulo. + + + + +niceness +Non sostituibile +Imposta questa opzione a un numero tra 20 e 0. Maggiore è il numero, minore la priorità che &tdesvn-build; si assegnerà. Il valore predefinito è 10. + + + +no-rebuild-on-fail +Sostituisce globale +Imposta questa opzione a (vero) per impedire sempre che &tdesvn-build; cerchi di ricostruire questo modulo se una generazione incrementale non dovesse riuscire. Normalmente &tdesvn-build; cercherà di ricostruire il modulo da zero per annullare l'effetto di aggiornamenti &svn; mancanti che danneggiano il sistema di generazione. + + + +override-url +Sostituisce globale +Se imposti questa opzione, &tdesvn-build; userà il suo valore come l'URL da passare a Subversion esattamente com'è. Generalmente dovresti usarla se vuoi scaricare un rilascio particolare ma &tdesvn-build; non riesce a capire quello che vuoi fare usando branch. + + + +qtdir +Non sostituibile +Imposta questa opzione per impostare la variabile d'ambiente TQTDIR durante la generazione. Non puoi sostituire questa impostazione nelle opzioni di un modulo. Se non specifichi l'opzione, il suo valore predefinito sarà $(source-dir)/build/qt-copy, che usa il modulo qt-copy incluso nel deposito sorgente di &kde;. Puoi usare una tilde (~) per rappresentare la tua cartella Home. + + + +remove-after-install +Sostituisce globale +Se hai poco spazio su disco, potrebbe interessarti questa opzione per eliminare automaticamente la cartella di generazione (o entrambe le cartelle del codice sorgente e di generazione per le installazioni singole) dopo che sarà riuscita l'installazione del modulo. +I valori possibili di questa opzione sono: + - Non eliminare nulla (predefinito). + - Elimina la cartella di generazione, ma non il codice sorgente. + - Elimina sia la cartella del codice sorgente che quella di generazione. + + + +Nota che l'uso di questa opzione può avere un significativo impatto negativo sul tuo uso di banda (se usi ) e sul tempo necessario a compilare &kde;, perché &tdesvn-build; non potrà effettuare generazioni incrementali. + + + + +set-env +Sostituisce globale +Questa opzione accetta un insieme di valori separati da spazi, dove il primo è la variabile d'ambiente da impostare, e il resto i valori a cui vuoi impostarla. Per esempio, per impostare la variabile PINCO a pallino, inseriresti questo comando nella sezione opportuna: +set-env PINCO pallino +Questa opzione è speciale perché può essere ripetuta senza sostituire le impostazioni di precedenti nella stessa sezione del file di configurazione. In questo modo puoi impostare diverse variabili d'ambiente per modulo (o globalmente). + + + + +source-dir +Non sostituibile +Questa opzione viene usata per impostare la cartelle in cui tenere il codice sorgente &svn; di &kde; sul tuo computer. Se non specifichi questo valore, quello predefinito sarà ~/tdesvn. Se invece lo specifichi, usa un percorso assoluto. + + + +svn-server +Non sostituibile +Questa opzione viene usata per impostare il server usato per ritirare i file da &svn;. Il valore predefinito è il deposito &svn; anonimo, svn://anonsvn.kde.org/. + + + +stop-on-failure +Sostituisce globale +Imposta questa opzione a (vero) per far fermare l'esecuzione dello script a seguito del verificarsi di un errore durante il processo di generazione o installazione. Il valore predefinito di questa opzione è spento. + + + +tag +Sostituisce globale +Usa questa opzione per scaricare un rilascio specifico di un modulo. +Nota: è molto probabile che usare questa opzione non è quello che vuoi fare. I rilasci di &kde; sono disponibili come tarball dal sito FTP di &kde; o da uno dei suoi mirror. +Se stai usando &tdesvn-build; perché hai dei problemi ad ottenere un rilascio di &kde; per la tua distribuzione, considera piuttosto lo strumento di generazione Konstruct, che funziona con le tarball dei rilasci. + + + + +use-qt-builddir-hack +Sostituisce globale +Sebbene questa opzione sostituisca quella globale, ha senso solo per qt-copy. Imposta questa opzione a (vero) per abilitare la modalità sperimentale dello script, con srcdir diverso da builddir. Quando abilitata, &tdesvn-build; copierà il modulo del codice sorgente qt-copy nella cartella di generazione, ed effettuerà la generazione da lì. Ciò vuol dire che la tua variabile d'ambiente TQTDIR dovrebbe invece essere impostata a $(qt-copy-build-dir)/qt-copy/lib. Dovresti anche cambiare l'opzione qtdir corrispondentemente. La compilazione incrementale dovrebbe funzionare ancora in questa modalità, perché le date e le ore dei file saranno mantenute dopo la copia. Se usi l'opzione apply-qt-patches, le patch saranno applicate nella cartella di generazione, non in quella del codice sorgente. Questa opzione ha valore predefinito (vero). + + + +use-unsermake +Sostituisce globale +Imposta questa opzione a (vero) per usare il programma sperimentale unsermake invece di automake quando esegui lo script di configurazione. Ciò può portare a notevoli riduzioni del tempo di generazione, specialmente per i sistemi di generazione distribuiti. Questa opzione ha valore predefinito (vero). + +Normalmente, se usi questa opzione &tdesvn-build; manterrà automaticamente unsermake aggiornato. Questo potrebbe essere fastidioso, specialmente se gestisci unsermake a mano. Se questo è il caso, puoi impostare questa opzione a , e &tdesvn-build; userà ancora unsermake, ma non farà nulla di particolare per tenerlo aggiornato. + + + + + + +
+ + + + +Opzioni da riga di comando e variabili d'ambiente + +Questo script non usa variabili d'ambiente. se devi impostare delle variabili d'ambiente per il processo di generazione o installazione, vedi l'opzione set-env. + +Lo script accetta le seguenti opzioni dalla riga di comando: + + + + + +mostra soltanto un semplice aiuto sull'uso di questo script. + + + + +mostra la versione del programma. + + + + +mostra informazioni per contattare l'autore. + + + + +abilita l'output colorato. + + + + +disabilita l'output colorato. + + + + (o ) +non fare nulla, fai solo finta di farlo. + + + + (o ) +non scrivere tanto output. Con questa opzione vengono scritte solo le cose fondamentali. + + + + +scrivi solo avvertimenti ed errori. + + + + +scrivi molte cose su quello che sta succedendo, e su cosa sta facendo &tdesvn-build;. + + + + +fai solo l'aggiornamento del codice sorgente. + + + + +fai solo la generazione. + + + + +non includere i moduli passati sul resto della riga di comando nel processo di aggiornamento e generazione. + + + + +salta la connessione al server &svn;. + + + + +salta il processo di generazione. + + + + +non installare automaticamente i pacchetti dopo averli generati. + + + + +abilita la modalità di debug per lo script. Attualmente ciò vuol dire che tutto l'output sarà riversato sullo standard output oltre ad essere registrato nella cartella di registro, come sarebbe normale. Inoltre, molte funzioni sono molto più verbose riguardo a quello che stanno facendo in modalità di debug. + + + + +non cercare di rigenerare da zero i moduli che non è stato possibile generare. &tdesvn-build; non cercherà mai di farlo con un modulo che si è già cercato di generare da zero. + + + + +ricrea il sistema di generazione e compila da zero. + + + + +esegui lo script di configurazione senza pulire la cartella di generazione. + + + + +esegui di nuovo make Makefile.cvs per creare lo script di configurazione, e continua a generare come normalmente. Questa opzione implica . + + + + +cerca di riprendere la generazione da dove lo script si è fermato l'ultima volta. Lo script comincia la generazione del modulo dopo l'ultimo compilato all'ultima esecuzione dello script, che sia riuscito o meno. Questa opzione implica . Non dovresti specificare altri nomi di moduli sulla riga di comando. + + + + +è come , tranne che indichi il modulo da cui cominciare a generare nel successivo parametro della riga di comando. Questa opzione implica . Non dovresti specificare altri nomi di moduli sulla riga di comando. + + + + +interpreta il prossimo parametro della riga di comando come il file da cui leggere le opzioni di configurazione. Il valore predefinito di questo parametro è ~/.tdesvn-buildrc. + + + + +permette di cambiare la cartella in cui sarà installato &kde; dalla riga di comando. Questa opzione implica . + + + + +ferma dopo aver eseguito make Makefile.cvs. Lo script di configurazione dovrà ancora essere eseguito, cosa che &tdesvn-build; farà la volta successiva. Ciò ti permette di preparare tutti gli script di configurazione in una volta, in modo da poter eseguire ./configure per ogni modulo, e modificare i tuoi flag di configurazione opportunamente. + + + +Se questa è l'unica opzione dalla riga di comando, cerca di installare tutti i moduli contenuti nella cartella successfully-built, tranne per qt-copy che non richiede installazione. Se sono specificate opzioni da riga di comando dopo , sono considerate essere i moduli da installare. + + + + +Puoi usare questa opzione per sostituire un'opzione nel tuo file di configurazione per ogni modulo. Per esempio, per sostituire l'opzione log-dir, scriveresti: . + + + + +Puoi usare questa opzione per sostituire un'opzione nel tuo file di configurazione per un modulo particolare. Per esempio, per sostituire l'opzione use-unsermake per tdemultimedia, scriveresti . + + + + +Tutte le altre opzioni da riga di comando sono considerate come moduli da aggiornare e generare. Non confondere la generazione con l'installazione. + + + + +Riconoscimenti e licenza +&underFDL; + + diff --git a/tde-i18n-pt/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt b/tde-i18n-pt/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt deleted file mode 100644 index 63f6da47f4a..00000000000 --- a/tde-i18n-pt/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt +++ /dev/null @@ -1,6 +0,0 @@ -# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer - -tde_create_handbook( - DESTINATION tdesvn-build - LANG pt -) diff --git a/tde-i18n-pt/docs/tdesdk/scripts/tdesvn-build/Makefile.am b/tde-i18n-pt/docs/tdesdk/scripts/tdesvn-build/Makefile.am deleted file mode 100644 index 70bf689f3a2..00000000000 --- a/tde-i18n-pt/docs/tdesdk/scripts/tdesvn-build/Makefile.am +++ /dev/null @@ -1,4 +0,0 @@ -KDE_LANG = pt -SUBDIRS = $(AUTODIRS) -KDE_DOCS = tdesvn-build -KDE_MANS = AUTO diff --git a/tde-i18n-pt/docs/tdesdk/scripts/tdesvn-build/index.docbook b/tde-i18n-pt/docs/tdesdk/scripts/tdesvn-build/index.docbook deleted file mode 100644 index a371d6302c3..00000000000 --- a/tde-i18n-pt/docs/tdesdk/scripts/tdesvn-build/index.docbook +++ /dev/null @@ -1,739 +0,0 @@ - - - - - - Subversion"> - tdesvn-build"> -]> - - - - -Manual do 'Script' &tdesvn-build; - - -MichaelPyne
michael.pyne@kdemail.net
 - -CarlosWoelz
carloswoelz@imap-mail.com
 - - - -JoséPires
jncp@netcabo.pt
Tradução - - - - -2005 -Michael Pyne - - - -2005 -Carlos Woelz - - - -&FDLNotice; - -2005-06-18 -0.98 - - -O &tdesvn-build; é um programa em Perl que compila e instala o &kde; directamente a partir do código existente no repositório de &svn; do &kde;. - - - -KDE -tdesdk -SVN -Subversion -Desenvolvimento KDE - - - - - - -Introdução - -O &tdesvn-build; é um programa em Perl que ajuda os utilizadores a instalar o &kde; a partir do &svn;. Poderá também querer considerar o programa 'kde-build' que vem incluído no módulo 'tdesdk' do &kde;. - -Aqui será documentado a sintaxe opções do ficheiro de configuração do &tdesvn-build;, as suas opções da linha de comandos, as funcionalidades e uma introdução a todos os passos necessários para compilar o &kde; a partir do código, incluindo os passos que deverá efectuar ao usar as outras ferramentas ou, por outras palavras, os passos que não são efectuados automaticamente pelo programa &tdesvn-build;. - - - - -Começar - -Neste capítulo, será apresentada a forma de utilização do &tdesvn-build; para obter os módulos do repositório do &kde; e os compilar. Será dada também uma explicação básica da estrutura de &svn; do &kde; e os passos que terá de efectuar antes de executar o programa. - -Todos os tópicos presentes neste capítulo são cobertos com ainda mais detalhe na secção Guia de Compilação do Código do &kde; Passo-a-Passo, na Página Web da Equipa de Qualidade do &kde;. Se estiver a compilar o KDE pela primeira vez, é uma boa ideia lê-lo ou consultá-lo como fonte de referência. Irá encontrar informações detalhada sobre as ferramentas de empacotamento e os requisitos, os problemas de compilação comuns e as estratégias e informações sobre a execução da instalação do seu novo &kde;. - - -Preparar o Sistema para Compilar o &kde; - -Recomenda-se que transfira e compile o &kde; com uma conta de utilizador. Se já tiver os pacotes do &kde; instalados, a melhor opção será criar um utilizador diferente (dedicado) para compilar e executar o novo &kde;. A vantagem de compilar o &kde; com um utilizador dedicado é que não poderá corromper o sistema de base e terá sempre uma forma de trabalhar confortavelmente quando as coisas correrem mal. - -Mais tarde, poderá fazer uma instalação como 'root' se o desejar. Este documento não cobre uma instalação como 'root'. Se estiver a efectuar uma instalação a nível do sistema, provavelmente já deverá saber o que está a fazer. - -Antes de usar o programa &tdesvn-build; (ou qualquer outra estratégia de compilação), deverá instalar as ferramentas de desenvolvimento e bibliotecas necessárias para o &kde;. Necessita da biblioteca Qt, versão 3.3.0 ou posterior, do Automake 1.8, Autoconf 2.5X (melhor se >=2.57, dado que foi detectado um erro com as versões anteriores), o cliente do 'subversion' (svn), o compilador 'gcc' com o suporte de C++, a libxml2, o openssl, a libbz2 entre outras coisas (para uma lista completa, visite os Requisitos de Compilação do KDE). Poderá obter normalmente estas ferramentas para o seu sistema, a partir da sua distribuição ou fornecedor. - -Alguns destes pacotes estão divididos em bibliotecas, programas ou utilitários e pacotes de desenvolvimento. Irá necessitar, pelo menos do programa ou biblioteca e do seu pacote de desenvolvimento. Se tiver dúvidas, instale tudo. As bibliotecas que necessita irão variar de acordo com os módulos que pretende compilar, dado que cada módulo tem os seus próprio requisitos. O Guia de Compilação do Código do &kde; Passo-a-Passo tem mais detalhes sobre as ferramentas e técnicas específicas usadas para instalar e encontrar o 'software' necessário. - -Poderá já ter uma versão do programa &tdesvn-build; instalada no seu sistema. O &tdesvn-build; obriga a que você crie um ficheiro de configuração chamado .tdesvn-buildrc. Este ficheiro deverá ser instalado na pasta pessoal (~/), e contém todos os dados de configuração necessários para o programa correr, como as opções de configuração, compilação, a localização do código, o destino da instalação (prefixo), os módulos que serão compilados, &etc;. Os dados de configuração por omissão são oferecidos pelo ficheiro tdesvn-buildrc-sample. Poderá encontrar mais informações sobre a sintaxe do ficheiro de configuração em e . - -Uma boa forma de obter a última versão é escolher a página 'tdesdk/scripts' da página Web do websvn.kde.org. Irá ver uma lista dos ficheiros disponíveis na pasta 'tdesdk/scripts' do repositório de &svn; do &kde;. Carregue na ligação do &tdesvn-build; e transfira a última versão do programa. Faça o mesmo para o ficheiro tdesvn-buildrc-sample. Torne o programa executável e verifique se está na sua PATH. - - - - -Definir os Dados de Configuração - -Para usar o programa, deverá ter um ficheiro na sua pasta pessoal chamado .tdesvn-buildrc, que define as opções gerais e os módulos que deseja transferir e compilar. - -Use o ficheiro tdesvn-buildrc-sample como modelo, defina as opções globais e os módulos que deseja compilar. - -Seleccione o servidor de onde deseja obter o &svn;, definindo a opção global 'svn-server'. O valor por omissão é o servidor &svn; anónimo, o svn://anonsvn.kde.org/, mas está à vontade para alterá-lo se tiver uma conta de &svn; do &kde; ou, se existir, uma réplica perto de si. - -Preste bastante atenção às variáveis globais 'tdedir' e 'qtdir', dado que a primeira define onde o seu &kde; irá ser instalado (por omissão em ~/kde), e o segundo diz onde (e se) a sua biblioteca Qt irá ser compilada e instalada, (por omissão em ~/tdesvn/build/qt-copy). Terá de saber mais tarde a localização da 'tdedir' e da 'qtdir', para configurar as variáveis de ambiente que são necessárias para executar a sua instalação nova. Verifique se os módulos indicados são, de facto, os módulos que pretende compilar. As opções por omissão do ficheiro tdesvn-buildrc-sample deverão ser suficientes para obter uma instalação relativamente completa do &kde;. Grave o resultado como .tdesvn-buildrc na sua pasta pessoal. - -Se desejar afinar o seu ficheiro .tdesvn-buildrc, consulte o para obter informação mais detalhada sobre todas as opções de configuração. - - - - -Usar o 'script' &tdesvn-build; - -Agora está pronto para executar o programa. A partir de uma janela de termina, autentique-se com o utilizador que usa para compilar o &kde; e execute o programa: %su utilizador -%tdesvn-build - - - -Agora, o programa deverá começar a ir obter o código-fonte e a compilá-lo. É pouco provável que corra tudo bem da primeira vez que compilar o &kde;. Não desespere! Verifique os ficheiros de registo para ver se faltam algumas ferramentas ou pacotes de desenvolvimento (a localização dos ficheiros de registo é definida pela variável 'log-dir' no ficheiro de configuração). Algumas vezes, a ramificação de desenvolvimento principal fica muito instável e difícil de compilar, principalmente quando está próximo um congelamento do desenvolvimento. Tenha paciência. Poderá descobrir mais exemplos comuns das coisas que poderão correr mal e as suas soluções, assim como dicas e estratégias gerais para compilar o &kde; no Guia de Compilação do Código do &kde; Passo-a-Passo. - - - - -Configurar o Ambiente para Executar o seu &kde; Novo - -Assumindo que está a usar um utilizador dedicado para compilar o &kde; e já tem uma versão do &kde; instalada, a execução do seu &kde; novo poderá ter os seus truques, dado que o &kde; novo terá de ter precedência sobre o antigo. Mude as variáveis de ambiente para garantir que isso acontece. - -Abra ou crie o ficheiro .bash_profile na sua pasta pessoal com o seu editor favorito e adicione o seguinte ao fim do ficheiro: -TDEDIR=(local do tdedir) -TDEDIRS=$TDEDIR -PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH -LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH -export TDEDIRS PATH LD_LIBRARY_PATH - Se estiver a compilar o módulo 'qt-copy', adicione em alternativa: TQTDIR=(local do qtdir) -TDEDIR=(local do tdedir) -TDEDIRS=$TDEDIR -PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH -MANPATH=$TQTDIR/doc/man:$MANPATH -LD_LIBRARY_PATH=$TDEDIR/lib:$TQTDIR/lib:$LD_LIBRARY_PATH -export TQTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH - - - -Se não estiver a usar um utilizador dedicado, defina um novo $TDEHOME para o seu novo ambiente no seu ficheiro .bash_profile: export TDEHOME="${HOME}/.tde-svn" - -# Criar a pasta se necessário -[ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn - - - - -Se, mais tarde, o seu menu estiver vazio ou completamente cheio de aplicações da sua distribuição, poderá ter de definir o as suas variáveis de ambiente do 'xdg' no seu .bash_profile: XDG_CONFIG_DIRS="/etc/xdg" -XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" -export XDG_CONFIG_DIRS XDG_DATA_DIRS - - - - - -Agora que terminou o que tinha para fazer, certifique-se que será usado o starttde correcto: - -Abra o ficheiro de texto .xinitrc (ou o .xsession, dependendo da distribuição) da pasta pessoal, ou crie-o se necessário. Adicione a linha: exec ${TDEDIR}/bin/starttde - - - -Agora inicie o seu &kde; novo: nos sistemas BSD e Linux, com o suporte para terminais virtuais, os atalhos Ctrl+Alt+F1...F12 são usados para mudar para a Consola Virtual 1 a 12. Isto permite-lhe executar mais que um ambiente gráfico ao mesmo tmpo. Os primeiros seis são terminais de texto e os seis seguintes são gráficos. - -Quando você arranca, é-lhe apresentado o gestor gráfico, em alternativa. Poderá usar o novo ambiente do KDE, mesmo que não apareça como opção. Carregue em Ctrl + Alt + F2, para que lhe apareça um terminal de texto. Autentique-se com o utilizador dedicado e escreva: - -startx -- :1 - - - -Poderá executar o KDE a partir do código e o KDE antigo ao mesmo tempo! Autentique-se com o seu utilizador normal e inicie o ambiente do KDE estável. Carregue em Ctrl + Alt + F2 (ou F1, F3, etc..), para que lhe apareça um terminal de texto. Ligue-se com o utilizador dedicado e escreva "startx -- :1". Poderá voltar ao utilizador normal, carregando em Ctrl + Alt + F6 (Ou F7, F8, etc... Experimente! Um deles é o correcto.) Para voltar ao KDE a partir do código, carregue em Ctrl + Alt + F7 (ou F6, F8,etc..). Agora poderá mudar entre as suas versões do KDE e teste a nova, sabendo que poderá voltar rapidamente à segurança do ambiente estável do KDE. - - - - - - - - -Funcionalidades do Programa - -As funcionalidades do &tdesvn-build; incluem: - - - - -Obtém ou actualiza automaticamente os módulos do &svn;, à medida das necessidades. - -Agenda o processo de compilação dos módulos. - -Tenta automaticamente compilar de novo os módulos que foram compilados com o 'make' incremental, que está sujeito a erros ao fim de algumas modificações. - -Poderá retomar uma execução anterior ou iniciar o processo de compilação de um determinado módulo. - -Vem incorporado com um conjunto seguro de opções predefinidas, apropriadas para compilar uma instalação mono-utilizador de base do &kde; a partir do repositório de &svn; anónimo. - -Vem com suporte para o Unsermake. - -Expansão do til (~) para as suas opções de configuração. Por exemplo, poderá indicar: qtdir ~/tdesvn/build/qt-copy - - -Pastas configuráveis para compilação, para o código-fonte e para registos. - -Configura automaticamente um sistema de compilação com uma pasta de compilação diferente da pasta de código, para manter impecável a pasta de código. A única excepção é o qt-copy, que não está desenhado para ser compilado dessa forma (a menos que queira testar o truque do Qt com uma pasta de compilação separada). - -Poderá indicar as opções globais a aplicar a todos os módulos a obter, assim como poderá indicar opções para se aplicar aos módulos individuais. - -Dado que as ferramentas 'auto*' normalmente perdem a sincronização com as modificações na árvore de código, poderá forçar uma nova compilação de um módulo, se criar um ficheiro chamado '.refresh-me' na pasta de compilação do módulo em questão ou executando o &tdesvn-build; com a opção . - -Poderá indicar vários valores de ambiente a usar durante a compilação, incluindo o TDEDIR, o TQTDIR, o DO_NOT_COMPILE e o CXXFLAGS. - -Registo dos comandos. Os ficheiros de registo são datados e numerados, para que tenha sempre um relatório de execução de um programa. Do mesmo modo, é criada uma ligação simbólica 'latest' para apontar sempre para o item de registo mais recente na pasta respectiva. - -Se estiver a usar uma compilação de utilizador do &kde;, em vez de uma instalação do sistema (para a qual necessita de ser o 'root' para instalar), poderá usar o programa para o instalar por si. Não foi ainda validado o código e este faz uma utilização ampla da chamada system(), como tal, não é recomendado executá-lo como 'root' nesta altura. - -Poderá usar o make-install-prefix para anteceder o comando 'make install' com um comando separado, o que poderá ser útil para o 'sudo'. - -Poderá usar a opção apidox para compilar e instalar automaticamente a documentação da API para alguns módulos. - -Poderá obter apenas uma parte de um módulo do &kde; no &svn;. Por exemplo, poderá obter apenas a biblioteca taglib do tdesupport ou apenas o K3B do extragear/multimedia. O programa irá obter automaticamente o kde-common, se for necessário para fazer a compilação funcionar. - -Poderá fingir efectuar as operações. Se passar a opção ou na linha de comandos, o programa dar-lhe-á uma descrição mais extensiva dos comandos que estará prestes a executar, sem os executar de facto. - -Suporte para obter ramificações ('branches') específicas dos módulos do &svn;. Este trabalho ainda necessita de ser terminado, mas já poderá seleccionar a ramificação que pretende compilar com a opção de configuração 'module-base-path'. - - - -As coisas que o &tdesvn-build; NÃO faz: - - - -Descobrir a réplica do &svn; do &kde; mais rápida. Não existe sequer uma lista a acompanhar o programa nesta altura, ainda que o servidor por omissão deva funcionar perfeitamente. - -Lavar-lhe os dentes. Isso deverá partir de si à mesma. - -O programa, provavelmente, não está livre de erros. Desculpe por isso. - - - - - - -O Formato do '.tdesvn-buildrc' - -Para usar o programa, deverá ter um ficheiro na sua pasta pessoal .tdesvn-buildrc, que descreve os módulos que deseja obter e compilar. - - - -Ele começa com as opções globais, indicadas da seguinte forma: - -global -nome-opção valor-opção -[...] -end global - - -Segue-se então uma ou mais secções dos módulos, organizadas da seguinte forma: - -module nome-módulo -nome-opção valor-opção -[...] -end module - - -O nome-módulo deverá ser um módulo do repositório de &svn; do &kde; (por exemplo, o 'tdelibs' ou o 'tdebase'). Algumas das opções sobrepõem-se às globais, algumas adicionam-se às opções globais e algumas opções globais simplesmente não podem ser sobrepostas. - -Segue-se uma lista ordenada alfabeticamente das opções que poderá usar. Carregue na opção para descobrir mais sobre ela. Se alguma não estiver documentada, envie por favor um e-mail aos autores, usando o endereço que poderá encontrar acima. - - -apidox, para compilar a Documentação da API -apply-qt-patches, para melhorar o 'qt-copy' -binpath, para definir a variável PATH. -branch, para obter uma dada ramificação, em vez da '/trunk'. -build-dir, para definir a pasta onde será feita a compilação. -checkout-only, para transferir apenas as partes de um módulo. -colorful-output para colorir o resultado do programa. -configure-flags para definir as opções com que um módulo poderá ser configurado. -cxxflags para definir a variável CXXFLAGS. -dest-dir para mudar a pasta de instalação de um módulo. -disable-agent-check, para impedir que o 'tdesvn-build' verifique o estado do 'ssh-agent'. -do-not-compile, para marcar as pastas que não serão compiladas. -inst-apps, para só compilar e instalar algumas pastas. -install-after-build, para evitar a instalação após o processo de compilação. -tdedir, para indicar a pasta onde o KDE será instalado. -libpath, para configurar a variável LD_LIBRARY_PATH. -make-install-prefix, para executar um programa auxiliar (como o 'sudo') durante o 'make install'. -make-options, para passar opções ao programa 'make'. -manual-build, para evitar que o módulo seja compilado automaticamente. -manual-update, para evitar que seja feito, seja o que for, ao módulo de forma automática. -module-base-path, para mudar o local onde transferir o módulo (útil para as ramificações - 'branches' -, e marcas - 'tags'). -niceness, para mudar a prioridade do CPU. -no-rebuild-on-fail, para evitar executar o 'make' de novo se falhar. -qtdir, para definir a localização do Qt. -set-env, para configurar uma variável de ambiente. -source-dir, para mudar o local onde colocar o código transferido. -stop-on-failure, para fazem com que o 'tdesvn-build' pare o mais cedo possível, após encontrar um problema. -svn-server, para mudar o servidor de onde é transferido o código. -use-qt-builddir-hack, para dar ao Qt uma pasta de compilação diferente da do seu código, como acontece no KDE. -use-unsermake, para usar o sistema de compilação avançado, o 'unsermake'. - - - -Aqui está uma tabela com as opções globais, bem como alguns comentários sobre elas. As opções que se sobreporem às globais irão também sobrepor-se a uma configuração da linha de comandos. - - -Tabela de Opções - - - - -Nome da Opção -Comportamento do Módulo -> Global -Notas - - - - - - -apidox -Sobrepõe-se à global -Configure esta opção como true, para que o &tdesvn-build; compile e instale automaticamente a documentação da API do módulo, após o processo de compilação/instalação normal. Isto só funciona para os módulos em que o make apidox faz alguma coisa, e que incluem o 'tdelibs', 'tdebase' e o 'koffice', entre outros. - - - -apply-qt-patches -Sobrepõe-se à global -Esta opção só é útil para o 'qt-copy'. Se for um valor diferente de zero, então o programa 'apply-patches' do 'qt-copy' será executado antes da compilação, para aplicar as alterações não oficiais no 'qt-copy'. Dado que estas alterações são normalmente a razão para usar o 'qt-copy', em vez de um Qt oficial, não deverá haver qualquer problema em activá-las. Por omissão, está activada a aplicação destas modificações. - - - -binpath -Não poderá ser sobreposta -Active esta opção para modificar a variável de ambiente PATH durante a compilação. Não poderá sobrepor esta opção numa opção do módulo. O valor por omissão é o /bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin. Esta variável de ambiente deverá incluir os locais, separados por dois-pontos das suas ferramentas de desenvolvimento. Os locais $TDEDIR/bin e $TQTDIR/bin são adicionados automaticamente. Poderá usar o til (~) para os locais que adicionar com esta opção. - - - - -branch -Sobrepõe-se à global -Altere esta opção para obter uma ramificação do KDE, em vez do valor por omissão "trunk", onde o desenvolvimento do KDE está em curso. Por exemplo, para obter a ramificação do KDE 3.4, deverá configurar esta opção como "3.4". -Lembre-se que alguns módulos usam um nome de ramificação diferente. Em concreto, o módulo obrigatório 'arts' não segue os números de versões do KDE. O 'arts' que acompanhava o KDE 3.4 era o 1.4. -Se o 'tdesvn-build' não conseguir obter adequadamente uma ramificação com esta opção, poderá ter de indicar manualmente o URL de onde transferir, com a opção override-url. - - - - -build-dir -Sobrepõe-se à global -Use esta opção para mudar a pasta que contém o código compilado. Existem três formas diferentes de o usar: Relativa à pasta de código do &kde; no &svn; (ver a opção 'source-dir'). Esta é a opção predefinida e a forma como funcionou o programa até à versão v0.61. Este modo fica seleccionado se escrever o nome de uma pasta que não comece por um til (~) ou uma barra (/). O valor por omissão é build. Um local absoluto. Se indicar um local que comece por um /, então será usado esse local directamente. Por exemplo, o /tmp/kde-obj-dir/. Relativo à sua pasta pessoal. Se indicar uma pasta que comece com um '~', então o local será usado em relação à sua pasta pessoal, de forma semelhante à expansão do til da linha de comandos. Por exemplo, o ~/builddir irá configurar a pasta de compilação como /home/utilizador/builddir. Talvez de forma surpreendente, esta opção poderá alterada por módulo. - - - -checkout-only -Sobrepõe-se à global -Altere esta opção para obter o código do &svn; passo-a-passo. O valor desta opção deverá ser uma lista separada por espaços das pastas a transferir. Se não incluir a pasta 'admin', será incluída automaticamente (se necessário). Ao transferir passo-a-passo, a pasta 'admin' será obtida do 'kde-common', que é onde se encontra no servidor do &svn;. Ainda que esta opção se sobreponha à global, tenha em atenção que esta opção, como global, não faz sentido. - - - -configure-flags -Adiciona às opções globais (excepto no 'qt-copy') -Use esta opção para indicar quais as opções a passar ao './configure' quando criar o sistema de compilação do módulo. Quando isto é usado como uma opção global, é aplicada a todos os módulos onde este programa se compila. O 'qt-copy' usa um conjunto muito diferente de opções do 'configure' do resto do &kde;, como tal esta opção sobrepõe as opções globais, quando é aplicada ao 'qt-copy'. - - - -colorful-output -Não poderá ser sobreposta -Configure esta opção como 'false' para desactivar o resultado colorido do &tdesvn-build;. Por omissão é true. Lembre-se que o &tdesvn-build; não irá mostrar os códigos de cores em nada que não seja um terminal (como o 'xterm', o &konsole; ou a consola normal do Linux). - - - -cxxflags -Adiciona-se à opção global -Use esta opção para indicar as opções a passar ao ./configure como CXXFLAGS, ao criar o sistema de compilação do módulo. Esta opção é indicada aqui em vez do configure-flags, dado que esta opção irá também definir a variável de ambiente CXXFLAGS durante o processo de compilação. - - - -dest-dir -Sobrepõe-se à global -Use esta opção para mudar o nome que é dado a um módulo no disco. Por exemplo, se o seu módulo se chamava 'extragear/network', poderá mudar o nome do mesmo para 'extragear-network' com esta opção. - - - -disable-agent-check -Não poderá ser sobreposta -Normalmente, se estiver a usar o SSH para obter o código do Subversion (se, por exemplo, estiver a usar o protocolo 'svn+ssh'), o 'tdesvn-build' irá tentar certificar-se que, se estiver a usar o 'ssh-agent', ele está de facto a gerir algumas identidades do SSH. Isto é para tentar e evitar que o SSH pergunte a sua frase-senha para todos os módulos. Poderá desactivar esta opção se activar a opção 'disable-agent-check' como 'true'. - - - -do-not-compile -Sobrepõe-se à global -Use esta opção para definir a variável de ambiente DO_NOT_COMPILE antes de executar o programa 'configure'. De acordo com a FAQ de Desenvolvimento do &kde;, este deverá ser o caso de uma pasta de topo que não deseje compilar. As pastas deverão estar separadas por espaços. - -Lembre-se que o código dos programas será à mesma transferido. Poderá usar a instrução checkout-only para escolher as pastas que deseja obter. - - - - -email-address -Não poderá ser sobreposta - -Configure esta opção com o endereço de e-mail que o 'tdesvn-build' deverá enviar, no caso de alguma vez necessitar de enviar mensagens. Não terá de se preocupar com isto se não usar qualquer funcionalidade que envie e-mails. (Elas estão todas desactivadas por omissão). - -De momento, só o email-on-compile-error é que necessita desta opção. - - - - -email-on-compile-error -Não poderá ser sobreposta - -Poderá configurar esta opção com o endereço de e-mail para onde enviar um relatório, sempre que um módulo não conseguir ser compilado. O 'tdesvn-build' irá esperar até que todos os módulos terminem e irá recolher todos os resultados no relatório. Este só é enviado se um módulo se recusar a compilar. - -Por favor, veja a opção email-address para configurar o endereço de onde o 'tdesvn-build' irá enviar, dado que o valor por omissão não é normalmente o que pretende. - - - - -inst-apps -Sobrepõe-se à global -Esta é o oposto da opção do-not-compile. Serve para indicar que apenas as pastas de topo referidas serão compiladas. As pastas deverão estar separadas por espaços. - -As alterações não farão efeito até à próxima vez que o make Makefile.cvs seja executado, quer automaticamente pelo programa, quer manualmente pelas opções ou . - -Lembre-se que o código dos programas será à mesma transferido. Poderá usar a instrução checkout-only para escolher as pastas que deseja obter. - - - - -install-after-build -Sobrepõe-se à global -Esta opção é usada para instalar o pacote depois de este ser compilado com sucesso. Esta opção está activa por omissão. Se quiser desactivá-la, terá de configurar esta opção como 0 no ficheiro de configuração. Poderá também usar a opção da linha de comandos . - - - -tdedir -Não poderá ser sobreposta -Esta opção define a pasta em que o &kde; será instalado após a compilação. Por omissão, será em ~/kde. Se mudar isto para uma pasta que necessite do acesso do 'root', poderá ter de ler acerca da opção make-install-prefix também. - - - -libpath -Não poderá ser sobreposta -Configure esta opção para definir a variável de ambiente LD_LIBRARY_PATH, enquanto efectua a compilação. Não poderá sobrepor esta opção num módulo. O valor por omissão está em branco, mas os locais $TDEDIR/lib e $TQTDIR/lib são adicionados automaticamente. Poderá usar o til (~) para os locais que adicionar com esta opção. - - - -log-dir -Sobrepõe-se à global -Use esta opção para mudar a pasta que irá conter os ficheiros de registo gerados pelo programa. Esta opção poderá ser definida por cada módulo, desde a versão 0.64 e posteriores. - - - -make-install-prefix -Sobrepõe-se à global -Configure esta variável com uma lista separada por espaços, que será interpretada como um comando e as suas opções, para anteceder o comando 'make install', que é usado para instalar os módulos. Isto é útil para instalar os pacotes com o 'sudo', por exemplo, mas tenha cuidado enquanto lida com os privilégios do 'root'. - - - -make-options -Sobrepõe-se à global -Configure esta variável para passar as opções da linha de comandos ao comando 'make'. Isto é útil para os programas, como o distcc. O distcc permite-lhe partilhar o seu trabalho de compilação por mais que um computador. Para a usar, deverá usar a opção do 'make'. Agora já pode. De acordo com a documentação, recomenda-se '2 * número_de_cpus_na_rede'. Existe 1 CPU no caso do autor, como tal seria no caso dele. - - - -manual-build -Sobrepõe-se à global -Configure o valor da opção como true para evitar que o processo de compilação tente compilar este módulo. Será à mesma mantido actualizado ao actualizar a partir do &svn;. Esta opção é exactamente equivalente à opção da linha de comandos . - - - -manual-update -Sobrepõe-se à global -Configure o valor da opção como true para evitar que o processo de compilação tente actualizar (e, por conseguinte, compilar ou instalar) este módulo. Se definir esta opção para um módulo, também poderá tê-la comentada. - - - -module-base-path -Sobrepõe-se à global -Configure esta opção para se sobrepor à pasta por omissão do &tdesvn-build; para o módulo em questão. Isto poderá ser usado, por exemplo, para usar ramificações ou marcas específicas de determinadas bibliotecas. O Visualizador de Código do &kde; é extremamente valioso para o ajudar a escolher o local correcto. -Lembre-se que o &tdesvn-build; constrói o local final de acordo com o seguinte modelo: $svn-server/home/kde/$module-base-path/$module-name. -O valor por omissão tanto pode ser o trunk como o trunk/KDE, dependendo do nome do módulo. - - - - -niceness -Não poderá ser sobreposta -Configure esta opção com um valor entre 20 e 0. Quanto mais alto o número, menor prioridade terá o &tdesvn-build; para si próprio. O valor por omissão é 10. - - - -no-rebuild-on-fail -Sobrepõe-se à global -Configure o valor desta opção como true para evitar sempre que o &tdesvn-build; tente compilar de novo este módulo, se falhar numa compilação incremental. Normalmente, o &tdesvn-build; irá tentar compilar de novo o módulo do zero, para contradizer o efeito de uma actualização do &svn; inválida que confunda o sistema de compilação. - - - -override-url -Sobrepõe-se à global -Se configurar esta opção, o 'tdesvn-build' irá usar o seu valor como o URL a passar ao Subversion, sem qualquer alteração. Deverá usar geralmente esta opção, se quiser obter uma versão específica, mas o 'tdesvn-build' não conseguir descobrir o que queria dizer ao usar a opção branch. - - - -qtdir -Não poderá ser sobreposta -Configure esta opção para definir a variável de ambiente TQTDIR enquanto compila. Poderá sobrepor esta configuração numa opção de um módulo. Se não indicar esta opção, será por omissão a $(source-dir)/build/qt-copy, que irá usar o módulo 'qt-copy' que está incluído no repositório de código do &kde;. Poderá usar um til (~) que representa a sua pasta pessoal. - - - -remove-after-install -Sobrepõe-se à global -Se estiver com pouco espaço em disco, poderá querer usar esta opção para remover automaticamente a pasta de compilação (ou as pastas de compilação e de código, para instalações episódicas), após o módulo ter sido instalado com sucesso. -Os valores possíveis para esta opção são: -none - Não remove nada (Este é o valor por omissão). -builddir - Remove a pasta de compilação, mas não o código. -all - Remove tanto o código-fonte como a pasta de compilação. - - - -Lembre-se que a utilização desta opção poderá ter um grande impacto na utilização da sua largura de banda (se usar o 'all') e o tempo que dura a compilação do KDE, dado que o 'tdesvn-build' será incapaz de efectuar compilações incrementais. - - - - -set-env -Sobrepõe-se à global -Esta opção aceita um conjunto de valores separados por espaços, onde o primeiro valor é a variável de ambiente a definir e o resto dos valores é o que deseja atribuir à sua variável. Por exemplo, para configurar a variável RONALD como McDonald, iria pôr este comando na secção apropriada: -set-env RONALD McDonald -Esta opção é especial, na medida em que poderá ser repetida sem sobrepor a configuração anterior do 'set-env' na mesma secção do ficheiro de configuração. Desta forma, poderá definir mais que uma variável de ambiente por módulo (ou a nível global). - - - - -source-dir -Não poderá ser sobreposta -Esta opção é usada para definir a pasta do seu computador, onde será guardado o código-fonte do &svn; do &kde;. Se não indicar este valor, será usado o valor por omissão ~/tdesvn. Se indicar de facto este valor, use um local absoluto. - - - -svn-server -Não poderá ser sobreposta -Esta opção é usada para definir o servidor usado para obter o código do &svn;. Por omissão, é usado o repositório anónimo de &svn;, em svn://anonsvn.kde.org/ - - - -stop-on-failure -Sobrepõe-se à global -Configure o valor desta opção como true para fazer com que o programa pare a execução, após ocorrer um erro durante o processo de compilação ou instalação. Esta opção está desactivada por omissão. - - - -tag -Sobrepõe-se à global -Use esta opção para obter uma versão específica de um módulo. -NOTA: As hipóteses serão muito boas quando NÃO QUISER usar esta opção. As versões do KDE estão disponíveis em pacote comprimidos no servidor de FTP do KDE ou numa das suas réplicas. -Se estiver a usar o 'tdesvn-build' porque está com problemas a obter uma versão do KDE para compilar na sua distribuição, pense em usar a ferramenta de compilação Konstruct em alternativa, a qual funciona a partir dos pacotes de lançamento. - - - - -use-qt-builddir-hack -Sobrepõe-se à global -Ainda que esta opção se sobreponha à global, só fará sentido para o 'qt-copy'. Configure esta opção como true para activar o modo experimental de 'srcdir' != 'builddir'. Se estiver activada, o &tdesvn-build; irá copiar o módulo de código do 'qt-copy' para a pasta de compilação e efectuar as compilações a partir daí. Isto significa que a sua variável de ambiente TQTDIR ficará igual a $(qt-copy-build-dir)/qt-copy/lib em alternativa. Deverá também mudar a sua opção qtdir em função disso. O 'make' incremental deverá à mesma funcionar neste modo, dado que as datas serão preservadas após a cópia. Se usar a opção apply-qt-patches, as actualizações serão aplicadas na pasta de compilação, não na pasta de código. Esta opção é igual a true, por omissão. - - - -use-unsermake -Sobrepõe-se à global -Configure esta opção como true para poder usar o programa experimentar 'unsermake' em vez do 'automake' ao correr o programa 'configure'. Isto poderá levar a algumas diminuições sérias na altura da compilação, principalmente no caso dos sistemas de compilação distribuídos. Esta opção é, por omissão, true (para a maioria dos módulos). - -Normalmente, se usar esta opção, o 'tdesvn-build' irá manter automaticamente o 'unsermake' actualizado. Isto poderá começar a ser incómodo, principalmente se estiver a gerir você mesmo o 'unsermake'. Se for este o caso, poderá configurar esta opção como self, pelo que o 'tdesvn-build' irá usar à mesma o 'unsermake', mas não fará nada de especial para o manter actualizado. - - - - - - -
- - - - -Opções da Linha de Comandos e Variáveis de Ambiente - -Este programa não usa variáveis de ambiente. Se necessitar de definir variáveis de ambiente para o ambiente de compilação ou de instalação, veja a opção set-env. - -O programa aceita as seguintes opções da linha de comandos: - - - - - -mostra apenas uma ajuda simples deste programa. - - - - -mostra a versão do programa. - - - - -mostra as informações de contacto do autor. - - - - -activa o resultado do programa a cores. - - - - -desactiva o resultado do programa a cores. - - - - (ou ) -não faz NADA de facto, mas funciona como se fizesse. - - - - (ou ) -Não é tão descritivo com o resultado à saída. Com esta opção, só as mensagens básicas são apresentadas. - - - - -Só mostra as mensagens de avisos e erros. - - - - -Torna-se bastante descritivo com o que se passa e o que o 'tdesvn-build' está a fazer. - - - - -efectua apenas a actualização do código. - - - - -efectua apenas o processo de compilação. - - - - -não inclui os módulos passados no resto da linha de comandos no processo de actualização/compilação. - - - - -ignora o passo de contacto do servidor do &svn;. - - - - -salta o processo de compilação. - - - - -não instala automaticamente os pacotes, após a sua compilação. - - - - -activa o modo de depuração para o programa. De momento, isto significa que todo o resultado será enviado para o STDOUT, para além de ficar registado na pasta de registo como normal. Do mesmo modo, muitas das funções tornar-se-ão mais descritivas sobre o que estão fazer no modo de depuração. - - - - -não tenta compilar de novo os módulos que não conseguiram ser compilados do zero. O &tdesvn-build; nunca irá tentar fazer isto num módulo que já se tentou compilar do zero. - - - - -volta a criar o sistema de compilação e a compilar do zero. - - - - -executa o programa 'configure' de novo sem limpar a pasta de compilação. - - - - -executa o make Makefile.cvs de novo para criar o programa 'configure' e continua a compilação normalmente. Esta opção implica a . - - - - -que tenta continuar a compilação a partir do ponto em que o programa parou da última vez. O programa começa a compilar o módulo, após o último ter sido compilado da última vez em que o programa foi executado, quer tenha corrido bem ou não. Esta opção implica a . Não deverá indicar os nomes de outros módulos na linha de comandos. - - - - -que é semelhante à opção , excepto que indica qual o módulo de onde começa a compilação como parâmetro seguinte na linha de comandos. Esta opção implica a . Não deverá indicar os nomes dos outros módulos na linha de comandos. - - - - -que interpreta o próximo parâmetro da linha de comandos como o ficheiro de onde ler as opções de configuração. O valor por omissão deste parâmetro é '~/.tdesvn-buildrc'. - - - - -que lhe permite mudar a pasta onde o &kde; será instalado na linha de comandos. Esta opção implica a . - - - - -pára após a execução do make Makefile.cvs. O programa 'configure' irá necessitar à mesma de ser executado, coisa que o &tdesvn-build; irá fazer da próxima vez. Isto permite-lhe preparar todos os programas 'configure' de uma vez, para que possa ver o ./configure de cada módulo e editar as suas opções do 'configure' adequadamente. - - - -Se esta for a única opção da linha de comandos, irá tentar instalar todos os módulo incluídos em 'successfully-built', excepto o 'qt-copy', que não necessita de instalação. Se as opções da linha de comandos forem indicadas após o , então assumem-se que são módulos para instalar. - - - - -Poderá usar esta opção para sobrepor outra opção no seu ficheiro de configuração para todos os módulos. Por exemplo, para sobrepor a opção log-dir, deverá escrever: . - - - - -Poderá usar esta opção para sobrepor uma opção do seu ficheiro de configuração para um dado módulo. Por exemplo, para sobrepor a opção use-unsermake do 'tdemultimedia', iria escrever: . - - - - -Todas as outras opções da linha de comandos assumem-se como sendo módulos para actualizar e compilar. Por favor, não misture a compilação com a instalação. - - - - -Créditos e Licenças -&underFDL; - - diff --git a/tde-i18n-pt/docs/tdesdk/tdesvn-build/CMakeLists.txt b/tde-i18n-pt/docs/tdesdk/tdesvn-build/CMakeLists.txt new file mode 100644 index 00000000000..63f6da47f4a --- /dev/null +++ b/tde-i18n-pt/docs/tdesdk/tdesvn-build/CMakeLists.txt @@ -0,0 +1,6 @@ +# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer + +tde_create_handbook( + DESTINATION tdesvn-build + LANG pt +) diff --git a/tde-i18n-pt/docs/tdesdk/tdesvn-build/Makefile.am b/tde-i18n-pt/docs/tdesdk/tdesvn-build/Makefile.am new file mode 100644 index 00000000000..70bf689f3a2 --- /dev/null +++ b/tde-i18n-pt/docs/tdesdk/tdesvn-build/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = pt +SUBDIRS = $(AUTODIRS) +KDE_DOCS = tdesvn-build +KDE_MANS = AUTO diff --git a/tde-i18n-pt/docs/tdesdk/tdesvn-build/index.docbook b/tde-i18n-pt/docs/tdesdk/tdesvn-build/index.docbook new file mode 100644 index 00000000000..a371d6302c3 --- /dev/null +++ b/tde-i18n-pt/docs/tdesdk/tdesvn-build/index.docbook @@ -0,0 +1,739 @@ + + + + + + Subversion"> + tdesvn-build"> +]> + + + + +Manual do 'Script' &tdesvn-build; + + +MichaelPyne
michael.pyne@kdemail.net
 + +CarlosWoelz
carloswoelz@imap-mail.com
 + + + +JoséPires
jncp@netcabo.pt
Tradução + + + + +2005 +Michael Pyne + + + +2005 +Carlos Woelz + + + +&FDLNotice; + +2005-06-18 +0.98 + + +O &tdesvn-build; é um programa em Perl que compila e instala o &kde; directamente a partir do código existente no repositório de &svn; do &kde;. + + + +KDE +tdesdk +SVN +Subversion +Desenvolvimento KDE + + + + + + +Introdução + +O &tdesvn-build; é um programa em Perl que ajuda os utilizadores a instalar o &kde; a partir do &svn;. Poderá também querer considerar o programa 'kde-build' que vem incluído no módulo 'tdesdk' do &kde;. + +Aqui será documentado a sintaxe opções do ficheiro de configuração do &tdesvn-build;, as suas opções da linha de comandos, as funcionalidades e uma introdução a todos os passos necessários para compilar o &kde; a partir do código, incluindo os passos que deverá efectuar ao usar as outras ferramentas ou, por outras palavras, os passos que não são efectuados automaticamente pelo programa &tdesvn-build;. + + + + +Começar + +Neste capítulo, será apresentada a forma de utilização do &tdesvn-build; para obter os módulos do repositório do &kde; e os compilar. Será dada também uma explicação básica da estrutura de &svn; do &kde; e os passos que terá de efectuar antes de executar o programa. + +Todos os tópicos presentes neste capítulo são cobertos com ainda mais detalhe na secção Guia de Compilação do Código do &kde; Passo-a-Passo, na Página Web da Equipa de Qualidade do &kde;. Se estiver a compilar o KDE pela primeira vez, é uma boa ideia lê-lo ou consultá-lo como fonte de referência. Irá encontrar informações detalhada sobre as ferramentas de empacotamento e os requisitos, os problemas de compilação comuns e as estratégias e informações sobre a execução da instalação do seu novo &kde;. + + +Preparar o Sistema para Compilar o &kde; + +Recomenda-se que transfira e compile o &kde; com uma conta de utilizador. Se já tiver os pacotes do &kde; instalados, a melhor opção será criar um utilizador diferente (dedicado) para compilar e executar o novo &kde;. A vantagem de compilar o &kde; com um utilizador dedicado é que não poderá corromper o sistema de base e terá sempre uma forma de trabalhar confortavelmente quando as coisas correrem mal. + +Mais tarde, poderá fazer uma instalação como 'root' se o desejar. Este documento não cobre uma instalação como 'root'. Se estiver a efectuar uma instalação a nível do sistema, provavelmente já deverá saber o que está a fazer. + +Antes de usar o programa &tdesvn-build; (ou qualquer outra estratégia de compilação), deverá instalar as ferramentas de desenvolvimento e bibliotecas necessárias para o &kde;. Necessita da biblioteca Qt, versão 3.3.0 ou posterior, do Automake 1.8, Autoconf 2.5X (melhor se >=2.57, dado que foi detectado um erro com as versões anteriores), o cliente do 'subversion' (svn), o compilador 'gcc' com o suporte de C++, a libxml2, o openssl, a libbz2 entre outras coisas (para uma lista completa, visite os Requisitos de Compilação do KDE). Poderá obter normalmente estas ferramentas para o seu sistema, a partir da sua distribuição ou fornecedor. + +Alguns destes pacotes estão divididos em bibliotecas, programas ou utilitários e pacotes de desenvolvimento. Irá necessitar, pelo menos do programa ou biblioteca e do seu pacote de desenvolvimento. Se tiver dúvidas, instale tudo. As bibliotecas que necessita irão variar de acordo com os módulos que pretende compilar, dado que cada módulo tem os seus próprio requisitos. O Guia de Compilação do Código do &kde; Passo-a-Passo tem mais detalhes sobre as ferramentas e técnicas específicas usadas para instalar e encontrar o 'software' necessário. + +Poderá já ter uma versão do programa &tdesvn-build; instalada no seu sistema. O &tdesvn-build; obriga a que você crie um ficheiro de configuração chamado .tdesvn-buildrc. Este ficheiro deverá ser instalado na pasta pessoal (~/), e contém todos os dados de configuração necessários para o programa correr, como as opções de configuração, compilação, a localização do código, o destino da instalação (prefixo), os módulos que serão compilados, &etc;. Os dados de configuração por omissão são oferecidos pelo ficheiro tdesvn-buildrc-sample. Poderá encontrar mais informações sobre a sintaxe do ficheiro de configuração em e . + +Uma boa forma de obter a última versão é escolher a página 'tdesdk/scripts' da página Web do websvn.kde.org. Irá ver uma lista dos ficheiros disponíveis na pasta 'tdesdk/scripts' do repositório de &svn; do &kde;. Carregue na ligação do &tdesvn-build; e transfira a última versão do programa. Faça o mesmo para o ficheiro tdesvn-buildrc-sample. Torne o programa executável e verifique se está na sua PATH. + + + + +Definir os Dados de Configuração + +Para usar o programa, deverá ter um ficheiro na sua pasta pessoal chamado .tdesvn-buildrc, que define as opções gerais e os módulos que deseja transferir e compilar. + +Use o ficheiro tdesvn-buildrc-sample como modelo, defina as opções globais e os módulos que deseja compilar. + +Seleccione o servidor de onde deseja obter o &svn;, definindo a opção global 'svn-server'. O valor por omissão é o servidor &svn; anónimo, o svn://anonsvn.kde.org/, mas está à vontade para alterá-lo se tiver uma conta de &svn; do &kde; ou, se existir, uma réplica perto de si. + +Preste bastante atenção às variáveis globais 'tdedir' e 'qtdir', dado que a primeira define onde o seu &kde; irá ser instalado (por omissão em ~/kde), e o segundo diz onde (e se) a sua biblioteca Qt irá ser compilada e instalada, (por omissão em ~/tdesvn/build/qt-copy). Terá de saber mais tarde a localização da 'tdedir' e da 'qtdir', para configurar as variáveis de ambiente que são necessárias para executar a sua instalação nova. Verifique se os módulos indicados são, de facto, os módulos que pretende compilar. As opções por omissão do ficheiro tdesvn-buildrc-sample deverão ser suficientes para obter uma instalação relativamente completa do &kde;. Grave o resultado como .tdesvn-buildrc na sua pasta pessoal. + +Se desejar afinar o seu ficheiro .tdesvn-buildrc, consulte o para obter informação mais detalhada sobre todas as opções de configuração. + + + + +Usar o 'script' &tdesvn-build; + +Agora está pronto para executar o programa. A partir de uma janela de termina, autentique-se com o utilizador que usa para compilar o &kde; e execute o programa: %su utilizador +%tdesvn-build + + + +Agora, o programa deverá começar a ir obter o código-fonte e a compilá-lo. É pouco provável que corra tudo bem da primeira vez que compilar o &kde;. Não desespere! Verifique os ficheiros de registo para ver se faltam algumas ferramentas ou pacotes de desenvolvimento (a localização dos ficheiros de registo é definida pela variável 'log-dir' no ficheiro de configuração). Algumas vezes, a ramificação de desenvolvimento principal fica muito instável e difícil de compilar, principalmente quando está próximo um congelamento do desenvolvimento. Tenha paciência. Poderá descobrir mais exemplos comuns das coisas que poderão correr mal e as suas soluções, assim como dicas e estratégias gerais para compilar o &kde; no Guia de Compilação do Código do &kde; Passo-a-Passo. + + + + +Configurar o Ambiente para Executar o seu &kde; Novo + +Assumindo que está a usar um utilizador dedicado para compilar o &kde; e já tem uma versão do &kde; instalada, a execução do seu &kde; novo poderá ter os seus truques, dado que o &kde; novo terá de ter precedência sobre o antigo. Mude as variáveis de ambiente para garantir que isso acontece. + +Abra ou crie o ficheiro .bash_profile na sua pasta pessoal com o seu editor favorito e adicione o seguinte ao fim do ficheiro: +TDEDIR=(local do tdedir) +TDEDIRS=$TDEDIR +PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH +LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH +export TDEDIRS PATH LD_LIBRARY_PATH + Se estiver a compilar o módulo 'qt-copy', adicione em alternativa: TQTDIR=(local do qtdir) +TDEDIR=(local do tdedir) +TDEDIRS=$TDEDIR +PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH +MANPATH=$TQTDIR/doc/man:$MANPATH +LD_LIBRARY_PATH=$TDEDIR/lib:$TQTDIR/lib:$LD_LIBRARY_PATH +export TQTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH + + + +Se não estiver a usar um utilizador dedicado, defina um novo $TDEHOME para o seu novo ambiente no seu ficheiro .bash_profile: export TDEHOME="${HOME}/.tde-svn" + +# Criar a pasta se necessário +[ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn + + + + +Se, mais tarde, o seu menu estiver vazio ou completamente cheio de aplicações da sua distribuição, poderá ter de definir o as suas variáveis de ambiente do 'xdg' no seu .bash_profile: XDG_CONFIG_DIRS="/etc/xdg" +XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" +export XDG_CONFIG_DIRS XDG_DATA_DIRS + + + + + +Agora que terminou o que tinha para fazer, certifique-se que será usado o starttde correcto: + +Abra o ficheiro de texto .xinitrc (ou o .xsession, dependendo da distribuição) da pasta pessoal, ou crie-o se necessário. Adicione a linha: exec ${TDEDIR}/bin/starttde + + + +Agora inicie o seu &kde; novo: nos sistemas BSD e Linux, com o suporte para terminais virtuais, os atalhos Ctrl+Alt+F1...F12 são usados para mudar para a Consola Virtual 1 a 12. Isto permite-lhe executar mais que um ambiente gráfico ao mesmo tmpo. Os primeiros seis são terminais de texto e os seis seguintes são gráficos. + +Quando você arranca, é-lhe apresentado o gestor gráfico, em alternativa. Poderá usar o novo ambiente do KDE, mesmo que não apareça como opção. Carregue em Ctrl + Alt + F2, para que lhe apareça um terminal de texto. Autentique-se com o utilizador dedicado e escreva: + +startx -- :1 + + + +Poderá executar o KDE a partir do código e o KDE antigo ao mesmo tempo! Autentique-se com o seu utilizador normal e inicie o ambiente do KDE estável. Carregue em Ctrl + Alt + F2 (ou F1, F3, etc..), para que lhe apareça um terminal de texto. Ligue-se com o utilizador dedicado e escreva "startx -- :1". Poderá voltar ao utilizador normal, carregando em Ctrl + Alt + F6 (Ou F7, F8, etc... Experimente! Um deles é o correcto.) Para voltar ao KDE a partir do código, carregue em Ctrl + Alt + F7 (ou F6, F8,etc..). Agora poderá mudar entre as suas versões do KDE e teste a nova, sabendo que poderá voltar rapidamente à segurança do ambiente estável do KDE. + + + + + + + + +Funcionalidades do Programa + +As funcionalidades do &tdesvn-build; incluem: + + + + +Obtém ou actualiza automaticamente os módulos do &svn;, à medida das necessidades. + +Agenda o processo de compilação dos módulos. + +Tenta automaticamente compilar de novo os módulos que foram compilados com o 'make' incremental, que está sujeito a erros ao fim de algumas modificações. + +Poderá retomar uma execução anterior ou iniciar o processo de compilação de um determinado módulo. + +Vem incorporado com um conjunto seguro de opções predefinidas, apropriadas para compilar uma instalação mono-utilizador de base do &kde; a partir do repositório de &svn; anónimo. + +Vem com suporte para o Unsermake. + +Expansão do til (~) para as suas opções de configuração. Por exemplo, poderá indicar: qtdir ~/tdesvn/build/qt-copy + + +Pastas configuráveis para compilação, para o código-fonte e para registos. + +Configura automaticamente um sistema de compilação com uma pasta de compilação diferente da pasta de código, para manter impecável a pasta de código. A única excepção é o qt-copy, que não está desenhado para ser compilado dessa forma (a menos que queira testar o truque do Qt com uma pasta de compilação separada). + +Poderá indicar as opções globais a aplicar a todos os módulos a obter, assim como poderá indicar opções para se aplicar aos módulos individuais. + +Dado que as ferramentas 'auto*' normalmente perdem a sincronização com as modificações na árvore de código, poderá forçar uma nova compilação de um módulo, se criar um ficheiro chamado '.refresh-me' na pasta de compilação do módulo em questão ou executando o &tdesvn-build; com a opção . + +Poderá indicar vários valores de ambiente a usar durante a compilação, incluindo o TDEDIR, o TQTDIR, o DO_NOT_COMPILE e o CXXFLAGS. + +Registo dos comandos. Os ficheiros de registo são datados e numerados, para que tenha sempre um relatório de execução de um programa. Do mesmo modo, é criada uma ligação simbólica 'latest' para apontar sempre para o item de registo mais recente na pasta respectiva. + +Se estiver a usar uma compilação de utilizador do &kde;, em vez de uma instalação do sistema (para a qual necessita de ser o 'root' para instalar), poderá usar o programa para o instalar por si. Não foi ainda validado o código e este faz uma utilização ampla da chamada system(), como tal, não é recomendado executá-lo como 'root' nesta altura. + +Poderá usar o make-install-prefix para anteceder o comando 'make install' com um comando separado, o que poderá ser útil para o 'sudo'. + +Poderá usar a opção apidox para compilar e instalar automaticamente a documentação da API para alguns módulos. + +Poderá obter apenas uma parte de um módulo do &kde; no &svn;. Por exemplo, poderá obter apenas a biblioteca taglib do tdesupport ou apenas o K3B do extragear/multimedia. O programa irá obter automaticamente o kde-common, se for necessário para fazer a compilação funcionar. + +Poderá fingir efectuar as operações. Se passar a opção ou na linha de comandos, o programa dar-lhe-á uma descrição mais extensiva dos comandos que estará prestes a executar, sem os executar de facto. + +Suporte para obter ramificações ('branches') específicas dos módulos do &svn;. Este trabalho ainda necessita de ser terminado, mas já poderá seleccionar a ramificação que pretende compilar com a opção de configuração 'module-base-path'. + + + +As coisas que o &tdesvn-build; NÃO faz: + + + +Descobrir a réplica do &svn; do &kde; mais rápida. Não existe sequer uma lista a acompanhar o programa nesta altura, ainda que o servidor por omissão deva funcionar perfeitamente. + +Lavar-lhe os dentes. Isso deverá partir de si à mesma. + +O programa, provavelmente, não está livre de erros. Desculpe por isso. + + + + + + +O Formato do '.tdesvn-buildrc' + +Para usar o programa, deverá ter um ficheiro na sua pasta pessoal .tdesvn-buildrc, que descreve os módulos que deseja obter e compilar. + + + +Ele começa com as opções globais, indicadas da seguinte forma: + +global +nome-opção valor-opção +[...] +end global + + +Segue-se então uma ou mais secções dos módulos, organizadas da seguinte forma: + +module nome-módulo +nome-opção valor-opção +[...] +end module + + +O nome-módulo deverá ser um módulo do repositório de &svn; do &kde; (por exemplo, o 'tdelibs' ou o 'tdebase'). Algumas das opções sobrepõem-se às globais, algumas adicionam-se às opções globais e algumas opções globais simplesmente não podem ser sobrepostas. + +Segue-se uma lista ordenada alfabeticamente das opções que poderá usar. Carregue na opção para descobrir mais sobre ela. Se alguma não estiver documentada, envie por favor um e-mail aos autores, usando o endereço que poderá encontrar acima. + + +apidox, para compilar a Documentação da API +apply-qt-patches, para melhorar o 'qt-copy' +binpath, para definir a variável PATH. +branch, para obter uma dada ramificação, em vez da '/trunk'. +build-dir, para definir a pasta onde será feita a compilação. +checkout-only, para transferir apenas as partes de um módulo. +colorful-output para colorir o resultado do programa. +configure-flags para definir as opções com que um módulo poderá ser configurado. +cxxflags para definir a variável CXXFLAGS. +dest-dir para mudar a pasta de instalação de um módulo. +disable-agent-check, para impedir que o 'tdesvn-build' verifique o estado do 'ssh-agent'. +do-not-compile, para marcar as pastas que não serão compiladas. +inst-apps, para só compilar e instalar algumas pastas. +install-after-build, para evitar a instalação após o processo de compilação. +tdedir, para indicar a pasta onde o KDE será instalado. +libpath, para configurar a variável LD_LIBRARY_PATH. +make-install-prefix, para executar um programa auxiliar (como o 'sudo') durante o 'make install'. +make-options, para passar opções ao programa 'make'. +manual-build, para evitar que o módulo seja compilado automaticamente. +manual-update, para evitar que seja feito, seja o que for, ao módulo de forma automática. +module-base-path, para mudar o local onde transferir o módulo (útil para as ramificações - 'branches' -, e marcas - 'tags'). +niceness, para mudar a prioridade do CPU. +no-rebuild-on-fail, para evitar executar o 'make' de novo se falhar. +qtdir, para definir a localização do Qt. +set-env, para configurar uma variável de ambiente. +source-dir, para mudar o local onde colocar o código transferido. +stop-on-failure, para fazem com que o 'tdesvn-build' pare o mais cedo possível, após encontrar um problema. +svn-server, para mudar o servidor de onde é transferido o código. +use-qt-builddir-hack, para dar ao Qt uma pasta de compilação diferente da do seu código, como acontece no KDE. +use-unsermake, para usar o sistema de compilação avançado, o 'unsermake'. + + + +Aqui está uma tabela com as opções globais, bem como alguns comentários sobre elas. As opções que se sobreporem às globais irão também sobrepor-se a uma configuração da linha de comandos. + + +Tabela de Opções + + + + +Nome da Opção +Comportamento do Módulo -> Global +Notas + + + + + + +apidox +Sobrepõe-se à global +Configure esta opção como true, para que o &tdesvn-build; compile e instale automaticamente a documentação da API do módulo, após o processo de compilação/instalação normal. Isto só funciona para os módulos em que o make apidox faz alguma coisa, e que incluem o 'tdelibs', 'tdebase' e o 'koffice', entre outros. + + + +apply-qt-patches +Sobrepõe-se à global +Esta opção só é útil para o 'qt-copy'. Se for um valor diferente de zero, então o programa 'apply-patches' do 'qt-copy' será executado antes da compilação, para aplicar as alterações não oficiais no 'qt-copy'. Dado que estas alterações são normalmente a razão para usar o 'qt-copy', em vez de um Qt oficial, não deverá haver qualquer problema em activá-las. Por omissão, está activada a aplicação destas modificações. + + + +binpath +Não poderá ser sobreposta +Active esta opção para modificar a variável de ambiente PATH durante a compilação. Não poderá sobrepor esta opção numa opção do módulo. O valor por omissão é o /bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin. Esta variável de ambiente deverá incluir os locais, separados por dois-pontos das suas ferramentas de desenvolvimento. Os locais $TDEDIR/bin e $TQTDIR/bin são adicionados automaticamente. Poderá usar o til (~) para os locais que adicionar com esta opção. + + + + +branch +Sobrepõe-se à global +Altere esta opção para obter uma ramificação do KDE, em vez do valor por omissão "trunk", onde o desenvolvimento do KDE está em curso. Por exemplo, para obter a ramificação do KDE 3.4, deverá configurar esta opção como "3.4". +Lembre-se que alguns módulos usam um nome de ramificação diferente. Em concreto, o módulo obrigatório 'arts' não segue os números de versões do KDE. O 'arts' que acompanhava o KDE 3.4 era o 1.4. +Se o 'tdesvn-build' não conseguir obter adequadamente uma ramificação com esta opção, poderá ter de indicar manualmente o URL de onde transferir, com a opção override-url. + + + + +build-dir +Sobrepõe-se à global +Use esta opção para mudar a pasta que contém o código compilado. Existem três formas diferentes de o usar: Relativa à pasta de código do &kde; no &svn; (ver a opção 'source-dir'). Esta é a opção predefinida e a forma como funcionou o programa até à versão v0.61. Este modo fica seleccionado se escrever o nome de uma pasta que não comece por um til (~) ou uma barra (/). O valor por omissão é build. Um local absoluto. Se indicar um local que comece por um /, então será usado esse local directamente. Por exemplo, o /tmp/kde-obj-dir/. Relativo à sua pasta pessoal. Se indicar uma pasta que comece com um '~', então o local será usado em relação à sua pasta pessoal, de forma semelhante à expansão do til da linha de comandos. Por exemplo, o ~/builddir irá configurar a pasta de compilação como /home/utilizador/builddir. Talvez de forma surpreendente, esta opção poderá alterada por módulo. + + + +checkout-only +Sobrepõe-se à global +Altere esta opção para obter o código do &svn; passo-a-passo. O valor desta opção deverá ser uma lista separada por espaços das pastas a transferir. Se não incluir a pasta 'admin', será incluída automaticamente (se necessário). Ao transferir passo-a-passo, a pasta 'admin' será obtida do 'kde-common', que é onde se encontra no servidor do &svn;. Ainda que esta opção se sobreponha à global, tenha em atenção que esta opção, como global, não faz sentido. + + + +configure-flags +Adiciona às opções globais (excepto no 'qt-copy') +Use esta opção para indicar quais as opções a passar ao './configure' quando criar o sistema de compilação do módulo. Quando isto é usado como uma opção global, é aplicada a todos os módulos onde este programa se compila. O 'qt-copy' usa um conjunto muito diferente de opções do 'configure' do resto do &kde;, como tal esta opção sobrepõe as opções globais, quando é aplicada ao 'qt-copy'. + + + +colorful-output +Não poderá ser sobreposta +Configure esta opção como 'false' para desactivar o resultado colorido do &tdesvn-build;. Por omissão é true. Lembre-se que o &tdesvn-build; não irá mostrar os códigos de cores em nada que não seja um terminal (como o 'xterm', o &konsole; ou a consola normal do Linux). + + + +cxxflags +Adiciona-se à opção global +Use esta opção para indicar as opções a passar ao ./configure como CXXFLAGS, ao criar o sistema de compilação do módulo. Esta opção é indicada aqui em vez do configure-flags, dado que esta opção irá também definir a variável de ambiente CXXFLAGS durante o processo de compilação. + + + +dest-dir +Sobrepõe-se à global +Use esta opção para mudar o nome que é dado a um módulo no disco. Por exemplo, se o seu módulo se chamava 'extragear/network', poderá mudar o nome do mesmo para 'extragear-network' com esta opção. + + + +disable-agent-check +Não poderá ser sobreposta +Normalmente, se estiver a usar o SSH para obter o código do Subversion (se, por exemplo, estiver a usar o protocolo 'svn+ssh'), o 'tdesvn-build' irá tentar certificar-se que, se estiver a usar o 'ssh-agent', ele está de facto a gerir algumas identidades do SSH. Isto é para tentar e evitar que o SSH pergunte a sua frase-senha para todos os módulos. Poderá desactivar esta opção se activar a opção 'disable-agent-check' como 'true'. + + + +do-not-compile +Sobrepõe-se à global +Use esta opção para definir a variável de ambiente DO_NOT_COMPILE antes de executar o programa 'configure'. De acordo com a FAQ de Desenvolvimento do &kde;, este deverá ser o caso de uma pasta de topo que não deseje compilar. As pastas deverão estar separadas por espaços. + +Lembre-se que o código dos programas será à mesma transferido. Poderá usar a instrução checkout-only para escolher as pastas que deseja obter. + + + + +email-address +Não poderá ser sobreposta + +Configure esta opção com o endereço de e-mail que o 'tdesvn-build' deverá enviar, no caso de alguma vez necessitar de enviar mensagens. Não terá de se preocupar com isto se não usar qualquer funcionalidade que envie e-mails. (Elas estão todas desactivadas por omissão). + +De momento, só o email-on-compile-error é que necessita desta opção. + + + + +email-on-compile-error +Não poderá ser sobreposta + +Poderá configurar esta opção com o endereço de e-mail para onde enviar um relatório, sempre que um módulo não conseguir ser compilado. O 'tdesvn-build' irá esperar até que todos os módulos terminem e irá recolher todos os resultados no relatório. Este só é enviado se um módulo se recusar a compilar. + +Por favor, veja a opção email-address para configurar o endereço de onde o 'tdesvn-build' irá enviar, dado que o valor por omissão não é normalmente o que pretende. + + + + +inst-apps +Sobrepõe-se à global +Esta é o oposto da opção do-not-compile. Serve para indicar que apenas as pastas de topo referidas serão compiladas. As pastas deverão estar separadas por espaços. + +As alterações não farão efeito até à próxima vez que o make Makefile.cvs seja executado, quer automaticamente pelo programa, quer manualmente pelas opções ou . + +Lembre-se que o código dos programas será à mesma transferido. Poderá usar a instrução checkout-only para escolher as pastas que deseja obter. + + + + +install-after-build +Sobrepõe-se à global +Esta opção é usada para instalar o pacote depois de este ser compilado com sucesso. Esta opção está activa por omissão. Se quiser desactivá-la, terá de configurar esta opção como 0 no ficheiro de configuração. Poderá também usar a opção da linha de comandos . + + + +tdedir +Não poderá ser sobreposta +Esta opção define a pasta em que o &kde; será instalado após a compilação. Por omissão, será em ~/kde. Se mudar isto para uma pasta que necessite do acesso do 'root', poderá ter de ler acerca da opção make-install-prefix também. + + + +libpath +Não poderá ser sobreposta +Configure esta opção para definir a variável de ambiente LD_LIBRARY_PATH, enquanto efectua a compilação. Não poderá sobrepor esta opção num módulo. O valor por omissão está em branco, mas os locais $TDEDIR/lib e $TQTDIR/lib são adicionados automaticamente. Poderá usar o til (~) para os locais que adicionar com esta opção. + + + +log-dir +Sobrepõe-se à global +Use esta opção para mudar a pasta que irá conter os ficheiros de registo gerados pelo programa. Esta opção poderá ser definida por cada módulo, desde a versão 0.64 e posteriores. + + + +make-install-prefix +Sobrepõe-se à global +Configure esta variável com uma lista separada por espaços, que será interpretada como um comando e as suas opções, para anteceder o comando 'make install', que é usado para instalar os módulos. Isto é útil para instalar os pacotes com o 'sudo', por exemplo, mas tenha cuidado enquanto lida com os privilégios do 'root'. + + + +make-options +Sobrepõe-se à global +Configure esta variável para passar as opções da linha de comandos ao comando 'make'. Isto é útil para os programas, como o distcc. O distcc permite-lhe partilhar o seu trabalho de compilação por mais que um computador. Para a usar, deverá usar a opção do 'make'. Agora já pode. De acordo com a documentação, recomenda-se '2 * número_de_cpus_na_rede'. Existe 1 CPU no caso do autor, como tal seria no caso dele. + + + +manual-build +Sobrepõe-se à global +Configure o valor da opção como true para evitar que o processo de compilação tente compilar este módulo. Será à mesma mantido actualizado ao actualizar a partir do &svn;. Esta opção é exactamente equivalente à opção da linha de comandos . + + + +manual-update +Sobrepõe-se à global +Configure o valor da opção como true para evitar que o processo de compilação tente actualizar (e, por conseguinte, compilar ou instalar) este módulo. Se definir esta opção para um módulo, também poderá tê-la comentada. + + + +module-base-path +Sobrepõe-se à global +Configure esta opção para se sobrepor à pasta por omissão do &tdesvn-build; para o módulo em questão. Isto poderá ser usado, por exemplo, para usar ramificações ou marcas específicas de determinadas bibliotecas. O Visualizador de Código do &kde; é extremamente valioso para o ajudar a escolher o local correcto. +Lembre-se que o &tdesvn-build; constrói o local final de acordo com o seguinte modelo: $svn-server/home/kde/$module-base-path/$module-name. +O valor por omissão tanto pode ser o trunk como o trunk/KDE, dependendo do nome do módulo. + + + + +niceness +Não poderá ser sobreposta +Configure esta opção com um valor entre 20 e 0. Quanto mais alto o número, menor prioridade terá o &tdesvn-build; para si próprio. O valor por omissão é 10. + + + +no-rebuild-on-fail +Sobrepõe-se à global +Configure o valor desta opção como true para evitar sempre que o &tdesvn-build; tente compilar de novo este módulo, se falhar numa compilação incremental. Normalmente, o &tdesvn-build; irá tentar compilar de novo o módulo do zero, para contradizer o efeito de uma actualização do &svn; inválida que confunda o sistema de compilação. + + + +override-url +Sobrepõe-se à global +Se configurar esta opção, o 'tdesvn-build' irá usar o seu valor como o URL a passar ao Subversion, sem qualquer alteração. Deverá usar geralmente esta opção, se quiser obter uma versão específica, mas o 'tdesvn-build' não conseguir descobrir o que queria dizer ao usar a opção branch. + + + +qtdir +Não poderá ser sobreposta +Configure esta opção para definir a variável de ambiente TQTDIR enquanto compila. Poderá sobrepor esta configuração numa opção de um módulo. Se não indicar esta opção, será por omissão a $(source-dir)/build/qt-copy, que irá usar o módulo 'qt-copy' que está incluído no repositório de código do &kde;. Poderá usar um til (~) que representa a sua pasta pessoal. + + + +remove-after-install +Sobrepõe-se à global +Se estiver com pouco espaço em disco, poderá querer usar esta opção para remover automaticamente a pasta de compilação (ou as pastas de compilação e de código, para instalações episódicas), após o módulo ter sido instalado com sucesso. +Os valores possíveis para esta opção são: +none - Não remove nada (Este é o valor por omissão). +builddir - Remove a pasta de compilação, mas não o código. +all - Remove tanto o código-fonte como a pasta de compilação. + + + +Lembre-se que a utilização desta opção poderá ter um grande impacto na utilização da sua largura de banda (se usar o 'all') e o tempo que dura a compilação do KDE, dado que o 'tdesvn-build' será incapaz de efectuar compilações incrementais. + + + + +set-env +Sobrepõe-se à global +Esta opção aceita um conjunto de valores separados por espaços, onde o primeiro valor é a variável de ambiente a definir e o resto dos valores é o que deseja atribuir à sua variável. Por exemplo, para configurar a variável RONALD como McDonald, iria pôr este comando na secção apropriada: +set-env RONALD McDonald +Esta opção é especial, na medida em que poderá ser repetida sem sobrepor a configuração anterior do 'set-env' na mesma secção do ficheiro de configuração. Desta forma, poderá definir mais que uma variável de ambiente por módulo (ou a nível global). + + + + +source-dir +Não poderá ser sobreposta +Esta opção é usada para definir a pasta do seu computador, onde será guardado o código-fonte do &svn; do &kde;. Se não indicar este valor, será usado o valor por omissão ~/tdesvn. Se indicar de facto este valor, use um local absoluto. + + + +svn-server +Não poderá ser sobreposta +Esta opção é usada para definir o servidor usado para obter o código do &svn;. Por omissão, é usado o repositório anónimo de &svn;, em svn://anonsvn.kde.org/ + + + +stop-on-failure +Sobrepõe-se à global +Configure o valor desta opção como true para fazer com que o programa pare a execução, após ocorrer um erro durante o processo de compilação ou instalação. Esta opção está desactivada por omissão. + + + +tag +Sobrepõe-se à global +Use esta opção para obter uma versão específica de um módulo. +NOTA: As hipóteses serão muito boas quando NÃO QUISER usar esta opção. As versões do KDE estão disponíveis em pacote comprimidos no servidor de FTP do KDE ou numa das suas réplicas. +Se estiver a usar o 'tdesvn-build' porque está com problemas a obter uma versão do KDE para compilar na sua distribuição, pense em usar a ferramenta de compilação Konstruct em alternativa, a qual funciona a partir dos pacotes de lançamento. + + + + +use-qt-builddir-hack +Sobrepõe-se à global +Ainda que esta opção se sobreponha à global, só fará sentido para o 'qt-copy'. Configure esta opção como true para activar o modo experimental de 'srcdir' != 'builddir'. Se estiver activada, o &tdesvn-build; irá copiar o módulo de código do 'qt-copy' para a pasta de compilação e efectuar as compilações a partir daí. Isto significa que a sua variável de ambiente TQTDIR ficará igual a $(qt-copy-build-dir)/qt-copy/lib em alternativa. Deverá também mudar a sua opção qtdir em função disso. O 'make' incremental deverá à mesma funcionar neste modo, dado que as datas serão preservadas após a cópia. Se usar a opção apply-qt-patches, as actualizações serão aplicadas na pasta de compilação, não na pasta de código. Esta opção é igual a true, por omissão. + + + +use-unsermake +Sobrepõe-se à global +Configure esta opção como true para poder usar o programa experimentar 'unsermake' em vez do 'automake' ao correr o programa 'configure'. Isto poderá levar a algumas diminuições sérias na altura da compilação, principalmente no caso dos sistemas de compilação distribuídos. Esta opção é, por omissão, true (para a maioria dos módulos). + +Normalmente, se usar esta opção, o 'tdesvn-build' irá manter automaticamente o 'unsermake' actualizado. Isto poderá começar a ser incómodo, principalmente se estiver a gerir você mesmo o 'unsermake'. Se for este o caso, poderá configurar esta opção como self, pelo que o 'tdesvn-build' irá usar à mesma o 'unsermake', mas não fará nada de especial para o manter actualizado. + + + + + + +
+ + + + +Opções da Linha de Comandos e Variáveis de Ambiente + +Este programa não usa variáveis de ambiente. Se necessitar de definir variáveis de ambiente para o ambiente de compilação ou de instalação, veja a opção set-env. + +O programa aceita as seguintes opções da linha de comandos: + + + + + +mostra apenas uma ajuda simples deste programa. + + + + +mostra a versão do programa. + + + + +mostra as informações de contacto do autor. + + + + +activa o resultado do programa a cores. + + + + +desactiva o resultado do programa a cores. + + + + (ou ) +não faz NADA de facto, mas funciona como se fizesse. + + + + (ou ) +Não é tão descritivo com o resultado à saída. Com esta opção, só as mensagens básicas são apresentadas. + + + + +Só mostra as mensagens de avisos e erros. + + + + +Torna-se bastante descritivo com o que se passa e o que o 'tdesvn-build' está a fazer. + + + + +efectua apenas a actualização do código. + + + + +efectua apenas o processo de compilação. + + + + +não inclui os módulos passados no resto da linha de comandos no processo de actualização/compilação. + + + + +ignora o passo de contacto do servidor do &svn;. + + + + +salta o processo de compilação. + + + + +não instala automaticamente os pacotes, após a sua compilação. + + + + +activa o modo de depuração para o programa. De momento, isto significa que todo o resultado será enviado para o STDOUT, para além de ficar registado na pasta de registo como normal. Do mesmo modo, muitas das funções tornar-se-ão mais descritivas sobre o que estão fazer no modo de depuração. + + + + +não tenta compilar de novo os módulos que não conseguiram ser compilados do zero. O &tdesvn-build; nunca irá tentar fazer isto num módulo que já se tentou compilar do zero. + + + + +volta a criar o sistema de compilação e a compilar do zero. + + + + +executa o programa 'configure' de novo sem limpar a pasta de compilação. + + + + +executa o make Makefile.cvs de novo para criar o programa 'configure' e continua a compilação normalmente. Esta opção implica a . + + + + +que tenta continuar a compilação a partir do ponto em que o programa parou da última vez. O programa começa a compilar o módulo, após o último ter sido compilado da última vez em que o programa foi executado, quer tenha corrido bem ou não. Esta opção implica a . Não deverá indicar os nomes de outros módulos na linha de comandos. + + + + +que é semelhante à opção , excepto que indica qual o módulo de onde começa a compilação como parâmetro seguinte na linha de comandos. Esta opção implica a . Não deverá indicar os nomes dos outros módulos na linha de comandos. + + + + +que interpreta o próximo parâmetro da linha de comandos como o ficheiro de onde ler as opções de configuração. O valor por omissão deste parâmetro é '~/.tdesvn-buildrc'. + + + + +que lhe permite mudar a pasta onde o &kde; será instalado na linha de comandos. Esta opção implica a . + + + + +pára após a execução do make Makefile.cvs. O programa 'configure' irá necessitar à mesma de ser executado, coisa que o &tdesvn-build; irá fazer da próxima vez. Isto permite-lhe preparar todos os programas 'configure' de uma vez, para que possa ver o ./configure de cada módulo e editar as suas opções do 'configure' adequadamente. + + + +Se esta for a única opção da linha de comandos, irá tentar instalar todos os módulo incluídos em 'successfully-built', excepto o 'qt-copy', que não necessita de instalação. Se as opções da linha de comandos forem indicadas após o , então assumem-se que são módulos para instalar. + + + + +Poderá usar esta opção para sobrepor outra opção no seu ficheiro de configuração para todos os módulos. Por exemplo, para sobrepor a opção log-dir, deverá escrever: . + + + + +Poderá usar esta opção para sobrepor uma opção do seu ficheiro de configuração para um dado módulo. Por exemplo, para sobrepor a opção use-unsermake do 'tdemultimedia', iria escrever: . + + + + +Todas as outras opções da linha de comandos assumem-se como sendo módulos para actualizar e compilar. Por favor, não misture a compilação com a instalação. + + + + +Créditos e Licenças +&underFDL; + + diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt b/tde-i18n-pt_BR/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt deleted file mode 100644 index cbf32c9a4a0..00000000000 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt +++ /dev/null @@ -1,6 +0,0 @@ -# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer - -tde_create_handbook( - DESTINATION tdesvn-build - LANG pt_BR -) diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/tdesvn-build/Makefile.am b/tde-i18n-pt_BR/docs/tdesdk/scripts/tdesvn-build/Makefile.am deleted file mode 100644 index 8c9276fea9d..00000000000 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/tdesvn-build/Makefile.am +++ /dev/null @@ -1,4 +0,0 @@ -KDE_LANG = pt_BR -SUBDIRS = $(AUTODIRS) -KDE_DOCS = tdesvn-build -KDE_MANS = AUTO diff --git a/tde-i18n-pt_BR/docs/tdesdk/scripts/tdesvn-build/index.docbook b/tde-i18n-pt_BR/docs/tdesdk/scripts/tdesvn-build/index.docbook deleted file mode 100644 index f94a9709930..00000000000 --- a/tde-i18n-pt_BR/docs/tdesdk/scripts/tdesvn-build/index.docbook +++ /dev/null @@ -1,739 +0,0 @@ - - - - - - Subversion"> - tdesvn-build"> -]> - - - - -Manual do 'Script' &tdesvn-build; - - -MichaelPyne
michael.pyne@kdemail.net
 - -CarlosWoelz
carloswoelz@imap-mail.com
 - - - -MarcusGama
marcus.gama@gmail.com
Tradução - - - - -2005 -Michael Pyne - - - -2005 -Carlos Woelz - - - -&FDLNotice; - -2005-06-18 -0.98 - - -O &tdesvn-build; é um programa em Perl que compila e instala o &kde; diretamente a partir do código existente no repositório de &svn; do &kde;. - - - -KDE -tdesdk -SVN -Subversion -Desenvolvimento KDE - - - - - - -Introdução - -O &tdesvn-build; é um programa em Perl que ajuda os usuários a instalar o &kde; a partir do &svn;. Você pode também querer considerar o programa 'kde-build' que vem incluído no módulo 'tdesdk' do &kde;. - -Aqui será documentado a sintaxe opções do arquivo de configuração do &tdesvn-build;, as suas opções da linha de comando, as funcionalidades e uma introdução a todos os passos necessários para compilar o &kde; a partir do código fonte, incluindo os passos que você deverá efetuar ao usar as outras ferramentas ou, em outras palavras, os passos que não são efetuados automaticamente pelo programa &tdesvn-build;. - - - - -Começando - -Neste capítulo, será apresentada a forma de utilização do &tdesvn-build; para obter os módulos do repositório do &kde; e compilá-los. Nós daremos também uma explicação básica da estrutura de &svn; do &kde; e os passos que você terá que efetuar antes de executar o programa. - -Todos os tópicos presentes neste capítulo são cobertos com ainda mais detalhe na seção Guia de Compilação do Código do &kde; Passo-a-Passo, na Página Web da Equipe de Qualidade do &kde;. Se você estiver compilando o KDE pela primeira vez, é uma boa idéia lê-lo ou consultá-lo como fonte de referência. Você irá encontrar informações detalhadas sobre as ferramentas de empacotamento e os requisitos, os problemas de compilação comuns e as estratégias e informações sobre a execução da instalação do seu novo &kde;. - - -Preparando o Sistema para Compilar o &kde; - -É recomendável que você transfira e compile o &kde; com uma conta de usuário. Se você já tiver os pacotes do &kde; instalados, a melhor opção será criar um usuário diferente (dedicado) para compilar e executar o novo &kde;. A vantagem de compilar o &kde; com um usuário dedicado é que você não poderá corromper o sistema base e terá sempre uma forma de trabalhar confortavelmente quando as coisas correrem mal. - -Mais tarde, você poderá fazer uma instalação como 'root' se desejar. Este documento não cobre uma instalação como 'root'. Se você estiver executando uma instalação a nível do sistema, provavelmente já deverá saber o que está fazendo. - -Antes de usar o programa &tdesvn-build; (ou qualquer outra estratégia de compilação), você deverá instalar as ferramentas de desenvolvimento e bibliotecas necessárias para o &kde;. Você precisará da biblioteca Qt, versão 3.3.0 ou posterior, do Automake 1.8, Autoconf 2.5X (melhor se >=2.57, uma vez que foi detectado um erro com as versões anteriores), o cliente do 'subversion' (svn), o compilador 'gcc' com o suporte de C++, a libxml2, o openssl, a libbz2 entre outras coisas (para uma lista completa, visite os Requisitos de Compilação do KDE). Você poderá obter normalmente estas ferramentas para o seu sistema, a partir da sua distribuição ou fornecedor. - -Alguns destes pacotes estão divididos em bibliotecas, programas ou utilitários e pacotes de desenvolvimento. Você irá precisar pelo menos do programa ou biblioteca e do seu pacote de desenvolvimento. Se você tiver dúvidas, instale tudo. As bibliotecas que necessita irão variar de acordo com os módulos que pretende compilar, uma vez que cada módulo tem os seus próprio requisitos. O Guia de Compilação do Código do &kde; Passo-a-Passo possui mais detalhes sobre as ferramentas e técnicas específicas usadas para instalar e encontrar o 'software' necessário. - -Você poderá já ter uma versão do programa &tdesvn-build; instalada no seu sistema. O &tdesvn-build; exije que você crie um arquivo de configuração chamado .tdesvn-buildrc. Este arquivo deverá ser instalado na pasta pessoal (~/), e contém todos os dados de configuração necessários para o programa rodar, como as opções de configuração, compilação, a localização do código, o destino da instalação (prefixo), os módulos que serão compilados, &etc;. Os dados de configuração por padrão são oferecidos pelo arquivo tdesvn-buildrc-sample. Você poderá encontrar mais informações sobre a sintaxe do arquivo de configuração em e . - -Uma boa forma de obter a última versão é escolher a página 'tdesdk/scripts' da página Web do websvn.kde.org. Você verá uma lista dos arquivos disponíveis na pasta 'tdesdk/scripts' do repositório de &svn; do &kde;. Clique na ligação do &tdesvn-build; e transfira a última versão do programa. Faça o mesmo para o arquivo tdesvn-buildrc-sample. Torne o programa executável e verifique se está na sua PATH. - - - - -Definindo os Dados de Configuração - -Para usar o programa, você deverá ter um arquivo na sua pasta pessoal chamado .tdesvn-buildrc, que define as opções gerais e os módulos que deseja transferir e compilar. - -Use o arquivo tdesvn-buildrc-sample como modelo, defina as opções globais e os módulos que deseja compilar. - -Selecione o servidor de onde deseja obter o &svn;, definindo a opção global 'svn-server'. O valor padrão é o servidor &svn; anónimo, o svn://anonsvn.kde.org/, mas fique à vontade para alterá-lo se tiver uma conta de &svn; do &kde; ou, se existir, um servidor espelho perto de você. - -Preste bastante atenção às variáveis globais 'tdedir' e 'qtdir', uma vez que a primeira define onde o seu &kde; irá ser instalado (por padrão em ~/kde), e o segundo diz onde (e se) a sua biblioteca Qt irá ser compilada e instalada, (por padrão em ~/tdesvn/build/qt-copy). Você terá que saber mais tarde a localização da 'tdedir' e da 'qtdir', para configurar as variáveis de ambiente que são necessárias para executar a sua nova instalação. Verifique se os módulos indicados são, de fato, os módulos que pretende compilar. As opções padrão do arquivo tdesvn-buildrc-sample deverão ser suficientes para obter uma instalação relativamente completa do &kde;. Salve o resultado como .tdesvn-buildrc na sua pasta pessoal. - -Se você desejar fazer um ajuste fino do seu arquivo .tdesvn-buildrc, consulte o para obter informações mais detalhadas sobre todas as opções de configuração. - - - - -Usando o 'script' &tdesvn-build; - -Agora você está pronto para executar o programa. A partir de uma janela de terminal, autentique-se com o usuário que usará para compilar o &kde; e execute o programa: %su usuário -%tdesvn-build - - - -Agora, o programa deverá começar a obter o código-fonte e a compilá-lo. É pouco provável que corra tudo bem da primeira vez que compilar o &kde;. Não se desespere! Verifique os arquivos de registro para ver se falta alguma ferramenta ou pacote de desenvolvimento (a localização dos arquivos de registro é definida pela variável 'log-dir' no arquivo de configuração). Algumas vezes, a ramificação de desenvolvimento principal fica muito instável e difícil de compilar, principalmente quando está próximo de um congelamento do desenvolvimento. Tenha paciência. Você poderá descobrir mais exemplos comuns das coisas que poderão correr mal e as suas soluções, assim como dicas e estratégias gerais para compilar o &kde; no Guia de Compilação do Código do &kde; Passo-a-Passo. - - - - -Configurando o Ambiente para Executar o seu &kde; Novo - -Assumindo que você está usando um usuário dedicado para compilar o &kde; e já possui uma versão do &kde; instalada, a execução do seu &kde; novo precisará de alguns truques, uma vez que o &kde; novo terá de ter precedência sobre o antigo. Mude as variáveis de ambiente para garantir que isso aconteça. - -Abra ou crie o arquivo .bash_profile na sua pasta pessoal com o seu editor favorito e adicione o seguinte ao fim do arquivo: -TDEDIR=(local do tdedir) -TDEDIRS=$TDEDIR -PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH -LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH -export TDEDIRS PATH LD_LIBRARY_PATH - Se estiver compilando o módulo 'qt-copy', adicione em alternativa: TQTDIR=(local do qtdir) -TDEDIR=(local do tdedir) -TDEDIRS=$TDEDIR -PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH -MANPATH=$TQTDIR/doc/man:$MANPATH -LD_LIBRARY_PATH=$TDEDIR/lib:$TQTDIR/lib:$LD_LIBRARY_PATH -export TQTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH - - - -Se você não estiver usando um usuário dedicado, defina um novo $TDEHOME para o seu novo ambiente no seu arquivo .bash_profile: export TDEHOME="${HOME}/.tde-svn" - -# Criar a pasta se necessário -[ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn - - - - -Se, mais tarde, o seu menu estiver vazio ou completamente cheio de aplicações da sua distribuição, você poderá ter que definir as suas variáveis de ambiente do 'xdg' no seu .bash_profile: XDG_CONFIG_DIRS="/etc/xdg" -XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" -export XDG_CONFIG_DIRS XDG_DATA_DIRS - - - - - -Agora que terminou o que tinha para fazer, certifique-se que será usado o starttde correto: - -Abra o arquivo de texto .xinitrc (ou o .xsession, dependendo da distribuição) da pasta pessoal, ou crie-o se necessário. Adicione a linha: exec ${TDEDIR}/bin/starttde - - - -Agora inicie o seu &kde; novo: nos sistemas BSD e Linux, com o suporte para terminais virtuais, os atalhos Ctrl+Alt+F1...F12 são usados para mudar para o Console Virtual 1 a 12. Isto permite-lhe executar mais de um ambiente gráfico ao mesmo tempo. Os primeiros seis são terminais de texto e os seis seguintes são gráficos. - -Quando você inicializa, é exibido um gerenciador gráfico, em alternativa. Você poderá usar o novo ambiente do KDE, mesmo que não apareça como opção. Pressione Ctrl + Alt + F2, para que apareça um terminal de texto. Autentique-se com o usuário dedicado e digite: - -startx -- :1 - - - -Você poderá executar o KDE a partir do código e o KDE antigo ao mesmo tempo! Autentique-se com o seu usuário normal e inicie o ambiente do KDE estável. Pressione Ctrl + Alt + F2 (ou F1, F3, etc..), para que apareça um terminal de texto. Logue-se com o usuário dedicado e digite "startx -- :1". Você poderá voltar ao usuário normal, pressionando Ctrl + Alt + F6 (Ou F7, F8, etc... Experimente! Um deles é o correto.) Para voltar ao KDE a partir do código, pressione Ctrl + Alt + F7 (ou F6, F8,etc..). Agora você poderá mudar entre as suas versões do KDE e testar a nova, sabendo que poderá voltar rapidamente à segurança do ambiente estável do KDE. - - - - - - - - -Funcionalidades do Programa - -As funcionalidades do &tdesvn-build; incluem: - - - - -Obtém ou atualiza automaticamente os módulos do &svn;, conforme necessário. - -Agenda o processo de compilação dos módulos. - -Tenta automaticamente compilar de novo os módulos que foram compilados com o 'make' incremental, que está sujeito a erros ao fim de algumas modificações. - -Poderá retomar uma execução anterior ou iniciar o processo de compilação de um determinado módulo. - -Vem com um conjunto seguro de opções padrão, apropriadas para compilar uma instalação mono-usuário básica do &kde; a partir do repositório de &svn; anónimo. - -Vem com suporte para o Unsermake. - -Expansão do til (~) para as suas opções de configuração. Por exemplo, você poderá especificar: qtdir ~/tdesvn/build/qt-copy - - -Pastas configuráveis para compilação, para o código-fonte e para registros. - -Configura automaticamente um sistema de compilação com uma pasta de compilação diferente da pasta de código, para manter intocávela pasta de código. A única exceção é o qt-copy, que não está desenhado para ser compilado dessa forma (a menos que queira testar o truque do Qt com uma pasta de compilação separada). - -Você poderá indicar as opções globais a aplicar a todos os módulos a serem obtidos, assim como poderá indicar opções para serem aplicadas aos módulos individualmente. - -Uma vez que as ferramentas 'auto*' normalmente perdem a sincronização com as modificações na árvore de código, você poderá forçar uma nova compilação de um módulo, se criar um arquivo chamado '.refresh-me' na pasta de compilação do módulo em questão ou executando o &tdesvn-build; com a opção . - -Você poderá indicar vários valores de ambiente a usar durante a compilação, incluindo o TDEDIR, o TQTDIR, o DO_NOT_COMPILE e o CXXFLAGS. - -Registro dos comandos. Os arquivos de registro são datados e numerados, para que você tenha sempre um relatório de execução de um programa. Do mesmo modo, é criada uma ligação simbólica 'latest' para apontar sempre para o item de registro mais recente na respectiva pasta. - -Se você estiver usando uma compilação de usuário do &kde;, em vez de uma instalação do sistema (para a qual precisa ser o 'root' para instalar), você poderá usar o programa para instalá-lo para você. O código não foi ainda validado e ele faz uma utilização ampla da chamada system(), assim, eu não recomendo executá-lo como 'root' por enquanto. - -Você poderá usar o make-install-prefix para anteceder o comando 'make install' com um comando separado, o que poderá ser útil para o 'sudo'. - -Você poderá usar a opção apidox para compilar e instalar automaticamente a documentação da API para alguns módulos. - -Você poderá obter apenas uma parte de um módulo do &kde; no &svn;. Por exemplo, poderá obter apenas a biblioteca taglib do tdesupport ou apenas o K3B do extragear/multimedia. O programa irá obter automaticamente o kde-common, se for necessário para fazer a compilação funcionar. - -Você poderá fingir efetuar as operações. Se passar a opção ou na linha de comando, o programa fornecerá uma descrição mais completa dos comandos que está prestes a executar, sem executá-los de fato. - -Suporte para obter ramificações ('branches') específicas dos módulos do &svn;. Este trabalho ainda precisa ser finalizado, mas você já poderá selecionar a ramificação que pretende compilar com a opção de configuração 'module-base-path'. - - - -As coisas que o &tdesvn-build; NÃO faz: - - - -Descobrir a réplica do &svn; do &kde; mais rápida. Não existe sequer uma lista acompanhando o programa atualmente, ainda que o servidor padrão deva funcionar perfeitamente. - -Escovar os seus dentes. Você deve lembrar de fazer isso você mesmo. - -O programa, provavelmente, não está livre de erros. Desculpe por isso. - - - - - - -O Formato do '.tdesvn-buildrc' - -Para usar o programa, você deverá ter um arquivo na sua pasta pessoal .tdesvn-buildrc, que descreve os módulos que deseja obter e compilar. - - - -Ele começa com as opções globais, indicadas da seguinte forma: - -global -nome-opção valor-opção -[...] -end global - - -Segue-se então uma ou mais seções dos módulos, organizadas da seguinte forma: - -module nome-módulo -nome-opção valor-opção -[...] -end module - - -O nome-módulo deverá ser um módulo do repositório de &svn; do &kde; (por exemplo, o 'tdelibs' ou o 'tdebase'). Algumas das opções sobrepõem-se às globais, algumas adicionam-se às opções globais e algumas opções globais simplesmente não podem ser sobrepostas. - -Segue-se uma lista ordenada alfabeticamente das opções que poderá usar. Clique na opção para descobrir mais sobre ela. Se alguma não estiver documentada, envie por favor um e-mail aos autores, usando o endereço que poderá encontrar acima. - - -apidox, para compilar a Documentação da API -apply-qt-patches, para melhorar o 'qt-copy' -binpath, para definir a variável PATH. -branch, para obter uma determinada ramificação, em vez da '/trunk'. -build-dir, para definir a pasta onde será feita a compilação. -checkout-only, para transferir apenas as partes de um módulo. -colorful-output para colorir o resultado do programa. -configure-flags para definir as opções com que um módulo poderá ser configurado. -cxxflags para definir a variável CXXFLAGS. -dest-dir para mudar a pasta de instalação de um módulo. -disable-agent-check, para impedir que o 'tdesvn-build' verifique o estado do 'ssh-agent'. -do-not-compile, para marcar as pastas que não serão compiladas. -inst-apps, para só compilar e instalar algumas pastas. -install-after-build, para evitar a instalação após o processo de compilação. -tdedir, para indicar a pasta onde o KDE será instalado. -libpath, para configurar a variável LD_LIBRARY_PATH. -make-install-prefix, para executar um programa auxiliar (como o 'sudo') durante o 'make install'. -make-options, para passar opções ao programa 'make'. -manual-build, para evitar que o módulo seja compilado automaticamente. -manual-update, para evitar que seja feito, seja o que for, ao módulo de forma automática. -module-base-path, para mudar o local de onde transferir o módulo (útil para as ramificações - 'branches' -, e marcas - 'tags'). -niceness, para mudar a prioridade da CPU. -no-rebuild-on-fail, para evitar a execução do 'make' novamente se algo falhar. -qtdir, para definir a localização do Qt. -set-env, para configurar uma variável de ambiente. -source-dir, para mudar o local onde colocar o código transferido. -stop-on-failure, para fazer com que o 'tdesvn-build' pare o mais cedo possível, após encontrar um problema. -svn-server, para mudar o servidor de onde é transferido o código. -use-qt-builddir-hack, para dar ao Qt uma pasta de compilação diferente da do seu código, como acontece no KDE. -use-unsermake, para usar o sistema de compilação avançado, o 'unsermake'. - - - -Aqui está uma tabela com as opções globais, bem como alguns comentários sobre elas. As opções que se sobreporem às globais irão também sobrepor-se a uma configuração da linha de comando. - - -Tabela de Opções - - - - -Nome da Opção -Comportamento do Módulo -> Global -Notas - - - - - - -apidox -Sobrepõe-se à global -Configure esta opção como true, para que o &tdesvn-build; compile e instale automaticamente a documentação da API do módulo, após o processo de compilação/instalação normal. Isto só funciona para os módulos em que o make apidox faz alguma coisa, e que incluem o 'tdelibs', 'tdebase' e o 'koffice', entre outros. - - - -apply-qt-patches -Sobrepõe-se à global -Esta opção só é útil para o 'qt-copy'. Se for um valor diferente de zero, então o programa 'apply-patches' do 'qt-copy' será executado antes da compilação, para aplicar as alterações não oficiais no 'qt-copy'. Uma vez que estas alterações são normalmente a razão para usar o 'qt-copy', em vez de um Qt oficial, não deverá haver qualquer problema em ativá-las. Por padrão, está ativada a aplicação destas modificações. - - - -binpath -Não poderá ser sobreposta -Ative esta opção para modificar a variável de ambiente PATH durante a compilação. Não poderá sobrepor esta opção numa opção do módulo. O valor padrão é o /bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin. Esta variável de ambiente deverá incluir os locais, separados por dois-pontos das suas ferramentas de desenvolvimento. Os locais $TDEDIR/bin e $TQTDIR/bin são adicionados automaticamente. Você poderá usar o til (~) para os locais que adicionar com esta opção. - - - - -branch -Sobrepõe-se à global -Altere esta opção para obter uma ramificação do KDE, em vez do valor por padrão "trunk", onde o desenvolvimento do KDE está em curso. Por exemplo, para obter a ramificação do KDE 3.4, você deverá configurar esta opção como "3.4". -Lembre-se que alguns módulos usam um nome de ramificação diferente. Notavelmente,o módulo obrigatório 'arts' não segue os números de versões do KDE. O 'arts' que acompanhava o KDE 3.4 era o 1.4. -Se o 'tdesvn-build' não conseguir obter adequadamente uma ramificação com esta opção, você poderá ter de indicar manualmente o URL de onde transferir, com a opção override-url. - - - - -build-dir -Sobrepõe-se à global -Use esta opção para mudar a pasta que contém o código compilado. Existem três formas diferentes de usá-la: Relativa à pasta de código do &kde; no &svn; (ver a opção 'source-dir'). Esta é a opção padrão e a forma como funcionou o programa até à versão v0.61. Este modo fica selecionado se digitar o nome de uma pasta que não comece por um til (~) ou uma barra (/). O valor padrão é build. Um local absoluto. Se indicar um local que comece por um /, então será usado esse local diretamente. Por exemplo, o /tmp/kde-obj-dir/. Relativo à sua pasta pessoal. Se indicar uma pasta que comece com um '~', então o local será usado em relação à sua pasta pessoal, de forma semelhante à expansão do til da linha de comando. Por exemplo, o ~/builddir irá configurar a pasta de compilação como /home/usuário/builddir. Surpreendentemente, esta opção poderá ser alterada por módulo. - - - -checkout-only -Sobrepõe-se à global -Altere esta opção para obter o código do &svn; passo-a-passo. O valor desta opção deverá ser uma lista separada por espaços das pastas a transferir. Se não incluir a pasta 'admin', ela será incluída automaticamente (se necessário). Ao transferir passo-a-passo, a pasta 'admin' será obtida do 'kde-common', que é onde se encontra no servidor do &svn;. Ainda que esta opção se sobreponha à global, observe que esta opção, como global, não faz sentido. - - - -configure-flags -Adiciona às opções globais (exceto no 'qt-copy') -Use esta opção para indicar quais opções passar ao './configure' quando criar o sistema de compilação do módulo. Quando isto é usado como uma opção global, é aplicada a todos os módulos onde este programa se compila. O 'qt-copy' usa um conjunto muito diferente de opções do 'configure' do resto do &kde;, assim esta opção sobrepõe as opções globais, quando é aplicada ao 'qt-copy'. - - - -colorful-output -Não poderá ser sobreposta -Configure esta opção como 'false' para desativar o resultado colorido do &tdesvn-build;. Por padrão é true. Lembre-se que o &tdesvn-build; não irá mostrar os códigos de cores em nada que não seja um terminal (como o 'xterm', o &konsole; ou o console normal do Linux). - - - -cxxflags -Adiciona-se à opção global -Use esta opção para indicar as opções a passar ao ./configure como CXXFLAGS, ao criar o sistema de compilação do módulo. Esta opção é indicada aqui em vez do configure-flags, uma vez que esta opção irá também definir a variável de ambiente CXXFLAGS durante o processo de compilação. - - - -dest-dir -Sobrepõe-se à global -Use esta opção para mudar o nome que é dado a um módulo no disco. Por exemplo, se o seu módulo se chamava 'extragear/network', você poderá mudar o nome do mesmo para 'extragear-network' com esta opção. - - - -disable-agent-check -Não poderá ser sobreposta -Normalmente, se você estiver usando o SSH para obter o código do Subversion (se, por exemplo, estiver usando o protocolo 'svn+ssh'), o 'tdesvn-build' irá tentar certificar-se que, se estiver usando o 'ssh-agent', ele está de fato gerenciando algumas identidades do SSH. Isto é para tentar evitar que o SSH pergunte a sua frase-senha para todos os módulos. Você poderá desativar esta opção se ativar a opção 'disable-agent-check' como 'true'. - - - -do-not-compile -Sobrepõe-se à global -Use esta opção para definir a variável de ambiente DO_NOT_COMPILE antes de executar o programa 'configure'. De acordo com a FAQ de Desenvolvimento do &kde;, este deverá ser o caso de uma pasta de topo que não deseje compilar. As pastas deverão estar separadas por espaços. - -Lembre-se que o código dos programas será ainda transferido. Você poderá usar a instrução checkout-only para escolher as pastas que deseja obter. - - - - -email-address -Não poderá ser sobreposta - -Configure esta opção com o endereço de e-mail que o 'tdesvn-build' deverá usar, no caso de precisar alguma vez enviar mensagens. Você não terá que se preocupar com isto se não usar qualquer funcionalidade que envie e-mails. (Elas estão todas desativadas por padrão). - -Atualmente, somente o email-on-compile-error necessita desta opção. - - - - -email-on-compile-error -Não poderá ser sobreposta - -Você poderá configurar esta opção com o endereço de e-mail para onde enviar um relatório, sempre que um módulo não conseguir ser compilado. O 'tdesvn-build' irá esperar até que todos os módulos terminem e irá recolher todos os resultados no relatório. Este relatório só é enviado se um módulo se recusar a compilar. - -Por favor, veja a opção email-address para configurar o endereço de onde o 'tdesvn-build' irá enviar, uma vez que o valor padrão não é normalmente o que você deseja. - - - - -inst-apps -Sobrepõe-se à global -Isto é o oposto da opção do-not-compile. Serve para indicar que apenas as pastas de topo referidas serão compiladas. As pastas deverão estar separadas por espaços. - -As alterações não farão efeito até à próxima vez que o make Makefile.cvs seja executado, quer automaticamente pelo programa, quer manualmente pelas opções ou . - -Lembre-se que o código dos programas será ainda transferido. Você poderá usar a instrução checkout-only para escolher as pastas que deseja obter. - - - - -install-after-build -Sobrepõe-se à global -Esta opção é usada para instalar o pacote depois dele ser compilado com sucesso. Esta opção está ativa por padrão. Se quiser desativá-la, terá que configurar esta opção como 0 no arquivo de configuração. Você poderá também usar a opção da linha de comando . - - - -tdedir -Não poderá ser sobreposta -Esta opção define a pasta em que o &kde; será instalado após a compilação. Por padrão, será em ~/kde. Se mudar isto para uma pasta que precise do acesso do 'root', será útil também ler algumas informações sobre a opção make-install-prefix. - - - -libpath -Não poderá ser sobreposta -Configure esta opção para definir a variável de ambiente LD_LIBRARY_PATH, enquanto efetua a compilação. Você não poderá sobrepor esta opção num módulo. O valor padrão está em branco, mas os locais $TDEDIR/lib e $TQTDIR/lib são adicionados automaticamente. Você poderá usar o til (~) para os locais que adicionar com esta opção. - - - -log-dir -Sobrepõe-se à global -Use esta opção para mudar a pasta que irá conter os arquivos de registro gerados pelo programa. Esta opção poderá ser definida para cada módulo, a partir da versão 0.64. - - - -make-install-prefix -Sobrepõe-se à global -Configure esta variável com uma lista separada por espaços, que será interpretada como um comando e as suas opções, para anteceder o comando 'make install', que é usado para instalar os módulos. Isto é útil para instalar os pacotes com o 'sudo', por exemplo, mas tenha cuidado ao trabalhar com os privilégios do 'root'. - - - -make-options -Sobrepõe-se à global -Configure esta variável para passar as opções da linha de comando ao comando 'make'. Isto é útil para os programas, como o distcc. O distcc permite-lhe compartilhar o seu trabalho de compilação em mais de um computador. Para usá-lo, deverá usar a opção do 'make'. Agora você já pode. De acordo com a documentação, recomenda-se '2 * número_de_cpus_na_rede'. Eu tenho 1 CPU, assim devo usar no meu caso. - - - -manual-build -Sobrepõe-se à global -Configure o valor da opção como true para evitar que o processo de compilação tente compilar este módulo. Ele ainda será mantido atualizado ao atualizar a partir do &svn;. Esta opção é exatamente equivalente à opção da linha de comando . - - - -manual-update -Sobrepõe-se à global -Configure o valor da opção como true para evitar que o processo de compilação tente atualizar (e, por conseguinte, compilar ou instalar) este módulo. Se definir esta opção para um módulo, também poderá tê-la comentada. - - - -module-base-path -Sobrepõe-se à global -Configure esta opção para se sobrepor à pasta padrão do &tdesvn-build; para o módulo em questão. Isto poderá ser usado, por exemplo, para usar ramificações ou marcas específicas de determinadas bibliotecas. O Visualizador de Código do &kde; é extremamente valioso para ajudá-lo a escolher o local correto. -Lembre-se que o &tdesvn-build; constrói o local final de acordo com o seguinte modelo: $svn-server/home/kde/$module-base-path/$module-name. -O valor padrão tanto pode ser o trunk como o trunk/KDE, dependendo do nome do módulo. - - - - -niceness -Não poderá ser sobreposta -Configure esta opção com um valor entre 20 e 0. Quanto mais alto o número, menor prioridade terá o &tdesvn-build;. O valor padrão é 10. - - - -no-rebuild-on-fail -Sobrepõe-se à global -Configure o valor desta opção como true para evitar que o &tdesvn-build; sempre tente compilar de novo este módulo, se falhar numa compilação incremental. Normalmente, o &tdesvn-build; irá tentar compilar de novo o módulo do zero, para lidar com o efeito de uma atualização do &svn; inválida que confunda o sistema de compilação. - - - -override-url -Sobrepõe-se à global -Se configurar esta opção, o 'tdesvn-build' irá usar o seu valor como o URL a passar ao Subversion, sem qualquer alteração. Você deverá usar geralmente esta opção, se quiser obter uma versão específica, mas o 'tdesvn-build' não conseguir descobrir o que queria dizer ao usar a opção branch. - - - -qtdir -Não poderá ser sobreposta -Configure esta opção para definir a variável de ambiente TQTDIR enquanto compila. Você poderá sobrepor esta configuração numa opção de um módulo. Se não indicar esta opção, será por padrão a $(source-dir)/build/qt-copy, que irá usar o módulo 'qt-copy' que está incluído no repositório de código do &kde;. Você poderá usar um til (~) que representa a sua pasta pessoal. - - - -remove-after-install -Sobrepõe-se à global -Se estiver com pouco espaço em disco, você poderá querer usar esta opção para remover automaticamente a pasta de compilação (ou as pastas de compilação e de código, para instalações episódicas), após o módulo ter sido instalado com sucesso. -Os valores possíveis para esta opção são: -none - Não remove nada (Este é o valor padrão). -builddir - Remove a pasta de compilação, mas não o código. -all - Remove tanto o código-fonte como a pasta de compilação. - - - -Lembre-se que a utilização desta opção poderá ter um grande impacto na utilização da sua largura de banda (se usar o 'all') e o tempo que dura a compilação do KDE, uma vez que o 'tdesvn-build' será incapaz de efetuar compilações incrementais. - - - - -set-env -Sobrepõe-se à global -Esta opção aceita um conjunto de valores separados por espaços, onde o primeiro valor é a variável de ambiente a definir e o resto dos valores é o que deseja atribuir à sua variável. Por exemplo, para configurar a variável RONALD como McDonald, você deve colocar este comando na seção apropriada: -set-env RONALD McDonald -Esta opção é especial, na medida em que poderá ser repetida sem sobrepor a configuração anterior do 'set-env' na mesma seção do arquivo de configuração. Desta forma, você poderá definir mais de uma variável de ambiente por módulo (ou a nível global). - - - - -source-dir -Não poderá ser sobreposta -Esta opção é usada para definir a pasta do seu computador onde será guardado o código-fonte do &svn; do &kde;. Se não indicar este valor, será usado o valor padrão ~/tdesvn. Se você especificar este valor, use um local absoluto. - - - -svn-server -Não poderá ser sobreposta -Esta opção é usada para definir o servidor usado para obter o código do &svn;. Por padrão, é usado o repositório anónimo de &svn;, em svn://anonsvn.kde.org/ - - - -stop-on-failure -Sobrepõe-se à global -Configure o valor desta opção como true para fazer com que o programa pare a execução, após ocorrer um erro durante o processo de compilação ou instalação. Esta opção está desativada por padrão. - - - -tag -Sobrepõe-se à global -Use esta opção para obter uma versão específica de um módulo. -NOTA: É muito provável que você NÃO QUEIRA usar esta opção. As versões do KDE lançadas estão disponíveis em pacotes compactados no servidor de FTP do KDE ou em um dos servidores espelho. -Se você estiver usando o 'tdesvn-build' porque está com problemas para obter uma versão do KDE para compilar na sua distribuição, pense em usar a ferramenta de compilação Konstruct em alternativa, que funciona a partir dos pacotes de lançamento. - - - - -use-qt-builddir-hack -Sobrepõe-se à global -Ainda que esta opção se sobreponha à global, só fará sentido para o 'qt-copy'. Configure esta opção como true para ativar o modo experimental de 'srcdir' != 'builddir'. Se estiver ativada, o &tdesvn-build; irá copiar o módulo de código do 'qt-copy' para a pasta de compilação e efetuar as compilações a partir daí. Isto significa que a sua variável de ambiente TQTDIR ficará igual a $(qt-copy-build-dir)/qt-copy/lib em alternativa. Você deverá também mudar a sua opção qtdir em função disso. O 'make' incremental deverá ainda funcionar neste modo, uma vez que as datas serão preservadas após a cópia. Se usar a opção apply-qt-patches, as atualizações serão aplicadas na pasta de compilação, não na pasta de código. Esta opção é igual a true, por padrão. - - - -use-unsermake -Sobrepõe-se à global -Configure esta opção como true para poder usar o programa experimental 'unsermake' em vez do 'automake' ao rodar o programa 'configure'. Isto poderá levar a uma diminuição significativa no tempo da compilação, principalmente no caso dos sistemas de compilação distribuídos. Esta opção é, por padrão, true (para a maioria dos módulos). - -Normalmente, se usar esta opção, o 'tdesvn-build' irá manter automaticamente o 'unsermake' atualizado. Isto poderá começar a ser incómodo, principalmente se estiver gerenciando você mesmo o 'unsermake'. Se for este o caso, você poderá configurar esta opção como self, fazendo com que o 'tdesvn-build' ainda use o 'unsermake', mas não faça nada de especial para mantê-lo atualizado. - - - - - - -
- - - - -Opções da Linha de Comando e Variáveis de Ambiente - -Este programa não usa variáveis de ambiente. Se você precisar definir variáveis de ambiente para o ambiente de compilação ou de instalação, veja a opção set-env. - -O programa aceita as seguintes opções da linha de comando: - - - - - -mostra apenas uma ajuda simples deste programa. - - - - -mostra a versão do programa. - - - - -mostra as informações de contato do autor. - - - - -ativa o resultado do programa à cores. - - - - -desativa o resultado do programa à cores. - - - - (ou ) -não faz NADA de fato, mas funciona como se você fizesse. - - - - (ou ) -Não é tão descritivo com o resultado exibido pela compilação. Com esta opção, somente as mensagens básicas são apresentadas. - - - - -Só mostra as mensagens de avisos e erros. - - - - -Torna-se bastante descritivo com o que está acontecendo e o que o 'tdesvn-build' está fazendo. - - - - -efetua apenas a atualização do código. - - - - -efetua apenas o processo de compilação. - - - - -não inclui os módulos passados no resto da linha de comando no processo de atualização/compilação. - - - - -ignora o passo de contacto do servidor do &svn;. - - - - -salta o processo de compilação. - - - - -não instala automaticamente os pacotes, após a sua compilação. - - - - -ativa o modo de depuração para o programa. Atualmente, isto significa que todo o resultado será enviado para o STDOUT, além de ficar registrado na pasta de registro normalmente. Do mesmo modo, muitas das funções tornar-se-ão mais descritivas sobre o que estão fazendo no modo de depuração. - - - - -não tenta compilar de novo os módulos que não conseguiram ser compilados do zero. O &tdesvn-build; nunca irá tentar fazer isto num módulo que já se tentou compilar do zero. - - - - -recria o sistema de compilação e compila a partir do zero. - - - - -executa o programa 'configure' novamente sem limpar a pasta de compilação. - - - - -executa o make Makefile.cvs novamente para criar o programa 'configure' e continua a compilação normalmente. Esta opção implica a . - - - - -tenta continuar a compilação a partir do ponto em que o programa parou da última vez. O programa começa a compilar o módulo, após o último ter sido compilado da última vez em que o programa foi executado, quer tenha corrido bem ou não. Esta opção implica a . Você não deverá indicar os nomes de outros módulos na linha de comando. - - - - -é semelhante à opção , exceto que você indica qual o módulo de onde começar a compilação como parâmetro a seguir na linha de comando. Esta opção implica a . Você não deverá indicar os nomes dos outros módulos na linha de comando. - - - - -interpreta o próximo parâmetro da linha de comando como o arquivo de onde ler as opções de configuração. O valor padrão deste parâmetro é '~/.tdesvn-buildrc'. - - - - -permite-lhe mudar a pasta onde o &kde; será instalado na linha de comando. Esta opção implica a . - - - - -pára após a execução do make Makefile.cvs. O programa 'configure' precisará ainda ser executado, coisa que o &tdesvn-build; irá fazer da próxima vez. Isto permite-lhe preparar todos os programas 'configure' de uma vez, para que você possa ver o ./configure de cada módulo e editar as suas opções do 'configure' adequadamente. - - - -Se esta for a única opção da linha de comando, ele irá tentar instalar todos os módulo incluídos em 'successfully-built', exceto o 'qt-copy', que não precisa de instalação. Se as opções da linha de comando forem indicadas após o , então assumem-se que são módulos para instalar. - - - - -Você poderá usar esta opção para sobrepor outra opção no seu arquivo de configuração para todos os módulos. Por exemplo, para sobrepor a opção log-dir, deverá digitar: . - - - - -Você poderá usar esta opção para sobrepor uma opção do seu arquivo de configuração para um determinado módulo. Por exemplo, para sobrepor a opção use-unsermake do 'tdemultimedia', você deveria digitar: . - - - - -Todas as outras opções da linha de comando assumem-se como sendo módulos para atualizar e compilar. Por favor, não misture a compilação com a instalação. - - - - -Créditos e Licenças -&underFDL; - - diff --git a/tde-i18n-pt_BR/docs/tdesdk/tdesvn-build/CMakeLists.txt b/tde-i18n-pt_BR/docs/tdesdk/tdesvn-build/CMakeLists.txt new file mode 100644 index 00000000000..cbf32c9a4a0 --- /dev/null +++ b/tde-i18n-pt_BR/docs/tdesdk/tdesvn-build/CMakeLists.txt @@ -0,0 +1,6 @@ +# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer + +tde_create_handbook( + DESTINATION tdesvn-build + LANG pt_BR +) diff --git a/tde-i18n-pt_BR/docs/tdesdk/tdesvn-build/Makefile.am b/tde-i18n-pt_BR/docs/tdesdk/tdesvn-build/Makefile.am new file mode 100644 index 00000000000..8c9276fea9d --- /dev/null +++ b/tde-i18n-pt_BR/docs/tdesdk/tdesvn-build/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = pt_BR +SUBDIRS = $(AUTODIRS) +KDE_DOCS = tdesvn-build +KDE_MANS = AUTO diff --git a/tde-i18n-pt_BR/docs/tdesdk/tdesvn-build/index.docbook b/tde-i18n-pt_BR/docs/tdesdk/tdesvn-build/index.docbook new file mode 100644 index 00000000000..f94a9709930 --- /dev/null +++ b/tde-i18n-pt_BR/docs/tdesdk/tdesvn-build/index.docbook @@ -0,0 +1,739 @@ + + + + + + Subversion"> + tdesvn-build"> +]> + + + + +Manual do 'Script' &tdesvn-build; + + +MichaelPyne
michael.pyne@kdemail.net
 + +CarlosWoelz
carloswoelz@imap-mail.com
 + + + +MarcusGama
marcus.gama@gmail.com
Tradução + + + + +2005 +Michael Pyne + + + +2005 +Carlos Woelz + + + +&FDLNotice; + +2005-06-18 +0.98 + + +O &tdesvn-build; é um programa em Perl que compila e instala o &kde; diretamente a partir do código existente no repositório de &svn; do &kde;. + + + +KDE +tdesdk +SVN +Subversion +Desenvolvimento KDE + + + + + + +Introdução + +O &tdesvn-build; é um programa em Perl que ajuda os usuários a instalar o &kde; a partir do &svn;. Você pode também querer considerar o programa 'kde-build' que vem incluído no módulo 'tdesdk' do &kde;. + +Aqui será documentado a sintaxe opções do arquivo de configuração do &tdesvn-build;, as suas opções da linha de comando, as funcionalidades e uma introdução a todos os passos necessários para compilar o &kde; a partir do código fonte, incluindo os passos que você deverá efetuar ao usar as outras ferramentas ou, em outras palavras, os passos que não são efetuados automaticamente pelo programa &tdesvn-build;. + + + + +Começando + +Neste capítulo, será apresentada a forma de utilização do &tdesvn-build; para obter os módulos do repositório do &kde; e compilá-los. Nós daremos também uma explicação básica da estrutura de &svn; do &kde; e os passos que você terá que efetuar antes de executar o programa. + +Todos os tópicos presentes neste capítulo são cobertos com ainda mais detalhe na seção Guia de Compilação do Código do &kde; Passo-a-Passo, na Página Web da Equipe de Qualidade do &kde;. Se você estiver compilando o KDE pela primeira vez, é uma boa idéia lê-lo ou consultá-lo como fonte de referência. Você irá encontrar informações detalhadas sobre as ferramentas de empacotamento e os requisitos, os problemas de compilação comuns e as estratégias e informações sobre a execução da instalação do seu novo &kde;. + + +Preparando o Sistema para Compilar o &kde; + +É recomendável que você transfira e compile o &kde; com uma conta de usuário. Se você já tiver os pacotes do &kde; instalados, a melhor opção será criar um usuário diferente (dedicado) para compilar e executar o novo &kde;. A vantagem de compilar o &kde; com um usuário dedicado é que você não poderá corromper o sistema base e terá sempre uma forma de trabalhar confortavelmente quando as coisas correrem mal. + +Mais tarde, você poderá fazer uma instalação como 'root' se desejar. Este documento não cobre uma instalação como 'root'. Se você estiver executando uma instalação a nível do sistema, provavelmente já deverá saber o que está fazendo. + +Antes de usar o programa &tdesvn-build; (ou qualquer outra estratégia de compilação), você deverá instalar as ferramentas de desenvolvimento e bibliotecas necessárias para o &kde;. Você precisará da biblioteca Qt, versão 3.3.0 ou posterior, do Automake 1.8, Autoconf 2.5X (melhor se >=2.57, uma vez que foi detectado um erro com as versões anteriores), o cliente do 'subversion' (svn), o compilador 'gcc' com o suporte de C++, a libxml2, o openssl, a libbz2 entre outras coisas (para uma lista completa, visite os Requisitos de Compilação do KDE). Você poderá obter normalmente estas ferramentas para o seu sistema, a partir da sua distribuição ou fornecedor. + +Alguns destes pacotes estão divididos em bibliotecas, programas ou utilitários e pacotes de desenvolvimento. Você irá precisar pelo menos do programa ou biblioteca e do seu pacote de desenvolvimento. Se você tiver dúvidas, instale tudo. As bibliotecas que necessita irão variar de acordo com os módulos que pretende compilar, uma vez que cada módulo tem os seus próprio requisitos. O Guia de Compilação do Código do &kde; Passo-a-Passo possui mais detalhes sobre as ferramentas e técnicas específicas usadas para instalar e encontrar o 'software' necessário. + +Você poderá já ter uma versão do programa &tdesvn-build; instalada no seu sistema. O &tdesvn-build; exije que você crie um arquivo de configuração chamado .tdesvn-buildrc. Este arquivo deverá ser instalado na pasta pessoal (~/), e contém todos os dados de configuração necessários para o programa rodar, como as opções de configuração, compilação, a localização do código, o destino da instalação (prefixo), os módulos que serão compilados, &etc;. Os dados de configuração por padrão são oferecidos pelo arquivo tdesvn-buildrc-sample. Você poderá encontrar mais informações sobre a sintaxe do arquivo de configuração em e . + +Uma boa forma de obter a última versão é escolher a página 'tdesdk/scripts' da página Web do websvn.kde.org. Você verá uma lista dos arquivos disponíveis na pasta 'tdesdk/scripts' do repositório de &svn; do &kde;. Clique na ligação do &tdesvn-build; e transfira a última versão do programa. Faça o mesmo para o arquivo tdesvn-buildrc-sample. Torne o programa executável e verifique se está na sua PATH. + + + + +Definindo os Dados de Configuração + +Para usar o programa, você deverá ter um arquivo na sua pasta pessoal chamado .tdesvn-buildrc, que define as opções gerais e os módulos que deseja transferir e compilar. + +Use o arquivo tdesvn-buildrc-sample como modelo, defina as opções globais e os módulos que deseja compilar. + +Selecione o servidor de onde deseja obter o &svn;, definindo a opção global 'svn-server'. O valor padrão é o servidor &svn; anónimo, o svn://anonsvn.kde.org/, mas fique à vontade para alterá-lo se tiver uma conta de &svn; do &kde; ou, se existir, um servidor espelho perto de você. + +Preste bastante atenção às variáveis globais 'tdedir' e 'qtdir', uma vez que a primeira define onde o seu &kde; irá ser instalado (por padrão em ~/kde), e o segundo diz onde (e se) a sua biblioteca Qt irá ser compilada e instalada, (por padrão em ~/tdesvn/build/qt-copy). Você terá que saber mais tarde a localização da 'tdedir' e da 'qtdir', para configurar as variáveis de ambiente que são necessárias para executar a sua nova instalação. Verifique se os módulos indicados são, de fato, os módulos que pretende compilar. As opções padrão do arquivo tdesvn-buildrc-sample deverão ser suficientes para obter uma instalação relativamente completa do &kde;. Salve o resultado como .tdesvn-buildrc na sua pasta pessoal. + +Se você desejar fazer um ajuste fino do seu arquivo .tdesvn-buildrc, consulte o para obter informações mais detalhadas sobre todas as opções de configuração. + + + + +Usando o 'script' &tdesvn-build; + +Agora você está pronto para executar o programa. A partir de uma janela de terminal, autentique-se com o usuário que usará para compilar o &kde; e execute o programa: %su usuário +%tdesvn-build + + + +Agora, o programa deverá começar a obter o código-fonte e a compilá-lo. É pouco provável que corra tudo bem da primeira vez que compilar o &kde;. Não se desespere! Verifique os arquivos de registro para ver se falta alguma ferramenta ou pacote de desenvolvimento (a localização dos arquivos de registro é definida pela variável 'log-dir' no arquivo de configuração). Algumas vezes, a ramificação de desenvolvimento principal fica muito instável e difícil de compilar, principalmente quando está próximo de um congelamento do desenvolvimento. Tenha paciência. Você poderá descobrir mais exemplos comuns das coisas que poderão correr mal e as suas soluções, assim como dicas e estratégias gerais para compilar o &kde; no Guia de Compilação do Código do &kde; Passo-a-Passo. + + + + +Configurando o Ambiente para Executar o seu &kde; Novo + +Assumindo que você está usando um usuário dedicado para compilar o &kde; e já possui uma versão do &kde; instalada, a execução do seu &kde; novo precisará de alguns truques, uma vez que o &kde; novo terá de ter precedência sobre o antigo. Mude as variáveis de ambiente para garantir que isso aconteça. + +Abra ou crie o arquivo .bash_profile na sua pasta pessoal com o seu editor favorito e adicione o seguinte ao fim do arquivo: +TDEDIR=(local do tdedir) +TDEDIRS=$TDEDIR +PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH +LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH +export TDEDIRS PATH LD_LIBRARY_PATH + Se estiver compilando o módulo 'qt-copy', adicione em alternativa: TQTDIR=(local do qtdir) +TDEDIR=(local do tdedir) +TDEDIRS=$TDEDIR +PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH +MANPATH=$TQTDIR/doc/man:$MANPATH +LD_LIBRARY_PATH=$TDEDIR/lib:$TQTDIR/lib:$LD_LIBRARY_PATH +export TQTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH + + + +Se você não estiver usando um usuário dedicado, defina um novo $TDEHOME para o seu novo ambiente no seu arquivo .bash_profile: export TDEHOME="${HOME}/.tde-svn" + +# Criar a pasta se necessário +[ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn + + + + +Se, mais tarde, o seu menu estiver vazio ou completamente cheio de aplicações da sua distribuição, você poderá ter que definir as suas variáveis de ambiente do 'xdg' no seu .bash_profile: XDG_CONFIG_DIRS="/etc/xdg" +XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" +export XDG_CONFIG_DIRS XDG_DATA_DIRS + + + + + +Agora que terminou o que tinha para fazer, certifique-se que será usado o starttde correto: + +Abra o arquivo de texto .xinitrc (ou o .xsession, dependendo da distribuição) da pasta pessoal, ou crie-o se necessário. Adicione a linha: exec ${TDEDIR}/bin/starttde + + + +Agora inicie o seu &kde; novo: nos sistemas BSD e Linux, com o suporte para terminais virtuais, os atalhos Ctrl+Alt+F1...F12 são usados para mudar para o Console Virtual 1 a 12. Isto permite-lhe executar mais de um ambiente gráfico ao mesmo tempo. Os primeiros seis são terminais de texto e os seis seguintes são gráficos. + +Quando você inicializa, é exibido um gerenciador gráfico, em alternativa. Você poderá usar o novo ambiente do KDE, mesmo que não apareça como opção. Pressione Ctrl + Alt + F2, para que apareça um terminal de texto. Autentique-se com o usuário dedicado e digite: + +startx -- :1 + + + +Você poderá executar o KDE a partir do código e o KDE antigo ao mesmo tempo! Autentique-se com o seu usuário normal e inicie o ambiente do KDE estável. Pressione Ctrl + Alt + F2 (ou F1, F3, etc..), para que apareça um terminal de texto. Logue-se com o usuário dedicado e digite "startx -- :1". Você poderá voltar ao usuário normal, pressionando Ctrl + Alt + F6 (Ou F7, F8, etc... Experimente! Um deles é o correto.) Para voltar ao KDE a partir do código, pressione Ctrl + Alt + F7 (ou F6, F8,etc..). Agora você poderá mudar entre as suas versões do KDE e testar a nova, sabendo que poderá voltar rapidamente à segurança do ambiente estável do KDE. + + + + + + + + +Funcionalidades do Programa + +As funcionalidades do &tdesvn-build; incluem: + + + + +Obtém ou atualiza automaticamente os módulos do &svn;, conforme necessário. + +Agenda o processo de compilação dos módulos. + +Tenta automaticamente compilar de novo os módulos que foram compilados com o 'make' incremental, que está sujeito a erros ao fim de algumas modificações. + +Poderá retomar uma execução anterior ou iniciar o processo de compilação de um determinado módulo. + +Vem com um conjunto seguro de opções padrão, apropriadas para compilar uma instalação mono-usuário básica do &kde; a partir do repositório de &svn; anónimo. + +Vem com suporte para o Unsermake. + +Expansão do til (~) para as suas opções de configuração. Por exemplo, você poderá especificar: qtdir ~/tdesvn/build/qt-copy + + +Pastas configuráveis para compilação, para o código-fonte e para registros. + +Configura automaticamente um sistema de compilação com uma pasta de compilação diferente da pasta de código, para manter intocávela pasta de código. A única exceção é o qt-copy, que não está desenhado para ser compilado dessa forma (a menos que queira testar o truque do Qt com uma pasta de compilação separada). + +Você poderá indicar as opções globais a aplicar a todos os módulos a serem obtidos, assim como poderá indicar opções para serem aplicadas aos módulos individualmente. + +Uma vez que as ferramentas 'auto*' normalmente perdem a sincronização com as modificações na árvore de código, você poderá forçar uma nova compilação de um módulo, se criar um arquivo chamado '.refresh-me' na pasta de compilação do módulo em questão ou executando o &tdesvn-build; com a opção . + +Você poderá indicar vários valores de ambiente a usar durante a compilação, incluindo o TDEDIR, o TQTDIR, o DO_NOT_COMPILE e o CXXFLAGS. + +Registro dos comandos. Os arquivos de registro são datados e numerados, para que você tenha sempre um relatório de execução de um programa. Do mesmo modo, é criada uma ligação simbólica 'latest' para apontar sempre para o item de registro mais recente na respectiva pasta. + +Se você estiver usando uma compilação de usuário do &kde;, em vez de uma instalação do sistema (para a qual precisa ser o 'root' para instalar), você poderá usar o programa para instalá-lo para você. O código não foi ainda validado e ele faz uma utilização ampla da chamada system(), assim, eu não recomendo executá-lo como 'root' por enquanto. + +Você poderá usar o make-install-prefix para anteceder o comando 'make install' com um comando separado, o que poderá ser útil para o 'sudo'. + +Você poderá usar a opção apidox para compilar e instalar automaticamente a documentação da API para alguns módulos. + +Você poderá obter apenas uma parte de um módulo do &kde; no &svn;. Por exemplo, poderá obter apenas a biblioteca taglib do tdesupport ou apenas o K3B do extragear/multimedia. O programa irá obter automaticamente o kde-common, se for necessário para fazer a compilação funcionar. + +Você poderá fingir efetuar as operações. Se passar a opção ou na linha de comando, o programa fornecerá uma descrição mais completa dos comandos que está prestes a executar, sem executá-los de fato. + +Suporte para obter ramificações ('branches') específicas dos módulos do &svn;. Este trabalho ainda precisa ser finalizado, mas você já poderá selecionar a ramificação que pretende compilar com a opção de configuração 'module-base-path'. + + + +As coisas que o &tdesvn-build; NÃO faz: + + + +Descobrir a réplica do &svn; do &kde; mais rápida. Não existe sequer uma lista acompanhando o programa atualmente, ainda que o servidor padrão deva funcionar perfeitamente. + +Escovar os seus dentes. Você deve lembrar de fazer isso você mesmo. + +O programa, provavelmente, não está livre de erros. Desculpe por isso. + + + + + + +O Formato do '.tdesvn-buildrc' + +Para usar o programa, você deverá ter um arquivo na sua pasta pessoal .tdesvn-buildrc, que descreve os módulos que deseja obter e compilar. + + + +Ele começa com as opções globais, indicadas da seguinte forma: + +global +nome-opção valor-opção +[...] +end global + + +Segue-se então uma ou mais seções dos módulos, organizadas da seguinte forma: + +module nome-módulo +nome-opção valor-opção +[...] +end module + + +O nome-módulo deverá ser um módulo do repositório de &svn; do &kde; (por exemplo, o 'tdelibs' ou o 'tdebase'). Algumas das opções sobrepõem-se às globais, algumas adicionam-se às opções globais e algumas opções globais simplesmente não podem ser sobrepostas. + +Segue-se uma lista ordenada alfabeticamente das opções que poderá usar. Clique na opção para descobrir mais sobre ela. Se alguma não estiver documentada, envie por favor um e-mail aos autores, usando o endereço que poderá encontrar acima. + + +apidox, para compilar a Documentação da API +apply-qt-patches, para melhorar o 'qt-copy' +binpath, para definir a variável PATH. +branch, para obter uma determinada ramificação, em vez da '/trunk'. +build-dir, para definir a pasta onde será feita a compilação. +checkout-only, para transferir apenas as partes de um módulo. +colorful-output para colorir o resultado do programa. +configure-flags para definir as opções com que um módulo poderá ser configurado. +cxxflags para definir a variável CXXFLAGS. +dest-dir para mudar a pasta de instalação de um módulo. +disable-agent-check, para impedir que o 'tdesvn-build' verifique o estado do 'ssh-agent'. +do-not-compile, para marcar as pastas que não serão compiladas. +inst-apps, para só compilar e instalar algumas pastas. +install-after-build, para evitar a instalação após o processo de compilação. +tdedir, para indicar a pasta onde o KDE será instalado. +libpath, para configurar a variável LD_LIBRARY_PATH. +make-install-prefix, para executar um programa auxiliar (como o 'sudo') durante o 'make install'. +make-options, para passar opções ao programa 'make'. +manual-build, para evitar que o módulo seja compilado automaticamente. +manual-update, para evitar que seja feito, seja o que for, ao módulo de forma automática. +module-base-path, para mudar o local de onde transferir o módulo (útil para as ramificações - 'branches' -, e marcas - 'tags'). +niceness, para mudar a prioridade da CPU. +no-rebuild-on-fail, para evitar a execução do 'make' novamente se algo falhar. +qtdir, para definir a localização do Qt. +set-env, para configurar uma variável de ambiente. +source-dir, para mudar o local onde colocar o código transferido. +stop-on-failure, para fazer com que o 'tdesvn-build' pare o mais cedo possível, após encontrar um problema. +svn-server, para mudar o servidor de onde é transferido o código. +use-qt-builddir-hack, para dar ao Qt uma pasta de compilação diferente da do seu código, como acontece no KDE. +use-unsermake, para usar o sistema de compilação avançado, o 'unsermake'. + + + +Aqui está uma tabela com as opções globais, bem como alguns comentários sobre elas. As opções que se sobreporem às globais irão também sobrepor-se a uma configuração da linha de comando. + + +Tabela de Opções + + + + +Nome da Opção +Comportamento do Módulo -> Global +Notas + + + + + + +apidox +Sobrepõe-se à global +Configure esta opção como true, para que o &tdesvn-build; compile e instale automaticamente a documentação da API do módulo, após o processo de compilação/instalação normal. Isto só funciona para os módulos em que o make apidox faz alguma coisa, e que incluem o 'tdelibs', 'tdebase' e o 'koffice', entre outros. + + + +apply-qt-patches +Sobrepõe-se à global +Esta opção só é útil para o 'qt-copy'. Se for um valor diferente de zero, então o programa 'apply-patches' do 'qt-copy' será executado antes da compilação, para aplicar as alterações não oficiais no 'qt-copy'. Uma vez que estas alterações são normalmente a razão para usar o 'qt-copy', em vez de um Qt oficial, não deverá haver qualquer problema em ativá-las. Por padrão, está ativada a aplicação destas modificações. + + + +binpath +Não poderá ser sobreposta +Ative esta opção para modificar a variável de ambiente PATH durante a compilação. Não poderá sobrepor esta opção numa opção do módulo. O valor padrão é o /bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin. Esta variável de ambiente deverá incluir os locais, separados por dois-pontos das suas ferramentas de desenvolvimento. Os locais $TDEDIR/bin e $TQTDIR/bin são adicionados automaticamente. Você poderá usar o til (~) para os locais que adicionar com esta opção. + + + + +branch +Sobrepõe-se à global +Altere esta opção para obter uma ramificação do KDE, em vez do valor por padrão "trunk", onde o desenvolvimento do KDE está em curso. Por exemplo, para obter a ramificação do KDE 3.4, você deverá configurar esta opção como "3.4". +Lembre-se que alguns módulos usam um nome de ramificação diferente. Notavelmente,o módulo obrigatório 'arts' não segue os números de versões do KDE. O 'arts' que acompanhava o KDE 3.4 era o 1.4. +Se o 'tdesvn-build' não conseguir obter adequadamente uma ramificação com esta opção, você poderá ter de indicar manualmente o URL de onde transferir, com a opção override-url. + + + + +build-dir +Sobrepõe-se à global +Use esta opção para mudar a pasta que contém o código compilado. Existem três formas diferentes de usá-la: Relativa à pasta de código do &kde; no &svn; (ver a opção 'source-dir'). Esta é a opção padrão e a forma como funcionou o programa até à versão v0.61. Este modo fica selecionado se digitar o nome de uma pasta que não comece por um til (~) ou uma barra (/). O valor padrão é build. Um local absoluto. Se indicar um local que comece por um /, então será usado esse local diretamente. Por exemplo, o /tmp/kde-obj-dir/. Relativo à sua pasta pessoal. Se indicar uma pasta que comece com um '~', então o local será usado em relação à sua pasta pessoal, de forma semelhante à expansão do til da linha de comando. Por exemplo, o ~/builddir irá configurar a pasta de compilação como /home/usuário/builddir. Surpreendentemente, esta opção poderá ser alterada por módulo. + + + +checkout-only +Sobrepõe-se à global +Altere esta opção para obter o código do &svn; passo-a-passo. O valor desta opção deverá ser uma lista separada por espaços das pastas a transferir. Se não incluir a pasta 'admin', ela será incluída automaticamente (se necessário). Ao transferir passo-a-passo, a pasta 'admin' será obtida do 'kde-common', que é onde se encontra no servidor do &svn;. Ainda que esta opção se sobreponha à global, observe que esta opção, como global, não faz sentido. + + + +configure-flags +Adiciona às opções globais (exceto no 'qt-copy') +Use esta opção para indicar quais opções passar ao './configure' quando criar o sistema de compilação do módulo. Quando isto é usado como uma opção global, é aplicada a todos os módulos onde este programa se compila. O 'qt-copy' usa um conjunto muito diferente de opções do 'configure' do resto do &kde;, assim esta opção sobrepõe as opções globais, quando é aplicada ao 'qt-copy'. + + + +colorful-output +Não poderá ser sobreposta +Configure esta opção como 'false' para desativar o resultado colorido do &tdesvn-build;. Por padrão é true. Lembre-se que o &tdesvn-build; não irá mostrar os códigos de cores em nada que não seja um terminal (como o 'xterm', o &konsole; ou o console normal do Linux). + + + +cxxflags +Adiciona-se à opção global +Use esta opção para indicar as opções a passar ao ./configure como CXXFLAGS, ao criar o sistema de compilação do módulo. Esta opção é indicada aqui em vez do configure-flags, uma vez que esta opção irá também definir a variável de ambiente CXXFLAGS durante o processo de compilação. + + + +dest-dir +Sobrepõe-se à global +Use esta opção para mudar o nome que é dado a um módulo no disco. Por exemplo, se o seu módulo se chamava 'extragear/network', você poderá mudar o nome do mesmo para 'extragear-network' com esta opção. + + + +disable-agent-check +Não poderá ser sobreposta +Normalmente, se você estiver usando o SSH para obter o código do Subversion (se, por exemplo, estiver usando o protocolo 'svn+ssh'), o 'tdesvn-build' irá tentar certificar-se que, se estiver usando o 'ssh-agent', ele está de fato gerenciando algumas identidades do SSH. Isto é para tentar evitar que o SSH pergunte a sua frase-senha para todos os módulos. Você poderá desativar esta opção se ativar a opção 'disable-agent-check' como 'true'. + + + +do-not-compile +Sobrepõe-se à global +Use esta opção para definir a variável de ambiente DO_NOT_COMPILE antes de executar o programa 'configure'. De acordo com a FAQ de Desenvolvimento do &kde;, este deverá ser o caso de uma pasta de topo que não deseje compilar. As pastas deverão estar separadas por espaços. + +Lembre-se que o código dos programas será ainda transferido. Você poderá usar a instrução checkout-only para escolher as pastas que deseja obter. + + + + +email-address +Não poderá ser sobreposta + +Configure esta opção com o endereço de e-mail que o 'tdesvn-build' deverá usar, no caso de precisar alguma vez enviar mensagens. Você não terá que se preocupar com isto se não usar qualquer funcionalidade que envie e-mails. (Elas estão todas desativadas por padrão). + +Atualmente, somente o email-on-compile-error necessita desta opção. + + + + +email-on-compile-error +Não poderá ser sobreposta + +Você poderá configurar esta opção com o endereço de e-mail para onde enviar um relatório, sempre que um módulo não conseguir ser compilado. O 'tdesvn-build' irá esperar até que todos os módulos terminem e irá recolher todos os resultados no relatório. Este relatório só é enviado se um módulo se recusar a compilar. + +Por favor, veja a opção email-address para configurar o endereço de onde o 'tdesvn-build' irá enviar, uma vez que o valor padrão não é normalmente o que você deseja. + + + + +inst-apps +Sobrepõe-se à global +Isto é o oposto da opção do-not-compile. Serve para indicar que apenas as pastas de topo referidas serão compiladas. As pastas deverão estar separadas por espaços. + +As alterações não farão efeito até à próxima vez que o make Makefile.cvs seja executado, quer automaticamente pelo programa, quer manualmente pelas opções ou . + +Lembre-se que o código dos programas será ainda transferido. Você poderá usar a instrução checkout-only para escolher as pastas que deseja obter. + + + + +install-after-build +Sobrepõe-se à global +Esta opção é usada para instalar o pacote depois dele ser compilado com sucesso. Esta opção está ativa por padrão. Se quiser desativá-la, terá que configurar esta opção como 0 no arquivo de configuração. Você poderá também usar a opção da linha de comando . + + + +tdedir +Não poderá ser sobreposta +Esta opção define a pasta em que o &kde; será instalado após a compilação. Por padrão, será em ~/kde. Se mudar isto para uma pasta que precise do acesso do 'root', será útil também ler algumas informações sobre a opção make-install-prefix. + + + +libpath +Não poderá ser sobreposta +Configure esta opção para definir a variável de ambiente LD_LIBRARY_PATH, enquanto efetua a compilação. Você não poderá sobrepor esta opção num módulo. O valor padrão está em branco, mas os locais $TDEDIR/lib e $TQTDIR/lib são adicionados automaticamente. Você poderá usar o til (~) para os locais que adicionar com esta opção. + + + +log-dir +Sobrepõe-se à global +Use esta opção para mudar a pasta que irá conter os arquivos de registro gerados pelo programa. Esta opção poderá ser definida para cada módulo, a partir da versão 0.64. + + + +make-install-prefix +Sobrepõe-se à global +Configure esta variável com uma lista separada por espaços, que será interpretada como um comando e as suas opções, para anteceder o comando 'make install', que é usado para instalar os módulos. Isto é útil para instalar os pacotes com o 'sudo', por exemplo, mas tenha cuidado ao trabalhar com os privilégios do 'root'. + + + +make-options +Sobrepõe-se à global +Configure esta variável para passar as opções da linha de comando ao comando 'make'. Isto é útil para os programas, como o distcc. O distcc permite-lhe compartilhar o seu trabalho de compilação em mais de um computador. Para usá-lo, deverá usar a opção do 'make'. Agora você já pode. De acordo com a documentação, recomenda-se '2 * número_de_cpus_na_rede'. Eu tenho 1 CPU, assim devo usar no meu caso. + + + +manual-build +Sobrepõe-se à global +Configure o valor da opção como true para evitar que o processo de compilação tente compilar este módulo. Ele ainda será mantido atualizado ao atualizar a partir do &svn;. Esta opção é exatamente equivalente à opção da linha de comando . + + + +manual-update +Sobrepõe-se à global +Configure o valor da opção como true para evitar que o processo de compilação tente atualizar (e, por conseguinte, compilar ou instalar) este módulo. Se definir esta opção para um módulo, também poderá tê-la comentada. + + + +module-base-path +Sobrepõe-se à global +Configure esta opção para se sobrepor à pasta padrão do &tdesvn-build; para o módulo em questão. Isto poderá ser usado, por exemplo, para usar ramificações ou marcas específicas de determinadas bibliotecas. O Visualizador de Código do &kde; é extremamente valioso para ajudá-lo a escolher o local correto. +Lembre-se que o &tdesvn-build; constrói o local final de acordo com o seguinte modelo: $svn-server/home/kde/$module-base-path/$module-name. +O valor padrão tanto pode ser o trunk como o trunk/KDE, dependendo do nome do módulo. + + + + +niceness +Não poderá ser sobreposta +Configure esta opção com um valor entre 20 e 0. Quanto mais alto o número, menor prioridade terá o &tdesvn-build;. O valor padrão é 10. + + + +no-rebuild-on-fail +Sobrepõe-se à global +Configure o valor desta opção como true para evitar que o &tdesvn-build; sempre tente compilar de novo este módulo, se falhar numa compilação incremental. Normalmente, o &tdesvn-build; irá tentar compilar de novo o módulo do zero, para lidar com o efeito de uma atualização do &svn; inválida que confunda o sistema de compilação. + + + +override-url +Sobrepõe-se à global +Se configurar esta opção, o 'tdesvn-build' irá usar o seu valor como o URL a passar ao Subversion, sem qualquer alteração. Você deverá usar geralmente esta opção, se quiser obter uma versão específica, mas o 'tdesvn-build' não conseguir descobrir o que queria dizer ao usar a opção branch. + + + +qtdir +Não poderá ser sobreposta +Configure esta opção para definir a variável de ambiente TQTDIR enquanto compila. Você poderá sobrepor esta configuração numa opção de um módulo. Se não indicar esta opção, será por padrão a $(source-dir)/build/qt-copy, que irá usar o módulo 'qt-copy' que está incluído no repositório de código do &kde;. Você poderá usar um til (~) que representa a sua pasta pessoal. + + + +remove-after-install +Sobrepõe-se à global +Se estiver com pouco espaço em disco, você poderá querer usar esta opção para remover automaticamente a pasta de compilação (ou as pastas de compilação e de código, para instalações episódicas), após o módulo ter sido instalado com sucesso. +Os valores possíveis para esta opção são: +none - Não remove nada (Este é o valor padrão). +builddir - Remove a pasta de compilação, mas não o código. +all - Remove tanto o código-fonte como a pasta de compilação. + + + +Lembre-se que a utilização desta opção poderá ter um grande impacto na utilização da sua largura de banda (se usar o 'all') e o tempo que dura a compilação do KDE, uma vez que o 'tdesvn-build' será incapaz de efetuar compilações incrementais. + + + + +set-env +Sobrepõe-se à global +Esta opção aceita um conjunto de valores separados por espaços, onde o primeiro valor é a variável de ambiente a definir e o resto dos valores é o que deseja atribuir à sua variável. Por exemplo, para configurar a variável RONALD como McDonald, você deve colocar este comando na seção apropriada: +set-env RONALD McDonald +Esta opção é especial, na medida em que poderá ser repetida sem sobrepor a configuração anterior do 'set-env' na mesma seção do arquivo de configuração. Desta forma, você poderá definir mais de uma variável de ambiente por módulo (ou a nível global). + + + + +source-dir +Não poderá ser sobreposta +Esta opção é usada para definir a pasta do seu computador onde será guardado o código-fonte do &svn; do &kde;. Se não indicar este valor, será usado o valor padrão ~/tdesvn. Se você especificar este valor, use um local absoluto. + + + +svn-server +Não poderá ser sobreposta +Esta opção é usada para definir o servidor usado para obter o código do &svn;. Por padrão, é usado o repositório anónimo de &svn;, em svn://anonsvn.kde.org/ + + + +stop-on-failure +Sobrepõe-se à global +Configure o valor desta opção como true para fazer com que o programa pare a execução, após ocorrer um erro durante o processo de compilação ou instalação. Esta opção está desativada por padrão. + + + +tag +Sobrepõe-se à global +Use esta opção para obter uma versão específica de um módulo. +NOTA: É muito provável que você NÃO QUEIRA usar esta opção. As versões do KDE lançadas estão disponíveis em pacotes compactados no servidor de FTP do KDE ou em um dos servidores espelho. +Se você estiver usando o 'tdesvn-build' porque está com problemas para obter uma versão do KDE para compilar na sua distribuição, pense em usar a ferramenta de compilação Konstruct em alternativa, que funciona a partir dos pacotes de lançamento. + + + + +use-qt-builddir-hack +Sobrepõe-se à global +Ainda que esta opção se sobreponha à global, só fará sentido para o 'qt-copy'. Configure esta opção como true para ativar o modo experimental de 'srcdir' != 'builddir'. Se estiver ativada, o &tdesvn-build; irá copiar o módulo de código do 'qt-copy' para a pasta de compilação e efetuar as compilações a partir daí. Isto significa que a sua variável de ambiente TQTDIR ficará igual a $(qt-copy-build-dir)/qt-copy/lib em alternativa. Você deverá também mudar a sua opção qtdir em função disso. O 'make' incremental deverá ainda funcionar neste modo, uma vez que as datas serão preservadas após a cópia. Se usar a opção apply-qt-patches, as atualizações serão aplicadas na pasta de compilação, não na pasta de código. Esta opção é igual a true, por padrão. + + + +use-unsermake +Sobrepõe-se à global +Configure esta opção como true para poder usar o programa experimental 'unsermake' em vez do 'automake' ao rodar o programa 'configure'. Isto poderá levar a uma diminuição significativa no tempo da compilação, principalmente no caso dos sistemas de compilação distribuídos. Esta opção é, por padrão, true (para a maioria dos módulos). + +Normalmente, se usar esta opção, o 'tdesvn-build' irá manter automaticamente o 'unsermake' atualizado. Isto poderá começar a ser incómodo, principalmente se estiver gerenciando você mesmo o 'unsermake'. Se for este o caso, você poderá configurar esta opção como self, fazendo com que o 'tdesvn-build' ainda use o 'unsermake', mas não faça nada de especial para mantê-lo atualizado. + + + + + + +
+ + + + +Opções da Linha de Comando e Variáveis de Ambiente + +Este programa não usa variáveis de ambiente. Se você precisar definir variáveis de ambiente para o ambiente de compilação ou de instalação, veja a opção set-env. + +O programa aceita as seguintes opções da linha de comando: + + + + + +mostra apenas uma ajuda simples deste programa. + + + + +mostra a versão do programa. + + + + +mostra as informações de contato do autor. + + + + +ativa o resultado do programa à cores. + + + + +desativa o resultado do programa à cores. + + + + (ou ) +não faz NADA de fato, mas funciona como se você fizesse. + + + + (ou ) +Não é tão descritivo com o resultado exibido pela compilação. Com esta opção, somente as mensagens básicas são apresentadas. + + + + +Só mostra as mensagens de avisos e erros. + + + + +Torna-se bastante descritivo com o que está acontecendo e o que o 'tdesvn-build' está fazendo. + + + + +efetua apenas a atualização do código. + + + + +efetua apenas o processo de compilação. + + + + +não inclui os módulos passados no resto da linha de comando no processo de atualização/compilação. + + + + +ignora o passo de contacto do servidor do &svn;. + + + + +salta o processo de compilação. + + + + +não instala automaticamente os pacotes, após a sua compilação. + + + + +ativa o modo de depuração para o programa. Atualmente, isto significa que todo o resultado será enviado para o STDOUT, além de ficar registrado na pasta de registro normalmente. Do mesmo modo, muitas das funções tornar-se-ão mais descritivas sobre o que estão fazendo no modo de depuração. + + + + +não tenta compilar de novo os módulos que não conseguiram ser compilados do zero. O &tdesvn-build; nunca irá tentar fazer isto num módulo que já se tentou compilar do zero. + + + + +recria o sistema de compilação e compila a partir do zero. + + + + +executa o programa 'configure' novamente sem limpar a pasta de compilação. + + + + +executa o make Makefile.cvs novamente para criar o programa 'configure' e continua a compilação normalmente. Esta opção implica a . + + + + +tenta continuar a compilação a partir do ponto em que o programa parou da última vez. O programa começa a compilar o módulo, após o último ter sido compilado da última vez em que o programa foi executado, quer tenha corrido bem ou não. Esta opção implica a . Você não deverá indicar os nomes de outros módulos na linha de comando. + + + + +é semelhante à opção , exceto que você indica qual o módulo de onde começar a compilação como parâmetro a seguir na linha de comando. Esta opção implica a . Você não deverá indicar os nomes dos outros módulos na linha de comando. + + + + +interpreta o próximo parâmetro da linha de comando como o arquivo de onde ler as opções de configuração. O valor padrão deste parâmetro é '~/.tdesvn-buildrc'. + + + + +permite-lhe mudar a pasta onde o &kde; será instalado na linha de comando. Esta opção implica a . + + + + +pára após a execução do make Makefile.cvs. O programa 'configure' precisará ainda ser executado, coisa que o &tdesvn-build; irá fazer da próxima vez. Isto permite-lhe preparar todos os programas 'configure' de uma vez, para que você possa ver o ./configure de cada módulo e editar as suas opções do 'configure' adequadamente. + + + +Se esta for a única opção da linha de comando, ele irá tentar instalar todos os módulo incluídos em 'successfully-built', exceto o 'qt-copy', que não precisa de instalação. Se as opções da linha de comando forem indicadas após o , então assumem-se que são módulos para instalar. + + + + +Você poderá usar esta opção para sobrepor outra opção no seu arquivo de configuração para todos os módulos. Por exemplo, para sobrepor a opção log-dir, deverá digitar: . + + + + +Você poderá usar esta opção para sobrepor uma opção do seu arquivo de configuração para um determinado módulo. Por exemplo, para sobrepor a opção use-unsermake do 'tdemultimedia', você deveria digitar: . + + + + +Todas as outras opções da linha de comando assumem-se como sendo módulos para atualizar e compilar. Por favor, não misture a compilação com a instalação. + + + + +Créditos e Licenças +&underFDL; + + diff --git a/tde-i18n-sv/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt b/tde-i18n-sv/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt deleted file mode 100644 index e13b2919123..00000000000 --- a/tde-i18n-sv/docs/tdesdk/scripts/tdesvn-build/CMakeLists.txt +++ /dev/null @@ -1,6 +0,0 @@ -# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer - -tde_create_handbook( - DESTINATION tdesvn-build - LANG sv -) diff --git a/tde-i18n-sv/docs/tdesdk/scripts/tdesvn-build/Makefile.am b/tde-i18n-sv/docs/tdesdk/scripts/tdesvn-build/Makefile.am deleted file mode 100644 index 81d84f8d685..00000000000 --- a/tde-i18n-sv/docs/tdesdk/scripts/tdesvn-build/Makefile.am +++ /dev/null @@ -1,4 +0,0 @@ -KDE_LANG = sv -SUBDIRS = $(AUTODIRS) -KDE_DOCS = tdesvn-build -KDE_MANS = AUTO diff --git a/tde-i18n-sv/docs/tdesdk/scripts/tdesvn-build/index.docbook b/tde-i18n-sv/docs/tdesdk/scripts/tdesvn-build/index.docbook deleted file mode 100644 index 822d5ba6bd8..00000000000 --- a/tde-i18n-sv/docs/tdesdk/scripts/tdesvn-build/index.docbook +++ /dev/null @@ -1,688 +0,0 @@ - - - - - - Subversion"> - tdesvn-build"> -]> - - - - -Handbok för skriptet &tdesvn-build; - - -MichaelPyne
michael.pyne@kdemail.net
 - -CarlosWoelz
carloswoelz@imap-mail.com
 - - - - Stefan Asserhäll
stefan.asserhall@comhem.se
 Översättare - - - - -2005 -Michael Pyne - - - -2005 -Carlos Woelz - - - -&FDLNotice; - -2005-06-18 -0.97 - - -&tdesvn-build; är ett Perl-skript som bygger och installerar &kde;, direkt från källkoden som hämtas från &kde;:s &svn;-arkiv. - - - -KDE -tdesdk -SVN -Subversion -KDE-utveckling - - - - - - -Inledning - -&tdesvn-build; är ett Perl-skript som hjälper användare att installera &kde; från &svn;. Du kanske också vill fundera på att använda skriptet kde-build, som är inkluderat i &kde;:s tdesdk-modul. - -Här dokumenterar vi syntaxen för &tdesvn-build; inställningsfiler, dess kommandoradsväljare, funktioner och en översikt över alla nödvändiga steg som krävs för att bygga &kde; från källkod, inklusive stegen du måste utföra med användning av andra verktyg, eller med andra ord, steg som inte automatiskt utförs av skriptet &tdesvn-build;. - - - - -Komma igång - -I det här kapitlet visar vi hur &tdesvn-build; används för att checka ut moduler från &kde;-arkivet och bygga dem. Vi tillhandahåller också en grundläggande förklaring av &kde;:s &svn;-struktur och stegen du måste utföra innan skriptet körs. - -Alla ämnen som presenteras i det här kapitlet täcks med ännu mer detaljer i guiden Building &kde; from Source Step by Step Guide på hemsidan för &kde;:s kvalitetsgrupp. Om du kompilerar KDE för första gången, är det en god idé att läsa den, eller rådfråga den som en referenskälla. Du hittar detaljerad information om paketverktyg och krav, vanliga fallgropar vid kompilering och strategier och information om att köra den nya &kde;-installationen. - - -Förbereda systemet för att bygga &kde; - -Du rekommenderas att ladda ner och bygga &kde; med ett användarkonto. Om du redan har &kde;-paket installerade, är det bästa valet att skapa en annan (särskild) användare för att bygga och köra det nya &kde;. Fördelen med att bygga &kde; för en särskild användare är att du inte kan förstöra bassystemet, och du har alltid ett sätt att arbeta bekvämt när saker och ting går fel. - -Senare kan du installera som systemadministratör om du vill. Det här dokumentet täcker inte en installation som systemadministratör. Om du utför en systeminstallation, vet du troligen ändå vad du gör. - -Innan du använder skriptet &tdesvn-build; (eller någon annan byggstrategi) måste du installera utvecklingsverktyg och bibliotek som behövs för &kde;. Du behöver Qt-biblioteket, version 3.3.0 eller senare, Automake 1.8, Autoconf 2.5X (bättre med >= 2.57 eftersom ett fel rapporterades med tidigare versioner), subversion-klienten (svn), gcc-kompilatorn med stöd för C++, libxml2, openssl, libbz2 och många fler (för en fullständig lista, besök KDE kompileringskrav). Du kan oftast få verktygen paketerade för ditt system från din distribution eller leverantör. - -Vissa av paketen är uppdelade i bibliotek, program eller verktyg och utvecklingspaket. Du behöver åtminstone programmet eller biblioteket och dess utvecklingspaket. Om du är tveksam installera alla. Biblioteken du behöver ändras beroende på modulerna du avser att bygga, eftersom varje modul har sina egna krav. Guiden Building &kde; from Source Step by Step har mer detaljinformation om specifika verktyg och tekniker som används för att installera och hitta programvaran som krävs. - -Du har troligen redan en version av skriptet &tdesvn-build; installerat på ditt -system. &tdesvn-build; kräver att du skapar en inställningsfil, som heter -.tdesvn-buildrc. Filen ska installeras i hemkatalogen -(~/), och innehålla all inställningsdata som krävs för att skriptet ska kunna -köras, som inställningsalternativ, kompileringsväljare, plats för källkoden, -målet för installationen (prefix), modulerna som ska byggas, etc. Förvald -inställningsdata tillhandahålls i filen -tdesvn-buildrc-sample. Du hittar mer information om -inställningsfilens syntax i -och i . - -Ett bra sätt att hämta senaste versionen är att bläddra till sidan tdesdk/scripts på webbplatsen websvn.kde.org. Du ser en lista med filer tillgängliga i katalogen tdesdk/scripts i &kde;:s &svn;-arkiv. Klicka på länken &tdesvn-build; och ladda ner senaste versionen av skriptet. Gör samma sak med filen tdesvn-buildrc-sample. Gör skriptet körbart, och försäkra dig om att det finns i din sökväg. - - - - -Ange inställningsinformation - -För att använda skriptet måste du ha en fil i din hemkatalog som heter .tdesvn-buildrc, som ställer in allmänna alternativ och anger modulerna som du vill ladda ner och bygga. - -Använd filen tdesvn-buildrc-sample som en mall, för att ställa in allmänna alternativ och modulerna du vill bygga. - -Välj servern som ska användas för att checka ut från &svn; genom att ställa in det allmänna alternativet svn-server. Det anonyma &svn;-arkivet svn://anonsvn.kde.org/ är förvalt, men ändra det om du har ett &kde; &svn;-konto, eller om det finns en spegelplats nära dig. - -Var särskilt uppmärksam på de globala variablerna tdedir och qtdir, eftersom den första anger var det byggda &kde; ska installeras (normalt i ~/kde), och den andra var (och om) Qt-biblioteket ska byggas och installeras (normalt ~/tdesvn/build/qt-copy). Du måste känna till platserna för tdedir och qtdir senare, för att ställa in miljövariablerna som är nödvändiga för att köra den nya installationen. Kontrollera om de listade modulerna i själva verket är modulerna som du vill bygga. De förvalda alternativen i filen tdesvn-buildrc-sample bör vara tillräckliga för att få en någorlunda komplett installation av &kde;. Spara resultatet som .tdesvn-buildrc i din hemkatalog. - -Om du vill finjustera .tdesvn-buildrc, titta då på för detaljerad information om alla inställningsalternativ. - - - - -Att använda skriptet &tdesvn-build; - -Nu är du klar att köra skriptet. Logga in till användaren som du använder för att kompilera &kde; i ett terminalfönster, och kör skriptet: %su utvecklings-användarnamn -%tdesvn-build - - - -Nu ska skriptet börja ladda ner källkoden och kompilera den. Det är inte troligt att du lyckas första gången du kompilerar &kde;. Förtvivla inte! Kontrollera loggfilerna för att se om du saknar några verktyg eller utvecklingspaket (platsen för loggfilerna anges av variabeln log-dir i inställningsfilen). Ibland blir huvudutvecklingsgrenen mycket instabil och svår att bygga, särskilt när en frysning av utvecklingen är nära. Ha tålamod. Du kan hitta fler vanliga exempel på saker som kan gå fel och deras lösning, samt allmänna tips och strategier för att bygga &kde; i guiden Building &kde; from Source Step by Step. - - - - -Ställa in miljön för att köra det färska &kde; - -Med antagandet att du använder en särskild användare för att bygga &kde; och redan har en installerad version av &kde;, kan det vara något krångligt att köra det nya &kde;, eftersom det nya &kde; måste ges företräde över det gamla. Ändra miljövariabler för att försäkra dig om att det gör det. - -Öppna eller skapa filen .bash_profile i hemkatalogen med din favoriteditor, och lägg till följande i slutet på filen: -TDEDIR=(sökväg till tdedir) -TDEDIRS=$TDEDIR -PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH -LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH -export TDEDIRS PATH LD_LIBRARY_PATH - om du bygger modulen qt-copy, lägg istället till: TQTDIR=(sökväg till qtdir) -TDEDIR=(sökväg till tdedir) -TDEDIRS=$TDEDIR -PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH -MANPATH=$TQTDIR/doc/man:$MANPATH -LD_LIBRARY_PATH=$TDEDIR/lib:$TQTDIR/lib:$LD_LIBRARY_PATH -export TQTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH - - - -Om du inte använder en särskild användare, ställ in en annorlunda $TDEHOME för den nya miljön i din .bash_profile: export TDEHOME="${HOME}/.tde-svn" - -# Skapa om det behövs -[ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn - - - - -Om menyn senare är tom eller för överfull med program från din distribution, kanske du måste ställa in miljövariabeln xdg i .bash_profile: XDG_CONFIG_DIRS="/etc/xdg" -XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" -export XDG_CONFIG_DIRS XDG_DATA_DIRS - - - - - -Nu när vi är klara med det måste du försäkra dig om att rätt starttde skript kommer att användas: - -Öppna textfilen .xinitrc (eller .xsession, beroende på distribution) i hemkatalogen, eller skapa den om det behövs. Lägg till raden: exec ${TDEDIR}/bin/starttde - - - -Starta nu det färska &kde;: i BSD- och Linux-system med stöd för virtuella terminaler, används tangentkombinationerna Ctrl+Alt+F1..F12 för att byta mellan virtuella konsoller 1 till och med 12. Det låter dig köra mer än en skrivbordsmiljö samtidigt. De första sex är textterminaler, och de följande sex är grafiska skärmar. - -Om den grafiska skärmhanteraren istället visas när du startar, kan du använda den nya KDE-miljön även om den inte listas som ett alternativ. Tryck på Ctrl+Alt+F2, så visas en textterminal. Logga in som den särskilda användaren och skriv: - -startx -- :1 - - - -Du kan köra KDE från källkod och det gamla KDE samtidigt. Logga in som din vanliga användare, och starta det stabila KDE-skrivbordet. Tryck på Ctrl+Alt+F2 (eller F1, F3, etc.), så visas en textterminal. Logga in som den särskilda användaren och skriv "startx -- :1". Du kan gå tillbaka till den vanliga användaren genom att trycka på Ctrl+Alt+F6 (eller F7, F8 etc. Prova dem. En av dem är den rätta.). För att återgå till KDE från källkod, tryck på Ctrl+Alt+F7 (eller F6, F8, etc.). Nu kan du byta mellan dina KDE-versioner, och testa den nya medan du vet att du snabbt kan återgå till säkerheten hos det stabila KDE-skrivbordet. - - - - - - - - -Skriptets funktioner - -Funktionerna i &tdesvn-build; omfattar: - - - - -Checkar automatiskt ut eller uppdaterar moduler från &svn;, enligt vad som är lämpligt. - -Beräknar tiden för att bygga moduler. - -Försöker automatiskt bygga om moduler som använder en inkrementell byggprocess, vilken tenderar att misslyckas efter vissa typer av incheckningar. - -Kan återuppta ett tidigare skript, eller starta byggprocessen från en viss modul. - -Levereras med en inbyggt rimlig uppsättning förvalda alternativ lämpligt för att bygga en grundläggande enanvändarinstallation av &kde; från det anonyma &svn;-arkivet. - -Levereras med stöd för Unsermake. - -Expanderar dina inställningsalternativ med tilde. Du kan till exempel ange: qtdir ~/tdesvn/build/qt-copy - - -Inställningsbara bygg-, källkods-, och loggningskataloger - -Sätter automatiskt upp ett byggsystem, med källkodskatalogen skild från byggkatalogen för att hålla källkodskatalogen orörd. Undantaget är qt-copy, som inte är konstruerad att byggas så (om du inte vill prova QT med separat byggkatalog). - -Du kan ange allmänna alternativ att använda för alla moduler som checkas ut, och du kan dessutom ange alternativ som ska användas för enskilda moduler. - -Eftersom autoverktygen ibland blir osynkroniserade med ändringar i källkodsträdet, kan du tvinga att en modul byggs om genom att skapa en fil som heter refresh-me i byggkatalogen för modulen i fråga, eller genom att köra &tdesvn-build; med väljaren . - -Du kan ange diverse miljövariabler som ska användas under byggprocessen, inklusive TDEDIR, TQTDIR, DO_NOT_COMPILE och CXXFLAGS. - -Kommandologgning. Loggar dateras och numreras så att du alltid har en logg av en körning av skriptet. Dessutom skapas en symbolisk länk som heter latest, som alltid pekar på den senaste loggen i loggkatalogen. - -Om du använder en användarbyggd &kde; istället för en systembyggd (som du måste vara systemadministratör för att installera), kan du låta skriptet installera åt dig. Jag har inte granskat koden, och den använder anropet system() flitigt, så jag rekommenderar för närvarande att inte köra den som systemadministratör. - -Du kan använda make-install-prefix för att inleda byggkommandoraden med ett separat kommando, som är användbart för sudo. - -Du kan använda alternativet apidox för att automatiskt bygga och installera dokumentation om programmeringsgränssnittet för vissa moduler. - -Du kan checka ut bara en delmängd av en &kde; &svn;-modul. Du skulle till exempel kunna checka ut bara taglib från tdesupport, eller bara K3B från extragear/multimedia. Skriptet hämtar automatiskt in kde-common om det behövs för att få byggprocessen att fungera. - -Du kan låtsas att utföra åtgärden. Om du skickar med eller på kommandoraden, ger skriptet en mycket utförlig beskrivning av de kommandon som ska göras, utan att i själva verket utföra dem. - -Stöd för att checka ut specifika grenar av &svn;-moduler. Arbetet behöver fortfarande göras färdigt, men du kan redan välja grenen du vill bygga med inställningsalternativet module-base-path. - - - -Saker som &tdesvn-build; INTE gör: - - - -Hitta den snabbaste spegelplatsen för &kde; &svn;. Det finns inte ens en lista medskickad med skriptet för närvarande, även om förvald server bör fungera bra. - -Borsta tänderna. Du måste komma ihåg att göra det själv. - -Tyvärr är skriptet troligen inte fritt från fel. - - - - - - -Formatet för .tdesvn-buildrc - -För att använda skriptet måste du ha en fil i din hemkatalog som heter .tdesvn-buildrc, som beskriver modulerna som du vill ladda ner och bygga. - - - -Den börjar med allmänna alternativ, angivna enligt följande: - -global -alternativ-namn alternativ-värde -[...] -end global - - -De följs därefter av en eller flera modulsektioner, angivna på följande sätt: - -module modul-namn -alternativ-namn alternativ-värde -[...] -end module - - -modul-namn måste vara en modul i &kde;:s &svn;-arkiv (till exempel tdelibs eller tdebase). Vissa alternativ överskrider de allmänna alternativen, vissa lägger till i de allmänna alternativen och vissa allmänna alternativ kan helt enkelt inte överskridas. - -Följande är en alfabetisk lista med alternativ du kan använda. Klicka på alternativet för att ta reda på mer om det. Om något inte är dokumenterat, skicka gärna e-post till upphovsmännen med adressen som du hittar ovan. - - -apidox, för att bygga dokumentation över programmeringsgränssnittet -apply-qt-patches, för att förbättra qt-copy -binpath, för att ställa in variabeln PATH. -branch, för att checka ut från en gren istället för /trunk. -build-dir, för att ange katalog att bygga i. -checkout-only, för att bara checka ut delar av en modul. -colorful-output för att lägga till färg i skriptets utmatning. -configure-flags för att ange vilka flaggor en modul ska ställas in med. -cxxflags för att definiera variabeln CXXFLAGS. -dest-dir för att ändra katalognamn för en modul. -do-not-compile, för att markera kataloger så att de hoppas över av byggprocessen. -inst-apps, för att bara bygga och installera vissa kataloger. -install-after-build, för att undvika att installera efter byggprocessen. -tdedir, för att ange katalog att installera KDE i. -libpath, för att sätta variabeln LD_LIBRARY_PATH. -make-install-prefix, för att köra ett hjälpprogram (som sudo) under installationen. -make-options, för att skicka väljare till byggprogrammet. -manual-build, för att undvika att modulen byggs automatiskt. -manual-update, för att undvika att någonting görs automatiskt med modulen. -module-base-path, för att ändra varifrån modulen laddas ner.(användbart för grenar och taggar). -niceness, för att ändra processorprioriteten. -no-rebuild-on-fail, för att undvika att köra byggprocessen igen om den misslyckas. -qtdir, för att ange sökväg till Qt. -set-env, för att sätta en miljövariabel. -source-dir, för att ändra vart källkoden laddas ner. -stop-on-failure, för att få .tdesvn-build att stoppa så fort ett allvarligt fel hittas. -svn-server, för att ändra servern som källkoden automatiskt laddas ner från. -use-qt-builddir-hack, för att ge Qt en separat byggkatalog från källkoden, som KDE. -use-unsermake, för att använda det avancerade byggsystemet unsermake. - - - -Här är en tabell över de olika alternativen, och några kommentarer om dem. Alla alternativ som överskrider det allmänna alternativet, överskrider också en kommandoradsväljare. - - -Alternativtabell - - - - -Alternativnamn -Modul -> Allmänt beteende -Anmärkningar - - - - - - -apidox -Överskrider allmän -Sätt alternativet till true för att få &tdesvn-build; att automatiskt bygga och installera dokumentation om programmeringsgränssnittet för modulen efter den normala byggprocessen. Det fungerar bara för moduler där make apidox gör någonting, inklusive , bland annat tdelibs, tdebase och koffice. - - - -apply-qt-patches -Överskrider allmän -Det här alternativet är bara användbart för qt-copy. Om det är inställt till ett värde skilt från noll, körs skriptet apply-patches i qt-copy innan byggprocessen, för att utföra inofficiella programfixar i qt-copy. Eftersom dessa programfixar normalt är orsaken till att använda qt-copy istället för en standardversion av Qt, ska det inte vara skadligt att aktivera det. Förvalt värde är att aktivera programfixarna. - - - -binpath -Kan inte överskridas -Sätt alternativet för att använda miljövariabeln PATH under byggprocessen. Du kan inte överskrida alternativet i ett modulalternativ. Förvalt värde är /bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin. Miljövariabeln ska innehålla sökvägar till utvecklingsverktygen åtskilda med kolon. Sökvägarna $TDEDIR/bin och $TQTDIR/bin läggs automatiskt till. Du kan använda tilde (~) för eventuella sökvägar du lägger till med det här alternativet. - - - - -branch -Överskrider allmän -Ange alternativet för att checka ut från en gren av KDE istället för det förvalda "trunk", där KDE-utveckling sker. För att till exempel checka ut grenen KDE 3.4, skulle du ange alternativet "3.4". -Observera att vissa moduler använder ett annorlunda grennamn. I synnerhet följer inte modulen arts som krävs KDE:s versionsnummer. Modulen arts som hörde ihop med KDE 3.4 var version 1.4. -Om tdesvn-build misslyckas med att ladda ner en gren med alternativet, kan du behöva ange webbadressen att ladda ner från för hand med alternativet override-url. - - - - -build-dir -Överskrider allmän -Använd det här alternativet för att byta katalog som innehåller källkoden att bygga. Det finns tre olika sätt att använda det: Relativt till &kde;:&svn;-källkodskatalog (se alternativet source-dir). Det är förvalt, och sättet som skriptet fungerade fram till version 0.61. Läget väljes om du skriver in ett katalognamn som inte börjar med tilde (~) eller snedstreck (/).Förvalt värde är buildAbsolut sökväg. Om du anger en sökväg som börjar med /, används sökvägen direkt. Till exempel /tmp/kde-obj-dir/Relativt till din hemkatalog. Om du anger en sökväg som börjar med ~, används sökvägen relativt till din hemkatalog, på motsvarande sätt som skalets expansion av tilde. Till exempel skulle ~/builddir ställa in byggkatalogen till /home/användarnamn/builddir Alternativet kan, kanske något oväntat, ändras per modul. - - - -checkout-only -Överskrider allmän -Sätt det här alternativet för att checka ut källkod från &svn; del för del. Värdet av alternativet ska vara en lista med kataloger åtskilda med mellanslag att checka ut. Om du inte inkluderar katalogen admin, inkluderas den automatiskt (om det behövs). När du checkar ut del för del hämtas katalogen admin in från kde-common, vilket är platsen den finns på &svn;-servern. Även om alternativet överskrider det allmänna alternativet, var medveten om att ange alternativet som ett allmänt alternativ inte är vettigt. - - - -configure-flags -Lägger till i allmänna alternativ (utom för qt-copy) -Använd det här alternativet för att ange vilka flaggor som ska skickas till ./configure när byggsystemet för modulen skapas. När det används som ett allmänt alternativ, används det för alla moduler som skriptet bygger. qt-copy använder en mycket annorlunda uppsättning inställningsalternativ än resten av &kde;, så det här alternativet överskrider de globala inställningarna när det används för qt-copy. - - - -colorful-output -Kan inte överskridas -Ställ in det här alternativet till false för att inaktivera färglagd utmatning från &tdesvn-build;. Alternativet är normalt true. Observera att &tdesvn-build; inte matar ut färgkoderna till någonting annat än en terminal (som xterm, &konsole; eller den vanliga Linux-konsollen). - - - -cxxflags -Lägger till i allmänna alternativ -Använd det här alternativet för att ange vilka flaggor som ska skickas till ./configure som CXXFLAGS när byggsystemet för modulen skapas. Alternativet anges här istället för med configure-flags eftersom alternativet också sätter miljövariabeln CXXFLAGS under byggprocessen. - - - -dest-dir -Överskrider allmän -Använd det här alternativet för att ändra namnet en modul ges på disk. Om modulen till exempel var extragear/network, skulle du kunna byta namn på den till extragear-network med alternativet. - - - -do-not-compile -Överskrider allmän -Använd det här alternativet för att sätta miljövariabeln DO_NOT_COMPILE innan skriptet configure körs. Enligt &kde;:s vanliga frågor för utvecklare, ska det göra att alla toppnivåkataloger du skickar med inte byggs. Katalogerna ska skiljas åt med mellanslag. - -Observera att källkoden till programmen fortfarande laddas ner. Du kan använda direktivet checkout-only för att välja kataloger som du vill checka ut. - - - - -inst-apps -Överskrider allmän -Det här är motsatsen till alternativet do-not-compile. Alternativet gör att bara angivna toppnivåkataloger byggs. Katalogerna ska åtskiljas med mellanslag. - -Eventuella ändringar får ingen effekt förrän nästa gång make Makefile.cvs körs, antingen automatiskt av skriptet, eller manuellt med alternativen eller . - -Observera att källkoden till programmen fortfarande laddas ner. Du kan använda direktivet checkout-only för att välja kataloger som du vill checka ut. - - - - -install-after-build -Överskrider allmän -Det här alternativet används för att installera paketet efter det har byggts med lyckat resultat. Alternativet är normalt aktiverat. Om du vill inaktivera det, måste du sätta alternativet till 0 i inställningsfilen. Du kan också använda kommandoradsväljaren . - - - -tdedir -Kan inte överskridas -Det här alternativet anger katalogen som &kde; installeras i efter det har byggts. Förvalt värde är ~/kde. Om du ändrar det till en katalog som kräver åtkomst som systemadministratör, bör du också läsa om alternativet make-install-prefix. - - - -libpath -Kan inte överskridas -Ange det här alternativet för att sätta miljövariabeln LD_LIBRARY_PATH under byggprocessen. Du kan inte överskrida inställningen med ett modulalternativ. Förvalt värde är tomt, men sökvägarna $TDEDIR/lib och $TQTDIR/lib läggs automatiskt till. Du kan använda tilde (~) i alla sökvägar du lägger till med alternativet. - - - -log-dir -Överskrider allmän -Använd det här alternativet för att ändra katalogen som används för att lagra loggfiler som skapas av skriptet. Inställningen kan ändras per modul från och med version 0.64 eller senare. - - - -make-install-prefix -Överskrider allmän -Sätt den här variabeln till en lista åtskilda med mellanslag, som tolkas som ett kommando och dess väljare för att föregå kommandot make install som används för att installera moduler. Det är användbart för att till exempel installera paket med sudo, men var försiktig när du hanterar systemadministratörsrättigheter. - - - -make-options -Överskrider allmän -Ange den här variabeln för att skicka kommandoradsväljare till kommandot make. Det är användbart för program som distcc. Programmet distcc låter dig dela upp ditt kompileringsarbete på mer än en dator. För att använda det, måste du använda väljaren till make. Nu kan du det. Enligt dokumentationen rekommenderas 2 * antal_processorer_i_nätverket. Jag har totalt en processor, så det skulle vara i mitt fall. - - - -manual-build -Överskrider allmän -Sätt alternativvärdet till true för att förhindra att byggprocessen försöker bygga modulen. Den hålls fortfarande uppdaterad vid uppdatering från &svn;. Alternativet motsvarar exakt kommandoradsväljaren . - - - -manual-update -Överskrider allmän -Sätt alternativvärdet till true för att förhindra att byggprocessen försöker uppdatera (och som en följd, bygga eller installera) modulen. Om du anger alternativet för en modul, är det i stort sett samma som att kommentera bort den. - - - -module-base-path -Överskrider allmän -Sätt det här alternativet för att överskrida &tdesvn-build;s förvalda katalogväg till modulen i fråga. Det kan till exempel användas för att hämta specifika grenar eller taggade versioner av bibliotek. &kde;:s källkodsvisning är ovärderlig som hjälp för att välja rätt sökväg. -Observera att &tdesvn-build; konstruerar den slutliga sökvägen enligt följande mall: $svn-server/home/kde/$module-base-path/$module-name. -Förvalt värde är antingen trunk eller trunk/KDE, beroende på modulnamn. - - - - -niceness -Kan inte överskridas -Ställ in alternativet till ett tal mellan 20 och 0. Ju högre nummer, desto lägre prioritet ställer &tdesvn-build; in åt sig själv. Förvalt värde är 10. - - - -no-rebuild-on-fail -Överskrider allmän -Ställ in det här alternativvärdet till true för att alltid förhindra att &tdesvn-build; försöker bygga om modulen om en inkrementell byggprocess skulle misslyckas. Normalt försöker &tdesvn-build; bygga om modulen från början för att motverka effekten att en enstaka &svn;-uppdatering orsakar problem med byggsystemet. - - - -override-url -Överskrider allmän -Om du anger alternativet, använder tdesvn-build dess värde som webbadress att skicka till Subversion helt oförändrad. Du bör i allmänhet använda det om du vill ladda ner en specifik utgåva, men tdesvn-build kan inte räkan ut vad du menar genom att använda branch. - - - -qtdir -Kan inte överskridas -Sätt alternativet för att använda miljövariabeln TQTDIR under byggprocessen. Du kan inte överskrida alternativet i ett modulalternativ. Förvalt värde är $(source-dir)/build/qt-copy, som använder modulen qt-copy som ingår i &kde;:s källkodsarkiv. Du kan använda tilde (~) för att representera din hemkatalog. - - - -set-env -Överskrider allmän -Det här alternativet accepterar en uppsättning värden åtskilda av mellanslag, där det första värdet är miljövariabeln att sätta, och följande värden är vad du vill sätta variabeln till. För att till exempel sätta variabeln RONALD till McDonald, skulle du skriva följande kommando under lämplig sektion: -set-env RONALD McDonald -Det här alternativet är speciellt på så sätt att det kan upprepas utan att överskrida tidigare inställningar med set-env i samma sektion av inställningsfilen. På så sätt kan du ange mer än en miljövariabel per modul (eller globalt). - - - - -source-dir -Kan inte överskridas -Det här alternativet används för att ange katalogen på datorn där &kde;:s &svn;-källkod ska lagras. Om du inte anger värdet, är förvalt värde ~/tdesvn. Om du anger värdet, använd en absolut sökväg. - - - -svn-server -Kan inte överskridas -Det här alternativet används för att ange servern som används vid utcheckning från &svn;. Förval är det anonyma &svn;-arkivet, svn://anonsvn.kde.org/. - - - -stop-on-failure -Överskrider allmän -Ställ in det här alternativvärdet till true för att göra att skriptet slutar köra efter ett fel uppstår i bygg- eller installationsprocessen. Alternativet är normalt av. - - - -tag -Överskrider allmän -Använd väljaren för att ladda ner en specifik utgåva av en modul. -Observera: Det är höga odds att du INTE VILL andvända alternativet. KDE-utgåvor är tillgängliga på arkivform från KDE:s FTP-plats eller en av dess spegelplatser. -Om du använder tdesvn-build eftersom du har svårighet att få en KDE-utgåva att bygga på din distribution, fundera på att använda byggverktyget Konstruct istället, som fungerar med utgåvornas arkiv. - - - - -use-qt-builddir-hack -Överskrider allmän -Även om alternativet överskrider det allmänna alternativet, är det bara vettigt för qt-copy. Sätt alternativet till true för att aktivera skriptets experimentella läge med källkatalog skild från byggkatalog. När det är aktiverat, kopierar &tdesvn-build; qt-copy källkodsmodulen till byggkatalogen, och utför byggprocessen därifrån. Det betyder att miljövariabeln TQTDIR istället ska vara inställd till $(qt-copy-build-dir)/qt-copy/lib. Du måste också ändra alternativet qtdir på motsvarande sätt. Att bygga inkrementellt ska fortfarande fungera med detta läge, eftersom tidsstämplar bevaras efter kopieringen. Om du använder alternativet apply-qt-patches, utföra programfixarna i byggkatalogen, inte källkodskatalogen. Alternativets förvalda värde är true. - - - -use-unsermake -Överskrider allmän -Set this option to a non-zero value in order to use the experimental unsermake program instead of automake when running the configure script. This can lead to some serious decreases in build time, especially for distributed building systems. This option defaults to true (for most modules). - - - - - -
- - - - -Kommandoradsväljare och miljövariabler - -Skriptet använder inte miljövariabler. Om du behöver sätta miljövariabler för bygg- eller installationsprocessen, se alternativet set.-env. - -Skriptet accepterar följande kommandoradsväljare: - - - - - -visa bara enkel hjälp om skriptet. - - - - -visa programmets version. - - - - -visa upphovsmannens kontaktinformation. - - - - -aktivera färglagd utmatning. - - - - -inaktivera färglagd utmatning. - - - - (eller ) -utför INTE någonting, men beter sig som om det vore så. - - - - -utför bara uppdatering av källkoden. - - - - -utför bara byggprocessen. - - - - -don't including the modules passed on the rest of the command line in the update/build process. - - - - -hoppa över att kontakta &svn;-servern. - - - - -hoppa över byggprocessen. - - - - -installera inte automatiskt paket efter de har byggts. - - - - -aktiverar felsökningsläge för skriptet. För närvarande betyder det att all utmatning skickas till standardutmatningen förutom att loggas i loggkatalogen som vanligt. Dessutom är många funktioner mycket utförligare om vad de gör i felsökningsläge. - - - - -försök inte att bygga om moduler som har misslyckats att byggas från början. &tdesvn-build; försöker aldrig göra detta med en modul där ett försök att bygga från början redan har gjorts. - - - - -skapa om byggsystemet och bygg från grunden. - - - - -kör skriptet configure igen utan att rensa byggkatalogen. - - - - -kör make Makefile.cvs igen för att skapa skriptet configure, och fortsätt bygga som vanligt. Alternativet inbegriper . - - - - -som försöker att fortsätta bygga från stället där skriptet slutade förra gången. Skriptet börjar bygga modulen efter den senaste modulen som kompilerades sist när skriptet kördes, vare sig det lyckades eller inte. Alternativet inbegriper . Du bör inte ange andra modulnamn på kommandoraden. - - - - -som är som , utom att du anger modulen där byggprocessen ska börja som nästa parameter på kommandoraden. Alternativet inbegriper . Du bör inte ange andra modulnamn på kommandoraden. - - - - -som tolkar nästa kommandoradsväljare som filen att läsa konfigurationsinställningarna från. Förvalt värde för väljaren är ~/.tdesvn-buildrc. - - - - -som låter dig ändra katalogen som &kde; installeras i från kommandoraden. Alternativet inbegriper . - - - - -stoppa efter att ha kört make Makefile.cvs. Skriptet configure behöver fortfarande köras, vilket &tdesvn-build; gör nästa gång. Detta låter dig förbereda alla konfigureringsskript på en gång så att du kan titta på ./configure för varje modul, och redigera dina flaggor till configure i enlighet med det. - - - -om detta är den enda kommandoradsväljaren, försöker skriptet installera alla moduler som har byggts med lyckat resultat, förutom qt-copy som inte behöver installeras. Om kommandoradsväljare anges efter , antas de alla vara moduler att installera. - - - - -Du kan använda väljaren för att överskrida ett alternativ i din inställningsfil för varje modul. För att till exempel överskrida alternativet log-dir, skulle du ange . - - - - -Du kan använda väljaren för att överskrida ett alternativ i inställningsfilen för en viss modul. För att till exempel överskrida alternativet use-unsermake för tdemultimedia, skulle du ange . - - - - -Alla övriga kommandoradsväljare antas vara moduler att uppdatera och bygga. Blanda helst inte ihop bygga och installera. - - - - -Tack till och licenser -&underFDL; - - diff --git a/tde-i18n-sv/docs/tdesdk/tdesvn-build/CMakeLists.txt b/tde-i18n-sv/docs/tdesdk/tdesvn-build/CMakeLists.txt new file mode 100644 index 00000000000..e13b2919123 --- /dev/null +++ b/tde-i18n-sv/docs/tdesdk/tdesvn-build/CMakeLists.txt @@ -0,0 +1,6 @@ +# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer + +tde_create_handbook( + DESTINATION tdesvn-build + LANG sv +) diff --git a/tde-i18n-sv/docs/tdesdk/tdesvn-build/Makefile.am b/tde-i18n-sv/docs/tdesdk/tdesvn-build/Makefile.am new file mode 100644 index 00000000000..81d84f8d685 --- /dev/null +++ b/tde-i18n-sv/docs/tdesdk/tdesvn-build/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = sv +SUBDIRS = $(AUTODIRS) +KDE_DOCS = tdesvn-build +KDE_MANS = AUTO diff --git a/tde-i18n-sv/docs/tdesdk/tdesvn-build/index.docbook b/tde-i18n-sv/docs/tdesdk/tdesvn-build/index.docbook new file mode 100644 index 00000000000..822d5ba6bd8 --- /dev/null +++ b/tde-i18n-sv/docs/tdesdk/tdesvn-build/index.docbook @@ -0,0 +1,688 @@ + + + + + + Subversion"> + tdesvn-build"> +]> + + + + +Handbok för skriptet &tdesvn-build; + + +MichaelPyne
michael.pyne@kdemail.net
 + +CarlosWoelz
carloswoelz@imap-mail.com
 + + + + Stefan Asserhäll
stefan.asserhall@comhem.se
 Översättare + + + + +2005 +Michael Pyne + + + +2005 +Carlos Woelz + + + +&FDLNotice; + +2005-06-18 +0.97 + + +&tdesvn-build; är ett Perl-skript som bygger och installerar &kde;, direkt från källkoden som hämtas från &kde;:s &svn;-arkiv. + + + +KDE +tdesdk +SVN +Subversion +KDE-utveckling + + + + + + +Inledning + +&tdesvn-build; är ett Perl-skript som hjälper användare att installera &kde; från &svn;. Du kanske också vill fundera på att använda skriptet kde-build, som är inkluderat i &kde;:s tdesdk-modul. + +Här dokumenterar vi syntaxen för &tdesvn-build; inställningsfiler, dess kommandoradsväljare, funktioner och en översikt över alla nödvändiga steg som krävs för att bygga &kde; från källkod, inklusive stegen du måste utföra med användning av andra verktyg, eller med andra ord, steg som inte automatiskt utförs av skriptet &tdesvn-build;. + + + + +Komma igång + +I det här kapitlet visar vi hur &tdesvn-build; används för att checka ut moduler från &kde;-arkivet och bygga dem. Vi tillhandahåller också en grundläggande förklaring av &kde;:s &svn;-struktur och stegen du måste utföra innan skriptet körs. + +Alla ämnen som presenteras i det här kapitlet täcks med ännu mer detaljer i guiden Building &kde; from Source Step by Step Guide på hemsidan för &kde;:s kvalitetsgrupp. Om du kompilerar KDE för första gången, är det en god idé att läsa den, eller rådfråga den som en referenskälla. Du hittar detaljerad information om paketverktyg och krav, vanliga fallgropar vid kompilering och strategier och information om att köra den nya &kde;-installationen. + + +Förbereda systemet för att bygga &kde; + +Du rekommenderas att ladda ner och bygga &kde; med ett användarkonto. Om du redan har &kde;-paket installerade, är det bästa valet att skapa en annan (särskild) användare för att bygga och köra det nya &kde;. Fördelen med att bygga &kde; för en särskild användare är att du inte kan förstöra bassystemet, och du har alltid ett sätt att arbeta bekvämt när saker och ting går fel. + +Senare kan du installera som systemadministratör om du vill. Det här dokumentet täcker inte en installation som systemadministratör. Om du utför en systeminstallation, vet du troligen ändå vad du gör. + +Innan du använder skriptet &tdesvn-build; (eller någon annan byggstrategi) måste du installera utvecklingsverktyg och bibliotek som behövs för &kde;. Du behöver Qt-biblioteket, version 3.3.0 eller senare, Automake 1.8, Autoconf 2.5X (bättre med >= 2.57 eftersom ett fel rapporterades med tidigare versioner), subversion-klienten (svn), gcc-kompilatorn med stöd för C++, libxml2, openssl, libbz2 och många fler (för en fullständig lista, besök KDE kompileringskrav). Du kan oftast få verktygen paketerade för ditt system från din distribution eller leverantör. + +Vissa av paketen är uppdelade i bibliotek, program eller verktyg och utvecklingspaket. Du behöver åtminstone programmet eller biblioteket och dess utvecklingspaket. Om du är tveksam installera alla. Biblioteken du behöver ändras beroende på modulerna du avser att bygga, eftersom varje modul har sina egna krav. Guiden Building &kde; from Source Step by Step har mer detaljinformation om specifika verktyg och tekniker som används för att installera och hitta programvaran som krävs. + +Du har troligen redan en version av skriptet &tdesvn-build; installerat på ditt +system. &tdesvn-build; kräver att du skapar en inställningsfil, som heter +.tdesvn-buildrc. Filen ska installeras i hemkatalogen +(~/), och innehålla all inställningsdata som krävs för att skriptet ska kunna +köras, som inställningsalternativ, kompileringsväljare, plats för källkoden, +målet för installationen (prefix), modulerna som ska byggas, etc. Förvald +inställningsdata tillhandahålls i filen +tdesvn-buildrc-sample. Du hittar mer information om +inställningsfilens syntax i +och i . + +Ett bra sätt att hämta senaste versionen är att bläddra till sidan tdesdk/scripts på webbplatsen websvn.kde.org. Du ser en lista med filer tillgängliga i katalogen tdesdk/scripts i &kde;:s &svn;-arkiv. Klicka på länken &tdesvn-build; och ladda ner senaste versionen av skriptet. Gör samma sak med filen tdesvn-buildrc-sample. Gör skriptet körbart, och försäkra dig om att det finns i din sökväg. + + + + +Ange inställningsinformation + +För att använda skriptet måste du ha en fil i din hemkatalog som heter .tdesvn-buildrc, som ställer in allmänna alternativ och anger modulerna som du vill ladda ner och bygga. + +Använd filen tdesvn-buildrc-sample som en mall, för att ställa in allmänna alternativ och modulerna du vill bygga. + +Välj servern som ska användas för att checka ut från &svn; genom att ställa in det allmänna alternativet svn-server. Det anonyma &svn;-arkivet svn://anonsvn.kde.org/ är förvalt, men ändra det om du har ett &kde; &svn;-konto, eller om det finns en spegelplats nära dig. + +Var särskilt uppmärksam på de globala variablerna tdedir och qtdir, eftersom den första anger var det byggda &kde; ska installeras (normalt i ~/kde), och den andra var (och om) Qt-biblioteket ska byggas och installeras (normalt ~/tdesvn/build/qt-copy). Du måste känna till platserna för tdedir och qtdir senare, för att ställa in miljövariablerna som är nödvändiga för att köra den nya installationen. Kontrollera om de listade modulerna i själva verket är modulerna som du vill bygga. De förvalda alternativen i filen tdesvn-buildrc-sample bör vara tillräckliga för att få en någorlunda komplett installation av &kde;. Spara resultatet som .tdesvn-buildrc i din hemkatalog. + +Om du vill finjustera .tdesvn-buildrc, titta då på för detaljerad information om alla inställningsalternativ. + + + + +Att använda skriptet &tdesvn-build; + +Nu är du klar att köra skriptet. Logga in till användaren som du använder för att kompilera &kde; i ett terminalfönster, och kör skriptet: %su utvecklings-användarnamn +%tdesvn-build + + + +Nu ska skriptet börja ladda ner källkoden och kompilera den. Det är inte troligt att du lyckas första gången du kompilerar &kde;. Förtvivla inte! Kontrollera loggfilerna för att se om du saknar några verktyg eller utvecklingspaket (platsen för loggfilerna anges av variabeln log-dir i inställningsfilen). Ibland blir huvudutvecklingsgrenen mycket instabil och svår att bygga, särskilt när en frysning av utvecklingen är nära. Ha tålamod. Du kan hitta fler vanliga exempel på saker som kan gå fel och deras lösning, samt allmänna tips och strategier för att bygga &kde; i guiden Building &kde; from Source Step by Step. + + + + +Ställa in miljön för att köra det färska &kde; + +Med antagandet att du använder en särskild användare för att bygga &kde; och redan har en installerad version av &kde;, kan det vara något krångligt att köra det nya &kde;, eftersom det nya &kde; måste ges företräde över det gamla. Ändra miljövariabler för att försäkra dig om att det gör det. + +Öppna eller skapa filen .bash_profile i hemkatalogen med din favoriteditor, och lägg till följande i slutet på filen: +TDEDIR=(sökväg till tdedir) +TDEDIRS=$TDEDIR +PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH +LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH +export TDEDIRS PATH LD_LIBRARY_PATH + om du bygger modulen qt-copy, lägg istället till: TQTDIR=(sökväg till qtdir) +TDEDIR=(sökväg till tdedir) +TDEDIRS=$TDEDIR +PATH=$TDEDIR/bin:$TQTDIR/bin:$PATH +MANPATH=$TQTDIR/doc/man:$MANPATH +LD_LIBRARY_PATH=$TDEDIR/lib:$TQTDIR/lib:$LD_LIBRARY_PATH +export TQTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH + + + +Om du inte använder en särskild användare, ställ in en annorlunda $TDEHOME för den nya miljön i din .bash_profile: export TDEHOME="${HOME}/.tde-svn" + +# Skapa om det behövs +[ ! -e ~/.trinity-svn ] && mkdir ~/.trinity-svn + + + + +Om menyn senare är tom eller för överfull med program från din distribution, kanske du måste ställa in miljövariabeln xdg i .bash_profile: XDG_CONFIG_DIRS="/etc/xdg" +XDG_DATA_DIRS="${TDEDIR}/share:/usr/share" +export XDG_CONFIG_DIRS XDG_DATA_DIRS + + + + + +Nu när vi är klara med det måste du försäkra dig om att rätt starttde skript kommer att användas: + +Öppna textfilen .xinitrc (eller .xsession, beroende på distribution) i hemkatalogen, eller skapa den om det behövs. Lägg till raden: exec ${TDEDIR}/bin/starttde + + + +Starta nu det färska &kde;: i BSD- och Linux-system med stöd för virtuella terminaler, används tangentkombinationerna Ctrl+Alt+F1..F12 för att byta mellan virtuella konsoller 1 till och med 12. Det låter dig köra mer än en skrivbordsmiljö samtidigt. De första sex är textterminaler, och de följande sex är grafiska skärmar. + +Om den grafiska skärmhanteraren istället visas när du startar, kan du använda den nya KDE-miljön även om den inte listas som ett alternativ. Tryck på Ctrl+Alt+F2, så visas en textterminal. Logga in som den särskilda användaren och skriv: + +startx -- :1 + + + +Du kan köra KDE från källkod och det gamla KDE samtidigt. Logga in som din vanliga användare, och starta det stabila KDE-skrivbordet. Tryck på Ctrl+Alt+F2 (eller F1, F3, etc.), så visas en textterminal. Logga in som den särskilda användaren och skriv "startx -- :1". Du kan gå tillbaka till den vanliga användaren genom att trycka på Ctrl+Alt+F6 (eller F7, F8 etc. Prova dem. En av dem är den rätta.). För att återgå till KDE från källkod, tryck på Ctrl+Alt+F7 (eller F6, F8, etc.). Nu kan du byta mellan dina KDE-versioner, och testa den nya medan du vet att du snabbt kan återgå till säkerheten hos det stabila KDE-skrivbordet. + + + + + + + + +Skriptets funktioner + +Funktionerna i &tdesvn-build; omfattar: + + + + +Checkar automatiskt ut eller uppdaterar moduler från &svn;, enligt vad som är lämpligt. + +Beräknar tiden för att bygga moduler. + +Försöker automatiskt bygga om moduler som använder en inkrementell byggprocess, vilken tenderar att misslyckas efter vissa typer av incheckningar. + +Kan återuppta ett tidigare skript, eller starta byggprocessen från en viss modul. + +Levereras med en inbyggt rimlig uppsättning förvalda alternativ lämpligt för att bygga en grundläggande enanvändarinstallation av &kde; från det anonyma &svn;-arkivet. + +Levereras med stöd för Unsermake. + +Expanderar dina inställningsalternativ med tilde. Du kan till exempel ange: qtdir ~/tdesvn/build/qt-copy + + +Inställningsbara bygg-, källkods-, och loggningskataloger + +Sätter automatiskt upp ett byggsystem, med källkodskatalogen skild från byggkatalogen för att hålla källkodskatalogen orörd. Undantaget är qt-copy, som inte är konstruerad att byggas så (om du inte vill prova QT med separat byggkatalog). + +Du kan ange allmänna alternativ att använda för alla moduler som checkas ut, och du kan dessutom ange alternativ som ska användas för enskilda moduler. + +Eftersom autoverktygen ibland blir osynkroniserade med ändringar i källkodsträdet, kan du tvinga att en modul byggs om genom att skapa en fil som heter refresh-me i byggkatalogen för modulen i fråga, eller genom att köra &tdesvn-build; med väljaren . + +Du kan ange diverse miljövariabler som ska användas under byggprocessen, inklusive TDEDIR, TQTDIR, DO_NOT_COMPILE och CXXFLAGS. + +Kommandologgning. Loggar dateras och numreras så att du alltid har en logg av en körning av skriptet. Dessutom skapas en symbolisk länk som heter latest, som alltid pekar på den senaste loggen i loggkatalogen. + +Om du använder en användarbyggd &kde; istället för en systembyggd (som du måste vara systemadministratör för att installera), kan du låta skriptet installera åt dig. Jag har inte granskat koden, och den använder anropet system() flitigt, så jag rekommenderar för närvarande att inte köra den som systemadministratör. + +Du kan använda make-install-prefix för att inleda byggkommandoraden med ett separat kommando, som är användbart för sudo. + +Du kan använda alternativet apidox för att automatiskt bygga och installera dokumentation om programmeringsgränssnittet för vissa moduler. + +Du kan checka ut bara en delmängd av en &kde; &svn;-modul. Du skulle till exempel kunna checka ut bara taglib från tdesupport, eller bara K3B från extragear/multimedia. Skriptet hämtar automatiskt in kde-common om det behövs för att få byggprocessen att fungera. + +Du kan låtsas att utföra åtgärden. Om du skickar med eller på kommandoraden, ger skriptet en mycket utförlig beskrivning av de kommandon som ska göras, utan att i själva verket utföra dem. + +Stöd för att checka ut specifika grenar av &svn;-moduler. Arbetet behöver fortfarande göras färdigt, men du kan redan välja grenen du vill bygga med inställningsalternativet module-base-path. + + + +Saker som &tdesvn-build; INTE gör: + + + +Hitta den snabbaste spegelplatsen för &kde; &svn;. Det finns inte ens en lista medskickad med skriptet för närvarande, även om förvald server bör fungera bra. + +Borsta tänderna. Du måste komma ihåg att göra det själv. + +Tyvärr är skriptet troligen inte fritt från fel. + + + + + + +Formatet för .tdesvn-buildrc + +För att använda skriptet måste du ha en fil i din hemkatalog som heter .tdesvn-buildrc, som beskriver modulerna som du vill ladda ner och bygga. + + + +Den börjar med allmänna alternativ, angivna enligt följande: + +global +alternativ-namn alternativ-värde +[...] +end global + + +De följs därefter av en eller flera modulsektioner, angivna på följande sätt: + +module modul-namn +alternativ-namn alternativ-värde +[...] +end module + + +modul-namn måste vara en modul i &kde;:s &svn;-arkiv (till exempel tdelibs eller tdebase). Vissa alternativ överskrider de allmänna alternativen, vissa lägger till i de allmänna alternativen och vissa allmänna alternativ kan helt enkelt inte överskridas. + +Följande är en alfabetisk lista med alternativ du kan använda. Klicka på alternativet för att ta reda på mer om det. Om något inte är dokumenterat, skicka gärna e-post till upphovsmännen med adressen som du hittar ovan. + + +apidox, för att bygga dokumentation över programmeringsgränssnittet +apply-qt-patches, för att förbättra qt-copy +binpath, för att ställa in variabeln PATH. +branch, för att checka ut från en gren istället för /trunk. +build-dir, för att ange katalog att bygga i. +checkout-only, för att bara checka ut delar av en modul. +colorful-output för att lägga till färg i skriptets utmatning. +configure-flags för att ange vilka flaggor en modul ska ställas in med. +cxxflags för att definiera variabeln CXXFLAGS. +dest-dir för att ändra katalognamn för en modul. +do-not-compile, för att markera kataloger så att de hoppas över av byggprocessen. +inst-apps, för att bara bygga och installera vissa kataloger. +install-after-build, för att undvika att installera efter byggprocessen. +tdedir, för att ange katalog att installera KDE i. +libpath, för att sätta variabeln LD_LIBRARY_PATH. +make-install-prefix, för att köra ett hjälpprogram (som sudo) under installationen. +make-options, för att skicka väljare till byggprogrammet. +manual-build, för att undvika att modulen byggs automatiskt. +manual-update, för att undvika att någonting görs automatiskt med modulen. +module-base-path, för att ändra varifrån modulen laddas ner.(användbart för grenar och taggar). +niceness, för att ändra processorprioriteten. +no-rebuild-on-fail, för att undvika att köra byggprocessen igen om den misslyckas. +qtdir, för att ange sökväg till Qt. +set-env, för att sätta en miljövariabel. +source-dir, för att ändra vart källkoden laddas ner. +stop-on-failure, för att få .tdesvn-build att stoppa så fort ett allvarligt fel hittas. +svn-server, för att ändra servern som källkoden automatiskt laddas ner från. +use-qt-builddir-hack, för att ge Qt en separat byggkatalog från källkoden, som KDE. +use-unsermake, för att använda det avancerade byggsystemet unsermake. + + + +Här är en tabell över de olika alternativen, och några kommentarer om dem. Alla alternativ som överskrider det allmänna alternativet, överskrider också en kommandoradsväljare. + + +Alternativtabell + + + + +Alternativnamn +Modul -> Allmänt beteende +Anmärkningar + + + + + + +apidox +Överskrider allmän +Sätt alternativet till true för att få &tdesvn-build; att automatiskt bygga och installera dokumentation om programmeringsgränssnittet för modulen efter den normala byggprocessen. Det fungerar bara för moduler där make apidox gör någonting, inklusive , bland annat tdelibs, tdebase och koffice. + + + +apply-qt-patches +Överskrider allmän +Det här alternativet är bara användbart för qt-copy. Om det är inställt till ett värde skilt från noll, körs skriptet apply-patches i qt-copy innan byggprocessen, för att utföra inofficiella programfixar i qt-copy. Eftersom dessa programfixar normalt är orsaken till att använda qt-copy istället för en standardversion av Qt, ska det inte vara skadligt att aktivera det. Förvalt värde är att aktivera programfixarna. + + + +binpath +Kan inte överskridas +Sätt alternativet för att använda miljövariabeln PATH under byggprocessen. Du kan inte överskrida alternativet i ett modulalternativ. Förvalt värde är /bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin. Miljövariabeln ska innehålla sökvägar till utvecklingsverktygen åtskilda med kolon. Sökvägarna $TDEDIR/bin och $TQTDIR/bin läggs automatiskt till. Du kan använda tilde (~) för eventuella sökvägar du lägger till med det här alternativet. + + + + +branch +Överskrider allmän +Ange alternativet för att checka ut från en gren av KDE istället för det förvalda "trunk", där KDE-utveckling sker. För att till exempel checka ut grenen KDE 3.4, skulle du ange alternativet "3.4". +Observera att vissa moduler använder ett annorlunda grennamn. I synnerhet följer inte modulen arts som krävs KDE:s versionsnummer. Modulen arts som hörde ihop med KDE 3.4 var version 1.4. +Om tdesvn-build misslyckas med att ladda ner en gren med alternativet, kan du behöva ange webbadressen att ladda ner från för hand med alternativet override-url. + + + + +build-dir +Överskrider allmän +Använd det här alternativet för att byta katalog som innehåller källkoden att bygga. Det finns tre olika sätt att använda det: Relativt till &kde;:&svn;-källkodskatalog (se alternativet source-dir). Det är förvalt, och sättet som skriptet fungerade fram till version 0.61. Läget väljes om du skriver in ett katalognamn som inte börjar med tilde (~) eller snedstreck (/).Förvalt värde är buildAbsolut sökväg. Om du anger en sökväg som börjar med /, används sökvägen direkt. Till exempel /tmp/kde-obj-dir/Relativt till din hemkatalog. Om du anger en sökväg som börjar med ~, används sökvägen relativt till din hemkatalog, på motsvarande sätt som skalets expansion av tilde. Till exempel skulle ~/builddir ställa in byggkatalogen till /home/användarnamn/builddir Alternativet kan, kanske något oväntat, ändras per modul. + + + +checkout-only +Överskrider allmän +Sätt det här alternativet för att checka ut källkod från &svn; del för del. Värdet av alternativet ska vara en lista med kataloger åtskilda med mellanslag att checka ut. Om du inte inkluderar katalogen admin, inkluderas den automatiskt (om det behövs). När du checkar ut del för del hämtas katalogen admin in från kde-common, vilket är platsen den finns på &svn;-servern. Även om alternativet överskrider det allmänna alternativet, var medveten om att ange alternativet som ett allmänt alternativ inte är vettigt. + + + +configure-flags +Lägger till i allmänna alternativ (utom för qt-copy) +Använd det här alternativet för att ange vilka flaggor som ska skickas till ./configure när byggsystemet för modulen skapas. När det används som ett allmänt alternativ, används det för alla moduler som skriptet bygger. qt-copy använder en mycket annorlunda uppsättning inställningsalternativ än resten av &kde;, så det här alternativet överskrider de globala inställningarna när det används för qt-copy. + + + +colorful-output +Kan inte överskridas +Ställ in det här alternativet till false för att inaktivera färglagd utmatning från &tdesvn-build;. Alternativet är normalt true. Observera att &tdesvn-build; inte matar ut färgkoderna till någonting annat än en terminal (som xterm, &konsole; eller den vanliga Linux-konsollen). + + + +cxxflags +Lägger till i allmänna alternativ +Använd det här alternativet för att ange vilka flaggor som ska skickas till ./configure som CXXFLAGS när byggsystemet för modulen skapas. Alternativet anges här istället för med configure-flags eftersom alternativet också sätter miljövariabeln CXXFLAGS under byggprocessen. + + + +dest-dir +Överskrider allmän +Använd det här alternativet för att ändra namnet en modul ges på disk. Om modulen till exempel var extragear/network, skulle du kunna byta namn på den till extragear-network med alternativet. + + + +do-not-compile +Överskrider allmän +Använd det här alternativet för att sätta miljövariabeln DO_NOT_COMPILE innan skriptet configure körs. Enligt &kde;:s vanliga frågor för utvecklare, ska det göra att alla toppnivåkataloger du skickar med inte byggs. Katalogerna ska skiljas åt med mellanslag. + +Observera att källkoden till programmen fortfarande laddas ner. Du kan använda direktivet checkout-only för att välja kataloger som du vill checka ut. + + + + +inst-apps +Överskrider allmän +Det här är motsatsen till alternativet do-not-compile. Alternativet gör att bara angivna toppnivåkataloger byggs. Katalogerna ska åtskiljas med mellanslag. + +Eventuella ändringar får ingen effekt förrän nästa gång make Makefile.cvs körs, antingen automatiskt av skriptet, eller manuellt med alternativen eller . + +Observera att källkoden till programmen fortfarande laddas ner. Du kan använda direktivet checkout-only för att välja kataloger som du vill checka ut. + + + + +install-after-build +Överskrider allmän +Det här alternativet används för att installera paketet efter det har byggts med lyckat resultat. Alternativet är normalt aktiverat. Om du vill inaktivera det, måste du sätta alternativet till 0 i inställningsfilen. Du kan också använda kommandoradsväljaren . + + + +tdedir +Kan inte överskridas +Det här alternativet anger katalogen som &kde; installeras i efter det har byggts. Förvalt värde är ~/kde. Om du ändrar det till en katalog som kräver åtkomst som systemadministratör, bör du också läsa om alternativet make-install-prefix. + + + +libpath +Kan inte överskridas +Ange det här alternativet för att sätta miljövariabeln LD_LIBRARY_PATH under byggprocessen. Du kan inte överskrida inställningen med ett modulalternativ. Förvalt värde är tomt, men sökvägarna $TDEDIR/lib och $TQTDIR/lib läggs automatiskt till. Du kan använda tilde (~) i alla sökvägar du lägger till med alternativet. + + + +log-dir +Överskrider allmän +Använd det här alternativet för att ändra katalogen som används för att lagra loggfiler som skapas av skriptet. Inställningen kan ändras per modul från och med version 0.64 eller senare. + + + +make-install-prefix +Överskrider allmän +Sätt den här variabeln till en lista åtskilda med mellanslag, som tolkas som ett kommando och dess väljare för att föregå kommandot make install som används för att installera moduler. Det är användbart för att till exempel installera paket med sudo, men var försiktig när du hanterar systemadministratörsrättigheter. + + + +make-options +Överskrider allmän +Ange den här variabeln för att skicka kommandoradsväljare till kommandot make. Det är användbart för program som distcc. Programmet distcc låter dig dela upp ditt kompileringsarbete på mer än en dator. För att använda det, måste du använda väljaren till make. Nu kan du det. Enligt dokumentationen rekommenderas 2 * antal_processorer_i_nätverket. Jag har totalt en processor, så det skulle vara i mitt fall. + + + +manual-build +Överskrider allmän +Sätt alternativvärdet till true för att förhindra att byggprocessen försöker bygga modulen. Den hålls fortfarande uppdaterad vid uppdatering från &svn;. Alternativet motsvarar exakt kommandoradsväljaren . + + + +manual-update +Överskrider allmän +Sätt alternativvärdet till true för att förhindra att byggprocessen försöker uppdatera (och som en följd, bygga eller installera) modulen. Om du anger alternativet för en modul, är det i stort sett samma som att kommentera bort den. + + + +module-base-path +Överskrider allmän +Sätt det här alternativet för att överskrida &tdesvn-build;s förvalda katalogväg till modulen i fråga. Det kan till exempel användas för att hämta specifika grenar eller taggade versioner av bibliotek. &kde;:s källkodsvisning är ovärderlig som hjälp för att välja rätt sökväg. +Observera att &tdesvn-build; konstruerar den slutliga sökvägen enligt följande mall: $svn-server/home/kde/$module-base-path/$module-name. +Förvalt värde är antingen trunk eller trunk/KDE, beroende på modulnamn. + + + + +niceness +Kan inte överskridas +Ställ in alternativet till ett tal mellan 20 och 0. Ju högre nummer, desto lägre prioritet ställer &tdesvn-build; in åt sig själv. Förvalt värde är 10. + + + +no-rebuild-on-fail +Överskrider allmän +Ställ in det här alternativvärdet till true för att alltid förhindra att &tdesvn-build; försöker bygga om modulen om en inkrementell byggprocess skulle misslyckas. Normalt försöker &tdesvn-build; bygga om modulen från början för att motverka effekten att en enstaka &svn;-uppdatering orsakar problem med byggsystemet. + + + +override-url +Överskrider allmän +Om du anger alternativet, använder tdesvn-build dess värde som webbadress att skicka till Subversion helt oförändrad. Du bör i allmänhet använda det om du vill ladda ner en specifik utgåva, men tdesvn-build kan inte räkan ut vad du menar genom att använda branch. + + + +qtdir +Kan inte överskridas +Sätt alternativet för att använda miljövariabeln TQTDIR under byggprocessen. Du kan inte överskrida alternativet i ett modulalternativ. Förvalt värde är $(source-dir)/build/qt-copy, som använder modulen qt-copy som ingår i &kde;:s källkodsarkiv. Du kan använda tilde (~) för att representera din hemkatalog. + + + +set-env +Överskrider allmän +Det här alternativet accepterar en uppsättning värden åtskilda av mellanslag, där det första värdet är miljövariabeln att sätta, och följande värden är vad du vill sätta variabeln till. För att till exempel sätta variabeln RONALD till McDonald, skulle du skriva följande kommando under lämplig sektion: +set-env RONALD McDonald +Det här alternativet är speciellt på så sätt att det kan upprepas utan att överskrida tidigare inställningar med set-env i samma sektion av inställningsfilen. På så sätt kan du ange mer än en miljövariabel per modul (eller globalt). + + + + +source-dir +Kan inte överskridas +Det här alternativet används för att ange katalogen på datorn där &kde;:s &svn;-källkod ska lagras. Om du inte anger värdet, är förvalt värde ~/tdesvn. Om du anger värdet, använd en absolut sökväg. + + + +svn-server +Kan inte överskridas +Det här alternativet används för att ange servern som används vid utcheckning från &svn;. Förval är det anonyma &svn;-arkivet, svn://anonsvn.kde.org/. + + + +stop-on-failure +Överskrider allmän +Ställ in det här alternativvärdet till true för att göra att skriptet slutar köra efter ett fel uppstår i bygg- eller installationsprocessen. Alternativet är normalt av. + + + +tag +Överskrider allmän +Använd väljaren för att ladda ner en specifik utgåva av en modul. +Observera: Det är höga odds att du INTE VILL andvända alternativet. KDE-utgåvor är tillgängliga på arkivform från KDE:s FTP-plats eller en av dess spegelplatser. +Om du använder tdesvn-build eftersom du har svårighet att få en KDE-utgåva att bygga på din distribution, fundera på att använda byggverktyget Konstruct istället, som fungerar med utgåvornas arkiv. + + + + +use-qt-builddir-hack +Överskrider allmän +Även om alternativet överskrider det allmänna alternativet, är det bara vettigt för qt-copy. Sätt alternativet till true för att aktivera skriptets experimentella läge med källkatalog skild från byggkatalog. När det är aktiverat, kopierar &tdesvn-build; qt-copy källkodsmodulen till byggkatalogen, och utför byggprocessen därifrån. Det betyder att miljövariabeln TQTDIR istället ska vara inställd till $(qt-copy-build-dir)/qt-copy/lib. Du måste också ändra alternativet qtdir på motsvarande sätt. Att bygga inkrementellt ska fortfarande fungera med detta läge, eftersom tidsstämplar bevaras efter kopieringen. Om du använder alternativet apply-qt-patches, utföra programfixarna i byggkatalogen, inte källkodskatalogen. Alternativets förvalda värde är true. + + + +use-unsermake +Överskrider allmän +Set this option to a non-zero value in order to use the experimental unsermake program instead of automake when running the configure script. This can lead to some serious decreases in build time, especially for distributed building systems. This option defaults to true (for most modules). + + + + + +
+ + + + +Kommandoradsväljare och miljövariabler + +Skriptet använder inte miljövariabler. Om du behöver sätta miljövariabler för bygg- eller installationsprocessen, se alternativet set.-env. + +Skriptet accepterar följande kommandoradsväljare: + + + + + +visa bara enkel hjälp om skriptet. + + + + +visa programmets version. + + + + +visa upphovsmannens kontaktinformation. + + + + +aktivera färglagd utmatning. + + + + +inaktivera färglagd utmatning. + + + + (eller ) +utför INTE någonting, men beter sig som om det vore så. + + + + +utför bara uppdatering av källkoden. + + + + +utför bara byggprocessen. + + + + +don't including the modules passed on the rest of the command line in the update/build process. + + + + +hoppa över att kontakta &svn;-servern. + + + + +hoppa över byggprocessen. + + + + +installera inte automatiskt paket efter de har byggts. + + + + +aktiverar felsökningsläge för skriptet. För närvarande betyder det att all utmatning skickas till standardutmatningen förutom att loggas i loggkatalogen som vanligt. Dessutom är många funktioner mycket utförligare om vad de gör i felsökningsläge. + + + + +försök inte att bygga om moduler som har misslyckats att byggas från början. &tdesvn-build; försöker aldrig göra detta med en modul där ett försök att bygga från början redan har gjorts. + + + + +skapa om byggsystemet och bygg från grunden. + + + + +kör skriptet configure igen utan att rensa byggkatalogen. + + + + +kör make Makefile.cvs igen för att skapa skriptet configure, och fortsätt bygga som vanligt. Alternativet inbegriper . + + + + +som försöker att fortsätta bygga från stället där skriptet slutade förra gången. Skriptet börjar bygga modulen efter den senaste modulen som kompilerades sist när skriptet kördes, vare sig det lyckades eller inte. Alternativet inbegriper . Du bör inte ange andra modulnamn på kommandoraden. + + + + +som är som , utom att du anger modulen där byggprocessen ska börja som nästa parameter på kommandoraden. Alternativet inbegriper . Du bör inte ange andra modulnamn på kommandoraden. + + + + +som tolkar nästa kommandoradsväljare som filen att läsa konfigurationsinställningarna från. Förvalt värde för väljaren är ~/.tdesvn-buildrc. + + + + +som låter dig ändra katalogen som &kde; installeras i från kommandoraden. Alternativet inbegriper . + + + + +stoppa efter att ha kört make Makefile.cvs. Skriptet configure behöver fortfarande köras, vilket &tdesvn-build; gör nästa gång. Detta låter dig förbereda alla konfigureringsskript på en gång så att du kan titta på ./configure för varje modul, och redigera dina flaggor till configure i enlighet med det. + + + +om detta är den enda kommandoradsväljaren, försöker skriptet installera alla moduler som har byggts med lyckat resultat, förutom qt-copy som inte behöver installeras. Om kommandoradsväljare anges efter , antas de alla vara moduler att installera. + + + + +Du kan använda väljaren för att överskrida ett alternativ i din inställningsfil för varje modul. För att till exempel överskrida alternativet log-dir, skulle du ange . + + + + +Du kan använda väljaren för att överskrida ett alternativ i inställningsfilen för en viss modul. För att till exempel överskrida alternativet use-unsermake för tdemultimedia, skulle du ange . + + + + +Alla övriga kommandoradsväljare antas vara moduler att uppdatera och bygga. Blanda helst inte ihop bygga och installera. + + + + +Tack till och licenser +&underFDL; + + -- cgit v1.2.1