From: Rich Bowen <rbowen@apache.org>
Date: Tue, 15 Feb 2011 14:23:40 +0000 (+0000)
Subject: People come to the SSL docs primarily for advice on getting SSL working.
X-Git-Tag: 2.3.11~35
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a8b84e115c68f9f92dafc5df26c78826935d3361;p=thirdparty%2Fapache%2Fhttpd.git

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 9cebf13163b..2f0497fbdc5 100644
--- 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 c8129e324df..e25f9ace099 100644
--- 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">