docs/motif2/install.txt

   1
   2   !!! When sending bug reports tell us what version of wxWindows you are
   3       using (including the beta) and what compiler on what system. One
   4       example: wxMotif 2.1 beta 6, egcs 1.1.1, Redhat 5.0 !!!
   5
   6 * The most simple case
   7 -----------------------
   8
   9 If you compile wxWindows on Linux for the first time and don't like to read
  10 install instructions just do (in the base dir):
  11
  12 > ./configure --with-motif
  13 > make
  14 > su <type root password>
  15 > make install
  16 > ldconfig
  17 > exit
  18
  19 Afterwards you can continue with
  20
  21 > make
  22 > su <type root password>
  23 > make install
  24 > ldconfig
  25 > exit
  26
  27 If you want to remove wxWindows on Unix you can do this:
  28
  29 > su <type root password>
  30 > make uninstall
  31 > ldconfig
  32 > exit
  33
  34 * The expert case
  35 -----------------
  36
  37 If you want to do some more serious cross-platform programming with wxWindows,
  38 such as for GTK and Motif, you can now build two complete libraries and use
  39 them concurretly. For this end, you have to create a directory for each build
  40 of wxWindows - you may also want to create different versions of wxWindows
  41 and test them concurrently. Most typically, this would be a version configured
  42 with --enable-debug_flag and one without. Note, that only one build can currently
  43 be installed, so you'd have to use local version of the library for that purpose.
  44 For building three versions (one GTK, one Motif and a debug version of the GTK
  45 source) you'd do this:
  46
  47 md buildmotif
  48 cd buildmotif
  49 ../configure --with-motif
  50 make
  51 cd ..
  52
  53 md buildgtk
  54 cd buildgtk
  55 ../configure --with-gtk
  56 make
  57 cd ..
  58
  59 md buildgtkd
  60 cd buildgtkd
  61 ../configure --with-gtk --enable-debug_flag
  62 make
  63 cd ..
  64
  65 * The most simple errors
  66 ------------------------
  67
  68 You get errors during compilation: The reason is that you probably have a broken
  69 compiler, which includes almost everything that is called gcc. If you use gcc 2.8
  70 you have to disable optimsation as the compiler will give up with an internal
  71 compiler error.
  72
  73 If there is just any way for you to use egcs, use egcs. We cannot fix gcc.
  74
  75 You get immediate segfault when starting any sample or application: This is either
  76 due to having compiled the library with different flags or options than your program -
  77 typically you might have the __WXDEBUG__ option set for the library but not for your
  78 program - or due to using a broken compiler (and its optimisation) such as GCC 2.8.
  79
  80 * The most simple program
  81 -------------------------
  82
  83 Now create your super-application myfoo.app and compile anywhere with
  84
  85 g++ myfoo.cpp `wx-config --libs --cflags` -o myfoo
  86
  87 * General
  88 -----------------------
  89
  90 The Unix variants of wxWindows use GNU configure. If you have problems with your
  91 make use GNU make instead.
  92
  93 If you have general problems with installation, read my homepage at
  94
  95   http://wesley.informatik.uni-freiburg.de/~wxxt
  96
  97 for newest information. If you still don't have any success, please send a bug
  98 report to one of our mailing lists (see my homepage) INCLUDING A DESCRIPTION OF
  99 YOUR SYSTEM AND YOUR PROBLEM, SUCH AS YOUR VERSION OF GTK, WXGTK, WHAT DISTRIBUTION
 100 YOU USE AND WHAT ERROR WAS REPORTED. I know this has no effect, but I tried...
 101
 102 * GUI libraries
 103 -----------------------
 104
 105 wxWindows/Motif requires the Motif library to be installed on your system. As
 106 an alternative, you may also use the free library "lesstif" which implements
 107 most of the Motif API without the licence restrictions of Motif.
 108
 109 You can get the newest version of the Lesstif from the lesstif homepage at:
 110
 111   http://www.lesstif.org
 112
 113 * Additional libraries
 114 -----------------------
 115
 116 wxWindows/Motif requires a thread library and X libraries known to work with threads.
 117 This is the case on all commercial Unix-Variants and all Linux-Versions that are
 118 based on glibc 2 except RedHat 5.0 which is broken in many aspects. As of writing
 119 this, these Linux distributions have correct glibc 2 support:
 120
 121  - RedHat 5.1
 122  - Debian 2.0
 123  - Stampede
 124  - DLD 6.0
 125  - SuSE 6.0
 126
 127 You can disable thread support by running
 128
 129 ./configure "--disable-threads"
 130 make
 131 su <type root password>
 132 make install
 133 ldconfig
 134 exit
 135
 136 NB: DO NOT COMPILE WXGTK WITH GCC AND THREADS, SINCE ALL PROGRAMS WILL CRASH UPON
 137 START-UP! Just always use egcs and be happy.
 138
 139 * Building wxMotif on SGI
 140 --------------------------
 141
 142 Using the SGI native compilers, it is recommended that you
 143 also set CFLAGS and CXXFLAGS before running configure. These
 144 should be set to :
 145
 146 CFLAGS="-mips3 -n32"
 147 CXXFLAGS="-mips3 -n32"
 148
 149 This is essential if you want to use the resultant binaries
 150 on any other machine than the one it was compiled on. If you
 151 have a 64bit machine (Octane) you should also do this to ensure
 152 you don't accidently build the libraries as 64bit (which is
 153 untested).
 154
 155 The SGI native compiler support has only been tested on Irix 6.5.
 156
 157 * Create your configuration
 158 -----------------------------
 159
 160 Usage:
 161         ./configure options
 162
 163 If you want to use system's C and C++ compiler,
 164 set environment variables CC and CCC as
 165
 166         % setenv CC cc
 167         % setenv CCC CC
 168         % ./configure options
 169
 170 to see all the options please use:
 171
 172         ./configure --help
 173
 174 The basic philosophy is that if you want to use different
 175 configurations, like a debug and a release version,
 176 or use the same source tree on different systems,
 177 you have only to change the environment variable OSTYPE.
 178 (Sadly this variable is not set by default on some systems
 179 in some shells - on SGI's for example). So you will have to
 180 set it there. This variable HAS to be set before starting
 181 configure, so that it knows which system it tries to
 182 configure for.
 183
 184 Configure will complain if the system variable OSTYPE has
 185 not been defined. And Make in some circumstances as well...
 186
 187
 188 * General options
 189 -------------------
 190
 191 Given below are the commands to change the default behaviour,
 192 i.e. if it says "--disable-threads" it means that threads
 193 are enabled by default.
 194
 195 Many of the confiugre options have been thoroughly tested
 196 in wxWindows snapshot 6, but not yet all (ODBC not).
 197
 198 You have to add --with-motif on platforms, where Motif is
 199 not the default (on Linux, configure will deafult to GTK).
 200
 201         --without-gtk            Don't use the GIMP ToolKit (GTK)
 202
 203         --with-motif             Use either Motif or Lesstif
 204                                  Configure will look for both.
 205
 206 The following options handle the kind of library you want to build.
 207
 208         --disable-threads       Compile without thread support. Threads
 209                                 support is also required for the
 210                                 socket code to work.
 211
 212         --disable-shared        Do not create shared libraries.
 213
 214         --disable-optimise      Do not optimise the code. Can
 215                                 sometimes be useful for debugging
 216                                 and is required on some architectures
 217                                 such as Sun with gcc 2.8.X which
 218                                 would otherwise produce segvs.
 219
 220         --enable-profile        Add profiling info to the object
 221                                 files. Currently broken, I think.
 222
 223         --enable-no_rtti        Enable compilation without creation of
 224                                 C++ RTTI information in object files.
 225                                 This will speed-up compilation and reduce
 226                                 binary size.
 227
 228         --enable-no_exceptions  Enable compilation without creation of
 229                                 C++ exception information in object files.
 230                                 This will speed-up compilation and reduce
 231                                 binary size. Also fewer crashes during the
 232                                 actual compilation...
 233
 234         --enable-mem_tracing    Add built-in memory tracing.
 235
 236         --enable-dmalloc        Use the dmalloc memory debugger.
 237                                 Read more at www.letters.com/dmalloc/
 238
 239         --enable-debug_info     Add debug info to object files and
 240                                 executables for use with debuggers
 241                                 such as gdb (or its many frontends).
 242
 243         --enable-debug_flag     Define __DEBUG__ and __WXDEBUG__ when
 244                                 compiling. This enable wxWindows' very
 245                                 useful internal debugging tricks (such
 246                                 as automatically reporting illegal calls)
 247                                 to work. Note that program and library
 248                                 must be compiled with the same debug
 249                                 options.
 250
 251 * Feature Options
 252 -------------------
 253
 254 Many of the confiugre options have been thoroughly tested
 255 in wxWindows snapshot 6, but not yet all (ODBC not).
 256
 257 When producing an executable that is linked statically with wxGTK
 258 you'll be surprised at its immense size. This can sometimes be
 259 drastically reduced by removing features from wxWindows that
 260 are not used in your program. The most relevant such features
 261 are
 262
 263         --without-libpng        Disables PNG image format code.
 264
 265         --without-libjpeg       Disables JPEG image format code.
 266
 267 {       --without-odbc          Disables ODBC code. Not yet. }
 268
 269         --disable-resources     Disables the use of *.wxr type
 270                                 resources.
 271
 272         --disable-threads       Disables threads. Will also
 273                                 disable sockets.
 274
 275         --disable-sockets       Disables sockets.
 276
 277         --disable-dnd           Disables Drag'n'Drop.
 278
 279         --disable-clipboard     Disables Clipboard.
 280
 281         --disable-serial        Disables object instance serialiasation.
 282
 283         --disable-streams       Disables the wxStream classes.
 284
 285         --disable-file          Disables the wxFile class.
 286
 287         --disable-textfile      Disables the wxTextFile class.
 288
 289         --disable-intl          Disables the internationalisation.
 290
 291         --disable-validators    Disables validators.
 292
 293         --disable-accel         Disables accel.
 294
 295 Apart from disabling certain features you can very often "strip"
 296 the program of its debugging information resulting in a significant
 297 reduction in size.
 298
 299 * Compiling
 300 -------------
 301
 302 The following must be done in the base directory (e.g. ~/wxGTK
 303 or ~/wxWin or whatever)
 304
 305 Now the makefiles are created (by configure) and you can compile
 306 the library by typing:
 307
 308         make
 309
 310 make yourself some coffee, as it will take some time. On an old
 311 386SX possibly two weeks. During compilation, you'll get a few
 312 warning messages depending in your compiler.
 313
 314 If you want to be more selective, you can change into a specific
 315 directiry and type "make" there.
 316
 317 Then you may install the library and it's header files under
 318 /usr/local/include/wx and /usr/local/lib respectively. You
 319 have to log in as root (i.e. run "su" and enter the root
 320 password) and type
 321
 322         make install
 323
 324 You can remove any traces of wxWindows by typing
 325
 326         make uninstall
 327
 328 If you want to save disk space by removing unnecessary
 329 object-files:
 330
 331          make clean
 332
 333 in the various directories will do the work for you.
 334
 335 * Creating a new Project
 336 --------------------------
 337
 338 1) The first way uses the installed libraries and header files
 339 automatically using wx-config
 340
 341 g++ myfoo.cpp `wx-config --libs` `wx-config --cflags` -o myfoo
 342
 343 Using this way, a make file for the minimal sample would look
 344 like this
 345
 346 CC = g++
 347
 348 minimal: minimal.o
 349     $(CC) -o minimal minimal.o `wx-config --libs`
 350
 351 minimal.o: minimal.cpp mondrian.xpm
 352     $(CC) `wx-config --cflags` -c minimal.cpp -o minimal.o
 353
 354 clean:
 355         rm -f *.o minimal
 356
 357 This is certain to become the standard way unless we decide
 358 to sitch to tmake.
 359
 360 2) The other way creates a project within the source code
 361 directories of wxWindows. For this endeavour, you'll need
 362 the usual number of GNU tools, at least
 363
 364 GNU automake version 1.4
 365 GNU autoheader version 2.14
 366 GNU autoconf version 2.14
 367 GNU libtool version 1.2 (1.3 seems broken)
 368
 369 and quite possibly
 370
 371 GNU make
 372 GNU C++
 373
 374 and if you have all this then you probably know enough to
 375 go ahead yourself :-)
 376
 377 ----------------------
 378
 379 In the hope that it will be useful,
 380
 381         Robert Roebling <roebling@sun2.ruf.uni-freiburg.de>
 382
 383