Installation of CifSieve

Step by Step
------------

0.  Make sure your system contains programs bison, flex, gzip and perl
(from the FSF project, ftp://prep.ai.mit.edu).

1.  CifSieve comes as a gzipped tar file.  Unzip and untar the file into a 
convenient working directory:

tar -zxvf - < cifsieve.tar.gz
or maybe
gunzip cifsieve.tar.gz; tar -xvf - < cifsieve.tar

2.  Create the DDL parsers by typing 'Make'

make

3.  Copy the parsers and file BuildSiv into a directory which is
normally searched for executables, eg /usr/local/bin :

cp ddl1parse ddl2parse BuildSiv /usr/localbin

4.  Update the executable search hash tables:

rehash

5.  All remaining files in the current directory can be deleted.


Problems
--------

CifSieve was constructed and tested on a Linux/GNU system.  Users
running other Unix versions should be aware of the following points:

1.  The original AT&T program 'lex' does not substitute for 'flex' and 
will not read the ddl1parse.lex / ddl2parse.lex files properly;

2.  Yacc may also encounter problems.  Bison is recommended.

3.  The Gnu C compiler is assumed, although very few options are used
so that other C compilers may be OK.  If not, check the makefile.

The Perl script makes a number of system calls which assume the presence
of Unix programs rm, cat, and cc.  If running on a non--Unix system,
you may need to alter the format of these commands (to find them in
the BuildSiv script, search for the word 'system').

The author (jrh@nirim.go.jp) would appreciate hearing of any problems
with this package.