ant-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Sonnek, Ryan" <Ryan.Son...@bpc.com>
Subject RE: Avoiding Ejb/Jboss tag-warnings using the ant <javadoc> task
Date Fri, 17 Jan 2003 16:19:35 GMT
for each of you <tag> elements, use the enabled flag and set it to false.  i
can't figure out how to remove several tags of the same type (@ejb.bean,
@ejb.pk) without having an individual <tag> for each one.  it'd be great if
you could use a wildcard of some sort.  please let me know if anyone out
there knows out to do this.

current way:
    <javadoc
     packagenames="com.bpc.*"
     destdir="${project.doc.api}"
     private="true"
     author="true"
     version="true"
     use="true"
     windowtitle="${project.description} API Documentation"
     stylesheetfile="${project.web}/style1.css">
      <fileset dir="${project.src}">
        <include name="**/*.java" />
      </fileset>
      <fileset dir="${project.src-gen}">
        <include name="**/*.java" />
      </fileset>
      <tag name="ejb.bean" description="used from xdoclet task"
enabled="false" />
      <tag name="ejb.pk" description="used from xdoclet task"
enabled="false" />
      <tag name="ejb.pk-field" description="used from xdoclet task"
enabled="false" />
      <tag name="ejb.persistent-field" description="used from xdoclet task"
enabled="false" />
      <tag name="ejb.interface-method" description="used from xdoclet task"
enabled="false" />
      <tag name="web" description="used from xdoclet task" enabled="false"
/>
      <tag name="todo" description="used from xdoclet task" enabled="false"
/>
      <doctitle><![CDATA[<h1>${project.description}</h1>]]></doctitle>
      <bottom><![CDATA[<i>Copyright &#169; 2000 Brown Printing Company
All
Rights Reserved.</i>]]></bottom>
      <classpath refid="project.class.path" />
    </javadoc>

nice to have:
    <javadoc
     packagenames="com.bpc.*"
     destdir="${project.doc.api}"
     private="true"
     author="true"
     version="true"
     use="true"
     windowtitle="${project.description} API Documentation"
     stylesheetfile="${project.web}/style1.css">
      <fileset dir="${project.src}">
        <include name="**/*.java" />
      </fileset>
      <fileset dir="${project.src-gen}">
        <include name="**/*.java" />
      </fileset>
      <tag name="jboss.*" description="used from xdoclet task"
enabled="false" />
      <tag name="ejb.*" description="used from xdoclet task" enabled="false"
/>
      <tag name="web.*" description="used from xdoclet task" enabled="false"
/>
      <tag name="jsp.*" description="used from xdoclet task" enabled="false"
/>
      <tag name="todo" description="used from xdoclet task" enabled="false"
/>
      <classpath refid="project.class.path" />
    </javadoc>

-----Original Message-----
From: Dominique Devienne [mailto:DDevienne@lgc.com]
Sent: Friday, January 17, 2003 10:05 AM
To: 'Ant Users List'
Subject: RE: Avoiding Ejb/Jboss tag-warnings using the ant <javadoc>
task


Could it be because they're not listed as tags??? ;-) --DD

-----Original Message-----
From: Jacob Rousseau [mailto:jacob.rousseau@virgil.nl] 
Sent: Friday, January 17, 2003 9:55 AM
To: Ant Users List
Subject: Avoiding Ejb/Jboss tag-warnings using the ant <javadoc> task

	Hallo everyone,	

	 We have a problem avoiding Javadoc warnings on EJB and JBoss tags
using 
the Ant-javadoc task (we are using Ant 1.5.1).
  The ant xml-code looks like this:
  -- snip --
	<target name="javadoc" >
		<javadoc
			sourcepath="${base}/src"
			destdir="${base}/docs/api"
			packagenames="nl.virgil.yards.*"
			classpathref="yards.classpath"
			access="private">
			<tag name="jboss" scope="all" description=" "/>
			<tag name="ejb:home" scope="all" description=" "/>
			<tag name="ejb:bean" scope="all" description=" "/>
             		<tag name="ejb:interface-method" scope="all"
description=" "/>

		</javadoc>
		<delete dir="${build}/docs/api/yards" quiet="true"/>
		<copy todir="${build}/docs/api/yards">
			<fileset dir="${base}/docs/api"/>
		</copy>
	</target>
Javadoc still gives warnings. For example :
----------

warning - @ejb:interface -method is an unknown tag.
warning - @ejb:persistent-field is an unknown tag.

----------


Could someone please give us a hint what we don't do correctly,

	TIA, Jacob Rousseau



--
To unsubscribe, e-mail:   <mailto:ant-user-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:ant-user-help@jakarta.apache.org>

--
To unsubscribe, e-mail:   <mailto:ant-user-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:ant-user-help@jakarta.apache.org>

--
To unsubscribe, e-mail:   <mailto:ant-user-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:ant-user-help@jakarta.apache.org>


Mime
View raw message