svn commit: r1070915 - in /httpd/httpd/trunk/docs/manual/ssl: index.xml ssl_howto.xml

[rb...@apache.org]

Author: rbowen
Date: Tue Feb 15 14:23:40 2011
New Revision: 1070915

URL: http://svn.apache.org/viewvc?rev=1070915&view=rev
Log:
People come to the SSL docs primarily for advice on getting SSL working.
Arrange the TOC accordingly, and remove condescending introductory quote
and meaningless paragraph.

Modified:
    httpd/httpd/trunk/docs/manual/ssl/index.xml
    httpd/httpd/trunk/docs/manual/ssl/ssl_howto.xml

Modified: httpd/httpd/trunk/docs/manual/ssl/index.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/ssl/index.xml?rev=1070915&r1=1070914&r2=1070915&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/ssl/index.xml (original)
+++ httpd/httpd/trunk/docs/manual/ssl/index.xml Tue Feb 15 14:23:40 2011
@@ -36,9 +36,9 @@ Ralf S. Engelschall's mod_ssl project.</
 
 <section id="documentation"><title>Documentation</title>
 <ul>
-<li><a href="ssl_intro.html">Introduction</a></li>
+<li><a href="ssl_howto.html">mod_ssl Configuration How-To</a></li>
+<li><a href="ssl_intro.html">Introduction To SSL</a></li>
 <li><a href="ssl_compat.html">Compatibility</a></li>
-<li><a href="ssl_howto.html">How-To</a></li>
 <li><a href="ssl_faq.html">Frequently Asked Questions</a></li>
 <li><a href="../glossary.html">Glossary</a></li>
 </ul>

Modified: httpd/httpd/trunk/docs/manual/ssl/ssl_howto.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/ssl/ssl_howto.xml?rev=1070915&r1=1070914&r2=1070915&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/ssl/ssl_howto.xml (original)
+++ httpd/httpd/trunk/docs/manual/ssl/ssl_howto.xml Tue Feb 15 14:23:40 2011
@@ -26,20 +26,11 @@
   <title>SSL/TLS Strong Encryption: How-To</title>
 
 <summary>
-<blockquote>
-<p>The solution to this problem is trivial
-and is left as an exercise for the reader.</p>
-
-<p class="cite">-- <cite>Standard textbook cookie</cite></p>
-</blockquote>
-
-<p>How to solve particular security problems for an SSL-aware
-webserver is not always obvious because of the interactions between SSL,
-HTTP and Apache's way of processing requests. This chapter gives
-instructions on how to solve some typical situations. Treat it as a first
-step to find out the final solution, but always try to understand the 
-stuff before you use it. Nothing is worse than using a security solution
-without knowing its restrictions and how it interacts with other systems.</p>
+
+<p>This documented is intended to get you started, and get a few things
+working. You are strongly encouraged to read the rest of the SSL
+documentation, and arrive at a deeper understanding of the material,
+before progressing to the advanced techniques.</p>
 </summary>
 
 <section id="configexample">