tools/winemaker.fr.man.in

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