Make IDirectMusicScriptImpl_IDirectMusicScript_CallRoutine return S_OK
[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, den Dateien im Dokumentations-Verzeichnis
27 des Wine-Quelltextes (siehe "DOKUMENTATION") und insbesondere der
28 Vielzahl an Informationen, die Sie auf http://www.winehq.org finden.
29
30 3. VORAUSSETZUNGEN
31
32 Um Wine kompilieren und ausführen zu können, brauchen Sie eines der
33 folgenden Betriebssysteme:
34
35   Linux version 2.0.36 oder neuer
36   FreeBSD 4.x oder FreeBSD 5-CURRENT oder neuer
37   Solaris x86 2.5 oder neuer
38   NetBSD-current
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 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 Unterstützte Dateisysteme:
68   Wine sollte auf den meisten Dateisystemen laufen. Jedoch wird Wine nicht
69   starten, wenn umsdos für das Verzeichnis /tmp benutzt wird. Ein paar
70   Kompatibilitäts-Probleme wurden auch gemeldet beim Dateizugriff über Samba.
71   Ausserdem können wir, da NTFS derzeit nur sicher für Lesezugriffe genutzt
72   werden kann, den Einsatz von NTFS nicht empfehlen; Windows-Programme
73   benötigen fast immer Schreibzugriffe.
74   Kopieren Sie NTFS-Dateien an einen Ort, an dem Sie Schreibrechte haben.
75
76 Grundsätzliche Voraussetzungen:
77   Sie müssen die Include-Dateien für X11-Entwicklung installiert haben
78   (Debian nennt diese xlib6g-dev, RedHat XFree86-devel).
79
80 Vorausgesetzte Build-Tools:
81   Auf x86-Systemen wird der gcc >= 2.7.2 benötigt.
82   Versionen vor 2.7.2.3 können Probleme damit haben, wenn bestimmte Dateien
83   mit Optimierungen kompiliert werden, oft im Zusammenhang mit Problemen mit
84   der Verwaltung von Header-Dateien. pgcc arbeitet derzeit nicht mit Wine.
85   Die Ursache dieses Problems ist unbekannt.
86
87   Natürlich benötigen Sie auch "make" (höchstwahrscheinlich GNU make).
88
89   Des Weiteren benötigen Sie flex in der Version 2.5 oder höher und bison.
90   Wenn Sie RedHat oder Debian benutzen, installieren Sie bitte die flex-
91   und bison-Pakete.
92
93 Optionale Support-Libraries:
94   Wenn Sie CUPS Drucker-Unterstützung haben wollen, installieren Sie bitte
95   die Pakete cups und cups-devel.
96
97   Für die automatische Verarbeitung der Test-Skripte brauchen Sie auch den
98   Entwicklungs-Headersupport aus libperl (in Debian das Paket libperl-dev).
99
100 Die Voraussetzungen für das selbständige Durchführen des Builds der
101 Dokumentation entnehmen Sie bitte dem Abschnitt "DOKUMENTATION".
102
103 4. KOMPILIEREN
104
105 Wenn Sie sich dafür entscheiden, wineinstall nicht zu benutzen, führen Sie
106 bitte die folgenden Kommandos für den Build von Wine aus:
107
108 ./configure
109 make depend
110 make
111
112 Das erledigt den Build des Programms "wine" und verschiedener Support-
113 Libraries / -Binärdateien.
114 Das Programm "wine" lädt ausführbare Windows-Dateien und führt sie aus.
115 Die Library "libwine" ("WineLib") kann benutzt werden, um Windows-Quelltexte
116 unter Unix zu kompilieren und zu verlinken.
117
118 Mit ./configure --help können Sie sich die Konfigurations-Optionen für
119 die Kompilierung anzeigen lassen.
120
121 Um mit Hilfe einer Patch-Datei auf ein neueres Release zu aktualisieren,
122 wechsen Sie erst mit cd in das Wurzelverzeichnis dieses Releases (das,
123 welches diese README-Datei enthält). Geben Sie dann "make clean" ein
124 und patchen Sie das Release mit dem Kommando:
125
126     gunzip -c patch-file | patch -p1
127
128 wobei "patch-file" der Name der Patch-Datei ist (etwas wie
129 Wine-yymmdd.diff.gz). Sie können dann erneut "./configure" und danach
130 "make depend && make" aufrufen.
131
132 5. SETUP
133
134 Nachdem der Build von Wine korrekt durchgelaufen ist, können Sie das
135 Kommando "make install" aufrufen; Dadurch werden das Wine-Programm, die
136 Man-Page und einige andere benötigte Dateien installiert.
137
138 Vergessen Sie nicht, erst alle früheren Wine-Installationen zu entfernen.
139 Führen Sie vor der Installation entweder "dpkg -r wine", "rpm -e wine" oder
140 "make uninstall" aus.
141
142 Wenn Sie die mit dem Wine-Quelltext gelieferte Dokumentation lesen wollen,
143 schauen Sie sich bitte den Abschnitt "DOKUMENTATION" an.
144
145 Wine benötigt eine Konfigurations-Datei namens "config" in Ihrem
146 ~/.wine-Verzeichnis. Das Format dieser Datei wird in der Man-Page der
147 Konfigurations-Datei erklärt (documentation/wine.conf.man).
148 Die Datei documentation/samples/config enthält eine beispielhafte
149 Konfigurations-Datei, die angepasst und an die oben erwähnte Stelle
150 kopiert werden muss.
151
152 Vergessen Sie nicht, lebenswichtige Registry-Einträge anzulegen, indem
153 Sie winedefault.reg mittels programms/regedit anwenden. Details entnehmen
154 Sie bitte dem Verzeichnis documentation.
155
156 Weitere Konfigurations-Hinweise finden Sie im Support-Bereich
157 von http://www.winehq.org.
158
159 Im Falle von Library-Ladefehlern (z.B. "Error while loading shared libraries:
160 libntdll.so") fügen Sie bitte den Library-Pfad zur Datei /etc/ld.so.conf hinzu 
161 und führen Sie ldconfig als root aus.
162
163 Um zu prüfen, ob Ihre Umgebung passend eingerichtet ist, um Wine erfolgreich
164 laufen zu lassen, können Sie das Kommando "./tools/winecheck | less" ausführen.
165 Es wird Ihnen eine Punktzahl in Prozent mitgeteilt, welche die "Korrektheit der
166 Wine-Konfiguration" darstellt.
167 Da dieses Programm immer noch im Alpha-Stadium ist, führt es aber keinen wirklich
168 umfassenden Test durch, die Ergebnisse der Überprüfungsollten sollten also nur
169 als erster Prüfschritt betrachtet werden.
170
171 In der Man-Page zu wine.conf können Sie nachlesen, wie Sie zum reinen Text-Modus
172 wechseln können, wenn gewünscht.
173
174 6. AUSFÜHREN VON PROGRAMMEN
175
176 Wenn Sie Wine aufrufen, können Sie den vollständigen Pfad zur ausführbaren
177 Datei angeben oder nur einen Dateinamen.
178
179 Beispiel: Um Solitaire auszuführen:
180
181         wine sol                   (den Suchpfad, der in der Konfiguartions-Datei 
182         wine sol.exe               angegeben wurde, benutzend)
183
184         wine c:\\windows\\sol.exe  (die Dateinamen-Syntax von DOS benutzend)
185
186         wine /usr/windows/sol.exe  (die Dateinamen-Syntax von Unix benutzend)
187
188         wine -- sol.exe /parameter1 -parameter2 parameter3
189                                    (Programmaufruf mit Parametern)
190
191 Hinweis: Der Pfad zur Datei wird auch zum Pfad hinzugefügt, wenn ein vollständiger
192          Dateiname auf der Kommandozeile angegeben wird.
193
194 Die Entwicklung von Wine ist noch nicht abgeschlossen, daher können einige
195 Programme abstürzen. Vorausgesetzt, dass Sie winedbg korrekt entsprechend 
196 documentation/debugger.sgml einrichten, werden Sie dann in einem Debugger landen,
197 um das Problem untersuchen und beheben zu können.
198 Weitere Informationen zu diesem Thema entnehmen Sie bitte der Datei
199 documentation/debugging.sgml.
200
201 Sie sollten Backups von allen wichtigen Dateien machen, auf die Sie Wine 
202 Zugriff gewähren, oder spezielle Kopien für Wine anlegen, da Benutzer einige
203 Fälle gemeldet haben, in denen Dateien zerstört wurden. Führen Sie zum Beispiel
204 NICHT den Explorer aus, wenn Sie kein geeignetes Backup haben, da er manchmal
205 Verzeichnise verstümmelt / umbenennnt. Selbst andere MS-Applikationen wie z.B
206 der Messenger sind nicht sicher, da sie unter Umständen den Explorer aufrufen.
207 Diese spezielle Beschädigung (!$!$!$!$.pfr) kann zumindest teilweise durch
208 http://home.nexgo.de/andi.mohr/download/decorrupt_explorer behoben werden.
209
210 7. DOKUMENTATION
211
212 Im Verzeichnis documentation/ befindet sich einiges an Dokumentation (verschiedene
213 Wine-Guides usw.). Sie sind auch im WineHQ verfügbar.
214
215 Wenn Sie die SGML-Dateien dort verarbeiten möchten, können Sie das Kommando
216 "make doc" im Verzeichnis documentation/ ausführen.
217 Dafür wird das Paket "sgml tools" vorausgesetzt (für db2html, db2ps, db2pdf):
218 Debian:         docbook-utils
219 Mandrake:       sgml-tools-A.B.C-DDmdk
220 SuSE:           docbktls-A.BB.C-DD
221
222 8. WEITERFÜHRENDE INFORMATIONEN
223
224 WWW:    Eine große Anzahl an Informationen findet sich im WineHQ unter
225         http://www.winehq.org/ : Verschiedene Wine Guides, Applikations-Datenbank,
226         Fehlerverfolgungs-System. Das ist vermutlich der beste Ausgangspunkt.
227
228 FAQ:    Die FAQ zu Wine befindet sich unter http://www.winehq.org/FAQ
229
230 Usenet: Hilfe und Diskussionen zu auf Wine bezogenen Problemen finden Sie unter
231         comp.emulators.ms-windows.wine.
232
233 Fehler: Melden Sie Fehler bitte an Wine-Bugzilla unter http://bugs.winehq.org
234         Schauen Sie bitte erst in der Bugzilla-Datenbank nach, ob Ihr Problem
235         bereits gemeldet wurde, bevor Sie eine Fehlermeldung verfassen. Sie 
236         können Fehlermeldungen auch an comp.emulators.ms-windows.wine schicken.
237         Lesen Sie bitte die Datei documentation/bugs.sgml um zu sehen, welche
238         Informationen benötigt werden.
239
240 IRC:    Online-Hilfe wird Ihnen im Chat-Kanal #WineHQ unter irc.freenode.net gewährt.
241
242 CVS:    Der aktuelle Wine-Entwicklungs-Tree ist über CVS verfügbar.
243         Besuchen Sie http://www.winehq.org/cvs für weitere Informationen.
244
245 Mailing-Listen:
246         Es gibt mehrere Mailing-Listen für die Wine-Entwickler; Schauen Sie
247         sich bitte dazu http://www.winehq.org/forums an.
248
249 Wenn Sie etwas hinzufügen oder einen Fehler beheben, senden Sie den Patch bitte 
250 (im 'diff -u'-Format) an die Liste wine-patches@winehq.org, um ihn in die nächste
251 Ausgabe aufnehmen zu können.
252
253 --
254 Alexandre Julliard
255 julliard@winehq.org
256
257 Übersetzung von Christian Britz (Deutschland)
258 Auf die Übersetzung bezogene Fehlermeldungen,
259 Anregungen und Kommentare senden Sie bite an:
260 cbritz@gmx.net