https://issues.apache.org/bugzilla/show_bug.cgi?id=50923

           Summary: Difficult to pick out valid values from config
                    descriptions
           Product: Tomcat 7
           Version: trunk
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Severity: enhancement
          Priority: P2
         Component: Documentation
        AssignedTo: dev@tomcat.apache.org
        ReportedBy: s...@apache.org


Created an attachment (id=26766)
 --> (https://issues.apache.org/bugzilla/attachment.cgi?id=26766)
Patch to add <entry> markers to http.xml and process them in XSL

It's quite difficult picking out the valid values from the configuration
documentation.  For example, the clientAuth description under

http://tomcat.apache.org/tomcat-7.0-doc/config/http.html#SSL_Support

does not make it easy to see that the permissible values are "true", "want" and
"false", because the code font is not very different from the normal font.

It would be easier to see the values if they were in bold or otherwise
high-lighted.

Rather than add fixed styling within the source XML files, maybe one could take
advantage of the XSL processing and replace the <code> entries with some other
markup to flag such values, e.g. <entry>true</entry>.

Sample patch attached.

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org

Reply via email to