----- Original Message -----
From: "Ara Abrahamian" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>; "'Mathias Bogaert'"
<[EMAIL PROTECTED]>
Cc: <[EMAIL PROTECTED]>
Sent: Thursday, May 16, 2002 12:15 PM
Subject: RE: [Xdoclet-devel] Strategies for doc generation
> > 1) xdoclet/modules/foo/src/META-INF/xtags.xml
> > This file is hand-written, and should be maintained by the module
> > authors.
> > We are already able to generate a nice table describing the tags. Done
> > with XSLT.
> > result: xdoclet/dist/docs/tags/foo-tags.html
>
> Xcellent.
>
> > 2) xdoclet/modules/foo/src/xdoclet/modules/foo/FooSubTask.java
> > We can add @tags on the setFoo and createFoo methods. Then use XDoclet
> > to generate subtask docs. (describing what to put in the build.xml
> > scripts)
> > result: xdoclet/dist/docs/subtasks/foo-subtask.html
> > This needs to be done.
>
> That's what Eric was working on for Ant. @ant:task blabla.
> We can ask Eric to donate his code ;-) And then extend it, and return it
> back to him/Ant. I'm sure we can come up with something useful for both
> Ant and xdoclet (the main difference is that xdoclet has lots of
> subtasks while Ant doesn't in xdoclet's sense).
>
> Erik, comments?
First, spell my name right! :)
Yes, there is a proposal/xdocs directory in Ant's CVS repository that is
fair game for anyone to use/abuse. There are custom XDoclet tags and
subtasks. I haven't gotten it sophisticated enough to be recursive, might
need some XDoclet expertise from you all to refine that when I finally get
back to working on it soon.
There really wasn't much need for me to have @tags anywhere on
create/add/addConfigured/set methods but certainly if there is some metadata
needed there for documentation purposes then sure. I do want it to drill
down to document the sub-elements and datatypes that each task can have,
certainly.
Erik
_______________________________________________________________
Have big pipes? SourceForge.net is looking for download mirrors. We supply
the hardware. You get the recognition. Email Us: [EMAIL PROTECTED]
_______________________________________________
Xdoclet-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/xdoclet-devel
