documentation/README.fr

   1 1. INTRODUCTION
   2
   3 Wine est un programme qui permet d'exécuter les logiciels écrits
   4 pour Microsoft Windows (comprenant les exécutables DOS, Windows 3.x
   5 et Win32) sur un Unix. Il est composé d'un chargeur qui charge et
   6 exécute un binaire Microsoft Windows, ainsi que d'une librairie (appelée
   7 Winelib) qui implémente les appels de l'API de Windows par leur
   8 équivalent Unix ou X11. Cette librairie peut également être utilisée
   9 pour porter du code Win32 vers un exécutable Unix natifs.
  10
  11 Wine est un logiciel libre, distribué sous GNU LGPL; lisez le fichier
  12 LICENCE pour les détails.
  13
  14 2. DÉMARRAGE RAPIDE
  15
  16 Même si vous compilez à partir des sources, il est recommandé d'utiliser
  17 l'Installateur de Wine pour construire et installer Wine. À partir du
  18 répertoire le plus élevé des sources de Wine (qui contient ce fichier),
  19 exécutez :
  20
  21 ./tools/wineinstall
  22
  23 Pour exécuter les programmes, tapez "wine [options] programme". Pour des
  24 informationS complémentaires et des résolutions de problèmes, lisez le
  25 reste de ce fichier, les pages "man" de Wine, les fichiers dans le
  26 répertoire de documentation des sources de Wine (voir "DOCUMENTATION"),
  27 et surtout les nombreuses informations que vous trouverez sur
  28 http://www.winehq.com.
  29
  30 3. CONFIGURATION NÉCESSAIRE
  31
  32 Pour compiler et exécuter Wine, vous devez avoir un des systèmes
  33 d'exploitation qui suit :
  34
  35         Linux version 2.0.36 ou supérieur
  36         FreeBSD 4.x or FreeBSD 5-CURRENT
  37         Solaris x86 2.5 ou supérieur
  38         NetBSD-current
  39
  40 Information Linux :
  41   Bien que les versions Linux 2.0.x fonctionneront en général, certaines
  42   caractéristiques (surtout le partage LDT) nécessaires pour faire
  43   fonctionner les "threads" Win32 n'étaient implémentés avant les kernels 2.2.
  44   Si vous avez constamment des plantages dû aux "threads", vous devriez
  45   considérer de vous mettre à jour au noyau 2.2. Aussi certains bogues ont été
  46   fixés et de nouvelles fonctionnalités ont été ajoutées aux dernières versions
  47   du noyau 2.0.x, ainsi si vous avez un noyau Linux très ancien, mettez-le à
  48   jour au moins au dernier 2.0.x.
  49
  50 Information FreeBSD :
  51   Assurez-vous d'avoir les options USER_LDT, SYSVSHM, SYSVSEM, and SYSVMSG
  52   enclanchées dans votre noyau.
  53   Plus d'information est située dans l'arbre de ports :
  54   ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/
  55
  56 Information Solaris :
  57   Il est plus que probable que vous devrez construire Wine avec la chaîne
  58   d'outils GNU (gcc, gas, etc.). Avertissement : intaller gas n'assure pas
  59   qu'il sera utilisé par gcc.  Recompliler gcc après l'installation de gas
  60   ou créer un lien symbolique de cc, as et ld vers les outils GNU semble
  61   nécessaire.
  62
  63 Information NetBSD :
  64   Assurez-vous d'avoir les options USER_LDT, SYSVSHM, SYSVSEM, and SYSVMSG
  65   enclanchées dans votre noyau.
  66
  67 Information des système de fichier :
  68   Wine devrait fonctionner sur la plupart des systèmes de fichier. Cependant
  69   Wine s'arrêtera au démarrage si umsdos est utilisé pour le répertoire /tmp.
  70   Quelques problèmes de compatibilité ont aussi été rapportés sur
  71   l'utilisation des fichiers accédés au travers de Samba. Egalement, puisque
  72   NTFS ne peut être utilisé en sécurité qu'avec un accès en lecture seul pour
  73   le moment, nous recommandons de ne pas utiliser NTFS, parce que les
  74   programmes Windows on besoin des accès en écriture presque partout. Si vous
  75   avez des fichier NTFS, copiez les vers une localisation accessible en
  76   écriture.
  77
  78 Wine a besoin de "threads" du niveau noyau. Actuellement, seul Linux version
  79 2.0 ou supérieur, FreeBSD 4.x ou supérieur, Solaris x86 version 2.5 ou supérieur
  80 et NetBSD-current sont supportés. D'autres systèmes d'exploitations qui
  81 implémentent les "threads" noyau peuvent être supportés dans le futur.
  82
  83 Vous avez besoin d'avoir les fichiers "include" de X11 installés
  84 (appelés xlib6g-dev pour Debian et XFree86-devel pour RedHat).
  85 Pour utiliser le support de Wine pour des applications multi-threads
  86 vos librairies X doivent être réentrantes, ce qui est probalblement la
  87 configuration par défaut à l'heure actuelle. Si vous possédez libc6 (glibc2)
  88 ou que vous compilez les librairies X vous-même, elles ont probablement été
  89 compilées avec l'option réentrant enclanchée.
  90
  91 Sur les système x86, gcc >= 2.7.2 est nécessaire. Les versions inférieures à
  92 la 2.7.2.3 peuvent créer des ennuis losrque certains fichiers sont compilés
  93 avec l'optimisation, souvent dû à des problèmes de gestion d'en-tête de fichier.
  94 pgcc ne fonctionne pas actuellement avec Wine. La cause de ce problème est
  95 inconnue.
  96
  97 Évidemment, vous aurez besoin de "make" (très probablement GNU make).
  98
  99 Vous aurez également besoin de flex version 2.5 ou supérieure et yacc.
 100 Bison fonctionnera en replacement de yacc. Si vous utilisez RedHat ou Debian,
 101 installez les paquets flex et bison.
 102
 103 Pour le traitement automatique des scripts de la série de tests, vous aurez
 104 également besoin des en-têtes de développement de libperl (package libperl-dev
 105 sous Debian).
 106
 107 Pour la configuration nécessaire si vous avez l'intention de construire la
 108 documentation vous-même voyez la section "DOCUMENTATION".
 109
 110 4. COMPILATION
 111
 112 Au cas où vous choisissez de ne pas utiliser wineinstall, exécuter les com-
 113 mandes suivantes pour construire Wine :
 114
 115 ./configure
 116 make depend
 117 make
 118
 119 Cela va constuire le programme "wine" et de nombreux binaires/librairies de
 120 support.
 121 Le programme "wine" chargera et exécutera les exécutables Windows.
 122 La librairie "libwine" ("Winelib") peut être utilisée pour compiler et lier
 123 le code source Windows sous Unix.
 124
 125 Pour voir les options de compilation, tapez ./configure --help.
 126
 127 Pour mettre à jour une nouvelle version en utilisant les fichiers patch, tout
 128 d'abord aller dans le répertoire de plus haut niveau de la version actuelle
 129 (celui qui contient ce fichier README.fr). Ensuite faire un "make clean", et
 130 patcher la version avec :
 131
 132     gunzip -c patch-file | patch -p1
 133
 134 Avec "patch-file" qui est le nom du fichier de patche (quelque chose de
 135 similaire à Wine-yymmdd.diff.gz). Vous pouvez réexécuter "./configure", et
 136 ensuite taper "make depend && make".
 137
 138 5. SETUP
 139
 140 Un fois que Wine a été construit correctement, vous pouvez tapez "make install";
 141 cela installera l'exécutable wine, les pages man Wine et quelques autres fichiers
 142 nécessaires.
 143
 144 N'oubliez pas de désinsatller toutes les installations précédantes de wine.
 145 Essayez soit "dpkg -r wine", "rpm -e wine" ou "make uninstall" avant
 146 d'installer.
 147
 148 Si vou désirez lire la documentation fournie avec les sources de Wine, voyez la
 149 section "DOCUMENTATION".
 150
 151 Wine a besoin d'un fichier de configuration nommé "config" dans votre répertoire
 152 ~/.wine. Le format de ce fichier est expliqué dans la page man du fichier de
 153 configuration (documentation/wine.conf.man).
 154 Le fichier documentation/samples/config contient un exemple de fichier de
 155 configuration qui doit être adapté et copié vers la localisation mentionnée
 156 ci-dessus.
 157
 158 N'oubliez pas d'ajouter des entrées de registre virtuelle en applicant
 159 winedefault.reg avec programs/regapi/. Voyez le répertoire documentation/ pour
 160 les détails.
 161
 162 Naviguez sur http://www.winehq.com/support/ pour plus d'astuce de configuration.
 163
 164 En cas d'erreur de chargement de librairie (par exemple
 165 "Error while loading shared libraries: libntdll.so"), assurez vous d'ajouter
 166 le chemin des librairies à /etc/ld.so.conf et exécuter ldconfig en tant que root.
 167
 168 Pour pouvoir vérifier l'exactitude de l'environnement dont vous avez besoin pour
 169 que Wine s'exécute correctement, vous pouvez exécuter "./tools/winecheck | less".
 170 Vous aurez un score en pourcentage indiquant "l'exactitude de la configuration
 171 de Wine". Ce programme est encore en développement alpha, il n'effectue pas
 172 encore un véritable test en profondeur, il devrait cependant être utile dans
 173 une première vérification.
 174
 175 Lisez les page man de wine.conf pour savoir comment basculer en un mode texte
 176 uniquement.
 177
 178 6. EXÉCUTER DES PROGRAMMES
 179
 180 Lorsque l'on invoque Wine, vous pouvez spécifier le chemin entier vers
 181 l'exécutable ou seulement le nom de fichier.
 182
 183 Pour exécuter Solitaire par exemple :
 184
 185         wine sol                   (en utilisant le chemin d'accès pour
 186                                     localiser le fichier)
 187         wine sol.exe
 188
 189         wine c:\\windows\\sol.exe  (en utilisant un nom de fichier DOS)
 190
 191         wine /usr/windows/sol.exe  (en utilisant un nom de fichier Unix)
 192
 193 Note: le chemin du fichier sera également additionné au chemin par défaut
 194       lorsque le nom entier est écrit sur la ligne de commande.
 195
 196 Wine n'est pas encore complet, ainsi quelque programmes peuvent planter. Selon
 197 que vous avez installé correctement winedbg d'après documentation/debugger.sgml,
 198 vous entrerez dans le débogueur vous permettant d'enquêter et de résoudre le
 199 problème. Pour plus d'information sur la manière de le faire, veuillez lire
 200 le fichier documentation/debugging.sgml.
 201
 202 Vous devriez sauvegarder tous vos fichier important auquels vous donnez accès
 203 à Wine ou utiliser une copie spéciale pour Wine, puisque dans certain cas des
 204 utilisateurs ont rapporté des corruptions de fichiers. Ne PAS
 205 éxécuter l'Explorateur, par exemple, si vous n'avez pas une copie propre,
 206 puisque il renomme/corrompt parfois plusieurs répertoires. Même certaines
 207 application MS telle Messenger par exemple ne sont pas sûres puisqu'elle
 208 peuvent lancer l'Explorateur dans certains cas. Certaines corruptions
 209 particulières telle (!$!$!$!$.pfr) peut du moins être partiellement
 210 fixée en utilisant la méthode décrite par
 211 http://home.nexgo.de/andi.mohr/download/decorrupt_explorer
 212
 213 7. DOCUMENTATION
 214
 215 Certaines documentations (divers Guides Wine etc) peuvent être trouvées dans
 216 le répertoire documentation/ (à part ceux disponibles également sur WineHQ)
 217
 218 Si vou voulez construire les fichier SGML ici, vous pouvez exécuter la
 219 commande "make doc" dans le répertoire documentation/.
 220 Pour le faire vous aurrez besoin des outils du package sgml (pour db2html,
 221 db2ps, db2pdf) nommés :
 222 Debian:         docbook-utils
 223 Mandrake:       sgml-tools-A.B.C-DDmdk
 224 SuSE:           docbktls-A.BB.C-DD
 225
 226 8. OPTENIR PLUS D'INFORMATIONS
 227
 228 WWW:    Baucoup d'informations à propos de Wine sont disponibles sur WineHQ à
 229         http://www.winehq.com/ : divers Guides Wine, base de donnée
 230         d'applications, suivit de bogues. C'est probablement le meilleur point
 231         de départ.
 232
 233 FAQ:    La Foire Aux Questions de Wine est localisée à :
 234         http://www.winehq.com/FAQ
 235
 236 Usenet: Vous pouvez parler des problèmes ou résolutions en relation avec Wine
 237         ou optenir de l'aide sur comp.emulators.ms-windows.wine.
 238
 239 Bugs:   Rapportez les bogues à Wine Bugzilla à http://bugs.winehq.com/.
 240         SVP cherchez tout d'abord dans la base de donnée de bugzilla
 241         pour contrôler que le problème n'est pas déjà découvert avant
 242         de poster un rapport de bogue. Vous pouvez également rapporter
 243         des rapports de bogue à comp.emulators.ms-windows.wine.
 244         SVP lisez le fichier documentation/bugs.sgml pour connaître les
 245         informations nécessaires.
 246
 247 IRC:    L'aide en ligne est disponible sur le cannal #WineHQ sur
 248         irc.freenode.net.
 249
 250 CVS:    L'arbre de développement actuel de Wine est disponible au travers
 251         de CVS.
 252         Allez sur http://www.winehq.com/development/ pour plus d'informations
 253
 254 Mailing lists:
 255         Il existe de multiples mailing lists pour les développeurs de Wine;
 256         repportez-vous à http://www.winehq.com/development/#ml pour de plus
 257         amples informations.
 258
 259 Si vous ajoutez quelquechose ou fixez un bogue, envoyez un patch (dans le
 260 format 'diff -u' ) à la liste de diffusion wine-patches@winehq.com  pour son
 261 inclusion dans la prochaine version.
 262
 263 --
 264 Alexandre Julliard
 265 julliard@winehq.com