winemaker: Update man page.
This commit is contained in:
parent
df5c4178a8
commit
8f74c2b1a7
@ -1,5 +1,5 @@
|
|||||||
.\" -*- nroff -*-
|
.\" -*- nroff -*-
|
||||||
.TH WINEMAKER 1 "October 2005" "@PACKAGE_STRING@" "Wine Developers Manual"
|
.TH WINEMAKER 1 "February 2009" "@PACKAGE_STRING@" "Wine Developers Manual"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
winemaker \- generate a build infrastructure for compiling Windows programs on Unix
|
winemaker \- generate a build infrastructure for compiling Windows programs on Unix
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
@ -21,7 +21,7 @@ winemaker \- generate a build infrastructure for compiling Windows programs on U
|
|||||||
]
|
]
|
||||||
.br
|
.br
|
||||||
[
|
[
|
||||||
.IR "-Dmacro[=defn] " "] [ " "-Idir " "] [ " "-Ldir " "] [ " "-idll" "] [ " "-llibrary "
|
.IR "-Dmacro[=defn] " "] [ " "-Idir " "] [ " "-Pdir " "] [ " "-idll" "] [ " "-Ldir " "] [ " "-llibrary "
|
||||||
]
|
]
|
||||||
.br
|
.br
|
||||||
[
|
[
|
||||||
@ -30,7 +30,8 @@ winemaker \- generate a build infrastructure for compiling Windows programs on U
|
|||||||
.br
|
.br
|
||||||
[
|
[
|
||||||
.IR "--generated-files " "] [ " "--nogenerated-files " "]
|
.IR "--generated-files " "] [ " "--nogenerated-files " "]
|
||||||
]
|
.br
|
||||||
|
.IR "work_directory" "| " "project_file" "| " "workspace_file"
|
||||||
|
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.PP
|
.PP
|
||||||
@ -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
|
the executables and libraries you are trying to build, match them with
|
||||||
source files, and generate the corresponding Makefile.in files.
|
source files, and generate the corresponding Makefile.in files.
|
||||||
.PP
|
.PP
|
||||||
- finally winemaker will generate a global Makefile.in file calling out to all
|
- finally winemaker will generate a global Makefile for normal use.
|
||||||
the others, and a configure script customized for use with Winelib.
|
|
||||||
.PP
|
.PP
|
||||||
- winemaker knows about MFC-based project and will generate customized files.
|
- winemaker knows about MFC-based project and will generate customized files.
|
||||||
.PP
|
.PP
|
||||||
|
- winemaker can read existing Projectfiles. It supports dsp, dsw, vcproj and sln files.
|
||||||
|
.PP
|
||||||
.SH OPTIONS
|
.SH OPTIONS
|
||||||
.TP
|
.TP
|
||||||
.I --nobanner
|
.I --nobanner
|
||||||
@ -140,12 +142,15 @@ Adds the specified macro definition to the global list of macro definitions.
|
|||||||
.I -Idir
|
.I -Idir
|
||||||
Appends the specified directory to the global include path.
|
Appends the specified directory to the global include path.
|
||||||
.TP
|
.TP
|
||||||
.I -Ldir
|
.I -Pdir
|
||||||
Appends the specified directory to the global library path.
|
Appends the specified directory to the global dll path.
|
||||||
.TP
|
.TP
|
||||||
.I -idll
|
.I -idll
|
||||||
Adds the Winelib library to the global list of Winelib libraries to import.
|
Adds the Winelib library to the global list of Winelib libraries to import.
|
||||||
.TP
|
.TP
|
||||||
|
.I -Ldir
|
||||||
|
Appends the specified directory to the global library path.
|
||||||
|
.TP
|
||||||
.I -llibrary
|
.I -llibrary
|
||||||
Adds the specified library to the global list of libraries to link with.
|
Adds the specified library to the global list of libraries to link with.
|
||||||
.TP
|
.TP
|
||||||
@ -167,49 +172,39 @@ Tells winemaker not to generate the Makefile.
|
|||||||
.PP
|
.PP
|
||||||
Here is a typical winemaker use:
|
Here is a typical winemaker use:
|
||||||
.PP
|
.PP
|
||||||
$ winemaker --lower-uppercase -DSTRICT
|
$ winemaker --lower-uppercase -DSTRICT .
|
||||||
.PP
|
.PP
|
||||||
The above tells winemaker to scan the current directory and its
|
The above tells winemaker to scan the current directory and its
|
||||||
subdirectories for source files. Whenever if finds a file or directory which
|
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
|
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.
|
all these source files for compilation with Winelib and generate Makefiles.
|
||||||
The '-DSTRICT' specifies that the STRICT macro must be set when compiling
|
The '-DSTRICT' specifies that the STRICT macro must be set when compiling
|
||||||
these sources. Finally winemaker will create a global Makefile.in and
|
these sources. Finally winemaker will create a Makefile.
|
||||||
configure.in, and run autoconf to generate the configure script.
|
|
||||||
.PP
|
.PP
|
||||||
The next step would be:
|
The next step would be:
|
||||||
.PP
|
.PP
|
||||||
$ ./configure --with-wine=/usr/local/opt/wine
|
|
||||||
.PP
|
|
||||||
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.
|
|
||||||
.PP
|
|
||||||
And finally:
|
|
||||||
.PP
|
|
||||||
$ make
|
$ make
|
||||||
.PP
|
.PP
|
||||||
If at this point you get compilation errors (which is quite likely for a
|
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
|
reasonably sized project) then you should consult the Winelib User Guide to
|
||||||
find tips on how to resolve them.
|
find tips on how to resolve them.
|
||||||
.PP
|
.PP
|
||||||
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:
|
||||||
.PP
|
.PP
|
||||||
$ winemaker --lower-uppercase --mfc
|
$ winemaker --lower-uppercase --mfc .
|
||||||
.br
|
.br
|
||||||
$ ./configure --with-wine=/usr/local/opt/wine \\
|
$ make
|
||||||
.br
|
.PP
|
||||||
--with-mfc=/usr/local/opt/mfc
|
For an existing project-file you would have to run the following commands:
|
||||||
|
.PP
|
||||||
|
$ winemaker --lower-all myproject.dsp
|
||||||
.br
|
.br
|
||||||
$ make
|
$ make
|
||||||
.PP
|
.PP
|
||||||
|
|
||||||
.SH TODO / BUGS
|
.SH TODO / BUGS
|
||||||
.PP
|
.PP
|
||||||
Winemaker should support the Visual Studio project files (.dsp for newer
|
In some cases you will have to edit the Makefile or sourcefiles by yourself.
|
||||||
versions and .mak for some older versions). This would allow it to be much
|
|
||||||
more accurate, especially for the macro, include and library path
|
|
||||||
settings.
|
|
||||||
.PP
|
.PP
|
||||||
Assuming that the windows executable/library is available, we could
|
Assuming that the windows executable/library is available, we could
|
||||||
use a pedump-like tool to determine what kind of executable it is (graphical
|
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.
|
|||||||
.PP
|
.PP
|
||||||
The Winelib User Guide:
|
The Winelib User Guide:
|
||||||
.PP
|
.PP
|
||||||
http://wine.codeweavers.com/docs/winelib-user/
|
http://www.winehq.org/docs/winelib-guide/index
|
||||||
.PP
|
.PP
|
||||||
.BR wine (1)
|
.BR wine (1)
|
||||||
.PP
|
.PP
|
||||||
|
Loading…
x
Reference in New Issue
Block a user