RE: How to ignore xdoclets tags on javadoc
Kevin Hagel wrote on Wednesday, March 10, 2004 8:25 AM: 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 ;-) Well, before pointing at javadoc, you might consider Jelly g IMHO it tries to evaluate the expression servlet-mapping ;-) Regards, Jörg - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: How to ignore xdoclets tags on javadoc
the example I posted comes from an ant build.xml file, not a maven.xml file, there's no jelly involved. Also, jelly never sees the source file, in this kind of thing jelly never sees the content of source files, it only directs them to javadoc. I've been reading about xjavadoc now being able to read @web.servlet.mapping as @web.servlet-mapping, which helps to get rid of the javadoc bitching about the xdoclet tags. I've tested it, it seems to work ... at least for xdoclet-1.2 Jörg Schaible wrote: Kevin Hagel wrote on Wednesday, March 10, 2004 8:25 AM: 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 ;-) Well, before pointing at javadoc, you might consider Jelly g IMHO it tries to evaluate the expression servlet-mapping ;-) Regards, Jörg - 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]
Re: How to ignore xdoclets tags on javadoc
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] -- Miguel Griffa Software Architect Technisys.NET The First Digital e-nabler Transactional Solutions Miami +1 305 357 8109 Madrid +34 915 726 763 Buenos Aires: +54 11 43227100 [EMAIL PROTECTED] http://www.technisys.net - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: How to ignore xdoclets tags on javadoc
http://maven.apache.org/reference/plugins/javadoc/properties.html
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]
How to ignore xdoclets tags on javadoc
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 -- Miguel Griffa Software Architect Technisys.NET The First Digital e-nabler Transactional Solutions Miami +1 305 357 8109 Madrid +34 915 726 763 Buenos Aires: +54 11 43227100 [EMAIL PROTECTED] http://www.technisys.net - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: How to ignore xdoclets tags on javadoc
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]
