[MPLUGIN-196] rename expression parameter to property

• Type: Wish
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 2.9
• Fix Version/s: 3.0
• Component/s: maven-plugin-annotations, maven-plugin-tools-java, maven-plugin-tools-javadoc
• Assignee: Herve Boutemy
• Reporter: Herve Boutemy
• Created: 13/May/12 14:51
• Updated: 09/Feb/14 14:41
• Resolved: 19/May/12 17:41

Description

the actual name isn't intuitive at all.
It would be more intuitive if we replaced

/**
 * @parameter default-value="a default value" expression="a property"
 */
 String first;

 @Parameter( defaultValue = "a default value", expression = "a property" )
 String second;

with

/**
 * @parameter default-value="a default value" property="a property"
 */
 String first;

 @Parameter( defaultValue = "a default value", property = "a property" )
 String second;

The move could be done in a compatible way, deprecating the previous expression javadoc tag.
And ${ } would be forbidden for property, where it was required previously for expression and made optional since MPLUGIN-194

Issue Links

• is duplicated by: MNG-2063 deprecate expression, add system-property
• is related to: MPLUGIN-259 @Parameter name="xxx" to set bean property name different from class' field
• is related to: MPLUGIN-194 support expression="a property" in addition to expression="${a property}"
• relates to: MNG-2063 deprecate expression, add system-property
• relates to: MPLUGIN-199 remove old undocumented "property" feature of javadoc tags (changing field name)