1. INTRODUCTION

Wine est un programme qui permet d'ex�cuter les logiciels �crits
pour Microsoft Windows (comprenant les ex�cutables DOS, Windows 3.x
et Win32) sur un Unix. Il est compos� d'un chargeur qui charge et
ex�cute un binaire Microsoft Windows, ainsi que d'une biblioth�que (appel�e
Winelib) qui impl�mente les appels de l'API de Windows par leur
�quivalent Unix ou X11. Cette biblioth�que peut �galement �tre utilis�e
pour porter du code Win32 vers un ex�cutable Unix natif.

Wine est un logiciel libre, distribu� sous GNU LGPL; lisez le fichier
LICENSE pour les d�tails.

2. D�MARRAGE RAPIDE

Quand vous compilez � partir des sources, il est recommand� d'utiliser
l'Installateur de Wine pour construire et installer Wine. � partir du
r�pertoire racine des sources de Wine (qui contient ce fichier),
ex�cutez :

./tools/wineinstall

Pour ex�cuter un programme, tapez "wine [options] programme". Pour des
informations compl�mentaires et des r�solutions de probl�mes, lisez le
reste de ce fichier, les pages "man" de Wine, et surtout les nombreuses 
informations que vous trouverez sur http://www.winehq.org.

3. CONFIGURATION N�CESSAIRE

Pour compiler et ex�cuter Wine, vous devez avoir un des syst�mes
d'exploitation qui suit :

	Linux version 2.0.36 ou ult�rieur
	FreeBSD 6.3 ou ult�rieur
	Solaris x86 9 ou ult�rieur
	NetBSD-current
	Mac OS X 10.4 ou ult�rieur

�tant donn� que Wine n�cessite une impl�mentation des "threads" (processus
l�gers) au niveau du noyau, seuls les syst�mes d'exploitation mentionn�s
ci-haut sont support�s. D'autres syst�mes d'exploitation impl�mentant les
threads noyau peuvent �tre pris en charge dans le futur.

Information Linux :
  Bien que Linux 2.2.x devrait encore fonctionner et que Linux 2.0.x pourrait
  encore marcher (des versions plus anciennes de 2.0.x avaient des plantages
  dus aux threads), il est pr�f�rable d'avoir un noyau r�cent tel que 2.4.x
  ou 2.6.x.

Information FreeBSD :
  Wine ne fonctionnera g�n�ralement pas bien pour les versions FreeBSD
  ant�rieures � 6.3 ou 7.0 (certains patches additionnels sont disponibles pour
  FreeBSD 6.3). Voyez <http://wiki.freebsd.org/Wine> pour plus d'informations.

Information Solaris :
  Il est plus que probable que vous devrez construire Wine avec la cha�ne
  d'outils GNU (gcc, gas, etc.). Attention : installer gas n'assure pas
  qu'il sera utilis� par gcc.  Recompiler gcc apr�s l'installation de gas
  ou cr�er un lien symbolique de cc, as et ld vers les outils GNU semble
  n�cessaire.

Information NetBSD :
  Assurez-vous d'avoir les options USER_LDT, SYSVSHM, SYSVSEM et SYSVMSG
  activ�es dans votre noyau.

Information Mac OS X :
  Xcode 2.4 ou ult�rieur est n�cessaire pour compiler Wine sous x86.


Syst�mes de fichiers pris en charge :
  Wine devrait fonctionner sur la plupart des syst�mes de fichiers. Certains
  probl�mes de compatibilit� ont �t� rapport�s lors de l'utilisation de fichiers
  acc�d�s via Samba. De plus, NTFS ne fournit pas toutes les fonctionnalit�s de
  syst�me de fichiers n�cessaires pour certains applications. L'utilisation d'un
  syst�me de fichiers Linux natif comme ext3 est recommand�e.

Configuration requise de base :
  Les fichiers "include" de X11 (appel�s xlib6g-dev sous Debian et XFree86-devel
  sous RedHat) doivent �tre install�s.

  Bien entendu, vous aurez besoin du programme "make" (tr�s probablement GNU
  make).

  Flex 2.5 ou ult�rieur, ainsi que bison, sont �galement requis.

Biblioth�ques optionnelles :
  "Configure" affichera des messages quand des biblioth�ques optionnelles ne
  sont pas d�tect�es sur votre syst�me. Consultez
  http://wiki.winehq.org/Recommended_Packages (en anglais) pour des indications
  sur les paquets logiciels que vous devriez installer.

  Sur les plates-formes 64 bits, vous devez installer les versions 32 bits de
  ces biblioth�ques. Voyez http://wiki.winehq.org/WineOn64bit (en anglais) pour
  les d�tails.

