update javadocs
update documentation for core classes and regenerate javadocs