gobject-introspection 2.2.5-x64-mingw32 → 3.0.0-x64-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (108) hide show
  1. checksums.yaml +4 -4
  2. data/Rakefile +3 -3
  3. data/ext/gobject-introspection/extconf.rb +1 -1
  4. data/ext/gobject-introspection/rb-gi-argument.c +2275 -708
  5. data/ext/gobject-introspection/rb-gi-constant-info.c +1 -1
  6. data/ext/gobject-introspection/rb-gi-constructor-info.c +2 -2
  7. data/ext/gobject-introspection/rb-gi-conversions.h +40 -36
  8. data/ext/gobject-introspection/rb-gi-field-info.c +32 -6
  9. data/ext/gobject-introspection/rb-gi-function-info.c +98 -63
  10. data/ext/gobject-introspection/rb-gi-loader.c +33 -1
  11. data/ext/gobject-introspection/rb-gi-method-info.c +3 -6
  12. data/ext/gobject-introspection/rb-gi-private.h +2 -1
  13. data/ext/gobject-introspection/rb-gi-repository.c +29 -29
  14. data/lib/2.0/gobject_introspection.so +0 -0
  15. data/lib/2.1/gobject_introspection.so +0 -0
  16. data/lib/2.2/gobject_introspection.so +0 -0
  17. data/lib/gobject-introspection.rb +1 -0
  18. data/lib/gobject-introspection/arg-info.rb +27 -0
  19. data/lib/gobject-introspection/callable-info.rb +3 -1
  20. data/lib/gobject-introspection/loader.rb +160 -31
  21. data/vendor/local/bin/g-ir-compiler.exe +0 -0
  22. data/vendor/local/bin/g-ir-generate.exe +0 -0
  23. data/vendor/local/bin/libgirepository-1.0-1.dll +0 -0
  24. data/vendor/local/include/gobject-introspection-1.0/girepository.h +4 -0
  25. data/vendor/local/include/gobject-introspection-1.0/giversionmacros.h +15 -1
  26. data/vendor/local/lib/girepository-1.0/GIRepository-2.0.typelib +0 -0
  27. data/vendor/local/lib/girepository-1.0/GLib-2.0.typelib +0 -0
  28. data/vendor/local/lib/girepository-1.0/GObject-2.0.typelib +0 -0
  29. data/vendor/local/lib/girepository-1.0/Gio-2.0.typelib +0 -0
  30. data/vendor/local/lib/gobject-introspection/giscanner/__init__.pyc +0 -0
  31. data/vendor/local/lib/gobject-introspection/giscanner/__init__.pyo +0 -0
  32. data/vendor/local/lib/gobject-introspection/giscanner/annotationmain.pyc +0 -0
  33. data/vendor/local/lib/gobject-introspection/giscanner/annotationmain.pyo +0 -0
  34. data/vendor/local/lib/gobject-introspection/giscanner/annotationparser.py +6 -1
  35. data/vendor/local/lib/gobject-introspection/giscanner/annotationparser.pyc +0 -0
  36. data/vendor/local/lib/gobject-introspection/giscanner/annotationparser.pyo +0 -0
  37. data/vendor/local/lib/gobject-introspection/giscanner/ast.py +3 -0
  38. data/vendor/local/lib/gobject-introspection/giscanner/ast.pyc +0 -0
  39. data/vendor/local/lib/gobject-introspection/giscanner/ast.pyo +0 -0
  40. data/vendor/local/lib/gobject-introspection/giscanner/cachestore.pyc +0 -0
  41. data/vendor/local/lib/gobject-introspection/giscanner/cachestore.pyo +0 -0
  42. data/vendor/local/lib/gobject-introspection/giscanner/ccompiler.pyc +0 -0
  43. data/vendor/local/lib/gobject-introspection/giscanner/ccompiler.pyo +0 -0
  44. data/vendor/local/lib/gobject-introspection/giscanner/codegen.pyc +0 -0
  45. data/vendor/local/lib/gobject-introspection/giscanner/codegen.pyo +0 -0
  46. data/vendor/local/lib/gobject-introspection/giscanner/collections/__init__.pyc +0 -0
  47. data/vendor/local/lib/gobject-introspection/giscanner/collections/__init__.pyo +0 -0
  48. data/vendor/local/lib/gobject-introspection/giscanner/collections/counter.pyc +0 -0
  49. data/vendor/local/lib/gobject-introspection/giscanner/collections/counter.pyo +0 -0
  50. data/vendor/local/lib/gobject-introspection/giscanner/collections/ordereddict.pyc +0 -0
  51. data/vendor/local/lib/gobject-introspection/giscanner/collections/ordereddict.pyo +0 -0
  52. data/vendor/local/lib/gobject-introspection/giscanner/docmain.pyc +0 -0
  53. data/vendor/local/lib/gobject-introspection/giscanner/docmain.pyo +0 -0
  54. data/vendor/local/lib/gobject-introspection/giscanner/docwriter.pyc +0 -0
  55. data/vendor/local/lib/gobject-introspection/giscanner/docwriter.pyo +0 -0
  56. data/vendor/local/lib/gobject-introspection/giscanner/dumper.pyc +0 -0
  57. data/vendor/local/lib/gobject-introspection/giscanner/dumper.pyo +0 -0
  58. data/vendor/local/lib/gobject-introspection/giscanner/gdumpparser.pyc +0 -0
  59. data/vendor/local/lib/gobject-introspection/giscanner/gdumpparser.pyo +0 -0
  60. data/vendor/local/lib/gobject-introspection/giscanner/girparser.py +19 -1
  61. data/vendor/local/lib/gobject-introspection/giscanner/girparser.pyc +0 -0
  62. data/vendor/local/lib/gobject-introspection/giscanner/girparser.pyo +0 -0
  63. data/vendor/local/lib/gobject-introspection/giscanner/girwriter.pyc +0 -0
  64. data/vendor/local/lib/gobject-introspection/giscanner/girwriter.pyo +0 -0
  65. data/vendor/local/lib/gobject-introspection/giscanner/introspectablepass.pyc +0 -0
  66. data/vendor/local/lib/gobject-introspection/giscanner/introspectablepass.pyo +0 -0
  67. data/vendor/local/lib/gobject-introspection/giscanner/libtoolimporter.pyc +0 -0
  68. data/vendor/local/lib/gobject-introspection/giscanner/libtoolimporter.pyo +0 -0
  69. data/vendor/local/lib/gobject-introspection/giscanner/maintransformer.py +7 -3
  70. data/vendor/local/lib/gobject-introspection/giscanner/maintransformer.pyc +0 -0
  71. data/vendor/local/lib/gobject-introspection/giscanner/maintransformer.pyo +0 -0
  72. data/vendor/local/lib/gobject-introspection/giscanner/message.pyc +0 -0
  73. data/vendor/local/lib/gobject-introspection/giscanner/message.pyo +0 -0
  74. data/vendor/local/lib/gobject-introspection/giscanner/scannermain.py +1 -1
  75. data/vendor/local/lib/gobject-introspection/giscanner/scannermain.pyc +0 -0
  76. data/vendor/local/lib/gobject-introspection/giscanner/scannermain.pyo +0 -0
  77. data/vendor/local/lib/gobject-introspection/giscanner/sectionparser.pyc +0 -0
  78. data/vendor/local/lib/gobject-introspection/giscanner/sectionparser.pyo +0 -0
  79. data/vendor/local/lib/gobject-introspection/giscanner/shlibs.pyc +0 -0
  80. data/vendor/local/lib/gobject-introspection/giscanner/shlibs.pyo +0 -0
  81. data/vendor/local/lib/gobject-introspection/giscanner/sourcescanner.py +8 -0
  82. data/vendor/local/lib/gobject-introspection/giscanner/sourcescanner.pyc +0 -0
  83. data/vendor/local/lib/gobject-introspection/giscanner/sourcescanner.pyo +0 -0
  84. data/vendor/local/lib/gobject-introspection/giscanner/testcodegen.pyc +0 -0
  85. data/vendor/local/lib/gobject-introspection/giscanner/testcodegen.pyo +0 -0
  86. data/vendor/local/lib/gobject-introspection/giscanner/transformer.pyc +0 -0
  87. data/vendor/local/lib/gobject-introspection/giscanner/transformer.pyo +0 -0
  88. data/vendor/local/lib/gobject-introspection/giscanner/utils.pyc +0 -0
  89. data/vendor/local/lib/gobject-introspection/giscanner/utils.pyo +0 -0
  90. data/vendor/local/lib/gobject-introspection/giscanner/xmlwriter.pyc +0 -0
  91. data/vendor/local/lib/gobject-introspection/giscanner/xmlwriter.pyo +0 -0
  92. data/vendor/local/lib/libgirepository-1.0.a +0 -0
  93. data/vendor/local/lib/libgirepository-1.0.dll.a +0 -0
  94. data/vendor/local/lib/libgirepository-1.0.la +3 -3
  95. data/vendor/local/lib/pkgconfig/gobject-introspection-1.0.pc +1 -1
  96. data/vendor/local/lib/pkgconfig/gobject-introspection-no-export-1.0.pc +1 -1
  97. data/vendor/local/share/gir-1.0/GIRepository-2.0.gir +44 -7
  98. data/vendor/local/share/gir-1.0/GLib-2.0.gir +518 -131
  99. data/vendor/local/share/gir-1.0/GObject-2.0.gir +1248 -475
  100. data/vendor/local/share/gir-1.0/Gio-2.0.gir +1849 -80
  101. data/vendor/local/share/gobject-introspection-1.0/tests/annotation.c +1 -1
  102. data/vendor/local/share/gobject-introspection-1.0/tests/gimarshallingtests.c +19 -16
  103. data/vendor/local/share/gobject-introspection-1.0/tests/gimarshallingtests.h +1 -1
  104. data/vendor/local/share/gobject-introspection-1.0/tests/regress.c +3 -0
  105. data/vendor/local/share/gobject-introspection-1.0/tests/regress.h +2 -2
  106. data/vendor/local/share/man/man1/g-ir-compiler.1 +1 -2
  107. data/vendor/local/share/man/man1/g-ir-generate.1 +2 -3
  108. metadata +5 -4
Binary file
Binary file
@@ -143,6 +143,10 @@ GITypelib * g_irepository_require_private (GIRepository *repository,
143
143
  GIRepositoryLoadFlags flags,
144
144
  GError **error);
145
145
 
146
+ GI_AVAILABLE_IN_1_44
147
+ gchar ** g_irepository_get_immediate_dependencies (GIRepository *repository,
148
+ const gchar *namespace_);
149
+
146
150
  GI_AVAILABLE_IN_ALL
147
151
  gchar ** g_irepository_get_dependencies (GIRepository *repository,
148
152
  const gchar *namespace_);
@@ -125,4 +125,18 @@
125
125
  # define GI_AVAILABLE_IN_1_42 _GI_EXTERN
126
126
  #endif
127
127
 
128
- #endif /* __GIVERSIONMACROS_H__ */
128
+ #if GLIB_VERSION_MIN_REQUIRED >= GLIB_VERSION_2_44
129
+ # define GI_DEPRECATED_IN_1_44 GLIB_DEPRECATED
130
+ # define GI_DEPRECATED_IN_1_44_FOR(f) GLIB_DEPRECATED_FOR(f)
131
+ #else
132
+ # define GI_DEPRECATED_IN_1_44 _GI_EXTERN
133
+ # define GI_DEPRECATED_IN_1_44_FOR(f) _GI_EXTERN
134
+ #endif
135
+
136
+ #if GLIB_VERSION_MAX_ALLOWED < GLIB_VERSION_2_44
137
+ # define GI_AVAILABLE_IN_1_44 GLIB_UNAVAILABLE(2, 44)
138
+ #else
139
+ # define GI_AVAILABLE_IN_1_44 _GI_EXTERN
140
+ #endif
141
+
142
+ #endif /* __GIVERSIONMACROS_H__ */
@@ -652,7 +652,7 @@ class GtkDocAnnotatable(object):
652
652
  return
