yeikel commented on PR #985: URL: https://github.com/apache/maven/pull/985#issuecomment-1419720276
> Why the duplication with Javadoc tags if there is a Java annotation? Where is the benefit? Others I do understand. This might help : https://stackoverflow.com/questions/20674135/deprecated-vs-deprecated#:~:text=%40deprecated%20is%20a%20javadoc%20tag,conjunction%20to%20the%20%40Deprecated%20annotation. > [@Deprecated](http://docs.oracle.com/javase/8/docs/api/java/lang/Deprecated.html) is an annotation that is read by the compiler, used to mark a method as deprecated to the compiler and will generate a deprecation compile-time warning if the method is used. > > [@deprecated](http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#@deprecated) is a javadoc tag used to provide documentation about the deprecation. You can use it to explain why the method was deprecated and to suggest an alternative. It only makes sense to use this tag in conjunction to the @Deprecated annotation. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
