Dramatic javadoc improvements....
References to other code is now linked correctly, allowing for easier browsing of code.  In addition there is greater and more correct usage of the @code annotation.  I also spaced all javadocs to the same maximum line length (100 characters).