[NEW ISSUE] Normative statement JCA90052 is poorly worded

[Mike Edwards <mike_edwards@uk.ibm.com>]

Raiser:        
               Mike
Edwards

Target:        
               sca-javacaa-1.1-spec-cd03.pdf

Description:

JCA90052 is worded as follows:

The @AllowsPassByReference annotation
MAY be placed on an individual method of a remotable
service implementation, on a service
implementation class, or on an individual reference for a
remotable service. When applied to a
reference, it MAY appear anywhere that the @Remotable
annotation MAY appear. It MUST NOT appear
anywhere else.

The existence of three MAY words followed
by a MUST NOT is at best confusing.  It leads to an assumption
that @AllowsPassByReference is an optional
feature, which is not intended.

This confusing formulation should be
replaced by clearer wording that avoids the impression of optionality.

Proposal:

The @AllowsPassByReference annotation
MUST only annotate the following locations:
- a service implementation class
- an individual method of a remotable
service implementation
- an individual reference which uses
a remotable interface, where the @AllowsPassByReference annotation
can annotate any artifact which can
be annotated by the @Remotable annotation
[JCA90052]


Yours,  Mike.

Strategist - Emerging Technologies, SCA & SDO.
Co Chair OASIS SCA Assembly TC.
IBM Hursley Park, Mail Point 146, Winchester, SO21 2JN, Great Britain.
Phone & FAX: +44-1962-818014    Mobile: +44-7802-467431  
Email:  mike_edwards@uk.ibm.com

---

Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 741598.
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU