[jboss-cvs] JBossAS SVN: r61112 - projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation.

[jboss-cvs-commits at lists.jboss.org]

Author: flavia.rainone at jboss.com
Date: 2007-03-05 19:10:50 -0500 (Mon, 05 Mar 2007)
New Revision: 61112

Removed:
   projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Callee.java
Modified:
   projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Arg.java
   projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Caller.java
   projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Target.java
   projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Thrown.java
Log:
[JBAOP-37] Completed the first version of javadocs and removed Callee.

Modified: projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Arg.java
===================================================================
--- projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Arg.java	2007-03-05 23:54:28 UTC (rev 61111)
+++ projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Arg.java	2007-03-06 00:10:50 UTC (rev 61112)
@@ -38,7 +38,8 @@
    /**
     * Indicates which joinpoint argument this advice parameter refers to.
     * When this value is not set, JBoss AOP will select the first joinpoint
-    * argument of the same type.
+    * argument of the same type (or, if there is not such argument, the first
+    * joinpoint argument of an assignable type to the advice parameter).
     */
    int index() default -1;
 }
\ No newline at end of file

Deleted: projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Callee.java
===================================================================
--- projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Callee.java	2007-03-05 23:54:28 UTC (rev 61111)
+++ projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Callee.java	2007-03-06 00:10:50 UTC (rev 61112)
@@ -1,37 +0,0 @@
-/*
-  * JBoss, Home of Professional Open Source
-  * Copyright 2005, JBoss Inc., and individual contributors as indicated
-  * by the @authors tag. See the copyright.txt in the distribution for a
-  * full listing of individual contributors.
-  *
-  * This is free software; you can redistribute it and/or modify it
-  * under the terms of the GNU Lesser General Public License as
-  * published by the Free Software Foundation; either version 2.1 of
-  * the License, or (at your option) any later version.
-  *
-  * This software is distributed in the hope that it will be useful,
-  * but WITHOUT ANY WARRANTY; without even the implied warranty of
-  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-  * Lesser General Public License for more details.
-  *
-  * You should have received a copy of the GNU Lesser General Public
-  * License along with this software; if not, write to the Free
-  * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
-  * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
-  */
-
-package org.jboss.aop.advice.annotation;
-
-
-import java.lang.annotation.ElementType;
-import java.lang.annotation.Retention;
-import java.lang.annotation.RetentionPolicy;
-import java.lang.annotation.Target;
-
-/**
- * 
- * 
- * @author Flavia Rainone
- */
- at Target (ElementType.PARAMETER) @Retention (RetentionPolicy.RUNTIME)
-public @interface Callee {}
\ No newline at end of file

Modified: projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Caller.java
===================================================================
--- projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Caller.java	2007-03-05 23:54:28 UTC (rev 61111)
+++ projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Caller.java	2007-03-06 00:10:50 UTC (rev 61112)
@@ -28,6 +28,8 @@
 
 
 /**
+ * Annotated with <code>@Caller</code> the advice parameter that receives the caller
+ * object on call joinpoints.
  * 
  * @author Flavia Rainone
  */

Modified: projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Target.java
===================================================================
--- projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Target.java	2007-03-05 23:54:28 UTC (rev 61111)
+++ projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Target.java	2007-03-06 00:10:50 UTC (rev 61112)
@@ -26,7 +26,9 @@
 import java.lang.annotation.RetentionPolicy;
 
 /**
- *
+ * Annotate with <code>@Target</code> the advice parameter that receives the
+ * target of the joinpoint.
+ * 
  * @author Flavia Rainone
  */
 @java.lang.annotation.Target( { ElementType.PARAMETER }) @Retention(RetentionPolicy.RUNTIME)

Modified: projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Thrown.java
===================================================================
--- projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Thrown.java	2007-03-05 23:54:28 UTC (rev 61111)
+++ projects/aop/trunk/aop/src/main/org/jboss/aop/advice/annotation/Thrown.java	2007-03-06 00:10:50 UTC (rev 61112)
@@ -27,8 +27,8 @@
 import java.lang.annotation.Target;
 
 /**
- * Annotate with <code>@Thrown</code> the <i>throwing</i> advice parameter that receives
- * the thrown exception.
+ * Annotate with <code>@Thrown</code> the <i>throwing</i> advice parameter that
+ * receives the thrown exception.
  * 
  * @author Flavia Rainone
  */