forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Nicola Ken Barozzi <nicola...@apache.org>
Subject Re: JavaDocGenerator, ideas?
Date Fri, 22 Nov 2002 10:38:00 GMT


Bertrand Delacretaz wrote:
> (cc to cocoon-docs for info, please discuss on forrest-dev)
> 
> Hi Forresters,
> 
> On cocoon-docs [1] we recently agreed (I think - no vote yet) to generate 
> parts of the soon-to-be Cocoon Users Reference Docs from custom javadoc tags 
> embedded in java source code.
> 
> For this we need a JavaDocGenerator that would parse java sources and output 
> an XML representation of (at least) the javadoc tags and their content. I 
> think such a generator could be very useful for other projects.
> 
> I assume this component would be added to the Cocoon code base, but the most 
> immediate need that I can see is in Forrest, which prompts me to bring the discussion
here.
> 
> Any suggestions on how to best implement this? 
> I see it has been discussed lately but did not find concrete conclusions.
> 
> I gave a quick look at qdox [2], looks like it would be fairly easy to base 
> the JavaDocGenerator on this library.

IMHO this is more appropriate for a project like Alexandria, and there 
is also a Javadoc XML doclet there.
But this would need static pre-generation of the javadocs...

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


Mime
View raw message