[deployment-guide/comm-rel: 33/41] Corrected the Generating Key Pairs introduction.

[dsilas]

commit 0526d84ef83d5d104f383ef396ba2c9d2e71f01f
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Wed Jul 14 17:49:32 2010 +0200

    Corrected the Generating Key Pairs introduction.

 en-US/OpenSSH.xml |   24 ++++++++++++------------
 1 files changed, 12 insertions(+), 12 deletions(-)
---
diff --git a/en-US/OpenSSH.xml b/en-US/OpenSSH.xml
index a464cb2..4c9956c 100644
--- a/en-US/OpenSSH.xml
+++ b/en-US/OpenSSH.xml
@@ -541,23 +541,23 @@ It is also possible that the RSA host key has just been changed.</screen>
         <secondary>generating key pairs</secondary>
       </indexterm>
       <para>
-        If you do not want to enter your password every time you use <command>ssh</command>, <command>scp</command>, or <command>sftp</command> to connect to a remote machine, you can generate an authorization key pair.
-      </para>
-      <para>
-        Keys must be generated for each user. To generate keys for a user, use the following steps as the user who wants to connect to remote machines. If you complete the steps as root, only root will be able to use the keys.
-      </para>
-      <para>
-        Starting with OpenSSH version 3.0, <filename>~/.ssh/authorized_keys2</filename>, <filename>~/.ssh/known_hosts2</filename>, and <filename>/etc/ssh_known_hosts2</filename> are obsolete. SSH Protocol 1 and 2 share the <filename>~/.ssh/authorized_keys</filename>, <filename>~/.ssh/known_hosts</filename>, and <filename>/etc/ssh/ssh_known_hosts</filename> files.
-      </para>
-      <para>
-        &MAJOROSVER; uses SSH Protocol 2 and RSA keys by default.
+        If you do not want to enter your password every time you use <command>ssh</command>, <command>scp</command>, or <command>sftp</command> to connect to a remote machine, you can generate an authorization key pair. Note that keys must be generated for each user. To do so, use the following steps as the user who wants to connect to remote machines.
       </para>
+      <important>
+        <title>Important: Do Not Generate Key Pairs as root</title>
+        <para>
+          If you complete the steps as root, only root will be able to use the keys.
+        </para>
+      </important>
       <note>
-        <title>Tip</title>
+        <title>Tip: Backup Your <filename class="directory">~/.ssh/</filename> Directory</title>
         <para>
-          If you reinstall and want to save your generated key pair, backup the <filename>.ssh</filename> directory in your home directory. After reinstalling, copy this directory back to your home directory. This process can be done for all users on your system, including root.
+          If you reinstall and want to save your generated key pair, backup the <filename class="directory">~/.ssh/</filename> directory. After reinstalling, copy it back to your home directory. This process can be done for all users on your system, including root.
         </para>
       </note>
+      <para>
+        &MAJOROSVER; uses SSH Protocol 2 and RSA keys by default.
+      </para>
       <section id="s3-openssh-rsa-keys-v2">
         <title>Generating an RSA Key Pair for Version 2</title>
         <indexterm>