ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Erik Hatcher" <jakarta-...@ehatchersolutions.com>
Subject Fw: [Xdoclet-devel] @tags and javadoc 1.4 warnings
Date Tue, 18 Jun 2002 00:12:03 GMT
Here's a message from an XDoclet developer, and there is a comment at the
end (directed to me) regarding the nested <tag> of <javadoc>.....  thoughts?
Is this a bug?


----- Original Message -----
From: "Andrew Stevens" <stevensa@users.sourceforge.net>
To: <xdoclet-devel@lists.sourceforge.net>
Sent: Monday, June 17, 2002 6:34 PM
Subject: [Xdoclet-devel] @tags and javadoc 1.4 warnings


> Something I was wondering about earlier...
>
> The ejb.tags format was added so that javadoc 1.4 can be told to ignore
> our custom tags with the -tag option.  However, we do have quite a lot of
> them so typing them all in by hand is likely to be laborious and error
> prone.  Since they're all described in the xtags, how about somewhere in
> the documentation generating a list of them all suitable for cut & paste
> into the -tag command line argument?
>
> Also, since such a list is likely to exceed the maximum command line
> length on many systems, perhaps we should also/instead generate a file
> containing them on separate -tag lines for including with @argfile (as
> described under "Example of a complete set of tags" at
> http://java.sun.com/j2se/1.4/docs/tooldocs/windows/javadoc.html#tag )?
>
> Lastly, I see that Ant 1.5's javadoc task supports <tag> nested elements;
> it might be a good idea if we generated a list of them all in this format
> too, so that they can be included in Ant scripts with just an entity
> declaration.
>
> By the way, Erik (resident Ant expert), any idea why the description
> attribute of tag nested elements is required? (according to the docs at
> http://jakarta.apache.org/ant/manual/CoreTasks/javadoc.html#tagelement )
> The javadoc docs include examples "-tag param", "-tag example:X", etc.
> which suggests to me it should be optional?
>
>
> Andrew.
>
> --------------------------------------------------------------------------
--
>                    Bringing you mounds of caffeinated joy
>                       >>>     http://thinkgeek.com/sf    <<<
>
> _______________________________________________
> Xdoclet-devel mailing list
> Xdoclet-devel@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/xdoclet-devel
>


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


Mime
View raw message