summaryrefslogtreecommitdiffstats
path: root/tde-i18n-da/docs/tdesdk/scripts/tdesvn-build/index.docbook
blob: f1c7b04e8daab0e822ea57edd782b17f4b54bb9a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "tdesvn-build">
  <!ENTITY package "tdesdk">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Danish "INCLUDE"
> <!-- Change language only here -->
  <!ENTITY svn "<application
>Subversion</application
>">
  <!ENTITY tdesvn-build "<application
>tdesvn-build</application
>">
]>

<book lang="&language;">

<bookinfo>
<title
>Håndbog for scriptet &tdesvn-build;</title>

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


&erik.kjaer.pedersen.role; 

</authorgroup>

<copyright>
<year
>2005</year>
<holder
>Michael Pyne</holder>
</copyright>

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


<legalnotice
>&FDLNotice;</legalnotice>

<date
>2005-06-18</date>
<releaseinfo
>0.98</releaseinfo>

<abstract>
<para
>&tdesvn-build; er et Perl-script som bygger og installerer &kde;, direkte fra kildekoden som hentes fra &kde;'s &svn;-arkiv.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>tdesdk</keyword>
<keyword
>SVN</keyword>
<keyword
>Subversion</keyword>
<keyword
>KDE-udvikling</keyword>
</keywordset>

</bookinfo>


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

<para
>&tdesvn-build; er et Perl-script som hjælper brugere at installere <ulink url="http://www.kde.org/"
>&kde;</ulink
> fra <ulink url="http://subversion.tigris.org/"
>&svn;</ulink
>. Du vil måske også overveje bruge scriptet kde-build, som er inkluderet i &kde;'s tdesdk-modul. </para>

<para
>Her dokumenterer vi syntaksen for &tdesvn-build;'s indstillingsfiler, dets kommandolinjeflag, funktioner og en oversigt over alle nødvendige skridt som kræves for at bygge &kde; fra kildekode, inklusive de skridt du skal udføre ved brug af andre værktøjer, eller med andre ord, skridt som ikke automatisk udføres af scriptet &tdesvn-build;. </para>

</chapter>

<chapter id="getting-started">
<title
>Sådan kommer vi i gang</title>

<para
>I dette kapitel viser vi hvordan &tdesvn-build; bruges til at tjekke moduler ud fra &kde;-arkivet og bygge dem. Vi sørger også efor n grundlæggende forklaring af &kde;'s &svn;-struktur og de skridt du skal udføre inden scriptet køres. </para>

<para
>Alle emner som præsenteres i dette kapitel dækkes med endnu flere detaljer i guiden <ulink url="http://quality.kde.org/develop/cvsguide/buildstep.php"
>Building &kde; from Source Step by Step Guide</ulink
> på <ulink url="http://quality.kde.org"
>hjemmesiden for &kde;'s kvalitetsgruppe</ulink
>. Hvis du kompilerer KDE første gang, er det en god idé at læse den, eller rådspørge den som en referencekilde. Du finder detaljeret information om pakkeværktøj og krav, almindelige faldgreb ved kompilering og strategier og information om at køre den nye &kde;-installation. </para>

<sect1 id="before-building">
<title
>Forbered systemet til  at bygge &kde;</title>

<para
>Du anbefales at hente og bygge &kde; med en brugerkonto. Hvis du allerede har &kde;-pakker installerede, er det bedste valg at oprette en anden (særlig) brugere til at bygge og køre den nye &kde;. Fordelen ved at bygge &kde; for en særlig bruger er at du ikke kan forstyrre basissystemet, og du har altid en måde at arbejde bekvemt når ting går galt. </para>

<para
>Senere kan du installere som systemadministrator hvis du vil. Dette dokument dækker ikke en installation som systemadministrator. Hvis du udfører en systeminstallation, véd du formodentlig alligevel hvad du fortager dig. </para>

<para
>Inden du bruger scriptet &tdesvn-build; (eller en anden byggestrategi) skal du installere udviklingsværktøjer og biblioteker som behøves for &kde;. Du behøver Qt-biblioteket, version 3.3.0 eller senere, Automake 1.8, Autoconf 2.5X (bedre med 
>= 2.57 eftersom en fejl rapporteredes med tidligere versioner), subversion-klienten (svn), gcc-oversætteren med understøttelse for C++, libxml2, openssl, libbz2 og mange flere (for en fuldstændig liste, besøg <ulink url="http://www.kde.org/info/requirements/3.4.php"
>KDE kompileringskrav</ulink
>). Du kan oftest få værktøjerne pakkede for dit system fra din distribution eller leverandør. </para>

<para
>Visse af pakkerne er opdelte i biblioteker, programmer eller værktøjer og udviklingspakker. Du behøver i det mindste programmet eller biblioteket og dets udviklingspakke. Hvis du er i tvivl installér alle. Bibliotekerne du behøver ændres afhængig af modulerne du har til hensigt at bygge, eftersom hvert modul har sine egne krav. Guiden <ulink url="http://quality.kde.org/develop/cvsguide/buildstep.php#step1"
>Building &kde; from Source Step by Step</ulink
> har flere detaljer om specifikke værktøjer og tekniker som bruges til at installere og finde programmellet som kræves. </para>

<para
>Du har formodentlig allerede en version af scriptet &tdesvn-build; installeret på dit system. &tdesvn-build; kræver at du laver en indstillingsfil, som hedder <filename
>.tdesvn-buildrc</filename
>. Filen skal installeres i hjemmemappen (~/), og indeholde alle indstillingsdata som kræves for at scriptet skal kunne køres, såsom indstillingstilvalg, kompileringsflag, plads for kildekoden, målet for installationen (præfix), modulerne som skal bygges, osv. Der sørges for standardindstillingsdata i filen <filename
>tdesvn-buildrc-sample</filename
>. Du finder mere information om indstillingsfilens syntaks i <xref linkend="configure-data"/> og i <xref linkend="tdesvn-buildrc"/>. </para>

<para
>En god måde at hente seneste version er at gå til siden tdesdk/scripts på <ulink url="http://websvn.kde.org/trunk/KDE"
>websvn.kde.org</ulink
>. Du ser en liste med filer tilgængelige i mappen tdesdk/scripts i &kde;:s &svn;-arkiv. Klik på linket &tdesvn-build; og hent seneste version af scriptet. Gør det samme med filen <filename
>tdesvn-buildrc-sample</filename
>. Gør scriptet kørbart, og sørg for at der er i din søgesti. </para>

</sect1>

<sect1 id="configure-data">
<title
>Angiv indstillingsinformation</title>

<para
>For at bruge scriptet skal du have en fil i din hjemmemappe som hedder <filename
>.tdesvn-buildrc</filename
>, som indstiller  generelle tilvalg og angiver modulerne som du vil hente og bygge. </para>

<para
>Brug filen <filename
>tdesvn-buildrc-sample</filename
> som en skabelon, for at indstille globale tilvalg og modulerne du vil bygge. </para>

