added/fixed some javadoc