]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/motif/install.txt
Made wxGTK dataobj.cpp compile; removed flashing from wxGLCanvas samples;
[wxWidgets.git] / docs / motif / install.txt
index 1e82044fcf9ae1b7a292f0aba76dad67ff202233..f86f3cf0a9eeb5560d51cd384eb1222d9c382235 100644 (file)
@@ -1,8 +1,8 @@
 wxWindows 2.0 for Motif installation
 ------------------------------------
 
-- Prerequisites: Motif 1.2 or above, or
-  Lesstif (not yet tested).
+- Prerequisites: Motif 1.2 or above, or Lesstif
+  (not yet tested). Motif 2.0 and above may also be suitable.
 
 - Download the files wx200gen.zip and wx200mot.zip, and
   documentation in a preferred format, such as wx200htm.zip
@@ -13,9 +13,39 @@ wxWindows 2.0 for Motif installation
   files to Unix format. Don't worry about files being
   overwritten: they should be identical anyway.
 
+COMPILING USING CONFIGURE
+
+- You can use the wxGTK configure system to make wxMotif, or
+  you can follow the following steps to use the simpler (but
+  less automatic) makefile system. If using configure, the
+  following script should make the library and samples, when
+  run from the top-level wxWindows directory (see also 'makewx'
+  in this directory):
+
+  # Make wxMotif using the configure system
+  chmod a+x install/unix/config.sub
+  install/unix/setup/general/* \
+    install/unix/config.guess install/unix/setup/shared/*
+  cd install/unix
+  autoconf && ./configure --with-shared --with-motif --with-debug_flag \
+   --with-debug_info --without-threads
+  cd ../..
+  make makefiles
+  make
+
+COMPILING USING MAKEFILES
+
+- Choose a .env file from src/makeenvs that matches your
+  environment, and copy it to src/make.env. These are the
+  settings read by wxWindows for Motif makefiles.
+
 - Edit src/make.env to change options according to your local
   environment. In particular, change WXDIR to where wxWindows is
-  found on your system.
+  found on your system, or set the WXWIN environment variable
+  before compilation, e.g.:
+
+    export WXWIN=/home/jacs/wx2
+
   Later, there will be a better makefile system
   and/or alternate make.env files as per wxWindows 1.68.
   Please feel free to contribute settings files for your environment.
@@ -38,10 +68,10 @@ Notes:
 ------
 
 - Better installation and makefile systems are
-  required. I didn't use the wxGTK system because I couldn't
-  understand it or make it work with wxMotif. Also I think
-  we should use something that can be made to work easily
-  with applications outside the wxWindows hierarchy.
+  required. Although the wxGTK config system can be used to make
+  wxMotif and samples, it can't easily be made to work
+  with applications outside the wxWindows hierarchy. Hence the
+  simple makefile system.
 
 - Debugging mode is switched on by default. To compile in non-debug
   mode, remove the -D__WXDEBUG__ switch in make.env.
@@ -51,11 +81,35 @@ Notes:
   I'd prefer you to fix the problem and send the fix to me :-) or at
   least let me know about it.
 
+- Thread support is switched off by default in setup.h (wxUSE_THREADS)
+  because standard Unices often do not have the necessary thread library
+  installed. Please see ../docs/gtk/install.txt for more details on this.
+  For Linux, the problem is expected to go away with future
+  distributions of the operating system.
+
+- If you have trouble compiling the file y_tab.c, or have strange
+  linking errors, check whether you're using a C or C++ compiler for this file.
+  You should specify a C compiler in the CCLEX variable in src/make.env.
+
+- If you run into problems with a missing X11/Xpm.h header, you
+  need to install the XPM package. It can be obtained from:
+
+  ftp://ftp.x.org/contrib/libraries/xpm-3.4k.tar.gz
+  http://sunfreeware.com
+
+  You may need to modify make.env to add -I and -L options pointing to where Xpm
+  is installed and possibly change bitmap.cpp to
+  include <xpm.h> instead of <X11/xpm.h>
+
+  Alternatively, edit include/motif/setup.h, set wxUSE_XPM
+  to 0, and recompile. You will not be able to load any XPMs,
+  though (currently the only supported colour bitmap format).
+
 - Please send bug reports with a description of your environment,
   compiler and the error message(s) to the wxwin-users mailing list at:
 
     wxwin-users@wx.dent.med.uni-muenchen.de
 
 
-Julian Smart, November 1998.
+Julian Smart, December 1998.
 julian.smart@ukonline.co.uk