core javadoc added