Re: Generating doc/*.xml files from javadocs

2001-10-18 Thread Erik Hatcher 

Craig,

What are your thoughts about morphing the current XML/XSL scheme of
generating TLD's to XDoclet's struts-config and taglib capability?

Centralizing all the TLD information into the actual source code of each tag
could avoid a lot of potential mismatch issues.  It would take some work,
but I think it would be possible, to create new XDoclet's that could
generate the documentation for the tags as well as the TLD's themselves.

Thanks,
Erik


- Original Message -
From: Craig R. McClanahan [EMAIL PROTECTED]
To: [EMAIL PROTECTED]
Cc: Martin Gee [EMAIL PROTECTED]
Sent: Wednesday, October 17, 2001 8:14 PM
Subject: Re: Generating doc/*.xml files from javadocs

...


 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.

Generating doc/*.xml files from javadocs

2001-10-17 Thread Matt Raible 



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.

Any ideas on this?

Thanks,

Matt

Re: Generating doc/*.xml files from javadocs

2001-10-17 Thread Craig R. McClanahan 



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

Re: Generating doc/*.xml files from javadocs

2001-10-17 Thread Matt Raible 

Craig,

Thanks for the clarification. I figured out the part you mentioned below, and
was able to successfully use what is in struts source to generate documentation
for our own tag libraries similarly.

However, I think the javadoc information in my tag libraries and the xml source
might end up being the same.  I'm now trying to figure out if it is possible
generate the xml source from the javadocs.

Thanks,

Matt


--- Craig R. McClanahan [EMAIL PROTECTED] wrote:
 
 
 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
 
 


__
Do You Yahoo!?
Make a great connection at Yahoo! Personals.
http://personals.yahoo.com