| 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.com. |
| |
| 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 |
| Solaris x86 2.5 ou supérieur |
| NetBSD-current |
| |
| Information Linux : |
| Bien que les versions Linux 2.0.x fonctionneront en général, certaines |
| caractéristiques (surtout le partage LDT) nécessaires pour faire |
| fonctionner les "threads" Win32 n'étaient implémentés avant les kernels 2.2. |
| Si vous avez constamment des plantages dû aux "threads", vous devriez |
| considérer de vous mettre à jour au noyau 2.2. Aussi certains bogues ont été |
| fixés et de nouvelles fonctionnalités ont été ajoutées aux dernières versions |
| du noyau 2.0.x, ainsi si vous avez un noyau Linux très ancien, mettez-le à |
| jour au moins au dernier 2.0.x. |
| |
| Information FreeBSD : |
| Assurez-vous d'avoir les options USER_LDT, SYSVSHM, SYSVSEM, and SYSVMSG |
| enclanchées dans votre noyau. |
| 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. |
| |
| Information des système de fichier : |
| 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. |
| |
| Wine a besoin de "threads" du niveau noyau. Actuellement, seul Linux version |
| 2.0 ou supérieur, FreeBSD 4.x ou supérieur, Solaris x86 version 2.5 ou supérieur |
| et NetBSD-current sont supportés. D'autres systèmes d'exploitations qui |
| implémentent les "threads" noyau peuvent être supportés dans le futur. |
| |
| Vous avez besoin d'avoir les fichiers "include" de X11 installés |
| (appelés xlib6g-dev pour Debian et XFree86-devel pour RedHat). |
| Pour utiliser le support de Wine pour des applications multi-threads |
| vos librairies X doivent être réentrantes, ce qui est probalblement la |
| configuration par défaut à l'heure actuelle. Si vous possédez libc6 (glibc2) |
| ou que vous compilez les librairies X vous-même, elles ont probablement été |
| compilées avec l'option réentrant enclanchée. |
| |
| 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 yacc. |
| Bison fonctionnera en replacement de yacc. Si vous utilisez RedHat ou Debian, |
| installez les paquets flex et bison. |
| |
| 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. |
| |
| N'oubliez pas d'ajouter des entrées de registre virtuelle en applicant |
| winedefault.reg avec programs/regapi/. Voyez le répertoire documentation/ pour |
| les détails. |
| |
| Naviguez sur http://www.winehq.com/support/ pour plus d'astuce 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. |
| |
| Pour pouvoir vérifier l'exactitude de l'environnement dont vous avez besoin pour |
| que Wine s'exécute correctement, vous pouvez exécuter "./tools/winecheck | less". |
| Vous aurez un score en pourcentage indiquant "l'exactitude de la configuration |
| de Wine". Ce programme est encore en développement alpha, il n'effectue pas |
| encore un véritable test en profondeur, il devrait cependant être utile dans |
| une première vérification. |
| |
| Lisez les page man de wine.conf pour savoir comment basculer en un mode texte |
| uniquement. |
| |
| 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 pour |
| localiser le fichier) |
| wine sol.exe |
| |
| wine c:\\windows\\sol.exe (en utilisant un nom de fichier DOS) |
| |
| wine /usr/windows/sol.exe (en utilisant un nom de fichier Unix) |
| |
| 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.com/ : 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.com/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.com/. |
| 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.com/development/ pour plus d'informations |
| |
| Mailing lists: |
| Il existe de multiples mailing lists pour les développeurs de Wine; |
| repportez-vous à http://www.winehq.com/development/#ml 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.com pour son |
| inclusion dans la prochaine version. |
| |
| -- |
| Alexandre Julliard |
| julliard@winehq.com |