INSTALL              Aug. 1, 1994


Ok, the new source tree layout looks a bit compliciated, but the
usage is really simple. To install Xm++ do the following:

1. Extract the release file, i.e. in my homedir on one of
   our Linux PCs the command would look like this:

[bernhard:~$] gunzip -c Xm++.0.6.tar.gz | tar xvf -

   This will create a directory 'xmp080194', you may rename
   it i.e. to xmTools.

2. Configure for your system. A 'system' is usually the combination
   of platform and compiler, but you may apply arbitrary other
   criteria. Currently supplied configurations are

   SUN1CC2  SunOS 4.1.X, Sun C++ 2.1
   SUN1CC3  SunOS 4.1.X, Sun SPARCWORKS C++ 3.X
   SUN1gcc  SunOS 4.1.X, gcc 2.5.X
   SUN1g6cc SunOS 4.1.X, gcc 2.6.0
   HP8CC2   HP-UX 8.07, HP C++ 2.X
   HP8gcc   HP-UX 8.07, gcc 2.5.X
   HP9CC3   HP-UX 9.01, HP C++ 3.X
   SGI4CC3  SGI Irix 4.0.5, AT&T C++ 3.X
   AIXxlC   IBM RS6000, IBM's xlC
   LINUX    Linux 0.99pl14 - 1.0pl?, gcc 2.5.X

   Change to the .../systems directory

[bernhard:~$] cd xmTools/systems

   If you are configuring a supported system you only
   need to run the mksys script:

[bernhard:~/xmTools/systems$] mksys LINUX

   Otherwise duplicate the configuration files the nearest matching
   choice and adapt them to meet your needs. For example if you
   use gcc2.6.0 under LINUX do the following:

[bernhard:~/xmTools/systems$] cd templates/include
[bernhard:~/.../templates/include$] cp SUN1g6cc.h LINUX26.h
[bernhard:~/.../templates/include$] cd ../makefiles
[bernhard:~/.../templates/makefiles$] cp SUN1g6cc.init LINUX26.init
[bernhard:~/.../templates/makefiles$] cd ../../systems
[bernhard:~/xmTools/systems$] mksys LINUX26

   The mksys script will create a directory .../systems/<SYSNAME> 
   containing the files Make.init and sysdefs.h and all necessary
   subdirectories and links.

   In most cases you'll have to edit Make.init to set the include
   and library paths for X11, Motif and Xaw matching to your
   system. Caution: If everything is available on the standard
   paths - set the values to '.' rather than to an empty string!

   When building in an unsupported environment you'll also have
   to modify the sysdefs.h file. See .../doc/sysdefs.txt
   for info on possible values.

   (If you successfully compiled Xm++ in a new environment we 
   would appreciate it if you mail your configuration files to
   xmplus@ani.univie.ac.at)

3. Build the basic stuff:

[bernhard:~/xmTools/systems$] cd LINUX/xmplus
[bernhard:~/xmTools/systems/LINUX/xmplus$] make

   This should build the libraries, the dialog editor and
   the dialog box sample in both Motif and Xaw versions.
   If you want only one version, try 'make all-xm' or
   'make all-aw' respectively.

4. Print the Xm++ documentation (optional)

   The directory which contains this file (.../doc/xmplus)
   also containes the Xm++ Users Guide and Class Reference
   Manual. You may print the supplied PostScript versions of
   these files. (xmguide.ps, xmref.ps)

5. Start your own projects:

   Put a copy of .../systems/LINUX/xmplus/samples/Makefile
   into your project directory and follow the instructions
   given in the makefile's header.


At the moment I haven't tested this on all platforms, but on most
of them it seems to work quite well. Forgive / mail me if it
doesn't work for you, I'm sure there will be a solution.

Good luck!