<para
>Vælg serveren som skal bruges til at tjekke ud fra &svn; ved at indstille det globale tilvalg for  svn-server. Det anonyme &svn;-arkiv <emphasis
>svn://anonsvn.kde.org/</emphasis
> er standard, men lav det om du har en <ulink url="http://developer.kde.org/documentation/misc/firststepsaccount"
>&kde; &svn;-konto</ulink
>, eller hvis der er et <ulink url="http://developer.kde.org/source/anonsvn.html"
>spejl tæt ved dig</ulink
>. </para>

<para
>Vær særlig opmærksom på de globale variabler tdedir og qtdir, eftersom den første angiver hvor det byggede &kde; skal installeres (normalt i <filename
>~/kde</filename
>), og den anden hvor (og om) Qt-biblioteket skal bygges og installeres (normalt <filename
>~/tdesvn/build/qt-copy</filename
>). 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 <filename
>tdesvn-buildrc-sample</filename
> bør være tilstrækkelige for at få en nogenlunde komplet installation af &kde;. Gem resultatet som <filename
>.tdesvn-buildrc</filename
> i din hjemmemappe. </para>

<para
>Hvis du vil finjustere <filename
>.tdesvn-buildrc</filename
>, kig så på <xref linkend="tdesvn-buildrc"/> for detaljeret information om alle indstillingstilvalg. </para>

</sect1>

<sect1 id="building-and-troubleshooting">
<title
>At bruge scriptet &tdesvn-build;</title>

<para
>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: <screen
><prompt
>&percnt;</prompt
><command
>su</command
> <option
>-</option
> <replaceable
>udviklings-brugernavn</replaceable>
<prompt
>&percnt;</prompt
><command
>tdesvn-build</command
>
</screen>
</para>

<para
>Nu skulle scriptet begynde at hente kildekoden og kompilere den. Det er ikke sandsynligt at det lykkes første gang du kompilerer &kde;. Fortvivl ikke! Kontrollér logfilerne for at se om du mangler nogle værktøjer eller udviklingspakker (stedet for logfilerne angives af variablen log-dir i indstillingsfilen). Sommetider bliver hovedudviklingsgrenen meget ustabil og svær at bygge, især når en frysning af udviklingen er nær. Vær tålmodig. Du kan finde flere almindelige eksempler på ting som kan gå galt og deres løsning, samt generelle vink og strategier for at bygge &kde; i guiden <ulink url="http://quality.kde.org/develop/cvsguide/buildstep.php#step1"
>Building &kde; from Source Step by Step</ulink
>. </para>

</sect1>

<sect1 id="environment">
<title
>Opsætning af miljøet for at køre den friske &kde;</title>

<para
>Under antagelse af at du bruger en særlig bruger til at bygge &kde; og allerede har en installeret version af &kde;, kan det være noget tricket at køre det nye &kde;, eftersom den nye &kde; skal foretrækkes frem for den gamle. Ændr miljøvariabler for at sikre dig at dette sker. </para>

<para
>Åbn eller oprette filen <filename
>.bash_profile</filename
> i hjemmemappen med din favoriteditor, og tilføj følgende i slutningen af filen: <programlisting>
TDEDIR=(søgesti til tdedir)
TDEDIRS=$TDEDIR
PATH=$TDEDIR/bin:$QTDIR/bin:$PATH
LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH
export TDEDIRS PATH LD_LIBRARY_PATH
</programlisting
> hvis du bygger modulet qt-copy, tilføj i stedet: <programlisting
>QTDIR=(søgesti til qtdir)
TDEDIR=(søgesti til tdedir)
TDEDIRS=$TDEDIR
PATH=$TDEDIR/bin:$QTDIR/bin:$PATH
MANPATH=$QTDIR/doc/man:$MANPATH
LD_LIBRARY_PATH=$TDEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH
export QTDIR TDEDIRS PATH MANPATH LD_LIBRARY_PATH
</programlisting>
</para>

<para
>Hvis du ikke bruger en særlig bruger,  idstillesn en anderledes <envar
>$TDEHOME</envar
> for det nye miljø i din <filename
>.bash_profile</filename
>: <programlisting
>export TDEHOME="${HOME}/.kde-svn"

# Opret hvis det behøves
[ ! -e ~/.kde-svn ] &amp;&amp; mkdir ~/.kde-svn
</programlisting>
</para>

<note>
<para
>Hvis menuen senere er tom eller for fyldt med programmer fra din distribution, skal du måske indstille miljøvariablen xdg i <filename
>.bash_profile</filename
>: <programlisting
>XDG_CONFIG_DIRS="/etc/xdg"
XDG_DATA_DIRS="${TDEDIR}/share:/usr/share"
export XDG_CONFIG_DIRS XDG_DATA_DIRS
</programlisting>

</para>
</note>

<para
>Nu når vi er færdige med dette skal du sørge  for at det rette <application
>starttde</application
> script bliver brugt: </para>

<para
>Åbn tekstfilen <filename
>.xinitrc</filename
> (eller <filename
>.xsession</filename
>, afhængig af distribution) i hjemmemappen, eller opret det hvis det behøves. Tilføj linjen: <programlisting
>exec ${TDEDIR}/bin/starttde
</programlisting>
</para>

<para
>Start nu den friske &kde;: i BSD- og Linux-systemer med understøttelse for virtuelle terminaler, bruges tastekombinationerne Ctrl+Alt+F1..F12 til at skifte mellem virtuelle konsoller 1 til og med 12. Det lader dig køre mere end et desktopmiljø samtidigt. De første seks er tekstterminaler, og de følgende seks er grafiske skærme. </para>

<para
>Hvis den grafiske skærmhåndtering i stedet vises når du starter, kan du bruge det nye KDE-miljø også selvom det ikke listes som en mulighed. Tryk på Ctrl+Alt+F2, så vises en tekstterminal. Log ind som den særlige bruger og skriv: </para>

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

<tip>
<para
>Du kan køre KDE fra kildekode og det gamle KDE samtidigt. Log ind som din almindelige bruger, og starte den stabile KDE-desktop. Tryk på Ctrl+Alt+F2 (eller F1, F3, etc.), så vises en tekstterminal. Log ind som den særlige bruger og skriv "startx -- :1". Du kan gå tilbage til den almindelige bruger ved at trykke på Ctrl+Alt+F6 (eller F7, F8 osv. Prøv dem. En af dem er den rigtige.). For at gå tilbage til KDE fra kildekode, tryk på Ctrl+Alt+F7 (eller F6, F8, etc.). Nu kan du skifte mellem dine KDE-versioner, og teste den nye mens du véd at du hurtigt kan gå tilbage til sikkerheden hos den stabile KDE-desktop. </para>
</tip>


</sect1>

</chapter>

<chapter id="features">
<title
>Scriptets funktioner</title>

<para
>Funktionerne i &tdesvn-build; omfatter: </para>


<itemizedlist>

<listitem
><para
>Tjekker automatisk ud eller opdaterer moduler fra &svn;, ifølge hvad som er passende. </para
></listitem>

