added deprecation javadoc