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.org.
  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 ou supérieur
  37         Solaris x86 2.5 ou supérieur
  38         NetBSD-current
  39
  40 Étant donné que Wine nécessite une implémentation des "threads" au niveau du
  41 noyau, seuls les systèmes d'exploitation mentionnés ci-haut sont supportés.
  42 D'autres systèmes d'exploitation qui implémentent les "threads" noyau peuvent
  43 être supportés dans le futur.
  44
  45 Information Linux :
  46   Bien que Linux 2.2.x devrait encore fontionner et que Linux 2.0.x pourrait
  47   encore marcher (des versions plus anciennes de 2.0.x avaient des plantages
  48   dû aux "threads"), il est préférable d'avoir un noyau récent tel que 2.4.x.
  49
  50 Information FreeBSD :
  51   Wine devrait pouvoir être compilé sur FreeBSD 4.x et FreeBSD 5.x, mais les
  52   versions antérieures à FreeBSD 5.3 ne fonctionneront généralement pas.
  53
  54   Plus d'information est située dans l'arbre de ports :
  55   ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/
  56
  57 Information Solaris :
  58   Il est plus que probable que vous devrez construire Wine avec la chaîne
  59   d'outils GNU (gcc, gas, etc.). Avertissement : intaller gas n'assure pas
  60   qu'il sera utilisé par gcc.  Recompliler gcc après l'installation de gas
  61   ou créer un lien symbolique de cc, as et ld vers les outils GNU semble
  62   nécessaire.
  63
  64 Information NetBSD :
  65   Assurez-vous d'avoir les options USER_LDT, SYSVSHM, SYSVSEM, and SYSVMSG
  66   enclanchées dans votre noyau.
  67
  68 Systèmes de fichier supportés :
  69   Wine devrait fonctionner sur la plupart des systèmes de fichier. Cependant
  70   Wine s'arrêtera au démarrage si umsdos est utilisé pour le répertoire /tmp.
  71   Quelques problèmes de compatibilité ont aussi été rapportés sur
  72   l'utilisation des fichiers accédés au travers de Samba. Egalement, puisque
  73   NTFS ne peut être utilisé en sécurité qu'avec un accès en lecture seul pour
  74   le moment, nous recommandons de ne pas utiliser NTFS, parce que les
  75   programmes Windows on besoin des accès en écriture presque partout. Si vous
  76   avez des fichier NTFS, copiez les vers une localisation accessible en
  77   écriture.
  78
  79 Configuration requise de base :
  80 Vous avez besoin d'avoir les fichiers "include" de X11 installés
  81 (appelés xlib6g-dev pour Debian et XFree86-devel pour RedHat).
  82
  83 Configuration requise des outils de compilation :
  84 Sur les système x86, gcc >= 2.7.2 est nécessaire. Les versions inférieures à
  85 la 2.7.2.3 peuvent créer des ennuis losrque certains fichiers sont compilés
  86 avec l'optimisation, souvent dû à des problèmes de gestion d'en-tête de fichier.
  87 pgcc ne fonctionne pas actuellement avec Wine. La cause de ce problème est
  88 inconnue.
  89
  90 Évidemment, vous aurez besoin de "make" (très probablement GNU make).
  91
  92 Vous aurez également besoin de flex version 2.5 ou supérieure et bison.
  93 Si vous utilisez RedHat ou Debian, installez les paquets flex et bison.
  94
  95 Librairies optionnelles :
  96   Si vous voulez un support d'impression à l'aide de CUPS, SVP installez à la
  97   fois les packages cups et cups-devel.
  98
  99 Pour le traitement automatique des scripts de la série de tests, vous aurez
 100 également besoin des en-têtes de développement de libperl (package libperl-dev
 101 sous Debian).
 102
 103 Pour la configuration nécessaire si vous avez l'intention de construire la
 104 documentation vous-même voyez la section "DOCUMENTATION".
 105
 106 4. COMPILATION
 107
 108 Au cas où vous choisissez de ne pas utiliser wineinstall, exécuter les com-
 109 mandes suivantes pour construire Wine :
 110
 111 ./configure
 112 make depend
 113 make
 114
 115 Cela va constuire le programme "wine" et de nombreux binaires/librairies de
 116 support.
 117 Le programme "wine" chargera et exécutera les exécutables Windows.
 118 La librairie "libwine" ("Winelib") peut être utilisée pour compiler et lier
 119 le code source Windows sous Unix.
 120
 121 Pour voir les options de compilation, tapez ./configure --help.
 122
 123 Pour mettre à jour une nouvelle version en utilisant les fichiers patch, tout
 124 d'abord aller dans le répertoire de plus haut niveau de la version actuelle
 125 (celui qui contient ce fichier README.fr). Ensuite faire un "make clean", et
 126 patcher la version avec :
 127
 128     gunzip -c patch-file | patch -p1
 129
 130 Avec "patch-file" qui est le nom du fichier de patche (quelque chose de
 131 similaire à Wine-yymmdd.diff.gz). Vous pouvez réexécuter "./configure", et
 132 ensuite taper "make depend && make".
 133
 134 5. SETUP
 135
 136 Un fois que Wine a été construit correctement, vous pouvez tapez "make install";
 137 cela installera l'exécutable wine, les pages man Wine et quelques autres fichiers
 138 nécessaires.
 139
 140 N'oubliez pas de désinsatller toutes les installations précédantes de wine.
 141 Essayez soit "dpkg -r wine", "rpm -e wine" ou "make uninstall" avant
 142 d'installer.
 143
 144 Si vou désirez lire la documentation fournie avec les sources de Wine, voyez la
 145 section "DOCUMENTATION".
 146
 147 Wine a besoin d'un fichier de configuration nommé "config" dans votre répertoire
 148 ~/.wine. Le format de ce fichier est expliqué dans la page man du fichier de
 149 configuration (documentation/wine.conf.man).
 150 Le fichier documentation/samples/config contient un exemple de fichier de
 151 configuration qui doit être adapté et copié vers la localisation mentionnée
 152 ci-dessus.
 153
 154 Naviguez dans la section Support à http://www.winehq.org/ pour plus d'astuces
 155 de configuration.
 156
 157 En cas d'erreur de chargement de librairie (par exemple
 158 "Error while loading shared libraries: libntdll.so"), assurez vous d'ajouter
 159 le chemin des librairies à /etc/ld.so.conf et exécuter ldconfig en tant que root.
 160
 161 6. EXÉCUTER DES PROGRAMMES
 162
 163 Lorsque l'on invoque Wine, vous pouvez spécifier le chemin entier vers
 164 l'exécutable ou seulement le nom de fichier.
 165
 166 Pour exécuter Solitaire par exemple :
 167
 168         wine sol                   (en utilisant le chemin d'accès spécifié
 169         wine sol.exe                    dans le fichier "config" pour localiser
 170                                         le fichier)
 171
 172         wine c:\\windows\\sol.exe  (en utilisant la syntaxe de fichiers DOS)
 173
 174         wine /usr/windows/sol.exe  (en utilisant la syntaxe de fichiers Unix)
 175
 176         wine sol.exe /parametre1 -parametre2 parametre3
 177                         (en appelant le programme avec des paramètres)
 178
 179 Note: le chemin du fichier sera également additionné au chemin par défaut
 180       lorsque le nom entier est écrit sur la ligne de commande.
 181
 182 Wine n'est pas encore complet, ainsi quelque programmes peuvent planter. Selon
 183 que vous avez installé correctement winedbg d'après documentation/debugger.sgml,
 184 vous entrerez dans le débogueur vous permettant d'enquêter et de résoudre le
 185 problème. Pour plus d'information sur la manière de le faire, veuillez lire
 186 le fichier documentation/debugging.sgml.
 187
 188 Vous devriez sauvegarder tous vos fichier important auquels vous donnez accès
 189 à Wine ou utiliser une copie spéciale pour Wine, puisque dans certain cas des
 190 utilisateurs ont rapporté des corruptions de fichiers. Ne PAS
 191 éxécuter l'Explorateur, par exemple, si vous n'avez pas une copie propre,
 192 puisque il renomme/corrompt parfois plusieurs répertoires. Même certaines
 193 application MS telle Messenger par exemple ne sont pas sûres puisqu'elle
 194 peuvent lancer l'Explorateur dans certains cas. Certaines corruptions
 195 particulières telle (!$!$!$!$.pfr) peut du moins être partiellement
 196 fixée en utilisant la méthode décrite par
 197 http://home.nexgo.de/andi.mohr/download/decorrupt_explorer
 198
 199 7. DOCUMENTATION
 200
 201 Certaines documentations (divers Guides Wine etc) peuvent être trouvées dans
 202 le répertoire documentation/ (à part ceux disponibles également sur WineHQ)
 203
 204 Si vou voulez construire les fichier SGML ici, vous pouvez exécuter la
 205 commande "make doc" dans le répertoire documentation/.
 206 Pour le faire vous aurrez besoin des outils du package sgml (pour db2html,
 207 db2ps, db2pdf) nommés :
 208 Debian:         docbook-utils
 209 Mandrake:       sgml-tools-A.B.C-DDmdk
 210 SuSE:           docbktls-A.BB.C-DD
 211
 212 8. OPTENIR PLUS D'INFORMATIONS
 213
 214 WWW:    Baucoup d'informations à propos de Wine sont disponibles sur WineHQ à
 215         http://www.winehq.org/ : divers Guides Wine, base de donnée
 216         d'applications, suivit de bogues. C'est probablement le meilleur point
 217         de départ.
 218
 219 FAQ:    La Foire Aux Questions de Wine est localisée à :
 220         http://www.winehq.org/FAQ
 221
 222 Usenet: Vous pouvez parler des problèmes ou résolutions en relation avec Wine
 223         ou optenir de l'aide sur comp.emulators.ms-windows.wine.
 224
 225 Bugs:   Rapportez les bogues à Wine Bugzilla à http://bugs.winehq.org
 226         SVP cherchez tout d'abord dans la base de donnée de bugzilla
 227         pour contrôler que le problème n'est pas déjà découvert avant
 228         de poster un rapport de bogue. Vous pouvez également rapporter
 229         des rapports de bogue à comp.emulators.ms-windows.wine.
 230         SVP lisez le fichier documentation/bugs.sgml pour connaître les
 231         informations nécessaires.
 232
 233 IRC:    L'aide en ligne est disponible sur le cannal #WineHQ sur
 234         irc.freenode.net.
 235
 236 CVS:    L'arbre de développement actuel de Wine est disponible au travers
 237         de CVS.
 238         Allez sur http://www.winehq.org/cvs pour plus d'informations
 239
 240 Mailing lists:
 241         Il existe de multiples mailing lists pour les développeurs de Wine;
 242         repportez-vous à http://www.winehq.org/forums pour de plus
 243         amples informations.
 244
 245 Si vous ajoutez quelquechose ou fixez un bogue, envoyez un patch (dans le
 246 format 'diff -u' ) à la liste de diffusion wine-patches@winehq.org  pour son
 247 inclusion dans la prochaine version.
 248
 249 --
 250 Alexandre Julliard
 251 julliard@winehq.org