You need verson 1.9.2 of the maven-xdoc-plugin to get it to generate the
comments (it was introduced in version 1.9.0, but doesn't work in 1.9.1).

Validator uses this feature and it works well:

http://jakarta.apache.org/commons/validator/dependencies.html

Hopefully maven 2 will be better though - it has "scopes" for depenencies
which hopefully it uses to create a better dependency report (I haven't
tried it yet)

http://maven.apache.org/maven2/dependency-mechanism.html#dependency_scope

Niall

----- Original Message ----- 
From: "robert burrell donkin" <[EMAIL PROTECTED]>
> > > (logging uses ant for builds but) i agree that this is a major issue
for
> > > all projects that use maven. JCL uses maven to generate the
> > > documentation which is misleading.
> > >
> > > does anyone know how to add comments for dependencies?
> >
> > For Maven 1 it could be solved by setting properties [1] on the
> > dependency. This would be something local to commons-logging that would
> > not work automatically in other places.
> >
> > [1]
> >
http://maven.apache.org/reference/project-descriptor.html#class_Dependency
>
> thanks :)
>
> helped me to track down what i was looking for:
>
>       <properties>
>         <comment>XXX</comment>
>       </properties>
>
> can be used to add comments which appear in the dependency report.
>
> - robert



---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to