gobject-introspection 3.1.8-x64-mingw32 → 3.1.9-x64-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (95) hide show
  1. checksums.yaml +4 -4
  2. data/Rakefile +2 -2
  3. data/ext/gobject-introspection/rb-gi-argument.c +49 -9
  4. data/ext/gobject-introspection/rb-gi-loader.c +74 -1
  5. data/lib/2.2/gobject_introspection.so +0 -0
  6. data/lib/2.3/gobject_introspection.so +0 -0
  7. data/lib/2.4/gobject_introspection.so +0 -0
  8. data/test/run-test.rb +1 -1
  9. data/vendor/local/bin/g-ir-compiler.exe +0 -0
  10. data/vendor/local/bin/g-ir-generate.exe +0 -0
  11. data/vendor/local/bin/g-ir-inspect.exe +0 -0
  12. data/vendor/local/bin/libgirepository-1.0-1.dll +0 -0
  13. data/vendor/local/lib/girepository-1.0/GLib-2.0.typelib +0 -0
  14. data/vendor/local/lib/girepository-1.0/GModule-2.0.typelib +0 -0
  15. data/vendor/local/lib/girepository-1.0/GObject-2.0.typelib +0 -0
  16. data/vendor/local/lib/girepository-1.0/Gio-2.0.typelib +0 -0
  17. data/vendor/local/lib/girepository-1.0/cairo-1.0.typelib +0 -0
  18. data/vendor/local/lib/gobject-introspection/giscanner/__init__.pyc +0 -0
  19. data/vendor/local/lib/gobject-introspection/giscanner/__init__.pyo +0 -0
  20. data/vendor/local/lib/gobject-introspection/giscanner/annotationmain.pyc +0 -0
  21. data/vendor/local/lib/gobject-introspection/giscanner/annotationmain.pyo +0 -0
  22. data/vendor/local/lib/gobject-introspection/giscanner/annotationparser.pyc +0 -0
  23. data/vendor/local/lib/gobject-introspection/giscanner/annotationparser.pyo +0 -0
  24. data/vendor/local/lib/gobject-introspection/giscanner/ast.pyc +0 -0
  25. data/vendor/local/lib/gobject-introspection/giscanner/ast.pyo +0 -0
  26. data/vendor/local/lib/gobject-introspection/giscanner/cachestore.py +8 -14
  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 +48 -51
  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 +39 -66
  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.pyc +0 -0
  58. data/vendor/local/lib/gobject-introspection/giscanner/maintransformer.pyo +0 -0
  59. data/vendor/local/lib/gobject-introspection/giscanner/message.pyc +0 -0
  60. data/vendor/local/lib/gobject-introspection/giscanner/message.pyo +0 -0
  61. data/vendor/local/lib/gobject-introspection/giscanner/msvccompiler.pyc +0 -0
  62. data/vendor/local/lib/gobject-introspection/giscanner/msvccompiler.pyo +0 -0
  63. data/vendor/local/lib/gobject-introspection/giscanner/scannermain.pyc +0 -0
  64. data/vendor/local/lib/gobject-introspection/giscanner/scannermain.pyo +0 -0
  65. data/vendor/local/lib/gobject-introspection/giscanner/sectionparser.pyc +0 -0
  66. data/vendor/local/lib/gobject-introspection/giscanner/sectionparser.pyo +0 -0
  67. data/vendor/local/lib/gobject-introspection/giscanner/shlibs.pyc +0 -0
  68. data/vendor/local/lib/gobject-introspection/giscanner/shlibs.pyo +0 -0
  69. data/vendor/local/lib/gobject-introspection/giscanner/sourcescanner.py +3 -1
  70. data/vendor/local/lib/gobject-introspection/giscanner/sourcescanner.pyc +0 -0
  71. data/vendor/local/lib/gobject-introspection/giscanner/sourcescanner.pyo +0 -0
  72. data/vendor/local/lib/gobject-introspection/giscanner/testcodegen.pyc +0 -0
  73. data/vendor/local/lib/gobject-introspection/giscanner/testcodegen.pyo +0 -0
  74. data/vendor/local/lib/gobject-introspection/giscanner/transformer.pyc +0 -0
  75. data/vendor/local/lib/gobject-introspection/giscanner/transformer.pyo +0 -0
  76. data/vendor/local/lib/gobject-introspection/giscanner/utils.py +3 -3
  77. data/vendor/local/lib/gobject-introspection/giscanner/utils.pyc +0 -0
  78. data/vendor/local/lib/gobject-introspection/giscanner/utils.pyo +0 -0
  79. data/vendor/local/lib/gobject-introspection/giscanner/xmlwriter.pyc +0 -0
  80. data/vendor/local/lib/gobject-introspection/giscanner/xmlwriter.pyo +0 -0
  81. data/vendor/local/lib/libgirepository-1.0.a +0 -0
  82. data/vendor/local/lib/libgirepository-1.0.dll.a +0 -0
  83. data/vendor/local/lib/pkgconfig/gobject-introspection-1.0.pc +1 -1
  84. data/vendor/local/lib/pkgconfig/gobject-introspection-no-export-1.0.pc +1 -1
  85. data/vendor/local/share/gir-1.0/GLib-2.0.gir +684 -515
  86. data/vendor/local/share/gir-1.0/GModule-2.0.gir +0 -25
  87. data/vendor/local/share/gir-1.0/GObject-2.0.gir +160 -3
  88. data/vendor/local/share/gir-1.0/Gio-2.0.gir +198 -83
  89. data/vendor/local/share/gir-1.0/cairo-1.0.gir +622 -21
  90. data/vendor/local/share/gir-1.0/gir-1.2.rnc +479 -0
  91. data/vendor/local/share/gobject-introspection-1.0/tests/annotation.c +2 -1
  92. data/vendor/local/share/gobject-introspection-1.0/tests/annotation.h +1 -1
  93. data/vendor/local/share/gobject-introspection-1.0/tests/regress.c +50 -1
  94. data/vendor/local/share/gobject-introspection-1.0/tests/regress.h +7 -0
  95. metadata +5 -4
@@ -59,16 +59,6 @@ If @module refers to the application itself, "main" is returned.</doc>
59
59
  </instance-parameter>
60
60
  </parameters>
61
61
  </method>
62
- <method name="name_utf8" c:identifier="g_module_name_utf8">
63
- <return-value transfer-ownership="none">
64
- <type name="utf8" c:type="const gchar*"/>
65
- </return-value>
66
- <parameters>
67
- <instance-parameter name="module" transfer-ownership="none">
68
- <type name="Module" c:type="GModule*"/>
69
- </instance-parameter>
70
- </parameters>
71
- </method>
72
62
  <method name="symbol" c:identifier="g_module_symbol">
73
63
  <doc xml:space="preserve">Gets a symbol pointer from a module, such as one exported
74
64
  by #G_MODULE_EXPORT. Note that a valid symbol can be %NULL.</doc>
@@ -170,21 +160,6 @@ returned.</doc>
170
160
  </parameter>
171
161
  </parameters>
172
162
  </function>
173
- <function name="open_utf8"
174
- c:identifier="g_module_open_utf8"
175
- introspectable="0">
176
- <return-value>
177
- <type name="Module" c:type="GModule*"/>
178
- </return-value>
179
- <parameters>
180
- <parameter name="file_name" transfer-ownership="none">
181
- <type name="utf8" c:type="const gchar*"/>
182
- </parameter>
183
- <parameter name="flags" transfer-ownership="none">
184
- <type name="ModuleFlags" c:type="GModuleFlags"/>
185
- </parameter>
186
- </parameters>
187
- </function>
188
163
  <function name="supported" c:identifier="g_module_supported">
189
164
  <doc xml:space="preserve">Checks if modules are supported on the current platform.</doc>
