.TH WINEMAKER 1 "jan 2012" "Wine 2.9" "Manuel des développeurs de Wine" .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 [ .BR "--guiexe " "| " "--windows " "| " "--cuiexe " "| " "--console " "| " "--dll " "| " "--lib " ] .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 .IR " répertoire_de_travail" " | " "fichier_projet" " | " "fichier_espace_de_travail" .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 -\ convertir les fins de ligne DOS en fins de ligne UNIX (CRLF vers LF). .PP -\ parcourir les directives d'inclusion et les références aux fichiers 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 de \fI#pragma pack\fR, l'utilisation de \fIafxres.h\fR dans des projets 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, les faire correspondre à des fichiers sources, et générer le \fIMakefile\fR correspondant. .PP -\ finalement, .B winemaker générera un \fIMakefile\fR global pour une utilisation classique. .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 en lecture seule. .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. Ainsi, \fIHELLO.C\fR serait renommé, mais pas \fIWorld.c\fR. .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 telle quelle, comme par exemple « .Cxx ». Comportement par défaut. .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 Présumer une DLL 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). .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). .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 rencontre des fichiers \fIstdafx.cpp\fR ou \fIstdafx.h\fR qui activeraient les MFC automatiquement en temps normal si ni \fB--nomfc\fR ni \fB--mfc\fR n'était spécifiée. .TP .BI -D macro "\fR[\fB=\fIdéfn\fR]" 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, c.-à-d. que toute DLL utilisée par votre code doit être explicitement spécifiée à l'aide d'options \fB-i\fR. L'ensemble standard de bibliothèques est : \fIodbc32.dll\fR, \fIodbccp32.dll\fR, \fIole32.dll\fR, \fIoleaut32.dll\fR et \fIwinspool.drv\fR. .TP .B --nomsvcrt Définir certaines options afin que \fBwinegcc\fR n'utilise pas msvcrt durant la compilation. Utilisez cette option si certains fichiers cpp incluent \fI\fR. .TP .B --interactive Utiliser le mode interactif. Dans ce mode, .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 .BI --single-target " nom" Spécifier qu'il n'y a qu'une seule cible, appelée \fInom\fR. .TP .B --generated-files Générer le \fIMakefile\fR. Comportement par défaut. .TP .B --nogenerated-files Ne pas générer le \fIMakefile\fR. .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 \fIMakefile\fRs. \fB-DSTRICT\fR spécifie que la macro \fBSTRICT\fR doit être définie lors de la compilation des sources. Finalement, un \fIMakefile\fR est créé. .PP L'étape suivante serait : .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 le guide de l'utilisateur de Winelib pour trouver des moyens de les résoudre. .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 Dans certains cas, vous devrez éditer manuellement le \fIMakefile\fR ou les fichiers 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 .BR LD_LIBRARY_PATH . .PP .B winemaker ne prend pas encore en charge les fichiers de messages, ni le compilateur de messages. .PP Les bugs peuvent être signalés (en anglais) sur le .UR http://bugs.winehq.org .B système de suivi des problèmes de Wine .UE . .SH AUTEURS François Gouget pour CodeWeavers .br Dimitrie O. Paun .br André Hentschel .SH DISPONIBILITÉ \fBwinemaker\fR fait partie de la distribution de Wine, qui est disponible sur WineHQ, le .UR http://www.winehq.org/ .B quartier général du développement de Wine .UE . .SH VOIR AUSSI .BR wine (1), .br .UR http://www.winehq.org/help .B Documentation et support de Wine .UE .