| blob | 2446a4f20713df0d5bc4dfe2844b91d084cd49d6 |
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"
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.
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
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 .