ACE-4744 javadoc and cleanup

git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@119697 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/traitextender/Extend.java

@@ -16,14 +16,28 @@
  * You should have received a copy of the GNU Lesser General Public License
  * along with Alfresco. If not, see http://www.gnu.org/licenses/.
  */
+
 package org.alfresco.traitextender;
 
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 
+/**
+ * A runtime retained annotation that marks AJ-trait-extended methods of
+ * {@link Extensible} objects.<br>
+ * It defines the actual circumstances in which the {@link ExtensionPoint}
+ * defined using {@link #extensionAPI()} and {@link #traitAPI()} has its
+ * extension invoked.<br>
+ * Methods marked by this aspect are advised by an extension-routing around
+ * advice in {@link RouteExtensions}. Consequently the call will be routed to a
+ * method of an extension object having the same signature as the marked method.<br>
+ * 
+ * @author Bogdan Horje
+ */
 @Retention(RetentionPolicy.RUNTIME)
 public @interface Extend
 {
     Class<?> extensionAPI();
+
     Class<? extends Trait> traitAPI();
 }