JavaDoc for default methods (Was: Re: Request for Review : CR#8004015 : Add interface extends and defaults for basic functional interfaces)

[Louis Tribble]

On Nov 28, 2012, at 11:36 PM, Kevin Bourrillion wrote:

> 
> Side note: it would be nice if whatever javadoc taglet we use would be
> usable for regular class methods as well, where it would mean "don't
> inheritDoc from me."  We've had a constant problem with extending things
> like AbstractSet and having "This implementation..." javadoc get copied
> into our own classes' docs, where it becomes simply false.

Using something like "The {@link AbstractSet} implementation..." works better after replication to a subclass, but it would great if javadoc could explicitly support the specification/implementation distinction.

Louis
> 
> 
> -- 
> Kevin Bourrillion | Java Librarian | Google, Inc. | kevinb at google.com
>