winemaker.man: update man-page
nerv at dawncrow.de
Tue Mar 3 13:30:32 CST 2009
tools/winemaker.man.in | 51 +++++++++++++++++++++--------------------------
1 files changed, 23 insertions(+), 28 deletions(-)
diff --git a/tools/winemaker.man.in b/tools/winemaker.man.in
index fc57a3c..e8afb2d 100644
@@ -1,5 +1,5 @@
.\" -*- nroff -*-
-.TH WINEMAKER 1 "October 2005" "@PACKAGE_STRING@" "Wine Developers Manual"
+.TH WINEMAKER 1 "February 2009" "@PACKAGE_STRING@" "Wine Developers Manual"
winemaker \- generate a build infrastructure for compiling Windows programs on Unix
@@ -21,7 +21,7 @@ winemaker \- generate a build infrastructure for compiling Windows programs on U
-.IR "-Dmacro[=defn] " "] [ " "-Idir " "] [ " "-Ldir " "] [ " "-idll" "] [ " "-llibrary "
+.IR "-Dmacro[=defn] " "] [ " "-Idir " "] [ " "-Pdir " "] [ " "-idll" "] [ " "-Ldir " "] [ " "-llibrary "
@@ -30,7 +30,8 @@ winemaker \- generate a build infrastructure for compiling Windows programs on U
.IR "--generated-files " "] [ " "--nogenerated-files " "]
+.IR "work_directory" "| " "project_file" "| " "workspace_file"
@@ -60,11 +61,12 @@ encounters something out of the ordinary, winemaker will warn you about it.
the executables and libraries you are trying to build, match them with
source files, and generate the corresponding Makefile.in files.
-- finally winemaker will generate a global Makefile.in file calling out to all
-the others, and a configure script customized for use with Winelib.
+- finally winemaker will generate a global Makefile for normal use.
- winemaker knows about MFC-based project and will generate customized files.
+- winemaker can read existing Projectfiles. It supports dsp, dsw, vcproj and sln files.
@@ -140,12 +142,15 @@ Adds the specified macro definition to the global list of macro definitions.
Appends the specified directory to the global include path.
-Appends the specified directory to the global library path.
+Appends the specified directory to the global dll path.
Adds the Winelib library to the global list of Winelib libraries to import.
+Appends the specified directory to the global library path.
Adds the specified library to the global list of libraries to link with.
@@ -167,49 +172,39 @@ Tells winemaker not to generate the Makefile.
Here is a typical winemaker use:
-$ winemaker --lower-uppercase -DSTRICT
+$ winemaker --lower-uppercase -DSTRICT .
The above tells winemaker to scan the current directory and its
subdirectories for source files. Whenever if finds a file or directory which
name is all uppercase, it should rename it to lowercase. It should then fix
all these source files for compilation with Winelib and generate Makefiles.
The '-DSTRICT' specifies that the STRICT macro must be set when compiling
-these sources. Finally winemaker will create a global Makefile.in and
-configure.in, and run autoconf to generate the configure script.
+these sources. Finally winemaker will create a Makefile.
The next step would be:
-$ ./configure --with-wine=/usr/local/opt/wine
-This generates the makefiles from the Makefile.in files. The generated
-makefiles will fetch the Winelib headers and libraries from the Wine
-installation located in /usr/local/opt/wine.
If at this point you get compilation errors (which is quite likely for a
reasonably sized project) then you should consult the Winelib User Guide to
find tips on how to resolve them.
-For an MFC-based project one would have run the following commands instead:
+For an MFC-based project you would have to run the following commands instead:
-$ winemaker --lower-uppercase --mfc
-$ ./configure --with-wine=/usr/local/opt/wine \\
+$ winemaker --lower-uppercase --mfc .
+For an existing project-file you would have to run the following commands:
+$ winemaker --lower-all myproject.dsp
.SH TODO / BUGS
-Winemaker should support the Visual Studio project files (.dsp for newer
-versions and .mak for some older versions). This would allow it to be much
-more accurate, especially for the macro, include and library path
+In some cases you will have to edit the Makefile or sourcefiles by yourself.
Assuming that the windows executable/library is available, we could
use a pedump-like tool to determine what kind of executable it is (graphical
@@ -229,7 +224,7 @@ Winemaker does not support message files and the message compiler yet.
The Winelib User Guide:
.BR wine (1)
More information about the wine-patches