190
165
  <return-value transfer-ownership="none">
@@ -3902,7 +3902,7 @@ zeros before this function is called.</doc>
3902
3902
  to the #GObject implementation and should never be accessed directly.</doc>
3903
3903
  <constructor name="new"
3904
3904
  c:identifier="g_object_new"
3905
- shadowed-by="newv"
3905
+ shadowed-by="new_with_properties"
3906
3906
  introspectable="0">
3907
3907
  <doc xml:space="preserve">Creates a new instance of a #GObject subtype and sets its properties.
3908
3908
 
@@ -3956,11 +3956,54 @@ which are not explicitly specified are set to their default values.</doc>
3956
3956
  </parameter>
3957
3957
  </parameters>
3958
3958
  </constructor>
3959
- <constructor name="newv" c:identifier="g_object_newv" shadows="new">
3959
+ <constructor name="new_with_properties"
3960
+ c:identifier="g_object_new_with_properties"
3961
+ shadows="new"
3962
+ version="2.54">
3963
+ <doc xml:space="preserve">Creates a new instance of a #GObject subtype and sets its properties using
3964
+ the provided arrays. Both arrays must have exactly @n_properties elements,
3965
+ and the names and values correspond by index.
3966
+
3967
+ Construction parameters (see %G_PARAM_CONSTRUCT, %G_PARAM_CONSTRUCT_ONLY)
3968
+ which are not explicitly specified are set to their default values.</doc>
3969
+ <return-value transfer-ownership="full">
3970
+ <doc xml:space="preserve">a new instance of
3971
+ @object_type</doc>
3972
+ <type name="Object" c:type="GObject*"/>
3973
+ </return-value>
3974
+ <parameters>
3975
+ <parameter name="object_type" transfer-ownership="none">
3976
+ <doc xml:space="preserve">the object type to instantiate</doc>
3977
+ <type name="GType" c:type="GType"/>
3978
+ </parameter>
3979
+ <parameter name="n_properties" transfer-ownership="none">
3980
+ <doc xml:space="preserve">the number of properties</doc>
3981
+ <type name="guint" c:type="guint"/>
3982
+ </parameter>
3983
+ <parameter name="names" transfer-ownership="none">
3984
+ <doc xml:space="preserve">the names of each property to be set</doc>
3985
+ <array length="1" zero-terminated="0" c:type="char*">
3986
+ <type name="utf8" c:type="char"/>
3987
+ </array>
3988
+ </parameter>
3989
+ <parameter name="values" transfer-ownership="none">
3990
+ <doc xml:space="preserve">the values of each property to be set</doc>
3991
+ <array length="1" zero-terminated="0" c:type="GValue">
3992
+ <type name="Value" c:type="GValue"/>
3993
+ </array>
3994
+ </parameter>
3995
+ </parameters>
3996
+ </constructor>
3997
+ <constructor name="newv"
3998
+ c:identifier="g_object_newv"
3999
+ deprecated="1"
4000
+ deprecated-version="2.54">
3960
4001
  <doc xml:space="preserve">Creates a new instance of a #GObject subtype and sets its properties.
3961
4002
 
