Re: Javadoc for default methods of an interface

2014-02-06 Thread Behrooz N
Thanks for your examples and explanations. On Thu, Feb 6, 2014 at 12:42 AM, Mike Duigou wrote: > The new tags are used in JDK docs but aren't standard javadoc tags. It's > necessary to use the -tag option to define them so that javadoc tool will > recognize then in source outside the JDK. > > >

Re: Javadoc for default methods of an interface

2014-02-05 Thread Mike Duigou
The new tags are used in JDK docs but aren't standard javadoc tags. It's necessary to use the -tag option to define them so that javadoc tool will recognize then in source outside the JDK. On 2014-02-05, at 11:42, Brian Goetz wrote: > There are some new javadoc tags to let you separate norm

Re: Javadoc for default methods of an interface

2014-02-05 Thread Brian Goetz
There are some new javadoc tags to let you separate normative from non-normative, and how it applies separately to the interface vs the default implementation. They are: @implSpec -- *specification* about what the default implementation does, such as "the default implementation throws UOE".

Javadoc for default methods of an interface

2014-02-05 Thread Behrooz N
Hi, I was wondering if there is a way to specify the "default" value returned by a defender method of an interface that would be processed specifically by javadoc of Java 8? And, how fair this expectation is or what is the argument not to have it? Thanks in advance, Behrooz