RFR: JDK-8075778: Add javadoc tag to avoid duplication of return information in simple situations. [v8]
Pavel Rappo
prappo at openjdk.java.net
Tue Dec 8 22:58:36 UTC 2020
On Tue, 8 Dec 2020 21:10:56 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:
>> This change extends the functionality of the `@return` tag so that it can also be used as an inline tag in the first sentence of a description.
>>
>> The goal is to be able to simplify the following common pattern:
>>
>> /**
>> * Returns the result. Optional additional text.
>> * @return the result
>> */
>> int method() {
>>
>> by
>>
>> /**
>> * {@return the result} Optional additional text.
>> */
>> int method() {
>>
>> Note:
>>
>> * The inline tag may only be used at the beginning of the description. A warning will be given if it is used elsewhere.
>> * The expansion of the inline tag is `Returns " _content_ `.` where _content_ is the content of the tag.
>> * If there is no block `@return` tag, the standard doclet will look for an inline tag at the beginning of the description
>> * The inline tag can be inherited into overriding methods as if it was provided as a block tag.
>
> Jonathan Gibbons has updated the pull request incrementally with one additional commit since the last revision:
>
> address review comments
Thanks for considering my feedback.
-------------
Marked as reviewed by prappo (Reviewer).
PR: https://git.openjdk.java.net/jdk/pull/1355
More information about the compiler-dev
mailing list