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

           Summary: http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html
                    improvements
           Product: Tomcat 6
           Version: unspecified
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Documentation
        AssignedTo: dev@tomcat.apache.org
        ReportedBy: s...@apache.org


I find the page http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html quite
difficult to use, and confusing.

The top of the page says:

"This Howto refers to usage of JSSE, that comes included with jdk 1.5 and
higher. When using APR, Tomcat will use OpenSSL, which uses a different
configuration."

This implies that the APR description is to be found elsewhere, however there
is no link, and in fact, the APR settings are described further down the page.

[Also, surely JSSE is included in Java 1.4+? (and it does not have to be jdk,
jre will do).]

==

I found the section headed "Edit the Tomcat Configuration File" confusing.

The configuration details for APR and JSSE are intermixed, and the table
showing the attributes only mentions common or JSSE atributes, the APR-only
ones are not mentioned.

IMO it would be better to have an introductory paragraph which describes the
two different methods, and how to choose between them, and then explain how to
set each of them up. The attributes table could have an extra column showing
which entries are JSSE, APR or common.

==

I can provide a patch; please let me know if that would be useful.

-- 
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