On Thu, 3 Dec 2020 21:19:38 GMT, Joe Darcy wrote:
>> There is lots of other duplication/repetition in most javadoc. I'd rather
>> see some kind of text macro that would allow a single definition of a string
>> that can be repeated. The source would be a bit less readable, but it would
>> be l
On Fri, 27 Nov 2020 16:33:27 GMT, Roger Riggs wrote:
>
>
> ```
> /**
> * {@return the result} Optional additional text.
> */
> ```
>
> The java source looks a bit odd/unusual because the "first sentence" does not
> appear to end with a period.
> Though it seems like a convenience to inclu
On Wed, 2 Dec 2020 15:39:56 GMT, Roger Riggs wrote:
>
>
> There is lots of other duplication/repetition in most javadoc. I'd rather see
> some kind of text macro that would allow a single definition of a string that
> can be repeated. The source would be a bit less readable, but it would be
> 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
