[mojo-dev] [jira] (MJAXB-129) Mojo params have incorrectly stated 'since' values

[Anders Hammar (JIRA)]

Title: Message Title

Anders Hammar commented on an issue   Re: Mojo params have incorrectly stated 'since' values I see we're viewing this from two different perspective. You from a javadoc perspective and I from a mojo doc perspective. The m-plugin-p uses the (javadoc) since tag to produce the mojo docs. From a javadoc perspective I agree with you, but from a mojo doc perspective I don't. In this case it might be unfortunate that the m-plugin-p tool uses the javadoc since tags, but IMO we need to take that into account. It will confuse the mojo end users, as they don't care about the impl. I argue that any mojo in v2.x with the same name as in v1.x should do the same thing. Also, any param with the same name in v2.x and v1.x should be backwards compatible. If it isn't, it should be renamed. So, stating since 2.0 (from a mojo docs perspective) for any param, as well as mojo, that already existed in v1.x is not correct as I firmly believe that the people that are going to view the code/javadoc is far fewer than the people that are going to view the mojo docs. Add Comment   Mojo's JAXB-2 Maven Plugin / MJAXB-129 Mojo params have incorrectly stated 'since' values On most of the params for the mojos, it is stated since "2.0" which is not correct. To simplify for users migrating to this new major version it would be good do clearly indicate which params are new and which existed in v1.x. Even the mojos themselves are stated as since 2.0 which is wrong. This message was sent by Atlassian JIRA (v6.1.6#6162-sha1:7af547c) --------------------------------------------------------------------- To unsubscribe from this list, please visit: http://xircles.codehaus.org/manage_email