French translation of the README file.

documentation/README.fr

@@ -0,0 +1,264 @@
+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'informations invoquant les patches pour la branche 4-STABLE dans
+  l'arbre de ports :
+  ftp://ftp.freebsd.org/pub/FreeBSD/FreeBSD-current/ports/emulators/wine/files/
+
+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-current ou FreeBSD 3.0 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.
+
+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 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" 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.
+
+HOWTO:	Le Wine HOWTO (hors date !) est disponible à
+	http://www.westfalen.de/witch/wine-HOWTO.txt .
+
+IRC:	L'aide en ligne est disponible sur le cannal #WineHQ sur
+	irc.openprojects.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