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