[NETBEANS-5838] Support for {@return …} Javadoc tag (JDK-8075778)

• Type: New Feature
• Status: Resolved
• Priority: Major
• Resolution: Not A Bug
• Affects Version/s: 12.4
• Component/s: java - Javadoc

Environment

Java 16

• External issue URL: https://bugs.openjdk.java.net/browse/JDK-8075778
• External issue ID: JDK-8075778
• Assignee: Unassigned
• Reporter: dennis lucero
• Created: 05/Jul/21 13:12
• Updated: 13/Mar/22 19:52
• Resolved: 13/Mar/22 19:52

Description

Currently

/**
 * {@return something}
 */

does not show up in the Javadoc window. According to JDK-8075778 the text in the tag should be displayed in the description (prefixed with "Returns " and in the "returns" section.

Also autoformatting the source code currently transforms the tag into

 /**
 * 
 * {
 * 
 * @return something}
 */

which is not recognized by the Javadoc generator anymore. The generated output contains "{" as the description and the given text including "}" (but without the "{") in the "returns" section.

Issue Links

• links to: apache/netbeans#3774