		    COMPILING THE XDT LIBRARY 
----------------------------------------------------------------------

Xdt is distributed in source-code form only.  Because it is
a library rather than an application, the compiled form of
the library will depend on your hardware and operating
system, and also on the version of X, Xt, Motif, and Xmt 
that you use.

The Xdt distribution comes with an Imakefile that you can
use with imake to build Xdt.  The first step in doing this
is to read the file Xdt.tmpl, and set variables as it
describes to customize it for your system.  The table below
lists the variables that you might want or need to set.
Note that some of these variables are C-preprocessor symbols
used by imake, and others are variables used directly by
make.

  Variable			Purpose
----------------------------------------------------------------------
DoNormalLib	 whether to build a normal, non-shared library.  YES or NO.
DoSharedLib	 whether to build ashared library.  YES or NO.
DoDebugLib	 whether to build a debugging (-g) library.  YES or NO.
DoProfileLib	 whether to build a profiled library.  YES or NO.
XdtUseMotif      whether to build with Motif references
XdtUseMotifTools whether to build with Xmt references
XDTLIBDIR	 Where to install the Xdt library.
XDTINCDIR	 Where to install the Xdt header files.
XDTXTLIB	 Where your X libraries are installed.
XDTXTINC	 Where your X header files are installed.
XDTXMLIB	 Where your Motif library is installed.
XDTXMINC	 Where your Motif header files are installed.
XDTXMTLIB	 Where your Motif Tools (Xmt) library is installed.
XDTXMTINC	 Where your Motif Tools (Xmt) header files are installed.
XMTEXTRALIBS	 Any extra libraries needed by Motif on your system.
HPDEFINES	 Uncomment this line if you use HP's version of Motif 1.1.


Using xmkmf
------------------------------------------------------------
Once you have edited Xdt.tmpl to work on your system,
you can build the Xdt distribution with these commands:

    xmkmf
    make World >& makelog &
    tail -f makelog

This will build the library in the Xmt directory.

Using imake
------------------------------------------------------------
If you do not have the 'xmkmf' script, installed, you can do
the build with these commands:

    imake -DUseInstalled -I/usr/lib/X11/config
    make World >& makelog &
    tail -f makelog

If your imake configuration files are installed somewhere
other than /usr/lib/X11/config, you will have to
change the -I option above as necessary.



	   INSTALLING THE XDT LIBRARY AND HEADER FILES
----------------------------------------------------------------------
Once you have compiled the Xdt library, you can install the library, 
the header files, the Xmt.tmpl template file by typing:

    make -k install

in the top level directory.  If you only want to install the
library and the headers, cd to the Xdt directory, and type
'make install' there.

The Xdt library and headers will be installed in the
locations specified by the XDTLIBDIR and XDTINCDIR variables
you set in the Xdt.tmpl file before building Xdt.  You can
check that these locations are correct by typing:

    make -n install

before you do the installation.  If you will be installing
files in system directories, then you may need to perform
the installation as the superuser.

Typing 'make install' in the toplevel directory will also 
install the Xmt.tmpl template whereever imake files go on your
system.  If you are not running as root, this will probably
fail for you, which is why you should use 'make -k'.

If you do not have imake on your system, then you will
have to install the library and headers by hand.


	   COMPILING AND LINKING PROGRAMS WITH XDT
------------------------------------------------------------
Using the Xdt library is really no different than using any
other library.  To compile programs that use Xdt, the
compiler must be able to find the Xdt header files.  If you
install them in /usr/include/Xdt, then the compiler
will find them automatically.  Otherwise, you'll need to
specify a -I option to the compiler.  Your
compilation command lines might look like this:

    cc -c -I/usr/local/Xdt/include test.c

You may also have to specify -I options to point to
your X and Motif header files as well, of course.

To link a program with the Xdt library, you need to include
the -lXdt option on the command line, and the linker
needs to be able to find the Xdt library.  If you install
the library in /usr/lib, then the linker will find it
automatically.  Otherwise, you'll need to specify a
-L option.  Your linking lines might look like this:

   cc -o test test.o \
      -L/usr/local/Xdt/lib -lXdt -lXmt -lXm -lXt -lXmu -lX11 -lXext

Again, you might also have to specify -L options to
point to your X and Motif libraries.

Note that -lXext is included in the above command
line.  This is the X extensions library, and is required by
the Xmt library (if you are using it).  The Xdt library requires
the X misc. utilities (Xmu) library.
