tools/winemaker.de.UTF-8.man.in

   1 .\" -*- nroff -*-
   2 .TH WINEMAKER 1 "Januar 2012" "@PACKAGE_STRING@" "Wine Entwicklerhandbuch"
   3 .SH NAME
   4 winemaker \- Erzeugt eine Build-Infrastruktur, um Windows Programme unter Unix zu kompilieren
   5 .SH ÜBERSICHT
   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 " "| " "--lib "
  21 ]
  22 .br
  23   [
  24 .BI               "-D" macro "\fR[=\fIdefn\fR] ] [" "\ " "-I" "dir\fR ]\ [ " "-P" "dir\fR ] [ " "-i" "dll\fR ] [ " "-L" "dir\fR ] [ " "-l" "library "
  25 ]
  26 .br
  27   [
  28 .BR               "--nodlls " "] [ " "--nomsvcrt " "] [ " "--interactive " "] [ " "--single-target \fIname\fR "
  29 ]
  30 .br
  31   [
  32 .BR               "--generated-files " "] [ " "--nogenerated-files " "]
  33 ]
  34 .br
  35   [
  36 .BR               "--wine32 " "]
  37 .br
  38 .IR               "  Arbeitsverzeichnis" " | " "Projektdatei" " | " "Workspacedatei"
  39
  40 .SH BESCHREIBUNG
  41 .PP
  42 .B winemaker
  43 ist ein Perl-Script um Ihnen das Konvertieren von Windows-Quellcode
  44 zu einem Winelib-Programm zu erleichtern.
  45 .PP
  46 Zu diesem Zweck beherrscht Winemaker folgende Operationen:
  47 .PP
  48 - Quellcodedateien und Verzeichnisse in Kleinbuchstaben umbenennen, falls
  49 diese beim Übertragen komplett in Großbuchstaben angekommen sind.
  50 .PP
  51 - Konvertierung von DOS- zu Unix-Zeilenenden (CRLF nach LF).
  52 .PP
  53 - Include-Anweisungen und Resourcenreferenzen durchsuchen, um Backslashes
  54 durch Slashes zu ersetzen.
  55 .PP
  56 - Während des obigen Schrittes wird Winemaker ebenfalls nach der angegebenen Datei
  57 im Includepfad suchen und die entsprechende Zeile, falls nötig, mit der korrekten
  58 Groß-/Kleinschreibweise austauschen.
  59 .PP
  60 - Winemaker wird ebenso andere, exotischere Probleme wie die Benutzung von
  61 '#pragma pack', 'afxres.h' in nicht-MFC-Projekten und mehr untersuchen.
  62 Sollte etwas ungwöhnliches vorkommen, wird Winemaker Sie warnen.
  63 .PP
  64 - Winemaker kann eine ganze Verzeichnisstruktur auf einmal durchsuchen,
  65 schätzen welche ausführbaren Dateien und Bibliotheken Sie zu erstellen
  66 gedenken, diese den passenden Quelldateien zuordnen und entsprechende Makefiles
  67 generieren.
  68 .PP
  69 - letztendlich wird Winemaker eine globale Makefile für den normalen Gebrauch erzeugen.
  70 .PP
  71 - Winemaker erkennt MFC-basierte Projekte und erstellt angepasste Dateien.
  72 .PP
  73 - Existierende Projektdateien können von Winemaker gelesen werden.
  74 Unterstützt sind dsp, dsw, vcproj und sln-Dateien.
  75 .PP
  76 .SH ARGUMENTE
  77 .TP
  78 .B --nobanner
  79 Unterdrückt die Anzeige des Banners.
  80 .TP
  81 .B --backup
  82 Lässt Winemaker Backups von allen Quellcodedateien anlegen, an denen
  83 Änderungen vorgenommen werden. Diese Option ist Standard.
  84 .TP
  85 .B --nobackup
  86 Lässt Winemaker keine Backups anlegen.
  87 .TP
  88 .B --nosource-fix
  89 Weist Winemaker an, keine Quellcodedateien zu ändern (z.B. DOS zu Unix
  90 Konvertierung). Verhindert Fehlermeldungen bei schreibgeschützten Dateien.
  91 .TP
  92 .B --lower-all
  93 Alle Dateien und Verzeichnisse werden in Kleinschreibung umbenannt.
  94 .TP
  95 .B --lower-uppercase
  96 Nur Dateien und Verzeichnisse, die komplett groß geschrieben sind, werden
  97 in Kleinschreibung umbenannt.
  98 "HALLO.C" würde beispielsweise umbenannt werden, "Welt.c" jedoch nicht.
  99 .TP
 100 .B --lower-none
 101 Keine Dateien und Verzeichnisse werden in Kleinschreibung umbenannt.
 102 Beachten Sie, dass dies nicht die Umbenennung von Dateien verhindert, deren
 103 Erweiterungen nicht unverändert verarbeitet werden können, z.B. ".Cxx".
 104 Diese Option ist Standard.
 105 .TP
 106 .B "--lower-include "
 107 Wenn die Datei zu einer Include-Anweisung (oder einer anderen Form von
 108 Dateireferenz für Resourcen) nicht auffindbar ist, wird der Dateiname in
 109 Kleinschreibung umbenannt. Diese Option ist Standard.
 110 .TP
 111 .B "--nolower-include "
 112 Es werden keine Änderungen an Include-Anweisungen oder Referenzen vorgenommen,
 113 wenn die entsprechende Datei nicht auffindbar ist.
 114 .TP
 115 .BR "--guiexe " "| " "--windows"
 116 Legt fest, dass für jedes gefundene, ausführbare Target, oder Target unbekannten
 117 Typs angenommen wird, dass es sich um eine grafische Anwendung handelt.
 118 Diese Option ist Standard.
 119 .TP
 120 .BR "--cuiexe " "| " "--console"
 121 Legt fest, dass für jedes gefundene, ausführbare Target, oder Target unbekannten
 122 Typs angenommen wird, dass es sich um eine Konsolenanwendung handelt.
 123 .TP
 124 .B --dll
 125 Winemaker wird im Zweifelsfall annehmen, dass es sich bei einem unbekannten
 126 Target um eine DLL handelt.
 127 .TP
 128 .B --lib
 129 Winemaker wird im Zweifelsfall annehmen, dass es sich bei einem unbekannten
 130 Target um eine statische Bibliothek handelt.
 131 .TP
 132 .B --mfc
 133 Teilt Winemaker mit, dass es sich um MFC-basierte Ziele handelt. In solch einem
 134 Fall passt Winemaker Pfade für Header und Bibliotheken entsprechend an und
 135 verlinkt die Ziele mit der MFC-Bibliothek.
 136 .TP
 137 .B --nomfc
 138 Teilt Winemaker mit, dass es sich nicht um MFC-basierte Ziele handelt. Diese
 139 Option verhindert die Benutzung von MFC-Bibliotheken, selbst wenn Winemaker
 140 Dateien wie "stdafx.cpp" oder "stdafx.h" begegnet, was normalerweise automatisch
 141 MFC aktivieren würde, wenn weder \fB--nomfc\fR noch \fB--mfc\fR angegeben wurden.
 142 .TP
 143 .BI -D macro "\fR[=\fIdefn\fR]"
 144 Fügt diese Makrodefinition zur globalen Makroliste hinzu.
 145 .TP
 146 .BI -I dir
 147 Hängt das angegebene Verzeichnis dem globalen Include-Pfad an.
 148 .TP
 149 .BI -P dir
 150 Hängt das angegebene Verzeichnis dem globalen DLL-Pfad an.
 151 .TP
 152 .BI -i dll
 153 Fügt die angegebene Winelib-Bibliothek zur globalen Liste der zu importierenden
 154 Winelib-Bibliotheken hinzu.
 155 .TP
 156 .BI -L dir
 157 Hängt das angegebene Verzeichnis dem globalen Bibliotheks-Pfad an.
 158 .TP
 159 .BI -l library
 160 Fügt die angegebene Bibliothek zur globalen Liste der zu verlinkenden
 161 Bibliotheken hinzu.
 162 .TP
 163 .B --nodlls
 164 Diese Option teilt Winemaker mit, nicht den Standardsatz an Winelib-Bibliotheken
 165 zu importieren. Dies bedeutet, dass jede DLL, die Ihr Quellcode nutzt, explizit
 166 mit \fB-i\fR an Winemaker übergeben werden muss.
 167 Die Standard-Bibliotheken sind: odbc32.dll, odbccp32.dll, ole32.dll,
 168 oleaut32.dll und winspool.drv.
 169 .TP
 170 .B --nomsvcrt
 171 Setzt einige Optionen, die winegcc daran hindern, gegen msvcrt zu kompilieren.
 172 Nutzen Sie diese Option bei cpp-Dateien, die <string> einbinden.
 173 .TP
 174 .B --interactive
 175 Versetzt Winemaker in einen interaktiven Modus. In diesem Modus wird Winemaker
 176 Sie für die Targetliste jedes Verzeichnisses nach Bestätigung und jeweils
 177 target- und verzeichnisspezifischen Optionen fragen.
 178 .TP
 179 .BI --single-target " name"
 180 Gibt an, dass es nur ein einziges Target gibt, namens \fIname\fR.
 181 .TP
 182 .B --generated-files
 183 Weist Winemaker an, eine Makefile zu erzeugen. Diese Option ist Standard.
 184 .TP
 185 .B --nogenerated-files
 186 Weist Winemaker an, keine Makefile zu erzeugen.
 187 .TP
 188 .B --wine32
 189 Weist Winemaker an, ein 32-Bit Target zu erstellen. Dies ist nützlich bei
 190 wow64-Systemen. Ohne diese Option wird die Standardarchitektur benutzt.
 191
 192 .SH BEISPIELE
 193 .PP
 194 Ein typischer Winemaker Aufruf:
 195 .PP
 196 $ winemaker --lower-uppercase -DSTRICT .
 197 .PP
 198 Damit scannt Winemaker das aktuelle Verzeichnis und die Unterverzeichnisse nach
 199 Quellcodedateien. Jede Datei und jedes Verzeichnis, das ganz in Großbuchstaben
 200 geschrieben ist, wird in Kleinbuchstaben umbenannt. Danach werden alle Quellcodedateien
 201 an die Kompilierung mit Winelib angepasst und Makefiles erzeugt.
 202 '-DSTRICT' gibt an, dass das STRICT-Makro gesetzt sein muss, um diesen Quellcode
 203 zu kompilieren. Letztendlich wird Winemaker die globale Makefile erzeugen.
 204 .PP
 205 Der nächste Schritt wäre dann:
 206 .PP
 207 $ make
 208 .PP
 209 Wenn Sie an diesem Punkt Compilerfehler erhalten (was recht wahrscheinlich ist,
 210 ab einer gewissen Projektgröße), sollten Sie den Winelib User Guide zu Rate
 211 ziehen, um Problemlösungen und Tipps zu finden.
 212 .PP
 213 Bei einem MFC-basierten Projekt sollten Sie stattdessen folgenden Befehl ausführen:
 214 .PP
 215 $ winemaker --lower-uppercase --mfc .
 216 .br
 217 $ make
 218 .PP
 219 Mit einer existierenden Projektdatei lautet der passende Befehl:
 220 .PP
 221 $ winemaker meinprojekt.dsp
 222 .br
 223 $ make
 224 .PP
 225
 226 .SH TODO / FEHLER
 227 .PP
 228 In einigen Fällen werden Sie die Makefile oder den Quellcode von Hand
 229 nachbearbeiten müssen.
 230 .PP
 231 Angenommen, die fertigen Windows-Bibliotheken oder Binärdateien sind vorhanden,
 232 könnte mit winedump ermittelt werden, um welche Art von ausführbarer Datei es
 233 sich handelt (grafisch oder Konsole), gegen welche Bibliotheken sie gelinkt
 234 sind und welche Funktionen exportiert werden (bei Bibliotheken). All diese
 235 Informationen könnten dann für das Winelib-Projekt verwendet werden.
 236 .PP
 237 Weiterhin ist Winemaker nicht sehr gut darin, die Bibliothek zu finden, die
 238 die Anwendung enthält: Sie muss entweder im aktuellen Verzeichnis oder im
 239 .IR LD_LIBRARY_PATH liegen.
 240 .PP
 241 Winemaker unterstützt noch keine Messagedateien und deren Compiler.
 242 .PP
 243 Fehler können im
 244 .UR http://bugs.winehq.org
 245 .B Wine Bugtracker
 246 .UE
 247 gemeldet werden.
 248 .SH AUTOREN
 249 François Gouget für CodeWeavers
 250 .br
 251 Dimitrie O. Paun
 252 .br
 253 André Hentschel
 254 .SH VERFÜGBARKEIT
 255 .B Winemaker
 256 ist Teil der Wine-Distribution, verfügbar im WineHQ, dem
 257 .UR http://www.winehq.org/
 258 .B Hauptquartier der Wine-Entwicklung
 259 .UE .
 260 .SH SIEHE AUCH
 261 .BR wine (1),
 262 .br
 263 .UR http://www.winehq.org/help
 264 .B Wine-Dokumentation und Support
 265 .UE .