You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@netbeans.apache.org by GitBox <gi...@apache.org> on 2022/03/13 15:32:43 UTC
[GitHub] [netbeans] ExE-Boss opened a new issue #3774: [NETBEANS‑5838] Support for {@return …} Javadoc tag (JDK‑8075778)
ExE-Boss opened a new issue #3774:
URL: https://github.com/apache/netbeans/issues/3774
### Description
From [NETBEANS‑5838]:
> Currently
> ```java
> /**
> * {@return something}
> */
> ```
> does not show up in the Javadoc window. According to [JDK-8075778][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
> ```java
> /**
> * {
> *
> * @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.
[NETBEANS‑5838]: https://issues.apache.org/jira/browse/NETBEANS-5838
[JDK‑8075778]: https://bugs.openjdk.java.net/browse/JDK-8075778
### Use case/motivation
_No response_
### Related issues
- [NETBEANS‑5838]
- [JDK‑8075778]
### Are you willing to submit a PR?
- [ ] Yes I am willing to submit a PR!
### Code of Conduct
- [X] I agree to follow the Apache Software Foundation's [Code of Conduct](https://www.apache.org/foundation/policies/conduct.html)
--
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: notifications-unsubscribe@netbeans.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] ExE-Boss commented on issue #3774: [NETBEANS‑5838] Support for {@return …} Javadoc tag (JDK‑8075778)
Posted by GitBox <gi...@apache.org>.
ExE-Boss commented on issue #3774:
URL: https://github.com/apache/netbeans/issues/3774#issuecomment-1066173135
@matthiasblaesing It’s correct since **Java 16**, see [JDK‑8075778](https://bugs.openjdk.java.net/browse/JDK-8075778) and [the Javadoc of `java.util.Objects.toIdentityString(…)`](https://github.com/openjdk/jdk/blob/5c408c1410e15087f735a815b7edc716d514b1b3/src/java.base/share/classes/java/util/Objects.java#L167-L189) for proof.
--
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: notifications-unsubscribe@netbeans.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] matthiasblaesing commented on issue #3774: [NETBEANS‑5838] Support for {@return …} Javadoc tag (JDK‑8075778)
Posted by GitBox <gi...@apache.org>.
matthiasblaesing commented on issue #3774:
URL: https://github.com/apache/netbeans/issues/3774#issuecomment-1066174259
In all fairness, the referenced issue description does _not_ show the new syntax, only the comment mentions it:
https://bugs.openjdk.java.net/browse/JDK-8075778?focusedCommentId=14350225&page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#comment-14350225
--
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: notifications-unsubscribe@netbeans.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] matthiasblaesing closed issue #3774: [NETBEANS‑5838] Support for {@return …} Javadoc tag (JDK‑8075778)
Posted by GitBox <gi...@apache.org>.
matthiasblaesing closed issue #3774:
URL: https://github.com/apache/netbeans/issues/3774
--
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: notifications-unsubscribe@netbeans.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] matthiasblaesing commented on issue #3774: [NETBEANS‑5838] Support for {@return …} Javadoc tag (JDK‑8075778)
Posted by GitBox <gi...@apache.org>.
matthiasblaesing commented on issue #3774:
URL: https://github.com/apache/netbeans/issues/3774#issuecomment-1066170323
The syntax is wrong (see https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#return or the manpage of the javadoc tool), it is:
```java
/**
* @return something
*/
```
--
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: notifications-unsubscribe@netbeans.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists