Pull request for trunk 309

Added javadoc for all classes and methods. Generally followed guide lines suggested by Ben Wolfe, reporter 
of the trunk. Mostly ignored @see and custom tags. Completely ignored @deprecated tags.