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 librairie (appel�e
Winelib) qui impl�mente les appels de l'API de Windows par leur
�quivalent Unix ou X11. Cette librairie peut �galement �tre utilis�e
pour porter du code Win32 vers un ex�cutable Unix natifs.

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

2. D�MARRAGE RAPIDE

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

./tools/wineinstall

Pour ex�cuter les programmes, 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 sup�rieur
	FreeBSD 4.x or FreeBSD 5-CURRENT ou sup�rieur
	Solaris x86 2.5 ou sup�rieur
	NetBSD-current

�tant donn� que Wine n�cessite une impl�mentation des "threads" au niveau du
noyau, seuls les syst�mes d'exploitation mentionn�s ci-haut sont support�s.
D'autres syst�mes d'exploitation qui impl�mentent les "threads" noyau peuvent
�tre support�s dans le futur.

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

Information FreeBSD :
  Wine devrait pouvoir �tre compil� sur FreeBSD 4.x et FreeBSD 5.x, mais les
  versions ant�rieures � FreeBSD 5.3 ne fonctionneront g�n�ralement pas.

  Plus d'information est situ�e dans l'arbre de ports :
  ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/

Information Solaris :
  Il est plus que probable que vous devrez construire Wine avec la cha�ne
  d'outils GNU (gcc, gas, etc.). Avertissement : intaller gas n'assure pas
  qu'il sera utilis� par gcc.  Recompliler 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, and SYSVMSG
  enclanch�es dans votre noyau.

Syst�mes de fichier support�s :
  Wine devrait fonctionner sur la plupart des syst�mes de fichier. Cependant
  Wine s'arr�tera au d�marrage si umsdos est utilis� pour le r�pertoire /tmp.
  Quelques probl�mes de compatibilit� ont aussi �t� rapport�s sur
  l'utilisation des fichiers acc�d�s au travers de Samba. Egalement, puisque
  NTFS ne peut �tre utilis� en s�curit� qu'avec un acc�s en lecture seul pour
  le moment, nous recommandons de ne pas utiliser NTFS, parce que les
  programmes Windows on besoin des acc�s en �criture presque partout. Si vous
  avez des fichier NTFS, copiez les vers une localisation accessible en
  �criture.

Configuration requise de base :
Vous avez besoin d'avoir les fichiers "include" de X11 install�s
(appel�s xlib6g-dev pour Debian et XFree86-devel pour RedHat).

Configuration requise des outils de compilation :
Sur les syst�me x86, gcc >= 2.7.2 est n�cessaire. Les versions inf�rieures �
la 2.7.2.3 peuvent cr�er des ennuis losrque certains fichiers sont compil�s
avec l'optimisation, souvent d� � des probl�mes de gestion d'en-t�te de fichier.
pgcc ne fonctionne pas actuellement avec Wine. La cause de ce probl�me est
inconnue.

�videmment, vous aurez besoin de "make" (tr�s probablement GNU make).

Vous aurez �galement besoin de flex version 2.5 ou sup�rieure et bison.
Si vous utilisez RedHat ou Debian, installez les paquets flex et bison.

Librairies optionnelles :
  Si vous voulez un support d'impression � l'aide de CUPS, SVP installez � la
  fois les packages cups et cups-devel.

4. COMPILATION

Au cas o� vous choisissez de ne pas utiliser wineinstall, ex�cuter les com-
mandes suivantes pour construire Wine :

./configure
make depend
make

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

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

Pour mettre � jour une nouvelle version en utilisant les fichiers patch, 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
patcher la version avec :

    gunzip -c patch-file | patch -p1

Avec "patch-file" qui est le nom du fichier de patche (quelque chose de
similaire � Wine-yymmdd.diff.gz). Vous pouvez r�ex�cuter "./configure", et
ensuite taper "make depend && make".

5. SETUP

Un fois que 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�sinsatller toutes les installations pr�c�dantes de wine.
Essayez soit "dpkg -r wine", "rpm -e wine" ou "make uninstall" avant
d'installer.

Naviguez dans la section Support � http://www.winehq.org/ pour pd'astuces
de configuration.

En cas d'erreur de chargement de librairie (par exemple
"Error while loading shared libraries: libntdll.so"), assurez vous d'ajouter
le chemin des librairies � /etc/ld.so.conf et ex�cuter ldconfig en tant que root.

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 Solitaire par exemple :

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

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

	wine /usr/windows/sol.exe  (en utilisant la syntaxe de fichiers Unix)

	wine sol.exe /parametre1 -parametre2 parametre3
			(en appelant le programme avec des param�tres)

Note: le chemin du fichier sera �galement additionn� au chemin par d�faut
      lorsque le nom entier est �crit sur la ligne de commande.

Wine n'est pas encore complet, ainsi quelque programmes peuvent planter. Selon
que vous avez install� correctement winedbg d'apr�s documentation/debugger.sgml,
vous entrerez dans le d�bogueur vous permettant d'enqu�ter et de r�soudre le
probl�me. Pour plus d'information sur la mani�re de le faire, veuillez lire
le fichier documentation/debugging.sgml.

Vous devriez sauvegarder tous vos fichier important auquels vous donnez acc�s
� Wine ou utiliser une copie sp�ciale pour Wine, puisque dans certain cas des
utilisateurs ont rapport� des corruptions de fichiers. Ne PAS
�x�cuter l'Explorateur, par exemple, si vous n'avez pas une copie propre,
puisque il renomme/corrompt parfois plusieurs r�pertoires. M�me certaines
application MS telle Messenger par exemple ne sont pas s�res puisqu'elle
peuvent lancer l'Explorateur dans certains cas. Certaines corruptions
particuli�res telle (!$!$!$!$.pfr) peut du moins �tre partiellement
fix�e en utilisant la m�thode d�crite par
http://home.nexgo.de/andi.mohr/download/decorrupt_explorer

7. OPTENIR PLUS D'INFORMATIONS

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

FAQ:	La Foire Aux Questions de Wine est localis�e � :
	http://www.winehq.org/FAQ

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

Bugs:	Rapportez les bogues � Wine Bugzilla � http://bugs.winehq.org
	SVP cherchez tout d'abord dans la base de donn�e de bugzilla
	pour contr�ler que le probl�me n'est pas d�j� d�couvert avant
	de poster 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 cannal #WineHQ sur
	irc.freenode.net.

CVS:	L'arbre de d�veloppement actuel de Wine est disponible au travers
	de CVS.
	Allez sur http://www.winehq.org/cvs pour plus d'informations

Mailing lists:
	Il existe de multiples mailing lists pour les d�veloppeurs de Wine;
	repportez-vous � http://www.winehq.org/forums pour de plus
	amples informations.

Si vous ajoutez quelquechose ou fixez un bogue, envoyez un patch (dans le
format 'diff -u' ) � la liste de diffusion wine-patches@winehq.org  pour son
inclusion dans la prochaine version.

--
Alexandre Julliard
julliard@winehq.org