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

[JIRA]

Title: Message Title

Lennart Jörelid commented on an issue   Re: Mojo params have incorrectly stated 'since' values So .. a bit more practical here. We need to move forwards; there are users who really need the functionality in the 2+ versions of j-m-p and it is yet to be released, due to these discussions. All of the classes in the j-m-p are new @since the 2.0 release. With the exception of the `NoSchemasException` class, nothing is kept. None of the current parameters existed in their present form in the version 1.x releases. A few parameters use the same name as in the 1.x releases since there was no need to change the names. All parameter documentation was redone in the 2.0 release. In most cases the earlier parameter documentation was either not present or unclear about how the parameter related to the underlying tool's options. All examples are redone in the plugin documentation for version 2+. The examples now illustrate usage of the j-m-p version 2+ and are not backwards compatible with the 1.x releases. (Parameters are changed; new parameters have arrived; things are done differently in the 2.0 release). I can remove the @since annotation from the class if it makes you happy, and document the "this is a completely new implementation since version 2.0" in the mojo JavaDoc instead. This implies that users will see the documentation in the description corresponding to http://mojo.codehaus.org/jaxb2-maven-plugin/schemagen-mojo.html, but not in the "attributes list". Is that a better approach in your view? It is certainly a worse approach in my view; I want to highlight the fact that this is a new implementation since version 2.0 and that people should test it out carefully. 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