Needed to look at the mavenized taglib docs today, and noticed a
couple of things in the new version (thanks for the efforts that went
in already).

The maven taglib plug-in picks up the CDATAs out of the TLDs and
converts them into pre-formatted blocks, which means that anyone
editing the TLDs will need to be diligent about line breaks,
indentation etc. Further, when CDATAs themselves hold HTML (which is
true in the Struts taglibs cases), errant linebreaks lead to malformed
artifacts (such as anchors).

Does anyone know if there is a way to generate the documentation
without the pre blocks, or more generally with span blocks and a
stylesheet of choice? To better illustrate my point, a before and
after sample of the TLD docs overview page is here:

http://people.apache.org/~rahul/struts/taglib-doc.html

Another issue I noticed is that the taglib:tagreference goal seems to
produce inconsistent internal anchors on the tagreference pages?
Internal anchors are defined as "taglib-short-name:tag-name" and
linked to as "#tag-name" so none of the internal anchors work.

I guess this is all probably best clarified in maven taglib plug-in
land, but appears they don't have mailing lists.

-Rahul

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to