winemaker.fr.UTF-8.man.in 9.42 KB
Newer Older
1
.TH WINEMAKER 1 "jan 2012" "@PACKAGE_STRING@" "Manuel des développeurs de Wine"
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
.SH NOM
winemaker \- générer une infrastructure de construction pour la compilation de programmes Windows sur UNIX
.SH SYNOPSIS
.B "winemaker "
[
.BR               "--nobanner " "] [ " "--backup " "| " "--nobackup " "] [ "--nosource-fix "
]
.br
  [
.BR               "--lower-none " "| " "--lower-all " "| " "--lower-uppercase "
]
.br
  [
.BR               "--lower-include " "| " "--nolower-include " ]\ [ " --mfc " "| " "--nomfc "
]
.br
  [
19
.BR               "--guiexe " "| " "--windows " "| " "--cuiexe " "| " "--console " "| " "--dll " "| " "--lib "
20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35
]
.br
  [
.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 "
]
.br
  [
.BR               "--nodlls " "] [ " "--nomsvcrt " "] [ " "--interactive " "] [ " "--single-target \fInom\fR "
]
.br
  [
.BR               "--generated-files " "] [ " "--nogenerated-files " "]
.br
  [
.BR               "--wine32 " "]
.br
36
.IR               "  répertoire_de_travail" " | " "fichier_projet" " | " "fichier_espace_de_travail"
37 38 39 40 41 42 43 44 45 46 47 48

.SH DESCRIPTION
.PP
.B winemaker
est un script perl conçu pour vous aider à entamer le
processus de conversion de vos sources Windows en programmes Winelib.
.PP
À cet effet, il peut effectuer les opérations suivantes :
.PP
-\ renommer vos fichiers sources et répertoires en minuscules s'ils ont été
convertis en majuscules durant le transfert.
.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 53 54 55 56 57 58 59 60 61
de ressources pour y remplacer les backslashs par des slashs.
.PP
-\ durant l'étape ci-dessus,
.B winemaker
va également effectuer une recherche insensible à la casse du fichier
référencé dans le chemin d'inclusion, et réécrire la directive d'inclusion
avec la casse correcte si nécessaire.
.PP
.RB "-\ " winemaker
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 64 65 66 67 68
non MFC, etc. Quand il trouve de tels points nébuleux, il émettra des
avertissements.
.PP
.RB "-\ " winemaker
peut également balayer un arbre de répertoires complet en une seule passe,
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 71 72 73
correspondant.
.PP
-\ finalement,
.B winemaker
74
générera un \fIMakefile\fR global pour une utilisation classique.
75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96
.PP
.RB "-\ " winemaker
comprend les projets de type MFC, et génère des fichiers appropriés.
.PP
.RB "-\ " winemaker
est capable de lire des fichiers projets existants (dsp, dsw, vcproj et sln).
.PP
.SH OPTIONS
.TP
.B --nobanner
Désactiver l'affichage de la bannière.
.TP
.B --backup
Effectuer une sauvegarde préalable de tous les fichiers modifiés.
Comportement par défaut.
.TP
.B --nobackup
Ne pas effectuer de sauvegarde des fichiers sources modifiés.
.TP
.B --nosource-fix
Ne pas essayer de corriger les fichiers sources (p.ex. la conversion
DOS vers UNIX). Cela évite des messages d'erreur si des fichiers sont
97
en lecture seule.
98 99 100 101 102 103 104
.TP
.B --lower-all
Renommer tous les fichiers et répertoires en minuscules.
.TP
.B --lower-uppercase
Ne renommer que les fichiers et répertoires qui ont un nom composé
uniquement de majuscules.
105
Ainsi, \fIHELLO.C\fR serait renommé, mais pas \fIWorld.c\fR.
106 107 108 109
.TP
.B --lower-none
Ne pas renommer de fichiers et répertoires en minuscules. Notez que cela
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.
111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132
.TP
.B "--lower-include "
Convertir en minuscules les noms de fichiers associés à des directives
d'inclusion (ou à d'autres formes de références de fichiers pour les
fichiers ressources) que
.B winemaker
n'arrive pas à trouver. Comportement par défaut.
.TP
.B "--nolower-include "
Ne pas modifier la directive d'inclusion si le fichier référencé ne peut
être trouvé.
.TP
.BR "--guiexe " "| " "--windows"
Présumer une application graphique quand une cible exécutable ou une cible d'un
type inconnu est rencontrée.
Comportement par défaut.
.TP
.BR "--cuiexe " "| " "--console"
Présumer une application en mode console quand une cible exécutable ou une cible d'un
type inconnu est rencontrée.
.TP
.B --dll
133
Présumer une DLL quand une cible d'un type inconnu est rencontrée (c.-à-d. si
134
.B winemaker
135 136 137 138 139 140
ne peut déterminer s'il s'agit d'un exécutable, d'une DLL ou d'une bibliothèque statique).
.TP
.B --lib
Présumer une bibliothèque statique quand une cible d'un type inconnu est rencontrée (c.-à-d. si
.B winemaker
ne peut déterminer s'il s'agit d'un exécutable, d'une DLL ou d'une bibliothèque statique).
141 142 143 144 145 146 147 148 149 150 151
.TP
.B --mfc
Spécifier que les cibles utilisent les MFC. Dans ce cas,
.B winemaker
adapte les chemins d'inclusion et des bibliothèques en conséquence,
et lie la cible avec la bibliothèque MFC.
.TP
.B --nomfc
Spécifier que les cibles n'utilisent pas les MFC. Cette option empêche
l'utilisation des bibliothèques MFC même si
.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 155
spécifiée.
.TP
156
.BI -D macro "\fR[\fB=\fIdéfn\fR]"
157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177
Ajouter la définition de macro spécifiée à la liste globale des
définitions de macros.
.TP
.BI -I répertoire
Ajouter le répertoire spécifié au chemin global d'inclusion.
.TP
.BI -P répertoire
Ajouter le répertoire spécifié au chemin global des DLL.
.TP
.BI -i dll
Ajouter la bibliothèque Winelib à la liste global de bibliothèques Winelib
à importer.
.TP
.BI -L répertoire
Ajouter le répertoire spécifié au chemin global des bibliothèques.
.TP
.BI -l bibliothèque
Ajouter la bibliothèque spécifiée à la liste globale de bibliothèques à utiliser lors de l'édition des liens.
.TP
.B --nodlls
Ne pas utiliser l'ensemble standard de bibliothèques Winelib pour les imports,
178 179
c.-à-d. que toute DLL utilisée par votre code doit être explicitement spécifiée à l'aide d'options
\fB-i\fR.
180 181
L'ensemble standard de bibliothèques est : \fIodbc32.dll\fR, \fIodbccp32.dll\fR, \fIole32.dll\fR,
\fIoleaut32.dll\fR et \fIwinspool.drv\fR.
182 183
.TP
.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.
187 188
.TP
.B --interactive
189
Utiliser le mode interactif. Dans ce mode,
190 191 192 193
.B winemaker
demandera de confirmer la liste de cibles pour chaque répertoire, et ensuite
de fournir des options spécifiques de répertoire et/ou de cible.
.TP
194
.BI --single-target " nom"
195
Spécifier qu'il n'y a qu'une seule cible, appelée \fInom\fR.
196 197
.TP
.B --generated-files
198
Générer le \fIMakefile\fR. Comportement par défaut.
199 200
.TP
.B --nogenerated-files
201
Ne pas générer le \fIMakefile\fR.
202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218
.TP
.B --wine32
Générer une cible 32 bits. Utile sur les systèmes wow64. Sans cette option,
l'architecture par défaut est utilisée.

.SH EXEMPLES
.PP
Voici quelques exemples typiques d'utilisation de
.B winemaker
:
.PP
$ winemaker --lower-uppercase -DSTRICT .
.PP
Recherche des fichiers sources dans le répertoire courant et ses
sous-répertoires. Quand un fichier ou répertoire a un nom composé
uniquement de majuscules, le renomme en minuscules. Ensuite, adapte tous
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éé.
222
.PP
223
L'étape suivante serait :
224 225 226 227 228
.PP
$ make
.PP
Si vous obtenez des erreurs de compilation à ce moment (ce qui est plus que
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.
230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246
.PP
Pour un projet utilisant les MFC, vous devriez plutôt exécuter les commandes
suivantes\ :
.PP
$ winemaker --lower-uppercase --mfc .
.br
$ make
.PP
Pour un fichier projet existant, vous devriez exécuter les commandes suivantes :
.PP
$ winemaker monprojet.dsp
.br
$ make
.PP

.SH LIMITATIONS / PROBLÈMES
.PP
247
Dans certains cas, vous devrez éditer manuellement le \fIMakefile\fR ou les fichiers
248 249 250 251 252 253 254 255 256 257 258 259 260 261
sources.
.PP
En supposant que l'exécutable ou la bibliothèque windows est disponible, on peut
utiliser
.B winedump
pour en déterminer le type (graphique ou en mode console) et les
bibliothèques auxquelles il est lié (pour les exécutables), ou quelles fonctions
elle exporte (pour les bibliothèques). On pourrait ensuite restituer tous ces
réglages pour la cible Winelib correspondante.
.PP
De plus,
.B winemaker
n'est pas très apte à trouver la bibliothèque contenant l'exécutable : elle doit
être soit dans le répertoire courant, soit dans un des répertoires de
262
.BR LD_LIBRARY_PATH .
263 264 265 266 267
.PP
.B winemaker
ne prend pas encore en charge les fichiers de messages, ni le compilateur
de messages.
.PP
268
Les bugs peuvent être signalés (en anglais) sur le
269
.UR https://bugs.winehq.org
270 271
.B système de suivi des problèmes de Wine
.UE .
272 273
.SH AUTEURS
François Gouget pour CodeWeavers
274
.br
275
Dimitrie O. Paun
276
.br
277
André Hentschel
278 279
.SH DISPONIBILITÉ
\fBwinemaker\fR fait partie de la distribution de Wine, qui est disponible sur WineHQ, le
280
.UR https://www.winehq.org/
281 282 283 284 285
.B quartier général du développement de Wine
.UE .
.SH VOIR AUSSI
.BR wine (1),
.br
286
.UR https://www.winehq.org/help
287 288
.B Documentation et support de Wine
.UE .