3962
4003
  Construction parameters (see #G_PARAM_CONSTRUCT, #G_PARAM_CONSTRUCT_ONLY)
3963
4004
  which are not explicitly specified are set to their default values.</doc>
4005
+ <doc-deprecated xml:space="preserve">Use g_object_new_with_properties() instead.
4006
+ deprecated. See #GParameter for more information.</doc-deprecated>
3964
4007
  <return-value transfer-ownership="full">
3965
4008
  <doc xml:space="preserve">a new instance of
3966
4009
  @object_type</doc>
@@ -4827,6 +4870,37 @@ See g_object_get().</doc>
4827
4870
  </parameter>
4828
4871
  </parameters>
4829
4872
  </method>
4873
+ <method name="getv" c:identifier="g_object_getv" version="2.54">
4874
+ <doc xml:space="preserve">Gets @n_properties properties for an @object.
4875
+ Obtained properties will be set to @values. All properties must be valid.
4876
+ Warnings will be emitted and undefined behaviour may result if invalid
4877
+ properties are passed in.</doc>
4878
+ <return-value transfer-ownership="none">
4879
+ <type name="none" c:type="void"/>
4880
+ </return-value>
4881
+ <parameters>
4882
+ <instance-parameter name="object" transfer-ownership="none">
4883
+ <doc xml:space="preserve">a #GObject</doc>
4884
+ <type name="Object" c:type="GObject*"/>
4885
+ </instance-parameter>
4886
+ <parameter name="n_properties" transfer-ownership="none">
4887
+ <doc xml:space="preserve">the number of properties</doc>
4888
+ <type name="guint" c:type="guint"/>
4889
+ </parameter>
4890
+ <parameter name="names" transfer-ownership="none">
4891
+ <doc xml:space="preserve">the names of each property to get</doc>
4892
+ <array length="0" zero-terminated="0" c:type="gchar*">
4893
+ <type name="utf8" c:type="gchar"/>
4894
+ </array>
4895
+ </parameter>
4896
+ <parameter name="values" transfer-ownership="none">
4897
+ <doc xml:space="preserve">the values of each property to get</doc>
4898
+ <array length="0" zero-terminated="0" c:type="GValue">
4899
+ <type name="Value" c:type="GValue"/>
4900
+ </array>
4901
+ </parameter>
4902
+ </parameters>
4903
+ </method>
4830
4904
  <method name="is_floating"
4831
4905
  c:identifier="g_object_is_floating"
4832
4906
  version="2.10">
@@ -5341,6 +5415,40 @@ with the same @quark.</doc>
5341
5415
  </parameter>
5342
5416
  </parameters>
5343
5417
  </method>
5418
+ <method name="setv"
5419
+ c:identifier="g_object_setv"
5420
+ version="2.54"
5421
+ introspectable="0">
5422
+ <doc xml:space="preserve">Sets @n_properties properties for an @object.
5423
+ Properties to be set will be taken from @values. All properties must be
5424
+ valid. Warnings will be emitted and undefined behaviour may result if invalid
5425
+ properties are passed in.</doc>
5426
+ <return-value transfer-ownership="none">
5427
+ <type name="none" c:type="void"/>
5428
+ </return-value>
5429
+ <parameters>
5430
+ <instance-parameter name="object" transfer-ownership="none">
5431
+ <doc xml:space="preserve">a #GObject</doc>
5432
+ <type name="Object" c:type="GObject*"/>
5433
+ </instance-parameter>
5434
+ <parameter name="n_properties" transfer-ownership="none">
5435
+ <doc xml:space="preserve">the number of properties</doc>
5436
+ <type name="guint" c:type="guint"/>
5437
+ </parameter>
5438
+ <parameter name="names" transfer-ownership="none">
5439
+ <doc xml:space="preserve">the names of each property to be set</doc>
5440
+ <array length="0" zero-terminated="0" c:type="gchar*">
5441
+ <type name="utf8" c:type="gchar"/>
5442
+ </array>
5443
+ </parameter>
5444
+ <parameter name="values" transfer-ownership="none">
5445
+ <doc xml:space="preserve">the values of each property to be set</doc>
5446
+ <array length="0" zero-terminated="0" c:type="GValue">
5447
+ <type name="Value" c:type="GValue"/>
5448
+ </array>
5449
+ </parameter>
5450
+ </parameters>
5451
+ </method>
5344
5452
  <method name="steal_data" c:identifier="g_object_steal_data">
5345
5453
  <doc xml:space="preserve">Remove a specified datum from the object's data associations,
5346
5454
  without invoking the association's destroy handler.</doc>
@@ -7348,9 +7456,13 @@ g_param_type_register_static().</doc>
7348
7456
  </array>
7349
7457
  </field>
7350
7458
  </class>
7351
- <record name="Parameter" c:type="GParameter">
7459
+ <record name="Parameter"
7460
+ c:type="GParameter"
7461
+ deprecated="1"
7462
+ deprecated-version="2.54">
7352
7463
  <doc xml:space="preserve">The GParameter struct is an auxiliary structure used
7353
7464
  to hand parameter name/value pairs to g_object_newv().</doc>
7465
+ <doc-deprecated xml:space="preserve">This type is not introspectable.</doc-deprecated>
7354
7466
  <field name="name" writable="1">
7355
7467
  <doc xml:space="preserve">the parameter name</doc>
7356
7468
  <type name="utf8" c:type="const gchar*"/>
@@ -12128,6 +12240,28 @@ definition than to write one yourself using g_enum_register_static().</doc>
12128
12240
  </parameter>
12129
12241
  </parameters>
12130
12242
  </function>
12243
+ <function name="enum_to_string"
12244
+ c:identifier="g_enum_to_string"
12245
+ version="2.54">
12246
+ <doc xml:space="preserve">Pretty-prints @value in the form of the enum’s name.
12247
+
12248
+ This is intended to be used for debugging purposes. The format of the output
12249
+ may change in the future.</doc>
12250
+ <return-value transfer-ownership="full">
12251
+ <doc xml:space="preserve">a newly-allocated text string</doc>
12252
+ <type name="utf8" c:type="gchar*"/>
12253
+ </return-value>
12254
+ <parameters>
12255
+ <parameter name="g_enum_type" transfer-ownership="none">
12256
+ <doc xml:space="preserve">the type identifier of a #GEnumClass type</doc>
12257
+ <type name="GType" c:type="GType"/>
12258
+ </parameter>
12259
+ <parameter name="value" transfer-ownership="none">
12260
+ <doc xml:space="preserve">the value</doc>
12261
+ <type name="gint" c:type="gint"/>
12262
+ </parameter>
12263
+ </parameters>
12264
+ </function>
12131
12265
  <function name="flags_complete_type_info"
12132
12266
  c:identifier="g_flags_complete_type_info">
12133
12267
  <doc xml:space="preserve">This function is meant to be called from the complete_type_info()
@@ -12237,6 +12371,29 @@ definition than to write one yourself using g_flags_register_static().</doc>
12237
12371
  </parameter>
12238
12372
  </parameters>
12239
12373
  </function>
12374
+ <function name="flags_to_string"
12375
+ c:identifier="g_flags_to_string"
12376
+ version="2.54">
12377
+ <doc xml:space="preserve">Pretty-prints @value in the form of the flag names separated by ` | ` and
12378
+ sorted. Any extra bits will be shown at the end as a hexadecimal number.
12379
+
12380
+ This is intended to be used for debugging purposes. The format of the output
12381
+ may change in the future.</doc>
12382
+ <return-value transfer-ownership="full">
12383
+ <doc xml:space="preserve">a newly-allocated text string</doc>
12384
+ <type name="utf8" c:type="gchar*"/>
12385
+ </return-value>
12386
+ <parameters>
12387
+ <parameter name="flags_type" transfer-ownership="none">
12388
+ <doc xml:space="preserve">the type identifier of a #GFlagsClass type</doc>
12389
+ <type name="GType" c:type="GType"/>
12390
+ </parameter>
12391
+ <parameter name="value" transfer-ownership="none">
12392
+ <doc xml:space="preserve">the value</doc>
12393
+ <type name="guint" c:type="guint"/>
12394
+ </parameter>
12395
+ </parameters>
12396
+ </function>
12240
12397
  <function name="gtype_get_type" c:identifier="g_gtype_get_type">
12241
12398
  <return-value transfer-ownership="none">
12242
12399
  <type name="GType" c:type="GType"/>
@@ -4557,7 +4557,7 @@ reproduced here:
4557
4557
  "[A-Z][a-z][0-9]_-." and must not begin with a digit.
4558
4558
 
4559
4559
  - Application identifiers must contain at least one '.' (period)
4560
- character (and thus at least three elements).
4560
+ character (and thus at least two elements).
4561
4561
 
4562
4562
  - Application identifiers must not begin or end with a '.' (period)
4563
4563
  character.
@@ -7189,13 +7189,17 @@ the value, and other property value pairs, and ended by %NULL.</doc>
7189
7189
  </function>
7190
7190
  <function name="newv_async"
7191
7191
  c:identifier="g_async_initable_newv_async"
7192
- version="2.22">
7192
+ version="2.22"
7193
+ deprecated="1"
7194
+ deprecated-version="2.54">
7193
7195
  <doc xml:space="preserve">Helper function for constructing #GAsyncInitable object. This is
7194
7196
  similar to g_object_newv() but also initializes the object asynchronously.
7195
7197
 
7196
7198
  When the initialization is finished, @callback will be called. You can
7197
7199
  then call g_async_initable_new_finish() to get the new object and check
7198
7200
  for any errors.</doc>
7201
+ <doc-deprecated xml:space="preserve">Use g_object_new_with_properties() and
7202
+ g_async_initable_init_async() instead. See #GParameter for more information.</doc-deprecated>
7199
7203
  <return-value transfer-ownership="none">
7200
7204
  <type name="none" c:type="void"/>
7201
7205
  </return-value>
@@ -7248,6 +7252,9 @@ interface. This must be done before any real use of the object after
7248
7252
  initial construction. If the object also implements #GInitable you can
7249
7253
  optionally call g_initable_init() instead.
7250
7254
 
7255
+ This method is intended for language bindings. If writing in C,
7256
+ g_async_initable_new_async() should typically be used instead.
7257
+
7251
7258
  When the initialization is finished, @callback will be called. You can
7252
7259
  then call g_async_initable_init_finish() to get the result of the
7253
7260
  initialization.
@@ -7265,11 +7272,11 @@ g_object_ref() and g_object_unref() are considered to be invalid, and
7265
7272
  have undefined behaviour. They will often fail with g_critical() or
7266
7273
  g_warning(), but this must not be relied on.
7267
7274
 
7268
- Implementations of this method must be idempotent: i.e. multiple calls
7269
- to this function with the same argument should return the same results.
7270
- Only the first call initializes the object; further calls return the result
7271
- of the first call. This is so that it's safe to implement the singleton
7272
- pattern in the GObject constructor function.
7275
+ Callers should not assume that a class which implements #GAsyncInitable can
7276
+ be initialized multiple times; for more information, see g_initable_init().
7277
+ If a class explicitly supports being initialized multiple times,
7278
+ implementation requires yielding all subsequent calls to init_async() on the
7279
+ results of the first call.
7273
7280
 
7274
7281
  For classes that also support the #GInitable interface, the default
7275
7282
  implementation of this method will run the g_initable_init() function
@@ -7344,6 +7351,9 @@ interface. This must be done before any real use of the object after
7344
7351
  initial construction. If the object also implements #GInitable you can
7345
7352
  optionally call g_initable_init() instead.
7346
7353
 
7354
+ This method is intended for language bindings. If writing in C,
7355
+ g_async_initable_new_async() should typically be used instead.
7356
+
7347
7357
  When the initialization is finished, @callback will be called. You can
7348
7358
  then call g_async_initable_init_finish() to get the result of the
7349
7359
  initialization.
@@ -7361,11 +7371,11 @@ g_object_ref() and g_object_unref() are considered to be invalid, and
7361
7371
  have undefined behaviour. They will often fail with g_critical() or
7362
7372
  g_warning(), but this must not be relied on.
7363
7373
 
7364
- Implementations of this method must be idempotent: i.e. multiple calls
7365
- to this function with the same argument should return the same results.
7366
- Only the first call initializes the object; further calls return the result
7367
- of the first call. This is so that it's safe to implement the singleton
7368
- pattern in the GObject constructor function.
7374
+ Callers should not assume that a class which implements #GAsyncInitable can
7375
+ be initialized multiple times; for more information, see g_initable_init().
7376
+ If a class explicitly supports being initialized multiple times,
7377
+ implementation requires yielding all subsequent calls to init_async() on the
7378
+ results of the first call.
7369
7379
 
7370
7380
  For classes that also support the #GInitable interface, the default
7371
7381
  implementation of this method will run the g_initable_init() function
@@ -8693,6 +8703,13 @@ the connection was disconnected.</doc>
8693
8703
  <doc xml:space="preserve">If another message bus connection owns the name and have
8694
8704
  specified #G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT, then take the name from the other connection.</doc>
8695
8705
  </member>
8706
+ <member name="do_not_queue"
8707
+ value="4"
8708
+ c:identifier="G_BUS_NAME_OWNER_FLAGS_DO_NOT_QUEUE"
8709
+ glib:nick="do-not-queue">
8710
+ <doc xml:space="preserve">If another message bus connection owns the name, immediately
8711
+ return an error from g_bus_own_name() rather than entering the waiting queue for that name. (Since 2.54)</doc>
8712
+ </member>
8696
8713
  </bitfield>
8697
8714
  <callback name="BusNameVanishedCallback"
8698
8715
  c:type="GBusNameVanishedCallback"
@@ -13907,10 +13924,7 @@ method.</doc>
13907
13924
  <doc xml:space="preserve">Indentation level.</doc>
13908
13925
  <type name="guint" c:type="guint"/>
13909
13926
  </parameter>
13910
- <parameter name="string_builder"
13911
- direction="out"
13912
- caller-allocates="1"
13913
- transfer-ownership="none">
13927
+ <parameter name="string_builder" transfer-ownership="none">
13914
13928
  <doc xml:space="preserve">A #GString to to append XML data to.</doc>
13915
13929
  <type name="GLib.String" c:type="GString*"/>
13916
13930
  </parameter>
@@ -14125,7 +14139,7 @@ emitted immediately.
14125
14139
 
14126
14140
  For example, an exported D-Bus interface may queue up property
14127
14141
  changes and emit the
14128
- `org.freedesktop.DBus.Properties::Propert``
14142
+ `org.freedesktop.DBus.Properties::PropertiesChanged`
14129
14143
  signal later (e.g. in an idle handler). This technique is useful
14130
14144
  for collapsing multiple property changes into one.</doc>
14131
14145
  <return-value transfer-ownership="none">
@@ -14245,7 +14259,7 @@ emitted immediately.
14245
14259
 
14246
14260
  For example, an exported D-Bus interface may queue up property
14247
14261
  changes and emit the
14248
- `org.freedesktop.DBus.Properties::Propert``
14262
+ `org.freedesktop.DBus.Properties::PropertiesChanged`
14249
14263
  signal later (e.g. in an idle handler). This technique is useful
14250
14264
  for collapsing multiple property changes into one.</doc>
14251
14265
  <return-value transfer-ownership="none">
@@ -16591,10 +16605,7 @@ handling the `org.freedesktop.DBus.Introspectable.Introspect` method.</doc>
16591
16605
  <doc xml:space="preserve">Indentation level.</doc>
16592
16606
  <type name="guint" c:type="guint"/>
16593
16607
  </parameter>
16594
- <parameter name="string_builder"
16595
- direction="out"
16596
- caller-allocates="1"
16597
- transfer-ownership="none">
16608
+ <parameter name="string_builder" transfer-ownership="none">
16598
16609
  <doc xml:space="preserve">A #GString to to append XML data to.</doc>
16599
16610
  <type name="GLib.String" c:type="GString*"/>
16600
16611
  </parameter>
@@ -20897,7 +20908,9 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
20897
20908
  <parameter name="length"
20898
20909
  direction="out"
20899
20910
  caller-allocates="0"
20900
- transfer-ownership="full">
20911
+ transfer-ownership="full"
20912
+ optional="1"
20913
+ allow-none="1">
20901
20914
  <doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
20902
20915
  <type name="gsize" c:type="gsize*"/>
20903
20916
  </parameter>
@@ -20987,7 +21000,9 @@ well.</doc>
20987
21000
  <parameter name="length"
20988
21001
  direction="out"
20989
21002
  caller-allocates="0"
20990
- transfer-ownership="full">
21003
+ transfer-ownership="full"
21004
+ optional="1"
21005
+ allow-none="1">
20991
21006
  <doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
20992
21007
  <type name="gsize" c:type="gsize*"/>
20993
21008
  </parameter>
@@ -21020,7 +21035,9 @@ g_data_input_stream_read_line_async().</doc>
21020
21035
  <parameter name="length"
21021
21036
  direction="out"
21022
21037
  caller-allocates="0"
21023
- transfer-ownership="full">
21038
+ transfer-ownership="full"
21039
+ optional="1"
21040
+ allow-none="1">
21024
21041
  <doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
21025
21042
  <type name="gsize" c:type="gsize*"/>
21026
21043
  </parameter>
@@ -21053,7 +21070,9 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
21053
21070
  <parameter name="length"
21054
21071
  direction="out"
21055
21072
  caller-allocates="0"
21056
- transfer-ownership="full">
21073
+ transfer-ownership="full"
21074
+ optional="1"
21075
+ allow-none="1">
21057
21076
  <doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
21058
21077
  <type name="gsize" c:type="gsize*"/>
21059
21078
  </parameter>
@@ -21185,7 +21204,9 @@ does not consume the stop character.</doc>
21185
21204
  <parameter name="length"
21186
21205
  direction="out"
21187
21206
  caller-allocates="0"
21188
- transfer-ownership="full">
21207
+ transfer-ownership="full"
21208
+ optional="1"
21209
+ allow-none="1">
21189
21210
  <doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
21190
21211
  <type name="gsize" c:type="gsize*"/>
21191
21212
  </parameter>
@@ -21282,7 +21303,9 @@ g_data_input_stream_read_until_async().</doc>
21282
21303
  <parameter name="length"
21283
21304
  direction="out"
21284
21305
  caller-allocates="0"
21285
- transfer-ownership="full">
21306
+ transfer-ownership="full"
21307
+ optional="1"
21308
+ allow-none="1">
21286
21309
  <doc xml:space="preserve">a #gsize to get the length of the data read in.</doc>
21287
21310
  <type name="gsize" c:type="gsize*"/>
21288
21311
  </parameter>
@@ -21326,7 +21349,9 @@ specified.</doc>
21326
21349
  <parameter name="length"
21327
21350
  direction="out"
21328
21351
  caller-allocates="0"
21329
- transfer-ownership="full">
21352
+ transfer-ownership="full"
21353
+ optional="1"
21354
+ allow-none="1">
21330
21355
  <doc xml:space="preserve">a #gsize to get the length of the data read in</doc>
21331
21356
  <type name="gsize" c:type="gsize*"/>
21332
21357
  </parameter>
@@ -21431,7 +21456,9 @@ g_data_input_stream_read_upto_async() again.</doc>
21431
21456
  <parameter name="length"
21432
21457
  direction="out"
21433
21458
  caller-allocates="0"
21434
- transfer-ownership="full">
21459
+ transfer-ownership="full"
21460
+ optional="1"
21461
+ allow-none="1">
21435
21462
  <doc xml:space="preserve">a #gsize to get the length of the data read in</doc>
21436
21463
  <type name="gsize" c:type="gsize*"/>
21437
21464
  </parameter>
@@ -27644,6 +27671,10 @@ If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
27644
27671
  will be copied as symlinks, otherwise the target of the
27645
27672
  @source symlink will be copied.
27646
27673
 
27674
+ If the flag #G_FILE_COPY_ALL_METADATA is specified then all the metadata
27675
+ that is possible to copy is copied, not just the default subset (which,
27676
+ for instance, does not include the owner, see #GFileInfo).
27677
+
27647
27678
  If @cancellable is not %NULL, then the operation can be cancelled by
27648
27679
  triggering the cancellable object from another thread. If the operation
27649
27680
  was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
@@ -27714,9 +27745,7 @@ file), see g_file_dup().</doc>
27714
27745
  </parameter>
27715
27746
  </parameters>
27716
27747
  </virtual-method>
27717
- <virtual-method name="copy_async"
27718
- invoker="copy_async"
27719
- introspectable="0">
27748
+ <virtual-method name="copy_async" invoker="copy_async">
27720
27749
  <doc xml:space="preserve">Copies the file @source to the location specified by @destination
27721
27750
  asynchronously. For details of the behaviour, see g_file_copy().
27722
27751
 
@@ -27759,6 +27788,7 @@ g_file_copy_finish() to get the result of the operation.</doc>
27759
27788
  transfer-ownership="none"
27760
27789
  nullable="1"
27761
27790
  allow-none="1"
27791
+ scope="notified"
27762
27792
  closure="5">
27763
27793
  <doc xml:space="preserve">function to callback with progress
27764
27794
  information, or %NULL if progress information is not needed</doc>
@@ -27767,7 +27797,8 @@ g_file_copy_finish() to get the result of the operation.</doc>
27767
27797
  <parameter name="progress_callback_data"
27768
27798
  transfer-ownership="none"
27769
27799
  nullable="1"
27770
- allow-none="1">
27800
+ allow-none="1"
27801
+ closure="4">
27771
27802
  <doc xml:space="preserve">user data to pass to @progress_callback</doc>
27772
27803
  <type name="gpointer" c:type="gpointer"/>
27773
27804
  </parameter>
@@ -27784,7 +27815,7 @@ g_file_copy_finish() to get the result of the operation.</doc>
27784
27815
  transfer-ownership="none"
27785
27816
  nullable="1"
27786
27817
  allow-none="1"
27787
- closure="7">
27818
+ closure="6">
27788
27819
  <doc xml:space="preserve">the data to pass to callback function</doc>
27789
27820
  <type name="gpointer" c:type="gpointer"/>
27790
27821
  </parameter>
@@ -31280,6 +31311,10 @@ If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
31280
31311
  will be copied as symlinks, otherwise the target of the
31281
31312
  @source symlink will be copied.
31282
31313
 
31314
+ If the flag #G_FILE_COPY_ALL_METADATA is specified then all the metadata
31315
+ that is possible to copy is copied, not just the default subset (which,
31316
+ for instance, does not include the owner, see #GFileInfo).
31317
+
31283
31318
  If @cancellable is not %NULL, then the operation can be cancelled by
31284
31319
  triggering the cancellable object from another thread. If the operation
31285
31320
  was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
@@ -31350,9 +31385,7 @@ file), see g_file_dup().</doc>
31350
31385
  </parameter>
31351
31386
  </parameters>
31352
31387
  </method>
31353
- <method name="copy_async"
31354
- c:identifier="g_file_copy_async"
31355
- introspectable="0">
31388
+ <method name="copy_async" c:identifier="g_file_copy_async">
31356
31389
  <doc xml:space="preserve">Copies the file @source to the location specified by @destination
31357
31390
  asynchronously. For details of the behaviour, see g_file_copy().
31358
31391
 
@@ -31395,6 +31428,7 @@ g_file_copy_finish() to get the result of the operation.</doc>
31395
31428
  transfer-ownership="none"
31396
31429
  nullable="1"
31397
31430
  allow-none="1"
31431
+ scope="notified"
31398
31432
  closure="5">
31399
31433
  <doc xml:space="preserve">function to callback with progress
31400
31434
  information, or %NULL if progress information is not needed</doc>
@@ -31403,7 +31437,8 @@ g_file_copy_finish() to get the result of the operation.</doc>
31403
31437
  <parameter name="progress_callback_data"
31404
31438
  transfer-ownership="none"
31405
31439
  nullable="1"
31406
- allow-none="1">
31440
+ allow-none="1"
31441
+ closure="4">
31407
31442
  <doc xml:space="preserve">user data to pass to @progress_callback</doc>
31408
31443
  <type name="gpointer" c:type="gpointer"/>
31409
31444
  </parameter>
@@ -31419,7 +31454,8 @@ g_file_copy_finish() to get the result of the operation.</doc>
31419
31454
  <parameter name="user_data"
31420
31455
  transfer-ownership="none"
31421
31456
  nullable="1"
31422
- allow-none="1">
31457
+ allow-none="1"
31458
+ closure="6">
31423
31459
  <doc xml:space="preserve">the data to pass to callback function</doc>
31424
31460
  <type name="gpointer" c:type="gpointer"/>
31425
31461
  </parameter>
@@ -39555,8 +39591,8 @@ to be used as icon.</doc>
39555
39591
  </parameters>
39556
39592
  </callback>
39557
39593
  </field>
39558
- <field name="copy_async" introspectable="0">
39559
- <callback name="copy_async" introspectable="0">
39594
+ <field name="copy_async">
39595
+ <callback name="copy_async">
39560
39596
  <return-value transfer-ownership="none">
39561
39597
  <type name="none" c:type="void"/>
39562
39598
  </return-value>
@@ -39589,6 +39625,7 @@ to be used as icon.</doc>
39589
39625
  transfer-ownership="none"
39590
39626
  nullable="1"
39591
39627
  allow-none="1"
39628
+ scope="notified"
39592
39629
  closure="6">
39593
39630
  <doc xml:space="preserve">function to callback with progress
39594
39631
  information, or %NULL if progress information is not needed</doc>
@@ -39598,7 +39635,8 @@ to be used as icon.</doc>
39598
39635
  <parameter name="progress_callback_data"
39599
39636
  transfer-ownership="none"
39600
39637
  nullable="1"
39601
- allow-none="1">
39638
+ allow-none="1"
39639
+ closure="5">
39602
39640
  <doc xml:space="preserve">user data to pass to @progress_callback</doc>
39603
39641
  <type name="gpointer" c:type="gpointer"/>
39604
39642
  </parameter>
@@ -39615,7 +39653,7 @@ to be used as icon.</doc>
39615
39653
  transfer-ownership="none"
39616
39654
  nullable="1"
39617
39655
  allow-none="1"
39618
- closure="8">
39656
+ closure="7">
39619
39657
  <doc xml:space="preserve">the data to pass to callback function</doc>
39620
39658
  <type name="gpointer" c:type="gpointer"/>
39621
39659
  </parameter>
@@ -46858,10 +46896,14 @@ the value, and other property value pairs, and ended by %NULL.</doc>
46858
46896
  <function name="newv"
46859
46897
  c:identifier="g_initable_newv"
46860
46898
  version="2.22"
46899
+ deprecated="1"
46900
+ deprecated-version="2.54"
46861
46901
  throws="1">
46862
46902
  <doc xml:space="preserve">Helper function for constructing #GInitable object. This is
46863
46903
  similar to g_object_newv() but also initializes the object
46864
46904
  and returns %NULL, setting an error on failure.</doc>
46905
+ <doc-deprecated xml:space="preserve">Use g_object_new_with_properties() and
46906
+ g_initable_init() instead. See #GParameter for more information.</doc-deprecated>
46865
46907
  <return-value transfer-ownership="full">
46866
46908
  <doc xml:space="preserve">a newly allocated
46867
46909
  #GObject, or %NULL on error</doc>
@@ -46894,6 +46936,9 @@ and returns %NULL, setting an error on failure.</doc>
46894
46936
  <virtual-method name="init" invoker="init" version="2.22" throws="1">
46895
46937
  <doc xml:space="preserve">Initializes the object implementing the interface.
46896
46938
 
46939
+ This method is intended for language bindings. If writing in C,
46940
+ g_initable_new() should typically be used instead.
46941
+
46897
46942
  The object must be initialized before any real use after initial
46898
46943
  construction, either with this function or g_async_initable_init_async().
46899
46944
 
@@ -46909,11 +46954,24 @@ error, then all operations on the object except g_object_ref() and
46909
46954
  g_object_unref() are considered to be invalid, and have undefined
46910
46955
  behaviour. See the [introduction][ginitable] for more details.
46911
46956
 
46912
- Implementations of this method must be idempotent, i.e. multiple calls
46913
- to this function with the same argument should return the same results.
46914
- Only the first call initializes the object, further calls return the result
46915
- of the first call. This is so that it's safe to implement the singleton
46916
- pattern in the GObject constructor function.</doc>
46957
+ Callers should not assume that a class which implements #GInitable can be
46958
+ initialized multiple times, unless the class explicitly documents itself as
46959
+ supporting this. Generally, a class’ implementation of init() can assume
46960
+ (and assert) that it will only be called once. Previously, this documentation
46961
+ recommended all #GInitable implementations should be idempotent; that
46962
+ recommendation was relaxed in GLib 2.54.
46963
+
46964
+ If a class explicitly supports being initialized multiple times, it is
46965
+ recommended that the method is idempotent: multiple calls with the same
46966
+ arguments should return the same results. Only the first call initializes
46967
+ the object; further calls return the result of the first call.
46968
+
46969
+ One reason why a class might need to support idempotent initialization is if
46970
+ it is designed to be used via the singleton pattern, with a
46971
+ #GObjectClass.constructor that sometimes returns an existing instance.
46972
+ In this pattern, a caller would expect to be able to call g_initable_init()
46973
+ on the result of g_object_new(), regardless of whether it is in fact a new
46974
+ instance.</doc>
46917
46975
  <return-value transfer-ownership="none">
46918
46976
  <doc xml:space="preserve">%TRUE if successful. If an error has occurred, this function will
46919
46977
  return %FALSE and set @error appropriately if present.</doc>
@@ -46939,6 +46997,9 @@ pattern in the GObject constructor function.</doc>
46939
46997
  throws="1">
46940
46998
  <doc xml:space="preserve">Initializes the object implementing the interface.
46941
46999
 
47000
+ This method is intended for language bindings. If writing in C,
47001
+ g_initable_new() should typically be used instead.
47002
+
46942
47003
  The object must be initialized before any real use after initial
46943
47004
  construction, either with this function or g_async_initable_init_async().
46944
47005
 
@@ -46954,11 +47015,24 @@ error, then all operations on the object except g_object_ref() and
46954
47015
  g_object_unref() are considered to be invalid, and have undefined
46955
47016
  behaviour. See the [introduction][ginitable] for more details.
46956
47017
 
46957
- Implementations of this method must be idempotent, i.e. multiple calls
46958
- to this function with the same argument should return the same results.
46959
- Only the first call initializes the object, further calls return the result
46960
- of the first call. This is so that it's safe to implement the singleton
46961
- pattern in the GObject constructor function.</doc>
47018
+ Callers should not assume that a class which implements #GInitable can be
47019
+ initialized multiple times, unless the class explicitly documents itself as
47020
+ supporting this. Generally, a class’ implementation of init() can assume
47021
+ (and assert) that it will only be called once. Previously, this documentation
47022
+ recommended all #GInitable implementations should be idempotent; that
47023
+ recommendation was relaxed in GLib 2.54.
47024
+
47025
+ If a class explicitly supports being initialized multiple times, it is
47026
+ recommended that the method is idempotent: multiple calls with the same
47027
+ arguments should return the same results. Only the first call initializes
47028
+ the object; further calls return the result of the first call.
47029
+
47030
+ One reason why a class might need to support idempotent initialization is if
47031
+ it is designed to be used via the singleton pattern, with a
47032
+ #GObjectClass.constructor that sometimes returns an existing instance.
47033
+ In this pattern, a caller would expect to be able to call g_initable_init()
47034
+ on the result of g_object_new(), regardless of whether it is in fact a new
47035
+ instance.</doc>
46962
47036
  <return-value transfer-ownership="none">
46963
47037
  <doc xml:space="preserve">%TRUE if successful. If an error has occurred, this function will
46964
47038
  return %FALSE and set @error appropriately if present.</doc>
@@ -47100,7 +47174,7 @@ operation.
47100
47174
 
47101
47175
  For behaviour details see g_input_stream_close().
47102
47176
 
47103
- The asyncronous methods have a default fallback that uses threads to implement
47177
+ The asynchronous methods have a default fallback that uses threads to implement
47104
47178
  asynchronicity, so they are optional for inheriting classes. However, if you
47105
47179
  override one you must override all.</doc>
47106
47180
  <return-value transfer-ownership="none">
@@ -47195,7 +47269,7 @@ Any outstanding i/o request with higher priority (lower numerical value) will
47195
47269
  be executed before an outstanding request with lower priority. Default
47196
47270
  priority is %G_PRIORITY_DEFAULT.
47197
47271
 
47198
- The asyncronous methods have a default fallback that uses threads to implement
47272
+ The asynchronous methods have a default fallback that uses threads to implement
47199
47273
  asynchronicity, so they are optional for inheriting classes. However, if you
47200
47274
  override one you must override all.</doc>
47201
47275
  <return-value transfer-ownership="none">
@@ -47475,7 +47549,7 @@ operation.
47475
47549
 
47476
47550
  For behaviour details see g_input_stream_close().
47477
47551
 
47478
- The asyncronous methods have a default fallback that uses threads to implement
47552
+ The asynchronous methods have a default fallback that uses threads to implement
47479
47553
  asynchronicity, so they are optional for inheriting classes. However, if you
47480
47554
  override one you must override all.</doc>
47481
47555
  <return-value transfer-ownership="none">
@@ -47786,7 +47860,7 @@ Any outstanding i/o request with higher priority (lower numerical value) will
47786
47860
  be executed before an outstanding request with lower priority. Default
47787
47861
  priority is %G_PRIORITY_DEFAULT.
47788
47862
 
47789
- The asyncronous methods have a default fallback that uses threads to implement
47863
+ The asynchronous methods have a default fallback that uses threads to implement
47790
47864
  asynchronicity, so they are optional for inheriting classes. However, if you
47791
47865
  override one you must override all.</doc>
47792
47866
  <return-value transfer-ownership="none">
@@ -52143,7 +52217,7 @@ and the #GAsyncReady data to see if the operation was completed
52143
52217
  successfully. If an @error is present when g_mount_unmount_with_operation_finish()
52144
52218
  is called, then it will be filled with any error information.</doc>
52145
52219
  <virtual-method name="can_eject" invoker="can_eject">
52146
- <doc xml:space="preserve">Checks if @mount can be eject.</doc>
52220
+ <doc xml:space="preserve">Checks if @mount can be ejected.</doc>
52147
52221
  <return-value transfer-ownership="none">
52148
52222
  <doc xml:space="preserve">%TRUE if the @mount can be ejected.</doc>
52149
52223
  <type name="gboolean" c:type="gboolean"/>
@@ -52156,7 +52230,7 @@ is called, then it will be filled with any error information.</doc>
52156
52230
  </parameters>
52157
52231
  </virtual-method>
52158
52232
  <virtual-method name="can_unmount" invoker="can_unmount">
52159
- <doc xml:space="preserve">Checks if @mount can be mounted.</doc>
52233
+ <doc xml:space="preserve">Checks if @mount can be unmounted.</doc>
52160
52234
  <return-value transfer-ownership="none">
52161
52235
  <doc xml:space="preserve">%TRUE if the @mount can be unmounted.</doc>
52162
52236
  <type name="gboolean" c:type="gboolean"/>
@@ -52824,7 +52898,7 @@ and #GAsyncResult data returned in the @callback.</doc>
52824
52898
  </parameters>
52825
52899
  </virtual-method>
52826
52900
  <method name="can_eject" c:identifier="g_mount_can_eject">
52827
- <doc xml:space="preserve">Checks if @mount can be eject.</doc>
52901
+ <doc xml:space="preserve">Checks if @mount can be ejected.</doc>
52828
52902
  <return-value transfer-ownership="none">
52829
52903
  <doc xml:space="preserve">%TRUE if the @mount can be ejected.</doc>
52830
52904
  <type name="gboolean" c:type="gboolean"/>
@@ -52837,7 +52911,7 @@ and #GAsyncResult data returned in the @callback.</doc>
52837
52911
  </parameters>
52838
52912
  </method>
52839
52913
  <method name="can_unmount" c:identifier="g_mount_can_unmount">
52840
- <doc xml:space="preserve">Checks if @mount can be mounted.</doc>
52914
+ <doc xml:space="preserve">Checks if @mount can be unmounted.</doc>
52841
52915
  <return-value transfer-ownership="none">
52842
52916
  <doc xml:space="preserve">%TRUE if the @mount can be unmounted.</doc>
52843
52917
  <type name="gboolean" c:type="gboolean"/>
@@ -55259,8 +55333,11 @@ depending on what @addr was created with.</doc>
55259
55333
  glib:get-type="g_network_monitor_get_type"
55260
55334
  glib:type-struct="NetworkMonitorInterface">
55261
55335
  <doc xml:space="preserve">#GNetworkMonitor provides an easy-to-use cross-platform API
55262
- for monitoring network connectivity. On Linux, the implementation
55263
- is based on the kernel's netlink interface.</doc>
55336
+ for monitoring network connectivity. On Linux, the available
55337
+ implementations are based on the kernel's netlink interface and
55338
+ on NetworkManager.
55339
+
55340
+ There is also an implementation for use inside Flatpak sandboxes.</doc>
55264
55341
  <prerequisite name="Initable"/>
55265
55342
  <function name="get_default"
55266
55343
  c:identifier="g_network_monitor_get_default"
@@ -60553,7 +60630,11 @@ specify one.</doc>
60553
60630
  glib:type-struct="ProxyResolverInterface">
60554
60631
  <doc xml:space="preserve">#GProxyResolver provides synchronous and asynchronous network proxy
60555
60632
  resolution. #GProxyResolver is used within #GSocketClient through
60556
- the method g_socket_connectable_proxy_enumerate().</doc>
60633
+ the method g_socket_connectable_proxy_enumerate().
60634
+
60635
+ Implementations of #GProxyResolver based on libproxy and GNOME settings can
60636
+ be found in glib-networking. GIO comes with an implementation for use inside
60637
+ Flatpak portals.</doc>
60557
60638
  <function name="get_default"
60558
60639
  c:identifier="g_proxy_resolver_get_default"
60559
60640
  version="2.26">
@@ -62792,6 +62873,13 @@ program must be in the PATH, or the `GDK_PIXBUF_PIXDATA` environment variable mu
62792
62873
  set to the full path to the gdk-pixbuf-pixdata executable; otherwise the resource compiler will
62793
62874
  abort.
62794
62875
 
62876
+ Resource files will be exported in the GResource namespace using the
62877
+ combination of the given `prefix` and the filename from the `file` element.
62878
+ The `alias` attribute can be used to alter the filename to expose them at a
62879
+ different location in the resource namespace. Typically, this is used to
62880
+ include files from a different source directory without exposing the source
62881
+ directory in the resource namespace, as in the example below.
62882
+
62795
62883
  Resource bundles are created by the [glib-compile-resources][glib-compile-resources] program
62796
62884
  which takes an XML file that describes the bundle, and a set of files that the XML references. These
62797
62885
  are combined into a binary resource bundle.
@@ -62804,6 +62892,7 @@ An example resource description:
62804
62892
  &lt;file&gt;data/splashscreen.png&lt;/file&gt;
62805
62893
  &lt;file compressed="true"&gt;dialog.ui&lt;/file&gt;
62806
62894
  &lt;file preprocess="xml-stripblanks"&gt;menumarkup.xml&lt;/file&gt;
62895
+ &lt;file alias="example.css"&gt;data/example.css&lt;/file&gt;
62807
62896
  &lt;/gresource&gt;
62808
62897
  &lt;/gresources&gt;
62809
62898
  ]|
