When the javadoc contains tags, like the one above, the generated description contains something like
Retrieves the representation of the {@link M2MResource} which holds a
I've tracked the problem to ParserHelper.getInheritableCommentText(), which uses methodDoc.commentText(). The documentation of that method actually says, that tags like {@link} will be removed, but that's not true.
Instead the method should be modified to use methodDoc.inlineTags() and convert the tags to string.
modifies ClassDocCache to support java7 syntax (this is only java 8 syntax you use in the code, and build infrastructure in companies usually doesn't have the latest stuff installed)
ParserHelper.getInheritableCommentText() calls a new helper to process the tags
adds TagHelper.java
adds extlink.properties - it contains package-to-external-link mapping.
When the javadoc contains tags, like the one above, the generated description contains something like
I've tracked the problem to ParserHelper.getInheritableCommentText(), which uses methodDoc.commentText(). The documentation of that method actually says, that tags like {@link} will be removed, but that's not true.
Instead the method should be modified to use methodDoc.inlineTags() and convert the tags to string.