/**
 * This is the documentation for ccdoc v0.8 source
 * code. For more information about ccdoc see the
 * ccdoc home page at: <a href="../index.html" target=_top>http://www.joelinoff.com/ccdoc</a>.
 *
 * The documentation is organized into 6 packages. The packages
 * are described briefly in the table below.
 * <p>
 * <table width="80%" border=1>
 * <tr><th>Phase</th><th>Description</th></tr>
 * <tr><td>DATABASE</td><td>The code associated with reading/writing the ccdoc database.</td>
 * <tr><td>PHASE1</td><td>The code that parses the input C++ files.</td>
 * <tr><td>PHASE2</td><td>The code that indexes unassociated entities.</td>
 * <tr><td>PHASE3</td><td>The code that generates the HTML output.</td>
 * <tr><td>STATEMENT</td><td>The code associated with processing ccdoc statements.</td>
 * <tr><td>UTILS</td><td>The code associated exception processing, log files, the internal string manager and switch handling.</td>
 * </table>
 *
 * This documentation was generated with the following commands, run
 * from the source directory:
 * <blockquote>
 * <pre>
 * % rm -f ../doc/webdocs/*.html
 * % ccdoc -v -db ../doc/webdocs/ccdoc.db -pkg UTILS \
 *      exceptions.h \
 *      log.h \
 *      strmgr.h \
 *      switches.h
 * % ccdoc -db ../doc/webdocs/ccdoc.db -pkg PHASE1 phase1*.h
 * % ccdoc -db ../doc/webdocs/ccdoc.db -pkg PHASE2 phase2*.h
 * % ccdoc -db ../doc/webdocs/ccdoc.db -pkg PHASE3 phase3*.h
 * % ccdoc -db ../doc/webdocs/ccdoc.db -pkg DATABASE database.h
 * % ccdoc -db ../doc/webdocs/ccdoc.db -pkg STATEMENT statement.h
 * % ccdoc -db ../doc/webdocs/ccdoc.db v0_8.txt
 * % ccdoc -db ../doc/webdocs/ccdoc.db -index
 * % ccdoc -db ../doc/webdocs/ccdoc.db \
 *      -html ../doc/webdocs/ \
 *      -header v0_8_hdr.txt \
 *      -srcurl ../../src/ \
 *      -root CCDOC \
 *      -rooturl ../users_guide.htm
 * </pre>
 * </blockquote>
 * As you can see, ccdoc was run multiple times to support the creation
 * of multiple packages.
 * @author <a href="mailto:joe@joelinoff.com,jdl@xilinx.com?subject=ccdoc code docs">Joe Linoff</a>
 * @version 0.8
 * @pkgdoc @root
 * @pkgdoctid program
 */

/**
 * Convert the C++ input to statement::base objects.
 * @author Joe Linoff
 * @version 0.8
 * @pkgdoc PHASE1
 * @pkgdoctid module
 */

/**
 * Process C++ class methods that were defined as global functions.
 * This phase allows comments to be put into source files.
 * @author Joe Linoff
 * @version 0.8
 * @pkgdoc PHASE2
 * @pkgdoctid module
 */

/**
 * Generate HTML from the statement::base objects.
 * @author Joe Linoff
 * @version 0.8
 * @pkgdoc PHASE3
 * @pkgdoctid module
 */

/**
 * The exception classes, the output log classes, the string manager class,
 * and the switches.
 * @author Joe Linoff
 * @version 0.8
 * @pkgdoc UTILS
 * @pkgdoctid module
 */

/**
 * The statement class definition and the comment class
 * definition. The comment class generates itself from
 * a statement object. It is very useful for processing
 * comments.
 * @author Joe Linoff
 * @version 0.8
 * @pkgdoc STATEMENT
 * @pkgdoctid module
 */

/**
 * The database class definition.
 * @author Joe Linoff
 * @version 0.8
 * @pkgdoc DATABASE
 * @pkgdoctid module
 */