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 Weitere Konfigurations-Hinweise finden Sie im Support-Bereich
 153 von http://www.winehq.org.
 154
 155 Im Falle von Library-Ladefehlern (z.B. "Error while loading shared libraries:
 156 libntdll.so") fügen Sie bitte den Library-Pfad zur Datei /etc/ld.so.conf hinzu
 157 und führen Sie ldconfig als root aus.
 158
 159 Um zu prüfen, ob Ihre Umgebung passend eingerichtet ist, um Wine erfolgreich
 160 laufen zu lassen, können Sie das Kommando "./tools/winecheck | less" ausführen.
 161 Es wird Ihnen eine Punktzahl in Prozent mitgeteilt, welche die "Korrektheit der
 162 Wine-Konfiguration" darstellt.
 163 Da dieses Programm immer noch im Alpha-Stadium ist, führt es aber keinen wirklich
 164 umfassenden Test durch, die Ergebnisse der Überprüfungsollten sollten also nur
 165 als erster Prüfschritt betrachtet werden.
 166
 167 In der Man-Page zu wine.conf können Sie nachlesen, wie Sie zum reinen Text-Modus
 168 wechseln können, wenn gewünscht.
 169
 170 6. AUSFÜHREN VON PROGRAMMEN
 171
 172 Wenn Sie Wine aufrufen, können Sie den vollständigen Pfad zur ausführbaren
 173 Datei angeben oder nur einen Dateinamen.
 174
 175 Beispiel: Um Solitaire auszuführen:
 176
 177         wine sol                   (den Suchpfad, der in der Konfiguartions-Datei
 178         wine sol.exe               angegeben wurde, benutzend)
 179
 180         wine c:\\windows\\sol.exe  (die Dateinamen-Syntax von DOS benutzend)
 181
 182         wine /usr/windows/sol.exe  (die Dateinamen-Syntax von Unix benutzend)
 183
 184         wine -- sol.exe /parameter1 -parameter2 parameter3
 185                                    (Programmaufruf mit Parametern)
 186
 187 Hinweis: Der Pfad zur Datei wird auch zum Pfad hinzugefügt, wenn ein vollständiger
 188          Dateiname auf der Kommandozeile angegeben wird.
 189
 190 Die Entwicklung von Wine ist noch nicht abgeschlossen, daher können einige
 191 Programme abstürzen. Vorausgesetzt, dass Sie winedbg korrekt entsprechend
 192 documentation/debugger.sgml einrichten, werden Sie dann in einem Debugger landen,
 193 um das Problem untersuchen und beheben zu können.
 194 Weitere Informationen zu diesem Thema entnehmen Sie bitte der Datei
 195 documentation/debugging.sgml.
 196
 197 Sie sollten Backups von allen wichtigen Dateien machen, auf die Sie Wine
 198 Zugriff gewähren, oder spezielle Kopien für Wine anlegen, da Benutzer einige
 199 Fälle gemeldet haben, in denen Dateien zerstört wurden. Führen Sie zum Beispiel
 200 NICHT den Explorer aus, wenn Sie kein geeignetes Backup haben, da er manchmal
 201 Verzeichnise verstümmelt / umbenennnt. Selbst andere MS-Applikationen wie z.B
 202 der Messenger sind nicht sicher, da sie unter Umständen den Explorer aufrufen.
 203 Diese spezielle Beschädigung (!$!$!$!$.pfr) kann zumindest teilweise durch
 204 http://home.nexgo.de/andi.mohr/download/decorrupt_explorer behoben werden.
 205
 206 7. DOKUMENTATION
 207
 208 Im Verzeichnis documentation/ befindet sich einiges an Dokumentation (verschiedene
 209 Wine-Guides usw.). Sie sind auch im WineHQ verfügbar.
 210
 211 Wenn Sie die SGML-Dateien dort verarbeiten möchten, können Sie das Kommando
 212 "make doc" im Verzeichnis documentation/ ausführen.
 213 Dafür wird das Paket "sgml tools" vorausgesetzt (für db2html, db2ps, db2pdf):
 214 Debian:         docbook-utils
 215 Mandrake:       sgml-tools-A.B.C-DDmdk
 216 SuSE:           docbktls-A.BB.C-DD
 217
 218 8. WEITERFÜHRENDE INFORMATIONEN
 219
 220 WWW:    Eine große Anzahl an Informationen findet sich im WineHQ unter
 221         http://www.winehq.org/ : Verschiedene Wine Guides, Applikations-Datenbank,
 222         Fehlerverfolgungs-System. Das ist vermutlich der beste Ausgangspunkt.
 223
 224 FAQ:    Die FAQ zu Wine befindet sich unter http://www.winehq.org/FAQ
 225
 226 Usenet: Hilfe und Diskussionen zu auf Wine bezogenen Problemen finden Sie unter
 227         comp.emulators.ms-windows.wine.
 228
 229 Fehler: Melden Sie Fehler bitte an Wine-Bugzilla unter http://bugs.winehq.org
 230         Schauen Sie bitte erst in der Bugzilla-Datenbank nach, ob Ihr Problem
 231         bereits gemeldet wurde, bevor Sie eine Fehlermeldung verfassen. Sie
 232         können Fehlermeldungen auch an comp.emulators.ms-windows.wine schicken.
 233         Lesen Sie bitte die Datei documentation/bugs.sgml um zu sehen, welche
 234         Informationen benötigt werden.
 235
 236 IRC:    Online-Hilfe wird Ihnen im Chat-Kanal #WineHQ unter irc.freenode.net gewährt.
 237
 238 CVS:    Der aktuelle Wine-Entwicklungs-Tree ist über CVS verfügbar.
 239         Besuchen Sie http://www.winehq.org/cvs für weitere Informationen.
 240
 241 Mailing-Listen:
 242         Es gibt mehrere Mailing-Listen für die Wine-Entwickler; Schauen Sie
 243         sich bitte dazu http://www.winehq.org/forums an.
 244
 245 Wenn Sie etwas hinzufügen oder einen Fehler beheben, senden Sie den Patch bitte
 246 (im 'diff -u'-Format) an die Liste wine-patches@winehq.org, um ihn in die nächste
 247 Ausgabe aufnehmen zu können.
 248
 249 --
 250 Alexandre Julliard
 251 julliard@winehq.org
 252
 253 Übersetzung von Christian Britz (Deutschland)
 254 Auf die Übersetzung bezogene Fehlermeldungen,
 255 Anregungen und Kommentare senden Sie bite an:
 256 cbritz@gmx.net