gobject-introspection 3.2.1-x64-mingw32 → 3.2.2-x64-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (100) hide show
  1. checksums.yaml +5 -5
  2. data/Rakefile +10 -7
  3. data/ext/gobject-introspection/rb-gi-argument.c +64 -16
  4. data/ext/gobject-introspection/rb-gi-conversions.h +3 -4
  5. data/ext/gobject-introspection/rb-gi-function-info.c +17 -8
  6. data/lib/2.2/gobject_introspection.so +0 -0
  7. data/lib/2.3/gobject_introspection.so +0 -0
  8. data/lib/2.4/gobject_introspection.so +0 -0
  9. data/lib/2.5/gobject_introspection.so +0 -0
  10. data/lib/gobject-introspection/loader.rb +11 -4
  11. data/vendor/local/bin/g-ir-compiler.exe +0 -0
  12. data/vendor/local/bin/g-ir-generate.exe +0 -0
  13. data/vendor/local/bin/g-ir-inspect.exe +0 -0
  14. data/vendor/local/bin/libgirepository-1.0-1.dll +0 -0
  15. data/vendor/local/lib/girepository-1.0/GIRepository-2.0.typelib +0 -0
  16. data/vendor/local/lib/girepository-1.0/GLib-2.0.typelib +0 -0
  17. data/vendor/local/lib/girepository-1.0/GObject-2.0.typelib +0 -0
  18. data/vendor/local/lib/girepository-1.0/Gio-2.0.typelib +0 -0
  19. data/vendor/local/lib/gobject-introspection/giscanner/__init__.pyc +0 -0
  20. data/vendor/local/lib/gobject-introspection/giscanner/__init__.pyo +0 -0
  21. data/vendor/local/lib/gobject-introspection/giscanner/annotationmain.pyc +0 -0
  22. data/vendor/local/lib/gobject-introspection/giscanner/annotationmain.pyo +0 -0
  23. data/vendor/local/lib/gobject-introspection/giscanner/annotationparser.pyc +0 -0
  24. data/vendor/local/lib/gobject-introspection/giscanner/annotationparser.pyo +0 -0
  25. data/vendor/local/lib/gobject-introspection/giscanner/ast.pyc +0 -0
  26. data/vendor/local/lib/gobject-introspection/giscanner/ast.pyo +0 -0
  27. data/vendor/local/lib/gobject-introspection/giscanner/cachestore.pyc +0 -0
  28. data/vendor/local/lib/gobject-introspection/giscanner/cachestore.pyo +0 -0
  29. data/vendor/local/lib/gobject-introspection/giscanner/ccompiler.py +3 -2
  30. data/vendor/local/lib/gobject-introspection/giscanner/ccompiler.pyc +0 -0
  31. data/vendor/local/lib/gobject-introspection/giscanner/ccompiler.pyo +0 -0
  32. data/vendor/local/lib/gobject-introspection/giscanner/codegen.pyc +0 -0
  33. data/vendor/local/lib/gobject-introspection/giscanner/codegen.pyo +0 -0
  34. data/vendor/local/lib/gobject-introspection/giscanner/collections/__init__.pyc +0 -0
  35. data/vendor/local/lib/gobject-introspection/giscanner/collections/__init__.pyo +0 -0
  36. data/vendor/local/lib/gobject-introspection/giscanner/collections/counter.pyc +0 -0
  37. data/vendor/local/lib/gobject-introspection/giscanner/collections/counter.pyo +0 -0
  38. data/vendor/local/lib/gobject-introspection/giscanner/collections/ordereddict.pyc +0 -0
  39. data/vendor/local/lib/gobject-introspection/giscanner/collections/ordereddict.pyo +0 -0
  40. data/vendor/local/lib/gobject-introspection/giscanner/docmain.pyc +0 -0
  41. data/vendor/local/lib/gobject-introspection/giscanner/docmain.pyo +0 -0
  42. data/vendor/local/lib/gobject-introspection/giscanner/docwriter.pyc +0 -0
  43. data/vendor/local/lib/gobject-introspection/giscanner/docwriter.pyo +0 -0
  44. data/vendor/local/lib/gobject-introspection/giscanner/dumper.py +1 -1
  45. data/vendor/local/lib/gobject-introspection/giscanner/dumper.pyc +0 -0
  46. data/vendor/local/lib/gobject-introspection/giscanner/dumper.pyo +0 -0
  47. data/vendor/local/lib/gobject-introspection/giscanner/gdumpparser.pyc +0 -0
  48. data/vendor/local/lib/gobject-introspection/giscanner/gdumpparser.pyo +0 -0
  49. data/vendor/local/lib/gobject-introspection/giscanner/girparser.pyc +0 -0
  50. data/vendor/local/lib/gobject-introspection/giscanner/girparser.pyo +0 -0
  51. data/vendor/local/lib/gobject-introspection/giscanner/girwriter.pyc +0 -0
  52. data/vendor/local/lib/gobject-introspection/giscanner/girwriter.pyo +0 -0
  53. data/vendor/local/lib/gobject-introspection/giscanner/introspectablepass.pyc +0 -0
  54. data/vendor/local/lib/gobject-introspection/giscanner/introspectablepass.pyo +0 -0
  55. data/vendor/local/lib/gobject-introspection/giscanner/libtoolimporter.pyc +0 -0
  56. data/vendor/local/lib/gobject-introspection/giscanner/libtoolimporter.pyo +0 -0
  57. data/vendor/local/lib/gobject-introspection/giscanner/maintransformer.py +1 -0
  58. data/vendor/local/lib/gobject-introspection/giscanner/maintransformer.pyc +0 -0
  59. data/vendor/local/lib/gobject-introspection/giscanner/maintransformer.pyo +0 -0
  60. data/vendor/local/lib/gobject-introspection/giscanner/message.pyc +0 -0
  61. data/vendor/local/lib/gobject-introspection/giscanner/message.pyo +0 -0
  62. data/vendor/local/lib/gobject-introspection/giscanner/msvccompiler.pyc +0 -0
  63. data/vendor/local/lib/gobject-introspection/giscanner/msvccompiler.pyo +0 -0
  64. data/vendor/local/lib/gobject-introspection/giscanner/scannermain.py +1 -1
  65. data/vendor/local/lib/gobject-introspection/giscanner/scannermain.pyc +0 -0
  66. data/vendor/local/lib/gobject-introspection/giscanner/scannermain.pyo +0 -0
  67. data/vendor/local/lib/gobject-introspection/giscanner/sectionparser.pyc +0 -0
  68. data/vendor/local/lib/gobject-introspection/giscanner/sectionparser.pyo +0 -0
  69. data/vendor/local/lib/gobject-introspection/giscanner/shlibs.py +7 -2
  70. data/vendor/local/lib/gobject-introspection/giscanner/shlibs.pyc +0 -0
  71. data/vendor/local/lib/gobject-introspection/giscanner/shlibs.pyo +0 -0
  72. data/vendor/local/lib/gobject-introspection/giscanner/sourcescanner.py +1 -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.pyc +0 -0
  78. data/vendor/local/lib/gobject-introspection/giscanner/transformer.pyo +0 -0
  79. data/vendor/local/lib/gobject-introspection/giscanner/utils.py +4 -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/libgirepository-1.0.la +3 -3
  87. data/vendor/local/lib/pkgconfig/gobject-introspection-1.0.pc +2 -2
  88. data/vendor/local/lib/pkgconfig/gobject-introspection-no-export-1.0.pc +2 -2
  89. data/vendor/local/share/gir-1.0/GIRepository-2.0.gir +16 -5
  90. data/vendor/local/share/gir-1.0/GLib-2.0.gir +911 -377
  91. data/vendor/local/share/gir-1.0/GObject-2.0.gir +110 -53
  92. data/vendor/local/share/gir-1.0/Gio-2.0.gir +835 -287
  93. data/vendor/local/share/gobject-introspection-1.0/Makefile.introspection +1 -1
  94. data/vendor/local/share/gobject-introspection-1.0/tests/foo.h +1 -0
  95. data/vendor/local/share/gobject-introspection-1.0/tests/regress.c +2 -1
  96. data/vendor/local/share/gobject-introspection-1.0/tests/regress.h +10 -2
  97. data/vendor/local/share/license/gobject-introspection/COPYING +1 -1
  98. data/vendor/local/share/man/man1/g-ir-compiler.1 +3 -3
  99. data/vendor/local/share/man/man1/g-ir-generate.1 +2 -1
  100. metadata +8 -7
@@ -2633,8 +2633,8 @@ but used automatically by GLib when specifying a %NULL marshaller.</doc>
2633
2633
  <function name="new" c:identifier="g_cclosure_new" introspectable="0">
2634
2634
  <doc xml:space="preserve">Creates a new closure which invokes @callback_func with @user_data as
2635
2635
  the last parameter.</doc>
2636
- <return-value transfer-ownership="full">
2637
- <doc xml:space="preserve">a new #GCClosure</doc>
2636
+ <return-value transfer-ownership="none">
2637
+ <doc xml:space="preserve">a floating reference to a new #GCClosure</doc>
2638
2638
  <type name="Closure" c:type="GClosure*"/>
2639
2639
  </return-value>
2640
2640
  <parameters>
@@ -2711,8 +2711,8 @@ after the object is is freed.</doc>
2711
2711
  introspectable="0">
2712
2712
  <doc xml:space="preserve">Creates a new closure which invokes @callback_func with @user_data as
2713
2713
  the first parameter.</doc>
2714
- <return-value transfer-ownership="full">
2715
- <doc xml:space="preserve">a new #GCClosure</doc>
2714
+ <return-value transfer-ownership="none">
2715
+ <doc xml:space="preserve">a floating reference to a new #GCClosure</doc>
2716
2716
  <type name="Closure" c:type="GClosure*"/>
2717
2717
  </return-value>
2718
2718
  <parameters>
@@ -2903,8 +2903,8 @@ In the case of C programs, a closure usually just holds a pointer
2903
2903
  to a function and maybe a data argument, and the marshaller
2904
2904
  converts between #GValue and native C types. The GObject
2905
2905
  library provides the #GCClosure type for this purpose. Bindings for
2906
- other languages need marshallers which convert between #GValue&lt;!--
2907
- --&gt;s and suitable representations in the runtime of the language in
2906
+ other languages need marshallers which convert between #GValues
2907
+ and suitable representations in the runtime of the language in
2908
2908
  order to use functions written in that languages as callbacks.
2909
2909
 
2910
2910
  Within GObject, closures play an important role in the
@@ -3059,8 +3059,8 @@ MyClosure *my_closure_new (gpointer data)
3059
3059
  return my_closure;
3060
3060
  }
3061
3061
  ]|</doc>
3062
- <return-value transfer-ownership="full">
3063
- <doc xml:space="preserve">a newly allocated #GClosure</doc>
3062
+ <return-value transfer-ownership="none">
3063
+ <doc xml:space="preserve">a floating reference to a new #GClosure</doc>
3064
3064
  <type name="Closure" c:type="GClosure*"/>
3065
3065
  </return-value>
3066
3066
  <parameters>
@@ -4084,7 +4084,9 @@ interface property.
4084
4084
  This function is meant to be called from the interface's default
4085
4085
  vtable initialization function (the @class_init member of
4086
4086
  #GTypeInfo.) It must not be called after after @class_init has
4087
- been called for any object types implementing this interface.</doc>
4087
+ been called for any object types implementing this interface.
4088
+
4089
+ If @pspec is a floating reference, it will be consumed.</doc>
4088
4090
  <return-value transfer-ownership="none">
4089
4091
  <type name="none" c:type="void"/>
4090
4092
  </return-value>
@@ -4462,9 +4464,13 @@ g_object_bind_property_with_closures() instead.</doc>
4462
4464
  or %NULL</doc>
4463
4465
  <type name="gpointer" c:type="gpointer"/>
4464
4466
  </parameter>
4465
- <parameter name="notify" transfer-ownership="none" scope="async">
4466
- <doc xml:space="preserve">function to be called when disposing the binding, to free the
4467
- resources used by the transformation functions</doc>
4467
+ <parameter name="notify"
4468
+ transfer-ownership="none"
4469
+ nullable="1"
4470
+ allow-none="1"
4471
+ scope="async">
4472
+ <doc xml:space="preserve">a function to call when disposing the binding, to free
4473
+ resources used by the transformation functions, or %NULL if not required</doc>
4468
4474
  <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
4469
4475
  </parameter>
4470
4476
  </parameters>
@@ -4781,7 +4787,8 @@ of three properties: an integer, a string and an object:
4781
4787
  <method name="get_data" c:identifier="g_object_get_data">
4782
4788
  <doc xml:space="preserve">Gets a named field from the objects table of associations (see g_object_set_data()).</doc>
4783
4789
  <return-value transfer-ownership="none" nullable="1">
4784
- <doc xml:space="preserve">the data if found, or %NULL if no such data exists.</doc>
4790
+ <doc xml:space="preserve">the data if found,
4791
+ or %NULL if no such data exists.</doc>
4785
4792
  <type name="gpointer" c:type="gpointer"/>
4786
4793
  </return-value>
4787
4794
  <parameters>
@@ -4997,7 +5004,12 @@ and then notify a change on the "foo" property with:
4997
5004
  </parameters>
4998
5005
  </method>
4999
5006
  <method name="ref" c:identifier="g_object_ref">
5000
- <doc xml:space="preserve">Increases the reference count of @object.</doc>
5007
+ <doc xml:space="preserve">Increases the reference count of @object.
5008
+
5009
+ Since GLib 2.56, if `GLIB_VERSION_MAX_ALLOWED` is 2.56 or greater, the type
5010
+ of @object will be propagated to the return type (using the GCC typeof()
5011
+ extension), so any casting the caller needs to do on the return type must be
5012
+ explicit.</doc>
5001
5013
  <return-value transfer-ownership="none">
5002
5014
  <doc xml:space="preserve">the same @object</doc>
5003
5015
  <type name="Object" c:type="gpointer"/>
@@ -5017,7 +5029,10 @@ In other words, if the object is floating, then this call "assumes
5017
5029
  ownership" of the floating reference, converting it to a normal
5018
5030
  reference by clearing the floating flag while leaving the reference
5019
5031
  count unchanged. If the object is not floating, then this call
5020
- adds a new normal reference increasing the reference count by one.</doc>
5032
+ adds a new normal reference increasing the reference count by one.
5033
+
5034
+ Since GLib 2.56, the type of @object will be propagated to the return type
5035
+ under the same conditions as for g_object_ref().</doc>
5021
5036
  <return-value transfer-ownership="none">
5022
5037
  <doc xml:space="preserve">@object</doc>
5023
5038
  <type name="Object" c:type="gpointer"/>
@@ -5084,7 +5099,8 @@ to match the one used with g_object_add_weak_pointer().</doc>
5084
5099
  </method>
5085
5100
  <method name="replace_data"
5086
5101
  c:identifier="g_object_replace_data"
5087
- version="2.34">
5102
+ version="2.34"
5103
+ introspectable="0">
5088
5104
  <doc xml:space="preserve">Compares the user data for the key @key on @object with
5089
5105
  @oldval, and if they are the same, replaces @oldval with
5090
5106
  @newval.
@@ -5095,7 +5111,7 @@ operation, for user data on an object.
5095
5111
  If the previous value was replaced then ownership of the
5096
5112
  old value (@oldval) is passed to the caller, including
5097
5113
  the registered destroy notify for it (passed out in @old_destroy).
5098
- Its up to the caller to free this as he wishes, which may
5114
+ It’s up to the caller to free this as needed, which may
5099
5115
  or may not include using @old_destroy as sometimes replacement
5100
5116
  should not destroy the object in the normal way.</doc>
5101
5117
  <return-value transfer-ownership="none">
@@ -5135,8 +5151,10 @@ should not destroy the object in the normal way.</doc>
5135
5151
  <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
5136
5152
  </parameter>
5137
5153
  <parameter name="old_destroy"
5154
+ direction="out"
5155
+ caller-allocates="0"
5138
5156
  transfer-ownership="none"
5139
- nullable="1"
5157
+ optional="1"
5140
5158
  allow-none="1"
5141
5159
  scope="async">
5142
5160
  <doc xml:space="preserve">destroy notify for the existing value</doc>
@@ -5146,7 +5164,8 @@ should not destroy the object in the normal way.</doc>
5146
5164
  </method>
5147
5165
  <method name="replace_qdata"
5148
5166
  c:identifier="g_object_replace_qdata"
5149
- version="2.34">
5167
+ version="2.34"
5168
+ introspectable="0">
5150
5169
  <doc xml:space="preserve">Compares the user data for the key @quark on @object with
5151
5170
  @oldval, and if they are the same, replaces @oldval with
5152
5171
  @newval.
@@ -5157,7 +5176,7 @@ operation, for user data on an object.
5157
5176
  If the previous value was replaced then ownership of the
5158
5177
  old value (@oldval) is passed to the caller, including
5159
5178
  the registered destroy notify for it (passed out in @old_destroy).
5160
- Its up to the caller to free this as he wishes, which may
5179
+ It’s up to the caller to free this as needed, which may
5161
5180
  or may not include using @old_destroy as sometimes replacement
5162
5181
  should not destroy the object in the normal way.</doc>
5163
5182
  <return-value transfer-ownership="none">
@@ -5197,8 +5216,10 @@ should not destroy the object in the normal way.</doc>
5197
5216
  <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
5198
5217
  </parameter>
5199
5218
  <parameter name="old_destroy"
5219
+ direction="out"
5220
+ caller-allocates="0"
5200
5221
  transfer-ownership="none"
5201
- nullable="1"
5222
+ optional="1"
5202
5223
  allow-none="1"
5203
5224
  scope="async">
5204
5225
  <doc xml:space="preserve">destroy notify for the existing value</doc>
@@ -5300,7 +5321,11 @@ Note that the @destroy callback is not called if @data is %NULL.</doc>
5300
5321
  <doc xml:space="preserve">data to associate with that key</doc>
5301
5322
  <type name="gpointer" c:type="gpointer"/>
5302
5323
  </parameter>
5303
- <parameter name="destroy" transfer-ownership="none" scope="async">
5324
+ <parameter name="destroy"
5325
+ transfer-ownership="none"
5326
+ nullable="1"
5327
+ allow-none="1"
5328
+ scope="async">
5304
5329
  <doc xml:space="preserve">function to call when the association is destroyed</doc>
5305
5330
  <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
5306
5331
  </parameter>
@@ -5385,7 +5410,11 @@ with the same @quark.</doc>
5385
5410
  <doc xml:space="preserve">An opaque user data pointer</doc>
5386
5411
  <type name="gpointer" c:type="gpointer"/>
5387
5412
  </parameter>
5388
- <parameter name="destroy" transfer-ownership="none" scope="async">
5413
+ <parameter name="destroy"
5414
+ transfer-ownership="none"
5415
+ nullable="1"
5416
+ allow-none="1"
5417
+ scope="async">
5389
5418
  <doc xml:space="preserve">Function to invoke with @data as argument, when @data
5390
5419
  needs to be freed</doc>
5391
5420
  <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
@@ -5453,7 +5482,8 @@ properties are passed in.</doc>
5453
5482
  <doc xml:space="preserve">Remove a specified datum from the object's data associations,
5454
5483
  without invoking the association's destroy handler.</doc>
5455
5484
  <return-value transfer-ownership="full" nullable="1">
5456
- <doc xml:space="preserve">the data if found, or %NULL if no such data exists.</doc>
5485
+ <doc xml:space="preserve">the data if found, or %NULL
5486
+ if no such data exists.</doc>
5457
5487
  <type name="gpointer" c:type="gpointer"/>
5458
5488
  </return-value>
5459
5489
  <parameters>
@@ -5687,9 +5717,8 @@ detail strings for the notify signal.</doc>
5687
5717
  glib:is-gtype-struct-for="Object">
5688
5718
  <doc xml:space="preserve">The class structure for the GObject type.
5689
5719
 
5690
- &lt;example&gt;
5691
- &lt;title&gt;Implementing singletons using a constructor&lt;/title&gt;
5692
- &lt;programlisting&gt;
5720
+ |[&lt;!-- language="C" --&gt;
5721
+ // Example of implementing a singleton using a constructor.
5693
5722
  static MySingleton *the_singleton = NULL;
5694
5723
 
5695
5724
  static GObject*
@@ -5711,7 +5740,7 @@ my_singleton_constructor (GType type,
5711
5740
 
5712
5741
  return object;
5713
5742
  }
5714
- &lt;/programlisting&gt;&lt;/example&gt;</doc>
5743
+ ]|</doc>
5715
5744
  <field name="g_type_class">
5716
5745
  <doc xml:space="preserve">the parent class</doc>
5717
5746
  <type name="TypeClass" c:type="GTypeClass"/>
@@ -6136,7 +6165,7 @@ a #GObjectClass.</doc>
6136
6165
  <type name="gint" c:type="gint"/>
6137
6166
  </constant>
6138
6167
  <constant name="PARAM_STATIC_STRINGS"
6139
- value="0"
6168
+ value="224"
6140
6169
  c:type="G_PARAM_STATIC_STRINGS">
6141
6170
  <doc xml:space="preserve">#GParamFlags value alias for %G_PARAM_STATIC_NAME | %G_PARAM_STATIC_NICK | %G_PARAM_STATIC_BLURB.
6142
6171
 
@@ -6353,7 +6382,7 @@ e.g. a tooltip. The @nick and @blurb should ideally be localized.</doc>
6353
6382
  version="2.38">
6354
6383
  <doc xml:space="preserve">Gets the default value of @pspec as a pointer to a #GValue.
6355
6384
 
6356
- The #GValue will remain value for the life of @pspec.</doc>
6385
+ The #GValue will remain valid for the life of @pspec.</doc>
6357
6386
  <return-value transfer-ownership="none">
6358
6387
  <doc xml:space="preserve">a pointer to a #GValue which must not be modified</doc>
6359
6388
  <type name="Value" c:type="const GValue*"/>
@@ -8413,12 +8442,18 @@ in the given type plugin. If the interface was already registered
8413
8442
  for the type in this plugin, nothing will be done.
8414
8443
 
8415
8444
  As long as any instances of the type exist, the type plugin will
8416
- not be unloaded.</doc>
8445
+ not be unloaded.
8446
+
8447
+ Since 2.56 if @module is %NULL this will call g_type_add_interface_static()
8448
+ instead. This can be used when making a static build of the module.</doc>
8417
8449
  <return-value transfer-ownership="none">
8418
8450
  <type name="none" c:type="void"/>
8419
8451
  </return-value>
8420
8452
  <parameters>
8421
- <instance-parameter name="module" transfer-ownership="none">
8453
+ <instance-parameter name="module"
8454
+ transfer-ownership="none"
8455
+ nullable="1"
8456
+ allow-none="1">
8422
8457
  <doc xml:space="preserve">a #GTypeModule</doc>
8423
8458
  <type name="TypeModule" c:type="GTypeModule*"/>
8424
8459
  </instance-parameter>
@@ -8445,13 +8480,19 @@ the #GType identifier for the type is returned, otherwise the type
8445
8480
  is newly registered, and the resulting #GType identifier returned.
8446
8481
 
8447
8482
  As long as any instances of the type exist, the type plugin will
8448
- not be unloaded.</doc>
8483
+ not be unloaded.
8484
+
8485
+ Since 2.56 if @module is %NULL this will call g_type_register_static()
8486
+ instead. This can be used when making a static build of the module.</doc>
8449
8487
  <return-value transfer-ownership="none">
8450
8488
  <doc xml:space="preserve">the new or existing type ID</doc>
8451
8489
  <type name="GType" c:type="GType"/>
8452
8490
  </return-value>
8453
8491
  <parameters>
8454
- <instance-parameter name="module" transfer-ownership="none">
8492
+ <instance-parameter name="module"
8493
+ transfer-ownership="none"
8494
+ nullable="1"
8495
+ allow-none="1">
8455
8496
  <doc xml:space="preserve">a #GTypeModule</doc>
8456
8497
  <type name="TypeModule" c:type="GTypeModule*"/>
8457
8498
  </instance-parameter>
@@ -8477,13 +8518,19 @@ the #GType identifier for the type is returned, otherwise the type
8477
8518
  is newly registered, and the resulting #GType identifier returned.
8478
8519
 
8479
8520
  As long as any instances of the type exist, the type plugin will
8480
- not be unloaded.</doc>
8521
+ not be unloaded.
8522
+
8523
+ Since 2.56 if @module is %NULL this will call g_type_register_static()
8524
+ instead. This can be used when making a static build of the module.</doc>
8481
8525
  <return-value transfer-ownership="none">
8482
8526
  <doc xml:space="preserve">the new or existing type ID</doc>
8483
8527
  <type name="GType" c:type="GType"/>
8484
8528
  </return-value>
8485
8529
  <parameters>
8486
- <instance-parameter name="module" transfer-ownership="none">
8530
+ <instance-parameter name="module"
8531
+ transfer-ownership="none"
8532
+ nullable="1"
8533
+ allow-none="1">
8487
8534
  <doc xml:space="preserve">a #GTypeModule</doc>
8488
8535
  <type name="TypeModule" c:type="GTypeModule*"/>
8489
8536
  </instance-parameter>
@@ -8511,13 +8558,19 @@ then reloaded, and reinitialized), @module and @parent_type must
8511
8558
  be the same as they were previously.
