[gnome-devel-docs/dx-hackfest: 14/18] platform-overview: Update the Secret page

[Federico Mena Quintero <federico src gnome org>]

commit 1d937d8f864e479370af408c68789e976d1f02dc
Author: Federico Mena Quintero <federico gnome org>
Date:   Thu Jan 31 17:09:46 2013 +0100

    platform-overview: Update the Secret page
    
    Signed-off-by: Federico Mena Quintero <federico gnome org>

 platform-overview/C/index.page                    |    2 +-
 platform-overview/C/{keyring.page => secret.page} |   26 +++++++++++++-------
 2 files changed, 18 insertions(+), 10 deletions(-)
---
diff --git a/platform-overview/C/index.page b/platform-overview/C/index.page
index b0c4562..d28e510 100644
--- a/platform-overview/C/index.page
+++ b/platform-overview/C/index.page
@@ -44,7 +44,7 @@ on each part of the platform.</p>
   <title>User interface and display</title>
 </links>
 
-<links type="topic" style="toronto" groups="eds gsettings keyring gda tracker">
+<links type="topic" style="toronto" groups="eds gsettings secret gda tracker">
   <title>Storage of the user's data</title>
 </links>
 
diff --git a/platform-overview/C/keyring.page b/platform-overview/C/secret.page
similarity index 72%
rename from platform-overview/C/keyring.page
rename to platform-overview/C/secret.page
index a522547..99be440 100644
--- a/platform-overview/C/keyring.page
+++ b/platform-overview/C/secret.page
@@ -1,15 +1,15 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
-      id="keyring">
+      id="secret">
 <info>
-  <link type="guide" xref="index" group="apps"/>
+  <link type="guide" xref="index" group="secret"/>
   <desc>Secure storage for passwords and other data</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="candidate"/>
 </info>
 
-<title>Keyring</title>
+<title>Secret</title>
 
-<p>GNOME provides a modern and secure keyring manager to store users'
+<p>GNOME uses libsecret as a secure keyring manager, to store users'
 passwords and other sensitive data.  Applications can use the keyring
 manager library to store and access passwords, and users can manage
 their passwords using GNOME's <app>Seahorse</app>
@@ -41,19 +41,27 @@ the session keyring are never stored on disk, and are lost as soon as
 the user's session ends.  The session keyring can be used to store
 passwords to be used in the current session only.</p>
 
-<p>If you use GIO to access remote servers, you automatically
-get the benefits of the keyring manager.  Whenever GVFS needs to
+<p>If you use <link xref="gio">GIO</link> to access remote servers, you automatically
+get the benefits of the keyring manager.  Whenever GIO needs to
 authenticate the user, it provides the option to store the password,
 either in the default keyring or in the session keyring.</p>
 
-<p>You should use the keyring manager whenever your application needs
+<p>You should use libsecret's keyring manager whenever your application needs
 to store passwords or other sensitive data for users.  Using the keyring
 manager provides a better user experience while still keeping user data
 safe and secure.</p>
 
+  <note>
+    <p>
+      Gnome used a library called gnome-keyring before version 3.6 was
+      released.  In version 3.6 onward, libsecret is used instead.  This allows
+      sharing the keyring servide between GNOME and other desktop environments
+      and applications.
+    </p>
+  </note>
+
 <list style="compact">
-  <item><p><link href="http://developer.gnome.org/gnome-keyring/stable/";>gnome-keyring Reference Manual</link></p></item>
-  <item><p><link href="http://developer.gnome.org/libseahorse/stable/";>libseahorse Reference Manual</link></p></item>
+  <item><p><link href="http://developer.gnome.org/libsecret/unstable/";>Libsecret Reference Manual</link></p></item>
 </list>
 
 </page>