Need to document how to get correct classpaths for ant mojo plugins
-------------------------------------------------------------------
Key: MNGSITE-138
URL: http://jira.codehaus.org/browse/MNGSITE-138
Project: Maven Project Web Site
Issue Type: Bug
Reporter: Kenneth Flynn
Priority: Critical
The documentation here:
http://maven.apache.org/guides/plugin/guide-ant-plugin-development.html
is really good for getting you started a couple of exceptions. Some of the
configuration options in *.mojos.xml are not fully listed, including the
<requiresDependencyResolution> parameter, needed to get classpaths correct
inside of the ant script. If you fail to set that, you get very strange
classpaths (just the target/classes directory) with no other sign of error. If
you're familiar with Java Mojo development, I suspect this is obvious, but as a
developer coming to this and trying to convert a giant chunk of antrun code
into a plugin to achieve reuse, I had to find information on this in a
completely different place (the Java mojo stuff), which took me quite a bit of
time.
I'd recommend adding a brief section on this parameter, with the table of what
is in scope copied from the Java mojo section, or at least put a link to that
saying "go read this first."
There is no documentation on this issue re: ant mojos anywhere that I can find,
including stackoverflow, etc.
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira