2005-07-25 12:35:16 -04:00
|
|
|
wxWidgets 2.6.2 for Motif installation
|
1998-11-04 17:17:19 -05:00
|
|
|
------------------------------------
|
|
|
|
|
1999-10-26 09:33:13 -04:00
|
|
|
IMPORTANT NOTE:
|
|
|
|
|
|
|
|
If you experience problems installing, please re-read these
|
|
|
|
instructions and other related files (todo.txt, bugs.txt and
|
|
|
|
osname.txt for your platform if it exists) carefully before
|
2003-04-02 15:46:36 -05:00
|
|
|
mailing wx-users or the author. Preferably, try to fix the
|
1999-10-26 09:33:13 -04:00
|
|
|
problem first and then send a patch to the author.
|
|
|
|
|
2004-05-04 04:27:20 -04:00
|
|
|
When sending bug reports tell us what version of wxWidgets you are
|
1999-10-26 09:33:13 -04:00
|
|
|
using (including the beta) and what compiler on what system. One
|
2005-07-25 12:35:16 -04:00
|
|
|
example: wxMotif 2.6.2, gcc 2.95.4, Redhat 6.1
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
First steps
|
|
|
|
-----------
|
1999-02-09 11:00:23 -05:00
|
|
|
|
2002-12-05 07:14:53 -05:00
|
|
|
- Prerequisites: Motif 1.2 or above, or Lesstif. Motif 2.0 and
|
|
|
|
above may also be suitable.
|
1998-11-04 17:17:19 -05:00
|
|
|
|
2002-12-05 07:14:53 -05:00
|
|
|
- Download wxX11-x.y.z.tgz, where x.y.z is the version number.
|
|
|
|
(wxMotif is included in the wxX11 distribution).
|
2000-07-15 15:51:35 -04:00
|
|
|
Download documentation in a preferred format, such as
|
2004-05-04 04:27:20 -04:00
|
|
|
wxWidgets-HTML.zip or wxWidgets-PDF.zip.
|
1998-11-04 17:17:19 -05:00
|
|
|
|
1999-10-26 09:33:13 -04:00
|
|
|
- Make a directory such as ~/wx and unarchive the files into this
|
2000-07-15 15:51:35 -04:00
|
|
|
directory.
|
1999-02-05 19:46:25 -05:00
|
|
|
|
1999-02-04 06:14:41 -05:00
|
|
|
- It is recommended that you install bison and flex; using yacc
|
|
|
|
and lex may require tweaking of the makefiles. You also need
|
1999-03-30 04:47:59 -05:00
|
|
|
libXpm (see comments in the Notes section below) if you want to have
|
2004-05-04 04:27:20 -04:00
|
|
|
XPM support in wxWidgets (recommended).
|
1999-02-04 06:14:41 -05:00
|
|
|
|
2004-05-04 04:27:20 -04:00
|
|
|
- You can now use configure to build wxWidgets and the samples.
|
1999-03-30 04:47:59 -05:00
|
|
|
|
2003-04-02 15:46:36 -05:00
|
|
|
Using configure is the only way to build the library. If it doesn't
|
1999-03-30 04:47:59 -05:00
|
|
|
work for you for whatever reason, please report it (together with detailed
|
|
|
|
information about your platform and the (relevant part of) contents of
|
2002-02-08 07:15:09 -05:00
|
|
|
config.log file) to wx-dev@lists.wxwindows.org.
|
|
|
|
|
1999-02-04 06:14:41 -05:00
|
|
|
|
1998-12-12 05:01:41 -05:00
|
|
|
COMPILING USING CONFIGURE
|
1999-02-04 06:14:41 -05:00
|
|
|
=========================
|
1998-12-12 05:01:41 -05:00
|
|
|
|
2002-09-14 04:31:23 -04:00
|
|
|
* The simplest case
|
|
|
|
-------------------
|
1999-10-26 09:33:13 -04:00
|
|
|
|
2004-05-04 04:27:20 -04:00
|
|
|
If you compile wxWidgets on Linux for the first time and don't like to read
|
1999-10-26 09:33:13 -04:00
|
|
|
install instructions just do (in the base dir):
|
|
|
|
|
|
|
|
> ./configure --with-motif
|
|
|
|
> make
|
|
|
|
> su <type root password>
|
|
|
|
> make install
|
|
|
|
> ldconfig
|
|
|
|
> exit
|
|
|
|
|
|
|
|
Afterwards you can continue with
|
|
|
|
|
|
|
|
> make
|
|
|
|
> su <type root password>
|
|
|
|
> make install
|
|
|
|
> ldconfig
|
|
|
|
> exit
|
|
|
|
|
2004-05-04 04:27:20 -04:00
|
|
|
If you want to remove wxWidgets on Unix you can do this:
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
> su <type root password>
|
|
|
|
> make uninstall
|
|
|
|
> ldconfig
|
|
|
|
> exit
|
|
|
|
|
|
|
|
* The expert case
|
|
|
|
-----------------
|
|
|
|
|
2004-05-04 04:27:20 -04:00
|
|
|
If you want to do some more serious cross-platform programming with wxWidgets,
|
1999-10-26 09:33:13 -04:00
|
|
|
such as for GTK and Motif, you can now build two complete libraries and use
|
2002-06-07 16:15:28 -04:00
|
|
|
them concurrently. For this end, you have to create a directory for each build
|
2004-05-04 04:27:20 -04:00
|
|
|
of wxWidgets - you may also want to create different versions of wxWidgets
|
1999-10-26 09:33:13 -04:00
|
|
|
and test them concurrently. Most typically, this would be a version configured
|
2003-04-02 15:46:36 -05:00
|
|
|
with --enable-debug and one without. Note, that only one build can
|
2002-09-14 04:31:23 -04:00
|
|
|
currently be installed, so you'd have to use local version of the library for
|
|
|
|
that purpose. For building three versions (one GTK, one Motif and a debug
|
|
|
|
version of the GTK source) you'd do this:
|
1999-10-26 09:33:13 -04:00
|
|
|
|
2003-04-02 15:46:36 -05:00
|
|
|
mkdir buildmotif
|
1999-10-26 09:33:13 -04:00
|
|
|
cd buildmotif
|
|
|
|
../configure --with-motif
|
|
|
|
make
|
|
|
|
cd ..
|
|
|
|
|
2003-04-02 15:46:36 -05:00
|
|
|
mkdir buildgtk
|
1999-10-26 09:33:13 -04:00
|
|
|
cd buildgtk
|
|
|
|
../configure --with-gtk
|
|
|
|
make
|
|
|
|
cd ..
|
|
|
|
|
2003-04-02 15:46:36 -05:00
|
|
|
mkdir buildgtkd
|
1999-10-26 09:33:13 -04:00
|
|
|
cd buildgtkd
|
2003-04-02 15:46:36 -05:00
|
|
|
../configure --with-gtk --enable-debug
|
1999-10-26 09:33:13 -04:00
|
|
|
make
|
|
|
|
cd ..
|
|
|
|
|
2002-09-14 04:31:23 -04:00
|
|
|
* The simplest errors
|
|
|
|
---------------------
|
1999-10-26 09:33:13 -04:00
|
|
|
|
2002-09-14 04:31:23 -04:00
|
|
|
You get errors during compilation: The reason is that you probably have a
|
|
|
|
broken compiler. GCC 2.8 and earlier versions and egcs are likely to cause
|
|
|
|
problems due to incomplete support for C++ and optimisation bugs. Best to use
|
|
|
|
GCC 2.95 or later.
|
1999-10-26 09:33:13 -04:00
|
|
|
|
2002-09-14 04:31:23 -04:00
|
|
|
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 compiler with optimisation
|
|
|
|
bugs.
|
1999-10-26 09:33:13 -04:00
|
|
|
|
2002-09-14 04:31:23 -04:00
|
|
|
* The simplest program
|
|
|
|
----------------------
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
Now create your super-application myfoo.app and compile anywhere with
|
|
|
|
|
2002-09-14 04:31:23 -04:00
|
|
|
g++ myfoo.cpp `wx-config --libs --cxxflags` -o myfoo
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
* General
|
2002-09-14 04:31:23 -04:00
|
|
|
---------
|
1999-10-26 09:33:13 -04:00
|
|
|
|
2004-05-04 04:27:20 -04:00
|
|
|
The Unix variants of wxWidgets use GNU configure. If you have problems with
|
2002-09-14 04:31:23 -04:00
|
|
|
your make use GNU make instead.
|
1999-10-26 09:33:13 -04:00
|
|
|
|
2004-05-04 04:27:20 -04:00
|
|
|
If you have general problems with installation, see the wxWidgets website at
|
1999-10-26 09:33:13 -04:00
|
|
|
|
2004-05-04 04:27:20 -04:00
|
|
|
http://www.wxwidgets.org/
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
for newest information. If you still don't have any success, please send a bug
|
2003-04-02 15:46:36 -05:00
|
|
|
report to one of our mailing lists (see my homepage) INCLUDING A DESCRIPTION OF
|
2002-09-14 04:31:23 -04:00
|
|
|
YOUR SYSTEM AND YOUR PROBLEM, SUCH AS YOUR VERSION OF MOTIF, WXMOTIF, WHAT
|
|
|
|
DISTRIBUTION YOU USE AND WHAT ERROR WAS REPORTED. I know this has no effect,
|
|
|
|
but I tried...
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
* GUI libraries
|
2002-09-14 04:31:23 -04:00
|
|
|
---------------
|
1999-10-26 09:33:13 -04:00
|
|
|
|
2004-05-04 04:27:20 -04:00
|
|
|
wxWidgets/Motif requires the Motif library to be installed on your system. As
|
1999-10-26 09:33:13 -04:00
|
|
|
an alternative, you may also use the free library "lesstif" which implements
|
|
|
|
most of the Motif API without the licence restrictions of Motif.
|
|
|
|
|
|
|
|
You can get the newest version of the Lesstif from the lesstif homepage at:
|
|
|
|
|
2003-04-02 15:46:36 -05:00
|
|
|
http://www.lesstif.org/
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
* Additional libraries
|
2002-09-14 04:31:23 -04:00
|
|
|
----------------------
|
1999-10-26 09:33:13 -04:00
|
|
|
|
2004-05-04 04:27:20 -04:00
|
|
|
wxWidgets/Motif requires a thread library and X libraries known to work with
|
2002-09-14 04:31:23 -04:00
|
|
|
threads. This is the case on all commercial Unix-Variants and all
|
|
|
|
Linux-Versions that are based on glibc 2 except RedHat 5.0 which is broken in
|
2003-08-05 16:33:16 -04:00
|
|
|
many aspects. As of writing this, virtually all Linux distributions have
|
|
|
|
correct glibc 2 support.
|
|
|
|
|
1999-10-26 09:33:13 -04:00
|
|
|
You can disable thread support by running
|
|
|
|
|
2002-09-14 04:31:23 -04:00
|
|
|
./configure --disable-threads
|
1999-10-26 09:33:13 -04:00
|
|
|
make
|
|
|
|
su <type root password>
|
|
|
|
make install
|
|
|
|
ldconfig
|
|
|
|
exit
|
|
|
|
|
2002-09-14 04:31:23 -04:00
|
|
|
* Building wxMotif on OS/2
|
2000-02-12 05:44:03 -05:00
|
|
|
--------------------------
|
|
|
|
|
|
|
|
Please send comments and question about the OS/2 installation
|
2003-09-20 17:26:18 -04:00
|
|
|
to Stefan Neis <Stefan.Neis@t-online.de> and patches to
|
2004-05-04 04:27:20 -04:00
|
|
|
the wxWidgets mailing list.
|
2000-02-12 05:44:03 -05:00
|
|
|
|
2003-09-20 17:26:18 -04:00
|
|
|
In the following list, the version numbers indicate the configuration that
|
|
|
|
was actually used by myself, newer version should cause no problems and
|
|
|
|
even older ones are expected to work most of the time.
|
2000-02-12 05:44:03 -05:00
|
|
|
|
2003-09-20 17:26:18 -04:00
|
|
|
You'll need OS/2 Warp (4.51) or eCS(1.0), X-Free86/2 (3.3.6 or newer),
|
|
|
|
Lesstif (0.92.7 or newer), emx (0.9d fix 4), flex (2.5.4), yacc (1.8) or
|
|
|
|
bison (1.25), a Unix like shell (pdksh-5.2.14 or ash), Autoconf (2.57),
|
|
|
|
GNU file utilities (3.13), GNU text utilities (1.19),
|
|
|
|
GNU shell utilites (1.12), m4 (1.4), sed (2.05), grep (2.0), Awk (3.0.3),
|
|
|
|
GNU Make (3.75).
|
|
|
|
|
|
|
|
Preferably, you should have Posix/2 installed and C(PLUS)_INCLUDE_PATH and
|
|
|
|
LIBRARY_PATH set up accordingly, however, wxGTK will even work without it.
|
|
|
|
Presence of Posix/2 will be auto-detected.
|
2000-02-12 05:44:03 -05:00
|
|
|
|
2003-09-20 17:26:18 -04:00
|
|
|
Open an OS/2 prompt and switch to the directory above.
|
|
|
|
Set MAKESHELL (and depending on your installation also INSTALL, for me
|
|
|
|
it tends to try to use the system's tcpip\pcomos\install.exe which causes
|
|
|
|
problems...) to a Unix like shell, e.g.
|
|
|
|
SET MAKESHELL=ash
|
2000-02-12 05:44:03 -05:00
|
|
|
|
2003-09-20 17:26:18 -04:00
|
|
|
Be warned that depending on the precise version of your make, the
|
|
|
|
variable that needs to be set might be MAKE_SHELL instead of MAKESHELL.
|
|
|
|
If you have a really deficient version of GNU make, it might even be
|
|
|
|
necessary to set SHELL or even COMSPEC to a unix like shell as well.
|
2000-02-12 05:44:03 -05:00
|
|
|
|
2003-09-20 17:26:18 -04:00
|
|
|
Notice that the delivered configure scripts are fully OS/2 aware, so you
|
|
|
|
can simply run
|
|
|
|
ash -c "configure --with-motif"
|
|
|
|
and make and possibly make install as described above.
|
2000-02-12 05:44:03 -05:00
|
|
|
|
|
|
|
To verify Lesstif installation, configure will try to compile a
|
|
|
|
sample program that requires X headers/libraries to be either
|
|
|
|
available via C_INCLUDE_PATH and LIBRARY_PATH or you need to
|
|
|
|
explicitly set CFLAGS prior to running configure.
|
|
|
|
|
1999-10-26 09:33:13 -04:00
|
|
|
* Building wxMotif on SGI
|
2002-09-14 04:31:23 -04:00
|
|
|
-------------------------
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
Using the SGI native compilers, it is recommended that you
|
|
|
|
also set CFLAGS and CXXFLAGS before running configure. These
|
|
|
|
should be set to :
|
|
|
|
|
|
|
|
CFLAGS="-mips3 -n32"
|
|
|
|
CXXFLAGS="-mips3 -n32"
|
|
|
|
|
|
|
|
This is essential if you want to use the resultant binaries
|
|
|
|
on any other machine than the one it was compiled on. If you
|
|
|
|
have a 64bit machine (Octane) you should also do this to ensure
|
|
|
|
you don't accidently build the libraries as 64bit (which is
|
|
|
|
untested).
|
|
|
|
|
|
|
|
The SGI native compiler support has only been tested on Irix 6.5.
|
|
|
|
|
|
|
|
* Create your configuration
|
2002-09-14 04:31:23 -04:00
|
|
|
---------------------------
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
Usage:
|
2002-09-14 04:31:23 -04:00
|
|
|
./configure [options]
|
1999-10-26 11:16:29 -04:00
|
|
|
|
1999-10-26 09:33:13 -04:00
|
|
|
If you want to use system's C and C++ compiler,
|
2001-09-28 03:00:13 -04:00
|
|
|
set environment variables CXX and CC as
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
% setenv CC cc
|
2001-09-28 03:00:13 -04:00
|
|
|
% setenv CXX CC
|
1999-10-26 09:33:13 -04:00
|
|
|
% ./configure options
|
|
|
|
|
|
|
|
to see all the options please use:
|
|
|
|
|
|
|
|
./configure --help
|
|
|
|
|
|
|
|
The basic philosophy is that if you want to use different
|
|
|
|
configurations, like a debug and a release version,
|
|
|
|
or use the same source tree on different systems,
|
|
|
|
you have only to change the environment variable OSTYPE.
|
|
|
|
(Sadly this variable is not set by default on some systems
|
|
|
|
in some shells - on SGI's for example). So you will have to
|
|
|
|
set it there. This variable HAS to be set before starting
|
|
|
|
configure, so that it knows which system it tries to
|
|
|
|
configure for.
|
|
|
|
|
|
|
|
Configure will complain if the system variable OSTYPE has
|
|
|
|
not been defined. And Make in some circumstances as well...
|
|
|
|
|
|
|
|
|
|
|
|
* General options
|
|
|
|
-------------------
|
|
|
|
|
|
|
|
Given below are the commands to change the default behaviour,
|
|
|
|
i.e. if it says "--disable-threads" it means that threads
|
|
|
|
are enabled by default.
|
|
|
|
|
2002-06-07 16:15:28 -04:00
|
|
|
Many of the configure options have been thoroughly tested
|
2004-05-04 04:27:20 -04:00
|
|
|
in wxWidgets snapshot 6, but not yet all (ODBC not).
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
You have to add --with-motif on platforms, where Motif is
|
2002-06-07 16:15:28 -04:00
|
|
|
not the default (on Linux, configure will default to GTK).
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
--with-motif Use either Motif or Lesstif
|
|
|
|
Configure will look for both.
|
|
|
|
|
|
|
|
The following options handle the kind of library you want to build.
|
|
|
|
|
|
|
|
--disable-threads Compile without thread support. Threads
|
|
|
|
support is also required for the
|
2003-08-05 16:33:16 -04:00
|
|
|
socket code to work.
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
--disable-shared Do not create shared libraries.
|
|
|
|
|
2004-05-04 04:27:20 -04:00
|
|
|
--enable-monolithic Build wxWidgets as single library instead
|
2003-08-05 16:33:16 -04:00
|
|
|
of as several smaller libraries (which is
|
2004-05-04 04:27:20 -04:00
|
|
|
the default since wxWidgets 2.5.0).
|
2003-08-05 16:33:16 -04:00
|
|
|
|
|
|
|
--disable-optimise Do not optimise the code. Can
|
1999-10-26 09:33:13 -04:00
|
|
|
sometimes be useful for debugging
|
2003-08-05 16:33:16 -04:00
|
|
|
and is required on some architectures
|
|
|
|
such as Sun with gcc 2.8.X which
|
|
|
|
would otherwise produce segvs.
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
--enable-profile Add profiling info to the object
|
|
|
|
files. Currently broken, I think.
|
|
|
|
|
|
|
|
--enable-no_rtti Enable compilation without creation of
|
|
|
|
C++ RTTI information in object files.
|
|
|
|
This will speed-up compilation and reduce
|
|
|
|
binary size.
|
|
|
|
|
|
|
|
--enable-no_exceptions Enable compilation without creation of
|
|
|
|
C++ exception information in object files.
|
|
|
|
This will speed-up compilation and reduce
|
|
|
|
binary size. Also fewer crashes during the
|
|
|
|
actual compilation...
|
|
|
|
|
|
|
|
--enable-no_deps Enable compilation without creation of
|
|
|
|
dependency information.
|
|
|
|
|
2002-06-07 16:15:28 -04:00
|
|
|
--enable-permissive Enable compilation without checking for strict
|
|
|
|
ANSI conformance. Useful to prevent the build
|
|
|
|
dying with errors as soon as you compile with
|
|
|
|
Solaris' ANSI-defying headers.
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
--enable-mem_tracing Add built-in memory tracing.
|
|
|
|
|
|
|
|
--enable-dmalloc Use the dmalloc memory debugger.
|
|
|
|
Read more at www.letters.com/dmalloc/
|
|
|
|
|
2003-04-02 15:46:36 -05:00
|
|
|
--enable-debug Equivalent to --enable-debug_info plus
|
|
|
|
--enable-debug-flag.
|
|
|
|
|
1999-10-26 09:33:13 -04:00
|
|
|
--enable-debug_info Add debug info to object files and
|
|
|
|
executables for use with debuggers
|
|
|
|
such as gdb (or its many frontends).
|
|
|
|
|
|
|
|
--enable-debug_flag Define __DEBUG__ and __WXDEBUG__ when
|
2004-05-04 04:27:20 -04:00
|
|
|
compiling. This enable wxWidgets' very
|
1999-10-26 09:33:13 -04:00
|
|
|
useful internal debugging tricks (such
|
|
|
|
as automatically reporting illegal calls)
|
|
|
|
to work. Note that program and library
|
|
|
|
must be compiled with the same debug
|
|
|
|
options.
|
|
|
|
|
|
|
|
* Feature Options
|
2002-09-14 04:31:23 -04:00
|
|
|
-----------------
|
1999-10-26 09:33:13 -04:00
|
|
|
|
2002-06-07 16:15:28 -04:00
|
|
|
Many of the configure options have been thoroughly tested
|
2004-05-04 04:27:20 -04:00
|
|
|
in wxWidgets snapshot 6, but not yet all (ODBC not).
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
When producing an executable that is linked statically with wxGTK
|
|
|
|
you'll be surprised at its immense size. This can sometimes be
|
2004-05-04 04:27:20 -04:00
|
|
|
drastically reduced by removing features from wxWidgets that
|
1999-10-26 09:33:13 -04:00
|
|
|
are not used in your program. The most relevant such features
|
|
|
|
are
|
|
|
|
|
|
|
|
--without-libpng Disables PNG image format code.
|
|
|
|
|
|
|
|
--without-libjpeg Disables JPEG image format code.
|
|
|
|
|
2003-04-02 15:46:36 -05:00
|
|
|
--without-odbc Disables ODBC code.
|
2003-08-05 16:33:16 -04:00
|
|
|
|
|
|
|
--without-libtiff Disables TIFF image format code.
|
|
|
|
|
|
|
|
--without-expat Disable XML classes based on Expat parser.
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
--disable-threads Disables threads. Will also
|
|
|
|
disable sockets.
|
|
|
|
|
|
|
|
--disable-sockets Disables sockets.
|
|
|
|
|
|
|
|
--disable-dnd Disables Drag'n'Drop.
|
|
|
|
|
|
|
|
--disable-clipboard Disables Clipboard.
|
|
|
|
|
|
|
|
--disable-streams Disables the wxStream classes.
|
|
|
|
|
|
|
|
--disable-file Disables the wxFile class.
|
|
|
|
|
|
|
|
--disable-textfile Disables the wxTextFile class.
|
|
|
|
|
|
|
|
--disable-intl Disables the internationalisation.
|
|
|
|
|
|
|
|
--disable-validators Disables validators.
|
|
|
|
|
|
|
|
--disable-accel Disables accel.
|
|
|
|
|
|
|
|
Apart from disabling certain features you can very often "strip"
|
|
|
|
the program of its debugging information resulting in a significant
|
|
|
|
reduction in size.
|
|
|
|
|
2003-08-05 16:33:16 -04:00
|
|
|
Please see the output of "./configure --help" for comprehensive list
|
|
|
|
of all configurable options.
|
|
|
|
|
|
|
|
|
1999-10-26 09:33:13 -04:00
|
|
|
* Compiling
|
2002-09-14 04:31:23 -04:00
|
|
|
-----------
|
1999-10-26 09:33:13 -04:00
|
|
|
|
2002-09-14 04:31:23 -04:00
|
|
|
The following must be done in the base directory (e.g. ~/wxMotif
|
1999-10-26 09:33:13 -04:00
|
|
|
or ~/wxWin or whatever)
|
|
|
|
|
|
|
|
Now the makefiles are created (by configure) and you can compile
|
|
|
|
the library by typing:
|
|
|
|
|
|
|
|
make
|
|
|
|
|
|
|
|
make yourself some coffee, as it will take some time. On an old
|
2003-04-02 15:46:36 -05:00
|
|
|
Pentium 200 around 40 minutes. During compilation, you may get a few
|
1999-10-26 09:33:13 -04:00
|
|
|
warning messages depending in your compiler.
|
|
|
|
|
|
|
|
If you want to be more selective, you can change into a specific
|
2002-06-07 16:15:28 -04:00
|
|
|
directory and type "make" there.
|
1999-10-26 09:33:13 -04:00
|
|
|
|
2002-06-07 16:15:28 -04:00
|
|
|
Then you may install the library and its header files under
|
1999-10-26 09:33:13 -04:00
|
|
|
/usr/local/include/wx and /usr/local/lib respectively. You
|
|
|
|
have to log in as root (i.e. run "su" and enter the root
|
|
|
|
password) and type
|
|
|
|
|
|
|
|
make install
|
|
|
|
|
2004-05-04 04:27:20 -04:00
|
|
|
You can remove any traces of wxWidgets by typing
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
make uninstall
|
|
|
|
|
|
|
|
If you want to save disk space by removing unnecessary
|
|
|
|
object-files:
|
|
|
|
|
|
|
|
make clean
|
|
|
|
|
|
|
|
in the various directories will do the work for you.
|
|
|
|
|
|
|
|
* Creating a new Project
|
2002-09-14 04:31:23 -04:00
|
|
|
------------------------
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
1) The first way uses the installed libraries and header files
|
|
|
|
automatically using wx-config
|
|
|
|
|
2002-09-14 04:31:23 -04:00
|
|
|
g++ myfoo.cpp `wx-config --libs` `wx-config --cxxflags` -o myfoo
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
Using this way, a make file for the minimal sample would look
|
|
|
|
like this
|
|
|
|
|
2001-09-28 03:00:13 -04:00
|
|
|
CXX = g++
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
minimal: minimal.o
|
2001-09-28 03:00:13 -04:00
|
|
|
$(CXX) -o minimal minimal.o `wx-config --libs`
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
minimal.o: minimal.cpp mondrian.xpm
|
2002-09-14 04:31:23 -04:00
|
|
|
$(CXX) `wx-config --cxxflags` -c minimal.cpp -o minimal.o
|
1999-10-26 09:33:13 -04:00
|
|
|
|
|
|
|
clean:
|
|
|
|
rm -f *.o minimal
|
|
|
|
|
|
|
|
This is certain to become the standard way unless we decide
|
2002-06-07 16:15:28 -04:00
|
|
|
to stick to tmake.
|
1999-10-26 09:33:13 -04:00
|
|
|
|
2004-05-04 04:27:20 -04:00
|
|
|
If your application uses only some of wxWidgets libraries, you can
|
2003-08-05 16:33:16 -04:00
|
|
|
specify required libraries when running wx-config. For example,
|
|
|
|
`wx-config --libs=html,core` will only output link command to link
|
|
|
|
with libraries required by core GUI classes and wxHTML classes. See
|
|
|
|
the manual for more information on the libraries.
|
|
|
|
|
1999-10-26 09:33:13 -04:00
|
|
|
2) The other way creates a project within the source code
|
2004-05-04 04:27:20 -04:00
|
|
|
directories of wxWidgets. For this endeavour, you'll need
|
1999-10-26 09:33:13 -04:00
|
|
|
GNU autoconf version 2.14 and add an entry to your Makefile.in
|
|
|
|
to the bottom of the configure.in script and run autoconf
|
|
|
|
and configure before you can type make.
|
|
|
|
|
|
|
|
* Further notes by Julian Smart
|
|
|
|
---------------------------------
|
|
|
|
|
1999-10-26 11:16:29 -04:00
|
|
|
- You may find the following script useful for compiling wxMotif,
|
|
|
|
especially if installing from zips (which don't preserve file
|
|
|
|
permissions). Make this script executable with the command
|
1999-01-31 13:47:10 -05:00
|
|
|
chmod a+x makewxmotif.
|
|
|
|
|
|
|
|
-------:x-----Cut here-----:x-----
|
|
|
|
# makewxmotif
|
|
|
|
# Sets permissions (in case we extracted wxMotif from zip files)
|
|
|
|
# and makes wxMotif.
|
2004-05-04 04:27:20 -04:00
|
|
|
# Call from top-level wxWidgets directory.
|
1999-01-31 13:47:10 -05:00
|
|
|
# Note that this uses standard (but commonly-used) configure options;
|
1999-03-30 04:47:59 -05:00
|
|
|
# if you're feeling brave, you may wish to compile with threads:
|
|
|
|
# if they're not supported by the target platform, they will be disabled
|
|
|
|
# anyhow
|
1999-01-31 13:47:10 -05:00
|
|
|
# -- Julian Smart
|
1999-10-26 09:33:13 -04:00
|
|
|
chmod a+x configure config.sub config.guess
|
2003-04-02 15:46:36 -05:00
|
|
|
./configure --with-shared --with-motif --with-debug_flag --with-debug_info --enable-debug --without-threads --without-sockets --without-odbc
|
1998-12-12 05:01:41 -05:00
|
|
|
make
|
1999-01-31 13:47:10 -05:00
|
|
|
-------:x-----Cut here-----:x-----
|
|
|
|
|
1999-10-26 09:33:13 -04:00
|
|
|
This script will build wxMotif using shared libraries. If you want to build
|
2004-05-04 04:27:20 -04:00
|
|
|
a static wxWidgets library, use --disable-shared.
|
1999-03-06 06:51:06 -05:00
|
|
|
|
1999-02-10 17:44:53 -05:00
|
|
|
Troubleshooting
|
|
|
|
---------------
|
|
|
|
|
2002-09-14 04:31:23 -04:00
|
|
|
- Solaris compilation with gcc: if the compiler has problems with the variable
|
|
|
|
argument functions, try putting the gcc fixinclude file paths early in the
|
|
|
|
include path.
|
1999-02-10 17:44:53 -05:00
|
|
|
|
1999-02-18 16:24:11 -05:00
|
|
|
- If you operator-related compile errors or strange memory problems
|
|
|
|
(for example in deletion of string arrays), set wxUSE_GLOBAL_MEMORY_OPERATORS
|
|
|
|
and wxUSE_MEMORY_TRACING to 0 in setup.h, and recompile.
|
1999-02-12 03:22:29 -05:00
|
|
|
|
1999-03-30 04:47:59 -05:00
|
|
|
- If you get an internal compiler error in gcc, turn off optimisations.
|
1999-02-17 12:18:22 -05:00
|
|
|
|
1999-02-12 03:22:29 -05:00
|
|
|
- Problems with XtDestroyWidget crashing in ~wxWindow have been
|
|
|
|
reported on SGI IRIX 6.4. This has not yet been resolved, so
|
|
|
|
any advice here would be very welcome. See bugs.txt for a
|
1999-02-18 16:24:11 -05:00
|
|
|
possible temporary workaround (comment out the final
|
|
|
|
XtDestroyWidget from ~wxWindow in window.cpp).
|
1999-02-12 03:22:29 -05:00
|
|
|
|
1999-02-24 03:02:28 -05:00
|
|
|
- Some compilers, such as Sun C++, may give a lot of warnings about
|
|
|
|
virtual functions being hidden. Please ignore these, it's correct C++ syntax.
|
|
|
|
If you find any incorrect instances, though, such as a
|
|
|
|
missing 'const' in an overridden function, please let us know.
|
|
|
|
|
1999-02-10 17:44:53 -05:00
|
|
|
Other Notes
|
|
|
|
-----------
|
1998-11-04 17:17:19 -05:00
|
|
|
|
2003-04-02 15:46:36 -05:00
|
|
|
- Using configure will create a release build of the library by
|
|
|
|
default: it's recommended to use --enable-debug configure switch
|
|
|
|
while developing your application. To compile in non-debug mode, use
|
|
|
|
--disable-debug configure switch.
|
1998-11-09 06:57:05 -05:00
|
|
|
|
1999-02-10 17:44:53 -05:00
|
|
|
Bug reports
|
|
|
|
-----------
|
|
|
|
|
|
|
|
Please send bug reports with a description of your environment,
|
1999-03-30 04:47:59 -05:00
|
|
|
compiler and the error message(s) to the wxwin-developers mailing list at:
|
1998-11-04 17:17:19 -05:00
|
|
|
|
2002-02-08 07:15:09 -05:00
|
|
|
wx-dev@lists.wxwindows.org
|
1998-11-04 17:17:19 -05:00
|
|
|
|
1999-10-26 11:16:29 -04:00
|
|
|
Julian Smart, Robert Roebling and Vadim Zeitlin, November 1999.
|
|
|
|
|