gobject-introspection 3.1.1-x64-mingw32 → 3.1.2-x64-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (97) hide show
  1. checksums.yaml +4 -4
  2. data/Rakefile +2 -2
  3. data/ext/gobject-introspection/extconf.rb +2 -2
  4. data/ext/gobject-introspection/rb-gi-argument.c +65 -10
  5. data/ext/gobject-introspection/rb-gi-field-info.c +81 -14
  6. data/ext/gobject-introspection/rb-gi-loader.c +8 -3
  7. data/ext/gobject-introspection/rb-gi-repository.c +5 -1
  8. data/lib/2.2/gobject_introspection.so +0 -0
  9. data/lib/2.3/gobject_introspection.so +0 -0
  10. data/lib/2.4/gobject_introspection.so +0 -0
  11. data/lib/gobject-introspection/loader.rb +49 -13
  12. data/lib/gobject-introspection/repository.rb +7 -0
  13. data/test/test-union-info.rb +34 -2
  14. data/vendor/local/bin/g-ir-compiler.exe +0 -0
  15. data/vendor/local/bin/g-ir-generate.exe +0 -0
  16. data/vendor/local/bin/g-ir-inspect.exe +0 -0
  17. data/vendor/local/bin/libgirepository-1.0-1.dll +0 -0
  18. data/vendor/local/lib/girepository-1.0/GIRepository-2.0.typelib +0 -0
  19. data/vendor/local/lib/girepository-1.0/GLib-2.0.typelib +0 -0
  20. data/vendor/local/lib/girepository-1.0/Gio-2.0.typelib +0 -0
  21. data/vendor/local/lib/gobject-introspection/giscanner/__init__.pyc +0 -0
  22. data/vendor/local/lib/gobject-introspection/giscanner/__init__.pyo +0 -0
  23. data/vendor/local/lib/gobject-introspection/giscanner/annotationmain.pyc +0 -0
  24. data/vendor/local/lib/gobject-introspection/giscanner/annotationmain.pyo +0 -0
  25. data/vendor/local/lib/gobject-introspection/giscanner/annotationparser.pyc +0 -0
  26. data/vendor/local/lib/gobject-introspection/giscanner/annotationparser.pyo +0 -0
  27. data/vendor/local/lib/gobject-introspection/giscanner/ast.pyc +0 -0
  28. data/vendor/local/lib/gobject-introspection/giscanner/ast.pyo +0 -0
  29. data/vendor/local/lib/gobject-introspection/giscanner/cachestore.pyc +0 -0
  30. data/vendor/local/lib/gobject-introspection/giscanner/cachestore.pyo +0 -0
  31. data/vendor/local/lib/gobject-introspection/giscanner/ccompiler.py +5 -4
  32. data/vendor/local/lib/gobject-introspection/giscanner/ccompiler.pyc +0 -0
  33. data/vendor/local/lib/gobject-introspection/giscanner/ccompiler.pyo +0 -0
  34. data/vendor/local/lib/gobject-introspection/giscanner/codegen.pyc +0 -0
  35. data/vendor/local/lib/gobject-introspection/giscanner/codegen.pyo +0 -0
  36. data/vendor/local/lib/gobject-introspection/giscanner/collections/__init__.pyc +0 -0
  37. data/vendor/local/lib/gobject-introspection/giscanner/collections/__init__.pyo +0 -0
  38. data/vendor/local/lib/gobject-introspection/giscanner/collections/counter.pyc +0 -0
  39. data/vendor/local/lib/gobject-introspection/giscanner/collections/counter.pyo +0 -0
  40. data/vendor/local/lib/gobject-introspection/giscanner/collections/ordereddict.pyc +0 -0
  41. data/vendor/local/lib/gobject-introspection/giscanner/collections/ordereddict.pyo +0 -0
  42. data/vendor/local/lib/gobject-introspection/giscanner/docmain.pyc +0 -0
  43. data/vendor/local/lib/gobject-introspection/giscanner/docmain.pyo +0 -0
  44. data/vendor/local/lib/gobject-introspection/giscanner/docwriter.pyc +0 -0
  45. data/vendor/local/lib/gobject-introspection/giscanner/docwriter.pyo +0 -0
  46. data/vendor/local/lib/gobject-introspection/giscanner/dumper.py +8 -7
  47. data/vendor/local/lib/gobject-introspection/giscanner/dumper.pyc +0 -0
  48. data/vendor/local/lib/gobject-introspection/giscanner/dumper.pyo +0 -0
  49. data/vendor/local/lib/gobject-introspection/giscanner/gdumpparser.pyc +0 -0
  50. data/vendor/local/lib/gobject-introspection/giscanner/gdumpparser.pyo +0 -0
  51. data/vendor/local/lib/gobject-introspection/giscanner/girparser.pyc +0 -0
  52. data/vendor/local/lib/gobject-introspection/giscanner/girparser.pyo +0 -0
  53. data/vendor/local/lib/gobject-introspection/giscanner/girwriter.py +1 -1
  54. data/vendor/local/lib/gobject-introspection/giscanner/girwriter.pyc +0 -0
  55. data/vendor/local/lib/gobject-introspection/giscanner/girwriter.pyo +0 -0
  56. data/vendor/local/lib/gobject-introspection/giscanner/introspectablepass.pyc +0 -0
  57. data/vendor/local/lib/gobject-introspection/giscanner/introspectablepass.pyo +0 -0
  58. data/vendor/local/lib/gobject-introspection/giscanner/libtoolimporter.pyc +0 -0
  59. data/vendor/local/lib/gobject-introspection/giscanner/libtoolimporter.pyo +0 -0
  60. data/vendor/local/lib/gobject-introspection/giscanner/maintransformer.pyc +0 -0
  61. data/vendor/local/lib/gobject-introspection/giscanner/maintransformer.pyo +0 -0
  62. data/vendor/local/lib/gobject-introspection/giscanner/message.pyc +0 -0
  63. data/vendor/local/lib/gobject-introspection/giscanner/message.pyo +0 -0
  64. data/vendor/local/lib/gobject-introspection/giscanner/msvccompiler.pyc +0 -0
  65. data/vendor/local/lib/gobject-introspection/giscanner/msvccompiler.pyo +0 -0
  66. data/vendor/local/lib/gobject-introspection/giscanner/scannermain.py +3 -0
  67. data/vendor/local/lib/gobject-introspection/giscanner/scannermain.pyc +0 -0
  68. data/vendor/local/lib/gobject-introspection/giscanner/scannermain.pyo +0 -0
  69. data/vendor/local/lib/gobject-introspection/giscanner/sectionparser.pyc +0 -0
  70. data/vendor/local/lib/gobject-introspection/giscanner/sectionparser.pyo +0 -0
  71. data/vendor/local/lib/gobject-introspection/giscanner/shlibs.pyc +0 -0
  72. data/vendor/local/lib/gobject-introspection/giscanner/shlibs.pyo +0 -0
  73. data/vendor/local/lib/gobject-introspection/giscanner/sourcescanner.pyc +0 -0
  74. data/vendor/local/lib/gobject-introspection/giscanner/sourcescanner.pyo +0 -0
  75. data/vendor/local/lib/gobject-introspection/giscanner/testcodegen.pyc +0 -0
  76. data/vendor/local/lib/gobject-introspection/giscanner/testcodegen.pyo +0 -0
  77. data/vendor/local/lib/gobject-introspection/giscanner/transformer.py +1 -6
  78. data/vendor/local/lib/gobject-introspection/giscanner/transformer.pyc +0 -0
  79. data/vendor/local/lib/gobject-introspection/giscanner/transformer.pyo +0 -0
  80. data/vendor/local/lib/gobject-introspection/giscanner/utils.pyc +0 -0
  81. data/vendor/local/lib/gobject-introspection/giscanner/utils.pyo +0 -0
  82. data/vendor/local/lib/gobject-introspection/giscanner/xmlwriter.pyc +0 -0
  83. data/vendor/local/lib/gobject-introspection/giscanner/xmlwriter.pyo +0 -0
  84. data/vendor/local/lib/libgirepository-1.0.a +0 -0
  85. data/vendor/local/lib/libgirepository-1.0.dll.a +0 -0
  86. data/vendor/local/lib/pkgconfig/gobject-introspection-1.0.pc +1 -1
  87. data/vendor/local/lib/pkgconfig/gobject-introspection-no-export-1.0.pc +1 -1
  88. data/vendor/local/share/gir-1.0/GIRepository-2.0.gir +18 -6
  89. data/vendor/local/share/gir-1.0/GLib-2.0.gir +186 -61
  90. data/vendor/local/share/gir-1.0/GObject-2.0.gir +565 -389
  91. data/vendor/local/share/gir-1.0/Gio-2.0.gir +921 -57
  92. data/vendor/local/share/gobject-introspection-1.0/Makefile.introspection +4 -0
  93. data/vendor/local/share/gobject-introspection-1.0/tests/gimarshallingtests.c +262 -0
  94. data/vendor/local/share/gobject-introspection-1.0/tests/gimarshallingtests.h +45 -1
  95. data/vendor/local/share/gobject-introspection-1.0/tests/regress.c +37 -0
  96. data/vendor/local/share/gobject-introspection-1.0/tests/regress.h +4 -0
  97. metadata +5 -5
@@ -2702,7 +2702,11 @@ See g_app_info_can_delete().</doc>
2702
2702
  </parameters>
2703
2703
  </virtual-method>
2704
2704
  <virtual-method name="equal" invoker="equal">
2705
- <doc xml:space="preserve">Checks if two #GAppInfos are equal.</doc>
2705
+ <doc xml:space="preserve">Checks if two #GAppInfos are equal.
2706
+
2707
+ Note that the check &lt;em&gt;may not&lt;/em&gt; compare each individual field, and
2708
+ only does an identity check. In case detecting changes in the contents
2709
+ is needed, program code must additionally compare relevant fields.</doc>
2706
2710
  <return-value transfer-ownership="none">
