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