ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Peter Donald <pe...@apache.org>
Subject Re: cvs commit: jakarta-ant/src/main/org/apache/tools/ant/taskdefs/optional EchoProperties.java IContract.java NetRexxC.java PropertyFile.java RenameExtensions.java
Date Mon, 25 Feb 2002 19:52:31 GMT
On Tue, 26 Feb 2002 03:17, Erik Hatcher wrote:
> Well, the issue also becomes the use of XDoclet.  Is there a way to turn
> off warnings of unrecognized tags?
>
> I want XDoclet to start building our task documentation.  I have made a
> prototype that I will commit to the proposal area (hopefully later this
> week).  I want tags like this:

yaya!!!
>
> Exit.java:
>     @ant:task name="fail"  category="control"
>
> That way we can categorize tasks, and also code generate our
> defaults.properties, etc.
>
> I've actually already modified my local version of some tasks to have these
> tags for my prototype.
>
> How can we have both no javadoc warnings and use XDoclet?  I feel warnings
> are better than no XDoclet though!  :)
>
>     Erik
>
>
>
> ----- Original Message -----
> From: "Jon Skeet" <jon.skeet@peramon.com>
> To: "Ant Developers List" <ant-dev@jakarta.apache.org>
> Sent: Monday, February 25, 2002 10:59 AM
> Subject: RE: cvs commit:
> jakarta-ant/src/main/org/apache/tools/ant/taskdefs/optional
> EchoProperties.java IContract.java NetRexxC.java PropertyFile.java
> RenameExtensions.java
>
> > >   +         * To-do: make sure the 'unit' attribute is only
> >
> > specified on
> > date
> >
> > *arg*... we can't have @todo tags?!  :((
>
> Not if we want JavaDoc to build without warnings...
>
> > XDoclet makes generating a nice to-do list very easy.  Can't
> > we keep them in?
>
> Hmm... I can see the desire for them, certainly, but I personally would
> like the docs to build cleanly under the standard doclet. Personally I
> usually use FIXME for "urgent" to-dos and XXX for slightly less urgent
> ones, then just grep (or whatever) for them. How much prettier is XDoclet
> than grepping, out of interest? (I'd be quite happy with a general TO-DO
> non-tag, or whatever, if you want something to search on.)
>
> Alternative idea: keep the @todo in, and I nag once a week to make sure
> they get done :)
>
> Jon

-- 
Cheers,

Pete

--------------------------------------------------
you've made a dangerous leap right over common 
sense, like some kind of metaphysical Evil Knievel
--------------------------------------------------


--
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