File	Date	Author	Commit
code	2010-03-02	James Sant'Angelo	[871f22] Merge branch 'next'
comtor_data	2010-03-02	Peter DePasquale	[220b63] Removed since it's not needed to be delivered i...
designdocs	2010-03-02	James Sant'Angelo	[871f22] Merge branch 'next'
install	2010-03-02	James Sant'Angelo	[871f22] Merge branch 'next'
migrations	2010-03-03	Peter DePasquale	[23c13e] Removed stashing comments and diff comments.
testingCode	2010-03-02	James Sant'Angelo	[871f22] Merge branch 'next'
unitTesting	2009-04-28	ssigwart	[dd5401] Unit testing and framework
www	2010-03-03	Peter DePasquale	[bd0dd9] Removed old, unneeded files.
INSTALL_README	2009-10-26	James Sant'Angelo	[0ba36d] Removed obsoleted readme, updated INSTALL readm...
LICENSE	2006-07-21	locasto	[7e698f] boilerplate files, not important
README	2010-03-02	James Sant'Angelo	[871f22] Merge branch 'next'
packager.sh	2010-03-03	Peter DePasquale	[2a284d] Cleaned up the release packager script to prope...

Read Me

Release Notes for Comment Mentor
````````````````````````````````

See the file INSTALL_README for installation and removal instructions.

If you are planning on doing development for COMTOR, see the tutorials
in the /designdocs/tutorials directory. Additonally, for more information
on how certain prepackaged doclets work, see the /designdocs/modules/ 
directory.

[Executive Summary]

Comment Mentor is a tool for automatically assessing the quality of source
code comments. It currently works on JavaDoc-style comments for Java code.
It is built with the Apache Ant tool and is known to work with the JDK 5.x.
Comment Mentor measures a number of features of source code comments and
rates the features of your code against standard code bases that have been
evaluated by hand. A summary and detailed report of how your comments stack
up against this test suite is generated.

Comment Mentor includes a number of tools, including:

 * CheckforTags		: checks for the presence of tags where/if required
 * Interactions		: analyzes various interactions between classes and methods
 * CommentAvgRatio   	: average comment length per class
 * PercentMethods  	: percent of methods documented in a class
 * SpellCheck		: checks for spelling errors
 * ReadingLevel		: Determines various sentence metrics and computes
 				Flesch-Kincaid reading level.
 * PreAndPostCheck     	: checks for the new @precondition and @postconditions tags
 
Thanks, and enjoy using Comment Mentor.