RFR: 8256917: Use combo @returns tag in java.compiler javadoc

Wed Dec 9 02:34:33 UTC 2020

On Wed, 9 Dec 2020 02:11:45 GMT, Iris Clark <iris at openjdk.org> wrote:

> 
> 
> Straightforward. I see a few minor differences (e.g. "otherwise returns X" -> "otherwise X"), but nothing significant.

Yes; I didn't limit my pass over the API to cases where there was strict duplication, near duplication was fair game too :-) From an offline specdiff, there weren't any unexpected changes and most of the individual code diffs didn't lead to spec diffs.

> Fantastic use of the new @returns tag. I look forward to seeing it used across the JDK.

Kudos to @jonathan-gibbons and the javadoc team for getting this feature in!

-------------

PR: https://git.openjdk.java.net/jdk/pull/1708