wine/documentation
Alexandre Julliard 69622dbdcc Added support for path wildcards of the form "*dllname" in load order
specifications.
Only use wildcard entry for dlls that don't specify an explicit path.
Removed the old DllOverrides syntax support.
Misc cleanups and optimizations.
2002-06-25 00:23:23 +00:00
..
samples Changed DllOverrides so we use builtin rpcrt4, ole32, oleaut32. 2002-06-10 02:30:32 +00:00
status Fixed references to old documentation location. 2001-09-17 19:07:56 +00:00
.cvsignore Upgraded configure script to use autoconf 2.50 features, and renamed 2002-02-14 19:47:29 +00:00
architecture.sgml Minor grammatical corrections. 2001-11-07 20:16:22 +00:00
authors.ent Documentation update. 2000-12-13 21:52:37 +00:00
bugs.sgml Some grammar fixes. 2002-06-10 02:32:59 +00:00
build.sgml Documentation update. 2000-12-13 21:52:37 +00:00
ChangeLog.OLD Moved old ChangeLog to documentation/ChangeLog.OLD. 1998-10-18 16:34:50 +00:00
compiling.sgml Removed references to xpm packages. 2002-01-04 18:53:55 +00:00
configuring.sgml Documentation improvements. 2002-06-04 23:09:34 +00:00
consoles.sgml Documentation update. 2000-12-13 21:52:37 +00:00
cvs-regression.sgml Misc doc updates. 2001-10-16 21:47:51 +00:00
db2html-winehq Added support for the Crux Linux distribution (with openjade). 2002-02-26 00:35:05 +00:00
ddraw.txt Authors: Andrew Lewycky <andrew@transgaming.com>, Gavriel State <gav@transgaming.com>, Ove Kaaven <ovek@transgaming.com> 2001-01-04 22:44:55 +00:00
debugger.sgml Added the detach command to the debugger. 2002-02-27 01:29:18 +00:00
debugging.sgml Rename debug.h to debugtools.h. 2001-11-30 23:07:30 +00:00
default.dsl Documentation update. 2000-12-13 21:52:37 +00:00
dlls.sgml Documentation update. 2000-12-13 21:52:37 +00:00
documentation.sgml Additions to how to use Docbook under RedHat (to help beginners like 2001-10-02 17:48:16 +00:00
fonts.sgml Documentation improvements. 2002-06-04 23:09:34 +00:00
getting.sgml Explain patch -p0 option. 2002-05-16 18:31:57 +00:00
gui Window style updates. 1999-07-03 12:06:26 +00:00
HOWTO-winelib - add documentation section to README 2002-02-02 18:03:55 +00:00
i18n.sgml Documentation update. 2000-12-13 21:52:37 +00:00
implementation.sgml Documentation improvements. 2002-06-04 23:09:34 +00:00
installation-und-konfiguration.german Replaced -dosver and -winver options by config file parameters. 2002-05-23 19:35:18 +00:00
installing.sgml Documentation improvements. 2002-06-04 23:09:34 +00:00
introduction.sgml Include information about XFree86 Windows server. 2001-10-10 20:22:35 +00:00
make_winehq 'test -e' is not supported on Solaris, replace with '-f' or '-d'. 2002-01-29 17:52:28 +00:00
Makefile.in Fixed make install target to work even when nothing has been compiled 2002-06-14 23:48:27 +00:00
multimedia.sgml Updated multimedia documentation. 2001-05-22 19:26:31 +00:00
ole.sgml Documentation update. 2000-12-13 21:52:37 +00:00
opengl.sgml Updated for change in config file name. Removed references to 2001-01-18 23:03:47 +00:00
packaging.sgml Moved remaining files in windows/x11drv to dlls/x11drv. 2002-04-30 21:16:39 +00:00
patches.sgml Cosmetics. 2001-10-21 15:18:15 +00:00
porting.sgml Removed references to xpm packages. 2002-01-04 18:53:55 +00:00
print.dsl Better formatting for PDF output. 2001-09-26 23:02:31 +00:00
printing.sgml The [windows] section is in win.ini not in ~/.wine/config. 2001-09-10 23:17:08 +00:00
programs Touch to test auto mailing of commits. 1998-10-11 23:14:04 +00:00
psdrv.reg Various registry-related PostScript driver enhancements. 2001-04-02 19:14:41 +00:00
README.fr Updated so it's in line with README. 2002-06-10 02:27:22 +00:00
registry.sgml - stress the fact that wineinstall is in Wine source 2002-02-27 01:30:32 +00:00
running.sgml Replaced -dosver and -winver options by config file parameters. 2002-05-23 19:35:18 +00:00
shell32 - New (some stubs): SHGetFolderLocation, PathAddExtension, 2000-06-01 23:25:44 +00:00
tools.sgml Documentation update. 2000-12-13 21:52:37 +00:00
wine-devel.sgml Added convenience script for generating online docs for winehq.com. 2001-01-19 20:58:37 +00:00
wine-doc.sgml Updated multimedia documentation. 2001-05-22 19:26:31 +00:00
wine-pkg.sgml Added convenience script for generating online docs for winehq.com. 2001-01-19 20:58:37 +00:00
wine-user.sgml Various registry-related PostScript driver enhancements. 2001-04-02 19:14:41 +00:00
wine.conf.man Added support for path wildcards of the form "*dllname" in load order 2002-06-25 00:23:23 +00:00
wine.man.in Replaced -dosver and -winver options by config file parameters. 2002-05-23 19:35:18 +00:00
wine.texinfo Fixed WARRANTY inclusion. 2002-03-19 02:10:35 +00:00
winehq.dsl Better formatting for PDF output. 2001-09-26 23:02:31 +00:00
winelib-bindlls.sgml Additions to how to use Docbook under RedHat (to help beginners like 2001-10-02 17:48:16 +00:00
winelib-intro.sgml Additions to how to use Docbook under RedHat (to help beginners like 2001-10-02 17:48:16 +00:00
winelib-mfc.sgml Added some MFC documentation (with the help of Francois Gouget). 2001-10-02 17:44:04 +00:00
winelib-pkg.sgml - Split Winelib User Guide into smaller files for easier maintenance 2001-01-24 19:36:24 +00:00
winelib-porting.sgml Spelling typos. 2001-05-18 21:01:38 +00:00
winelib-toolkit.sgml 'test -e' is not supported on Solaris, replace with '-f' or '-d'. 2002-01-29 17:52:28 +00:00
winelib-user.sgml - Split Winelib User Guide into smaller files for easier maintenance 2001-01-24 19:36:24 +00:00
winsock Release 970525 1997-05-25 13:58:18 +00:00

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'information est situé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î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 4.x 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.

Évidemment, vous aurez besoin de "make" (très probablement GNU make).

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 le traitement automatique des scripts de la série de tests, vous aurez
é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é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.

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