Javadoc new tags not yet documented

Alan Bateman Alan.Bateman at
Wed Apr 1 15:59:05 UTC 2015

On 01/04/2015 16:47, Paul Benedict wrote:
> The JDK 8 documentation did not include any documentation on the new tags
> (e.g., @apiNote, @implSpec and @implNote). It's neither here [1] nor there
> [2], but they should be.
> Can anyone look into this for 9 (or even fix 8)? The absence of
> documentation is probably why they haven't seen widespread adoption yet.
There is an informational JEP prepared for this, see:


More information about the core-libs-dev mailing list