@@ -62813,6 +62902,7 @@ This will create a resource bundle with the following files:
62813
62902
  /org/gtk/Example/data/splashscreen.png
62814
62903
  /org/gtk/Example/dialog.ui
62815
62904
  /org/gtk/Example/menumarkup.xml
62905
+ /org/gtk/Example/example.css
62816
62906
  ]|
62817
62907
 
62818
62908
  Note that all resources in the process share the same namespace, so use Java-style
@@ -62833,22 +62923,24 @@ using API calls like g_resources_open_stream() to stream the data or g_resources
62833
62923
  to the data. You can also use URIs like "resource:///org/gtk/Example/data/splashscreen.png" with #GFile to access
62834
62924
  the resource data.
62835
62925
 
62926
+ Some higher-level APIs, such as #GtkApplication, will automatically load
62927
+ resources from certain well-known paths in the resource namespace as a
62928
+ convenience. See the documentation for those APIs for details.
62929
+
62836
62930
  There are two forms of the generated source, the default version uses the compiler support for constructor
62837
62931
  and destructor functions (where available) to automatically create and register the #GResource on startup
62838
- or library load time. If you pass --manual-register two functions to register/unregister the resource is instead
62839
- created. This requires an explicit initialization call in your application/library, but it works on all platforms,
62840
- even on the minor ones where this is not available. (Constructor support is available for at least Win32, Mac OS and Linux.)
62932
+ or library load time. If you pass `--manual-register`, two functions to register/unregister the resource are created
62933
+ instead. This requires an explicit initialization call in your application/library, but it works on all platforms,
62934
+ even on the minor ones where constructors are not supported. (Constructor support is available for at least Win32, Mac OS and Linux.)
62841
62935
 
