Lates OASIS files for the annottaions, no changes just formating and javadoc

git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@931880 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 15 insertions, 12 deletions

diff --git a/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/annotation/Scope.java b/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/annotation/Scope.java
index 8f9a13430e..087f589168 100644
--- a/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/annotation/Scope.java
+++ b/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/annotation/Scope.java
@@ -1,31 +1,34 @@
 /*
- * Copyright(C) OASIS(R) 2005,2009. All Rights Reserved.
+ * Copyright(C) OASIS(R) 2005,2010. All Rights Reserved.
  * OASIS trademark, IPR and other policies apply.
  */
 package org.oasisopen.sca.annotation;
 
 import static java.lang.annotation.ElementType.TYPE;
 import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
 /**
- * Annotation used to indicate a scoped service.
- * <p/>
- * The spec refers to but does not describe an eager() attribute; this is an error in the draft.
- *
- * @version $Rev$ $Date$
+ * The @Scope annotation MUST only be used on a service's implementation
+ * class. It is an error to use this annotation on an interface.
  */
 @Target(TYPE)
 @Retention(RUNTIME)
 public @interface Scope {
+
     /**
-     * The name of the scope. Values currently defined by the specification are:
-     * <ul>
-     * <li>STATELESS (default)</li>
-     * <li>COMPOSITE</li>
-     * </ul>
+     * The name of the scope.
+     *
+     * For 'STATELESS' implementations, a different implementation
+     * instance can be used to service each request. Implementation
+     * instances can be newly created or be drawn from a pool of instances.
+     *
+     * SCA defines the following scope names, but others can be defined
+     * by particular Java-based implementation types:
+     *  STATELESS
+     *  COMPOSITE
+     * The default value is STATELESS.
      *
      * @return the name of the scope
      */