Hello,
On 3/17/2021 3:56 PM, jmehrens wrote:
On Tue, 16 Mar 2021 22:24:55 GMT, Joe Darcy <da...@openjdk.org> wrote:
[snip]
780:
781: /**
782: *{@return {@code true} if and only if this class has the synthetic
modifier
The braces around return tag are allowed? "{@return ...} vs. "@return ..."
Seems inconsistent with other uses of return tags.
Yes; after a recently-added javadoc feature in JDK 16:
JDK-8075778: Add javadoc tag to avoid duplication of return
information in simple situations.
https://bugs.openjdk.java.net/browse/JDK-8075778
The usage allow an explicit @return tag to be elided when it is the same
as the first sentence of the javadoc.
The docs in the java.compiler module have been updated to use the feature.
HTH,
-Joe
