1. EINF�HRUNG

Wine ist ein Programm, das es erm�glicht, Programme, die f�r Microsoft
Windows geschrieben wurden (inklusive DOS-, Windows 3.x- und Win32-
Bin�rdateien), unter Unix auszuf�hren. Es besteht aus einem Programm-
Lader, der Microsoft Windows-Bin�rdateien l�dt und ausf�hrt, sowie
einer Library (Winelib genannt), die Aufrufe der Windows API unter
Verwendung der entsprechenden Unix- oder X11-Gegenst�cke implementiert.
Die Library kann auch benutzt werden, um Win32-Code nativ nach Unix
zu portieren.

Wine ist Freie Software, die unter der GNU LGPL ver�ffentlicht wird; 
Bitte lesen Sie die Details in der Datei LICENSE nach.

2. SCHNELLSTART

Um den Quelltext zu kompilieren, empfiehlt es sich immer, den Wine-
Installer f�r den Build und die Installation von Wine zu verwenden.
Rufen Sie dazu aus dem Wurzelverzeichnis des Wine-Quelltextes (das
diese Datei enth�lt) das folgende Kommando auf:

./tools/wineinstall

Starten Sie Programme mit "wine [Optionen] Programm". Weitere 
Informationen und Probleml�sungen entnehmen Sie bitte dem Rest dieser
Datei, der Man-Page von Wine und insbesondere der Vielzahl an 
Informationen, die Sie auf http://www.winehq.org finden.

3. VORAUSSETZUNGEN

Um Wine kompilieren und ausf�hren zu k�nnen, brauchen Sie eines der
folgenden Betriebssysteme:

  Linux version 2.0.36 oder neuer
  FreeBSD 6.3 oder neuer
  Solaris x86 9 oder neuer
  NetBSD-current
  Mac OS X 10.4 oder neuer

Da Wine Thread-Support auf Kernelebene ben�tigt, werden nur die oben
aufgef�hrten Betriebssysteme unterst�tzt.
Andere Betriebssysteme, die Kernel-Threads unterst�tzen, werden unter
Umst�nden in der Zukunft unterst�tzt.

Linux-Info:
  Obwohl Linux 2.2.x immer noch funktionieren sollte und Linux 2.0.x
  vielleicht auch noch funktioniert (�ltere 2.0.x-Versionen verzeichneten
  Abst�rze im Zusammenhang mit Threads), sollte man am besten einen
  aktuellen Kernel wie 2.4.x oder 2.6.x verwenden.

FreeBSD-Info:
  Stellen Sie sicher, dass Sie die Optionen USER_LDT, SYSVSHM, SYSVSEM und
  SYSVMSG in Ihrem Kernel aktiviert haben. Weitere Informationen finden Sie
  im Ports-Tree: ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/

Solaris-Info:
  H�chstwahrscheinlich m�ssen Sie den Wine-Build mit der GNU-Toolchain
  (gcc, gas etc.) durchf�hren. Warnung: Die Installation von gas stellt nicht
  sicher, dass es vom gcc auch verwendet wird. Den gcc neu zu kompilieren, nach
  der Installation von gas, oder die Symbolischen Links von cc, as und ld
  mit den GNU-Tools zu verkn�pfen, soll ausreichend sein.

NetBSD-Info:
  Stellen Sie sicher, dass Sie die Optionen USER_LDT, SYSVSHM, SYSVSEM und
  SYSVMSG in Ihrem Kernel aktiviert haben.

Mac OS X Info:
  Sie ben�tigen mindestens Xcode 2.4 um richtig unter x86 kompilieren zu k�nnen.

