[libgnome-keyring/gnome-3-0] Cleanup documentation warnings.



commit d6a342f541310fbeb792a564d6a6f442ae2b3afe
Author: Stef Walter <stefw collabora co uk>
Date:   Fri Apr 1 13:14:50 2011 +0200

    Cleanup documentation warnings.

 docs/reference/gnome-keyring/Makefile.am           |   10 +-
 .../gnome-keyring/gnome-keyring-sections.txt       |    6 +
 library/gkr-misc.c                                 |   16 ++
 library/gnome-keyring-private.h                    |    1 +
 library/gnome-keyring-utils.c                      |   88 ++++++++++-
 library/gnome-keyring.c                            |   44 ++++--
 library/gnome-keyring.h                            |  160 ++++++++++----------
 7 files changed, 225 insertions(+), 100 deletions(-)
---
diff --git a/docs/reference/gnome-keyring/Makefile.am b/docs/reference/gnome-keyring/Makefile.am
index f44408c..39bcc07 100644
--- a/docs/reference/gnome-keyring/Makefile.am
+++ b/docs/reference/gnome-keyring/Makefile.am
@@ -29,7 +29,7 @@ SCANGOBJ_OPTIONS=
 
 # Extra options to supply to gtkdoc-scan.
 # e.g. SCAN_OPTIONS=--deprecated-guards="GTK_DISABLE_DEPRECATED"
-SCAN_OPTIONS=
+SCAN_OPTIONS=--deprecated-guards="GNOME_KEYRING_DISABLE_DEPRECATED"
 
 # Extra options to supply to gtkdoc-mkdb.
 # e.g. MKDB_OPTIONS=--sgml-mode --output-format=xml
@@ -58,7 +58,13 @@ EXTRA_HFILES=
 
 # Header files to ignore when scanning. Use base file name, no paths
 # e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h
-IGNORE_HFILES=
+IGNORE_HFILES= \
+	gnome-keyring-private.h \
+	gkr-callback.h \
+	gkr-debug.h \
+	gkr-misc.h \
+	gkr-operation.h \
+	gkr-session.h
 
 # Images to copy into HTML directory.
 # e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png
diff --git a/docs/reference/gnome-keyring/gnome-keyring-sections.txt b/docs/reference/gnome-keyring/gnome-keyring-sections.txt
index e8e4977..3c70508 100644
--- a/docs/reference/gnome-keyring/gnome-keyring-sections.txt
+++ b/docs/reference/gnome-keyring/gnome-keyring-sections.txt
@@ -78,6 +78,10 @@ gnome_keyring_item_set_acl
 gnome_keyring_item_set_acl_sync
 gnome_keyring_item_grant_access_rights
 gnome_keyring_item_grant_access_rights_sync
+GNOME_KEYRING_ITEM_APPLICATION_SECRET
+GNOME_KEYRING_ITEM_INFO_ALL
+GNOME_KEYRING_ITEM_NO_TYPE
+GNOME_KEYRING_ITEM_TYPE_MASK
 </SECTION>
 <SECTION>
 <FILE>gnome-keyring-item-info</FILE>
@@ -122,6 +126,7 @@ gnome_keyring_attribute_list_copy
 GnomeKeyringAccessControl
 GnomeKeyringApplicationRef
 GnomeKeyringAccessType
+GnomeKeyringAccessRestriction
 gnome_keyring_application_ref_new
 gnome_keyring_application_ref_copy
 gnome_keyring_application_ref_free
@@ -173,6 +178,7 @@ gnome_keyring_memory_strdup
 <FILE>gnome-keyring-result</FILE>
 gnome_keyring_result_to_message
 GnomeKeyringResult
+GNOME_KEYRING_RESULT_ALREADY_EXISTS
 </SECTION>
 <SECTION>
 <FILE>gnome-keyring-generic-callbacks</FILE>
