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.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1070915 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/ssl/index.xml b/docs/manual/ssl/index.xml
index 9cebf13163bcf078c44ee90a16c8cae920be416e..2f0497fbdc5cf28f99fdad8ea163953ec1b18c64 100644 (file)
--- a/docs/manual/ssl/index.xml
+++ b/docs/manual/ssl/index.xml
@@ -36,9 +36,9 @@ Ralf S. Engelschall's mod_ssl project.</p>
 
 <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>

diff --git a/docs/manual/ssl/ssl_howto.xml b/docs/manual/ssl/ssl_howto.xml
index c8129e324dfb01e9164c74dbe4ee4c912b9e4d20..e25f9ace09980d452e7e74df922391b39c512f46 100644 (file)
--- a/docs/manual/ssl/ssl_howto.xml
+++ b/docs/manual/ssl/ssl_howto.xml
@@ -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">