luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-06-11 07:10:09 +02:00
Code Issues Packages Projects Releases Wiki Activity

Update doc syntax

Browse Source 
Use gi-docgen syntax for the newly added documentation.
This commit is contained in:
Matthias Clasen 2025-03-30 08:18:37 -04:00
parent eccef5f487
commit 78214120fa
1 changed files with 28 additions and 26 deletions

54
gio/gsettingsschema.c

@ -342,15 +342,15 @@ g_settings_schema_source_new_from_directory (const gchar *directory,
/** /**
* g_settings_schema_source_new_from_path: * g_settings_schema_source_new_from_path:
* @path: (type filename): the filename of a compiled schema source * @path: (type filename): the filename of a compiled schema source
* @parent: (nullable): a #GSettingsSchemaSource, or %NULL * @parent: (nullable): a `GSettingsSchemaSource`
* @trusted: %TRUE, if the directory is trusted * @trusted: true, if the directory is trusted
* @error: a pointer to a #GError pointer set to %NULL, or %NULL * @error: return location for an error
* *
* Almost identical to g_settings_schema_source_new_from_directory() but * Almost identical to [ctor@Gio.SettingsSchemaSource.new_from_directory],
* takes a path to a compiled schema file directly instead of to the * but takes a path to a compiled schema file directly instead of to
* directory it is in. * the directory it is in.
* *
* Returns: (transfer full): a new #GSettingsSchemaSource, or %NULL * Returns: (transfer full): a new `GSettingsSchemaSource`
* *
* Since: 2.86 * Since: 2.86
**/ **/
@ -382,10 +382,10 @@ g_settings_schema_source_new_from_path (const gchar *path,
/** /**
* g_settings_schema_source_new_from_bytes: * g_settings_schema_source_new_from_bytes:
* @bytes: a #GBytes * @bytes: a `GBytes`
* @parent: (nullable): a #GSettingsSchemaSource, or %NULL * @parent: (nullable): a `GSettingsSchemaSource`
* @trusted: %TRUE, if the data is trusted * @trusted: true, if the data is trusted
* @error: a pointer to a #GError pointer set to %NULL, or %NULL * @error: return location for an error
* *
* Attempts to create a new schema source corresponding to the contents * Attempts to create a new schema source corresponding to the contents
* of @bytes, which should contain the data as produced by the * of @bytes, which should contain the data as produced by the
@ -394,14 +394,15 @@ g_settings_schema_source_new_from_path (const gchar *path,
* This should only be used in standalone applications and should not * This should only be used in standalone applications and should not
* be used in situations where settings are shared with other applications. * be used in situations where settings are shared with other applications.
* *
* Note that g_settings_schema_key_get_summary() and * Note that [method@Gio.SettingsSchemaKey.get_summary] and
* g_settings_schema_key_get_description() will always return %NULL for * [method@Gio.SettingsSchemaKey.get_description] will always return `NULL`
* a #GSettingsSchemaKey belonging to a #GSettingsSchema created from a * for a `GSettingsSchemaKey` belonging to a `GSettingsSchema` created
* schema source returned by this function. * from a schema source returned by this function.
* *
* See g_settings_schema_source_new_from_directory() for more information. * See [ctor@Gio.SettingsSchemaSource.new_from_directory] for
* more information.
* *
* Returns: (transfer full) (nullable): a new #GSettingsSchemaSource, or %NULL * Returns: (transfer full) (nullable): a new `GSettingsSchemaSource`
* *
* Since: 2.86 * Since: 2.86
**/ **/
@ -433,10 +434,10 @@ g_settings_schema_source_new_from_bytes (GBytes *bytes,
/** /**
* g_settings_schema_source_new_from_resource: * g_settings_schema_source_new_from_resource:
* @path: the resource path * @path: the resource path
* @lookup_flags: A #GResourceLookupFlags * @lookup_flags: flags for the resource lookup
* @parent: (nullable): a #GSettingsSchemaSource, or %NULL * @parent: (nullable): a `GSettingsSchemaSource`
* @trusted: %TRUE, if the resource is trusted * @trusted: true, if the resource is trusted
* @error: a pointer to a #GError pointer set to %NULL, or %NULL * @error: return location for an error
* *
* Attempts to create a new schema source corresponding to the contents * Attempts to create a new schema source corresponding to the contents
* of the given resource, which should contain the data as produced by the * of the given resource, which should contain the data as produced by the
@ -445,13 +446,14 @@ g_settings_schema_source_new_from_bytes (GBytes *bytes,
* This should only be used in standalone applications and should not * This should only be used in standalone applications and should not
* be used in situations where settings are shared with other applications. * be used in situations where settings are shared with other applications.
* *
* Note that for g_settings_schema_key_get_summary() and * Note that [method@Gio.SettingsSchemaKey.get_summary] and
* g_settings_schema_key_get_description() to work, an XML schema resource * [method@Gio.SettingsSchemaKey.get_description] to work, an XML schema
* $path.xml must be present. * resource @path.xml must be present.
* *
* See g_settings_schema_source_new_from_directory() for more information. * See [ctor@Gio.SettingsSchemaSource.new_from_directory] for
* more information.
* *
* Returns: (transfer full): a new #GSettingsSchemaSource, or %NULL * Returns: (transfer full): a new `GSettingsSchemaSource`
* *
* Since: 2.86 * Since: 2.86
**/ **/