← Prev in month ← Prev in thread
Next in thread → Next in month →

Inconsistent use of a and an when referring to annotations in the document

From
C Vamsi <>
Date
2008-08-18T13:35:56+00:00
ID
Thread
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
← Prev in month ← Prev in thread
Next in thread → Next in month →