<listitem
><para
>Beregner tiden for at bygge moduler. </para
></listitem>

<listitem
><para
>Forsøger automatisk at genbygge moduler som bruger en inkrementel byggeproces, hvilket tenderer at mislykkes efter visse typer af indtjekninger. </para
></listitem>

<listitem
><para
>Kan genoptage et tidligere script, eller starte byggeprocessen fra en bestemt modul. </para
></listitem>

<listitem
><para
>Levereres med et indbygget rimeligt sæt standardtilvalg passende til  at bygge en grundlæggende enbrugerinstallation af &kde; fra det anonyme &svn;-arkivet. </para
></listitem>

<listitem
><para
>Levereres med understøttelse for <ulink url="http://www.kde.me.uk/index.php?page=unsermake"
>Unsermake</ulink
>. </para
></listitem>

<listitem
><para
>Ekspanderer dine indstillingstilvalg med tilde. Du kan for eksempel angive: <programlisting
>qtdir ~/tdesvn/build/qt-copy</programlisting>
</para
></listitem>

<listitem
><para
>Indstillelige bygge-, kildekode-, og logningsmapper </para
></listitem>

<listitem
><para
>Sætter automatisk et byggesystem op, med kildekodemappen adskilt fra byggemappen for at holde kildekodemappen uberørt. Undtagelsen er <application
>qt-copy</application
>, som ikke er konstrueret til at bygges sådan (hvis du ikke vil prøve <link linkend="conf-use-qt-builddir-hack"
><quote
>QT med separat byggemappe</quote
></link
>). </para
></listitem>

<listitem
><para
>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. </para
></listitem>

<listitem
><para
>Eftersom autoværktøjerne sommetider bliver usynkroniserede med ændringer i kildekodetræet, kan du tvinge til at et modul bygges om ved at oprette en fil som hedder refresh-me i byggemappen for modulet det drejer sig om, eller ved at køre &tdesvn-build; med flaget <option
>--refresh-build</option
>. </para
></listitem>

<listitem
><para
>Du kan angive diverse miljøvariabler som skal bruges under byggeprocessen, inklusive <envar
>TDEDIR</envar
>, <envar
>QTDIR</envar
>, <envar
>DO_NOT_COMPILE</envar
> og <envar
>CXXFLAGS</envar
>. </para
></listitem>

<listitem
><para
>Kommandologning. Logger dateres og nummereres så du altid har en log af en kørsel af scriptet. Desuden skabes et symbolsk link som hedder latest, som altid peger på den seneste log i logmappen. </para
></listitem>

<listitem
><para
>Hvis du bruger en brugerbygget &kde; i stedet for en systembygget (som du skal være systemadministrator for at installere), kan du lada scriptet installere for dig. Jeg har ikke gransket koden, og den bruger kaldet <function
>system()</function
> flitigt, så jeg anbefaler  for øjeblikket ikke at køre den som systemadministrator. </para
></listitem>

<listitem
><para
>Du kan bruge <link linkend="conf-make-install-prefix"
>make-install-prefix</link
> til at indlede byggekommandolinjen med en separat kommando, hvilket er nyttigt for sudo. </para
></listitem>

<listitem
><para
>Du kan bruge tilvalget <link linkend="conf-apidox"
>apidox</link
> for automatisk at bygge og installere dokumentation om programmeringsgrænsefladen for visse moduler. </para
></listitem>

<listitem
><para
>Du kan nøjes med at tjekke en delmængde af en &kde; &svn;-modul ud. Du vil for  eksempel kunne kunne nøjes med at tjekke  <application
>taglib</application
> ud fra <application
>tdesupport</application
>, eller kun <application
>K3B</application
> fra <application
>extragear/multimedia</application
>. Scriptet henter automatisk <application
>kde-common</application
> hvis det behøves for at få byggeprocessen til at fungere. </para
></listitem>

<listitem
><para
>Du kan <quote
>lade som om</quote
> du udfører handlingen. Hvis du sender med <option
>--pretend</option
> eller <option
>-p</option
> på kommandolinjen, giver scriptet en meget udførlig beskrivelse af de kommandoer som skal gøres, uden i virkeligheden at udføre dem. </para
></listitem>

<listitem
><para
>Støtte for at tjekke specifikke grene af &svn;-moduler ud. Arbejdet behøver stadigvæk at gøres færdigt, men du kan allerede vælge grenen du vil bygge med indstillingstilvalget <link linkend="conf-module-base-path"
>module-base-path</link
>. </para
></listitem>

</itemizedlist>

<para
>Ting som &tdesvn-build; IKKE gør: </para>

<itemizedlist>

<listitem
><para
>Finde det hurtigste spejl for &kde; &svn;. Der er ikke engang en liste medsendt med scriptet for øjeblikket, selvom standardserveren skulle virke godt. </para
></listitem>

<listitem
><para
>Børste dine tænder. Du skal huske at gøre det selv. </para
></listitem>

<listitem
><para
>Desværre er scriptet formodentlig ikke fejlfrit. </para
></listitem>

</itemizedlist>

</chapter>

<chapter id="tdesvn-buildrc">
<title
>Formatet for .tdesvn-buildrc</title>

<para
>For at bruge scriptet skal du have en fil i din hjemmemappe som hedder <filename
>.tdesvn-buildrc</filename
>, som beskriver modulerne som du vil hente og bygge. </para>



<para
>Det begynder med globale tilvalg, angivne som følger: </para>

<programlisting
>global
<replaceable
>tilvalg-navn tilvalg-værdi</replaceable>
<replaceable
>[...]</replaceable>
end global
</programlisting>

<para
>De følges derefter af en eller flere modulsektioner, angivne på følgende måde: </para>

<programlisting
>module <replaceable
>modul-navn</replaceable>
<replaceable
>tilvalg-navn tilvalg-værdi</replaceable>
<replaceable
>[...]</replaceable>
end module
</programlisting>

<para
><replaceable
>modul-navn</replaceable
> skal være et modul i &kde;:s &svn;-arkiv (for eksempel tdelibs eller tdebase). Visse tilvælg sætter de globale valgmuligheder ud af kraft, visse tilføjes til de globale valgmuligheder og visse globale tilvalg kan simpelthen ikke sættes ud af kraft. </para>

<para
>Følgende er en alfabetisk liste med tilvalg du kan bruge. Klik på tilvalget for at finde ud af mere om det. Hvis noget ikke er dokumenteret, så send gerne e-mail til forfatterne med adressen som du finder <link linkend="authors"
>ovenfor</link
>. </para>

