Improved comments, updated javadoc web pages