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, den Dateien im Dokumentations-Verzeichnis
des Wine-Quelltextes (siehe "DOKUMENTATION") 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 4.x oder FreeBSD 5-CURRENT oder neuer
  Solaris x86 2.5 oder neuer
  NetBSD-current

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 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.

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, RedHat XFree86-devel).

Vorausgesetzte Build-Tools:
  Auf x86-Systemen wird der gcc >= 2.7.2 ben�tigt.
  Versionen vor 2.7.2.3 k�nnen Probleme damit haben, wenn bestimmte Dateien
  mit Optimierungen kompiliert werden, oft im Zusammenhang mit Problemen mit
  der Verwaltung von Header-Dateien. pgcc arbeitet derzeit nicht mit Wine.
  Die Ursache dieses Problems ist unbekannt.

  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.
  Wenn Sie RedHat oder Debian benutzen, installieren Sie bitte die flex-
  und bison-Pakete.

Optionale Support-Libraries:
  Wenn Sie CUPS Drucker-Unterst�tzung haben wollen, installieren Sie bitte
  die Pakete cups und cups-devel.

Die Voraussetzungen f�r das selbst�ndige Durchf�hren des Builds der
Dokumentation entnehmen Sie bitte dem Abschnitt "DOKUMENTATION".

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,
wechsen Sie erst mit cd in das Wurzelverzeichnis dieses Releases (das,
welches diese README-Datei enth�lt). Geben Sie dann "make clean" ein
und patchen Sie das Release mit dem Kommando:

    gunzip -c patch-file | patch -p1

wobei "patch-file" der Name der Patch-Datei ist (etwas wie
Wine-yymmdd.diff.gz). 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.

Wenn Sie die mit dem Wine-Quelltext gelieferte Dokumentation lesen wollen,
schauen Sie sich bitte den Abschnitt "DOKUMENTATION" an.

Wine ben�tigt eine Konfigurations-Datei namens "config" in Ihrem
~/.wine-Verzeichnis. Das Format dieser Datei wird in der Man-Page der
Konfigurations-Datei erkl�rt (documentation/wine.conf.man).
Die Datei documentation/samples/config enth�lt eine beispielhafte
Konfigurations-Datei, die angepasst und an die oben erw�hnte Stelle
kopiert werden muss.

Weitere 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 Solitaire auszuf�hren:

	wine sol		   (den Suchpfad, der in der Konfiguartions-Datei 
	wine sol.exe		   angegeben wurde, benutzend)

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

	wine /usr/windows/sol.exe  (die Dateinamen-Syntax von Unix benutzend)

        wine sol.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. DOKUMENTATION

Im Verzeichnis documentation/ befindet sich einiges an Dokumentation (verschiedene
Wine-Guides usw.). Sie sind auch im WineHQ verf�gbar.

Wenn Sie die SGML-Dateien dort verarbeiten m�chten, k�nnen Sie das Kommando
"make doc" im Verzeichnis documentation/ ausf�hren.
Daf�r wird das Paket "sgml tools" vorausgesetzt (f�r db2html, db2ps, db2pdf):
Debian:		docbook-utils
Mandrake:	sgml-tools-A.B.C-DDmdk
SuSE:		docbktls-A.BB.C-DD

8. 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.

CVS:	Der aktuelle Wine-Entwicklungs-Tree ist �ber CVS verf�gbar.
	Besuchen Sie http://www.winehq.org/cvs 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.

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