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