8512
8559
 
8513
8560
  As long as any instances of the type exist, the type plugin will
8514
- not be unloaded.</doc>
8561
+ not be unloaded.
8562
+
8563
+ Since 2.56 if @module is %NULL this will call g_type_register_static()
8564
+ instead. This can be used when making a static build of the module.</doc>
8515
8565
  <return-value transfer-ownership="none">
8516
8566
  <doc xml:space="preserve">the new or existing type ID</doc>
8517
8567
  <type name="GType" c:type="GType"/>
8518
8568
  </return-value>
8519
8569
  <parameters>
8520
- <instance-parameter name="module" transfer-ownership="none">
8570
+ <instance-parameter name="module"
8571
+ transfer-ownership="none"
8572
+ nullable="1"
8573
+ allow-none="1">
8521
8574
  <doc xml:space="preserve">a #GTypeModule</doc>
8522
8575
  <type name="TypeModule" c:type="GTypeModule*"/>
8523
8576
  </instance-parameter>
@@ -9243,10 +9296,11 @@ reference count.</doc>
9243
9296
  <method name="dup_variant"
9244
9297
  c:identifier="g_value_dup_variant"
9245
9298
  version="2.26">
9246
- <doc xml:space="preserve">Get the contents of a variant #GValue, increasing its refcount.</doc>
9247
- <return-value transfer-ownership="full">
9248
- <doc xml:space="preserve">variant contents of @value, should be unrefed using
9249
- g_variant_unref() when no longer needed</doc>
9299
+ <doc xml:space="preserve">Get the contents of a variant #GValue, increasing its refcount. The returned
9300
+ #GVariant is never floating.</doc>
9301
+ <return-value transfer-ownership="full" nullable="1">
9302
+ <doc xml:space="preserve">variant contents of @value (may be %NULL);
9303
+ should be unreffed using g_variant_unref() when no longer needed</doc>
9250
9304
  <type name="GLib.Variant" c:type="GVariant*"/>
9251
9305
  </return-value>
9252
9306
  <parameters>
@@ -9541,8 +9595,8 @@ Get the contents of a %G_TYPE_CHAR #GValue.</doc>
9541
9595
  c:identifier="g_value_get_variant"
9542
9596
  version="2.26">
9543
9597
  <doc xml:space="preserve">Get the contents of a variant #GValue.</doc>
9544
- <return-value transfer-ownership="full">
9545
- <doc xml:space="preserve">variant contents of @value</doc>
9598
+ <return-value transfer-ownership="full" nullable="1">
9599
+ <doc xml:space="preserve">variant contents of @value (may be %NULL)</doc>
9546
9600
  <type name="GLib.Variant" c:type="GVariant*"/>
9547
9601
  </return-value>
9548
9602
  <parameters>
@@ -10463,6 +10517,7 @@ contents.</doc>
10463
10517
  </method>
10464
10518
  <method name="free"
10465
10519
  c:identifier="g_value_array_free"
10520
+ introspectable="0"
10466
10521
  deprecated="1"
10467
10522
  deprecated-version="2.32">
10468
10523
  <doc xml:space="preserve">Free a #GValueArray including its contents.</doc>
@@ -10641,7 +10696,9 @@ C qsort() function.</doc>
10641
10696
  </record>
10642
10697
  <callback name="ValueTransform" c:type="GValueTransform">
10643
10698
  <doc xml:space="preserve">The type of value transformation functions which can be registered with
10644
- g_value_register_transform_func().</doc>
10699
+ g_value_register_transform_func().
10700
+
10701
+ @dest_value will be initialized to the correct destination type.</doc>
10645
10702
  <return-value transfer-ownership="none">
10646
10703
  <type name="none" c:type="void"/>
10647
10704
  </return-value>
@@ -11980,8 +12037,8 @@ but used automatically by GLib when specifying a %NULL marshaller.</doc>
11980
12037
  introspectable="0">
11981
12038
  <doc xml:space="preserve">Creates a new closure which invokes @callback_func with @user_data as
11982
12039
  the last parameter.</doc>
11983
- <return-value transfer-ownership="full">
11984
- <doc xml:space="preserve">a new #GCClosure</doc>
12040
+ <return-value transfer-ownership="none">
12041
+ <doc xml:space="preserve">a floating reference to a new #GCClosure</doc>
11985
12042
  <type name="Closure" c:type="GClosure*"/>
11986
12043
  </return-value>
11987
12044
  <parameters>
@@ -12061,8 +12118,8 @@ after the object is is freed.</doc>
12061
12118
  introspectable="0">
12062
12119
  <doc xml:space="preserve">Creates a new closure which invokes @callback_func with @user_data as
12063
12120
  the first parameter.</doc>
12064
- <return-value transfer-ownership="full">
12065
- <doc xml:space="preserve">a new #GCClosure</doc>
12121
+ <return-value transfer-ownership="none">
12122
+ <doc xml:space="preserve">a floating reference to a new #GCClosure</doc>
12066
12123
  <type name="Closure" c:type="GClosure*"/>
12067
12124
  </return-value>
12068
12125
  <parameters>
@@ -14785,8 +14842,8 @@ signal id for you.</doc>
14785
14842
  <doc xml:space="preserve">Creates a new closure which invokes the function found at the offset
14786
14843
  @struct_offset in the class structure of the interface or classed type
14787
14844
  identified by @itype.</doc>
14788
- <return-value transfer-ownership="full">
14789
- <doc xml:space="preserve">a new #GCClosure</doc>
14845
+ <return-value transfer-ownership="none">
14846
+ <doc xml:space="preserve">a floating reference to a new #GCClosure</doc>
14790
14847
  <type name="Closure" c:type="GClosure*"/>
14791
14848
  </return-value>
14792
14849
  <parameters>
@@ -15110,7 +15167,7 @@ G_TYPE_CHECK_INSTANCE() macro.</doc>
15110
15167
  </return-value>
15111
15168
  <parameters>
15112
15169
  <parameter name="value" transfer-ownership="none">
15113
- <type name="Value" c:type="GValue*"/>
15170
+ <type name="Value" c:type="const GValue*"/>
15114
15171
  </parameter>
15115
15172
  </parameters>
15116
15173
  </function>
@@ -15121,7 +15178,7 @@ G_TYPE_CHECK_INSTANCE() macro.</doc>
15121
15178
  </return-value>
15122
15179
  <parameters>
15123
15180
  <parameter name="value" transfer-ownership="none">
15124
- <type name="Value" c:type="GValue*"/>
15181
+ <type name="Value" c:type="const GValue*"/>
15125
15182
  </parameter>
15126
15183
  <parameter name="type" transfer-ownership="none">
15127
15184
  <type name="GType" c:type="GType"/>
@@ -2388,7 +2388,7 @@ being swallowed by Exec key unquoting. See the specification for exact quoting r
2388
2388
  <parameters>
2389
2389
  <parameter name="commandline" transfer-ownership="none">
2390
2390
  <doc xml:space="preserve">the commandline to use</doc>
2391
- <type name="utf8" c:type="const char*"/>
2391
+ <type name="filename" c:type="const char*"/>
2392
2392
  </parameter>
2393
2393
  <parameter name="application_name"
2394
2394
  transfer-ownership="none"
@@ -2535,7 +2535,7 @@ required.</doc>
2535
2535
  <doc xml:space="preserve">the uri to show</doc>
2536
2536
  <type name="utf8" c:type="const char*"/>
2537
2537
  </parameter>
2538
- <parameter name="launch_context"
2538
+ <parameter name="context"
2539
2539
  transfer-ownership="none"
2540
2540
  nullable="1"
2541
2541
  allow-none="1">
@@ -2561,13 +2561,18 @@ dialog to the user.</doc>
2561
2561
  <doc xml:space="preserve">the uri to show</doc>
2562
2562
  <type name="utf8" c:type="const char*"/>
2563
2563
  </parameter>
2564
- <parameter name="launch_context" transfer-ownership="none">
2564
+ <parameter name="context"
2565
+ transfer-ownership="none"
2566
+ nullable="1"
2567
+ allow-none="1">
2568
+ <doc xml:space="preserve">an optional #GAppLaunchContext</doc>
2565
2569
  <type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
2566
2570
  </parameter>
2567
2571
  <parameter name="cancellable"
2568
2572
  transfer-ownership="none"
2569
2573
  nullable="1"
2570
2574
  allow-none="1">
2575
+ <doc xml:space="preserve">a #GCancellable</doc>
2571
2576
  <type name="Cancellable" c:type="GCancellable*"/>
2572
2577
  </parameter>
2573
2578
  <parameter name="callback"
@@ -2704,9 +2709,9 @@ See g_app_info_can_delete().</doc>
2704
2709
  <virtual-method name="equal" invoker="equal">
2705
2710
  <doc xml:space="preserve">Checks if two #GAppInfos are equal.
2706
2711
 
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>
2712
+ Note that the check &lt;emphasis&gt;may not&lt;/emphasis&gt; compare each individual
2713
+ field, and only does an identity check. In case detecting changes in the
2714
+ contents is needed, program code must additionally compare relevant fields.</doc>
2710
2715
  <return-value transfer-ownership="none">
2711
2716
  <doc xml:space="preserve">%TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise.</doc>
2712
2717
  <type name="gboolean" c:type="gboolean"/>
@@ -2844,7 +2849,7 @@ the application.</doc>
2844
2849
  </virtual-method>
2845
2850
  <virtual-method name="launch" invoker="launch" throws="1">
2846
2851
  <doc xml:space="preserve">Launches the application. Passes @files to the launched application
2847
- as arguments, using the optional @launch_context to get information
2852
+ as arguments, using the optional @context to get information
2848
2853
  about the details of the launcher (like what screen it is on).
2849
2854
  On error, @error will be set accordingly.
2850
2855
 
@@ -2869,7 +2874,7 @@ environment variable with the path of the launched desktop file and
2869
2874
  process. This can be used to ignore `GIO_LAUNCHED_DESKTOP_FILE`,
2870
2875
  should it be inherited by further processes. The `DISPLAY` and
2871
2876
  `DESKTOP_STARTUP_ID` environment variables are also set, based
2872
- on information provided in @launch_context.</doc>
2877
+ on information provided in @context.</doc>
2873
2878
  <return-value transfer-ownership="none">
2874
2879
  <doc xml:space="preserve">%TRUE on successful launch, %FALSE otherwise.</doc>
2875
2880
  <type name="gboolean" c:type="gboolean"/>
@@ -2888,7 +2893,7 @@ on information provided in @launch_context.</doc>
2888
2893
  <type name="File"/>
2889
2894
  </type>
2890
2895
  </parameter>
2891
- <parameter name="launch_context"
2896
+ <parameter name="context"
2892
2897
  transfer-ownership="none"
2893
2898
  nullable="1"
2894
2899
  allow-none="1">
@@ -2899,7 +2904,7 @@ on information provided in @launch_context.</doc>
2899
2904
  </virtual-method>
2900
2905
  <virtual-method name="launch_uris" invoker="launch_uris" throws="1">
2901
2906
  <doc xml:space="preserve">Launches the application. This passes the @uris to the launched application
2902
- as arguments, using the optional @launch_context to get information
2907
+ as arguments, using the optional @context to get information
2903
2908
  about the details of the launcher (like what screen it is on).
2904
2909
  On error, @error will be set accordingly.
2905
2910
 
@@ -2926,7 +2931,7 @@ no way to detect this.</doc>
2926
2931
  <type name="utf8"/>
2927
2932
  </type>
2928
2933
  </parameter>
2929
- <parameter name="launch_context"
2934
+ <parameter name="context"
2930
2935
  transfer-ownership="none"
2931
2936
  nullable="1"
2932
2937
  allow-none="1">
@@ -2970,7 +2975,7 @@ no way to detect this.</doc>
2970
2975
  <parameter name="extension" transfer-ownership="none">
2971
2976
  <doc xml:space="preserve">a string containing the file extension
2972
2977
  (without the dot).</doc>
2973
- <type name="filename" c:type="char*"/>
2978
+ <type name="filename" c:type="const char*"/>
2974
2979
  </parameter>
2975
2980
  </parameters>
2976
2981
  </virtual-method>
@@ -3139,9 +3144,9 @@ See g_app_info_can_delete().</doc>
3139
3144
  <method name="equal" c:identifier="g_app_info_equal">
3140
3145
  <doc xml:space="preserve">Checks if two #GAppInfos are equal.
3141
3146
 
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>
3147
+ Note that the check &lt;emphasis&gt;may not&lt;/emphasis&gt; compare each individual
3148
+ field, and only does an identity check. In case detecting changes in the
3149
+ contents is needed, program code must additionally compare relevant fields.</doc>
3145
3150
  <return-value transfer-ownership="none">
3146
3151
  <doc xml:space="preserve">%TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise.</doc>
3147
3152
  <type name="gboolean" c:type="gboolean"/>
@@ -3165,7 +3170,7 @@ started.</doc>
3165
3170
  <return-value transfer-ownership="none">
3166
3171
  <doc xml:space="preserve">a string containing the @appinfo's commandline,
3167
3172
  or %NULL if this information is not available</doc>
3168
- <type name="filename" c:type="char*"/>
3173
+ <type name="filename" c:type="const char*"/>
3169
3174
  </return-value>
3170
3175
  <parameters>
3171
3176
  <instance-parameter name="appinfo" transfer-ownership="none">
@@ -3210,7 +3215,7 @@ no display name is available.</doc>
3210
3215
  <return-value transfer-ownership="none">
3211
3216
  <doc xml:space="preserve">a string containing the @appinfo's application
3212
3217
  binaries name</doc>
3213
- <type name="filename" c:type="char*"/>
3218
+ <type name="filename" c:type="const char*"/>
3214
3219
  </return-value>
3215
3220
  <parameters>
3216
3221
  <instance-parameter name="appinfo" transfer-ownership="none">
@@ -3290,7 +3295,7 @@ the application.</doc>
3290
3295
  </method>
3291
3296
  <method name="launch" c:identifier="g_app_info_launch" throws="1">
3292
3297
  <doc xml:space="preserve">Launches the application. Passes @files to the launched application
3293
- as arguments, using the optional @launch_context to get information
3298
+ as arguments, using the optional @context to get information
3294
3299
  about the details of the launcher (like what screen it is on).
3295
3300
  On error, @error will be set accordingly.
3296
3301
 
@@ -3315,7 +3320,7 @@ environment variable with the path of the launched desktop file and
3315
3320
  process. This can be used to ignore `GIO_LAUNCHED_DESKTOP_FILE`,
3316
3321
  should it be inherited by further processes. The `DISPLAY` and
3317
3322
  `DESKTOP_STARTUP_ID` environment variables are also set, based
3318
- on information provided in @launch_context.</doc>
3323
+ on information provided in @context.</doc>
3319
3324
  <return-value transfer-ownership="none">
3320
3325
  <doc xml:space="preserve">%TRUE on successful launch, %FALSE otherwise.</doc>
3321
3326
  <type name="gboolean" c:type="gboolean"/>
@@ -3334,7 +3339,7 @@ on information provided in @launch_context.</doc>
3334
3339
  <type name="File"/>
3335
3340
  </type>
3336
3341
  </parameter>
3337
- <parameter name="launch_context"
3342
+ <parameter name="context"
3338
3343
  transfer-ownership="none"
3339
3344
  nullable="1"
3340
3345
  allow-none="1">
@@ -3347,7 +3352,7 @@ on information provided in @launch_context.</doc>
3347
3352
  c:identifier="g_app_info_launch_uris"
3348
3353
  throws="1">
3349
3354
  <doc xml:space="preserve">Launches the application. This passes the @uris to the launched application
3350
- as arguments, using the optional @launch_context to get information
3355
+ as arguments, using the optional @context to get information
3351
3356
  about the details of the launcher (like what screen it is on).
3352
3357
  On error, @error will be set accordingly.
3353
3358
 
@@ -3374,7 +3379,7 @@ no way to detect this.</doc>
3374
3379
  <type name="utf8"/>
3375
3380
  </type>
3376
3381
  </parameter>
3377
- <parameter name="launch_context"
3382
+ <parameter name="context"
3378
3383
  transfer-ownership="none"
3379
3384
  nullable="1"
3380
3385
  allow-none="1">
@@ -3418,7 +3423,7 @@ no way to detect this.</doc>
3418
3423
  <parameter name="extension" transfer-ownership="none">
3419
3424
  <doc xml:space="preserve">a string containing the file extension
3420
3425
  (without the dot).</doc>
3421
- <type name="filename" c:type="char*"/>
3426
+ <type name="filename" c:type="const char*"/>
3422
3427
  </parameter>
3423
3428
  </parameters>
3424
3429
  </method>
@@ -3664,7 +3669,7 @@ if there is no default icon.</doc>
3664
3669
  <type name="File"/>
3665
3670
  </type>
3666
3671
  </parameter>
3667
- <parameter name="launch_context"
3672
+ <parameter name="context"
3668
3673
  transfer-ownership="none"
3669
3674
  nullable="1"
3670
3675
  allow-none="1">
@@ -3722,7 +3727,7 @@ if there is no default icon.</doc>
3722
3727
  <type name="utf8"/>
3723
3728
  </type>
3724
3729
  </parameter>
3725
- <parameter name="launch_context"
3730
+ <parameter name="context"
3726
3731
  transfer-ownership="none"
3727
3732
  nullable="1"
3728
3733
  allow-none="1">
@@ -3778,7 +3783,7 @@ if there is no default icon.</doc>
3778
3783
  <parameter name="extension" transfer-ownership="none">
3779
3784
  <doc xml:space="preserve">a string containing the file extension
3780
3785
  (without the dot).</doc>
3781
- <type name="filename" c:type="char*"/>
3786
+ <type name="filename" c:type="const char*"/>
3782
3787
  </parameter>
3783
3788
  </parameters>
3784
3789
  </callback>
@@ -4113,10 +4118,10 @@ the child process when @context is used to launch an application.
4113
4118
  This is a %NULL-terminated array of strings, where each string has
4114
4119
  the form `KEY=VALUE`.</doc>
4115
4120
  <return-value transfer-ownership="full">
4116
- <doc xml:space="preserve">the
4117
- child's environment</doc>
4121
+ <doc xml:space="preserve">
4122
+ the child's environment</doc>
4118
4123
  <array c:type="char**">
4119
- <type name="utf8"/>
4124
+ <type name="filename"/>
4120
4125
  </array>
4121
4126
  </return-value>
4122
4127
  <parameters>
@@ -4188,11 +4193,11 @@ environment when @context is used to launch an application.</doc>
4188
4193
  </instance-parameter>
4189
4194
  <parameter name="variable" transfer-ownership="none">
4190
4195
  <doc xml:space="preserve">the environment variable to set</doc>
4191
- <type name="utf8" c:type="const char*"/>
4196
+ <type name="filename" c:type="const char*"/>
4192
4197
  </parameter>
4193
4198
  <parameter name="value" transfer-ownership="none">
4194
4199
  <doc xml:space="preserve">the value for to set the variable to.</doc>
4195
- <type name="utf8" c:type="const char*"/>
4200
+ <type name="filename" c:type="const char*"/>
4196
4201
  </parameter>
4197
4202
  </parameters>
4198
4203
  </method>
@@ -4211,7 +4216,7 @@ when @context is used to launch an application.</doc>
4211
4216
  </instance-parameter>
4212
4217
  <parameter name="variable" transfer-ownership="none">
4213
4218
  <doc xml:space="preserve">the environment variable to remove</doc>
4214
- <type name="utf8" c:type="const char*"/>
4219
+ <type name="filename" c:type="const char*"/>
4215
4220
  </parameter>
4216
4221
  </parameters>
4217
4222
  </method>
@@ -5292,6 +5297,10 @@ Upon return to the mainloop, g_application_run() will return,
5292
5297
  calling only the 'shutdown' function before doing so.
5293
5298
 
5294
5299
  The hold count is ignored.
5300
+ Take care if your code has called g_application_hold() on the application and
5301
+ is therefore still expecting it to exist.
5302
+ (Note that you may have called g_application_hold() indirectly, for example
5303
+ through gtk_application_add_window().)
5295
5304
 
