[ 
https://issues.apache.org/struts/browse/STR-3144?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Matthieu Chase Heimer updated STR-3144:
---------------------------------------

    Attachment: struts1-taglib-pom.diff

Yes. I think it's only in the latest version of the taglib plugin (2.3.1)  so 
maybe you tried it before 2.3.1. Here is what the page looks like with 
parseHtml set to true http://www.ej4l.org/site/tagreference.html. Notice there 
is sill a problem with the one sentence summaries of each lib but that's a bug 
in the taglib plugin. The page is rendered much better with this option turned 
on.

> 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
>         Attachments: struts1-taglib-pom.diff
>
>
> 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.

Reply via email to