Clean up deprecation annotations and javadoc tags
- Document the deprecated API elements that are not scheduled for removal
- Use SuppressWarnings instead of Deprecated annotation on methods in non-public subclasses that override public deprecated methods
- Improve messages on some deprecated Javadoc tags