5296
5305
  The result of calling g_application_run() again after it returns is
5297
5306
  unspecified.</doc>
@@ -5467,9 +5476,10 @@ what their exit status will be.</doc>
5467
5476
  transfer-ownership="none"
5468
5477
  nullable="1"
5469
5478
  allow-none="1">
5470
- <doc xml:space="preserve">the argv from main(), or %NULL</doc>
5479
+ <doc xml:space="preserve">
5480
+ the argv from main(), or %NULL</doc>
5471
5481
  <array length="0" zero-terminated="0" c:type="char**">
5472
- <type name="utf8" c:type="char*"/>
5482
+ <type name="filename"/>
5473
5483
  </array>
5474
5484
  </parameter>
5475
5485
  </parameters>
@@ -5650,6 +5660,81 @@ zero. Any timeouts currently in progress are not impacted.</doc>
5650
5660
  </parameter>
5651
5661
  </parameters>
5652
5662
  </method>
5663
+ <method name="set_option_context_description"
5664
+ c:identifier="g_application_set_option_context_description"
5665
+ version="2.56">
5666
+ <doc xml:space="preserve">Adds a description to the @application option context.
5667
+
5668
+ See g_option_context_set_description() for more information.</doc>
5669
+ <return-value transfer-ownership="none">
5670
+ <type name="none" c:type="void"/>
5671
+ </return-value>
5672
+ <parameters>
5673
+ <instance-parameter name="application" transfer-ownership="none">
5674
+ <doc xml:space="preserve">the #GApplication</doc>
5675
+ <type name="Application" c:type="GApplication*"/>
5676
+ </instance-parameter>
5677
+ <parameter name="description"
5678
+ transfer-ownership="none"
5679
+ nullable="1"
5680
+ allow-none="1">
5681
+ <doc xml:space="preserve">a string to be shown in `--help` output
5682
+ after the list of options, or %NULL</doc>
5683
+ <type name="utf8" c:type="const gchar*"/>
5684
+ </parameter>
5685
+ </parameters>
5686
+ </method>
5687
+ <method name="set_option_context_parameter_string"
5688
+ c:identifier="g_application_set_option_context_parameter_string"
5689
+ version="2.56">
5690
+ <doc xml:space="preserve">Sets the parameter string to be used by the commandline handling of @application.
5691
+
5692
+ This function registers the argument to be passed to g_option_context_new()
5693
+ when the internal #GOptionContext of @application is created.
5694
+
5695
+ See g_option_context_new() for more information about @parameter_string.</doc>
5696
+ <return-value transfer-ownership="none">
5697
+ <type name="none" c:type="void"/>
5698
+ </return-value>
5699
+ <parameters>
5700
+ <instance-parameter name="application" transfer-ownership="none">
5701
+ <doc xml:space="preserve">the #GApplication</doc>
5702
+ <type name="Application" c:type="GApplication*"/>
5703
+ </instance-parameter>
5704
+ <parameter name="parameter_string"
5705
+ transfer-ownership="none"
5706
+ nullable="1"
5707
+ allow-none="1">
5708
+ <doc xml:space="preserve">a string which is displayed
5709
+ in the first line of `--help` output, after the usage summary `programname [OPTION...]`.</doc>
5710
+ <type name="utf8" c:type="const gchar*"/>
5711
+ </parameter>
5712
+ </parameters>
5713
+ </method>
5714
+ <method name="set_option_context_summary"
5715
+ c:identifier="g_application_set_option_context_summary"
5716
+ version="2.56">
5717
+ <doc xml:space="preserve">Adds a summary to the @application option context.
5718
+
5719
+ See g_option_context_set_summary() for more information.</doc>
5720
+ <return-value transfer-ownership="none">
5721
+ <type name="none" c:type="void"/>
5722
+ </return-value>
5723
+ <parameters>
5724
+ <instance-parameter name="application" transfer-ownership="none">
5725
+ <doc xml:space="preserve">the #GApplication</doc>
5726
+ <type name="Application" c:type="GApplication*"/>
5727
+ </instance-parameter>
5728
+ <parameter name="summary"
5729
+ transfer-ownership="none"
5730
+ nullable="1"
5731
+ allow-none="1">
5732
+ <doc xml:space="preserve">a string to be shown in `--help` output
5733
+ before the list of options, or %NULL</doc>
5734
+ <type name="utf8" c:type="const gchar*"/>
5735
+ </parameter>
5736
+ </parameters>
5737
+ </method>
5653
5738
  <method name="set_resource_base_path"
5654
5739
  c:identifier="g_application_set_resource_base_path"
5655
5740
  version="2.42">
@@ -6414,7 +6499,7 @@ the invoking process rather than the local process.</doc>
6414
6499
  </instance-parameter>
6415
6500
  <parameter name="arg" transfer-ownership="none">
6416
6501
  <doc xml:space="preserve">an argument from @cmdline</doc>
6417
- <type name="utf8" c:type="const gchar*"/>
6502
+ <type name="filename" c:type="const gchar*"/>
6418
6503
  </parameter>
6419
6504
  </parameters>
6420
6505
  </method>
@@ -6433,10 +6518,10 @@ use g_option_context_parse_strv().
6433
6518
  The return value is %NULL-terminated and should be freed using
6434
6519
  g_strfreev().</doc>
6435
6520
  <return-value transfer-ownership="full">
6436
- <doc xml:space="preserve">the string array
6437
- containing the arguments (the argv)</doc>
6521
+ <doc xml:space="preserve">
6522
+ the string array containing the arguments (the argv)</doc>
6438
6523
  <array length="0" zero-terminated="0" c:type="gchar**">
6439
- <type name="utf8"/>
6524
+ <type name="filename"/>
6440
6525
  </array>
6441
6526
  </return-value>
6442
6527
  <parameters>
@@ -6469,7 +6554,7 @@ The return value should not be modified or freed and is valid for as
6469
6554
  long as @cmdline exists.</doc>
6470
6555
  <return-value transfer-ownership="none" nullable="1">
6471
6556
  <doc xml:space="preserve">the current directory, or %NULL</doc>
6472
- <type name="filename" c:type="gchar*"/>
6557
+ <type name="filename" c:type="const gchar*"/>
6473
6558
  </return-value>
6474
6559
  <parameters>
6475
6560
  <instance-parameter name="cmdline" transfer-ownership="none">
@@ -6498,10 +6583,10 @@ long as @cmdline exists.
6498
6583
  See g_application_command_line_getenv() if you are only interested
6499
6584
  in the value of a single environment variable.</doc>
6500
6585
  <return-value transfer-ownership="none">
6501
- <doc xml:space="preserve">the environment
6502
- strings, or %NULL if they were not sent</doc>
6586
+ <doc xml:space="preserve">
6587
+ the environment strings, or %NULL if they were not sent</doc>
6503
6588
  <array c:type="gchar**">
6504
- <type name="utf8"/>
6589
+ <type name="filename"/>
6505
6590
  </array>
6506
6591
  </return-value>
6507
6592
  <parameters>
@@ -6643,7 +6728,7 @@ long as @cmdline exists.</doc>
6643
6728
  </instance-parameter>
6644
6729
  <parameter name="name" transfer-ownership="none">
6645
6730
  <doc xml:space="preserve">the environment variable to get</doc>
6646
- <type name="utf8" c:type="const gchar*"/>
6731
+ <type name="filename" c:type="const gchar*"/>
6647
6732
  </parameter>
6648
6733
  </parameters>
6649
6734
  </method>
@@ -7537,12 +7622,21 @@ will return %FALSE and set @error appropriately if present.</doc>
7537
7622
  </record>
7538
7623
  <callback name="AsyncReadyCallback" c:type="GAsyncReadyCallback">
7539
7624
  <doc xml:space="preserve">Type definition for a function that will be called back when an asynchronous
7540
- operation within GIO has been completed.</doc>
7625
+ operation within GIO has been completed. #GAsyncReadyCallback
7626
+ callbacks from #GTask are guaranteed to be invoked in a later
7627
+ iteration of the
7628
+ [thread-default main context][g-main-context-push-thread-default]
7629
+ where the #GTask was created. All other users of
7630
+ #GAsyncReadyCallback must likewise call it asynchronously in a
7631
+ later iteration of the main context.</doc>
7541
7632
  <return-value transfer-ownership="none">
7542
7633
  <type name="none" c:type="void"/>
7543
7634
  </return-value>
7544
7635
  <parameters>
7545
- <parameter name="source_object" transfer-ownership="none">
7636
+ <parameter name="source_object"
7637
+ transfer-ownership="none"
7638
+ nullable="1"
7639
+ allow-none="1">
7546
7640
  <doc xml:space="preserve">the object the asynchronous operation was started with.</doc>
7547
7641
  <type name="GObject.Object" c:type="GObject*"/>
7548
7642
  </parameter>
@@ -7572,13 +7666,16 @@ Asynchronous operations are broken up into two separate operations
7572
7666
  which are chained together by a #GAsyncReadyCallback. To begin
7573
7667
  an asynchronous operation, provide a #GAsyncReadyCallback to the
7574
7668
  asynchronous function. This callback will be triggered when the
7575
- operation has completed, and will be passed a #GAsyncResult instance
7576
- filled with the details of the operation's success or failure, the
7577
- object the asynchronous function was started for and any error codes
7578
- returned. The asynchronous callback function is then expected to call
7579
- the corresponding "_finish()" function, passing the object the
7580
- function was called for, the #GAsyncResult instance, and (optionally)
7581
- an @error to grab any error conditions that may have occurred.
7669
+ operation has completed, and must be run in a later iteration of
7670
+ the [thread-default main context][g-main-context-push-thread-default]
7671
+ from where the operation was initiated. It will be passed a
7672
+ #GAsyncResult instance filled with the details of the operation's
7673
+ success or failure, the object the asynchronous function was
7674
+ started for and any error codes returned. The asynchronous callback
7675
+ function is then expected to call the corresponding "_finish()"
7676
+ function, passing the object the function was called for, the
7677
+ #GAsyncResult instance, and (optionally) an @error to grab any
7678
+ error conditions that may have occurred.
7582
7679
 
7583
7680
  The "_finish()" function for an operation takes the generic result
7584
7681
  (of type #GAsyncResult) and returns the specific result that the
@@ -7649,9 +7746,9 @@ higher priority. It is recommended to choose priorities between
7649
7746
  as a default.</doc>
7650
7747
  <virtual-method name="get_source_object" invoker="get_source_object">
7651
7748
  <doc xml:space="preserve">Gets the source object from a #GAsyncResult.</doc>
7652
- <return-value transfer-ownership="full">
7653
- <doc xml:space="preserve">a new reference to the source object for the @res,
7654
- or %NULL if there is none.</doc>
7749
+ <return-value transfer-ownership="full" nullable="1">
7750
+ <doc xml:space="preserve">a new reference to the source
7751
+ object for the @res, or %NULL if there is none.</doc>
7655
7752
  <type name="GObject.Object" c:type="GObject*"/>
7656
7753
  </return-value>
7657
7754
  <parameters>
@@ -7699,9 +7796,9 @@ pointer indicating the function @res was created by).</doc>
7699
7796
  <method name="get_source_object"
7700
7797
  c:identifier="g_async_result_get_source_object">
7701
7798
  <doc xml:space="preserve">Gets the source object from a #GAsyncResult.</doc>
7702
- <return-value transfer-ownership="full">
7703
- <doc xml:space="preserve">a new reference to the source object for the @res,
7704
- or %NULL if there is none.</doc>
7799
+ <return-value transfer-ownership="full" nullable="1">
7800
+ <doc xml:space="preserve">a new reference to the source
7801
+ object for the @res, or %NULL if there is none.</doc>
7705
7802
  <type name="GObject.Object" c:type="GObject*"/>
7706
7803
  </return-value>
7707
7804
  <parameters>
@@ -7799,9 +7896,9 @@ to enable subclasses to chain up correctly.</doc>
7799
7896
  </field>
7800
7897
  <field name="get_source_object">
7801
7898
  <callback name="get_source_object">
7802
- <return-value transfer-ownership="full">
7803
- <doc xml:space="preserve">a new reference to the source object for the @res,
7804
- or %NULL if there is none.</doc>
7899
+ <return-value transfer-ownership="full" nullable="1">
7900
+ <doc xml:space="preserve">a new reference to the source
7901
+ object for the @res, or %NULL if there is none.</doc>
7805
7902
  <type name="GObject.Object" c:type="GObject*"/>
7806
7903
  </return-value>
7807
7904
  <parameters>
@@ -7990,7 +8087,7 @@ of bytes that are required to fill the buffer.</doc>
7990
8087
  <virtual-method name="fill_finish" invoker="fill_finish" throws="1">
7991
8088
  <doc xml:space="preserve">Finishes an asynchronous read.</doc>
7992
8089
  <return-value transfer-ownership="none">
7993
- <doc xml:space="preserve">a #gssize of the read stream, or %-1 on an error.</doc>
8090
+ <doc xml:space="preserve">a #gssize of the read stream, or `-1` on an error.</doc>
7994
8091
  <type name="gssize" c:type="gssize"/>
7995
8092
  </return-value>
7996
8093
  <parameters>
@@ -8108,7 +8205,7 @@ of bytes that are required to fill the buffer.</doc>
8108
8205
  throws="1">
8109
8206
  <doc xml:space="preserve">Finishes an asynchronous read.</doc>
8110
8207
  <return-value transfer-ownership="none">
8111
- <doc xml:space="preserve">a #gssize of the read stream, or %-1 on an error.</doc>
8208
+ <doc xml:space="preserve">a #gssize of the read stream, or `-1` on an error.</doc>
8112
8209
  <type name="gssize" c:type="gssize"/>
8113
8210
  </return-value>
8114
8211
  <parameters>
@@ -8352,7 +8449,7 @@ smaller than its current contents.</doc>
8352
8449
  <field name="fill_finish">
8353
8450
  <callback name="fill_finish" throws="1">
8354
8451
  <return-value transfer-ownership="none">
8355
- <doc xml:space="preserve">a #gssize of the read stream, or %-1 on an error.</doc>
8452
+ <doc xml:space="preserve">a #gssize of the read stream, or `-1` on an error.</doc>
8356
8453
  <type name="gssize" c:type="gssize"/>
8357
8454
  </return-value>
8358
8455
  <parameters>
@@ -8716,7 +8813,7 @@ return an error from g_bus_own_name() rather than entering the waiting queue for
8716
8813
  version="2.26">
8717
8814
  <doc xml:space="preserve">Invoked when the name being watched is known not to have to have a owner.
8718
8815
 
8719
- This is also invoked when the #GDBusConection on which the watch was
8816
+ This is also invoked when the #GDBusConnection on which the watch was
8720
8817
  established has been closed. In that case, @connection will be
8721
8818
  %NULL.</doc>
8722
8819
  <return-value transfer-ownership="none">
@@ -8990,7 +9087,7 @@ same time as the cancellable operation is finished and the
8990
9087
  signal handler is removed. See #GCancellable::cancelled for
8991
9088
  details on how to use this.
8992
9089
 
8993
- If @cancellable is %NULL or @handler_id is %0 this function does
9090
+ If @cancellable is %NULL or @handler_id is `0` this function does
8994
9091
  nothing.</doc>
8995
9092
  <return-value transfer-ownership="none">
8996
9093
  <type name="none" c:type="void"/>
@@ -9004,7 +9101,7 @@ nothing.</doc>
9004
9101
  <type name="Cancellable" c:type="GCancellable*"/>
9005
9102
  </instance-parameter>
9006
9103
  <parameter name="handler_id" transfer-ownership="none">
9007
- <doc xml:space="preserve">Handler id of the handler to be disconnected, or %0.</doc>
9104
+ <doc xml:space="preserve">Handler id of the handler to be disconnected, or `0`.</doc>
9008
9105
  <type name="gulong" c:type="gulong"/>
9009
9106
  </parameter>
9010
9107
  </parameters>
@@ -10392,8 +10489,12 @@ g_action_group_list_actions() to get the initial list.</doc>
10392
10489
  <doc xml:space="preserve">A #GDBusConnection</doc>
10393
10490
  <type name="DBusConnection" c:type="GDBusConnection*"/>
10394
10491
  </parameter>
10395
- <parameter name="bus_name" transfer-ownership="none">
10396
- <doc xml:space="preserve">the bus name which exports the action group</doc>
10492
+ <parameter name="bus_name"
10493
+ transfer-ownership="none"
10494
+ nullable="1"
10495
+ allow-none="1">
10496
+ <doc xml:space="preserve">the bus name which exports the action
10497
+ group or %NULL if @connection is not a message bus connection</doc>
10397
10498
  <type name="utf8" c:type="const gchar*"/>
10398
10499
  </parameter>
10399
10500
  <parameter name="object_path" transfer-ownership="none">
@@ -10771,7 +10872,7 @@ Here is an example for exporting a subtree:
10771
10872
  ## An example for file descriptor passing # {#gdbus-unix-fd-client}
10772
10873
 
10773
10874
  Here is an example for passing UNIX file descriptors:
10774
- [gdbus-unix-fd-client.c](https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-unix-fd-client.c)
10875
+ [gdbus-unix-fd-client.c](https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-example-unix-fd-client.c)
10775
10876
 
10776
10877
  ## An example for exporting a GObject # {#gdbus-export}
10777
10878
 
@@ -11138,7 +11239,9 @@ not compatible with the D-Bus protocol, the operation fails with
11138
11239
 
11139
11240
  If @reply_type is non-%NULL then the reply will be checked for having this type and an
11140
11241
  error will be raised if it does not match. Said another way, if you give a @reply_type
11141
- then any non-%NULL return value will be of this type.
11242
+ then any non-%NULL return value will be of this type. Unless it’s
11243
+ %G_VARIANT_TYPE_UNIT, the @reply_type will be a tuple containing one or more
11244
+ values.
11142
11245
 
11143
11246
  If the @parameters #GVariant is floating, it is consumed. This allows
11144
11247
  convenient 'inline' use of g_variant_new(), e.g.:
@@ -11209,7 +11312,8 @@ the %G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED flag set.</doc>
11209
11312
  transfer-ownership="none"
11210
11313
  nullable="1"
11211
11314
  allow-none="1">
11212
- <doc xml:space="preserve">the expected type of the reply, or %NULL</doc>
11315
+ <doc xml:space="preserve">the expected type of the reply (which will be a
11316
+ tuple), or %NULL</doc>
11213
11317
  <type name="GLib.VariantType" c:type="const GVariantType*"/>
11214
11318
  </parameter>
11215
11319
  <parameter name="flags" transfer-ownership="none">
@@ -11697,7 +11801,9 @@ does.</doc>
11697
11801
 
11698
11802
  If the parameters GVariant is floating, it is consumed.
11699
11803
 
11700
- This can only fail if @parameters is not compatible with the D-Bus protocol.</doc>
11804
+ This can only fail if @parameters is not compatible with the D-Bus protocol
11805
+ (%G_IO_ERROR_INVALID_ARGUMENT), or if @connection has been closed
11806
+ (%G_IO_ERROR_CLOSED).</doc>
11701
11807
  <return-value transfer-ownership="none">
11702
11808
  <doc xml:space="preserve">%TRUE unless @error is set</doc>
11703
11809
  <type name="gboolean" c:type="gboolean"/>
@@ -13414,7 +13520,9 @@ exists.</doc>
13414
13520
  </parameter>
13415
13521
  <parameter name="entries" transfer-ownership="none">
13416
13522
  <doc xml:space="preserve">A pointer to @num_entries #GDBusErrorEntry struct items.</doc>
13417
- <type name="DBusErrorEntry" c:type="const GDBusErrorEntry*"/>
13523
+ <array length="3" zero-terminated="0" c:type="GDBusErrorEntry*">
13524
+ <type name="DBusErrorEntry" c:type="GDBusErrorEntry"/>
13525
+ </array>
13418
13526
  </parameter>
13419
13527
  <parameter name="num_entries" transfer-ownership="none">
13420
13528
  <doc xml:space="preserve">Number of items to register.</doc>
@@ -14139,7 +14247,7 @@ emitted immediately.
14139
14247
 
14140
14248
  For example, an exported D-Bus interface may queue up property
14141
14249
  changes and emit the
14142
- `org.freedesktop.DBus.Properties::PropertiesChanged`
14250
+ `org.freedesktop.DBus.Properties.PropertiesChanged`
14143
14251
  signal later (e.g. in an idle handler). This technique is useful
14144
14252
  for collapsing multiple property changes into one.</doc>
14145
14253
  <return-value transfer-ownership="none">
@@ -14259,7 +14367,7 @@ emitted immediately.
14259
14367
 
14260
14368
  For example, an exported D-Bus interface may queue up property
14261
14369
  changes and emit the
14262
- `org.freedesktop.DBus.Properties::PropertiesChanged`
14370
+ `org.freedesktop.DBus.Properties.PropertiesChanged`
14263
14371
  signal later (e.g. in an idle handler). This technique is useful
14264
14372
  for collapsing multiple property changes into one.</doc>
14265
14373
  <return-value transfer-ownership="none">
@@ -14757,8 +14865,12 @@ the thread default main context unchanged.</doc>
14757
14865
  <doc xml:space="preserve">a #GDBusConnection</doc>
14758
14866
  <type name="DBusConnection" c:type="GDBusConnection*"/>
14759
14867
  </parameter>
14760
- <parameter name="bus_name" transfer-ownership="none">
14761
- <doc xml:space="preserve">the bus name which exports the menu model</doc>
14868
+ <parameter name="bus_name"
14869
+ transfer-ownership="none"
14870
+ nullable="1"
14871
+ allow-none="1">
14872
+ <doc xml:space="preserve">the bus name which exports the menu model
14873
+ or %NULL if @connection is not a message bus connection</doc>
14762
14874
  <type name="utf8" c:type="const gchar*"/>
14763
14875
  </parameter>
14764
14876
  <parameter name="object_path" transfer-ownership="none">
@@ -15781,7 +15893,7 @@ passive_filter (GDBusConnection *connection
15781
15893
  gboolean incoming,
15782
15894
  gpointer user_data)
15783
15895
  {
15784
- /&lt;!-- --&gt;* inspect @message *&lt;!-- --&gt;/
15896
+ // inspect @message
15785
15897
  return message;
15786
15898
  }
15787
15899
  ]|
@@ -15814,10 +15926,10 @@ modifying_filter (GDBusConnection *connection
15814
15926
 
15815
15927
  error = NULL;
15816
15928
  copy = g_dbus_message_copy (message, &amp;error);
15817
- /&lt;!-- --&gt;* handle @error being is set *&lt;!-- --&gt;/
15929
+ // handle @error being set
15818
15930
  g_object_unref (message);
15819
15931
 
15820
- /&lt;!-- --&gt;* modify @copy *&lt;!-- --&gt;/
15932
+ // modify @copy
15821
15933
 
15822
15934
  return copy;
15823
15935
  }
