CB-5471: add deprecation javadoc/annotation