Apache
/
maven
mirror of https://github.com/apache/maven.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

[MNG-7463] Improve documentation about deprecation in Mojo

This commit is contained in:
Slawomir Jaranowski 2022-09-12 22:30:46 +02:00
parent 5502c0c8db
commit 47e2d689d6
2 changed files with 11 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
maven-plugin-api/src/main/java/org/apache/maven/plugin/descriptor/MojoDescriptor.java
View File

@ -88,8 +88,8 @@ public class MojoDescriptor
private String executeLifecycle; private String executeLifecycle;
/** /**
* Specify the version when the Mojo was deprecated to the API. Similar to Javadoc deprecated. This will trigger a * Description with reason of Mojo deprecation. Similar to Javadoc {@code @deprecated}.
* warning when a user tries to configure a parameter marked as deprecated. * This will trigger a warning when a user tries to use a Mojo marked as deprecated.
*/ */
private String deprecated; private String deprecated;
@ -170,7 +170,7 @@ public class MojoDescriptor
} }
/** /**
* @return <code>true</code> if the Mojo is deprecated, <code>false</code> otherwise. * @return Description with reason of a Mojo deprecation.
*/ */
public String getDeprecated() public String getDeprecated()
{ {
@ -178,7 +178,7 @@ public class MojoDescriptor
} }
/** /**
* @param deprecated <code>true</code> to deprecate the Mojo, <code>false</code> otherwise. * @param deprecated Description with reason of a Mojo deprecation.
*/ */
public void setDeprecated( String deprecated ) public void setDeprecated( String deprecated )
{ {

14
maven-plugin-api/src/main/mdo/plugin.mdo
View File

@ -289,10 +289,10 @@ under the License.
<name>deprecated</name> <name>deprecated</name>
<version>1.0.0</version> <version>1.0.0</version>
<type>String</type> <type>String</type>
<description> <description><![CDATA[
Specify the version when the Mojo was deprecated to the API. Similar to Javadoc deprecated. This will Description with the reason of Mojo deprecation. Similar to Javadoc <code>@deprecated</code>
trigger a warning when a user tries to configure a parameter marked as deprecated. This will trigger a warning when a user tries to use a Mojo marked as deprecated.
</description> ]]></description>
</field> </field>
<field> <field>
<name>configurator</name> <name>configurator</name>
@ -422,10 +422,10 @@ under the License.
<name>deprecated</name> <name>deprecated</name>
<version>1.0.0</version> <version>1.0.0</version>
<type>String</type> <type>String</type>
<description> <description><![CDATA[
Specify the version when the parameter was deprecated to the API. Similar to Javadoc deprecated. Description with the reason of parameter deprecation. Similar to Javadoc <code>@deprecated</code>
This will trigger a warning when a user tries to configure a parameter marked as deprecated. This will trigger a warning when a user tries to configure a parameter marked as deprecated.
</description> ]]></description>
</field> </field>
</fields> </fields>
</class> </class>