You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by cs...@apache.org on 2021/10/18 10:35:53 UTC

[maven-plugin-tools] branch master updated: [MPLUGIN-375] deprecate unsupported Mojo descriptor items (#43)

This is an automated email from the ASF dual-hosted git repository.

cstamas pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-plugin-tools.git


The following commit(s) were added to refs/heads/master by this push:
     new f2c4bef  [MPLUGIN-375] deprecate unsupported Mojo descriptor items (#43)
f2c4bef is described below

commit f2c4bef6a881d68ab4bdbeba79301c0feaf178dc
Author: Slawomir Jaranowski <s....@gmail.com>
AuthorDate: Mon Oct 18 12:35:49 2021 +0200

    [MPLUGIN-375] deprecate unsupported Mojo descriptor items (#43)
---
 .../main/java/org/apache/maven/plugins/annotations/Mojo.java   | 10 ++++++++++
 maven-plugin-tools-annotations/src/site/apt/index.apt          |  6 +++---
 maven-plugin-tools-java/src/site/apt/index.apt                 |  6 +++---
 3 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/maven-plugin-annotations/src/main/java/org/apache/maven/plugins/annotations/Mojo.java b/maven-plugin-annotations/src/main/java/org/apache/maven/plugins/annotations/Mojo.java
index ec5fce1..336a522 100644
--- a/maven-plugin-annotations/src/main/java/org/apache/maven/plugins/annotations/Mojo.java
+++ b/maven-plugin-annotations/src/main/java/org/apache/maven/plugins/annotations/Mojo.java
@@ -71,7 +71,10 @@ public @interface Mojo
     /**
      * execution strategy: <code>once-per-session</code> or <code>always</code>.
      * @return <code>once-per-session</code> or <code>always</code>
+     *
+     * @deprecated unused
      */
+    @Deprecated
     String executionStrategy() default "once-per-session";
 
     /**
@@ -98,7 +101,10 @@ public @interface Mojo
     /**
      * can this Mojo be invoked directly only?
      * @return invoked directly only
+     *
+     * @deprecated unused
      */
+    @Deprecated
     boolean requiresDirectInvocation() default false;
 
     /**
@@ -107,6 +113,10 @@ public @interface Mojo
      */
     boolean requiresOnline() default false;
 
+    /**
+     * @deprecated unused
+     */
+    @Deprecated
     boolean inheritByDefault() default true;
 
     /**
diff --git a/maven-plugin-tools-annotations/src/site/apt/index.apt b/maven-plugin-tools-annotations/src/site/apt/index.apt
index 29f46e7..7ffc3ba 100644
--- a/maven-plugin-tools-annotations/src/site/apt/index.apt
+++ b/maven-plugin-tools-annotations/src/site/apt/index.apt
@@ -58,13 +58,13 @@ import org.apache.maven.settings.Settings;
 @Mojo( name = "<goal-name>",
        aggregator = <false|true>, 
        configurator = "<role hint>",
-       executionStrategy = "<once-per-session|always>",
-       inheritByDefault = <true|false>,
+       executionStrategy = "<once-per-session|always>", // (unsupported since Maven 3.0)
+       inheritByDefault = <true|false>, // (unsupported since Maven 3.0)
        instantiationStrategy = InstantiationStrategy.<strategy>,
        defaultPhase = LifecyclePhase.<phase>,
        requiresDependencyResolution = ResolutionScope.<scope>,
        requiresDependencyCollection = ResolutionScope.<scope>, // (since Maven 3.0)
-       requiresDirectInvocation = <false|true>,
+       requiresDirectInvocation = <false|true>, // (unsupported since Maven 3.0)
        requiresOnline = <false|true>,
        requiresProject = <true|false>,
        requiresReports = <false|true>, // (unsupported since Maven 3.0)
diff --git a/maven-plugin-tools-java/src/site/apt/index.apt b/maven-plugin-tools-java/src/site/apt/index.apt
index ca520c4..dac64e1 100644
--- a/maven-plugin-tools-java/src/site/apt/index.apt
+++ b/maven-plugin-tools-java/src/site/apt/index.apt
@@ -50,13 +50,13 @@ import org.apache.maven.settings.Settings;
  * @aggregator
  * @configurator <roleHint>
  * @execute phase="<phaseName>" lifecycle="<lifecycleId>" goal="<goalName>"
- * @executionStrategy <once-per-session|always>
- * @inheritByDefault <true|false>
+ * @executionStrategy <once-per-session|always> (unsupported since Maven 3.0)
+ * @inheritByDefault <true|false> (unsupported since Maven 3.0)
  * @instantiationStrategy <per-lookup|singleton|keep-alive|poolable>
  * @phase <phaseName>
  * @requiresDependencyResolution <compile|runtime|compile+runtime|test>
  * @requiresDependencyCollection <compile|runtime|compile+runtime|test> (since Maven 3.0)
- * @requiresDirectInvocation <false|true>
+ * @requiresDirectInvocation <false|true> (unsupported since Maven 3.0)
  * @requiresOnline <false|true>
  * @requiresProject <true|false>
  * @requiresReports <false|true> (unsupported since Maven 3.0)