Installation and Usage Notes for the
                             Dictionary Suite



1. Installation

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

        zcat mmcif-dict-suite-vX.XXX-prod.tar.gz | tar -xf -

    The result of this command is a subdirectory mmcif-dict-suite-vX.XXX-prod in
    the current directory. It contains subdirectories of various source and
    data modules.


2.  Building the Suite

a.  Position in the mmcif-dict-suite-vX.XXX-prod directory and run "make"
    command:

        cd mmcif-dict-suite-vX.XXX-prod
        make

    All the built executables will be placed in the
    "mmcif-dict-suite-vX.XXX/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 mmcif-dict-suite-vX.XXX-prod directory and execute
    "make everything":

        cd mmcif-dict-suite-vX.XXX-prod
        make everything

    This command will create dictionary object files and store them in "odb"
    directory and convert all the dictionaries to the XML and HTML formats,
    and store the converted files in "xml" and "html" directories.