Installation and Usage Notes for the cif2various Application
                            (Source Distribution)

1.  Installation   

    Uncompress and unbundle the distribution using the following command:

        zcat cif2various-vX.X.tar.gz | tar -xf - 


2.  Building the Application

    Position in the cif2various-vX.X directory and run "make" command:

        cd cif2various-vX.X 
        make

    The application executables will be placed in the "cif2various-vX.X/bin" 
    subdirectory.

    NOTE: The users who are working on Sun platform are 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.  Application Usage Notes

    The program is a Unix command line program. It only requirs two inputs:
    mmCIF file name and the output format.

    Usage: cif2various -i input_cif_file_name -o output_format

    where:

    input_cif_file_name - the input mmCIF file name
    output_format can be:
    CNS    - converts mmCIF to CNS format
    HKL    - converts mmCIF to HKL or SCALEPACK format
    TNT    - converts mmCIF to TNT format
    SHELX  - converts mmCIF to SHELX format
    EPMR   - converts mmCIF to EPMR format


4.  Example test

    Position in the cif2various-vX.X directory and execute:

    make test

    This command utilizes the application in order to convert structure
    factor file from MMCIF format to CNS format that is stored in the file
    ar0007-sf.cif_11.CNS.