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: Inconsistent use of a and an when referring to annotations in the document



REF: sca-javacaa-1.1-spec-WD04.doc
This can be considered as an editorial change (if at all).  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.

What is the general practice?

1. Should it always be 'an' since there is an 'at' symbol?

2. Should the @ symbol be ignored always in deciding on the article?
Example:
A @Reference to a conversational service is injected  --- will be read as,
"a reference to a conversational service ..."
A @Service annotation with no attributes ...  --- will be read as, "a
service annotation with no attributes ..."
An @Init annotation on a method ... --- will be read as, "an init
annotation ... "
A @OneWay annotation on a method ... ---- will be read as, "a oneway
annotation on a method ..."

3. Should it be 'an' when referrring to the annotation with the word
'annotation' following the annotation itself and other times the @ is
ignored.
Example:
A @Reference to a conversational service is injected  --- will be read as,
"a reference to a conversational service ..."
An @Reference annotation on a field ...  --- will be read as, "an at
reference annotation on a field ..."
An @Service annotation with no attributes ...  --- will be read as, "an at
service annotation with no attributes ..."
An @Init annotation on a method ...  --- will be read as, "an at init
annotation ... "
An @OneWay annotation on a method ...  ---- will be read as, "an at oneway
annotation on a method ..."

You get the idea what I am talking about.

++Vamsi



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