Use @deprecated for deprecated constants

The AIDL compiler now supports deprecating entities by adding
'@deprecated <optional note>' in the javadoc style comments.

Replaced workarounds to emit `@Deprecated` to the Java generated code
with the supported way of deprecation.

Since C++ generated code also respects @deprecated, references to older
names are switched to newer names as well.

Bug: 174514415
Test: m
Change-Id: I5c260302e88332fc4cfe323e4c946e977aa2a862