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
