cce is system for generating HTML documentation from C++ source and
header files.  It parses a generous subset of C++ and understands
specially-formatted comments of the form

/**********************************************************************

  One-line synopsis

  @Description Multi-line description of the thing.  HTML tags may be
   embedded within this block, <B>like so</B>.

  @Author Stephen Edwards

 **********************************************************************/

For more information, see the cce home page:

	http://www.eecs.berkeley.edu/~sedwards/cce/

Example source and header files can be found in the doc/examples directory.

----------------------------------------------------------------------
INSTALLATION

  cce runs under Unix-like operating systems, requires an ANSI C
  compiler (e.g., gcc), and the following packages

	Package		Desired		Can be obtained from
			Version
	--------------------------------------------------------------
	Tcl		7.5		ftp://ftp.smli.com/pub/tcl/
	flex		2.5.2		ftp://prep.ai.mit.edu/pub/gnu/
	bison		1.22		ftp://prep.ai.mit.edu/pub/gnu/

SIMPLE INSTALLATION

	% ./configure
	% make
	% make install

  By default, this will install cceExtHtml and its related files in
  /usr/local/{bin,lib,man}.

COMPLEX INSTALLATION

* To place cceExtHtml in a different directory, configure may be
  invoked with a --prefix option, e.g.,

	% ./configure --prefix=/home/cce

  will install cceExtHtml in /home/cce/{bin,lib,man}.

* If the default version of tclsh appears to support loadable modules,
  the makefile will attempt to build cce as a loadable module.  To
  manually enable or disable this feature, use

	% ./configure --enable-module
	% ./configure --disable-module

* Another option allows you to specify a different tclsh executable
  (which much appear in your search path).  For example,

	% which tclsh-7.5
	/usr/sww/bin/tclsh-7.5		# OK
	% ./configure --with-tclsh=tclsh-7.5

* Unfortunately, configure is not infallible.  In particular, if you
  have a non-standard Tcl installation, it may not find tcl.h or
  libtcl.a.  If this happens, edit the generated Makefile and fix
  TCL_INCLUDE_DIR and/or TCL_LIB_SPEC and TCL_LIBS.

* More installation details can be found in the file INSTALL.

----------------------------------------------------------------------
AUTHOR

Stephen Edwards
sedwards@eecs.berkeley.edu
http://www.eecs.berkeley.edu/~sedwards