Unterst�tzte Dateisysteme:
  Wine sollte auf den meisten Dateisystemen laufen. Jedoch wird Wine nicht
  starten, wenn umsdos f�r das Verzeichnis /tmp benutzt wird. Ein paar
  Kompatibilit�ts-Probleme wurden auch gemeldet beim Dateizugriff �ber Samba.
  Ausserdem k�nnen wir, da NTFS derzeit nur sicher f�r Lesezugriffe genutzt
  werden kann, den Einsatz von NTFS nicht empfehlen; Windows-Programme
  ben�tigen fast immer Schreibzugriffe.
  Kopieren Sie NTFS-Dateien an einen Ort, an dem Sie Schreibrechte haben.

Grunds�tzliche Voraussetzungen:
  Sie m�ssen die Include-Dateien f�r X11-Entwicklung installiert haben
  (Debian nennt diese xlib6g-dev, Red Hat XFree86-devel).

  Nat�rlich ben�tigen Sie auch "make" (h�chstwahrscheinlich GNU make).

  Des Weiteren ben�tigen Sie flex in der Version 2.5 oder h�her und bison.

Optionale Support-Bibliotheken:
  Der ./configure Aufruf zeigt am Ende optionale Bibliotheken an,
  die von Wine benutzt werden k�nnen, aber auf dem System nicht vorhanden
  sind.

  Auf 64-Bit Plattformen ben�tigen Sie die 32-bit
  Versionen dieser Bibliotheken; siehe dazu http://wiki.winehq.org/WineOn64bit

4. KOMPILIEREN

Wenn Sie sich daf�r entscheiden, wineinstall nicht zu benutzen, f�hren Sie
bitte die folgenden Kommandos f�r den Build von Wine aus:

./configure
make depend
make

Das erledigt den Build des Programms "wine" und verschiedener Support-
Libraries / -Bin�rdateien.
Das Programm "wine" l�dt ausf�hrbare Windows-Dateien und f�hrt sie aus.
Die Library "libwine" ("WineLib") kann benutzt werden, um Windows-Quelltexte
unter Unix zu kompilieren und zu verlinken.

Mit ./configure --help k�nnen Sie sich die Konfigurations-Optionen f�r
die Kompilierung anzeigen lassen.

Um mit Hilfe einer Patch-Datei auf ein neueres Release zu aktualisieren,
wechseln Sie erst mit cd in das Wurzelverzeichnis dieses Releases (eins
�ber dem, welches diese README-Datei enth�lt). Geben Sie dann
"make clean" ein und patchen Sie das Release mit dem Kommando:

    bunzip2 -c Patch-Datei | patch -p1

wobei "Patch-Datei" der Name der Patch-Datei ist (sowas wie
wine-1.0.x.diff.bz2). Sie k�nnen dann erneut "./configure" und danach
"make depend && make" aufrufen.

5. SETUP

Nachdem der Build von Wine korrekt durchgelaufen ist, k�nnen Sie das
Kommando "make install" aufrufen; Dadurch werden das Wine-Programm, die
Man-Page und einige andere ben�tigte Dateien installiert.

Vergessen Sie nicht, erst alle fr�heren Wine-Installationen zu entfernen.
F�hren Sie vor der Installation entweder "dpkg -r wine", "rpm -e wine" oder
"make uninstall" aus.

Die Konfigurations-Hinweise finden Sie im Support-Bereich
von http://www.winehq.org.

