A wise old hermit known only as Vincent Harcq 
<[EMAIL PROTECTED]> once said:

> Hi,
> With my value object stuffs getting more and more complex, I want to add
> comments in the J files
> 
> Could we have something like
>       <XDtComment:comment>I do this because ...</XDtComment:comment>
> that would not be generated
> And maybe also
>       <XDtComment:comment generate="true">Bla bla
> bla</XDtComment:comment> that would be generated between /* */
> What do you think ?

Sounds good to me.  What about //s if it's short enough for a single line?
It could also check the type of the current subtask, and if it's an XML 
one use <!-- --> automatically instead.  And maybe a javadoc="true" 
parameter (or separate XDtComment:javadoc) to use /** */ instead (though 
I'm not sure how it would handle including javadoc tags).

Another thing that would be useful is some way to include @todo's in the 
templates, that get included by the info task along with the java source 
ones.  That's trickier to do, since we then need to supply two types of 
source structure to the doclet - I know others have used the template 
engine with XML files as the source, but including both would be 
difficult.  Perhaps but would be easier initially to just generate a 
separate list.  By the way, is it still only class-level @todo tags that 
get used, or do method/field/constructor-level ones get picked up too?


Andrew.

_______________________________________________
Xdoclet-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/xdoclet-devel

Reply via email to