README for maintainers: $Date: 2000/07/24 22:36:22 $
===========================================================================

This is the README file specifically for maintainers.  It has the following
sections:
    - INSTALLING FAILSAFE HEADERS & LIBRARIES
    - BUILDING FROM A SOURCE TREE
    - PRODUCT VERSION NUMBER



INSTALLING FAILSAFE HEADERS & LIBRARIES

Before building the FailSafe GUI, you will need to get FailSafe headers &
libraries.  If you aren't building your own FailSafe tree, the easiest way
to get the FailSafe headers & libraries is by snorting them off bitbucket.
Decide where you want to put them (say /usr/tmp/fs), and do the following:

    mkdir -p /usr/tmp/fs
    cd /usr/tmp/fs
    rsh bitbucket "(cd /chaos/linux/oss_rpms/root_images && tar cBf - . )" \
        | tar xBf -
    setenv EXTRA_INCS -I/usr/tmp/fs/inc
    setenv EXTRA_LIBS -L/usr/tmp/fs/lib

Actually, for now, there are a couple of additional steps; you need to
copy fs_client.h and fs_param.h into your FailSafe include directory.
- install the failsafe-1.x.x SRPM
- tar xvfz /usr/src/redhat/SOURCES/failsafe-1.x.x.tar.gz include/fs_client.h \
    include/fs_param.h
- cp /usr/src/redhat/SOURCES/failsafe-1.x.x/include/fs_client.h \
    /usr/src/redhat/SOURCES/failsafe-1.x.x/include/fs_param.h /usr/tmp/fs/inc
Franck says he's moved those files into the root images & they'll be there
next time they're generated, so by the time you read this, this won't be
necessary.



BUILDING FROM A SOURCE TREE

After populating your workarea, first make sure you have recent Rhino
(sysadm_base-dev) installed, as it installs a sysadm_base.m4 file which
contains macro definitions which are used by aclocal (the first step below).

Also, make sure you've got FailSafe headers & libraries, and have set
EXTRA_INCS and EXTRA_LIBS as above.

You will need to run the following commands before running "make":

    aclocal
    autoheader
    automake --add-missing
    autoconf
    ./configure --prefix=/usr --sysconfdir=/etc

(You may also need --with-JAVAPATH=/usr/jdk118/bin, etc.)

At this point, you should be able to run "make rpm".

This works on the following systems:

    RedHat 6.2
        autoconf-2.13
        automake-1.4
        gettext-0.10.35
        gmake-3.78.1
        libtool-1.3.4

OK, that was a short list.



PRODUCT VERSION NUMBER

The version is stored in configure.in.  The value set there is available in
C/C++ files through config.h and Java files through
packages/com/sgi/fsmgr/fsPackageP.properties (which is generated from
fsPackageP.properties.in at configure time).  The
/var/lib/sysadm/products/.../version link is created by misc/Makefile.am.