<itemizedlist>
<listitem
><para
><link linkend="conf-apidox"
>apidox</link
>, for at bygge dokumentation over programmeringsgrænsefladen</para
></listitem>
<listitem
><para
><link linkend="conf-apply-qt-patches"
>apply-qt-patches</link
>, for at forbedre qt-copy</para
></listitem>
<listitem
><para
><link linkend="conf-binpath"
>binpath</link
>, for at indstille variablen <envar
>PATH</envar
>.</para
></listitem>
<listitem
><para
><link linkend="conf-branch"
>branch</link
>, for at tjekke ud fra en gren i stedet for /trunk.</para
></listitem>
<listitem
><para
><link linkend="conf-build-dir"
>build-dir</link
>, for at angive mappe at bygge i.</para
></listitem>
<listitem
><para
><link linkend="conf-checkout-only"
>checkout-only</link
>, for  kun at tjekke dele af et modul ud.</para
></listitem>
<listitem
><para
><link linkend="conf-colorful-output"
>colorful-output</link
> for at tilføje farve til scriptets uddata.</para
></listitem>
<listitem
><para
><link linkend="conf-configure-flags"
>configure-flags</link
> for at angive hvilke flag et modul skal indstilles med.</para
></listitem>
<listitem
><para
><link linkend="conf-cxxflags"
>cxxflags</link
> for at definere variablen <envar
>CXXFLAGS</envar
>.</para
></listitem>
<listitem
><para
><link linkend="conf-dest-dir"
>dest-dir</link
> for at ændre mappenavn for et modul.</para
></listitem>
<listitem
><para
><link linkend="conf-disable-agent-check"
>disable-agent-check</link
>, for at forhindre at tdesvn-build kontrollerer SSH-agentens status.</para
></listitem>
<listitem
><para
><link linkend="conf-do-not-compile"
>do-not-compile</link
>, for at markere mapper så de springes over af byggeprocessen.</para
></listitem>
<listitem
><para
><link linkend="conf-inst-apps"
>inst-apps</link
>, for at kun bygge og installere visse mapper.</para
></listitem>
<listitem
><para
><link linkend="conf-install-after-build"
>install-after-build</link
>, for at undgå at installere efter byggeprocessen.</para
></listitem>
<listitem
><para
><link linkend="conf-tdedir"
>tdedir</link
>, for at angive mappe at installere KDE i.</para
></listitem>
<listitem
><para
><link linkend="conf-libpath"
>libpath</link
>, for at sætte variablen <envar
>LD_LIBRARY_PATH</envar
>.</para
></listitem>
<listitem
><para
><link linkend="conf-make-install-prefix"
>make-install-prefix</link
>, for at køre et hjælpeprogram (såsom sudo) under installationen.</para
></listitem>
<listitem
><para
><link linkend="conf-make-options"
>make-options</link
>, for at sende flag til byggeprogrammet.</para
></listitem>
<listitem
><para
><link linkend="conf-manual-build"
>manual-build</link
>, for at undgå at modulet bygges automatisk.</para
></listitem>
<listitem
><para
><link linkend="conf-manual-update"
>manual-update</link
>, for at undgå at noget gøres automatisk med modulet.</para
></listitem>
<listitem
><para
><link linkend="conf-module-base-path"
>module-base-path</link
>, for at ændre hvorfra modulet hentes. (nyttigt for grene og mærker).</para
></listitem>
<listitem
><para
><link linkend="conf-niceness"
>niceness</link
>, for at ændre processorprioriteten.</para
></listitem>
<listitem
><para
><link linkend="conf-no-rebuild-on-fail"
>no-rebuild-on-fail</link
>, for at undgå at køre byggeprocessen om igen hvis den mislykkes.</para
></listitem>
<listitem
><para
><link linkend="conf-qtdir"
>qtdir</link
>, for at angive søgesti til Qt.</para
></listitem>
<listitem
><para
><link linkend="conf-set-env"
>set-env</link
>, for at sætte en miljøvariabel.</para
></listitem>
<listitem
><para
><link linkend="conf-source-dir"
>source-dir</link
>, for at ændre hvor kildekoden hentes.</para
></listitem>
<listitem
><para
><link linkend="conf-stop-on-failure"
>stop-on-failure</link
>, for at få .tdesvn-build at stoppe så snart en alvorlig fejl findes.</para
></listitem>
<listitem
><para
><link linkend="conf-svn-server"
>svn-server</link
>, for at ændre serveren som kildekoden automatisk hentes fra.</para
></listitem>
<listitem
><para
><link linkend="conf-use-qt-builddir-hack"
>use-qt-builddir-hack</link
>, for at give Qt en separat byggemappe fra kildekoden, såsom KDE.</para
></listitem>
<listitem
><para
><link linkend="conf-use-unsermake"
>use-unsermake</link
>, for at bruge det avancerede byggesystem unsermake.</para
></listitem>
</itemizedlist>


<para
>Her er en tabel over de forskellige valgmuligheder, og nogle kommentarer om dem. Alle tilvalg som sætter et globat tilvalg ud af kraft, gør det også for et kommandolinjeflag. </para>

<table id="option-table">
<title
>Tilvalgstabel</title>
<tgroup cols="3">

<thead>
<row>
<entry
>Tilvalgsnavn</entry>
<entry
>Modul -&gt; global opførsel</entry>
<entry
>Noter</entry>
</row>
</thead>

<tbody>

<row id="conf-apidox">
<entry
>apidox</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Sæt dette til <quote
>true</quote
> for at få &tdesvn-build; til  automatisk at bygge og installere dokumentation om programmeringsgrænsefladen for modulet efter den normale byggeproces. Det virker kun for moduler hvor <quote
>make apidox</quote
> gør noget, inklusive , blandt andet tdelibs, tdebase og koffice. </entry>
</row>

<row id="conf-apply-qt-patches">
<entry
>apply-qt-patches</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Dette er kun nyttigtt for qt-copy. Hvis det er stillet til en værdi andet end nul, køres scriptet apply-patches i qt-copy inden byggeprocessen, for at udføre uofficielle programrettelser i qt-copy. Eftersom disse programrettelser normalt er grunden til at bruge qt-copy i stedet for en standardversion af Qt, skulle det ikke være skadligt at aktivere dette. Standardværdi er at aktivere programrettelserne.</entry>
</row>

<row id="conf-binpath">
<entry
>binpath</entry>
<entry
>Kan ikke sættes udf af kraft</entry>
<entry
><para
>Sæt dette for at bruge miljøvariablen PATH under byggeprocessen. Du kan ikke dette ud af kraft i et modultilvalg. Standatdværdi er <filename class="directory"
>/bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin</filename
>. Miljøvariablen skal indeholde søgestier til udviklingsværktøjerne adskilte med kolon. Søgestierne <filename class="directory"
>$TDEDIR/bin</filename
> og <filename class="directory"
>$QTDIR/bin</filename
> tilføjes automatisk. Du kan bruge tilde (~) for eventuelle søgestier du tilføjer med dette tilvalg.</para>
</entry>
</row>

