[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: NEW ISSUE: Inconsistent use of a and an when referring to annotations
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
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]