javadocs about deprecated param