62842
62936
  Note that resource data can point directly into the data segment of e.g. a library, so if you are unloading libraries
62843
62937
  during runtime you need to be very careful with keeping around pointers to data from a resource, as this goes away
62844
62938
  when the library is unloaded. However, in practice this is not generally a problem, since most resource accesses
62845
- is for your own resources, and resource data is often used once, during parsing, and then released.
62939
+ are for your own resources, and resource data is often used once, during parsing, and then released.
62846
62940
 
62847
62941
  When debugging a program or testing a change to an installed version, it is often useful to be able to
62848
62942
  replace resources in the program or library, without recompiling, for debugging or quick hacking and testing
62849
- purposes.
62850
-
62851
- Since GLib 2.50, it is possible to use the `G_RESOURCE_OVERLAYS` environment variable to selectively overlay
62943
+ purposes. Since GLib 2.50, it is possible to use the `G_RESOURCE_OVERLAYS` environment variable to selectively overlay
62852
62944
  resources with replacements from the filesystem. It is a colon-separated list of substitutions to perform
62853
62945
  during resource lookups.
62854
62946
 
@@ -64026,8 +64118,7 @@ of your whole loop.</doc-deprecated>
64026
64118
  </return-value>
64027
64119
  </function>
64028
64120
  <function name="sync" c:identifier="g_settings_sync">
