Added a new man page for winegcc.
This commit is contained in:
Dimitrie O. Paun
Alexandre Julliard
parent
27b8e5557e
commit
4e0c3aa551
|
|
@ -30,12 +30,15 @@ winegcc$(EXEEXT): winegcc.o utils.o
|
|||
$(CC) $(CFLAGS) -o $@ winegcc.o utils.o $(LIBPORT)
|
||||
|
||||
install:: $(PROGRAMS)
|
||||
$(MKINSTALLDIRS) $(bindir)
|
||||
$(MKINSTALLDIRS) $(bindir) $(mandir)/man$(prog_manext)
|
||||
$(INSTALL_PROGRAM) winegcc$(EXEEXT) $(bindir)/winegcc$(EXEEXT)
|
||||
cd $(bindir) && $(RM) wineg++$(EXEEXT) && $(LN_S) winegcc$(EXEEXT) wineg++$(EXEEXT)
|
||||
cd $(bindir) && $(RM) winecpp$(EXEEXT) && $(LN_S) winegcc$(EXEEXT) winecpp$(EXEEXT)
|
||||
$(INSTALL_DATA) $(SRCDIR)/winegcc.man $(mandir)/man$(prog_manext)/winegcc.$(prog_manext)
|
||||
cd $(mandir)/man$(prog_manext) && $(RM) wineg++.$(prog_manext) && $(LN_S) winegcc.$(prog_manext) wineg++.$(prog_manext)
|
||||
|
||||
uninstall::
|
||||
$(RM) $(bindir)/winegcc$(EXEEXT) $(bindir)/wineg++$(EXEEXT) $(bindir)/winecpp$(EXEEXT)
|
||||
$(RM) $(bindir)/winegcc$(EXEEXT) $(bindir)/wineg++$(EXEEXT) $(bindir)/winecpp$(EXEEXT) \
|
||||
$(mandir)/man$(prog_manext)/winegcc.$(prog_manext) $(mandir)/man$(prog_manext)/wineg++.$(prog_manext)
|
||||
|
||||
### Dependencies:
|
||||
|
|
|
|||
|
|
@ -0,0 +1,84 @@
|
|||
.TH WINEGCC 1 "January 2005" "Wine Manpage" "Wine Developers Manual"
|
||||
.SH NAME
|
||||
winegcc \- Wine C and C++ MinGW Compatible Compiler
|
||||
.SH SYNOPSIS
|
||||
.BR "winegcc "\fI[options]\fR " \fIinfile\fR"...
|
||||
.SH DESCRIPTION
|
||||
.B winegcc
|
||||
is a gcc wrapper which tries to provide a MinGW compatible compiler
|
||||
under Linux. This is most useful to Win32 developers who can simply
|
||||
take their MinGW code from Windows, and recompile it without
|
||||
modifications under Winelib on Linux.
|
||||
wineg++ accepts mostly the same options as winegcc.
|
||||
.PP
|
||||
The goal of winegcc is to be able to simply replace gcc/g++/windres
|
||||
with winegcc/wineg++/wrc in a MinGW Makefile, and just recompile
|
||||
the application using Winelib under Wine. While typically there are
|
||||
small adjustments that must be made to the application source code
|
||||
and/or Makefile, it is quite easy to do them in a fashion that is
|
||||
compatible between the MinGW and Wine environments.
|
||||
.PP
|
||||
This manual will document only the differences from gcc; please consult
|
||||
the gcc manual for more information on those options.
|
||||
.PP
|
||||
.SH OPTIONS
|
||||
.B gcc options:
|
||||
All gcc options are supported, and are passed along to the backend
|
||||
compiler.
|
||||
.IP "\fB-B\fIprefix\fR"
|
||||
This option specifies where to find the executables, libraries,
|
||||
include files, and data files of the compiler itself. This is a
|
||||
standard gcc option that has been extended to recognize a
|
||||
\fIprefix\fR ending with '/tools/winebuild', in which case winegcc
|
||||
enters a special mode for building Wine itself. Developers should
|
||||
avoid prefixes ending with the magic suffix, or if that is not
|
||||
possible, simply express it differently, such as '/tools/winebuild/',
|
||||
to avoid the special behaviour.
|
||||
.IP \fB-fno-short-wchar\fR
|
||||
Override the underlying type for wchar_t to be the default for the
|
||||
target, instead of using short unsigned int, which is the default
|
||||
for Win32.
|
||||
.IP \fB-mconsole\fR
|
||||
This option passes '--subsystem console' to winebuild, to build
|
||||
console applications. It is the default.
|
||||
.IP \fB-mno-cygwin\fR
|
||||
Use Wine's implementation of MSVCRT, instead of linking against
|
||||
the host system's libc. This is necessary for the vast majority
|
||||
of Win32 applications, as they typically depend on various features
|
||||
of MSVCRT. This switch is also used by the MinGW compiler to link
|
||||
against MSVCRT on Windows, instead of linking against Cygwin's
|
||||
libc. Sharing the syntax with MinGW makes it very easy to write
|
||||
Makefiles that work under Wine, MinGW+MSYS, or MinGW+Cygwin.
|
||||
.IP \fB-mwindows\fR
|
||||
This option adds -lgdi32, -lcomdlg32, and -lshell32 to the list of
|
||||
default libraries, and passes '--subsystem windows' to winebuild
|
||||
to build graphical applications.
|
||||
.IP \fB-nodefaultlibs\fR
|
||||
Do not use the standard system libraries when linking. These
|
||||
include at a minimum -lkernel32, -luser32, -ladvapi32, and
|
||||
any default libraries used by the backend compiler. The -mwindows
|
||||
option augments the list of default libraries as described above.
|
||||
.IP \fB-Wb,option\fR
|
||||
Pass option as an option to winebuild. If option contains
|
||||
commas, it is split into multiple options at the commas.
|
||||
.SH DEFINES
|
||||
winegcc defines __WINE__, for code that needs to know when it is
|
||||
being compiled under Wine. It also defines WIN32, _WIN32, __WIN32,
|
||||
__WIN32__, __WINNT, and __WINNT__ for compatibility with MinGW.
|
||||
.SH BUGS
|
||||
The dllimport/dllexport attributes are not supported at the moment,
|
||||
due to lack of support for these features in the ELF version of gcc.
|
||||
.PP
|
||||
Static linking is not currently supported against Wine's DLL. As a
|
||||
result, the -static, --static, and -Wl,-static options will generate
|
||||
an error.
|
||||
.SH AUTHORS
|
||||
.B winegcc
|
||||
was written by Dimitrie O. Paun.
|
||||
.SH "SEE ALSO"
|
||||
.BR gcc(1),
|
||||
.BR winebuild(1),
|
||||
.BR wrc(1),
|
||||
.BR wine(1),
|
||||
.BR "Winelib User Guide",
|
||||
.BR "Wine Developers Guide".
|
||||
Loading…
Reference in New Issue