X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/70aac632a1f6221f5f0e7e9f14100a93ca689dd7..1dc049cc3497a85c2b556f057871cbfa47a11453:/docs/motif/install.txt?ds=sidebyside diff --git a/docs/motif/install.txt b/docs/motif/install.txt index 8962f5c762..984729779a 100644 --- a/docs/motif/install.txt +++ b/docs/motif/install.txt @@ -11,7 +11,7 @@ IMPORTANT NOTE: When sending bug reports tell us what version of wxWindows you are using (including the beta) and what compiler on what system. One - example: wxMotif 2.5.0, gcc 2.95.4, Redhat 6.1 + example: wxMotif 2.5.1, gcc 2.95.4, Redhat 6.1 First steps ----------- @@ -156,15 +156,9 @@ You can get the newest version of the Lesstif from the lesstif homepage at: wxWindows/Motif requires a thread library and X libraries known to work with 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 -many aspects. As of writing this, these Linux distributions have correct glibc -2 support: - - - RedHat 5.1 - - Debian 2.0 and 3.0 - - Stampede - - DLD 6.0 - - SuSE 6.0 - +many aspects. As of writing this, virtually all Linux distributions have +correct glibc 2 support. + You can disable thread support by running ./configure --disable-threads @@ -178,45 +172,45 @@ exit -------------------------- Please send comments and question about the OS/2 installation -to Andrea Venturoli and patches to +to Stefan Neis and patches to the wxWindows mailing list. -You'll need OS/2 Warp (4.00FP#6), X-Free86/2 (3.3.3 or newer), -Lesstif (0.89.1 or newer), emx (0.9d fix 1), flex (2.5.4), -yacc (1.8), unix like shell, e.g. korn shell (5.2.13), -Autoconf (2.13), GNU file utilities (3.6), -GNU text utilities (1.3), GNU shell utilites (1.12), m4 (1.4), -sed (2.05), grep (2.0), Awk (3.0.3), GNU Make (3.76.1). +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. -Open an OS/2 prompt and switch to the directory above. -First set some global environment variables we need: +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). -SET CXXFLAGS=-Zmtd -D__ST_MT_ERRNO__ -SET CFLAGS=-Zmtd -D__ST_MT_ERRNO__ -SET OSTYPE=OS2X -SET COMSPEC=sh +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. -Notice you can choose whatever you want, if you don't like OS2X. +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 + +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. -Now, run autoconf in the main directory and in the samples, demos -and utils subdirectory. This will generate the OS/2 specific -versions of the configure scripts. Now run - configure --with-motif -as described above. +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. 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. -If you have pthreads library installed, it will be autodetected -and the library will be compiled with thread-support. - -Note that configure assumes your flex will generate files named -"lexyy.c", not "lex.yy.c". If you have a version which does -generate "lex.yy.c", you need to manually change the generated -makefile. - * Building wxMotif on SGI ------------------------- @@ -286,15 +280,19 @@ 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 - socket code to work. + socket code to work. --disable-shared Do not create shared libraries. - --disable-optimise Do not optimise the code. Can + --enable-monolithic Build wxWindows as single library instead + of as several smaller libraries (which is + the default since wxWindows 2.5.0). + + --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. + and is required on some architectures + such as Sun with gcc 2.8.X which + would otherwise produce segvs. --enable-profile Add profiling info to the object files. Currently broken, I think. @@ -355,6 +353,10 @@ are --without-libjpeg Disables JPEG image format code. --without-odbc Disables ODBC code. + + --without-libtiff Disables TIFF image format code. + + --without-expat Disable XML classes based on Expat parser. --disable-threads Disables threads. Will also disable sockets. @@ -381,6 +383,10 @@ Apart from disabling certain features you can very often "strip" the program of its debugging information resulting in a significant reduction in size. +Please see the output of "./configure --help" for comprehensive list +of all configurable options. + + * Compiling ----------- @@ -442,6 +448,12 @@ clean: This is certain to become the standard way unless we decide to stick to tmake. +If your application uses only some of wxWindows libraries, you can +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. + 2) The other way creates a project within the source code directories of wxWindows. For this endeavour, you'll need GNU autoconf version 2.14 and add an entry to your Makefile.in