Im Falle von Library-Ladefehlern (z.B. "Error while loading shared libraries:
libntdll.so") f�gen Sie bitte den Library-Pfad zur Datei /etc/ld.so.conf hinzu 
und f�hren Sie ldconfig als root aus.

6. AUSF�HREN VON PROGRAMMEN

Wenn Sie Wine aufrufen, k�nnen Sie den vollst�ndigen Pfad zur ausf�hrbaren
Datei angeben oder nur einen Dateinamen.

Beispiel: Um Notepad auszuf�hren:

	wine notepad		   (den Suchpfad, der in der Konfigurations-Datei
	wine notepad.exe	   angegeben wurde, benutzend)

	wine c:\\windows\\notepad.exe  (die Dateinamen-Syntax von DOS benutzend)

	wine ~/.wine/drive_c/windows/notepad.exe  (die Dateinamen-Syntax von Unix benutzend)

        wine notepad.exe /parameter1 -parameter2 parameter3
				   (Programmaufruf mit Parametern)

Hinweis: Der Pfad zur Datei wird auch zum Pfad hinzugef�gt, wenn ein vollst�ndiger
         Dateiname auf der Kommandozeile angegeben wird.

Die Entwicklung von Wine ist noch nicht abgeschlossen, daher k�nnen einige
Programme abst�rzen. Vorausgesetzt, dass Sie winedbg korrekt entsprechend 
documentation/debugger.sgml einrichten, werden Sie dann in einem Debugger landen,
um das Problem untersuchen und beheben zu k�nnen.
Weitere Informationen zu diesem Thema entnehmen Sie bitte der Datei
documentation/debugging.sgml.

Sie sollten Backups von allen wichtigen Dateien machen, auf die Sie Wine 
Zugriff gew�hren, oder spezielle Kopien f�r Wine anlegen, da Benutzer einige
F�lle gemeldet haben, in denen Dateien zerst�rt wurden. F�hren Sie zum Beispiel
NICHT den Explorer aus, wenn Sie kein geeignetes Backup haben, da er manchmal
Verzeichnise verst�mmelt / umbenennnt. Selbst andere MS-Applikationen wie z.B
der Messenger sind nicht sicher, da sie unter Umst�nden den Explorer aufrufen.
Diese spezielle Besch�digung (!$!$!$!$.pfr) kann zumindest teilweise durch
http://home.nexgo.de/andi.mohr/download/decorrupt_explorer behoben werden.

7. WEITERF�HRENDE INFORMATIONEN

WWW:	Eine gro�e Anzahl an Informationen findet sich im WineHQ unter
	http://www.winehq.org/ : Verschiedene Wine Guides, Applikations-Datenbank,
	Fehlerverfolgungs-System. Das ist vermutlich der beste Ausgangspunkt.

FAQ:	Die FAQ zu Wine befindet sich unter http://www.winehq.org/FAQ

Usenet:	Hilfe und Diskussionen zu auf Wine bezogenen Problemen finden Sie unter
	comp.emulators.ms-windows.wine.

Fehler:	Melden Sie Fehler bitte an Wine-Bugzilla unter http://bugs.winehq.org
	Schauen Sie bitte erst in der Bugzilla-Datenbank nach, ob Ihr Problem
	bereits gemeldet wurde, bevor Sie eine Fehlermeldung verfassen. Sie 
	k�nnen Fehlermeldungen auch an comp.emulators.ms-windows.wine schicken.
	Lesen Sie bitte die Datei documentation/bugs.sgml um zu sehen, welche
	Informationen ben�tigt werden.

IRC:	Online-Hilfe wird Ihnen im Chat-Kanal #WineHQ unter irc.freenode.net gew�hrt.

GIT:	Der aktuelle Wine-Entwicklungs-Zweig ist �ber GIT verf�gbar.
	Besuchen Sie http://www.winehq.org/site/git f�r weitere Informationen.

Mailing-Listen:
	Es gibt mehrere Mailing-Listen f�r die Wine-Entwickler; Schauen Sie
	sich bitte dazu http://www.winehq.org/forums an.

Wiki:	Das Wine-Wiki finden Sie unter http://wiki.winehq.org

Wenn Sie etwas hinzuf�gen oder einen Fehler beheben, senden Sie den Patch bitte 
(im 'diff -u'-Format) an die Liste wine-patches@winehq.org, um ihn in die n�chste
Ausgabe aufnehmen zu k�nnen.

--
Alexandre Julliard
julliard@winehq.org

�bersetzung von Christian Britz (Deutschland)
Auf die �bersetzung bezogene Fehlermeldungen,
Anregungen und Kommentare senden Sie bite an:
cbritz@gmx.net