UNPACKING:

The cca distribution file is archived with tar, then compressed with the
compress program.  To completely unpack this distribution file, simply save
the distribution file to some directory and type the following command:

uncompress -c cca-1.0.tar.Z | tar xvf -

When the distribution file is unpacked with the above method, a subdirectory
called cca/ will be created that contains all of the files and subdirectories.


INSTALLATION:

REQUIREMENT - A Perl 5.001 or later interpereter is required, but Perl 5.002
              or above is preferred, since version 5.001 has known problems
              that may affect your ability to use cca.

To build cca, complete the following steps:

1) Change directory to cca (cd cca).
2) Run build (./build).  If you run into problems, follow the directions
   given by "build".

Once you have successfully run build, there will be an executable Perl script
in cca/bin called "cca" (cca/bin/cca).


USEFUL FILES:

- cca/bin/cca : The executable script (must be built with the above procedure).
- cca/man/cca.1 : The manual page for cca.
- cca/doc/html/CCA.html : Main html page for the online documentation.
- cca/doc/latex/[A-Z]+.ps : LaTeX-generated documentation in PostScript format.
- cca/doc/latex/key.ps : PostScript file that describes the symbols used in the
                         graphical output. 


VIEWING THE MAN PAGE:

The man page can be easily viewed by changing the working directory to
cca/man/, then typing "nroff -man cca.1 | more".


SAMPLE EXECUTION:

(Assuming an executable file called cca in the current working directory.)

./cca -h
	Prints the usage statement.

./cca -f someCfile.c
	Analyzes the input file someCfile.c, and sends output to STDOUT.

./cca -f someCfile.c -o outfile.txt
	Same as above, except output is written to outfile.txt.

./cca -f someCfile.c -g graphfile.ps 
	Analyzes someCfile.c, and generates a graphical chart of the
	conditional control logic within the file and stores this chart in 
	PostScript format in the file graphfile.ps

See the man page for further examples and explanations of the available
analysis options.