@@ -16442,7 +16554,7 @@ else
16442
16554
  g_dbus_method_invocation_return_value (invocation,
16443
16555
  g_variant_new ("(s)", result_string));
16444
16556
 
16445
- /&lt;!-- --&gt;* Do not free @invocation here; returning a value does that *&lt;!-- --&gt;/
16557
+ // Do not free @invocation here; returning a value does that
16446
16558
  ]|
16447
16559
 
16448
16560
  This method will take ownership of @invocation. See
@@ -17875,7 +17987,8 @@ that @manager was constructed in.</doc>
17875
17987
  <type name="GLib.Variant"/>
17876
17988
  </parameter>
17877
17989
  <parameter name="invalidated_properties" transfer-ownership="none">
17878
- <doc xml:space="preserve">A %NULL terminated array of properties that was invalidated.</doc>
17990
+ <doc xml:space="preserve">A %NULL terminated
17991
+ array of properties that were invalidated.</doc>
17879
17992
  <array>
17880
17993
  <type name="utf8"/>
17881
17994
  </array>
@@ -18807,7 +18920,7 @@ interface on a remote object. A #GDBusProxy can be constructed for
18807
18920
  both well-known and unique names.
18808
18921
 
18809
18922
  By default, #GDBusProxy will cache all properties (and listen to
18810
- changes) of the remote object, and proxy all signals that gets
18923
+ changes) of the remote object, and proxy all signals that get
18811
18924
  emitted. This behaviour can be changed by passing suitable
18812
18925
  #GDBusProxyFlags when the proxy is created. If the proxy is for a
18813
18926
  well-known name, the property cache is flushed when the name owner
@@ -18849,7 +18962,8 @@ An example using a proxy for a well-known name can be found in
18849
18962
  throws="1">
18850
18963
  <doc xml:space="preserve">Finishes creating a #GDBusProxy.</doc>
18851
18964
  <return-value transfer-ownership="full">
18852
- <doc xml:space="preserve">A #GDBusProxy or %NULL if @error is set. Free with g_object_unref().</doc>
18965
+ <doc xml:space="preserve">A #GDBusProxy or %NULL if @error is set.
18966
+ Free with g_object_unref().</doc>
18853
18967
  <type name="DBusProxy" c:type="GDBusProxy*"/>
18854
18968
  </return-value>
18855
18969
  <parameters>
@@ -18865,7 +18979,8 @@ An example using a proxy for a well-known name can be found in
18865
18979
  throws="1">
18866
18980
  <doc xml:space="preserve">Finishes creating a #GDBusProxy.</doc>
18867
18981
  <return-value transfer-ownership="full">
18868
- <doc xml:space="preserve">A #GDBusProxy or %NULL if @error is set. Free with g_object_unref().</doc>
18982
+ <doc xml:space="preserve">A #GDBusProxy or %NULL if @error is set.
18983
+ Free with g_object_unref().</doc>
18869
18984
  <type name="DBusProxy" c:type="GDBusProxy*"/>
18870
18985
  </return-value>
18871
18986
  <parameters>
@@ -18883,7 +18998,8 @@ An example using a proxy for a well-known name can be found in
18883
18998
 
18884
18999
  #GDBusProxy is used in this [example][gdbus-wellknown-proxy].</doc>
18885
19000
  <return-value transfer-ownership="full">
18886
- <doc xml:space="preserve">A #GDBusProxy or %NULL if error is set. Free with g_object_unref().</doc>
19001
+ <doc xml:space="preserve">A #GDBusProxy or %NULL if error is set.
19002
+ Free with g_object_unref().</doc>
18887
19003
  <type name="DBusProxy" c:type="GDBusProxy*"/>
18888
19004
  </return-value>
18889
19005
  <parameters>
@@ -18947,7 +19063,8 @@ and g_dbus_proxy_new_finish() for the asynchronous version.
18947
19063
 
18948
19064
  #GDBusProxy is used in this [example][gdbus-wellknown-proxy].</doc>
18949
19065
  <return-value transfer-ownership="full">
18950
- <doc xml:space="preserve">A #GDBusProxy or %NULL if error is set. Free with g_object_unref().</doc>
19066
+ <doc xml:space="preserve">A #GDBusProxy or %NULL if error is set.
19067
+ Free with g_object_unref().</doc>
18951
19068
  <type name="DBusProxy" c:type="GDBusProxy*"/>
18952
19069
  </return-value>
18953
19070
  <parameters>
@@ -19535,10 +19652,10 @@ blocking IO.
19535
19652
  If @proxy has an expected interface (see
19536
19653
  #GDBusProxy:g-interface-info) and @property_name is referenced by
19537
19654
  it, then @value is checked against the type of the property.</doc>
19538
- <return-value transfer-ownership="full">
19539
- <doc xml:space="preserve">A reference to the #GVariant instance that holds the value
19540
- for @property_name or %NULL if the value is not in the cache. The
19541
- returned reference must be freed with g_variant_unref().</doc>
19655
+ <return-value transfer-ownership="full" nullable="1">
19656
+ <doc xml:space="preserve">A reference to the #GVariant instance
19657
+ that holds the value for @property_name or %NULL if the value is not in
19658
+ the cache. The returned reference must be freed with g_variant_unref().</doc>
19542
19659
  <type name="GLib.Variant" c:type="GVariant*"/>
19543
19660
  </return-value>
19544
19661
  <parameters>
@@ -19556,8 +19673,9 @@ returned reference must be freed with g_variant_unref().</doc>
19556
19673
  c:identifier="g_dbus_proxy_get_cached_property_names"
19557
19674
  version="2.26">
19558
19675
  <doc xml:space="preserve">Gets the names of all cached properties on @proxy.</doc>
19559
- <return-value transfer-ownership="full">
19560
- <doc xml:space="preserve">A %NULL-terminated array of strings or %NULL if
19676
+ <return-value transfer-ownership="full" nullable="1">
19677
+ <doc xml:space="preserve">A
19678
+ %NULL-terminated array of strings or %NULL if
19561
19679
  @proxy has no cached properties. Free the returned array with
19562
19680
  g_strfreev().</doc>
19563
19681
  <array c:type="gchar**">
@@ -19626,9 +19744,9 @@ See the #GDBusProxy:g-default-timeout property for more details.</doc>
19626
19744
  <doc xml:space="preserve">Returns the #GDBusInterfaceInfo, if any, specifying the interface
19627
19745
  that @proxy conforms to. See the #GDBusProxy:g-interface-info
19628
19746
  property for more details.</doc>
19629
- <return-value transfer-ownership="full">
19630
- <doc xml:space="preserve">A #GDBusInterfaceInfo or %NULL. Do not unref the returned
19631
- object, it is owned by @proxy.</doc>
19747
+ <return-value transfer-ownership="none" nullable="1">
19748
+ <doc xml:space="preserve">A #GDBusInterfaceInfo or %NULL.
19749
+ Do not unref the returned object, it is owned by @proxy.</doc>
19632
19750
  <type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
19633
19751
  </return-value>
19634
19752
  <parameters>
@@ -19675,8 +19793,9 @@ object, it is owned by @proxy.</doc>
19675
19793
  no-one currently owns that name. You may connect to the
19676
19794
  #GObject::notify signal to track changes to the
19677
19795
  #GDBusProxy:g-name-owner property.</doc>
19678
- <return-value transfer-ownership="full">
19679
- <doc xml:space="preserve">The name owner or %NULL if no name owner exists. Free with g_free().</doc>
19796
+ <return-value transfer-ownership="full" nullable="1">
19797
+ <doc xml:space="preserve">The name owner or %NULL if no name
19798
+ owner exists. Free with g_free().</doc>
19680
19799
  <type name="utf8" c:type="gchar*"/>
19681
19800
  </return-value>
19682
19801
  <parameters>
@@ -19798,7 +19917,8 @@ details.</doc>
19798
19917
  transfer-ownership="none"
19799
19918
  nullable="1"
19800
19919
  allow-none="1">
19801
- <doc xml:space="preserve">Minimum interface this proxy conforms to or %NULL to unset.</doc>
19920
+ <doc xml:space="preserve">Minimum interface this proxy conforms to
19921
+ or %NULL to unset.</doc>
19802
19922
  <type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
19803
19923
  </parameter>
19804
19924
  </parameters>
@@ -21173,6 +21293,8 @@ an error occurred.</doc>
21173
21293
  </method>
21174
21294
  <method name="read_until"
21175
21295
  c:identifier="g_data_input_stream_read_until"
21296
+ deprecated="1"
21297
+ deprecated-version="2.56"
21176
21298
  throws="1">
21177
21299
  <doc xml:space="preserve">Reads a string from the data input stream, up to the first
21178
21300
  occurrence of any of the stop characters.
@@ -21185,6 +21307,8 @@ inconsistent with g_data_input_stream_read_until_async(). Both
21185
21307
  functions will be marked as deprecated in a future release. Use
21186
21308
  g_data_input_stream_read_upto() instead, but note that that function
21187
21309
  does not consume the stop character.</doc>
21310
+ <doc-deprecated xml:space="preserve">Use g_data_input_stream_read_upto() instead, which has more
21311
+ consistent behaviour regarding the stop character.</doc-deprecated>
21188
21312
  <return-value transfer-ownership="full">
21189
21313
  <doc xml:space="preserve">a string with the data that was read
21190
21314
  before encountering any of the stop characters. Set @length to
@@ -21221,7 +21345,9 @@ does not consume the stop character.</doc>
21221
21345
  </method>
21222
21346
  <method name="read_until_async"
21223
21347
  c:identifier="g_data_input_stream_read_until_async"
21224
- version="2.20">
21348
+ version="2.20"
21349
+ deprecated="1"
21350
+ deprecated-version="2.56">
21225
21351
  <doc xml:space="preserve">The asynchronous version of g_data_input_stream_read_until().
21226
21352
  It is an error to have two outstanding calls to this function.
21227
21353
 
@@ -21237,6 +21363,8 @@ Don't use this function in new code. Its functionality is
21237
21363
  inconsistent with g_data_input_stream_read_until(). Both functions
21238
21364
  will be marked as deprecated in a future release. Use
21239
21365
  g_data_input_stream_read_upto_async() instead.</doc>
21366
+ <doc-deprecated xml:space="preserve">Use g_data_input_stream_read_upto_async() instead, which
21367
+ has more consistent behaviour regarding the stop character.</doc-deprecated>
21240
21368
  <return-value transfer-ownership="none">
21241
21369
  <type name="none" c:type="void"/>
21242
21370
  </return-value>
@@ -21281,9 +21409,13 @@ g_data_input_stream_read_upto_async() instead.</doc>
21281
21409
  <method name="read_until_finish"
21282
21410
  c:identifier="g_data_input_stream_read_until_finish"
21283
21411
  version="2.20"
21412
+ deprecated="1"
21413
+ deprecated-version="2.56"
21284
21414
  throws="1">
21285
21415
  <doc xml:space="preserve">Finish an asynchronous call started by
21286
21416
  g_data_input_stream_read_until_async().</doc>
21417
+ <doc-deprecated xml:space="preserve">Use g_data_input_stream_read_upto_finish() instead, which
21418
+ has more consistent behaviour regarding the stop character.</doc-deprecated>
21287
21419
  <return-value transfer-ownership="full">
21288
21420
  <doc xml:space="preserve">a string with the data that was read
21289
21421
  before encountering any of the stop characters. Set @length to
@@ -21324,7 +21456,9 @@ g_data_input_stream_read_byte() to get it before calling
21324
21456
  g_data_input_stream_read_upto() again.
21325
21457
 
21326
21458
  Note that @stop_chars may contain '\0' if @stop_chars_len is
21327
- specified.</doc>
21459
+ specified.
21460
+
21461
+ The returned string will always be nul-terminated on success.</doc>
21328
21462
  <return-value transfer-ownership="full">
21329
21463
  <doc xml:space="preserve">a string with the data that was read
21330
21464
  before encountering any of the stop characters. Set @length to
@@ -21436,7 +21570,9 @@ g_data_input_stream_read_upto_async().
21436
21570
 
21437
21571
  Note that this function does not consume the stop character. You
21438
21572
  have to use g_data_input_stream_read_byte() to get it before calling
21439
- g_data_input_stream_read_upto_async() again.</doc>
21573
+ g_data_input_stream_read_upto_async() again.
21574
+
21575
+ The returned string will always be nul-terminated on success.</doc>
21440
21576
  <return-value transfer-ownership="full">
21441
21577
  <doc xml:space="preserve">a string with the data that was read
21442
21578
  before encountering any of the stop characters. Set @length to
@@ -25719,7 +25855,7 @@ non-%NULL.)</doc>
25719
25855
  version="2.48">
25720
25856
  <doc xml:space="preserve">Sets the certificate database that is used to verify peer certificates.
25721
25857
  This is set to the default database by default. See
25722
- g_dtls_backend_get_default_database(). If set to %NULL, then
25858
+ g_tls_backend_get_default_database(). If set to %NULL, then
25723
25859
  peer certificate validation will always set the
