You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@groovy.apache.org by em...@apache.org on 2022/07/05 18:25:15 UTC
[groovy] 01/02: add `@since` tag
This is an automated email from the ASF dual-hosted git repository.
emilles pushed a commit to branch GROOVY_4_0_X
in repository https://gitbox.apache.org/repos/asf/groovy.git
commit 61ecf78b608696026a4f9e99f55ceee9a6cb4752
Author: Eric Milles <er...@thomsonreuters.com>
AuthorDate: Tue Jul 5 13:22:33 2022 -0500
add `@since` tag
---
src/main/java/groovy/transform/Generated.java | 6 ++++--
src/main/java/groovy/transform/Internal.java | 6 ++++--
src/main/java/groovy/transform/Pure.java | 8 +++++---
3 files changed, 13 insertions(+), 7 deletions(-)
diff --git a/src/main/java/groovy/transform/Generated.java b/src/main/java/groovy/transform/Generated.java
index 98eaf5b0df..218e2b8bf9 100644
--- a/src/main/java/groovy/transform/Generated.java
+++ b/src/main/java/groovy/transform/Generated.java
@@ -24,9 +24,11 @@ import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
- * The Generated annotation is used to mark members that have been generated.
+ * Marks class members that have been generated by the compiler.
+ *
+ * @since 2.5.0
*/
-@Target({ElementType.METHOD, ElementType.CONSTRUCTOR, ElementType.TYPE, ElementType.FIELD})
+@Target({ElementType.CONSTRUCTOR, ElementType.METHOD, ElementType.FIELD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface Generated {
}
diff --git a/src/main/java/groovy/transform/Internal.java b/src/main/java/groovy/transform/Internal.java
index a645f81c8c..8d0e3b6310 100644
--- a/src/main/java/groovy/transform/Internal.java
+++ b/src/main/java/groovy/transform/Internal.java
@@ -24,9 +24,11 @@ import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
- * The Internal annotation is used to mark members that are internal.
+ * Marks class members that are intended for internal use.
+ *
+ * @since 2.5.3
*/
-@Target({ElementType.METHOD, ElementType.CONSTRUCTOR, ElementType.TYPE, ElementType.FIELD})
+@Target({ElementType.CONSTRUCTOR, ElementType.METHOD, ElementType.FIELD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface Internal {
}
diff --git a/src/main/java/groovy/transform/Pure.java b/src/main/java/groovy/transform/Pure.java
index 7827343c42..19c724f034 100644
--- a/src/main/java/groovy/transform/Pure.java
+++ b/src/main/java/groovy/transform/Pure.java
@@ -18,18 +18,20 @@
*/
package groovy.transform;
+import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
- * Mark the return value of "pure" method only comes from expressions involving constants or other pure methods
+ * Marks the return value of "pure" method only comes from expressions involving
+ * constants or other pure methods.
*
* @since 4.0.0
*/
-@java.lang.annotation.Documented
+@Documented
+@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
-@Target({ElementType.METHOD})
public @interface Pure {
}