Installation Guide
Table of Contents
0. Requirements
1. Configuring Xarm
2. Compiling Xarm
3. Installing Xarm
4. Fastrack
X11R5 or greater
Motif 1.2.x or greater (LessTif can be used)
gcc 2.7.2 or greater (other C++ compilers may work)
GNU make (or hack support into configure.in for you make utility)
Configuration of Xarm is handled by GNU autoconf. Configuration using the old Imakefile package is still possible but is no longer supported.
To configure Xarm for your system, just type './configure'. This should do a reasonable job of locating the stuff it needs, and gives rather verbose output should something fail.
Two things that configure looks for on your machine are:
It will tell you where it has found them if it found them. If it didn't find them, you'll have to specify the path to them on the command line to configure. To specify the X stuff, use these two options:
--x-includes
--x-libraries
And to specify the Motif stuff, use these:
--with-motif-includes
--with-motif-libraries
To specify the location of the various bits, you have to set these flags equal to something. For example:
./configure --x-includes=/usr/local/X11R5/include
Note: If configure can't locate either X or Motif on your system you have to specify both the include path and the library path. Also, by default configure installs in /usr/local. To override this use the --prefix option. For example:
./configure --prefix=/usr/X11R6
After configuring Xarm, just typing 'make' should build all the libraries, examples, and clients for Xarm. To build libraries or other things only, just cd to the directory in which you want to build things, and type 'make'. Dependencies have been set up so that the libraries will be recompiled if they are old (or haven't been compiled yet), so typing 'make' from within an example directory will rebuild what needs to be rebuilt.
Some combinations of compilers and libraries may have code generation bugs. For example, gcc-2.7.0 on a Solaris platform has known problems if the library is compiled with an optimization greater than -O (-O1). If you see wierd problems when you debug library code, try a lower (or no) optimization. For the vast majority who compile with the default flags (-g for GNU-C), this is not an issue.
Installing Xarm is as easy as typing 'make install'. However, you may need to be root to do this.
chmod u+x configure
./configure
make