1
<appendix id="kdevelop-install">
11
<!-- ROLES_OF_TRANSLATORS -->
16
>Installera &kdevelop;</title>
18
<indexterm zone="kdevelop-install">
20
>Installation</primary
24
>I det här kapitlet beskriver vi alla steg som behövs för att kompilera och installera den integrerade utvecklingsmiljön &kdevelop;: <itemizedlist>
27
><link linkend="kdevelop-install-howto"
28
>Hur man skaffar &kdevelop;</link
29
> koncentrerar sig på hur man laddar ner den senaste källkoden för &kdevelop; från CVS. </para
33
><link linkend="requirements"
34
>Krav för &kdevelop;</link
35
> listar programmen och biblioteken som du måste ha installerade för att kompilera den integrerade utvecklingsmiljön med lyckat resultat. </para
39
><link linkend="compile-and-install"
40
>Kompilering och installation av &kdevelop;</link
41
> leder dig igenom alla steg för kompilering och installation av programmet. </para
45
><link linkend="make-api"
46
>Hur man skaffar dokumentation av programmeringsgränssnittet för &kdevelop;</link
47
> talar om vad ett programmeringsgränssnitt är och hur du skaffar ett så användbart verktyg för navigering i källkoden för &kdevelop;. </para
52
<sect1 id="kdevelop-install-howto">
54
>Hur man skaffar &kdevelop;</title>
56
<indexterm zone="kdevelop-install-howto">
58
>skaffa &kdevelop;</primary
60
<indexterm zone="kdevelop-install-howto">
68
>&kdevelop; är tillgänglig i binärform från många olika &Linux;-distributioner som SuSE, RedHat med flera. Binärfilerna är paketerade på något bekvämt sätt, oftast RPM, för att enkelt kunna installeras. Följ standardinstruktionerna som ges i distributionen för att installera. </para>
70
>Du kan mycket väl skaffa källkoden för &kdevelop;, kompilera och installera den själv. Källkoden hittas via projektets hemsida på <ulink url="http://www.kdevelop.org"
71
>http://www.kdevelop.org</ulink
72
> eller via <ulink url="http://download.kde.org"
73
>&kde;:s FTP-plats</ulink
76
<sect2 id="howto-cvs">
78
>Hämta dagsfärska versioner av &kdevelop; från &CVS;</title>
80
<indexterm zone="howto-cvs">
86
>Om du vill vara en del av den nuvarande utvecklingen, är versioner via anonym &CVS; från arkivet också tillgängliga. Modulnamnet är <emphasis
88
> på <filename class="directory"
89
>:pserver:anonymous@anoncvs.kde.org:/home/kde</filename
92
<sect3 id="howto-cvs-co">
94
>Ursprunglig utcheckning från &CVS;</title>
96
<indexterm zone="howto-cvs-co">
100
<indexterm zone="howto-cvs-co">
102
>&kdevelop;</primary>
106
>utcheckning</tertiary
110
>För att skaffa en ursprunglig version av &kdevelop; måste du ladda ner den från anonym &CVS;. Följ bara stegen nedan för den här så kallade <emphasis
111
>utcheckningsåtgärden</emphasis
116
>Vi antar att du vill placera din kopia av &kdevelop; i underkatalogen <filename class="directory"
118
> i din hemkatalog (<filename class="directory"
126
># Skapa målkatalogen, om det behövs: </member>
131
>mkdir kde3src</userinput
137
>cd kde3src</userinput
141
>~/kde3src> </prompt
143
>cvs -z3 -d :pserver:anonymous@anoncvs.kde.org:/home/kde co kdevelop</userinput
147
>~/kde3src> </prompt
149
>cd kdevelop</userinput
156
>När du väl har lyckats checka ut din version av &kdevelop;, kan du hänga med i ändringarna genom att använda uppdateringsproceduren som visas i nästa avsnitt. </para
161
>Håll serverns last nere. <emphasis
162
>Var vänlig att inte checka ut varje gång du vill få en aktuell version av &kdevelop;!</emphasis
163
> Använd CVS update för detta syfte. </para
167
>Nu kan du kompilera din version av &kdevelop; som visas i avsnittet <link linkend="compile-and-install"
168
>Kompilering och installation av &kdevelop;</link
172
> <!-- howto-cvs-co -->
174
<sect3 id="howto-cvs-up">
176
>Hålla din kopia av&CVS; aktuell</title>
178
<indexterm zone="howto-cvs-up">
182
<indexterm zone="howto-cvs-up">
184
>&kdevelop;</primary>
192
>Efter du checkat ut &kdevelop; från CVS som visas ovan (och kompilerat med lyckat resultat), vill du hålla den aktuell för att få med alla programfixar. Följ då stegen nedan. (Återigen antar vi att du har placerat din kopia av &kdevelop; i katalogen <filename class="directory"
196
>Observera kommandot <command
200
>) istället för <command
202
> (vilket betyder <emphasis
212
>cd kde3src</userinput
216
>~/kde3src> </prompt
218
>cvs -z3 -d :pserver:anonymous@anoncvs.kde.org:/home/kde up kdevelop</userinput
222
>~/kde3src> </prompt
224
>cd kdevelop</userinput
231
>Håll ett öga på meddelanden som &CVS; visar under uppdateringssekvensen. De exakta stegen i kompileringssekvensen beror på dem. </para
235
>Nu kan du kompilera en ny version av &kdevelop; som visas i kapitlet <link linkend="compile-and-install-make-cvs"
236
>Särskilda hänsyn vid kompilering från &CVS;</link
239
> <!-- howto-cvs-up -->
247
<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
249
<sect1 id="requirements">
251
>Krav för &kdevelop;</title>
253
<indexterm zone="requirements">
257
<indexterm zone="requirements">
259
>&kdevelop;</primary>
263
<indexterm zone="requirements">
271
>För att kompilera och använda &kdevelop; med lyckat resultat, behöver du följande program och bibliotek. De är tillgängliga på de flesta plattformar som distributionspaket, och kan därigenom lätt installeras. </para>
279
>gcc/g++</application
280
> 2.95.3 eller senare (eller motsvarande) <indexterm>
294
>Tillgänglig från <ulink url="gcc.gnu.org"
301
>&GNU; make</application
302
> (eller motsvarande) <indexterm>
310
>Tillgänglig från <ulink url="www.gnu.org/software/make"
311
>www.gnu.org/software/make</ulink
316
>&perl; 5.004 (eller senare) <indexterm>
324
>Tillgänglig från <ulink url="www.perl.com"
331
>autoconf</application
332
> ≥ 2.52 (eller senare) <indexterm>
340
>Tillgänglig från <ulink url="www.gnu.org/software/autoconf"
341
>www.gnu.org/software/autoconf</ulink
347
>automake</application
348
> ≥ 1.6 (eller senare) <indexterm>
356
>Tillgänglig från <ulink url="www.gnu.org/software/automake"
357
>www.gnu.org/software/automake</ulink
364
> 2.5.4 (eller senare) <indexterm>
372
>Tillgänglig från <ulink url="www.gnu.org/software/flex"
373
>www.gnu.org/software/flex</ulink
378
>&Qt; ≥ 3.0.3 (eller senare) <indexterm>
386
>Tillgänglig från <ulink url="www.trolltech.com/products/qt"
387
>www.trolltech.com/products/qt</ulink
394
> ≥ 3.0.2 (eller senare) <indexterm>
402
>Tillgänglig från <ulink url="www.kde.org"
417
> för källkodsnavigering, från <ulink url="http://ctags.sourceforge.net"
418
>http://ctags.sourceforge.net</ulink
419
>, som ger dig snabb åtkomst till deklarationer och definitioner med några få enkla klick på ett namn i editorn. <indexterm
427
>Kompilatorn <emphasis
431
> för grafikspråk, från <ulink url="http://www.graphviz.org"
432
>http:/www.graphviz.org</ulink
433
>. Verktyget behövs tillsammans med &doxygen; nedan, om du vill visa klassförhållanden grafiskt (vilket starkt rekommenderas). <indexterm
441
>Dokumentationsverktyget <emphasis
443
>, från <ulink url="http://www.doxygen.org"
444
>http://www.doxygen.org</ulink
445
>, om du vill skapa koncis och kraftfull dokumentation av programmeringsgränssnittet för dina projekt. <indexterm
455
>Valgrind</application
457
> från <ulink url="http://developer.kde.org/~sewardj/"
458
>http://developer.kde.org/~sewardj/</ulink
459
> hjälper dig att hitta minneshanteringsproblem i dina program. <indexterm
471
> från <ulink url="http://www.cvshome.org"
472
>http://www.cvshome.org</ulink
473
>, om du vill använda versionshanteringssystemet &CVS;. <indexterm>
483
>Eventuellt andra kompilatorer och/eller verktyg om du vill utveckla för ett annat språk eller plattform än C++/&kde;, eller använda någon annan specialfunktion. </para
491
>Du kan i viss utsträckning kringgå behovet av &autoconf; ≥ 2.52 och &automake; ≥ 1.6. Ta bara bort katalogen <filename class="directory"
493
> i installationskatalogen för &kdevelop;, och skriv: <indexterm>
497
>kringgå versionsbehov</secondary
503
>kringgå versionsbehov</secondary
507
>versionsbehov</primary>
509
>kringgå för autoconf och automake</secondary
516
>(din kdevelop-katalog)> </prompt
518
>ln -s $KDEDIR/share/apps/kdelibs/admin admin</userinput
523
>i terminalen. Det gör att &kdevelop; använder standardinställningarna i &kde;:s <filename class="directory"
525
>-katalog istället. </para>
529
>Var försiktig så att du <emphasis
530
>inte blandar olika versioner av &Qt;</emphasis
531
>. Länka alltid &kdevelop; med samma version av &Qt; som &kde;-biblioteket kompilerades med. Annars råkar du troligen ut för <emphasis
532
>mycket konstigt</emphasis
539
> <!-- requirements -->
541
<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
543
<sect1 id="compile-and-install">
545
>Kompilering och installation av &kdevelop;</title>
547
<indexterm zone="compile-and-install">
549
>&kdevelop;</primary>
551
>kompilering</secondary
553
<indexterm zone="compile-and-install">
555
>&kdevelop;</primary>
557
>installation</secondary
561
>När alla krav väl är uppfyllda är du redo att kompilera och installera &kdevelop;. Det här appendixet beskriver nödvändiga steg för att göra det. </para>
565
><link linkend="compile-and-install-preliminaries"
566
>Förberedande steg</link
567
> berättar hur du ställer in en riktig miljö. </para
571
><link linkend="compile-and-install-make"
572
>Kompilera &kdevelop;</link
573
> handlar om hur källkoden för &kdevelop; skaffas från &cvs;, hur den förbereds för installationsprocessen, och visar till sist stegen som är nödvändiga för att kompilera och installera &kdevelop;. </para
577
><link linkend="compile-and-install-options"
578
>Några anmärkningar om väljare till configure</link
579
> talar om hur man kör &kdevelop; om det har installerats på en annan plats än i &kde;-katalogen. </para
583
<sect2 id="compile-and-install-preliminaries">
585
>Förberedande steg</title>
587
<indexterm zone="compile-and-install-preliminaries">
589
>preliminärt</primary>
591
>Installation av &kdevelop;</secondary
593
<indexterm zone="compile-and-install-preliminaries">
597
<indexterm zone="compile-and-install-preliminaries">
601
<indexterm zone="compile-and-install-preliminaries">
603
>LD_LIBRARY_PATH</primary
605
<indexterm zone="compile-and-install-preliminaries">
607
>LIBRARY_PATH</primary
609
<indexterm zone="compile-and-install-preliminaries">
615
>Innan du påbörjar kompileringssekvensen, måste du försäkra dig om att alla bibliotek och verktyg är tillgängliga för byggsystemet. För att uppnå detta, måste vissa miljövariabler ställas in riktigt. Stegen som ska utföras beror på vilket skal du använder i terminalen. </para>
619
>För att undvika att skriva in alla satserna som ställer in nödvändiga miljövariabler varje gång du vill kompilera, kan du placera dem i filen <filename
623
>. På så sätt ställs miljövariablerna in riktigt varje gång du startar skalet. </para
626
<sect3 id="compile-and-install-preliminaries-bash">
628
>Ställa in miljön för bash-skalet</title>
631
>Om du använder bash-skalet, lägg till följande rader: </para>
637
>export KDEDIR=</userinput
638
>(sökväg till KDE-installationen)</member>
641
>export QTDIR=</userinput
642
>(sökväg till Qt-biblioteket)</member>
645
>export LD_LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LD_LIBRARY_PATH</userinput
649
>export LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LIBRARY_PATH</userinput
653
>export PATH=$QTDIR/bin:$KDEDIR/bin:$PATH</userinput
661
> <!-- compile-and-install-preliminaries-bash -->
663
<sect3 id="compile-and-install-preliminaries-tcsh">
665
>Ställa in miljön för tcsh-skalet</title>
668
>Om du använder tcsh-skalet, lägg till följande rader: </para>
674
>setenv KDEDIR </userinput
675
>(sökväg till KDE-installationen)</member>
678
>setenv QTDIR </userinput
679
>(sökväg till Qt-biblioteket)</member>
682
>setenv LD_LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LD_LIBRARY_PATH</userinput
686
>setenv LIBRARY_PATH $QTDIR/lib:$KDEDIR/lib:$LIBRARY_PATH</userinput
690
>setenv PATH $QTDIR/bin:$KDEDIR/bin:$PATH</userinput
697
> <!-- compile-and-install-preliminaries-tcs -->
700
> <!-- compile-and-install-preliminaries -->
702
<sect2 id="compile-and-install-make">
704
>Kompilera &kdevelop;</title>
706
<indexterm zone="compile-and-install-make">
710
>Installation av &kdevelop;</secondary
712
<indexterm zone="compile-and-install-make">
716
>&kdevelop;</secondary
721
>I följande beskrivning antar vi att du har placerat källkoden för &kdevelop; i katalogen <filename class="directory"
722
>~/kde3src/kdevelop</filename
726
<sect3 id="compile-and-install-make-cvs">
728
>Särskilda hänsyn vid kompilering från &CVS;</title>
731
>Om du använder en aktuell version av &kdevelop; från &CVS;, beror de första kompileringsstegen på om du just gjort en fullständig utcheckning, eller bara uppdaterat källkoden. </para>
735
<term id="compile-and-install-make-cvs-co"
736
>Efter en utcheckning från CVS</term>
740
>initiera byggsystemet</emphasis
741
> efter en ny utcheckning. Samma sak gäller varje gång du måste starta om från början. Skriv: </para>
747
>~/kde3src/kdevelop> </prompt
749
>make -f admin/Makefile.common cvs-clean</userinput
754
>och därefter <emphasis
755
>alla följande steg</emphasis
759
>Du kan behöva komma åt&CVS;-arkivet för att rensa det om några skadade eller saknade filer måste återskapas. </para
766
>tar bort alla filer</emphasis
767
> som inte finns i &CVS; från katalogen. Försäkra dig om att säkerhetskopiera viktig information innan du använder det här rensningskommandot. </para
773
<term id="compile-and-install-make-cvs-up"
774
>Efter en uppdatering från CVS</term>
777
>Nästa steg beror på utmatningen från &CVS;-uppdateringssekvensen. Om du fick något som liknar följande (observera markören U till vänster): </para>
780
>U /någon_sökväg/Makefile.am
783
>eller om du precis gjort en fullständig utcheckning, måste du skriva: </para>
788
>~/kde3src/kdevelop> </prompt
790
>make -f Makefile.cvs</userinput
795
>innan du fortsätter med <emphasis
796
>alla följande steg</emphasis
802
> <!-- compile-and-install-make-cvs -->
804
<sect3 id="compile-and-install-make-basic">
806
>Grundläggande kommandosekvens med <command
811
>När det grundläggande byggsystemet har ställts in, måste du bestämma dig för vilken typ av &kdevelop;-system du vill använda. Det görs med följande konfigureringssteg, som bygger de verkliga filerna med namn <filename
813
>, som kommandot <command
815
> kommer att använda. </para>
819
>Du kan utelämna väljaren <option
821
> i följande kommandorader med <command
823
>, om du vill att &kdevelop; ska installeras i &kde;:s standardkatalog. Se kapitlet <link linkend="compile-and-install-options"
824
>Några anmärkningar om väljare till configure</link
831
>En version kompilerad för avlusning</term>
834
>Om du vill hålla ordning på vad programmet &kdevelop; gör när det kör, kan du bygga en version kompilerad med avlusning. Tala bara om för <command
836
> att göra det: </para>
842
>~/kde3src/kdevelop> </prompt
844
>./configure --enable-debug=full --prefix=</userinput
845
>(där din kde3 finns) </member
853
>En version kompilerad för distribution</term>
856
>Om du bara vill använda &kdevelop; som det är (mindre och snabbare), räcker det med en version kompilerad för distribution. Det är förvalt i <command
864
>~/kde3src/kdevelop> </prompt
866
>./configure --prefix=</userinput
867
>(där din kde3 finns) </member
873
>Om du vill skapa din egen <link linkend="make-api"
874
>dokumentation av programmeringsgränssnittet</link
875
> för &kdevelop;, måste du ta med ytterligare en väljare i kommandot <command
882
>~/kde3src/kdevelop> </prompt
884
>./configure --</userinput
885
>(väljare enlikt ovan) <userinput
890
>--with-kdelibsdoxy-dir=$KDEDIR/share/doc/HTML/en/kdelibs-apidocs</userinput
900
>Bygga och installera &kdevelop;</term>
905
> kontrollerar systemet och skapar några filer vid namn <filename
907
> enligt vad det hittar. Kommandot <command
909
> använder normalt den huvudsakliga filen <filename
917
>~/kde3src/kdevelop> </prompt
924
>tillräckligt. Om nödvändigt, skaffa rättigheter som systemadministratör genom att använda kommandot </para>
929
>~/kde3src/kdevelop> </prompt
936
>och ange systemadministratörens lösenord. Installera sedan programmet: </para>
941
>~/kde3src/kdevelop> </prompt
943
>make install</userinput
948
>Det är allt. Om du installerade &kdevelop; i &kde;:s standardkatalog, kan du nu köra den integrerade utvecklingsmiljön. Annars är några ytterligare steg nödvändiga, som visas i avsnittet <link linkend="compile-and-install-options-dir"
949
>Annan installationskatalog än standard</link
954
>I själva verket har tre &kdevelop;-baserade program installerats: </para>
958
>Den integrerade utvecklingsmiljön &kdevelop;: Det här är platsen där du oftast arbetar.</para
962
>Den fristående dokumentationsbläddraren &kdevelop; assistent: Isolerar alla kraftfulla dokumentationsfunktioner i utvecklingsmiljön &kdevelop; i ett separat verktyg. Det här är praktiskt när du vill slå upp någon programmeringsdokumentation, men inte vill starta den fullständiga utvecklingsmiljön.</para
966
>&kdevelop; Designer: Utökar &Qt; Designer för grafiska gränssnitt med element specifika för &kde; och integreras på ett bra sätt i utvecklingsmiljön &kdevelop;.</para
976
> <!-- compile-and-install-make-basic -->
978
> <!-- compile-and-install-make -->
981
<sect2 id="compile-and-install-options">
983
>Några anmärkningar om väljare till <command
987
<sect3 id="compile-and-install-options-dir">
989
>Annan installationskatalog än standard</title>
991
<indexterm zone="compile-and-install-options-dir">
993
>&kdevelop;</primary>
995
>installation</secondary>
997
>inte standardkatalog</tertiary
999
<indexterm zone="compile-and-install-options-dir">
1001
>inte standardkatalog</primary
1003
<indexterm zone="compile-and-install-options-dir">
1007
<indexterm zone="compile-and-install-options-dir">
1009
>kbuildsycoca</primary
1013
>Normalt förbereder <command
1015
> för att installera den grafiska utvecklingsmiljön i &kde;:s standardkatalog. Det behövs, eftersom &kdevelop; antar att det går att direkt komma åt vissa verktyg och delprogram som finns där. Om du vill använda din egen installationskatalog, måste du tala om det för <command
1017
> med väljaren <option
1024
>~/kde3src/kdevelop> </prompt
1026
>./configure --prefix=</userinput
1027
>(där din kde3 finns) </member
1031
>Det finns ett problem om du gör det. Du måste ge möjlighet för &kdevelop; att komma åt nödvändiga verktyg och delprogram i &kde;:s katalog när det kör. (Du kan fortfarande använda den integrerade utvecklingsmiljön utan att göra det, men med mycket begränsade funktioner.) </para>
1033
>Starta ett skal och se till att köra följande kommandon innan du startar &kdevelop; från skalet. </para>
1038
>Försäkra dig om att använda pluralis:</emphasis
1056
>export KDEDIRS=/usr/local/kde:/opt/kde3</userinput
1062
>kbuildsycoca</userinput
1065
>(Starta nu &kdevelop;:) </member>
1070
>kdevelop</userinput
1078
>Miljövariabeln <envar
1080
> måste vara inställt till <emphasis
1081
>listan med aktiva &kde;-bibliotek</emphasis
1082
> i systemet. Vi använder</member>
1084
><filename class="directory"
1085
>/usr/local/kde</filename
1086
>:<filename class="directory"
1087
>/opt/kde3</filename
1090
>bara som ett exempel.</member>
1092
>Katalogen <filename class="directory"
1093
>/usr/local/kde</filename
1094
> kan till exempel innehålla en ofullständig &kde;-version som du kompilerat i avlusningssyfte, och katalogen <filename class="directory"
1095
>/opt/kde3</filename
1096
> innehåller dessutom den vanliga &kde;-versionen från distributionen som används för dagligt arbete.</member>
1101
>I ett tcsh-skal måste du ställa in miljövariablerna genom att använda: </para>
1108
>setenv KDEDIRS /usr/local/kde:/opt/kde3</userinput
1114
>kbuildsycoca</command
1116
>bygg systemkontrollcache</quote
1117
>) söker efter bibliotek och lagrar deras plats och version i en cache, så att &kdevelop; kan hitta dem. Problemet är att det tar märkbart med tid, och måste köras varje gång du använder skalet för att starta &kdevelop; med en annan installationskatalog än standardkatalogen. Du skulle kunna skriva in ovanstående kommandon i ett skalskript för att reducera ansträngningen att skriva in det. </para>
1119
>(Du skulle också kunna skriva in raderna i filen <filename
1123
>, men det är inte önskvärt eftersom då körs <command
1124
>kbuildsycoca</command
1125
> varje gång du använder skalet.) </para>
1130
>kbuildsycoca</command
1131
> kör inte för systemadministratören. Du måste anropa det som en annan användare. (Men det är <emphasis
1132
>inte en särskild god idé</emphasis
1133
> att utveckla programvara som systemadministratör!) </para
1136
> <!-- compile-and-install-options-dir -->
1138
<!-- ### put a sect3 with other configuration options here -->
1141
> <!-- compile-and-install-options -->
1144
> <!-- compile-and-install -->
1146
<sect1 id="make-api">
1148
>Hur man skaffar dokumentation av programmeringsgränssnittet för &kdevelop;</title>
1150
<indexterm zone="make-api">
1152
>programmeringsgränssnitt</primary>
1154
>&kdevelop;</secondary
1156
<indexterm zone="make-api">
1158
>&kdevelop;</primary>
1160
>programmeringsgränssnitt</secondary
1162
<indexterm zone="make-api">
1164
>kompilera</primary>
1166
>&kdevelop;</secondary>
1168
>programmeringsgränssnitt</tertiary
1170
<indexterm zone="make-api">
1174
>Programmeringsgränssnitt i &kdevelop;</secondary
1178
>Programmeringsgränssnittet, <quote
1179
>Application Program Interface</quote
1180
> på engelska, ofta förkortat API, innehåller i själva verket en följd av beskrivningar (dvs. anropsmodeller) som ett program kan använda för att komma åt operativsystem och andra tjänster. I vårt fall har dock en mer omfattande definition använts. Programmeringsgränssnittet för ett &kde;- eller &Qt;-program är en sammanfattning av klasser och metodgränssnitt, en översikt som kan användas som uppslagsbok för navigation i källkoden. </para>
1182
>Det finns en version av det senaste programmeringsgränssnittet på <ulink url="http://www.kdevelop.org/HEAD/doc/api/html/index.html"
1183
> KDevelops hemsida</ulink
1184
>. Den uppdateras automatiskt varje dygn så att du kan hänga med. </para>
1186
>Tyvärr används den här versionen bäst för att bara läsa via Internet. Om du inte alltid är uppkopplad, kan du lika väl bygga din egen dokumentation av programmeringsgränssnittet från källkoden för &kdevelop;. För att göra det, måste du tala om det för automake-systemet var KDELIBS programmeringsgränssnitt finns på din dator. Det kan åstadkommas med den särskilda väljaren <option
1187
>--with-kdelibsdoxy-dir</option
1188
> i kommandot <command
1190
> när du förbereder kompilering av källkoden för &kdevelop;. </para>
1196
>~/kde3src/kdevelop> </prompt
1198
>./configure --</userinput
1199
>(vanliga väljare)<userinput
1204
>--with-kdelibsdoxy-dir=$KDEDIR/share/doc/HTML/en/kdelibs-apidocs</userinput>
1212
> ersätter den globala variabeln <varname
1214
> med den verkliga inställningen av &kde;-katalogen som finns där). Utför sedan kommandot <command
1216
> <link linkend="compile-and-install-make-basic"
1218
>. Efter att den integrerade utvecklingsmiljön &kdevelop; har byggts, har du möjlighet att också bygga programmeringsgränssnittet. För att göra det måste du skriva: </para>
1223
>~/kde3src/kdevelop> </prompt
1225
>make apidocs</userinput
1231
>Detta bygger en <filename
1233
> i baskatalogen för &kdevelop;, som i sin tur behandlas av programmet <application
1234
>Doxygen</application
1235
> för att skapa en hel del <filename
1237
>-filer för programmeringsgränssnittet. När den ganska långa byggprocessen (den kan ta mer än en timme på en långsam dator) av programmeringsgränssnittet till sist är klar, måste du installera programmeringsgränssnittet precis som du måste installera själva den integrerade utvecklingsmiljön &kdevelop;. Skaffa rättigheter som systemadministratör om det behövs med: </para>
1243
>~/kde3src/kdevelop> </prompt
1251
>och ange systemadministratörens lösenord. Installera sedan dokumentationsfilerna: </para>
1257
>~/kde3src/kdevelop> </prompt
1259
>make install-apidox</userinput
1265
>När det här väl är gjort, informerar <command
1267
> dig om katalogen där du till sist kan titta på innehållet i dokumentationen av programmeringsgränssnittet. Observera adressen, eftersom du kan använda den från &konqueror; samt inne i &kdevelop;, om du har ställt in den egna källkoden för &kdevelop; som projektet att arbeta med. </para>
1271
>Du ser troligen en mängd varningar och/eller felmeddelanden under tiden programmeringsgränssnittet byggs av <application
1272
>Doxygen</application
1273
>. Det är bäst att ignorera dem. De är bara av intresse för utvecklare av &kdevelop;. Om programmeringsgränssnittet väl skapats med lyckat resultat, blir dess <filename
1275
>-filer användbara. </para
1282
> <!-- kdevelop-install -->