jakarta-taglibs-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Glenn Nielsen <gl...@voyager.apg.more.net>
Subject Re: [PROPOSAL/VOTE] Jakarta-taglibs dir/file layout and build restructuring
Date Wed, 23 May 2001 00:01:27 GMT
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             glenn@more.net | /* Spelin donut madder    |
MOREnet System Programming               |  * if iz ina coment.      |
Missouri Research and Education Network  |  */                       |
----------------------------------------------------------------------

Mime
View raw message