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

Merge branch 'settings-list-order' into 'master'

Browse Source 
gsettings: Document that lists are returned in no defined order

See merge request GNOME/glib!851
This commit is contained in:
Sebastian Dröge 2019-06-11 11:35:58 +00:00
commit f78194e8d0
2 changed files with 14 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
gio/gsettings.c
View File

@ -2459,7 +2459,9 @@ g_settings_get_child (GSettings *settings,
* You should free the return value with g_strfreev() when you are done
* with it.
*
* Returns: (transfer full) (element-type utf8): a list of the keys on @settings
* Returns: (transfer full) (element-type utf8): a list of the keys on
* @settings, in no defined order
* Deprecated: 2.46: Use g_settings_schema_list_keys instead().
*/
gchar **
g_settings_list_keys (GSettings *settings)
@ -2483,7 +2485,8 @@ g_settings_list_keys (GSettings *settings)
* You should free the return value with g_strfreev() when you are done
* with it.
*
* Returns: (transfer full) (element-type utf8): a list of the children on @settings
* Returns: (transfer full) (element-type utf8): a list of the children on
* @settings, in no defined order
*/
gchar **
g_settings_list_children (GSettings *settings)

17
gio/gsettingsschema.c
View File

@ -742,9 +742,9 @@ g_settings_schema_source_get_text_tables (GSettingsSchemaSource *source)
* @source: a #GSettingsSchemaSource
* @recursive: if we should recurse
* @non_relocatable: (out) (transfer full) (array zero-terminated=1): the
* list of non-relocatable schemas
* list of non-relocatable schemas, in no defined order
* @relocatable: (out) (transfer full) (array zero-terminated=1): the list
* of relocatable schemas
* of relocatable schemas, in no defined order
*
* Lists the schemas in a given source.
*
@ -857,8 +857,8 @@ ensure_schema_lists (void)
* Deprecated.
*
* Returns: (element-type utf8) (transfer none): a list of #GSettings
* schemas that are available. The list must not be modified or
* freed.
* schemas that are available, in no defined order. The list must not be
* modified or freed.
*
* Since: 2.26
*
@ -881,8 +881,8 @@ g_settings_list_schemas (void)
* Deprecated.
*
* Returns: (element-type utf8) (transfer none): a list of relocatable
* #GSettings schemas that are available. The list must not be
* modified or freed.
* #GSettings schemas that are available, in no defined order. The list must
* not be modified or freed.
*
* Since: 2.28
*
@ -1035,7 +1035,8 @@ g_settings_schema_has_key (GSettingsSchema *schema,
* You should free the return value with g_strfreev() when you are done
* with it.
*
* Returns: (transfer full) (element-type utf8): a list of the children on @settings
* Returns: (transfer full) (element-type utf8): a list of the children on
* @settings, in no defined order
*
* Since: 2.44
*/
@ -1080,7 +1081,7 @@ g_settings_schema_list_children (GSettingsSchema *schema)
* function is intended for introspection reasons.
*
* Returns: (transfer full) (element-type utf8): a list of the keys on
* @schema
* @schema, in no defined order
*
* Since: 2.46
*/