More Javadoc, especially on classes in ...core package