Sounds good! Actually, it would be nice to make available an XSLT
stylesheet that does exactly that.
What I would prefer to avoid is having another XML document that is not
the JSP 1.2 TLD that is providing the extra information needed by page
authors. Same argument that you are using: we want developers to have
to write only one document.
Thanks,
- eduard/o
Morgan Delagrange wrote:
>
> That sounds possible. It's going to be a pain maintaining different
> versions of the TLDs though! Maybe older versions of the TLD can be
> generated by transforming newer versions.
>
> - Morgan
>
> On Thu, 3 May 2001, Eduardo Pelegri-Llopart wrote:
>
> > Any chances we could add JSP 1.2 TLD for all libraries and run xslts on
> > them to generate page-author-level documentation? We just added a
> > number of elements to the TLD in PFD2 just for that purporse.
> >
> > thanks,
> > - eduard/o
> >
> > Morgan Delagrange wrote:
> > >
> > > Hi all,
> > >
> > > I just checked in some files that implement the "news" and
> > > "state" proposal in the HOWTO-RELEASE document, and I'd like to propose
> > > moving them to the site. The relevant pieces are:
> > >
> > > - /src/doc/taglibs_doc.dtd
> > >
> > > My attempt to represent our documentation format as a DTD. I
> > > added element for displaying news and the "state" of each tag
> > > library.
> > >
> > > - /src/doc/stylesheets/taglibs.xsl
> > >
> > > Updates with the new news and state elements
> > >
> > > - /src/doc/index.xml
> > >
> > > Updated with news, including the renaming of JDBC taglib and
> > > the retirement of the SQL taglib. Also added descriptions
> > > and state for each taglib.
> > >
> > > - src/doc/project.xml
> > >
> > > Renamed JDBC to DBTags and added a special section for UNSUPPORTED
> > > tags.
> > >
> > > I also updated the DBTags and the SQL documentation with news sections.
> > >
> > > I'm not all that happy with the formatting of the Taglib description
> > > section, but we can play with the stylesheet now or later.
> > >
> > > Also, as the news sections get longer, they will probably have to be moved
> > > into a separate XML file. The way the transformations are designed right
> > > now makes that difficult to do for individual taglibs, so we may have to
> > > do some light refactoring later.
> > >
> > > You may be wondering why all the current tags are in the "Pre-Release" or
> > > "Unsupported" state. Technically taglibs do not move to the beta or
> > > released state until they have a formal binary release (daily builds do
> > > not count). We should be able to perform binary builds, now that we have
> > > a news section to track our progress. I hope to formally release DBTags
> > > next week.
> > >
> > > I am +1 for moving out a new version of the homepage that includes news
> > > and tag descriptions. I am also +1 for updating the SQL documentation and
> > > moving DBTags to its new home. :)
> > >
> > > - Morgan
> >
