[seahorse/mallard-help] Help: Fix pgp-retrieve-remote.page



commit 00f3328ed74820c84ac6f504dd9d26a8b7a544e3
Author: Aruna Sankaranarayanan <arunasank src gnome org>
Date:   Sat Aug 31 00:09:03 2013 +0530

    Help: Fix pgp-retrieve-remote.page
    
    Make steps more concise and to the point. think from the user's
    perspective.

 help/C/pgp-retrieve-remote.page |   60 +++++++++++++++++----------------------
 1 files changed, 26 insertions(+), 34 deletions(-)
---
diff --git a/help/C/pgp-retrieve-remote.page b/help/C/pgp-retrieve-remote.page
index 18da782..9c03753 100644
--- a/help/C/pgp-retrieve-remote.page
+++ b/help/C/pgp-retrieve-remote.page
@@ -17,18 +17,15 @@
       <years>2013</years>
     </credit>
 
-    <desc>Download public keys of those you communicate with from key
-    servers.</desc>
-
+    <desc>If you want to send an urgent encrypted message to someone, but do
+    not have their key, you can retrieve their key from a remote key
+    server.</desc>
   </info>
 
   <title>Retrieve remote keys</title>
 
-  <p>You may want to import the <em>public keys</em> of people you frequently
-  communicate with to make it easier to encrypt messages to them.
-  <app>Passwords and Keys</app> helps you to import a specific key when you
-  have certain details about it, like the key ID or the owner's name or email
-  address etc.</p>
+  <p>You can retrieve someone's public GnuPG key using the Internet and store
+  it on <app>Passwords and Keys</app>.</p>
 
   <steps>
     <title>To retrieve a remote key:</title>
@@ -37,37 +34,32 @@
       <gui style="menuitem">Find Remote Keys…</gui></guiseq>.</p>
     </item>
     <item>
-      <p>In the new dialog that opens up, type in any information about the key
-      you wish to retrieve, in the text box next to the
-      <gui>Search for keys containing</gui> label. Details like key ID, or the
-      key owner's email address give more accurate results than the name of the
-      key owner.</p>
-    </item>
-    <item>
-      <p>You can additionally check which key servers must be searched in order
-      to find the key you are interested in by clicking the small <gui>+</gui>
-      next to <gui>Where to search</gui> and checking the key servers you are
-      interested in. All the key servers are checked, by default.</p>
+      <p>Enter information about the key you wish to retrieve in the field
+      provided. Details like key ID or the key owner's email address give more
+      accurate results than the name of the key owner.</p>
     </item>
     <item>
-      <p>When you have specified enough information, press the
-      <gui style="button">Search</gui> button.</p>
+      <p>Press the <gui style="button">Search</gui> button.</p>
     </item>
     <item>
-      <p>You will see a list of keys that are relevant search results. To
-      verify a key from the list before importing it, select it and press the
-      <gui style="button">Properties</gui> button, found at the top.
-      Alternatively you can also right click on the key and select
-      <gui style="menuitem">Properties</gui>. This opens a dialog that shows
-      you all information about the key, like the key ID, key fingerprint,
-      level of trust, owner's name, etc.</p>
-    </item>
-    <item>
-      <p>Once you have verified a key, select it from the list and press the
-      <gui style="button">Import</gui> button present at the top to import the
-      key into <app>Passwords and keys</app>. Alternatively, you can also right
-      click on the key and select <gui style="menuitem">Import</gui>.</p>
+      <p>From the list of search results, select the key of your choice, right
+      click on it and select <gui style="menuitem">Import</gui>. Alternatively,
+      you can also press the <gui style="button">Import</gui> button present at
+      the top of the dialog after selecting the key.</p>
     </item>
   </steps>
 
+  <p>The imported key will be listed in the <gui>GnuPG keys</gui> keyring. If
+  you cannot see the key, please select <guiseq><gui>View</gui>
+  <gui>Show any</gui></guiseq>.</p>
+
+  <note style="tip">
+    <p>If you want more information about a key, before importing it, select
+    it, and press the properties button found at the top of the dialog.
+    Alternatively you can also right click on the key and select
+    <gui style="menuitem">Properties</gui>. This opens a new window that
+    displays information like the key ID, key fingerprint, level of trust,
+    owner's name, etc.</p>
+  </note>
+
 </page>


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]