wine-wine/documentation/README.fr

1. INTRODUCTION

Wine est un programme qui permet d'ex<65>cuter les logiciels <20>crits
pour Microsoft Windows (comprenant les ex<65>cutables DOS, Windows 3.x
et Win32) sur un Unix. Il est compos<6F> d'un chargeur qui charge et
ex<EFBFBD>cute un binaire Microsoft Windows, ainsi que d'une librairie (appel<65>e
Winelib) qui impl<70>mente les appels de l'API de Windows par leur
<EFBFBD>quivalent Unix ou X11. Cette librairie peut <20>galement <20>tre utilis<69>e
pour porter du code Win32 vers un ex<65>cutable Unix natifs.

Wine est un logiciel libre, distribu<62> sous GNU LGPL; lisez le fichier
LICENCE pour les d<>tails.

2. D<>MARRAGE RAPIDE

M<EFBFBD>me si vous compilez <20> partir des sources, il est recommand<6E> d'utiliser
l'Installateur de Wine pour construire et installer Wine. <20> partir du
r<EFBFBD>pertoire le plus <20>lev<65> des sources de Wine (qui contient ce fichier),
ex<EFBFBD>cutez :

./tools/wineinstall

Pour ex<65>cuter les programmes, tapez "wine [options] programme". Pour des
informationS compl<70>mentaires et des r<>solutions de probl<62>mes, lisez le
reste de ce fichier, les pages "man" de Wine, les fichiers dans le
r<EFBFBD>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<65>cuter Wine, vous devez avoir un des syst<73>mes
d'exploitation qui suit :

	Linux version 2.0.36 ou sup<75>rieur
	FreeBSD 4.x or FreeBSD 5-CURRENT
	Solaris x86 2.5 ou sup<75>rieur
	NetBSD-current

Information Linux :
  Bien que les versions Linux 2.0.x fonctionneront en g<>n<EFBFBD>ral, certaines
  caract<63>ristiques (surtout le partage LDT) n<>cessaires pour faire
  fonctionner les "threads" Win32 n'<27>taient impl<70>ment<6E>s avant les kernels 2.2.
  Si vous avez constamment des plantages d<> aux "threads", vous devriez
  consid<69>rer de vous mettre <20> jour au noyau 2.2. Aussi certains bogues ont <20>t<EFBFBD>
  fix<69>s et de nouvelles fonctionnalit<69>s ont <20>t<EFBFBD> ajout<75>es aux derni<6E>res versions
  du noyau 2.0.x, ainsi si vous avez un noyau Linux tr<74>s ancien, mettez-le <20>
  jour au moins au dernier 2.0.x.

Information FreeBSD :
  Assurez-vous d'avoir les options USER_LDT, SYSVSHM, SYSVSEM, and SYSVMSG
  enclanch<63>es dans votre noyau.
  Plus d'information est situ<74>e dans l'arbre de ports :
  ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/

Information Solaris :
  Il est plus que probable que vous devrez construire Wine avec la cha<68>ne
  d'outils GNU (gcc, gas, etc.). Avertissement : intaller gas n'assure pas
  qu'il sera utilis<69> par gcc.  Recompliler gcc apr<70>s l'installation de gas
  ou cr<63>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<63>es dans votre noyau.

Information des syst<73>me de fichier :
  Wine devrait fonctionner sur la plupart des syst<73>mes de fichier. Cependant
  Wine s'arr<72>tera au d<>marrage si umsdos est utilis<69> pour le r<>pertoire /tmp.
  Quelques probl<62>mes de compatibilit<69> ont aussi <20>t<EFBFBD> rapport<72>s sur
  l'utilisation des fichiers acc<63>d<EFBFBD>s au travers de Samba. Egalement, puisque
  NTFS ne peut <20>tre utilis<69> en s<>curit<69> qu'avec un acc<63>s en lecture seul pour
  le moment, nous recommandons de ne pas utiliser NTFS, parce que les
  programmes Windows on besoin des acc<63>s en <20>criture presque partout. Si vous
  avez des fichier NTFS, copiez les vers une localisation accessible en
  <20>criture.

Wine a besoin de "threads" du niveau noyau. Actuellement, seul Linux version
2.0 ou sup<75>rieur, FreeBSD 4.x ou sup<75>rieur, Solaris x86 version 2.5 ou sup<75>rieur
et NetBSD-current sont support<72>s. D'autres syst<73>mes d'exploitations qui
impl<EFBFBD>mentent les "threads" noyau peuvent <20>tre support<72>s dans le futur.

