[seahorse/wip/userdocs: 19/244] help: New keys pages: sync, retrieve

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 9a0cbe200704504f2fc1812d6ca0e576f049d223
Author: Aruna Sankaranarayanan <arunasank src gnome org>
Date:   Tue Jun 18 14:34:56 2013 +0530

    help: New keys pages: sync, retrieve

 help/C/keys-retrieve-remote.page |   62 +++++++++++++++++++++
 help/C/keys-sync-publish.page    |  113 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 175 insertions(+), 0 deletions(-)
---
diff --git a/help/C/keys-retrieve-remote.page b/help/C/keys-retrieve-remote.page
new file mode 100644
index 0000000..4876fb6
--- /dev/null
+++ b/help/C/keys-retrieve-remote.page
@@ -0,0 +1,62 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="keys-retrieve-remote">
+  <info>
+    <link type="guide" xref="index#use-keys"/>
+    <revision version="0.1" date="2011-10-23" status="stub"/>
+    <revision pkgversion="3.9" version="0.1" date="2013-06-18" status="stub"/>
+
+    <credit type="author copyright">
+      <name>Aruna</name>
+      <email>aruna evam gmail com</email>
+    </credit>
+
+    <desc></desc>
+  </info>
+
+  <title>How to 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 keys when you have specific
+  information about the key, like its key ID or the name or email address of
+  its owner.</p>
+
+  <steps>
+    <title>To retrieve a remote key:</title>
+      <item>
+        <p>Select <guiseq><gui style="menu">Remote</gui>
+       <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>
+      </item>
+      <item>
+       <p>When you have specified enough information, click
+       <gui style="button">Search</gui>.</p>
+      </item>
+      <item>
+       <p>You will be presented a list of keys that are relevant search
+       results. Select the key of your choice from the results and click the
+       <gui style="button">Import</gui> button present on the toolbar to
+       import the key into your keyring or click the
+       <gui style="button">Properties</gui> button to see the properties of
+       the key, like the key ID, key fingerprint, level of trust, owner's
+       name, etc. You can also right click on the key and select
+       <gui style="menuitem">Import</gui> or
+       <gui style="menuitem">Properties</gui>.</p>
+      </item>
+  </steps>
+
+</page>
diff --git a/help/C/keys-sync-publish.page b/help/C/keys-sync-publish.page
new file mode 100644
index 0000000..80a321e
--- /dev/null
+++ b/help/C/keys-sync-publish.page
@@ -0,0 +1,113 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="keys-sync-publish">
+  <info>
+    <link type="guide" xref="index#use-keys"/>
+
+    <revision version="0.1" date="2011-10-23" status="stub"/>
+    <revision pkgversion="3.9" version="0.1" date="2013-06-18" status="draft"/>
+
+    <credit type="author copyright">
+      <name>Aruna</name>
+      <email>aruna evam gmail com</email>
+    </credit>
+
+    <desc></desc>
+  </info>
+
+  <title>How to sync and publish keys?</title>
+
+  <p><app>Passwords and Keys</app> helps you to publish and sync
+  <em>Public keys</em>. This keeps your keys updated and also helps people to
+  find your keys easily.</p>
+
+<section id="publish">
+  <title>Publish your keys</title>
+
+  <p>After you create your <em>Public key</em> you can choose to publish it.
+  When you publish a key, it becomes easily accessible to anybody who wants to
+  communicate with you and saves you the hassle of mailing your key
+  individually to all your communicators. However, you can also choose to not
+  publish your key if you only want to share your <em>Public key</em> with a
+  select few people.</p>
+
+  <steps>
+    <title>How do I publish my key?</title>
+      <item>
+        <p>Select the key you want to publish.</p>
+      </item>
+      <item>
+       <p>Select <guiseq><gui style="menu">Remote</gui>
+       <gui style="menuitem">Sync and Publish Keys…</gui></guiseq>.</p>
+      </item>
+      <item>
+       <p>Click the <gui style="button">Key Servers</gui> button.</p>
+      </item>
+      <item>
+       <p>Three <link xref="key-servers-what-are-they">key servers</link>
+       will already be listed by <app>Passwords and Keys</app>.</p>
+       <note style="tip">
+         <p>You can also add the key server of your choice to the list by
+         clicking the <gui style="add">Add</gui> button. Select the
+         appropriate key server type. Key servers are identified by the
+         protocol they use to communicate. Look for the first few letters in
+         the Internet URL of your key server to identify its type. In the
+         <gui style="input">Host</gui> field, paste the Internet URL of your
+         key server, and click <gui style="button">OK</gui>. To remove a key
+         server from the list, select it with your mouse and click
+         <gui style="button">Remove</gui>.</p>
+       </note>
+      </item>
+      <item>
+       <p>From the drop down box next to
+       <gui style="group">Publish keys to</gui>, select the key server that
+       you want to publish your key on.</p>
+      </item>
+      <item>
+       <p>Check the
+       <gui style="checkbox">Automatically retrieve keys from key servers</gui>
+       checkbox to retrieve any key that is published on the
+       server you have selected in the previous step. You can also check the
+       <gui style="checkbox">Automatically sync modified keys with key servers</gui>
+       checkbox to ensure that any modifications to a key on the
+       key server, like a signature are updated on your copy of the key
+       too.</p>
+      </item>
+  </steps>
+
+</section>
+
+<section id="sync">
+  <title>Sync your keys</title>
+
+  <p>Keys in your keyring may have to be synced with a key server to ensure
+  that any changes made to the key on the key server, like a new signature, are
+  updated in your local copy of the key.</p>
+
+  <steps>
+    <title>How do I sync a key?</title>
+      <item>
+        <p>Select the key you wish to sync.</p>
+      </item>
+      <item>
+        <p>Select <guiseq><gui style="menu">Remote</gui>
+       <gui style="menuitem">Sync and Publish Keys…</gui></guiseq>.</p>
+      </item>
+      <item>
+        <p>Click the <gui style="button">Sync</gui> button to sync your
+       key.</p>
+      </item>
+  </steps>
+
+  <note style="important">
+    <title>Why is the <gui style="button">Sync</gui> button not
+    clickable?</title>
+      <p>Only keys that have been published on a key server can be synced. If
+      the <gui style="button">Sync</gui> button is not clickable, check if the
+      key has been published on a key server. In the case of syncing your own
+      keys, publish them, before syncing them.</p>
+  </note>
+
+</section>
+
+</page>