riched20: Added GetStoryType().
[wine.git] / tools / winemaker.fr.UTF-8.man.in
blob8e454aeabf3eb361037bb0a143024ef07433cdcb
1 .TH WINEMAKER 1 "jan 2012" "@PACKAGE_STRING@" "Manuel des développeurs de Wine"
2 .SH NOM
3 winemaker \- générer une infrastructure de construction pour la compilation de programmes Windows sur UNIX
4 .SH SYNOPSIS
5 .B "winemaker "
7 .BR               "--nobanner " "] [ " "--backup " "| " "--nobackup " "] [ "--nosource-fix "
9 .br
10   [
11 .BR               "--lower-none " "| " "--lower-all " "| " "--lower-uppercase "
13 .br
14   [
15 .BR               "--lower-include " "| " "--nolower-include " ]\ [ " --mfc " "| " "--nomfc "
17 .br
18   [
19 .BR               "--guiexe " "| " "--windows " "| " "--cuiexe " "| " "--console " "| " "--dll " "| " "--lib "
21 .br
22   [
23 .BI               "-D" macro "\fR[=\fIdéfn\fR] ] [" "\ " "-I" "rép\fR ]\ [ " "-P" "rép\fR ] [ " "-i" "dll\fR ] [ " "-L" "rép\fR ] [ " "-l" "bibliothèque "
25 .br
26   [
27 .BR               "--nodlls " "] [ " "--nomsvcrt " "] [ " "--interactive " "] [ " "--single-target \fInom\fR "
29 .br
30   [
31 .BR               "--generated-files " "] [ " "--nogenerated-files " "]
33 .br
34   [
35 .BR               "--wine32 " "]
36 .br
37 .IR               "  répertoire_de_travail" "| " "fichier_projet" "| " "fichier_espace_de_travail"
39 .SH DESCRIPTION
40 .PP
41 .B winemaker
42 est un script perl conçu pour vous aider à entamer le
43 processus de conversion de vos sources Windows en programmes Winelib.
44 .PP
45 À cet effet, il peut effectuer les opérations suivantes :
46 .PP
47 -\ renommer vos fichiers sources et répertoires en minuscules s'ils ont été
48 convertis en majuscules durant le transfert.
49 .PP
50 -\ convertir les fins de ligne DOS en fins de ligne UNIX (CRLF vers LF).
51 .PP
52 -\ balayer les directives d'inclusion et les références aux fichiers
53 de ressources pour y remplacer les backslashs par des slashs.
54 .PP
55 -\ durant l'étape ci-dessus,
56 .B winemaker
57 va également effectuer une recherche insensible à la casse du fichier
58 référencé dans le chemin d'inclusion, et réécrire la directive d'inclusion
59 avec la casse correcte si nécessaire.
60 .PP
61 .RB "-\ " winemaker
62 recherchera également d'autres problèmes plus exotiques comme l'emploi
63 de \fI#pragma pack\fR, l'utilisation de \fIafxres.h\fR dans des projets
64 non MFC, etc. Quand il trouve de tels points nébuleux, il émettra des
65 avertissements.
66 .PP
67 .RB "-\ " winemaker
68 peut également balayer un arbre de répertoires complet en une seule passe,
69 deviner quels sont les exécutables et bibliothèques en cours de construction,
70 les faire correspondre à des fichiers sources, et générer le \fIMakefile\fR
71 correspondant.
72 .PP
73 -\ finalement,
74 .B winemaker
75 générera un \fIMakefile\fR global pour une utilisation classique.
76 .PP
77 .RB "-\ " winemaker
78 comprend les projets de type MFC, et génère des fichiers appropriés.
79 .PP
80 .RB "-\ " winemaker
81 est capable de lire des fichiers projets existants (dsp, dsw, vcproj et sln).
82 .PP
83 .SH OPTIONS
84 .TP
85 .B --nobanner
86 Désactiver l'affichage de la bannière.
87 .TP
88 .B --backup
89 Effectuer une sauvegarde préalable de tous les fichiers modifiés.
90 Comportement par défaut.
91 .TP
92 .B --nobackup
93 Ne pas effectuer de sauvegarde des fichiers sources modifiés.
94 .TP
95 .B --nosource-fix
96 Ne pas essayer de corriger les fichiers sources (p.ex. la conversion
97 DOS vers UNIX). Cela évite des messages d'erreur si des fichiers sont
98 en lecture seule.
99 .TP
100 .B --lower-all
101 Renommer tous les fichiers et répertoires en minuscules.
103 .B --lower-uppercase
104 Ne renommer que les fichiers et répertoires qui ont un nom composé
105 uniquement de majuscules.
106 Ainsi, \fIHELLO.C\fR serait renommé, mais pas \fIWorld.c\fR.
108 .B --lower-none
109 Ne pas renommer de fichiers et répertoires en minuscules. Notez que cela
110 n'empêche pas le renommage d'un fichier si son extension ne peut être traitée
111 telle quelle, comme par exemple « .Cxx ». Comportement par défaut.
113 .B "--lower-include "
114 Convertir en minuscules les noms de fichiers associés à des directives
115 d'inclusion (ou à d'autres formes de références de fichiers pour les
116 fichiers ressources) que
117 .B winemaker
118 n'arrive pas à trouver. Comportement par défaut.
120 .B "--nolower-include "
121 Ne pas modifier la directive d'inclusion si le fichier référencé ne peut
122 être trouvé.
124 .BR "--guiexe " "| " "--windows"
125 Présumer une application graphique quand une cible exécutable ou une cible d'un
126 type inconnu est rencontrée.
127 Comportement par défaut.
129 .BR "--cuiexe " "| " "--console"
130 Présumer une application en mode console quand une cible exécutable ou une cible d'un
131 type inconnu est rencontrée.
133 .B --dll
134 Présumer une DLL quand une cible d'un type inconnu est rencontrée (c.-à-d. si
135 .B winemaker
136 ne peut déterminer s'il s'agit d'un exécutable, d'une DLL ou d'une bibliothèque statique).
138 .B --lib
139 Présumer une bibliothèque statique quand une cible d'un type inconnu est rencontrée (c.-à-d. si
140 .B winemaker
141 ne peut déterminer s'il s'agit d'un exécutable, d'une DLL ou d'une bibliothèque statique).
143 .B --mfc
144 Spécifier que les cibles utilisent les MFC. Dans ce cas,
145 .B winemaker
146 adapte les chemins d'inclusion et des bibliothèques en conséquence,
147 et lie la cible avec la bibliothèque MFC.
149 .B --nomfc
150 Spécifier que les cibles n'utilisent pas les MFC. Cette option empêche
151 l'utilisation des bibliothèques MFC même si
152 .B winemaker
153 rencontre des fichiers \fIstdafx.cpp\fR ou \fIstdafx.h\fR qui activeraient
154 les MFC automatiquement en temps normal si ni \fB--nomfc\fR ni \fB--mfc\fR n'était
155 spécifiée.
157 .BI -D macro "\fR[\fB=\fIdéfn\fR]"
158 Ajouter la définition de macro spécifiée à la liste globale des
159 définitions de macros.
161 .BI -I répertoire
162 Ajouter le répertoire spécifié au chemin global d'inclusion.
164 .BI -P répertoire
165 Ajouter le répertoire spécifié au chemin global des DLL.
167 .BI -i dll
168 Ajouter la bibliothèque Winelib à la liste global de bibliothèques Winelib
169 à importer.
171 .BI -L répertoire
172 Ajouter le répertoire spécifié au chemin global des bibliothèques.
174 .BI -l bibliothèque
175 Ajouter la bibliothèque spécifiée à la liste globale de bibliothèques à utiliser lors de l'édition des liens.
177 .B --nodlls
178 Ne pas utiliser l'ensemble standard de bibliothèques Winelib pour les imports,
179 c.-à-d. que toute DLL utilisée par votre code doit être explicitement spécifiée à l'aide d'options
180 \fB-i\fR.
181 L'ensemble standard de bibliothèques est : \fIodbc32.dll\fR, \fIodbccp32.dll\fR, \fIole32.dll\fR,
182 \fIoleaut32.dll\fR et \fIwinspool.drv\fR.
184 .B --nomsvcrt
185 Définir certaines options afin que winegcc n'utilise pas
186 msvcrt durant la compilation. Utilisez cette option si certains fichiers cpp
187 incluent \fI<string>\fR.
189 .B --interactive
190 Utiliser le mode interactif. Dans ce mode,
191 .B winemaker
192 demandera de confirmer la liste de cibles pour chaque répertoire, et ensuite
193 de fournir des options spécifiques de répertoire et/ou de cible.
195 .BR --single-target " nom"
196 Spécifier qu'il n'y a qu'une seule cible, appelée \fInom\fR.
198 .B --generated-files
199 Générer le \fIMakefile\fR. Comportement par défaut.
201 .B --nogenerated-files
202 Ne pas générer le \fIMakefile\fR.
204 .B --wine32
205 Générer une cible 32 bits. Utile sur les systèmes wow64. Sans cette option,
206 l'architecture par défaut est utilisée.
208 .SH EXEMPLES
210 Voici quelques exemples typiques d'utilisation de
211 .B winemaker
214 $ winemaker --lower-uppercase -DSTRICT .
216 Recherche des fichiers sources dans le répertoire courant et ses
217 sous-répertoires. Quand un fichier ou répertoire a un nom composé
218 uniquement de majuscules, le renomme en minuscules. Ensuite, adapte tous
219 ces fichiers sources pour une compilation avec Winelib, et génère des
220 \fIMakefile\fRs. \fB-DSTRICT\fR spécifie que la macro \fBSTRICT\fR doit
221 être définie lors de la compilation des sources.
222 Finalement, un \fIMakefile\fR est créé.
224 L'étape suivante serait :
226 $ make
228 Si vous obtenez des erreurs de compilation à ce moment (ce qui est plus que
229 probable pour un projet d'une taille raisonnable), vous devriez consulter
230 le guide de l'utilisateur de Winelib pour trouver des moyens de les résoudre.
232 Pour un projet utilisant les MFC, vous devriez plutôt exécuter les commandes
233 suivantes\ :
235 $ winemaker --lower-uppercase --mfc .
237 $ make
239 Pour un fichier projet existant, vous devriez exécuter les commandes suivantes :
241 $ winemaker monprojet.dsp
243 $ make
246 .SH LIMITATIONS / PROBLÈMES
248 Dans certains cas, vous devrez éditer manuellement le \fIMakefile\fR ou les fichiers
249 sources.
251 En supposant que l'exécutable ou la bibliothèque windows est disponible, on peut
252 utiliser
253 .B winedump
254 pour en déterminer le type (graphique ou en mode console) et les
255 bibliothèques auxquelles il est lié (pour les exécutables), ou quelles fonctions
256 elle exporte (pour les bibliothèques). On pourrait ensuite restituer tous ces
257 réglages pour la cible Winelib correspondante.
259 De plus,
260 .B winemaker
261 n'est pas très apte à trouver la bibliothèque contenant l'exécutable : elle doit
262 être soit dans le répertoire courant, soit dans un des répertoires de
263 .BR LD_LIBRARY_PATH .
265 .B winemaker
266 ne prend pas encore en charge les fichiers de messages, ni le compilateur
267 de messages.
269 Les bugs peuvent être signalés (en anglais) sur le
270 .UR http://bugs.winehq.org
271 .B système de suivi des problèmes de Wine
272 .UE .
273 .SH AUTEURS
274 François Gouget pour CodeWeavers
276 Dimitrie O. Paun
278 André Hentschel
279 .SH DISPONIBILITÉ
280 \fBwinemaker\fR fait partie de la distribution de Wine, qui est disponible sur WineHQ, le
281 .UR http://www.winehq.org/
282 .B quartier général du développement de Wine
283 .UE .
284 .SH VOIR AUSSI
285 .BR wine (1),
287 .UR http://www.winehq.org/help
288 .B Documentation et support de Wine
289 .UE .