added some javadoc to key classes