| 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, les fichiers dans le |
| répertoire de documentation des sources de Wine (voir "DOCUMENTATION"), |
| 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. |
| |
| Pour le traitement automatique des scripts de la série de tests, vous aurez |
| également besoin des en-têtes de développement de libperl (package libperl-dev |
| sous Debian). |
| |
| Pour la configuration nécessaire si vous avez l'intention de construire la |
| documentation vous-même voyez la section "DOCUMENTATION". |
| |
| 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. |
| |
| Si vou désirez lire la documentation fournie avec les sources de Wine, voyez la |
| section "DOCUMENTATION". |
| |
| Wine a besoin d'un fichier de configuration nommé "config" dans votre répertoire |
| ~/.wine. Le format de ce fichier est expliqué dans la page man du fichier de |
| configuration (documentation/wine.conf.man). |
| Le fichier documentation/samples/config contient un exemple de fichier de |
| configuration qui doit être adapté et copié vers la localisation mentionnée |
| ci-dessus. |
| |
| Naviguez dans la section Support à http://www.winehq.org/ pour plus d'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. DOCUMENTATION |
| |
| Certaines documentations (divers Guides Wine etc) peuvent être trouvées dans |
| le répertoire documentation/ (à part ceux disponibles également sur WineHQ) |
| |
| Si vou voulez construire les fichier SGML ici, vous pouvez exécuter la |
| commande "make doc" dans le répertoire documentation/. |
| Pour le faire vous aurrez besoin des outils du package sgml (pour db2html, |
| db2ps, db2pdf) nommés : |
| Debian: docbook-utils |
| Mandrake: sgml-tools-A.B.C-DDmdk |
| SuSE: docbktls-A.BB.C-DD |
| |
| 8. 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 |
