1 .TH WINEMAKER 1 "jan 2012" "@PACKAGE_STRING@" "Manuel des développeurs de Wine"
3 winemaker \- générer une infrastructure de construction pour la compilation de programmes Windows sur UNIX
7 .BR "--nobanner " "] [ " "--backup " "| " "--nobackup " "] [ "--nosource-fix "
11 .BR "--lower-none " "| " "--lower-all " "| " "--lower-uppercase "
15 .BR "--lower-include " "| " "--nolower-include " ]\ [ " --mfc " "| " "--nomfc "
19 .BR "--guiexe " "| " "--windows " "| " "--cuiexe " "| " "--console " "| " "--dll " "| " "--lib "
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 "
27 .BR "--nodlls " "] [ " "--nomsvcrt " "] [ " "--interactive " "] [ " "--single-target \fInom\fR "
31 .BR "--generated-files " "] [ " "--nogenerated-files " "]
37 .IR " répertoire_de_travail" "| " "fichier_projet" "| " "fichier_espace_de_travail"
42 est un script perl conçu pour vous aider à entamer le
43 processus de conversion de vos sources Windows en programmes Winelib.
45 À cet effet, il peut effectuer les opérations suivantes :
47 -\ renommer vos fichiers sources et répertoires en minuscules s'ils ont été
48 convertis en majuscules durant le transfert.
50 -\ convertir les fins de ligne DOS en fins de ligne UNIX (CRLF vers LF).
52 -\ balayer les directives d'inclusion et les références aux fichiers
53 de ressources pour y remplacer les backslashs par des slashs.
55 -\ durant l'étape ci-dessus,
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.
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
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
75 générera un \fIMakefile\fR global pour une utilisation classique.
78 comprend les projets de type MFC, et génère des fichiers appropriés.
81 est capable de lire des fichiers projets existants (dsp, dsw, vcproj et sln).
86 Désactiver l'affichage de la bannière.
89 Effectuer une sauvegarde préalable de tous les fichiers modifiés.
90 Comportement par défaut.
93 Ne pas effectuer de sauvegarde des fichiers sources modifiés.
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
101 Renommer tous les fichiers et répertoires en minuscules.
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.
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
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
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.
134 Présumer une DLL quand une cible d'un type inconnu est rencontrée (c.-à-d. si
136 ne peut déterminer s'il s'agit d'un exécutable, d'une DLL ou d'une bibliothèque statique).
139 Présumer une bibliothèque statique quand une cible d'un type inconnu est rencontrée (c.-à-d. si
141 ne peut déterminer s'il s'agit d'un exécutable, d'une DLL ou d'une bibliothèque statique).
144 Spécifier que les cibles utilisent les MFC. Dans ce cas,
146 adapte les chemins d'inclusion et des bibliothèques en conséquence,
147 et lie la cible avec la bibliothèque MFC.
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
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
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.
162 Ajouter le répertoire spécifié au chemin global d'inclusion.
165 Ajouter le répertoire spécifié au chemin global des DLL.
168 Ajouter la bibliothèque Winelib à la liste global de bibliothèques Winelib
172 Ajouter le répertoire spécifié au chemin global des bibliothèques.
175 Ajouter la bibliothèque spécifiée à la liste globale de bibliothèques à utiliser lors de l'édition des liens.
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
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.
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.
190 Utiliser le mode interactif. Dans ce mode,
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.
199 Générer le \fIMakefile\fR. Comportement par défaut.
201 .B --nogenerated-files
202 Ne pas générer le \fIMakefile\fR.
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.
210 Voici quelques exemples typiques d'utilisation de
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 :
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
235 $ winemaker --lower-uppercase --mfc .
239 Pour un fichier projet existant, vous devriez exécuter les commandes suivantes :
241 $ winemaker monprojet.dsp
246 .SH LIMITATIONS / PROBLÈMES
248 Dans certains cas, vous devrez éditer manuellement le \fIMakefile\fR ou les fichiers
251 En supposant que l'exécutable ou la bibliothèque windows est disponible, on peut
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.
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 .
266 ne prend pas encore en charge les fichiers de messages, ni le compilateur
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
274 François Gouget pour CodeWeavers
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
287 .UR http://www.winehq.org/help
288 .B Documentation et support de Wine