James Strachan wrote:
>
> +1
>
> A couple of minor points below...
>
> > Attached is my previous file which documents the current jakarta-taglibs
> dir/file
> > layout and build process. Included at the end is my proposal for a new
> > dir/file layout and build process.
> >
> > Comments? Votes?
>
> > Configuration Files (taglib-doc-kit)
> > ------------------------------------
> >
> > <taglib>/xml/<taglib>-tags.xml - Taglib and tag XML data transformed by
> taglib-doc-kit/xml/taglib-doc.xsl into the taglib index.html documentation
> and by taglib-doc-kit/xml/tld.xsl into the <taglib>.tld
>
> I've been using the pattern
>
> <taglib>/xml/<taglib>.xml
>
> (i.e. without the trailing "-tags") in the IO, Log and XTags libraries. Is
> this a problem or can we relax the restriction? I'm happy to go either way
> on this.
>
<taglib>/xml/<taglib>.xml works for me.
> > Build Files
> > -----------
> >
> > .cvsignore - CVS file specifying what files to ignore, add build, dist,
> and build.properties
>
> Cool!
>
> > build.properties.sample
> >
> > Example build properties file used to configure ant properties for
> required jar files.
> > The jar file properties will be in the form "servlet.jar=<path to jar
> file>",
> > version specific jars would be "servlet-2.2.jar=<path to jar file>.
> This means that
> > the build.bat and build.sh scripts can be removed. $ANT_HOME/bin would
> have to be
> > in your PATH so that you could build by using "ant dist".
>
> Cool - like it.
>
> > build.bat - Windows build script: Remove, no longer needed
> > build.sh - Unix build script: Remove, no longer needed
> > build.xml - Overall taglibs Ant build config
> > common.properties - common properties for building a taglib
> > common.xml - common Ant config for building a taglib:
> >
> > Switch common.xml from using env vars for jar files to using
> build.properties.
>
> +1
>
> > Add the ability to generate documentation using the new taglib-doc-kit.
>
> I've already added the gen-doc target to the common.xml so that any task
> that depends on the gen-docs target gets this stuff for free. Its all in use
> in IO, Log and XTags right now.
>
Thanks
> I've no idea where the <taglib>-tags.xml files are for all the other
> libraries. I assume people have been creating the HTML and TLD by hand up to
> now? Maybe we can reverse engineer them all via XSLT then add the
> documentation back in by hand?
>
Yeah, taglibs developed before the taglib-doc-kit was available haven't been
converted over to use it.
> Great piece of work Glenn.
>
Thanks, but this is only the start, there are enough +1 votes for me to implement
the changes.
> James
>
> _________________________________________________________
> Do You Yahoo!?
> Get your free @yahoo.com address at http://mail.yahoo.com
--
----------------------------------------------------------------------
Glenn Nielsen [EMAIL PROTECTED] | /* Spelin donut madder |
MOREnet System Programming | * if iz ina coment. |
Missouri Research and Education Network | */ |
----------------------------------------------------------------------
