[cleanup] improved javadoc