64029
- <doc xml:space="preserve">Ensures that all pending operations for the given are complete for
64030
- the default backend.
64121
+ <doc xml:space="preserve">Ensures that all pending operations are complete for the default backend.
64031
64122
 
64032
64123
  Writes made to a #GSettings are handled asynchronously. For this
64033
64124
  reason, it is very unlikely that the changes have it to disk by the
@@ -69773,10 +69864,11 @@ the peer, or -1 on error</doc>
69773
69864
  direction="out"
69774
69865
  caller-allocates="0"
69775
69866
  transfer-ownership="full"
69867
+ nullable="1"
69776
69868
  optional="1"
69777
69869
  allow-none="1">
69778
- <doc xml:space="preserve">a pointer which
69779
- may be filled with an array of #GSocketControlMessages, or %NULL</doc>
69870
+ <doc xml:space="preserve">a pointer
69871
+ which may be filled with an array of #GSocketControlMessages, or %NULL</doc>
69780
69872
  <array length="4"
69781
69873
  zero-terminated="0"
69782
69874
  c:type="GSocketControlMessage***">
@@ -73417,6 +73509,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
73417
73509
  direction="out"
73418
73510
  caller-allocates="0"
73419
73511
  transfer-ownership="none"
73512
+ nullable="1"
73420
73513
  optional="1"
