Mark `@Deprecated` annotation in overridden methods

[ikhoon]

We conventionally omit @Deprecated in the overridden methods.
That is easy to maintain but IDE does not properly notify users that the function is deprecated, and the deprecation is not rendered correctly in Javadoc.

[jrhee17]

We probably need to check how many occurrences there are, but I would feel better if this was fixed on the IDE level in terms of maintainability

[ikhoon]

I've googled to get the specification for that.

TL;DR: It seems like a standard that a compiler or IDE doesn't produce a warning for an overridden method without @Deprecated annotation.

• https://youtrack.jetbrains.com/issue/KT-47902/Do-not-propagate-method-deprecation-through-overrides
• https://github.com/openjdk/jdk13/blob/dcd4014cd8a6f49a564cbb95387ad01a80a20bed/src/java.base/share/classes/java/lang/Deprecated.java#L38-L39
• https://stackoverflow.com/questions/33255581/add-deprecated-annotation-to-the-superclass-subclasses-or-both
• https://stackoverflow.com/questions/36838925/deprecations-on-overriding-method

[minwoox]

Related #5685
If we use the SELF type for the builder, the problem won't appear for the builder classes.

[ikhoon]

It sounds like a better idea. 👍