[libsecret: 7/13] docs: Remove large indentations




commit 56bf2c8fe9c887b01ccd9e6b13eace117f959886
Author: Maximiliano Sandoval R <msandova gnome org>
Date:   Sat Feb 5 22:01:47 2022 +0100

    docs: Remove large indentations
    
    Indentations by more than four spaces make gi-docgen read them as a
    quote block.

 libsecret/secret-backend.c     |  4 ++--
 libsecret/secret-methods.c     | 12 +++++-----
 libsecret/secret-password.c    | 14 +++++------
 libsecret/secret-paths.c       | 54 +++++++++++++++++++++---------------------
 libsecret/secret-retrievable.c |  4 ++--
 libsecret/secret-schema.c      |  2 +-
 libsecret/secret-service.c     | 14 +++++------
 7 files changed, 52 insertions(+), 52 deletions(-)
---
diff --git a/libsecret/secret-backend.c b/libsecret/secret-backend.c
index 2a74ad7..47b495f 100644
--- a/libsecret/secret-backend.c
+++ b/libsecret/secret-backend.c
@@ -66,9 +66,9 @@
  * SecretBackendFlags:
  * @SECRET_BACKEND_NONE: no flags for initializing the #SecretBackend
  * @SECRET_BACKEND_OPEN_SESSION: establish a session for transfer of secrets
- *                               while initializing the #SecretBackend
+ *   while initializing the #SecretBackend
  * @SECRET_BACKEND_LOAD_COLLECTIONS: load collections while initializing the
- *                                   #SecretBackend
+ *   #SecretBackend
  *
  * Flags which determine which parts of the #SecretBackend are initialized.
  *
