Re: maxEntries in contents()

Dan Creswell wrote:
 >John McClain responded:
> So, I'm not sure I'd be pushing for the spec to change - feels like a
> throway, JavaDoc'ish type of thing to me.  Or maybe we need to revisit
> this whole spec and annotation of the spec (I'm thinking the equivalent
> of pencil scribblings in the margin of a book).
>
> And given that I already understood what was there and was comfortable
> with it, I'm not a good candidate for qualifying how "minor" this is :)
>
>> As to the "JavaDoc == spec" question, I don't think I have anything to
>> add. I have done it both ways and there are advantages and disadvantage
>> to both (for writer and reader), someone just needs to tell me if we are
>> switching.

I think we really need to use JavaDoc tags to separate specification from
informative text.  We need a review process that allows everyone to be critical
of what gets added.  But, I don't think that we should have to vote for there to
be new, more informative text added to the javadoc of any class.

Gregg Wonderly

===========================================================================
To unsubscribe, send email to [email protected] and include in the body
of the message "signoff JAVASPACES-USERS".  For general help, send email to
[email protected] and include in the body of the message "help".

To view past JAVASPACES-USERS postings, please see:
http://archives.java.sun.com/archives/javaspaces-users.html