X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/70373b5a57223350e0fcc4968920f81463dc6125..df191bfe39c1a40649173212029e4967d425a48c:/docs/wine/install.txt diff --git a/docs/wine/install.txt b/docs/wine/install.txt index 29fc50154b..9a5cd5da1a 100644 --- a/docs/wine/install.txt +++ b/docs/wine/install.txt @@ -1,37 +1,8 @@ - !!! When sending bug reports tell us what version of wxWindows you are - using (including the beta) and what compiler on what system. One - example: wxWINE 2.1 snapshot 6, egcs 1.1.1, Redhat 5.0 !!! - -* Preparing WINE ----------------- - -Most C++ compilers cannot compile the WINE sources yet (this includes -all versions of g++ and egcs) so you have to make a minimal change -and recompile all of WINE in order to get anywhere. - -(Note: this information may be out of date now. See notes at -the bottom of this file.) - -This change has do be applied to the /include/windef.h file, line 59 -in the section "Calling convention definitions", where the sources -reads: - -#if __i386__ - -which has to be changed into - -#if 0 - -After this change, you'll have to recompile all of WINE without -forgetting to install it. The direct consequence of this change -is that the Win32 binary emulator won't work anymore, as the -change disables the Windows native calling convention. - * The most simple case ----------------------- -If you compile wxWindows on Linux for the first time and don't like to read +If you compile wxWidgets on Linux for the first time and don't like to read install instructions just do (in the base dir): > ./configure --with-wine @@ -45,7 +16,7 @@ On all variants of Unix except Linux (and maybe except *BSD), shared libraries are not supported out of the box due to the utter stupidity of libtool, so you'll have to do this to get shared library support: -> ./configure --with-wine --disable-static --enable-shared +> ./configure --with-wine --disable-unicode --disable-static --enable-shared Then you'll have to edit the wrongly created libtool script. There are two important entries with respect to shared library creation, which are @@ -66,7 +37,7 @@ Afterwards you can continue with > ldconfig > exit -If you want to remove wxWindows on Unix you can do this: +If you want to remove wxWidgets on Unix you can do this: > su > make uninstall @@ -76,10 +47,10 @@ If you want to remove wxWindows on Unix you can do this: * The expert case ----------------- -If you want to do some more serious cross-platform programming with wxWindows, +If you want to do some more serious cross-platform programming with wxWidgets, such as for GTK and Motif, you can now build two complete libraries and use them concurrently. For this end, you have to create a directory for each build -of wxWindows - you may also want to create different versions of wxWindows +of wxWidgets - you may also want to create different versions of wxWidgets and test them concurrently. Most typically, this would be a version configured with --enable-debug_flag and one without. Note, that only one build can currently be installed, so you'd have to use local version of the library for that purpose. @@ -131,7 +102,7 @@ g++ myfoo.cpp `wx-config --libs --cflags` -o myfoo * General ----------------------- -The Unix variants of wxWindows use GNU configure. If you have problems with your +The Unix variants of wxWidgets use GNU configure. If you have problems with your make use GNU make instead. If you have general problems with installation, read my homepage at @@ -146,7 +117,7 @@ YOU USE AND WHAT ERROR WAS REPORTED. I know this has no effect, but I tried... * GUI libraries ----------------------- -wxWindows/WINE requires the WINE library to be installed on your system. +wxWidgets/WINE requires the WINE library to be installed on your system. You can get the newest version of the WINE from the WINE homepage at: @@ -191,7 +162,7 @@ i.e. if it says "--disable-threads" it means that threads are enabled by default. Many of the configure options have been thoroughly tested -in wxWindows snapshot 6, but not yet all (ODBC not). +in wxWidgets snapshot 6, but not yet all (ODBC not). You must do this by running configure with either of: @@ -235,7 +206,7 @@ The following options handle the kind of library you want to build. such as gdb (or its many frontends). --enable-debug_flag Define __DEBUG__ and __WXDEBUG__ when - compiling. This enable wxWindows' very + compiling. This enable wxWidgets' very useful internal debugging tricks (such as automatically reporting illegal calls) to work. Note that program and library @@ -246,11 +217,11 @@ The following options handle the kind of library you want to build. ------------------- Many of the configure options have been thoroughly tested -in wxWindows snapshot 6, but not yet all (ODBC not). +in wxWidgets snapshot 6, but not yet all (ODBC not). When producing an executable that is linked statically with wxGTK you'll be surprised at its immense size. This can sometimes be -drastically reduced by removing features from wxWindows that +drastically reduced by removing features from wxWidgets that are not used in your program. The most relevant such features are @@ -315,7 +286,7 @@ password) and type make install -You can remove any traces of wxWindows by typing +You can remove any traces of wxWidgets by typing make uninstall @@ -337,13 +308,13 @@ g++ myfoo.cpp `wx-config --libs` `wx-config --cflags` -o myfoo Using this way, a make file for the minimal sample would look like this -CC = g++ +CXX = g++ minimal: minimal.o - $(CC) -o minimal minimal.o `wx-config --libs` + $(CXX) -o minimal minimal.o `wx-config --libs` -minimal.o: minimal.cpp mondrian.xpm - $(CC) `wx-config --cflags` -c minimal.cpp -o minimal.o +minimal.o: minimal.cpp + $(CXX) `wx-config --cflags` -c minimal.cpp -o minimal.o clean: rm -f *.o minimal @@ -352,7 +323,7 @@ This is certain to become the standard way unless we decide to stick to tmake. 2) The other way creates a project within the source code -directories of wxWindows. For this endeavour, you'll need +directories of wxWidgets. For this endeavour, you'll need the usual number of GNU tools, at least GNU automake version 1.4 @@ -408,3 +379,7 @@ wxWINE library will need recompiling with different options. Any progress on this front will be very welcome. +Note that while wxWINE builds with --enable-unicode, samples +don't run. Some samples will run when built with +--disable-unicode, and others (such as auidemo) fail. +