cocoon-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jeff Turner <>
Subject Re: JavaDocGenerator, ideas?
Date Fri, 22 Nov 2002 11:00:48 GMT
On Fri, Nov 22, 2002 at 11:35:37AM +0100, 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.

Yes, I would find that useful for documenting Ant tasks.

I propose sucking up to Peter Donald:

  "Essentially what I want to do is be able to point at a java source
  file that gets processed by and outputs some
  custom xml. The code is already written but only works from command
  line. What I would like to do is get it working inside forrest so that
  everytime I rebuild the descriptions of components are regenerated and


> 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
> 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.
> Thoughts?
> -- 
>  Bertrand Delacrétaz (,
>  buzzwords: XML, java, XSLT, Cocoon, FOP, mentoring/teaching/coding.
>  blogspace
> [1]
> [2]

View raw message