Remove outdated information from the introduction page and the FAQ.
[wine] / 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 la configuration nécessaire si vous avez l'intention de construire la
100 documentation vous-même voyez la section "DOCUMENTATION".
101
102 4. COMPILATION
103
104 Au cas où vous choisissez de ne pas utiliser wineinstall, exécuter les com-
105 mandes suivantes pour construire Wine :
106
107 ./configure
108 make depend
109 make
110
111 Cela va constuire le programme "wine" et de nombreux binaires/librairies de
112 support.
113 Le programme "wine" chargera et exécutera les exécutables Windows.
114 La librairie "libwine" ("Winelib") peut être utilisée pour compiler et lier
115 le code source Windows sous Unix.
116
117 Pour voir les options de compilation, tapez ./configure --help.
118
119 Pour mettre à jour une nouvelle version en utilisant les fichiers patch, tout
120 d'abord aller dans le répertoire de plus haut niveau de la version actuelle
121 (celui qui contient ce fichier README.fr). Ensuite faire un "make clean", et
122 patcher la version avec :
123
124     gunzip -c patch-file | patch -p1
125
126 Avec "patch-file" qui est le nom du fichier de patche (quelque chose de
127 similaire à Wine-yymmdd.diff.gz). Vous pouvez réexécuter "./configure", et
128 ensuite taper "make depend && make".
129
130 5. SETUP
131
132 Un fois que Wine a été construit correctement, vous pouvez tapez "make install";
133 cela installera l'exécutable wine, les pages man Wine et quelques autres fichiers
134 nécessaires.
135
136 N'oubliez pas de désinsatller toutes les installations précédantes de wine.
137 Essayez soit "dpkg -r wine", "rpm -e wine" ou "make uninstall" avant
138 d'installer.
139
140 Si vou désirez lire la documentation fournie avec les sources de Wine, voyez la
141 section "DOCUMENTATION".
142
143 Wine a besoin d'un fichier de configuration nommé "config" dans votre répertoire
144 ~/.wine. Le format de ce fichier est expliqué dans la page man du fichier de
145 configuration (documentation/wine.conf.man).
146 Le fichier documentation/samples/config contient un exemple de fichier de
147 configuration qui doit être adapté et copié vers la localisation mentionnée
148 ci-dessus.
149
150 Naviguez dans la section Support à http://www.winehq.org/ pour plus d'astuces
151 de configuration.
152
153 En cas d'erreur de chargement de librairie (par exemple
154 "Error while loading shared libraries: libntdll.so"), assurez vous d'ajouter
155 le chemin des librairies à /etc/ld.so.conf et exécuter ldconfig en tant que root.
156
157 6. EXÉCUTER DES PROGRAMMES
158
159 Lorsque l'on invoque Wine, vous pouvez spécifier le chemin entier vers
160 l'exécutable ou seulement le nom de fichier.
161
162 Pour exécuter Solitaire par exemple :
163
164         wine sol                   (en utilisant le chemin d'accès spécifié
165         wine sol.exe                    dans le fichier "config" pour localiser
166                                         le fichier)
167
168         wine c:\\windows\\sol.exe  (en utilisant la syntaxe de fichiers DOS)
169
170         wine /usr/windows/sol.exe  (en utilisant la syntaxe de fichiers Unix)
171
172         wine sol.exe /parametre1 -parametre2 parametre3
173                         (en appelant le programme avec des paramètres)
174
175 Note: le chemin du fichier sera également additionné au chemin par défaut
176       lorsque le nom entier est écrit sur la ligne de commande.
177
178 Wine n'est pas encore complet, ainsi quelque programmes peuvent planter. Selon
179 que vous avez installé correctement winedbg d'après documentation/debugger.sgml,
180 vous entrerez dans le débogueur vous permettant d'enquêter et de résoudre le
181 problème. Pour plus d'information sur la manière de le faire, veuillez lire
182 le fichier documentation/debugging.sgml.
183
184 Vous devriez sauvegarder tous vos fichier important auquels vous donnez accès
185 à Wine ou utiliser une copie spéciale pour Wine, puisque dans certain cas des
186 utilisateurs ont rapporté des corruptions de fichiers. Ne PAS
187 éxécuter l'Explorateur, par exemple, si vous n'avez pas une copie propre,
188 puisque il renomme/corrompt parfois plusieurs répertoires. Même certaines
189 application MS telle Messenger par exemple ne sont pas sûres puisqu'elle
190 peuvent lancer l'Explorateur dans certains cas. Certaines corruptions
191 particulières telle (!$!$!$!$.pfr) peut du moins être partiellement
192 fixée en utilisant la méthode décrite par
193 http://home.nexgo.de/andi.mohr/download/decorrupt_explorer
194
195 7. DOCUMENTATION
196
197 Certaines documentations (divers Guides Wine etc) peuvent être trouvées dans
198 le répertoire documentation/ (à part ceux disponibles également sur WineHQ)
199
200 Si vou voulez construire les fichier SGML ici, vous pouvez exécuter la
201 commande "make doc" dans le répertoire documentation/.
202 Pour le faire vous aurrez besoin des outils du package sgml (pour db2html,
203 db2ps, db2pdf) nommés :
204 Debian:         docbook-utils
205 Mandrake:       sgml-tools-A.B.C-DDmdk
206 SuSE:           docbktls-A.BB.C-DD
207
208 8. OPTENIR PLUS D'INFORMATIONS
209
210 WWW:    Baucoup d'informations à propos de Wine sont disponibles sur WineHQ à
211         http://www.winehq.org/ : divers Guides Wine, base de donnée
212         d'applications, suivit de bogues. C'est probablement le meilleur point
213         de départ.
214
215 FAQ:    La Foire Aux Questions de Wine est localisée à :
216         http://www.winehq.org/FAQ
217
218 Usenet: Vous pouvez parler des problèmes ou résolutions en relation avec Wine
219         ou optenir de l'aide sur comp.emulators.ms-windows.wine.
220
221 Bugs:   Rapportez les bogues à Wine Bugzilla à http://bugs.winehq.org
222         SVP cherchez tout d'abord dans la base de donnée de bugzilla
223         pour contrôler que le problème n'est pas déjà découvert avant
224         de poster un rapport de bogue. Vous pouvez également rapporter
225         des rapports de bogue à comp.emulators.ms-windows.wine.
226         SVP lisez le fichier documentation/bugs.sgml pour connaître les
227         informations nécessaires.
228
229 IRC:    L'aide en ligne est disponible sur le cannal #WineHQ sur
230         irc.freenode.net.
231
232 CVS:    L'arbre de développement actuel de Wine est disponible au travers
233         de CVS.
234         Allez sur http://www.winehq.org/cvs pour plus d'informations
235
236 Mailing lists:
237         Il existe de multiples mailing lists pour les développeurs de Wine;
238         repportez-vous à http://www.winehq.org/forums pour de plus
239         amples informations.
240
241 Si vous ajoutez quelquechose ou fixez un bogue, envoyez un patch (dans le
242 format 'diff -u' ) à la liste de diffusion wine-patches@winehq.org  pour son
243 inclusion dans la prochaine version.
244
245 --
246 Alexandre Julliard
247 julliard@winehq.org