You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by hb...@apache.org on 2026/07/27 22:15:42 UTC
(maven) branch requirement-to-jsr330 created (now 43ec8050e4)
This is an automated email from the ASF dual-hosted git repository.
hboutemy pushed a change to branch requirement-to-jsr330
in repository https://gitbox.apache.org/repos/asf/maven.git
at 43ec8050e4 improve doc about deprecating plugin descriptor's requirement
This branch includes the following new commits:
new 43ec8050e4 improve doc about deprecating plugin descriptor's requirement
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
(maven) 01/01: improve doc about deprecating plugin descriptor's requirement
Posted by hb...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
hboutemy pushed a commit to branch requirement-to-jsr330
in repository https://gitbox.apache.org/repos/asf/maven.git
commit 43ec8050e4c37a57e37399a576ed3243731ad37b
Author: Hervé Boutemy <hb...@apache.org>
AuthorDate: Tue Jul 28 00:15:30 2026 +0200
improve doc about deprecating plugin descriptor's requirement
---
maven-plugin-api/src/main/mdo/plugin.mdo | 14 ++++++++++----
1 file changed, 10 insertions(+), 4 deletions(-)
diff --git a/maven-plugin-api/src/main/mdo/plugin.mdo b/maven-plugin-api/src/main/mdo/plugin.mdo
index adc17ef4c5..53faee72eb 100644
--- a/maven-plugin-api/src/main/mdo/plugin.mdo
+++ b/maven-plugin-api/src/main/mdo/plugin.mdo
@@ -339,7 +339,10 @@ under the License.
<field xdoc.separator="blank">
<name>requirements</name>
<version>1.0.0</version>
- <description>Use Maven 4 Dependency Injection (for v4 plugins) or JSR 330 annotations (for v3 plugins) to inject dependencies instead.</description>
+ <description><![CDATA[
+ Deprecated: Component requirements (plugin tools {@code @Component} annotation), that will be injected to Mojo fields.
+ <a href="https://maven.apache.org/maven-jsr330.html">Use JSR 330 annotations</a> to inject components instead, without this descriptor.
+ ]]></description>
<association>
<type>Requirement</type>
<multiplicity>*</multiplicity>
@@ -469,7 +472,10 @@ under the License.
<class xdoc.anchorName="requirement">
<name>Requirement</name>
<version>1.0.0</version>
- <description>Describes a component requirement.</description>
+ <description><![CDATA[
+ Deprecated: Describes a component requirement (plugin tools' {@code @Component} annotation), that will be injected to a Mojo field.
+ <a href="https://maven.apache.org/maven-jsr330.html">Use JSR 330 annotations</a> to inject components instead, without this descriptor.
+ ]]></description>
<!-- see o.a.m.plugin.descriptor.Requirement -->
<fields>
<field>
@@ -477,7 +483,7 @@ under the License.
<required>true</required>
<version>1.0.0</version>
<type>String</type>
- <description></description>
+ <description>Plexus role of the component to inject.</description>
</field>
<field xml.tagName="role-hint">
<name>roleHint</name>
@@ -490,7 +496,7 @@ under the License.
<required>true</required>
<version>1.0.0</version>
<type>String</type>
- <description>The field name which has this requirement.</description>
+ <description>The field name which has this component requirement.</description>
</field>
</fields>
</class>