updated core package javadocs