<row id="conf-branch">
<entry
>branch</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
><para
>Angiv dette for at tjekk ud fra en gren af KDE i stedet for  standarden "trunk", hvor KDE-udvikling sker. For eksempel for at tjekke  grenen KDE 3.4 ud, skal du angive tilvalget "3.4".</para>
<para
>Bemærk at visse moduler bruger et anderledes grennavn. I særdeleshed følger det krævede modul arts ikke  KDE's versionsnummer. Modulet arts som hørte sammen med KDE 3.4 var version 1.4.</para>
<para
>Hvis det mislykkes for tdesvn-build at hente en gren med dette tilvalg, kan du behøve at  angive URL'en for at hente fra manuelt med tilvalget <link linkend="conf-override-url"
>override-url</link
>.</para>
</entry>
</row>

<row id="conf-build-dir">
<entry
>build-dir</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Brug dette for at skifte mappen som indeholder kildekoden at bygge. Der er tre forskellige måder at bruge det: <itemizedlist
><listitem
><para
>Relativt til &kde;:&svn;-kildekodemappe (se <link linkend="conf-source-dir"
>tilvalget source-dir</link
>). Det er standard, og måden som scriptet virkede frem til version 0.61. Denne tilstand  vælges hvis du indskriver et mappenavn som ikke begynder med tilde (~) eller skråstreg (/).</para
><para
>Standardværdi er <filename class="directory"
>build</filename
></para
></listitem
><listitem
><para
>Absolut søgesti. Hvis du angiver en søgesti som begynder med /, bruges søgestien direkte. For eksempel <filename class="directory"
>/tmp/kde-obj-dir/</filename
></para
></listitem
><listitem
><para
>Relativt til din hjemmemappe. Hvis du angiver en søgesti som begynder med ~, bruges søgestien relativt til din hjemmemappe, på tilsvarende måde som skallens ekspansion af tilde. Forl eksempel ville <filename class="directory"
>~/builddir</filename
> indstille byggemappen til <filename class="directory"
>/home/brugernavn/builddir</filename
></para
></listitem
> </itemizedlist
>Dette kan, måske noget uventet, ændres pr modul. </entry>
</row>

<row id="conf-checkout-only">
<entry
>checkout-only</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Sæt dette for kun at tjekke kildekode ud fra &svn; del for del. Værdien af tilvalget skal være en liste med mapper adskilte med mellemrum at tjekke ud. Hvis du ikke inkluderer mappen admin, inkluderes den automatisk (hvis det behøves). Når du tjekker ud del for del hentes mappen admin ind fra kde-common, hvilket er stedet den findes på &svn;-serveren. Selvom tilvalget sætter det globale tilvalg ud af kraft, skal være klar over  at det at angive dette som et globalt tilvalg ikke giver mening. </entry>
</row>

<row id="conf-configure-flags">
<entry
>configure-flags</entry>
<entry
>Tilføjer globale tilvalg (undtagen for qt-copy)</entry>
<entry
>Brug dette tilvalg for at angive hvilke flag som skal sendes til ./configure når byggesystemet for modulet laves. Når det bruges som et globalt tilvalg, bruges det for alle moduler som scriptet bygger. qt-copy bruger et meget anderledes sæt indstillingstilvalg end resten af &kde;, så dette tilvalg <emphasis
>sætter de globale indstillinger ud af kraft</emphasis
> når det bruges for qt-copy.</entry>
</row>

<row id="conf-colorful-output">
<entry
>colorful-output</entry>
<entry
>Kan ikke sættes udf af kraft</entry>
<entry
>Sæt dette tilvalg til false for at deaktivere farvelagt uddata fra &tdesvn-build;. Dette tilvalg er normalt <quote
>true</quote
>. Bemærk at &tdesvn-build; ikke sender farvekoderne ud til noget andet end en terminal (såsom xterm, &konsole; eller den normale Linux-konsol). </entry>
</row>

<row id="conf-cxxflags">
<entry
>cxxflags</entry>
<entry
>Tilføjer til globale tilvalg</entry>
<entry
>Brug dette tilvalg for at angive hvilke flag som skal sendes til <command
>./configure</command
> som <envar
>CXXFLAGS</envar
> når byggesystemet for modulet laves. Dette tilvalg angives her i stedet for med <link linkend="conf-configure-flags"
>configure-flags</link
> eftersom tilvalget også sætter miljøvariablen <envar
>CXXFLAGS</envar
> under byggprocessen. </entry>
</row>

<row id="conf-dest-dir">
<entry
>dest-dir</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Brug dette tilvalg for at ændre navnet et modul gives på disken. Hvis modulet for eksempel var extragear/network, ville du kunne skifte navn på det til extragear-network med dette tilvalg. </entry>
</row>

<row id="conf-disable-agent-check">
<entry
>disable-agent-check</entry>
<entry
>Kan ikke sættes udf af kraft</entry>
<entry
>Normalt, hvis du bruger SSH for at hente Subversion-kildekoden (såsom hvis du bruger protokollen svn+ssh), forsøger tdesvn-build at sørge for at du bruger SSH-agenten, så håndterer den virkelig nogle SSH-identiteter. Dette er for at forsøge at forhindre at SSH spørger efter dit løsen for hvert modul. Du kan deaktivere kontrollen ved at sætte disable-agent-check til true. </entry>
</row>

<row id="conf-do-not-compile">
<entry
>do-not-compile</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
><para
>Brug dette tilvalg for at sætte miljøvariablen <envar
>DO_NOT_COMPILE</envar
> inden scriptet configure køres. Ifølge <ulink url="http://developer.kde.org/documentation/other/developer-faq.html"
>&kde;'s ofte stillede  spørgsmål for udviklere</ulink
>, skal det gøre at alle topniveaumapper du sender med ikke bygges. Katalogerne skal adskilles med mellemrum.</para>

<para
>Bemærk at kildekoden for programmerne stadigvæk hentes. Du kan bruge direktivet <link linkend="conf-checkout-only"
>checkout-only</link
> for at vælge mapper som du vil tjekke ud.</para>
</entry>
</row>

<row id="conf-email-address">
<entry
>email-address</entry>
<entry
>Kan ikke sættes udf af kraft</entry>
<entry>
<para
>Indstil dette tilvalg til e-mail-adressen som tdesvn-build skal sende fra hvis det nogensinde behøver at sende e-mail. Du behøver ikke bekymre dig om det hvis du ikke bruger nogen funktion som sender e-mail (De er alle normalt deaktiverede). </para>

<para
>For øjeblikket behøver kun <link linkend="conf-email-on-compile-error"
>email-on-compile-error</link
> tilvalget. </para>
</entry>
</row>

<row id="conf-email-on-compile-error">
<entry
>email-on-compile-error</entry>
<entry
>Kan ikke sættes udf af kraft</entry>
<entry>
<para
>Du kan indstille dette tilvalg til e-mail-adressen hvorhen en rapport skal sendes når et modul mislykkes at bygge. tdesvn-build venter til alle moduler er færdige og samler alle resultater i rapporten. Rapporten sendes kun hvis det mislykkes at bygge et modul. </para>

<para
>Se tilvalget <link linkend="conf-email-address"
>email-address</link
> for at indstille adressen som tdesvn-build skal sende fra, eftersom standardværdien som oftest ikke er hvad du vil have. </para>
</entry>
</row>