653
653
 
654
654
  for option, value in options.items():
655
- if option in [OPT_ARRAY_ZERO_TERMINATED, OPT_ARRAY_FIXED_SIZE]:
655
+ if option == OPT_ARRAY_FIXED_SIZE:
656
656
  try:
657
657
  int(value)
658
658
  except (TypeError, ValueError):
@@ -663,6 +663,11 @@ class GtkDocAnnotatable(object):
663
663
  warn('invalid "%s" annotation option "%s" value "%s", must be an integer' %
664
664
  (ann_name, option, value),
665
665
  position)
666
+ elif option == OPT_ARRAY_ZERO_TERMINATED:
667
+ if value is not None and value not in ['0', '1']:
668
+ warn('invalid "%s" annotation option "%s" value "%s", must be 0 or 1' %
669
+ (ann_name, option, value),
670
+ position)
666
671
  elif option == OPT_ARRAY_LENGTH:
667
672
  if value is None:
668
673
  warn('"%s" annotation option "length" needs a value' % (ann_name, ),
@@ -284,6 +284,8 @@ type_names['int32_t'] = TYPE_INT32
284
284
  type_names['uint32_t'] = TYPE_UINT32
285
285
  type_names['int64_t'] = TYPE_INT64
286
286
  type_names['uint64_t'] = TYPE_UINT64
287
+ # C99 stdbool
288
+ type_names['bool'] = TYPE_BOOLEAN
287
289
 
288
290
  # A few additional GLib type aliases
289
291
  type_names['guchar'] = TYPE_UINT8
@@ -374,6 +376,7 @@ class Namespace(object):
374
376
  self.type_names = {} # Maps from GTName -> node
375
377
  self.ctypes = {} # Maps from CType -> node
376
378
  self.symbols = {} # Maps from function symbols -> Function
379
+ # Immediate includes only, not their transitive closure:
377
380
  self.includes = set() # Include
378
381
  self.shared_libraries = [] # str
379
382
  self.c_includes = [] # str
@@ -24,6 +24,7 @@ from xml.etree.cElementTree import parse
24
24
 
25
25
  from . import ast
26
26
  from .girwriter import COMPATIBLE_GIR_VERSION
27
+ from .collections import OrderedDict
27
28
 
28
29
  CORE_NS = "http://www.gtk.org/introspection/core/1.0"
29
30
  C_NS = "http://www.gtk.org/introspection/c/1.0"
@@ -165,9 +166,18 @@ class GIRParser(object):
165
166
 
166
167
  def _parse_generic_attribs(self, node, obj):
167
168
  assert isinstance(obj, ast.Annotated)
169
+ skip = node.attrib.get('skip')
170
+ if skip:
171
+ try:
172
+ obj.skip = int(skip) > 0
173
+ except ValueError:
174
+ obj.skip = False
168
175
  introspectable = node.attrib.get('introspectable')
169
176
  if introspectable:
170
- obj.introspectable = int(introspectable) > 0
177
+ try:
178
+ obj.introspectable = int(introspectable) > 0
179
+ except ValueError:
180
+ obj.introspectable = False
171
181
  if self._types_only:
172
182
  return
173
183
  doc = node.find(_corens('doc'))
@@ -195,6 +205,14 @@ class GIRParser(object):
195
205
  if stability_doc is not None:
196
206
  if stability_doc.text:
197
207
  obj.stability_doc = stability_doc.text
208
+ attributes = node.findall(_corens('attribute'))
209
+ if attributes:
210
+ attributes_ = OrderedDict()
211
+ for attribute in attributes:
212
+ name = attribute.attrib.get('name')
213
+ value = attribute.attrib.get('value')
214
+ attributes_[name] = value
215
+ obj.attributes = attributes_
198
216
 
199
217
  def _parse_object_interface(self, node):
200
218
  parent = node.attrib.get('parent')
@@ -386,10 +386,14 @@ class MainTransformer(object):
386
386
  array_options = annotations.get(ANN_ARRAY)
387
387
  container_type = ast.Array(array_type, element_type_node, ctype=node.type.ctype,
388
388
  is_const=node.type.is_const)
389
- if OPT_ARRAY_ZERO_TERMINATED in array_options:
390
- container_type.zeroterminated = array_options.get(OPT_ARRAY_ZERO_TERMINATED) == '1'
391
- else:
389
+ if array_options.get(OPT_ARRAY_ZERO_TERMINATED, '0') == '0':
392
390
  container_type.zeroterminated = False
391
+ else:
392
+ if (OPT_ARRAY_ZERO_TERMINATED in array_options
393
+ or array_options.get(OPT_ARRAY_ZERO_TERMINATED) == '1'):
394
+ container_type.zeroterminated = True
395
+ else:
396
+ container_type.zeroterminated = False
393
397
 
394
398
  length = array_options.get(OPT_ARRAY_LENGTH)
395
399
  if length:
@@ -280,7 +280,7 @@ def process_options(output, allowed_flags):
280
280
 
281
281
 
282
282
  def process_packages(options, packages):
283
- args = ['pkg-config', '--cflags']
283
+ args = [os.environ.get('PKG_CONFIG', 'pkg-config'), '--cflags']
284
284
  args.extend(packages)
285
285
  output = subprocess.Popen(args,
286
286
  stdout=subprocess.PIPE).communicate()[0]
@@ -294,6 +294,14 @@ class SourceScanner(object):
294
294
  cpp_args += ['-E', '-C', '-I.', '-']
295
295
  cpp_args += self._cpp_options
296
296
 
297
+ # We expect the preprocessor to remove macros. If debugging is turned
298
+ # up high enough that won't happen, so strip these out. Bug #720504
299
+ for flag in ['-g3', '-ggdb3', '-gstabs3', '-gcoff3', '-gxcoff3', '-gvms3']:
300
+ try:
301
+ cpp_args.remove(flag)
302
+ except ValueError:
303
+ pass
304
+
297
305
  proc = subprocess.Popen(cpp_args,
298
306
  stdin=subprocess.PIPE,
299
307
  stdout=subprocess.PIPE)
Binary file
@@ -1,5 +1,5 @@
1
1
  # libgirepository-1.0.la - a libtool library file
2
- # Generated by libtool (GNU libtool) 2.4.2
2
+ # Generated by libtool (GNU libtool) 2.4.2 Debian-2.4.2-1.11
3
3
  #
4
4
  # Please DO NOT delete this file!
5
5
  # It is necessary for linking the library.
@@ -14,10 +14,10 @@ library_names='libgirepository-1.0.dll.a'
14
14
  old_library='libgirepository-1.0.a'
15
15
 
16
16
  # Linker flags that can not go in dependency_libs.
17
- inherited_linker_flags=''
17
+ inherited_linker_flags=' -pthread'
18
18
 
19
19
  # Libraries that this one depends upon.
20
- dependency_libs=' -R/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib -L/home/vagrant/rcairo.win64/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/gobject-introspection/vendor/local/lib /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgio-2.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgmodule-2.0.la -ldnsapi -liphlpapi -lz /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgobject-2.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libglib-2.0.la -lws2_32 -lole32 -lwinmm -lshlwapi /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libintl.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libiconv.la -lpthread /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libffi.la'
20
+ dependency_libs=' -R/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib -L/home/vagrant/rcairo.win64/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/gobject-introspection/vendor/local/lib /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgio-2.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgmodule-2.0.la -ldnsapi -liphlpapi -lz /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgobject-2.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libglib-2.0.la -lws2_32 -lole32 -lwinmm -lshlwapi /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libintl.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libiconv.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libffi.la'
21
21
 
22
22
  # Names of additional weak libraries provided by this library
23
23
  weak_library_names=''
@@ -23,4 +23,4 @@ Libs.private:
23
23
 
24
24
  Name: gobject-introspection
25
25
  Description: GObject Introspection
26
- Version: 1.42.0
26
+ Version: 1.44.0
@@ -20,4 +20,4 @@ Libs.private:
20
20
 
21
21
  Name: gobject-introspection
22
22
  Description: GObject Introspection
23
- Version: 1.42.0
23
+ Version: 1.44.0
@@ -882,9 +882,45 @@ such as g_irepository_require() before calling this function.</doc>
882
882
  &lt;code&gt;namespace-version&lt;/code&gt;.
883
883
 
884
884
  Note: @namespace_ must have already been loaded using a function
885
- such as g_irepository_require() before calling this function.</doc>
885
+ such as g_irepository_require() before calling this function.
886
+
887
+ To get only the immediate dependencies for @namespace_, use
888
+ g_irepository_get_immediate_dependencies().</doc>
889
+ <return-value transfer-ownership="full">
890
+ <doc xml:space="preserve">Zero-terminated string array of all versioned
891
+ dependencies</doc>
892
+ <array c:type="gchar**">
893
+ <type name="utf8"/>
894
+ </array>
895
+ </return-value>
896
+ <parameters>
897
+ <instance-parameter name="repository"
898
+ transfer-ownership="none"
899
+ nullable="1"
900
+ allow-none="1">
901
+ <doc xml:space="preserve">A #GIRepository or %NULL for the singleton
902
+ process-global default #GIRepository</doc>
903
+ <type name="Repository" c:type="GIRepository*"/>
904
+ </instance-parameter>
905
+ <parameter name="namespace_" transfer-ownership="none">
906
+ <doc xml:space="preserve">Namespace of interest</doc>
907
+ <type name="utf8" c:type="const gchar*"/>
908
+ </parameter>
909
+ </parameters>
910
+ </method>
911
+ <method name="get_immediate_dependencies"
912
+ c:identifier="g_irepository_get_immediate_dependencies"
913
+ version="1.44">
914
+ <doc xml:space="preserve">Return an array of the immediate versioned dependencies for @namespace_.
915
+ Returned strings are of the form &lt;code&gt;namespace-version&lt;/code&gt;.
916
+
917
+ Note: @namespace_ must have already been loaded using a function
918
+ such as g_irepository_require() before calling this function.
919
+
920
+ To get the transitive closure of dependencies for @namespace_, use
921
+ g_irepository_get_dependencies().</doc>
886
922
  <return-value transfer-ownership="full">
887
- <doc xml:space="preserve">Zero-terminated string array of versioned
923
+ <doc xml:space="preserve">Zero-terminated string array of immediate versioned
888
924
  dependencies</doc>
889
925
  <array c:type="gchar**">
890
926
  <type name="utf8"/>
@@ -979,15 +1015,16 @@ already been loaded before calling this function.</doc>
979
1015
  </method>
980
1016
  <method name="get_shared_library"
981
1017
  c:identifier="g_irepository_get_shared_library">
982
- <doc xml:space="preserve">This function returns the full path to the shared C library
983
- associated with the given namespace @namespace_. There may be no
984
- shared library path associated, in which case this function will
985
- return %NULL.
1018
+ <doc xml:space="preserve">This function returns a comma-separated list of paths to the
1019
+ shared C libraries associated with the given namespace @namespace_.
1020
+ There may be no shared library path associated, in which case this
1021
+ function will return %NULL.
986
1022
 
987
1023
  Note: The namespace must have already been loaded using a function
988
1024
  such as g_irepository_require() before calling this function.</doc>
989
1025
  <return-value transfer-ownership="none">
990
- <doc xml:space="preserve">Full path to shared library, or %NULL if none associated</doc>
1026
+ <doc xml:space="preserve">Comma-separated list of paths to shared libraries,
1027
+ or %NULL if none are associated</doc>
991
1028
  <type name="utf8" c:type="const gchar*"/>
992
1029
  </return-value>
993
1030
  <parameters>
@@ -13,17 +13,94 @@ and/or use gtk-doc annotations. -->
13
13
  shared-library="libglib-2.0-0.dll,libgobject-2.0-0.dll"
14
14
  c:identifier-prefixes="G"
15
15
  c:symbol-prefixes="g,glib">
16
+ <alias name="Array_autoptr" c:type="GArray_autoptr">
17
+ <type name="gpointer" c:type="gpointer"/>
18
+ </alias>
19
+ <alias name="AsyncQueue_autoptr" c:type="GAsyncQueue_autoptr">
20
+ <type name="gpointer" c:type="gpointer"/>
21
+ </alias>
22
+ <alias name="BookmarkFile_autoptr" c:type="GBookmarkFile_autoptr">
23
+ <type name="gpointer" c:type="gpointer"/>
24
+ </alias>
25
+ <alias name="ByteArray_autoptr" c:type="GByteArray_autoptr">
26
+ <type name="gpointer" c:type="gpointer"/>
27
+ </alias>
28
+ <alias name="Bytes_autoptr" c:type="GBytes_autoptr">
29
+ <type name="gpointer" c:type="gpointer"/>
30
+ </alias>
31
+ <alias name="Checksum_autoptr" c:type="GChecksum_autoptr">
32
+ <type name="gpointer" c:type="gpointer"/>
33
+ </alias>
16
34
  <alias name="DateDay" c:type="GDateDay">
17
35
  <doc xml:space="preserve">Integer representing a day of the month; between 1 and 31.
18
36
  #G_DATE_BAD_DAY represents an invalid day of the month.</doc>
19
37
  <type name="guint8" c:type="guint8"/>
20
38
  </alias>
39
+ <alias name="DateTime_autoptr" c:type="GDateTime_autoptr">
40
+ <type name="gpointer" c:type="gpointer"/>
41
+ </alias>
21
42
  <alias name="DateYear" c:type="GDateYear">
22
43
  <doc xml:space="preserve">Integer representing a year; #G_DATE_BAD_YEAR is the invalid
23
44
  value. The year must be 1 or higher; negative (BC) years are not
24
45
  allowed. The year is represented with four digits.</doc>
25
46
  <type name="guint16" c:type="guint16"/>
26
47
  </alias>
48
+ <alias name="Dir_autoptr" c:type="GDir_autoptr">
49
+ <type name="gpointer" c:type="gpointer"/>
50
+ </alias>
51
+ <alias name="Error_autoptr" c:type="GError_autoptr">
52
+ <type name="gpointer" c:type="gpointer"/>
53
+ </alias>
54
+ <alias name="HashTable_autoptr" c:type="GHashTable_autoptr">
55
+ <type name="gpointer" c:type="gpointer"/>
56
+ </alias>
57
+ <alias name="Hmac_autoptr" c:type="GHmac_autoptr">
58
+ <type name="gpointer" c:type="gpointer"/>
59
+ </alias>
60
+ <alias name="IOChannel_autoptr" c:type="GIOChannel_autoptr">
61
+ <type name="gpointer" c:type="gpointer"/>
62
+ </alias>
63
+ <alias name="KeyFile_autoptr" c:type="GKeyFile_autoptr">
64
+ <type name="gpointer" c:type="gpointer"/>
65
+ </alias>
66
+ <alias name="List_autoptr" c:type="GList_autoptr">
67
+ <type name="gpointer" c:type="gpointer"/>
68
+ </alias>
69
+ <alias name="MainContext_autoptr" c:type="GMainContext_autoptr">
70
+ <type name="gpointer" c:type="gpointer"/>
71
+ </alias>
72
+ <alias name="MainLoop_autoptr" c:type="GMainLoop_autoptr">
73
+ <type name="gpointer" c:type="gpointer"/>
74
+ </alias>
75
+ <alias name="MappedFile_autoptr" c:type="GMappedFile_autoptr">
76
+ <type name="gpointer" c:type="gpointer"/>
77
+ </alias>
78
+ <alias name="MarkupParseContext_autoptr"
79
+ c:type="GMarkupParseContext_autoptr">
80
+ <type name="gpointer" c:type="gpointer"/>
81
+ </alias>
82
+ <alias name="MatchInfo_autoptr" c:type="GMatchInfo_autoptr">
83
+ <type name="gpointer" c:type="gpointer"/>
84
+ </alias>
85
+ <alias name="MutexLocker" c:type="GMutexLocker">
86
+ <doc xml:space="preserve">Opaque type. See g_mutex_locker_new() for details.</doc>
87
+ <type name="gpointer" c:type="gpointer"/>
88
+ </alias>
89
+ <alias name="MutexLocker_autoptr" c:type="GMutexLocker_autoptr">
90
+ <type name="gpointer" c:type="gpointer"/>
91
+ </alias>
92
+ <alias name="Node_autoptr" c:type="GNode_autoptr">
93
+ <type name="gpointer" c:type="gpointer"/>
94
+ </alias>
95
+ <alias name="OptionContext_autoptr" c:type="GOptionContext_autoptr">
96
+ <type name="gpointer" c:type="gpointer"/>
97
+ </alias>
98
+ <alias name="OptionGroup_autoptr" c:type="GOptionGroup_autoptr">
99
+ <type name="gpointer" c:type="gpointer"/>
100
+ </alias>
101
+ <alias name="PatternSpec_autoptr" c:type="GPatternSpec_autoptr">
102
+ <type name="gpointer" c:type="gpointer"/>
103
+ </alias>
27
104
  <alias name="Pid" c:type="GPid">
28
105
  <doc xml:space="preserve">A type which is used to hold a process identification.
29
106
 
@@ -34,15 +111,45 @@ GPid is used in GLib only for descendant processes spawned with
34
111
  the g_spawn functions.</doc>
35
112
  <type name="gpointer" c:type="gpointer"/>
36
113
  </alias>
114
+ <alias name="PtrArray_autoptr" c:type="GPtrArray_autoptr">
115
+ <type name="gpointer" c:type="gpointer"/>
116
+ </alias>
37
117
  <alias name="Quark" c:type="GQuark">
38
118
  <doc xml:space="preserve">A GQuark is a non-zero integer which uniquely identifies a
39
119
  particular string. A GQuark value of zero is associated to %NULL.</doc>
40
120
  <type name="guint32" c:type="guint32"/>
41
121
  </alias>
122
+ <alias name="Queue_autoptr" c:type="GQueue_autoptr">
123
+ <type name="gpointer" c:type="gpointer"/>
124
+ </alias>
125
+ <alias name="Rand_autoptr" c:type="GRand_autoptr">
126
+ <type name="gpointer" c:type="gpointer"/>
127
+ </alias>
128
+ <alias name="Regex_autoptr" c:type="GRegex_autoptr">
129
+ <type name="gpointer" c:type="gpointer"/>
130
+ </alias>
131
+ <alias name="SList_autoptr" c:type="GSList_autoptr">
132
+ <type name="gpointer" c:type="gpointer"/>
133
+ </alias>
134
+ <alias name="Scanner_autoptr" c:type="GScanner_autoptr">
135
+ <type name="gpointer" c:type="gpointer"/>
136
+ </alias>
137
+ <alias name="Sequence_autoptr" c:type="GSequence_autoptr">
138
+ <type name="gpointer" c:type="gpointer"/>
139
+ </alias>
140
+ <alias name="Source_autoptr" c:type="GSource_autoptr">
141
+ <type name="gpointer" c:type="gpointer"/>
142
+ </alias>
143
+ <alias name="StringChunk_autoptr" c:type="GStringChunk_autoptr">
144
+ <type name="gpointer" c:type="gpointer"/>
145
+ </alias>
42
146
  <alias name="Strv" c:type="GStrv">
43
147
  <doc xml:space="preserve">A C representable type name for #G_TYPE_STRV.</doc>
44
148
  <type name="gpointer" c:type="gpointer"/>
45
149
  </alias>
150
+ <alias name="Thread_autoptr" c:type="GThread_autoptr">
151
+ <type name="gpointer" c:type="gpointer"/>
152
+ </alias>
46
153
  <alias name="Time" c:type="GTime">
47
154
  <doc xml:space="preserve">Simply a replacement for time_t. It has been deprecated
48
155
  since it is not equivalent to time_t on 64-bit platforms
@@ -68,9 +175,33 @@ gtime = (GTime)ttime;
68
175
  <doc xml:space="preserve">A value representing an interval of time, in microseconds.</doc>
69
176
  <type name="gint64" c:type="gint64"/>
70
177
  </alias>
178
+ <alias name="TimeZone_autoptr" c:type="GTimeZone_autoptr">
179
+ <type name="gpointer" c:type="gpointer"/>
180
+ </alias>
181
+ <alias name="Timer_autoptr" c:type="GTimer_autoptr">
182
+ <type name="gpointer" c:type="gpointer"/>
183
+ </alias>
184
+ <alias name="Tree_autoptr" c:type="GTree_autoptr">
185
+ <type name="gpointer" c:type="gpointer"/>
186
+ </alias>
71
187
  <alias name="Type" c:type="GType">
72
188
  <type name="gsize" c:type="gsize"/>
73
189
  </alias>
190
+ <alias name="VariantBuilder_autoptr" c:type="GVariantBuilder_autoptr">
191
+ <type name="gpointer" c:type="gpointer"/>
192
+ </alias>
193
+ <alias name="VariantDict_autoptr" c:type="GVariantDict_autoptr">
194
+ <type name="gpointer" c:type="gpointer"/>
195
+ </alias>
196
+ <alias name="VariantIter_autoptr" c:type="GVariantIter_autoptr">
197
+ <type name="gpointer" c:type="gpointer"/>
198
+ </alias>
199
+ <alias name="VariantType_autoptr" c:type="GVariantType_autoptr">
200
+ <type name="gpointer" c:type="gpointer"/>
201
+ </alias>
202
+ <alias name="Variant_autoptr" c:type="GVariant_autoptr">
203
+ <type name="gpointer" c:type="gpointer"/>
204
+ </alias>
74
205
  <constant name="ANALYZER_ANALYZING"
75
206
  value="1"
76
207
  c:type="G_ANALYZER_ANALYZING">
@@ -5459,7 +5590,7 @@ this may mean that the week-numbering year is one greater than the
5459
5590
  calendar year (so that these days have the same week-numbering year
5460
5591
  as the Thursday occurring early in the next year).
5461
5592
 
5462
- For Friday, Saturaday and Sunday occurring near the start of the year,
5593
+ For Friday, Saturday and Sunday occurring near the start of the year,
5463
5594
  this may mean that the week-numbering year is one less than the
5464
5595
  calendar year (so that these days have the same week-numbering year
5465
5596
  as the Thursday occurring late in the previous year).
@@ -6582,7 +6713,7 @@ and printing values of type #gsize. See also #G_GINT16_FORMAT.</doc>
6582
6713
  c:type="G_GSIZE_MODIFIER"
6583
6714
  version="2.6">
6584
6715
  <doc xml:space="preserve">The platform dependent length modifier for conversion specifiers
6585
- for scanning and printing values of type #gsize or #gssize. It
6716
+ for scanning and printing values of type #gsize. It
6586
6717
  is a string literal.</doc>
6587
6718
  <type name="utf8" c:type="gchar*"/>
6588
6719
  </constant>
@@ -6594,7 +6725,13 @@ is a string literal.</doc>
6594
6725
  and printing values of type #gssize. See also #G_GINT16_FORMAT.</doc>
6595
6726
  <type name="utf8" c:type="gchar*"/>
6596
6727
  </constant>
6597
- <constant name="GSSIZE_MODIFIER" value="I64" c:type="G_GSSIZE_MODIFIER">
6728
+ <constant name="GSSIZE_MODIFIER"
6729
+ value="I64"
6730
+ c:type="G_GSSIZE_MODIFIER"
6731
+ version="2.6">
6732
+ <doc xml:space="preserve">The platform dependent length modifier for conversion specifiers
6733
+ for scanning and printing values of type #gssize. It
6734
+ is a string literal.</doc>
6598
6735
  <type name="utf8" c:type="gchar*"/>
6599
6736
  </constant>
6600
6737
  <constant name="GUINT16_FORMAT" value="hu" c:type="G_GUINT16_FORMAT">
@@ -6788,6 +6925,7 @@ the discussion in the section description.</doc>
6788
6925
  version="2.32">
6789
6926
  <doc xml:space="preserve">Checks if @key is in @hash_table.</doc>
6790
6927
  <return-value transfer-ownership="none">
6928
+ <doc xml:space="preserve">%TRUE if @key is in @hash_table, %FALSE otherwise.</doc>
6791
6929
  <type name="gboolean" c:type="gboolean"/>
6792
6930
  </return-value>
6793
6931
  <parameters>
@@ -6968,7 +7106,11 @@ key/value pairs in the hash table.</doc>
6968
7106
  version="2.14"
6969
7107
  introspectable="0">
6970
7108
  <doc xml:space="preserve">Retrieves every key inside @hash_table. The returned data is valid
6971
- until changes to the hash release those keys.</doc>
7109
+ until changes to the hash release those keys.
7110
+
7111
+ This iterates over every entry in the hash table to build its return value.
7112
+ To iterate over the entries in a #GHashTable more efficiently, use a
7113
+ #GHashTableIter.</doc>
6972
7114
  <return-value>
6973
7115
  <doc xml:space="preserve">a #GList containing all the keys inside the hash
6974
7116
  table. The content of the list is owned by the hash table and
@@ -6999,7 +7141,11 @@ key. Use @length to determine the true length if it's possible that
6999
7141
  %NULL was used as the value for a key.
7000
7142
 
7001
7143
  Note: in the common case of a string-keyed #GHashTable, the return
7002
- value of this function can be conveniently cast to (gchar **).
7144
+ value of this function can be conveniently cast to (const gchar **).
7145
+
7146
+ This iterates over every entry in the hash table to build its return value.
7147
+ To iterate over the entries in a #GHashTable more efficiently, use a
7148
+ #GHashTableIter.
7003
7149
 
7004
7150
  You should always free the return result with g_free(). In the
7005
7151
  above-mentioned case of a string-keyed hash table, it may be
@@ -7034,7 +7180,11 @@ first to transfer ownership of the keys.</doc>
7034
7180
  version="2.14"
7035
7181
  introspectable="0">
7036
7182
  <doc xml:space="preserve">Retrieves every value inside @hash_table. The returned data
7037
- is valid until @hash_table is modified.</doc>
7183
+ is valid until @hash_table is modified.
7184
+
7185
+ This iterates over every entry in the hash table to build its return value.
7186
+ To iterate over the entries in a #GHashTable more efficiently, use a
7187
+ #GHashTableIter.</doc>
7038
7188
  <return-value>
7039
7189
  <doc xml:space="preserve">a #GList containing all the values inside the hash
7040
7190
  table. The content of the list is owned by the hash table and
@@ -7191,7 +7341,14 @@ a function call.</doc>
7191
7341
  <doc xml:space="preserve">Creates a new #GHashTable like g_hash_table_new() with a reference
7192
7342
  count of 1 and allows to specify functions to free the memory
7193
7343
  allocated for the key and value that get called when removing the
7194
- entry from the #GHashTable.</doc>
7344
+ entry from the #GHashTable.
7345
+
7346
+ Since version 2.42 it is permissible for destroy notify functions to
7347
+ recursively remove further items from the hash table. This is only
7348
+ permissible if the application still holds a reference to the hash table.
7349
+ This means that you may need to ensure that the hash table is empty by
7350
+ calling g_hash_table_remove_all before releasing the last reference using
7351
+ g_hash_table_unref().</doc>
7195
7352
  <return-value>
7196
7353
  <doc xml:space="preserve">a new #GHashTable</doc>
7197
7354
  <type name="GLib.HashTable" c:type="GHashTable*">
@@ -9886,7 +10043,10 @@ details about the meanings of the keys below.</doc>
9886
10043
  </constant>
9887
10044
  <constant name="KEY_FILE_DESKTOP_KEY_ACTIONS"
9888
10045
  value="Actions"
9889
- c:type="G_KEY_FILE_DESKTOP_KEY_ACTIONS">
10046
+ c:type="G_KEY_FILE_DESKTOP_KEY_ACTIONS"
10047
+ version="2.38">
10048
+ <doc xml:space="preserve">A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string list
10049
+ giving the available application actions.</doc>
9890
10050
  <type name="utf8" c:type="gchar*"/>
9891
10051
  </constant>
9892
10052
  <constant name="KEY_FILE_DESKTOP_KEY_CATEGORIES"
@@ -9908,7 +10068,10 @@ string giving the tooltip for the desktop entry.</doc>
9908
10068
  </constant>
9909
10069
  <constant name="KEY_FILE_DESKTOP_KEY_DBUS_ACTIVATABLE"
9910
10070
  value="DBusActivatable"
9911
- c:type="G_KEY_FILE_DESKTOP_KEY_DBUS_ACTIVATABLE">
10071
+ c:type="G_KEY_FILE_DESKTOP_KEY_DBUS_ACTIVATABLE"
10072
+ version="2.38">
10073
+ <doc xml:space="preserve">A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a boolean set to true
10074
+ if the application is D-Bus activatable.</doc>
9912
10075
  <type name="utf8" c:type="gchar*"/>
9913
10076
  </constant>
9914
10077
  <constant name="KEY_FILE_DESKTOP_KEY_EXEC"
@@ -11932,7 +12095,10 @@ either use g_list_free_full() or free them manually first.</doc>
11932
12095
  </parameters>
11933
12096
  </function>
11934
12097
  <function name="free_1" c:identifier="g_list_free_1" introspectable="0">
11935
- <doc xml:space="preserve">Frees one #GList element.
12098
+ <doc xml:space="preserve">Frees one #GList element, but does not update links from the next and
12099
+ previous elements in the list, so you should not call this function on an
12100
+ element that is currently part of a list.
12101
+
11936
12102
  It is usually used after g_list_remove_link().</doc>
11937
12103
  <return-value transfer-ownership="none">
11938
12104
  <type name="none" c:type="void"/>
@@ -12146,7 +12312,8 @@ with g_list_sort().</doc>
12146
12312
 
12147
12313
  This function iterates over the whole list to count its elements.
12148
12314
  Use a #GQueue instead of a GList if you regularly need the number
12149
- of items.</doc>
12315
+ of items. To check whether the list is non-empty, it is faster to check
12316
+ @list against %NULL.</doc>
12150
12317
  <return-value transfer-ownership="none">
12151
12318
  <doc xml:space="preserve">the number of elements in the #GList</doc>
12152
12319
  <type name="guint" c:type="guint"/>
@@ -12161,7 +12328,11 @@ of items.</doc>
12161
12328
  </parameters>
12162
12329
  </function>
12163
12330
  <function name="nth" c:identifier="g_list_nth" introspectable="0">
12164
- <doc xml:space="preserve">Gets the element at the given position in a #GList.</doc>
12331
+ <doc xml:space="preserve">Gets the element at the given position in a #GList.
12332
+
12333
+ This iterates over the list until it reaches the @n-th position. If you
12334
+ intend to iterate over every element, it is better to use a for-loop as
12335
+ described in the #GList introduction.</doc>
12165
12336
  <return-value>
12166
12337
  <doc xml:space="preserve">the element, or %NULL if the position is off
12167
12338
  the end of the #GList</doc>
@@ -12185,7 +12356,11 @@ of items.</doc>
12185
12356
  <function name="nth_data"
12186
12357
  c:identifier="g_list_nth_data"
12187
12358
  introspectable="0">
12188
- <doc xml:space="preserve">Gets the data of the element at the given position.</doc>
12359
+ <doc xml:space="preserve">Gets the data of the element at the given position.
12360
+
12361
+ This iterates over the list until it reaches the @n-th position. If you
12362
+ intend to iterate over every element, it is better to use a for-loop as
12363
+ described in the #GList introduction.</doc>
12189
12364
  <return-value>
12190
12365
  <doc xml:space="preserve">the element's data, or %NULL if the position
12191
12366
  is off the end of the #GList</doc>
@@ -12604,7 +12779,7 @@ linked against at application run time.</doc>
12604
12779
  <doc xml:space="preserve">The minimum value which can be held in a #gint8.</doc>
12605
12780
  <type name="gint8" c:type="gint8"/>
12606
12781
  </constant>
12607
- <constant name="MINOR_VERSION" value="42" c:type="GLIB_MINOR_VERSION">
12782
+ <constant name="MINOR_VERSION" value="44" c:type="GLIB_MINOR_VERSION">
12608
12783
  <doc xml:space="preserve">The minor version number of the GLib library.
12609
12784
 
12610
12785
  Like #gtk_minor_version, but from the headers used at
@@ -15638,8 +15813,8 @@ option: `--name arg` or combined in a single argument: `--name=arg`.</doc>
15638
15813
  <doc xml:space="preserve">The option takes an integer argument.</doc>
15639
15814
  </member>
15640
15815
  <member name="callback" value="3" c:identifier="G_OPTION_ARG_CALLBACK">
15641
- <doc xml:space="preserve">The option provides a callback to parse the
15642
- extra argument.</doc>
15816
+ <doc xml:space="preserve">The option provides a callback (of type
15817
+ #GOptionArgFunc) to parse the extra argument.</doc>
15643
15818
  </member>
15644
15819
  <member name="filename" value="4" c:identifier="G_OPTION_ARG_FILENAME">
15645
15820
  <doc xml:space="preserve">The option takes a filename as argument.</doc>
@@ -15702,10 +15877,8 @@ fields and should not be directly accessed.</doc>
15702
15877
  c:identifier="g_option_context_add_group"
15703
15878
  version="2.6">
15704
15879
  <doc xml:space="preserve">Adds a #GOptionGroup to the @context, so that parsing with @context
15705
- will recognize the options in the group. Note that the group will
15706
- be freed together with the context when g_option_context_free() is
15707
- called, so you must not free the group yourself after adding it
15708
- to a context.</doc>
15880
+ will recognize the options in the group. Note that this will take
15881
+ ownership of the @group and thus the @group should not be freed.</doc>
15709
15882
  <return-value transfer-ownership="none">
15710
15883
  <type name="none" c:type="void"/>
15711
15884
  </return-value>
@@ -15714,7 +15887,7 @@ to a context.</doc>
15714
15887
  <doc xml:space="preserve">a #GOptionContext</doc>
15715
15888
  <type name="OptionContext" c:type="GOptionContext*"/>
15716
15889
  </instance-parameter>
15717
- <parameter name="group" transfer-ownership="none">
15890
+ <parameter name="group" transfer-ownership="full">
15718
15891
  <doc xml:space="preserve">the group to add</doc>
15719
15892
  <type name="OptionGroup" c:type="GOptionGroup*"/>
15720
15893
  </parameter>
@@ -15845,13 +16018,12 @@ g_option_context_set_ignore_unknown_options().</doc>
15845
16018
  </method>
15846
16019
  <method name="get_main_group"
15847
16020
  c:identifier="g_option_context_get_main_group"
15848
- version="2.6"
15849
- introspectable="0">
16021
+ version="2.6">
15850
16022
  <doc xml:space="preserve">Returns a pointer to the main group of @context.</doc>
15851
- <return-value>
15852
- <doc xml:space="preserve">the main group of @context, or %NULL if @context doesn't
15853
- have a main group. Note that group belongs to @context and should
15854
- not be modified or freed.</doc>
16023
+ <return-value transfer-ownership="none">
16024
+ <doc xml:space="preserve">the main group of @context, or %NULL if
16025
+ @context doesn't have a main group. Note that group belongs to
16026
+ @context and should not be modified or freed.</doc>
15855
16027
  <type name="OptionGroup" c:type="GOptionGroup*"/>
15856
16028
  </return-value>
15857
16029
  <parameters>
@@ -15861,6 +16033,23 @@ g_option_context_set_ignore_unknown_options().</doc>
15861
16033
  </instance-parameter>
15862
16034
  </parameters>
15863
16035
  </method>
16036
+ <method name="get_strict_posix"
16037
+ c:identifier="g_option_context_get_strict_posix"
16038
+ version="2.44">
16039
+ <doc xml:space="preserve">Returns whether strict POSIX code is enabled.
16040
+
16041
+ See g_option_context_set_strict_posix() for more information.</doc>
16042
+ <return-value transfer-ownership="none">
16043
+ <doc xml:space="preserve">%TRUE if strict POSIX is enabled, %FALSE otherwise.</doc>
16044
+ <type name="gboolean" c:type="gboolean"/>
16045
+ </return-value>
16046
+ <parameters>
16047
+ <instance-parameter name="context" transfer-ownership="none">
16048
+ <doc xml:space="preserve">a #GoptionContext</doc>
16049
+ <type name="OptionContext" c:type="GOptionContext*"/>
16050
+ </instance-parameter>
16051
+ </parameters>
16052
+ </method>
15864
16053
  <method name="get_summary"
15865
16054
  c:identifier="g_option_context_get_summary"
15866
16055
  version="2.12">
@@ -16062,12 +16251,53 @@ treated differently when generating `--help` output.</doc>
16062
16251
  <doc xml:space="preserve">a #GOptionContext</doc>
16063
16252
  <type name="OptionContext" c:type="GOptionContext*"/>
16064
16253
  </instance-parameter>
16065
- <parameter name="group" transfer-ownership="none">
16254
+ <parameter name="group" transfer-ownership="full">
16066
16255
  <doc xml:space="preserve">the group to set as main group</doc>
16067
16256
  <type name="OptionGroup" c:type="GOptionGroup*"/>
16068
16257
  </parameter>
16069
16258
  </parameters>
16070
16259
  </method>
16260
+ <method name="set_strict_posix"
16261
+ c:identifier="g_option_context_set_strict_posix"
16262
+ version="2.44">
16263
+ <doc xml:space="preserve">Sets strict POSIX mode.
16264
+
16265
+ By default, this mode is disabled.
16266
+
16267
+ In strict POSIX mode, the first non-argument parameter encountered
16268
+ (eg: filename) terminates argument processing. Remaining arguments
16269
+ are treated as non-options and are not attempted to be parsed.
16270
+
16271
+ If strict POSIX mode is disabled then parsing is done in the GNU way
16272
+ where option arguments can be freely mixed with non-options.
16273
+
16274
+ As an example, consider "ls foo -l". With GNU style parsing, this
16275
+ will list "foo" in long mode. In strict POSIX style, this will list
16276
+ the files named "foo" and "-l".
16277
+
16278
+ It may be useful to force strict POSIX mode when creating "verb
16279
+ style" command line tools. For example, the "gsettings" command line
16280
+ tool supports the global option "--schemadir" as well as many
16281
+ subcommands ("get", "set", etc.) which each have their own set of
16282
+ arguments. Using strict POSIX mode will allow parsing the global
16283
+ options up to the verb name while leaving the remaining options to be
16284
+ parsed by the relevant subcommand (which can be determined by
16285
+ examining the verb name, which should be present in argv[1] after
16286
+ parsing).</doc>
16287
+ <return-value transfer-ownership="none">
16288
+ <type name="none" c:type="void"/>
16289
+ </return-value>
16290
+ <parameters>
16291
+ <instance-parameter name="context" transfer-ownership="none">
16292
+ <doc xml:space="preserve">a #GoptionContext</doc>
16293
+ <type name="OptionContext" c:type="GOptionContext*"/>
16294
+ </instance-parameter>
16295
+ <parameter name="strict_posix" transfer-ownership="none">
16296
+ <doc xml:space="preserve">the new value</doc>
16297
+ <type name="gboolean" c:type="gboolean"/>
16298
+ </parameter>
16299
+ </parameters>
16300
+ </method>
16071
16301
  <method name="set_summary"
16072
16302
  c:identifier="g_option_context_set_summary"
16073
16303
  version="2.12">
@@ -16349,7 +16579,11 @@ or g_option_group_add_entries().</doc>
16349
16579
  your direct control. Since 2.8.</doc>
16350
16580
  </member>
16351
16581
  </bitfield>
16352
- <record name="OptionGroup" c:type="GOptionGroup" disguised="1">
16582
+ <record name="OptionGroup"
16583
+ c:type="GOptionGroup"
16584
+ glib:type-name="GOptionGroup"
16585
+ glib:get-type="g_option_group_get_type"
16586
+ c:symbol-prefix="option_group">
16353
16587
  <doc xml:space="preserve">A `GOptionGroup` struct defines the options in a single
16354
16588
  group. The struct has only private fields and should not be directly accessed.
16355
16589
 
@@ -16357,6 +16591,49 @@ All options in a group share the same translation function. Libraries which
16357
16591
  need to parse commandline options are expected to provide a function for
16358
16592
  getting a `GOptionGroup` holding their options, which
16359
16593
  the application can then add to its #GOptionContext.</doc>
16594
+ <constructor name="new" c:identifier="g_option_group_new" version="2.6">
16595
+ <doc xml:space="preserve">Creates a new #GOptionGroup.</doc>
16596
+ <return-value transfer-ownership="full">
16597
+ <doc xml:space="preserve">a newly created option group. It should be added
16598
+ to a #GOptionContext or freed with g_option_group_unref().</doc>
16599
+ <type name="OptionGroup" c:type="GOptionGroup*"/>
16600
+ </return-value>
16601
+ <parameters>
16602
+ <parameter name="name" transfer-ownership="none">
16603
+ <doc xml:space="preserve">the name for the option group, this is used to provide
16604
+ help for the options in this group with `--help-`@name</doc>
16605
+ <type name="utf8" c:type="const gchar*"/>
16606
+ </parameter>
16607
+ <parameter name="description" transfer-ownership="none">
16608
+ <doc xml:space="preserve">a description for this group to be shown in
16609
+ `--help`. This string is translated using the translation
16610
+ domain or translation function of the group</doc>
16611
+ <type name="utf8" c:type="const gchar*"/>
16612
+ </parameter>
16613
+ <parameter name="help_description" transfer-ownership="none">
16614
+ <doc xml:space="preserve">a description for the `--help-`@name option.
16615
+ This string is translated using the translation domain or translation function
16616
+ of the group</doc>
16617
+ <type name="utf8" c:type="const gchar*"/>
16618
+ </parameter>
16619
+ <parameter name="user_data"
16620
+ transfer-ownership="none"
16621
+ nullable="1"
16622
+ allow-none="1">
16623
+ <doc xml:space="preserve">user data that will be passed to the pre- and post-parse hooks,
16624
+ the error hook and to callbacks of %G_OPTION_ARG_CALLBACK options, or %NULL</doc>
16625
+ <type name="gpointer" c:type="gpointer"/>
16626
+ </parameter>
16627
+ <parameter name="destroy"
16628
+ transfer-ownership="none"
16629
+ nullable="1"
16630
+ allow-none="1"
16631
+ scope="async">
16632
+ <doc xml:space="preserve">a function that will be called to free @user_data, or %NULL</doc>
16633
+ <type name="DestroyNotify" c:type="GDestroyNotify"/>
16634
+ </parameter>
16635
+ </parameters>
16636
+ </constructor>
16360
16637
  <method name="add_entries"
16361
16638
  c:identifier="g_option_group_add_entries"
16362
16639
  version="2.6">
@@ -16375,9 +16652,14 @@ the application can then add to its #GOptionContext.</doc>
16375
16652
  </parameter>
16376
16653
  </parameters>
16377
16654
  </method>
16378
- <method name="free" c:identifier="g_option_group_free" version="2.6">
16655
+ <method name="free"
16656
+ c:identifier="g_option_group_free"
16657
+ version="2.6"
16658
+ deprecated="1"
16659
+ deprecated-version="2.44">
16379
16660
  <doc xml:space="preserve">Frees a #GOptionGroup. Note that you must not free groups
16380
16661
  which have been added to a #GOptionContext.</doc>
16662
+ <doc-deprecated xml:space="preserve">Use g_option_group_unref() instead.</doc-deprecated>
16381
16663
  <return-value transfer-ownership="none">
16382
16664
  <type name="none" c:type="void"/>
16383
16665
  </return-value>
@@ -16388,6 +16670,19 @@ which have been added to a #GOptionContext.</doc>
16388
16670
  </instance-parameter>
16389
16671
  </parameters>
16390
16672
  </method>
16673
+ <method name="ref" c:identifier="g_option_group_ref" version="2.44">
16674
+ <doc xml:space="preserve">Increments the reference count of @group by one.</doc>
16675
+ <return-value transfer-ownership="full">
16676
+ <doc xml:space="preserve">a #GoptionGroup</doc>
16677
+ <type name="OptionGroup" c:type="GOptionGroup*"/>
16678
+ </return-value>
16679
+ <parameters>
16680
+ <instance-parameter name="group" transfer-ownership="none">
16681
+ <doc xml:space="preserve">a #GOptionGroup</doc>
16682
+ <type name="OptionGroup" c:type="GOptionGroup*"/>
16683
+ </instance-parameter>
16684
+ </parameters>
16685
+ </method>
16391
16686
  <method name="set_error_hook"
16392
16687
  c:identifier="g_option_group_set_error_hook"
16393
16688
  version="2.6"
@@ -16509,52 +16804,20 @@ user-visible strings.</doc>
16509
16804
  </parameter>
16510
16805
  </parameters>
16511
16806
  </method>
16512
- <function name="new"
16513
- c:identifier="g_option_group_new"
16514
- version="2.6"
16515
- introspectable="0">
16516
- <doc xml:space="preserve">Creates a new #GOptionGroup.</doc>
16517
- <return-value>
16518
- <doc xml:space="preserve">a newly created option group. It should be added
16519
- to a #GOptionContext or freed with g_option_group_free().</doc>
16520
- <type name="OptionGroup" c:type="GOptionGroup*"/>
16807
+ <method name="unref" c:identifier="g_option_group_unref" version="2.44">
16808
+ <doc xml:space="preserve">Decrements the reference count of @group by one.
16809
+ If the reference count drops to 0, the @group will be freed.
16810
+ and all memory allocated by the @group is released.</doc>
16811
+ <return-value transfer-ownership="none">
16812
+ <type name="none" c:type="void"/>
16521
16813
  </return-value>
16522
16814
  <parameters>
16523
- <parameter name="name" transfer-ownership="none">
16524
- <doc xml:space="preserve">the name for the option group, this is used to provide
16525
- help for the options in this group with `--help-`@name</doc>
16526
- <type name="utf8" c:type="const gchar*"/>
16527
- </parameter>
16528
- <parameter name="description" transfer-ownership="none">
16529
- <doc xml:space="preserve">a description for this group to be shown in
16530
- `--help`. This string is translated using the translation
16531
- domain or translation function of the group</doc>
16532
- <type name="utf8" c:type="const gchar*"/>
16533
- </parameter>
16534
- <parameter name="help_description" transfer-ownership="none">
16535
- <doc xml:space="preserve">a description for the `--help-`@name option.
16536
- This string is translated using the translation domain or translation function
16537
- of the group</doc>
16538
- <type name="utf8" c:type="const gchar*"/>
16539
- </parameter>
16540
- <parameter name="user_data"
16541
- transfer-ownership="none"
16542
- nullable="1"
16543
- allow-none="1">
16544
- <doc xml:space="preserve">user data that will be passed to the pre- and post-parse hooks,
16545
- the error hook and to callbacks of %G_OPTION_ARG_CALLBACK options, or %NULL</doc>
16546
- <type name="gpointer" c:type="gpointer"/>
16547
- </parameter>
16548
- <parameter name="destroy"
16549
- transfer-ownership="none"
16550
- nullable="1"
16551
- allow-none="1"
16552
- scope="async">
16553
- <doc xml:space="preserve">a function that will be called to free @user_data, or %NULL</doc>
16554
- <type name="DestroyNotify" c:type="GDestroyNotify"/>
16555
- </parameter>
16815
+ <instance-parameter name="group" transfer-ownership="none">
16816
+ <doc xml:space="preserve">a #GOptionGroup</doc>
16817
+ <type name="OptionGroup" c:type="GOptionGroup*"/>
16818
+ </instance-parameter>
16556
16819
  </parameters>
16557
- </function>
16820
+ </method>
16558
16821
  </record>
16559
16822
  <callback name="OptionParseFunc" c:type="GOptionParseFunc" throws="1">
16560
16823
  <doc xml:space="preserve">The type of function that can be called before and after parsing.</doc>
@@ -17564,9 +17827,10 @@ g_queue_new().</doc>
17564
17827
  c:identifier="g_queue_insert_after"
17565
17828
  version="2.4"
17566
17829
  introspectable="0">
17567
- <doc xml:space="preserve">Inserts @data into @queue after @sibling
17830
+ <doc xml:space="preserve">Inserts @data into @queue after @sibling.
17568
17831
 
17569
- @sibling must be part of @queue</doc>
17832
+ @sibling must be part of @queue. Since GLib 2.44 a %NULL sibling pushes the
17833
+ data at the head of the queue.</doc>
17570
17834
  <return-value transfer-ownership="none">
17571
17835
  <type name="none" c:type="void"/>
17572
17836
  </return-value>
@@ -17575,8 +17839,12 @@ g_queue_new().</doc>
17575
17839
  <doc xml:space="preserve">a #GQueue</doc>
17576
17840
  <type name="Queue" c:type="GQueue*"/>
17577
17841
  </instance-parameter>
17578
- <parameter name="sibling" transfer-ownership="none">
17579
- <doc xml:space="preserve">a #GList link that must be part of @queue</doc>
17842
+ <parameter name="sibling"
17843
+ transfer-ownership="none"
17844
+ nullable="1"
17845
+ allow-none="1">
17846
+ <doc xml:space="preserve">a #GList link that must be part of @queue, or %NULL to
17847
+ push at the head of the queue.</doc>
17580
17848
  <type name="GLib.List" c:type="GList*">
17581
17849
  <type name="gpointer" c:type="gpointer"/>
17582
17850
  </type>
@@ -17593,7 +17861,8 @@ g_queue_new().</doc>
17593
17861
  introspectable="0">
17594
17862
  <doc xml:space="preserve">Inserts @data into @queue before @sibling.
17595
17863
 
17596
- @sibling must be part of @queue.</doc>
17864
+ @sibling must be part of @queue. Since GLib 2.44 a %NULL sibling pushes the
17865
+ data at the tail of the queue.</doc>
17597
17866
  <return-value transfer-ownership="none">
17598
17867
  <type name="none" c:type="void"/>
17599
17868
  </return-value>
@@ -17602,8 +17871,12 @@ g_queue_new().</doc>
17602
17871
  <doc xml:space="preserve">a #GQueue</doc>
17603
17872
  <type name="Queue" c:type="GQueue*"/>
17604
17873
  </instance-parameter>
17605
- <parameter name="sibling" transfer-ownership="none">
17606
- <doc xml:space="preserve">a #GList link that must be part of @queue</doc>
17874
+ <parameter name="sibling"
17875
+ transfer-ownership="none"
17876
+ nullable="1"
17877
+ allow-none="1">
17878
+ <doc xml:space="preserve">a #GList link that must be part of @queue, or %NULL to
17879
+ push at the tail of the queue.</doc>
17607
17880
  <type name="GLib.List" c:type="GList*">
17608
17881
  <type name="gpointer" c:type="gpointer"/>
17609
17882
  </type>
@@ -20812,7 +21085,8 @@ This function iterates over the whole list.</doc>
20812
21085
  <doc xml:space="preserve">Gets the number of elements in a #GSList.
20813
21086
 
20814
21087
  This function iterates over the whole list to
20815
- count its elements.</doc>
21088
+ count its elements. To check whether the list is non-empty, it is faster to
21089
+ check @list against %NULL.</doc>
20816
21090
  <return-value transfer-ownership="none">
20817
21091
  <doc xml:space="preserve">the number of elements in the #GSList</doc>
20818
21092
  <type name="guint" c:type="guint"/>
@@ -24188,7 +24462,7 @@ The rest of the #GString is shifted down to fill the gap.</doc>
24188
24462
  If @free_segment is %TRUE it also frees the character data. If
24189
24463
  it's %FALSE, the caller gains ownership of the buffer and must
24190
24464
  free it after use with g_free().</doc>
24191
- <return-value transfer-ownership="full">
24465
+ <return-value transfer-ownership="full" nullable="1">
24192
24466
  <doc xml:space="preserve">the character data of @string
24193
24467
  (i.e. %NULL if @free_segment is %TRUE)</doc>
24194
24468
  <type name="utf8" c:type="gchar*"/>
@@ -25264,7 +25538,7 @@ or or from within a #GThreadPool.</doc>
25264
25538
  </parameters>
25265
25539
  </function>
25266
25540
  <function name="self" c:identifier="g_thread_self">
25267
- <doc xml:space="preserve">This functions returns the #GThread corresponding to the
25541
+ <doc xml:space="preserve">This function returns the #GThread corresponding to the
25268
25542
  current thread. Note that this function does not increase
25269
25543
  the reference count of the returned struct.
25270
25544
 
@@ -25569,7 +25843,7 @@ global pool.
25569
25843
  @error can be %NULL to ignore errors, or non-%NULL to report
25570
25844
  errors. An error can only occur when @exclusive is set to %TRUE
25571
25845
  and not all @max_threads threads could be created.
25572
- See #GThreadError for possible errors that may occurr.
25846
+ See #GThreadError for possible errors that may occur.
25573
25847
  Note, even in case of error a valid #GThreadPool is returned.</doc>
25574
25848
  <return-value>
25575
25849
  <doc xml:space="preserve">the new #GThreadPool</doc>
@@ -27110,7 +27384,7 @@ url="http://www.unicode.org/reports/tr24/"&gt;Unicode Standard Annex
27110
27384
  value="1"
27111
27385
  c:identifier="G_UNICODE_SCRIPT_INHERITED">
27112
27386
  <doc xml:space="preserve">a mark glyph that takes its script from the
27113
- i base glyph to which it is attached</doc>
27387
+ base glyph to which it is attached</doc>
27114
27388
  </member>
27115
27389
  <member name="arabic" value="2" c:identifier="G_UNICODE_SCRIPT_ARABIC">
27116
27390
  <doc xml:space="preserve">Arabic</doc>
@@ -27639,12 +27913,12 @@ i base glyph to which it is attached</doc>
27639
27913
  <member name="tirhuta"
27640
27914
  value="124"
27641
27915
  c:identifier="G_UNICODE_SCRIPT_TIRHUTA">
27642
- <doc xml:space="preserve">Tirhuta. Since: 2.42
27643
- @G_UNICODE_SCRIPT_WARANG_CITI Warang Citi. Since: 2.42</doc>
27916
+ <doc xml:space="preserve">Tirhuta. Since: 2.42</doc>
27644
27917
  </member>
27645
27918
  <member name="warang_citi"
27646
27919
  value="125"
27647
27920
  c:identifier="G_UNICODE_SCRIPT_WARANG_CITI">
27921
+ <doc xml:space="preserve">Warang Citi. Since: 2.42</doc>
27648
27922
  </member>
27649
27923
  </enumeration>
27650
27924
  <enumeration name="UnicodeType" c:type="GUnicodeType">
@@ -28216,7 +28490,7 @@ new instance takes ownership of them as if via g_variant_ref_sink().</doc>
28216
28490
  version="2.26">
28217
28491
  <doc xml:space="preserve">Creates an array-of-bytes #GVariant with the contents of @string.
28218
28492
  This function is just like g_variant_new_string() except that the
28219
- string need not be valid utf8.
28493
+ string need not be valid UTF-8.
28220
28494
 
28221
28495
  The nul terminator character at the end of the string is stored in
28222
28496
  the array.</doc>
@@ -28701,14 +28975,14 @@ g_variant_is_signature() if you're not sure.</doc>
28701
28975
  version="2.24">
28702
28976
  <doc xml:space="preserve">Creates a string #GVariant with the contents of @string.
28703
28977
 
28704
- @string must be valid utf8.</doc>
28978
+ @string must be valid UTF-8.</doc>
28705
28979
  <return-value transfer-ownership="none">
28706
28980
  <doc xml:space="preserve">a floating reference to a new string #GVariant instance</doc>
28707
28981
  <type name="Variant" c:type="GVariant*"/>
28708
28982
  </return-value>
28709
28983
  <parameters>
28710
28984
  <parameter name="string" transfer-ownership="none">
28711
- <doc xml:space="preserve">a normal utf8 nul-terminated string</doc>
28985
+ <doc xml:space="preserve">a normal UTF-8 nul-terminated string</doc>
28712
28986
  <type name="utf8" c:type="const gchar*"/>
28713
28987
  </parameter>
28714
28988
  </parameters>
@@ -28743,7 +29017,7 @@ If @length is -1 then @strv is %NULL-terminated.</doc>
28743
29017
  introspectable="0">
28744
29018
  <doc xml:space="preserve">Creates a string #GVariant with the contents of @string.
28745
29019
 
28746
- @string must be valid utf8.
29020
+ @string must be valid UTF-8.
28747
29021
 
28748
29022
  This function consumes @string. g_free() will be called on @string
28749
29023
  when it is no longer required.
@@ -28758,7 +29032,7 @@ freed.</doc>
28758
29032
  </return-value>
28759
29033
  <parameters>
28760
29034
  <parameter name="string" transfer-ownership="none">
28761
- <doc xml:space="preserve">a normal utf8 nul-terminated string</doc>
29035
+ <doc xml:space="preserve">a normal UTF-8 nul-terminated string</doc>
28762
29036
  <type name="utf8" c:type="gchar*"/>
28763
29037
  </parameter>
28764
29038
  </parameters>
@@ -29132,11 +29406,11 @@ For an empty array, @length will be set to 0 and a pointer to a
29132
29406
  <doc xml:space="preserve">Similar to g_variant_get_string() except that instead of returning
29133
29407
  a constant string, the string is duplicated.
29134
29408
 
29135
- The string will always be utf8 encoded.
29409
+ The string will always be UTF-8 encoded.
29136
29410
 
29137
29411
  The return value must be freed using g_free().</doc>
29138
29412
  <return-value transfer-ownership="full">
29139
- <doc xml:space="preserve">a newly allocated string, utf8 encoded</doc>
29413
+ <doc xml:space="preserve">a newly allocated string, UTF-8 encoded</doc>
29140
29414
  <type name="utf8" c:type="gchar*"/>
29141
29415
  </return-value>
29142
29416
  <parameters>
@@ -29723,7 +29997,7 @@ involved.</doc>
29723
29997
  type. This includes the types %G_VARIANT_TYPE_STRING,
29724
29998
  %G_VARIANT_TYPE_OBJECT_PATH and %G_VARIANT_TYPE_SIGNATURE.
29725
29999
 
29726
- The string will always be utf8 encoded.
30000
+ The string will always be UTF-8 encoded.
29727
30001
 
29728
30002
  If @length is non-%NULL then the length of the string (in bytes) is
29729
30003
  returned there. For trusted values, this information is already
@@ -29734,7 +30008,7 @@ other than those three.
29734
30008
 
29735
30009
  The return value remains valid as long as @value exists.</doc>
29736
30010
  <return-value transfer-ownership="none">
29737
- <doc xml:space="preserve">the constant string, utf8 encoded</doc>
30011
+ <doc xml:space="preserve">the constant string, UTF-8 encoded</doc>
29738
30012
  <type name="utf8" c:type="const gchar*"/>
29739
30013
  </return-value>
29740
30014
  <parameters>
@@ -32525,6 +32799,23 @@ function passed to g_atexit().</doc>
32525
32799
  c:type="G_WIN32_MSG_HANDLE">
32526
32800
  <type name="gint" c:type="gint"/>
32527
32801
  </constant>
32802
+ <enumeration name="Win32OSType" c:type="GWin32OSType">
32803
+ <doc xml:space="preserve">Type of Windows edition to check for at run-time.</doc>
32804
+ <member name="any" value="0" c:identifier="G_WIN32_OS_ANY">
32805
+ <doc xml:space="preserve">The running system can be a workstation or a server edition of
32806
+ Windows. The type of the running system is therefore not checked.</doc>
32807
+ </member>
32808
+ <member name="workstation"
32809
+ value="1"
32810
+ c:identifier="G_WIN32_OS_WORKSTATION">
32811
+ <doc xml:space="preserve">The running system is a workstation edition of Windows,
32812
+ such as Windows 7 Professional.</doc>
32813
+ </member>
32814
+ <member name="server" value="2" c:identifier="G_WIN32_OS_SERVER">
32815
+ <doc xml:space="preserve">The running system is a server edition of Windows, such as
32816
+ Windows Server 2008 R2.</doc>
32817
+ </member>
32818
+ </enumeration>
32528
32819
  <function name="access" c:identifier="g_access" version="2.8">
32529
32820
  <doc xml:space="preserve">A wrapper for the POSIX access() function. This function is used to
32530
32821
  test a pathname for one or several of read, write or execute
@@ -32579,7 +32870,8 @@ This function generates enough precision that converting
32579
32870
  the string back using g_ascii_strtod() gives the same machine-number
32580
32871
  (on machines with IEEE compatible 64bit doubles). It is
32581
32872
  guaranteed that the size of the resulting string will never
32582
- be larger than @G_ASCII_DTOSTR_BUF_SIZE bytes.</doc>
32873
+ be larger than @G_ASCII_DTOSTR_BUF_SIZE bytes, including the terminating
32874
+ nul character, which is always added.</doc>
32583
32875
  <return-value transfer-ownership="full">
32584
32876
  <doc xml:space="preserve">The pointer to the buffer with the converted string.</doc>
32585
32877
  <type name="utf8" c:type="gchar*"/>
@@ -32605,6 +32897,8 @@ decimal point. To format the number you pass in
32605
32897
  a printf()-style format string. Allowed conversion
32606
32898
  specifiers are 'e', 'E', 'f', 'F', 'g' and 'G'.
32607
32899
 
32900
+ The returned buffer is guaranteed to be nul-terminated.
32901
+
32608
32902
  If you just want to want to serialize the value into a
32609
32903
  string, use g_ascii_dtostr().</doc>
32610
32904
  <return-value transfer-ownership="full">
@@ -34448,6 +34742,7 @@ function over the call provided by the system; on Unix, it will
34448
34742
  attempt to correctly handle %EINTR, which has platform-specific
34449
34743
  semantics.</doc>
34450
34744
  <return-value transfer-ownership="none">
34745
+ <doc xml:space="preserve">%TRUE on success, %FALSE if there was an error.</doc>
34451
34746
  <type name="gboolean" c:type="gboolean"/>
34452
34747
  </return-value>
34453
34748
  <parameters>
@@ -36698,7 +36993,9 @@ positional parameters, as specified in the Single Unix Specification.</doc>
36698
36993
  </function>
36699
36994
  <function name="free" c:identifier="g_free">
36700
36995
  <doc xml:space="preserve">Frees the memory pointed to by @mem.
36701
- If @mem is %NULL it simply returns.</doc>
36996
+
36997
+ If @mem is %NULL it simply returns, so there is no need to check @mem
36998
+ against %NULL before calling this function.</doc>
36702
36999
  <return-value transfer-ownership="none">
36703
37000
  <type name="none" c:type="void"/>
36704
37001
  </return-value>
@@ -36780,8 +37077,14 @@ freed.</doc>
36780
37077
  <type name="gboolean" c:type="gboolean"/>
36781
37078
  </return-value>
36782
37079
  <parameters>
36783
- <parameter name="charset" transfer-ownership="none">
36784
- <doc xml:space="preserve">return location for character set name</doc>
37080
+ <parameter name="charset"
37081
+ direction="out"
37082
+ caller-allocates="0"
37083
+ transfer-ownership="none"
37084
+ optional="1"
37085
+ allow-none="1">
37086
+ <doc xml:space="preserve">return location for character set
37087
+ name, or %NULL.</doc>
36785
37088
  <type name="utf8" c:type="const char**"/>
36786
37089
  </parameter>
36787
37090
  </parameters>
@@ -37329,6 +37632,7 @@ the discussion in the section description.</doc>
37329
37632
  version="2.32">
37330
37633
  <doc xml:space="preserve">Checks if @key is in @hash_table.</doc>
37331
37634
  <return-value transfer-ownership="none">
37635
+ <doc xml:space="preserve">%TRUE if @key is in @hash_table, %FALSE otherwise.</doc>
37332
37636
  <type name="gboolean" c:type="gboolean"/>
37333
37637
  </return-value>
37334
37638
  <parameters>
@@ -37866,8 +38170,10 @@ returns %FALSE it is automatically removed from the list of event
37866
38170
  sources and will not be called again.
37867
38171
 
37868
38172
  This internally creates a main loop source using g_idle_source_new()
37869
- and attaches it to the main loop context using g_source_attach().
37870
- You can do these steps manually if you need greater control.</doc>
38173
+ and attaches it to the global #GMainContext using g_source_attach(), so
38174
+ the callback will be invoked in whichever thread is running that main
38175
+ context. You can do these steps manually if you need greater control or to
38176
+ use a custom main context.</doc>
37871
38177
  <return-value transfer-ownership="none">
37872
38178
  <doc xml:space="preserve">the ID (greater than 0) of the event source.</doc>
37873
38179
  <type name="guint" c:type="guint"/>
@@ -37891,8 +38197,10 @@ events pending. If the function returns %FALSE it is automatically
37891
38197
  removed from the list of event sources and will not be called again.
37892
38198
 
37893
38199
  This internally creates a main loop source using g_idle_source_new()
37894
- and attaches it to the main loop context using g_source_attach().
37895
- You can do these steps manually if you need greater control.</doc>
38200
+ and attaches it to the global #GMainContext using g_source_attach(), so
38201
+ the callback will be invoked in whichever thread is running that main
38202
+ context. You can do these steps manually if you need greater control or to
38203
+ use a custom main context.</doc>
37896
38204
  <return-value transfer-ownership="none">
37897
38205
  <doc xml:space="preserve">the ID (greater than 0) of the event source.</doc>
37898
38206
  <type name="guint" c:type="guint"/>
@@ -39544,7 +39852,7 @@ Windows-specific code.</doc>
39544
39852
  <doc xml:space="preserve">Returns a pointer into @file_name after the root component,
39545
39853
  i.e. after the "/" in UNIX or "C:\" under Windows. If @file_name
39546
39854
  is not an absolute path it returns %NULL.</doc>
39547
- <return-value transfer-ownership="none">
39855
+ <return-value transfer-ownership="none" nullable="1">
39548
39856
  <doc xml:space="preserve">a pointer into @file_name after the root component</doc>
39549
39857
  <type name="utf8" c:type="const gchar*"/>
39550
39858
  </return-value>
@@ -39875,7 +40183,11 @@ of the sprintf() function.</doc>
39875
40183
  </function>
39876
40184
  <function name="propagate_error" c:identifier="g_propagate_error">
39877
40185
  <doc xml:space="preserve">If @dest is %NULL, free @src; otherwise, moves @src into *@dest.
39878
- The error variable @dest points to must be %NULL.</doc>
40186
+ The error variable @dest points to must be %NULL.
40187
+
40188
+ Note that @src is no longer valid after this call. If you want
40189
+ to keep using the same GError*, you need to set it to %NULL
40190
+ after calling this function on it.</doc>
39879
40191
  <return-value transfer-ownership="none">
39880
40192
  <type name="none" c:type="void"/>
39881
40193
  </return-value>
@@ -42571,8 +42883,10 @@ g_strcompress() does the reverse conversion.</doc>
42571
42883
  </parameters>
42572
42884
  </function>
42573
42885
  <function name="strfreev" c:identifier="g_strfreev">
42574
- <doc xml:space="preserve">Frees a %NULL-terminated array of strings, and the array itself.
42575
- If called on a %NULL value, g_strfreev() simply returns.</doc>
42886
+ <doc xml:space="preserve">Frees a %NULL-terminated array of strings, as well as each
42887
+ string it contains.
42888
+
42889
+ If @str_array is %NULL, this function simply returns.</doc>
42576
42890
  <return-value transfer-ownership="none">
42577
42891
  <type name="none" c:type="void"/>
42578
42892
  </return-value>
@@ -43104,6 +43418,25 @@ point in some locales, causing unexpected results.</doc>
43104
43418
  </parameter>
43105
43419
  </parameters>
43106
43420
  </function>
43421
+ <function name="strv_contains"
43422
+ c:identifier="g_strv_contains"
43423
+ version="2.44">
43424
+ <doc xml:space="preserve">Checks if @strv contains @str. @strv must not be %NULL.</doc>
43425
+ <return-value transfer-ownership="none">
43426
+ <doc xml:space="preserve">%TRUE if @str is an element of @strv, according to g_str_equal().</doc>
43427
+ <type name="gboolean" c:type="gboolean"/>
43428
+ </return-value>
43429
+ <parameters>
43430
+ <parameter name="strv" transfer-ownership="none">
43431
+ <doc xml:space="preserve">a %NULL-terminated array of strings</doc>
43432
+ <type name="utf8" c:type="const gchar* const*"/>
43433
+ </parameter>
43434
+ <parameter name="str" transfer-ownership="none">
43435
+ <doc xml:space="preserve">a string</doc>
43436
+ <type name="utf8" c:type="const gchar*"/>
43437
+ </parameter>
43438
+ </parameters>
43439
+ </function>
43107
43440
  <function name="strv_get_type" c:identifier="g_strv_get_type">
43108
43441
  <return-value transfer-ownership="none">
43109
43442
  <type name="GType" c:type="GType"/>
@@ -43125,8 +43458,7 @@ string array @str_array.</doc>
43125
43458
  </function>
43126
43459
  <function name="test_add_data_func"
43127
43460
  c:identifier="g_test_add_data_func"
43128
- version="2.16"
43129
- introspectable="0">
43461
+ version="2.16">
43130
43462
  <doc xml:space="preserve">Create a new test case, similar to g_test_create_case(). However
43131
43463
  the test is assumed to use no fixture, and test suites are automatically
43132
43464
  created on the fly and added to the root fixture, based on the
@@ -43148,7 +43480,7 @@ required via the `-p` command-line option or g_test_trap_subprocess().</doc>
43148
43480
  <doc xml:space="preserve">Test data argument for the test function.</doc>
43149
43481
  <type name="gpointer" c:type="gconstpointer"/>
43150
43482
  </parameter>
43151
- <parameter name="test_func" transfer-ownership="none">
43483
+ <parameter name="test_func" transfer-ownership="none" scope="async">
43152
43484
  <doc xml:space="preserve">The test function to invoke for this test.</doc>
43153
43485
  <type name="TestDataFunc" c:type="GTestDataFunc"/>
43154
43486
  </parameter>
@@ -43188,8 +43520,7 @@ required via the `-p` command-line option or g_test_trap_subprocess().</doc>
43188
43520
  </function>
43189
43521
  <function name="test_add_func"
43190
43522
  c:identifier="g_test_add_func"
43191
- version="2.16"
43192
- introspectable="0">
43523
+ version="2.16">
43193
43524
  <doc xml:space="preserve">Create a new test case, similar to g_test_create_case(). However
43194
43525
  the test is assumed to use no fixture, and test suites are automatically
43195
43526
  created on the fly and added to the root fixture, based on the
@@ -43206,7 +43537,7 @@ required via the `-p` command-line option or g_test_trap_subprocess().</doc>
43206
43537
  <doc xml:space="preserve">/-separated test case path name for the test.</doc>
43207
43538
  <type name="utf8" c:type="const char*"/>
43208
43539
  </parameter>
43209
- <parameter name="test_func" transfer-ownership="none">
43540
+ <parameter name="test_func" transfer-ownership="none" scope="async">
43210
43541
  <doc xml:space="preserve">The test function to invoke for this test.</doc>
43211
43542
  <type name="TestFunc" c:type="GTestFunc"/>
43212
43543
  </parameter>
@@ -43350,14 +43681,14 @@ same relative path as the test binary.</doc>
43350
43681
  <doc xml:space="preserve">Create a new #GTestCase, named @test_name, this API is fairly
43351
43682
  low level, calling g_test_add() or g_test_add_func() is preferable.
43352
43683
  When this test is executed, a fixture structure of size @data_size
43353
- will be allocated and filled with 0s. Then @data_setup is called
43354
- to initialize the fixture. After fixture setup, the actual test
43355
- function @data_test is called. Once the test run completed, the
43356
- fixture structure is torn down by calling @data_teardown and
43357
- after that the memory is released.
43684
+ will be automatically allocated and filled with zeros. Then @data_setup is
43685
+ called to initialize the fixture. After fixture setup, the actual test
43686
+ function @data_test is called. Once the test run completes, the
43687
+ fixture structure is torn down by calling @data_teardown and
43688
+ after that the memory is automatically released by the test framework.
43358
43689
 
43359
43690
  Splitting up a test run into fixture setup, test function and
43360
- fixture teardown is most usful if the same fixture is used for
43691
+ fixture teardown is most useful if the same fixture is used for
43361
43692
  multiple tests. In this cases, g_test_create_case() will be
43362
43693
  called with the same fixture, but varying @test_name and
43363
43694
  @data_test arguments.</doc>
@@ -43378,15 +43709,17 @@ called with the same fixture, but varying @test_name and
43378
43709
  <doc xml:space="preserve">test data argument for the test functions</doc>
43379
43710
  <type name="gpointer" c:type="gconstpointer"/>
43380
43711
  </parameter>
43381
- <parameter name="data_setup" transfer-ownership="none">
43712
+ <parameter name="data_setup" transfer-ownership="none" scope="async">
43382
43713
  <doc xml:space="preserve">the function to set up the fixture data</doc>
43383
43714
  <type name="TestFixtureFunc" c:type="GTestFixtureFunc"/>
43384
43715
  </parameter>
43385
- <parameter name="data_test" transfer-ownership="none">
43716
+ <parameter name="data_test" transfer-ownership="none" scope="async">
43386
43717
  <doc xml:space="preserve">the actual test function</doc>
43387
43718
  <type name="TestFixtureFunc" c:type="GTestFixtureFunc"/>
43388
43719
  </parameter>
43389
- <parameter name="data_teardown" transfer-ownership="none">
43720
+ <parameter name="data_teardown"
43721
+ transfer-ownership="none"
43722
+ scope="async">
43390
43723
  <doc xml:space="preserve">the function to teardown the fixture data</doc>
43391
43724
  <type name="TestFixtureFunc" c:type="GTestFixtureFunc"/>
43392
43725
  </parameter>
@@ -44302,7 +44635,7 @@ regularly stop all unused threads e.g. from g_timeout_add().</doc>
44302
44635
  <function name="thread_self"
44303
44636
  c:identifier="g_thread_self"
44304
44637
  moved-to="Thread.self">
44305
- <doc xml:space="preserve">This functions returns the #GThread corresponding to the
44638
+ <doc xml:space="preserve">This function returns the #GThread corresponding to the
44306
44639
  current thread. Note that this function does not increase
44307
44640
  the reference count of the returned struct.
44308
44641
 
@@ -44378,8 +44711,10 @@ g_timeout_add_seconds() function; this function allows for more
44378
44711
  optimizations and more efficient system power usage.
44379
44712
 
44380
44713
  This internally creates a main loop source using g_timeout_source_new()
44381
- and attaches it to the main loop context using g_source_attach(). You can
44382
- do these steps manually if you need greater control.
44714
+ and attaches it to the global #GMainContext using g_source_attach(), so
44715
+ the callback will be invoked in whichever thread is running that main
44716
+ context. You can do these steps manually if you need greater control or to
44717
+ use a custom main context.
44383
44718
 
44384
44719
  The interval given is in terms of monotonic time, not wall clock
44385
44720
  time. See g_get_monotonic_time().</doc>
@@ -44420,8 +44755,10 @@ timeout is recalculated based on the current time and the given interval
44420
44755
  (it does not try to 'catch up' time lost in delays).
44421
44756
 
44422
44757
  This internally creates a main loop source using g_timeout_source_new()
44423
- and attaches it to the main loop context using g_source_attach(). You can
44424
- do these steps manually if you need greater control.
44758
+ and attaches it to the global #GMainContext using g_source_attach(), so
44759
+ the callback will be invoked in whichever thread is running that main
44760
+ context. You can do these steps manually if you need greater control or to
44761
+ use a custom main context.
44425
44762
 
44426
44763
  The interval given in terms of monotonic time, not wall clock time.
44427
44764
  See g_get_monotonic_time().</doc>
@@ -44734,7 +45071,9 @@ but care is taken to detect possible overflow during multiplication.</doc>
44734
45071
  introspectable="0">
44735
45072
  <doc xml:space="preserve">Attempts to realloc @mem to a new size, @n_bytes, and returns %NULL
44736
45073
  on failure. Contrast with g_realloc(), which aborts the program
44737
- on failure. If @mem is %NULL, behaves the same as g_try_malloc().</doc>
45074
+ on failure.
45075
+
45076
+ If @mem is %NULL, behaves the same as g_try_malloc().</doc>
44738
45077
  <return-value>
44739
45078
  <doc xml:space="preserve">the allocated memory, or %NULL.</doc>
44740
45079
  <type name="gpointer" c:type="gpointer"/>
@@ -46994,6 +47333,45 @@ positional parameters, as specified in the Single Unix Specification.</doc>
46994
47333
  </parameter>
46995
47334
  </parameters>
46996
47335
  </function>
47336
+ <function name="win32_check_windows_version"
47337
+ c:identifier="g_win32_check_windows_version"
47338
+ version="2.44">
47339
+ <doc xml:space="preserve">Returns whether the version of the Windows operating system the
47340
+ code is running on is at least the specified major, minor and
47341
+ service pack versions. See MSDN documentation for the Operating
47342
+ System Version. Software that needs even more detailed version and
47343
+ feature information should use the Win32 API VerifyVersionInfo()
47344
+ directly.
47345
+
47346
+ Successive calls of this function can be used for enabling or
47347
+ disabling features at run-time for a range of Windows versions,
47348
+ as per the VerifyVersionInfo() API documentation.</doc>
47349
+ <return-value transfer-ownership="none">
47350
+ <doc xml:space="preserve">%TRUE if the Windows Version is the same or greater than
47351
+ the specified major, minor and service pack versions, and
47352
+ whether the running Windows is a workstation or server edition
47353
+ of Windows, if specifically specified.</doc>
47354
+ <type name="gboolean" c:type="gboolean"/>
47355
+ </return-value>
47356
+ <parameters>
47357
+ <parameter name="major" transfer-ownership="none">
47358
+ <doc xml:space="preserve">major version of Windows</doc>
47359
+ <type name="gint" c:type="const gint"/>
47360
+ </parameter>
47361
+ <parameter name="minor" transfer-ownership="none">
47362
+ <doc xml:space="preserve">minor version of Windows</doc>
47363
+ <type name="gint" c:type="const gint"/>
47364
+ </parameter>
47365
+ <parameter name="spver" transfer-ownership="none">
47366
+ <doc xml:space="preserve">Windows Service Pack Level, 0 if none</doc>
47367
+ <type name="gint" c:type="const gint"/>
47368
+ </parameter>
47369
+ <parameter name="os_type" transfer-ownership="none">
47370
+ <doc xml:space="preserve">Type of Windows OS</doc>
47371
+ <type name="Win32OSType" c:type="const GWin32OSType"/>
47372
+ </parameter>
47373
+ </parameters>
47374
+ </function>
46997
47375
  <function name="win32_error_message" c:identifier="g_win32_error_message">
46998
47376
  <doc xml:space="preserve">Translate a Win32 error code (as returned by GetLastError() or
46999
47377
  WSAGetLastError()) into the corresponding message. The message is
@@ -47155,8 +47533,12 @@ with g_free() when not needed any longer. If the function fails
47155
47533
  </function>
47156
47534
  <function name="win32_get_windows_version"
47157
47535
  c:identifier="g_win32_get_windows_version"
47158
- version="2.6">
47159
- <doc xml:space="preserve">Returns version information for the Windows operating system the
47536
+ deprecated="1"
47537
+ deprecated-version="2.44">
47538
+ <doc xml:space="preserve">This function is deprecated. Use
47539
+ g_win32_check_windows_version() instead.
47540
+
47541
+ Returns version information for the Windows operating system the
47160
47542
  code is running on. See MSDN documentation for the GetVersion()
47161
47543
  function. To summarize, the most significant bit is one on Win9x,
47162
47544
  and zero on NT-based systems. Since version 2.14, GLib works only
@@ -47165,6 +47547,11 @@ in your own software is moot. The least significant byte is 4 on
47165
47547
  Windows NT 4, and 5 on Windows XP. Software that needs really
47166
47548
  detailed version and feature information should use Win32 API like
47167
47549
  GetVersionEx() and VerifyVersionInfo().</doc>
47550
+ <doc-deprecated xml:space="preserve">Be aware that for Windows 8.1 and Windows Server
47551
+ 2012 R2 and later, this will return 62 unless the application is
47552
+ manifested for Windows 8.1/Windows Server 2012 R2, for example.
47553
+ MSDN stated that GetVersion(), which is used here, is subject to
47554
+ further change or removal after Windows 8.1.</doc-deprecated>
47168
47555
  <return-value transfer-ownership="none">
47169
47556
  <doc xml:space="preserve">The version information.</doc>
47170
47557
  <type name="guint" c:type="guint"/>