[
https://issues.apache.org/struts/browse/STR-3144?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=43856#action_43856
]
Matthieu Chase Heimer commented on STR-3144:
--------------------------------------------
I just submitted patches for the same issue for the tile-jsp.tld tag reference
page. See: https://issues.apache.org/struts/browse/TILES-274. As long as the
latest taglib plugin is used there is a pom.xml configuration change that can
be made to disable the escaping that is happening. You must be very careful to
make the html in the description well formed and manually escape everything in
any code blocks.
> Bean Taglib Documentation Has Been Unreadable FOR YEARS...
> ----------------------------------------------------------
>
> Key: STR-3144
> URL: https://issues.apache.org/struts/browse/STR-3144
> Project: Struts 1
> Issue Type: Bug
> Components: Taglibs
> Affects Versions: 1.3.0, 1.3.1, 1.3.2, 1.3.3, 1.3.4, 1.3.5, 1.3.6, 1.3.7,
> 1.3.8, 1.3.9
> Environment: Any OS, any browser.
> Reporter: Daniel A. Torrey
>
> The page http://struts.apache.org/1.3.8/struts-taglib/tagreference.html has
> been unreadable for YEARS. The output has all of the markup tags escaped, so
> instead of rendering a paragraph tag as the end of a paragraph, the literal
> string "<p>" is written. This makes the documentation worth very little.
> The last time I worked on a Struts app, in May of 2007, this was the case.
> The time before that that I worked on a Struts app, in October of 2006, this
> was the case.
> I've never reported it, as I've always thought that a) someone would fix it
> and b) you must have already been flooded by reports. Or maybe nobody in the
> world except me actually reads documentation?
> This really should be fixed - it reflects very poorly on the development /
> documentation team. I'd be glad to help, but I wouldn't have a clue where to
> start.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