73421
73514
  allow-none="1">
73422
73515
  <doc xml:space="preserve">location where #GObject pointer will be stored, or %NULL</doc>
@@ -73494,6 +73587,7 @@ to get the result of the operation.</doc>
73494
73587
  direction="out"
73495
73588
  caller-allocates="0"
73496
73589
  transfer-ownership="none"
73590
+ nullable="1"
73497
73591
  optional="1"
73498
73592
  allow-none="1">
73499
73593
  <doc xml:space="preserve">Optional #GObject identifying this source</doc>
@@ -73532,6 +73626,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
73532
73626
  direction="out"
73533
73627
  caller-allocates="0"
73534
73628
  transfer-ownership="none"
73629
+ nullable="1"
73535
73630
  optional="1"
73536
73631
  allow-none="1">
73537
73632
  <doc xml:space="preserve">location where #GObject pointer will be stored, or %NULL.</doc>
@@ -73609,6 +73704,7 @@ to get the result of the operation.</doc>
73609
73704
  direction="out"
73610
73705
  caller-allocates="0"
73611
73706
  transfer-ownership="none"
73707
+ nullable="1"
73612
73708
  optional="1"
73613
73709
  allow-none="1">
73614
73710
  <doc xml:space="preserve">Optional #GObject identifying this source</doc>
