tools/winemaker.de.man.in

   1 .\" -*- nroff -*-
   2 .TH WINEMAKER 1 "Januar 2012" "@PACKAGE_STRING@" "Wine Developers Manual"
   3 .SH NAME
   4 winemaker \- Erzeugt eine Buildumgebung 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 Um diese zu tun kann winemaker folgendes vornehmen:
  47 .PP
  48 - Quellcodedateien und Verzeichnisse in Kleinbuchstaben umbennen falls
  49 alle Buchstaben groß sind.
  50 .PP
  51 - DOS zu Unix konvertierung (CRLF to LF).
  52 .PP
  53 - include Anweisungen und Resource Referenzen durchsuchen um Backslashes
  54 durch Slashes zu ersetzen.
  55 .PP
  56 - während des oberen Schrittes wird winemaker auch nach der angegebenen Datei
  57 im Includepfad suchen um die entsprechende Zeile falls nötig mit der jeweiligen Schreibweise
  58 zu korriegieren.
  59 .PP
  60 - winemaker wird ebenso andere exotische Probleme wie die Benutzung von
  61 '#pragma pack', 'afxres.h' in nicht-MFC-Projekten und mehr untersuchen.
  62 Sollte irgendwas ungwöhnliches vorkommen wird winemaker Sie warnen.
  63 .PP
  64 - winemaker kann auch eine ganze Verzeichnisstruktur auf einmal durchsuchen,
  65 schätzen was die ausführbaren Dateien und Bibliotheken sind die Sie neu erstellen
  66 möchten und dazu die Quellcodedateien zuordnen.
  67 .PP
  68 - letzendlich wird winemaker eine Makefile für den normalen gebrauch erstellen.
  69 .PP
  70 - MFC-basierte Projekte werden erkannt und es werden angepasste Dateien erstellt.
  71 .PP
  72 - Existierende Projektdateien können von winemaker gelesen werden.
  73 Unterstützt werden dsp, dsw, vcproj und sln Dateien.
  74 .PP
  75 .SH ARGUMENTE
  76 .TP
  77 .B --nobanner
  78 Schaltet das anzeigen des Banners aus.
  79 .TP
  80 .B --backup
  81 Lässt winemaker Backups von allen Quellcodedateien erstellen an denen
  82 Änderungen vorgenommen werden. Diese Option ist Standard.
  83 .TP
  84 .B --nobackup
  85 Lässt winemaker keine Backups erstellen.
  86 .TP
  87 .B --nosource-fix
  88 Lässt winemaker keine Quellcodedateien ändern (z.B. DOS zu Unix Konvertierung)
  89 Das kann Meldungen bei schreibgeschützten Dateien verhindern.
  90 .TP
  91 .B --lower-all
  92 Alle Dateien und Verzeichnisse werden in Kleinschreibung umbenannt.
  93 .TP
  94 .B --lower-uppercase
  95 Alle Dateien und Verzeichnisse die komplett groß geschrieben sind werden
  96 in Kleinschreibung umbenannt.
  97 Also "HALLO.C" würde umbenannt werden, "Welt.c" jedoch nicht.
  98 .TP
  99 .B --lower-none
 100 Keine Dateien und Verzeichnisse werden in Kleinschreibung umbenannt.
 101 Achtung: Dies verhindert nicht die Umbennenung von Dateien, deren Erweiterung
 102 nicht verarbeiten lassen, wie z.B. ".Cxx". Diese Option ist Standard.
 103 .TP
 104 .B "--lower-include "
 105 Wenn die Datei zu einer include Anweisung (oder einer Resource Referenz)
 106 nicht auffindbar ist, wird der Dateiname in Kleinschreibung umbenannt.
 107 Diese Option ist Standard.
 108 .TP
 109 .B "--nolower-include "
 110 Wenn die Datei zu einer include Anweisung (oder einer Resource Referenz)
 111 nicht auffindbar ist, wird keine Änderung vorgenommen.
 112 .TP
 113 .BR "--guiexe " "| " "--windows"
 114 Gibt den Typ(grafisch) der zu erstellenden Anwendung an.
 115 Diese Option ist Standard.
 116 .TP
 117 .BR "--cuiexe " "| " "--console"
 118 Gibt den Typ(Konsole) der zu erstellenden Anwendung an.
 119 .TP
 120 .B --dll
 121 winemaker wird im Zweifelsfall annehmen, dass es sich um eine DLL handelt.
 122 .TP
 123 .B --lib
 124 winemaker wird im Zweifelsfall annehmen, dass es sich um eine statische Bibliothek handelt.
 125 .TP
 126 .B --mfc
 127 Teilt winemaker mit, dass es sich um MFC-basierten Quellcode handelt.
 128 In solch einem Fall passt winemaker Pfade für Header und Bibliotheken entsprechend an
 129 und kompiliert gegen die MFC Bibliothek.
 130 .TP
 131 .B --nomfc
 132 Teilt winemaker mit, dass es sich nicht um MFC-basierten Quellcode handelt.
 133 Selbst wenn winemaker dateien wie "stdafx.cpp" oder "stdafx.h" bemerkt, was automatisch
 134 MFC aktivieren würde, wenn weder --nomfc noch --mfc angegeben wurden.
 135 .TP
 136 .BI -D macro "\fR[=\fIdefn\fR]"
 137 Verwendet diese Makrodefinition global.
 138 .TP
 139 .BI -I dir
 140 Verwendet den Pfad als globalen Include-Pfad.
 141 .TP
 142 .BI -P dir
 143 Verwendet den Pfad als globalen DLL-Pfad.
 144 .TP
 145 .BI -i dll
 146 Fügt eine Winelib Bibliothek zu der globalen Liste der zu importierenden
 147 Winelib Bibliotheken hinzu.
 148 .TP
 149 .BI -L dir
 150 Verwendet den Pfad als globalen Bibliotheks-Pfad.
 151 .TP
 152 .BI -l library
 153 Fügt eine Bibliothek zu der globalen Liste der zu importierenden
 154 Bibliotheken hinzu.
 155 .TP
 156 .B --nodlls
 157 Dieso Option teil winemakr mit, nicht die Standard Winelib Bibliotheken zu importieren.
 158 Also muss jede DLL die der Quellcode nutzt explizit mit -i an winemaker übergeben werden.
 159 Die Standard Bibliotheken sind: odbc32.dll, odbccp32.dll, ole32.dll,
 160 oleaut32.dll und winspool.drv.
 161 .TP
 162 .B --nomsvcrt
 163 Dies hindert winegcc gegen msvcrt zu kompilieren.
 164 Nutzen Sie diese Option bei cpp-Dateien mit einem <string> include.
 165 .TP
 166 .B --interactive
 167 Versetzt winemaker in einen interaktiven Modus. In diesem Modus wird winemaker
 168 Sie für jede Targetliste in jedem Verzeichniss nach Bestätigung fragen und nach jeweils
 169 speziellen Optionen fragen.
 170 .TP
 171 .B --single-target name
 172 Es gibt nur ein Target namens "name".
 173 .TP
 174 .B --generated-files
 175 Eine Makefile soll erzeugt werden. Diese Option ist Standard.
 176 .TP
 177 .B --nogenerated-files
 178 Keine Makefile erstellen.
 179 .TP
 180 .B --wine32
 181 Ein 32-Bit Target erstellen. Das ist nützlich unter wow64 Systemen.
 182 Ohne dieser Option wird die Standard Architektur genutzt.
 183
 184 .SH BEISPIELE
 185 .PP
 186 Ein typischer winemaker aufruf:
 187 .PP
 188 $ winemaker --lower-uppercase -DSTRICT .
 189 .PP
 190 Damit scannt winemaker das aktuelle Verzeichnis und die Unterverzeichnisse nach
 191 Quellcodedateien. Jede Datei und jedes Verzeichnis das in Großbuchstaben geschrieben
 192 ist wird in Kleinbuchstaben umbenannt. Danach werden alle Quellcodedateien an die
 193 kompilierung mit Winelib angepasst und Makefiles erzeugt.
 194 '-DSTRICT' gibt an, dass das STRICT Makro gesetzt sein muss wenn man diesen Quellcode
 195 kompiliert. Letztendlich wird winemaker die globale Makefile erzeugen.
 196 .PP
 197 Der nächste Schritt wäre dann:
 198 .PP
 199 $ make
 200 .PP
 201 Wenn Sie hier Compiler Fehler sehen (was nicht unwahrscheinlich für ein einigermaßen
 202 großes Projekt), dann sollten Sie einen Blick in den Winelib User Guide werfen um
 203 für die Problemlösung ein paar Tipps zu finden.
 204 .PP
 205 Bei einem MFC-basierten Projekt müssen Sie stattdessen folgenden Befehl ausführen:
 206 .PP
 207 $ winemaker --lower-uppercase --mfc .
 208 .br
 209 $ make
 210 .PP
 211 Mit einer existierenden Projektdatei folgenden Befehl ausführen:
 212 .PP
 213 $ winemaker meinprojekt.dsp
 214 .br
 215 $ make
 216 .PP
 217
 218 .SH TODO / FEHLER
 219 .PP
 220 In einigen Fällen müssen Sie die Makefile oder den Quellcode nachbearbeiten.
 221 .PP
 222 Für den Fall das die Binärdateien schon vorhanden sind könnten wir winedump
 223 nutzen um die Art (grafisch oder Konsole), die benötigten Bibliotheken und welche
 224 Funktionen exportiert werden (bei den Bibliotheken). Wir könnten all diese Informationen
 225 für das Winelib Projekt verwenden.
 226 .PP
 227 Weiterhin ist winemaker nicht sehr gut darin die Bibliothek zu finden, die die
 228 Anwendung enthält. Sie muss entweder im aktuellen Verzeichnis sein oder in
 229 .IR LD_LIBRARY_PATH .
 230 .PP
 231 Winemaker unterstützt noch keine Messagedateien und deren Compiler.
 232 .PP
 233
 234 .SH SIEHE AUCH
 235 .PP
 236 Den Winelib User Guide:
 237 .PP
 238 http://www.winehq.org/docs/winelib-guide/index
 239 .PP
 240 .BR wine (1)
 241 .PP
 242
 243 .SH AUTOREN
 244 François Gouget for CodeWeavers
 245 .PP
 246 Dimitrie O. Paun
 247 .PP
 248 André Hentschel
 249 .PP