diff --git a/library/gkr-misc.c b/library/gkr-misc.c
index 02ffda0..ba2b6b6 100644
--- a/library/gkr-misc.c
+++ b/library/gkr-misc.c
@@ -29,6 +29,22 @@
 #include <stdlib.h>
 #include <string.h>
 
+/**
+ * GnomeKeyringAttributeType:
+ * @GNOME_KEYRING_ATTRIBUTE_TYPE_STRING: A UTF-8 encoded string attribute.
+ * @GNOME_KEYRING_ATTRIBUTE_TYPE_UINT32: A unsigned integer attribute.
+ *
+ * The data type of the item attribute.
+ */
+
+/**
+ * GnomeKeyringItemInfoFlags:
+ * @GNOME_KEYRING_ITEM_INFO_BASICS: Retrieve just the basic info about the item.
+ * @GNOME_KEYRING_ITEM_INFO_SECRET: Retrieve the item secret.
+ *
+ * The type of item info to retrieve with gnome_keyring_item_get_info_full().
+ */
+
 const gchar*
 gkr_service_name (void)
 {
diff --git a/library/gnome-keyring-private.h b/library/gnome-keyring-private.h
index cf011f1..d069473 100644
--- a/library/gnome-keyring-private.h
+++ b/library/gnome-keyring-private.h
@@ -42,6 +42,7 @@ struct GnomeKeyringAccessControl {
 };
 
 struct GnomeKeyringInfo {
+	/* <private> */
 	gboolean lock_on_idle;
 	guint32 lock_timeout;
 	time_t mtime;
diff --git a/library/gnome-keyring-utils.c b/library/gnome-keyring-utils.c
index d5eb93a..c0013d4 100644
--- a/library/gnome-keyring-utils.c
+++ b/library/gnome-keyring-utils.c
@@ -51,6 +51,86 @@
  * after doing this. You should use this function instead of g_free() for
  * secret information.
  **/
+
+/**
+ * GnomeKeyringAccessControl:
+ *
+ * A structure which contains access control information.
+ */
+
+/**
+ * GnomeKeyringItemType:
+ * @GNOME_KEYRING_ITEM_GENERIC_SECRET: Generic secret
+ * @GNOME_KEYRING_ITEM_NETWORK_PASSWORD: Network password
+ * @GNOME_KEYRING_ITEM_NOTE: Note
+ * @GNOME_KEYRING_ITEM_CHAINED_KEYRING_PASSWORD: Keyring password
+ * @GNOME_KEYRING_ITEM_ENCRYPTION_KEY_PASSWORD: Password for encryption key
+ * @GNOME_KEYRING_ITEM_PK_STORAGE: Key storage password
+ * @GNOME_KEYRING_ITEM_LAST_TYPE: Not used
+ *
+ * The types of items.
+ */
+
+/**
+ * GnomeKeyringResult:
+ * @GNOME_KEYRING_RESULT_OK: The operation completed successfully.
+ * @GNOME_KEYRING_RESULT_DENIED: Either the user or daemon denied access.
+ * @GNOME_KEYRING_RESULT_NO_KEYRING_DAEMON: Keyring daemon is not available.
+ * @GNOME_KEYRING_RESULT_ALREADY_UNLOCKED: Keyring was already unlocked.
+ * @GNOME_KEYRING_RESULT_NO_SUCH_KEYRING: No such keyring exists.
+ * @GNOME_KEYRING_RESULT_BAD_ARGUMENTS: Bad arguments to function.
+ * @GNOME_KEYRING_RESULT_IO_ERROR: Problem communicating with daemon.
+ * @GNOME_KEYRING_RESULT_CANCELLED: Operation was cancelled.
+ * @GNOME_KEYRING_RESULT_KEYRING_ALREADY_EXISTS: The keyring already exists.
+ * @GNOME_KEYRING_RESULT_NO_MATCH: No such match found.
+ *
+ * Various result codes returned by functions.
+ */
+
+/**
+ * GnomeKeyringAttribute:
+ * @name: The name of the attribute.
+ * @type: The data type.
+ *
+ * An item attribute. Set <code>string</code> if data type is
+ * %GNOME_KEYRING_ATTRIBUTE_TYPE_STRING or <code>integer</code> if data type is
+ * %GNOME_KEYRING_ATTRIBUTE_TYPE_UINT32
+ */
+
+/**
+ * GnomeKeyringAccessType:
+ * @GNOME_KEYRING_ACCESS_READ: Read access
+ * @GNOME_KEYRING_ACCESS_WRITE: Write access
+ * @GNOME_KEYRING_ACCESS_REMOVE: Delete access
+ *
+ * Type of access.
+ */
+
+/**
+ * GnomeKeyringAccessRestriction:
+ * @GNOME_KEYRING_ACCESS_ASK: Ask permission.
+ * @GNOME_KEYRING_ACCESS_DENY: Deny permission.
+ * @GNOME_KEYRING_ACCESS_ALLOW: Give permission.
+ *
+ * Type of access restriction.
+ */
+
+/**
+ * GnomeKeyringNetworkPasswordData:
+ * @keyring: Keyring item stored in.
+ * @item_id: The identifier of the item.
+ * @protocol: Network protocol or scheme.
+ * @server: Server or host name.
+ * @object: Share or other object on server.
+ * @authtype: Type of authentication.
+ * @port: TCP port.
+ * @user: User name.
+ * @domain: User domain
+ * @password: The password.
+ *
+ * Network password info.
+ */
+
 void
 gnome_keyring_free_password (gchar *password)
 {
@@ -124,14 +204,14 @@ gnome_keyring_result_to_message (GnomeKeyringResult res)
 }
 
 /**
- * gnome_keyring_found_free():
+ * gnome_keyring_found_free:
  * @found: a #GnomeKeyringFound
  *
  * Free the memory used by a #GnomeKeyringFound item.
  *
  * You usually want to use gnome_keyring_found_list_free() on the list of
  * results.
- **/
+ */
 void
 gnome_keyring_found_free (GnomeKeyringFound *found)
 {
@@ -490,7 +570,7 @@ gnome_keyring_access_control_free (GnomeKeyringAccessControl *ac)
 
 /**
  * gnome_keyring_access_control_copy:
- * @ac: A #GnomeKeyringAcessControl pointer
+ * @ac: A #GnomeKeyringAccessControl pointer
  *
  * Copy an access control for an item.
  *
@@ -809,7 +889,7 @@ gnome_keyring_item_ac_get_display_name (GnomeKeyringAccessControl *ac)
 
 /**
  * gnome_keyring_item_ac_set_display_name:
- * @ac: A #GnomeKeyringAcccessControl pointer.
+ * @ac: A #GnomeKeyringAccessControl pointer.
  * @value: The new application display name.
  *
  * Set the access control application's display name.
diff --git a/library/gnome-keyring.c b/library/gnome-keyring.c
index 0fee64d..d25ad0c 100644
--- a/library/gnome-keyring.c
+++ b/library/gnome-keyring.c
@@ -521,12 +521,16 @@ gnome_keyring_cancel_request (gpointer request)
  * @title: Keyrings
  * @short_description: Listing and managing keyrings
  *
- * %gnome-keyring-daemon manages multiple keyrings. Each keyring can store one or more items containing secrets.
+ * <code>gnome-keyring-daemon</code> manages multiple keyrings. Each keyring can
+ * store one or more items containing secrets.
  *
- * One of the keyrings is the default keyring, which can in many cases be used by specifying %NULL for a keyring name.
+ * One of the keyrings is the default keyring, which can in many cases be used
+ * by specifying %NULL for a keyring name.
  *
- * Each keyring can be in a locked or unlocked state. A password must be specified, either by the user or the calling application, to unlock the keyring.
- **/
+ * Each keyring can be in a locked or unlocked state. A password must be
+ * specified, either by the user or the calling application, to unlock the
+ * keyring.
+ */
 
 static GkrOperation*
 set_default_keyring_start (const gchar *keyring, GnomeKeyringOperationDoneCallback callback,
@@ -792,7 +796,7 @@ list_keyring_names_start (GnomeKeyringOperationGetListCallback callback,
  * the @callback. If no keyrings exist then an empty list will be passed to the
  * @callback. The list is freed after @callback returns.
  *
- * For a synchronous version of this function see gnome_keyring_list_keyrings_sync().
+ * For a synchronous version of this function see gnome_keyring_list_keyring_names_sync().
  *
  * Return value: The asychronous request, which can be passed to gnome_keyring_cancel_request().
  **/
@@ -1771,7 +1775,7 @@ set_keyring_info_start (const char *keyring, GnomeKeyringInfo *info,
  * @destroy_data: A function to free @data when it's no longer needed.
  *
  * Set flags and info for the @keyring. The only fields in @info that are used
- * are %lock_on_idle and %lock_timeout.
+ * are lock_on_idle and lock_timeout.
  *
  * For a synchronous version of this function see gnome_keyring_set_info_sync().
  *
@@ -1794,7 +1798,7 @@ gnome_keyring_set_info (const char                                  *keyring,
  * @info: A structure containing flags and info for the keyring.
  *
  * Set flags and info for @keyring. The only fields in @info that are used
- * are %lock_on_idle and %lock_timeout.
+ * are lock_on_idle and lock_timeout.
  *
  * For an asynchronous version of this function see gnome_keyring_set_info().
  *
@@ -2529,11 +2533,6 @@ gnome_keyring_find_itemsv_sync  (GnomeKeyringItemType        type,
  * Attributes allow various other pieces of information to be associated with an item.
  * These can also be used to search for relevant items. Attributes are accessed with
  * #GnomeKeyringAttribute structures and built into lists using #GnomeKeyringAttributeList.
- *
- * Each item has an access control list, which specifies the applications that
- * can read, write or delete an item. The read access applies only to reading the secret.
- * All applications can read other parts of the item. ACLs are accessed and changed
- * through #GnomeKeyringAccessControl pointers.
  **/
 
 typedef struct _item_create_args {
@@ -2889,7 +2888,7 @@ gnome_keyring_item_create (const char                          *keyring,
 }
 
 /**
- * gnome_keyring_item_create_sync():
+ * gnome_keyring_item_create_sync:
  * @keyring: The name of the keyring in which to create the item, or NULL for the default keyring.
  * @type: The item type.
  * @display_name: The name of the item. This will be displayed to the user where necessary.
@@ -2915,7 +2914,7 @@ gnome_keyring_item_create (const char                          *keyring,
  *
  * Return value: %GNOME_KEYRING_RESULT_OK if the operation was succcessful or
  * an error result otherwise.
- **/
+ */
 GnomeKeyringResult
 gnome_keyring_item_create_sync (const char                                 *keyring,
                                 GnomeKeyringItemType                        type,
@@ -3720,7 +3719,7 @@ item_get_acl_reply (GnomeKeyringResult res, gpointer user_data)
  * Return value: The asychronous request, which can be passed to gnome_keyring_cancel_request().
  *
  * Deprecated: Never returns any ACL values.
- **/
+ */
 gpointer
 gnome_keyring_item_get_acl (const char                                 *keyring,
                             guint32                                     id,
@@ -3817,7 +3816,7 @@ gnome_keyring_item_set_acl_sync (const char *keyring,
  * Since: 2.20
  *
  * Deprecated: This function no longer has any effect.
- **/
+ */
 gpointer
 gnome_keyring_item_grant_access_rights (const gchar *keyring,
                                         const gchar *display_name,
@@ -3849,7 +3848,7 @@ gnome_keyring_item_grant_access_rights (const gchar *keyring,
  * an error result otherwise.
  *
  * Deprecated: This function no longer has any effect.
- **/
+ */
 GnomeKeyringResult
 gnome_keyring_item_grant_access_rights_sync (const char                   *keyring,
                                              const char                   *display_name,
@@ -4769,6 +4768,17 @@ gnome_keyring_find_password (const GnomeKeyringPasswordSchema* schema,
 }
 
 /**
+ * GnomeKeyringFound:
+ * @keyring: The keyring the item was found in.
+ * @item_id: The identifier for the item.
+ * @attributes: The item's attributes.
+ * @secret: The item's secret.
+ *
+ * A found structure returned by a found operation. Use gnome_keyring_found_list_free()
+ * to free a list of these structures.
+ */
+
+/**
  * gnome_keyring_find_password_sync:
  * @schema: The password schema.
  * @password: An address to store password that was found. The password must
diff --git a/library/gnome-keyring.h b/library/gnome-keyring.h
index d0c194c..4190289 100644
--- a/library/gnome-keyring.h
+++ b/library/gnome-keyring.h
@@ -55,27 +55,13 @@ typedef enum {
 #define	GNOME_KEYRING_ITEM_APPLICATION_SECRET 0x01000000
 
 typedef enum {
-	GNOME_KEYRING_ACCESS_ASK,
-	GNOME_KEYRING_ACCESS_DENY,
-	GNOME_KEYRING_ACCESS_ALLOW
-} GnomeKeyringAccessRestriction;
-
-typedef enum {
 	GNOME_KEYRING_ATTRIBUTE_TYPE_STRING,
 	GNOME_KEYRING_ATTRIBUTE_TYPE_UINT32
 } GnomeKeyringAttributeType;
 
-typedef struct GnomeKeyringAccessControl GnomeKeyringAccessControl;
-typedef struct GnomeKeyringApplicationRef GnomeKeyringApplicationRef;
 typedef GArray GnomeKeyringAttributeList;
 
 typedef enum {
-	GNOME_KEYRING_ACCESS_READ = 1<<0,
-	GNOME_KEYRING_ACCESS_WRITE = 1<<1,
-	GNOME_KEYRING_ACCESS_REMOVE = 1<<2
-} GnomeKeyringAccessType;
-
-typedef enum {
 	GNOME_KEYRING_ITEM_INFO_BASICS = 0,
 	GNOME_KEYRING_ITEM_INFO_SECRET = 1<<0
 } GnomeKeyringItemInfoFlags;
@@ -316,38 +302,6 @@ gpointer           gnome_keyring_item_set_attributes      (const char
 GnomeKeyringResult gnome_keyring_item_set_attributes_sync (const char                                 *keyring,
                                                            guint32                                     id,
                                                            GnomeKeyringAttributeList                  *attributes);
-gpointer           gnome_keyring_item_get_acl             (const char                                 *keyring,
-                                                           guint32                                     id,
-                                                           GnomeKeyringOperationGetListCallback        callback,
-                                                           gpointer                                    data,
-                                                           GDestroyNotify                              destroy_data);
-GnomeKeyringResult gnome_keyring_item_get_acl_sync        (const char                                 *keyring,
-                                                           guint32                                     id,
-                                                           GList                                     **acl);
-gpointer           gnome_keyring_item_set_acl             (const char                                 *keyring,
-                                                           guint32                                     id,
-                                                           GList                                      *acl,
-                                                           GnomeKeyringOperationDoneCallback           callback,
-                                                           gpointer                                    data,
-                                                           GDestroyNotify                              destroy_data);
-GnomeKeyringResult gnome_keyring_item_set_acl_sync        (const char                                 *keyring,
-                                                           guint32                                     id,
-                                                           GList                                      *acl);
-
-gpointer           gnome_keyring_item_grant_access_rights      (const gchar                       *keyring,
-                                                                const gchar                       *display_name,
-                                                                const gchar                       *full_path,
-                                                                const guint32                      id,
-                                                                const GnomeKeyringAccessType       rights,
-                                                                GnomeKeyringOperationDoneCallback  callback,
-                                                                gpointer                           data,
-                                                                GDestroyNotify                     destroy_data);
-
-GnomeKeyringResult gnome_keyring_item_grant_access_rights_sync (const char                   *keyring,
-                                                                const char                   *display_name,
-                                                                const char                   *full_path,
-                                                                const guint32                id,
-                                                                const GnomeKeyringAccessType rights);
 
 void                  gnome_keyring_item_info_free             (GnomeKeyringItemInfo *item_info);
 GnomeKeyringItemInfo *gnome_keyring_item_info_new              (void);
@@ -364,33 +318,6 @@ void                  gnome_keyring_item_info_set_display_name (GnomeKeyringItem
 time_t                gnome_keyring_item_info_get_mtime        (GnomeKeyringItemInfo *item_info);
 time_t                gnome_keyring_item_info_get_ctime        (GnomeKeyringItemInfo *item_info);
 
-GnomeKeyringApplicationRef * gnome_keyring_application_ref_new          (void);
-GnomeKeyringApplicationRef * gnome_keyring_application_ref_copy         (const GnomeKeyringApplicationRef *app);
-void                         gnome_keyring_application_ref_free         (GnomeKeyringApplicationRef       *app);
-
-GnomeKeyringAccessControl *  gnome_keyring_access_control_new  (const GnomeKeyringApplicationRef *application,
-                                                                GnomeKeyringAccessType            types_allowed);
-GnomeKeyringAccessControl *  gnome_keyring_access_control_copy (GnomeKeyringAccessControl        *ac);
-
-
-void    gnome_keyring_access_control_free (GnomeKeyringAccessControl *ac);
-GList * gnome_keyring_acl_copy            (GList                     *list);
-void    gnome_keyring_acl_free            (GList                     *acl);
-
-
-char *                gnome_keyring_item_ac_get_display_name   (GnomeKeyringAccessControl *ac);
-void                  gnome_keyring_item_ac_set_display_name   (GnomeKeyringAccessControl *ac,
-                                                                const char           *value);
-
-char *                gnome_keyring_item_ac_get_path_name      (GnomeKeyringAccessControl *ac);
-void                  gnome_keyring_item_ac_set_path_name      (GnomeKeyringAccessControl *ac,
-                                                                const char           *value);
-
-
-GnomeKeyringAccessType gnome_keyring_item_ac_get_access_type   (GnomeKeyringAccessControl *ac);
-void                   gnome_keyring_item_ac_set_access_type   (GnomeKeyringAccessControl *ac,
-                                                                const GnomeKeyringAccessType value);
-
 /* ------------------------------------------------------------------------------
  * A Simpler API
  */
@@ -510,13 +437,92 @@ GnomeKeyringResult gnome_keyring_set_network_password_sync  (const char
                                                              guint32                               *item_id);
 
 /* -----------------------------------------------------------------------------
- * USED ONLY BY THE SESSION
+ * DEPRECATED STUFF
  */
 
-/* Deprecated */
-GnomeKeyringResult    gnome_keyring_daemon_set_display_sync         (const char *display);
+#ifndef GNOME_KEYRING_DISABLE_DEPRECATED
+
+typedef enum {
+	GNOME_KEYRING_ACCESS_ASK,
+	GNOME_KEYRING_ACCESS_DENY,
+	GNOME_KEYRING_ACCESS_ALLOW
+} GnomeKeyringAccessRestriction;
+
+typedef struct GnomeKeyringAccessControl GnomeKeyringAccessControl;
+typedef struct GnomeKeyringApplicationRef GnomeKeyringApplicationRef;
+
+typedef enum {
+	GNOME_KEYRING_ACCESS_READ = 1<<0,
+	GNOME_KEYRING_ACCESS_WRITE = 1<<1,
+	GNOME_KEYRING_ACCESS_REMOVE = 1<<2
+} GnomeKeyringAccessType;
+
+GnomeKeyringResult gnome_keyring_daemon_set_display_sync       (const char *display);
+
+GnomeKeyringResult gnome_keyring_daemon_prepare_environment_sync (void);
+
+gpointer           gnome_keyring_item_grant_access_rights      (const gchar                       *keyring,
+                                                                const gchar                       *display_name,
+                                                                const gchar                       *full_path,
+                                                                const guint32                      id,
+                                                                const GnomeKeyringAccessType       rights,
+                                                                GnomeKeyringOperationDoneCallback  callback,
+                                                                gpointer                           data,
+                                                                GDestroyNotify                     destroy_data);
+
+GnomeKeyringResult gnome_keyring_item_grant_access_rights_sync (const char                   *keyring,
+                                                                const char                   *display_name,
+                                                                const char                   *full_path,
+                                                                const guint32                id,
+                                                                const GnomeKeyringAccessType rights);
+
+
+GnomeKeyringApplicationRef * gnome_keyring_application_ref_new          (void);
+GnomeKeyringApplicationRef * gnome_keyring_application_ref_copy         (const GnomeKeyringApplicationRef *app);
+void                         gnome_keyring_application_ref_free         (GnomeKeyringApplicationRef       *app);
+
+GnomeKeyringAccessControl *  gnome_keyring_access_control_new  (const GnomeKeyringApplicationRef *application,
+                                                                GnomeKeyringAccessType            types_allowed);
+GnomeKeyringAccessControl *  gnome_keyring_access_control_copy (GnomeKeyringAccessControl        *ac);
+
+
+void    gnome_keyring_access_control_free (GnomeKeyringAccessControl *ac);
+GList * gnome_keyring_acl_copy            (GList                     *list);
+void    gnome_keyring_acl_free            (GList                     *acl);
+
+
+char *                gnome_keyring_item_ac_get_display_name   (GnomeKeyringAccessControl *ac);
+void                  gnome_keyring_item_ac_set_display_name   (GnomeKeyringAccessControl *ac,
+                                                                const char           *value);
+
+char *                gnome_keyring_item_ac_get_path_name      (GnomeKeyringAccessControl *ac);
+void                  gnome_keyring_item_ac_set_path_name      (GnomeKeyringAccessControl *ac,
+                                                                const char           *value);
+
+
+GnomeKeyringAccessType gnome_keyring_item_ac_get_access_type   (GnomeKeyringAccessControl *ac);
+void                   gnome_keyring_item_ac_set_access_type   (GnomeKeyringAccessControl *ac,
+                                                                const GnomeKeyringAccessType value);
+
+gpointer           gnome_keyring_item_get_acl             (const char                                 *keyring,
+                                                           guint32                                     id,
+                                                           GnomeKeyringOperationGetListCallback        callback,
+                                                           gpointer                                    data,
+                                                           GDestroyNotify                              destroy_data);
+GnomeKeyringResult gnome_keyring_item_get_acl_sync        (const char                                 *keyring,
+                                                           guint32                                     id,
+                                                           GList                                     **acl);
+gpointer           gnome_keyring_item_set_acl             (const char                                 *keyring,
+                                                           guint32                                     id,
+                                                           GList                                      *acl,
+                                                           GnomeKeyringOperationDoneCallback           callback,
+                                                           gpointer                                    data,
+                                                           GDestroyNotify                              destroy_data);
+GnomeKeyringResult gnome_keyring_item_set_acl_sync        (const char                                 *keyring,
+                                                           guint32                                     id,
+                                                           GList                                      *acl);
 
-GnomeKeyringResult    gnome_keyring_daemon_prepare_environment_sync (void);
+#endif /* GNOME_KEYRING_DISABLE_DEPRECATED */
 
 G_END_DECLS
 



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