On Wed, 17 Oct 2001, Matt Raible wrote:
> Date: Wed, 17 Oct 2001 18:07:42 -0600
> From: Matt Raible <[EMAIL PROTECTED]>
> Reply-To: [EMAIL PROTECTED]
> To: [EMAIL PROTECTED]
> Cc: Martin Gee <[EMAIL PROTECTED]>
> Subject: Generating doc/*.xml files from javadocs
>
> Hello,
>
> I am writing to find out if the docs/*.xml files in the source
> distribution of struts are "generated" or are they static. Ideally, I
> would like to use this same process to create tld's and html files for
> our tag libraries. However, I would like to generate the xml files
> (documentation) from the javadocs within my Tag Library *.java files.
>
The XML files are themselves the source files. However, they are used to
generate two different kinds of things:
* The "struts-*.xml" files are used to generate BOTH the TLD files
that you include in your application AND the "Tag Library Reference"
pages in the struts-documentation webapp (HTML format).
* The remaining XML files are used to generate the rest of the
struts-documentation stuff only (HTML format).
In the former case, this magic comes courtesy of using two different XSLT
stylesheets that take the same input, but generate different output.
You can look at the Ant build script (build.xml) for how this is done in
Struts. The Jakarta Taglibs project <http://jakarta.apache.org/taglibs>
has a similar-but-different approach that accomplishes the same thing, but
again starts from XML files as the source, not the destination.
> Any ideas on this?
>
> Thanks,
>
> Matt
>
