SI-4788/SI-5948 Respect RetentionPolicy of Java annotations

Because of

```
@deprecated
class DScala
```

In the tests. I felt that `@deprecated` and `@Deprecated` where important/special-cased enough to document their current behavior explicitly.