makefiles: Output all the documentation rules explicitly for each module.
[wine] / documentation / README.de
1 1. EINFÜHRUNG
2
3 Wine ist ein Programm, das es ermöglicht, Programme, die für Microsoft
4 Windows geschrieben wurden (inklusive DOS-, Windows 3.x- und Win32-
5 Binärdateien), unter Unix auszuführen. Es besteht aus einem Programm-
6 Lader, der Microsoft Windows-Binärdateien lädt und ausführt, sowie
7 einer Library (Winelib genannt), die Aufrufe der Windows API unter
8 Verwendung der entsprechenden Unix- oder X11-Gegenstücke implementiert.
9 Die Library kann auch benutzt werden, um Win32-Code nativ nach Unix
10 zu portieren.
11
12 Wine ist Freie Software, die unter der GNU LGPL veröffentlicht wird;
13 Bitte lesen Sie die Details in der Datei LICENSE nach.
14
15 2. SCHNELLSTART
16
17 Um den Quelltext zu kompilieren, empfiehlt es sich immer, den Wine-
18 Installer für den Build und die Installation von Wine zu verwenden.
19 Rufen Sie dazu aus dem Wurzelverzeichnis des Wine-Quelltextes (das
20 diese Datei enthält) das folgende Kommando auf:
21
22 ./tools/wineinstall
23
24 Starten Sie Programme mit "wine [Optionen] Programm". Weitere 
25 Informationen und Problemlösungen entnehmen Sie bitte dem Rest dieser
26 Datei, der Man-Page von Wine und insbesondere der Vielzahl an 
27 Informationen, die Sie auf http://www.winehq.org finden.
28
29 3. VORAUSSETZUNGEN
30
31 Um Wine kompilieren und ausführen zu können, brauchen Sie eines der
32 folgenden Betriebssysteme:
33
34   Linux version 2.0.36 oder neuer
35   FreeBSD 6.3 oder neuer
36   Solaris x86 9 oder neuer
37   NetBSD-current
38   Mac OS X 10.4 oder neuer
39
40 Da Wine Thread-Support auf Kernelebene benötigt, werden nur die oben
41 aufgeführten Betriebssysteme unterstützt.
42 Andere Betriebssysteme, die Kernel-Threads unterstützen, werden unter
43 Umständen in der Zukunft unterstützt.
44
45 Linux-Info:
46   Obwohl Linux 2.2.x immer noch funktionieren sollte und Linux 2.0.x
47   vielleicht auch noch funktioniert (ältere 2.0.x-Versionen verzeichneten
48   Abstürze im Zusammenhang mit Threads), sollte man am besten einen
49   aktuellen Kernel wie 2.4.x oder 2.6.x verwenden.
50
51 FreeBSD-Info:
52   Stellen Sie sicher, dass Sie die Optionen USER_LDT, SYSVSHM, SYSVSEM und
53   SYSVMSG in Ihrem Kernel aktiviert haben. Weitere Informationen finden Sie
54   im Ports-Tree: ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/
55
56 Solaris-Info:
57   Höchstwahrscheinlich müssen Sie den Wine-Build mit der GNU-Toolchain
58   (gcc, gas etc.) durchführen. Warnung: Die Installation von gas stellt nicht
59   sicher, dass es vom gcc auch verwendet wird. Den gcc neu zu kompilieren, nach
60   der Installation von gas, oder die Symbolischen Links von cc, as und ld
61   mit den GNU-Tools zu verknüpfen, soll ausreichend sein.
62
63 NetBSD-Info:
64   Stellen Sie sicher, dass Sie die Optionen USER_LDT, SYSVSHM, SYSVSEM und
65   SYSVMSG in Ihrem Kernel aktiviert haben.
66
67 Mac OS X Info:
68   Sie benötigen mindestens Xcode 2.4 um richtig unter x86 kompilieren zu können.
69
70 Unterstützte Dateisysteme:
71   Wine sollte auf den meisten Dateisystemen laufen. Ein paar
72   Kompatibilitäts-Probleme wurden auch gemeldet beim Dateizugriff über Samba.
73   Ausserdem können wir, da NTFS derzeit nur sicher für Lesezugriffe genutzt
74   werden kann, den Einsatz von NTFS nicht empfehlen; Windows-Programme
75   benötigen fast immer Schreibzugriffe.
76   Kopieren Sie NTFS-Dateien an einen Ort, an dem Sie Schreibrechte haben.
77
78 Grundsätzliche Voraussetzungen:
79   Sie müssen die Include-Dateien für X11-Entwicklung installiert haben
80   (Debian nennt diese xlib6g-dev, Red Hat XFree86-devel).
81
82   Natürlich benötigen Sie auch "make" (höchstwahrscheinlich GNU make).
83
84   Des Weiteren benötigen Sie flex in der Version 2.5 oder höher und bison.
85
86 Optionale Support-Bibliotheken:
87   Der ./configure Aufruf zeigt am Ende optionale Bibliotheken an,
88   die von Wine benutzt werden können, aber auf dem System nicht vorhanden
89   sind.
90
91   Auf 64-Bit Plattformen benötigen Sie die 32-bit
92   Versionen dieser Bibliotheken; siehe dazu http://wiki.winehq.org/WineOn64bit
93
94 4. KOMPILIEREN
95
96 Wenn Sie sich dafür entscheiden, wineinstall nicht zu benutzen, führen Sie
97 bitte die folgenden Kommandos für den Build von Wine aus:
98
99 ./configure
100 make depend
101 make
102
103 Das erledigt den Build des Programms "wine" und verschiedener Support-
104 Libraries / -Binärdateien.
105 Das Programm "wine" lädt ausführbare Windows-Dateien und führt sie aus.
106 Die Library "libwine" ("WineLib") kann benutzt werden, um Windows-Quelltexte
107 unter Unix zu kompilieren und zu verlinken.
108
109 Mit ./configure --help können Sie sich die Konfigurations-Optionen für
110 die Kompilierung anzeigen lassen.
111
112 Um mit Hilfe einer Patch-Datei auf ein neueres Release zu aktualisieren,
113 wechseln Sie erst mit cd in das Wurzelverzeichnis dieses Releases (eins
114 über dem, welches diese README-Datei enthält). Geben Sie dann
115 "make clean" ein und patchen Sie das Release mit dem Kommando:
116
117     bunzip2 -c Patch-Datei | patch -p1
118
119 wobei "Patch-Datei" der Name der Patch-Datei ist (sowas wie
120 wine-1.0.x.diff.bz2). Sie können dann erneut "./configure" und danach
121 "make depend && make" aufrufen.
122
123 5. SETUP
124
125 Nachdem der Build von Wine korrekt durchgelaufen ist, können Sie das
126 Kommando "make install" aufrufen; Dadurch werden das Wine-Programm, die
127 Man-Page und einige andere benötigte Dateien installiert.
128
129 Vergessen Sie nicht, erst alle früheren Wine-Installationen zu entfernen.
130 Führen Sie vor der Installation entweder "dpkg -r wine", "rpm -e wine" oder
131 "make uninstall" aus.
132
133 Die Konfigurations-Hinweise finden Sie im Support-Bereich
134 von http://www.winehq.org.
135
136 Im Falle von Library-Ladefehlern (z.B. "Error while loading shared libraries:
137 libntdll.so") fügen Sie bitte den Library-Pfad zur Datei /etc/ld.so.conf hinzu
138 und führen Sie ldconfig als root aus.
139
140 6. AUSFÜHREN VON PROGRAMMEN
141
142 Wenn Sie Wine aufrufen, können Sie den vollständigen Pfad zur ausführbaren
143 Datei angeben oder nur einen Dateinamen.
144
145 Beispiel: Um Notepad auszuführen:
146
147         wine notepad               (den Suchpfad, der in der Konfigurations-Datei
148         wine notepad.exe           angegeben wurde, benutzend)
149
150         wine c:\\windows\\notepad.exe  (die Dateinamen-Syntax von DOS benutzend)
151
152         wine ~/.wine/drive_c/windows/notepad.exe  (die Dateinamen-Syntax von Unix benutzend)
153
154         wine notepad.exe /parameter1 -parameter2 parameter3
155                                    (Programmaufruf mit Parametern)
156
157 Hinweis: Der Pfad zur Datei wird auch zum Pfad hinzugefügt, wenn ein vollständiger
158          Dateiname auf der Kommandozeile angegeben wird.
159
160 Die Entwicklung von Wine ist noch nicht abgeschlossen, daher können einige
161 Programme abstürzen. In diesem Fall startet der Debugger, so dass Sie das Problem
162 untersuchen und beheben können. Weitere Informationen zu diesem Thema entnehmen Sie
163 bitte dem Kapitel Debugging aus dem Wine Developer's Guide.
164
165 7. WEITERFÜHRENDE INFORMATIONEN
166
167 WWW:    Eine große Anzahl an Informationen findet sich im WineHQ unter
168         http://www.winehq.org/ : Verschiedene Wine Guides, Applikations-Datenbank,
169         Fehlerverfolgungs-System. Das ist vermutlich der beste Ausgangspunkt.
170
171 FAQ:    Die FAQ zu Wine befindet sich unter http://www.winehq.org/FAQ
172
173 Usenet: Hilfe und Diskussionen zu auf Wine bezogenen Problemen finden Sie unter
174         comp.emulators.ms-windows.wine.
175
176 Fehler: Melden Sie Fehler bitte an Wine-Bugzilla unter http://bugs.winehq.org
177         Schauen Sie bitte erst in der Bugzilla-Datenbank nach, ob Ihr Problem
178         bereits gemeldet wurde, bevor Sie eine Fehlermeldung verfassen. Sie 
179         können Fehlermeldungen auch an comp.emulators.ms-windows.wine schicken.
180         Lesen Sie bitte die Datei documentation/bugs.sgml um zu sehen, welche
181         Informationen benötigt werden.
182
183 IRC:    Online-Hilfe wird Ihnen im Chat-Kanal #WineHQ unter irc.freenode.net gewährt.
184
185 Git:    Der aktuelle Wine-Entwicklungs-Zweig ist über Git verfügbar.
186         Besuchen Sie http://www.winehq.org/site/git für weitere Informationen.
187
188 Mailing-Listen:
189         Es gibt mehrere Mailing-Listen für die Wine-User und -Entwickler; Schauen Sie
190         sich bitte dazu http://www.winehq.org/forums an.
191
192 Wiki:   Das Wine-Wiki finden Sie unter http://wiki.winehq.org
193
194 Wenn Sie etwas hinzufügen oder einen Fehler beheben, senden Sie den Patch bitte
195 (im 'diff -u'-Format) an die Liste wine-patches@winehq.org, um ihn in die nächste
196 Ausgabe aufnehmen zu können.
197
198 --
199 Alexandre Julliard
200 julliard@winehq.org
201
202 Übersetzung von Christian Britz (Deutschland)
203 Auf die Übersetzung bezogene Fehlermeldungen,
204 Anregungen und Kommentare senden Sie bite an:
205 cbritz@gmx.net