@@ -75573,8 +75669,12 @@ g_environ_unsetenv(), etc.
75573
75669
  As an alternative, you can use g_subprocess_launcher_setenv(),
75574
75670
  g_subprocess_launcher_unsetenv(), etc.
75575
75671
 
75576
- Pass %NULL to inherit the parent process' environment. Pass an
75577
- empty array to set an empty environment.
75672
+ Pass an empty array to set an empty environment. Pass %NULL to inherit the
75673
+ parent process’ environment. As of GLib 2.54, the parent process’ environment
75674
+ will be copied when g_subprocess_launcher_set_environ() is called.
75675
+ Previously, it was copied when the subprocess was executed. This means the
75676
+ copied environment may now be modified (using g_subprocess_launcher_setenv(),
75677
+ etc.) before launching the subprocess.
75578
75678
 
75579
75679
  On UNIX, all strings in this array can be arbitrary byte strings.
75580
75680
  On Windows, they should be in UTF-8.</doc>
@@ -86827,13 +86927,17 @@ g_app_info_remove_supports_type().</doc>
86827
86927
  <function name="async_initable_newv_async"
86828
86928
  c:identifier="g_async_initable_newv_async"
86829
86929
  moved-to="AsyncInitable.newv_async"
86830
- version="2.22">
86930
+ version="2.22"
86931
+ deprecated="1"
86932
+ deprecated-version="2.54">
86831
86933
  <doc xml:space="preserve">Helper function for constructing #GAsyncInitable object. This is
86832
86934
  similar to g_object_newv() but also initializes the object asynchronously.
86833
86935
 
86834
86936
  When the initialization is finished, @callback will be called. You can
86835
86937
  then call g_async_initable_new_finish() to get the new object and check
86836
86938
  for any errors.</doc>
86939
+ <doc-deprecated xml:space="preserve">Use g_object_new_with_properties() and
86940
+ g_async_initable_init_async() instead. See #GParameter for more information.</doc-deprecated>
86837
86941
  <return-value transfer-ownership="none">
86838
86942
  <type name="none" c:type="void"/>
86839
86943
  </return-value>
@@ -88261,7 +88365,11 @@ See the g_dbus_gvariant_to_gvalue() function for how to convert a
88261
88365
  <doc xml:space="preserve">Converts a #GVariant to a #GValue. If @value is floating, it is consumed.
88262
88366
 
88263
88367
  The rules specified in the g_dbus_gvalue_to_gvariant() function are
88264
- used - this function is essentially its reverse form.
88368
+ used - this function is essentially its reverse form. So, a #GVariant
88369
+ containing any basic or string array type will be converted to a #GValue
88370
+ containing a basic value or string array. Any other #GVariant (handle,
88371
+ variant, tuple, dict entry) will be converted to a #GValue containing that
88372
+ #GVariant.
88265
88373
 
88266
88374
  The conversion never fails - a valid #GValue is always returned in
88267
88375
  @out_gvalue.</doc>
@@ -88657,10 +88765,14 @@ with the type system prior to calling g_icon_new_for_string().</doc>
88657
88765
  c:identifier="g_initable_newv"
88658
88766
  moved-to="Initable.newv"
88659
88767
  version="2.22"
88768
+ deprecated="1"
88769
+ deprecated-version="2.54"
88660
88770
  throws="1">
88661
88771
  <doc xml:space="preserve">Helper function for constructing #GInitable object. This is
88662
88772
  similar to g_object_newv() but also initializes the object
88663
88773
  and returns %NULL, setting an error on failure.</doc>
88774
+ <doc-deprecated xml:space="preserve">Use g_object_new_with_properties() and
88775
+ g_initable_init() instead. See #GParameter for more information.</doc-deprecated>
88664
88776
  <return-value transfer-ownership="full">
88665
88777
  <doc xml:space="preserve">a newly allocated
88666
88778
  #GObject, or %NULL on error</doc>
@@ -88694,7 +88806,10 @@ and returns %NULL, setting an error on failure.</doc>
88694
88806
  <doc xml:space="preserve">Converts errno.h error codes into GIO error codes. The fallback
88695
88807
  value %G_IO_ERROR_FAILED is returned for error codes not currently
88696
88808
  handled (but note that future GLib releases may return a more
88697
- specific value instead).</doc>
88809
+ specific value instead).
88810
+
88811
+ As %errno is global and may be modified by intermediate function
88812
+ calls, you should save its value as soon as the call which sets it</doc>
88698
88813
  <return-value transfer-ownership="none">
88699
88814
  <doc xml:space="preserve">#GIOErrorEnum value for the given errno.h error number.</doc>
88700
88815
  <type name="IOErrorEnum" c:type="GIOErrorEnum"/>
@@ -89433,8 +89548,8 @@ globally registered resources and if found returns information about it.
89433
89548
  transfer-ownership="full"
89434
89549
  optional="1"
89435
89550
  allow-none="1">
89436
- <doc xml:space="preserve">a location to place the flags about the file,
89437
- or %NULL if the length is not needed</doc>
89551
+ <doc xml:space="preserve">a location to place the #GResourceFlags about the file,
89552
+ or %NULL if the flags are not needed</doc>
89438
89553
  <type name="guint32" c:type="guint32*"/>
89439
89554
  </parameter>
89440
89555
  </parameters>