+
+ !!! When sending bug reports tell us what version of
+ wxWindows you are using (including the beta) and
+ what compiler on what system. One example:
+ wxGTK 2.1 beta 6, egcs 1.1.1, Redhat 5.0 !!!
+
* The most simple case
-----------------------
ldconfig
exit
+If you want to remove wxWindows on Unix you can do this:
+
+su <type root password>
+make uninstall
+ldconfig
+exit
+
+* The expert case
+-----------------
+
+If you want to do some more serious cross-platform programming
+with wxWindows, such as for GTK and Motif, you can now build
+two complete libraries and use them concurretly. For this end,
+you have to create a directory for each build of wxWindows -
+you may also want to create different versions of wxWindows
+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 currenty be installed, so you'd
+have to use local version of the library for that purpose.
+For building three version, one GTK, one Motif and a debug
+version of the GTK source, you'd do this:
+
+md buildmotif
+cd buildmotif
+../configure --with-motif
+make
+cd ..
+
+md buildgtk
+cd buildgtk
+../configure --with-gtk
+make
+cd ..
+
+md buildgtkd
+cd buildgtkd
+../configure --with-gtk --enable-debug
+make
+cd ..
* The most simple errors
------------------------
although you are certainly sure you have. Well, you have
installed it, but you also have another version of the
GTK installed, which you may need to removed including
-other versions of glib (and its headers).
-
-You get errors during compilation. The reason is that you
+other versions of glib (and its headers). Also, look
+for the PATH variable and check if it includes the path
+to the correct gtk-config! The check your LDPATH if
+it points to the correct library. There is no way to
+compile wxGTK if configure doesn't pass this test as
+all this test does is compile and link a GTK program.
+
+You get errors during compilation: The reason is that you
probably have a broken compiler, which includes almost
-everything that is called gcc. If there is just any way
-for you to use egcs, use egcs. We are sorry, but we cannot
-fix gcc.
+everything that is called gcc. If you use gcc 2.8 you
+have to disable optimsation as the compiler will give
+up with an internal compiler error.
+
+If there is just any way for you to use egcs, use egcs.
+We are sorry, but we cannot fix gcc.
+
+You get immediate segfault when starting any sample
+or application: This is either due to having compiled
+the library with different flags or options than your
+program - typically you might have the __WXDEBUG__ option
+set for the library but not for your program - or due
+to using a broken compiler (and its optimisation) such
+as GCC 2.8.
* The most simple program
-------------------------
Now create your super-application myfoo.app and compile anywhere
with
-g++ myfoo.cpp `wx-config --libs` `wx-config --cflags` -o myfoo
+g++ myfoo.cpp `wx-config --libs --cflags` -o myfoo
* General
-----------------------
-----------------------
wxWindows/GTK requires the GTK+ library to be installed on your system.
-It has to be a stable version, preferebly version 1.2.1. You can use
-GTK 1.0.X in connection with wxWindows, but we don't support Drag'n'Drop
-for GTK 1.0.X so you have to "configure --without-dnd". wxWindows does
-NOT work with the 1.1.X versions of the GTK+ library.
+It has to be a stable version, preferebly version 1.2.3. You can use
+GTK 1.0 in connection with wxWindows, but only without Drag'n'Drop.
+wxWindows does work with the 1.1.X versions of the GTK+ library.
You can get the newest version of the GTK+ from the GTK homepage
at
- DLD 6.0
- SuSE 6.0
-You can enable thread support by running
+You can disable thread support by running
-./configure "--with-threads"
-make clean
+./configure "--disable-threads"
make
su <type root password>
make install
* General options
-------------------
+The confiugre options have not yet been thoroughly tested
+in wxWindows snapshot 6.
+
Normally, you won't have to choose a toolkit, because when
you download wxGTK, it will default to --with-gtk etc. But
if you use all of our CVS repository you have to choose a
The following options handle the kind of library you want to build.
- --with-threads Compile with thread support. Threads
+ --disable-threads Compile without thread support. Threads
support is also required for the
socket code to work.
- --without-shared Do not create shared libraries.
+ --disable-shared Do not create shared libraries.
- --without-optimise Do not optimise the code. Can
+ --disable-optimise Do not optimise the code. Can
sometimes be useful for debugging
and is required on some architectures
such as Sun with gcc 2.8.X which
would otherwise produce segvs.
- --with-profile Add profiling info to the object
+ --enable-profile Add profiling info to the object
files. Currently broken, I think.
- --with-mem_tracing Add built-in memory tracing.
+ --enable-mem_tracing Add built-in memory tracing.
- --with-dmalloc Use the dmalloc memory debugger.
+ --enable-dmalloc Use the dmalloc memory debugger.
Read more at www.letters.com/dmalloc/
- --with-debug_info Add debug info to object files and
+ --enable-debug_info Add debug info to object files and
executables for use with debuggers
such as gdb (or its many frontends).
- --with-debug_flag Define __DEBUG__ and __WXDEBUG__ when
+ --enable-debug_flag Define __DEBUG__ and __WXDEBUG__ when
compiling. This enable wxWindows' very
useful internal debugging tricks (such
as automatically reporting illegal calls)
* Feature Options
-------------------
+The confiugre options have not yet been thoroughly tested
+in wxWindows snapshot 6.
+
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
--without-odbc Disables ODBC code.
- --without-wxresources Disables the use of *.wxr type
+ --disable-wxresources Disables the use of *.wxr type
resources.
- --without-threads Disables threads.
+ --disable-threads Disables threads. Will also
+ disable sockets.
- --without-sockets Disables sockets.
+ --disable-sockets Disables sockets.
- --without-dnd Disables Drag'n'Drop.
+ --disable-dnd Disables Drag'n'Drop.
- --without-clipboard Disables Clipboard.
+ --disable-clipboard Disables Clipboard.
- --without-serial Disables object instance serialiasation.
+ --disable-serial Disables object instance serialiasation.
- --without-streams Disables the wxStream classes.
+ --disable-streams Disables the wxStream classes.
Apart from disabling certain features you can very often "strip"
the program of its debugging information resulting in a significant
make
make yourself some coffee, as it will take some time. On an old
-386SX possibly week. During compilation, you'll get a few
+386SX possibly two weeks. During compilation, you'll get a few
warning messages depending in your compiler.
-if you want to be more selective:
-
- make will build only the base libraries
- make samples will build the samples
- make user will build everything in user
+if you want to be more selective, you can change into a specific
+directiry and type "make" there.
Then you may install the library and it's header files under
/usr/local/include/wx and /usr/local/lib respectively. You
password) and type
make install
-
-Depending on the configuration of some files, the libraries
-and binaries will be placed in different directories.
-The "global" binaries and libraries will be placed in:
-
- bin/$(OSTYPE) and
- lib/$(OSTYPE) respectively
-"local" binaries and libraries will be placed in:
-
- (basedir of that application)/$(OSTYPE).
-
-This is also the place where all the object-files will go.
-(Currently there arent any global binaries).
+You can remove any traces of wxWindows by typing
+ make uninstall
+
If you want to save disk space by removing unnecessary
object-files:
to sitch to tmake.
2) The other way creates a project within the source code
-directories of wxWindows: In this case I propose to put
-all contributed programs in the directory "/user", with a
-directory of its own.
+directories of wxWindows. For this endeavour, you'll need
+the usual number of GNU tools, at least
-This directory then should include the following files:
+GNU automake version 1.4
+GNU autoheader version 2.14
+GNU autoconf version 2.14
-Makefile (You can copy this one from any application in samples
- probably you will not need to edit this one. There is
- only one case where you might be interested in changing
- this file, but about that see later.)
-Makefile.in (This is the base application-Makefile template, from
- which the actual Makefile for each system is created.
- More about this later)
+and quite possibly
-put ALL your source code along with all the other stuff you need for
-your application in this directory (subdirectories are welcome).
+GNU make
+GNU cc
+and if you have all this then you probably know enough to
+go ahead yourself :-)
** Something about Makefiles
------------------------------
projects / wxWidgets.git / blobdiff