<row id="conf-inst-apps">
<entry
>inst-apps</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
><para
>Dette er modsætningen til tilvalget <link linkend="conf-do-not-compile"
>do-not-compile</link
>. Dette tilvalg gør at kun angivne topniveaumapper bygges. Katalogerna skal adskilles med mellemrum.</para>

<para
>Eventuelle ændringer får ingen virkning førend næste gang <command
>make <option
>-f</option
> Makefile.cvs</command
> køres, enten automatisk af scriptet, eller manuelt med tilvalgene <link linkend="cmdline-refresh-build"
><option
>--refresh-build</option
></link
> eller <link linkend="cmdline-recreate-configure"
><option
>--recreate-configure</option
></link
>. </para>

<para
>Bemærk at kildekoden for programmerne stadigvæk hentes. Du kan bruge direktivet <link linkend="conf-checkout-only"
>checkout-only</link
> for at vælge mapper som du vil tjekke ud.</para>
</entry>
</row>

<row id="conf-install-after-build">
<entry
>install-after-build</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Dette tilvalg bruges til at installere pakken efter det er lykkedes at bygge den. Dette tilvalg er normalt aktiveret. Hvis du vil deaktivere det, skal du sætte tilvalget til 0 i indstillingsfilen. Du kan også bruge kommandolinjeflaget <link linkend="cmdline-no-install"
><option
>--no-install</option
></link
>. </entry>
</row>

<row id="conf-tdedir">
<entry
>tdedir</entry>
<entry
>Kan ikke sættes udf af kraft</entry>
<entry
>Dette tilvalg angiver mappen som &kde; installeres i efter det er bygget. Standardværdien er <filename class="directory"
>~/kde</filename
>. Hvis du ændrer det til en mappe som kræver adgang som systemadministrator, bør du også læse om tilvalget <link linkend="conf-make-install-prefix"
>make-install-prefix</link
>.</entry>
</row>

<row id="conf-libpath">
<entry
>libpath</entry>
<entry
>Kan ikke sættes udf af kraft</entry>
<entry
>Angiv dette tilvalg for at sætte miljøvariablen LD_LIBRARY_PATH under byggeprocessen. Du kan ikke sætte denne indstilling ud af kraft med et modultilvalg. Standardværdi er tomt, men søgestierne <filename class="directory"
>$TDEDIR/lib</filename
> og <filename class="directory"
>$QTDIR/lib</filename
> tilføjes automatisk. Du kan bruge tilde (~) i alle søgestier du tilføjer med dette tilvalg. </entry>
</row>

<row id="conf-log-dir">
<entry
>log-dir</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Brug dette tilvalg for at ændre mappen som bruges til at opbevare logfiler som laves af scriptet. Indstillingen kan ændres pr modul fra og med version 0.64 eller senere. </entry>
</row>

<row id="conf-make-install-prefix">
<entry
>make-install-prefix</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Sæt denne variabel til en liste adskilt med mellemrum, som tolkes som en kommando og dens flag til at gå forud for kommandoen make install som bruges til at installere moduler. Dette er nyttigt for eksempel til at installere pakker med sudo, men vær forsigtig når du håndterer systemadministratorens rettigheder.</entry>
</row>

<row id="conf-make-options">
<entry
>make-options</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Angiv denne variabel for at sende kommandolinjeflag til kommandoen make. Dette er nyttigt for programmer såsom <ulink url="http://distcc.samba.org/"
><application
>distcc</application
></ulink
>. Programmet <application
>distcc</application
> lader dig opdele dit kompileringsarbejde på mere end en maskine. For at bruge det, skal du bruge flaget <option
>-j</option
> til make. Nu kan du det. Ifølge dokumentationen anbefales 2 * antal_processorer_i_netværket. Jeg har i alt en processor, så det ville være <option
>-j2</option
> i mit tilfælde.</entry>
</row>

<row id="conf-manual-build">
<entry
>manual-build</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Sæt tilvalgsværdien til <quote
>true</quote
> for at forhindre at byggeprocessen forsøger at bygge modulet. Den holdes stadigvæk opdateret ved opdatering fra &svn;. Dette tilvalg svarer nøjagtigt til kommandolinjeflaget <link linkend="cmdline-no-build"
><option
>--no-build</option
></link
>. </entry>
</row>

<row id="conf-manual-update">
<entry
>manual-update</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Sæt tilvalgsværdien til <quote
>true</quote
> for at forhindre at byggeprocessen forsøger at opdatere (og følgelig, bygge eller installere) modulet. Hvis du angiver tilvalget for et modul, er det stort set det samme som at kommentere det bort. </entry>
</row>

<row id="conf-module-base-path">
<entry
>module-base-path</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
><para
>Sæt dette tilvalg for at sætte &tdesvn-build;s standardmappesti til modulet det drejer sig omd ud af kraft. Det kan for eksempel bruges til at hente specifikke grene eller mærkede versioner af biblioteker. <ulink url="http://websvn.kde.org/"
>&kde;'s kildekodevisning</ulink
> er uvurderlig som hjælp til at vælge rette søgesti.</para>
<para
>Bemærk at &tdesvn-build; konstruerer den endelige søgesti efter følgende skabelon: <varname
>$svn-server</varname
>/home/kde/<varname
>$module-base-path</varname
>/<varname
>$module-name</varname
>. </para>
<para
>Standardværdien er enten <quote
>trunk</quote
> eller <quote
>trunk/KDE</quote
>, afhængig af modulnavnet.</para>
</entry>
</row>

<row id="conf-niceness">
<entry
>niceness</entry>
<entry
>Kan ikke sættes udf af kraft</entry>
<entry
>Sæt dette  tilvalg til et tal mellem 20 og 0. Jo højere nummer, desto lavere prioritet sætter &tdesvn-build; for sig selv. Standardværdi er 10. </entry>
</row>

<row id="conf-no-rebuild-on-fail">
<entry
>no-rebuild-on-fail</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Indstil denne tilvalgsværdi til <quote
>true</quote
> for altid at forhindre at &tdesvn-build; forsøger at genbygge modulet hvis en inkrementel byggeproces skulle mislykkes. Normalt forsøger &tdesvn-build; at genbygge modulet fra begyndelsen for at modvirke virkningen at enkelt &svn;-opdatering forårsager problemer med byggesystemet.</entry>
</row>

<row id="conf-override-url">
<entry
>override-url</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Hvis du angiver dette tilvalg, bruger tdesvn-build dets værdi som URL at sende til Subversion <emphasis
>helt uforandret</emphasis
>. Du bør  generelt bruge dette hvis du vil hente en specifik udgave, men tdesvn-build kan ikke regne ud hvad du mener ved at bruge <link linkend="conf-branch"
>branch</link
>. </entry>
</row>

