From: "Murray Collingwood" <[EMAIL PROTECTED]>
I've read through most of this documentation and it doesn't help much.
I completely agree. I've never been able to just read the taglib docs and figure out what combination of attributes will do what I want.
I'm really looking for a reference manual that: 1. lists all of the available tags in a tag library, 2. describes all of the parameters, 3. how the parameters differ from each other and how they interact (you can't always use two parameters together and sometimes if you have one you need a second etc) 4. and optionally including some examples of usage in everyday JSP pages Here's a good example from Hibernate: http://www.hibernate.org/hib_docs/v3/reference/en/html/mapping.html#mapping-declaration-class
That's *nice*. We're getting there. :) As part of the as-yet-unpublished website reorganization, we now have JSP 1.2 tld files with embedded HTML documentation. These are being used to generate Tag Reference pages http://svn.apache.org/builds/struts/maven/trunk/site-test/struts-taglib/tagreference-struts-html.html and also Taglibdoc http://svn.apache.org/builds/struts/maven/trunk/site-test/struts-taglib/tlddoc/index.html Right now... it's the same documentation from the original xml source documents, presented two different ways, so it's no great improvement. And really, no amount of writing about the attributes is going to help-- the descriptions are technically correct. I think examples are the only thing that will clear up the many mysteries of what, exactly, happens when you use attributes in various combinations. The dtd for JSP 1.2 tag library descriptors includes an <example> tag that we can now take advantage of. But first, someone has to come up with the examples. :) Patches are very welcome-- the TLD files are under src/tld in the 'taglib' sub project. If you're interested in working on them, just ask on the dev list if you need help getting started with Subversion, etc. Alternately, start a Wiki page and I'd be more than happy to move the examples into the TLDs as appropriate. I'm not likely to have time to sit down and come up with examples for all of these tags, but if a few people get involved, it won't be long before we have them all done. -- Wendy Smoak --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
