docs: Remove large indentations

Indentations by more than four spaces make gi-docgen read them as a
quote block.
This commit is contained in:
Maximiliano Sandoval R 2022-02-05 22:01:47 +01:00
parent 3f9738bdd4
commit 56bf2c8fe9
No known key found for this signature in database
GPG Key ID: D64A8D747F6FE706
7 changed files with 52 additions and 52 deletions

View File

@ -66,9 +66,9 @@
* SecretBackendFlags: * SecretBackendFlags:
* @SECRET_BACKEND_NONE: no flags for initializing the #SecretBackend * @SECRET_BACKEND_NONE: no flags for initializing the #SecretBackend
* @SECRET_BACKEND_OPEN_SESSION: establish a session for transfer of secrets * @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 * @SECRET_BACKEND_LOAD_COLLECTIONS: load collections while initializing the
* #SecretBackend * #SecretBackend
* *
* Flags which determine which parts of the #SecretBackend are initialized. * Flags which determine which parts of the #SecretBackend are initialized.
* *

View File

@ -764,7 +764,7 @@ secret_service_lock (SecretService *service,
* @service: (nullable): the secret service * @service: (nullable): the secret service
* @result: asynchronous result passed to the callback * @result: asynchronous result passed to the callback
* @locked: (out) (element-type Gio.DBusProxy) (transfer full) (nullable) (optional): * @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 * @error: location to place an error on failure
* *
* Complete asynchronous operation to lock items or collections in the secret * 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 * @objects: (element-type Gio.DBusProxy): the items or collections to lock
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object
* @locked: (out) (element-type Gio.DBusProxy) (transfer full) (nullable) (optional): * @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 * @error: location to place an error on failure
* *
* Lock items or collections in the secret service. * Lock items or collections in the secret service.
@ -878,7 +878,7 @@ secret_service_unlock (SecretService *service,
* @service: (nullable): the secret service * @service: (nullable): the secret service
* @result: asynchronous result passed to the callback * @result: asynchronous result passed to the callback
* @unlocked: (out) (element-type Gio.DBusProxy) (transfer full) (nullable) (optional): * @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 * @error: location to place an error on failure
* *
* Complete asynchronous operation to unlock items or collections in the secret * 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 * @objects: (element-type Gio.DBusProxy): the items or collections to unlock
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object
* @unlocked: (out) (element-type Gio.DBusProxy) (transfer full) (nullable) (optional): * @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 * @error: location to place an error on failure
* *
* Unlock items or collections in the secret service. * 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 * @schema: (nullable): the schema to use to check attributes
* @attributes: (element-type utf8 utf8): the attribute keys and values * @attributes: (element-type utf8 utf8): the attribute keys and values
* @collection: (nullable): a collection alias, or D-Bus object path of the * @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 * @label: label for the secret
* @value: the secret value * @value: the secret value
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object
@ -1241,7 +1241,7 @@ secret_service_store_finish (SecretService *service,
* @schema: (nullable): the schema for the attributes * @schema: (nullable): the schema for the attributes
* @attributes: (element-type utf8 utf8): the attribute keys and values * @attributes: (element-type utf8 utf8): the attribute keys and values
* @collection: (nullable): a collection alias, or D-Bus object path of the * @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 * @label: label for the secret
* @value: the secret value * @value: the secret value
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object

View File

@ -27,7 +27,7 @@
* secret_password_store: (skip) * secret_password_store: (skip)
* @schema: the schema for attributes * @schema: the schema for attributes
* @collection: (nullable): a collection alias, or D-Bus object path of the * @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 * @label: label for the secret
* @password: the null-terminated password to store * @password: the null-terminated password to store
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object
@ -159,7 +159,7 @@ on_store_backend (GObject *source,
* @schema: (nullable): the schema for attributes * @schema: (nullable): the schema for attributes
* @attributes: (element-type utf8 utf8) (transfer full): the attribute keys and values * @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: (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 * @label: label for the secret
* @password: the null-terminated password to store * @password: the null-terminated password to store
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object
@ -273,7 +273,7 @@ secret_password_store_binary (const SecretSchema *schema,
* @schema: (nullable): the schema for attributes * @schema: (nullable): the schema for attributes
* @attributes: (element-type utf8 utf8) (transfer full): the attribute keys and values * @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: (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 * @label: label for the secret
* @value: a [struct@Value] * @value: a [struct@Value]
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object
@ -348,7 +348,7 @@ secret_password_store_finish (GAsyncResult *result,
* secret_password_store_sync: * secret_password_store_sync:
* @schema: the schema for attributes * @schema: the schema for attributes
* @collection: (nullable): a collection alias, or D-Bus object path of the * @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 * @label: label for the secret
* @password: the null-terminated password to store * @password: the null-terminated password to store
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object
@ -413,7 +413,7 @@ secret_password_store_sync (const SecretSchema *schema,
* @schema: (nullable): the schema for attributes * @schema: (nullable): the schema for attributes
* @attributes: (element-type utf8 utf8): the attribute keys and values * @attributes: (element-type utf8 utf8): the attribute keys and values
* @collection: (nullable): a collection alias, or D-Bus object path of the * @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 * @label: label for the secret
* @password: the null-terminated password to store * @password: the null-terminated password to store
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object
@ -477,7 +477,7 @@ secret_password_storev_sync (const SecretSchema *schema,
* secret_password_store_binary_sync: * secret_password_store_binary_sync:
* @schema: the schema for attributes * @schema: the schema for attributes
* @collection: (nullable): a collection alias, or D-Bus object path of the * @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 * @label: label for the secret
* @value: a [struct@Value] * @value: a [struct@Value]
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object
@ -535,7 +535,7 @@ secret_password_store_binary_sync (const SecretSchema *schema,
* @schema: (nullable): the schema for attributes * @schema: (nullable): the schema for attributes
* @attributes: (element-type utf8 utf8): the attribute keys and values * @attributes: (element-type utf8 utf8): the attribute keys and values
* @collection: (nullable): a collection alias, or D-Bus object path of the * @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 * @label: label for the secret
* @value: a [struct@Value] * @value: a [struct@Value]
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object

View File

@ -532,11 +532,11 @@ _secret_service_search_for_paths_variant (SecretService *self,
* @self: the secret service * @self: the secret service
* @result: asynchronous result passed to callback * @result: asynchronous result passed to callback
* @unlocked: (out) (transfer full) (array zero-terminated=1) (optional) (nullable): * @unlocked: (out) (transfer full) (array zero-terminated=1) (optional) (nullable):
* location to place an array of D-Bus object paths for matching * location to place an array of D-Bus object paths for matching
* items which were locked. * items which were locked.
* @locked: (out) (transfer full) (array zero-terminated=1) (optional) (nullable): * @locked: (out) (transfer full) (array zero-terminated=1) (optional) (nullable):
* location to place an array of D-Bus object paths for matching * location to place an array of D-Bus object paths for matching
* items which were locked. * items which were locked.
* @error: location to place error on failure * @error: location to place error on failure
* *
* Complete asynchronous operation to search for items, and return their * 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 * @attributes: (element-type utf8 utf8): search for items matching these attributes
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object
* @unlocked: (out) (transfer full) (array zero-terminated=1) (optional) (nullable): * @unlocked: (out) (transfer full) (array zero-terminated=1) (optional) (nullable):
* location to place an array of D-Bus object paths for matching * location to place an array of D-Bus object paths for matching
* items which were locked. * items which were locked.
* @locked: (out) (transfer full) (array zero-terminated=1) (optional) (nullable): * @locked: (out) (transfer full) (array zero-terminated=1) (optional) (nullable):
* location to place an array of D-Bus object paths for matching * location to place an array of D-Bus object paths for matching
* items which were locked. * items which were locked.
* @error: location to place error on failure * @error: location to place error on failure
* *
* Search for items matching the @attributes, and return their D-Bus object * 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 * @paths: (array zero-terminated=1): the D-Bus object paths of the items or collections to lock
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object
* @locked: (out) (array zero-terminated=1) (transfer full) (optional) (nullable): * @locked: (out) (array zero-terminated=1) (transfer full) (optional) (nullable):
* location to place array of D-Bus paths of items or collections * location to place array of D-Bus paths of items or collections
* that were locked * that were locked
* @error: location to place an error on failure * @error: location to place an error on failure
* *
* Lock items or collections in the secret service. * Lock items or collections in the secret service.
@ -1237,8 +1237,8 @@ secret_service_lock_dbus_paths (SecretService *self,
* @self: the secret service * @self: the secret service
* @result: asynchronous result passed to the callback * @result: asynchronous result passed to the callback
* @locked: (out) (array zero-terminated=1) (transfer full) (optional) (nullable): * @locked: (out) (array zero-terminated=1) (transfer full) (optional) (nullable):
* location to place array of D-Bus paths of items or collections * location to place array of D-Bus paths of items or collections
* that were locked * that were locked
* @error: location to place an error on failure * @error: location to place an error on failure
* *
* Complete asynchronous operation to lock items or collections in the secret * 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) * secret_service_unlock_dbus_paths_sync: (skip)
* @self: the secret service * @self: the secret service
* @paths: (array zero-terminated=1): the D-Bus object paths of the items or * @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 * @cancellable: (nullable): optional cancellation object
* @unlocked: (out) (array zero-terminated=1) (transfer full) (optional) (nullable): * @unlocked: (out) (array zero-terminated=1) (transfer full) (optional) (nullable):
* location to place array of D-Bus paths of items or collections * location to place array of D-Bus paths of items or collections
* that were unlocked * that were unlocked
* @error: location to place an error on failure * @error: location to place an error on failure
* *
* Unlock items or collections in the secret service. * 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) * secret_service_unlock_dbus_paths: (skip)
* @self: the secret service * @self: the secret service
* @paths: (array zero-terminated=1): the D-Bus paths for items or * @paths: (array zero-terminated=1): the D-Bus paths for items or
* collections to unlock * collections to unlock
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object
* @callback: called when the operation completes * @callback: called when the operation completes
* @user_data: data to pass to the callback * @user_data: data to pass to the callback
@ -1369,8 +1369,8 @@ secret_service_unlock_dbus_paths (SecretService *self,
* @self: the secret service * @self: the secret service
* @result: asynchronous result passed to the callback * @result: asynchronous result passed to the callback
* @unlocked: (out) (array zero-terminated=1) (transfer full) (optional) (nullable): * @unlocked: (out) (array zero-terminated=1) (transfer full) (optional) (nullable):
* location to place array of D-Bus paths of items or collections * location to place array of D-Bus paths of items or collections
* that were unlocked * that were unlocked
* @error: location to place an error on failure * @error: location to place an error on failure
* *
* Complete asynchronous operation to unlock items or collections in the secret * 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) * secret_service_create_collection_dbus_path: (skip)
* @self: a secret service object * @self: a secret service object
* @properties: (element-type utf8 GLib.Variant): hash table of properties for * @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 * @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 * @flags: not currently used
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object
* @callback: called when the operation completes * @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) * secret_service_create_collection_dbus_path_sync: (skip)
* @self: a secret service object * @self: a secret service object
* @properties: (element-type utf8 GLib.Variant): hash table of D-Bus properties * @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 * @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 * @flags: not currently used
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object
* @error: location to place an error on failure * @error: location to place an error on failure
@ -1843,7 +1843,7 @@ secret_service_create_collection_dbus_path_finish (SecretService *self,
* Stability: Unstable * Stability: Unstable
* *
* Returns: (transfer full): a new string containing the D-Bus object path * Returns: (transfer full): a new string containing the D-Bus object path
* of the collection * of the collection
*/ */
gchar * gchar *
secret_service_create_collection_dbus_path_sync (SecretService *self, secret_service_create_collection_dbus_path_sync (SecretService *self,
@ -1998,7 +1998,7 @@ on_create_item_session (GObject *source,
* @self: a secret service object * @self: a secret service object
* @collection_path: the D-Bus object path of the collection in which to create item * @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 * @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 * @value: the secret value to store in the item
* @flags: flags for the creation of the new item * @flags: flags for the creation of the new item
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object
@ -2120,7 +2120,7 @@ _secret_service_create_item_dbus_path_finish_raw (GAsyncResult *result,
* @self: a secret service object * @self: a secret service object
* @collection_path: the D-Bus path of the collection in which to create item * @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 * @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 * @value: the secret value to store in the item
* @flags: flags for the creation of the new item * @flags: flags for the creation of the new item
* @cancellable: (nullable): optional cancellation object * @cancellable: (nullable): optional cancellation object
@ -2149,7 +2149,7 @@ _secret_service_create_item_dbus_path_finish_raw (GAsyncResult *result,
* Stability: Unstable * Stability: Unstable
* *
* Returns: (transfer full): a new string containing the D-Bus object path * Returns: (transfer full): a new string containing the D-Bus object path
* of the item * of the item
*/ */
gchar * gchar *
secret_service_create_item_dbus_path_sync (SecretService *self, 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 * @self: a secret service object
* @alias: the alias to assign the collection to * @alias: the alias to assign the collection to
* @collection_path: (nullable): the D-Bus object path of 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 * @cancellable: (nullable): optional cancellation object
* @error: location to place error on failure * @error: location to place error on failure
* *

View File

@ -45,9 +45,9 @@
* SecretRetrievableInterface: * SecretRetrievableInterface:
* @parent_iface: the parent interface * @parent_iface: the parent interface
* @retrieve_secret: implementation of [method@Retrievable.retrieve_secret], * @retrieve_secret: implementation of [method@Retrievable.retrieve_secret],
* required * required
* @retrieve_secret_finish: implementation of * @retrieve_secret_finish: implementation of
* [method@Retrievable.retrieve_secret_finish], required * [method@Retrievable.retrieve_secret_finish], required
* *
* The interface for #SecretRetrievable. * The interface for #SecretRetrievable.
* *

View File

@ -89,7 +89,7 @@
* SecretSchemaFlags: * SecretSchemaFlags:
* @SECRET_SCHEMA_NONE: no flags for the schema * @SECRET_SCHEMA_NONE: no flags for the schema
* @SECRET_SCHEMA_DONT_MATCH_NAME: don't match the schema name when looking up or * @SECRET_SCHEMA_DONT_MATCH_NAME: don't match the schema name when looking up or
* removing passwords * removing passwords
* *
* Flags for a #SecretSchema definition. * Flags for a #SecretSchema definition.
*/ */

View File

@ -76,16 +76,16 @@
* SecretServiceClass: * SecretServiceClass:
* @parent_class: the parent class * @parent_class: the parent class
* @collection_gtype: the [alias@GLib.Type] of the [class@Collection] objects instantiated * @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 * @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_async: called to perform asynchronous prompting when necessary
* @prompt_finish: called to complete an asynchronous prompt operation * @prompt_finish: called to complete an asynchronous prompt operation
* @prompt_sync: called to perform synchronous prompting when necessary * @prompt_sync: called to perform synchronous prompting when necessary
* @get_collection_gtype: called to get the GObject type for collections * @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 * @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. * The class for #SecretService.
*/ */
@ -94,9 +94,9 @@
* SecretServiceFlags: * SecretServiceFlags:
* @SECRET_SERVICE_NONE: no flags for initializing the #SecretService * @SECRET_SERVICE_NONE: no flags for initializing the #SecretService
* @SECRET_SERVICE_OPEN_SESSION: establish a session for transfer of secrets * @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 * @SECRET_SERVICE_LOAD_COLLECTIONS: load collections while initializing the
* #SecretService * #SecretService
* *
* Flags which determine which parts of the #SecretService proxy are initialized * Flags which determine which parts of the #SecretService proxy are initialized
* during a [func@Service.get] or [func@Service.open] operation. * 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. * [method@Service.ensure_session] to establish a session.
* *
* Returns: (nullable): a string representing the algorithms for transferring * Returns: (nullable): a string representing the algorithms for transferring
* secrets * secrets
*/ */
const gchar * const gchar *
secret_service_get_session_algorithms (SecretService *self) secret_service_get_session_algorithms (SecretService *self)