added some javadoc for base classes