The implementation of default methods

[Doug Lea]

On 12/14/12 08:06, David Holmes wrote:
> Okay we now have several threads across the public lists debating the issue of
> whether the implementations of default methods that we are adding to the core
> libraries are the required implementation for those default methods or simply an
> implementation.
>
> Can we get a definitive position on this?
>

My vote is to use the form and style I showed for Map;
still at http://gee.cs.oswego.edu/dl/wwwtmp/apis/Map.html

Main idea:

1. A sentence or two of basic spec.
2. "The default implementation is equivalent to ..."
   (note that it must always be possible to say this
   for anything default implementable.)
3. Any constraints on overrides for implementors
4. Other notes, clarifications, examples, advice.
5. params/return/throw specs

-Doug