update documentation for core classes and regenerate javadocs