Re: RFR: JDK-8075778: Add javadoc tag to avoid duplication of return information in simple situations. [v3]

2020-11-20 Thread Jonathan Gibbons
> 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. > * @re

Re: RFR: JDK-8075778: Add javadoc tag to avoid duplication of return information in simple situations. [v2]

2020-11-20 Thread Jonathan Gibbons
> 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. > * @re

RFR: JDK-8075778: Add javadoc tag to avoid duplication of return information in simple situations.

2020-11-20 Thread Jonathan Gibbons
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