added javadoc comments to deprecated methods