some more javadoc updates