diff --git a/libsecret/secret-methods.c b/libsecret/secret-methods.c
index bea98f6..aa7539d 100644
--- a/libsecret/secret-methods.c
+++ b/libsecret/secret-methods.c
@@ -764,7 +764,7 @@ secret_service_lock (SecretService *service,
  * @service: (nullable): the secret service
  * @result: asynchronous result passed to the callback
  * @locked: (out) (element-type Gio.DBusProxy) (transfer full) (nullable) (optional):
- *          location to place list of items or collections that were locked
+ *   location to place list of items or collections that were locked
  * @error: location to place an error on failure
  *
  * Complete asynchronous operation to lock items or collections in the secret
@@ -793,7 +793,7 @@ secret_service_lock_finish (SecretService *service,
  * @objects: (element-type Gio.DBusProxy): the items or collections to lock
  * @cancellable: (nullable): optional cancellation object
  * @locked: (out) (element-type Gio.DBusProxy) (transfer full) (nullable) (optional):
- *          location to place list of items or collections that were locked
+ *   location to place list of items or collections that were locked
  * @error: location to place an error on failure
  *
  * Lock items or collections in the secret service.
@@ -878,7 +878,7 @@ secret_service_unlock (SecretService *service,
  * @service: (nullable): the secret service
  * @result: asynchronous result passed to the callback
  * @unlocked: (out) (element-type Gio.DBusProxy) (transfer full) (nullable) (optional):
- *            location to place list of items or collections that were unlocked
+ *   location to place list of items or collections that were unlocked
  * @error: location to place an error on failure
  *
  * Complete asynchronous operation to unlock items or collections in the secret
@@ -907,7 +907,7 @@ secret_service_unlock_finish (SecretService *service,
  * @objects: (element-type Gio.DBusProxy): the items or collections to unlock
  * @cancellable: (nullable): optional cancellation object
  * @unlocked: (out) (element-type Gio.DBusProxy) (transfer full) (nullable) (optional):
- *            location to place list of items or collections that were unlocked
+ *   location to place list of items or collections that were unlocked
  * @error: location to place an error on failure
  *
  * Unlock items or collections in the secret service.
@@ -1121,7 +1121,7 @@ on_store_service (GObject *source,
  * @schema: (nullable): the schema to use to check attributes
  * @attributes: (element-type utf8 utf8): the attribute keys and values
  * @collection: (nullable): a collection alias, or D-Bus object path of the
- *              collection where to store the secret
+ *   collection where to store the secret
  * @label: label for the secret
  * @value: the secret value
  * @cancellable: (nullable): optional cancellation object
@@ -1241,7 +1241,7 @@ secret_service_store_finish (SecretService *service,
  * @schema: (nullable): the schema for the attributes
  * @attributes: (element-type utf8 utf8): the attribute keys and values
  * @collection: (nullable): a collection alias, or D-Bus object path of the
- *              collection where to store the secret
+ *   collection where to store the secret
  * @label: label for the secret
  * @value: the secret value
  * @cancellable: (nullable): optional cancellation object
diff --git a/libsecret/secret-password.c b/libsecret/secret-password.c
index deabdf3..ac6214e 100644
--- a/libsecret/secret-password.c
+++ b/libsecret/secret-password.c
@@ -27,7 +27,7 @@
  * secret_password_store: (skip)
  * @schema: the schema for attributes
  * @collection: (nullable): a collection alias, or D-Bus object path of the
- *              collection where to store the secret
+ *   collection where to store the secret
  * @label: label for the secret
  * @password: the null-terminated password to store
  * @cancellable: (nullable): optional cancellation object
@@ -159,7 +159,7 @@ on_store_backend (GObject *source,
  * @schema: (nullable): the schema for attributes
  * @attributes: (element-type utf8 utf8) (transfer full): the attribute keys and values
  * @collection: (nullable): a collection alias, or D-Bus object path of the
- *              collection where to store the secret
+ *   collection where to store the secret
  * @label: label for the secret
  * @password: the null-terminated password to store
  * @cancellable: (nullable): optional cancellation object
@@ -273,7 +273,7 @@ secret_password_store_binary (const SecretSchema *schema,
  * @schema: (nullable): the schema for attributes
  * @attributes: (element-type utf8 utf8) (transfer full): the attribute keys and values
  * @collection: (nullable): a collection alias, or D-Bus object path of the
- *              collection where to store the secret
+ *   collection where to store the secret
  * @label: label for the secret
  * @value: a [struct@Value]
  * @cancellable: (nullable): optional cancellation object
@@ -348,7 +348,7 @@ secret_password_store_finish (GAsyncResult *result,
  * secret_password_store_sync:
  * @schema: the schema for attributes
  * @collection: (nullable): a collection alias, or D-Bus object path of the
- *              collection where to store the secret
+ *   collection where to store the secret
  * @label: label for the secret
  * @password: the null-terminated password to store
  * @cancellable: (nullable): optional cancellation object
@@ -413,7 +413,7 @@ secret_password_store_sync (const SecretSchema *schema,
  * @schema: (nullable): the schema for attributes
  * @attributes: (element-type utf8 utf8): the attribute keys and values
  * @collection: (nullable): a collection alias, or D-Bus object path of the
- *              collection where to store the secret
+ *   collection where to store the secret
  * @label: label for the secret
  * @password: the null-terminated password to store
  * @cancellable: (nullable): optional cancellation object
@@ -477,7 +477,7 @@ secret_password_storev_sync (const SecretSchema *schema,
  * secret_password_store_binary_sync:
  * @schema: the schema for attributes
  * @collection: (nullable): a collection alias, or D-Bus object path of the
- *              collection where to store the secret
+ *   collection where to store the secret
  * @label: label for the secret
  * @value: a [struct@Value]
  * @cancellable: (nullable): optional cancellation object
@@ -535,7 +535,7 @@ secret_password_store_binary_sync (const SecretSchema *schema,
  * @schema: (nullable): the schema for attributes
  * @attributes: (element-type utf8 utf8): the attribute keys and values
  * @collection: (nullable): a collection alias, or D-Bus object path of the
- *              collection where to store the secret
+ *   collection where to store the secret
  * @label: label for the secret
  * @value: a [struct@Value]
  * @cancellable: (nullable): optional cancellation object
diff --git a/libsecret/secret-paths.c b/libsecret/secret-paths.c
index 0b044a1..96ffa07 100644
--- a/libsecret/secret-paths.c
+++ b/libsecret/secret-paths.c
@@ -532,11 +532,11 @@ _secret_service_search_for_paths_variant (SecretService *self,
  * @self: the secret service
  * @result: asynchronous result passed to callback
  * @unlocked: (out) (transfer full) (array zero-terminated=1) (optional) (nullable):
- *            location to place an array of D-Bus object paths for matching
- *            items which were locked.
+ *   location to place an array of D-Bus object paths for matching
+ *   items which were locked.
  * @locked: (out) (transfer full) (array zero-terminated=1) (optional) (nullable):
- *          location to place an array of D-Bus object paths for matching
- *          items which were locked.
+ *   location to place an array of D-Bus object paths for matching
+ *   items which were locked.
  * @error: location to place error on failure
  *
  * Complete asynchronous operation to search for items, and return their
@@ -596,11 +596,11 @@ secret_service_search_for_dbus_paths_finish (SecretService *self,
  * @attributes: (element-type utf8 utf8): search for items matching these attributes
  * @cancellable: (nullable): optional cancellation object
  * @unlocked: (out) (transfer full) (array zero-terminated=1) (optional) (nullable):
- *            location to place an array of D-Bus object paths for matching
- *            items which were locked.
+ *   location to place an array of D-Bus object paths for matching
+ *   items which were locked.
  * @locked: (out) (transfer full) (array zero-terminated=1) (optional) (nullable):
- *          location to place an array of D-Bus object paths for matching
- *          items which were locked.
+ *   location to place an array of D-Bus object paths for matching
+ *   items which were locked.
  * @error: location to place error on failure
  *
  * Search for items matching the @attributes, and return their D-Bus object
@@ -1141,8 +1141,8 @@ _secret_service_xlock_paths_finish (SecretService *self,
  * @paths: (array zero-terminated=1): the D-Bus object paths of the items or collections to lock
  * @cancellable: (nullable): optional cancellation object
  * @locked: (out) (array zero-terminated=1) (transfer full) (optional) (nullable):
- *          location to place array of D-Bus paths of items or collections
- *          that were locked
+ *   location to place array of D-Bus paths of items or collections
+ *   that were locked
  * @error: location to place an error on failure
  *
  * Lock items or collections in the secret service.
@@ -1237,8 +1237,8 @@ secret_service_lock_dbus_paths (SecretService *self,
  * @self: the secret service
  * @result: asynchronous result passed to the callback
  * @locked: (out) (array zero-terminated=1) (transfer full) (optional) (nullable):
- *          location to place array of D-Bus paths of items or collections
- *          that were locked
+ *   location to place array of D-Bus paths of items or collections
+ *   that were locked
  * @error: location to place an error on failure
  *
  * Complete asynchronous operation to lock items or collections in the secret
@@ -1268,11 +1268,11 @@ secret_service_lock_dbus_paths_finish (SecretService *self,
  * secret_service_unlock_dbus_paths_sync: (skip)
  * @self: the secret service
  * @paths: (array zero-terminated=1): the D-Bus object paths of the items or
- *         collections to unlock
+ *   collections to unlock
  * @cancellable: (nullable): optional cancellation object
  * @unlocked: (out) (array zero-terminated=1) (transfer full) (optional) (nullable):
- *            location to place array of D-Bus paths of items or collections
- *            that were unlocked
+ *   location to place array of D-Bus paths of items or collections
+ *   that were unlocked
  * @error: location to place an error on failure
  *
  * Unlock items or collections in the secret service.
@@ -1328,7 +1328,7 @@ secret_service_unlock_dbus_paths_sync (SecretService *self,
  * secret_service_unlock_dbus_paths: (skip)
  * @self: the secret service
  * @paths: (array zero-terminated=1): the D-Bus paths for items or
- *         collections to unlock
+ *   collections to unlock
  * @cancellable: (nullable): optional cancellation object
  * @callback: called when the operation completes
  * @user_data: data to pass to the callback
@@ -1369,8 +1369,8 @@ secret_service_unlock_dbus_paths (SecretService *self,
  * @self: the secret service
  * @result: asynchronous result passed to the callback
  * @unlocked: (out) (array zero-terminated=1) (transfer full) (optional) (nullable):
- *            location to place array of D-Bus paths of items or collections
- *            that were unlocked
+ *   location to place array of D-Bus paths of items or collections
+ *   that were unlocked
  * @error: location to place an error on failure
  *
  * Complete asynchronous operation to unlock items or collections in the secret
@@ -1694,9 +1694,9 @@ on_create_collection_called (GObject *source,
  * secret_service_create_collection_dbus_path: (skip)
  * @self: a secret service object
  * @properties: (element-type utf8 GLib.Variant): hash table of properties for
- *              the new collection
+ *   the new collection
  * @alias: (nullable): an alias to check for before creating the new
- *         collection, or to assign to the new collection
+ *   collection, or to assign to the new collection
  * @flags: not currently used
  * @cancellable: (nullable): optional cancellation object
  * @callback: called when the operation completes
@@ -1811,9 +1811,9 @@ secret_service_create_collection_dbus_path_finish (SecretService *self,
  * secret_service_create_collection_dbus_path_sync: (skip)
  * @self: a secret service object
  * @properties: (element-type utf8 GLib.Variant): hash table of D-Bus properties
- *              for the new collection
+ *   for the new collection
  * @alias: (nullable): an alias to check for before creating the new
- *         collection, or to assign to the new collection
+ *   collection, or to assign to the new collection
  * @flags: not currently used
  * @cancellable: (nullable): optional cancellation object
  * @error: location to place an error on failure
@@ -1843,7 +1843,7 @@ secret_service_create_collection_dbus_path_finish (SecretService *self,
  * Stability: Unstable
  *
  * Returns: (transfer full): a new string containing the D-Bus object path
- *          of the collection
+ *   of the collection
  */
 gchar *
 secret_service_create_collection_dbus_path_sync (SecretService *self,
@@ -1998,7 +1998,7 @@ on_create_item_session (GObject *source,
  * @self: a secret service object
  * @collection_path: the D-Bus object path of the collection in which to create item
  * @properties: (element-type utf8 GLib.Variant): hash table of D-Bus properties
- *              for the new collection
+ *   for the new collection
  * @value: the secret value to store in the item
  * @flags: flags for the creation of the new item
  * @cancellable: (nullable): optional cancellation object
@@ -2120,7 +2120,7 @@ _secret_service_create_item_dbus_path_finish_raw (GAsyncResult *result,
  * @self: a secret service object
  * @collection_path: the D-Bus path of the collection in which to create item
  * @properties: (element-type utf8 GLib.Variant): hash table of D-Bus properties
- *              for the new collection
+ *   for the new collection
  * @value: the secret value to store in the item
  * @flags: flags for the creation of the new item
  * @cancellable: (nullable): optional cancellation object
@@ -2149,7 +2149,7 @@ _secret_service_create_item_dbus_path_finish_raw (GAsyncResult *result,
  * Stability: Unstable
  *
  * Returns: (transfer full): a new string containing the D-Bus object path
- *          of the item
+ *   of the item
  */
 gchar *
 secret_service_create_item_dbus_path_sync (SecretService *self,
@@ -2385,7 +2385,7 @@ secret_service_set_alias_to_dbus_path_finish (SecretService *self,
  * @self: a secret service object
  * @alias: the alias to assign the collection to
  * @collection_path: (nullable): the D-Bus object path of the collection to
- *                   assign to the alias
+ *   assign to the alias
  * @cancellable: (nullable): optional cancellation object
  * @error: location to place error on failure
  *
diff --git a/libsecret/secret-retrievable.c b/libsecret/secret-retrievable.c
index 37d1bb6..2ee474d 100644
--- a/libsecret/secret-retrievable.c
+++ b/libsecret/secret-retrievable.c
@@ -45,9 +45,9 @@
  * SecretRetrievableInterface:
  * @parent_iface: the parent interface
  * @retrieve_secret: implementation of [method@Retrievable.retrieve_secret],
- *                   required
+ *   required
  * @retrieve_secret_finish: implementation of
- *                   [method@Retrievable.retrieve_secret_finish], required
+ *   [method@Retrievable.retrieve_secret_finish], required
  *
  * The interface for #SecretRetrievable.
  *
diff --git a/libsecret/secret-schema.c b/libsecret/secret-schema.c
index 4af52c0..7e21106 100644
--- a/libsecret/secret-schema.c
+++ b/libsecret/secret-schema.c
@@ -89,7 +89,7 @@
  * SecretSchemaFlags:
  * @SECRET_SCHEMA_NONE: no flags for the schema
  * @SECRET_SCHEMA_DONT_MATCH_NAME: don't match the schema name when looking up or
- *                                 removing passwords
+ *   removing passwords
  *
  * Flags for a #SecretSchema definition.
  */
diff --git a/libsecret/secret-service.c b/libsecret/secret-service.c
index 5d281b9..aabbac7 100644
--- a/libsecret/secret-service.c
+++ b/libsecret/secret-service.c
@@ -76,16 +76,16 @@
  * SecretServiceClass:
  * @parent_class: the parent class
  * @collection_gtype: the [alias GLib Type] of the [class@Collection] objects instantiated
- *                    by the #SecretService proxy
+ *   by the #SecretService proxy
  * @item_gtype: the [alias GLib Type] of the [class@Item] objects instantiated by the
- *              #SecretService proxy
+ *   #SecretService proxy
  * @prompt_async: called to perform asynchronous prompting when necessary
  * @prompt_finish: called to complete an asynchronous prompt operation
  * @prompt_sync: called to perform synchronous prompting when necessary
  * @get_collection_gtype: called to get the GObject type for collections
- *                        instantiated by the #SecretService proxy
+ *   instantiated by the #SecretService proxy
  * @get_item_gtype: called to get the GObject type for collections
- *                  instantiated by the #SecretService proxy
+ *   instantiated by the #SecretService proxy
  *
  * The class for #SecretService.
  */
@@ -94,9 +94,9 @@
  * SecretServiceFlags:
  * @SECRET_SERVICE_NONE: no flags for initializing the #SecretService
  * @SECRET_SERVICE_OPEN_SESSION: establish a session for transfer of secrets
- *                               while initializing the #SecretService
+ *   while initializing the #SecretService
  * @SECRET_SERVICE_LOAD_COLLECTIONS: load collections while initializing the
- *                                   #SecretService
+ *   #SecretService
  *
  * Flags which determine which parts of the #SecretService proxy are initialized
  * during a [func Service get] or [func Service open] operation.
@@ -1365,7 +1365,7 @@ _secret_service_take_session (SecretService *self,
  * [method@Service.ensure_session] to establish a session.
  *
  * Returns: (nullable): a string representing the algorithms for transferring
- *          secrets
+ *   secrets
  */
 const gchar *
 secret_service_get_session_algorithms (SecretService *self)


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