javadoc & internal DB class documentation cleanup;