Vous avez besoin d'avoir les fichiers "include" de X11 install<6C>s
(appel<65>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 <20>tre r<>entrantes, ce qui est probalblement la
configuration par d<>faut <20> l'heure actuelle. Si vous poss<73>dez libc6 (glibc2)
ou que vous compilez les librairies X vous-m<>me, elles ont probablement <20>t<EFBFBD>
compil<EFBFBD>es avec l'option r<>entrant enclanch<63>e.

Sur les syst<73>me x86, gcc >= 2.7.2 est n<>cessaire. Les versions inf<6E>rieures <20>
la 2.7.2.3 peuvent cr<63>er des ennuis losrque certains fichiers sont compil<69>s
avec l'optimisation, souvent d<> <20> des probl<62>mes de gestion d'en-t<>te de fichier.
pgcc ne fonctionne pas actuellement avec Wine. La cause de ce probl<62>me est
inconnue.

<EFBFBD>videmment, vous aurez besoin de "make" (tr<74>s probablement GNU make).

Vous aurez <20>galement besoin de flex version 2.5 ou sup<75>rieure et yacc.
Bison fonctionnera en replacement de yacc. Si vous utilisez RedHat ou Debian,
installez les paquets flex et bison.

Pour le traitement automatique des scripts de la s<>rie de tests, vous aurez
<EFBFBD>galement besoin des en-t<>tes de d<>veloppement de libperl (package libperl-dev
sous Debian).

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<65>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<65>cutera les ex<65>cutables Windows.
La librairie "libwine" ("Winelib") peut <20>tre utilis<69>e pour compiler et lier
le code source Windows sous Unix.

Pour voir les options de compilation, tapez ./configure --help.

Pour mettre <20> 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 <20> Wine-yymmdd.diff.gz). Vous pouvez r<>ex<65>cuter "./configure", et
ensuite taper "make depend && make".

5. SETUP

Un fois que Wine a <20>t<EFBFBD> construit correctement, vous pouvez tapez "make install";
cela installera l'ex<65>cutable wine, les pages man Wine et quelques autres fichiers
n<EFBFBD>cessaires.

N'oubliez pas de d<>sinsatller toutes les installations pr<70>c<EFBFBD>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<6D> "config" dans votre r<>pertoire
~/.wine. Le format de ce fichier est expliqu<71> 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 <20>tre adapt<70> et copi<70> vers la localisation mentionn<6E>e
ci-dessus.

N'oubliez pas d'ajouter des entr<74>es de registre virtuelle en applicant
winedefault.reg avec programs/regedit/. 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 <20> /etc/ld.so.conf et ex<65>cuter ldconfig en tant que root.

Pour pouvoir v<>rifier l'exactitude de l'environnement dont vous avez besoin pour
que Wine s'ex<65>cute correctement, vous pouvez ex<65>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 <20>tre utile dans
une premi<6D>re v<>rification.

Lisez les page man de wine.conf pour savoir comment basculer en un mode texte
uniquement.

6. EX<45>CUTER DES PROGRAMMES

Lorsque l'on invoque Wine, vous pouvez sp<73>cifier le chemin entier vers
l'ex<65>cutable ou seulement le nom de fichier.

Pour ex<65>cuter Solitaire par exemple :

	wine sol		   (en utilisant le chemin d'acc<63>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 <20>galement additionn<6E> au chemin par d<>faut
      lorsque le nom entier est <20>crit sur la ligne de commande.

Wine n'est pas encore complet, ainsi quelque programmes peuvent planter. Selon
que vous avez install<6C> correctement winedbg d'apr<70>s documentation/debugger.sgml,
vous entrerez dans le d<>bogueur vous permettant d'enqu<71>ter et de r<>soudre le
probl<EFBFBD>me. Pour plus d'information sur la mani<6E>re de le faire, veuillez lire
le fichier documentation/debugging.sgml.

Vous devriez sauvegarder tous vos fichier important auquels vous donnez acc<63>s
<EFBFBD> Wine ou utiliser une copie sp<73>ciale pour Wine, puisque dans certain cas des
utilisateurs ont rapport<72> des corruptions de fichiers. Ne PAS
<EFBFBD>x<EFBFBD>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<EFBFBD>res telle (!$!$!$!$.pfr) peut du moins <20>tre partiellement
fix<EFBFBD>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 <20>tre trouv<75>es dans
le r<>pertoire documentation/ (<28> part ceux disponibles <20>galement sur WineHQ)

Si vou voulez construire les fichier SGML ici, vous pouvez ex<65>cuter la
commande "make doc" dans le r<>pertoire documentation/.
Pour le faire vous aurrez besoin des outils du package sgml (pour db2html,
db2ps, db2pdf) nomm<6D>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 <20> propos de Wine sont disponibles sur WineHQ <20>
	http://www.winehq.com/ : divers Guides Wine, base de donn<6E>e
	d'applications, suivit de bogues. C'est probablement le meilleur point
	de d<>part.

FAQ:	La Foire Aux Questions de Wine est localis<69>e <20> :
	http://www.winehq.com/FAQ

Usenet:	Vous pouvez parler des probl<62>mes ou r<>solutions en relation avec Wine
	ou optenir de l'aide sur comp.emulators.ms-windows.wine.

Bugs:	Rapportez les bogues <20> Wine Bugzilla <20> http://bugs.winehq.com/.
	SVP cherchez tout d'abord dans la base de donn<6E>e de bugzilla
	pour contr<74>ler que le probl<62>me n'est pas d<>j<EFBFBD> d<>couvert avant
	de poster un rapport de bogue. Vous pouvez <20>galement rapporter
	des rapports de bogue <20> comp.emulators.ms-windows.wine.
	SVP lisez le fichier documentation/bugs.sgml pour conna<6E>tre les
	informations n<>cessaires.

IRC:	L'aide en ligne est disponible sur le cannal #WineHQ sur
	irc.freenode.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 <20> 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' ) <20> la liste de diffusion wine-patches@winehq.com  pour son
inclusion dans la prochaine version.

--
Alexandre Julliard
julliard@winehq.com