Installation and Usage Notes for the
                        CIFOBJ - Loader Class Library


1. Installation

a.  Uncompress and unbundle the distribution using the following command:

        zcat cifobj-loader-vX.XXX-XXX.tar.gz | tar -xf -

    The result of this command is a subdirectory cifobj-loader-vX.XXX-XXX in
    the current directory. It contains subdirectories of various source modules.


2.  Building the Application

a.  Position in the cifobj-loader-vX.XXX-XXX directory and run "make" command:

        cd cifobj-loader-vX.XXX-XXX
        make

    The application executable "CifLoader" will be placed in the
    "cifobj-loader-vX.X/bin" subdirectory.

    NOTE: The users who are working on Sun platform are strongly advised to
    check the compiler flags in etc/make.platform.sunos5 file. Depending on
    the compiler version, users may be required to make modifications to those
    compiler flags.


3.  Demonstration

a.  Position in the cifobj-loader-vX.X-XXX directory and execute "make test":

        cd cifobj-loader-vX.X-XXX
        make test

    This command invokes "CifLoader" executable with the ddl file and
    dictionary file from "cifobj-loader-vX.X/test" directory and puts the
    resulting persistent storage file "mmcif_std.odb" in the same directory.
    This file can be used as an input to the CIFLIB builder application.