db-jdo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Craig L Russell <Craig.Russ...@Sun.COM>
Subject Re: JDO 2.1 spec draft: @Indexes vs @Indices
Date Mon, 13 Aug 2007 15:54:29 GMT
If there are no other comments in the next day, I'll remove the  
@Indexes annotation.

Craig

On Aug 13, 2007, at 8:33 AM, David Ezzio wrote:

>
>
> cbeams wrote:
>> I can imagine other users doing just what I did: sitting in Eclipse,
>> typing @Ind and then autocompleting, seeing the two options and
>> wondering "what's the difference?"  He heads over to the JPOX
>> annotations page only to find that they are the same, one
>> interchangeable for the other.  The user scratches his head for a
>> moment, asking himself, "which one do I like better?", "am an  
>> 'Indexes'
>> kind of guy, or an 'Indices' man?"  Perhaps he checks the dictionary,
>> like yours truly, to determine proper usage.  He determines  
>> 'Indices' is
>> clearly superior, and moves on.
>>
>> Meanwhile, down the hall, his fellow programmer engages in the same
>> exercise, ultimately deciding that 'Indexes' is the way to go.
>>
>> They've both spent some pretty unproductive time and worse, the
>> application does the same thing in different ways, all in the name of
>> accommodating users' personal spelling preferences.
>>
>> I suggest that the spec ought to be... specific on such matters.
>>
>> At any rate, its hardly the end of the world if these both stick  
>> around,
>> but I brought it up so it's at least a conscious decision for the
>> group.  My vote is that we choose one, thus reducing the number of
>> things users have to learn and understand.
>
> +1
>
> If you go on the assumption that any developer can give only so much
> time to learn a new interface, then the value of easy to learn,
> understand, remember, and correctly guesstimate is huge.
>
>>
>> Thanks!
>>
>> - Chris
>>
>> On Aug 5, 2007, at 9:33 AM, Craig L Russell wrote:
>>
>>> Hi Chris,
>>>
>>> Where would the confusion be in having both?
>>>
>>> Craig
>>>
>>> On Aug 5, 2007, at 4:32 AM, cbeams wrote:
>>>
>>>> 19.20 specifies @Indexes
>>>> 19.21 specifies @Indices
>>>>
>>>> They appear to be identical in intent, serving as containers when
>>>> more than @Index annotation is required.  JPOX treats them as the
>>>> same annotation, differing only in name.
>>>>
>>>> It seems redundant and potentially confusing to include both of
>>>> these; I suggest we choose one.
>>>>
>>>> While the dictionary (New Oxford American) treats both 'indexes'  
>>>> and
>>>> 'indices' as valid plural forms of 'index', it notes that 'indices'
>>>> is favored "especially in technical contexts".  Perhaps we can let
>>>> that be the deciding vote?
>>>>
>>>> - Chris Beams
>>>
>>> Craig Russell
>>> Architect, Sun Java Enterprise System http://java.sun.com/ 
>>> products/jdo
>>> 408 276-5638 mailto:Craig.Russell@sun.com
>>> P.S. A good JDO? O, Gasp!
>>>
>>
>>
>
>
> Notice:  This email message, together with any attachments, may  
> contain information  of  BEA Systems,  Inc.,  its subsidiaries   
> and  affiliated entities,  that may be confidential,  proprietary,   
> copyrighted  and/or legally privileged, and is intended solely for  
> the use of the individual or entity named in this message. If you  
> are not the intended recipient, and have received this message in  
> error, please immediately return this by email and then delete it.

Craig Russell
Architect, Sun Java Enterprise System http://java.sun.com/products/jdo
408 276-5638 mailto:Craig.Russell@sun.com
P.S. A good JDO? O, Gasp!


Mime
View raw message