added javadoc (hopefully ;) )