<row id="conf-qtdir">
<entry
>qtdir</entry>
<entry
>Kan ikke sættes udf af kraft</entry>
<entry
>Sæt dette tilvalg for at bruge miljøvariablen QTDIR under byggeprocessen. Du kan ikke sætte dette  tilvalg ud af kraft i et modultilvalg. Standardværdi er <filename class="directory"
><varname
>$(source-dir)</varname
>/build/qt-copy</filename
>, som bruger modulet qt-copy som indgår i &kde;:s kildekodearkiv. Du kan bruge tilde (~) til at repræsentere din hjemmemappe. </entry>
</row>

<row id="conf-remove-after-install">
<entry
>remove-after-install</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
><para
>Hvis du kun har lidt om harddiskplads kan du ville bruge dette tilvalg til at automatisk at fjerne byggemappen (eller både kildemappen og byggemappen for engangsinstallationer) efter det er lykkedes at installere modulet. </para>
<para
>Mulige værdier for dette tilvalg er: <itemizedlist>
<listitem
><para
>none - Slet ikke bort noget (dette er standardværdien).</para
></listitem>
<listitem
><para
>builddir - Slet byggemappen men ikke kildekoden.</para
></listitem>
<listitem
><para
>all - Slet både  kildekoden og byggemappen.</para
></listitem>
</itemizedlist>
</para>

<para
>Bemærk at brug af dette tilvalg kan give en signifikant skadelig indvirkning både på din brug af båndbredde (hvis du bruger 'all') og tiden det tager at kompilere KDE, eftersom tdesvn-build ikke kan udføre inkrementel bygning.</para>
</entry>
</row>

<row id="conf-set-env">
<entry
>set-env</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
><para
>Dette tilvalg accepterer et sæt værdier adskilte af mellemrum, hvor den første værdi er miljøvariabel at sætte, og følgende værdier er hvad du vil sætte variabelen til. For eksempel for at sætte variablen ANDERS til AND, ville du skrive følgende kommando i det dertil passende afsnit:</para>
<screen
><command
>set-env</command
> <envar
>ANDERS</envar
> <userinput
>AND</userinput
></screen>
<para
>Dette tilvalg er specielt på den måde at det kan gentages uden at sætte tidligere indstillinger ud af kraft med set-env i samme afsnit af indstillingsfilen. På den måde du angive mere end en miljøvariabel pr modul (eller globalt).</para>
</entry>
</row>

<row id="conf-source-dir">
<entry
>source-dir</entry>
<entry
>Kan ikke sættes udf af kraft</entry>
<entry
>Dette tilvalg bruges til at angive mappen på maskinen hvor &kde;'s &svn;-kildekode skal opbevares. Hvis du ikke angiver denne værdi, er standardværdien  <filename class="directory"
>~/tdesvn</filename
>. Hvis du angiver denne værdi, brug en absolut søgesti. </entry>
</row>

<row id="conf-svn-server">
<entry
>svn-server</entry>
<entry
>Kan ikke sættes udf af kraft</entry>
<entry
>Dette tilvalg bruges til at angive serveren som bruges ved udtjekning fra &svn;. Standard er det anonyme &svn;-arkiv, <emphasis
>svn://anonsvn.kde.org/</emphasis
>.</entry>
</row>

<row id="conf-stop-on-failure">
<entry
>stop-on-failure</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Sæt denne tilvalgsværdi til <quote
>true</quote
> for at gøre at scriptet holder op med at køre efter en fejl opstår i bygge- eller installationsprocessen. Dette tilvalg er normalt slået fra. </entry>
</row>

<row id="conf-tag">
<entry
>tag</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
><para
>Brug dette tilvalg for at hente en specifik udgave af et modul.</para>
<para
><emphasis
>Bemærk:</emphasis
> Der er høje odds for at du IKKE ØNSKER at bruge dette tilvalg. KDE-udgaver er tilgængelige på arkivform fra <ulink url="ftp://ftp.kde.org/"
>KDE's FTP-sted</ulink
> eller et af dets <ulink url="http://download.kde.org/download.php"
>spejle</ulink
>.</para>
<para
>Hvis du bruger tdesvn-build fordi du har svært ved at få fat på en KDE-udgave at bygge på din distribution, så overvej at bruge byggeværktøjet <ulink url="http://developer.kde.org/build/konstruct/"
>Konstruct</ulink
> i stedet for, som virker ud fra de udgivne tar-bolde.</para>
</entry>
</row>

<row id="conf-use-qt-builddir-hack">
<entry
>use-qt-builddir-hack</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
>Selvom dette tilvalg sætter det globale tilvalg ud af kraft, giver det kun mening for qt-copy. Sæt dette tilvalg til <quote
>true</quote
> for at aktivere scriptets <emphasis
>eksperimentelle</emphasis
> tilstand med kildemappe adskilt fra byggemappe. Når det er aktiveret, kopierer &tdesvn-build; qt-copy's kildekodemodul til byggemappen, og udfører byggeprocessen derfra. Det betyder at miljøvariablen QTDIR i stedet skal være indstillet til <filename class="directory"
>$(qt-copy-build-dir)/qt-copy/lib</filename
>. Du skal også ændre tilvalget <link linkend="conf-qtdir"
>qtdir</link
> på tilsvarende måde. At bygge inkrementelt skulle stadigvæk virke i denne tilstand, eftersom tidsstempler bevaras efter kopieringen. Hvis du bruger tilvalget <link linkend="conf-apply-qt-patches"
>apply-qt-patches</link
>, udføres programrettelserne  i byggemappen, ikke i kildekodemappen. Tilvalgets standardværdi er <quote
>true</quote
>. </entry>
</row>

<row id="conf-use-unsermake">
<entry
>use-unsermake</entry>
<entry
>Sætter global ud af kraft</entry>
<entry
><para
>Sæt dette tilvalg til <quote
>true</quote
> for at bruge det eksperimentelle program unsermake i stedet for automake når scriptet configure køres. Det kan forårsage væsentlig mindskning af byggetiden, især for <ulink url="http://www.csh.rit.edu/slashdot/distcc.html"
>distribuerede byggesystem</ulink
>. Tilvalgets standardværdi er <quote
>true</quote
> (for de fleste moduler). </para>

<para
>Normalt, hvis du bruger dette tilvalg kommer tdesvn-build automatisk til at holde unsermake opdateret. Det kan begynde at blive irriterende, især hvis du håndterer unsermake selv. Hvis dette er tilfældet, kan du sætte tilvalget til <quote
>self</quote
>, så bruger tdesvn-build stadigvæk unsermake, men gør ingenting særligt for at holde det opdateret. </para>
</entry>
</row>

</tbody>

</tgroup>
</table>

</chapter>

<chapter id="cmdline">
<title
>Kommandolinjeflag og miljøvariabler</title>

<para
>Scriptet bruger ikke miljøvariabler. Hvis du behøver at sætte miljøvariabler for bygge- eller installationsprocessen, så se tilvalget <link linkend="conf-set-env"
>set-env</link
>. </para>

<para
>Scriptet accepterer følgende kommandolinjeflag: </para>

<variablelist>