4. COMPILATION

Au cas o� vous choisiriez de ne pas utiliser wineinstall, ex�cutez les commandes
suivantes pour construire Wine :

./configure
make depend
make

Cela va construire le programme "wine" et de nombreux binaires/biblioth�ques de
support.
Le programme "wine" chargera et ex�cutera les ex�cutables Windows.
La biblioth�que "libwine" ("Winelib") peut �tre utilis�e pour compiler et lier
du code source Windows sous Unix.

Pour voir les options de compilation, tapez ./configure --help.

Pour mettre � jour vers une nouvelle version en utilisant les fichiers de mise �
niveau, tout d'abord aller dans le r�pertoire de plus haut niveau de la version
actuelle (celui qui contient ce fichier README.fr). Ensuite faire un "make
clean", et mettre � jour la version avec :

    bunzip2 -c fichier-patch | patch -p1

o� "fichier-patch" est le nom du fichier de mise � niveau (quelque chose du
genre wine-1.0.x.diff.bz2). Vous pouvez ensuite r�ex�cuter "./configure", et
taper ensuite "make depend && make".

5. INSTALLATION

Une fois Wine a �t� construit correctement, vous pouvez tapez "make install" :
cela installera l'ex�cutable wine, les pages man Wine et quelques autres
fichiers n�cessaires.

N'oubliez pas de d�sinstaller toutes les installations pr�c�dentes de wine.
Essayez soit "dpkg -r wine", "rpm -e wine" ou "make uninstall" avant
d'installer une nouvelle version.

Une fois l'installation termin�e, vous pouvez naviguer dans la section Support �
http://www.winehq.org/ pour obtenir des astuces de configuration.


6. EX�CUTER DES PROGRAMMES

Lorsque l'on invoque Wine, vous pouvez sp�cifier le chemin entier vers
l'ex�cutable ou seulement le nom de fichier.

Pour ex�cuter le bloc-notes par exemple :

	wine notepad		       (en utilisant le chemin d'acc�s sp�cifi�
	wine notepad.exe	        dans le fichier "config" pour localiser
				        le fichier)

	wine c:\\windows\\notepad.exe  (en utilisant la syntaxe de fichiers DOS)

	wine ~/.wine/drive_c/windows/notepad.exe  (en utilisant la syntaxe Unix)

	wine notepad.exe /param�tre1 -param�tre2 param�tre3
			(en appelant le programme avec des param�tres)

Wine n'est pas encore termin� ; ainsi quelques programmes peuvent planter. Quand
cela se produit, un d�bogueur est d�marr� � l'endroit du plantage pour que vous
puissiez essayer de r�soudre le probl�me.  Pour plus d'informations sur la
mani�re de faire, veuillez lire la section "d�boguage" du Guide du d�veloppeur
Wine (Wine Developer's Guide).


7. INFORMATIONS COMPL�MENTAIRES

WWW	Beaucoup d'informations � propos de Wine sont disponibles sur WineHQ �
	http://www.winehq.org/ : divers guides Wine, base de donn�es
	d'applications, suivi de bogues. C'est probablement le meilleur point
	de d�part.

FAQ	La Foire Aux Questions de Wine se trouve sur http://www.winehq.org/FAQ

Usenet	Vous pouvez parler des probl�mes en relation avec Wine
	ou obtenir de l'aide sur comp.emulators.ms-windows.wine.

Bogues	Rapportez les bogues � Wine Bugzilla � http://bugs.winehq.org
	SVP cherchez tout d'abord dans la base de donn�es de bugzilla
	pour contr�ler que le probl�me n'est pas d�j� d�couvert avant
	de soumettre un rapport de bogue. Vous pouvez �galement rapporter
	des rapports de bogue � comp.emulators.ms-windows.wine.
	SVP lisez le fichier documentation/bugs.sgml pour conna�tre les
	informations n�cessaires.

IRC	L'aide en ligne est disponible sur le canal #WineHQ sur
	irc.freenode.net.

GIT	L'arbre de d�veloppement actuel de Wine est disponible au travers de
	GIT. Voyez http://www.winehq.org/site/git pour plus d'informations.

Listes de diffusion
	Il existe de multiples listes de diffusion pour les d�veloppeurs Wine ;
	voyez http://www.winehq.org/forums pour de plus amples informations.

Wiki	Le wiki Wine est situ� sur http://wiki.winehq.org


Si vous ajoutez quelque chose ou corrigez un bogue, envoyez un correctif (dans le
format 'diff -u' ) � la liste de diffusion wine-patches@winehq.org pour qu'il
soit inclus dans la prochaine version.

--
Alexandre Julliard
julliard@winehq.org