[oss-changes] [ opensubsystems-Feature Requests-1145839 ] Fix javadoc warnings occured during build process

[SourceForge.net <no...@so...>]

Feature Requests item #1145839, was opened at 2005-02-21 17:13
Message generated for change (Comment added) made by bastafidli
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=659216&aid=1145839&group_id=111437

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: Build Process
Group: Short term
>Status: Closed
>Resolution: Fixed
Priority: 5
Private: No
Submitted By: Julian Legeny (jlegeny)
Assigned to: Miro Halas (bastafidli)
Summary: Fix javadoc warnings occured during build process

Initial Comment:
While building application [target - build all] there
are lots of javadoc warnings that have to be fixed. 

----------------------------------------------------------------------

>Comment By: Miro Halas (bastafidli)
Date: 2007-04-25 15:13

Message:
Logged In: YES 
user_id=166079
Originator: NO

The bellow mentioned problem seems to be problem with JDK, since it only
occurs with JDK 1.4 but it doesn't occur with JDK 1.5, when only an
information note is printed. I am therefore closing this bug.



----------------------------------------------------------------------

Comment By: Julian Legeny (jlegeny)
Date: 2005-02-21 17:22

Message:
Logged In: YES 
user_id=1072486

Problem how to mute: "warning - @ABC-XYZ is an unknown tag"
================================================

   We are using Java 1.4.2, XDoclet 1.2.2 and Ant 1.6.2.

   When I put the ejbdoclet tags in java source file for our
bean and then run javadoc through Ant I get the following
warnings:

warning - @ejb.interface-method is an unknown tag.
warning - @ejb.ejb-ref is an unknown tag.
warning - @jonas.ejb-ref is an unknown tag.
warning - @jboss.ejb-ref-jndi is an unknown tag.
warning - @weblogic.ejb-reference-description is an unknown tag.

   I have defined following tags (bellow) for mute all
xdoclet tag warnings, but it seems all tags containing minus
(-) char within
the name are problematic and warnings occured in spite of that.
   
<tag name="ejb.bean" scope="all" description="XDoclet tag:" />
<tag name="ejb.home" scope="all" description="XDoclet tag:" />
<tag name="ejb.interface" scope="all" description="XDoclet
tag:" />
<tag name="ejb.interface-method" scope="all"
description="XDoclet tag:" />
<tag name="ejb.ejb-ref" scope="all" description="XDoclet
tag:" />
<tag name="ejb.transaction" scope="all" description="XDoclet
tag:" />
<tag name="jonas.bean" scope="all" description="XDoclet tag:" />
<tag name="jonas.ejb-ref" scope="all" description="XDoclet
tag:" />
<tag name="jboss.ejb-ref-jndi" scope="all"
description="XDoclet tag:" />
<tag name="weblogic.ejb-reference-description" scope="all"
description="XDoclet tag:" />

   Warnings don't show for tags without minus (-) char in
the tag name (for example for ejb.bean, ejb.home, etc.)


   I have posted this problem to mailing lists at following
addresses:

XDoclet Mailing List
================
http://www.mail-archive.com/xdoclet-user%40lists.sourceforge.net/msg10106.html

JavaDoc Mailing List
=================
http://forum.java.sun.com/thread.jspa?threadID=599069

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=659216&aid=1145839&group_id=111437