more javadoc for new classes