diff options
Diffstat (limited to 'tde-i18n-da/docs/kdevelop/kdevelop/kdevelop-install.docbook')
| -rw-r--r-- | tde-i18n-da/docs/kdevelop/kdevelop/kdevelop-install.docbook | 1292 |
1 files changed, 1292 insertions, 0 deletions
diff --git a/tde-i18n-da/docs/kdevelop/kdevelop/kdevelop-install.docbook b/tde-i18n-da/docs/kdevelop/kdevelop/kdevelop-install.docbook new file mode 100644 index 00000000000..3e53cceaf67 --- /dev/null +++ b/tde-i18n-da/docs/kdevelop/kdevelop/kdevelop-install.docbook @@ -0,0 +1,1292 @@ +<appendix id="kdevelop-install"> + +<appendixinfo> + <authorgroup> + <author +><firstname +>Bernd</firstname +><surname +>Pol</surname +></author> + <author +><firstname +>Anne-Marie</firstname +><surname +>Mahfouf</surname +></author> + <!-- ROLES_OF_TRANSLATORS --> + </authorgroup> +</appendixinfo> + +<title +>Installering af &kdevelop;</title> + +<indexterm zone="kdevelop-install"> + <primary +>Installation</primary +></indexterm> + +<para +>Her finder du alle skridt som behøves for at kompilere og installere det integrerede udviklingsmiljø &kdevelop;: <itemizedlist> + <listitem +><para +><link linkend="kdevelop-install-howto" +>Hvordan man får fat på &kdevelop;</link +> koncentrerer sig om hvordan man henter den seneste kildekode for &kdevelop; fra svn. </para +></listitem> + <listitem +><para +><link linkend="requirements" +>Krav for &kdevelop;</link +> giver en liste af programmer og biblioteker som du skal have installerede for at det skal lykkes at kompilere det integrerede udviklingsmiljø. </para +></listitem> + <listitem +><para +><link linkend="compile-and-install" +>Kompilering og installation af &kdevelop;</link +> leder dig gennem alle skridt for kompilering og installation af programmet. </para +></listitem> + <listitem +><para +><link linkend="make-api" +>Hvordan man får fat på dokumentation af programmeringsgrænsefladen for &kdevelop;</link +> fortæller hvad en programmeringsgrænseflade er og hvordan du får fat på et så nyttigt værktøj for navigering i kildekoden for &kdevelop;. </para +></listitem> +</itemizedlist> +</para> + +<sect1 id="kdevelop-install-howto"> +<title +>Hvordan man får fat på &kdevelop;</title> + +<indexterm zone="kdevelop-install-howto"> + <primary +>få fat på &kdevelop;</primary +></indexterm> +<indexterm zone="kdevelop-install-howto"> + <primary +>&kdevelop;</primary> + <secondary +>få fat på</secondary +></indexterm> + +<para +>&kdevelop; er tilgængelig i binær form fra mange forskellige &Linux;-distributioner såsom SuSE, RedHat med flere. De binære filer er pakkede på en bekvem måde, oftest RPM, for nemt at kunne installeres. Følg standardinstruktionerne som gives i distributionen for at installere. </para> +<para +>Du kan også få fat på kildekoden for &kdevelop;, kompilere og installere den selv. Kildekoden findes via projektets hjemmeside på <ulink url="http://www.kdevelop.org" +>http://www.kdevelop.org</ulink +> eller via <ulink url="http://download.kde.org" +>&kde;'s FTP-sted</ulink +>. </para> + +<sect2 id="howto-svn"> +<title +>Hente dagsfriske udgaver af &kdevelop; fra svn</title> + +<indexterm zone="howto-svn"> + <primary +>svn</primary +></indexterm> + +<para +>Hvis du vil tage del i nuværende udvikling, er versioner fra det anonyme SVN-arkiv tilgængelige.</para> +<para +>Modulnavnet er <emphasis +>kdevelop</emphasis +> med <filename class="directory" +>svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/kdevelop</filename +>. </para> + +<sect3 id="howto-svn-co"> +<title +>Oprindelig udtjekning fra svn</title> + +<indexterm zone="howto-svn-co"> + <primary +>udtjekning</primary +></indexterm> +<indexterm zone="howto-svn-co"> + <primary +>&kdevelop;</primary> + <secondary +>svn</secondary> + <tertiary +>udtjekning</tertiary +></indexterm> + +<para +>For at få en oprindelig udgave af &kdevelop; skal du hente den fra anonym svn. For denne såkaldte <emphasis +>udtjekningshandling</emphasis +> følges skridtene nedenfor. </para> + +<note +><para +>Vi antager vi at du ønsker at placere din kopi af &kdevelop; i mappen <filename class="directory" +>/kde3src/kdevelop</filename +> undermappen af din hjemmemappe(<filename class="directory" +>~</filename +>). </para +></note> + +<informalexample +><simplelist> + <member +># Opret målmappen om nødvendigt: </member> + <member +><prompt +>~> </prompt +> <userinput +>mkdir kde3src</userinput +> </member> + <member +><prompt +>~> </prompt +> <userinput +>cd kde3src</userinput +> </member> + <member +><prompt +>~/kde3src> </prompt +> <userinput +>svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/kdevelop</userinput +> </member> + <member +><prompt +>~/kde3src> </prompt +> <userinput +>cd kdevelop</userinput +> </member> +</simplelist +></informalexample> + +<note +><para +>Når du er lykkedes at tjekke din version af &kdevelop; ud, kan du følge med i ændringerne ved at bruge opdateringsproceduren som vises i næste afsnit. </para +></note> + +<important +><para +>Hold serverbelastningen lav. <emphasis +>Vær venlig ikke at tjekke ud hver gang du vil have en ny version af &kdevelop;</emphasis +> Brug svn update til dette formål. </para +></important> + +<para +>Nu kan du kompilere din version af &kdevelop; som vist i kapitlet <link linkend="compile-and-install" +>Kompilering og installation af &kdevelop;</link +>. </para> + +</sect3 +> <!-- howto-svn-co --> + +<sect3 id="howto-svn-up"> +<title +>Hold din kopi af svn opdateret</title> + +<indexterm zone="howto-svn-up"> + <primary +>opdatér</primary +></indexterm> +<indexterm zone="howto-svn-up"> + <primary +>&kdevelop;</primary> + <secondary +>svn</secondary> + <tertiary +>opdatér</tertiary +></indexterm> + +<para +>Efter du har tjekket &kdevelop; ud fra svn som vist ovenfor (og det er lykkedes at kompilere den), vil du holde den aktuel for at få alle programrettelser med. Følg så skridtene nedenfor. (Vi antager igen at du har placeret din kopi af &kdevelop; i mappen <filename class="directory" +>kde3src</filename +>.) </para> +<para +>Bemærk kommandoen <command +>up</command +> (= <emphasis +>update</emphasis +>) i stedet for <command +>co</command +> (hvilket betyder <emphasis +>checkout</emphasis +>). </para> + +<informalexample +><simplelist> + <member +><prompt +>~> </prompt +> <userinput +>cd kde3src</userinput +> </member> + <member +><prompt +>~/kde3src> </prompt +> <userinput +>cd kdevelop</userinput +> </member> + <member +><prompt +>~/kde3src> </prompt +> <userinput +>svn up</userinput +> </member> +</simplelist +></informalexample> + +<note +><para +>Hold øje med meddelelserne som svn viser under opdateringssekvensen. De nøjagtige skridt i kompileringssekvensen afhænger af dem. </para +></note> + +<para +>Nu kan du kompilere en ny version af &kdevelop; som vist i kapitlet <link linkend="compile-and-install-make-svn" +>Særlige hensyn ved kompilering fra svn</link +>. </para> +</sect3 +> <!-- howto-svn-up --> + +</sect2 +> <!-- howto-svn --> + +</sect1 +> <!-- howto --> + +<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> + +<sect1 id="requirements"> +<title +>Krav for &kdevelop;</title> + +<indexterm zone="requirements"> + <primary +>krav</primary +></indexterm> +<indexterm zone="requirements"> + <primary +>&kdevelop;</primary> + <secondary +>krav</secondary +></indexterm> +<indexterm zone="requirements"> + <primary +>GNU</primary> + <secondary +>krav</secondary +></indexterm> + +<para +>For at det skal lykkes at kompilere og bruge &kdevelop;, behøver du følgende programmer og biblioteker. De er tilgængelige på de fleste platforme som distributionspakke, og kan derved let installeres. </para> + +<itemizedlist> +<title +>Krævet</title> + <listitem> + <para +><application +>gcc/g++</application +> ≥ 2.95.3 (eller tilsvarende) <indexterm> + <primary +>gcc</primary> + <secondary +>krav</secondary +></indexterm> + <indexterm> + <primary +>g++</primary> + <secondary +>krav</secondary +></indexterm> + </para> + <para +>Tilgængelig fra <ulink url="gcc.gnu.org" +>gcc.gnu.org</ulink +> </para> + </listitem> + <listitem> + <para +><application +>&GNU; make</application +> (eller tilsvarende) <indexterm> + <primary +>make</primary> + <secondary +>krav</secondary +></indexterm> + </para> + <para +>Tilgængelig fra <ulink url="www.gnu.org/software/make" +>www.gnu.org/software/make</ulink +> </para> + </listitem> + <listitem> + <para +>&perl; 5.004 (eller nyere) <indexterm> + <primary +>Perl</primary> + <secondary +>krav</secondary +></indexterm> + </para> + <para +>Tilgængelig fra <ulink url="www.perl.com" +>www.perl.com</ulink +> </para> + </listitem> + <listitem> + <para +><application +>autoconf</application +> ≥ 2.52 (eller nyere) <indexterm> + <primary +>autoconf</primary> + <secondary +>krav</secondary +></indexterm> + </para> + <para +>Tilgængelig fra <ulink url="www.gnu.org/software/autoconf" +>www.gnu.org/software/autoconf</ulink +> </para> + </listitem> + <listitem> + <para +><application +>automake</application +> ≥ 1.6 (eller nyerer) <indexterm> + <primary +>automake</primary> + <secondary +>krav</secondary +></indexterm> + </para> + <para +>Tilgængelig fra <ulink url="www.gnu.org/software/automake" +>www.gnu.org/software/automake</ulink +> </para> + </listitem> + <listitem> + <para +><application +>flex</application +> 2.5.4 (eller nyere) <indexterm> + <primary +>flex</primary> + <secondary +>krav</secondary +></indexterm> + </para> + <para +>Tilgængelig fra <ulink url="www.gnu.org/software/flex" +>www.gnu.org/software/flex</ulink +> </para> + </listitem> + <listitem> + <para +>&Qt; ≥ 3.3.0 (eller nyere) <indexterm> + <primary +>Qt</primary> + <secondary +>krav</secondary +></indexterm> + </para> + <para +>Tilgængelig fra <ulink url="www.trolltech.com/products/qt" +>www.trolltech.com/products/qt</ulink +> </para> + </listitem> + <listitem> + <para +><application +>KDE</application +> ≥ 3.4.0 (eller nyere) <indexterm> + <primary +>KDE</primary> + <secondary +>krav</secondary +></indexterm> + </para> + <para +>Tilgængelig fra <ulink url="www.kde.org" +>www.kde.org</ulink +> </para> + </listitem> +</itemizedlist> + +<itemizedlist> +<title +>Valgfrit:</title> + <listitem +><para +>Værktøjet <emphasis +><application +>ctags</application +></emphasis +> til kildekodenavigering, fra <ulink url="http://ctags.sourceforge.net" +>http://ctags.sourceforge.net</ulink +>, som giver dig hurtig adgang til deklarationer og definitioner med nogle få enkle klik på et navn i editoren. <indexterm +><primary +>ctags</primary +></indexterm> + </para +></listitem> + <listitem +><para +>Oversætteren <emphasis +><application +>dot</application +></emphasis +> for grafiksprog, fra <ulink url="http://www.graphviz.org" +>http:/www.graphviz.org</ulink +>. Værktøjet behøves sammen med &doxygen; nedenfor, hvis du vil vise klasseforholdene grafisk (hvilket stærkt anbefales). <indexterm +><primary +>dot</primary +></indexterm> + </para +></listitem> + <listitem +><para +>Dokumentationsværktøjet <emphasis +>&doxygen;</emphasis +>, fra <ulink url="http://www.doxygen.org" +>http://www.doxygen.org</ulink +>, hvis du vil lave koncis og kraftfuld dokumentation af programmeringsgrænsefladen for dine projekter. <indexterm +><primary +>doxygen</primary +></indexterm> + </para +></listitem> + <listitem +><para +><emphasis +><application +>Valgrind</application +></emphasis +> fra <ulink url="http://developer.kde.org/~sewardj/" +>http://developer.kde.org/~sewardj/</ulink +> hjælper dig med at finde hukommelseshåndteringsproblemer i dine programmer. <indexterm +><primary +>valgrind</primary +></indexterm> + </para +></listitem> + <listitem +><para +><emphasis +><application +>SVN</application +></emphasis +> fra <ulink url="http://subversion.tigris.org/" +>http://subversion.tigris.org/</ulink +>, hvis du vil bruge versionshåndteringssystemet SVN. <indexterm> + <primary +>svn</primary> + <secondary +>krav</secondary +></indexterm> + </para +></listitem> + <listitem +><para +>Eventuelt andre oversættere og/eller værktøjer hvis du vil udvikle for et andet sprog eller platform end C++/&kde;, eller bruge en anden specialfunktion. </para +></listitem> +</itemizedlist> + +<note> +<orderedlist> + <listitem> + <para +>Du kan i et vist omfang omgå behovet for &autoconf; ≥ 2.52 og &automake; ≥ 1.6. Fjern blot mappen <filename class="directory" +>admin</filename +> i installationsmappen for &kdevelop;, og skriv: <indexterm> + <primary +>autoconf</primary> + <secondary +>omgå versionsbehov</secondary +></indexterm> + <indexterm> + <primary +>automake</primary> + <secondary +>omgå versionsbehov</secondary +></indexterm> + <indexterm> + <primary +>versionsbehov</primary> + <secondary +>omgå behov for autoconf og automake</secondary +></indexterm> + </para> + <informalexample +><simplelist> + <member +><prompt +>(din kdevelop-mappe)> </prompt +> <userinput +>ln -s $KDEDIR/share/apps/kdelibs/admin admin</userinput +></member> + </simplelist +></informalexample> + <para +>i terminalen. Det gør at &kdevelop; bruger standardindstillingerne i &kde;'s <filename class="directory" +>admin</filename +>-mappe i stedet. </para> + </listitem> + <listitem> + <para +>Vær forsigtig så du <emphasis +>ikke blander forskellige versioner af &Qt;</emphasis +>. Link altid &kdevelop; med samme version af &Qt; som &kde;-biblioteket kompileredes med. Ellers vil du formodentlig komme ud for <emphasis +>meget mærkelig</emphasis +> opførsel. </para> + </listitem> +</orderedlist> +</note> + +</sect1 +> <!-- requirements --> + +<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> + +<sect1 id="compile-and-install"> +<title +>Kompilering og installation af &kdevelop;</title> + +<indexterm zone="compile-and-install"> + <primary +>&kdevelop;</primary> + <secondary +>kompilering</secondary +></indexterm> +<indexterm zone="compile-and-install"> + <primary +>&kdevelop;</primary> + <secondary +>installation</secondary +></indexterm> + +<para +>Når alle krav er mødt, er du parat til at kompilere og installere &kdevelop;. Dette appendiks vil diskutere de nødvendige skridt til at gøre dette. </para> +<itemizedlist> + <listitem +><para +><link linkend="compile-and-install-preliminaries" +>Forberedende skridt</link +> fortæller dig om opsætning af rigtigt miljø. </para +></listitem> + <listitem +><para +><link linkend="compile-and-install-make" +>Kompilér &kdevelop;</link +> drejer sig om at få fat på &kdevelop; kilder fra svn, hvordan de skal forberedes for installationsprocessen, og viser endelig skridtene der er nødvendige for at kompilere og installere &kdevelop;. </para +></listitem> + <listitem +><para +><link linkend="compile-and-install-options" +>Nogle bemærkninger om configure tilvalg</link +> fortæller dig hvordan du kører &kdevelop; hvis det er blevet installeret på et andet sted end &kde;-mappen. </para +></listitem> +</itemizedlist> + +<sect2 id="compile-and-install-preliminaries"> +<title +>Forberedende skridt</title> + +<indexterm zone="compile-and-install-preliminaries"> + <primary +>preliminært</primary> + <secondary +>Installation af &kdevelop;</secondary +></indexterm> +<indexterm zone="compile-and-install-preliminaries"> + <primary +>KDEDIR</primary +></indexterm> +<indexterm zone="compile-and-install-preliminaries"> + <primary +>QTDIR</primary +></indexterm> +<indexterm zone="compile-and-install-preliminaries"> + <primary +>LD_LIBRARY_PATH</primary +></indexterm> +<indexterm zone="compile-and-install-preliminaries"> + <primary +>LIBRARY_PATH</primary +></indexterm> +<indexterm zone="compile-and-install-preliminaries"> + <primary +>PATH</primary +></indexterm> + +<para +>Inden du påbegynder kompileringssekvensen, skal du sikre dig at alle biblioteker og værktøj er tilgængelige for byggesystemet. For at opnå dette, skal visse miljøvariabler indstilles rigtigt. Skridtene som skal udføres afhænger af hvilken skal du bruger i terminalen. </para> + +<note +><para +>For at undgå at indtaste alle sætningerne som indstiller de nødvendige miljøvariabler hver gang du vil kompilere, kan du placere dem i filen <filename +>.bashrc</filename +> eller <filename +>.cshrc</filename +>. På den måde indstilles miljøvariablerne rigtigt hver gang du starter skallen. </para +></note> + +<sect3 id="compile-and-install-preliminaries-bash"> +<title +>Opsætning af miljøet for bash-skallen</title> + +<para +>Hvis du bruger bash-skallen, tilføjes følgende linjer: </para> + +<informalexample +><simplelist> + <member +><userinput +>export KDEDIR=</userinput +>(sti til din KDE-installation)</member> + <member +><userinput +>export QTDIR=</userinput +>(sti til dit Qt-bibliotek)</member> + <member +><userinput +>export LD_LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LD_LIBRARY_PATH</userinput +></member> + <member +><userinput +>export LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LIBRARY_PATH</userinput +></member> + <member +><userinput +>export PATH=$QTDIR/bin:$KDEDIR/bin:$PATH</userinput +></member> +</simplelist +></informalexample> +<para +></para> + +</sect3 +> <!-- compile-and-install-preliminaries-bash --> + +<sect3 id="compile-and-install-preliminaries-tcsh"> +<title +>Opsætning af miljøet for tcsh-skallen</title> + +<para +>Hvis du bruger tcsh-skallen, tilføjes følgende linjer: </para> +<para> +<informalexample +><simplelist> + <member +><userinput +>setenv KDEDIR </userinput +>(sti til din KDE-installation)</member> + <member +><userinput +>setenv QTDIR </userinput +>(sti til dit Qt-bibliotek)</member> + <member +><userinput +>setenv LD_LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LD_LIBRARY_PATH</userinput +></member> + <member +><userinput +>setenv LIBRARY_PATH $QTDIR/lib:$KDEDIR/lib:$LIBRARY_PATH</userinput +></member> + <member +><userinput +>setenv PATH $QTDIR/bin:$KDEDIR/bin:$PATH</userinput +></member> +</simplelist +></informalexample> +</para> + +</sect3 +> <!-- compile-and-install-preliminaries-tcs --> + +</sect2 +> <!-- compile-and-install-preliminaries --> + +<sect2 id="compile-and-install-make"> +<title +>Kompilér &kdevelop;</title> + +<indexterm zone="compile-and-install-make"> + <primary +>make</primary> + <secondary +>Installation af &kdevelop;</secondary +></indexterm> +<indexterm zone="compile-and-install-make"> + <primary +>kompilering</primary> + <secondary +>&kdevelop;</secondary +></indexterm> + +<note +><para +>I følgende beskrivelse antager vi at du har placeret kildekoden for &kdevelop; i mappen <filename class="directory" +>~/kde3src/kdevelop</filename +>. </para +></note> + +<sect3 id="compile-and-install-make-svn"> +<title +>Særlige hensyn ved kompilering fra svn</title> + +<para +>Hvis du bruger en aktuel version af &kdevelop; fra svn, afhænger de første kompileringsskridt af om du netop har gjort en fuldstændig udtjekning, eller kun opdateret kildekoden. </para> + +<variablelist> +<varlistentry> +<term id="compile-and-install-make-svn-co" +>Efter en udtjekning fra svn</term> +<listitem> +<para +>Du skal <emphasis +>initiere byggesystemet</emphasis +> efter en ny udtjekning. Det samme gælder hver gang du skal starte igen fra begyndelsen. Skriv: </para> + +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>make -f admin/Makefile.common svn-clean</userinput +> </member +></simplelist +></informalexample> +<para +>og derefter <emphasis +>alle følgende skridt</emphasis +>. </para> +<note +><para +>Du har måske brug for adgang til svn-arkivet for oprydningen hvis nogen korrupte eller manglende filer skal genkonstrueres. </para +></note> +<important +><para +><command +>svn-clean</command +>-kommandoen vil <emphasis +>fjerne hver fil</emphasis +> der ikke er i svn fra mappen! Sørg for at sikkerhedskopiere al værdifuld information før du udsteder denne oprydningskommando. </para +></important> +</listitem> +</varlistentry> + +<varlistentry> +<term id="compile-and-install-make-svn-up" +>Efter en opdatering fra svn</term> +<listitem> +<para +>Næste skridt afhænger af udskriften fra svn-opdateringssekvensen. Hvis du fik noget som ligner følgende (der kan være en U eller P markering i søjlen til venstre, begge betyder at filen er blevet ændret): </para> + +<screen +>U /en_mappe_sti/Makefile.am +</screen> +<para +>eller hvis du netop har lavet en fuldstændig udtjekning, skal du skrive: </para> +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>make -f Makefile.svn</userinput +> </member +></simplelist +></informalexample> +<para +>inden du fortsætter med <emphasis +>alle følgende skridt</emphasis +>. </para> +</listitem> +</varlistentry> +</variablelist> +</sect3 +> <!-- compile-and-install-make-svn --> + +<sect3 id="compile-and-install-make-basic"> +<title +>Grundlæggende kommandosekvens med <command +>make</command +></title> + +<para +>Når det grundlæggende byggesystem er indstillet på denne måde, skal du bestemme dig for hvilken slags &kdevelop;-system du vil bruge. Det gøres med følgende indstillingsskridt, som bygger den virkelige fil med navnet <filename +>Makefile</filename +>, som <command +>make</command +> kommandoen vil bruge. </para> + +<note +><para +>Du kan udelade flaget <option +>--prefix</option +> i følgende kommandolinjer med <command +>configure</command +>, hvis du ønsker at &kdevelop; skal installeres i &kde;'s standardmappe. Se kapitlet <link linkend="compile-and-install-options" +>Nogle bemærkninger om flag til <command +>configure</command +></link +> om dette. </para +></note> + +<variablelist> +<varlistentry> +<term +>En version kompileret til fejlsøgning</term> +<listitem> +<para +>Hvis du vil holde styr på hvad programmet &kdevelop; gør når det kører, kan du bygge en version kompileret med fejlsøgning. Bed blot din <command +>configure</command +> om at gøre det: </para> + +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>./configure --enable-debug=full --prefix=</userinput +>(hvor-din-kde3-er) </member +></simplelist +></informalexample> +</listitem> +</varlistentry> + +<varlistentry> +<term +>En version kompileret til distribution</term> +<listitem> +<para +>Hvis du kun vil bruge &kdevelop; som det er (mindre og hurtigere), er det nok med en version kompileret for distribution. Det er standarden i <command +>configure</command +>.</para> + +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>./configure --prefix=</userinput +>(hvor-din-kde3-er) </member +></simplelist +></informalexample> + +<note> +<para +>Hvis du vil lave din egen <link linkend="make-api" +>dokumentation for programmeringsgrænsefladen</link +> for &kdevelop;, skal du tage yderligere et flag med i kommandoen <command +>configure</command +>: </para> +<informalexample +><simplelist> + <member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>./configure --</userinput +>(tilvalg-som-ovenfor) <userinput +>\</userinput +></member +> <member +><userinput +>--with-kdelibsdoxy-dir=$KDEDIR/share/doc/HTML/en/kdelibs-apidocs</userinput +></member> +</simplelist +></informalexample> +</note> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Byg og installér &kdevelop;</term> +<listitem> +<para +>Kommandoen <command +>configure</command +> kontrollerer systemet og bygger en <filename +>Makefile</filename +> ifølge hvad den finder. Kommandoen <command +>make</command +> bruger normalt denne <filename +>Makefile</filename +>. Altså er </para> + +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>make</userinput +> </member +></simplelist +></informalexample> +<para +>tilstrækkeligt. Om nødvendigt, så skaf rettigheder som systemadministrator </para> +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>su</userinput +> </member +></simplelist +></informalexample> +<para +>og angive systemadministratorens kodeord. Installér derefter programmet: </para> +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>make install</userinput +> </member +></simplelist +></informalexample> +<para +>Det er alt. Hvis du installerede &kdevelop; i &kde;'s standardmappe, kan du nu køre det integrerede udviklingsmiljø. Ellers er nogle yderligere skridt nødvendige, som vises i afsnittet <link linkend="compile-and-install-options-dir" +>Anden installationsmappe end standard</link +> nedenfor. </para> + +<note> + <para +>Faktisk er der normalt tre &kdevelop;-programmer installeret: </para> + <itemizedlist> + <listitem +><para +>&kdevelop; integreret udviklingsmiljø — det er her du normalt kommer til at arbejde.</para +></listitem> + <listitem +><para +>Den fritstående &kdevelop; Assistent dokumentationsbrowser — isolerer alle de stærke dokumentationsfunktioner fra det integrerede &kdevelop; udviklingsmiljø i et separat værktøj. Dette er specielt nyttigt når du vil slå noget programmeringsdokumentation op, men ikke vil starte hele udviklingsmiljøet.</para +></listitem> + <listitem +><para +>&kdevelop; Designer — forbedrer &Qt;-User Interface Designer med &kde; specifikke kontroller og integrerer sig fint i &kdevelop; udviklingsmiljøet.</para +></listitem> + </itemizedlist> +</note> +</listitem> +</varlistentry> +</variablelist> + + +</sect3 +> <!-- compile-and-install-make-basic --> +</sect2 +> <!-- compile-and-install-make --> + + +<sect2 id="compile-and-install-options"> +<title +>Nogle bemærkninger om flag til <command +>configure</command +></title> + +<sect3 id="compile-and-install-options-dir"> +<title +>Anden installationsmappe end standard</title> + +<indexterm zone="compile-and-install-options-dir"> + <primary +>&kdevelop;</primary> + <secondary +>installation</secondary> + <tertiary +>ikke standardmappe</tertiary +></indexterm> +<indexterm zone="compile-and-install-options-dir"> + <primary +>ikke standardmappe</primary +></indexterm> +<indexterm zone="compile-and-install-options-dir"> + <primary +>KDEDIRS</primary +></indexterm> +<indexterm zone="compile-and-install-options-dir"> + <primary +>kbuildsycoca</primary +></indexterm> + +<para +>Normalt forbereder <command +>configure</command +> til at installere det grafiske udviklingsmiljø i &kde;'s standardmappe. Det er nødvendigt, eftersom &kdevelop; antager at der er direkte adgang til visse værktøjer og delprogrammer som findes der. Hvis du vil bruge din egen installationsmappe, skal du fortælle det til <command +>configure</command +> med flaget <option +>--prefix</option +>: </para> +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>./configure --prefix=</userinput +>(hvor-din-kde3-er) </member +></simplelist +></informalexample> +<para +>Der er et problem hvis du gør det. Du skal give mulighed for at &kdevelop; har adgang til nødvendige værktøjer og delprogrammer i &kde;'s mappe. (Du kan stadigvæk bruge det integrerede udviklingsmiljø uden at gøre det, men med meget begrænsede funktioner.) </para> +<para +> Du skal bruge en skal, og følgende kommando skal køres inden du kan starte &kdevelop; fra skallen. </para> + +<note +><para +><emphasis +>Husk at bruge flertal:</emphasis +> Det er <quote +><envar +>KDEDIRS</envar +></quote +>, ikke blot <quote +><envar +>KDEDIR</envar +></quote +>) </para +></note> + +<informalexample +><simplelist> + <member +><prompt +>~> </prompt +> <userinput +>export KDEDIRS=/usr/local/kde:/opt/kde3</userinput +> </member> + <member +><prompt +>~> </prompt +> <userinput +>kbuildsycoca</userinput +> </member> + <member +>(Start nu &kdevelop;:) </member> + <member +><prompt +>~> </prompt +> <userinput +>kdevelop</userinput +> </member> +</simplelist +></informalexample> + +<note +><simplelist> + <member +><envar +>KDEDIRS</envar +> miljøvariablen skal sættes til <emphasis +>listen af aktive &kde; mapper</emphasis +> på dit system. Vi bruger</member> + <member +><filename class="directory" +>/usr/local/kde</filename +>:<filename class="directory" +>/opt/kde3</filename +></member> + <member +>blot som et eksempel.</member> + <member +>Mappen <filename class="directory" +>/usr/local/kde</filename +> kan for eksempel indeholde en ufuldstændig udgave af &kde; som du kompilerede til fejlretningsformål og mappen <filename class="directory" +>/opt/kde3</filename +> kunne derudover indeholder standardudgaven af &kde; fra din distribution der bruges til hverdagsarbejde.</member> +</simplelist +></note> + +<para +>I en tcsh-skal skal du indstille miljøvariablerne ved at bruge: </para> +<informalexample +><simplelist +><member +><prompt +>~> </prompt +> <userinput +>setenv KDEDIRS /usr/local/kde:/opt/kde3</userinput +> </member +></simplelist +></informalexample> +<para +>Kommandoen <command +>kbuildsycoca</command +> (<quote +>byg systemkontrolcache</quote +>) søger efter biblioteker og gemmer deres sted og version i en cache, så &kdevelop; kan finde dem. Problemet er at det tager mærkbart med tid—og skal køres hver gang du bruger skallen til at starte &kdevelop; med en anden installationsmappe end standardmappen. Du vil kunne indtaste ovenstående kommando i et skalscript for at reducere anstrengelserne med at indtaste det. </para> +<para +>(Du vil også kunne indtaste linjerne i filen <filename +>.bashrc</filename +> eller <filename +>.cshrc</filename +>, men det er ikke ønskværdigt fordi så køres <command +>kbuildsycoca</command +> hver gang du bruger skallen.) </para> + +<note +><para +>Kommandoen <command +>kbuildsycoca</command +> kører ikke for systemadministratoren. Du skal kalde den som en anden bruger. (Men det er <emphasis +>ikke en særlig god idé</emphasis +> at udvikle som systemadministrator!) </para +></note> +</sect3 +> <!-- compile-and-install-options-dir --> + +<!-- ### put a sect3 with other configuration options here --> + +</sect2 +> <!-- compile-and-install-options --> + +</sect1 +> <!-- compile-and-install --> + +<sect1 id="make-api"> +<title +>Hvordan man får fat i programmeringsgrænsefladen for &kdevelop;</title> + +<indexterm zone="make-api"> + <primary +>API</primary> + <secondary +>&kdevelop;</secondary +></indexterm> +<indexterm zone="make-api"> + <primary +>&kdevelop;</primary> + <secondary +>API</secondary +></indexterm> +<indexterm zone="make-api"> + <primary +>kompilering</primary> + <secondary +>&kdevelop;</secondary> + <tertiary +>API</tertiary +></indexterm> +<indexterm zone="make-api"> + <primary +>configure</primary> + <secondary +>&kdevelop; API</secondary +></indexterm> + +<para +>Programmeringsgrænsefladen, <quote +>Application Program Interface</quote +> på engelsk, ofte forkortet til API, er i virkeligheden en følge af beskrivelser (&ie; kaldmodeller) som et program bruger for at få adgang til operativsystem og andre tjenester. I vort tilfælde er en mere omfattende definition dog blevet anvendt. Programmeringsgrænsefladen for et &kde;- eller &Qt;-program er en abstraktion af klasser og metodegrænseflader, en oversigt som kan bruges som opslagsbog for navigation i kildekoden. </para> +<para +>Der er en version af den seneste programmeringsgrænseflade på <ulink url="http://www.kdevelop.org/HEAD/doc/api/html/index.html" +>KDevelops hjemmeside</ulink +>. Den opdateres automatisk hvert døgn så at du kan følge med. </para> +<para +>Desværre bruges denne version bedst kun til at læse via internettet. Du kan ligesågodt bygge din egen dokumentation af programmeringsgrænsefladen fra kildekoden for &kdevelop;. For at gøre det, skal du fortælle automake systemet hvor KDELIBS API findes på dit. Dette opnås med det særlige flag <option +>--with-kdelibsdoxy-dir</option +> til <command +>configure</command +>-kommandoen når du forbereder at kompilere &kdevelop;'s kildekode: </para> + +<informalexample +><simplelist> + <member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>./configure --</userinput +>(flag-som-sædvanligt)<userinput +> \</userinput +> </member> + <member> + <userinput +>--with-kdelibsdoxy-dir=$KDEDIR/share/doc/HTML/en/kdelibs-apidocs</userinput> + </member> +</simplelist +></informalexample> + +<para +>(<command +>make</command +> erstatter den globale <varname +>$KDEDIR</varname +> med den egentlige &kde;-mappe). Udfør derefter kommandoen <command +>make</command +> <link linkend="compile-and-install-make-basic" +>som sædvanligt</link +>. Efter at det integrerede udviklingsmiljø &kdevelop; er bygget, har du mulighed for også at bygge programmeringsgrænsefladen. For at gøre det skal du skrive: </para> +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>make apidocs</userinput +> </member +></simplelist +></informalexample> + +<para +>Dette bygger en <filename +>Doxyfile</filename +> i basismappen for &kdevelop;, som derefter behandles af programmet <application +>doxygen</application +> for at oprette en hel del <filename +>.html</filename +>-filer for programmeringsgrænsefladen. Når den ganske lange byggeproces for programmeringsgrænsefladen til sidst er klar, skal du installere programmeringsgrænsefladen præcis som du skal installere selve det integrerede udviklingsmiljø &kdevelop;. Få rettigheder som systemadministrator om nødvendigt med: </para> + +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>su</userinput +> </member +></simplelist +></informalexample> + +<para +>og angive systemadministratorens kodeord. Installér derefter dokumentationsfilerne: </para> + +<informalexample +><simplelist +><member +><prompt +>~/kde3src/kdevelop> </prompt +> <userinput +>make install-apidox</userinput +> </member +></simplelist +></informalexample> + +<para +>Når dette er gjort, informerer <command +>make</command +> dig om mappen hvor du til sidst kan kigge på indholdet i dokumentationen for programmeringsgrænsefladen. Bemærk adressen, eftersom du kan bruge den fra &konqueror; samt inde i &kdevelop;, hvis du har indstillet den egne kildekode for &kdevelop; som projektet at arbejde med. </para> + +<note +><para +>Du vil mest sandsynligt se en masse advarsler og/eller fejlmeddelelser under API byggekørslen for <application +>Doxygen</application +>. Bedst at ignorere dem, de er kun af interesse for &kdevelop;-udviklerne. Hvis API-generingen nogensinde bliver færdig, så vil <filename +>.html</filename +> API-filerne kunne bruges. </para +></note> + +</sect1 +> <!-- make-api --> + +</appendix +> <!-- kdevelop-install --> |