[gnome-keyring/dbus-api] Make object paths static for the lifetime of an object.



commit d4ca6d4f828a914d0e2070877c01b1523e46ba62
Author: Stefan Walter <Stefan Walter>
Date:   Thu Jul 16 01:35:11 2009 +0000

    Make object paths static for the lifetime of an object.
    
    Suggestion from Michael Leupold.

 docs/reference/secrets/secrets-docs.sgml |    6 ++++--
 1 files changed, 4 insertions(+), 2 deletions(-)
---
diff --git a/docs/reference/secrets/secrets-docs.sgml b/docs/reference/secrets/secrets-docs.sgml
index e18452d..0a903d1 100644
--- a/docs/reference/secrets/secrets-docs.sgml
+++ b/docs/reference/secrets/secrets-docs.sgml
@@ -94,7 +94,8 @@
 			A collection is similar in concept to the terms 'keyring' or 'wallet'.</para>
 			
 			<para>Collections and items are represented as DBus objects, and each have their own
-			object paths. However these may change from time to time.</para>
+			object paths. The object path of a collection or item should not change for it's lifetime,
+			under normal circumstances.</para>
 			
 			<para>It is strongly recommended that client applications use 
 			<link linkend='lookup-attributes'>lookup attributes</link> to find items rather than 
@@ -354,7 +355,8 @@
 			</refmeta>
     	
 			<para>The various DBus object paths used with the Secrets API are designed to be human
-			readable but not displayed to the user.</para>
+			readable but not displayed to the user. The object path of an item or collection should
+			not change for its lifetime, under normal circumstances.</para>
 
 			<refsect1>
 				<programlisting>/org/freedesktop/Secrets</programlisting>



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