jdk9-dev Digest, Vol 16, Issue 1

[Stuart Marks]

Thanks. It's probably possible to trim it down somewhat, but I think a bit of 
historical perspective is necessary. Anyone who has written javadoc in the past 
and who has attempted to use @inheritDoc would probably appreciate knowing about 
the change in behavior.

I'm going to edit it a bit more and then mark it Submitted.

s'marks

On 2/3/15 10:11 AM, Mike Duigou wrote:
> Looks really good to me. Some of the details about {@inheritDoc} improvements
> could probably be omitted as they are mostly historical.
>
> Mike
>
> On 2015-02-03 08:54, jdk9-dev-request at openjdk.java.net wrote:
>> Date: Tue, 27 Jan 2015 17:01:13 -0800
>> From: Stuart Marks <stuart.marks at oracle.com>
>> To: "jdk9-dev at openjdk.java.net" <jdk9-dev at openjdk.java.net>
>> Subject: please review draft, informational JEP to cover @apiNote,
>>     @implSpec,     @implNote javadoc tags
>> Message-ID: <54C834D9.8090500 at oracle.com>
>> Content-Type: text/plain; charset=utf-8; format=flowed
>>
>> Hi all,
>>
>> Please review the following draft JEP:
>>
>>      https://bugs.openjdk.java.net/browse/JDK-8068562
>>
>> This is an informational JEP that's intended to document the new javadoc custom
>> tags that were introduced in JDK 8. Many of you noticed that these
>> tags appeared
>> in the javadoc for JDK 8 and have asked about what they mean and where they're
>> defined. That's what this JEP is intended to do.
>>
>> s'marks
>