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

• Type: New Feature
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 12.4
• Fix Version/s: 24
• 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: 28/Aug/24 08:02
• Resolved: 28/Aug/24 08:00

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