New @DeprecatedFor to improve deprecation process

An annotation is needed to enhanced @Deprecated annotation usage, and allow the creation of tools to strengthen the API life cycle.

As we don't have access to the JEP 277, we'll use a @DeprecatedFor annotation instead which will support the following attributes:

• since: the revision in which the annotated element became deprecated.
• reason:
  • CodeRemoval tags the deprecation for being removed in next revisions,
  • CodeLegacy tags the deprecation as being maintained but which should be used only with extreme prudence.

A draft lives in https://github.com/nuxeo-sandbox/nuxeo-tools-deprecation