jammy (1) winecpp-development.1.gz

NAME

       winegcc - Wine C and C++ MinGW Compatible Compiler

SYNOPSIS

       winegcc [options] infile...

DESCRIPTION

       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.

       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.

       This manual will document only the  differences  from  gcc;  please  consult  the  gcc  manual  for  more
       information on those options.

OPTIONS

       gcc options: All gcc options are supported, and are passed along to the backend compiler.

       -b,--target target
              Specify  the  target architecture triplet for cross-compiling. winegcc will then invoke target-gcc
              instead of gcc.

       --wine-objdir dir
              Specify the Wine object directory. This is used when building Wine itself, to use the includes and
              libraries from inside the build tree.

       --winebuild name
              Specifies  the  path  and  name  of  the  winebuild  binary that will be launched automatically by
              winegcc.  If not set, winegcc will look for a  file  named  winebuild  in  the  path.  This  takes
              precedence over the WINEBUILD environment variable.

       -fno-short-wchar
              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.

       -mconsole
              This option passes '--subsystem console' to winebuild, to build console applications.  It  is  the
              default.

       -mno-cygwin
              Use  Wine  implementation  of  MSVCRT,  instead  of  linking against the host system 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 libc. Sharing the syntax with MinGW makes it very  easy
              to write Makefiles that work under Wine, MinGW+MSYS, or MinGW+Cygwin.

       -municode
              Set  the  default entry point of the application to be the Unicode wmain() instead of the standard
              main().

       -mwindows
              This option adds -lgdi32, -lcomdlg32, and -lshell32 to the list of default libraries,  and  passes
              '--subsystem  windows' to winebuild to build graphical applications.  -munix Set when building the
              Unix counterpart of a builtin module.

       -nodefaultlibs
              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.

       -nostartfiles
              Do not add the winecrt0 library when linking.

       -Wb,option
              Pass an option to winebuild.  If option contains commas, it is split into multiple options at  the
              commas.

       -Wl,--out-implib,lib.a
              When linking a dll, also create its corresponding import library.

ENVIRONMENT

       WINEBUILD
              Specifies  the  path  and  name  of  the  winebuild  binary that will be launched automatically by
              winegcc.  If not set, winegcc will look for a file named winebuild in the path.

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.

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.

       Static linking is not currently supported against Wine DLLs. As a  result,  the  -static,  --static,  and
       -Wl,-static options will generate an error.

       Bugs can be reported on the Wine bug tracker ⟨https://bugs.winehq.org⟩.

AUTHORS

       winegcc was written by Dimitrie O. Paun.

AVAILABILITY

       winegcc  is  part  of  the  Wine  distribution,  which  is available through WineHQ, the Wine development
       headquarters ⟨https://www.winehq.org/⟩.

SEE ALSO

       gcc(1), winebuild(1), wrc(1), wine(1),
       Wine documentation and support ⟨https://www.winehq.org/help⟩.