Xdigitise installation instructions

UNPACKING

Unpack the archive with the following command:

> gzip -dc xdd.tar.gz | tar -xvf -
 

INSTALLATION

Open the file xdd.config in editor

Look for the lines that define variables BUILDROOT & XDDHOME

BUILDROOT=$(HOME)

XDDHOME=$(BUILDROOT)/XDD

Edit these lines so that XDDHOME reflects the current directory. (BUILD ROOT can be ignored if XDDHOME is set to absolut path)

Now create the top level makefile.

> xmkmf

Create the other makefiles

> make Makefiles

Start the build process

> make install

Note that the 'install' is neccessary because of the many dependencies. That is there are many libraries that are built that need to be found by other components. They will installed within the XDD tree. This is done to keep the many Imakefiles simpler

At the end of this process there should be a lib and bin directory directly below the XDD directory.

To use the program this bin directory needs to be in a users PATH and the lib directory in their LD_LIBRARY_PATH. Or the programs and libraries should be moved to a suitable location.

****************************************************

There is a problem with the XmHTML stuff. It should build ok but not install, so if the main build bails out with a 'cant find -lXmHTML' or similar then copy the library to the correct location. That is copy XDD/xmhtml/libXmHTML.a to XDD/lib/ and restart the main build.

*****************************************************
 

ONLINE HELP

The online help should be installed automatically to the help directory under your XDDHOME directory.

You need to specify the directory to install the help files in. This directory needs to be known to xdigitise by using the XDDHELPDIR environment variable.
 

Xdigitise SCRIPT

To ease up the start of xdigitise with the appropriate environment variables set you can copy the Xdigitise script from the xdigitise directory to your bin directory. In the script the variables must be set dependant on your BUILDROOT directory.