2707
2711
  <doc xml:space="preserve">%TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise.</doc>
2708
2712
  <type name="gboolean" c:type="gboolean"/>
@@ -3133,7 +3137,11 @@ See g_app_info_can_delete().</doc>
3133
3137
  </parameters>
3134
3138
  </method>
3135
3139
  <method name="equal" c:identifier="g_app_info_equal">
3136
- <doc xml:space="preserve">Checks if two #GAppInfos are equal.</doc>
3140
+ <doc xml:space="preserve">Checks if two #GAppInfos are equal.
3141
+
3142
+ Note that the check &lt;em&gt;may not&lt;/em&gt; compare each individual field, and
3143
+ only does an identity check. In case detecting changes in the contents
3144
+ is needed, program code must additionally compare relevant fields.</doc>
3137
3145
  <return-value transfer-ownership="none">
3138
3146
  <doc xml:space="preserve">%TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise.</doc>
3139
3147
  <type name="gboolean" c:type="gboolean"/>
@@ -4420,7 +4428,7 @@ examples below.
4420
4428
 
4421
4429
  If used, the expected form of an application identifier is very close
4422
4430
  to that of of a
4423
- [DBus bus name](http://dbus.freedesktop.org/doc/dbus-specification.html#message-protocol-names-interface).
4431
+ [D-Bus bus name](http://dbus.freedesktop.org/doc/dbus-specification.html#message-protocol-names-interface).
4424
4432
  Examples include: "com.example.MyApp", "org.example.internal-apps.Calculator".
4425
4433
  For details on valid application identifiers, see g_application_id_is_valid().
4426
4434
 
@@ -10796,7 +10804,8 @@ Here is an example for exporting a #GObject:
10796
10804
  throws="1">
10797
10805
  <doc xml:space="preserve">Synchronously connects and sets up a D-Bus client connection for
10798
10806
  exchanging D-Bus messages with an endpoint specified by @address
10799
- which must be in the D-Bus address format.
10807
+ which must be in the
10808
+ [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
10800
10809
 
10801
10810
  This constructor can only be used to initiate client-side
10802
10811
  connections - use g_dbus_connection_new_sync() if you need to act
@@ -10971,7 +10980,8 @@ version.</doc>
10971
10980
  version="2.26">
10972
10981
  <doc xml:space="preserve">Asynchronously connects and sets up a D-Bus client connection for
10973
10982
  exchanging D-Bus messages with an endpoint specified by @address
10974
- which must be in the D-Bus address format.
10983
+ which must be in the
10984
+ [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
10975
10985
 
10976
10986
  This constructor can only be used to initiate client-side
10977
10987
  connections - use g_dbus_connection_new() if you need to act as the
@@ -15801,7 +15811,7 @@ modifying_filter (GDBusConnection *connection
15801
15811
  If the returned #GDBusMessage is different from @message and cannot
15802
15812
  be sent on @connection (it could use features, such as file
15803
15813
  descriptors, not compatible with @connection), then a warning is
15804
- logged to &lt;emphasis&gt;standard error&lt;/emphasis&gt;. Applications can
15814
+ logged to standard error. Applications can
15805
15815
  check this ahead of time using g_dbus_message_to_blob() passing a
15806
15816
  #GDBusCapabilityFlags value obtained from @connection.</doc>
15807
15817
  <return-value transfer-ownership="full" nullable="1">
@@ -16234,7 +16244,9 @@ If the call was GetAll, %NULL will be returned.</doc>
16234
16244
  version="2.26">
16235
16245
  <doc xml:space="preserve">Finishes handling a D-Bus method call by returning an error.
16236
16246
 
16237
- This method will free @invocation, you cannot use it afterwards.</doc>
16247
+ This method will take ownership of @invocation. See
16248
+ #GDBusInterfaceVTable for more information about the ownership of
16249
+ @invocation.</doc>
16238
16250
  <return-value transfer-ownership="none">
16239
16251
  <type name="none" c:type="void"/>
16240
16252
  </return-value>
@@ -16270,7 +16282,9 @@ If you are writing an application intended to be portable,
16270
16282
  always register errors with g_dbus_error_register_error()
16271
16283
  or use g_dbus_method_invocation_return_dbus_error().
16272
16284
 
16273
- This method will free @invocation, you cannot use it afterwards.
16285
+ This method will take ownership of @invocation. See
16286
+ #GDBusInterfaceVTable for more information about the ownership of
16287
+ @invocation.
16274
16288
 
16275
16289
  Since 2.48, if the method call requested for a reply not to be sent
16276
16290
  then this call will free @invocation but otherwise do nothing (as per
@@ -16306,7 +16320,9 @@ the recommendations of the D-Bus specification).</doc>
16306
16320
  version="2.26">
16307
16321
  <doc xml:space="preserve">Like g_dbus_method_invocation_return_error() but without printf()-style formatting.
16308
16322
 
16309
- This method will free @invocation, you cannot use it afterwards.</doc>
16323
+ This method will take ownership of @invocation. See
16324
+ #GDBusInterfaceVTable for more information about the ownership of
16325
+ @invocation.</doc>
16310
16326
  <return-value transfer-ownership="none">
16311
16327
  <type name="none" c:type="void"/>
16312
16328
  </return-value>
@@ -16336,7 +16352,9 @@ This method will free @invocation, you cannot use it afterwards.</doc>
16336
16352
  <doc xml:space="preserve">Like g_dbus_method_invocation_return_error() but intended for
16337
16353
  language bindings.
16338
16354
 
16339
- This method will free @invocation, you cannot use it afterwards.</doc>
16355
+ This method will take ownership of @invocation. See
16356
+ #GDBusInterfaceVTable for more information about the ownership of
16357
+ @invocation.</doc>
16340
16358
  <return-value transfer-ownership="none">
16341
16359
  <type name="none" c:type="void"/>
16342
16360
  </return-value>
@@ -16369,7 +16387,9 @@ This method will free @invocation, you cannot use it afterwards.</doc>
16369
16387
  <doc xml:space="preserve">Like g_dbus_method_invocation_return_error() but takes a #GError
16370
16388
  instead of the error domain, error code and message.
16371
16389
 
16372
- This method will free @invocation, you cannot use it afterwards.</doc>
16390
+ This method will take ownership of @invocation. See
16391
+ #GDBusInterfaceVTable for more information about the ownership of
16392
+ @invocation.</doc>
16373
16393
  <return-value transfer-ownership="none">
16374
16394
  <type name="none" c:type="void"/>
16375
16395
  </return-value>
@@ -16390,9 +16410,30 @@ This method will free @invocation, you cannot use it afterwards.</doc>
16390
16410
  <doc xml:space="preserve">Finishes handling a D-Bus method call by returning @parameters.
16391
16411
  If the @parameters GVariant is floating, it is consumed.
16392
16412
 
16393
- It is an error if @parameters is not of the right format.
16413
+ It is an error if @parameters is not of the right format: it must be a tuple
16414
+ containing the out-parameters of the D-Bus method. Even if the method has a
16415
+ single out-parameter, it must be contained in a tuple. If the method has no
16416
+ out-parameters, @parameters may be %NULL or an empty tuple.
16417
+
16418
+ |[&lt;!-- language="C" --&gt;
16419
+ GDBusMethodInvocation *invocation = some_invocation;
16420
+ g_autofree gchar *result_string = NULL;
16421
+ g_autoptr (GError) error = NULL;
16422
+
16423
+ result_string = calculate_result (&amp;error);
16394
16424
 
16395
- This method will free @invocation, you cannot use it afterwards.
16425
+ if (error != NULL)
16426
+ g_dbus_method_invocation_return_gerror (invocation, error);
16427
+ else
16428
+ g_dbus_method_invocation_return_value (invocation,
16429
+ g_variant_new ("(s)", result_string));
16430
+
16431
+ /&lt;!-- --&gt;* Do not free @invocation here; returning a value does that *&lt;!-- --&gt;/
16432
+ ]|
16433
+
16434
+ This method will take ownership of @invocation. See
16435
+ #GDBusInterfaceVTable for more information about the ownership of
16436
+ @invocation.
16396
16437
 
16397
16438
  Since 2.48, if the method call requested for a reply not to be sent
16398
16439
  then this call will sink @parameters and free @invocation, but
@@ -16422,7 +16463,9 @@ specification).</doc>
16422
16463
 
16423
16464
  This method is only available on UNIX.
16424
16465
 
16425
- This method will free @invocation, you cannot use it afterwards.</doc>
16466
+ This method will take ownership of @invocation. See
16467
+ #GDBusInterfaceVTable for more information about the ownership of
16468
+ @invocation.</doc>
16426
16469
  <return-value transfer-ownership="none">
16427
16470
  <type name="none" c:type="void"/>
16428
16471
  </return-value>
@@ -16454,7 +16497,9 @@ This method will free @invocation, you cannot use it afterwards.</doc>
16454
16497
  <doc xml:space="preserve">Like g_dbus_method_invocation_return_gerror() but takes ownership
16455
16498
  of @error so the caller does not need to free it.
16456
16499
 
16457
- This method will free @invocation, you cannot use it afterwards.</doc>
16500
+ This method will take ownership of @invocation. See
16501
+ #GDBusInterfaceVTable for more information about the ownership of
16502
+ @invocation.</doc>
16458
16503
  <return-value transfer-ownership="none">
16459
16504
  <type name="none" c:type="void"/>
16460
16505
  </return-value>
@@ -19998,7 +20043,7 @@ This flag is only meaningful in proxies for well-known names.</doc>
19998
20043
  value="8"
19999
20044
  c:identifier="G_DBUS_PROXY_FLAGS_GET_INVALIDATED_PROPERTIES"
20000
20045
  glib:nick="get-invalidated-properties">
20001
- <doc xml:space="preserve">If set, the property value for any &lt;emphasis&gt;invalidated property&lt;/emphasis&gt; will be (asynchronously) retrieved upon receiving the &lt;ulink url="http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-properties"&gt;PropertiesChanged&lt;/ulink&gt; D-Bus signal and the property will not cause emission of the #GDBusProxy::g-properties-changed signal. When the value is received the #GDBusProxy::g-properties-changed signal is emitted for the property along with the retrieved value. Since 2.32.</doc>
20046
+ <doc xml:space="preserve">If set, the property value for any __invalidated property__ will be (asynchronously) retrieved upon receiving the [`PropertiesChanged`](http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-properties) D-Bus signal and the property will not cause emission of the #GDBusProxy::g-properties-changed signal. When the value is received the #GDBusProxy::g-properties-changed signal is emitted for the property along with the retrieved value. Since 2.32.</doc>
20002
20047
  </member>
20003
20048
  <member name="do_not_auto_start_at_construction"
20004
20049
  value="16"
@@ -20152,8 +20197,9 @@ g_object_unref().</doc>
20152
20197
  <method name="get_client_address"
20153
20198
  c:identifier="g_dbus_server_get_client_address"
20154
20199
  version="2.26">
20155
- <doc xml:space="preserve">Gets a D-Bus address string that can be used by clients to connect
20156
- to @server.</doc>
20200
+ <doc xml:space="preserve">Gets a
20201
+ [D-Bus address](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses)
20202
+ string that can be used by clients to connect to @server.</doc>
20157
20203
  <return-value transfer-ownership="none">
20158
20204
  <doc xml:space="preserve">A D-Bus address string. Do not free, the string is owned
20159
20205
  by @server.</doc>
@@ -26815,6 +26861,15 @@ resolution thumbnail without metadata. Corresponding
26815
26861
  for this key should contain a #GIcon.</doc>
26816
26862
  <type name="utf8" c:type="gchar*"/>
26817
26863
  </constant>
26864
+ <constant name="FILE_ATTRIBUTE_RECENT_MODIFIED"
26865
+ value="recent::modified"
26866
+ c:type="G_FILE_ATTRIBUTE_RECENT_MODIFIED"
26867
+ version="2.52">
26868
+ <doc xml:space="preserve">A key in the "recent" namespace for getting time, when the metadata for the
26869
+ file in `recent:///` was last changed. Corresponding #GFileAttributeType is
26870
+ %G_FILE_ATTRIBUTE_TYPE_INT64.</doc>
26871
+ <type name="utf8" c:type="gchar*"/>
26872
+ </constant>
26818
26873
  <constant name="FILE_ATTRIBUTE_SELINUX_CONTEXT"
26819
26874
  value="selinux::context"
26820
26875
  c:type="G_FILE_ATTRIBUTE_SELINUX_CONTEXT">
@@ -27047,8 +27102,8 @@ image. Corresponding #GFileAttributeType is
27047
27102
  c:type="G_FILE_ATTRIBUTE_TIME_ACCESS">
27048
27103
  <doc xml:space="preserve">A key in the "time" namespace for getting the time the file was last
27049
27104
  accessed. Corresponding #GFileAttributeType is
27050
- %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the UNIX time since the
27051
- file was last accessed.</doc>
27105
+ %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the
27106
+ file was last accessed, in seconds since the UNIX epoch.</doc>
27052
27107
  <type name="utf8" c:type="gchar*"/>
27053
27108
  </constant>
27054
27109
  <constant name="FILE_ATTRIBUTE_TIME_ACCESS_USEC"
@@ -27065,7 +27120,8 @@ the file was last accessed. This should be used in conjunction with
27065
27120
  c:type="G_FILE_ATTRIBUTE_TIME_CHANGED">
27066
27121
  <doc xml:space="preserve">A key in the "time" namespace for getting the time the file was last
27067
27122
  changed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
27068
- and contains the UNIX time since the file was last changed.
27123
+ and contains the time since the file was last changed, in seconds since the
27124
+ UNIX epoch.
27069
27125
 
27070
27126
  This corresponds to the traditional UNIX ctime.</doc>
27071
27127
  <type name="utf8" c:type="gchar*"/>
@@ -27084,7 +27140,8 @@ the file was last changed. This should be used in conjunction with
27084
27140
  c:type="G_FILE_ATTRIBUTE_TIME_CREATED">
27085
27141
  <doc xml:space="preserve">A key in the "time" namespace for getting the time the file was created.
27086
27142
  Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
27087
- and contains the UNIX time since the file was created.
27143
+ and contains the time since the file was created, in seconds since the UNIX
27144
+ epoch.
27088
27145
 
27089
27146
  This corresponds to the NTFS ctime.</doc>
27090
27147
  <type name="utf8" c:type="gchar*"/>
@@ -27103,14 +27160,14 @@ the file was created. This should be used in conjunction with
27103
27160
  c:type="G_FILE_ATTRIBUTE_TIME_MODIFIED">
27104
27161
  <doc xml:space="preserve">A key in the "time" namespace for getting the time the file was last
27105
27162
  modified. Corresponding #GFileAttributeType is
27106
- %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the UNIX time since the
27107
- file was modified.</doc>
27163
+ %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the
27164
+ file was modified, in seconds since the UNIX epoch.</doc>
27108
27165
  <type name="utf8" c:type="gchar*"/>
27109
27166
  </constant>
27110
27167
  <constant name="FILE_ATTRIBUTE_TIME_MODIFIED_USEC"
27111
27168
  value="time::modified-usec"
27112
27169
  c:type="G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC">
27113
- <doc xml:space="preserve">A key in the "time" namespace for getting the miliseconds of the time
27170
+ <doc xml:space="preserve">A key in the "time" namespace for getting the microseconds of the time
27114
27171
  the file was last modified. This should be used in conjunction with
27115
27172
  #G_FILE_ATTRIBUTE_TIME_MODIFIED. Corresponding #GFileAttributeType is
27116
27173
  %G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
@@ -27121,7 +27178,7 @@ the file was last modified. This should be used in conjunction with
27121
27178
  c:type="G_FILE_ATTRIBUTE_TRASH_DELETION_DATE"
27122
27179
  version="2.24">
27123
27180
  <doc xml:space="preserve">A key in the "trash" namespace. When requested against
27124
- items in "trash:///", will return the date and time when the file
27181
+ items in `trash:///`, will return the date and time when the file
27125
27182
  was trashed. The format of the returned string is YYYY-MM-DDThh:mm:ss.
27126
27183
  Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
27127
27184
  <type name="utf8" c:type="gchar*"/>
@@ -27130,7 +27187,7 @@ Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
27130
27187
  value="trash::item-count"
27131
27188
  c:type="G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT">
27132
27189
  <doc xml:space="preserve">A key in the "trash" namespace. When requested against
27133
- "trash:///" returns the number of (toplevel) items in the trash folder.
27190
+ `trash:///` returns the number of (toplevel) items in the trash folder.
27134
27191
  Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
27135
27192
  <type name="utf8" c:type="gchar*"/>
27136
27193
  </constant>
@@ -27139,7 +27196,7 @@ Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
27139
27196
  c:type="G_FILE_ATTRIBUTE_TRASH_ORIG_PATH"
27140
27197
  version="2.24">
27141
27198
  <doc xml:space="preserve">A key in the "trash" namespace. When requested against
27142
- items in "trash:///", will return the original path to the file before it
27199
+ items in `trash:///`, will return the original path to the file before it
27143
27200
  was trashed. Corresponding #GFileAttributeType is
27144
27201
  %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.</doc>
27145
27202
  <type name="utf8" c:type="gchar*"/>
@@ -56306,7 +56363,7 @@ the result of the operation.
56306
56363
 
56307
56364
  For behaviour details see g_output_stream_close().
56308
56365
 
56309
- The asyncronous methods have a default fallback that uses threads
56366
+ The asynchronous methods have a default fallback that uses threads
56310
56367
  to implement asynchronicity, so they are optional for inheriting
56311
56368
  classes. However, if you override one you must override all.</doc>
56312
56369
  <return-value transfer-ownership="none">
@@ -56604,7 +56661,7 @@ Any outstanding I/O request with higher priority (lower numerical
56604
56661
  value) will be executed before an outstanding request with lower
56605
56662
  priority. Default priority is %G_PRIORITY_DEFAULT.
56606
56663
 
56607
- The asyncronous methods have a default fallback that uses threads
56664
+ The asynchronous methods have a default fallback that uses threads
56608
56665
  to implement asynchronicity, so they are optional for inheriting
56609
56666
  classes. However, if you override one you must override all.
56610
56667
 
@@ -56804,7 +56861,7 @@ the result of the operation.
56804
56861
 
56805
56862
  For behaviour details see g_output_stream_close().
56806
56863
 
56807
- The asyncronous methods have a default fallback that uses threads
56864
+ The asynchronous methods have a default fallback that uses threads
56808
56865
  to implement asynchronicity, so they are optional for inheriting
56809
56866
  classes. However, if you override one you must override all.</doc>
56810
56867
  <return-value transfer-ownership="none">
@@ -56956,7 +57013,7 @@ result of the operation.</doc>
56956
57013
  </parameters>
56957
57014
  </method>
56958
57015
  <method name="has_pending" c:identifier="g_output_stream_has_pending">
56959
- <doc xml:space="preserve">Checks if an ouput stream has pending actions.</doc>
57016
+ <doc xml:space="preserve">Checks if an output stream has pending actions.</doc>
56960
57017
  <return-value transfer-ownership="none">
56961
57018
  <doc xml:space="preserve">%TRUE if @stream has pending actions.</doc>
56962
57019
  <type name="gboolean" c:type="gboolean"/>
@@ -57466,7 +57523,7 @@ Any outstanding I/O request with higher priority (lower numerical
57466
57523
  value) will be executed before an outstanding request with lower
57467
57524
  priority. Default priority is %G_PRIORITY_DEFAULT.
57468
57525
 
57469
- The asyncronous methods have a default fallback that uses threads
57526
+ The asynchronous methods have a default fallback that uses threads
57470
57527
  to implement asynchronicity, so they are optional for inheriting
57471
57528
  classes. However, if you override one you must override all.
57472
57529
 
@@ -63126,6 +63183,12 @@ bundle.</doc>
63126
63183
  <doc xml:space="preserve">No flags set.</doc>
63127
63184
  </member>
63128
63185
  </bitfield>
63186
+ <constant name="SETTINGS_BACKEND_EXTENSION_POINT_NAME"
63187
+ value="gsettings-backend"
63188
+ c:type="G_SETTINGS_BACKEND_EXTENSION_POINT_NAME">
63189
+ <doc xml:space="preserve">Extension point for #GSettingsBackend functionality.</doc>
63190
+ <type name="utf8" c:type="gchar*"/>
63191
+ </constant>
63129
63192
  <interface name="Seekable"
63130
63193
  c:symbol-prefix="seekable"
63131
63194
  c:type="GSeekable"
@@ -65282,11 +65345,10 @@ If @value is floating then this function consumes the reference.</doc>
65282
65345
  </parameters>
65283
65346
  </method>
65284
65347
  <property name="backend"
65285
- introspectable="0"
65286
65348
  writable="1"
65287
65349
  construct-only="1"
65288
65350
  transfer-ownership="none">
65289
- <type/>
65351
+ <type name="SettingsBackend"/>
65290
65352
  </property>
65291
65353
  <property name="delay-apply" version="2.28" transfer-ownership="none">
65292
65354
  <doc xml:space="preserve">Whether the #GSettings object is in 'delay-apply' mode. See
@@ -65460,7 +65522,14 @@ callbacks when the writability of "x" changes.</doc>
65460
65522
  </parameters>
65461
65523
  </glib:signal>
65462
65524
  </class>
65463
- <record name="SettingsBackend" c:type="GSettingsBackend" disguised="1">
65525
+ <class name="SettingsBackend"
65526
+ c:symbol-prefix="settings_backend"
65527
+ c:type="GSettingsBackend"
65528
+ parent="GObject.Object"
65529
+ abstract="1"
65530
+ glib:type-name="GSettingsBackend"
65531
+ glib:get-type="g_settings_backend_get_type"
65532
+ glib:type-struct="SettingsBackendClass">
65464
65533
  <doc xml:space="preserve">The #GSettingsBackend interface defines a generic interface for
65465
65534
  non-strictly-typed data that is stored in a hierarchy. To implement
65466
65535
  an alternative storage backend for #GSettings, you need to implement
@@ -65485,6 +65554,637 @@ implementations, but does not carry the same stability guarantees
65485
65554
  as the public GIO API. For this reason, you have to define the
65486
65555
  C preprocessor symbol %G_SETTINGS_ENABLE_BACKEND before including
65487
65556
  `gio/gsettingsbackend.h`.</doc>
65557
+ <function name="flatten_tree"
65558
+ c:identifier="g_settings_backend_flatten_tree"
65559
+ version="2.26">
65560
+ <doc xml:space="preserve">Calculate the longest common prefix of all keys in a tree and write
65561
+ out an array of the key names relative to that prefix and,
65562
+ optionally, the value to store at each of those keys.
65563
+
65564
+ You must free the value returned in @path, @keys and @values using
65565
+ g_free(). You should not attempt to free or unref the contents of
65566
+ @keys or @values.</doc>
65567
+ <return-value transfer-ownership="none">
65568
+ <type name="none" c:type="void"/>
65569
+ </return-value>
65570
+ <parameters>
65571
+ <parameter name="tree" transfer-ownership="none">
65572
+ <doc xml:space="preserve">a #GTree containing the changes</doc>
65573
+ <type name="GLib.Tree" c:type="GTree*"/>
65574
+ </parameter>
65575
+ <parameter name="path"
65576
+ direction="out"
65577
+ caller-allocates="0"
65578
+ transfer-ownership="full">
65579
+ <doc xml:space="preserve">the location to save the path</doc>
65580
+ <type name="utf8" c:type="gchar**"/>
65581
+ </parameter>
65582
+ <parameter name="keys"
65583
+ direction="out"
65584
+ caller-allocates="0"
65585
+ transfer-ownership="container">
65586
+ <doc xml:space="preserve">the
65587
+ location to save the relative keys</doc>
65588
+ <array c:type="gchar***">
65589
+ <type name="utf8" c:type="gchar**"/>
65590
+ </array>
65591
+ </parameter>
65592
+ <parameter name="values"
65593
+ direction="out"
65594
+ caller-allocates="0"
65595
+ transfer-ownership="container"
65596
+ optional="1"
65597
+ allow-none="1">
65598
+ <doc xml:space="preserve">
65599
+ the location to save the values, or %NULL</doc>
65600
+ <array c:type="GVariant***">
65601
+ <type name="GLib.Variant" c:type="GVariant**"/>
65602
+ </array>
65603
+ </parameter>
65604
+ </parameters>
65605
+ </function>
65606
+ <function name="get_default"
65607
+ c:identifier="g_settings_backend_get_default"
65608
+ version="2.28">
65609
+ <doc xml:space="preserve">Returns the default #GSettingsBackend. It is possible to override
65610
+ the default by setting the `GSETTINGS_BACKEND` environment variable
65611
+ to the name of a settings backend.
65612
+
65613
+ The user gets a reference to the backend.</doc>
65614
+ <return-value transfer-ownership="full">
65615
+ <doc xml:space="preserve">the default #GSettingsBackend</doc>
65616
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65617
+ </return-value>
65618
+ </function>
65619
+ <virtual-method name="get_permission" introspectable="0">
65620
+ <return-value>
65621
+ <type name="Permission" c:type="GPermission*"/>
65622
+ </return-value>
65623
+ <parameters>
65624
+ <instance-parameter name="backend" transfer-ownership="none">
65625
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65626
+ </instance-parameter>
65627
+ <parameter name="path" transfer-ownership="none">
65628
+ <type name="utf8" c:type="const gchar*"/>
65629
+ </parameter>
65630
+ </parameters>
65631
+ </virtual-method>
65632
+ <virtual-method name="get_writable">
65633
+ <return-value transfer-ownership="none">
65634
+ <type name="gboolean" c:type="gboolean"/>
65635
+ </return-value>
65636
+ <parameters>
65637
+ <instance-parameter name="backend" transfer-ownership="none">
65638
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65639
+ </instance-parameter>
65640
+ <parameter name="key" transfer-ownership="none">
65641
+ <type name="utf8" c:type="const gchar*"/>
65642
+ </parameter>
65643
+ </parameters>
65644
+ </virtual-method>
65645
+ <virtual-method name="read">
65646
+ <return-value transfer-ownership="full">
65647
+ <type name="GLib.Variant" c:type="GVariant*"/>
65648
+ </return-value>
65649
+ <parameters>
65650
+ <instance-parameter name="backend" transfer-ownership="none">
65651
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65652
+ </instance-parameter>
65653
+ <parameter name="key" transfer-ownership="none">
65654
+ <type name="utf8" c:type="const gchar*"/>
65655
+ </parameter>
65656
+ <parameter name="expected_type" transfer-ownership="none">
65657
+ <type name="GLib.VariantType" c:type="const GVariantType*"/>
65658
+ </parameter>
65659
+ <parameter name="default_value" transfer-ownership="none">
65660
+ <type name="gboolean" c:type="gboolean"/>
65661
+ </parameter>
65662
+ </parameters>
65663
+ </virtual-method>
65664
+ <virtual-method name="read_user_value">
65665
+ <return-value transfer-ownership="full">
65666
+ <type name="GLib.Variant" c:type="GVariant*"/>
65667
+ </return-value>
65668
+ <parameters>
65669
+ <instance-parameter name="backend" transfer-ownership="none">
65670
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65671
+ </instance-parameter>
65672
+ <parameter name="key" transfer-ownership="none">
65673
+ <type name="utf8" c:type="const gchar*"/>
65674
+ </parameter>
65675
+ <parameter name="expected_type" transfer-ownership="none">
65676
+ <type name="GLib.VariantType" c:type="const GVariantType*"/>
65677
+ </parameter>
65678
+ </parameters>
65679
+ </virtual-method>
65680
+ <virtual-method name="reset">
65681
+ <return-value transfer-ownership="none">
65682
+ <type name="none" c:type="void"/>
65683
+ </return-value>
65684
+ <parameters>
65685
+ <instance-parameter name="backend" transfer-ownership="none">
65686
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65687
+ </instance-parameter>
65688
+ <parameter name="key" transfer-ownership="none">
65689
+ <type name="utf8" c:type="const gchar*"/>
65690
+ </parameter>
65691
+ <parameter name="origin_tag"
65692
+ transfer-ownership="none"
65693
+ nullable="1"
65694
+ allow-none="1">
65695
+ <type name="gpointer" c:type="gpointer"/>
65696
+ </parameter>
65697
+ </parameters>
65698
+ </virtual-method>
65699
+ <virtual-method name="subscribe">
65700
+ <return-value transfer-ownership="none">
65701
+ <type name="none" c:type="void"/>
65702
+ </return-value>
65703
+ <parameters>
65704
+ <instance-parameter name="backend" transfer-ownership="none">
65705
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65706
+ </instance-parameter>
65707
+ <parameter name="name" transfer-ownership="none">
65708
+ <type name="utf8" c:type="const gchar*"/>
65709
+ </parameter>
65710
+ </parameters>
65711
+ </virtual-method>
65712
+ <virtual-method name="sync">
65713
+ <return-value transfer-ownership="none">
65714
+ <type name="none" c:type="void"/>
65715
+ </return-value>
65716
+ <parameters>
65717
+ <instance-parameter name="backend" transfer-ownership="none">
65718
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65719
+ </instance-parameter>
65720
+ </parameters>
65721
+ </virtual-method>
65722
+ <virtual-method name="unsubscribe">
65723
+ <return-value transfer-ownership="none">
65724
+ <type name="none" c:type="void"/>
65725
+ </return-value>
65726
+ <parameters>
65727
+ <instance-parameter name="backend" transfer-ownership="none">
65728
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65729
+ </instance-parameter>
65730
+ <parameter name="name" transfer-ownership="none">
65731
+ <type name="utf8" c:type="const gchar*"/>
65732
+ </parameter>
65733
+ </parameters>
65734
+ </virtual-method>
65735
+ <virtual-method name="write">
65736
+ <return-value transfer-ownership="none">
65737
+ <type name="gboolean" c:type="gboolean"/>
65738
+ </return-value>
65739
+ <parameters>
65740
+ <instance-parameter name="backend" transfer-ownership="none">
65741
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65742
+ </instance-parameter>
65743
+ <parameter name="key" transfer-ownership="none">
65744
+ <type name="utf8" c:type="const gchar*"/>
65745
+ </parameter>
65746
+ <parameter name="value" transfer-ownership="none">
65747
+ <type name="GLib.Variant" c:type="GVariant*"/>
65748
+ </parameter>
65749
+ <parameter name="origin_tag"
65750
+ transfer-ownership="none"
65751
+ nullable="1"
65752
+ allow-none="1">
65753
+ <type name="gpointer" c:type="gpointer"/>
65754
+ </parameter>
65755
+ </parameters>
65756
+ </virtual-method>
65757
+ <virtual-method name="write_tree">
65758
+ <return-value transfer-ownership="none">
65759
+ <type name="gboolean" c:type="gboolean"/>
65760
+ </return-value>
65761
+ <parameters>
65762
+ <instance-parameter name="backend" transfer-ownership="none">
65763
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65764
+ </instance-parameter>
65765
+ <parameter name="tree" transfer-ownership="none">
65766
+ <type name="GLib.Tree" c:type="GTree*"/>
65767
+ </parameter>
65768
+ <parameter name="origin_tag"
65769
+ transfer-ownership="none"
65770
+ nullable="1"
65771
+ allow-none="1">
65772
+ <type name="gpointer" c:type="gpointer"/>
65773
+ </parameter>
65774
+ </parameters>
65775
+ </virtual-method>
65776
+ <method name="changed"
65777
+ c:identifier="g_settings_backend_changed"
65778
+ version="2.26">
65779
+ <doc xml:space="preserve">Signals that a single key has possibly changed. Backend
65780
+ implementations should call this if a key has possibly changed its
65781
+ value.
65782
+
65783
+ @key must be a valid key (ie starting with a slash, not containing
65784
+ '//', and not ending with a slash).
65785
+
65786
+ The implementation must call this function during any call to
65787
+ g_settings_backend_write(), before the call returns (except in the
65788
+ case that no keys are actually changed and it cares to detect this
65789
+ fact). It may not rely on the existence of a mainloop for
65790
+ dispatching the signal later.
65791
+
65792
+ The implementation may call this function at any other time it likes
65793
+ in response to other events (such as changes occurring outside of the
65794
+ program). These calls may originate from a mainloop or may originate
65795
+ in response to any other action (including from calls to
65796
+ g_settings_backend_write()).
65797
+
65798
+ In the case that this call is in response to a call to
65799
+ g_settings_backend_write() then @origin_tag must be set to the same
65800
+ value that was passed to that call.</doc>
65801
+ <return-value transfer-ownership="none">
65802
+ <type name="none" c:type="void"/>
65803
+ </return-value>
65804
+ <parameters>
65805
+ <instance-parameter name="backend" transfer-ownership="none">
65806
+ <doc xml:space="preserve">a #GSettingsBackend implementation</doc>
65807
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65808
+ </instance-parameter>
65809
+ <parameter name="key" transfer-ownership="none">
65810
+ <doc xml:space="preserve">the name of the key</doc>
65811
+ <type name="utf8" c:type="const gchar*"/>
65812
+ </parameter>
65813
+ <parameter name="origin_tag"
65814
+ transfer-ownership="none"
65815
+ nullable="1"
65816
+ allow-none="1">
65817
+ <doc xml:space="preserve">the origin tag</doc>
65818
+ <type name="gpointer" c:type="gpointer"/>
65819
+ </parameter>
65820
+ </parameters>
65821
+ </method>
65822
+ <method name="changed_tree"
65823
+ c:identifier="g_settings_backend_changed_tree"
65824
+ version="2.26">
65825
+ <doc xml:space="preserve">This call is a convenience wrapper. It gets the list of changes from
65826
+ @tree, computes the longest common prefix and calls
65827
+ g_settings_backend_changed().</doc>
65828
+ <return-value transfer-ownership="none">
65829
+ <type name="none" c:type="void"/>
65830
+ </return-value>
65831
+ <parameters>
65832
+ <instance-parameter name="backend" transfer-ownership="none">
65833
+ <doc xml:space="preserve">a #GSettingsBackend implementation</doc>
65834
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65835
+ </instance-parameter>
65836
+ <parameter name="tree" transfer-ownership="none">
65837
+ <doc xml:space="preserve">a #GTree containing the changes</doc>
65838
+ <type name="GLib.Tree" c:type="GTree*"/>
65839
+ </parameter>
65840
+ <parameter name="origin_tag"
65841
+ transfer-ownership="none"
65842
+ nullable="1"
65843
+ allow-none="1">
65844
+ <doc xml:space="preserve">the origin tag</doc>
65845
+ <type name="gpointer" c:type="gpointer"/>
65846
+ </parameter>
65847
+ </parameters>
65848
+ </method>
65849
+ <method name="keys_changed"
65850
+ c:identifier="g_settings_backend_keys_changed"
65851
+ version="2.26">
65852
+ <doc xml:space="preserve">Signals that a list of keys have possibly changed. Backend
65853
+ implementations should call this if keys have possibly changed their
65854
+ values.
65855
+
65856
+ @path must be a valid path (ie starting and ending with a slash and
65857
+ not containing '//'). Each string in @items must form a valid key
65858
+ name when @path is prefixed to it (ie: each item must not start or
65859
+ end with '/' and must not contain '//').
65860
+
65861
+ The meaning of this signal is that any of the key names resulting
65862
+ from the contatenation of @path with each item in @items may have
65863
+ changed.
65864
+
65865
+ The same rules for when notifications must occur apply as per
65866
+ g_settings_backend_changed(). These two calls can be used
65867
+ interchangeably if exactly one item has changed (although in that
65868
+ case g_settings_backend_changed() is definitely preferred).
65869
+
65870
+ For efficiency reasons, the implementation should strive for @path to
65871
+ be as long as possible (ie: the longest common prefix of all of the
65872
+ keys that were changed) but this is not strictly required.</doc>
65873
+ <return-value transfer-ownership="none">
65874
+ <type name="none" c:type="void"/>
65875
+ </return-value>
65876
+ <parameters>
65877
+ <instance-parameter name="backend" transfer-ownership="none">
65878
+ <doc xml:space="preserve">a #GSettingsBackend implementation</doc>
65879
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65880
+ </instance-parameter>
65881
+ <parameter name="path" transfer-ownership="none">
65882
+ <doc xml:space="preserve">the path containing the changes</doc>
65883
+ <type name="utf8" c:type="const gchar*"/>
65884
+ </parameter>
65885
+ <parameter name="items" transfer-ownership="none">
65886
+ <doc xml:space="preserve">the %NULL-terminated list of changed keys</doc>
65887
+ <array c:type="gchar**">
65888
+ <type name="utf8" c:type="gchar*"/>
65889
+ </array>
65890
+ </parameter>
65891
+ <parameter name="origin_tag"
65892
+ transfer-ownership="none"
65893
+ nullable="1"
65894
+ allow-none="1">
65895
+ <doc xml:space="preserve">the origin tag</doc>
65896
+ <type name="gpointer" c:type="gpointer"/>
65897
+ </parameter>
65898
+ </parameters>
65899
+ </method>
65900
+ <method name="path_changed"
65901
+ c:identifier="g_settings_backend_path_changed"
65902
+ version="2.26">
65903
+ <doc xml:space="preserve">Signals that all keys below a given path may have possibly changed.
65904
+ Backend implementations should call this if an entire path of keys
65905
+ have possibly changed their values.
65906
+
65907
+ @path must be a valid path (ie starting and ending with a slash and
65908
+ not containing '//').
65909
+
65910
+ The meaning of this signal is that any of the key which has a name
65911
+ starting with @path may have changed.
65912
+
65913
+ The same rules for when notifications must occur apply as per
65914
+ g_settings_backend_changed(). This call might be an appropriate
65915
+ reasponse to a 'reset' call but implementations are also free to
65916
+ explicitly list the keys that were affected by that call if they can
65917
+ easily do so.
65918
+
65919
+ For efficiency reasons, the implementation should strive for @path to
65920
+ be as long as possible (ie: the longest common prefix of all of the
65921
+ keys that were changed) but this is not strictly required. As an
65922
+ example, if this function is called with the path of "/" then every
65923
+ single key in the application will be notified of a possible change.</doc>
65924
+ <return-value transfer-ownership="none">
65925
+ <type name="none" c:type="void"/>
65926
+ </return-value>
65927
+ <parameters>
65928
+ <instance-parameter name="backend" transfer-ownership="none">
65929
+ <doc xml:space="preserve">a #GSettingsBackend implementation</doc>
65930
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65931
+ </instance-parameter>
65932
+ <parameter name="path" transfer-ownership="none">
65933
+ <doc xml:space="preserve">the path containing the changes</doc>
65934
+ <type name="utf8" c:type="const gchar*"/>
65935
+ </parameter>
65936
+ <parameter name="origin_tag"
65937
+ transfer-ownership="none"
65938
+ nullable="1"
65939
+ allow-none="1">
65940
+ <doc xml:space="preserve">the origin tag</doc>
65941
+ <type name="gpointer" c:type="gpointer"/>
65942
+ </parameter>
65943
+ </parameters>
65944
+ </method>
65945
+ <method name="path_writable_changed"
65946
+ c:identifier="g_settings_backend_path_writable_changed"
65947
+ version="2.26">
65948
+ <doc xml:space="preserve">Signals that the writability of all keys below a given path may have
65949
+ changed.
65950
+
65951
+ Since GSettings performs no locking operations for itself, this call
65952
+ will always be made in response to external events.</doc>
65953
+ <return-value transfer-ownership="none">
65954
+ <type name="none" c:type="void"/>
65955
+ </return-value>
65956
+ <parameters>
65957
+ <instance-parameter name="backend" transfer-ownership="none">
65958
+ <doc xml:space="preserve">a #GSettingsBackend implementation</doc>
65959
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65960
+ </instance-parameter>
65961
+ <parameter name="path" transfer-ownership="none">
65962
+ <doc xml:space="preserve">the name of the path</doc>
65963
+ <type name="utf8" c:type="const gchar*"/>
65964
+ </parameter>
65965
+ </parameters>
65966
+ </method>
65967
+ <method name="writable_changed"
65968
+ c:identifier="g_settings_backend_writable_changed"
65969
+ version="2.26">
65970
+ <doc xml:space="preserve">Signals that the writability of a single key has possibly changed.
65971
+
65972
+ Since GSettings performs no locking operations for itself, this call
65973
+ will always be made in response to external events.</doc>
65974
+ <return-value transfer-ownership="none">
65975
+ <type name="none" c:type="void"/>
65976
+ </return-value>
65977
+ <parameters>
65978
+ <instance-parameter name="backend" transfer-ownership="none">
65979
+ <doc xml:space="preserve">a #GSettingsBackend implementation</doc>
65980
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
65981
+ </instance-parameter>
65982
+ <parameter name="key" transfer-ownership="none">
65983
+ <doc xml:space="preserve">the name of the key</doc>
65984
+ <type name="utf8" c:type="const gchar*"/>
65985
+ </parameter>
65986
+ </parameters>
65987
+ </method>
65988
+ <field name="parent_instance">
65989
+ <type name="GObject.Object" c:type="GObject"/>
65990
+ </field>
65991
+ <field name="priv" readable="0" private="1">
65992
+ <type name="SettingsBackendPrivate" c:type="GSettingsBackendPrivate*"/>
65993
+ </field>
65994
+ </class>
65995
+ <record name="SettingsBackendClass"
65996
+ c:type="GSettingsBackendClass"
65997
+ glib:is-gtype-struct-for="SettingsBackend">
65998
+ <doc xml:space="preserve">Class structure for #GSettingsBackend.</doc>
65999
+ <field name="parent_class">
66000
+ <type name="GObject.ObjectClass" c:type="GObjectClass"/>
66001
+ </field>
66002
+ <field name="read">
66003
+ <callback name="read">
66004
+ <return-value transfer-ownership="full">
66005
+ <type name="GLib.Variant" c:type="GVariant*"/>
66006
+ </return-value>
66007
+ <parameters>
66008
+ <parameter name="backend" transfer-ownership="none">
66009
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
66010
+ </parameter>
66011
+ <parameter name="key" transfer-ownership="none">
66012
+ <type name="utf8" c:type="const gchar*"/>
66013
+ </parameter>
66014
+ <parameter name="expected_type" transfer-ownership="none">
66015
+ <type name="GLib.VariantType" c:type="const GVariantType*"/>
66016
+ </parameter>
66017
+ <parameter name="default_value" transfer-ownership="none">
66018
+ <type name="gboolean" c:type="gboolean"/>
66019
+ </parameter>
66020
+ </parameters>
66021
+ </callback>
66022
+ </field>
66023
+ <field name="get_writable">
66024
+ <callback name="get_writable">
66025
+ <return-value transfer-ownership="none">
66026
+ <type name="gboolean" c:type="gboolean"/>
66027
+ </return-value>
66028
+ <parameters>
66029
+ <parameter name="backend" transfer-ownership="none">
66030
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
66031
+ </parameter>
66032
+ <parameter name="key" transfer-ownership="none">
66033
+ <type name="utf8" c:type="const gchar*"/>
66034
+ </parameter>
66035
+ </parameters>
66036
+ </callback>
66037
+ </field>
66038
+ <field name="write">
66039
+ <callback name="write">
66040
+ <return-value transfer-ownership="none">
66041
+ <type name="gboolean" c:type="gboolean"/>
66042
+ </return-value>
66043
+ <parameters>
66044
+ <parameter name="backend" transfer-ownership="none">
66045
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
66046
+ </parameter>
66047
+ <parameter name="key" transfer-ownership="none">
66048
+ <type name="utf8" c:type="const gchar*"/>
66049
+ </parameter>
66050
+ <parameter name="value" transfer-ownership="none">
66051
+ <type name="GLib.Variant" c:type="GVariant*"/>
66052
+ </parameter>
66053
+ <parameter name="origin_tag"
66054
+ transfer-ownership="none"
66055
+ nullable="1"
66056
+ allow-none="1">
66057
+ <type name="gpointer" c:type="gpointer"/>
66058
+ </parameter>
66059
+ </parameters>
66060
+ </callback>
66061
+ </field>
66062
+ <field name="write_tree">
66063
+ <callback name="write_tree">
66064
+ <return-value transfer-ownership="none">
66065
+ <type name="gboolean" c:type="gboolean"/>
66066
+ </return-value>
66067
+ <parameters>
66068
+ <parameter name="backend" transfer-ownership="none">
66069
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
66070
+ </parameter>
66071
+ <parameter name="tree" transfer-ownership="none">
66072
+ <type name="GLib.Tree" c:type="GTree*"/>
66073
+ </parameter>
66074
+ <parameter name="origin_tag"
66075
+ transfer-ownership="none"
66076
+ nullable="1"
66077
+ allow-none="1">
66078
+ <type name="gpointer" c:type="gpointer"/>
66079
+ </parameter>
66080
+ </parameters>
66081
+ </callback>
66082
+ </field>
66083
+ <field name="reset">
66084
+ <callback name="reset">
66085
+ <return-value transfer-ownership="none">
66086
+ <type name="none" c:type="void"/>
66087
+ </return-value>
66088
+ <parameters>
66089
+ <parameter name="backend" transfer-ownership="none">
66090
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
66091
+ </parameter>
66092
+ <parameter name="key" transfer-ownership="none">
66093
+ <type name="utf8" c:type="const gchar*"/>
66094
+ </parameter>
66095
+ <parameter name="origin_tag"
66096
+ transfer-ownership="none"
66097
+ nullable="1"
66098
+ allow-none="1">
66099
+ <type name="gpointer" c:type="gpointer"/>
66100
+ </parameter>
66101
+ </parameters>
66102
+ </callback>
66103
+ </field>
66104
+ <field name="subscribe">
66105
+ <callback name="subscribe">
66106
+ <return-value transfer-ownership="none">
66107
+ <type name="none" c:type="void"/>
66108
+ </return-value>
66109
+ <parameters>
66110
+ <parameter name="backend" transfer-ownership="none">
66111
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
66112
+ </parameter>
66113
+ <parameter name="name" transfer-ownership="none">
66114
+ <type name="utf8" c:type="const gchar*"/>
66115
+ </parameter>
66116
+ </parameters>
66117
+ </callback>
66118
+ </field>
66119
+ <field name="unsubscribe">
66120
+ <callback name="unsubscribe">
66121
+ <return-value transfer-ownership="none">
66122
+ <type name="none" c:type="void"/>
66123
+ </return-value>
66124
+ <parameters>
66125
+ <parameter name="backend" transfer-ownership="none">
66126
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
66127
+ </parameter>
66128
+ <parameter name="name" transfer-ownership="none">
66129
+ <type name="utf8" c:type="const gchar*"/>
66130
+ </parameter>
66131
+ </parameters>
66132
+ </callback>
66133
+ </field>
66134
+ <field name="sync">
66135
+ <callback name="sync">
66136
+ <return-value transfer-ownership="none">
66137
+ <type name="none" c:type="void"/>
66138
+ </return-value>
66139
+ <parameters>
66140
+ <parameter name="backend" transfer-ownership="none">
66141
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
66142
+ </parameter>
66143
+ </parameters>
66144
+ </callback>
66145
+ </field>
66146
+ <field name="get_permission" introspectable="0">
66147
+ <callback name="get_permission" introspectable="0">
66148
+ <return-value>
66149
+ <type name="Permission" c:type="GPermission*"/>
66150
+ </return-value>
66151
+ <parameters>
66152
+ <parameter name="backend" transfer-ownership="none">
66153
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
66154
+ </parameter>
66155
+ <parameter name="path" transfer-ownership="none">
66156
+ <type name="utf8" c:type="const gchar*"/>
66157
+ </parameter>
66158
+ </parameters>
66159
+ </callback>
66160
+ </field>
66161
+ <field name="read_user_value">
66162
+ <callback name="read_user_value">
66163
+ <return-value transfer-ownership="full">
66164
+ <type name="GLib.Variant" c:type="GVariant*"/>
66165
+ </return-value>
66166
+ <parameters>
66167
+ <parameter name="backend" transfer-ownership="none">
66168
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
66169
+ </parameter>
66170
+ <parameter name="key" transfer-ownership="none">
66171
+ <type name="utf8" c:type="const gchar*"/>
66172
+ </parameter>
66173
+ <parameter name="expected_type" transfer-ownership="none">
66174
+ <type name="GLib.VariantType" c:type="const GVariantType*"/>
66175
+ </parameter>
66176
+ </parameters>
66177
+ </callback>
66178
+ </field>
66179
+ <field name="padding" readable="0" private="1">
66180
+ <array zero-terminated="0" c:type="gpointer" fixed-size="23">
66181
+ <type name="gpointer" c:type="gpointer"/>
66182
+ </array>
66183
+ </field>
66184
+ </record>
66185
+ <record name="SettingsBackendPrivate"
66186
+ c:type="GSettingsBackendPrivate"
66187
+ disguised="1">
65488
66188
  </record>
65489
66189
  <bitfield name="SettingsBindFlags"
65490
66190
  glib:type-name="GSettingsBindFlags"
@@ -69053,7 +69753,8 @@ the peer, or -1 on error</doc>
69053
69753
  direction="out"
69054
69754
  caller-allocates="0"
69055
69755
  transfer-ownership="full"
69056
- nullable="1">
69756
+ optional="1"
69757
+ allow-none="1">
69057
69758
  <doc xml:space="preserve">a pointer to a #GSocketAddress
69058
69759
  pointer, or %NULL</doc>
69059
69760
  <type name="SocketAddress" c:type="GSocketAddress**"/>
@@ -69072,7 +69773,8 @@ the peer, or -1 on error</doc>
69072
69773
  direction="out"
69073
69774
  caller-allocates="0"
69074
69775
  transfer-ownership="full"
69075
- nullable="1">
69776
+ optional="1"
69777
+ allow-none="1">
69076
69778
  <doc xml:space="preserve">a pointer which
69077
69779
  may be filled with an array of #GSocketControlMessages, or %NULL</doc>
69078
69780
  <array length="4"
@@ -74871,6 +75573,9 @@ g_environ_unsetenv(), etc.
74871
75573
  As an alternative, you can use g_subprocess_launcher_setenv(),
74872
75574
  g_subprocess_launcher_unsetenv(), etc.
74873
75575
 
75576
+ Pass %NULL to inherit the parent process' environment. Pass an
75577
+ empty array to set an empty environment.
75578
+
74874
75579
  On UNIX, all strings in this array can be arbitrary byte strings.
74875
75580
  On Windows, they should be in UTF-8.</doc>
74876
75581
  <return-value transfer-ownership="none">
@@ -79565,8 +80270,8 @@ objects. Use g_object_unref() on each certificate, and g_list_free() on the rele
79565
80270
  invoker="verify_chain"
79566
80271
  version="2.30"
79567
80272
  throws="1">
79568
- <doc xml:space="preserve">Verify's a certificate chain after looking up and adding any missing
79569
- certificates to the chain.
80273
+ <doc xml:space="preserve">Determines the validity of a certificate chain after looking up and
80274
+ adding any missing certificates to the chain.
79570
80275
 
79571
80276
  @chain is a chain of #GTlsCertificate objects each pointing to the next
79572
80277
  certificate in the chain by its %issuer property. The chain may initially
@@ -79587,6 +80292,15 @@ host by host basis.
79587
80292
  Currently there are no @flags, and %G_TLS_DATABASE_VERIFY_NONE should be
79588
80293
  used.
79589
80294
 
80295
+ If @chain is found to be valid, then the return value will be 0. If
80296
+ @chain is found to be invalid, then the return value will indicate
80297
+ the problems found. If the function is unable to determine whether
80298
+ @chain is valid or not (eg, because @cancellable is triggered
80299
+ before it completes) then the return value will be
80300
+ %G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set
80301
+ accordingly. @error is not set when @chain is successfully analyzed
80302
+ but found to be invalid.
80303
+
79590
80304
  This function can block, use g_tls_database_verify_chain_async() to perform
79591
80305
  the verification operation asynchronously.</doc>
79592
80306
  <return-value transfer-ownership="none">
@@ -79638,9 +80352,9 @@ result of verification.</doc>
79638
80352
  <virtual-method name="verify_chain_async"
79639
80353
  invoker="verify_chain_async"
79640
80354
  version="2.30">
79641
- <doc xml:space="preserve">Asynchronously verify's a certificate chain after looking up and adding
79642
- any missing certificates to the chain. See g_tls_database_verify_chain()
79643
- for more information.</doc>
80355
+ <doc xml:space="preserve">Asynchronously determines the validity of a certificate chain after
80356
+ looking up and adding any missing certificates to the chain. See
80357
+ g_tls_database_verify_chain() for more information.</doc>
79644
80358
  <return-value transfer-ownership="none">
79645
80359
  <type name="none" c:type="void"/>
79646
80360
  </return-value>
@@ -79707,7 +80421,16 @@ for more information.</doc>
79707
80421
  version="2.30"
79708
80422
  throws="1">
79709
80423
  <doc xml:space="preserve">Finish an asynchronous verify chain operation. See
79710
- g_tls_database_verify_chain() for more information. *</doc>
80424
+ g_tls_database_verify_chain() for more information.
80425
+
80426
+ If @chain is found to be valid, then the return value will be 0. If
80427
+ @chain is found to be invalid, then the return value will indicate
80428
+ the problems found. If the function is unable to determine whether
80429
+ @chain is valid or not (eg, because @cancellable is triggered
80430
+ before it completes) then the return value will be
80431
+ %G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set
80432
+ accordingly. @error is not set when @chain is successfully analyzed
80433
+ but found to be invalid.</doc>
79711
80434
  <return-value transfer-ownership="none">
79712
80435
  <doc xml:space="preserve">the appropriate #GTlsCertificateFlags which represents the
79713
80436
  result of verification.</doc>
@@ -80139,8 +80862,8 @@ objects. Use g_object_unref() on each certificate, and g_list_free() on the rele
80139
80862
  c:identifier="g_tls_database_verify_chain"
80140
80863
  version="2.30"
80141
80864
  throws="1">
80142
- <doc xml:space="preserve">Verify's a certificate chain after looking up and adding any missing
80143
- certificates to the chain.
80865
+ <doc xml:space="preserve">Determines the validity of a certificate chain after looking up and
80866
+ adding any missing certificates to the chain.
80144
80867
 
80145
80868
  @chain is a chain of #GTlsCertificate objects each pointing to the next
80146
80869
  certificate in the chain by its %issuer property. The chain may initially
@@ -80161,6 +80884,15 @@ host by host basis.
80161
80884
  Currently there are no @flags, and %G_TLS_DATABASE_VERIFY_NONE should be
80162
80885
  used.
80163
80886
 
80887
+ If @chain is found to be valid, then the return value will be 0. If
80888
+ @chain is found to be invalid, then the return value will indicate
80889
+ the problems found. If the function is unable to determine whether
80890
+ @chain is valid or not (eg, because @cancellable is triggered
80891
+ before it completes) then the return value will be
80892
+ %G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set
80893
+ accordingly. @error is not set when @chain is successfully analyzed
80894
+ but found to be invalid.
80895
+
80164
80896
  This function can block, use g_tls_database_verify_chain_async() to perform
80165
80897
  the verification operation asynchronously.</doc>
80166
80898
  <return-value transfer-ownership="none">
@@ -80212,9 +80944,9 @@ result of verification.</doc>
80212
80944
  <method name="verify_chain_async"
80213
80945
  c:identifier="g_tls_database_verify_chain_async"
80214
80946
  version="2.30">
80215
- <doc xml:space="preserve">Asynchronously verify's a certificate chain after looking up and adding
80216
- any missing certificates to the chain. See g_tls_database_verify_chain()
80217
- for more information.</doc>
80947
+ <doc xml:space="preserve">Asynchronously determines the validity of a certificate chain after
80948
+ looking up and adding any missing certificates to the chain. See
80949
+ g_tls_database_verify_chain() for more information.</doc>
80218
80950
  <return-value transfer-ownership="none">
80219
80951
  <type name="none" c:type="void"/>
80220
80952
  </return-value>
@@ -80280,7 +81012,16 @@ for more information.</doc>
80280
81012
  version="2.30"
80281
81013
  throws="1">
80282
81014
  <doc xml:space="preserve">Finish an asynchronous verify chain operation. See
80283
- g_tls_database_verify_chain() for more information. *</doc>
81015
+ g_tls_database_verify_chain() for more information.
81016
+
81017
+ If @chain is found to be valid, then the return value will be 0. If
81018
+ @chain is found to be invalid, then the return value will indicate
81019
+ the problems found. If the function is unable to determine whether
81020
+ @chain is valid or not (eg, because @cancellable is triggered
81021
+ before it completes) then the return value will be
81022
+ %G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set
81023
+ accordingly. @error is not set when @chain is successfully analyzed
81024
+ but found to be invalid.</doc>
80284
81025
  <return-value transfer-ownership="none">
80285
81026
  <doc xml:space="preserve">the appropriate #GTlsCertificateFlags which represents the
80286
81027
  result of verification.</doc>
@@ -86994,11 +87735,33 @@ g_mount_guess_content_type().</doc>
86994
87735
  </parameter>
86995
87736
  </parameters>
86996
87737
  </function>
87738
+ <function name="content_type_is_mime_type"
87739
+ c:identifier="g_content_type_is_mime_type"
87740
+ version="2.52">
87741
+ <doc xml:space="preserve">Determines if @type is a subset of @mime_type.
87742
+ Convenience wrapper around g_content_type_is_a().</doc>
87743
+ <return-value transfer-ownership="none">
87744
+ <doc xml:space="preserve">%TRUE if @type is a kind of @mime_type,
87745
+ %FALSE otherwise.</doc>
87746
+ <type name="gboolean" c:type="gboolean"/>
87747
+ </return-value>
87748
+ <parameters>
87749
+ <parameter name="type" transfer-ownership="none">
87750
+ <doc xml:space="preserve">a content type string</doc>
87751
+ <type name="utf8" c:type="const gchar*"/>
87752
+ </parameter>
87753
+ <parameter name="mime_type" transfer-ownership="none">
87754
+ <doc xml:space="preserve">a mime type string</doc>
87755
+ <type name="utf8" c:type="const gchar*"/>
87756
+ </parameter>
87757
+ </parameters>
87758
+ </function>
86997
87759
  <function name="content_type_is_unknown"
86998
87760
  c:identifier="g_content_type_is_unknown">
86999
87761
  <doc xml:space="preserve">Checks if the content type is the generic "unknown" type.
87000
87762
  On UNIX this is the "application/octet-stream" mimetype,
87001
- while on win32 it is "*".</doc>
87763
+ while on win32 it is "*" and on OSX it is a dynamic type
87764
+ or octet-stream.</doc>
87002
87765
  <return-value transfer-ownership="none">
87003
87766
  <doc xml:space="preserve">%TRUE if the type is the unknown type.</doc>
87004
87767
  <type name="gboolean" c:type="gboolean"/>
@@ -87052,7 +87815,10 @@ which could be used in a D-Bus address like
87052
87815
  throws="1">
87053
87816
  <doc xml:space="preserve">Synchronously looks up the D-Bus address for the well-known message
87054
87817
  bus instance specified by @bus_type. This may involve using various
87055
- platform specific mechanisms.</doc>
87818
+ platform specific mechanisms.
87819
+
87820
+ The returned address will be in the
87821
+ [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).</doc>
87056
87822
  <return-value transfer-ownership="full">
87057
87823
  <doc xml:space="preserve">a valid D-Bus address string for @bus_type or %NULL if
87058
87824
  @error is set</doc>
@@ -87077,7 +87843,8 @@ platform specific mechanisms.</doc>
87077
87843
  version="2.26">
87078
87844
  <doc xml:space="preserve">Asynchronously connects to an endpoint specified by @address and
87079
87845
  sets up the connection so it is in a state to run the client-side
87080
- of the D-Bus authentication conversation.
87846
+ of the D-Bus authentication conversation. @address must be in the
87847
+ [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
87081
87848
 
87082
87849
  When the operation is finished, @callback will be invoked. You can
87083
87850
  then call g_dbus_address_get_stream_finish() to get the result of
@@ -87149,7 +87916,8 @@ g_dbus_address_get_stream_sync() for the synchronous version.</doc>
87149
87916
  throws="1">
87150
87917
  <doc xml:space="preserve">Synchronously connects to an endpoint specified by @address and
87151
87918
  sets up the connection so it is in a state to run the client-side
87152
- of the D-Bus authentication conversation.
87919
+ of the D-Bus authentication conversation. @address must be in the
87920
+ [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
87153
87921
 
87154
87922
  This is a synchronous failable function. See
87155
87923
  g_dbus_address_get_stream() for the asynchronous version.</doc>
@@ -87517,7 +88285,8 @@ The conversion never fails - a valid #GValue is always returned in
87517
88285
  <function name="dbus_is_address"
87518
88286
  c:identifier="g_dbus_is_address"
87519
88287
  version="2.26">
87520
- <doc xml:space="preserve">Checks if @string is a D-Bus address.
88288
+ <doc xml:space="preserve">Checks if @string is a
88289
+ [D-Bus address](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
87521
88290
 
87522
88291
  This doesn't check if @string is actually supported by #GDBusServer
87523
88292
  or #GDBusConnection - use g_dbus_is_supported_address() to do more
@@ -87596,9 +88365,10 @@ GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).</doc>
87596
88365
  c:identifier="g_dbus_is_supported_address"
87597
88366
  version="2.26"
87598
88367
  throws="1">
87599
- <doc xml:space="preserve">Like g_dbus_is_address() but also checks if the library suppors the
88368
+ <doc xml:space="preserve">Like g_dbus_is_address() but also checks if the library supports the
87600
88369
  transports in @string and that key/value pairs for each transport
87601
- are valid.</doc>
88370
+ are valid. See the specification of the
88371
+ [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).</doc>
87602
88372
  <return-value transfer-ownership="none">
87603
88373
  <doc xml:space="preserve">%TRUE if @string is a valid D-Bus address that is
87604
88374
  supported by this library, %FALSE if @error is set.</doc>
@@ -88207,6 +88977,88 @@ of the request.</doc>
88207
88977
  </parameter>
88208
88978
  </parameters>
88209
88979
  </function>
88980
+ <function name="keyfile_settings_backend_new"
88981
+ c:identifier="g_keyfile_settings_backend_new">
88982
+ <doc xml:space="preserve">Creates a keyfile-backed #GSettingsBackend.
88983
+
88984
+ The filename of the keyfile to use is given by @filename.
88985
+
88986
+ All settings read to or written from the backend must fall under the
88987
+ path given in @root_path (which must start and end with a slash and
88988
+ not contain two consecutive slashes). @root_path may be "/".
88989
+
88990
+ If @root_group is non-%NULL then it specifies the name of the keyfile
88991
+ group used for keys that are written directly below @root_path. For
88992
+ example, if @root_path is "/apps/example/" and @root_group is
88993
+ "toplevel", then settings the key "/apps/example/enabled" to a value
88994
+ of %TRUE will cause the following to appear in the keyfile:
88995
+
88996
+ |[
88997
+ [toplevel]
88998
+ enabled=true
88999
+ ]|
89000
+
89001
+ If @root_group is %NULL then it is not permitted to store keys
89002
+ directly below the @root_path.
89003
+
89004
+ For keys not stored directly below @root_path (ie: in a sub-path),
89005
+ the name of the subpath (with the final slash stripped) is used as
89006
+ the name of the keyfile group. To continue the example, if
89007
+ "/apps/example/profiles/default/font-size" were set to
89008
+ 12 then the following would appear in the keyfile:
89009
+
89010
+ |[
89011
+ [profiles/default]
89012
+ font-size=12
89013
+ ]|
89014
+
89015
+ The backend will refuse writes (and return writability as being
89016
+ %FALSE) for keys outside of @root_path and, in the event that
89017
+ @root_group is %NULL, also for keys directly under @root_path.
89018
+ Writes will also be refused if the backend detects that it has the
89019
+ inability to rewrite the keyfile (ie: the containing directory is not
89020
+ writable).
89021
+
89022
+ There is no checking done for your key namespace clashing with the
89023
+ syntax of the key file format. For example, if you have '[' or ']'
89024
+ characters in your path names or '=' in your key names you may be in
89025
+ trouble.</doc>
89026
+ <return-value transfer-ownership="full">
89027
+ <doc xml:space="preserve">a keyfile-backed #GSettingsBackend</doc>
89028
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
89029
+ </return-value>
89030
+ <parameters>
89031
+ <parameter name="filename" transfer-ownership="none">
89032
+ <doc xml:space="preserve">the filename of the keyfile</doc>
89033
+ <type name="utf8" c:type="const gchar*"/>
89034
+ </parameter>
89035
+ <parameter name="root_path" transfer-ownership="none">
89036
+ <doc xml:space="preserve">the path under which all settings keys appear</doc>
89037
+ <type name="utf8" c:type="const gchar*"/>
89038
+ </parameter>
89039
+ <parameter name="root_group"
89040
+ transfer-ownership="none"
89041
+ nullable="1"
89042
+ allow-none="1">
89043
+ <doc xml:space="preserve">the group name corresponding to
89044
+ @root_path, or %NULL</doc>
89045
+ <type name="utf8" c:type="const gchar*"/>
89046
+ </parameter>
89047
+ </parameters>
89048
+ </function>
89049
+ <function name="memory_settings_backend_new"
89050
+ c:identifier="g_memory_settings_backend_new"
89051
+ version="2.28">
89052
+ <doc xml:space="preserve">Creates a memory-backed #GSettingsBackend.
89053
+
89054
+ This backend allows changes to settings, but does not write them
89055
+ to any backing storage, so the next time you run your application,
89056
+ the memory backend will start out with the default values again.</doc>
89057
+ <return-value transfer-ownership="full">
89058
+ <doc xml:space="preserve">a newly created #GSettingsBackend</doc>
89059
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
89060
+ </return-value>
89061
+ </function>
88210
89062
  <function name="network_monitor_get_default"
88211
89063
  c:identifier="g_network_monitor_get_default"
88212
89064
  moved-to="NetworkMonitor.get_default"
@@ -88228,6 +89080,18 @@ functions (without calling any GLib networking functions first).</doc>
88228
89080
  <type name="none" c:type="void"/>
88229
89081
  </return-value>
88230
89082
  </function>
89083
+ <function name="null_settings_backend_new"
89084
+ c:identifier="g_null_settings_backend_new"
89085
+ version="2.28">
89086
+ <doc xml:space="preserve">Creates a readonly #GSettingsBackend.
89087
+
89088
+ This backend does not allow changes to settings, so all settings
89089
+ will always have their default values.</doc>
89090
+ <return-value transfer-ownership="full">
89091
+ <doc xml:space="preserve">a newly created #GSettingsBackend</doc>
89092
+ <type name="SettingsBackend" c:type="GSettingsBackend*"/>
89093
+ </return-value>
89094
+ </function>
88231
89095
  <function name="pollable_source_new"
88232
89096
  c:identifier="g_pollable_source_new"
88233
89097
  version="2.28">