RFR: JDK-8305206: Add @spec tags in java.base/java.* (part 1)

[Alan Bateman]

On Thu, 30 Mar 2023 20:38:13 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

> The initial assumption was "after the @param/@return/@throws group". Overall, as I said in the description for this PR, the block tags are not very consistent about ordering. I was thinking we might want to recommend an overall ordering, but I'm worried it would be too intrusive a change to apply generally. In the description, I suggested an ordering based on the order in `Docs.gmk` which defines the order in which tags appear in the generated output.

Okay, I think it's just a few of the usages that I sampled had author tags left over from early JDK releases and they end up between the spec and see tags. We can fix these things up at another time.

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

PR Comment: https://git.openjdk.org/jdk/pull/13248#issuecomment-1491696054