at the top of your maven.xml you can be sure to nclude this kind of thing (among others)
<project xmlns:ant="jelly:ant" >
below is actually from an ant build.xml target. visit that link at top and look at the maven.javadoc.customtags down in the middle of the page.
the stuff below will work in your maven.xml, there are better ways to do it that are more "maven", but this can help get you started.
Let's assume you have your local repostiory in $MAVEN_HOME_LOCAL (that's linux, for windows it's %MAVEN_HOME_LOCAL%)
Look in $MAVEN_HOME_LOCAL/plugins/maven-javadoc-plugin-1.3 for a file called plugin.jelly
I learned a lot from looking in the plugin.jelly files in the plugins directory, they are in the exact same format as a maven.xml file
<goal name="javadocs">
<ant:javadoc sourcepath="${src.dir}"
destdir="${javadoc.dest.dir}"
packagenames="*"
defaultexcludes="yes"
Private="true"
verbose="no"
group="true"
stylesheetfile="${basedir}/docs/stylesheet.css"
failonerror="false"
Overview="${basedir}/docs/overview.html"><ant:tag name="web.servlet" scope="overview" enabled="false"/>
<ant:tag name="web.listener" enabled="false"/>
<ant:tag name="web.filter" enabled="false"/>
<ant:tag name="hibernate.property" enabled="false"/>
<ant:tag name="hibernate.class" enabled="false"/>
<ant:tag name="hibernate.id" enabled="false"/>
<ant:tag name="todo" scope="all" description="To do:" />
<ant:packageset dir="${java.src.dir}">
</packageset>
<ant:classpath refid="compile.classpath" />
<ant:link href="http://jakarta.apache.org/commons/beanutils/api/"/>
<ant:link href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_2_1/"/>
<ant:link href="http://jakarta.apache.org/commons/logging/api/"/>
<ant:link href="http://jakarta.apache.org/commons/lang/apidocs/"/>
<ant:link href="http://jakarta.apache.org/commons/fileupload/apidocs/"; />
<ant:link href="http://jakarta.apache.org/tomcat/tomcat-4.0-doc/servletapi/"; />
<ant:link href="http://java.sun.com/j2se/1.4.2/docs/api/"/>
<ant:link href="http://www.hibernate.org/hib_docs/api/"/>
<ant:link href="http://www.springframework.org/docs/api/"/>
</ant:javadoc>
</goal>
Miguel Griffa wrote:
Hi,
I'm sorry I'm still quite newbie here, where should I place this? in maven.xml or project.xml?
Kevin Hagel wrote:
here's a section of my build file that javadocs:
<!--
Try to get JavaDoc to shut the hell up about the XDoclet tags.
-->
<tag name="web.servlet" scope="overview" enabled="false"/>
<tag name="web.listener" enabled="false"/>
<tag name="web.filter" enabled="false"/>
<tag name="hibernate.property" enabled="false"/>
<tag name="hibernate.class" enabled="false"/>
<tag name="hibernate.id" enabled="false"/>
<tag name="todo" scope="all" description="To do:" />
the problem is: while @web.servlet will be successfully ignored, @web.servlet-mapping will not, something about the hypen in "servlet-mapping". Javadoc advises using something like @web.servlet.mapping, but that's not really very useful for us is it?
I suspect javadoc was written by C++ programmers ;-)
Miguel Griffa wrote:
Hi all,
This is my first post to the list.
I'm becoming a fan of maven, but I find myself still climbing the learning curve...
Could anyone tellme How can I ignore some tags on maven javadoc report? (I have lots of xdoclet tags)
Thanks in advance
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
