OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

sca-j message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: ISSUE-82 Inconsistent use of a and an when referring to annotations


http://www.osoa.org/jira/browse/JAVA-82



REF: sca-javacaa-1.1-spec-WD04.doc

I am noticing that in the document the use of a and an with annotations is
not
consistent. For e.g.,

Line 342: A @Reference to a conversational service is injected
Line 437: interfaces declare a @ConversationAttributes annotation, ...
Line 1437: The presence of a @Reference annotation is reflected ...
Line 1683: A @Service annotation with no attributes is meaningless ...
Line 1709-1710: a @WebService annotation on the class ...

Line 96-97: ... an @Reference annotation.
Line 255-256: ... an @OneWay annotation.
Line 263-264: ... an @Conversational annotation.

See [1] for original e-mail posted to the mailing list.

PROPOSAL:
Make the usage of a and an consistent when referring to annotations by
treating "@" as silent when used with annotation such that normal english
usage prevails. The following examples illustrate this proposal:
1. a @Reference annotation -- read as, "a reference annotation"
2. a @Conversational annotation -- read as, "a conversational annotation"
3. an @EagerInit annotation -- read as, "an eager-init annotation"
4. a @OneWay annotation -- read as, "a one-way annotation"


[1]
http://lists.oasis-open.org/archives/sca-j/200808/msg00080.html


Dave Booz
STSM, BPM and SCA Architecture
Co-Chair OASIS SCA-Policy TC and SCA-J TC
"Distributed objects first, then world hunger"
Poughkeepsie, NY (845)-435-6093 or 8-295-6093
e-mail:booz@us.ibm.com



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]