<varlistentry id="cmdline-help">
<term
><option
>--help</option
></term>
<listitem
><para
>vis kun simpel hjælp om scriptet. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-version">
<term
><option
>---version</option
></term>
<listitem
><para
>vis programmets version. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-author">
<term
><option
>--author</option
></term>
<listitem
><para
>vis forfatterens kontaktinformation. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-color">
<term
><option
>--color</option
></term>
<listitem
><para
>aktivér farvelagt uddata. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-no-color">
<term
><option
>--no-color</option
></term>
<listitem
><para
>deaktivér farvelagt uddata. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-pretend">
<term
><option
>--pretend</option
> (eller <option
>-p</option
>)</term>
<listitem
><para
>udfører IKKE noget, men opfør sig som om du gjorde det. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-quiet">
<term
><option
>--quiet</option
> (eller <option
>-q</option
>)</term>
<listitem
><para
>Vær ikke så støjende med uddata. Med dette flag meddeles kun det vigtigste. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-really-quiet">
<term
><option
>--really-quiet</option
></term>
<listitem
><para
>Kun advarsler og fejl. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-verbose">
<term
><option
>--verbose</option
></term>
<listitem
><para
>Beskriv i detalje hvad der sker, og hvad tdesvn-build gør. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-svn-only">
<term
><option
>--svn-only</option
></term>
<listitem
><para
>udfører kun opdatering af kildekoden. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-build-only">
<term
><option
>--build-only</option
></term>
<listitem
><para
>udfører kun byggeprocessen. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-ignore-modules">
<term
><option
>--ignore-modules</option
></term>
<listitem
><para
>inkludér ikke moduler som sendes på resten af kommandolinjen under opdaterings- og byggeprocessen. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-no-svn">
<term
><option
>--no-svn</option
></term>
<listitem
><para
>spring over at kontakte &svn;-serveren. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-no-build">
<term
><option
>--no-build</option
></term>
<listitem
><para
>spring over byggeprocessen. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-no-install">
<term
><option
>--no-install</option
></term>
<listitem
><para
>installér ikke automatisk pakker efter de er bygget. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-debug">
<term
><option
>--debug</option
></term>
<listitem
><para
>aktiverer fejlsøgningstilstand for scriptet. For øjeblikket betyder det at al uddata sendes til STDOUT foruden at logges i logmappen som sædvanligt. Desuden er mange funktioner meget udførligere om hvad de gør i fejlsøgningstilstand. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-no-rebuild-on-fail">
<term
><option
>--no-rebuild-on-fail</option
></term>
<listitem
><para
>forsøg ikke at genbygge moduler som det er mislykket at bygge fra begyndelsen. &tdesvn-build; forsøger aldrig at gøre dette med et modul hvor et forsøg på at bygge fra begyndelsen allerede er gjort. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-refresh-build">
<term
><option
>--refresh-build</option
></term>
<listitem
><para
>genopret om byggesystemet og byg fra grunden. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-reconfigure">
<term
><option
>--reconfigure</option
></term>
<listitem
><para
>kør scriptet configure igen uden at rense byggemappen. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-recreate-configure">
<term
><option
>--recreate-configure</option
></term>
<listitem
><para
>kør <command
>make <option
>-f</option
> Makefile.cvs</command
> igen for at oprette scriptet configure, og fortsæt med at bygge som sædvanligt. Dette tilvalg implicerer <option
><link linkend="cmdline-reconfigure"
>--reconfigure</link
></option
>. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-resume">
<term
><option
>--resume</option
></term>
<listitem
><para
>som forsøger at fortsætte med at  bygge fra stedet hvor scriptet sluttede sidste gangen. Scriptet begynder at bygge modulet efter det seneste modul som kompileredes sidst da scriptet kørtes, havd enten det lykkedes eller ej. Dette tilvalg implicerer <link linkend="cmdline-no-svn"
><option
>--no-svn</option
></link
>. Du bør ikke angive andre modulnavne på kommandolinjen. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-resume-from">
<term
><option
>--resume-from</option
></term>
<listitem
><para
>som er ligesom <link linkend="cmdline-resume"
><option
>--resume</option
></link
>, bortset fra at du angiver modulet hvor byggeprocessen skal begynde som næste parameter på kommandolinjen. Alternativet implicerer <link linkend="cmdline-no-svn"
><option
>--no-svn</option
></link
>. Du bør ikke angive andre modulnavne på kommandolinjen. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-rc-file">
<term
><option
>--rc-file</option
></term>
<listitem
><para
>som tolker næste kommandolinjeflag som filen at læse indstillingstilvalg fra. Standardværdien for denne parameter er ~/.tdesvn-buildrc. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-prefix">
<term
><option
>--prefix=&lt;/søgesti/till/kde&gt;</option
></term>
<listitem
><para
>som lader dig ændre mappen som &kde; installeres i fra kommandolinjen. Dette tilvalg  implicerer <link linkend="cmdline-reconfigure"
><option
>--reconfigure</option
></link
>. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-build-system-only">
<term
><option
>--build-system-only</option
></term>
<listitem
><para
>stop efter at have kørt <command
>make <option
>-f</option
> Makefile.cvs</command
>. Scriptet configure skal stadigvæk køres, hvilket &tdesvn-build; gør næste gang. Dette lader dig forberede alle configure-scripter på en gang så du kan kigge på <command
>./configure <option
>--help</option
></command
> for hvert modul, og redigere dine flag til configure i overensstemmelse med dette. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-install"
><term
><option
>--install</option
></term>
<listitem
><para
>hvis dette er det eneste kommandolinjeflag, forsøger scriptet at installere alle moduler som det er lykkedes at bygge, bortset fra qt-copy som ikke behøver at installeres. Hvis kommandolinjeflag angives efter <option
>--install</option
>, antages de alle at være moduler at installere. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-global-option">
<term
><option
>--&lt;option-name&gt;=</option
></term>
<listitem
><para
>Du kan bruge dette tilvalg til at sætte et tilvalg i din indstillingsfil ud af kraft  for hvert modul. For eksempel for at sætte tilvalget <link linkend="conf-log-dir"
>log-dir</link
> ud af kraft, skulle du angive <option
>--log-dir=/søgesti/til/mappe</option
>. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-module-option">
<term
><option
>--&lt;modulnavn&gt;,&lt;tilvalgnavn&gt;=</option
></term>
<listitem
><para
>Du kan bruge dette flag til at sætte et tilvalg i indstillingsfilen for et vist modul ud af kraft. For eksempel for at sætte tilvalget <link linkend="conf-use-unsermake"
>use-unsermake</link
> ud af kraft for tdemultimedia, skal du angive <option
>--tdemultimedia,use-unsermake=false</option
>. </para
></listitem>
</varlistentry>

</variablelist>

<para
>Alle øvrige kommandolinjeflag antages at være moduler at opdatere og bygge. Bland helst ikke bygge og installere sammen. </para>

</chapter>

<chapter id="credits-and-licenses">
<title
>Medvirkende og licens</title>
&underFDL; </chapter>

</book>