summaryrefslogtreecommitdiff
path: root/Master/texmf-doc/source/german/texlive-ge/live.tex
blob: 1af532a4dcf6a30900fc624b325abc4eddb4674a (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
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431
2432
2433
2434
2435
2436
2437
2438
2439
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450
2451
2452
2453
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
2493
2494
2495
2496
2497
2498
2499
2500
2501
2502
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
2540
2541
2542
2543
2544
2545
2546
2547
2548
2549
2550
2551
2552
2553
2554
2555
2556
2557
2558
2559
2560
2561
2562
2563
2564
2565
2566
2567
2568
2569
2570
2571
2572
2573
2574
2575
2576
2577
2578
2579
2580
2581
2582
2583
2584
2585
2586
2587
2588
2589
2590
2591
2592
2593
2594
2595
2596
2597
2598
2599
2600
2601
2602
2603
2604
2605
2606
2607
2608
2609
2610
2611
2612
2613
2614
2615
2616
2617
2618
2619
2620
2621
2622
2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638
2639
2640
2641
2642
2643
2644
2645
2646
2647
2648
2649
2650
2651
2652
2653
2654
2655
2656
2657
2658
2659
2660
2661
2662
2663
2664
2665
2666
2667
2668
2669
2670
2671
2672
2673
2674
2675
2676
2677
2678
2679
2680
2681
2682
2683
2684
2685
2686
2687
2688
2689
2690
2691
2692
2693
2694
2695
2696
2697
2698
2699
2700
2701
2702
2703
2704
2705
2706
2707
2708
2709
2710
2711
2712
2713
2714
2715
2716
2717
2718
2719
2720
2721
2722
2723
2724
2725
2726
2727
2728
2729
2730
2731
2732
2733
2734
2735
2736
2737
2738
2739
2740
2741
2742
2743
2744
2745
2746
2747
2748
2749
2750
2751
2752
2753
2754
2755
2756
2757
2758
2759
2760
2761
2762
2763
2764
2765
2766
2767
2768
2769
2770
2771
2772
2773
2774
2775
2776
2777
2778
2779
2780
2781
2782
2783
2784
2785
2786
2787
2788
2789
2790
2791
2792
2793
2794
2795
2796
2797
2798
2799
2800
2801
2802
2803
2804
2805
2806
2807
2808
2809
2810
2811
2812
2813
2814
2815
2816
2817
2818
2819
2820
2821
2822
2823
2824
2825
2826
2827
2828
2829
2830
2831
2832
2833
2834
2835
2836
2837
2838
2839
2840
2841
2842
2843
2844
2845
2846
2847
2848
2849
2850
2851
2852
2853
2854
2855
2856
2857
2858
2859
2860
2861
2862
2863
2864
2865
2866
2867
2868
2869
2870
2871
2872
2873
2874
2875
2876
2877
2878
2879
2880
2881
2882
2883
2884
2885
2886
2887
2888
2889
2890
2891
2892
2893
2894
2895
2896
2897
2898
2899
2900
2901
2902
2903
2904
2905
2906
2907
2908
2909
2910
2911
2912
2913
2914
2915
2916
2917
2918
2919
2920
2921
2922
2923
2924
2925
2926
2927
2928
2929
2930
2931
2932
2933
2934
2935
2936
2937
2938
2939
2940
2941
2942
2943
2944
2945
2946
2947
2948
2949
2950
2951
2952
2953
2954
2955
2956
2957
2958
2959
2960
2961
2962
2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
2977
2978
2979
2980
2981
2982
2983
2984
2985
2986
2987
2988
2989
2990
2991
2992
2993
2994
2995
2996
2997
2998
2999
3000
3001
3002
3003
3004
3005
3006
3007
3008
3009
3010
3011
3012
3013
3014
3015
3016
3017
3018
3019
3020
3021
3022
3023
3024
3025
3026
3027
3028
3029
3030
3031
3032
3033
3034
3035
3036
3037
3038
3039
3040
3041
3042
3043
3044
3045
3046
3047
3048
3049
3050
3051
3052
3053
3054
3055
3056
3057
3058
3059
3060
3061
3062
3063
3064
3065
3066
3067
3068
3069
3070
3071
3072
3073
3074
3075
3076
3077
3078
3079
3080
3081
3082
3083
3084
3085
3086
3087
3088
3089
3090
3091
3092
3093
3094
3095
3096
3097
3098
3099
3100
3101
3102
3103
3104
3105
3106
3107
3108
3109
3110
3111
3112
3113
3114
3115
3116
3117
3118
3119
3120
3121
3122
3123
3124
3125
3126
3127
3128
3129
3130
3131
3132
3133
3134
3135
3136
3137
3138
3139
3140
3141
3142
3143
3144
3145
3146
3147
3148
3149
3150
3151
3152
3153
3154
3155
3156
3157
3158
3159
3160
3161
3162
3163
3164
3165
3166
3167
3168
3169
3170
3171
3172
3173
3174
3175
3176
3177
3178
3179
3180
3181
3182
3183
3184
3185
3186
3187
3188
3189
3190
3191
3192
3193
3194
3195
3196
3197
3198
3199
3200
3201
3202
3203
3204
3205
3206
3207
3208
3209
3210
3211
3212
3213
3214
3215
3216
3217
3218
3219
3220
3221
3222
3223
3224
3225
3226
3227
3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
3249
3250
3251
3252
3253
3254
3255
3256
3257
3258
3259
3260
3261
3262
3263
3264
3265
3266
3267
3268
3269
3270
3271
3272
3273
3274
3275
3276
3277
3278
3279
3280
3281
3282
3283
3284
3285
3286
3287
3288
3289
3290
3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
3309
3310
3311
3312
3313
3314
3315
3316
3317
3318
3319
3320
3321
3322
3323
3324
3325
3326
3327
3328
3329
3330
3331
3332
3333
3334
3335
3336
3337
3338
3339
3340
3341
3342
3343
3344
3345
3346
3347
3348
3349
3350
3351
3352
3353
3354
3355
3356
3357
3358
3359
3360
3361
3362
3363
3364
3365
3366
3367
3368
3369
3370
3371
3372
3373
3374
3375
3376
3377
3378
3379
3380
3381
3382
3383
3384
3385
3386
3387
3388
3389
3390
3391
3392
3393
3394
3395
3396
3397
3398
3399
3400
3401
3402
3403
3404
3405
3406
3407
3408
3409
3410
3411
3412
3413
3414
3415
3416
3417
3418
3419
3420
3421
3422
3423
3424
3425
3426
3427
3428
3429
3430
3431
3432
3433
3434
3435
3436
3437
3438
3439
3440
3441
3442
3443
3444
3445
3446
3447
3448
3449
3450
3451
3452
3453
3454
3455
3456
3457
3458
3459
3460
3461
3462
3463
3464
3465
3466
3467
3468
3469
3470
3471
3472
3473
3474
3475
3476
3477
3478
3479
3480
3481
3482
3483
3484
3485
3486
3487
3488
3489
3490
3491
3492
3493
3494
3495
3496
3497
3498
3499
3500
3501
3502
3503
3504
3505
3506
3507
3508
3509
3510
3511
3512
3513
3514
3515
3516
3517
3518
3519
3520
3521
3522
3523
3524
3525
3526
3527
3528
3529
3530
3531
3532
3533
3534
3535
3536
3537
3538
3539
3540
3541
3542
3543
3544
3545
3546
3547
3548
3549
3550
3551
3552
3553
3554
3555
3556
3557
3558
3559
3560
3561
3562
3563
3564
3565
3566
3567
3568
3569
3570
3571
3572
3573
3574
3575
3576
3577
3578
3579
3580
3581
3582
3583
3584
3585
3586
3587
3588
3589
3590
3591
3592
3593
3594
3595
3596
3597
3598
3599
3600
3601
3602
3603
3604
3605
3606
3607
3608
3609
3610
3611
3612
3613
3614
3615
3616
3617
3618
3619
3620
3621
3622
3623
3624
3625
3626
3627
3628
3629
3630
3631
3632
3633
3634
3635
3636
3637
3638
3639
3640
3641
3642
3643
3644
3645
3646
3647
3648
3649
3650
3651
3652
3653
3654
3655
3656
3657
3658
3659
3660
3661
3662
3663
3664
3665
3666
3667
3668
3669
3670
3671
3672
3673
3674
3675
3676
3677
3678
3679
3680
3681
3682
3683
3684
3685
3686
3687
3688
3689
3690
3691
3692
3693
3694
3695
3696
3697
3698
3699
3700
3701
3702
3703
3704
3705
3706
3707
3708
3709
3710
3711
3712
3713
3714
3715
3716
3717
3718
3719
3720
3721
3722
3723
3724
3725
3726
3727
3728
3729
3730
3731
3732
3733
3734
3735
3736
3737
3738
3739
3740
3741
3742
3743
3744
3745
3746
3747
3748
3749
3750
3751
3752
3753
3754
3755
3756
3757
3758
3759
3760
3761
3762
3763
3764
3765
3766
3767
3768
3769
3770
3771
3772
3773
3774
3775
3776
3777
3778
3779
3780
3781
3782
3783
3784
3785
3786
3787
3788
3789
3790
3791
3792
3793
3794
3795
3796
3797
3798
3799
3800
3801
3802
3803
3804
3805
3806
3807
3808
3809
3810
3811
3812
3813
3814
3815
3816
3817
3818
3819
3820
3821
3822
3823
3824
3825
3826
3827
3828
3829
3830
3831
3832
3833
3834
3835
3836
3837
3838
3839
3840
3841
3842
3843
3844
3845
3846
3847
3848
3849
3850
3851
3852
3853
3854
3855
3856
3857
3858
3859
3860
3861
3862
3863
3864
3865
3866
3867
3868
3869
3870
3871
3872
3873
3874
3875
3876
3877
3878
3879
3880
3881
3882
3883
3884
3885
3886
3887
3888
3889
3890
3891
3892
3893
3894
3895
3896
3897
3898
3899
3900
3901
3902
3903
3904
3905
3906
3907
3908
3909
3910
3911
3912
3913
3914
3915
3916
3917
3918
3919
3920
3921
3922
3923
3924
3925
3926
3927
3928
3929
3930
3931
3932
3933
3934
3935
3936
3937
3938
3939
3940
3941
3942
3943
3944
3945
3946
3947
% distribution source: http://www.tug.org/ftp/texlive/Contents/testlive/ ...etc.
% documentation source: http://tug.org/texlive/devsrc/Master/texmf-doc/source/english/texlive-en/
% $Id$
% TeX Live documentation.  Originally written by Sebastian Rahtz and
% Michel Goossens, now maintained by Karl Berry and others.
% Public domain.
% German translation by Günter Partosch (7.11--22.11.2004)
% 2005 update by Klaus Hoeppner.
% 2006 update by Norbert Preining.

\documentclass[a4paper,twoside,10pt]{article}
\ifnum\Status=1
  % Create A4 pdf
  \pdfpageheight297mm
  \pdfpagewidth210mm
\fi
\let\tldocgerman=1  % for live4ht.cfg
\usepackage{ngerman}
\usepackage{booktabs}
\usepackage[ngerman]{varioref}
\usepackage{parskip}
%\usepackage{tex4ht}
%\usepackage{hyperref}
\hyphenation{Da-tei-na-men Be-din-gun-gen UNIX Ab-schnitt Kon-fi-gu-ra-tions-da-tei 
In-stal-la-tion Al-ter-na-tiv Zei-chen-zu-ord-nungs-da-tei einer eine TEXFONTMAPS}

\usepackage{tex-live}

%% perhaps a workaround: (no, it causes all the links to break; cannot
%% use \path here).
%\def\OnCD#1{\href{../../../../#1}{\path{#1}}}

\newcommand\OptPl{{\ensuremath\rightarrow\ }}
\newcommand\Titlename[1]{{\textsf{#1}}}

\setlength\marginparwidth{0pt}
\setlength\marginparsep{0pt}
\setlength\evensidemargin{15pt}
\setlength\oddsidemargin{15pt}

% deutsche typographische Anpassung
    % Trennung von tt-Font
    \newcommand{\origttfamily}{}% sollte noch nicht definiert sein!
    \let\origttfamily=\ttfamily % alte Definition von \ttfamily sichern
    \renewcommand{\ttfamily}{\origttfamily \hyphenchar\font=`\-}

    \renewcommand{\samp}[1]{">\mbox{\texttt{#1}}"<}
    \renewcommand{\optname}[1]{\mbox{\texttt{#1}}}
    \renewcommand{\TypeI}{Type"~1}
    \renewcommand{\var}[1]{{\rmfamily\sl #1}}
    \renewcommand{\MP}{\textrm{META""POST}}
%    \renewcommand{\cmdname}[1]{\textsf{\sc #1}}
    \renewcommand{\dirname}[1]{\texttt{#1}}%   directory name
    \renewcommand{\filename}[1]{\texttt{#1}}%  file name
    \renewcommand{\KPS}{\cmdname{Kpathsea}}
    \renewcommand{\TL}{{{\TeX}\,Live}}
    \renewcommand{\MacOSX}{Mac\,\acro{OS\,X}\xspace}

    \newcommand{\ttit}[1]{\texttt{\itshape#1}}
    \newcommand{\CDROM}{\acro{CD"~ROM}\xspace}
    \newcommand{\pdfTeX}{pdf\TeX\xspace}
    \newcommand{\pdfLaTeX}{pdf\LaTeX\xspace}
    \newcommand{\plainTeX}{\textrm{plain}\TeX\xspace}
    \newcommand{\CDVD}{\acro{DVD} und \acro{CD"~ROM}\xspace}
    \newcommand{\pdf}{\acro{PDF}\xspace}
    \newcommand{\TUG}{\TeX~Users~Group}
    \newcommand{\DTK}{">Die \TeX nische Komödie"<}
    \newcommand{\UKTUG}{\acro{UK}{\TeX} Users~Group}
    \newcommand{\ME}{Windows\,\acro{ME}\xspace}
    \newcommand{\NT}{Windows\,\acro{NT}\xspace}
    \newcommand{\XP}{Windows\,\acro{XP}\xspace}

\newcommand{\deflabel}[1]{\mdseries\cmdname{#1}\hfill}
\newenvironment{deflist}[1]%
{\begin{list}{}%
{\settowidth{\labelwidth}{\bf #1}%
\setlength{\leftmargin}{\labelwidth}%
\addtolength{\leftmargin}{\labelsep}%
\renewcommand{\makelabel}{\deflabel}}}%
{\end{list}}

%---------------------------------------------------------
% Fussnoten
%---------------------------------------------------------
\makeatletter
\renewcommand{\@makefntext}[1]{%
% formatiert die Fussnoten als haengende Absaetze
\setlength{\parindent}{0pt}%
\begin{list}{}{%
\setlength{\labelwidth}{1.0em}%
\setlength{\leftmargin}{\labelwidth}%
\setlength{\labelsep}{3pt}%
\setlength{\itemsep}{0pt}%
\setlength{\parsep}{0pt}%
\setlength{\topsep}{0pt}%
\footnotesize}\item[\hfill\@makefnmark\hfill]#1%
\end{list}%
}
\makeatother

%---------------------------------------------------------
% Aufbereitungsvarianten
%---------------------------------------------------------
%\renewcommand{\Status}{1}
% \Status = 0: TeX Live documentation in DVI format
% \Status = 1: TeX Live documentation in PDF format
% \Status = 2: TeX Live documentation in HTML format
% \Status = 3: TeX Live documentation as a Baskerville issue
% \Status = 4: TeX Live documentation as a TUB article

\listfiles

\begin{document}

\title{%
  {\huge \textit{Anleitung zum \protect\TL-System}\\\strut}
  {\LARGE \textsf{\TK{} 2007}}
}

\author{Karl Berry (Herausgeber) \\[3mm]
        \url{http://tug.org/texlive/}\\[12mm]
\ifnum \Status=1
        %\includegraphics[width=.7\hsize]{texlive2004-front.pdf} \\[5mm]
\else\ifnum \Status=2
        %\includegraphics[width=.7\hsize]{texlive2004-front.png} \\[5mm]
\fi\fi
        \small{\textit{Verantwortlich für die deutsche Ausgabe}}\\[3mm]
        \small{Klaus Höppner, \email{klaus@dante.de}} \\
        \small{(DANTE e.V.)}        \\[3mm]
%        \small{\textit{Ansprechpartner für die Ausgaben in}}\\[3mm]
        \small
%        \begin{tabular}{lll}
%Englisch    & Karl Berry           & \email{karl@freefriends.org} \\             %%
%Französisch & Daniel~Flipo \& 
%              Fabrice Popineau     & \email{Daniel.Flipo@univ-lille1.fr} \\
%            &                      & \& \email{Fabrice.Popineau@supelec.fr} \\
%Polnisch    & Staszek Wawrykiewicz & \email{staw@gust.org.pl} \\
%Tschechisch & Petr Sojka           & \email{sojka@informatics.muni.cz} \\
%Slowakisch  & Jan~Busa             & \email{Jan.Busa@tuke.sk} \\
%Russisch    & Boris Veytsman       & \email{borisv@lk.net} \\                    %%
%Deutsch     & Günter Partosch 
%              \& Hartmut Henkel    & \email{Guenter.Partosch@hrz.uni-giessen.de} \\
%            &                      & \& \email{hartmut_henkel@gmx.de}\\
%         \end{tabular} \\[8mm]
         }


\date{Dezember 2006}

\maketitle
\thispagestyle{empty}

\newpage

\begin{multicols}{2}
    \tableofcontents
    \listoffigures
    \listoftables
\end{multicols}

%\renewcommand{\Status}{0}
%\typeout{Status is \Status}

\clearpage

% ==============================================================
\section{Einleitung}\label{sec:intro}

Diese Anleitung beschreibt das \TL-System. Die {\TL} enthält
\TeX/\LaTeX-Systeme für Linux, verschiedene \acro{UNIX}-Plattformen, {\MacOSX}
und (32-Bit)-Windows. \textbf{Warnung:} Für ältere Macintosh-Systeme und \acro{MS-DOS} sind diese
\TeX-Systeme wenig hilfreich.

{\TL} enthält lauf"|fähige Versionen von \TeX, \LaTeXe, \ConTeXt, \MF, \MP,
\cmdname{Makeindex}, {\BibTeX} und vielen anderen Programmen,
sowie eine umfassende Auswahl an Makros, Zeichensätzen und
Beschreibungen, die gemäß der Standard"=\TeX"=Verzeichnisstruktur (\TDS)
abgelegt sind. {\TL} eignet sich somit zur Nutzung
mit nahezu jeder \TeX"=Installation und erlaubt das Setzen von Schriften
und Texten vieler Sprachen. Es ist Teil der \TK, die in Zusammenarbeit mit den verschiedenen \TeX-Benutzergruppen 
entstanden ist und kurz im Abschnitt~\ref{sec:struct-tl} auf Seite~\pageref{sec:struct-tl} beschrieben wird.

Wenn Sie neuere Versionen der dort aufgeführten Pakete zu suchen wollen, gehen Sie am besten zu \acro{CTAN}: 
\url{http://www.ctan.org/}.

Eine kurze Zusammenfassung der wesentlichen Änderungen der aktuellen \TL-Version
gegenüber der Vorgängerversion finden Sie im Abschnitt~\ref{sec:history} auf
Seite~\pageref{sec:history}.

%Da diese {\TK} auf einem Medium (\DVD) {\TL} und {\CTAN}
%miteinander verbindet, gibt es im Abschnitt~\ref{sec:ctan} auf Seite~\pageref{sec:ctan} 
%einige zusätzliche Informationen über den
%\CTAN-Teil.

% -------------------------------------------------------------
\subsection{Einsatzmöglichkeiten des \TL-Systems der \TK}\label{sec:basic}

% ++++++++++++++++++++++++
\newcommand{\distribs}{%
% will be used repeatedly
(siehe hierzu Kapitel~\ref{sec:multiple-dist} auf
Seite~\pageref{sec:multiple-dist} über die verschiedenen
Distributionen)}
% ++++++++++++++++++++++++

Sie können das \TL-System auf drei verschiedene Arten nutzen:

\begin{enumerate}
\item Sie können auf Kosten der Ausführungsgeschwindigkeit alle
      zu {\TeX} gehörenden Programme direkt von der \pkgname{live}-{\DVD}
      starten und auf alle Makros und Zeichensätze zugreifen
      \distribs. Dieses Vorgehen benötigt kaum Plattenplatz -- der Geschwindigkeitsverlust kann akzeptiert werden.
\item Sie können das \TL-System komplett (oder Teile davon) auf
      einer lokalen Platte installieren. Dies ist sicherlich der Normalfall,
      erfordert aber mindestens 100\,MB Plattenplatz. Für das empfohlene
      Standardsystem benötigen Sie 310\,MB und für eine Komplettinstallation
      bis zu 1,3\,GB an Plattenspeicherplatz.
\item Sie haben die Möglichkeit, Ihr bestehendes \TeX-System durch
      Pakete oder Sammlungen von der {\CDVD} zu ergänzen. Dabei ist es
      gleichgültig, welches \TeX-System Sie benutzen.
\end{enumerate}

Alles das wird bei den betreffenden Installationsanleitungen für jedes Betriebssystem
ausführlich erläutert. Hier das Notwendigste:

\begin{itemize*}
\item Das Hauptinstallationsskript für \acro{UNIX} und {\MacOSX} ist \cmdname{install-tl.sh}.
\item Um ein einzelnes Paket unter \acro{UNIX} zu installieren, benutzen Sie das Skript \cmdname{install-pkg.sh}.
\item Das Windows-Installationsprogramm mit dem Namen \cmdname{tlpmgui.exe}
befindet sich im Verzeichnis \dirname{setup-win32} (siehe dazu Abschnitt~\ref{sec:win-install}).
Mit diesem Programm können Sie auch nachträglich Pakete hinzufügen oder entfernen.
\end{itemize*}


% -------------------------------------------------------------
\subsection{">Wo bekomme ich Hilfe?"< oder ">Hier werden Sie geholfen!"<}\label{sec:help}

Die \TeX-Gemeinschaft ist ebenso aktiv wie hilfsbereit, und es wird
praktisch jede ernst gemeinte Frage beantwortet. Diese Hilfe ist allerdings
nicht formal organisiert, sondern wird von Freiwilligen in ihrer
Freizeit geleistet. Es ist daher ernst gemeint, dass Sie vor einer
Fragestellung Ihre ">Hausaufgaben"< gemacht haben. Falls Sie auf
eine garantierte kommerzielle Unterstützung angewiesen sind oder eine solche
bevorzugen, sollten Sie die Finger vollständig vom \TL-System lassen und
in der Aufstellung unter \url{http://tug.org/interest.html#vendors} nach
einem geeigneten Händler suchen.

Die folgende Liste stellt die leicht zugänglichen Quellen in der
empfohlenen Reihenfolge vor:

\begin{description}
\item [Einführung:]\mbox{}\\
      Wenn Sie \TeX-Anfänger sind und eine englische Einführung in das System benötigen, sollten Sie das \acro{WWW}-
      Dokument \url{http://tug.org/begin.html} (Englisch) lesen.

      Für deutschsprachige \LaTeX-Anfänger ist die ">\LaTeXe-Kurzbeschreibung"< von großem Nutzen 
      (\OnCD{texmf-doc/doc/german/lshort-german/}).
\item [\TeX-\acro{FAQ}s:]\mbox{}\\
      Die \TeX-\acro{FAQ} (im Deutschen
      \file{de-tex-faq} ">\emph{Fragen und Antworten [\acro{FAQ}] über
      das Textsatzsystem TeX und \acro{DANTE}, Deutschsprachige
      Anwendervereinigung TeX e.V.}"<) ist ein riesiges Kompendium
      mit Fragen (und Antworten) aller Art, von der einfachsten
      Anfängerfrage bis zu Expertenwissen. Sie ist Bestandteil
      des \TL-Systems (\OnCD{texmf-doc/doc/german/FAQ-ge/}) und umfasst zur
      Zeit 182~Seiten als \pdf-Datei (\OnCD{texmf-doc/doc/german/FAQ-ge/de-tex-faq.pdf}). Darüber hinaus ist die
      \acro{FAQ} als \HTML-Datei (\OnCD{texmf-doc/doc/german/FAQ-ge/html/index.html})
      und als durchsuchbare Textdatei
      (\OnCD{texmf-doc/doc/german/FAQ-ge/text/index.html}) enthalten.
      Im Internet finden Sie die \acro{FAQ} unter
      \url{http://www.dante.de/faq/de-tex-faq/}; zudem wird die
      Text"-ver"-sion regelmäßig zur Monatsmitte in die News-Gruppen
      \url{news:de.comp.text.tex}, \url{news:de.answers} und \url{news:news.answers}
      verschickt. Die \acro{FAQ} besteht aus mehreren Teilen, wobei
      jeder Teil ohne News-Header nicht länger als ca. 32\,KB ist.

      Des Weiteren existiert eine englischsprachige \acro{FAQ}-Sammlung
      (\OnCD{texmf-doc/doc/english/FAQ-en/}), die auch im Internet verfügbar ist
      (\url{http://www.tex.ac.uk/faq}).

      Bitte nutzen Sie bei Problemen zu allererst diese beiden Möglichkeiten.

\item [\TeX-Catalogue:]\mbox{}\\
      Wenn Sie auf der Suche nach einem bestimmten Paket,
      Font, Programm u.\,ä. sind, empfiehlt sich ein Blick in den
      \TeX-Catalogue. Dieser Katalog enthält eine Liste aller verfügbaren
      \TeX-spezifischen Dinge (siehe \OnCD{texmf-doc/doc/english/catalogue} oder
      \url{http://www.ctan.org/tex-archive/help/Catalogue/}).

\item [\TeX-\acro{WWW}-Ressourcen:]\mbox{}\\
      Im \acro{WWW}-Dokument \url{http://tug.org/interest.html} finden Sie eine große Anzahl \TeX-spezifischer
      Links zu Büchern, Manuals und Artikeln zu allen Aspekten des \TeX-Systems.

\item [Archive:]\mbox{}\\
      Ein Forum für die Hilfestellung sind die Usenet-News-Gruppen
      \url{news:de.comp.text.tex} (Deutsch), \url{news:comp.text.tex} (Englisch)
      und die Mailing-Liste \email{texhax@tug.org}. In deren Archiven finden
      sich die Fragen und Antworten vieler Jahre. Ihre Suche können Sie in Google
      beispielsweise mit \url{http://groups.google.de/groups?group=de.comp.text.tex}
      starten -- oder auch in \url{http://tug.org/mail-archives/texhax/}.

      Im Allgemeinen ist es recht Erfolg versprechend, eine generelle Suche über Google
      \url{http://www.google.de/} durchzuführen (entweder im \emph{WWW} allgemein
      oder in den \emph{News-Gruppen}); dies insbesondere, wenn es sich um Fragen über
      \PS/{\pdf}, \cmdname{Ghostscript} u.\,ä. handelt.

\item [Fragen stellen:]\mbox{}\\
      Wenn Sie mit den oben aufgezeigten Möglichkeiten immer noch keine
      Antwort auf Ihre Frage gefunden haben, können Sie die Frage auch in einer
      News-Gruppe stellen (neudeutsch: \emph{posten}). Hier bietet sich für
      den deutschsprachigen Raum die News-Gruppe \url{news:de.comp.text.tex} an. 
      Benutzen Sie am besten für Anfragen Google 
      (\url{http://groups.google.de/groups?group=de.comp.text.tex})
      oder einen Newsreader. Fragen an die englischsprachige Gruppe
      \url{news:comp.text.tex} 
      (bei Google: \url{http://groups.google.de/groups?group=comp.text.tex}) 
      sollten Sie bitte nur in Englisch stellen.

      Zusätzlich existieren E-Mail-Diskussionslisten, wobei hier die deutschsprachige Liste
      \email{TeX-D-L@listserv.dfn.de} zu nennen ist (das englischsprachige Äquivalent 
      ist \email{texhax@tug.org}). Darüber hinaus bietet sich für Mitglieder
      von \acro{DANTE}~e.V. der Beraterkreis an (\email{beraterkreis@dante.de}).
      Wie Sie sich in die E-Mail-Liste \dirname{TeX-D-L} eintragen können,
      finden Sie in der \acro{FAQ} unter ">\texttt{1.3.2 Was ist TeX-D-L?}"<.

      Bevor Sie aber eine Frage absenden, lesen Sie \emph{bitte} die entsprechenden
      Einträge der \acro{FAQ} zum Thema ">\emph{Wie stelle ich eine Frage in einer
      Newsgroup, damit ich mit hoher Wahrscheinlichkeit eine Antwort bekomme?}"<. So
      z.\,B. ">\texttt{1.3.1 Was ist `de.comp.text.tex'?}"< und ">\texttt{1.3.7 Was
      sollte ich gelesen haben, bevor ich eine Frage in `de.comp.text.tex' oder der
      Diskussionsliste TeX-D-L stelle?}"< oder auch
      \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}.

\item [Mithilfe:]\mbox{}\\
      Wenn Sie einen Fehler melden wollen oder Empfehlungen und Kommentare
      zur \TL-Verteilung, -Installation oder -Dokumentation geben möchten, sollten Sie die
      E-Mail-Liste \email{tex-live@tug.org} nutzen. 
      Korrekturen, Anmerkungen und Erweiterungen für die deutsche Übersetzung können Sie auch
      an \email{cdrom@dante.de} oder schriftlich an die Geschäftsstelle von
      \acro{DANTE}~e.V. senden.

      Fragen zu Programmen, die Sie in der {\TK} finden, sollten Sie besser auf
      einer der oben genannten Mailing-Listen stellen oder direkt an den Programmautor
      richten.
\end{description}

Auf der anderen Seite können auch Sie mit Ihrem Wissen helfen. Die News-Gruppen
\url{news:de.comp.text.tex} (in Deutsch), \url{news:comp.text.tex} (in Englisch) und
die Mailing-Liste \email{TeX-D-L@listserv.dfn.de} (Deutsch) und \email{texhax@tug.org} (Englisch)
stehen allen offen. Wenn Sie also dort mitlesen, scheuen Sie sich nicht, Fragen,
zu denen Sie eine Antwort wissen, zu beantworten und damit anderen zu helfen.

% ==============================================================
\section[Struktur des \protect\TeX Live-Systems]{Struktur des \TL-Systems}\label{sec:struct-tl}
% don't use \TL so the \uppercase in the headline works.  Also so
% tex4ht ends up with the right TeX.  Likewise the \protect's.

In diesem Abschnitt beschreiben wir Struktur und Inhalt des \TL-Systems und der übergeordneten \TK.


% -------------------------------------------------------------
\subsection[Die Distributionen \protect\pkgname{live}, \protect\pkgname{inst}, \protect\pkgname{protext}]%
{Die Distributionen \pkgname{live}, \pkgname{inst}, \pkgname{protext}}\label{sec:multiple-dist}

Das Material des \TL-Systems war von Jahr zu Jahr angewachsen und hatte 
den Rahmen, der durch die Größe einer {\CDROM} vorgegeben war, gesprengt. Um nicht wieder eine
willkürliche Auswahl unter den unzähligen Paketen, Zeichensätzen und Hilfsprogrammen
treffen zu müssen, wurde schon 2003 der Entschluss gefasst, die {\TK} in 
unterschiedliche Distributionen zu zerlegen. Im Einzelnen:

\begin{deflist}{\pkgname{protext}}
\item [\pkgname{live}]
      ist ein vollständiges System auf einer {\DVD}.
      Mit mehr als 1,1\,GB ist es zu groß für eine \CDROM. 
      Es kann auf Festplatte installiert oder direkt von der {\DVD} gestartet werden.
      Zusätzlich enthält die {\DVD} unabhängig vom \TL-System die
      Mac\TeX-Distribution für \MacOSX, \pkgname{pro\TeX t} -- eine
      alternative \TeX-Distribution für MS Windows, die auf \MIKTEX
      basiert -- und ein fast vollständiges Abbild des \CTAN-Archivs
      (Stand: Oktober~2005) und eine Sammlung verschiedener Pakete in
      einem \dirname{texmf-extra}-Verzeichnis.

      Wenn Sie die {\DVD} unter Windows ">mounten"<, bietet Ihnen das Setup-Programm an, \pkgname{protext} zu 
      starten (siehe unten). Es berücksichtigt dabei auch {\CTAN} und {\TL}, die sich in Unterverzeichnissen der 
      obersten Stufe auf der {\DVD} befinden.

      Für {\CTAN} und den Verzeichnisbaum \dirname{texmf-extra} gelten andere Weitergabe-Bedingungen als für \TL. 
      Achten Sie bitte darauf, wenn Sie diese (oder Teile) weitergeben oder modifizieren.

\item [\pkgname{inst}]
      (installable) ist ein Komplettsystem auf \CDROM. Um dies zu ermöglichen, wurden alle Dateien auf dieser {\CDROM} 
      komprimiert. Daher kann man {\TeX} auch nicht direkt von der \pkgname{inst}-{\CDROM} laufen lassen, sondern muss 
      es auf der Festplatte \textbf{inst}allieren. 
      Die Installation entspricht dem Vorgehen bei der Installation von der \pkgname{live}-\acro{DVD} auf der Festplatte und wird in späteren Abschnitten beschrieben.

\item [\pkgname{protext}]
      {\ProTeXt} ist eine Erweiterung der \MIKTEX-Distribution für Windows. Es ergänzt {\MIKTEX} durch 
      einige Tools (u.\,a. \cmdname{WinEdt}, \cmdname{TeXnicCenter}, \cmdname{Ghostscript}/\cmdname{GSView}), ist 
      völlig unabhängig vom \TL-System und hat eine eigene 
      Installation. {\ProTeXt} kann auf Festplatte installiert oder direkt gestartet werden. Informationen 
      zu {\ProTeXt} finden Sie im \acro{WWW} übrigens unter \url{http://tug.org/protext/}.

      {\ProTeXt} wird sowohl auf der \pkgname{live}-{\DVD} als auch auf einer eigenen {\CDROM} angeboten (für 
      diejenigen, die die {\DVD} nicht benutzen können).
\end{deflist}

Welche der drei Distributionen Sie geladen haben, zeigt ihnen die Datei
">\file{00\var{typ}.TL}"< im Wurzelverzeichnis des Verteilungsmediums. Für die
\pkgname{inst}-Version der Distribution finden Sie die Datei mit dem
Namen ">\file{00INST.TL}"<. Die Datei enthält das Release-Datum und 
beschreibt den möglichen Einsatz der Distribution und ihre Einschränkungen:

\begin{small}
\begin{alltt}
   This is the TeX Live `inst' distribution.  You can *not* run programs
   directly from it, you must install it to disk.  It includes all packages.
\end{alltt}
\end{small}

% soll ich das Folgende einfügen: ??
% vielleicht wie folgt ??
% Naturally, each user group chooses what to distribute, at its own
% discretion.  (\acro{TUG} is sending all three discs above to all of its
% members.)
Alle \acro{DANTE}-Mitglieder erhalten die \TL-{\DVD} als Beilage zur Vereinszeitschrift \DTK. Für all diejenigen, die 
nichts mit der {\DVD} anfangen können, ist auf Anfrage auch eine \TL-{\CDROM} erhältlich. Zusätzlich gibt es auch 
eine \ProTeXt-\CDROM. Wenden Sie sich bitte an das Büro von \acro{DANTE}, Deutschsprachige Anwendervereinigung TeX e.V., 
wenn Sie Interesse an einer der beiden {\CDROM}s haben.

% -------------------------------------------------------------
\subsection{Basisverzeichnisse}\label{sec:tld}

In diesem Abschnitt beschreiben wir die Basisverzeichnisse der \TL-Distribution.

Auf der \pkgname{live}-\DVD befindet sich die gesamte \TL-Hierarchie im Unterverzeichnis \dirname{texliveYYYY} -- nicht 
im Wurzelverzeichnis der \DVD.

\smallskip

%% \begin{longtable}{@{}>{\ttfamily}lp{.63\hsize}@{}}
%%   \hline
%% \rm
%% Verzeichnis &  Inhalt \\
%%   \hline
%% \endfirsthead
%% \rm
%% Verzeichnis &  Inhalt \\
%%   \hline
%% \endhead
%%   \hline
%% \endfoot
\begin{tabular}{@{}>{\ttfamily}lp{.85\linewidth}@{}}
bin        &  ausführbare Programme des \TeX-Systems;
              jeweils für die verschiedenen Rechnerplattformen
              in Unterverzeichnissen zusammengefasst \\
source     &  Quelldateien aller Programme inklusive der
              \Webc-Quellen für die \TeX- und \MF-Pakete als
              komprimierte \file{bzip2}"=Archive \\
support    &  verschiedene Programme und Hilfspakete, die \emph{nicht} automatisch
              mitinstalliert werden, wie z.\,B. Editoren und \TeX-Shells\\
texmf      &  Verzeichnisbaum für Programme und zugehörigen Hilfsdateien und Anleitungen; enthält keine \TeX-Formate 
              und Pakete (siehe \texttt{TEXMFMAIN} im nächsten Abschnitt) \\
texmf-dist &  Hauptbaum mit Formaten und Paketen (siehe \texttt{TEXMFDIST} im nächsten Abschnitt)\\
texmf-doc  &  Verzeichnisbaum mit vollständigen Dokumentationen (ohne andere installierte Dateien); sortiert nach 
              Sprachen  \\
texmf-var  &  Verzeichnisbaum für automatisch erzeugte und gespeicherte Dateien
              für \TeX, {\MF} und andere (siehe \texttt{TEXMFSYSVAR} im nächsten Abschnitt),\\
xemtex     &  Verzeichnis mit nützlichen Programmen für Windows aus dem \XEmTeX-Paket
              (Alle diese Programme sind auf \acro{UNIX}-Systemen in
              der Regel vorinstalliert oder lassen sich zumindest
              leicht kompilieren.) \\
%%\end{longtable}
\end{tabular}

\smallskip

Zusätzlich zu den oben aufgeführten Verzeichnissen finden Sie im Wurzelverzeichnis der Distribution auch noch die 
Installationsskripte und die \filename{README}-Dateien in verschiedenen Sprachen.

Das Verzeichnis \OnCD{texmf-doc} enthält zwar nur Anleitungen, bei weitem aber nicht die gesamte Dokumentation: 
Die Dokumentation für Programme (Handbücher, ">man~pages"<, \acro{GNU}-\acro{info}-Dateien) beispielsweise finden Sie 
im Verzeichnis \OnCD{texmf/doc}, da die Programme selbst sich im Verzeichnis \OnCD{texmf} befinden. Ähnliches 
gilt für die Dokumentation der \TeX-Pakete und -Formate im Verzeichnis \OnCD{texmf-dist/doc}. 

Benutzen Sie die Programme \cmdname{texdoc} oder \cmdname{texdoctk}, wenn Sie auf der Suche nach irgendeiner 
Dokumentationsdatei sind. Hilfreich in diesem Zusammenhang könnte auch die Link-Sammlung \filename{doc.html} im 
Wurzelverzeichnis sein.

% -------------------------------------------------------------
\subsection{Überblick über die vordefinierten texmf-Bäume}
\label{sec:texmftrees}

Dieser Abschnitt listet alle vordefinierten texmf-Bäume, die vom System benutzt
werden, und deren Bedeutung auf. Das Kommando \cmdname{texconfig conf}
zeigt Ihnen die aktuellen Einstellungen dieser Variablen an.

\begin{ttdescription}
\item [TEXMFMAIN] In diesem Baum befinden sich wichtige Teile des Systems,
  Hilfsprogramme (wie \verb+web2c/mktexdir+), pool-Dateien und andere
  Hilfsdateien.
\item [TEXMFDIST] In diesem Baum befinden sich die wesentlichen Makro-Pakete,
  Fonts usw. Dieser Baum enthält systemunabhängige Daten, die prinzipiell
  von jedem TDS-kompatiblem \TeX-System nutzbar sein sollten.
\item [TEXMFLOCAL] Dieser Baum ist für Ergänzungen oder Aktualisierungen
  von Makros, Fonts etc. gedacht, die Administratoren für alle Nutzer
  installieren.
\item [TEXMFHOME] In diesem Baum können einzelne Nutzer Ergänzungen oder
  Aktualisierungen von Makros, Fonts etc. ablegen. Standardmäßig befindet
  sich dieser Baum unterhalb von \verb+$HOME+, so dass andere Nutzer von
  Änderungen hier nicht beeinflusst werden.
\item [TEXMFCONFIG] Dieser Baum wird von den Hilfsprogrammen von te\TeX{}
  wie \verb+texconfig+, \verb+updmap+ und \verb+fmtutil+ verwendet.
  Standardmäßig befindet sich dieser Baum unterhalb von \verb+$HOME+,
  so dass andere Nutzer von Änderungen hier nicht beeinflusst werden.
\item [TEXMFSYSCONFIG] Dieser Baum wird von den Hilfsprogrammen von te\TeX{}
  wie \verb+texconfig-sys+, \verb+updmap-sys+ und \verb+fmtutil-sys+
  verwendet, so dass hier das Verhalten des \TL-Systems für alle Nutzer
  beeinflusst werden kann.
\item [TEXMFVAR] Dieser Baum wird von Hilfsprogrammen wie \verb+texconfig+,
  \verb+updmap+ und \verb+fmtutil+ benutzt, um automatisch generierte
  Konfigurations-Dateien abzulegen.
\item [TEXMFSYSVAR] Dieser Baum wird von den systemweiten Hilfsprogrammen
  wie \verb+texconfig-sys+, \verb+updmap-sys+ und \verb+fmtutil-sys+
  verwendet, um automatisch generierte Konfigurations-Dateien abzulegen.
\end{ttdescription}

Für näherere Hinweise zu \texttt{texconfig} und zu den davon abhängigen
Hilfsprogrammen siehe Abschnitt~\ref{sec:texconfig} auf Seite~\pageref{sec:texconfig}.

% -------------------------------------------------------------
\subsection{\protect\TeX-Erweiterungen}\label{sec:tex-extensions}

Unter den \TeX-Systemen der {\TL} befinden sich verschiedene
\TeX"=Erweiterungen:

\begin{deflist}{pdfe\TeX}
\item [\eTeX]\label{text:etex} stellt bei 100\%-iger Kompatibilität zum
      normalen {\TeX} einen kleinen, aber mächtigen Satz neuer Befehle
      bereit (für Makroexpansion, Character-Scanning, zusätzliche
      Klassen für ">marks"<, erweiterte Debug-Möglichkeiten und andere).
      Zusätzlich gibt es noch die \TeXXeT-Erweiterungen für den bidirektionalen Textsatz, 
      wie er beispielsweise im Arabischen gebraucht wird.
      Im voreingestellten Modus ist {\eTeX} 100\%-ig kompatibel mit dem ">normalen"< \TeX.
      Die Dokumentation zu {\eTeX} finden Sie in der Datei
      \OnCD{texmf-dist/doc/etex/base/etex_man.pdf}.
\item [\pdfTeX] enhält die \eTeX\ Erweiterungen, und erlaubt zusätzlich
      die Ausgabe in \pdf-Dateien sowie {\dvi}-Dateien.
      Die Dokumentation zu \pdfTeX{} finden Sie unter 
      \OnCD{texmf/doc/pdftex/manual/pdftex-a.pdf}. 
      In der Datei
      \OnCD{texmf/doc/pdftex/manual/samplepdf/samplepdf.tex} finden
      Sie ein Anwendungsbeispiel. Das \LaTeX"=Paket \pkgname{hyperref}
      besitzt die Option \optname{pdftex}, mit der Möglichkeiten
      für aktive Querverweise von {\pdf} (Hypertext) zur
      Verfügung gestellt werden.
      Es ist die voreingestellte ">Engine"< 
      für alle Formate außer \plainTeX. Näheres finden Sie in der Dokumentation. 
\item [XeTeX] bietet die Unterstützung von Unicode Zeichensätzen und
      OpenType Schriften durch diverse zusätzliche Bibliotheken.
      Mehr Informationen sind unter  \url{http://scripts.sil.org/xetex}
      verfügbar.
\item [\OMEGA] (Omega) ist ein \TeX-System, das intern mit Unicode
      (16-Bit"=Unicode"=Zeichen) arbeitet und damit das gleichzeitige
      Arbeiten mit nahezu allen auf der Welt eingesetzten Schriften
      und deren Zeichenkodierungen erlaubt. Außerdem werden über dynamisch
      geladene, sogenannte ">{\OMEGA}~Translation~Processes"< (\acro{OTP}s),
      Transformationen zur Verfügung gestellt, die beliebige Eingaben
      vor der Bearbeitung durch {\TeX} nach bestimmten Regeln
      umformen. Die (nicht ganz aktuelle) Anleitung zu {\OMEGA} finden
      Sie in dem \TL-System in der Datei \OnCD{texmf-dist/doc/omega/base/doc-1.8.tex}.
\item [$\aleph$] (Aleph) vereinigt die \OMEGA- und \eTeX-Erweiterungen.  
      Eine Minimaldokumentation finden Sie in \OnCD{texmf-dist/doc/aleph/base}.
\end{deflist}

%\clearpage

% -------------------------------------------------------------
\subsection{Weitere Programme der \TL}

{\TL} enthält eine ganze Reihe unterstützender Programme wie

\smallskip

\begin{deflist}{\cmdname{dv2dt, dt2dv}}
\item[\cmdname{bibtex}]         Verwalten von Bibliographien                  
\item[\cmdname{dv2dt, dt2dv}]   \file{dvi} nach ASCII und umgekehrt            
\item[\cmdname{dviconcat}]      Zusammenfügen von \dvi-Dateien                 
\item[\cmdname{dvips}]          Konversion von {\dvi} in {\PS}     
\item[\cmdname{dviselect}]      Ausschneiden von Seiten aus \dvi-Dateien       
\item[\cmdname{dvipdfmx}]       \dvi-nach-\pdf-Konverter (erzeugt auch
               \acro{CJK}-konformes {\pdf} aus
               \dvi-Dateien mit \OMEGA"=Erweiterungen), als Alternative
	       zu \pdfTeX.
\item[\cmdname{dvilj}]          Druckertreiber für die HP-LaserJet"=Familie    
\item[\cmdname{lacheck}]        \LaTeX-Syntax-Überprüfung                      
\item[\cmdname{makeindex}]      Erzeugen eines Stichwortverzeichnisses         
\item[\cmdname{mpost}]          \MF-ähnliches Grafikprogramm                   
\item[\cmdname{psnup}]          mehrere logische \PS-Seiten auf einem Blatt platzieren 
\item[\cmdname{psselect}]       Ausschneiden von Seiten aus \PS-Dateien        
\item[\cmdname{tex4ht}]         \TeX-nach-\HTML"=Konvertierung                
\item[\cmdname{texexec}]        \ConTeXt- und PDF"=Prozessor.                
\item[\cmdname{xdvi}]           \dvi-Bildschirmausgabe im X-Window-System      
\end{deflist}

% ==============================================================
\section{Installation und Anwendung von {\TL} unter \acro{UNIX}}\label{sec:UNIX-install}

Wie schon in Kapitel~\ref{sec:basic} auf Seite~\pageref{sec:basic}
ausgeführt, können Sie {\TL} auf drei Arten nutzen:

\begin{enumerate}
\item Sie können das \TL-System direkt vom Verteilungsmedium laufen
      lassen (gilt für die \pkgname{live}-\DVD).

\item Sie können das Gesamtsystem oder Teile davon auf Ihrer Festplatte
      installieren (gilt für die \pkgname{live}-\DVD, die \pkgname{inst}- und \pkgname{protext}-\CDROM).

\item Sie können einzelne Pakete in Ihr bestehendes \TeX-System
      integrieren, gleichgültig, ob es ein \TL-System oder ein
      anderes ist (gilt für die \pkgname{live}-\DVD, die \pkgname{inst}- und \pkgname{protext}-\CDROM).
\end{enumerate}

Die folgenden Abschnitte beschreiben für \acro{UNIX} jedes dieser drei
Verfahren ausführlich zum Nachvollziehen. Im Folgenden werden die Eingaben des
Benutzers nach dem Kommando-Prompt \samp{>} \Ucom{unterstrichen} dargestellt.

\ifSingleColumn \begin{figure}[ht]\noindent \fi
{\centering
\begin{warningbox}
\textbf{Achtung: } Die {\CDROM}s und die {\DVD} der {\TK} wurden im Format ISO-9660 (High Sierra)
mit Rock"~Ridge- und Joliet"=Erweiterungen produziert. Damit Ihr
\acro{UNIX}-Rechner die {\TK} optimal nutzen kann, muss Ihr System diese
Erweiterungen unterstützen. Schlagen Sie in der Systemdokumentation
des Befehls \emph{mount} nach, um zu ermitteln, ob Ihr System diese
Erweiterungen unterstützt. Falls Sie die {\TK} in einem lokalen
Netzwerk einsetzen, suchen Sie sich einen Rechner aus, der die
Erweiterungen unterstützt und ">mounten"< Sie die anderen Rechner auf diesen.

%\leavevmode\quad
\smallskip
Moderne Linux-, \acro{BSD}-, Sun- und \acro{SGI}-Systeme haben
normalerweise keine Schwierigkeiten, {\TL} zu benutzen. Wenn
Sie ein anderes System einsetzen und {\TL} erfolgreich einbinden
konnten, bitten wir Sie um detaillierte Anweisungen, um diese
Anleitung weiter verbessern zu können.

%\leavevmode\quad
\smallskip
Der Rest der Anleitung geht davon aus, dass Sie
die {\TK} erfolgreich unter Verwendung der Rock"~Ridge- und
Joliet"=Erweiterungen ">mounten"< konnten.
\end{warningbox}\par}
\ifSingleColumn\end{figure}\fi

% -------------------------------------------------------------
\subsection{\protect{\TL} direkt vom Verteilungsmedium starten (\acro{UNIX})}

% ++++++++++++++++++++++++
\newcommand{\runlive}{%
% text repeated in windows section
Sie können {\TeX} direkt von der \pkgname{live}-{\DVD} starten, ohne es vorher auf Festplatte installieren zu müssen 
(daher der Name {\TeX} ">Live"<). Es ist aber \emph{nicht}
möglich, {\TeX} direkt von den {\CDROM}s laufen zu lassen
(siehe hierzu Kapitel~\ref{sec:multiple-dist} auf
Seite~\pageref{sec:multiple-dist} über die verschiedenen Distributionen).
In den folgenden Installationsschritten benutzen wir ">\texttt{>}"< für
die Eingabeaufforderung und Unterstreichung für Benutzereingaben.
}
% ++++++++++++++++++++++++

%\runlive

% ++++++++++++++++++++++++
\newcommand{\startinst}{%
% is repeated in other sections
Zuerst ">mounten"< Sie die {\CDROM} oder {\DVD} unter Verwendung der Rock"~Ridge"=Erweiterungen.
Das Kommando hierfür variiert von System zu System; die nachfolgenden Befehle funktionieren
unter Linux; nur der Name des \CDROM-/\DVD-Laufwerks (hier |/dev/cdrom|) muss u.\,U.
angepasst werden.

\begin{alltt}
> \Ucom{mount -t iso9660 /dev/cdrom /mnt/cdrom}
\end{alltt}

Wechseln Sie mit Ihrem aktuellen Verzeichnis zum Mount-Point:

\begin{alltt}
> \Ucom{cd /mnt/cdrom}
\end{alltt}

Unter {\MacOSX} werden {\CDROM}s und {\DVD}s automatisch ">gemountet"<;
ein \cmdname{mount} ist deshalb überflüssig. Das Verteilungsmedium
wird in das Verzeichnis |/Volumes/| ">gemountet"<.
}

\def\installtlsh{%
Starten Sie das Installationsskript \filename{install-tl.sh}:

\begin{alltt}
> \Ucom{sh install-tl.sh}\\
Welcome to TeX Live...
\end{alltt}

Nach den Begrüßungsmeldungen und der Ausgabe der Hauptmenü-Liste
werden Sie aufgefordert, ein Kommando einzugeben. Geben Sie die
gewünschte Option ein und schließen Sie die Eingabe mit ">\cmdname{Return}"<
ab. 
Bei der Eingabe bleiben Groß- oder Kleinschreibung unberücksichtigt;
in unseren Beispielen benutzen wir die Kleinschreibung.}
% ++++++++++++++++++++++++

\runlive
\startinst
\installtlsh

Um das \TL-System direkt vom Verteilungsmedium laufen zu lassen, müssen wir
als erstes Kommando \Ucom{d} eingeben und dann das Unterkommando \Ucom{1},
um die Verzeichnisse zu erzeugen. Obwohl wir alle Programme von {\CDROM} oder
{\DVD} laufen lassen, muss trotzdem ein Verzeichnis auf der lokalen Platte
eingerichtet werden, um Dateien, die {\TeX} während der Laufzeiten
erzeugt wurden (beispielsweise Fonts, Formate und geänderte Konfigurationsdateien),
abgelegt werden können. Im folgenden Beispiel benutzen wir
\dirname{/opt/texlive2006} (wenn die Voreinstellung \dirname{/usr/local/texlive2005}
für Sie in Ordnung ist, können Sie den folgenden Schritt überspringen). Wir
empfehlen, das Erscheinungsjahr von \TL{} in den Pfadnamen -- wie oben im
Beispiel -- aufzunehmen, damit ältere \TL-Installationen nicht beeinflusst 
werden, und da erstellte Dateien im allgemeinen nicht zwischen den Ausgaben
kompatibel sind.

\begin{alltt}
Enter command: \Ucom{d}
Current directories setup:
<1>  TEXDIR:     /usr/local/texlive/2006
...
Enter command: \Ucom{1}
New value for TEXDIR [/usr/local/texlive/2006]: \Ucom{/opt/texlive2006}
...
Enter command: \Ucom{r}
:1
\end{alltt}

Zurück im Hauptmenü, geben wir unser zweites und letztes
Kommando \Ucom{r} ein, um den Modus ">von \CDROM/{\DVD} laufen lassen (keine
Installation auf Disk)"< zu erreichen:

\begin{alltt}
Enter command: \Ucom{r}
Preparing destination directories...
...
Welcome to the TeX Live!
>
\end{alltt}

Nun sind wir wieder zurück am System-Prompt \samp{>}.

Der letzte Schritt zu einem funktionsfähigen \TL-System ist die
Änderung zweier En"-viron"-ment-Variablen: \envname{PATH} und \envname{TEXMFSYSVAR}.
Die Variable \envname{PATH} muss um das Verzeichnis erweitert werden, in
dem die Programme der verwendeten Architektur liegen; \envname{TEXMFSYSVAR}
erhält die Verzeichnis-Angabe, die oben festgelegt wurde.
In Tabelle~\ref{tab:archlist} sehen Sie eine Liste der verfügbaren
Architekturen für die verschiedenen Systeme.

% ++++++++++++++++++++++++
\newcommand{\textruntexconfig}{%
% is repeated in other sections
Direkt im Anschluss an die Installation und das Setzen der
En"-viron"-ment-Variablen wird \cmdname{texconfig} oder \cmdname{texconfig-sys} aufgerufen,
um das \TeX-System an Ihre lokalen Gegebenheiten anzupassen.
Dieser Schritt wird im Abschnitt~\ref{sec:texconfig} auf
Seite~\pageref{sec:texconfig} näher erläutert.}
% ++++++++++++++++++++++++

\textruntexconfig

\begin{table}[tbh!]
 \centering
\caption[Unterstützte Betriebssysteme und Architekturen]{Unterstützte Betriebssysteme und Architekturen}\label{tab:archlist}

\smallskip 

\begin{tabular}{l>{\ttfamily}l}
\hline
 Betriebssystem/Plattform    & Version \\
\hline
  HP Alpha \acro{GNU}/Linux           & alpha-linux          \\
% HP Alphaev5 \acro{OSF} 4.0d         & alphaev5-osf4.0d    \\
% HP9000 \acro{HPUX} 10.20            & hppa2.0-hpux10.20   \\
  Intel x86 \MacOSX                   & i386-darwin      \\
  Intel x86 Free\acro{BSD}            & i386-freebsd      \\
  Intel x86 \acro{GNU}/Linux          & i386-linux        \\
% Intel x86 Open\acro{BSD}            & i386-openbsd3.3      \\
% Intel x86 Solaris                   & i386-solaris2.8      \\
  \acro{SGI} IRIX                     & mips-irix         \\
  \acro{IBM} RS/6000 \acro{AIX} 4.3.* & powerpc-aix   \\
  \MacOSX                             & powerpc-darwin \\
  Sun Sparc \acro{GNU}/Linux          & sparc-linux        \\
  Sun Sparc Solaris                   & sparc-solaris     \\
  Windows 9X/ME/2K/NT/XP (32\,bit)    & win32             \\
  Intel x68 64-Bit \acro{GNU}/Linux  & x86\_64-linux       \\
\hline
\end{tabular}

\end{table}\label{text:path}

Die Syntax für das Setzen einer En"-viron"-ment-Variable und der Name der
Initialisierungsdatei, in die sie geschrieben wird, hängt von der Shell ab,
die Sie benutzen. Benutzer, die eine Shell einsetzen, die kompatibel zur
Bourne-Shell ist (z.\,B. \cmdname{sh}, \cmdname{bash}, \cmdname{ksh}, usw.),
können die folgenden Zeilen in Ihre Datei \file{\$HOME/.profile} einfügen:

\begin{alltt}
   PATH=/mnt/cdrom/bin/\var{archname}:$PATH; export PATH
   TEXMFSYSVAR=/opt/texlive2006/texmf-var; export TEXMFSYSVAR
\end{alltt}

Für C-Shell-kompatible Shells (z.\,B. \cmdname{csh}, \cmdname{tcsh})
sind die folgenden Zeilen in die Datei \file{\$HOME/.cshrc}
aufzunehmen:

\begin{alltt}
   setenv PATH      /mnt/cdrom/bin/\var{archname}:$PATH
   setenv TEXMFSYSVAR /opt/texlive2006/texmf-var
\end{alltt}

Nach dieser Änderung loggen Sie sich aus und wieder ein und testen
Ihre Installation (siehe Abschnitt~\ref{sec:test-install} auf
Seite~\pageref{sec:test-install}.

% ++++++++++++++++++++++++
\newcommand{\textifindoubt}{%
Wenn Sie sich nicht sicher sind, fragen Sie Ihren lokalen System-Guru
um Rat, denn es variiert beispielsweise, wie {\CDROM}s oder {\DVD}s zu ">mounten"<
sind, welche Verzeichnisse benutzt werden dürfen oder wie die Änderungen
in den Initialisierungsdateien vorgenommen werden müssen.}
% ++++++++++++++++++++++++

\textifindoubt

% -------------------------------------------------------------
\subsection{Installation des \protect\TL-Systems auf der Festplatte}\label{sec:unix-install-disk}

Es ist sicherlich der Standardfall, das \TL-System auf der
Festplatte zu installieren. Dies kann von der \TK-\DVD
oder der \TL-{\CDROM} erfolgen. 
(lesen Sie Abschnitt~\ref{sec:multiple-dist} auf Seite~\pageref{sec:multiple-dist} für eine Erläuterung der verschiedenen Distributionen.)

\startinst
\installtlsh

Die Tabelle~\ref{tab:main-menu-options} listet die Optionen
des Hauptmenüs auf. Die Abfolge, in der Sie die einzelnen Optionen auswählen,
ist unerheblich, mit Ausnahme von ">\optname{i}"<, was stets am
Ende steht. Wir erläutern die einzelnen Optionen in der angegebenen
Reihenfolge:

% apparently here.sty [H] doesn't support table*.

\begin{table}[H]
\caption{Optionen im Installationshauptmenü}\label{tab:main-menu-options}
\centering
%\begin{tabular}{*{2}{>{\ttfamily}l}l@{}}
\begin{tabular}{@{}>{\ttfamily}lp{0.9\linewidth}}
p & \ttfamily The \optname{p}latform you are running on.\\
  & Plattform ändern\\
b & \ttfamily The architectures for which to install \optname{b}inaries.\\
  & Programme für andere Plattformen installieren \\
s & \ttfamily The base installation \optname{s}cheme to use (minimal, recommended, full, etc.\\
  & Installations-Schema auswählen \\
c & \ttfamily Override the base scheme for individual \optname{c}ollections.\\
  & Installations-Schema ändern  \\
l & \ttfamily Override for \optname{l}anguage collections.\\
  & Sprachschema ändern\\
d & \ttfamily \optname{D}irectories in which to install.\\
  & Installationsverzeichnisse festlegen \\
o & \ttfamily \optname{O}ther options.\\
  & allgemeine Installationsoptionen \\
%r & \optname{r}un off CD or DVD & nichts installieren; Lauf von \CDROM/\DVD \\
i & \ttfamily Perform the \optname{i}nstallation.\\
  & Installation starten\\
%h & \optname{h}elp    & Hilfe \\
%q & \optname{q}uit    & Ende  \\
\end{tabular}
\end{table}

Die Optionen im Einzelnen:

\begin{itemize}
\item [\optname{p}] \textbf{Current platform}: Das Installationsskript versucht
      automatisch festzustellen, auf welcher Plattform es
      läuft. Im Allgemeinen wird die Plattform korrekt erkannt, so dass diese
      Option nur dann benutzt werden muss, wenn die automatische Erkennung versagt 
      oder überschrieben werden soll.

\item [\optname{b}] \textbf{Binary architectures}: Im Standardfall werden nur
      die Programme der aktuellen Plattform installiert.
      Mit Hilfe dieser Option ist es aber möglich, Programme anderer
      Plattformen zu installieren -- oder überhaupt keine, wenn Sie die
      Programme lieber selber kompilieren möchten. Ersteres kann insbesondere
      dann sinnvoll sein, wenn der \TeX-Verzeichnisbaum von mehreren
      (heterogenen) Rechnern über ein Netzwerk ge">shared"< wird. Siehe
      hierzu die Tabelle~\ref{tab:archlist}
      auf Seite~\pageref{tab:archlist} mit den unterstützten Architekturen.


\item [\optname{s}] \textbf{Base installation scheme}: In diesem Menü können Sie aus einer Anzahl von vorkonfigurierten 
      Paket-Zusammenstellungen (">Schema-Definitionen"<) wählen. Die wichtigsten sind:

\begin{tabular}{@{}lp{0.8\linewidth}}
       \hline
    Angabe  &  Inhalt und Verwendung               \\
       \hline
\optname{basic}       & Diese Angabe ist dann sinnvoll, wenn Sie nur wenig Platz auf der Festplatte haben.\\
\optname{full}        & Dies ist die Voreinstellung. Mit dieser Angabe bekommen Sie einfach alles.\\
\optname{medium} & Irgendwo dazwischen\\
\hline
\end{tabular}

      Daneben gibt es u.\,a. auch noch Paket-Zusammenstellungen für {\OMEGA} and \acro{XML}.

\item [\optname{c}] \textbf{Individual collections}: Über dieses Menü ist es möglich, den
      Umfang der zu installierenden Sammlung (aus der Schema-Auswahl)
      individuell zu verändern. Sie können den Installationsumfang (und die
      Leistungsfähigkeit Ihres Systems) durch An- oder Abwahl von Sammlungen
      oder durch Einzelselektion bestimmen. Jede Paketsammlung (\TeX-Makros,
      Font-Familien, usw.) besteht aus einer Anzahl von Paketen; hier können
      Sie einzelne Pakete hinzu- oder anwählen. Beachten Sie bitte in diesem Menü
      die Groß"~/""Kleinschreibung.

%%         \begin{tabular}{c>{\bfseries\sffamily}lc>{\bfseries\sffamily}l} % ?? prüfen, ob die Tabelle noch gilt
%%             a  &  Essential programs and files   &  o  &  Basic {\LaTeX}?? packages \\
%%             b  &  Extra {\BibTeX}?? styles         &  p  &  Support for latex3 \\
%%             c  &  The bare {\TL}?? binaries   &  s  &  {\LaTeX}?? supplementary packages \\
%%             d  &  Chemical typesetting           &  t  &  {\LaTeX}?? recommended packages  \\
%%             e  &  Context macro package          &  u  &  Advanced math typesetting  \\
%%             f  &  Extra documentation            &  v  &  Metapost (and Metafont) drawing \\
%%             g  &  e\TeX??                          &  w  &  {\OMEGA}??   \\
%%             h  &  {\TeX}?? auxiliary programs      &  x  &  {\pdfTeX}??  \\
%%             i  &  {\TeX}?? font-related programs   &  y  &  Drawing and graphing packages \\
%%             j  &  Recommended extra fonts        &  z  &  Plain {\TeX}?? extra macros  \\
%%             k  &  Extra formats                  &  A  &  {\PS}?? utilities   \\
%%             l  &  Games typesetting (chess, etc  &  B  &  Support for publishers  \\
%%             m  &  Miscellaneous macros           &  C  &  TrueType font manipulation  \\
%%             n  &  HTML/SGML/XML support          &     &   \\
%%         \end{tabular}

\item [\optname{l}] \textbf{Language collections}: Dieses Menü hat eine ähnliche Aufgabe 
      wie \Ucom{c} -- nämlich das vorgegebene Schema zu ändern: Hier können Sie den Installationsumfang für
      die Sprachunterstützung festlegen.

      Jede Sammlung besteht aus
      verschiedenen Paketen, die Makros, Fonts und Trennmuster enthalten. Beispielsweise
      wird das Makropaket \pkgname{frenchle.sty} installiert, wenn die Sprachsammlung
      \optname{French} ausgewählt wird. Darüber hinaus hat die Sprachauswahl Einfluss
      auf die Konfigurationsdatei \filename{language.dat}. Diese Datei steuert, welche
      Trennmuster geladen werden.

Die Liste für Sprachen der {\TL} umfasst (Hier muss bei den
Auswahl-Buchstaben Groß-/""Kleinschreibung unterschieden werden):

\bgroup
\centering
\begin{tabular}{@{}p{0.24\linewidth}p{0.20\linewidth}p{0.20\linewidth}p{0.24\linewidth}}  % ?? noch ganz grausig
(einige) Afrikanische Skripte & Arabisch & Armenisch & Chinesisch Japanisch Koreanisch \\
Kroatisch & Kyrillisch & Tschechisch/""Slowakisch & Dänisch \\ 
Niederländisch & Finnisch & Französisch & Deutsch \\
Griechisch & Ungarisch & Indisch &  Italienisch \\
Latein & Manju & Mongolisch & Norwegisch \\
Polnisch & Portugiesisch & Spanisch &  Schwedisch \\
Tibetanisch & \acro{UK}-English & Vietnamesisch & Hebräisch \\
\end{tabular}
\egroup

Der oben angegebenen Reihenfolge der Sprachen liegt die Abfolge der Auswahl-Boxen des Menüs zugrunde.

\item [\optname{d}]
      \textbf{Installation directories}: Die folgenden drei Verzeichnisse können hier
                                         geändert werden:\hfill
      \label{text:instdir}

      \begin{ttdescription}
      \item [TEXDIR]\mbox{}\\
            ist das Wurzelverzeichnis, unterhalb dessen alles installiert
	    wird. Die Voreinstellung ist \dirname{/usr/local/texlive/2006};
	    diese Angabe wird aber meistens verändert. Sie können auf diese
	    Weise verschiedene \TL-Ausgaben parallel betreiben. Wir empfehlen
	    daher, die Jahresangabe im Verzeichnisnamen beizubehalten.
	    Wenn Sie das neue Release ausführlich getestet haben, könnten Sie
	    dann beispielsweise \dirname{/usr/local/texlive} zu einem
	    symbolischen Link machen.

            Unter {\MacOSX} wird das \TeX-Front-End üblicherweise in
            \dirname{/usr/local/teTeX} gesucht. Sie können also überlegen,
            das \TL-System dort zu installieren.

      \item [TEXMFLOCAL:]\mbox{}\\
	    In diesem Zweig speichert das \TeX-System üblicherweise die nicht
	    versionsabhängigen Dateien, vornehmlich Fonts. Die Voreinstellung
	    ist \dirname{/usr/local/texlive/texmf-local}, unabhängig vom
	    Release-Jahr der \TL. In diesen Verzeichniszweig gehören
            auch alle lokalen Pakete und Konfigurationsdateien.

      \item [TEXMFSYSVAR:]\mbox{}\\
            In diesem Zweig speichert das System die versionsabhängigen
            Dateien, insbesondere Format-Dateien und Konfigurationsdateien, die
            von \cmdname{texconfig-sys} verändert werden (siehe Abschnitt~\ref{sec:texconfig}
            auf Seite~\pageref{sec:texconfig}).  Die Voreinstellung ist
            \dirname{TEXDIR/texmf-var}. Normalerweise gibt es keinen Grund, diese Einstellung zu ändern.
      \end{ttdescription}

\item [\optname{o}]
      \textbf{Other Options}: In diesem Menü können Sie grundlegende Installations-Optionen setzen:
      \begin{ttdescription}
      \item [a] Hiermit geben Sie ein \textbf{a}lternatives Verzeichnis an, in das generierte
                Fonts abgelegt werden dürfen. Standardmäßig wird das durch
                \envname{TEXMFVAR} angegebene Verzeichnis benutzt, wie oben beschrieben.
                Die Angabe eines alternativen Verzeichnisses ist immer dann sinnvoll,
                wenn Sie Ihr Hauptverzeichnis \emph{read-only} setzen wollen und daher
                für die dynamisch kreierten Fonts ein anderes -- möglicherweise rechnerspezifisches -- Verzeichnis 
                benötigen.

      \item [l] Erzeugen symbolischer \textbf{L}inks für Programme, ">man~pages"<
                bzw. \acro{GNU}-\acro{info}-Dateien an anderen Stellen; beispielsweise um die
                Man-page-Dokumentation unter \dirname{/usr/local/man} und die
                Info-Dateien unter \dirname{/usr/local/info} zur Verfügung zu stellen
                (Selbstverständlich müssen Sie im Besitz der notwendigen Privilegien
                sein, um in die angegebenen Verzeichnisse schreiben zu dürfen.)

                Es ist nicht ratsam, ein schon bereits bestehendes \TeX-System zu überschreiben, 
                das mit dieser Option erstellt wurde. Die Option ist vielmehr dafür gedacht, 
                Links in den schon bekannten Standardverzeichnissen (wie z.\,B. \dirname{/usr/local/bin}) 
                bereit zu stellen. Die betreffenden Verzeichnisse sollten dann aber auch nicht 
                irgendwelche \TeX-Verzeichnisse enthalten. 

      \item [d] Die Installation der
                Dokumentation (">\textbf{d}oc"<) für Fonts und Makros wird unterlassen. 
                Das ist dann sinnvoll, wenn Sie Platz sparen müssen oder die Dokumentation bereits 
                an anderer Stelle abgelegt haben.

      \item [s] Die Installation des Hauptzweigs mit Fonts und Makros wird übersprungen.
                Diese Option wird bei der Einrichtung eines ">\textbf{s}hared"< Betriebs
                zwischen Rechnern bzw. Architekturen mittels \acro{NFS} oder
                \cmdname{automount} für den Hauptzweig genutzt.
      \end{ttdescription}

\item [\optname{i}]
      \textbf{perform installation}: Wenn Sie mit Ihrer Konfiguration
      zufrieden sind, starten Sie mit der Eingabe von \Ucom{i} die
      Installation vom Medium auf die Festplatte.
\end{itemize}

Wenn die Installation abgeschlossen ist, so besteht der nächste Schritt
darin, die Variable \envname{PATH} so zu ergänzen, dass die neu-installierten
Programme im architektur-spezifischen Verzeichnis unterhalb von
\dirname{\$TEXDIR/bin} gefunden werden. Die unterstützten Architekturen sind in
der Tabelle~\ref{tab:archlist} auf Seite~\pageref{tab:archlist} zu finden.
Sie können sich aber auch einfach den Inhalt des Verzeichnisses in
\dirname{\$TEXDIR/bin} ausgeben lassen.

Die Syntax für das Setzen einer En"-viron"-ment-Variable und der Name der
Initialisierungsdatei, in die sie geschrieben wird, hängen von der Shell ab,
die Sie benutzen. Benutzer, die eine Shell einsetzen, die kompatibel zur
Bourne-Shell ist (z.\,B. \cmdname{sh}, \cmdname{bash}, \cmdname{ksh}, usw.),
können folgende Zeilen in Ihre Datei \file{\$HOME/.profile} aufnehmen:

\begin{alltt}
   PATH=/usr/local/texlive/2006/bin/\var{archname}:\$PATH; export PATH
\end{alltt}

Für C-Shell-kompatible Shells (z.\,B. \cmdname{csh}, \cmdname{tcsh})
sind die folgenden Zeilen in die Datei \file{\$HOME/.cshrc}
aufzunehmen:

\begin{alltt}
   setenv PATH /usr/local/texlive/2006/bin/\var{archname}:\$PATH
\end{alltt}

\textruntexconfig

Es folgt ein kurzes kommentiertes Beispiel für eine volle Installation der
">Live"<-Version ({\DVD} oder \pkgname{inst}-{\CDROM}) mit den Binärdateien
für das aktuelle System und den oben vorgeschlagenen Verzeichnis-Änderungen.
In diesem Fall ist daher nur das Kommando \Ucom{i} erforderlich. Das Zeichen
">\texttt{>}"< steht wie üblich für den Kommandozeilen-Prompt.

\begin{alltt}
> \Ucom{sh install-tl.sh}
\Ucom{i}                         # perform installation
> \Ucom{texconfig} ...
# New PATH, with Linux as the example:
> \Ucom{PATH=/usr/local/texlive/2006/bin/i386-linux:\$PATH; export PATH}
\end{alltt}

\textifindoubt

% -------------------------------------------------------------
\subsection{Nicht interaktive Installation}
\label{sec:noninteractive-install}

Die Vorgabeverzeichnisse können durch das Setzen von Umgebungsvariablen
geändert werden, wodurch eine automatische, d.\,h.\ nicht interaktive
Installation ermöglicht wird, siehe folgendes Beispiel:
\begin{alltt}
> \Ucom{TEXLIVE_INSTALL_PREFIX=/opt/texlive}
> \Ucom{export TEXLIVE_INSTALL_PREFIX}
> \Ucom{echo i | sh install-tl.sh}
\end{alltt}

Die Umgebungsvariable \envname{TEXLIVE\_INSTALL\_PREFIX} überschreibt die
Vorgabe für \dirname{/usr/local/texlive}, während alles andere unverändert
bleibt -- daher würde obiges Beispiel die gesamte Installation nach
\dirname{/opt/texlive/2006} durchführen.

Wie üblich unter Unix kann das \Ucom{echo i} durch eine beliebe Folge von
Eingabebefehlen durch ein ">here"< Dokument ersetzt werden, so dass eine
beliebige Folge von Befehlen ausgeführt werden kann.

Folgende Liste gibt die möglichen Umgebungsvariablen an:

\begin{ttdescription}
\item [TEXLIVE\_INSTALL\_PREFIX]
      Überschreibt \dirname{/usr/local/texlive}.
\item [TEXLIVE\_INSTALL\_TEXDIR]
      Überschreibt \dirname{\$TEXLIVE\_INSTALL\_PREFIX}/2006.
\item [TEXLIVE\_INSTALL\_TEXMFLOCAL]
      Überschreibt \dirname{\$TEXLIVE\_INSTALL\_PREFIX/texmf-var}.
\item [TEXLIVE\_INSTALL\_TEXMFSYSVAR]
      Überschreibt \dirname{\$TEXLIVE\_INSTALL\_TEXDIR/texmf-var}.
\item [TEXLIVE\_INSTALL\_TEXMFHOME]
      Überschreibt \dirname{\$HOME/texmf}.
\end{ttdescription}

Es wäre besser die \acro{GNU} Standardmethode mit \filename{configure} 
und Optionen zu unterstützen anstelle der Umgebungsvariablen.
Freiwillige für die Implementierung sind herzliche willkommen.

% -------------------------------------------------------------
%\subsection{Installation einzelner Pakete}
\subsection{Installation einzelner Pakete auf einer Festplatte}

Sie können die {\TL} auch dazu benutzen, ein bestehendes
\TeX-System auf den neuesten Stand zu bringen bzw. die Daten einer
bestehenden Installation durch einzelne Pakete oder Sammlungen zu ergänzen. 

\startinst

Führen Sie das \emph{für diesen Zweck} vorgesehene Installations-Skript \filename{install-pkg.sh}
aus (das im vorigen Abschnitt vorgestellte Skript \filename{install-tl.sh} ist nur
für eine Erstinstallation gedacht):

\begin{alltt}
> \Ucom{sh install-pkg.sh \var{Optionen}}
\end{alltt}

Das Skript kann über Kommandozeilenparameter gesteuert werden.
Die ersten zwei dienen zur Auswahl des zu installierenden Pakets, zur Auswahl
der Sammlung (z.\,B. \samp{tex-mathextra}), zur Angabe des Verzeichnisses,
auf das das Medium ">gemountet"< ist und zur Angabe des Verzeichnisses, das
die Dateilisten der Pakete enthält (diese beiden werden automatisch gesetzt):

\smallskip

\begin{deflist}{\texttt{-{}-collection=}\var{coll-name}}
\item[\texttt{-{}-package=}\var{pgk-name}]
     Name des gewünschten Pakets (\emph{package})
\item[\texttt{-{}-collection=}\var{coll-name}]
     Name der gewünschten Sammlung (\emph{collection})
\item[\texttt{-{}-nodoc}] 
     Dokumentationsdateien nicht mitkopieren
\item[\texttt{-{}-nosrc}]
     Quelldateien nicht mitkopieren
\item[\texttt{-{}-cddir=}\var{cd-dir}]
     Quellverzeichnis, von dem gelesen wird (Voreinstellung ist
     das aktuelle Verzeichnis): Wenn Sie die oben
     stehenden Anweisungen befolgt haben, befinden
     Sie sich im Distributionsverzeichnis und müssen
     keine Änderungen vornehmen.   
\item[\texttt{-{}-listdir=}\var{list-dir}]
     das sogenannte ">list"<-Verzeichnis innerhalb von
     \var{cd-dir}, von dem die Paket-Informationen
     gelesen werden: Die Voreinstellung für \var{list-dir}
     ist \var{cd-dir}\file{/texmf/tpm/lists}; der einzige
     Grund für eine Änderung läge vor, wenn Sie Änderungen
     am \TL-System selbst vornähmen. 
\end{deflist}

%\smallskip
Die eigentliche Aktion wird durch weitere Parameter gesteuert. Die ersten beiden
verhindern die Installation der Dokumentation bzw. der Quelldateien
eines Pakets. Der dritte verhindert den Aufruf von \cmdname{mktexlsr} beim
Abschluss der Installation, womit die Datenbank der Verzeichnisstruktur neu
aufgebaut würde. Der vierte Parameter dient zur Anzeige der zu installierenden
Dateien, ohne dass die Installation tatsächlich durchgeführt wird. Der Umfang
der Informationen über die aktuellen Tätigkeiten des Skripts kann vergrößert
werden und zu guter Letzt kann noch aus einem zu installierenden Paket (oder
Sammlung) ein \cmdname{tar}-Archiv erzeugt werden, in dem die Dateien schon die
korrekte \OnCD{texmf}-Verzeichnisstruktur haben.

\smallskip

\begin{deflist}{\texttt{-{}-archive=}\var{tarfile}}
\item[\texttt{-{}-listonly}] Auf"|listung, welche Dateien in einem Paket oder einer Sammlung sind;
     keine Installation des Pakets 
\item[\texttt{-{}-archive=}\var{tarfile}] Statt das angegebene Paket oder die Sammlung zu
     installieren, wird ein \cmdname{tar}-Archiv erzeugt. 
\end{deflist}

Zusätzliche Optionen:

\begin{deflist}{\texttt{-{}-archive=}\var{tarfile}}
\item[\texttt{-{}-nohash}]  kein Hash-Lauf von \cmdname{mktexlsr} 
\item[\texttt{-{}-config}]  nach der Installation einen Konfigurationslauf mit \samp{texconfig~init} durchführen
\item[\texttt{-{}-verbose}] mehr Informationen ausgeben, was das Skript während seines Laufs macht 
\end{deflist}

\smallskip

Hier einige Beispiele für die Verwendung des Skripts:

\begin{enumerate}
\item   Wollen Sie beispielsweise wissen, welche Dateien mit dem
        Paket \pkgname{fancyhdr} installiert werden würden, ist folgender
        Befehl einzugeben, der die entsprechende Ausgabe zur Folge hat:

\begin{alltt}
\ifSingleColumn> \Ucom{sh install-pkg.sh --package=fancyhdr --listonly}
\else> \Ucom{sh install-pkg.sh --package=fancyhdr \bs}
>>                         \Ucom{--listonly}
\fi{}
     texmf/doc/latex/fancyhdr/README
     texmf/doc/latex/fancyhdr/fancyhdr.dvi
     texmf/doc/latex/fancyhdr/fancyhdr.tex
     texmf/tex/latex/fancyhdr/extramarks.sty
     texmf/tex/latex/fancyhdr/fancyhdr.sty
     ....
\end{alltt}

    \item Installation des \LaTeX-Pakets \pkgname{natbib}:

\begin{alltt}
> \Ucom{sh install-pkg.sh --package=natbib}
\end{alltt}

\item Installation des Pakets \pkgname{alg} ohne Quelldateien und
      ohne Dokumentation:

\begin{alltt}
\ifSingleColumn> \Ucom{sh install-pkg.sh  --package=alg --nosrc --nodoc}
\else> \Ucom{sh install-pkg.sh  --package=alg \bs}
>>                \Ucom{--nosrc --nodoc}
\fi\end{alltt}

\item Installation der Pakete mit zusätzlichen \plainTeX-Makros:

\begin{alltt}
> \Ucom{sh install-pkg.sh --collection=tex-plainextra}
\end{alltt}

\item Erzeugen eines \cmdname{tar}-Archivs aller Dateien des Pakets \pkgname{PSTricks}
      im Verzeichnis \dirname{/tmp}:

\begin{alltt}
\ifSingleColumn> \Ucom{sh install-pkg.sh --package=pstricks --archive=/tmp/pstricks.tar}
\else
> \Ucom{sh install-pkg.sh --package=pstricks \bs}
>>        \Ucom{--archive=/tmp/pstricks.tar}
\fi\end{alltt}
\end{enumerate}

\textifindoubt

% ==============================================================
\section{Installationsnacharbeiten und Wartung}\label{sec:postinstall}

Nachdem die Hauptinstallation durchgeführt ist, müssen das \TeX-System an Ihre lokalen
Gegebenheiten angepasst und einige Tests durchgeführt werden.

Eine andere Form der Nacharbeit ist das nachträgliche Installieren
von Paketen, Fonts oder Programmen, die in der {\TL} nicht enthalten sind.
Grundsätzlich empfiehlt es sich, diese Erweiterungen im \envname{TEXMFLOCAL}-Baum
(bei einer Installation auf Festplatte) oder in \envname{TEXMFSYSVAR} (beim ">Live"<-Betrieb)
unterzubringen. Siehe hierzu auch die Ausführungen unter ">Installation directories"<
im Abschnitt~\ref{text:instdir} ab Seite~\pageref{text:instdir}.

Leider ist dieses Thema nicht völlig trivial und auch für die unterschiedlichen Pakete
(Fonts, Makros, usw.) nicht einheitlich geregelt, so dass es den Umfang dieser Anleitung
sprengen würde, darauf im Detail einzugehen. 

Es gibt einige Beschreibungen in Englisch:

\begin{itemize*}
\item \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages}
\item \url{http://www.ctan.org/installationadvice/}
\item \url{http://www.ctan.org/tex-archive/info/beginlatex/html/chapter5.html#pkginst}: über die Paketinstallation
\item \url{http://www.ctan.org/tex-archive/info/Type1fonts/}: über die Font"=Installation
\end{itemize*}

% -------------------------------------------------------------
\subsection{Konfigurationsprogramm \cmdname{texconfig}}\label{sec:texconfig}\label{ssec:tex}

Nachdem das Installationsprogramm die benötigten Dateien kopiert hat,
können Sie das Programm \cmdname{texconfig} aufrufen, um das \TeX-System
an Ihre Wünsche und lokalen Gegebenheiten anzupassen.
Sie können dieses Programm aber auch zu jedem anderen Zeitpunkt aufrufen,
um Einstellungen zu ändern und anzupassen. \cmdname{texconfig} ist in dem
plattform-spezifischen Unterverzeichnis \dirname{TEXDIR/bin/}\var{arch}
neben allen anderen Programmen zu finden.

Starten Sie das Programm ohne Argumente, so wird \cmdname{texconfig} im
Vollbildmodus mit einem maskenbasierten Kommandobildschirm gestartet,
wo Sie die einzelnen Optionen interaktiv kontrollieren und ändern
können. Alternativ können Sie auch auf der Kommandozeilen-Ebene mit
Schaltern die Konfiguration steuern.

Sie sollten für sämtliche Wartungsarbeiten wie ">Installation neuer Drucker"<
oder ">Neuaufbau der Dateinamen"=Datenbank"< \cmdname{texconfig} verwenden.
Es gibt Hilfstexte mit Erläuterungen für die Fähigkeiten von
\cmdname{texconfig} in beiden Betriebsmodi. 

Einige der am häufigsten benötigten Schalter werden im Folgenden erklärt:%
\footnote{Anmerkung: Die Voreinstellung für das Papierformat im \TL-System ist \optname{a4}.}

\begin{deflist}{\code {texconfig paper letter}}
\item[\code {texconfig paper letter}] Legt das Standard-Papierformat für verschiedene Programme und Treiber 
     (\cmdname{pdftex}, \cmdname{dvips}, \cmdname{dvipdfm}, \cmdname{xdvi}) auf ">\optname{letter}"< fest. Eine andere 
     mögliche Angabe ist \optname{a4}, die auch die Voreinstellung ist.

\item[\code {texconfig localsetup}] Überprüft, ob die Pfade korrekt sind.

\item[\code {texconfig rehash}] Neugenerierung aller Dateinamen"=Datenbanken für das \TeX-System nach dem Hinzufügen oder Entfernen von Dateien

\item[\code {texconfig faq}] Zeigt die \teTeX-\acro{FAQ} an. Beachten Sie auch die \TeX-\acro{FAQ}s in 
     \OnCD{texmf-doc/doc/english/FAQ-en}.

\item[\code {texconfig help}] Ausgabe von Hilfetexten für \cmdname{texconfig}
\end{deflist}

Das Programm \cmdname{texconfig} unterstützt natürlich nur die Änderung von einigen
wenigen (aber viel genutzten) Optionen und Konfigurationsparametern des
\TeX-Systems. Die zugrunde liegende Konfigurationsdatei für alle \Webc-Programme
heißt \filename{texmf.cnf}; Sie können sie mit dem Befehl
\samp{kpsewhich~texmf.cnf} ausfindig machen. Die in der Datei enthaltenen
Kommentare für Voreinstellungen und sinnvolle Alternativeinstellungen helfen
bei eigenen Modifikationen weiter.

Ab dem Erscheinungsjahr 2005 der \TL{} schreibt \cmdname{texconfig} Änderung
in ein nutzerspezifisches Verzeichnis, nämlich \dirname{\$HOME/.texliveYYYY}.
Falls Sie \TeX\ nur für sich selbst installieren, ergeben sich keine
wesentlichen Unterschiede zu früher. Falls Sie ein \TeX-System für mehrere
Nutzer administrieren, möchten Sie wahrscheinlich die Konfiguration des
\TeX-Systems für alle Nutzer ändern. In diesem Fall benutzen Sie
\cmdname{texconfig-sys} statt \cmdname{texconfig}.

Ebenso wurden die Hilfsprogramme \cmdname{updmap} und \cmdname{fmtutil}
so geändert, dass sie sich auf das Verzeichnis \dirname{\$HOME/.texlive2005}
beziehen. Für Änderungen, die alle Nutzer betreffen, benutzen Sie
\cmdname{updmap-sys} bzw. \cmdname{fmtutil-sys}.

Beispielsweise werden Sie auf einem Multi-User-System die Standard-Formate
mit \texttt{fmtutil-sys -{}-missing} zentral erzeugen wollen, da diese
ansonsten für alle Nutzer individuell erzeugt werden.

Falls Sie modifizierte Versionen von \filename{fmtutil.cnf} oder
\filename{updmap.cfg} verwenden wollen, müssen diese in dem texmf-Baum
installiert sein, auf den \envname{TEXMFSYSCONFIG} zeigt.

Für die Übersicht der verschiedenen texmf-Bäume sei auf den
Abschnitt~\ref{sec:texmftrees} auf Seite~\pageref{sec:texmftrees} verwiesen.
Die aktuellen Werte für diese Verzeichnisse erfahren Sie mit dem Kommando
">\texttt{texconfig conf}"< und können in der Datei \filename{texmf.cnf}
geändert werden.
% -------------------------------------------------------------
\subsection{Testen der Installation}\label{sec:test-install}

Nachdem Sie das \TL-System installiert haben, wollen Sie es sicherlich auch
testen, um dann in der Lage zu sein, beeindruckende Dokumente bzw. Fonts zu
erzeugen.

Der folgende Abschnitt stellt einige grundlegende Vorgehensweisen vor, mit
der das neue System auf Funktionsfähigkeit geprüft werden kann. Hier werden
nur die \acro{UNIX}-Kommandos beschrieben, da unter {\MacOSX} und Windows
sicherlich ein \acro{GUI}%
\footnote{\acro{GUI}: Graphical User Interface; Graphische Benutzeroberfläche}
eingesetzt wird, um diese Tests durchzuführen;
grundsätzlich gilt aber das gleiche Prinzip.

\begin{enumerate}
\item Stellen Sie als erstes sicher, dass das Programm \cmdname{tex} läuft:

\begin{alltt}
> \Ucom{tex -{}-version}
TeX 3.141592 (Web2C 7.5.5)
kpathsea version 3.5.5
Copyright (C) 1997-2004 D.E. Knuth.
...
\end{alltt}

Falls Sie nicht die Versionsnummern und die Copyright-Information sehen,
sondern ">\texttt{command not found}"< (o.\,ä.) erhalten, ist vermutlich die
En"-viron"-ment-Variable \envname{PATH} nicht korrekt gesetzt. Überprüfen Sie,
ob das richtige \OnCD{bin}-Unterverzeichnis in der Variablen \envname{PATH}
enthalten ist. Siehe auch die Informationen zum Setzen des En"-viron"-ments
auf Seite~\pageref{text:path}.

\item Übersetzen einer Basis-\LaTeX-Datei:

\begin{alltt}
> \Ucom{latex sample2e.tex}
This is pdfeTeXk, Version 3.141592...
...
Output written on sample2e.dvi (3 pages, 7496 bytes).
Transcript written on sample2e.log.
\end{alltt}

Wird bei diesem Test die Datei \filename{sample2e.tex} (oder eine
Stildatei) nicht gefunden, liegt vermutlich ein Konfigurationsfehler
oder eine störende En"-viron"-ment-Variable vor. Für eine genauere Analyse ist
es empfehlenswert, {\TeX} über die Dateisuche berichten zu lassen.
Genaueres können Sie im Abschnitt ">Fehlersuche"< auf Seite~\pageref{Debugging}
nachlesen.

\item Anzeigen der Ergebnisdatei:

\begin{alltt}
> \Ucom{xdvi sample2e.dvi}
\end{alltt}

(\textbf{Anmerkung:} Unter Windows heißt das entsprechende Kommando
\cmdname{Windvi}.) Sie sollten jetzt ein neues Fenster sehen, in dem ein Text
mit Erläuterungen über die Grundlagen in {\LaTeX} zu sehen ist. Sollten
{\TeX} und {\LaTeX} Neuland für Sie sein, ist dies ein empfehlenswertes
Dokument. Eine wesentliche Voraussetzung für \cmdname{xdvi} ist, dass
\emph{X-Windows} bei ihnen läuft. Ist dies nicht der Fall oder wurde die
En"-viron"-ment-Variable \envname{DISPLAY} nicht korrekt gesetzt, erhalten
Sie den Fehler \samp{Can't open display}.

\item Eine \PS-Datei für Druck oder Anzeige erzeugen:

\begin{alltt}
> \Ucom{dvips sample2e.dvi -o sample2e.ps}
\end{alltt}

\item Ausgabeformat {\pdf} statt {\dvi}; mit diesem Befehl wird aus der
      \filename{.tex}-Datei direkt {\pdf} erzeugt:

\begin{alltt}
> \Ucom{pdflatex sample2e.tex}
\end{alltt}

\item \pdf-Datei anzeigen:

\begin{alltt}
> \Ucom{gv sample2e.pdf}
\textrm{oder}
> \Ucom{xpdf sample2e.pdf}
\end{alltt}

Leider sind weder \cmdname{gv} noch \cmdname{xpdf} in der aktuellen
{\TL} enthalten. Sie müssen deshalb beide separat installiert werden.
Siehe \url{http://www.gnu.org/software/gv/} und
\url{http://www.foolabs.com/xpdf/} zu Informationen über \cmdname{gv}
bzw. \cmdname{xpdf}.

\item Weitere Dateien, die für Tests interessant sind:

\begin{deflist}{\filename{testfont.tex}} % vorher zu unübersichtlich
%\item[\filename{docstrip.tex}] Erzeugt \TeX-Quelle und -Dokumentation aus einer
%     \filename{.dtx}-Datei.
\item[\filename{small2e.tex}] einfacheres Dokument als \file{sample2e.exe}, damit bei der 
     Untersuchung von Problemen eine möglichst kleine Quelldatei vorliegt
\item[\filename{testpage.tex}] erzeugt eine Seite mit Skalen für den Ausdrucktest,
     um Drucker-Offsets ermitteln zu können.
\item[\filename{nfssfont.tex}] Testausdruck von beliebigen Fonts
\item[\filename{testfont.tex}] ebenfalls für den Testausdruck von beliebigen Fonts; allerdings in \plainTeX
\item[\filename{story.tex}] Die ">kanonische"< (plain-)\TeX-Datei überhaupt: Sie müssen nach dem 
     Aufruf von \samp{tex story.tex} nach dem \filename{*}-Prompt noch \samp{\bs bye} eingeben.
\end{deflist}

Diese \filename{.tex}-Dateien können Sie auf die gleiche Weise bearbeiten
wie im Beispiel \filename{sample2e.tex} weiter oben.
\end{enumerate}

Falls Sie mit {\TeX} und {\LaTeX} Neuland betreten oder Hilfe bei der
Erstellung von \TeX- und \LaTeX-Dokumenten benötigen, sollten Sie unbedingt
die deutschsprachige Ausgabe der \acro{FAQ}s zu Rate ziehen
(\OnCD{texmf-doc/doc/german/FAQ-ge/de-tex-faq.pdf}). Dort finden Sie im
Abschnitt~2.4.2 ">Frei verfügbare Einführungen in (La)TeX, METAFONT und
verwandte Themen"< Verweise auf ausdruckbare und online-verfügbare
Einführungen.

Hier sind insbesondere die Broschüren von Manuela~Jürgens von der
Fern-Universität in Hagen zu empfehlen: 

\begin{flushleft}
\begin{itemize}
\item ">\emph{{\LaTeX} -- eine Einführung und ein bisschen mehr \ldots}"<
(\url{ftp://ftp.fernuni-hagen.de/pub/pdf/urz-broschueren/broschueren/a0260003.pdf})
und 
\item ">\emph{{\LaTeX} -- Fortgeschrittene Anwendungen (oder: Neues von den Hobbits)}"<
(\url{ftp://ftp.fernuni-hagen.de/pub/pdf/urz-broschueren/broschueren/a0279510.pdf})
\end{itemize}
\end{flushleft}

Ein englischsprachiges \acro{WWW}-Dokument ist unter
\url{http://tug.org/begin.html} zu finden, wo auch andere
Informationsmöglichkeiten aufgeführt sind.

% ==============================================================
\section{Installation unter \MacOSX}\label{sec:mac-install}
Der empfohlene Weg zur Installation eines \TeX-Systems unter \MacOSX\ ist
die Benutzung der Mac\TeX-Distribution, die im Jahr~2005 neu aufgenommen
wurde. Sie finden Sie auf der \pkgname{live}-\DVD{} im Verzeichnis
\dirname{mactex/}. Die Mac\TeX-Distribution verfügt über ein eigenes
Installationsprogramm für ein vollständiges \TeX-System, das auf te\TeX{}
und \TL{} basiert, und um viele zusätzliche Anwendungen und Anleitungen
ergänzt wurde. Die Homepage des Mac\TeX-Projektes finden Sie unter
\url{http://tug.org/mactex}.

Alternativ können erfahrene Anwender unter \MacOSX{} ein reines
\TL-System installieren, indem Sie die \filename{install*}-Skripten
verwenden.

Um diese Installations-Skripte unter {\MacOSX} nutzen zu können, muss die \cmdname{bash}-Shell
installiert sein.  Läuft Ihr Rechner unter \MacOSX~10.2 haben Sie bereits die
\cmdname{bash}-Shell und müssen nichts weiter unternehmen. Für Besitzer früherer
Betriebssystem-Versionen ist \cmdname{zsh} die Standard-Shell, mit der die Skripte
nicht funktionieren. Falls Sie die \cmdname{bash}-Shell benötigen, sollten Sie sie 
vom Internet laden oder (noch besser) Ihr System auf einen neueren Stand bringen.

Wenn \cmdname{bash} bei ihnen läuft, können Sie der \acro{UNIX}-Installationsdokumentation
im letzten Abschnitt folgen. Siehe Abschnitt~\ref{sec:UNIX-install} auf
Seite~\pageref{sec:UNIX-install}; Mac\acro{OS}X-spezifische Anmerkungen sind -- wo 
notwendig -- bereits im Text enthalten.

% ==============================================================
\section{Installation und Einsatz unter Windows}\label{sec:win-install}

Nachdem in der letztjährigen \TL-Ausgabe kein Installationsprogramm für
Windows enthalten war, ist ein solches nun wieder unter dem Namen
\cmdname{tlpmgui.exe} vorhanden, wenn auch noch in einem Anfangsstadium
und als recht experimentell anzusehen.

\cmdname{tlpmgui.exe} besitzt weitgehend die gleichen Optionen wie das
Installationsskript für \acro{UNIX}, allerdings in Form einer grafischen
Oberfläche.  Sie können daher Schemata, Pakete, Verzeichnisse etc. auswählen,
analog zur Beschreibung des Vorgehens für Unix-Systeme in
Abschnitt~\ref{sec:unix-install-disk} auf
Seite~\pageref{sec:unix-install-disk}.  Zusätzlich können Sie hier nach einer
erfolgten \TL{}-Installation nachträglich Pakete hinzufügen oder entfernen,
die Datei-Datenbank aktualisieren und Formate erzeugen.

Falls Sie die technischen Details interessieren: \cmdname{tlpmgui} verwendet
im Hintergrund ein Kommandozeilen-Programm mit dem Namen \cmdname{tlpm}.

Die unter Windows ausführbaren \TL-Programme basieren auf den neuen
Programmen aus dem \XEmTeX{}-Projekt, dem Nachfolger von \fpTeX{} (siehe
\url{http://www.metz.supelec.fr/~popineau/xemtex-1.html}). Einige Programme
sind ältere (aber hoffentlich noch funktionsfähige) Programme, insbesondere
der \dvi-Viewer \textsf{Windvi}, dessen Benutzung sich an dem auf
Unix-Systemen in der Regel verwendeten \textsf{xdvi} orientiert. Die
Anleitung zu \textsf{Windvi} finden Sie unter
\OnCD{texmf/doc/html/windvi/windvi.html}. Bitte beachten Sie, dass 
\textsf{Windvi} nicht mehr weiter entwickelt wird.

\TL{} kann auf 32"~Bit-Windows-Systemen wie
Windows\,9x, {\ME}, {\NT}, Windows\,2000 (\acro{2K}) oder {\XP} installiert
werden. Ältere Versionen von Windows (3.1x) oder gar \acro{MS-DOS} werden
nicht unterstützt.

\subsection{Installon von \protect\TeX\protect\ Live auf Festplatte}

Nach dem Einlegen der \TL-CD in Ihr \acro{CD}-Laufwerk sollte \cmdname{tlpmgui}
automatisch starten. Wenn Sie die \TeX Collection-DVD verwenden,
erscheint ein Auswahl-Menu für die einzelnen auf der DVD enthaltenen
Teile, und \cmdname{tlpmgui} startet nach der Auswahl von \TL.
Ist dies nicht der Fall, weil die Autostart-Option Ihres Systems deaktiviert
ist, wählen Sie auf Ihrem Windows-Desktop \guiseq{Start\arw Ausführen/Run} und
starten \verb|laufwerk:\setup-win32\tplmgui.exe| (von der
\pkgname{inst}-CD) bzw. \verb|laufwerk:\texlive\setup-win32\tplmgui.exe|
(wenn Sie die \pkgname{live}-DVD verwenden).

Das Installationsprogramm \cmdname{tlpmgui} öffnet ein Fenster mit dem Titel
">\guiseq{TeX Live Installations- und Wartungsprogramm/TeX Live installation
and maintenance utility}"<. Die Sprache Ihres Windowssystem sollte automatisch
erkannt werden, so dass Sie in der Regel eine deutschsprachige Oberfläche
sehen sollten.

Hier sind folgende Optionsgruppen verfügbar: \guiseq{Anpassung/Main
customization}, \guiseq{Installation/Install}, \guiseq{Schema
auswählen/Select a scheme}, \guiseq{System auswählen/Select systems},
\guiseq{Verzeichnisse/Directories} and \guiseq{Optionen/Options}. Derzeit
sind noch nicht alle Gruppen wirklich implementiert, einige erscheinen noch
hellgrau und sind inaktiv.

Im Abschnitt ">\guiseq{Verzeichnisse/Directories}"< sollte Ihr CD/DVD-Laufwerk
bereits neben der Schaltfläche \guiseq{CD/DVD} erscheinen. Falls nicht,
klicken Sie bitte auf \guiseq{CD/DVD} und wählen das Laufwerk aus,
in dem Installationsmedium befindet (bzw. \path|<laufwerk>:\texlive|, wenn
Sie von der \pkgname{live}-DVD installiern).

Das Ziel-Verzeichnis für die Software-Installation kann über die Schaltfläche
\guiseq{TLroot} ausgewählt werden. Zur späteren Verwendung wird eine
Umgebungsvariable \path|TLroot| auf dieses Verzeichnis gesetzt. Die
Pfade \path|TEXMFTEMP| und \path|TEXMFCNF|, die neben den entsprechenden
Schaltflächen angezeigt werden, werden automatisch auf sinnvolle Werte
gesetzt, können aber auch manuell geändert werden.

Im Abschnitt ">\guiseq{Schema auswählen/Select a scheme}"< kann das
gewünschte Installations-Schema ausgewählt werden (z.\,B.
\guiseq{scheme-gust}). % TODO: Besseres Beispiel
Zu jedem Schema kann mit \guiseq{Info} ein kurzer Informationstext angezeigt
werden.

Schemata (schemes) sind große Sammlungen von Paketen für typische
Anwendungsfälle. Es gibt allgemeine Schemata wie \texttt{basic},
\texttt{medium} und \texttt{full}, wobei wir bei ausreichendem Platz auf
Ihrer Festplatte das Schema \texttt{full} empfehlen. Andere Schemata wurden
speziell für einzelen User Groups zusammengestellt (wie GUST und GUTenberg)
oder betreffen spezielle Anwendungsfälle (z.\,B. für XML-Integration in
\TeX). Ein ausgewähltes Schema kann im Abschnitt ">\guiseq{Anpassung/Main
customization}"< durch die Aus- oder Abwahl von Kollektionen (collections)
in den Auswahlfenstern angepasst werden, die nach Klicken auf
">\guiseq{Standard-Kollektionen}"< oder ">\guiseq{Sprach-Kollektionen/Language
collections}"< erscheinen. So können Sie zum Beispiel durch Auswahl von
">\guiseq{Standard-Kollektionen}"< zusätzliche Pakete wie \MP, Omega oder
Anleitungen in verschiedenen Sprachen auswählen.

\textbf{Anmerkung:} Die Pakete \guiseq{Ghostscript}, \guiseq{Perl} und
\guiseq{Wintools} sind standardmäßig ausgewählt und sollten auf jeden
Fall installiert werden, da deren Installation für viele Programme
notwendig ist -- es sei denn, sie sind bereits anderweitig installiert und
Sie kennen sich gut mit Ihrem System aus. Von diesen Tools werden die
Umgebungsvariablen \verb|PERL5LIB| und \verb|GS_LIB| gesetzt.

Im Bereich ">\guiseq{Sprach-Kollektionen}"< im Abschnitt
\guiseq{Anpassung/Main customization} können Sie durch
Haken auswählen, welche Sprachunterstützungen installiert werden sollen.

Zum Starten der Installation klicken Sie auf die Schaltfläche
\guiseq{Installieren} im Abschnitt ">\guiseq{Installation}"<.

Während der Installation sehen Sie rechts unten einen Statusbalken.  Solange
die Daten von dem Installationsmedium auf die Festplatte kopiert werden,
füllt sich dieser langsam (und damit meinen wir wirklich langsam) von links
nach rechts.  Die Installation erfordert nach dem Kopieren auf die Festplatte
mehrere zusätzliche Schritte wie Erzeugen der Formate, Aufbau der
Datei-Datenbank, Setzen von Umgebungsvariablen etc. Dies kann einige Zeit in
Anspruch nehmen, während der der Statusbalken periodisch von links nach
rechts und zurück wandert. Warten Sie auf jeden Fall, bis der erfolgreiche
Abschluss der Installation gemeldet wird.

In Ihrem Windows-System wird eine Programmgruppe
\guiseq{Start\arw Programme\arw TeXLive2006} mit dem Installationsprogramm
\cmdname{tlpmgui} eingerichtet.

Arbeiten Sie unter Windows\,9x/""\ME, müssen Sie einen Windows-Neustart
durchführen.

% -------------------------------------------------------------
\subsection{Installation von Support-Paketen für Windows}\label{sec:win-xemtex}

Für ein vollständiges \TL-System werden noch eine Reihe von
Paketen benötigt, die üblicherweise nicht zum Standard-Repertoire
von Windows gehören. Hierzu gehören \cmdname{Perl}, der
\PS-Interpreter \cmdname{Ghostscript} und eine
graphische Toolbox; zudem kann ein \TeX-orientierter
Editor eine deutliche Erleichterung bei der Tipparbeit darstellen.

Alle diese Programme sind für Windows verfügbar; und um das Leben
ein bisschen einfacher zu machen, sind sie auch in {\TL}
vertreten:

\begin{itemize}
\item GNU \cmdname{Ghostscript}~7.07
\item eine minimale Installation von \cmdname{Perl} 5.8, die für die
  Perl-Skripte von \TL{} benötigt werden
\item win-tools ist eine Sammlung von Programmen wie bzip2, gzip, jpeg2ps
  und tiff2png
\end{itemize}

Diese Programme stammen aus der \XEmTeX{}-Distribution, dem Nachfolger
von fp\TeX.

Perl und Ghostscript werden automatisch installiert, wenn Sie es nicht
explizit abgewählt haben. Tun Sie dies nur, wenn Sie sicher sind, dass
diese Programme bereits installiert sind.

Wenn Sie diese Sammlung nicht installieren möchten, sind Sie auf sich
gestellt, die notwendigen Tools und Pakete zur Vervollständigung Ihres
\TL-System verfügbar zu machen. Nachfolgend finden Sie eine Liste
der Tools und die zugehörigen Adressen, wo Sie sie herunterladen können:

\begin{description}
\item[\cmdname{Ghostscript}:]\mbox{}\\
     \url{http://www.cs.wisc.edu/~ghost/}, in der {\TL}
     finden Sie die Version 8.53 unter
     \href{ftp://ftp.dante.de/tex-archive/nonfree/support/ghostscript/AFPL/}{\texttt{ctan/nonfree/support/ghostscript/AFPL}}
\item[Perl:]\mbox{}\\
     \url{http://www.activestate.com/} (zusätzliche
     \cmdname{Perl}-Module erhalten Sie von \acro{CPAN}:
     \url{http://www.cpan.org/})
\item[ImageMagick:]\mbox{}\\
     \url{http://www.imagemagick.com/}
\item[NetPBM:]\mbox{}\\
     als Alternative zu \cmdname{ImageMagick} können
     Sie \cmdname{NetPBM} für die Bearbeitung und Konversion
     Ihrer Graphikdateien benutzen. Die \cmdname{NetPBM}-Homepage
     ist \url{http://netpbm.sourceforge.net/}.
\item[\TeX-Editoren:]\mbox{}\\
     Die Zahl der Editoren ist groß -- und da es meist
     Geschmackssache ist, hier eine kleine Auswahl:
     \begin{itemize*}
     \item \cmdname{GNU~Emacs} ist als Windows-Version verfügbar; siehe
           \url{http://www.gnu.org/software/emacs/windows/ntemacs.html}.
     \item \cmdname{XEmacs} ist ebenfalls unter Windows verfügbar; siehe
           \url{http://www.xemacs.org/}.
     \item \cmdname{WinShell} ist in der {\TL} im Verzeichnis \path|support| vorhanden,
           die URL ist \url{http://www.winshell.de/}.
     \item \cmdname{WinEdt} ist ein Shareware-Editor erhältlich unter der
           URL \url{http://www.winedt.com/}. In der {\TL} (\DVD) sind die
           aktuellen Programme, Erweiterungsmakros und Wörterbücher in
           dem Verzeichnis \href{ftp://ftp.dante.de/tex-archive/nonfree/systems/win32/winedt/}{\texttt{ctan/nonfree/systems/win32/winedt/}}
           enthalten.

           Mitglieder von \acro{DANTE}~e.V. können über den Verein preisgünstige
           Lizenzen erhalten (siehe \url{http://www.dante.de/dante/lizenzen/winedt/}).
     \item \cmdname{vim} finden Sie auf der {\TL} im Pfad
           \OnCD{support/vim}; die Referenz-URL ist \url{http://www.vim.org/}.
     \item TeXnicCenter ist eine freie Oberfläche, erhältlich von
           \url{http://www.toolscenter.org} und innerhalb von proTeXt.
     \item \cmdname{LEd} ist unter \url{http://www.ctan.org/support/LEd}
           erhätlich
     \item \cmdname{SciTE} kann unter der URL \url{http://www.scintilla.org/SciTE.html}
           geladen werden.
     \end{itemize*}
\end{description}

Sie werden sicherlich weitere Tools installieren wollen, die ">nicht
frei"<\footnote{Die Festlegung ">\emph{nicht frei}"< folgt den Richtlinien
für ">freie Software"<. Es heißt
nicht, dass Sie die Software nicht auch kostenlos bekommen können.}
sind und deshalb auf der {\TL} fehlen, so zum Beispiel \cmdname{GSView}.
Dieser Begleiter von \cmdname{Ghostscript}, der das Anschauen von
\PS-/\pdf-Dateien vereinfacht, ist erhältlich unter der URL
\url{http://www.cs.wisc.edu/~ghost/gsview/} oder
\href{ftp://ftp.dante.de/tex-archive/nonfree/support/ghostscript/ghostgum/}{\texttt{CTAN:nonfree/support/ghostscript/ghostgum}}.

%\clearpage

% -------------------------------------------------------------
\subsection{Wartung Ihrer Installation}

Wenn Sie Ihr \TL-System installiert haben, können Sie das System mit dem
Aufruf von \cmdname{tlpmgui} modifizieren.

\subsubsection{Hinzufügen und Entfernen von Paketen}
Starten Sie \cmdname{tlpmgui} aus der Programmgruppe
\guiseq{Start\arw Programme\arw TeXLive2006}, die während der Installation
angelegt wurde. Das Fenster mit dem Titel ">\guiseq{TeX Live Installations-
und Wartungsprogramm}"< erscheint. Hier sind mehrere Bereiche als
Karteireiter vorhanden:
\guiseq{Pakete hinzufügen/Add Packages},
\guiseq{Pakete entfernen/Remove packages}, 
\guiseq{Installation bearbeiten/Manage installation},
\guiseq{Installation entfernen/Remove installation}.

Das Arbeiten mit ">\guiseq{Pakete hinzufügen}"< bzw. ">\guiseq{Pakete
entfernen}"< ist im Wesentlichen identisch:
\begin{itemize}
\item Wählen Sie im ersten Abschnitt Ihr Laufwerk mit dem Installationsmedium
  aus (bzw. \path|<laufwerk>:\texlive| von der DVD).
\item Klicken Sie auf die Schaltfläche ">\guiseq{Suchen/Search}"<, um im
  Abschnitt ">\guiseq{Auswahl der zu \dots{} Pakete/Select packages
  to\dots}"< die Liste der zu (de)installierenden Pakete zu aktualisieren.
  
  Wenn Sie Pakete hinzufügen wollen, wird die Liste der bereits installierten
  Pakete mit den auf der CD/DVD vorhandenen Pakete abgeglichen. Es werden nur
  die Pakete angezeigt, die noch nicht installiert wurden, aus denen Sie
  dann Ihre Auswahl treffen können.

  Wenn Sie Pakete entfernen wollen, werden nur die tatsächlich installierten
  Pakete zur Deinstallation angeboten.

  Beachten Sie, dass in der Auswahlliste zuerst komplette Kollektionen
  (Collections) erscheinen.

\item Wählen Sie die zu (de)installierenden Pakete aus. Durch Auswahl von
  \guiseq{Info} erhalten Sie jeweils kurze Informationen zum ausgewählten
  Paket. Zur Auswahl mehrerer Pakete halten Sie bei der Auswahl die
  Control- bzw. Strg-Taste oder die Shift-Taste gedrückt.

\item Klicken Sie auf \guiseq{Installieren} bzw. \guiseq{Entfernen}, um die
  (De)Installation durchzuführen.
\end{itemize}

\subsubsection{Konfiguration und Verwaltung}

Die Funktionen im Bereich ">\guiseq{Installation bearbeiten/Manage the
installation}"< sind hilfreich, wenn Sie die Unterstützung für weitere
Sprachen hinzufügen möchten, die Sie bei der Installation nicht ausgewählt
hatten.  Weiterhin können Sie die \TeX-Formate neu generieren, sei es, weil
Sie sie noch nicht installiert hatten oder Sie Änderungen an Ihrem System
vorgenommen haben, die eine Neugenerierung der Formate erfordern (z.\,B. die
Installation weiterer Trennmuster).

\subsubsection{Deinstallation von \TL}

Die Schaltfäche ">\guiseq{Installation entfernen/Remove the installation}"<
öffnet ein Fenster, dessen Funktionalität wir hier nicht näher beschreiben
wollen, da wir nicht wissen, warum man dies tun sollte \dots

Beachten Sie, dass eine Deinstallation einen lokalen texmf-Baum unter
\path|texmf-local| nicht betrifft. Sie brauchen also keine Sorgen zu haben,
dass Ihre lokalen Ergänzungen auf einmal verschwinden. Das Verzeichnis
\path|setup-win32|, in dem sich das Installationsprogramm \cmdname{tlpmgui}
und davon benötigte Dateien befinden, wird ebenfalls nicht gelöscht und
muss von Ihnen für eine restlose Deinstallation manuell gelöscht werden.

\subsection{Hinzufügen eigener Pakete zur existierenden Installation}

Das Hinzufügen eigener Pakete zur Installation setzt etwas Detail\-kenntnis
voraus. Ein häufig auftretendes Problem ist, dass Sie niemals vergessen
dürfen, nach eigenen Änderungen die Datei-Datenbank (die aus Gründen, die
aus der \acro{UNIX}-Welt stammen, \texttt{ls-R} heißt) aufzufrischen.
Ansonsten werden Ihre neuen Dateien nicht gefunden! Sie können dies entweder
mit \cmdname{tlpmgui} durch die entsprechende Schaltfläche im Bereich
">\guiseq{Installation bearbeiten}"< oder durch direktes Aufrufen von
\file{mktexlsr} tun.

Wenn Sie Pakete hinzufügen wollen, die nicht zur \TL-Distribution gehören,
sind diese im \path|texmf-local|-Baum am Besten aufgehoben. Dort sind
Ihre Dateien vor einem Upgrade oder einer Deinstallation von \TL{} sicher.

Das Verzeichnis \path|texmf-local| ist zunächst leer. Wenn Sie dort neue
Dateien hinzufügen wollen, müssen diese innerhalb dieses Baumes so abgelegtgq
werden, dass es der standardisierten \TeX-Verzeichnisstruktur TDS entspricht.
Wollen Sie also z.\,B. Style-Dateien für das Mathematik-Programm Maple
hinzufügen, sind diese unter
\path|c:\TeXLive2006\texmf-local\tex\latex\maple| und die zugehörige
Dokumentation unter \path|c:\TeXLive2006\texmf-local\doc\latex\maple| gut
aufgehoben.

\subsection{Benutzung von \texttt{tlmp.exe} in der Kommandozeile}

Das Programm \cmdname{tlpm.exe}, das von \cmdname{tlpmgui} im Hintergrund
benutzt wird, enthält einige weitere nützliche Optionen. Einen Überblick
erhalten Sie durch den Aufruf
\begin{verbatim}
    tlpm --help
\end{verbatim}

Weitere Informationen finden Sie auf englisch in der Datei \path|tlpm.readme|.

\subsection{Installation im Netzwerk}
\KPS{} unterstützt inzwischen die von Windows verwendeten UNC-Namen, so
dass Sie Ihren texmf-Baum auch über das Netzwerk verwenden können.

Im folgenden beschreiben wir den Fall, dass Sie ein Multiplattform-System
über das Netzwerk zugänglich machen wollen.

Alle Dateien einer \TL-Installation außer den Programmen in den
\path|bin|-Verzeichnissen sind von der Betriebssystem"=Plattform unabhängig,
so dass es möglich ist, dass über Samba ein Windows-Client eine
\TL-Installation von einem \acro{UNIX}-Server oder ein \acro{UNIX}-Rechner
auf einen Windows-Server zugreift. Hierbei sind mehrere Szenarien denkbar:
\begin{itemize}
\item Komplettinstallation auf einem Server. Hier müssen Sie unterhalb des
  \path|bin|-Verzeichnisses die ausführbaren Programme für die gewünschten
  Plattformen installieren, also z.\,B. \path|bin/win32| und
  \path|bin/i386-linux|. Anschließend müssen Sie Ihren Pfad und die
  Umgebungsvariablen konfigurieren. Für Windows können Sie UNC-Namen benutzen.
\item Lokale Kopie der ausführbaren Programme und der \TeX-Formate. In diesem
  Fall müssen Sie die Umgebungsvariable \verb|$TEXMFMAIN| auf den globalen
  texmf-Baum zeigen lassen, der auf dem Server liegt. Setzen Sie die
  Variable \verb|$TEXMFVAR| auf ein lokales Verzeichnis, in dem Sie die
  Konfigurationsdateien und automatisch generierte Dateien ablegen können.
\end{itemize}


% -------------------------------------------------------------
\subsection{Win32-Unterschiede zum Standard-\Webc}

Die Win32-Version von {\Webc} hat einige spezifische Eigenschaften,
die hier näher erklärt werden.

\begin{description}
\item[{\KPS}:]\mbox{}\\
     Die von {\KPS} aufgebauten Hash-Tabellen sind bei {\TL}
     sehr groß. Um die Startzeit für jedes Programm, das {\KPS}
     benutzt, zu verkürzen, wurden diese Hash-Tabellen in das
     ">Shared Memory"< gelegt. Dadurch kann der Overhead, der beim
     zyklischen Aufruf von Programmen auftritt, wenn \file{tex}
     beispielsweise \file{mpost} aufruft, das wiederum \file{tex}
     ruft, vermindert werden. Diese Änderung wird vor dem Benutzer
     versteckt, außer wenn das Debug-Flag bei \cmdname{kpathsea}
     auf \file{-1} gesetzt wird. Dann wird der Zugriff zum
     Shared-Memory aufgezeichnet, was sicherlich nicht das ist,
     was Sie wollen (es wird nämlich \textbf{sehr} häufig angesprochen!).
     Die wirklich erforderlichen Trace-Daten für den Zugriff auf
     das Shared-Memory müssen noch definiert werden; dies ist
     sicherlich eine Aufgabe für die Zukunft.
\item[\cmdname{kpsecheck}:]\mbox{}\\
     Dieses Kommando bietet einige Optionen, die nicht zu den Aufgaben
     von \cmdname{kpsewhich} gehören und deshalb auch dort schlecht passen.
     Mit \cmdname{kpsecheck} können Sie alle Dateinamen auf"|listen, die
     mehrfach in verschiedenen Zweigen des \OnCD{texmf}-Baums auftreten.
     Dies ist bei der Dateisuche sehr praktisch; die meiste Zeit werden Sie
     allerdings unerwünschte Angaben bekommen, beispielsweise von dutzendweise
     vertretenen \file{README}-Dateien. Es bleibt festzustellen,
     dass alle diese Dateien zu Problemen beim \KPS"=Hash"=Mechanismus
     führen; glücklicherweise wird nach diesen Dateien nie gesucht.
     Deshalb kann die Option \mbox{\file{-multiple-occurrences}} mit zwei
     weiteren Optionen zum Ein- oder Ausschluss von Dateinamen, die
     einem bestimmtem Muster entsprechen, kombiniert werden. Es können
     mehrere Muster angegeben werden.

     Das Kommando \cmdname{kpsecheck} gibt auch Auskunft über den Status
     des Shared-Memories: ">in~use"< oder ">not~used"< (">in Benutzung"< oder
     ">nicht benutzt"<). Das kann von Nutzen sein, da ein Aufruf von
     \cmdname{mktexlsr} so lange nicht ausgeführt wird, wie noch ein
     Prozess das Memory nutzt und der Status somit als ">in~use"<
     angegeben wird.

     Mit diesem Kommando kann auch das Installationsverzeichnis von
     \cmdname{Ghostscript} festgestellt werden. Für viele Programme
     unter Win32 ist es einfacher, die \cmdname{Ghostscript}-DLL zu benutzen
     und mittels des Registry-Keys von \cmdname{Ghostscript} das Verzeichnis
     zu finden, als den \file{PATH} zu ändern (der sowieso eine begrenzte
     Länge hat).

\item[\Webc:]\mbox{}\\
     Die \TeX-Engines unter Windows besitzen gegenüber der \Webc-Standardversion
     einige zusätzliche Optionen;
     zudem hat eine Option ein anderen Verhalten:
     \begin{itemize}
%%   \item das Verhalten der \file{-fmt}-Option unterscheidet sich
%%         vom Standard. Früher und mit der Standardversion von {\Webc}
%%         hat diese Option zwei unterschiedliche Bedeutungen, je nachdem,
%%         ob sie in ">ini"<"= oder ">vir"<"=Modus benutzt wird.
%%         Unter Windows gibt es keinen Unterschied: Es wird immer das
%%         angegebene Format geladen. Um die Bedeutung im ">ini"<"=Modus
%%         zu erhalten, wurde die Option ">\optname{-job-name}"< eingeführt.
%%   \item \file{-job-name}\mbox{\ }\newline
%%         erlaubt die Bestimmung des Dateinamens als Ergebnis eines
%%         Compiler-Laufs. Im normalen Modus ändert dies den Basisnamen
%%         aller erzeugten Dateien (\file{.dvi}, \file{.aux}, usw.),
%%         während im ">ini"<"=Modus der Name der Format-Datei festgelegt
%%         wird.
     \item \optname{-halt-on-error}\mbox{\ }\newline
           Stoppt die Übersetzung nach dem Auftreten des ersten Fehlers.
     \item \optname{-job-time}\mbox{\ }\newline
           Setzt die ">job~time"< auf die Zeit, die die Datei im Argument
           trägt.
     \item \optname{-oem}\mbox{\ }\newline
           Benutzt die \acro{DOS}-Codepage für alle Konsol-Ausgaben.
     \item \optname{-output-directory}\mbox{\ }\newline
           Alle Ausgabedateien werden in das angegebene Verzeichnis
           geschrieben.
     \item \optname{-time-statistics}\mbox{\ }\newline
           Ausgabe der Job-Statistik: Da Windows\,9x kein echtes 
	   Multi"~Tasking-Betriebssystem ist, besitzt es keinen Timer für
	   kurze Zeitabläufe.  Die ausgegebenen Zeiten sind daher
	   Annäherungen. Unter {\NT}/Windows\,2000 und {\XP} sind die
	   angegebenen Zeiten für Usertime und Systemtime recht genau.
	   Hinweis für \acro{UNIX}-Benutzer: Das Kommando \cmdname{time}
	   steht Windows-Benutzern nicht zur Verfügung.
     \end{itemize}
\end{description}

% -------------------------------------------------------------
\subsection{Persönliche Konfiguration}

% ..............................................................
\subsubsection{\dvips}

Die Konfigurationsdatei für {\dvips} ist so eingestellt, dass die \TypeI"=Fonts
genutzt werden. Anpassungen sind notwendig, falls stan"-dard"-mä"-ßig eine andere
Papiergröße als DIN\,A4 verwendet werden soll.

Öffnen Sie die Datei |c:\TeXLive2006\texmf-var\dvips\config\config.ps|
mit einem Editor.

\begin{description}
\item[Fonts:]\mbox{}\\
     Sie können damit die Voreinstellungen für den \MF-Drucker-Modus und die Drucker"-auf"|lö"-sung ändern. Das könnte 
     dann erforderlich sein, wenn {\dvips} \acro{PK}-Dateien generieren müsste. In der Voreinstellung ist {\dvips} so 
     konfiguriert, dass die \TypeI-Versionen der CM-Fonts benutzt werden. \cmdname{mktexpk} sollte deshalb nicht allzu 
     oft gerufen werden.
\item[Printer:]\mbox{}\\
     Sie können einen Standarddrucker einrichten.
     Steht die Option \samp{o} ohne weitere Zeichen allein
     auf der Zeile, wird ein \file{.ps}-File geschrieben.
     Sie können nun \cmdname{dvips} Druckernamen in folgender
     Weise vorgeben:\\
       \hspace*{1em}   \optname{o lpt1:}         \\
       \hspace*{1em}   \verb+% o | lpr -S server -P myprinter+ \\
       \hspace*{1em}   \verb+% o \\server\myprinter+
\item[Paper:]\mbox{}\\
     Für die Änderung der Standard-Papiergröße von DIN\,A4 auf
     beispielsweise ">US letter"<, müssen Sie dafür sorgen,
     dass ">US letter"< die erste in der Datei aufgeführte
     Papiergröße ist. Suchen Sie den Block mit Zeilen,
     die mit \samp{@} beginnen. Verschieben Sie die
     folgenden Zeilen an den Beginn dieses Blocks:\\
       \hspace*{1em}   \optname{@ letterSize 8.5in 11in}          \\
       \hspace*{1em}   \optname{@ letter 8.5in 11in}              \\
       \hspace*{1em}   \optname{@+ \%\%BeginPaperSize: Letter}  \\
       \hspace*{1em}   \optname{@+ letter}                      \\
       \hspace*{1em}   \optname{@+ \%\%EndPaperSize}
\end{description}

Speichern Sie die Einstellungen.

Die aktuelle \TL-Distribution enthält Mechanismen, die dafür sorgen, dass die
Font"~Map-Dateien für {\dvips} und {\pdfTeX} immer auf den neuesten Stand
gehalten werden. Das geschieht während der \TeX-Installation wie auch bei der
Installation neuer Pakete durch das Programm \cmdname{updmap}. Sollten Sie
ein neues Paket per Hand installieren, müssen Sie die Datei \file{updmap.cfg}
in \verb|$TEXMFVAR/web2c| entsprechend editieren.

% ..............................................................
\subsubsection{\pdfTeX}

Wenn Sie {\pdfTeX} oder {\pdfLaTeX} benutzen, um direkt \pdf-Dateien zu
erzeugen und nicht das standardmäßige Papierformat DIN\,A4 benutzen wollen,
müssen Sie in der Konfigurationsdatei
|c:\TeXLive2006\texmf-var\tex\generic\config\pdftexconfig.tex| die
Anweisungen \samp{\bs pdfpagewidth} und \samp{\bs pdfpageheight} entsprechend
ändern.

Die Anweisungen heißen jetzt:

\begin{alltt}
   \bs{}pdfpagewidth=8.5 true in
   \bs{}pdfpageheight=11 true in
\end{alltt}

Speichern Sie die Datei und verlassen den Editor.

% ..............................................................
\subsubsection{\cmdname{GSView}}

\cmdname{GSView} unterliegt jetzt der Aladdin-Lizenz und kann deshalb nicht
mehr mit {\TL} verteilt werden. Sie können es aber jederzeit von einem der
\acro{CTAN}-Server laden (im Verzeichnis
\href{ftp://ftp.dante.de/tex-archive/nonfree/support/ghostscript/ghostgum/}{\texttt{nonfree/support/ghostscript/ghostgum}}).

In \cmdname{GSView} können Sie das Papier-Standardformat über die Menü-Option
\textbf{Formate} festlegen. Wählen Sie hier das gewünschte Format aus
der Liste, beispielsweise \textbf{A5}.

Beachten Sie die Menü-Optionen, die Ihnen erlauben, eine optimale
Bildschirmanzeige einzustellen:

Wählen Sie \textbf{Formate} \OptPl \textbf{Anzeige Einstellungen...}
und setzen Sie:\\
  \begin{tabular}{@{}ll}
    \hspace*{1em}   \textbf{Text Alpha}    & \texttt{4 bits} \\
    \hspace*{1em}   \textbf{Graphik Alpha} & \texttt{4 bits} \\
  \end{tabular}\\

Hierfür muss die Option \textbf{Farbtiefe} gegebenenfalls auf
\textbf{8} oder \textbf{24}\,Bits/Pixel eingestellt werden.

Damit alle diese Einstellungen erhalten bleiben, wählen Sie
\textbf{Optionen} \OptPl \textbf{Speichere Optionen jetzt}.
Beachten Sie, dass beim Installationsprozess alle \file{.ps}- und
\texttt{.eps}-Dateien mit \cmdname{GSView} assoziiert wurden. Über das
Drucken eines Dokuments finden Sie Informationen im Abschnitt~\ref{printing}.

% ..............................................................
\subsubsection{\cmdname{Windvi}}\label{sub:windvi}

Das Programm \file{tlpmgui.exe} nimmt eine Assoziation von
\file{.dvi}-Dateien mit \file{Windvi} vor. Sie können daher einfach auf
\dvi-Dateien doppelklicken, und \cmdname{Windvi} sollte starten.  Sie können
\cmdname{windvi} natürlich auch von der Kommandozeile starten oder sich eine
Verknüpfung auf \cmdname{windvi} auf den Desktop legen.

In \cmdname{Windvi} kann das gewünschte Papierformat aus einer Vielzahl
von Formaten über \textbf{View} \OptPl \textbf{Options} und dann in einer
Liste unter \samp{Paper~type} gewählt werden. Querformate sind an einem
angehängten \textbf{r} erkennbar, z.\,B. \textbf{a4r}. Mit \textbf{OK}
werden die Einstellungen gesichert.

Falls Sie nach dem passenden \MF-Modus für die Auf"|lösung Ihres Druckers
suchen, sollten Sie in |c:\Programme\TeXLive\texmf-dist\metafont\misc\modes.mf|
nachlesen.

Alle Konfigurationseinstellungen von \cmdname{Windvi} werden in
\dirname{\$HOME/windvi.cnf} gespeichert. Sie können diese
mit folgendem Befehl finden:

\begin{alltt}
c:\bs> \Ucom{kpsewhich --expand-var \$HOME/windvi.cnf}
\end{alltt}

Falls Sie Probleme mit \cmdname{Windvi} haben, empfiehlt es sich,
die Konfigurationsdatei zu löschen und zu prüfen, ob der gleiche
Fehler auch mit der Standardkonfiguration auftritt.

% -------------------------------------------------------------
\subsection{Installation testen}

Im Abschnitt~\ref{sec:test-install} auf Seite~\pageref{sec:test-install}
wurde eine generelle Methode zum Test einer Installation beschrieben;
die Ausführungen hier beleuchten die Windows-spezifischen Tests.

In Ihrem Editor öffnen Sie bitte die Datei \file{sample2e.tex}, die Sie unter
|c:\TeXLive2006\texmf-dist\tex\latex\base\| finden können.
Die \LaTeX-Quelle sollte nach dem Öffnen der Datei auf dem Bildschirm
angezeigt werden. Durch Anklicken des \LaTeX-Symbols in der Menü-Leiste
wird die Datei übersetzt; bei Wahl des Preview-Symbols (\cmdname{Windvi})
wird sie dargestellt.
Beim ersten ">Preview"< einer Datei mit \cmdname{Windvi} werden alle
benötigten Fonts erzeugt; sie wurden nicht mitinstalliert. Mit der
Zeit werden Sie das Fenster, das die Font"=Generierung anzeigt,
immer seltener sehen.
Als nächstes sollten Sie {\dvips} anklicken und \cmdname{GSView}
ausprobieren.

\textbf{Hinweis für später:} Wenn ein \LaTeX-Lauf mit einer Fehlermeldung
unterbricht, weil eine Datei nicht gefunden wird, können Sie mit
\textbf{Ctrl-z} einen Abbruch erzwingen. Überprüfen Sie anhand der
Protokolldatei, welche Datei nicht zu finden war und beheben Sie den Fehler.

% -------------------------------------------------------------
\subsection{Drucken}\label{printing}

Es ist grundsätzlich möglich, aus \cmdname{Windvi} heraus zu drucken.
Wird dabei der Standard-Windows-Druckertreiber benutzt, hat dies
den Vorteil, dass eine Ausgabe auf allen Druckern möglich ist und
Sie \file{BMP}- oder \file{WMF}-Bilddateien einbinden und drucken
können. Nachteil ist, dass teilweise extrem große Druckdateien
erzeugt werden. Sie müssen sicherstellen, dass die Druckparameter
korrekt eingestellt sind (siehe Abschnitt~\vref{sub:windvi}),
sonst erhalten Sie eine skalierte Ausgabe der Druckseite. So wird
bei einer Drucker"-auf"|lö"-sung von 300\,dpi eine 600-dpi-Druckausgabe
nur ein Viertel der Seite zeigen.

Im Allgemeinen ist es allerdings schneller und für den Produktionszyklus
beim Einbinden von \file{eps}-Graphiken schneller und sicherer, {\dvips} zu
benutzen. Sie erstellen eine \file{.ps}-Datei und drucken mit \cmdname{GSView}.
Einen Ausdruck können Sie in \cmdname{GSView} über das Drucker-Symbol oder
durch Wahl von \textbf{Datei} \OptPl \textbf{Drucken...} anstoßen. Es
wird dann ein Fenster für die weiteren Druckparameter geöffnet.

Bei der Benutzung eines \PS-Druckers müssen Sie sicherstellen,
dass Sie die Option \textbf{\PS~Drucker} angewählt haben.
Ab \cmdname{GSView}-Version~3.6 erfolgt dies in dem Feld
\samp{Druckmethode} unten links im Fenster \textbf{Drucken}.
Dann können Sie im Feld \samp{Drucker} jeden installierten
\PS-fähigen Drucker auswählen. Wenn Sie vergessen sollten,
\textbf{\PS-Drucker} als \samp{Druckmethode} zu wählen,
wird das Ausdrucken nicht funktionieren.

Benutzen Sie hingegen einen \textbf{nicht}-\PS-fähigen Drucker,
wählen Sie im Feld \samp{Druckmethode} stattdessen die Option
\textbf{\cmdname{Ghostscript} Treiber} und klicken den mit \textbf{djet500}
beschrifteten Knopf. Hier wählen Sie Ihren Drucker im Dialog
\textbf{Wähle Ghostscript-Gerät} aus.
(In älteren \cmdname{GSView}-Versionen müssen Sie das Feld
\samp{\PS-Drucker} abwählen und dann Ihren Drucker aus
der \textbf{Geräte-Liste} wählen.)

% -------------------------------------------------------------
\subsection{Tipps und Tricks für Win32-Plattformen}

% ..............................................................
\subsubsection{Die feinen Unterschiede bei Win32}

Was wir als Win32 bezeichnen, ist im Grunde kein eigenständiges
Betriebssystem. Es ist ein sehr großer Satz von Funktionen%
\footnote{Die Headerfiles der Microsoft-\acro{SDK} enthalten rund 12\,000\,Funktionen!},
den man benutzen kann, um Programme für unterschiedliche
Betriebssysteme der Windows-Familie zu schreiben.

Windows kommt in unterschiedlichen Ausprägungen:

\begin{itemize}
\item Windows\,95, Windows\,98 und {\ME} stellen \emph{keine echten Multi"~Tasking-
      oder Multi-Threading}-Systeme dar. Sie sind (hoffentlich)
      die letzte \acro{DOS}-Metamorphose. Dies kann man mehr oder minder leicht
      in der Boot-Phase überprüfen. Hat der PC \file{command.com} geladen
      und man unterbricht die weitere Boot-Folge und fragt nach der
      aktuellen (\acro{DOS}-)Version, so erhält man (zumindest bei älteren
      Versionen von Windows\,9x) die Angabe: \samp{MS-DOS~7.0}.
\item \NT, ein komplett neu geschriebenes Betriebssystem mit
      echten Multi"~Tasking"=Eigenschaften und vielen ">high~level~features"<
\item Windows\,2000, entwickelt auf der Basis von \NT, mit allen
      Schikanen von Windows\,98
\item \XP, in den Geschmacksrichtungen \emph{Personal} und \emph{Pro},
      ist der letzte Schritt auf dem Weg, die beiden Entwicklungslinien
      Windows\,9x und {\NT} zusammenzuführen. {\XP} wurde auf der
      Basis von {\NT} entwickelt.
\end{itemize}

Windows\,9x ist in der Lage, 32"~Bit- und 16"~Bit-Programme gleichzeitig
auszuführen. Das Betriebssystem ist allerdings nicht vollständig im
32"~Bit-Modus geschrieben und unterstützt daher keinen Speicherschutz.
16"~Bit-Applikationen können so Teile des Betriebssystemspeichers
überschreiben! Einige Systemteile, wie beispielsweise das \cmdname{GDI}
(Graphical Device Interface), müssen beschränkte Ressourcen wie Bitmaps,
Fonts usw. für alle gleichzeitig laufenden Programme verwalten. Die
Gesamtgröße aller Bitmap-Header, die zu einem Zeitpunkt verfügbar ist,
beträgt maximal 64\,KB. Dies erklärt die Rolle von ">Performance~Tools"<
und auch, warum Sie die Stabilität Ihres Systems auf die Probe stellen,
wenn Sie intensiven Gebrauch von graphischen Objekten machen.

\NT/""{\XP} und Windows\,2000 leiden weder unter diesen, noch unter
anderen Windows"~9x"=Beschränkungen. Sie sind echte Multi"~Tasking-Systeme mit
Speicherschutz-Me"-cha"-nis"-men. Durch besseres Design bei Speicherverwaltung,
Dateisystem usw. haben sie zudem ein wesentlich besseres Antwortverhalten.

% ..............................................................
\subsubsection{Kommandointerpreter}

Sie haben sich sicherlich schon gefragt, ">Warum sollte ich etwas über
die Kommandozeile eingeben, wenn ich Windows benutze?"<.

Gute Frage. Dies ist mehr ein grundsätzliches Problem, da mit einer
graphischen Benutzerschnittstelle (\acro{GUI}) nicht immer alle Arbeitsschritte
einfach zu erledigen sind. Der Kommandointerpreter eröffnet hier 
häufig -- einen intelligenten Kommandointerpreter vorausgesetzt -- mehr Möglichkeiten.

In unserem Fall handelt es sich aber um ein fundamentales Problem:
{\TeX} ist ein \emph{Batch}-Tool und kein interaktives Programm.
{\TeX} errechnet das beste Layout für jede Seite, löst die Referenzen
auf, usw. Hierfür ist die Gesamtbearbeitung des Dokuments immer noch
die einfachste Methode. Bislang macht eine interaktive Bearbeitung
der Eingabe (noch) keinen Sinn.

Das bedeutet also, dass Sie {\TeX} auf der Kommandozeile benutzen
sollten. Im Grunde ist die Situation sogar so, dass diese Programme
für komplexe Verarbeitungsvorgänge besser geeignet sind, da es leichter
ist, ein Programm ohne die Verkopplung mit einer graphischen
Benutzerschnittstelle zu testen und Fehler zu finden. Es ist
dann auch einfacher, ein \acro{GUI} zur Bedienung dieses Programms
zu entwickeln. Und dies ist genau der Fall für {\TeX}, mit dem
Sie in den allermeisten Fällen über eine Shell oder einen
\acro{GUI}-Editor in Kontakt treten.

Manchmal benötigen Sie aber den Kommandointerpreter dazu, um
Probleme zu lösen oder um Fehler in Ihrem Setup aufzuspüren
(siehe Abschnitt~\ref{sec:troubleshooting}).

\begin{description}
  \item[Windows\,9x:]\mbox{}\\
                Sie starten den Kommandointerpreter entweder im
                \textbf{Start}-Menü \OptPl \textbf{Programme} und
                suchen die Option \cmdname{MS-DOS-Eingabeauf"|forderung}
                oder mit \textbf{Start}-Menü \OptPl \textbf{Ausführen}
                und tippen ">\file{command.com}"<.
  \item[{\NT}, Windows\,2000 und \XP:]\mbox{}\\
                Sie finden den Kommandointerpreter im
                \textbf{Start}-Menü unter \textbf{Accessories}.%
                \footnote{Dies kann je nach Version des Betriebssystems
                unterschiedlich sein. In der deutschsprachigen Version
                von Windows heißt diese Programmgruppe meistens ">Zubehör"<.}
                Sie starten ihn allerdings auch im \textbf{Start}-Menü
                \OptPl \textbf{Ausführen} durch ">\file{cmd.exe}"<
                (so heißt der nagelneue Kommandointerpreter für
                {\NT}).\footnote{Was auch erklärt, warum es unwahr
                ist, ihn unter {\NT} als \emph{\acro{DOS}}-Box zu bezeichnen.}
\end{description}

% ..............................................................
\subsubsection{Verzeichnistrenner}

Die Win32-API versteht sowohl \samp{/} als auch ">|\|"<
als Verzeichnistrenner. Die Kommandointerpreter aber leider nicht!
Sie können also immer dann beide Trenner benutzen, sogar gemischt
innerhalb eines Pfads, wenn Sie \emph{nicht} auf der Kommandozeile
arbeiten.
Der Kommandointerpreter spielt hier nicht mit, da er das Zeichen
\samp{/} benutzt, um Argumente von Kommandos zu trennen.

Sie sollten also nicht überrascht sein, wenn Sie Pfad- und
Verzeichnisnamen in der \acro{UNIX}"=Schreibweise sehen. \fpTeX ist eine
Portierung von {\Webc} und zielt auf Kompatibilität über die Plattformen.
Deshalb enthalten alle Konfigurationsdateien die Pfadnamen in
\acro{UNIX}-Schreibweise.

% ..............................................................
\subsubsection{Dateisysteme}\label{sec:clusters}

Das schwächste Glied bei Windows\,9x in Bezug auf {\TeX} ist
sicherlich das sogenannte \acro{FAT}- oder \acro{FAT16}-Dateisystem.
{\TeX} benutzt eine Vielzahl sehr kleiner Dateien, meist mit
Größen zwischen 1\, und 3\,KB. Das \acro{FAT}-Dateisystem
ist veraltet; es stammt aus einer Zeit, als Gigabyte-Platten
noch unbekannt waren. Deshalb kann es mit den Zehntausenden von Dateien
des \TL-Systems nicht effizient umgehen. Im \acro{FAT}-Dateisystem
werden auf großen Partitionen im Minimum 32\,KB für
\emph{jede} Datei angelegt. Damit ist klar, dass {\TeX} auf
diese Weise wesentlich mehr Plattenplatz verbraucht als
notwendig wäre.

Die moderneren Windows-Dateisysteme, wie \acro{FAT32} oder \acro{NTFS},
haben diesen Nachteil nicht. Hier betragen die sogenannten
Cluster-Größen 4\,KB.%
\footnote{Unter \acro{NTFS} kann dies bis auf 512\,Byte gesenkt werden.}

% ..............................................................
\subsubsection{\envname{PATH} um Verzeichnis(se) erweitern}

Jedes Programm erhält bei seinem Start eine Kopie der
Standardumgebung. Dies ist eine Sammlung von Variablen mit
zugehörigen Schlüsselwerten. Diese Variablen stehen unter
der ausschließlichen Kontrolle des Programms; Änderungen
an Schlüsseln oder Schlüsselwerten sind für andere Programme
nicht sichtbar.

Die Umgebungsvariable \envname{PATH} dient der Suche nach
Programmen. Es existieren unterschiedliche Vorgehensweisen
zur Änderung dieser Variablen für die verschiedenen
Windows-Varianten:

\begin{description}
\item[Windows\,95/98:]\mbox{}\\
     Laden Sie die Datei \file{autoexec.bat} in den Editor
     und suchen nach einer Zeile, die mit \samp{PATH=}
     beginnt. Nach dem \samp{=} folgt eine Liste von
     Verzeichnissen, die durch \samp{;} getrennt sind.
     Fügen Sie das Verzeichnis mit den \TL-Programmen
     an. Danach könnte die Zeile wie folgt aussehen:

     |PATH=c:\windows;c:\windows\system;c:\TeXLive2006\bin\win32|

\item[\ME:]\mbox{}\\
     Um eine Umgebungsvariable zu ändern, müssen Sie
     das Programm

     |c:\windows\system\msconfig.exe|
     
     laufen lassen. Wählen Sie nach dem Start dieses Programms
     ">\cmdname{Umgebung}"<, dann tragen Sie die Variable
     \texttt{PATH} mit ihrem Wert ein oder ändern ihn:

     |PATH c:\TeXLive2006\bin\win32|

     Danach werden Sie aufgefordert, Ihren Rechner neu zu starten.

\item[\NT/Windows\,2000:]\mbox{}\\
     Gehen Sie über \textbf{Start}-Menü \OptPl \textbf{Einstellungen}
     \OptPl \textbf{Systemsteuerung} \OptPl \textbf{System}.
     Wählen Sie \textbf{Umgebung}. Die weiteren Schritte finden Sie
     unter \XP.

\item[\XP:]\mbox{}\\
     Gehen Sie über \textbf{Start}-Menü \OptPl \textbf{Systemsteuerung}
     \OptPl \textbf{System} \OptPl \textbf{Erweitert}.
     Wählen Sie unten links \textbf{Umgebungsvariablen}.

     Sie können nun als Benutzer die Umgebungsvariablen
     ändern. Es werden Ihnen aber auch Variablen
     für das System angezeigt. Im Normalfall können Sie keine
     System-Variablen ändern, es sei denn, Sie besitzen für den
     Rechner auch Administrator-Rechte. Möchten Sie \envname{PATH}
     für alle Benutzer ändern, müssen Sie mit Ihrem Systembetreuer
     Kontakt aufnehmen; sind Sie selbst Systembetreuer, sollten
     Sie Bescheid wissen.

     Existiert bereits eine Einstellung für \envname{PATH} für Sie,
     klicken Sie mit der linken Maustaste auf \envname{PATH}. Im
     Feld \textsf{Variable} erscheint dann \envname{PATH}, das Feld
     \textsf{Wert} zeigt den aktuellen Inhalt als Liste von
     Verzeichnissen, die mit \samp{;} getrennt sind. Fügen Sie
     das Verzeichnis mit den \TL-Programmen an:

     |c:\TeXLive2006\bin\win32|

     Existiert für Sie keine Variable mit Namen \envname{PATH}, müssen Sie
     in das Feld \textsf{Variable} klicken und \envname{PATH}
     eintragen. Dann wählen Sie das Feld \textsf{Wert} an und
     tragen das gewünschte Verzeichnis ein.

     \textbf{Wichtig}: Klicken Sie zuerst \samp{Übernehmen} an,
     bevor Sie mit \samp{Ok} bestätigen. Anderenfalls
     werden die Änderungen an \envname{PATH} nicht für Ihr System
     übernommen. Seien Sie vorsichtig beim Ändern der Umgebung!
\end{description}

Zur Überprüfung, ob die Variable gesetzt wurde, ist es am
besten, ein Kommandointerpreter-Fenster zu öffnen und dort einzugeben:

   ~~~~\code{set} \var{variable}

Sie erhalten dann den zugewiesenen Wert angezeigt.

% ..............................................................
\subsubsection{{\TeX}-Engines}

Wenn Sie die \Webc-Dokumentation aufmerksam lesen, werden Sie
feststellen, dass immer davon geschrieben wird, dass alle auf
{\TeX} basierenden Programme die gleiche ">Base-Engine"<
benutzen. So sind zum Beispiel \file{tex.exe} und \file{latex.exe}
Kopien des gleichen Programms; jedes benötigt aber seine eigene
Format-Datei basierend auf dem Programmnamen.

Unter \acro{UNIX} wird dies durch sogenannte \emph{symbolische Links} erreicht.
Das spart Plattenplatz, da einige Base-Engines mit sehr vielen
unterschiedlichen Format-Dateien genutzt werden.

%\enlargethispage{-\baselineskip}
Die Win32-API kennt keine symbolischen Links. Um also annähernd die
gleiche Ersparnis zu erreichen, wurden die \TeX-Base-Engines
in sogenannten DLLs (\emph{Dynamic Linked Library}) realisiert.
Das heißt, man sieht folgende Verteilung:

\begin{alltt}
18/09/2005  14:19                3 584 latex.exe
18/09/2005  14:19                3 584 pdfetex.exe
18/09/2005  14:19              524 288 tl90pdfetex.dll
\end{alltt}

\file{latex.exe} ist eine Kopie von \file{pdfetex.exe}, die den
selben Kern \file{tl90pdfetex.dll} nutzt. Der gleiche Trick wurde
für die acht Mitglieder der \file{mktex*.exe}-Programmfamilie
benutzt, die auf die Bibliothek \file{mktex.dll} ">gelinkt"< sind.

Das \TL-System enthält das Programm \file{irun.exe}, mit
dem für Win32-Binärprogramme das \acro{UNIX}-Äquivalent der sogenannten
\emph{hard~links} eingerichtet werden kann.

% -------------------------------------------------------------
\subsection{Problemfälle}\label{sec:troubleshooting}

% ..............................................................
\subsubsection{Was ist zu tun, wenn {\LaTeX} Ihre Dateien nicht findet?}

\begin{itemize}
\item Bei diesen Problemen heißt das Werkzeug der Wahl \cmdname{kpsewhich}.
      Leider gibt \cmdname{kpsewhich} seine Ausgaben auf \samp{stderr}
      aus und das Fenster des Kommandointerpreters kennt keinen Weg
      \samp{stderr} auf eine Datei umzulenken.%
      \footnote{Ok, \NT/""{\XP} und Windows\,2000 haben dazu gelernt. Der
                angegebene Trick funktioniert aber für alle
                Systeme!}
      Für Diagnosezwecke kann man im Kommandointerpreter die folgende
      Umgebungsvariable definieren:

      | SET KPATHSEA_DEBUG_OUTPUT=err.log|

      Sie können auch die Debug-Schwelle einstellen:

      | SET KPATHSEA_DEBUG=-1|

\item Falls Sie die Fehlerausgabe \samp{stderr} auf die Standardausgabe \samp{stdout}
      umlegen wollen (unter Windows\,9x, \NT/""Windows\,2000/""{\XP} nicht möglich), hilft folgende
      Vorgehensweise:

      | SET KPATHSEA_DEBUG_OUTPUT=con:|

      Damit können Fehler- und Standardausgaben in der gleichen Datei gesammelt werden.

\item Überprüfen Sie die folgenden Werte (es wird hierbei angenommen, dass das
      \TeX-System unter |c:/TeXLive2005| eingerichtet wurde): \\
      \begin{small}
      \begin{tabular}{lp{6cm}}
      \texttt{kpsewhich -expand-path \$SELFAUTOPARENT}
                                  &  |c:/TeXLive2005| \\
      \texttt{kpsewhich -expand-path \$TEXMF}
                                  & |c:/TeXLive2005/texmf| \\
      \texttt{kpsewhich -expand-path \$TEXMFCNF}
                                  & |.;c:/TeXLive2005/texmf-var/web2c;| \\
      \texttt{kpsewhich -expand-var \$TEXINPUTS}
                                  & |.;c:/TeXLive2005/texmf/tex//|
      \end{tabular}
      \end{small}

\item Falls Sie die Umgebungsvariablen für das \TeX-Umfeld anders gesetzt haben,
      sollten Sie diese Eintragungen löschen. Offensichtlich werden die Einstellung
      aus \file{texmf.cnf} überschrieben.

\item Vergleichen Sie Ihre Ergebnisse mit folgenden Werten:\\
      \begin{small}
      \begin{tabular}{ll}
        \texttt{kpsewhich cmr10.tfm} &
            \file{c:/TeXLive2005/texmf/fonts/tfm/public/cm/cmr10.tfm}\\
        \texttt{kpsewhich latex.fmt}&
            \file{c:/TeXLive2005/texmf/web2c/latex.fmt}
      \end{tabular}
      \end{small}

\item Falls bis zu diesem Punkt alles übereinstimmte, sollten auch
      \file{tex.exe} und Co. funktionieren. Ist dies nicht der Fall,
      werden Sie sich intensiver mit der \cmdname{kpsewhich}-Option \optname{-debug=n}
      beschäftigen und alle Werte
      überprüfen müssen. Wenn Sie das Problem identifizieren können,
      schicken Sie bitte einen Fehler-Report.
\end{itemize}

% ..............................................................
\subsubsection{Was ist zu tun, wenn das Setup nicht wie gewünscht funktioniert?}

Es gibt einige Punkte, die Sie zuerst prüfen sollten:

\begin{enumerate}
\item Liegt \file{tex.exe} im definierten \envname{PATH}?
\item Wurde die Umgebungsvariable \envname{TEXMFCNF} auf
      |c:\TeXLive2005\texmf-var\web2c| gesetzt
      (eigene Einstellung beachten!)?
\item Wurden im Installationsprotokoll Fehler durch \file{tlpmgui.exe}
      eingetragen? Die Datei \file{tlpmgui.log} befindet sich im
      \file{TEMP}-Verzeichnis. Fehlermeldungen beginnen mit \samp{Error}.
      Hinweis: Manchmal finden sich in der Log-Datei Fehlermeldungen vom
      Versuch, alle Format-Dateien zu generieren. Keine Panik, wenn dies
      Formate betrifft, die Sie gar nicht installiert haben.
\item Sie können im \acro{WWW}-Dokument \url{http://www.tug.org/tex-live/}
      prüfen, ob ein Bug-Fix für das \TL-System vorliegt.
\end{enumerate}

Die \TL-Software ist komplex und besteht aus Hunderten von Programmen
und Zehntausenden von Dateien aus verschiedenen Quellen. Es ist deshalb nicht
möglich, Antworten für alle Problemfälle vorzuhalten. Wir werden aber
unser Bestes tun, Ihnen bei allen Schwierigkeiten zu helfen. (Siehe Abschnitt~\ref{sec:help} auf 
Seite~\pageref{sec:help}.)

% ==============================================================
% don't use \Webc so the \uppercase in the headline works.
\section[Anleitung zum Web2C-System]{Anleitung zum \Webc-System}

{\Webc} besteht aus einer Reihe von Programmen, die zusammen ein komplettes
\TeX-System darstellen. Dazu gehören natürlich \TeX,
\MF, \MP, {\BibTeX} usw.

Die erste Implementierung eines \TeX-Systems
in der Programmiersprache C stammt von Tomas~Rokicki und datiert zurück in das
Jahr 1987. Rokicki benutzte als Basis sog. Change-Files unter \acro{UNIX}, die ursprünglich von
Howard~Trickey und Pavel~Curtis entwickelt wurden. Tim~Morgan hat dieses
System, für das der Name  Web-to-C\@ eingeführt wurde, gepflegt.
1990 hat Karl~Berry mit Unterstützung vieler Helfer die Weiterentwicklung
übernommen und 1997 an Olaf~Weber weitergegeben.

\Webc~7.5 läuft unter \acro{UNIX}, Windows\,3.1, Windows\,9x/""\ME/""\NT/""Windows\,2000/""\XP,
\acro{DOS} und auf weiteren Betriebssystemen. Es benutzt die
Original-Quelldateien von Donald E.~Knuth und weitere in der
Sprache {\web} entwickelte Programme als Basis und übersetzt diese
in C-Quell-Code. Darüber hinaus bietet das System viele Makros und
Funktionen zur Nutzung der originalen \TeX-Software. Hier eine
Liste der Basisprogramme eines \TeX-Systems:

\begin{deflist}{\mdseries\cmdname{pooltype}}
%\renewcommand{\makelabel}[1]{\descriptionlabel{\mdseries\cmdname{#1}}}
\item[bibtex]   Verwalten von Bibliographien
\item[dmp]      \cmdname{troff}-nach-MPX-Konverter (\MP-Bilder)
\item[dvicopy]  Umwandeln von virtuellen Zeichensätzen in DVI-Dateien
\item[dvitomp]  DVI-nach-MPX-Konverter (\MP-Bilder)
\item[dvitype]  Textanzeige aus DVI-Dateien
\item[gftodvi]  Erzeugen von Prüfausgaben für Zeichensätze
\item[gftopk]   Packen von Zeichensätzen
\item[gftype]   Anzeige von Zeichensätzen als ASCII-Graphik
\item[makempx]  Anzeige von \MP-Beschriftungen
\item[mf]       Zeichensatzerzeugung
\item[mft]      formatierte Ausgabe von \MF-Quellen
\item[mpost]    \MF-ähnliches Grafikprogramm
\item[mpto]     Extrahieren von \MP-Beschriftungen
\item[newer]    Vergleich von Dateierstellungsdaten
\item[patgen]   Erzeugen von Trennmustern
\item[pktogf]   Entpacken von Zeichensätzen
\item[pktype]   Anzeige gepackter Zeichensätze
\item[pltotf]   Umwandeln von Property-Listen in \file{.tfm}-Dateien
\item[pooltype] Anzeige der Bildschirmtexte eines WEB-Programms
\item[tangle]   Konverter {\web} nach Pascal
\item[tex]      \TeX-Programm
\item[tftopl]   Umwandeln einer \file{.tfm}-Datei in eine Property-Liste
\item[vftovp]   Umwandeln eines virtuellen Zeichensatzes in eine Property-Liste
\item[vptovf]   Umwandeln einer Property-Liste in einen virtuellen Zeichensatz
\item[weave]    \web-Code als \TeX-Dokumentation
\end{deflist}

Die genaue Funktionsweise und die möglichen Parameter sind der
Beschreibung der jeweiligen Pakete bzw. der \Webc-Dokumentation zu entnehmen.
Trotzdem wird ein Überblick über Zusammenspiel und Funktionsweise der
\Webc-Programme Ihnen sicherlich helfen, besser mit dem System zurechtzukommen.

Zunächst verstehen alle Programme die grundlegenden Parameter der
\acro{GNU}-Software:

\begin{deflist}{\texttt{-{}-version}}
\item[\texttt{-{}-help}] kurzer Hilfstext
\item[\texttt{-{}-verbose}] ausführliche Ausgaben beim Programmablauf
\item[\texttt{-{}-version}] Ausgabe der Versionsnummer
\end{deflist}

Die Programme des \Webc-Systems benutzen zum Lokalisieren der benötigten
Dateien im Dateisystem die \KPS-Bibliothek. Diese Bibliothek optimiert und
beschleunigt den Suchprozess im Dateisystem. Ihre Arbeitsweise wird durch
einige Umgebungsvariablen und eine Kon"-fi"-gu"-ra"-tions"-da"-tei gesteuert.
\Webc~7.5 kann mehr als einen Dateibaum gleichzeitig verwalten und ermöglicht
somit die schon beschriebene \TL-Installation unter Verwendung der
{\CDROM} oder {\DVD} mit der Ablage modifizierter Konfigurationsdateien
und zusätzlicher Zeichensätze in einem zweiten Dateibaum. Die Suche
nach Dateien wird durch die Analyse der Datei \file{ls-R} beschleunigt,
die in jedem Wurzelverzeichnis eines \TeX-Dateibaums vorhanden ist.
Sie enthält für jede Datei die genaue Position im Dateibaum relativ
zum Wurzelverzeichnis.

% -------------------------------------------------------------
\subsection[Dateisuche mit der Kpathsea-Bibliothek]{Dateisuche mit der \protect\KPS-Bibliothek}

Wir beschreiben zunächst den grundlegenden Suchmechanismus der \KPS-Bibliothek.

Ein \emph{Suchpfad} ist eine durch Kommata oder Semikola getrennte Liste von
\emph{Pfadkomponenten}, die üblicherweise Verzeichnisnamen darstellen.
Ein Suchpfad kann sich aus vielen Komponenten zusammensetzen. Die Suche nach
einer Datei \samp{my-file} über den Suchpfad \samp{.:/dir} bewirkt, dass
{\KPS} jede Komponente nacheinander überprüft, also zunächst
\samp{./my-file} und dann \samp{/dir/my-file}. Als Ergebnis wird entweder die
erste gefundene Datei oder eine Liste aller passenden Dateien geliefert.

Um auf allen Dateisystemen effizient arbeiten zu können, verwendet {\KPS} ggf. andere
Datei-/""Verzeich"-nis-Separatoren als \samp{:} und \samp{/}.

Beim Überprüfen einer Pfadkomponente \var{p} überprüft {\KPS} zunächst,
ob eine Dateinamen"=Datenbank (siehe auch Dateinamen"=Datenbank auf
Seite~\pageref{Filename-database}) für die Pfadkomponente zuständig ist,
d.\,h. beispielsweise steht die Datenbank in einem Verzeichnis, das im Pfad
vor der zu überprüfenden Komponente \var{p} steht. In diesem Fall wird
zur Bestimmung der Position der gesuchten Datei die Datenbank herangezogen.

Nur wenn keine passende Datenbank existiert oder wenn die Datei nicht
in der Datenbank gefunden wird, durchsucht {\KPS} das Dateisystem. Diese
zeitaufwändige Suche kann über die Spezifikation der Pfadkomponente \var{p}
mit dem Präfix \samp{!!}\ unterbunden werden. Zur Suche erzeugt {\KPS} eine
Liste der Verzeichnisse, die im Pfadelement enthalten sind, und durchsucht
jedes dieser Verzeichnisse nach der gesuchten Datei.

Für Dateien kann auch ein Schalter \samp{file~must~exist} gesetzt
werden (">Datei muss vorhanden sein"<). Wenn dieser Schalter nicht
gesetzt ist und beispielsweise über das \TeX-Kommando
\cs{openin} eine VF-Datei wie \file{cmr10.vf} gelesen werden
soll, wäre es falsch, nach dieser Datei zu suchen, weil es sie gar
nicht gibt. Speziell für neu installierte VF-Dateien sollten Sie
also unbedingt die Dateinamen"=Datenbank (\cmdname{ls-R})
aktualisieren, weil die Dateien sonst nicht gelesen werden und
kein Fehler angezeigt wird. Dieser Vorgang wiederholt sich für jede
Komponente eines Suchpfades: zunächst wird die Datenbank
überprüft, danach ggf. das Dateisystem. Wird die Datei gefunden,
stoppt die Suche (normalerweise) und als Ergebnis wird der komplette Pfad zur
gesuchten Datei ausgegeben.

Außer Verzeichnisnamen dürfen Pfadkomponenten für {\KPS} folgende
Elemente enthalten: (verschachtelte) Vorgaben, Umgebungsvariablen,
Werte aus der Konfigurationsdatei, Home-Verzeich"-nisse von
Benutzern und Startverzeichnisse für eine rekursive Suche. Diese
Elemente werden vor einer Dateisuche von {\KPS} in gewöhnliche
Verzeichnis- oder Dateinamen expandiert. Diese Expansion wird in
den folgenden Abschnitten erklärt, und zwar genau in der
Reihenfolge, wie die Elemente auch von {\KPS} bearbeitet werden.

Beachten Sie, dass {\KPS} bei absoluten und explizit relativen Komponenten,
d.\,h. wenn die Komponente mit den Zeichen \samp{/}, \samp{./} oder
\samp{../} beginnt, nur überprüft, ob die Datei existiert.

\ifSingleColumn
\else

\begin{figure*}[tp]
\verbatiminput{examples/ex5.tex}
\setlength{\abovecaptionskip}{0pt}
  \caption{An illustrative configuration file sample}
  \label{fig:config-sample}
\end{figure*}
\fi

% ..............................................................
\subsubsection{Bestandteile von Pfadkomponenten}\label{Path-sources}

Ein Suchpfad kann aus vielen verschiedenen Bestandteilen aufgebaut werden.
Dies sind in der Reihenfolge, wie {\KPS} sie auswertet:

\begin{enumerate}
\item
  eine benutzerdefinierte Umgebungsvariable, z.\,B. \envname{TEXINPUTS}:
  Wird an den Inhalt der Variablen ein Punkt und ein Programmname angehängt, wie
  beispielsweise bei \envname{TEXINPUTS.latex}, hat diese Form Vorrang
  vor den ">gewöhnlichen"< Variablen.
\item
  Einträge aus programmspezifischen Konfigurationsdateien,
  beispielsweise zum Programm {\dvips} eine Zeile \samp{S /a:/b}
  in der Konfigurationsdatei \file{config.ps}
\item
  Einträge aus der \KPS-Konfigurationsdatei \file{texmf.cnf},
  z.\,B. \samp{TEXINPUTS=/c:/d} (siehe folgenden Text)
\item
  Einstellung beim Übersetzen der Programme
\end{enumerate}

Unter Verwendung der Parameter zur Fehlersuche können Sie sich diese
Werte für einen Suchpfad auch anzeigen lassen. (Siehe dazu den Abschnitt
Fehlersuche auf Seite~\pageref{Debugging}.)

% ..............................................................
\subsubsection{Konfigurationsdateien}

%\tolerance=3500
Die \KPS-Bibliothek liest zur Laufzeit die \emph{Konfigurationsdateien} mit den Namen
\file{texmf.cnf}. Der zugehörige Suchpfad zum Auf"|finden dieser
Konfigurationsdateien steht in der Umgebungsvariablen \envname{TEXMFCNF}
(die Voreinstellung ist \file{texmf/web2c}). {\KPS} liest \emph{alle}
Dateien mit den Namen \file{texmf.cnf}, die es in diesem Suchpfad findet.
Die zuerst gelesenen Definitionen haben dabei Vorrang vor später gelesenen
Werten.
Wenn der Suchpfad auf \dirname{.:\$TEXMF} steht, überschreiben die Einstellungen
in \file{./texmf.cnf} diejenigen in \dirname{\$TEXMF/texmf.cnf}.

%\tolerance=1500

Im Folgenden wird die Syntax der Datei \file{texmf.cnf} angegeben.
Konsultieren Sie zum besseren Verständnis beim Lesen die auf der
{\CDROM} oder {\DVD} enthaltene Konfigurationsdatei.
%, die ab Seite~\pageref{app:texmf.cnf} im Anhang dieser Anleitung
% abgedruckt ist.

\begin{itemize}
\item
  Kommentare beginnen mit einem \samp{\%} und erstrecken sich bis zum
  Zeilenende.
\item
  Leerzeilen werden überlesen.
\item
  Ein \samp{\bs} am Zeilenende fasst die aktuelle mit der folgenden Zeile
  zusammen. Leerraum in der Folgezeile wird \emph{nicht} überlesen.
\item
  Sonstige Zeilen haben den folgenden Aufbau:

\begin{alltt}
  \var{Variable}[.\var{Programmname}] [=] \var{Wert}
\end{alltt}%

  Das Zeichen ">="< und umgebender Leerraum dürfen entfallen.
\item
  Der Name von \var{Variable} kann alle Zeichen außer Leerzeichen,
  \samp{=} und \samp{.} enthalten. Verwenden Sie am besten nur die Zeichen
  \samp{A-Za-z\_}.
\item
  Wenn das Suffix ">\code{.\var{Programmname}}"< angegeben wird, gilt die
  Variable nur für das entsprechende Programm ">\var{Programmname}"< oder
  ">\code{\var{Programmname}.exe}"<. Auf diese Weise können
  beispielsweise verschiedene
  \TeX-Formate mit unterschiedlichen Suchpfaden arbeiten.
\item
  \texttt{\var{Wert}} darf alle Zeichen außer \texttt{\%} und \texttt{@}
  enthalten.
  Die Einschränkung der Werte auf bestimmte Programme über ein Suffix
  ist nicht zulässig. Ein \samp{;} in \texttt{\var{Wert}} wird unter
  \acro{UNIX} in \samp{:} umgewandelt. Dadurch ist die Verwendung der gleichen
  Konfigurationsdateien für \acro{UNIX} und \acro{DOS}/""Windows"=Systeme möglich.
\item
  Die Definitionen werden komplett eingelesen, bevor eine Expansion
  stattfindet. Dadurch können Sie die Variable schon vor Ihrer Definition
  referieren.
\end{itemize}

Der Ausschnitt einer Konfigurationsdatei demonstriert diese
Möglichkeiten.
\ifSingleColumn
\verbatiminput{examples/ex5.tex}
\else
Betrachten Sie Abbildung~\ref{fig:config-sample}.
\fi

% ..............................................................
\subsubsection{Expansion von Pfadkomponenten}\label{Path-expansion}

{\KPS} verwendet in Suchpfaden ähnliche Zeichen und Konstrukte wie
\acro{UNIX}-Shells. Beispielsweise wird die Definition
\verb|~$USER/{foo,bar}//baz| in alle Unterverzeichnisse von \file{foo} und
\file{bar} unterhalb vom Home-Verzeichnis von \dirname{\$USER} expandiert,
die eine Datei oder ein Unterverzeichnis namens \file{baz} enthalten. Der
Expansionsmechanismus wird im Folgenden erklärt.

% ..............................................................
\subsubsection{Expansion der Voreinstellungen}\label{Default-expansion}

Wenn der Suchpfad mit der höchsten Priorität (siehe hierzu ">Bestandteile von
Pfadkomponenten"< auf Seite~\pageref{Path-sources}) einen zusätzlichen
(vorangestellten, nachgestellten oder verdoppelten) Doppelpunkt enthält,
wird an dieser Stelle der Suchpfad eingefügt, der als nächstes in der
Hierarchie folgt. Auch bei diesem gilt dieselbe Regel. Wenn beispielsweise
die Umgebungsvariable

\begin{alltt}
> \Ucom{setenv TEXINPUTS /home/karl:}
\end{alltt}

gesetzt wird (hier: C-Shell) und in \file{texmf.cnf} die Variable
\code{TEXINPUTS} folgenden Wert erhält

\begin{alltt}
  .:\$TEXMF//tex
\end{alltt}

dann lautet der Suchpfad schließlich:

\begin{alltt}
  /home/karl:.:\$TEXMF//tex
\end{alltt}

Da es sinnlos wäre, denselben Pfad mehrfach einzufügen, wird die Ersetzung
nur einmal vorgenommen, und zwar in der Reihenfolge vorne, hinten und
Mitte. Mehrfach verdoppelte Doppelpunkte bleiben unverändert.

% ..............................................................
\subsubsection{Expansion geschweifter Klammern}

Die Expansion geschweifter Klammern ist zur Definition mehrerer
\TeX-Hierarchien sehr nützlich. Beispielsweise wird |v{a,b}w|
zu |vaw:vbw|. Verschachtelungen sind dabei erlaubt.
Diese Technik wird dazu benutzt, durch eine Zuweisung an
\code{\$TEXMF} verschiedene \TeX-Hierarchien einzuführen.
Als Beispiel finden Sie in \file{texmf.cnf} folgende Definition
(etwas gekürzt, tatsächlich ist es etwas komplexer):
%(Zeile 75): %%%% to be checked !!!! checked&corrected vrws 01.06.05

\begin{verbatim}
  TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFVAR,!!$TEXMFMAIN}
\end{verbatim}

Eine Anwendung wie

\begin{verbatim}
  TEXINPUTS = .;$TEXMF/tex//
\end{verbatim}
%$
führt dann dazu, dass erst im aktuellen Verzeichnis gesucht wird, dann
im gesamten Dateibaum \code{\$TEXMFHOME/tex} und \code{\$TEXMFLOCAL/tex}
(auf der Festplatte) und
schließlich im gesamten Dateibaum \dirname{\$TEXMFVAR/tex} sowie
\code{\$TEXMFMAIN/tex} (nur in der Datenbank \file{ls-R})
durchsucht wird. Dadurch kann man bequem
zwei parallel installierte \TeX-Hierarchien durchsuchen,
beispielsweise eine unveränderliche auf \CDROM/{\DVD} und eine dynamisch
angepasste auf Festplatte, in der neue Programmversionen und zusätzliche
Zeichensätze installiert werden. Durch die Verwendung der Variablen
\code{\$TEXMF} in allen Definitionen wird grundsätzlich zuerst der
neuere Dateibaum durchsucht.

% ..............................................................
\subsubsection{Expansion von Unterverzeichnissen}\label{Subdirectory-expansion}

Zwei oder mehrere aufeinanderfolgende Schrägstriche (\texttt{//}) in
einer Pfadkomponente, die auf einen Verzeichnisnamen \var{d} folgen,
werden expandiert zu allen Unterverzeichnissen von \var{d}. Dieser
Vorgang findet rekursiv statt, wobei erst alle Verzeichnisse auf
einer Ebene bearbeitet werden, dann deren Unterverzeichnisse, usw.
Auf den jeweiligen Ebenen ist nicht beeinflussbar, in welcher
Reihenfolge die Unterverzeichnisse bearbeitet werden.

Wenn nach den Schrägstrichen Namen angegeben werden, dann werden nur
Unterverzeichnisse mit passenden Namen in die Suche einbezogen.
Beispielsweise wird \samp{/a//b} in die Pfade \file{/a/1/b},
\file{/a/2/b}, \file{/a/1/1/b} usw. expandiert, aber nicht
zu \file{/a/b/c} oder \file{/a/1}.
(Jeweils vorausgesetzt, dass die Verzeichnisse existieren.)

Mehrere \samp{//}-Konstruktionen innerhalb einer Pfadkomponente
sind zulässig, allerdings nicht am Pfadanfang.

% ..............................................................
\subsubsection{Liste der Sonderzeichen und ihre Bedeutung: eine Zusammenfassung}

Die folgende Zusammenfassung fasst alle Sonderzeichen zusammen, die in den
\KPS"=Konfigurationsdateien auftreten können:

% ++++++++++++++++++++++++
\newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}}
% ++++++++++++++++++++++++

\begin{deflist}{\CODE{!!}} % noch schlechter Satz ??
\item[\CODE{:}]  Trennzeichen für Pfadkomponenten; als erstes
                    oder letztes Zeichen im Pfad bewirkt es die
                    Expansion der Voreinstellungen.
\item[\CODE{;}]  Trennzeichen für Pfadkomponenten für andere
                    Rechnerplattformen als \acro{UNIX} (Verwendung wie
		    ">\code{:}"<)
\item[\CODE{\$}]    Expansion von Variableninhalten
\item[\CODE{\string~}]   Home-Verzeichnis eines Benutzers (Tilde)
\item[\CODE{\char`\{...\char`\}}] Expansion geschweifter Klammern:
                    beispielsweise wird |a{1,2}b| zu |a1b:a2b|.
\item[\CODE{//}]    Expansion von Unterverzeichnissen: tritt niemals
                    am Anfang einer Pfadkomponente auf.
\item[\CODE{\%}]    Kommentar
\item[\CODE{\bs}]   Konkatenation mit Folgezeile(n)
\item[\CODE{!!}]    Einschränkung der Suche \emph{ausschließlich} auf die
                    Dateinamen"=Datenbank: Das Dateisystem wird \emph{nicht}
                    durchsucht!
\end{deflist}

% -------------------------------------------------------------
\subsection{Dateinamen"=Datenbanken}\label{Filename-database}

{\KPS} unternimmt etliche Anstrengungen, um den Zugriff auf Festplatte und
\CDROM/{\DVD} zur Suche nach Dateien zu reduzieren. Auf \TeX-Systemen mit
vielen Unterverzeichnissen kann die Suche in jedem möglichen Verzeichnis
nach einer bestimmten Datei eine lange Zeit in Anspruch nehmen, besonders
wenn einige Hundert Zeichensatzverzeichnisse durchforstet werden müssen.
Um dieses Problem abzumildern, benutzt {\KPS} eine Art Datenbankdatei
namens \file{ls-R}, die die Zuordnung von Dateinamen auf Verzeichnisse
enthält. Dadurch muss nicht jedesmal die Festplatte durchsucht werden.

Eine zweite Datenbank in der Datei \file{aliases} kann eine Zuordnung
zwischen den Namen in \file{ls-R} und weiteren Namen vornehmen und so
beispielsweise hilfreich bei der Umsetzung von \samp{8.3}-\acro{DOS}-Dateinamen
auf die ">echten"<, aussagekräftigen Dateinamen zur Seite stehen.

% ..............................................................
\subsubsection{Die \texttt{ls-R}-Datenbank}\label{ls-R}

Wie schon öfters erwähnt, muss die Dateinamen"=Datenbank in der Datei
\file{ls-R} gespeichert sein. Sie sollten eine solche Datenbank für jede
\TeX-Hierarchie (normalerweise in \code{\$TEXMF}) Ihres Systems anlegen.
Die meisten \TeX-Systeme arbeiten nur mit einer Hierarchie. {\KPS} sucht
die Datenbanken \file{ls-R} über den Pfad \code{TEXMFDBS}.

Es wird empfohlen, die Pflege der \code{ls-R}-Dateien dem mitgelieferten
Skript \cmdname{mktexlsr} zu überlassen. Dieses Skript wird automatisch von den
verschiedenen \samp{mktex*}-Skripten aufgerufen. Das Skript ruft
grob gesagt den Befehl

\begin{alltt}
cd /\var{your}/\var{texmf}/\var{root} && ls -LAR ./ >ls-R
\end{alltt}

auf, falls das Kommando \code{ls} Ihres Rechners eine Ausgabe im richtigen
Format liefert. (So wie das \acro{GNU}-\code{ls}.) Wenn Sie ganz sichergehen
wollen, dass die Datenbank immer auf dem neuesten Stand ist, sollten Sie sie
in regelmäßigen Abständen mit Hilfe eines \cmdname{crontab}-Eintrags
aktualisieren lassen.  Dadurch wird nach einer Installation eines
Pakets per Hand trotzdem sichergestellt, dass die Datenbank aktuell ist.

Wenn eine Datei nicht über die Datenbank gefunden wird, sucht
{\KPS} normalerweise auf der Festplatte weiter. Wenn eine Pfadkomponente
mit \samp{!!} beginnt, wird dagegen niemals die Festplatte durchsucht.

% ..............................................................
\subsubsection{\cmdname{kpsewhich}: Dateisuche}\label{Invoking-kpsewhich}

Mit dem Programm \cmdname{kpsewhich} können Sie unabhängig vom Aufruf
irgendeines \TeX-Programms nach Dateien in der \TeX-Hierarchie suchen
(als schnellere Alternative zu dem Befehl \cmdname{find}). Dies
wird von den verschiedenen \samp{mktex\dots}-Skripten bis zum
Exzess vorexerziert.

\begin{alltt}
> \Ucom{kpsewhich \var{option}{\dots} \var{filename}{\dots}}
\end{alltt}

Die Optionen werden entweder mit \samp{-} oder mit \samp{-{}-} eingeleitet.
Jede eindeutige Abkürzung ist zulässig.

Argumente der Kommandozeile, die keine Optionen darstellen, werden als
Dateinamen interpretiert. Für jeden Dateinamen wird der erste passende
Pfad gemeldet. Um eine Liste aller passenden Pfade zu erhalten, müssen Sie
das \acro{UNIX}-Kommando \cmdname{find} aufrufen.

Im Folgenden werden die wichtigen Optionen beschrieben.

\begin{description}
\item[\texttt{-{}-dpi=}\var{num}]\mbox{}\\
     Stellt die Auf"|lösung für die Suche nach Zeichensätzen
     (nur \file{.gf} oder \file{.pk}) auf \var{num}\,dpi. Alternativ
     kann die Option \optname{-D} (kommt von \dvips) benutzt werden.
     Voreinstellung ist~600.
\item[\texttt{-{}-format=}\var{name}]\mbox{}\\
     Setzt das Format zur Suche auf \var{name}. Per Voreinstellung
     versucht \cmdname{kpsewhich} das Format über den Dateinamen
     zu erschließen. Bei Formaten ohne zugeordnete Namens\-endung wie den
     zu {\MP} gehörenden Dateien und den Konfigurationsdateien zu
     {\dvips} müssen Sie den entsprechenden Namen so eingeben, wie er
     \KPS{} bekannt ist.
\item[\texttt{-{}-mode=}\var{string}]\mbox{}\\
     Setzt für die Zeichensatzsuche den Generierungsmodus (betrifft nur
     \file{.gf}- oder \file{.pk}-Dateien). Normalerweise werden alle
     Zeichensätze gemeldet.
\item[\texttt{-{}-must-exist}]\mbox{}\\
     Es wird versucht, die Dateien notfalls durch eine Suche auf der
     Festplatte zu finden. Normalerweise wird nur die \file{ls-R}-Datenbank
     konsultiert.
\item[\texttt{-{}-path=}\var{string}]\mbox{}\\
     Sucht entlang des angegebenen Pfads statt des Standardpfads,
     der auf Grund der Endung gewählt wird. Alle Expansionen sind
     zulässig. Bei Verwendung der Option \texttt{-{}-path} darf nicht
     die Option \texttt{-{}-format} angegeben werden.
\item[\texttt{-{}-progname=}\var{name}]\mbox{}\\
     Setzt den Programmnamen für die genauere Variablenspezifikation
     über \samp{.\var{Programmname}}. Voreinstellung ist \samp{kpsewhich}.
\item[\texttt{-{}-show-path=}\var{name}]\mbox{}\\
     Zeigt den Suchpfad für die angegebene Namens\-endung. Diese kann entweder
     als Namens\-endung (\samp{.pk}, \samp{.vf}, usw.) oder als Name (wie bei der
     Option \optname{-{}-format}) spezifiziert werden.
\item[\texttt{-{}-debug=}\var{num}]\mbox{}\\
     Legt den Umfang für die Fehlersuche fest.
\end{description}

% ..............................................................
\subsubsection{Anwendungsbeispiele}\label{SExamplesofuse}

Wir schauen uns nun die Funktionsweise von {\KPS} anhand einiger Beispiele an.

\begin{alltt}
> \Ucom{kpsewhich  article.cls}
   /usr/local/texmf-dist/tex/latex/base/article.cls
\end{alltt}

Wir suchen unter den \TeX-Quelldateien nach der Datei \file{article.cls}.
Da die Namens\-endung \samp{.cls} eindeutig ist, müssen wir den Typ
\samp{.tex} nicht angeben. Die \samp{texmf-dist}-Hierarchie enthält die
Datei im Unterverzeichnis \dirname{tex/latex/base}. Ähnlich bereiten
die folgenden Beispiele auf Grund eindeutiger Namens\-endungen keine Probleme.

\begin{alltt}
> \Ucom{kpsewhich array.sty}
   /usr/local/texmf-dist/tex/latex/tools/array.sty
> \Ucom{kpsewhich latin1.def}
   /usr/local/texmf-dist/tex/latex/base/latin1.def
> \Ucom{kpsewhich size10.clo}
   /usr/local/texmf-dist/tex/latex/base/size10.clo
> \Ucom{kpsewhich small2e.tex}
   /usr/local/texmf-dist/tex/latex/base/small2e.tex
> \Ucom{kpsewhich tugboat.bib}
   /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib
\end{alltt}

Beim letzten Beispiel handelt es sich um eine \BibTeX-Literaturdatenbank
für \textsl{TUGBoat}-Artikel.

\begin{alltt}
> \Ucom{kpsewhich cmr10.pk}
\end{alltt}

Zeichensatzdateien mit der Namens\-endung \samp{.pk} werden
von Anzeige- oder Druckaufbereitungsprogrammen wie {\dvips} und
\cmdname{xdvi} verwendet. Nachdem wir aufgrund der Voreinstellung keine \file{.pk}-Dateien verwenden,
sondern die \PS-\TypeI-Zeichensätze, die auf der \CDROM/{\DVD} enthalten
sind, wird auch keine \file{.pk}-Datei angezeigt.

\begin{alltt}
> \Ucom{kpsewhich wsuipa10.pk}
\ifSingleColumn   /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
\else /usr/local/texmf-var/fonts/pk/ljfour/public/
...                         wsuipa/wsuipa10.600pk
\fi\end{alltt}

Für diesen Zeichensatz (Teil der \acro{IPA}-Fonts%
\footnote{\acro{IPA}: International Phonetic Alphabet}
von der Universität von Washington) liegen noch keine
\TypeI-Umsetzungen vor und \samp{.pk}-Dateien müssen generiert werden. Da unser voreingestellter \MF-Modus
\samp{ljfour} eine Auf"|lösung von 600\,dpi besitzt,
finden wir (nachdem er schon einmal gebraucht und automatisch
erzeugt wurde) eine entsprechende Instanz dieses Zeichensatzes.

\begin{alltt}
> \Ucom{kpsewhich -dpi=300 wsuipa10.pk}
\end{alltt}

Durch die Angabe ">\optname{-dpi=300}"< interessieren wir uns nur
für Zeichensätze mit der Auf"|lösung 300\,dpi. Es wurde keiner gefunden.
Programme wie {\dvips} oder \cmdname{xdvi} lassen einen solchen fehlenden
Zeichensatz durch den Aufruf des Skripts \cmdname{mktexpk} mit entsprechenden
Parametern automatisch erzeugen.

Als nächstes wenden wir uns den Header- und Konfigurationsdateien
von {\dvips} zu.
Zunächst suchen wir nach der Konfiguration für die \TeX-Unterstützung,
dem Prolog \file{tex.pro}. Danach suchen wir die allgemeine Konfigurationsdatei
(\file{config.ps}) und schließlich die \PS-Zeichensatzzuordnungsdatei
\file{psfonts.map}. Dateien dieser Art haben seit der 2004er-Version der {\TL} ihre eigenen Suchpfade und einen neuen Aufbewahrungsort im \OnCD{texmf}-Baum. Da die Namens\-endung \samp{.ps} nicht eindeutig ist,
müssen wir den gewünschten Typ (\samp{dvips config})
für die Datei \file{config.ps} spezifizieren.

\begin{alltt}
> \Ucom{kpsewhich tex.pro}
   /usr/local/texmf/dvips/base/tex.pro
> \Ucom{kpsewhich --format="dvips config" config.ps}
   /usr/local/texmf/dvips/config/config.ps
> \Ucom{kpsewhich psfonts.map}
   /usr/local/texmf/fonts/map/dvips/updmap/psfonts.map
\end{alltt}

Jetzt suchen wir nach den Dateien für den \PS-Zeichensatz ">URW Times"<.
Nach dem Namensschema von Karl~Berry beginnen die Namen mit ">\texttt{utm}"<.
Zunächst suchen wir die Konfigurationsdatei, die den Namen der
Zeichensatzzuordnungsdatei enthält.

\begin{alltt}
> \Ucom{kpsewhich --format="dvips config" config.utm}
   /usr/local/texmf-dist/dvips/psnfss/config.utm
\end{alltt}

Diese Datei enthält folgende Anweisung:

\begin{alltt}
   p +utm.map
\end{alltt}

Die angegebene Datei \file{utm.map} wollen wir als nächstes suchen:

\begin{alltt}
> \Ucom{kpsewhich utm.map}
   /usr/local/texmf-dist/fonts/map/dvips/times/utm.map
\end{alltt}

Diese Zuordnungsdatei wird im Unterverzeichnis \file{urw} bei den
Hilfsdateien für {\dvips} gefunden. Sie enthält die Dateinamen der
\TypeI-\PS-Zeichensätze, die für URW Times benutzt werden. Ein
kleiner Auszug aus dieser Datei:

\begin{alltt}
  utmb8r  NimbusRomNo9L-Medi    ... <utmb8a.pfb
  utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
  utmr8r  NimbusRomNo9L-Regu    ... <utmr8a.pfb
  utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
  utmbo8r NimbusRomNo9L-Medi    ... <utmb8a.pfb
  utmro8r NimbusRomNo9L-Regu    ... <utmr8a.pfb
\end{alltt}

Wenn wir jetzt beispielsweise nach dem Zeichensatz Times Regular
(\file{utmr8a.pfb}) suchen, finden wir ihn im
Verzeichnis \OnCD{texmf} unter den \TypeI-Zeichensätzen:

\begin{alltt}
> \Ucom{kpsewhich utmr8a.pfb}
\ifSingleColumn   /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb
\else   /usr/local/texmf-dist/fonts/type1/
... urw/utm/utmr8a.pfb
\fi\end{alltt}

Diese Beispiele sollten deutlich gemacht haben, wie leicht bestimmte Dateien
im \TeX-Dateibaum gefunden werden können. Dies ist sehr wichtig, wenn Sie
den Verdacht haben, dass eine falsche Version einer Datei verwendet wird:
Sie lassen sich einfach die verwendete Datei von \cmdname{kpsewhich}
anzeigen.

% ..............................................................
\subsubsection{Fehlersuche}\label{Debugging}

Manchmal ist wichtig, bis ins Detail nachzuvollziehen, wie ein Programm eine
bestimmte Datei findet. Zu diesem Zweck bietet die \KPS-Bibliothek verschiedene
Stufen für den Umfang der Fehlersuche an.

\begin{itemize}
\item[\texttt{\ 1}] \code{stat}-Aufrufe (Überprüfung, ob Datei
     existiert); mit einer aktuellen \file{ls-R}-Datenbank sollten Sie fast
     keine Meldungen erhalten.
\item[\texttt{\ 2}] Zugriffe auf Suchlisten (wie \file{ls-R}-Datenbanken,
     Zuordnungsdateien (\texttt{.map}), Konfigurationsdateien)
\item[\texttt{\ 4}] Öffnen und Schließen von Dateien
\item[\texttt{\ 8}] Auf"|listen der voreingestellten Pfade für Extensionen
\item[\texttt{16}]  Verzeichnisliste für jede Pfadkomponente (nur bei Festplattenzugriff)
\item[\texttt{32}]  Suchaktionen nach Dateien
\end{itemize}

Durch die Angabe von \samp{-1} setzen Sie alle Stufen gleichzeitig.
Für eine effiziente Fehlersuche sollten Sie sich auf die wichtigsten
Ausgaben beschränken.

Für {\dvips} gibt es einen ähnlichen Mechanismus zur Erzeugung
von Analysemeldungen, um herauszufinden, warum bestimmte Dateien geöffnet
wurden bzw. wo vielleicht das Problem liegt, wenn Dateien nicht gefunden
werden.

Da fast alle Programme die \KPS-Bibliothek benutzen, können Sie die
gewünschte Stufe auch über die Umgebungsvariable \envname{KPATHSEA\_DEBUG}
einstellen, indem Sie einen der Werte oder eine additive Kombination
spezifizieren.

Anmerkung für Windows-Benutzer: Es ist nicht einfach, alle Meldungen in eine Datei umzulenken. Für die Fehlersuche 
jedoch ist die folgende (temporäre!) Vereinbarung sinnvoll: 

\indent\texttt{SET KPATHSEA\_DEBUG\_OUTPUT=err.log}

Wir betrachten als Beispiel eine kleine \LaTeX-Quelldatei mit dem Namen
\file{hello-world.tex} mit folgendem Inhalt:

\begin{verbatim}
  \documentclass{article}
  \begin{document}
  Hello World!
  \end{document}
\end{verbatim}

Diese Datei verwendet nur einen Zeichensatz, nämlich \file{cmr10}. Wir sehen uns
jetzt einmal genau an, wie {\dvips} die \PS-Datei erzeugt.
Da wir die \TypeI-Variante der Computer-Modern-Roman-Zeichensätze
verwenden wollen, haben wir die Option \optname{-Pcms} verwendet.

\begin{alltt}
> \Ucom{dvips -d4100 hello-world -Pcms -o}
\end{alltt}

Hier haben wir als Stufe zur Fehlersuche eine Kombination der Stufe~\code{4} von
{\dvips} (siehe \dvips-Handbuch,
\dirname{texmf/doc/html/dvips/dvips\_toc.html}?).
%\ifSingleColumn
%We get something
%like the following (we have rearranged the output for easier display):
%\begin{alltt}\small
%\input{examples/ex6.tex}
%\end{alltt}
%\else
Die Ausgabe sieht ungefähr so wie in
Abbildung~\ref{fig:dvipsdbga} dargestellt aus (die Ausgabe wurde für einen besseren Überblick
etwas umgestaltet).

\begin{figure*}[tp]
\centering
\input{examples/ex6a.tex}
\caption{Suche nach Konfigurationsdateien}\label{fig:dvipsdbga}

\bigskip

\input{examples/ex6b.tex}
\caption{Suche nach Prologdateien}\label{fig:dvipsdbgb}

\bigskip

\input{examples/ex6c.tex}
\caption{Suche nach Font-Dateien}\label{fig:dvipsdbgc}
\end{figure*}

Zunächst sucht {\dvips} (bzw. \KPS) seine Konfigurationsdateien,
nämlich \file{texmf.cnf} (das die Pfade der anderen Dateien enthält),
dann die Dateinamen"=Datenbank \file{ls-R} (zur Optimierung der Suche)
und die Datei \file{aliases}, mit deren Hilfe für eine Datei
mehrere Namen vereinbart werden können, z.\,B. um die kurzen
\samp{8.3}-\acro{DOS}-Namen mit aussagefähigen, langen Namen zu assoziieren.
Danach wird die allgemeine \dvips-Konfigurationsdatei
\file{config.ps}, anschließend die benutzerspezifische Konfigurationsdatei
\file{.dvipsrc} (wird hier \emph{nicht} gefunden) gesucht.
Als letztes sucht {\dvips} die Zuordnungsdatei für 
Computer-Modern-{\PS}"=Zeichensätze \file{config.cms} (bedingt durch die
Option \optname{-Pcms} beim Aufruf von \dvips). Diese
Datei enthält die Dateinamen der Listen, die die Zuordnung zwischen
Dateinamen und Zeichensatznamen herstellen.

\begin{alltt}
> \Ucom{more /usr/local/texmf/dvips/cms/config.cms}
   p +ams.map
   p +cms.map
   p +cmbkm.map
   p +amsbkm.map
\end{alltt}

{\dvips} versucht, diese Dateien und zusätzlich die
allgemeine Zeichensatzzuordnungstabelle \file{psfonts.map} zu
laden, die immer konsultiert wird; der letzte Teil von
Abschnitt~\ref{SExamplesofuse} erklärt diese Tabellen genauer.

Jetzt erfolgt die normale Startmeldung von \dvips:

\begin{alltt}\ifSingleColumn
dvips(k) 5.94a
kpathsea version
Copyright (C) 2003 Radical Eye Software.
...
\else\small{}dvips(k) 5.94a
kpathsea version
Copyright (C) 2003 Radical Eye Software.
...
\fi\end{alltt}% decided to accept slight overrun in tub case
\ifSingleColumn
Danach wird nach \file{texc.pro} gesucht:

\begin{alltt}\small
kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
  path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
       ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
\end{alltt}
\else
Danach wird nach \file{texc.pro} gesucht (siehe Abbildung~\ref{fig:dvipsdbgb}).
\fi
Dann gibt {\dvips} Datum und Uhrzeit aus und meldet den Dateinamen
der erzeugten \PS-Datei \file{hello-world.ps}. Jetzt wird die
Zeichensatzdatei \file{cmr10} benötigt, die {\dvips} als
">resident"< meldet.

\enlargethispage{1ex}
\begin{alltt}\small
TeX output 1998.02.26:1204' -> hello-world.ps
Defining font () cmr10 at 10.0pt
Font cmr10 <CMR10> is resident.
\end{alltt}

Es geht weiter mit \file{cmr10.tfm} und einigen weiteren Prologdateien,
deren Ausgaben wir hier weglassen. Letztlich wird die \TypeI-Zeichensatzdatei
\file{cmr10.pfb} gesucht (und gefunden) und in die Ausgabedatei integriert
(siehe letzte Zeile).

\begin{alltt}\small
kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
  path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
       /var/tex/fonts/tfm//).
kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
   ...
<texps.pro>
kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
  path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
       ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
<cmr10.pfb>[1]
\end{alltt}

% -------------------------------------------------------------
\subsection{Einstellungen zur Laufzeit}

Zu den willkommenen Erweiterungen von {\Webc} zählt die Möglichkeit,
zur Laufzeit einige Speicher"-größen über die Datei \file{texmf.cnf} anpassen
zu können (insbesondere die Größe einiger Stacks). Eine ausführliche Liste
der veränderbaren Parameter finden Sie in der Datei \file{texmf.cnf}.
Die wichtigsten Werte sind:

\begin{description}
\item[\texttt{main\_memory}]\mbox{}\\
     Arbeitsspeicher für \TeX, {\MF} und {\MP} in Worten: Für jede Einstellung
     muss eine eigene Format-Datei erstellt werden. Allerdings können Sie
     mehrere Versionen von {\TeX} unter verschiedenen Namen erzeugen und
     in der Konfigurationsdatei jeweils eigene Einträge vorsehen. Hier gibt
     es ein Monster-{\TeX} namens \samp{hugetex} mit der zugehörigen Format-Datei 
     \file{hugetex.fmt}, wobei der spezielle Wert der 
     Variablen \texttt{main\_memory} dann 
     aus der Datei \file{texmf.cnf} gelesen wird.
\item[\texttt{extra\_mem\_bot}]\mbox{}\\
     Extraspeicher für ">große"< \TeX-Datenstrukturen wie Boxen, Glue,
     Breakpoints, usw.: Besonders bei Anwendung von {\PiCTeX} sollte dieser
     Wert erhöht werden.
\item[\texttt{font\_mem\_size}]\mbox{}\\
     Anzahl der Worte für Speicherung von Zeichensatzinformationen: Entspricht
     ungefähr dem Speicherbedarf der gelesenen \acro{TFM}-Dateien.
\item[\texttt{hash\_extra}]\mbox{}\\
     Zusätzlicher Platz für Suchlisten: In der Hauptliste können
     ca. 10000~Einträge verwaltet werden. Bei einem Buch mit vielen Querverweisen
     reicht dieser Platz unter Umständen nicht aus.
     Die Voreinstellung für \texttt{hash\_extra} ist \texttt{50000}.
\end{description}

Natürlich sind diese Parameter kein Ersatz für eine wirklich dynamische
Speicherverwaltung. Mit der gegenwärtigen Version von {\TeX} ist dieses
Konzept aber nur extrem schwer zu implementieren; darum stellt dieses
Verfahren eine praktikable Lösung dar.

\begin{comment}
%\clearpage
% ==============================================================
\section{Installation von {\TeX} auf einer neuen \acro{UNIX}-Plattform}

Wenn Sie eine Rechnerplattform einsetzen, für die wir keine Binärdateien
zur Verfügung gestellt haben, müssen Sie {\TeX} und die zugehörigen
Programme mit Hilfe der Quell-Codes selbst übersetzen. Das ist gar nicht so
schwer, wie es klingt. Alles, was Sie brauchen, finden Sie auf der {\DVD}
im Verzeichnis \texttt{source}.

Zunächst sollten Sie jedoch die von {\TeX} benötigten Dateien durch
eine Installation ohne Binärdateien auf die Festplatte kopieren bzw.
durch ">Mounten"< der {\DVD} verfügbar machen.

% -------------------------------------------------------------
\subsection{Voraussetzungen}

Zum Übersetzen von {\TeX} und allen weiteren benötigten
Programmen benötigen Sie ca. 100\,MB Festplattenkapazität.
Dazu kommen ein \acro{ANSI}-C-Compiler, \cmdname{make} sowie
ein Scanner- und Parser-Generator. Die \acro{GNU}-Programme
(\cmdname{gcc}, \acro{GNU}-\cmdname{make}, \cmdname{m4},
\cmdname{flex} und \cmdname{bison}) sind praxiserprobt
und auf den meisten Plattformen verfügbar.  Eventuell können
Sie auch andere C-Compiler oder \cmdname{make}-Programme einsetzen,
doch dann sollten Sie sich wirklich gut mit Ihrem System auskennen,
wenn es Schwierigkeiten während des Übersetzungsprozesses gibt.
Der Befehl \cmdname{uname} muss einen gültigen Namen liefern.

% -------------------------------------------------------------
\subsection{Konfiguration}

\begin{itemize}
\item Beginnen Sie mit einer ganz normalen \TL-Installation auf
Festplatte (siehe Abschnitt~\ref{sec:UNIX-install-disk} auf
Seite~\pageref{sec:UNIX-install-disk}). Das Installieren der
fertigen Binaries können Sie getrost überspringen.

\item Dann entpacken Sie das komprimierte Archiv (\cmdname{tar}) in
\dirname{source} auf Ihre Festplatte und wechseln in dieses Verzeichnis.

\item Legen Sie einen Pfad fest, unter dem das \TeX-System
installiert werden soll. Natürlich sollte das derselbe Pfad sein,
den Sie schon zum Kopieren der Daten verwendet haben
(z.\,B. \dirname{/usr/local} oder \dirname{/usr/local/TeX}).
\end{itemize}

Die automatische Systemerkennung und -anpassung wird durch
\textsf{configure} mit folgendem Aufruf gestartet:

\begin{alltt}
> \Ucom{./configure -prefix=/usr/local/TeX}
\end{alltt}

Bei der Option \optname{prefix} geben Sie das Verzeichnis an, in dem sich die
bereits kopierten \TL-Dateien befinden;
dieses Verzeichnis wird weiter strukturiert (\dirname{\$TEXDIR}
ist dabei das Installationsverzeichnis):


\begin{tabular}{>{\ttfamily}ll@{}}
  \dirname{\$TEXDIR/man}               & Anleitungen im
                                        \acro{UNIX}-\cmdname{man}-Format\\
  \dirname{\$TEXDIR/share/texmf}       & \TeX-Daten mit Zeichensätzen,
                                        Makros, usw.\\
  \dirname{\$TEXDIR/info}              & Anleitungen im
                                        \acro{GNU}-\cmdname{info}-Format\\
  \dirname{\$TEXDIR/bin/\$PLATFORM}     & ausführbare Programme\\
\end{tabular}
%$

Wenn Sie wollen, können Sie ">\dirname{share/}"< als Namensbestandteil
von \OnCD{texmf} weglassen, da sowohl
\dirname{\$TEXDIR/share/texmf} als auch \dirname{\$TEXDIR/texmf}
automatisch von \cmdname{configure} erkannt werden. Sollten Sie ein anderes
Verzeichnis vorziehen, müssen Sie dieses \cmdname{configure} mit dem
Kommandozeilenparameter \optname{-{}-datadir}  mitteilen.

Wenn Sie die erkannte Plattform nicht als \dirname{\$PLATFORM} im
Pfad der ausführbaren Programme haben wollen, sondern z.\,B.
direkt in \dirname{\$TEXDIR/bin} installieren wollen, verwenden Sie
die Option \optname{-{}-disable-multiplatform}.

Zum Weglassen spezieller \TeX-Systeme wie {\OMEGA} oder {\eTeX} gibt
es eine Reihe von Optionen, die Sie durch die Eingabe von
\samp{./configure --help} angezeigt bekommen.

% -------------------------------------------------------------
\subsection{Aufruf von \cmdname{make}}

Vergewissern Sie sich, dass die Shell-Variable \envname{noclobber} nicht
gesetzt ist und geben

\begin{alltt}
> \Ucom{make world}
\end{alltt}

ein. Jetzt können Sie sich entspannt zurücklehnen oder wie ein
{\TeX}ie sagt: |\relax|.

Eine gute Idee ist auch das Speichern der Meldungen beim
Übersetzen durch das Anlegen eines Protokolls:

\begin{alltt}
> \Ucom{sh -c "make world >world.log 2>\&1" \&}
\end{alltt}

Nehmen Sie nicht fälschlicherweise nach dem Durchlauf von \cmdname{make}
an, dass alles gut gegangen ist, sondern vergewissern sich durch eine
Kontrolle des Protokolls. (\acro{GNU} \cmdname{make} zeigt Fehler
z.\,B. immer mit der Zeichenkette ">\texttt{***}"< an.)
Außerdem sollten Sie sich vergewissern, dass alle ausführbaren
Programme auch erzeugt wurden:

\begin{alltt}
> \Ucom{cd \var{TEXDIR}/bin/\var{archname}}
> \Ucom{ls | wc}
\end{alltt}

Das Ergebnis sollte über 200 liegen (Sie können die exakte Zahl
mit der Anzahl der lauf"|fähigen Programme [Binaries] im Verzeichnis \OnCD{bin} vergleichen).
Der Aufruf \samp{make~world} ist übrigens äquivalent zu
\samp{make~all~install~strip}.

Wenn für den Aufruf von \samp{make~install} besondere
Systemverwalterrechte notwendig sein sollten, können Sie die
Anweisung \samp{make~world} auch in zwei Durchgängen absetzen:

\begin{alltt}
> \Ucom{make all}
> \Ucom{su}
> \Ucom{make install strip}
\end{alltt}

Nachdem Sie Ihre Binaries installiert haben, sollten Sie die normalen
Installationsnacharbeiten durchführen, die im Abschnitt~\ref{sec:postinstall}
auf Seite~\pageref{sec:postinstall} beschrieben sind.

Wenn Sie lauf"|fähige Programme erstellt haben und diese Anderen zur Verfügung stellen wollen, sollten Sie uns kontaktieren. Wir würden uns freuen, sie auf den \TL-\acro{WWW}-Seiten anzubieten.
\end{comment}

% ==============================================================
\section{Danksagungen}

Die {\TL} ist eine gemeinsame Arbeit faktisch aller {\TeX} Users
Groups. 

Die Entwicklung des vorliegende \TL-Releases wurde von Sebastian~Rahtz und Karl~Berry geleitet;
die übrigen Haupt-Mitarbeiter sind im Folgenden aufgelistet.

\begin{itemize}
\item Den englisch-, deutsch-, niederländisch-, und polnisch-sprachigen
      \TeX-Anwendervereinigungen (\acro{TUG}, \acro{DANTE} e.V., 
      \acro{NTG}, and \acro{GUST}),
      die zusammen die tecnische und administrative Infrastruktur
      zur Verfügung stellen. Wir würden uns freuen wenn Sie bei einer der
      Anwendervereinigungen Mitglied werden.
\item Dem \acro{CTAN} Team, das die \TL{}-CD-Images und die Infrastruktur
      für Paketupdates zur Verfügung stellt, von denen \TL{} abhängt.
\item Peter Breitenlohner und das \eTeX\-Team für den stabilen Grundstock zu {\TeX}s Zukunft;
\item Thomas~Esser, der mit dem exzellenten {\teTeX} die Basis
      für dieses {\TL} schuf und dessen ständige Hilfe das Resultat
      deutlich verbessert hat;
\item Michel~Goossens, als Coautor der englischen Original-Dokumentation;
\item Eitan~Gurari, mit dessen {\TeX4ht} die \HTML-Version dieser
      Anleitung erstellt wurde und der unermüdlich daran gearbeitet
      hat, es auf Zuruf zu verbessern;
\item Hans Hagen, der den größten Teil der notwendigen Tests durchführte und das \ConTeXt-Format an das \TL-System 
      anpasste;
\item \Thanh, Martin~Schröder und das \pdfTeX-Team, die die Arbeiten zur Erweiterung der Möglichkeiten von 
      {\TeX} fortgesetzt haben;
\item Taco Hoekwater, für neue Entwicklungen von MetaPost und \TeX.
\item Pawe{\l} Jackowski für das Installationsprogramm \cmdname{tlpm} für
      Windows,
      Tomasz {\L}uczak für \cmdname{tlpmgui};

\item Akira Kakuto, für Windows-Programme im Rahmen seines
      \acro{W32TEX} Distribution
      (\url{http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/}).

\item Jonathan Kew und seinem Arbeitgeber \acro{SIL}, für die
      Neuentwicklung von Xe\TeX{} und die Zeit und Mühe es in \TL{} zu
      integrieren.

\item Reinhard Kotucha, für die Unterstützung beim Update der Pakete in
      \TL{}, für seine Windows-Untersuchungen, für das \texttt{getnonfreefonts} 
      Script, und vieles mehr.

\item Petr~Olsak, der das tschechische und slowakische Material sehr sorgfältig er- und überarbeitet hat;

\item Fabrice~Popineau für die ursprünglichen Windows-Programme von {\TL};

\item Norbert Preining, für die Hilfe mit \TL{}-Infrastruktur und 
      Paket-Updates, für die Koordination der Debian Version von  \TL{}
      (zusammen mit Frank Küster), und die daraus resultierenden 
      Verbesserungsvorschläge.

\item Staszek~Wawrykiewicz, der Haupttester für alles, was mit {\TeX} zusammen hängt, Koordinator der polnischen 
      Beiträge, Windows-Installation und mehr;
\item Olaf~Weber für die Geduld beim Zusammenpuzzeln und Pflegen
      von \Webc, von dem alles Andere abhängt;
\item Gerben~Wierda für das Erstellen und Pflegen des \MacOSX-Teils und für viele Integrations- und Testarbeiten;  
\item Graham~Williams, dessen Arbeit das Makro- und Paketverzeichnis möglich gemacht hat.
\end{itemize}

\textbf{Lauf"|fähige Programme:}

\begin{itemize*}
\item Tigran~Aivazian (\pkgname{x86\_64-linux}),
\item Manfred~Lotz (\pkgname{i386-freebsd}),
\item Fabrice~Popineau (\pkgname{win32}),
\item Norbert~Preining (\pkgname{alpha-linux}),
\item Vladimir~Volovich (\pkgname{powerpc-aix}, \pkgname{sparc64-linux}) und
      \pkgname{sparc-linux},
\item Staszek~Wawrykiewicz (\pkgname{i386-linux}),
\item Olaf~Weber (\pkgname{mips-irix}),
\item Gerben~Wierda (\pkgname{i386-darwin}, \pkgname{powerpc-darwin})
\end{itemize*}

\textbf{Dokumentation und Anpassung der Übersetzungen:}

\begin{itemize*}
\item Karl~Berry (Englisch), 
\item Daniel~Flipo \& Fabrice~Popineau (Französisch),
\item Klaus Höppner \& Hartmut~Henkel (Deutsch) mit Unterstützung von
  Günter Partosch, Holger Horn, Wolfgang Engelmann und Heiko Oberdiek,
\item Petr~Sojka \& Jan~Busa (Tschechisch/""Slowakisch),
\item Boris~Veytsman (Russisch),
\item Staszek~Wawrykiewicz (Polnisch).
\end{itemize*}

Natürlich haben wir am meisten Donald~Knuth zu danken, einmal dafür, dass er {\TeX} erfand und dann dafür, dass er es 
der Welt schenkte.

% -------------------------------------------------------------
\section{Geschichtliches}\label{sec:history}

Diese Ausgabe der {\TL} ist in Zusammenarbeit der {\TUG} (\acro{TUG}), der 
\UKTUG, der französischen \TeX-Vereinigung GUTenberg
und der deutschsprachigen \TeX-Anwendervereinigung (DANTE e.\,V.)
unter Mithilfe der niederländischen, tschechischen/""slowakischen,
indischen, polnischen und russischen \TeX-Benutzergruppen
entstanden.

\subsection{Vergangenheit}

Die niederländische \TeX-Benutzergruppe hatte Ende 1993 mit der
Produktion der 4All\TeX-{\CDROM} für \acro{MS-DOS} die Diskussion angeregt,
eine einzige {\CDROM} für alle Rechnersysteme zu entwickeln. Zum
damaligen Zeitpunkt war dieses Ziel zu hoch gesteckt, doch immerhin
entstand aus dieser Diskussion nicht nur die sehr erfolgreiche
4All\TeX-{\CDROM}, sondern auch die \acro{TUG}-Arbeitsgruppe zur Definition
der {\TeX} Directory Structure \TDS, die die zur Arbeit mit {\TeX}
notwendigen und hilfreichen Dateien in eine konsistente und
handhabbare Verzeichnisstruktur einbettet. Das ">Final~Draft"<-Dokument,
das diese Verzeichnisstruktur festlegt, wurde in der Dezember-Ausgabe
1995 der TUGBoat veröffentlicht. Schon frühzeitig war den Beteiligten
klar, dass eine {\CDROM} auf der Basis der {\TDS} sehr zu begrüßen wäre.
Die \TL-{\CDROM} war das direkte Resultat der Beratungen der
\TDS-Arbeitsgruppe. Außerdem hat der Erfolg der 4All\TeX-{\CDROM}
klargemacht, dass ein ähnliches System auch für \acro{UNIX}-Benutzer eine
Erleichterung darstellen würde. Dies war der zweite Beweggrund für
die \TL-\CDROM.

Im Herbst 1995 wurde das Projekt, eine \TDS-basierte \acro{UNIX}-{\CDROM}
zu entwickeln, in Angriff genommen. Sehr schnell stießen die
Verantwortlichen auf das \teTeX-System von Thomas~Esser als
idealen Ausgangspunkt für diese Arbeit, weil es verschiedene
Rechnerplattformen unterstützte und für die Arbeit mit verschiedenen
Dateisystemen vorgesehen war. Anfang 1996 wurde in Zusammenarbeit
mit Thomas~Esser ernsthaft mit der Arbeit begonnen und im Mai~1996
die erste Ausgabe der {\CDROM} veröffentlicht.

Anfang 1997 stellte
Karl~Berry eine neue Version seines \Webc-\TeX-Systems vor, das
schon nahezu alle Ausstattungsmerkmale aufwies, die Thomas~Esser
mit {\teTeX} verwirklicht hatte. Die \acro{TUG} entschied sich daraufhin,
die zweite Version der {\CDROM} auf der Basis von {\Webc} unter
Verwendung des Installations-Skripts \cmdname{texconfig} aus dem
\teTeX-Paket zu entwickeln.

Die dritte Ausgabe basierte auf der
inzwischen von Olaf~Weber gepflegten und weiter entwickelten
{\Webc}~Version~7.2; {\TL} unterstützte fast alle Eigenschaften
der zur selben Zeit entstandenen neuen Version von \teTeX.

Die vierte Ausgabe folgte demselben Schema, indem ihr neue
Versionen von {\teTeX} und {\Webc}~(7.5) zugrunde lagen.
Fast die gesamte {\CDROM} wurde einer kritischen Überprüfung
unterzogen, wobei besonders darauf geachtet wurde, dass doppelte
Dateien entfernt wurden und die Einordnung der Pakete konsistent
erfolgte. Zudem enthielt diese Ausgabe ein komplettes Windows-Setup.

Für die fünfte Ausgabe im März~2000 wurden wiederum große Teile der
{\CDROM} ersetzt, wobei Hunderte von überarbeiteten Paketen aufgenommen
wurden. {\OMEGA}, {\pdfTeX} und Teile der \TeX-Support-Programme (hier
insbesondere \cmdname{xdvi}, \cmdname{dvips} und \cmdname{tex4ht})
lagen in neuer Version vor.
Die Hauptänderung bei der \TL\,5 betraf die \samp{non-free}-Software.
Alles auf dieser {\CDROM} war nun in Übereinstimmung mit den \emph{Debian
Free Software Guidelines} (\url{http://www.debian.org/intro/free}).
Wir haben unser Bestes versucht, die Lizenzbedingungen aller Pakete
zu überprüfen, sind aber dankbar, wenn wir auf Fehler hingewiesen werden.

Die sechste Ausgabe der {\TL} vom Juli/August~2001
enthielt die neuesten Versionen aller Pakete und Programme.
Das neue Installationskonzept stellte die größte Änderung dar:
Der Benutzer konnte nun viel genauer
gewünschte bzw. nicht erwünschte Sammlungen
und Pakete auswählen. Dabei wurden die sprachspezifischen Sammlungen
komplett überarbeitet, so dass sie jetzt automatisch nicht nur
Makros, Fonts usw. installierten, sondern zusätzlich die notwendigen
Einträge in \file{language.dat} vornahmen.

Die siebte Ausgabe vom Mai~2002 enthält als größte
Änderungen {\MacOSX} und wieder unzählige Updates aller Pakete und Programme.
Ein wesentliches Ziel war zudem die Wiedererstellung einer gemeinsamen
Quelle mit {\teTeX}, um das Auseinanderlaufen seit \TL\,5 und \TL\,6
zu korrigieren.

\subsection{2003}

Im Jahr 2003 war die Flut von Updates und neuen Paketen so groß geworden,
dass wir feststellen mussten: ">{\TL} passt nicht mehr auf eine einzelne
\CDROM"<. Und so wurde sie in drei verschiedene Distributionen aufgeteilt
(siehe Abschnitt~\ref{sec:multiple-dist} auf Seite~\pageref{sec:multiple-dist}).
Des Weiteren:

\begin{itemize}
\item Auf Wunsch des \LaTeX-Teams wurde der Standard für \cmdname{latex}
      und \cmdname{pdflatex} verändert; beide benutzen nun {\eTeX} als Basis
      (siehe Seite~\pageref{text:etex}).
\item Die neuen ">Latin Modern Fonts"< wurden aufgenommen (und werden
      zur Benutzung empfohlen).
\item Der Support für Alpha-\acro{OSF} wurde aufgegeben (den
      \acro{HPUX}-Support hatte es schon zuvor ereilt), da
      niemand mehr in der Lage war, neue Binaries zu kompilieren.
\item Das Setup für Windows wurde grundlegend überarbeitet.
      Zum ersten Mal wurde eine integrierte Umgebung eingeführt, 
      die auf \cmdname{XEmacs} basiert.
\item Wichtige Hilfsprogramme für Windows (Perl, Ghost\-script,
      Image\-Magick, Ispell) werden nun im \TL-Verzeichnis
      installiert.
\item Die von \cmdname{dvips}, \cmdname{dvipdfm} und \cmdname{pdftex}
      benutzten Font-Mapfiles werden vom neuen Programm
      \cmdname{updmap} generiert und in \dirname{texmf/fonts/map}
      installiert.
\item \TeX, {\MF} und {\MP} geben nun die meisten 8"~Bit-Input"~Zeichen (Position 32 und oberhalb) unverändert
      aus in (\verb|\write|)-Files, Logfiles und auf dem Terminal.
      Das bedeutet, dass sie \emph{nicht} mit der \verb|^^|-Notierung
      übersetzt ausgegeben werden. Auf der \TL\,7 war diese
      Übersetzung abhängig von der \cmdname{locale}-Einstellung des
      Systems; nun beeinflussen \cmdname{locale}-Einstellung nicht
      {\TeX}s Programmverhalten. Falls Sie aus irgendwelchen
      Gründen die \verb|^^|-Ausgabe benötigen, müssen Sie in Ihrem System
      die Datei \file{texmf/web2c/cp8bit.tcx} umbenennen
      (zukünftige Versionen werden eine sauberere Schnittstelle zur
      Kontrolle dieses Verhaltens anbieten).
\item Die Dokumentation wurde grundlegend überarbeitet.
\item Zum Abschluss einigten wir uns auf eine neue Edition-Nummerierung.
      Ab diesem Jahr trägt die {\TL} statt einer fortlaufenden Nummer
      die Jahreszahl: \TL~2003.
\end{itemize}

\subsection{2004}

\begin{itemize}
\item Wenn Sie lokal installierte Zeichensätze mit ihren eigenen \filename{.map}- oder (weniger wahrscheinlich) 
      \filename{.enc}-Dateien benutzen, müssen Sie möglicherweise diese Dateien verschieben.

      Nach den \filename{.map}-Dateien wird jetzt in den \dirname{fonts/map}-Unterverzeichnissen im 
      \envname{TEXFONTMAPS}-Pfad gesucht (in jedem \filename{texmf}-Baum).
      Gleichzeitig werden \filename{.enc}-Dateien jetzt in den \dirname{fonts/enc}-Unterverzeichnissen entlang des 
      \envname{ENCFONTS}-Pfads gesucht. Das Programm \cmdname{updmap} versucht, bei problematischen Dateien zu warnen.

      Informationen darüber, wie das gehandhabt wird, und zusätzliche Informationen finden Sie unter 
      \url{http://tug.org/texlive/mapenc.html}.

\item Die \TK\ wurde für all diejenigen, die diese Implementierung {\Webc} vorziehen, um eine \MIKTEX-basierte und 
      installierbare {\CDROM} erweitert. Siehe dazu auch Abschnitt~\ref{sec:struct-tl} auf 
      Seite~\pageref{sec:struct-tl}.

\item In der {\TL} wurde der umfangreiche \dirname{texmf}-Baum früherer Versionen durch drei Teilbäume ersetzt: 
      \OnCD{texmf}, \OnCD{texmf-dist} und \OnCD{texmf-doc}. Siehe dazu Abschnitt~\ref{sec:tld} auf 
      Seite~\pageref{sec:tld} und die \filename{README}-Dateien in den drei Zweigen.

\item Alle \TeX-relevanten Eingabedateien sind jetzt in den \dirname{tex}-Unterverzeichnissen der 
      \dirname{texmf*}-Bäume zusammengefasst und nicht mehr in den parallelen Verzeichnissen \dirname{tex}, 
      \dirname{etex}, \dirname{pdftex}, \dirname{pdfetex}, usw.  Siehe dazu 
      \CDref{texmf-doc/doc/english/tds/tds.html\#Extensions}{\texttt{texmf-doc/doc/english/tds/tds.html\#Extensions}}.

\item Hilfs-Skripte, die der Anwender nicht selbst aufruft, werden jetzt in den \mbox{neuen}
      \dirname{scripts}-Unterverzeichnissen der \dirname{texmf*}-Bäume aufbewahrt. Nach ihnen wird per 
      \samp{kpsewhich -format=texmfscripts} gesucht. Wenn Sie Programme einsetzen, die solche Skripte aufrufen, müssen 
      sie angepasst werden. Siehe dazu \CDref{texmf-doc/doc/english/tds/tds.html\#Scripts}
{\texttt{texmf-doc/doc/english/tds/tds.html\#Scripts}}.

\item (Fast) alle Formate interpretieren -- an Stelle einer Übersetzung durch die \verb|^^|-Notation -- mittels 
      des ">translation files"< \filename{cp227.tcx} die meisten Zeichen als direkt ausgebbar. Insbesondere werden 
      die Zeichen an den Positionen 32--256, zusätzlich \acro{TAB}, \acro{VT} (vertical tab; vertikaler Tab) und 
      \acro{FF} (form feed; Seitenvorschub), als druckbar angesehen und daher nicht übersetzt. Ausnahmen sind 
      \plainTeX, bei dem nur die Zeichen an den Positionen 32--127 druckbar sind, {\ConTeXt} (mit druckbaren Zeichen an 
      den Positionen 0--255) und die \OMEGA-verwandten Formate. Dieses voreingestellte Verhalten ist (fast) identisch 
      mit dem in \TL\,2003; es ist aber jetzt klarer und mit umfangreicheren Anpassungsmöglichkeiten implementiert. 
      Siehe dazu \CDref{texmf/doc/web2c/web2c.html\#TCX-files}
{\texttt{texmf/doc/web2c/web2c.html\#TCX-files}}.

      \textbf{Anmerkung:} Da {\TeX} byte-orientiert ist, können bei einer Unicode-Eingabe (2-Byte-Zeichen) im Kontext 
      von Fehlermeldungen Folgen von 1-Byte-Zeichen ausgegeben werden.

\item \cmdname{pdfetex} ist jetzt die voreingestellte ">Engine"< für alle Formate mit Ausnahme von 
      \mbox{(plain-)\cmdname{tex}} selbst (natürlich generiert es \dvi-Code, wenn es als \cmdname{latex}, usw. 
      aufgerufen wird.).  Das bedeutet unter vielen anderen Dingen, dass die mikrotypographischen Fähigkeiten von 
      \cmdname{pdftex} 
      wie auch die Erweiterungen von {\eTeX} in \LaTeX, \ConTeXt usw. zur Verfügung stehen 
      (\OnCD{texmf-dist/doc/etex/base/}).

      Das bedeutet, dass es \emph{wichtiger denn je} ist, das Paket \pkgname{ifpdf} zu benutzen (es arbeitet sowohl mit 
      {\plainTeX} als auch mit \LaTeX), da der einfache Test, ob \cs{pdfoutput} oder ein anderer \TeX-Grundbefehl 
      (primitive) definiert ist, nicht verlässlich genug ist für die Entscheidung, ob eine \pdf-Ausgabe erzeugt wird. 
      Wir haben das rückwärts-kompatibel gemacht, so gut wir das dieses Jahr konnten; nächstes Jahr aber soll 
      \cs{pdfoutput} so beschaffen sein, dass dieser Befehl auch dann definiert ist, wenn {\dvi}-Code erzeugt wird.

\item \pdfTeX\ (\url{http://pdftex.org/}) hat viele neue Besonderheiten:
      \begin{itemize}
      \item Die Befehle \cs{pdfmapfile} und \cs{pdfmapline} ermöglichen einen Font"~Map-Support innerhalb eines 
            Dokuments.
      \item Mikrotypografische Zeichensatz-Expansion (font expansion) kann jetzt viel leichter benutzt werden 
            \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html}.
      \item Alle Parameter, die früher in der speziellen Konfigurationsdatei \filename{pdftex.cfg} definiert wurden, 
            müssen jetzt mit Hilfe von \pdfTeX-Grundbefehlen gesetzt werden, typischerweise in 
            \filename{pdftexconfig.tex}; die Konfigurationsdatei \filename{pdftex.cfg} wird nicht länger unterstützt. 
            Jede schon bestehende Format-Datei (\filename{.fmt}) muss neu erstellt werden, wenn 
            \filename{pdftexconfig.tex} geändert wird.
      \item Für zusätzliche Informationen siehe das \pdfTeX-Handbuch: \OnCD{texmf/doc/pdftex/manual}.
      \end{itemize}

\item Der Grundbefehl \cs{input} in \cmdname{tex} (\cmdname{mf} und \cmdname{mpost}) akzeptiert jetzt doppelte 
      Anführungszeichen und andere Spezialzeichen. Typische Beispiele:

\begin{verbatim}
\input "filename with spaces"   % plain
\input{"filename with spaces"}  % latex
\end{verbatim}

      Für zusätzliche Informationen siehe das \Webc-Handbuch: \OnCD{texmf/doc/web2c}.

\item enc\TeX\ wird jetzt in {\Webc} und damit auch in allen \TeX-Programmen unterstützt. Dazu wird \emph{beim 
      Generieren neuer Formate} die Option \optname{-enc} benutzt. enc\TeX\ unterstützt allgemein die Umkodierung der 
      Ein- und Ausgabe und ermöglicht eine volle Unicode-Unterstützung (in \acro{UTF}-8). 
      Siehe \OnCD{texmf-dist/doc/generic/enctex/} und \url{http://www.olsak.net/enctex.html}.

\item Aleph (\ensuremath{\aleph}), eine neue ">Engine"<, die {\eTeX} und {\OMEGA} vereinigt, ist verfügbar. Ein bisschen 
      Information darüber finden Sie in \OnCD{texmf-dist/doc/aleph/base} und 
      \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph}. Das \LaTeX-basierte Aleph-Format heißt 
      \cmdname{lamed}.

\item Das neueste \LaTeX-Release enthält eine neue Version der \acro{LPPL}%
      \footnote{LPPL: LaTeX Project Public License}, 
      die jetzt eine offiziell von Debian anerkannte Lizenz ist. Zusammen mit anderen Updates finden Sie Informationen 
      dazu in den \filename{ltnews}-Dateien in \OnCD{texmf-dist/doc/latex/base}.

\item \cmdname{dvipng} -- ein neues Programm zum Konvertieren von \dvi-Dateien in \acro{PNG}-Bilddateien, ist 
      Bestandteil von \TL. Siehe \OnCD{texmf/doc/man/man1/dvipng.1}.

\item Auf Vorschlag des Autors (Claudio~Beccari) haben wir das Paket \pkgname{cbgreek} auf einen ">mittelgroßen"< Satz 
      von Fonts reduziert. Herausgenommen wurden die ">invisible"<, Outline- und ">Transparency"<-Fonts,
      die relativ selten benutzt werden -- denn wir benötigen den Platz. In seinem vollen Umfang ist das Paket natürlich 
      weiterhin auf \acro{CTAN} verfügbar (\url{http://www.ctan.org/tex-archive/fonts/greek/cb/}).

\item \cmdname{oxdvi} wurde entfernt; benutzen Sie jetzt \cmdname{xdvi}.

\item Die \cmdname{ini}- und \cmdname{vir}-Befehle (Links) für \cmdname{tex}, \cmdname{mf} and \cmdname{mpost} sind 
      nicht mehr länger verfügbar, so auch \cmdname{initex}. Das ist kein richtiger Verlust, da die 
      \cmdname{ini}-Funktionalität schon seit mehreren Jahren über den Aufrufparameter \optname{-ini} zur Verfügung 
      steht.

\item Die Unterstützung der Plattform \cmdname{i386-openbsd} wurde entfernt. Da das Paket \pkgname{tetex} im  
      \acro{BSD}-Ports-System zur Verfügung steht und Binaries für \acro{GNU}/""Linux and Free\acro{BSD} erhältlich sind, 
      erschien es sinnvoll, die Zeit der Freiwilligen besser zu nutzen.

\item Zumindest auf \cmdname{sparc-solaris} müssen Sie ggf. die En"-viron"-ment-Variable \envname{LD\_LIBRARY\_PATH} 
      setzen, um die \pkgname{t1utils}-Programme laufen lassen zu können. Ursache dafür ist, dass die Programme mit C++ 
      kompiliert wurden und dass es keinen Standard-Platz für Laufzeit-Bibliotheken gibt (das ist zwar auch im Jahre 
      2004 nicht neu, wurde aber bisher nicht dokumentiert.) Unter \cmdname{mips-irix} werden die 
      \acro{MIPS}pro-7.4-Laufzeit-Bibliotheken benötigt.
\end{itemize}

\subsection{2005}

Im Jahr 2005 gab es -- wie üblich -- viele aktualisierte Pakete und
Programme. Die Struktur des Systems blieb weitgehend gleich, mit folgenden
Ausnahmen:

\begin{itemize}
\item Die neuen Skripte \cmdname{texconfig-sys}, \cmdname{updmap-sys} und
  \cmdname{fmtutil-sys} für die systemweite Konfiguration des Systems wurden
  hinzugefügt. Die Skripte \cmdname{texconfig}, \cmdname{updmap} und
  \cmdname{fmtutil} modifizieren nun die Konfiguration für einen einzelnen
  Nutzer unter \dirname{\$HOME/.texlive2005}.
  Siehe Abschnitt~\ref{sec:texconfig} auf Seite~\pageref{sec:texconfig}.
\item Analog spezifizieren die Pfade \envname{TEXMFCONFIG} und
  \envname{TEXMFSYSCONFIG} nun, wo die Konfigurationsdateien gefunden
  werden (für einen einzelnen Nutzer bzw. systemweit). Möglicherweise
  müssen Sie daher vorhandene eigene Versionen von
  \filename{fmtutil.cnf} oder \filename{updmap.cfg} in die entsprechenden
  Pfade verschieben. Alternativ können Sie \envname{TEXMFCONFIG} und
  \envname{TEXMFSYSCONFIG} in der Datei \filename{texmf.cnf} umdefinieren,
  dass diese auf die Speicherorte Ihrer eigenen Konfigurationsdateien
  verweisen. Siehe Abschnitt~\ref{sec:texmftrees} auf Seite~\pageref{sec:texmftrees}.
\item Im letzten Jahr wurden für die Programme, die DVI als Ausgabeformat
  erzeugen, die Primitive wie \verb|\pdfoutput| auf undefiniert gesetzt,
  obwohl immer \cmdname{pdfetex} verwendet wurde. In diesem Jahr wurde dies
  wie angekündigt nicht mehr getan. Falls in Dokumenten nun die Abfrage
  \verb|\ifx\pdfoutput\undefined| zum Test benutzt wird, ob PDF oder DVI
  erzeugt wird, müssen diese geändert werden! Benutzen Sie das Paket
  \pkgname{ifpdf.sty}, das auch mit dem geänderten Verhalten funktioniert,
  oder orientieren Sie sich an dessen Code.
\item Im letzten Jahr wurden die Formate so geändert, dass sie Zeichen
  als 8-bit ausgeben. Die neue TCX-Datei \filename{empty.tcx} eröffnet nun
  einen einfachen Weg, die originale Ausgabe mit \verb|^^|-Notation zu
  erhalten, wenn Sie es wünschen:
\begin{verbatim}
latex --translate-file=empty.tcx yourfile.tex
\end{verbatim}
\item Das Programm \cmdname{dvipdfmx} für die Konvertierung von DVI nach
  PDF ist neu hinzugekommen. Dies ist eine aktiv gepflegte Erweiterung von
  \cmdname{dvipdfm}, das zwar noch verfügbar ist, aber als obsolet angesehen
  werden kann.
\item Ebenso sind die Programme \cmdname{pdfopen} und \cmdname{pdfclose} neu
  hinzugekommen. Diese erlauben ein Reload von PDF-Dateien im Acrobat Reader,
  ohne diesen neu starten zu müssen (andere PDF-Viewer wie \cmdname{xpdf},
  \cmdname{gv} oder \cmdname{gsview} hatten damit nie Probleme).
\item Aus Konsistenzgründen wurden die Variablen \envname{HOMETEXMF} und
  \envname{VARTEXMF} in \envname{TEXMFHOME} bzw. \envname{TEXMFSYSVAR}
  umbenannt. Weiterhin existiert \envname{TEXMFVAR} für einen Baum, der
  spezifisch für einen einzelnen Nutzer ist.
\end{itemize}

\subsection{Gegenwart}
\label{tlcurrent}

Der wichtigeste Neuzuwachs in der 2006 Ausgabe von \TL{} war das Xe\TeX{} 
Programm, verfügbar durch die \texttt{xetex} und \texttt{xelatex} 
Programme; siehe \url{http://scripts.sil.org/xetex}.

Auch MetaPost erhielt ein bemerkenswertes Update, mit weiteren geplannten
Änderungen (\url{http://tug.org/metapost/articles}), ebenso pdf\TeX{}
(\url{http://tug.org/applications/pdftex}).

Das (plain) \texttt{tex}-Programm liest nicht mehr erste Zeilen mit 
\texttt{\%\&} um das Format zu bestimmen. Es ist ein reines Knuth-\TeX.
(\LaTeX\ und alle anderen Formate lesen weiterhin \texttt{\%\&}-Zeilen).

Das Installationsskript wertet nun diverse Umgebungsvariablen aus, um eine
nicht-interaktive Installation zu ermöglichen, siehe 
Abschnitt~\ref{sec:noninteractive-install}.

Weiters wurden wie üblich hunderte von Paketen und Programmen auf einen
neueren Stand gebracht. Für weiter Updates wenden Sie sich bitte an
\acro{CTAN} (\url{http://www.ctan.org}).

Die Entwicklungsumgebung wurde auf Subversion umgestellt, was ein Webinterface
für den Entwicklungsbaum beisteuerte. Dieses Webinterface ist von der
Homepage verlinkt. Obwohl dieser Umstieg in der Distribution nicht zu
erkennen ist, erwarten wir uns ein stabiles Fundament für die Entwicklung
in den nächsten Jahren.

Schließlich hat im Mai~2006 Thomas Esser das Ende seiner Entwicklung von
te\TeX{} (\url{http://tug.org/tetex}) angekündigt. Als Konsequenz ist das
Interesse an \TL{}, besonders unter den \acro{GNU}/Linux-Distributoren
angestiegen. (\TL{} bietet nun ein \texttt{tetex}-Installationsschema, dass
annähernd den Umfang von te\TeX{} umfasst.) Wir hoffen dass dies
schlussendlich zu einer Verbesserung der \TeX-Umgebung für jederman führt.

% -------------------------------------------------------------
\subsection{Zukunft}

\emph{{\TL} ist nicht perfekt! -- und wird es auch nie sein.}  Wir planen
Neuauf"|lagen zu produzieren, die umfangreichere
Hilfstexte, mehr Hilfsprogramme, mehr Installationshilfen und (natürlich)
den ständig verbesserten und überprüften Satz der Makros und Zeichensätze
enthalten. Diese Arbeit wird von Freiwilligen in ihrer knappen Freizeit
geleistet. Viel Arbeit steht noch an. Wenn Sie uns helfen können,
zögern Sie keine Sekunde, sich bei uns zu melden.

Verbesserungen, Anregungen und Erweiterungen für künftige Ausgaben
der {\TK} senden Sie bitte an:\hfill\null

\begin{quote}
\email{tex-live@tug.org}\\
\url{http://tug.org/texlive/}
\end{quote}

Neue Versionen, Anmerkungen und zusätzliches Material werden über
die \CTAN-Server im Verzeichnis \dirname{info/texlive} zur Verfügung gestellt.
Im \acro{WWW} können Sie sich über die Adresse
\url{http://www.tug.org/tex-live/} informieren und die Bestellformalitäten
einsehen.

\end{document}