Re: maxEntries in contents()

Gregg Wonderly wrote:
>
>
> 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.
>


So I don't know if anyone's tried this, thought about it or has an
opinion but there's JDocs (www.jdocs.com) which allows for user
annotations etc - might that be a help?

Might avoid voting and allow for us to mark things up with useful
comments etc.

Just a thought,

Dan.

===========================================================================
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