# 
# $Date: 1997/05/23 22:28:45 $
# $Source: /usr/local/src/Xbae/INSTALL,v $

INSTALLATION
============

To install:

1. Unpack the tar file.  You've probably already done this step if
   you're reading this file.

2. Take a look at Xbae.tmpl and modify accordingly.  Particularly the
   libraries to be built, HaveWcl, HaveXpm, RESIZE_SHADOW,
   ALLOW_COLUMN_RESIZE, USE_EDITRES and DEFAULT_SCROLL_SPEED macros.
   In order to run the demos, it is best not to make the shared lib
   unless you have a very clever dynamic linker.  I would suggest
   building the shared library only when you are ready to install.
   You can try setting your LD_LIBRARY_PATH to point to the source
   directory if you like.

3. Run "xmkmf" to create the makefile.  [Note to VMS users and
   others who don't have xmkmf and imake:  I'm told that VMS doesn't
   have imake.  Try looking in the "contrib/vmsstuff" directory
   (thanks Vince) for the MMS files. You'll have to move this dir up
   a level, too and perhaps modify a few files as they will be out of
   date]

4. Run "make World".  Alternatively, you can use xmkmf -a if your xmkmf
   supports it.

5. If it doesn't compile cleanly, then I'd almost guarantee that there
   is something wrong with your setup of imake, so contact your system
   administrator before coming to me.  If I can compile it on a pyramid
   system running DC/OSx and Motif1.1 then it should work for you.

6. Go to the examples sub directory and run "runtest" for a simple demo
   and to test it's all working OK.

7. Run "make install".  The library and header files will be installed
   with a -(RELEASE.NO) suffix and symbolic links made.  That way, you
   will be able to relink with older versions of the widget if the need
   arises.

8. Run "make install.man" to install the manual pages.

9. Send me (lister@syd.net.au after June '97 or lister@shadow.apana.org.au
   before that) some email to let me know how installation went, the
   platform on which compiled and what you intend to use the widgets for.
   This step is optional but will help me to get an idea of what needs to
   be done in further releases.  Don't forget to join the mailing list!
   Also, I need more postcards :p

