head	1.4;
access;
symbols
	RELEASE_1_0:1.2;
locks; strict;
comment	@# @;


1.4
date	96.12.12.08.57.52;	author evans911;	state Exp;
branches;
next	1.3;

1.3
date	96.12.12.01.45.08;	author evans911;	state Exp;
branches;
next	1.2;

1.2
date	96.12.11.04.31.37;	author evans911;	state Exp;
branches;
next	1.1;

1.1
date	96.11.17.22.43.54;	author jone9333;	state Exp;
branches;
next	;


desc
@@


1.4
log
@*** empty log message ***
@
text
@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.
@


1.3
log
@*** empty log message ***
@
text
@d3 1
a3 1
The cca beta distribution file is archived with tar, then compressed with the
d34 3
a36 3
- cca/doc/latex/* : LaTeX documentation source.
- cca/doc/key.ps : PostScript file that describes the symbols used in the
                   graphical output. 
d42 1
a42 1
cca/doc/, then typing "nroff -man cca.1 | more".  
@


1.2
log
@*** empty log message ***
@
text
@d33 1
a33 1
- cca/doc/html/cca.html : Main html page for the online documentation.
@


1.1
log
@Initial revision
@
text
@d4 2
a5 2
compress function.  To completely unpack this distribution file, simply
save the distribution file to some directory and type the following command:
d7 1
a7 1
uncompress -c cca.BETA_1.tar.Z | tar xvf - 
d9 2
a10 3
When the distribution file is unpacked with the above method, a 
subdirectory cca/ will be created to store all of the files and
subdirectories.
d12 1
d15 3
a17 5
After unpacking, there will be a cca/src/ directory.  This contains all of
the source files for the cca tool as well as an installation script called
pmerge.pl .  This script will combine all of the separate source files into a
single executable, as well as inserting the location of perl into the first
line of the script.
d19 1
a19 1
To run the installation script, type
d21 3
a23 1
./pmerge.pl perl_location executable
d25 2
a26 2
where perl_location is the location of perl on your system, and executable is
the file name you would like to give to the executable file.
a27 1
An example of this is:
d29 1
a29 1
 ./pmerge /usr/local/bin/perl cca
d31 6
a36 2
Which creates the executable cca for a system on which the perl interpereter
resides in the /usr/local/bin directory.
a37 2
NOTE - It is imperative that you know where the perl interpereter is located.
If this is not known, this tool will be unusable.
d39 1
a39 2
REQUIREMENT - A perl 5.0 or later interpereter is required.  Once again,
without this, the cca tool will not run.
d41 4
d47 1
a47 1
(Assuming an executable file called cca)
d50 1
a50 1
	Prints the usage statement
d53 1
a53 1
	Analyzes the input file someCfile.c, and sends output to STDOUT
d56 1
a56 1
	Same as above, except output is written to outfile.txt
a64 14

VIEWING THE MAN PAGE:

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

UNDERSTANDING THE GRAPHICAL OUTPUT:

In the cca/doc/ subdirectory, there is a postscript file called key.ps which
describes the symbols in the graphical output files.  You can print this, or
use ghostview to display it.


@