25724
25860
  %G_TLS_CERTIFICATE_UNKNOWN_CA error (meaning
25725
25861
  #GDtlsConnection::accept-certificate will always be emitted on
@@ -25985,7 +26121,7 @@ g_dtls_connection_set_certificate().</doc>
25985
26121
  transfer-ownership="none">
25986
26122
  <doc xml:space="preserve">The certificate database to use when verifying this TLS connection.
25987
26123
  If no certificate database is set, then the default database will be
25988
- used. See g_dtls_backend_get_default_database().</doc>
26124
+ used. See g_tls_backend_get_default_database().</doc>
25989
26125
  <type name="TlsDatabase"/>
25990
26126
  </property>
25991
26127
  <property name="interaction"
@@ -27332,6 +27468,7 @@ To construct a #GFile, you can use:
27332
27468
  - g_file_new_for_commandline_arg() for a command line argument.
27333
27469
  - g_file_new_tmp() to create a temporary file from a template.
27334
27470
  - g_file_parse_name() from a UTF-8 string gotten from g_file_get_parse_name().
27471
+ - g_file_new_build_filename() to create a file from path elements.
27335
27472
 
27336
27473
  One way to think of a #GFile is as an abstraction of a pathname. For
27337
27474
  normal files the system pathname is what is stored internally, but as
@@ -27399,6 +27536,30 @@ has been modified from the version on the file system. See the
27399
27536
  HTTP 1.1
27400
27537
  [specification](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html)
27401
27538
  for HTTP Etag headers, which are a very similar concept.</doc>
27539
+ <function name="new_build_filename"
27540
+ c:identifier="g_file_new_build_filename"
27541
+ version="2.56"
27542
+ introspectable="0">
27543
+ <doc xml:space="preserve">Constructs a #GFile from a series of elements using the correct
27544
+ separator for filenames.
27545
+
27546
+ Using this function is equivalent to calling g_build_filename(),
27547
+ followed by g_file_new_for_path() on the result.</doc>
27548
+ <return-value transfer-ownership="full">
27549
+ <doc xml:space="preserve">a new #GFile</doc>
27550
+ <type name="File" c:type="GFile*"/>
27551
+ </return-value>
27552
+ <parameters>
27553
+ <parameter name="first_element" transfer-ownership="none">
27554
+ <doc xml:space="preserve">the first element in the path</doc>
27555
+ <type name="filename" c:type="const gchar*"/>
27556
+ </parameter>
27557
+ <parameter name="..." transfer-ownership="none">
27558
+ <doc xml:space="preserve">remaining elements in path, terminated by %NULL</doc>
27559
+ <varargs/>
27560
+ </parameter>
27561
+ </parameters>
27562
+ </function>
27402
27563
  <function name="new_for_commandline_arg"
27403
27564
  c:identifier="g_file_new_for_commandline_arg">
27404
27565
  <doc xml:space="preserve">Creates a #GFile with the given argument from the command line.
@@ -27423,7 +27584,7 @@ for you there. It is also always possible to use this function with
27423
27584
  <parameters>
27424
27585
  <parameter name="arg" transfer-ownership="none">
27425
27586
  <doc xml:space="preserve">a command line string</doc>
27426
- <type name="utf8" c:type="const char*"/>
27587
+ <type name="filename" c:type="const char*"/>
27427
27588
  </parameter>
27428
27589
  </parameters>
27429
27590
  </function>
@@ -27448,11 +27609,11 @@ See also g_application_command_line_create_file_for_arg().</doc>
27448
27609
  <parameters>
27449
27610
  <parameter name="arg" transfer-ownership="none">
27450
27611
  <doc xml:space="preserve">a command line string</doc>
27451
- <type name="utf8" c:type="const gchar*"/>
27612
+ <type name="filename" c:type="const gchar*"/>
27452
27613
  </parameter>
27453
27614
  <parameter name="cwd" transfer-ownership="none">
27454
27615
  <doc xml:space="preserve">the current working directory of the commandline</doc>
27455
- <type name="filename" c:type="gchar*"/>
27616
+ <type name="filename" c:type="const gchar*"/>
27456
27617
  </parameter>
27457
27618
  </parameters>
27458
27619
  </function>
@@ -27469,7 +27630,7 @@ operation if @path is malformed.</doc>
27469
27630
  <parameter name="path" transfer-ownership="none">
27470
27631
  <doc xml:space="preserve">a string containing a relative or absolute path.
27471
27632
  The string must be encoded in the glib filename encoding.</doc>
27472
- <type name="filename" c:type="char*"/>
27633
+ <type name="filename" c:type="const char*"/>
27473
27634
  </parameter>
27474
27635
  </parameters>
27475
27636
  </function>
@@ -27516,7 +27677,7 @@ a temporary file could not be created.</doc>
27516
27677
  allow-none="1">
27517
27678
  <doc xml:space="preserve">Template for the file
27518
27679
  name, as in g_file_open_tmp(), or %NULL for a default template</doc>
27519
- <type name="filename" c:type="char*"/>
27680
+ <type name="filename" c:type="const char*"/>
27520
27681
  </parameter>
27521
27682
  <parameter name="iostream"
27522
27683
  direction="out"
@@ -28949,7 +29110,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
28949
29110
  <parameter name="symlink_value" transfer-ownership="none">
28950
29111
  <doc xml:space="preserve">a string with the path for the target
28951
29112
  of the new symlink</doc>
28952
- <type name="filename" c:type="char*"/>
29113
+ <type name="filename" c:type="const char*"/>
28953
29114
  </parameter>
28954
29115
  <parameter name="cancellable"
28955
29116
  transfer-ownership="none"
@@ -30465,14 +30626,14 @@ This call does no blocking I/O.</doc>
30465
30626
  </instance-parameter>
30466
30627
  <parameter name="relative_path" transfer-ownership="none">
30467
30628
  <doc xml:space="preserve">a given relative path string</doc>
30468
- <type name="filename" c:type="char*"/>
30629
+ <type name="filename" c:type="const char*"/>
30469
30630
  </parameter>
30470
30631
  </parameters>
30471
30632
  </virtual-method>
30472
30633
  <virtual-method name="set_attribute" invoker="set_attribute" throws="1">
30473
30634
  <doc xml:space="preserve">Sets an attribute in the file with attribute name @attribute to @value.
30474
30635
 
30475
- Some attributes can be unset by setting @attribute to
30636
+ Some attributes can be unset by setting @type to
30476
30637
  %G_FILE_ATTRIBUTE_TYPE_INVALID and @value_p to %NULL.
30477
30638
 
30478
30639
  If @cancellable is not %NULL, then the operation can be cancelled by
@@ -32339,7 +32500,7 @@ This call does no blocking I/O.</doc>
32339
32500
  </instance-parameter>
32340
32501
  <parameter name="name" transfer-ownership="none">
32341
32502
  <doc xml:space="preserve">string containing the child's basename</doc>
32342
- <type name="filename" c:type="char*"/>
32503
+ <type name="filename" c:type="const char*"/>
32343
32504
  </parameter>
32344
32505
  </parameters>
32345
32506
  </method>
@@ -32617,6 +32778,136 @@ This call does no blocking I/O.</doc>
32617
32778
  </instance-parameter>
32618
32779
  </parameters>
32619
32780
  </method>
32781
+ <method name="load_bytes"
32782
+ c:identifier="g_file_load_bytes"
32783
+ version="2.56"
32784
+ throws="1">
32785
+ <doc xml:space="preserve">Loads the contents of @file and returns it as #GBytes.
32786
+
32787
+ If @file is a resource:// based URI, the resulting bytes will reference the
32788
+ embedded resource instead of a copy. Otherwise, this is equivalent to calling
32789
+ g_file_load_contents() and g_bytes_new_take().
32790
+
32791
+ For resources, @etag_out will be set to %NULL.
32792
+
32793
+ The data contained in the resulting #GBytes is always zero-terminated, but
32794
+ this is not included in the #GBytes length. The resulting #GBytes should be
32795
+ freed with g_bytes_unref() when no longer in use.</doc>
32796
+ <return-value transfer-ownership="full">
32797
+ <doc xml:space="preserve">a #GBytes or %NULL and @error is set</doc>
32798
+ <type name="GLib.Bytes" c:type="GBytes*"/>
32799
+ </return-value>
32800
+ <parameters>
32801
+ <instance-parameter name="file" transfer-ownership="none">
32802
+ <doc xml:space="preserve">a #GFile</doc>
32803
+ <type name="File" c:type="GFile*"/>
32804
+ </instance-parameter>
32805
+ <parameter name="cancellable"
32806
+ transfer-ownership="none"
32807
+ nullable="1"
32808
+ allow-none="1">
32809
+ <doc xml:space="preserve">a #GCancellable or %NULL</doc>
32810
+ <type name="Cancellable" c:type="GCancellable*"/>
32811
+ </parameter>
32812
+ <parameter name="etag_out"
32813
+ direction="out"
32814
+ caller-allocates="0"
32815
+ transfer-ownership="full"
32816
+ nullable="1"
32817
+ optional="1"
32818
+ allow-none="1">
32819
+ <doc xml:space="preserve">a location to place the current
32820
+ entity tag for the file, or %NULL if the entity tag is not needed</doc>
32821
+ <type name="utf8" c:type="gchar**"/>
32822
+ </parameter>
32823
+ </parameters>
32824
+ </method>
32825
+ <method name="load_bytes_async"
32826
+ c:identifier="g_file_load_bytes_async"
32827
+ version="2.56">
32828
+ <doc xml:space="preserve">Asynchronously loads the contents of @file as #GBytes.
32829
+
32830
+ If @file is a resource:// based URI, the resulting bytes will reference the
32831
+ embedded resource instead of a copy. Otherwise, this is equivalent to calling
32832
+ g_file_load_contents_async() and g_bytes_new_take().
32833
+
32834
+ @callback should call g_file_load_bytes_finish() to get the result of this
32835
+ asynchronous operation.
32836
+
32837
+ See g_file_load_bytes() for more information.</doc>
32838
+ <return-value transfer-ownership="none">
32839
+ <type name="none" c:type="void"/>
32840
+ </return-value>
32841
+ <parameters>
32842
+ <instance-parameter name="file" transfer-ownership="none">
32843
+ <doc xml:space="preserve">a #GFile</doc>
32844
+ <type name="File" c:type="GFile*"/>
32845
+ </instance-parameter>
32846
+ <parameter name="cancellable"
32847
+ transfer-ownership="none"
32848
+ nullable="1"
32849
+ allow-none="1">
32850
+ <doc xml:space="preserve">a #GCancellable or %NULL</doc>
32851
+ <type name="Cancellable" c:type="GCancellable*"/>
32852
+ </parameter>
32853
+ <parameter name="callback"
32854
+ transfer-ownership="none"
32855
+ nullable="1"
32856
+ allow-none="1"
32857
+ scope="async"
32858
+ closure="2">
32859
+ <doc xml:space="preserve">a #GAsyncReadyCallback to call when the
32860
+ request is satisfied</doc>
32861
+ <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
32862
+ </parameter>
32863
+ <parameter name="user_data"
32864
+ transfer-ownership="none"
32865
+ nullable="1"
32866
+ allow-none="1">
32867
+ <doc xml:space="preserve">the data to pass to callback function</doc>
32868
+ <type name="gpointer" c:type="gpointer"/>
32869
+ </parameter>
32870
+ </parameters>
32871
+ </method>
32872
+ <method name="load_bytes_finish"
32873
+ c:identifier="g_file_load_bytes_finish"
32874
+ version="2.56"
32875
+ throws="1">
32876
+ <doc xml:space="preserve">Completes an asynchronous request to g_file_load_bytes_async().
32877
+
32878
+ For resources, @etag_out will be set to %NULL.
32879
+
32880
+ The data contained in the resulting #GBytes is always zero-terminated, but
32881
+ this is not included in the #GBytes length. The resulting #GBytes should be
32882
+ freed with g_bytes_unref() when no longer in use.
32883
+
32884
+ See g_file_load_bytes() for more information.</doc>
32885
+ <return-value transfer-ownership="full">
32886
+ <doc xml:space="preserve">a #GBytes or %NULL and @error is set</doc>
32887
+ <type name="GLib.Bytes" c:type="GBytes*"/>
32888
+ </return-value>
32889
+ <parameters>
32890
+ <instance-parameter name="file" transfer-ownership="none">
32891
+ <doc xml:space="preserve">a #GFile</doc>
32892
+ <type name="File" c:type="GFile*"/>
32893
+ </instance-parameter>
32894
+ <parameter name="result" transfer-ownership="none">
32895
+ <doc xml:space="preserve">a #GAsyncResult provided to the callback</doc>
32896
+ <type name="AsyncResult" c:type="GAsyncResult*"/>
32897
+ </parameter>
32898
+ <parameter name="etag_out"
32899
+ direction="out"
32900
+ caller-allocates="0"
32901
+ transfer-ownership="full"
32902
+ nullable="1"
32903
+ optional="1"
32904
+ allow-none="1">
32905
+ <doc xml:space="preserve">a location to place the current
32906
+ entity tag for the file, or %NULL if the entity tag is not needed</doc>
32907
+ <type name="utf8" c:type="gchar**"/>
32908
+ </parameter>
32909
+ </parameters>
32910
+ </method>
32620
32911
  <method name="load_contents"
32621
32912
  c:identifier="g_file_load_contents"
32622
32913
  throws="1">
@@ -32806,8 +33097,12 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
32806
33097
  <doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
32807
33098
  <type name="Cancellable" c:type="GCancellable*"/>
32808
33099
  </parameter>
32809
- <parameter name="read_more_callback" transfer-ownership="none">
32810
- <doc xml:space="preserve">a #GFileReadMoreCallback to receive partial data
33100
+ <parameter name="read_more_callback"
33101
+ transfer-ownership="none"
33102
+ scope="call"
33103
+ closure="3">
33104
+ <doc xml:space="preserve">a
33105
+ #GFileReadMoreCallback to receive partial data
32811
33106
  and to specify whether further data should be read</doc>
32812
33107
  <type name="FileReadMoreCallback" c:type="GFileReadMoreCallback"/>
32813
33108
  </parameter>
@@ -32817,7 +33112,8 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
32817
33112
  allow-none="1"
32818
33113
  scope="async"
32819
33114
  closure="3">
32820
- <doc xml:space="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
33115
+ <doc xml:space="preserve">a #GAsyncReadyCallback to call
33116
+ when the request is satisfied</doc>
32821
33117
  <type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
32822
33118
  </parameter>
32823
33119
  <parameter name="user_data"
@@ -33040,7 +33336,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
33040
33336
  <parameter name="symlink_value" transfer-ownership="none">
33041
33337
  <doc xml:space="preserve">a string with the path for the target
33042
33338
  of the new symlink</doc>
33043
- <type name="filename" c:type="char*"/>
33339
+ <type name="filename" c:type="const char*"/>
33044
33340
  </parameter>
33045
33341
  <parameter name="cancellable"
33046
33342
  transfer-ownership="none"
@@ -33729,6 +34025,26 @@ g_file_open_readwrite_async().</doc>
33729
34025
  </parameter>
33730
34026
  </parameters>
33731
34027
  </method>
34028
+ <method name="peek_path" c:identifier="g_file_peek_path" version="2.56">
34029
+ <doc xml:space="preserve">Exactly like g_file_get_path(), but caches the result via
34030
+ g_object_set_qdata_full(). This is useful for example in C
34031
+ applications which mix `g_file_*` APIs with native ones. It
34032
+ also avoids an extra duplicated string when possible, so will be
34033
+ generally more efficient.
34034
+
34035
+ This call does no blocking I/O.</doc>
34036
+ <return-value transfer-ownership="none" nullable="1">
34037
+ <doc xml:space="preserve">string containing the #GFile's path,
34038
+ or %NULL if no such path exists. The returned string is owned by @file.</doc>
34039
+ <type name="filename" c:type="const char*"/>
34040
+ </return-value>
34041
+ <parameters>
34042
+ <instance-parameter name="file" transfer-ownership="none">
34043
+ <doc xml:space="preserve">input #GFile</doc>
34044
+ <type name="File" c:type="GFile*"/>
34045
+ </instance-parameter>
34046
+ </parameters>
34047
+ </method>
33732
34048
  <method name="poll_mountable"
33733
34049
  c:identifier="g_file_poll_mountable"
33734
34050
  version="2.22">
@@ -33832,7 +34148,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
33832
34148
  <doc xml:space="preserve">Utility function to check if a particular file exists. This is
33833
34149
  implemented using g_file_query_info() and as such does blocking I/O.
33834
34150
 
33835
- Note that in many cases it is racy to first check for file existence
34151
+ Note that in many cases it is [racy to first check for file existence](https://en.wikipedia.org/wiki/Time_of_check_to_time_of_use)
33836
34152
  and then execute something based on the outcome of that, because the
33837
34153
  file might have been created or removed in between the operations. The
33838
34154
  general approach to handling that is to not check, but just do the
@@ -34905,7 +35221,7 @@ This call does no blocking I/O.</doc>
34905
35221
  </instance-parameter>
34906
35222
  <parameter name="relative_path" transfer-ownership="none">
34907
35223
  <doc xml:space="preserve">a given relative path string</doc>
34908
- <type name="filename" c:type="char*"/>
35224
+ <type name="filename" c:type="const char*"/>
34909
35225
  </parameter>
34910
35226
  </parameters>
34911
35227
  </method>
@@ -34914,7 +35230,7 @@ This call does no blocking I/O.</doc>
34914
35230
  throws="1">
34915
35231
  <doc xml:space="preserve">Sets an attribute in the file with attribute name @attribute to @value.
34916
35232
 
34917
- Some attributes can be unset by setting @attribute to
35233
+ Some attributes can be unset by setting @type to
34918
35234
  %G_FILE_ATTRIBUTE_TYPE_INVALID and @value_p to %NULL.
34919
35235
 
34920
35236
  If @cancellable is not %NULL, then the operation can be cancelled by
@@ -38136,7 +38452,7 @@ to be used as icon.</doc>
38136
38452
  </parameter>
38137
38453
  <parameter name="relative_path" transfer-ownership="none">
38138
38454
  <doc xml:space="preserve">a given relative path string</doc>
38139
- <type name="filename" c:type="char*"/>
38455
+ <type name="filename" c:type="const char*"/>
38140
38456
  </parameter>
38141
38457
  </parameters>
38142
38458
  </callback>
@@ -39516,7 +39832,7 @@ to be used as icon.</doc>
39516
39832
  <parameter name="symlink_value" transfer-ownership="none">
39517
39833
  <doc xml:space="preserve">a string with the path for the target
39518
39834
  of the new symlink</doc>
39519
- <type name="filename" c:type="char*"/>
39835
+ <type name="filename" c:type="const char*"/>
39520
39836
  </parameter>
39521
39837
  <parameter name="cancellable"
39522
39838
  transfer-ownership="none"
@@ -41403,7 +41719,7 @@ in @result.</doc>
41403
41719
  <doc xml:space="preserve">Gets the name for a file.</doc>
41404
41720
  <return-value transfer-ownership="none">
41405
41721
  <doc xml:space="preserve">a string containing the file name.</doc>
41406
- <type name="filename" c:type="char*"/>
41722
+ <type name="filename" c:type="const char*"/>
41407
41723
  </return-value>
41408
41724
  <parameters>
41409
41725
  <instance-parameter name="info" transfer-ownership="none">
@@ -41974,7 +42290,7 @@ See %G_FILE_ATTRIBUTE_STANDARD_NAME.</doc>
41974
42290
  </instance-parameter>
41975
42291
  <parameter name="name" transfer-ownership="none">
41976
42292
  <doc xml:space="preserve">a string containing a name.</doc>
41977
- <type name="filename" c:type="char*"/>
42293
+ <type name="filename" c:type="const char*"/>
41978
42294
  </parameter>
41979
42295
  </parameters>
41980
42296
  </method>
@@ -43660,7 +43976,8 @@ should be read, or %FALSE otherwise.</doc>
43660
43976
  <parameter name="callback_data"
43661
43977
  transfer-ownership="none"
43662
43978
  nullable="1"
43663
- allow-none="1">
43979
+ allow-none="1"
43980
+ closure="2">
43664
43981
  <doc xml:space="preserve">data passed to the callback.</doc>
43665
43982
  <type name="gpointer" c:type="gpointer"/>
43666
43983
  </parameter>
@@ -44624,7 +44941,7 @@ or %NULL on error.</doc>
44624
44941
  <parameters>
44625
44942
  <parameter name="filename" transfer-ownership="none">
44626
44943
  <doc xml:space="preserve">filename of the shared library module.</doc>
44627
- <type name="filename" c:type="gchar*"/>
44944
+ <type name="filename" c:type="const gchar*"/>
44628
44945
  </parameter>
44629
44946
  </parameters>
44630
44947
  </constructor>
@@ -44651,7 +44968,15 @@ points actually implemented must be returned by g_io_module_query()
44651
44968
 
44652
44969
  When installing a module that implements g_io_module_query() you must
44653
44970
  run gio-querymodules in order to build the cache files required for
44654
- lazy loading.</doc>
44971
+ lazy loading.
44972
+
44973
+ Since 2.56, this function should be named `g_io_&lt;modulename&gt;_query`, where
44974
+ `modulename` is the plugin’s filename with the `lib` or `libgio` prefix and
44975
+ everything after the first dot removed, and with `-` replaced with `_`
44976
+ throughout. For example, `libgiognutls-helper.so` becomes `gnutls_helper`.
44977
+ Using the new symbol names avoids name clashes when building modules
44978
+ statically. The old symbol names continue to be supported, but cannot be used
44979
+ for static builds.</doc>
44655
44980
  <return-value transfer-ownership="full">
44656
44981
  <doc xml:space="preserve">A %NULL-terminated array of strings,
44657
44982
  listing the supported extension points of the module. The array
@@ -44666,7 +44991,15 @@ lazy loading.</doc>
44666
44991
 
44667
44992
  This function is run after the module has been loaded into GIO,
44668
44993
  to initialize the module. Typically, this function will call
44669
- g_io_extension_point_implement().</doc>
44994
+ g_io_extension_point_implement().
44995
+
44996
+ Since 2.56, this function should be named `g_io_&lt;modulename&gt;_load`, where
44997
+ `modulename` is the plugin’s filename with the `lib` or `libgio` prefix and
44998
+ everything after the first dot removed, and with `-` replaced with `_`
44999
+ throughout. For example, `libgiognutls-helper.so` becomes `gnutls_helper`.
45000
+ Using the new symbol names avoids name clashes when building modules
45001
+ statically. The old symbol names continue to be supported, but cannot be used
45002
+ for static builds.</doc>
44670
45003
  <return-value transfer-ownership="none">
44671
45004
  <type name="none" c:type="void"/>
44672
45005
  </return-value>
@@ -44681,7 +45014,15 @@ g_io_extension_point_implement().</doc>
44681
45014
  <doc xml:space="preserve">Required API for GIO modules to implement.
44682
45015
 
44683
45016
  This function is run when the module is being unloaded from GIO,
44684
- to finalize the module.</doc>
45017
+ to finalize the module.
45018
+
45019
+ Since 2.56, this function should be named `g_io_&lt;modulename&gt;_unload`, where
45020
+ `modulename` is the plugin’s filename with the `lib` or `libgio` prefix and
45021
+ everything after the first dot removed, and with `-` replaced with `_`
45022
+ throughout. For example, `libgiognutls-helper.so` becomes `gnutls_helper`.
45023
+ Using the new symbol names avoids name clashes when building modules
45024
+ statically. The old symbol names continue to be supported, but cannot be used
45025
+ for static builds.</doc>
44685
45026
  <return-value transfer-ownership="none">
44686
45027
  <type name="none" c:type="void"/>
44687
45028
  </return-value>
@@ -48589,15 +48930,23 @@ thread in which it is appropriate to use it depends on the particular
48589
48930
  implementation, but typically it will be from the thread that owns
48590
48931
  the [thread-default main context][g-main-context-push-thread-default]
48591
48932
  in effect at the time that the model was created.</doc>
48592
- <virtual-method name="get_item">
48593
- <return-value transfer-ownership="none" nullable="1">
48594
- <type name="gpointer" c:type="gpointer"/>
48933
+ <virtual-method name="get_item" version="2.44">
48934
+ <doc xml:space="preserve">Get the item at @position. If @position is greater than the number of
48935
+ items in @list, %NULL is returned.
48936
+
48937
+ %NULL is never returned for an index that is smaller than the length
48938
+ of the list. See g_list_model_get_n_items().</doc>
48939
+ <return-value transfer-ownership="full" nullable="1">
48940
+ <doc xml:space="preserve">the object at @position.</doc>
48941
+ <type name="GObject.Object" c:type="gpointer"/>
48595
48942
  </return-value>
48596
48943
  <parameters>
48597
48944
  <instance-parameter name="list" transfer-ownership="none">
48945
+ <doc xml:space="preserve">a #GListModel</doc>
48598
48946
  <type name="ListModel" c:type="GListModel*"/>
48599
48947
  </instance-parameter>
48600
48948
  <parameter name="position" transfer-ownership="none">
48949
+ <doc xml:space="preserve">the position of the item to fetch</doc>
48601
48950
  <type name="guint" c:type="guint"/>
48602
48951
  </parameter>
48603
48952
  </parameters>
@@ -48651,7 +49000,7 @@ items in @list, %NULL is returned.
48651
49000
  of the list. See g_list_model_get_n_items().</doc>
48652
49001
  <return-value transfer-ownership="full" nullable="1">
48653
49002
  <doc xml:space="preserve">the item at @position.</doc>
48654
- <type name="GObject.Object" c:type="gpointer"/>
49003
+ <type name="gpointer" c:type="gpointer"/>
48655
49004
  </return-value>
48656
49005
  <parameters>
48657
49006
  <instance-parameter name="list" transfer-ownership="none">
@@ -48834,14 +49183,17 @@ were added in their place.</doc>
48834
49183
  </field>
48835
49184
  <field name="get_item">
48836
49185
  <callback name="get_item">
48837
- <return-value transfer-ownership="none" nullable="1">
48838
- <type name="gpointer" c:type="gpointer"/>
49186
+ <return-value transfer-ownership="full" nullable="1">
49187
+ <doc xml:space="preserve">the object at @position.</doc>
49188
+ <type name="GObject.Object" c:type="gpointer"/>
48839
49189
  </return-value>
48840
49190
  <parameters>
48841
49191
  <parameter name="list" transfer-ownership="none">
49192
+ <doc xml:space="preserve">a #GListModel</doc>
48842
49193
  <type name="ListModel" c:type="GListModel*"/>
48843
49194
  </parameter>
48844
49195
  <parameter name="position" transfer-ownership="none">
49196
+ <doc xml:space="preserve">the position of the item to fetch</doc>
48845
49197
  <type name="guint" c:type="guint"/>
48846
49198
  </parameter>
48847
49199
  </parameters>
@@ -52211,9 +52563,9 @@ and #GTask. To unmount a #GMount instance, first call
52211
52563
  g_mount_unmount_with_operation() with (at least) the #GMount instance and a
52212
52564
  #GAsyncReadyCallback. The callback will be fired when the
52213
52565
  operation has resolved (either with success or failure), and a
52214
- #GAsyncReady structure will be passed to the callback. That
52566
+ #GAsyncResult structure will be passed to the callback. That
52215
52567
  callback should then call g_mount_unmount_with_operation_finish() with the #GMount
52216
- and the #GAsyncReady data to see if the operation was completed
52568
+ and the #GAsyncResult data to see if the operation was completed
52217
52569
  successfully. If an @error is present when g_mount_unmount_with_operation_finish()
52218
52570
  is called, then it will be filled with any error information.</doc>
52219
52571
  <virtual-method name="can_eject" invoker="can_eject">
@@ -53616,8 +53968,11 @@ will need to emit the #GMount::changed signal on @mount manually.</doc>
53616
53968
  </return-value>
53617
53969
  </glib:signal>
53618
53970
  <glib:signal name="pre-unmount" when="last" version="2.22">
53619
- <doc xml:space="preserve">This signal is emitted when the #GMount is about to be
53620
- unmounted.</doc>
53971
+ <doc xml:space="preserve">This signal may be emitted when the #GMount is about to be
53972
+ unmounted.
53973
+
53974
+ This signal depends on the backend and is only emitted if
53975
+ GIO was used to unmount.</doc>
53621
53976
  <return-value transfer-ownership="none">
53622
53977
  <type name="none" c:type="void"/>
53623
53978
  </return-value>
@@ -54343,7 +54698,9 @@ passed, see each method taking a #GMountOperation for details.</doc>
54343
54698
  <type name="utf8" c:type="const char*"/>
54344
54699
  </parameter>
54345
54700
  <parameter name="choices" transfer-ownership="none">
54346
- <type name="utf8" c:type="const char*"/>
54701
+ <array c:type="char*">
54702
+ <type name="utf8"/>
54703
+ </array>
54347
54704
  </parameter>
54348
54705
  </parameters>
54349
54706
  </virtual-method>
@@ -54363,7 +54720,7 @@ passed, see each method taking a #GMountOperation for details.</doc>
54363
54720
  </parameter>
54364
54721
  </parameters>
54365
54722
  </virtual-method>
54366
- <virtual-method name="show_processes" introspectable="0">
54723
+ <virtual-method name="show_processes" version="2.22">
54367
54724
  <return-value transfer-ownership="none">
54368
54725
  <type name="none" c:type="void"/>
54369
54726
  </return-value>
@@ -54376,11 +54733,13 @@ passed, see each method taking a #GMountOperation for details.</doc>
54376
54733
  </parameter>
54377
54734
  <parameter name="processes" transfer-ownership="none">
54378
54735
  <array name="GLib.Array" c:type="GArray*">
54379
- <type name="gpointer" c:type="gpointer"/>
54736
+ <type name="GLib.Pid"/>
54380
54737
  </array>
54381
54738
  </parameter>
54382
54739
  <parameter name="choices" transfer-ownership="none">
54383
- <type name="utf8" c:type="const gchar*"/>
54740
+ <array c:type="gchar*">
54741
+ <type name="utf8"/>
54742
+ </array>
54384
54743
  </parameter>
54385
54744
  </parameters>
54386
54745
  </virtual-method>
@@ -54827,7 +55186,9 @@ primary text in a #GtkMessageDialog.</doc>
54827
55186
  <type name="utf8" c:type="const char*"/>
54828
55187
  </parameter>
54829
55188
  <parameter name="choices" transfer-ownership="none">
54830
- <type name="utf8" c:type="const char*"/>
55189
+ <array c:type="char*">
55190
+ <type name="utf8"/>
55191
+ </array>
54831
55192
  </parameter>
54832
55193
  </parameters>
54833
55194
  </callback>
@@ -54862,8 +55223,8 @@ primary text in a #GtkMessageDialog.</doc>
54862
55223
  </parameters>
54863
55224
  </callback>
54864
55225
  </field>
54865
- <field name="show_processes" introspectable="0">
54866
- <callback name="show_processes" introspectable="0">
55226
+ <field name="show_processes">
55227
+ <callback name="show_processes">
54867
55228
  <return-value transfer-ownership="none">
54868
55229
  <type name="none" c:type="void"/>
54869
55230
  </return-value>
@@ -54876,11 +55237,13 @@ primary text in a #GtkMessageDialog.</doc>
54876
55237
  </parameter>
54877
55238
  <parameter name="processes" transfer-ownership="none">
54878
55239
  <array name="GLib.Array" c:type="GArray*">
54879
- <type name="gpointer" c:type="gpointer"/>
55240
+ <type name="GLib.Pid"/>
54880
55241
  </array>
54881
55242
  </parameter>
54882
55243
  <parameter name="choices" transfer-ownership="none">
54883
- <type name="utf8" c:type="const gchar*"/>
55244
+ <array c:type="gchar*">
55245
+ <type name="utf8"/>
55246
+ </array>
54884
55247
  </parameter>
54885
55248
  </parameters>
54886
55249
  </callback>
@@ -55157,7 +55520,7 @@ If no port is specified in @host_and_port then @default_port will be
55157
55520
  used as the port number to connect to.
55158
55521
 
55159
55522
  In general, @host_and_port is expected to be provided by the user
55160
- (allowing them to give the hostname, and a port overide if necessary)
55523
+ (allowing them to give the hostname, and a port override if necessary)
55161
55524
  and @default_port is expected to be provided by the application.
55162
55525
 
55163
55526
  (The port component of @host_and_port can also be specified as a
@@ -55468,7 +55831,7 @@ See g_network_monitor_can_reach_async().</doc>
55468
55831
  <instance-parameter name="monitor" transfer-ownership="none">
55469
55832
  <type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
55470
55833
  </instance-parameter>
55471
- <parameter name="available" transfer-ownership="none">
55834
+ <parameter name="network_available" transfer-ownership="none">
55472
55835
  <type name="gboolean" c:type="gboolean"/>
55473
55836
  </parameter>
55474
55837
  </parameters>
@@ -55703,16 +56066,12 @@ See also #GNetworkMonitor:network-available.</doc>
55703
56066
  <type name="gboolean" c:type="gboolean"/>
55704
56067
  </property>
55705
56068
  <glib:signal name="network-changed" when="last" version="2.32">
55706
- <doc xml:space="preserve">Emitted when the network configuration changes. If @available is
55707
- %TRUE, then some hosts may be reachable that were not reachable
55708
- before, while others that were reachable before may no longer be
55709
- reachable. If @available is %FALSE, then no remote hosts are
55710
- reachable.</doc>
56069
+ <doc xml:space="preserve">Emitted when the network configuration changes.</doc>
55711
56070
  <return-value transfer-ownership="none">
55712
56071
  <type name="none" c:type="void"/>
55713
56072
  </return-value>
55714
56073
  <parameters>
55715
- <parameter name="available" transfer-ownership="none">
56074
+ <parameter name="network_available" transfer-ownership="none">
55716
56075
  <doc xml:space="preserve">the current value of #GNetworkMonitor:network-available</doc>
55717
56076
  <type name="gboolean" c:type="gboolean"/>
55718
56077
  </parameter>
@@ -55737,7 +56096,7 @@ reachable.</doc>
55737
56096
  <parameter name="monitor" transfer-ownership="none">
55738
56097
  <type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
55739
56098
  </parameter>
55740
- <parameter name="available" transfer-ownership="none">
56099
+ <parameter name="network_available" transfer-ownership="none">
55741
56100
  <type name="gboolean" c:type="gboolean"/>
55742
56101
  </parameter>
55743
56102
  </parameters>
@@ -56320,8 +56679,12 @@ was sent on is activated.</doc>
56320
56679
  </method>
56321
56680
  <method name="set_urgent"
56322
56681
  c:identifier="g_notification_set_urgent"
56323
- version="2.40">
56682
+ version="2.40"
56683
+ deprecated="1"
56684
+ deprecated-version="2.42">
56324
56685
  <doc xml:space="preserve">Deprecated in favor of g_notification_set_priority().</doc>
56686
+ <doc-deprecated xml:space="preserve">Since 2.42, this has been deprecated in favour of
56687
+ g_notification_set_priority().</doc-deprecated>
56325
56688
  <return-value transfer-ownership="none">
56326
56689
  <type name="none" c:type="void"/>
56327
56690
  </return-value>
@@ -57161,7 +57524,9 @@ or g_output_stream_write_all().</doc>
57161
57524
  <parameter name="bytes_written"
57162
57525
  direction="out"
57163
57526
  caller-allocates="0"
57164
- transfer-ownership="full">
57527
+ transfer-ownership="full"
57528
+ optional="1"
57529
+ allow-none="1">
57165
57530
  <doc xml:space="preserve">location to store the number of bytes that was
57166
57531
  written to the stream</doc>
57167
57532
  <type name="gsize" c:type="gsize*"/>
@@ -57341,7 +57706,9 @@ or g_output_stream_write_all().</doc>
57341
57706
  <parameter name="bytes_written"
57342
57707
  direction="out"
57343
57708
  caller-allocates="0"
57344
- transfer-ownership="full">
57709
+ transfer-ownership="full"
57710
+ optional="1"
57711
+ allow-none="1">
57345
57712
  <doc xml:space="preserve">location to store the number of bytes that was
57346
57713
  written to the stream</doc>
57347
57714
  <type name="gsize" c:type="gsize*"/>
@@ -57460,7 +57827,9 @@ g_output_stream_write().</doc>
57460
57827
  <parameter name="bytes_written"
57461
57828
  direction="out"
57462
57829
  caller-allocates="0"
57463
- transfer-ownership="full">
57830
+ transfer-ownership="full"
57831
+ optional="1"
57832
+ allow-none="1">
57464
57833
  <doc xml:space="preserve">location to store the number of bytes that was
57465
57834
  written to the stream</doc>
57466
57835
  <type name="gsize" c:type="gsize*"/>
@@ -57569,7 +57938,9 @@ g_output_stream_write_async().</doc>
57569
57938
  <parameter name="bytes_written"
57570
57939
  direction="out"
57571
57940
  caller-allocates="0"
57572
- transfer-ownership="full">
57941
+ transfer-ownership="full"
57942
+ optional="1"
57943
+ allow-none="1">
57573
57944
  <doc xml:space="preserve">location to store the number of bytes that was written to the stream</doc>
57574
57945
  <type name="gsize" c:type="gsize*"/>
57575
57946
  </parameter>
@@ -59449,7 +59820,10 @@ Note that since this method never blocks, you cannot actually
59449
59820
  use @cancellable to cancel it. However, it will return an error
59450
59821
  if @cancellable has already been cancelled when you call, which
59451
59822
  may happen if you call this method after a source triggers due
59452
- to having been cancelled.</doc>
59823
+ to having been cancelled.
59824
+
59825
+ Also note that if %G_IO_ERROR_WOULD_BLOCK is returned some underlying
59826
+ transports like D/TLS require that you send the same @buffer and @count.</doc>
59453
59827
  <return-value transfer-ownership="none">
59454
59828
  <doc xml:space="preserve">the number of bytes written, or -1 on error (including
59455
59829
  %G_IO_ERROR_WOULD_BLOCK).</doc>
@@ -59564,7 +59938,10 @@ Note that since this method never blocks, you cannot actually
59564
59938
  use @cancellable to cancel it. However, it will return an error
59565
59939
  if @cancellable has already been cancelled when you call, which
59566
59940
  may happen if you call this method after a source triggers due
59567
- to having been cancelled.</doc>
59941
+ to having been cancelled.
59942
+
59943
+ Also note that if %G_IO_ERROR_WOULD_BLOCK is returned some underlying
59944
+ transports like D/TLS require that you send the same @buffer and @count.</doc>
59568
59945
  <return-value transfer-ownership="none">
59569
59946
  <doc xml:space="preserve">the number of bytes written, or -1 on error (including
59570
59947
  %G_IO_ERROR_WOULD_BLOCK).</doc>
@@ -60398,7 +60775,7 @@ if the creator didn't specify this).</doc>
60398
60775
  glib:get-type="g_proxy_address_enumerator_get_type"
60399
60776
  glib:type-struct="ProxyAddressEnumeratorClass">
60400
60777
  <doc xml:space="preserve">A subclass of #GSocketAddressEnumerator that takes another address
60401
- enumerator and wraps its results in #GProxyAddress&lt;!-- --&gt;es as
60778
+ enumerator and wraps its results in #GProxyAddresses as
60402
60779
  directed by the default #GProxyResolver.</doc>
60403
60780
  <property name="connectable"
60404
60781
  writable="1"
@@ -62972,7 +63349,11 @@ This will keep a reference to @data while the resource lives, so
62972
63349
  the data should not be modified or freed.
62973
63350
 
62974
63351
  If you want to use this resource in the global resource namespace you need
62975
- to register it with g_resources_register().</doc>
63352
+ to register it with g_resources_register().
63353
+
63354
+ Note: @data must be backed by memory that is at least pointer aligned.
63355
+ Otherwise this function will internally create a copy of the memory since
63356
+ GLib 2.56, or in older versions fail and exit the process.</doc>
62976
63357
  <return-value transfer-ownership="full">
62977
63358
  <doc xml:space="preserve">a new #GResource, or %NULL on error</doc>
62978
63359
  <type name="Resource" c:type="GResource*"/>
@@ -63207,7 +63588,7 @@ to register it with g_resources_register().</doc>
63207
63588
  <parameters>
63208
63589
  <parameter name="filename" transfer-ownership="none">
63209
63590
  <doc xml:space="preserve">the path of a filename to load, in the GLib filename encoding</doc>
63210
- <type name="filename" c:type="gchar*"/>
63591
+ <type name="filename" c:type="const gchar*"/>
63211
63592
  </parameter>
63212
63593
  </parameters>
63213
63594
  </function>
@@ -63315,7 +63696,8 @@ usually cause the stream to resize by introducing zero bytes.</doc>
63315
63696
  </parameters>
63316
63697
  </virtual-method>
63317
63698
  <virtual-method name="can_truncate" invoker="can_truncate">
63318
- <doc xml:space="preserve">Tests if the stream can be truncated.</doc>
63699
+ <doc xml:space="preserve">Tests if the length of the stream can be adjusted with
63700
+ g_seekable_truncate().</doc>
63319
63701
  <return-value transfer-ownership="none">
63320
63702
  <doc xml:space="preserve">%TRUE if the stream can be truncated, %FALSE otherwise.</doc>
63321
63703
  <type name="gboolean" c:type="gboolean"/>
@@ -63384,7 +63766,9 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
63384
63766
  </parameters>
63385
63767
  </virtual-method>
63386
63768
  <virtual-method name="truncate_fn" invoker="truncate" throws="1">
63387
- <doc xml:space="preserve">Truncates a stream with a given #offset.
63769
+ <doc xml:space="preserve">Sets the length of the stream to @offset. If the stream was previously
63770
+ larger than @offset, the extra data is discarded. If the stream was
63771
+ previouly shorter than @offset, it is extended with NUL ('\0') bytes.
63388
63772
 
63389
63773
  If @cancellable is not %NULL, then the operation can be cancelled by
63390
63774
  triggering the cancellable object from another thread. If the operation
@@ -63403,7 +63787,7 @@ partial result will be returned, without an error.</doc>
63403
63787
  <type name="Seekable" c:type="GSeekable*"/>
63404
63788
  </instance-parameter>
63405
63789
  <parameter name="offset" transfer-ownership="none">
63406
- <doc xml:space="preserve">a #goffset.</doc>
63790
+ <doc xml:space="preserve">new length for @seekable, in bytes.</doc>
63407
63791
  <type name="gint64" c:type="goffset"/>
63408
63792
  </parameter>
63409
63793
  <parameter name="cancellable"
@@ -63429,7 +63813,8 @@ partial result will be returned, without an error.</doc>
63429
63813
  </parameters>
63430
63814
  </method>
63431
63815
  <method name="can_truncate" c:identifier="g_seekable_can_truncate">
63432
- <doc xml:space="preserve">Tests if the stream can be truncated.</doc>
63816
+ <doc xml:space="preserve">Tests if the length of the stream can be adjusted with
63817
+ g_seekable_truncate().</doc>
63433
63818
  <return-value transfer-ownership="none">
63434
63819
  <doc xml:space="preserve">%TRUE if the stream can be truncated, %FALSE otherwise.</doc>
63435
63820
  <type name="gboolean" c:type="gboolean"/>
@@ -63498,7 +63883,9 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
63498
63883
  </parameters>
63499
63884
  </method>
63500
63885
  <method name="truncate" c:identifier="g_seekable_truncate" throws="1">
63501
- <doc xml:space="preserve">Truncates a stream with a given #offset.
63886
+ <doc xml:space="preserve">Sets the length of the stream to @offset. If the stream was previously
63887
+ larger than @offset, the extra data is discarded. If the stream was
63888
+ previouly shorter than @offset, it is extended with NUL ('\0') bytes.
63502
63889
 
63503
63890
  If @cancellable is not %NULL, then the operation can be cancelled by
63504
63891
  triggering the cancellable object from another thread. If the operation
@@ -63517,7 +63904,7 @@ partial result will be returned, without an error.</doc>
63517
63904
  <type name="Seekable" c:type="GSeekable*"/>
63518
63905
  </instance-parameter>
63519
63906
  <parameter name="offset" transfer-ownership="none">
63520
- <doc xml:space="preserve">a #goffset.</doc>
63907
+ <doc xml:space="preserve">new length for @seekable, in bytes.</doc>
63521
63908
  <type name="gint64" c:type="goffset"/>
63522
63909
  </parameter>
63523
63910
  <parameter name="cancellable"
@@ -63625,7 +64012,7 @@ partial result will be returned, without an error.</doc>
63625
64012
  <type name="Seekable" c:type="GSeekable*"/>
63626
64013
  </parameter>
63627
64014
  <parameter name="offset" transfer-ownership="none">
63628
- <doc xml:space="preserve">a #goffset.</doc>
64015
+ <doc xml:space="preserve">new length for @seekable, in bytes.</doc>
63629
64016
  <type name="gint64" c:type="goffset"/>
63630
64017
  </parameter>
63631
64018
  <parameter name="cancellable"
@@ -63670,7 +64057,7 @@ When creating a GSettings instance, you have to specify a schema
63670
64057
  that describes the keys in your settings and their types and default
63671
64058
  values, as well as some other information.
63672
64059
 
63673
- Normally, a schema has as fixed path that determines where the settings
64060
+ Normally, a schema has a fixed path that determines where the settings
63674
64061
  are stored in the conceptual global tree of settings. However, schemas
63675
64062
  can also be '[relocatable][gsettings-relocatable]', i.e. not equipped with
63676
64063
  a fixed path. This is
@@ -64087,7 +64474,7 @@ characters.</doc>
64087
64474
  version="2.28"
64088
64475
  deprecated="1"
64089
64476
  deprecated-version="2.40">
64090
- <doc xml:space="preserve">&lt;!-- --&gt;</doc>
64477
+ <doc xml:space="preserve">Deprecated.</doc>
64091
64478
  <doc-deprecated xml:space="preserve">Use g_settings_schema_source_list_schemas() instead</doc-deprecated>
64092
64479
  <return-value transfer-ownership="none">
64093
64480
  <doc xml:space="preserve">a list of relocatable
@@ -64103,7 +64490,7 @@ characters.</doc>
64103
64490
  version="2.26"
64104
64491
  deprecated="1"
64105
64492
  deprecated-version="2.40">
64106
- <doc xml:space="preserve">&lt;!-- --&gt;</doc>
64493
+ <doc xml:space="preserve">Deprecated.</doc>
64107
64494
  <doc-deprecated xml:space="preserve">Use g_settings_schema_source_list_schemas() instead.
64108
64495
  If you used g_settings_list_schemas() to check for the presence of
64109
64496
  a particular schema, use g_settings_schema_source_lookup() instead
@@ -64239,7 +64626,7 @@ function also establishes a binding between the writability of
64239
64626
  a boolean property by that name). See g_settings_bind_writable()
64240
64627
  for more details about writable bindings.
64241
64628
 
64242
- Note that the lifecycle of the binding is tied to the object,
64629
+ Note that the lifecycle of the binding is tied to @object,
64243
64630
  and that you can have only one binding per object property.
64244
64631
  If you bind the same property twice on the same object, the second
64245
64632
  binding overrides the first one.</doc>
@@ -64279,7 +64666,7 @@ and the property @property of @object.
64279
64666
  The binding uses the provided mapping functions to map between
64280
64667
  settings and property values.
64281
64668
 
64282
- Note that the lifecycle of the binding is tied to the object,
64669
+ Note that the lifecycle of the binding is tied to @object,
64283
64670
  and that you can have only one binding per object property.
64284
64671
  If you bind the same property twice on the same object, the second
64285
64672
  binding overrides the first one.</doc>
@@ -64352,7 +64739,7 @@ When the @inverted argument is %TRUE, the binding inverts the
64352
64739
  value as it passes from the setting to the object, i.e. @property
64353
64740
  will be set to %TRUE if the key is not writable.
64354
64741
 
64355
- Note that the lifecycle of the binding is tied to the object,
64742
+ Note that the lifecycle of the binding is tied to @object,
64356
64743
  and that you can have only one binding per object property.
64357
64744
  If you bind the same property twice on the same object, the second
64358
64745
  binding overrides the first one.</doc>
@@ -65439,6 +65826,7 @@ If @value is floating then this function consumes the reference.</doc>
65439
65826
  writable="1"
65440
65827
  construct-only="1"
65441
65828
  transfer-ownership="none">
65829
+ <doc xml:space="preserve">The name of the context that the settings are stored in.</doc>
65442
65830
  <type name="SettingsBackend"/>
65443
65831
  </property>
65444
65832
  <property name="delay-apply" version="2.28" transfer-ownership="none">
@@ -65635,12 +66023,12 @@ The semantics of the interface are very precisely defined and
65635
66023
  implementations must carefully adhere to the expectations of
65636
66024
  callers that are documented on each of the interface methods.
65637
66025
 
65638
- Some of the GSettingsBackend functions accept or return a #GTree.
66026
+ Some of the #GSettingsBackend functions accept or return a #GTree.
65639
66027
  These trees always have strings as keys and #GVariant as values.
65640
66028
  g_settings_backend_create_tree() is a convenience function to create
65641
66029
  suitable trees.
65642
66030
 
65643
- The GSettingsBackend API is exported to allow third-party
66031
+ The #GSettingsBackend API is exported to allow third-party
65644
66032
  implementations, but does not carry the same stability guarantees
65645
66033
  as the public GIO API. For this reason, you have to define the
65646
66034
  C preprocessor symbol %G_SETTINGS_ENABLE_BACKEND before including
@@ -66536,7 +66924,7 @@ initialise_plugin (const gchar *dir)
66536
66924
  ...
66537
66925
 
66538
66926
  plugin-&gt;schema_source =
66539
- g_settings_new_schema_source_from_directory (dir,
66927
+ g_settings_schema_source_new_from_directory (dir,
66540
66928
  g_settings_schema_source_get_default (), FALSE, NULL);
66541
66929
 
66542
66930
  ...
@@ -66997,7 +67385,7 @@ returned by g_settings_schema_source_get_default().</doc>
66997
67385
  <parameters>
66998
67386
  <parameter name="directory" transfer-ownership="none">
66999
67387
  <doc xml:space="preserve">the filename of a directory</doc>
67000
- <type name="filename" c:type="gchar*"/>
67388
+ <type name="filename" c:type="const gchar*"/>
67001
67389
  </parameter>
67002
67390
  <parameter name="parent"
67003
67391
  transfer-ownership="none"
@@ -67138,7 +67526,7 @@ from different directories, depending on which directories were given
67138
67526
  in `XDG_DATA_DIRS` and `GSETTINGS_SCHEMA_DIR`. For this reason, all
67139
67527
  lookups performed against the default source should probably be done
67140
67528
  recursively.</doc>
67141
- <return-value transfer-ownership="none">
67529
+ <return-value transfer-ownership="none" nullable="1">
67142
67530
  <doc xml:space="preserve">the default schema source</doc>
67143
67531
  <type name="SettingsSchemaSource" c:type="GSettingsSchemaSource*"/>
67144
67532
  </return-value>
@@ -67608,9 +67996,10 @@ g_simple_async_result_complete() will finish an I/O task directly
67608
67996
  from the point where it is called. g_simple_async_result_complete_in_idle()
67609
67997
  will finish it from an idle handler in the
67610
67998
  [thread-default main context][g-main-context-push-thread-default]
67611
- . g_simple_async_result_run_in_thread() will run the
67612
- job in a separate thread and then deliver the result to the
67613
- thread-default main context.
67999
+ where the #GSimpleAsyncResult was created.
68000
+ g_simple_async_result_run_in_thread() will run the job in a
68001
+ separate thread and then use
68002
+ g_simple_async_result_complete_in_idle() to deliver the result.
67614
68003
 
67615
68004
  To set the results of an asynchronous function,
67616
68005
  g_simple_async_result_set_op_res_gpointer(),
@@ -69464,7 +69853,7 @@ In case the protocol is unknown, -1 is returned.</doc>
69464
69853
  c:identifier="g_socket_get_remote_address"
69465
69854
  version="2.22"
69466
69855
  throws="1">
69467
- <doc xml:space="preserve">Try to get the remove address of a connected socket. This is only
69856
+ <doc xml:space="preserve">Try to get the remote address of a connected socket. This is only
69468
69857
  useful for connection oriented sockets that have been connected.</doc>
69469
69858
  <return-value transfer-ownership="full">
69470
69859
  <doc xml:space="preserve">a #GSocketAddress or %NULL on error.
@@ -69573,7 +69962,10 @@ to bind to based on @group.
69573
69962
 
69574
69963
  If @source_specific is %TRUE, source-specific multicast as defined
69575
69964
  in RFC 4604 is used. Note that on older platforms this may fail
69576
- with a %G_IO_ERROR_NOT_SUPPORTED error.</doc>
69965
+ with a %G_IO_ERROR_NOT_SUPPORTED error.
69966
+
69967
+ To bind to a given source-specific multicast address, use
69968
+ g_socket_join_multicast_group_ssm() instead.</doc>
69577
69969
  <return-value transfer-ownership="none">
69578
69970
  <doc xml:space="preserve">%TRUE on success, %FALSE on error.</doc>
69579
69971
  <type name="gboolean" c:type="gboolean"/>
@@ -69600,6 +69992,55 @@ with a %G_IO_ERROR_NOT_SUPPORTED error.</doc>
69600
69992
  </parameter>
69601
69993
  </parameters>
69602
69994
  </method>
69995
+ <method name="join_multicast_group_ssm"
69996
+ c:identifier="g_socket_join_multicast_group_ssm"
69997
+ version="2.56"
69998
+ throws="1">
69999
+ <doc xml:space="preserve">Registers @socket to receive multicast messages sent to @group.
70000
+ @socket must be a %G_SOCKET_TYPE_DATAGRAM socket, and must have
70001
+ been bound to an appropriate interface and port with
70002
+ g_socket_bind().
70003
+
70004
+ If @iface is %NULL, the system will automatically pick an interface
70005
+ to bind to based on @group.
70006
+
70007
+ If @source_specific is not %NULL, use source-specific multicast as
70008
+ defined in RFC 4604. Note that on older platforms this may fail
70009
+ with a %G_IO_ERROR_NOT_SUPPORTED error.
70010
+
70011
+ Note that this function can be called multiple times for the same
70012
+ @group with different @source_specific in order to receive multicast
70013
+ packets from more than one source.</doc>
70014
+ <return-value transfer-ownership="none">
70015
+ <doc xml:space="preserve">%TRUE on success, %FALSE on error.</doc>
70016
+ <type name="gboolean" c:type="gboolean"/>
70017
+ </return-value>
70018
+ <parameters>
70019
+ <instance-parameter name="socket" transfer-ownership="none">
70020
+ <doc xml:space="preserve">a #GSocket.</doc>
70021
+ <type name="Socket" c:type="GSocket*"/>
70022
+ </instance-parameter>
70023
+ <parameter name="group" transfer-ownership="none">
70024
+ <doc xml:space="preserve">a #GInetAddress specifying the group address to join.</doc>
70025
+ <type name="InetAddress" c:type="GInetAddress*"/>
70026
+ </parameter>
70027
+ <parameter name="source_specific"
70028
+ transfer-ownership="none"
70029
+ nullable="1"
70030
+ allow-none="1">
70031
+ <doc xml:space="preserve">a #GInetAddress specifying the
70032
+ source-specific multicast address or %NULL to ignore.</doc>
70033
+ <type name="InetAddress" c:type="GInetAddress*"/>
70034
+ </parameter>
70035
+ <parameter name="iface"
70036
+ transfer-ownership="none"
70037
+ nullable="1"
70038
+ allow-none="1">
70039
+ <doc xml:space="preserve">Name of the interface to use, or %NULL</doc>
70040
+ <type name="utf8" c:type="const gchar*"/>
70041
+ </parameter>
70042
+ </parameters>
70043
+ </method>
69603
70044
  <method name="leave_multicast_group"
69604
70045
  c:identifier="g_socket_leave_multicast_group"
69605
70046
  version="2.32"
@@ -69609,7 +70050,10 @@ and @source_specific (which must all have the same values they had
69609
70050
  when you joined the group).
69610
70051
 
69611
70052
  @socket remains bound to its address and port, and can still receive
69612
- unicast messages after calling this.</doc>
70053
+ unicast messages after calling this.
70054
+
70055
+ To unbind to a given source-specific multicast address, use
70056
+ g_socket_leave_multicast_group_ssm() instead.</doc>
69613
70057
  <return-value transfer-ownership="none">
69614
70058
  <doc xml:space="preserve">%TRUE on success, %FALSE on error.</doc>
69615
70059
  <type name="gboolean" c:type="gboolean"/>
@@ -69636,6 +70080,46 @@ unicast messages after calling this.</doc>
69636
70080
  </parameter>
69637
70081
  </parameters>
69638
70082
  </method>
70083
+ <method name="leave_multicast_group_ssm"
70084
+ c:identifier="g_socket_leave_multicast_group_ssm"
70085
+ version="2.56"
70086
+ throws="1">
70087
+ <doc xml:space="preserve">Removes @socket from the multicast group defined by @group, @iface,
70088
+ and @source_specific (which must all have the same values they had
70089
+ when you joined the group).
70090
+
70091
+ @socket remains bound to its address and port, and can still receive
70092
+ unicast messages after calling this.</doc>
70093
+ <return-value transfer-ownership="none">
70094
+ <doc xml:space="preserve">%TRUE on success, %FALSE on error.</doc>
70095
+ <type name="gboolean" c:type="gboolean"/>
70096
+ </return-value>
70097
+ <parameters>
70098
+ <instance-parameter name="socket" transfer-ownership="none">
70099
+ <doc xml:space="preserve">a #GSocket.</doc>
70100
+ <type name="Socket" c:type="GSocket*"/>
70101
+ </instance-parameter>
70102
+ <parameter name="group" transfer-ownership="none">
70103
+ <doc xml:space="preserve">a #GInetAddress specifying the group address to leave.</doc>
70104
+ <type name="InetAddress" c:type="GInetAddress*"/>
70105
+ </parameter>
70106
+ <parameter name="source_specific"
70107
+ transfer-ownership="none"
70108
+ nullable="1"
70109
+ allow-none="1">
70110
+ <doc xml:space="preserve">a #GInetAddress specifying the
70111
+ source-specific multicast address or %NULL to ignore.</doc>
70112
+ <type name="InetAddress" c:type="GInetAddress*"/>
70113
+ </parameter>
70114
+ <parameter name="iface"
70115
+ transfer-ownership="none"
70116
+ nullable="1"
70117
+ allow-none="1">
70118
+ <doc xml:space="preserve">Name of the interface to use, or %NULL</doc>
70119
+ <type name="utf8" c:type="const gchar*"/>
70120
+ </parameter>
70121
+ </parameters>
70122
+ </method>
69639
70123
  <method name="listen"
69640
70124
  c:identifier="g_socket_listen"
69641
70125
  version="2.22"
@@ -70955,7 +71439,7 @@ struct sockaddr</doc>
70955
71439
  glib:get-type="g_socket_address_enumerator_get_type"
70956
71440
  glib:type-struct="SocketAddressEnumeratorClass">
70957
71441
  <doc xml:space="preserve">Enumerator type for objects that contain or generate
70958
- #GSocketAddress&lt;!-- --&gt;es.</doc>
71442
+ #GSocketAddress instances.</doc>
70959
71443
  <virtual-method name="next" invoker="next" throws="1">
70960
71444
  <doc xml:space="preserve">Retrieves the next #GSocketAddress from @enumerator. Note that this
70961
71445
  may block for some amount of time. (Eg, a #GNetworkAddress may need
@@ -73474,7 +73958,7 @@ or g_socket_listener_add_inet_port().</doc>
73474
73958
  <type name="SocketListener" c:type="GSocketListener*"/>
73475
73959
  </instance-parameter>
73476
73960
  <parameter name="event" transfer-ownership="none">
73477
- <type name="SocketListenerEvent" c:type="GSocketListenerEvent*"/>
73961
+ <type name="SocketListenerEvent" c:type="GSocketListenerEvent"/>
73478
73962
  </parameter>
73479
73963
  <parameter name="socket" transfer-ownership="none">
73480
73964
  <type name="Socket" c:type="GSocket*"/>
@@ -73974,7 +74458,7 @@ the order they happen in is undefined.</doc>
73974
74458
  <type name="SocketListener" c:type="GSocketListener*"/>
73975
74459
  </parameter>
73976
74460
  <parameter name="event" transfer-ownership="none">
73977
- <type name="SocketListenerEvent" c:type="GSocketListenerEvent*"/>
74461
+ <type name="SocketListenerEvent" c:type="GSocketListenerEvent"/>
73978
74462
  </parameter>
73979
74463
  <parameter name="socket" transfer-ownership="none">
73980
74464
  <type name="Socket" c:type="GSocket*"/>
@@ -74794,7 +75278,7 @@ The argument list is expected to be %NULL-terminated.</doc>
74794
75278
  <parameter name="argv" transfer-ownership="none">
74795
75279
  <doc xml:space="preserve">commandline arguments for the subprocess</doc>
74796
75280
  <array c:type="gchar**">
74797
- <type name="utf8"/>
75281
+ <type name="filename"/>
74798
75282
  </array>
74799
75283
  </parameter>
74800
75284
  <parameter name="flags" transfer-ownership="none">
@@ -74874,14 +75358,20 @@ attempt to interact with the pipes while the operation is in progress
74874
75358
  <parameter name="stdout_buf"
74875
75359
  direction="out"
74876
75360
  caller-allocates="0"
74877
- transfer-ownership="full">
75361
+ transfer-ownership="full"
75362
+ nullable="1"
75363
+ optional="1"
75364
+ allow-none="1">
74878
75365
  <doc xml:space="preserve">data read from the subprocess stdout</doc>
74879
75366
  <type name="GLib.Bytes" c:type="GBytes**"/>
74880
75367
  </parameter>
74881
75368
  <parameter name="stderr_buf"
74882
75369
  direction="out"
74883
75370
  caller-allocates="0"
74884
- transfer-ownership="full">
75371
+ transfer-ownership="full"
75372
+ nullable="1"
75373
+ optional="1"
75374
+ allow-none="1">
74885
75375
  <doc xml:space="preserve">data read from the subprocess stderr</doc>
74886
75376
  <type name="GLib.Bytes" c:type="GBytes**"/>
74887
75377
  </parameter>
@@ -74950,14 +75440,20 @@ invocation with g_subprocess_communicate_finish().</doc>
74950
75440
  <parameter name="stdout_buf"
74951
75441
  direction="out"
74952
75442
  caller-allocates="0"
74953
- transfer-ownership="full">
75443
+ transfer-ownership="full"
75444
+ nullable="1"
75445
+ optional="1"
75446
+ allow-none="1">
74954
75447
  <doc xml:space="preserve">Return location for stdout data</doc>
74955
75448
  <type name="GLib.Bytes" c:type="GBytes**"/>
74956
75449
  </parameter>
74957
75450
  <parameter name="stderr_buf"
74958
75451
  direction="out"
74959
75452
  caller-allocates="0"
74960
- transfer-ownership="full">
75453
+ transfer-ownership="full"
75454
+ nullable="1"
75455
+ optional="1"
75456
+ allow-none="1">
74961
75457
  <doc xml:space="preserve">Return location for stderr data</doc>
74962
75458
  <type name="GLib.Bytes" c:type="GBytes**"/>
74963
75459
  </parameter>
@@ -74993,14 +75489,20 @@ process as UTF-8, and returns it as a regular NUL terminated string.</doc>
74993
75489
  <parameter name="stdout_buf"
74994
75490
  direction="out"
74995
75491
  caller-allocates="0"
74996
- transfer-ownership="full">
75492
+ transfer-ownership="full"
75493
+ nullable="1"
75494
+ optional="1"
75495
+ allow-none="1">
74997
75496
  <doc xml:space="preserve">data read from the subprocess stdout</doc>
74998
75497
  <type name="utf8" c:type="char**"/>
74999
75498
  </parameter>
75000
75499
  <parameter name="stderr_buf"
75001
75500
  direction="out"
75002
75501
  caller-allocates="0"
75003
- transfer-ownership="full">
75502
+ transfer-ownership="full"
75503
+ nullable="1"
75504
+ optional="1"
75505
+ allow-none="1">
75004
75506
  <doc xml:space="preserve">data read from the subprocess stderr</doc>
75005
75507
  <type name="utf8" c:type="char**"/>
75006
75508
  </parameter>
@@ -75069,14 +75571,20 @@ invocation with g_subprocess_communicate_utf8_finish().</doc>
75069
75571
  <parameter name="stdout_buf"
75070
75572
  direction="out"
75071
75573
  caller-allocates="0"
75072
- transfer-ownership="full">
75574
+ transfer-ownership="full"
75575
+ nullable="1"
75576
+ optional="1"
75577
+ allow-none="1">
75073
75578
  <doc xml:space="preserve">Return location for stdout data</doc>
75074
75579
  <type name="utf8" c:type="char**"/>
75075
75580
  </parameter>
75076
75581
  <parameter name="stderr_buf"
75077
75582
  direction="out"
75078
75583
  caller-allocates="0"
75079
- transfer-ownership="full">
75584
+ transfer-ownership="full"
75585
+ nullable="1"
75586
+ optional="1"
75587
+ allow-none="1">
75080
75588
  <doc xml:space="preserve">Return location for stderr data</doc>
75081
75589
  <type name="utf8" c:type="char**"/>
75082
75590
  </parameter>
@@ -75502,7 +76010,7 @@ g_subprocess_wait_async().</doc>
75502
76010
  c:type="GSubprocessFlags">
75503
76011
  <doc xml:space="preserve">Flags to define the behaviour of a #GSubprocess.
75504
76012
 
75505
- Note that the default for stdin is to redirect from /dev/null. For
76013
+ Note that the default for stdin is to redirect from `/dev/null`. For
75506
76014
  stdout and stderr the default are for them to inherit the
75507
76015
  corresponding descriptor from the calling process.
75508
76016
 
@@ -75543,7 +76051,7 @@ example, you may not request both %G_SUBPROCESS_FLAGS_STDOUT_PIPE and
75543
76051
  c:identifier="G_SUBPROCESS_FLAGS_STDOUT_SILENCE"
75544
76052
  glib:nick="stdout-silence">
75545
76053
  <doc xml:space="preserve">silence the stdout of the spawned
75546
- process (ie: redirect to /dev/null).</doc>
76054
+ process (ie: redirect to `/dev/null`).</doc>
75547
76055
  </member>
75548
76056
  <member name="stderr_pipe"
75549
76057
  value="16"
@@ -75558,7 +76066,7 @@ example, you may not request both %G_SUBPROCESS_FLAGS_STDOUT_PIPE and
75558
76066
  c:identifier="G_SUBPROCESS_FLAGS_STDERR_SILENCE"
75559
76067
  glib:nick="stderr-silence">
75560
76068
  <doc xml:space="preserve">silence the stderr of the spawned
75561
- process (ie: redirect to /dev/null).</doc>
76069
+ process (ie: redirect to `/dev/null`).</doc>
75562
76070
  </member>
75563
76071
  <member name="stderr_merge"
75564
76072
  value="64"
@@ -75620,8 +76128,9 @@ environment of processes launched from this launcher.
75620
76128
  On UNIX, the returned string can be an arbitrary byte string.
75621
76129
  On Windows, it will be UTF-8.</doc>
75622
76130
  <return-value transfer-ownership="none">
75623
- <doc xml:space="preserve">the value of the environment variable, %NULL if unset</doc>
75624
- <type name="utf8" c:type="const gchar*"/>
76131
+ <doc xml:space="preserve">the value of the environment variable,
76132
+ %NULL if unset</doc>
76133
+ <type name="filename" c:type="const gchar*"/>
75625
76134
  </return-value>
75626
76135
  <parameters>
75627
76136
  <instance-parameter name="self" transfer-ownership="none">
@@ -75630,7 +76139,7 @@ On Windows, it will be UTF-8.</doc>
75630
76139
  </instance-parameter>
75631
76140
  <parameter name="variable" transfer-ownership="none">
75632
76141
  <doc xml:space="preserve">the environment variable to get</doc>
75633
- <type name="utf8" c:type="const gchar*"/>
76142
+ <type name="filename" c:type="const gchar*"/>
75634
76143
  </parameter>
75635
76144
  </parameters>
75636
76145
  </method>
@@ -75652,7 +76161,7 @@ of the launching process at the time of launch.</doc>
75652
76161
  </instance-parameter>
75653
76162
  <parameter name="cwd" transfer-ownership="none">
75654
76163
  <doc xml:space="preserve">the cwd for launched processes</doc>
75655
- <type name="filename" c:type="gchar*"/>
76164
+ <type name="filename" c:type="const gchar*"/>
75656
76165
  </parameter>
75657
76166
  </parameters>
75658
76167
  </method>
@@ -75687,9 +76196,10 @@ On Windows, they should be in UTF-8.</doc>
75687
76196
  <type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
75688
76197
  </instance-parameter>
75689
76198
  <parameter name="env" transfer-ownership="none">
75690
- <doc xml:space="preserve">the replacement environment</doc>
76199
+ <doc xml:space="preserve">
76200
+ the replacement environment</doc>
75691
76201
  <array c:type="gchar**">
75692
- <type name="utf8" c:type="gchar*"/>
76202
+ <type name="filename"/>
75693
76203
  </array>
75694
76204
  </parameter>
75695
76205
  </parameters>
@@ -75741,12 +76251,13 @@ On Windows, they should be in UTF-8.</doc>
75741
76251
  <type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
75742
76252
  </instance-parameter>
75743
76253
  <parameter name="variable" transfer-ownership="none">
75744
- <doc xml:space="preserve">the environment variable to set, must not contain '='</doc>
75745
- <type name="utf8" c:type="const gchar*"/>
76254
+ <doc xml:space="preserve">the environment variable to set,
76255
+ must not contain '='</doc>
76256
+ <type name="filename" c:type="const gchar*"/>
75746
76257
  </parameter>
75747
76258
  <parameter name="value" transfer-ownership="none">
75748
76259
  <doc xml:space="preserve">the new value for the variable</doc>
75749
- <type name="utf8" c:type="const gchar*"/>
76260
+ <type name="filename" c:type="const gchar*"/>
75750
76261
  </parameter>
75751
76262
  <parameter name="overwrite" transfer-ownership="none">
75752
76263
  <doc xml:space="preserve">whether to change the variable if it already exists</doc>
@@ -75799,7 +76310,7 @@ On Windows, they should be in UTF-8.</doc>
75799
76310
  <parameter name="argv" transfer-ownership="none">
75800
76311
  <doc xml:space="preserve">Command line arguments</doc>
75801
76312
  <array c:type="gchar**">
75802
- <type name="utf8"/>
76313
+ <type name="filename"/>
75803
76314
  </array>
75804
76315
  </parameter>
75805
76316
  </parameters>
@@ -75821,8 +76332,9 @@ containing '='. On Windows, it should be in UTF-8.</doc>
75821
76332
  <type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
75822
76333
  </instance-parameter>
75823
76334
  <parameter name="variable" transfer-ownership="none">
75824
- <doc xml:space="preserve">the environment variable to unset, must not contain '='</doc>
75825
- <type name="utf8" c:type="const gchar*"/>
76335
+ <doc xml:space="preserve">the environment variable to unset,
76336
+ must not contain '='</doc>
76337
+ <type name="filename" c:type="const gchar*"/>
75826
76338
  </parameter>
75827
76339
  </parameters>
75828
76340
  </method>
@@ -75875,11 +76387,13 @@ task object around through your asynchronous operation.
75875
76387
  Eventually, you will call a method such as
75876
76388
  g_task_return_pointer() or g_task_return_error(), which will
75877
76389
  save the value you give it and then invoke the task's callback
75878
- function (waiting until the next iteration of the main
75879
- loop first, if necessary). The caller will pass the #GTask back
75880
- to the operation's finish function (as a #GAsyncResult), and
75881
- you can use g_task_propagate_pointer() or the like to extract
75882
- the return value.
76390
+ function in the
76391
+ [thread-default main context][g-main-context-push-thread-default]
76392
+ where it was created (waiting until the next iteration of the main
76393
+ loop first, if necessary). The caller will pass the #GTask back to
76394
+ the operation's finish function (as a #GAsyncResult), and you can
76395
+ can use g_task_propagate_pointer() or the like to extract the
76396
+ return value.
75883
76397
 
75884
76398
  Here is an example for using GTask as a GAsyncResult:
75885
76399
  |[&lt;!-- language="C" --&gt;
@@ -76118,9 +76632,10 @@ Here is an example for chained asynchronous operations:
76118
76632
  ## Asynchronous operations from synchronous ones
76119
76633
 
76120
76634
  You can use g_task_run_in_thread() to turn a synchronous
76121
- operation into an asynchronous one, by running it in a thread
76122
- which will then dispatch the result back to the caller's
76123
- #GMainContext when it completes.
76635
+ operation into an asynchronous one, by running it in a thread.
76636
+ When it completes, the result will be dispatched to the
76637
+ [thread-default main context][g-main-context-push-thread-default]
76638
+ where the #GTask was created.
76124
76639
 
76125
76640
  Running a task in a thread:
76126
76641
  |[&lt;!-- language="C" --&gt;
@@ -76332,7 +76847,7 @@ in several ways:
76332
76847
  whether the task's callback can be invoked directly, or
76333
76848
  if it needs to be sent to another #GMainContext, or delayed
76334
76849
  until the next iteration of the current #GMainContext.)
76335
- - The "finish" functions for #GTask-based operations are generally
76850
+ - The "finish" functions for #GTask based operations are generally
76336
76851
  much simpler than #GSimpleAsyncResult ones, normally consisting
76337
76852
  of only a single call to g_task_propagate_pointer() or the like.
76338
76853
  Since g_task_propagate_pointer() "steals" the return value from
@@ -76683,7 +77198,7 @@ g_task_set_return_on_cancel() for more details.</doc>
76683
77198
  version="2.36">
76684
77199
  <doc xml:space="preserve">Gets the source object from @task. Like
76685
77200
  g_async_result_get_source_object(), but does not ref the object.</doc>
76686
- <return-value transfer-ownership="none">
77201
+ <return-value transfer-ownership="none" nullable="1">
76687
77202
  <doc xml:space="preserve">@task's source object, or %NULL</doc>
76688
77203
  <type name="GObject.Object" c:type="gpointer"/>
76689
77204
  </return-value>
@@ -78104,7 +78619,7 @@ support is available, and vice-versa.</doc>
78104
78619
  <doc xml:space="preserve">Gets the #GType of @backend’s #GDtlsClientConnection implementation.</doc>
78105
78620
  <return-value transfer-ownership="none">
78106
78621
  <doc xml:space="preserve">the #GType of @backend’s #GDtlsClientConnection
78107
- implementation.</doc>
78622
+ implementation, or %G_TYPE_INVALID if this backend doesn’t support DTLS.</doc>
78108
78623
  <type name="GType" c:type="GType"/>
78109
78624
  </return-value>
78110
78625
  <parameters>
@@ -78120,7 +78635,7 @@ support is available, and vice-versa.</doc>
78120
78635
  <doc xml:space="preserve">Gets the #GType of @backend’s #GDtlsServerConnection implementation.</doc>
78121
78636
  <return-value transfer-ownership="none">
78122
78637
  <doc xml:space="preserve">the #GType of @backend’s #GDtlsServerConnection
78123
- implementation.</doc>
78638
+ implementation, or %G_TYPE_INVALID if this backend doesn’t support DTLS.</doc>
78124
78639
  <type name="GType" c:type="GType"/>
78125
78640
  </return-value>
78126
78641
  <parameters>
@@ -78327,7 +78842,7 @@ g_tls_certificate_new_from_pem().</doc>
78327
78842
  <parameters>
78328
78843
  <parameter name="file" transfer-ownership="none">
78329
78844
  <doc xml:space="preserve">file containing a PEM-encoded certificate to import</doc>
78330
- <type name="filename" c:type="gchar*"/>
78845
+ <type name="filename" c:type="const gchar*"/>
78331
78846
  </parameter>
78332
78847
  </parameters>
78333
78848
  </constructor>
@@ -78357,12 +78872,12 @@ g_tls_certificate_new_from_pem().</doc>
78357
78872
  <parameter name="cert_file" transfer-ownership="none">
78358
78873
  <doc xml:space="preserve">file containing one or more PEM-encoded
78359
78874
  certificates to import</doc>
78360
- <type name="filename" c:type="gchar*"/>
78875
+ <type name="filename" c:type="const gchar*"/>
78361
78876
  </parameter>
78362
78877
  <parameter name="key_file" transfer-ownership="none">
78363
78878
  <doc xml:space="preserve">file containing a PEM-encoded private key
78364
78879
  to import</doc>
78365
- <type name="filename" c:type="gchar*"/>
78880
+ <type name="filename" c:type="const gchar*"/>
78366
78881
  </parameter>
78367
78882
  </parameters>
78368
78883
  </constructor>
@@ -78419,7 +78934,7 @@ and its contents when you are done with it.</doc>
78419
78934
  <parameters>
78420
78935
  <parameter name="file" transfer-ownership="none">
78421
78936
  <doc xml:space="preserve">file containing PEM-encoded certificates to import</doc>
78422
- <type name="filename" c:type="gchar*"/>
78937
+ <type name="filename" c:type="const gchar*"/>
78423
78938
  </parameter>
78424
78939
  </parameters>
78425
78940
  </function>
@@ -78889,12 +79404,16 @@ known.</doc>
78889
79404
  </method>
78890
79405
  <method name="get_use_ssl3"
78891
79406
  c:identifier="g_tls_client_connection_get_use_ssl3"
78892
- version="2.28">
78893
- <doc xml:space="preserve">Gets whether @conn will use SSL 3.0 rather than the
78894
- highest-supported version of TLS; see
78895
- g_tls_client_connection_set_use_ssl3().</doc>
78896
- <return-value transfer-ownership="none">
78897
- <doc xml:space="preserve">whether @conn will use SSL 3.0</doc>
79407
+ version="2.28"
79408
+ deprecated="1"
79409
+ deprecated-version="2.56">
79410
+ <doc xml:space="preserve">Gets whether @conn will force the lowest-supported TLS protocol
79411
+ version rather than attempt to negotiate the highest mutually-
79412
+ supported version of TLS; see g_tls_client_connection_set_use_ssl3().</doc>
79413
+ <doc-deprecated xml:space="preserve">SSL 3.0 is insecure, and this function does not
79414
+ actually indicate whether it is enabled.</doc-deprecated>
79415
+ <return-value transfer-ownership="none">
79416
+ <doc xml:space="preserve">whether @conn will use the lowest-supported TLS protocol version</doc>
78898
79417
  <type name="gboolean" c:type="gboolean"/>
78899
79418
  </return-value>
78900
79419
  <parameters>
@@ -78942,12 +79461,19 @@ performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled.</doc>
78942
79461
  </method>
78943
79462
  <method name="set_use_ssl3"
78944
79463
  c:identifier="g_tls_client_connection_set_use_ssl3"
78945
- version="2.28">
78946
- <doc xml:space="preserve">If @use_ssl3 is %TRUE, this forces @conn to use SSL 3.0 rather than
78947
- trying to properly negotiate the right version of TLS or SSL to use.
78948
- This can be used when talking to servers that do not implement the
78949
- fallbacks correctly and which will therefore fail to handshake with
78950
- a "modern" TLS handshake attempt.</doc>
79464
+ version="2.28"
79465
+ deprecated="1"
79466
+ deprecated-version="2.56">
79467
+ <doc xml:space="preserve">If @use_ssl3 is %TRUE, this forces @conn to use the lowest-supported
79468
+ TLS protocol version rather than trying to properly negotiate the
79469
+ highest mutually-supported protocol version with the peer. This can
79470
+ be used when talking to broken TLS servers that exhibit protocol
79471
+ version intolerance.
79472
+
79473
+ Be aware that SSL 3.0 is generally disabled by the #GTlsBackend, so
79474
+ the lowest-supported protocol version is probably not SSL 3.0.</doc>
79475
+ <doc-deprecated xml:space="preserve">SSL 3.0 is insecure, and this function does not
79476
+ generally enable or disable it, despite its name.</doc-deprecated>
78951
79477
  <return-value transfer-ownership="none">
78952
79478
  <type name="none" c:type="void"/>
78953
79479
  </return-value>
@@ -78957,7 +79483,7 @@ a "modern" TLS handshake attempt.</doc>
78957
79483
  <type name="TlsClientConnection" c:type="GTlsClientConnection*"/>
78958
79484
  </instance-parameter>
78959
79485
  <parameter name="use_ssl3" transfer-ownership="none">
78960
- <doc xml:space="preserve">whether to use SSL 3.0</doc>
79486
+ <doc xml:space="preserve">whether to use the lowest-supported protocol version</doc>
78961
79487
  <type name="gboolean" c:type="gboolean"/>
78962
79488
  </parameter>
78963
79489
  </parameters>
@@ -79017,19 +79543,23 @@ virtual hosts.</doc>
79017
79543
  </property>
79018
79544
  <property name="use-ssl3"
79019
79545
  version="2.28"
79546
+ deprecated="1"
79547
+ deprecated-version="2.56"
79020
79548
  writable="1"
79021
79549
  construct="1"
79022
79550
  transfer-ownership="none">
79023
- <doc xml:space="preserve">If %TRUE, tells the connection to use a fallback version of TLS
79551
+ <doc xml:space="preserve">If %TRUE, forces the connection to use a fallback version of TLS
79024
79552
  or SSL, rather than trying to negotiate the best version of TLS
79025
79553
  to use. This can be used when talking to servers that don't
79026
79554
  implement version negotiation correctly and therefore refuse to
79027
- handshake at all with a "modern" TLS handshake.
79028
-
79029
- Despite the property name, the fallback version is not
79030
- necessarily SSL 3.0; if SSL 3.0 has been disabled, the
79031
- #GTlsClientConnection will use the next highest available version
79032
- (normally TLS 1.0) as the fallback version.</doc>
79555
+ handshake at all with a modern TLS handshake.
79556
+
79557
+ Despite the property name, the fallback version is usually not
79558
+ SSL 3.0, because SSL 3.0 is generally disabled by the #GTlsBackend.
79559
+ #GTlsClientConnection will use the next-highest available version
79560
+ as the fallback version.</doc>
79561
+ <doc-deprecated xml:space="preserve">SSL 3.0 is insecure, and this property does not
79562
+ generally enable or disable it, despite its name.</doc-deprecated>
79033
79563
  <type name="gboolean" c:type="gboolean"/>
79034
79564
  </property>
79035
79565
  <property name="validation-flags"
@@ -80090,7 +80620,7 @@ g_tls_database_lookup_certificate_for_handle() for more information.</doc>
80090
80620
  version="2.30"
80091
80621
  throws="1">
80092
80622
  <doc xml:space="preserve">Finish an asynchronous lookup of a certificate by its handle. See
80093
- g_tls_database_lookup_certificate_handle() for more information.
80623
+ g_tls_database_lookup_certificate_by_handle() for more information.
80094
80624
 
80095
80625
  If the handle is no longer valid, or does not point to a certificate in
80096
80626
  this database, then %NULL will be returned.</doc>
@@ -80374,7 +80904,7 @@ objects. Use g_object_unref() on each certificate, and g_list_free() on the rele
80374
80904
  adding any missing certificates to the chain.
80375
80905
 
80376
80906
  @chain is a chain of #GTlsCertificate objects each pointing to the next
80377
- certificate in the chain by its %issuer property. The chain may initially
80907
+ certificate in the chain by its #GTlsCertificate:issuer property. The chain may initially
80378
80908
  consist of one or more certificates. After the verification process is
80379
80909
  complete, @chain may be modified by adding missing certificates, or removing
80380
80910
  extra certificates. If a certificate anchor was found, then it is added to
@@ -80684,7 +81214,7 @@ g_tls_database_lookup_certificate_for_handle() for more information.</doc>
80684
81214
  version="2.30"
80685
81215
  throws="1">
80686
81216
  <doc xml:space="preserve">Finish an asynchronous lookup of a certificate by its handle. See
80687
- g_tls_database_lookup_certificate_handle() for more information.
81217
+ g_tls_database_lookup_certificate_by_handle() for more information.
80688
81218
 
80689
81219
  If the handle is no longer valid, or does not point to a certificate in
80690
81220
  this database, then %NULL will be returned.</doc>
@@ -80966,7 +81496,7 @@ objects. Use g_object_unref() on each certificate, and g_list_free() on the rele
80966
81496
  adding any missing certificates to the chain.
80967
81497
 
80968
81498
  @chain is a chain of #GTlsCertificate objects each pointing to the next
80969
- certificate in the chain by its %issuer property. The chain may initially
81499
+ certificate in the chain by its #GTlsCertificate:issuer property. The chain may initially
80970
81500
  consist of one or more certificates. After the verification process is
80971
81501
  complete, @chain may be modified by adding missing certificates, or removing
80972
81502
  extra certificates. If a certificate anchor was found, then it is added to
@@ -81655,7 +82185,7 @@ objects. Use g_object_unref() on each certificate, and g_list_free() on the rele
81655
82185
  glib:type-name="GTlsDatabaseLookupFlags"
81656
82186
  glib:get-type="g_tls_database_lookup_flags_get_type"
81657
82187
  c:type="GTlsDatabaseLookupFlags">
81658
- <doc xml:space="preserve">Flags for g_tls_database_lookup_certificate_handle(),
82188
+ <doc xml:space="preserve">Flags for g_tls_database_lookup_certificate_for_handle(),
81659
82189
  g_tls_database_lookup_certificate_issuer(),
81660
82190
  and g_tls_database_lookup_certificates_issued_by().</doc>
81661
82191
  <member name="none"
@@ -81780,7 +82310,7 @@ The certificates in @anchors must be PEM encoded.</doc>
81780
82310
  <parameters>
81781
82311
  <parameter name="anchors" transfer-ownership="none">
81782
82312
  <doc xml:space="preserve">filename of anchor certificate authorities.</doc>
81783
- <type name="filename" c:type="gchar*"/>
82313
+ <type name="filename" c:type="const gchar*"/>
81784
82314
  </parameter>
81785
82315
  </parameters>
81786
82316
  </function>
@@ -82763,7 +83293,9 @@ considered part of the password in this case.)</doc>
82763
83293
  </instance-parameter>
82764
83294
  <parameter name="value" transfer-ownership="none">
82765
83295
  <doc xml:space="preserve">the value for the password</doc>
82766
- <type name="guint8" c:type="guchar*"/>
83296
+ <array length="1" zero-terminated="0" c:type="guchar*">
83297
+ <type name="guint8" c:type="guchar"/>
83298
+ </array>
82767
83299
  </parameter>
82768
83300
  <parameter name="length" transfer-ownership="none">
82769
83301
  <doc xml:space="preserve">the length of the password, or -1</doc>
@@ -82908,7 +83440,9 @@ considered part of the password in this case.)</doc>
82908
83440
  </instance-parameter>
82909
83441
  <parameter name="value" transfer-ownership="none">
82910
83442
  <doc xml:space="preserve">the new password value</doc>
82911
- <type name="guint8" c:type="const guchar*"/>
83443
+ <array length="1" zero-terminated="0" c:type="guchar*">
83444
+ <type name="guint8" c:type="guchar"/>
83445
+ </array>
82912
83446
  </parameter>
82913
83447
  <parameter name="length" transfer-ownership="none">
82914
83448
  <doc xml:space="preserve">the length of the password, or -1</doc>
@@ -82938,7 +83472,9 @@ considered part of the password in this case.)</doc>
82938
83472
  </instance-parameter>
82939
83473
  <parameter name="value" transfer-ownership="none">
82940
83474
  <doc xml:space="preserve">the value for the password</doc>
82941
- <type name="guint8" c:type="guchar*"/>
83475
+ <array length="1" zero-terminated="0" c:type="guchar*">
83476
+ <type name="guint8" c:type="guchar"/>
83477
+ </array>
82942
83478
  </parameter>
82943
83479
  <parameter name="length" transfer-ownership="none">
82944
83480
  <doc xml:space="preserve">the length of the password, or -1</doc>
@@ -83030,7 +83566,9 @@ g_tls_password_get_flags().</doc>
83030
83566
  </parameter>
83031
83567
  <parameter name="value" transfer-ownership="none">
83032
83568
  <doc xml:space="preserve">the value for the password</doc>
83033
- <type name="guint8" c:type="guchar*"/>
83569
+ <array length="2" zero-terminated="0" c:type="guchar*">
83570
+ <type name="guint8" c:type="guchar"/>
83571
+ </array>
83034
83572
  </parameter>
83035
83573
  <parameter name="length" transfer-ownership="none">
83036
83574
  <doc xml:space="preserve">the length of the password, or -1</doc>
@@ -84335,7 +84873,7 @@ other words, in code
84335
84873
  then the expression
84336
84874
  |[&lt;!-- language="C" --&gt;
84337
84875
  (g_file_has_prefix (volume_activation_root, mount_root) ||
84338
- g_file_equal (volume_activation_root, mount_root))
84876
+ g_file_equal (volume_activation_root, mount_root))
84339
84877
  ]|
84340
84878
  will always be %TRUE.
84341
84879
 
@@ -84785,7 +85323,7 @@ other words, in code
84785
85323
  then the expression
84786
85324
  |[&lt;!-- language="C" --&gt;
84787
85325
  (g_file_has_prefix (volume_activation_root, mount_root) ||
84788
- g_file_equal (volume_activation_root, mount_root))
85326
+ g_file_equal (volume_activation_root, mount_root))
84789
85327
  ]|
84790
85328
  will always be %TRUE.
84791
85329
 
@@ -85966,7 +86504,10 @@ its elements have been unreffed with g_object_unref().</doc>
85966
86504
  </parameters>
85967
86505
  </glib:signal>
85968
86506
  <glib:signal name="mount-pre-unmount" when="last">
85969
- <doc xml:space="preserve">Emitted when a mount is about to be removed.</doc>
86507
+ <doc xml:space="preserve">May be emitted when a mount is about to be removed.
86508
+
86509
+ This signal depends on the backend and is only emitted if
86510
+ GIO was used to unmount.</doc>
85970
86511
  <return-value transfer-ownership="none">
85971
86512
  <type name="none" c:type="void"/>
85972
86513
  </return-value>
@@ -86679,7 +87220,7 @@ being swallowed by Exec key unquoting. See the specification for exact quoting r
86679
87220
  <parameters>
86680
87221
  <parameter name="commandline" transfer-ownership="none">
86681
87222
  <doc xml:space="preserve">the commandline to use</doc>
86682
- <type name="utf8" c:type="const char*"/>
87223
+ <type name="filename" c:type="const char*"/>
86683
87224
  </parameter>
86684
87225
  <parameter name="application_name"
86685
87226
  transfer-ownership="none"
@@ -86834,7 +87375,7 @@ required.</doc>
86834
87375
  <doc xml:space="preserve">the uri to show</doc>
86835
87376
  <type name="utf8" c:type="const char*"/>
86836
87377
  </parameter>
86837
- <parameter name="launch_context"
87378
+ <parameter name="context"
86838
87379
  transfer-ownership="none"
86839
87380
  nullable="1"
86840
87381
  allow-none="1">
@@ -86861,13 +87402,18 @@ dialog to the user.</doc>
86861
87402
  <doc xml:space="preserve">the uri to show</doc>
86862
87403
  <type name="utf8" c:type="const char*"/>
86863
87404
  </parameter>
86864
- <parameter name="launch_context" transfer-ownership="none">
87405
+ <parameter name="context"
87406
+ transfer-ownership="none"
87407
+ nullable="1"
87408
+ allow-none="1">
87409
+ <doc xml:space="preserve">an optional #GAppLaunchContext</doc>
86865
87410
  <type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
86866
87411
  </parameter>
86867
87412
  <parameter name="cancellable"
86868
87413
  transfer-ownership="none"
86869
87414
  nullable="1"
86870
87415
  allow-none="1">
87416
+ <doc xml:space="preserve">a #GCancellable</doc>
86871
87417
  <type name="Cancellable" c:type="GCancellable*"/>
86872
87418
  </parameter>
86873
87419
  <parameter name="callback"
@@ -87896,10 +88442,10 @@ g_list_free_full (list, g_free).</doc>
87896
88442
  <doc xml:space="preserve">Escape @string so it can appear in a D-Bus address as the value
87897
88443
  part of a key-value pair.
87898
88444
 
87899
- For instance, if @string is "/run/bus-for-:0",
87900
- this function would return "/run/bus-for-%3A0",
88445
+ For instance, if @string is `/run/bus-for-:0`,
88446
+ this function would return `/run/bus-for-%3A0`,
87901
88447
  which could be used in a D-Bus address like
87902
- "unix:nonce-tcp:host=127.0.0.1,port=42,noncefile=/run/bus-for-%3A0".</doc>
88448
+ `unix:nonce-tcp:host=127.0.0.1,port=42,noncefile=/run/bus-for-%3A0`.</doc>
87903
88449
  <return-value transfer-ownership="full">
87904
88450
  <doc xml:space="preserve">a copy of @string with all
87905
88451
  non-optionally-escaped bytes escaped</doc>
@@ -88245,7 +88791,9 @@ exists.</doc>
88245
88791
  </parameter>
88246
88792
  <parameter name="entries" transfer-ownership="none">
88247
88793
  <doc xml:space="preserve">A pointer to @num_entries #GDBusErrorEntry struct items.</doc>
88248
- <type name="DBusErrorEntry" c:type="const GDBusErrorEntry*"/>
88794
+ <array length="3" zero-terminated="0" c:type="GDBusErrorEntry*">
88795
+ <type name="DBusErrorEntry" c:type="GDBusErrorEntry"/>
88796
+ </array>
88249
88797
  </parameter>
88250
88798
  <parameter name="num_entries" transfer-ownership="none">
88251
88799
  <doc xml:space="preserve">Number of items to register.</doc>
@@ -88580,7 +89128,7 @@ for you there. It is also always possible to use this function with
88580
89128
  <parameters>
88581
89129
  <parameter name="arg" transfer-ownership="none">
88582
89130
  <doc xml:space="preserve">a command line string</doc>
88583
- <type name="utf8" c:type="const char*"/>
89131
+ <type name="filename" c:type="const char*"/>
88584
89132
  </parameter>
88585
89133
  </parameters>
88586
89134
  </function>
@@ -88606,11 +89154,11 @@ See also g_application_command_line_create_file_for_arg().</doc>
88606
89154
  <parameters>
88607
89155
  <parameter name="arg" transfer-ownership="none">
88608
89156
  <doc xml:space="preserve">a command line string</doc>
88609
- <type name="utf8" c:type="const gchar*"/>
89157
+ <type name="filename" c:type="const gchar*"/>
88610
89158
  </parameter>
88611
89159
  <parameter name="cwd" transfer-ownership="none">
88612
89160
  <doc xml:space="preserve">the current working directory of the commandline</doc>
88613
- <type name="filename" c:type="gchar*"/>
89161
+ <type name="filename" c:type="const gchar*"/>
88614
89162
  </parameter>
88615
89163
  </parameters>
88616
89164
  </function>
@@ -88629,7 +89177,7 @@ operation if @path is malformed.</doc>
88629
89177
  <parameter name="path" transfer-ownership="none">
88630
89178
  <doc xml:space="preserve">a string containing a relative or absolute path.
88631
89179
  The string must be encoded in the glib filename encoding.</doc>
88632
- <type name="filename" c:type="char*"/>
89180
+ <type name="filename" c:type="const char*"/>
88633
89181
  </parameter>
88634
89182
  </parameters>
88635
89183
  </function>
@@ -88679,7 +89227,7 @@ a temporary file could not be created.</doc>
88679
89227
  allow-none="1">
88680
89228
  <doc xml:space="preserve">Template for the file
88681
89229
  name, as in g_file_open_tmp(), or %NULL for a default template</doc>
88682
- <type name="filename" c:type="char*"/>
89230
+ <type name="filename" c:type="const char*"/>
88683
89231
  </parameter>
88684
89232
  <parameter name="iostream"
88685
89233
  direction="out"
@@ -88936,7 +89484,7 @@ which allows delayed/lazy loading of modules.</doc>
88936
89484
  <parameter name="dirname" transfer-ownership="none">
88937
89485
  <doc xml:space="preserve">pathname for a directory containing modules
88938
89486
  to load.</doc>
88939
- <type name="filename" c:type="gchar*"/>
89487
+ <type name="filename" c:type="const gchar*"/>
88940
89488
  </parameter>
88941
89489
  </parameters>
88942
89490
  </function>
@@ -88963,7 +89511,7 @@ which allows delayed/lazy loading of modules.</doc>
88963
89511
  <parameter name="dirname" transfer-ownership="none">
88964
89512
  <doc xml:space="preserve">pathname for a directory containing modules
88965
89513
  to load.</doc>
88966
- <type name="filename" c:type="gchar*"/>
89514
+ <type name="filename" c:type="const gchar*"/>
88967
89515
  </parameter>
88968
89516
  <parameter name="scope" transfer-ownership="none">
88969
89517
  <doc xml:space="preserve">a scope to use when scanning the modules.</doc>
@@ -88992,7 +89540,7 @@ use g_io_modules_load_all_in_directory().</doc>
88992
89540
  <parameter name="dirname" transfer-ownership="none">
88993
89541
  <doc xml:space="preserve">pathname for a directory containing modules
88994
89542
  to scan.</doc>
88995
- <type name="filename" c:type="char*"/>
89543
+ <type name="filename" c:type="const char*"/>
88996
89544
  </parameter>
88997
89545
  </parameters>
88998
89546
  </function>
@@ -89017,7 +89565,7 @@ use g_io_modules_load_all_in_directory().</doc>
89017
89565
  <parameter name="dirname" transfer-ownership="none">
89018
89566
  <doc xml:space="preserve">pathname for a directory containing modules
89019
89567
  to scan.</doc>
89020
- <type name="filename" c:type="gchar*"/>
89568
+ <type name="filename" c:type="const gchar*"/>
89021
89569
  </parameter>
89022
89570
  <parameter name="scope" transfer-ownership="none">
89023
89571
  <doc xml:space="preserve">a scope to use when scanning the modules</doc>
@@ -89480,7 +90028,7 @@ to register it with g_resources_register().</doc>
89480
90028
  <parameters>
89481
90029
  <parameter name="filename" transfer-ownership="none">
89482
90030
  <doc xml:space="preserve">the path of a filename to load, in the GLib filename encoding</doc>
89483
- <type name="filename" c:type="gchar*"/>
90031
+ <type name="filename" c:type="const gchar*"/>
89484
90032
  </parameter>
89485
90033
  </parameters>
89486
90034
  </function>
@@ -89660,7 +90208,7 @@ from different directories, depending on which directories were given
89660
90208
  in `XDG_DATA_DIRS` and `GSETTINGS_SCHEMA_DIR`. For this reason, all
89661
90209
  lookups performed against the default source should probably be done
89662
90210
  recursively.</doc>
89663
- <return-value transfer-ownership="none">
90211
+ <return-value transfer-ownership="none" nullable="1">
89664
90212
  <doc xml:space="preserve">the default schema source</doc>
89665
90213
  <type name="SettingsSchemaSource" c:type="GSettingsSchemaSource*"/>
89666
90214
  </return-value>
@@ -89892,7 +90440,7 @@ The certificates in @anchors must be PEM encoded.</doc>
89892
90440
  <parameters>
89893
90441
  <parameter name="anchors" transfer-ownership="none">
89894
90442
  <doc xml:space="preserve">filename of anchor certificate authorities.</doc>
89895
- <type name="filename" c:type="gchar*"/>
90443
+ <type name="filename" c:type="const gchar*"/>
89896
90444
  </parameter>
89897
90445
  </parameters>
89898
90446
  </function>