Bug 255003: Document certificates and validation. p=jwalden, r=rlk. Also fix leftovers of bug 254780

git-svn-id: svn://10.0.0.236/branches/AVIARY_1_0_20040515_BRANCH@160794 18797224-902f-48f8-a5cc-f745e15eee43

mozilla/browser/components/help/locale/en-US/prefs.xhtml

@@ -484,15 +484,44 @@ Contributors:
 
   <h3 id="certificates">Certificates</h3>
 
-  <p>The Certificates section is provisional and will be changed or removed in
-    future releases. It is not covered in this document.</p>
+  <p>Certificates help perform encryption and decryption of connections to
+    <a href="glossary.xhtml#secure_site">secure sites</a>.</p>
+
+  <p><em>Client Certificate Selection</em><br/>When a web site requests a
+    secure connection, &brandShortName; will by default automatically use
+    an appropriate certificate.  If you wish to manually choose a certificate
+    (for example, if you wish to use a certain type of encryption instead of
+    what is automatically selected), select the option "Ask Every Time" and
+    you'll be in complete control of what certificates you use while
+    browsing.</p>
+
+  <p><em>Manage Certificates</em><br/>Click the <em>Manage Certificates...</em>
+    button to view stored certificates, import new certificates, and
+    back up or delete old certificates in &brandShortName;.</p>
+
+  <p><em>Manage Security Devices</em><br/>Security devices can encrypt and
+    decrypt connections and store certificates and passwords.  If you need
+    to use a security device other than the one in &brandShortName; or need
+    to change your master password, click the <em>Manage Security
+    Devices...</em> button.</p>
 
   <h3 id="validation">Validation</h3>
 
-  <p>The Validation section is provisional and will be changed or removed in
-    future releases. It is not covered in this document.</p>
+  <p>Validation ensures that certificates used by &brandShortName; are not
+    obsolete.</p>
 
-<div class="contentsBox"><em>17 July 2004</em></div>
+  <p><em>CRL</em><br/>&brandShortName; can use CRLs (also known as Certificate
+    Revocation Lists) to ensure that your certificates are not invalid.  If you
+    need to add a CRL to &brandShortName; or wish to view information about CRLs
+    you have installed, click the <em>Manage CRLs...</em> button.</p>
+
+  <p><em>OCSP</em><br/>OCSP (Online Certificate Status Protocol) is a way to
+    validate your certificates every time they are viewed or used.
+    &brandShortName; does not use OCSP by default, but if you want to enable it,
+    you can do so here.  You will most likely only need to change this if your
+    Internet environment requires it.</p>
+
+<div class="contentsBox"><em>14 August 2004</em></div>
 <p>Copyright &copy; 2003-2004 Contributors to the Mozilla Help Viewer Project.</p>
 </body>
 </html>

mozilla/toolkit/components/help/helpOnHelp/locale/en-US/firebird-glossary.rdf

@@ -57,6 +57,7 @@
         <rdf:li> <rdf:Description nc:name="private key" nc:link="glossary.xhtml#private_key"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="proxy" nc:link="glossary.xhtml#proxy"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="search engine" nc:link="glossary.xhtml#search_engine"/> </rdf:li>
+        <rdf:li> <rdf:Description nc:name="secure site" nc:link="glossary.xhtml#secure_site"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="Secure Sockets Layer (SSL)" nc:link="glossary.xhtml#Secure_Sockets_Layer"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="server" nc:link="glossary.xhtml#server"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="SSL" nc:link="glossary.xhtml#SSL"/> </rdf:li>

mozilla/toolkit/components/help/helpOnHelp/locale/en-US/glossary.xhtml

@@ -323,6 +323,16 @@ corresponding public key.</dd>
   search box, and the search engine displays links to relevant web
   pages.</dd>
 
+<dt id="secure_site">secure site</dt>
+<dd>A site that uses <a href="#encryption">encryption</a> in connections
+  with &brandShortName; to prevent other malicious Internet users from
+  viewing transmitted data.  When you visit secure sites, &brandShortName;
+  displays a lock icon in the <a href="#Status_Bar">Status Bar</a> and the
+  <a href="#location_bar">Location Bar</a>.  &brandShortName; also
+  displays the site's domain name in the Status Bar (to prevent malicious
+  sites from stealing your data) and turns the background of the Location
+  Bar to yellow.</dd>
+
 <dt id="Secure_Sockets_Layer">Secure Sockets Layer (SSL)</dt>
 <dd>A protocol that allows mutual authentication between a
   <a href="#client">client</a> and a <a href="#server">server</a>
@@ -390,6 +400,6 @@ corresponding public key.</dd>
 </p>
 
 <div class="contentsBox"><em>14 August 2004</em></div>
-<p>Copyright &copy; 2003 Contributors to the Firebird Help Project.</p>
+<p>Copyright &copy; 2003-2004 Contributors to the Mozilla Help Viewer Project.</p>
 </body>
 </html>

mozilla/toolkit/components/help/helpOnHelp/locale/en-US/welcome.xhtml

@@ -89,7 +89,7 @@
 	</ul>
 
 <div class="contentsBox"><em>07 September 2003</em></div>
-<p>Copyright &copy; 2003 Contributors to the Firebird Help Project.</p>
+<p>Copyright &copy; 2003-2004 Contributors to the Mozilla Help Viewer Project.</p>
 
 </body>
 </html>