Using @apiNote and other tags in JDK-specific APIs

Alan Bateman Alan.Bateman at
Thu Jul 17 10:34:18 UTC 2014

On 16/07/2014 21:49, Mike Duigou wrote:
> These tags certainly could be added to the other javadoc bundles. Initially I opted to only add them where essential.
> One bit of weirdness you are probably wondering about--why is every tag named? The reason is that specifying an existing tag with -tag moves it to the end of the ordering. It's necessary to specify the total ordering if you don't want anything to change. The total ordering for tags was derived from the javadoc source code. (It is what it is).
I was wondering about the ordering but I've written a few custom tags in 
the past so I think I know what you mean.

I see your offer of a patch, that would be great. I can workaround it 
easily for now, my mail was mostly to get some background as to why they 
were defined for the Java SE docs only.


More information about the build-dev mailing list