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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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
data/vendor/local/share/gir-1.0/GObject-2.0.gir CHANGED
@@ -14,6 +14,12 @@ and/or use gtk-doc annotations. -->
14
14
  shared-library="libgobject-2.0-0.dll"
15
15
  c:identifier-prefixes="G"
16
16
  c:symbol-prefixes="g">
17
+ <alias name="InitiallyUnowned_autoptr" c:type="GInitiallyUnowned_autoptr">
18
+ <type name="gpointer" c:type="gpointer"/>
19
+ </alias>
20
+ <alias name="Object_autoptr" c:type="GObject_autoptr">
21
+ <type name="gpointer" c:type="gpointer"/>
22
+ </alias>
17
23
  <alias name="SignalCMarshaller" c:type="GSignalCMarshaller">
18
24
  <doc xml:space="preserve">This is the signature of marshaller functions, required to marshall
19
25
  arrays of parameter values to signal emissions into C language callback
@@ -405,26 +411,41 @@ structure passed.</doc>
405
411
  </field>
406
412
  <function name="marshal_BOOLEAN__BOXED_BOXED"
407
413
  c:identifier="g_cclosure_marshal_BOOLEAN__BOXED_BOXED">
414
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with handlers that
415
+ take two boxed pointers as arguments and return a boolean. If you
416
+ have such a signal, you will probably also need to use an
417
+ accumulator, such as g_signal_accumulator_true_handled().</doc>
408
418
  <return-value transfer-ownership="none">
409
419
  <type name="none" c:type="void"/>
410
420
  </return-value>
411
421
  <parameters>
412
422
  <parameter name="closure" transfer-ownership="none">
423
+ <doc xml:space="preserve">A #GClosure.</doc>
413
424
  <type name="Closure" c:type="GClosure*"/>
414
425
  </parameter>
415
426
  <parameter name="return_value" transfer-ownership="none">
427
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
428
+ if the callback of closure doesn't return a value.</doc>
416
429
  <type name="Value" c:type="GValue*"/>
417
430
  </parameter>
418
431
  <parameter name="n_param_values" transfer-ownership="none">
432
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
419
433
  <type name="guint" c:type="guint"/>
420
434
  </parameter>
421
435
  <parameter name="param_values" transfer-ownership="none">
436
+ <doc xml:space="preserve">An array of #GValues holding the arguments
437
+ on which to invoke the callback of closure.</doc>
422
438
  <type name="Value" c:type="const GValue*"/>
423
439
  </parameter>
424
440
  <parameter name="invocation_hint" transfer-ownership="none">
441
+ <doc xml:space="preserve">The invocation hint given as the last argument to
442
+ g_closure_invoke().</doc>
425
443
  <type name="gpointer" c:type="gpointer"/>
426
444
  </parameter>
427
445
  <parameter name="marshal_data" transfer-ownership="none">
446
+ <doc xml:space="preserve">Additional data specified when registering the
447
+ marshaller, see g_closure_set_marshal() and
448
+ g_closure_set_meta_marshal()</doc>
428
449
  <type name="gpointer" c:type="gpointer"/>
429
450
  </parameter>
430
451
  </parameters>
@@ -432,65 +453,91 @@ structure passed.</doc>
432
453
  <function name="marshal_BOOLEAN__BOXED_BOXEDv"
433
454
  c:identifier="g_cclosure_marshal_BOOLEAN__BOXED_BOXEDv"
434
455
  introspectable="0">
456
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_BOOLEAN__BOXED_BOXED().</doc>
435
457
  <return-value transfer-ownership="none">
436
458
  <type name="none" c:type="void"/>
437
459
  </return-value>
438
460
  <parameters>
439
461
  <parameter name="closure" transfer-ownership="none">
462
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
440
463
  <type name="Closure" c:type="GClosure*"/>
441
464
  </parameter>
442
- <parameter name="return_value" transfer-ownership="none">
465
+ <parameter name="return_value"
466
+ transfer-ownership="none"
467
+ nullable="1"
468
+ allow-none="1">
469
+ <doc xml:space="preserve">a #GValue to store the return
470
+ value. May be %NULL if the callback of @closure doesn't return a
471
+ value.</doc>
443
472
  <type name="Value" c:type="GValue*"/>
444
473
  </parameter>
445
474
  <parameter name="instance" transfer-ownership="none">
475
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
446
476
  <type name="gpointer" c:type="gpointer"/>
447
477
  </parameter>
448
478
  <parameter name="args" transfer-ownership="none">
479
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
449
480
  <type name="va_list" c:type="va_list"/>
450
481
  </parameter>
451
- <parameter name="marshal_data" transfer-ownership="none">
482
+ <parameter name="marshal_data"
483
+ transfer-ownership="none"
484
+ nullable="1"
485
+ allow-none="1">
486
+ <doc xml:space="preserve">additional data specified when
487
+ registering the marshaller, see g_closure_set_marshal() and
488
+ g_closure_set_meta_marshal()</doc>
452
489
  <type name="gpointer" c:type="gpointer"/>
453
490
  </parameter>
454
491
  <parameter name="n_params" transfer-ownership="none">
492
+ <doc xml:space="preserve">the length of the @param_types array</doc>
455
493
  <type name="gint" c:type="int"/>
456
494
  </parameter>
457
495
  <parameter name="param_types" transfer-ownership="none">
458
- <type name="GType" c:type="GType*"/>
496
+ <doc xml:space="preserve">the #GType of each argument from
497
+ @args.</doc>
498
+ <array length="5" zero-terminated="0" c:type="GType*">
499
+ <type name="GType" c:type="GType"/>
500
+ </array>
459
501
  </parameter>
460
502
  </parameters>
461
503
  </function>
462
504
  <function name="marshal_BOOLEAN__FLAGS"
463
505
  c:identifier="g_cclosure_marshal_BOOLEAN__FLAGS">
464
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
465
- `gboolean (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter
466
- denotes a flags type.</doc>
506
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with handlers that
507
+ take a flags type as an argument and return a boolean. If you have
508
+ such a signal, you will probably also need to use an accumulator,
509
+ such as g_signal_accumulator_true_handled().</doc>
467
510
  <return-value transfer-ownership="none">
468
511
  <type name="none" c:type="void"/>
469
512
  </return-value>
470
513
  <parameters>
471
514
  <parameter name="closure" transfer-ownership="none">
472
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
515
+ <doc xml:space="preserve">A #GClosure.</doc>
473
516
  <type name="Closure" c:type="GClosure*"/>
474
517
  </parameter>
475
518
  <parameter name="return_value" transfer-ownership="none">
476
- <doc xml:space="preserve">a #GValue which can store the returned #gboolean</doc>
519
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
520
+ if the callback of closure doesn't return a value.</doc>
477
521
  <type name="Value" c:type="GValue*"/>
478
522
  </parameter>
479
523
  <parameter name="n_param_values" transfer-ownership="none">
480
- <doc xml:space="preserve">2</doc>
524
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
481
525
  <type name="guint" c:type="guint"/>
482
526
  </parameter>
483
527
  <parameter name="param_values" transfer-ownership="none">
484
- <doc xml:space="preserve">a #GValue array holding instance and arg1</doc>
528
+ <doc xml:space="preserve">An array of #GValues holding the arguments
529
+ on which to invoke the callback of closure.</doc>
485
530
  <type name="Value" c:type="const GValue*"/>
486
531
  </parameter>
487
532
  <parameter name="invocation_hint" transfer-ownership="none">
488
- <doc xml:space="preserve">the invocation hint given as the last argument
489
- to g_closure_invoke()</doc>
533
+ <doc xml:space="preserve">The invocation hint given as the last argument to
534
+ g_closure_invoke().</doc>
490
535
  <type name="gpointer" c:type="gpointer"/>
491
536
  </parameter>
492
537
  <parameter name="marshal_data" transfer-ownership="none">
493
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
538
+ <doc xml:space="preserve">Additional data specified when registering the
539
+ marshaller, see g_closure_set_marshal() and
540
+ g_closure_set_meta_marshal()</doc>
494
541
  <type name="gpointer" c:type="gpointer"/>
495
542
  </parameter>
496
543
  </parameters>
@@ -498,64 +545,90 @@ denotes a flags type.</doc>
498
545
  <function name="marshal_BOOLEAN__FLAGSv"
499
546
  c:identifier="g_cclosure_marshal_BOOLEAN__FLAGSv"
500
547
  introspectable="0">
548
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_BOOLEAN__FLAGS().</doc>
501
549
  <return-value transfer-ownership="none">
502
550
  <type name="none" c:type="void"/>
503
551
  </return-value>
504
552
  <parameters>
505
553
  <parameter name="closure" transfer-ownership="none">
554
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
506
555
  <type name="Closure" c:type="GClosure*"/>
507
556
  </parameter>
508
- <parameter name="return_value" transfer-ownership="none">
557
+ <parameter name="return_value"
558
+ transfer-ownership="none"
559
+ nullable="1"
560
+ allow-none="1">
561
+ <doc xml:space="preserve">a #GValue to store the return
562
+ value. May be %NULL if the callback of @closure doesn't return a
563
+ value.</doc>
509
564
  <type name="Value" c:type="GValue*"/>
510
565
  </parameter>
511
566
  <parameter name="instance" transfer-ownership="none">
567
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
512
568
  <type name="gpointer" c:type="gpointer"/>
513
569
  </parameter>
514
570
  <parameter name="args" transfer-ownership="none">
571
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
515
572
  <type name="va_list" c:type="va_list"/>
516
573
  </parameter>
517
- <parameter name="marshal_data" transfer-ownership="none">
574
+ <parameter name="marshal_data"
575
+ transfer-ownership="none"
576
+ nullable="1"
577
+ allow-none="1">
578
+ <doc xml:space="preserve">additional data specified when
579
+ registering the marshaller, see g_closure_set_marshal() and
580
+ g_closure_set_meta_marshal()</doc>
518
581
  <type name="gpointer" c:type="gpointer"/>
519
582
  </parameter>
520
583
  <parameter name="n_params" transfer-ownership="none">
584
+ <doc xml:space="preserve">the length of the @param_types array</doc>
521
585
  <type name="gint" c:type="int"/>
522
586
  </parameter>
523
587
  <parameter name="param_types" transfer-ownership="none">
524
- <type name="GType" c:type="GType*"/>
588
+ <doc xml:space="preserve">the #GType of each argument from
589
+ @args.</doc>
590
+ <array length="5" zero-terminated="0" c:type="GType*">
591
+ <type name="GType" c:type="GType"/>
592
+ </array>
525
593
  </parameter>
526
594
  </parameters>
527
595
  </function>
528
596
  <function name="marshal_STRING__OBJECT_POINTER"
529
597
  c:identifier="g_cclosure_marshal_STRING__OBJECT_POINTER">
530
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
531
- `gchar* (*callback) (gpointer instance, GObject *arg1, gpointer arg2, gpointer user_data)`.</doc>
598
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with handlers that
599
+ take a #GObject and a pointer and produce a string. It is highly
600
+ unlikely that your signal handler fits this description.</doc>
532
601
  <return-value transfer-ownership="none">
533
602
  <type name="none" c:type="void"/>
534
603
  </return-value>
535
604
  <parameters>
536
605
  <parameter name="closure" transfer-ownership="none">
537
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
606
+ <doc xml:space="preserve">A #GClosure.</doc>
538
607
  <type name="Closure" c:type="GClosure*"/>
539
608
  </parameter>
540
609
  <parameter name="return_value" transfer-ownership="none">
541
- <doc xml:space="preserve">a #GValue, which can store the returned string</doc>
610
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
611
+ if the callback of closure doesn't return a value.</doc>
542
612
  <type name="Value" c:type="GValue*"/>
543
613
  </parameter>
544
614
  <parameter name="n_param_values" transfer-ownership="none">
545
- <doc xml:space="preserve">3</doc>
615
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
546
616
  <type name="guint" c:type="guint"/>
547
617
  </parameter>
548
618
  <parameter name="param_values" transfer-ownership="none">
549
- <doc xml:space="preserve">a #GValue array holding instance, arg1 and arg2</doc>
619
+ <doc xml:space="preserve">An array of #GValues holding the arguments
620
+ on which to invoke the callback of closure.</doc>
550
621
  <type name="Value" c:type="const GValue*"/>
551
622
  </parameter>
552
623
  <parameter name="invocation_hint" transfer-ownership="none">
553
- <doc xml:space="preserve">the invocation hint given as the last argument
554
- to g_closure_invoke()</doc>
624
+ <doc xml:space="preserve">The invocation hint given as the last argument to
625
+ g_closure_invoke().</doc>
555
626
  <type name="gpointer" c:type="gpointer"/>
556
627
  </parameter>
557
628
  <parameter name="marshal_data" transfer-ownership="none">
558
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
629
+ <doc xml:space="preserve">Additional data specified when registering the
630
+ marshaller, see g_closure_set_marshal() and
631
+ g_closure_set_meta_marshal()</doc>
559
632
  <type name="gpointer" c:type="gpointer"/>
560
633
  </parameter>
561
634
  </parameters>
@@ -563,64 +636,89 @@ denotes a flags type.</doc>
563
636
  <function name="marshal_STRING__OBJECT_POINTERv"
564
637
  c:identifier="g_cclosure_marshal_STRING__OBJECT_POINTERv"
565
638
  introspectable="0">
639
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_STRING__OBJECT_POINTER().</doc>
566
640
  <return-value transfer-ownership="none">
567
641
  <type name="none" c:type="void"/>
568
642
  </return-value>
569
643
  <parameters>
570
644
  <parameter name="closure" transfer-ownership="none">
645
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
571
646
  <type name="Closure" c:type="GClosure*"/>
572
647
  </parameter>
573
- <parameter name="return_value" transfer-ownership="none">
648
+ <parameter name="return_value"
649
+ transfer-ownership="none"
650
+ nullable="1"
651
+ allow-none="1">
652
+ <doc xml:space="preserve">a #GValue to store the return
653
+ value. May be %NULL if the callback of @closure doesn't return a
654
+ value.</doc>
574
655
  <type name="Value" c:type="GValue*"/>
575
656
  </parameter>
576
657
  <parameter name="instance" transfer-ownership="none">
658
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
577
659
  <type name="gpointer" c:type="gpointer"/>
578
660
  </parameter>
579
661
  <parameter name="args" transfer-ownership="none">
662
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
580
663
  <type name="va_list" c:type="va_list"/>
581
664
  </parameter>
582
- <parameter name="marshal_data" transfer-ownership="none">
665
+ <parameter name="marshal_data"
666
+ transfer-ownership="none"
667
+ nullable="1"
668
+ allow-none="1">
669
+ <doc xml:space="preserve">additional data specified when
670
+ registering the marshaller, see g_closure_set_marshal() and
671
+ g_closure_set_meta_marshal()</doc>
583
672
  <type name="gpointer" c:type="gpointer"/>
584
673
  </parameter>
585
674
  <parameter name="n_params" transfer-ownership="none">
675
+ <doc xml:space="preserve">the length of the @param_types array</doc>
586
676
  <type name="gint" c:type="int"/>
587
677
  </parameter>
588
678
  <parameter name="param_types" transfer-ownership="none">
589
- <type name="GType" c:type="GType*"/>
679
+ <doc xml:space="preserve">the #GType of each argument from
680
+ @args.</doc>
681
+ <array length="5" zero-terminated="0" c:type="GType*">
682
+ <type name="GType" c:type="GType"/>
683
+ </array>
590
684
  </parameter>
591
685
  </parameters>
592
686
  </function>
593
687
  <function name="marshal_VOID__BOOLEAN"
594
688
  c:identifier="g_cclosure_marshal_VOID__BOOLEAN">
595
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
596
- `void (*callback) (gpointer instance, gboolean arg1, gpointer user_data)`.</doc>
689
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
690
+ boolean argument.</doc>
597
691
  <return-value transfer-ownership="none">
598
692
  <type name="none" c:type="void"/>
599
693
  </return-value>
600
694
  <parameters>
601
695
  <parameter name="closure" transfer-ownership="none">
602
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
696
+ <doc xml:space="preserve">A #GClosure.</doc>
603
697
  <type name="Closure" c:type="GClosure*"/>
604
698
  </parameter>
605
699
  <parameter name="return_value" transfer-ownership="none">
606
- <doc xml:space="preserve">ignored</doc>
700
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
701
+ if the callback of closure doesn't return a value.</doc>
607
702
  <type name="Value" c:type="GValue*"/>
608
703
  </parameter>
609
704
  <parameter name="n_param_values" transfer-ownership="none">
610
- <doc xml:space="preserve">2</doc>
705
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
611
706
  <type name="guint" c:type="guint"/>
612
707
  </parameter>
613
708
  <parameter name="param_values" transfer-ownership="none">
614
- <doc xml:space="preserve">a #GValue array holding the instance and the #gboolean parameter</doc>
709
+ <doc xml:space="preserve">An array of #GValues holding the arguments
710
+ on which to invoke the callback of closure.</doc>
615
711
  <type name="Value" c:type="const GValue*"/>
616
712
  </parameter>
617
713
  <parameter name="invocation_hint" transfer-ownership="none">
618
- <doc xml:space="preserve">the invocation hint given as the last argument
619
- to g_closure_invoke()</doc>
714
+ <doc xml:space="preserve">The invocation hint given as the last argument to
715
+ g_closure_invoke().</doc>
620
716
  <type name="gpointer" c:type="gpointer"/>
621
717
  </parameter>
622
718
  <parameter name="marshal_data" transfer-ownership="none">
623
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
719
+ <doc xml:space="preserve">Additional data specified when registering the
720
+ marshaller, see g_closure_set_marshal() and
721
+ g_closure_set_meta_marshal()</doc>
624
722
  <type name="gpointer" c:type="gpointer"/>
625
723
  </parameter>
626
724
  </parameters>
@@ -628,64 +726,89 @@ denotes a flags type.</doc>
628
726
  <function name="marshal_VOID__BOOLEANv"
629
727
  c:identifier="g_cclosure_marshal_VOID__BOOLEANv"
630
728
  introspectable="0">
729
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__BOOLEAN().</doc>
631
730
  <return-value transfer-ownership="none">
632
731
  <type name="none" c:type="void"/>
633
732
  </return-value>
634
733
  <parameters>
635
734
  <parameter name="closure" transfer-ownership="none">
735
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
636
736
  <type name="Closure" c:type="GClosure*"/>
637
737
  </parameter>
638
- <parameter name="return_value" transfer-ownership="none">
738
+ <parameter name="return_value"
739
+ transfer-ownership="none"
740
+ nullable="1"
741
+ allow-none="1">
742
+ <doc xml:space="preserve">a #GValue to store the return
743
+ value. May be %NULL if the callback of @closure doesn't return a
744
+ value.</doc>
639
745
  <type name="Value" c:type="GValue*"/>
640
746
  </parameter>
641
747
  <parameter name="instance" transfer-ownership="none">
748
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
642
749
  <type name="gpointer" c:type="gpointer"/>
643
750
  </parameter>
644
751
  <parameter name="args" transfer-ownership="none">
752
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
645
753
  <type name="va_list" c:type="va_list"/>
646
754
  </parameter>
647
- <parameter name="marshal_data" transfer-ownership="none">
755
+ <parameter name="marshal_data"
756
+ transfer-ownership="none"
757
+ nullable="1"
758
+ allow-none="1">
759
+ <doc xml:space="preserve">additional data specified when
760
+ registering the marshaller, see g_closure_set_marshal() and
761
+ g_closure_set_meta_marshal()</doc>
648
762
  <type name="gpointer" c:type="gpointer"/>
649
763
  </parameter>
650
764
  <parameter name="n_params" transfer-ownership="none">
765
+ <doc xml:space="preserve">the length of the @param_types array</doc>
651
766
  <type name="gint" c:type="int"/>
652
767
  </parameter>
653
768
  <parameter name="param_types" transfer-ownership="none">
654
- <type name="GType" c:type="GType*"/>
769
+ <doc xml:space="preserve">the #GType of each argument from
770
+ @args.</doc>
771
+ <array length="5" zero-terminated="0" c:type="GType*">
772
+ <type name="GType" c:type="GType"/>
773
+ </array>
655
774
  </parameter>
656
775
  </parameters>
657
776
  </function>
658
777
  <function name="marshal_VOID__BOXED"
659
778
  c:identifier="g_cclosure_marshal_VOID__BOXED">
660
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
661
- `void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data)`.</doc>
779
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
780
+ argument which is any boxed pointer type.</doc>
662
781
  <return-value transfer-ownership="none">
663
782
  <type name="none" c:type="void"/>
664
783
  </return-value>
665
784
  <parameters>
666
785
  <parameter name="closure" transfer-ownership="none">
667
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
786
+ <doc xml:space="preserve">A #GClosure.</doc>
668
787
  <type name="Closure" c:type="GClosure*"/>
669
788
  </parameter>
670
789
  <parameter name="return_value" transfer-ownership="none">
671
- <doc xml:space="preserve">ignored</doc>
790
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
791
+ if the callback of closure doesn't return a value.</doc>
672
792
  <type name="Value" c:type="GValue*"/>
673
793
  </parameter>
674
794
  <parameter name="n_param_values" transfer-ownership="none">
675
- <doc xml:space="preserve">2</doc>
795
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
676
796
  <type name="guint" c:type="guint"/>
677
797
  </parameter>
678
798
  <parameter name="param_values" transfer-ownership="none">
679
- <doc xml:space="preserve">a #GValue array holding the instance and the #GBoxed* parameter</doc>
799
+ <doc xml:space="preserve">An array of #GValues holding the arguments
800
+ on which to invoke the callback of closure.</doc>
680
801
  <type name="Value" c:type="const GValue*"/>
681
802
  </parameter>
682
803
  <parameter name="invocation_hint" transfer-ownership="none">
683
- <doc xml:space="preserve">the invocation hint given as the last argument
684
- to g_closure_invoke()</doc>
804
+ <doc xml:space="preserve">The invocation hint given as the last argument to
805
+ g_closure_invoke().</doc>
685
806
  <type name="gpointer" c:type="gpointer"/>
686
807
  </parameter>
687
808
  <parameter name="marshal_data" transfer-ownership="none">
688
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
809
+ <doc xml:space="preserve">Additional data specified when registering the
810
+ marshaller, see g_closure_set_marshal() and
811
+ g_closure_set_meta_marshal()</doc>
689
812
  <type name="gpointer" c:type="gpointer"/>
690
813
  </parameter>
691
814
  </parameters>
@@ -693,64 +816,89 @@ denotes a flags type.</doc>
693
816
  <function name="marshal_VOID__BOXEDv"
694
817
  c:identifier="g_cclosure_marshal_VOID__BOXEDv"
695
818
  introspectable="0">
819
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__BOXED().</doc>
696
820
  <return-value transfer-ownership="none">
697
821
  <type name="none" c:type="void"/>
698
822
  </return-value>
699
823
  <parameters>
700
824
  <parameter name="closure" transfer-ownership="none">
825
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
701
826
  <type name="Closure" c:type="GClosure*"/>
702
827
  </parameter>
703
- <parameter name="return_value" transfer-ownership="none">
828
+ <parameter name="return_value"
829
+ transfer-ownership="none"
830
+ nullable="1"
831
+ allow-none="1">
832
+ <doc xml:space="preserve">a #GValue to store the return
833
+ value. May be %NULL if the callback of @closure doesn't return a
834
+ value.</doc>
704
835
  <type name="Value" c:type="GValue*"/>
705
836
  </parameter>
706
837
  <parameter name="instance" transfer-ownership="none">
838
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
707
839
  <type name="gpointer" c:type="gpointer"/>
708
840
  </parameter>
709
841
  <parameter name="args" transfer-ownership="none">
842
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
710
843
  <type name="va_list" c:type="va_list"/>
711
844
  </parameter>
712
- <parameter name="marshal_data" transfer-ownership="none">
845
+ <parameter name="marshal_data"
846
+ transfer-ownership="none"
847
+ nullable="1"
848
+ allow-none="1">
849
+ <doc xml:space="preserve">additional data specified when
850
+ registering the marshaller, see g_closure_set_marshal() and
851
+ g_closure_set_meta_marshal()</doc>
713
852
  <type name="gpointer" c:type="gpointer"/>
714
853
  </parameter>
715
854
  <parameter name="n_params" transfer-ownership="none">
855
+ <doc xml:space="preserve">the length of the @param_types array</doc>
716
856
  <type name="gint" c:type="int"/>
717
857
  </parameter>
718
858
  <parameter name="param_types" transfer-ownership="none">
719
- <type name="GType" c:type="GType*"/>
859
+ <doc xml:space="preserve">the #GType of each argument from
860
+ @args.</doc>
861
+ <array length="5" zero-terminated="0" c:type="GType*">
862
+ <type name="GType" c:type="GType"/>
863
+ </array>
720
864
  </parameter>
721
865
  </parameters>
722
866
  </function>
723
867
  <function name="marshal_VOID__CHAR"
724
868
  c:identifier="g_cclosure_marshal_VOID__CHAR">
725
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
726
- `void (*callback) (gpointer instance, gchar arg1, gpointer user_data)`.</doc>
869
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
870
+ character argument.</doc>
727
871
  <return-value transfer-ownership="none">
728
872
  <type name="none" c:type="void"/>
729
873
  </return-value>
730
874
  <parameters>
731
875
  <parameter name="closure" transfer-ownership="none">
732
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
876
+ <doc xml:space="preserve">A #GClosure.</doc>
733
877
  <type name="Closure" c:type="GClosure*"/>
734
878
  </parameter>
735
879
  <parameter name="return_value" transfer-ownership="none">
736
- <doc xml:space="preserve">ignored</doc>
880
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
881
+ if the callback of closure doesn't return a value.</doc>
737
882
  <type name="Value" c:type="GValue*"/>
738
883
  </parameter>
739
884
  <parameter name="n_param_values" transfer-ownership="none">
740
- <doc xml:space="preserve">2</doc>
885
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
741
886
  <type name="guint" c:type="guint"/>
742
887
  </parameter>
743
888
  <parameter name="param_values" transfer-ownership="none">
744
- <doc xml:space="preserve">a #GValue array holding the instance and the #gchar parameter</doc>
889
+ <doc xml:space="preserve">An array of #GValues holding the arguments
890
+ on which to invoke the callback of closure.</doc>
745
891
  <type name="Value" c:type="const GValue*"/>
746
892
  </parameter>
747
893
  <parameter name="invocation_hint" transfer-ownership="none">
748
- <doc xml:space="preserve">the invocation hint given as the last argument
749
- to g_closure_invoke()</doc>
894
+ <doc xml:space="preserve">The invocation hint given as the last argument to
895
+ g_closure_invoke().</doc>
750
896
  <type name="gpointer" c:type="gpointer"/>
751
897
  </parameter>
752
898
  <parameter name="marshal_data" transfer-ownership="none">
753
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
899
+ <doc xml:space="preserve">Additional data specified when registering the
900
+ marshaller, see g_closure_set_marshal() and
901
+ g_closure_set_meta_marshal()</doc>
754
902
  <type name="gpointer" c:type="gpointer"/>
755
903
  </parameter>
756
904
  </parameters>
@@ -758,64 +906,89 @@ denotes a flags type.</doc>
758
906
  <function name="marshal_VOID__CHARv"
759
907
  c:identifier="g_cclosure_marshal_VOID__CHARv"
760
908
  introspectable="0">
909
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__CHAR().</doc>
761
910
  <return-value transfer-ownership="none">
762
911
  <type name="none" c:type="void"/>
763
912
  </return-value>
764
913
  <parameters>
765
914
  <parameter name="closure" transfer-ownership="none">
915
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
766
916
  <type name="Closure" c:type="GClosure*"/>
767
917
  </parameter>
768
- <parameter name="return_value" transfer-ownership="none">
918
+ <parameter name="return_value"
919
+ transfer-ownership="none"
920
+ nullable="1"
921
+ allow-none="1">
922
+ <doc xml:space="preserve">a #GValue to store the return
923
+ value. May be %NULL if the callback of @closure doesn't return a
924
+ value.</doc>
769
925
  <type name="Value" c:type="GValue*"/>
770
926
  </parameter>
771
927
  <parameter name="instance" transfer-ownership="none">
928
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
772
929
  <type name="gpointer" c:type="gpointer"/>
773
930
  </parameter>
774
931
  <parameter name="args" transfer-ownership="none">
932
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
775
933
  <type name="va_list" c:type="va_list"/>
776
934
  </parameter>
777
- <parameter name="marshal_data" transfer-ownership="none">
935
+ <parameter name="marshal_data"
936
+ transfer-ownership="none"
937
+ nullable="1"
938
+ allow-none="1">
939
+ <doc xml:space="preserve">additional data specified when
940
+ registering the marshaller, see g_closure_set_marshal() and
941
+ g_closure_set_meta_marshal()</doc>
778
942
  <type name="gpointer" c:type="gpointer"/>
779
943
  </parameter>
780
944
  <parameter name="n_params" transfer-ownership="none">
945
+ <doc xml:space="preserve">the length of the @param_types array</doc>
781
946
  <type name="gint" c:type="int"/>
782
947
  </parameter>
783
948
  <parameter name="param_types" transfer-ownership="none">
784
- <type name="GType" c:type="GType*"/>
949
+ <doc xml:space="preserve">the #GType of each argument from
950
+ @args.</doc>
951
+ <array length="5" zero-terminated="0" c:type="GType*">
952
+ <type name="GType" c:type="GType"/>
953
+ </array>
785
954
  </parameter>
786
955
  </parameters>
787
956
  </function>
788
957
  <function name="marshal_VOID__DOUBLE"
789
958
  c:identifier="g_cclosure_marshal_VOID__DOUBLE">
790
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
791
- `void (*callback) (gpointer instance, gdouble arg1, gpointer user_data)`.</doc>
959
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with one
960
+ double-precision floating point argument.</doc>
792
961
  <return-value transfer-ownership="none">
793
962
  <type name="none" c:type="void"/>
794
963
  </return-value>
795
964
  <parameters>
796
965
  <parameter name="closure" transfer-ownership="none">
797
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
966
+ <doc xml:space="preserve">A #GClosure.</doc>
798
967
  <type name="Closure" c:type="GClosure*"/>
799
968
  </parameter>
800
969
  <parameter name="return_value" transfer-ownership="none">
801
- <doc xml:space="preserve">ignored</doc>
970
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
971
+ if the callback of closure doesn't return a value.</doc>
802
972
  <type name="Value" c:type="GValue*"/>
803
973
  </parameter>
804
974
  <parameter name="n_param_values" transfer-ownership="none">
805
- <doc xml:space="preserve">2</doc>
975
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
806
976
  <type name="guint" c:type="guint"/>
807
977
  </parameter>
808
978
  <parameter name="param_values" transfer-ownership="none">
809
- <doc xml:space="preserve">a #GValue array holding the instance and the #gdouble parameter</doc>
979
+ <doc xml:space="preserve">An array of #GValues holding the arguments
980
+ on which to invoke the callback of closure.</doc>
810
981
  <type name="Value" c:type="const GValue*"/>
811
982
  </parameter>
812
983
  <parameter name="invocation_hint" transfer-ownership="none">
813
- <doc xml:space="preserve">the invocation hint given as the last argument
814
- to g_closure_invoke()</doc>
984
+ <doc xml:space="preserve">The invocation hint given as the last argument to
985
+ g_closure_invoke().</doc>
815
986
  <type name="gpointer" c:type="gpointer"/>
816
987
  </parameter>
817
988
  <parameter name="marshal_data" transfer-ownership="none">
818
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
989
+ <doc xml:space="preserve">Additional data specified when registering the
990
+ marshaller, see g_closure_set_marshal() and
991
+ g_closure_set_meta_marshal()</doc>
819
992
  <type name="gpointer" c:type="gpointer"/>
820
993
  </parameter>
821
994
  </parameters>
@@ -823,64 +996,89 @@ denotes a flags type.</doc>
823
996
  <function name="marshal_VOID__DOUBLEv"
824
997
  c:identifier="g_cclosure_marshal_VOID__DOUBLEv"
825
998
  introspectable="0">
999
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__DOUBLE().</doc>
826
1000
  <return-value transfer-ownership="none">
827
1001
  <type name="none" c:type="void"/>
828
1002
  </return-value>
829
1003
  <parameters>
830
1004
  <parameter name="closure" transfer-ownership="none">
1005
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
831
1006
  <type name="Closure" c:type="GClosure*"/>
832
1007
  </parameter>
833
- <parameter name="return_value" transfer-ownership="none">
1008
+ <parameter name="return_value"
1009
+ transfer-ownership="none"
1010
+ nullable="1"
1011
+ allow-none="1">
1012
+ <doc xml:space="preserve">a #GValue to store the return
1013
+ value. May be %NULL if the callback of @closure doesn't return a
1014
+ value.</doc>
834
1015
  <type name="Value" c:type="GValue*"/>
835
1016
  </parameter>
836
1017
  <parameter name="instance" transfer-ownership="none">
1018
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
837
1019
  <type name="gpointer" c:type="gpointer"/>
838
1020
  </parameter>
839
1021
  <parameter name="args" transfer-ownership="none">
1022
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
840
1023
  <type name="va_list" c:type="va_list"/>
841
1024
  </parameter>
842
- <parameter name="marshal_data" transfer-ownership="none">
1025
+ <parameter name="marshal_data"
1026
+ transfer-ownership="none"
1027
+ nullable="1"
1028
+ allow-none="1">
1029
+ <doc xml:space="preserve">additional data specified when
1030
+ registering the marshaller, see g_closure_set_marshal() and
1031
+ g_closure_set_meta_marshal()</doc>
843
1032
  <type name="gpointer" c:type="gpointer"/>
844
1033
  </parameter>
845
1034
  <parameter name="n_params" transfer-ownership="none">
1035
+ <doc xml:space="preserve">the length of the @param_types array</doc>
846
1036
  <type name="gint" c:type="int"/>
847
1037
  </parameter>
848
1038
  <parameter name="param_types" transfer-ownership="none">
849
- <type name="GType" c:type="GType*"/>
1039
+ <doc xml:space="preserve">the #GType of each argument from
1040
+ @args.</doc>
1041
+ <array length="5" zero-terminated="0" c:type="GType*">
1042
+ <type name="GType" c:type="GType"/>
1043
+ </array>
850
1044
  </parameter>
851
1045
  </parameters>
852
1046
  </function>
853
1047
  <function name="marshal_VOID__ENUM"
854
1048
  c:identifier="g_cclosure_marshal_VOID__ENUM">
855
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
856
- `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes an enumeration type..</doc>
1049
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
1050
+ argument with an enumerated type.</doc>
857
1051
  <return-value transfer-ownership="none">
858
1052
  <type name="none" c:type="void"/>
859
1053
  </return-value>
860
1054
  <parameters>
861
1055
  <parameter name="closure" transfer-ownership="none">
862
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1056
+ <doc xml:space="preserve">A #GClosure.</doc>
863
1057
  <type name="Closure" c:type="GClosure*"/>
864
1058
  </parameter>
865
1059
  <parameter name="return_value" transfer-ownership="none">
866
- <doc xml:space="preserve">ignored</doc>
1060
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1061
+ if the callback of closure doesn't return a value.</doc>
867
1062
  <type name="Value" c:type="GValue*"/>
868
1063
  </parameter>
869
1064
  <parameter name="n_param_values" transfer-ownership="none">
870
- <doc xml:space="preserve">2</doc>
1065
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
871
1066
  <type name="guint" c:type="guint"/>
872
1067
  </parameter>
873
1068
  <parameter name="param_values" transfer-ownership="none">
874
- <doc xml:space="preserve">a #GValue array holding the instance and the enumeration parameter</doc>
1069
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1070
+ on which to invoke the callback of closure.</doc>
875
1071
  <type name="Value" c:type="const GValue*"/>
876
1072
  </parameter>
877
1073
  <parameter name="invocation_hint" transfer-ownership="none">
878
- <doc xml:space="preserve">the invocation hint given as the last argument
879
- to g_closure_invoke()</doc>
1074
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1075
+ g_closure_invoke().</doc>
880
1076
  <type name="gpointer" c:type="gpointer"/>
881
1077
  </parameter>
882
1078
  <parameter name="marshal_data" transfer-ownership="none">
883
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1079
+ <doc xml:space="preserve">Additional data specified when registering the
1080
+ marshaller, see g_closure_set_marshal() and
1081
+ g_closure_set_meta_marshal()</doc>
884
1082
  <type name="gpointer" c:type="gpointer"/>
885
1083
  </parameter>
886
1084
  </parameters>
@@ -888,64 +1086,89 @@ denotes a flags type.</doc>
888
1086
  <function name="marshal_VOID__ENUMv"
889
1087
  c:identifier="g_cclosure_marshal_VOID__ENUMv"
890
1088
  introspectable="0">
1089
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__ENUM().</doc>
891
1090
  <return-value transfer-ownership="none">
892
1091
  <type name="none" c:type="void"/>
893
1092
  </return-value>
894
1093
  <parameters>
895
1094
  <parameter name="closure" transfer-ownership="none">
1095
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
896
1096
  <type name="Closure" c:type="GClosure*"/>
897
1097
  </parameter>
898
- <parameter name="return_value" transfer-ownership="none">
1098
+ <parameter name="return_value"
1099
+ transfer-ownership="none"
1100
+ nullable="1"
1101
+ allow-none="1">
1102
+ <doc xml:space="preserve">a #GValue to store the return
1103
+ value. May be %NULL if the callback of @closure doesn't return a
1104
+ value.</doc>
899
1105
  <type name="Value" c:type="GValue*"/>
900
1106
  </parameter>
901
1107
  <parameter name="instance" transfer-ownership="none">
1108
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
902
1109
  <type name="gpointer" c:type="gpointer"/>
903
1110
  </parameter>
904
1111
  <parameter name="args" transfer-ownership="none">
1112
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
905
1113
  <type name="va_list" c:type="va_list"/>
906
1114
  </parameter>
907
- <parameter name="marshal_data" transfer-ownership="none">
1115
+ <parameter name="marshal_data"
1116
+ transfer-ownership="none"
1117
+ nullable="1"
1118
+ allow-none="1">
1119
+ <doc xml:space="preserve">additional data specified when
1120
+ registering the marshaller, see g_closure_set_marshal() and
1121
+ g_closure_set_meta_marshal()</doc>
908
1122
  <type name="gpointer" c:type="gpointer"/>
909
1123
  </parameter>
910
1124
  <parameter name="n_params" transfer-ownership="none">
1125
+ <doc xml:space="preserve">the length of the @param_types array</doc>
911
1126
  <type name="gint" c:type="int"/>
912
1127
  </parameter>
913
1128
  <parameter name="param_types" transfer-ownership="none">
914
- <type name="GType" c:type="GType*"/>
1129
+ <doc xml:space="preserve">the #GType of each argument from
1130
+ @args.</doc>
1131
+ <array length="5" zero-terminated="0" c:type="GType*">
1132
+ <type name="GType" c:type="GType"/>
1133
+ </array>
915
1134
  </parameter>
916
1135
  </parameters>
917
1136
  </function>
918
1137
  <function name="marshal_VOID__FLAGS"
919
1138
  c:identifier="g_cclosure_marshal_VOID__FLAGS">
920
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
921
- `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes a flags type.</doc>
1139
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
1140
+ argument with a flags types.</doc>
922
1141
  <return-value transfer-ownership="none">
923
1142
  <type name="none" c:type="void"/>
924
1143
  </return-value>
925
1144
  <parameters>
926
1145
  <parameter name="closure" transfer-ownership="none">
927
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1146
+ <doc xml:space="preserve">A #GClosure.</doc>
928
1147
  <type name="Closure" c:type="GClosure*"/>
929
1148
  </parameter>
930
1149
  <parameter name="return_value" transfer-ownership="none">
931
- <doc xml:space="preserve">ignored</doc>
1150
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1151
+ if the callback of closure doesn't return a value.</doc>
932
1152
  <type name="Value" c:type="GValue*"/>
933
1153
  </parameter>
934
1154
  <parameter name="n_param_values" transfer-ownership="none">
935
- <doc xml:space="preserve">2</doc>
1155
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
936
1156
  <type name="guint" c:type="guint"/>
937
1157
  </parameter>
938
1158
  <parameter name="param_values" transfer-ownership="none">
939
- <doc xml:space="preserve">a #GValue array holding the instance and the flags parameter</doc>
1159
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1160
+ on which to invoke the callback of closure.</doc>
940
1161
  <type name="Value" c:type="const GValue*"/>
941
1162
  </parameter>
942
1163
  <parameter name="invocation_hint" transfer-ownership="none">
943
- <doc xml:space="preserve">the invocation hint given as the last argument
944
- to g_closure_invoke()</doc>
1164
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1165
+ g_closure_invoke().</doc>
945
1166
  <type name="gpointer" c:type="gpointer"/>
946
1167
  </parameter>
947
1168
  <parameter name="marshal_data" transfer-ownership="none">
948
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1169
+ <doc xml:space="preserve">Additional data specified when registering the
1170
+ marshaller, see g_closure_set_marshal() and
1171
+ g_closure_set_meta_marshal()</doc>
949
1172
  <type name="gpointer" c:type="gpointer"/>
950
1173
  </parameter>
951
1174
  </parameters>
@@ -953,64 +1176,89 @@ denotes a flags type.</doc>
953
1176
  <function name="marshal_VOID__FLAGSv"
954
1177
  c:identifier="g_cclosure_marshal_VOID__FLAGSv"
955
1178
  introspectable="0">
1179
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__FLAGS().</doc>
956
1180
  <return-value transfer-ownership="none">
957
1181
  <type name="none" c:type="void"/>
958
1182
  </return-value>
959
1183
  <parameters>
960
1184
  <parameter name="closure" transfer-ownership="none">
1185
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
961
1186
  <type name="Closure" c:type="GClosure*"/>
962
1187
  </parameter>
963
- <parameter name="return_value" transfer-ownership="none">
1188
+ <parameter name="return_value"
1189
+ transfer-ownership="none"
1190
+ nullable="1"
1191
+ allow-none="1">
1192
+ <doc xml:space="preserve">a #GValue to store the return
1193
+ value. May be %NULL if the callback of @closure doesn't return a
1194
+ value.</doc>
964
1195
  <type name="Value" c:type="GValue*"/>
965
1196
  </parameter>
966
1197
  <parameter name="instance" transfer-ownership="none">
1198
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
967
1199
  <type name="gpointer" c:type="gpointer"/>
968
1200
  </parameter>
969
1201
  <parameter name="args" transfer-ownership="none">
1202
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
970
1203
  <type name="va_list" c:type="va_list"/>
971
1204
  </parameter>
972
- <parameter name="marshal_data" transfer-ownership="none">
1205
+ <parameter name="marshal_data"
1206
+ transfer-ownership="none"
1207
+ nullable="1"
1208
+ allow-none="1">
1209
+ <doc xml:space="preserve">additional data specified when
1210
+ registering the marshaller, see g_closure_set_marshal() and
1211
+ g_closure_set_meta_marshal()</doc>
973
1212
  <type name="gpointer" c:type="gpointer"/>
974
1213
  </parameter>
975
1214
  <parameter name="n_params" transfer-ownership="none">
1215
+ <doc xml:space="preserve">the length of the @param_types array</doc>
976
1216
  <type name="gint" c:type="int"/>
977
1217
  </parameter>
978
1218
  <parameter name="param_types" transfer-ownership="none">
979
- <type name="GType" c:type="GType*"/>
1219
+ <doc xml:space="preserve">the #GType of each argument from
1220
+ @args.</doc>
1221
+ <array length="5" zero-terminated="0" c:type="GType*">
1222
+ <type name="GType" c:type="GType"/>
1223
+ </array>
980
1224
  </parameter>
981
1225
  </parameters>
982
1226
  </function>
983
1227
  <function name="marshal_VOID__FLOAT"
984
1228
  c:identifier="g_cclosure_marshal_VOID__FLOAT">
985
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
986
- `void (*callback) (gpointer instance, gfloat arg1, gpointer user_data)`.</doc>
1229
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with one
1230
+ single-precision floating point argument.</doc>
987
1231
  <return-value transfer-ownership="none">
988
1232
  <type name="none" c:type="void"/>
989
1233
  </return-value>
990
1234
  <parameters>
991
1235
  <parameter name="closure" transfer-ownership="none">
992
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1236
+ <doc xml:space="preserve">A #GClosure.</doc>
993
1237
  <type name="Closure" c:type="GClosure*"/>
994
1238
  </parameter>
995
1239
  <parameter name="return_value" transfer-ownership="none">
996
- <doc xml:space="preserve">ignored</doc>
1240
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1241
+ if the callback of closure doesn't return a value.</doc>
997
1242
  <type name="Value" c:type="GValue*"/>
998
1243
  </parameter>
999
1244
  <parameter name="n_param_values" transfer-ownership="none">
1000
- <doc xml:space="preserve">2</doc>
1245
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1001
1246
  <type name="guint" c:type="guint"/>
1002
1247
  </parameter>
1003
1248
  <parameter name="param_values" transfer-ownership="none">
1004
- <doc xml:space="preserve">a #GValue array holding the instance and the #gfloat parameter</doc>
1249
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1250
+ on which to invoke the callback of closure.</doc>
1005
1251
  <type name="Value" c:type="const GValue*"/>
1006
1252
  </parameter>
1007
1253
  <parameter name="invocation_hint" transfer-ownership="none">
1008
- <doc xml:space="preserve">the invocation hint given as the last argument
1009
- to g_closure_invoke()</doc>
1254
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1255
+ g_closure_invoke().</doc>
1010
1256
  <type name="gpointer" c:type="gpointer"/>
1011
1257
  </parameter>
1012
1258
  <parameter name="marshal_data" transfer-ownership="none">
1013
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1259
+ <doc xml:space="preserve">Additional data specified when registering the
1260
+ marshaller, see g_closure_set_marshal() and
1261
+ g_closure_set_meta_marshal()</doc>
1014
1262
  <type name="gpointer" c:type="gpointer"/>
1015
1263
  </parameter>
1016
1264
  </parameters>
@@ -1018,64 +1266,89 @@ denotes a flags type.</doc>
1018
1266
  <function name="marshal_VOID__FLOATv"
1019
1267
  c:identifier="g_cclosure_marshal_VOID__FLOATv"
1020
1268
  introspectable="0">
1269
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__FLOAT().</doc>
1021
1270
  <return-value transfer-ownership="none">
1022
1271
  <type name="none" c:type="void"/>
1023
1272
  </return-value>
1024
1273
  <parameters>
1025
1274
  <parameter name="closure" transfer-ownership="none">
1275
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1026
1276
  <type name="Closure" c:type="GClosure*"/>
1027
1277
  </parameter>
1028
- <parameter name="return_value" transfer-ownership="none">
1278
+ <parameter name="return_value"
1279
+ transfer-ownership="none"
1280
+ nullable="1"
1281
+ allow-none="1">
1282
+ <doc xml:space="preserve">a #GValue to store the return
1283
+ value. May be %NULL if the callback of @closure doesn't return a
1284
+ value.</doc>
1029
1285
  <type name="Value" c:type="GValue*"/>
1030
1286
  </parameter>
1031
1287
  <parameter name="instance" transfer-ownership="none">
1288
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
1032
1289
  <type name="gpointer" c:type="gpointer"/>
1033
1290
  </parameter>
1034
1291
  <parameter name="args" transfer-ownership="none">
1292
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
1035
1293
  <type name="va_list" c:type="va_list"/>
1036
1294
  </parameter>
1037
- <parameter name="marshal_data" transfer-ownership="none">
1295
+ <parameter name="marshal_data"
1296
+ transfer-ownership="none"
1297
+ nullable="1"
1298
+ allow-none="1">
1299
+ <doc xml:space="preserve">additional data specified when
1300
+ registering the marshaller, see g_closure_set_marshal() and
1301
+ g_closure_set_meta_marshal()</doc>
1038
1302
  <type name="gpointer" c:type="gpointer"/>
1039
1303
  </parameter>
1040
1304
  <parameter name="n_params" transfer-ownership="none">
1305
+ <doc xml:space="preserve">the length of the @param_types array</doc>
1041
1306
  <type name="gint" c:type="int"/>
1042
1307
  </parameter>
1043
1308
  <parameter name="param_types" transfer-ownership="none">
1044
- <type name="GType" c:type="GType*"/>
1309
+ <doc xml:space="preserve">the #GType of each argument from
1310
+ @args.</doc>
1311
+ <array length="5" zero-terminated="0" c:type="GType*">
1312
+ <type name="GType" c:type="GType"/>
1313
+ </array>
1045
1314
  </parameter>
1046
1315
  </parameters>
1047
1316
  </function>
1048
1317
  <function name="marshal_VOID__INT"
1049
1318
  c:identifier="g_cclosure_marshal_VOID__INT">
1050
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1051
- `void (*callback) (gpointer instance, gint arg1, gpointer user_data)`.</doc>
1319
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
1320
+ integer argument.</doc>
1052
1321
  <return-value transfer-ownership="none">
1053
1322
  <type name="none" c:type="void"/>
1054
1323
  </return-value>
1055
1324
  <parameters>
1056
1325
  <parameter name="closure" transfer-ownership="none">
1057
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1326
+ <doc xml:space="preserve">A #GClosure.</doc>
1058
1327
  <type name="Closure" c:type="GClosure*"/>
1059
1328
  </parameter>
1060
1329
  <parameter name="return_value" transfer-ownership="none">
1061
- <doc xml:space="preserve">ignored</doc>
1330
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1331
+ if the callback of closure doesn't return a value.</doc>
1062
1332
  <type name="Value" c:type="GValue*"/>
1063
1333
  </parameter>
1064
1334
  <parameter name="n_param_values" transfer-ownership="none">
1065
- <doc xml:space="preserve">2</doc>
1335
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1066
1336
  <type name="guint" c:type="guint"/>
1067
1337
  </parameter>
1068
1338
  <parameter name="param_values" transfer-ownership="none">
1069
- <doc xml:space="preserve">a #GValue array holding the instance and the #gint parameter</doc>
1339
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1340
+ on which to invoke the callback of closure.</doc>
1070
1341
  <type name="Value" c:type="const GValue*"/>
1071
1342
  </parameter>
1072
1343
  <parameter name="invocation_hint" transfer-ownership="none">
1073
- <doc xml:space="preserve">the invocation hint given as the last argument
1074
- to g_closure_invoke()</doc>
1344
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1345
+ g_closure_invoke().</doc>
1075
1346
  <type name="gpointer" c:type="gpointer"/>
1076
1347
  </parameter>
1077
1348
  <parameter name="marshal_data" transfer-ownership="none">
1078
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1349
+ <doc xml:space="preserve">Additional data specified when registering the
1350
+ marshaller, see g_closure_set_marshal() and
1351
+ g_closure_set_meta_marshal()</doc>
1079
1352
  <type name="gpointer" c:type="gpointer"/>
1080
1353
  </parameter>
1081
1354
  </parameters>
@@ -1083,64 +1356,89 @@ denotes a flags type.</doc>
1083
1356
  <function name="marshal_VOID__INTv"
1084
1357
  c:identifier="g_cclosure_marshal_VOID__INTv"
1085
1358
  introspectable="0">
1359
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__INT().</doc>
1086
1360
  <return-value transfer-ownership="none">
1087
1361
  <type name="none" c:type="void"/>
1088
1362
  </return-value>
1089
1363
  <parameters>
1090
1364
  <parameter name="closure" transfer-ownership="none">
1365
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1091
1366
  <type name="Closure" c:type="GClosure*"/>
1092
1367
  </parameter>
1093
- <parameter name="return_value" transfer-ownership="none">
1368
+ <parameter name="return_value"
1369
+ transfer-ownership="none"
1370
+ nullable="1"
1371
+ allow-none="1">
1372
+ <doc xml:space="preserve">a #GValue to store the return
1373
+ value. May be %NULL if the callback of @closure doesn't return a
1374
+ value.</doc>
1094
1375
  <type name="Value" c:type="GValue*"/>
1095
1376
  </parameter>
1096
1377
  <parameter name="instance" transfer-ownership="none">
1378
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
1097
1379
  <type name="gpointer" c:type="gpointer"/>
1098
1380
  </parameter>
1099
1381
  <parameter name="args" transfer-ownership="none">
1382
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
1100
1383
  <type name="va_list" c:type="va_list"/>
1101
1384
  </parameter>
1102
- <parameter name="marshal_data" transfer-ownership="none">
1385
+ <parameter name="marshal_data"
1386
+ transfer-ownership="none"
1387
+ nullable="1"
1388
+ allow-none="1">
1389
+ <doc xml:space="preserve">additional data specified when
1390
+ registering the marshaller, see g_closure_set_marshal() and
1391
+ g_closure_set_meta_marshal()</doc>
1103
1392
  <type name="gpointer" c:type="gpointer"/>
1104
1393
  </parameter>
1105
1394
  <parameter name="n_params" transfer-ownership="none">
1395
+ <doc xml:space="preserve">the length of the @param_types array</doc>
1106
1396
  <type name="gint" c:type="int"/>
1107
1397
  </parameter>
1108
1398
  <parameter name="param_types" transfer-ownership="none">
1109
- <type name="GType" c:type="GType*"/>
1399
+ <doc xml:space="preserve">the #GType of each argument from
1400
+ @args.</doc>
1401
+ <array length="5" zero-terminated="0" c:type="GType*">
1402
+ <type name="GType" c:type="GType"/>
1403
+ </array>
1110
1404
  </parameter>
1111
1405
  </parameters>
1112
1406
  </function>
1113
1407
  <function name="marshal_VOID__LONG"
1114
1408
  c:identifier="g_cclosure_marshal_VOID__LONG">
1115
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1116
- `void (*callback) (gpointer instance, glong arg1, gpointer user_data)`.</doc>
1409
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with with a single
1410
+ long integer argument.</doc>
1117
1411
  <return-value transfer-ownership="none">
1118
1412
  <type name="none" c:type="void"/>
1119
1413
  </return-value>
1120
1414
  <parameters>
1121
1415
  <parameter name="closure" transfer-ownership="none">
1122
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1416
+ <doc xml:space="preserve">A #GClosure.</doc>
1123
1417
  <type name="Closure" c:type="GClosure*"/>
1124
1418
  </parameter>
1125
1419
  <parameter name="return_value" transfer-ownership="none">
1126
- <doc xml:space="preserve">ignored</doc>
1420
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1421
+ if the callback of closure doesn't return a value.</doc>
1127
1422
  <type name="Value" c:type="GValue*"/>
1128
1423
  </parameter>
1129
1424
  <parameter name="n_param_values" transfer-ownership="none">
1130
- <doc xml:space="preserve">2</doc>
1425
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1131
1426
  <type name="guint" c:type="guint"/>
1132
1427
  </parameter>
1133
1428
  <parameter name="param_values" transfer-ownership="none">
1134
- <doc xml:space="preserve">a #GValue array holding the instance and the #glong parameter</doc>
1429
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1430
+ on which to invoke the callback of closure.</doc>
1135
1431
  <type name="Value" c:type="const GValue*"/>
1136
1432
  </parameter>
1137
1433
  <parameter name="invocation_hint" transfer-ownership="none">
1138
- <doc xml:space="preserve">the invocation hint given as the last argument
1139
- to g_closure_invoke()</doc>
1434
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1435
+ g_closure_invoke().</doc>
1140
1436
  <type name="gpointer" c:type="gpointer"/>
1141
1437
  </parameter>
1142
1438
  <parameter name="marshal_data" transfer-ownership="none">
1143
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1439
+ <doc xml:space="preserve">Additional data specified when registering the
1440
+ marshaller, see g_closure_set_marshal() and
1441
+ g_closure_set_meta_marshal()</doc>
1144
1442
  <type name="gpointer" c:type="gpointer"/>
1145
1443
  </parameter>
1146
1444
  </parameters>
@@ -1148,64 +1446,89 @@ denotes a flags type.</doc>
1148
1446
  <function name="marshal_VOID__LONGv"
1149
1447
  c:identifier="g_cclosure_marshal_VOID__LONGv"
1150
1448
  introspectable="0">
1449
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__LONG().</doc>
1151
1450
  <return-value transfer-ownership="none">
1152
1451
  <type name="none" c:type="void"/>
1153
1452
  </return-value>
1154
1453
  <parameters>
1155
1454
  <parameter name="closure" transfer-ownership="none">
1455
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1156
1456
  <type name="Closure" c:type="GClosure*"/>
1157
1457
  </parameter>
1158
- <parameter name="return_value" transfer-ownership="none">
1458
+ <parameter name="return_value"
1459
+ transfer-ownership="none"
1460
+ nullable="1"
1461
+ allow-none="1">
1462
+ <doc xml:space="preserve">a #GValue to store the return
1463
+ value. May be %NULL if the callback of @closure doesn't return a
1464
+ value.</doc>
1159
1465
  <type name="Value" c:type="GValue*"/>
1160
1466
  </parameter>
1161
1467
  <parameter name="instance" transfer-ownership="none">
1468
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
1162
1469
  <type name="gpointer" c:type="gpointer"/>
1163
1470
  </parameter>
1164
1471
  <parameter name="args" transfer-ownership="none">
1472
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
1165
1473
  <type name="va_list" c:type="va_list"/>
1166
1474
  </parameter>
1167
- <parameter name="marshal_data" transfer-ownership="none">
1475
+ <parameter name="marshal_data"
1476
+ transfer-ownership="none"
1477
+ nullable="1"
1478
+ allow-none="1">
1479
+ <doc xml:space="preserve">additional data specified when
1480
+ registering the marshaller, see g_closure_set_marshal() and
1481
+ g_closure_set_meta_marshal()</doc>
1168
1482
  <type name="gpointer" c:type="gpointer"/>
1169
1483
  </parameter>
1170
1484
  <parameter name="n_params" transfer-ownership="none">
1485
+ <doc xml:space="preserve">the length of the @param_types array</doc>
1171
1486
  <type name="gint" c:type="int"/>
1172
1487
  </parameter>
1173
1488
  <parameter name="param_types" transfer-ownership="none">
1174
- <type name="GType" c:type="GType*"/>
1489
+ <doc xml:space="preserve">the #GType of each argument from
1490
+ @args.</doc>
1491
+ <array length="5" zero-terminated="0" c:type="GType*">
1492
+ <type name="GType" c:type="GType"/>
1493
+ </array>
1175
1494
  </parameter>
1176
1495
  </parameters>
1177
1496
  </function>
1178
1497
  <function name="marshal_VOID__OBJECT"
1179
1498
  c:identifier="g_cclosure_marshal_VOID__OBJECT">
1180
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1181
- `void (*callback) (gpointer instance, GObject *arg1, gpointer user_data)`.</doc>
1499
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
1500
+ #GObject argument.</doc>
1182
1501
  <return-value transfer-ownership="none">
1183
1502
  <type name="none" c:type="void"/>
1184
1503
  </return-value>
1185
1504
  <parameters>
1186
1505
  <parameter name="closure" transfer-ownership="none">
1187
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1506
+ <doc xml:space="preserve">A #GClosure.</doc>
1188
1507
  <type name="Closure" c:type="GClosure*"/>
1189
1508
  </parameter>
1190
1509
  <parameter name="return_value" transfer-ownership="none">
1191
- <doc xml:space="preserve">ignored</doc>
1510
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1511
+ if the callback of closure doesn't return a value.</doc>
1192
1512
  <type name="Value" c:type="GValue*"/>
1193
1513
  </parameter>
1194
1514
  <parameter name="n_param_values" transfer-ownership="none">
1195
- <doc xml:space="preserve">2</doc>
1515
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1196
1516
  <type name="guint" c:type="guint"/>
1197
1517
  </parameter>
1198
1518
  <parameter name="param_values" transfer-ownership="none">
1199
- <doc xml:space="preserve">a #GValue array holding the instance and the #GObject* parameter</doc>
1519
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1520
+ on which to invoke the callback of closure.</doc>
1200
1521
  <type name="Value" c:type="const GValue*"/>
1201
1522
  </parameter>
1202
1523
  <parameter name="invocation_hint" transfer-ownership="none">
1203
- <doc xml:space="preserve">the invocation hint given as the last argument
1204
- to g_closure_invoke()</doc>
1524
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1525
+ g_closure_invoke().</doc>
1205
1526
  <type name="gpointer" c:type="gpointer"/>
1206
1527
  </parameter>
1207
1528
  <parameter name="marshal_data" transfer-ownership="none">
1208
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1529
+ <doc xml:space="preserve">Additional data specified when registering the
1530
+ marshaller, see g_closure_set_marshal() and
1531
+ g_closure_set_meta_marshal()</doc>
1209
1532
  <type name="gpointer" c:type="gpointer"/>
1210
1533
  </parameter>
1211
1534
  </parameters>
@@ -1213,64 +1536,89 @@ denotes a flags type.</doc>
1213
1536
  <function name="marshal_VOID__OBJECTv"
1214
1537
  c:identifier="g_cclosure_marshal_VOID__OBJECTv"
1215
1538
  introspectable="0">
1539
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__OBJECT().</doc>
1216
1540
  <return-value transfer-ownership="none">
1217
1541
  <type name="none" c:type="void"/>
1218
1542
  </return-value>
1219
1543
  <parameters>
1220
1544
  <parameter name="closure" transfer-ownership="none">
1545
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1221
1546
  <type name="Closure" c:type="GClosure*"/>
1222
1547
  </parameter>
1223
- <parameter name="return_value" transfer-ownership="none">
1548
+ <parameter name="return_value"
1549
+ transfer-ownership="none"
1550
+ nullable="1"
1551
+ allow-none="1">
1552
+ <doc xml:space="preserve">a #GValue to store the return
1553
+ value. May be %NULL if the callback of @closure doesn't return a
1554
+ value.</doc>
1224
1555
  <type name="Value" c:type="GValue*"/>
1225
1556
  </parameter>
1226
1557
  <parameter name="instance" transfer-ownership="none">
1558
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
1227
1559
  <type name="gpointer" c:type="gpointer"/>
1228
1560
  </parameter>
1229
1561
  <parameter name="args" transfer-ownership="none">
1562
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
1230
1563
  <type name="va_list" c:type="va_list"/>
1231
1564
  </parameter>
1232
- <parameter name="marshal_data" transfer-ownership="none">
1565
+ <parameter name="marshal_data"
1566
+ transfer-ownership="none"
1567
+ nullable="1"
1568
+ allow-none="1">
1569
+ <doc xml:space="preserve">additional data specified when
1570
+ registering the marshaller, see g_closure_set_marshal() and
1571
+ g_closure_set_meta_marshal()</doc>
1233
1572
  <type name="gpointer" c:type="gpointer"/>
1234
1573
  </parameter>
1235
1574
  <parameter name="n_params" transfer-ownership="none">
1575
+ <doc xml:space="preserve">the length of the @param_types array</doc>
1236
1576
  <type name="gint" c:type="int"/>
1237
1577
  </parameter>
1238
1578
  <parameter name="param_types" transfer-ownership="none">
1239
- <type name="GType" c:type="GType*"/>
1579
+ <doc xml:space="preserve">the #GType of each argument from
1580
+ @args.</doc>
1581
+ <array length="5" zero-terminated="0" c:type="GType*">
1582
+ <type name="GType" c:type="GType"/>
1583
+ </array>
1240
1584
  </parameter>
1241
1585
  </parameters>
1242
1586
  </function>
1243
1587
  <function name="marshal_VOID__PARAM"
1244
1588
  c:identifier="g_cclosure_marshal_VOID__PARAM">
1245
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1246
- `void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data)`.</doc>
1589
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
1590
+ argument of type #GParamSpec.</doc>
1247
1591
  <return-value transfer-ownership="none">
1248
1592
  <type name="none" c:type="void"/>
1249
1593
  </return-value>
1250
1594
  <parameters>
1251
1595
  <parameter name="closure" transfer-ownership="none">
1252
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1596
+ <doc xml:space="preserve">A #GClosure.</doc>
1253
1597
  <type name="Closure" c:type="GClosure*"/>
1254
1598
  </parameter>
1255
1599
  <parameter name="return_value" transfer-ownership="none">
1256
- <doc xml:space="preserve">ignored</doc>
1600
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1601
+ if the callback of closure doesn't return a value.</doc>
1257
1602
  <type name="Value" c:type="GValue*"/>
1258
1603
  </parameter>
1259
1604
  <parameter name="n_param_values" transfer-ownership="none">
1260
- <doc xml:space="preserve">2</doc>
1605
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1261
1606
  <type name="guint" c:type="guint"/>
1262
1607
  </parameter>
1263
1608
  <parameter name="param_values" transfer-ownership="none">
1264
- <doc xml:space="preserve">a #GValue array holding the instance and the #GParamSpec* parameter</doc>
1609
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1610
+ on which to invoke the callback of closure.</doc>
1265
1611
  <type name="Value" c:type="const GValue*"/>
1266
1612
  </parameter>
1267
1613
  <parameter name="invocation_hint" transfer-ownership="none">
1268
- <doc xml:space="preserve">the invocation hint given as the last argument
1269
- to g_closure_invoke()</doc>
1614
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1615
+ g_closure_invoke().</doc>
1270
1616
  <type name="gpointer" c:type="gpointer"/>
1271
1617
  </parameter>
1272
1618
  <parameter name="marshal_data" transfer-ownership="none">
1273
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1619
+ <doc xml:space="preserve">Additional data specified when registering the
1620
+ marshaller, see g_closure_set_marshal() and
1621
+ g_closure_set_meta_marshal()</doc>
1274
1622
  <type name="gpointer" c:type="gpointer"/>
1275
1623
  </parameter>
1276
1624
  </parameters>
@@ -1278,64 +1626,93 @@ denotes a flags type.</doc>
1278
1626
  <function name="marshal_VOID__PARAMv"
1279
1627
  c:identifier="g_cclosure_marshal_VOID__PARAMv"
1280
1628
  introspectable="0">
1629
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__PARAM().</doc>
1281
1630
  <return-value transfer-ownership="none">
1282
1631
  <type name="none" c:type="void"/>
1283
1632
  </return-value>
1284
1633
  <parameters>
1285
1634
  <parameter name="closure" transfer-ownership="none">
1635
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1286
1636
  <type name="Closure" c:type="GClosure*"/>
1287
1637
  </parameter>
1288
- <parameter name="return_value" transfer-ownership="none">
1638
+ <parameter name="return_value"
1639
+ transfer-ownership="none"
1640
+ nullable="1"
1641
+ allow-none="1">
1642
+ <doc xml:space="preserve">a #GValue to store the return
1643
+ value. May be %NULL if the callback of @closure doesn't return a
1644
+ value.</doc>
1289
1645
  <type name="Value" c:type="GValue*"/>
1290
1646
  </parameter>
1291
1647
  <parameter name="instance" transfer-ownership="none">
1648
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
1292
1649
  <type name="gpointer" c:type="gpointer"/>
1293
1650
  </parameter>
1294
1651
  <parameter name="args" transfer-ownership="none">
1652
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
1295
1653
  <type name="va_list" c:type="va_list"/>
1296
1654
  </parameter>
1297
- <parameter name="marshal_data" transfer-ownership="none">
1655
+ <parameter name="marshal_data"
1656
+ transfer-ownership="none"
1657
+ nullable="1"
1658
+ allow-none="1">
1659
+ <doc xml:space="preserve">additional data specified when
1660
+ registering the marshaller, see g_closure_set_marshal() and
1661
+ g_closure_set_meta_marshal()</doc>
1298
1662
  <type name="gpointer" c:type="gpointer"/>
1299
1663
  </parameter>
1300
1664
  <parameter name="n_params" transfer-ownership="none">
1665
+ <doc xml:space="preserve">the length of the @param_types array</doc>
1301
1666
  <type name="gint" c:type="int"/>
1302
1667
  </parameter>
1303
1668
  <parameter name="param_types" transfer-ownership="none">
1304
- <type name="GType" c:type="GType*"/>
1669
+ <doc xml:space="preserve">the #GType of each argument from
1670
+ @args.</doc>
1671
+ <array length="5" zero-terminated="0" c:type="GType*">
1672
+ <type name="GType" c:type="GType"/>
1673
+ </array>
1305
1674
  </parameter>
1306
1675
  </parameters>
1307
1676
  </function>
1308
1677
  <function name="marshal_VOID__POINTER"
1309
1678
  c:identifier="g_cclosure_marshal_VOID__POINTER">
1310
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1311
- `void (*callback) (gpointer instance, gpointer arg1, gpointer user_data)`.</doc>
1679
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single raw
1680
+ pointer argument type.
1681
+
1682
+ If it is possible, it is better to use one of the more specific
1683
+ functions such as g_cclosure_marshal_VOID__OBJECT() or
1684
+ g_cclosure_marshal_VOID__OBJECT().</doc>
1312
1685
  <return-value transfer-ownership="none">
1313
1686
  <type name="none" c:type="void"/>
1314
1687
  </return-value>
1315
1688
  <parameters>
1316
1689
  <parameter name="closure" transfer-ownership="none">
1317
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1690
+ <doc xml:space="preserve">A #GClosure.</doc>
1318
1691
  <type name="Closure" c:type="GClosure*"/>
1319
1692
  </parameter>
1320
1693
  <parameter name="return_value" transfer-ownership="none">
1321
- <doc xml:space="preserve">ignored</doc>
1694
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1695
+ if the callback of closure doesn't return a value.</doc>
1322
1696
  <type name="Value" c:type="GValue*"/>
1323
1697
  </parameter>
1324
1698
  <parameter name="n_param_values" transfer-ownership="none">
1325
- <doc xml:space="preserve">2</doc>
1699
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1326
1700
  <type name="guint" c:type="guint"/>
1327
1701
  </parameter>
1328
1702
  <parameter name="param_values" transfer-ownership="none">
1329
- <doc xml:space="preserve">a #GValue array holding the instance and the #gpointer parameter</doc>
1703
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1704
+ on which to invoke the callback of closure.</doc>
1330
1705
  <type name="Value" c:type="const GValue*"/>
1331
1706
  </parameter>
1332
1707
  <parameter name="invocation_hint" transfer-ownership="none">
1333
- <doc xml:space="preserve">the invocation hint given as the last argument
1334
- to g_closure_invoke()</doc>
1708
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1709
+ g_closure_invoke().</doc>
1335
1710
  <type name="gpointer" c:type="gpointer"/>
1336
1711
  </parameter>
1337
1712
  <parameter name="marshal_data" transfer-ownership="none">
1338
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1713
+ <doc xml:space="preserve">Additional data specified when registering the
1714
+ marshaller, see g_closure_set_marshal() and
1715
+ g_closure_set_meta_marshal()</doc>
1339
1716
  <type name="gpointer" c:type="gpointer"/>
1340
1717
  </parameter>
1341
1718
  </parameters>
@@ -1343,64 +1720,89 @@ denotes a flags type.</doc>
1343
1720
  <function name="marshal_VOID__POINTERv"
1344
1721
  c:identifier="g_cclosure_marshal_VOID__POINTERv"
1345
1722
  introspectable="0">
1723
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__POINTER().</doc>
1346
1724
  <return-value transfer-ownership="none">
1347
1725
  <type name="none" c:type="void"/>
1348
1726
  </return-value>
1349
1727
  <parameters>
1350
1728
  <parameter name="closure" transfer-ownership="none">
1729
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1351
1730
  <type name="Closure" c:type="GClosure*"/>
1352
1731
  </parameter>
1353
- <parameter name="return_value" transfer-ownership="none">
1732
+ <parameter name="return_value"
1733
+ transfer-ownership="none"
1734
+ nullable="1"
1735
+ allow-none="1">
1736
+ <doc xml:space="preserve">a #GValue to store the return
1737
+ value. May be %NULL if the callback of @closure doesn't return a
1738
+ value.</doc>
1354
1739
  <type name="Value" c:type="GValue*"/>
1355
1740
  </parameter>
1356
1741
  <parameter name="instance" transfer-ownership="none">
1742
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
1357
1743
  <type name="gpointer" c:type="gpointer"/>
1358
1744
  </parameter>
1359
1745
  <parameter name="args" transfer-ownership="none">
1746
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
1360
1747
  <type name="va_list" c:type="va_list"/>
1361
1748
  </parameter>
1362
- <parameter name="marshal_data" transfer-ownership="none">
1749
+ <parameter name="marshal_data"
1750
+ transfer-ownership="none"
1751
+ nullable="1"
1752
+ allow-none="1">
1753
+ <doc xml:space="preserve">additional data specified when
1754
+ registering the marshaller, see g_closure_set_marshal() and
1755
+ g_closure_set_meta_marshal()</doc>
1363
1756
  <type name="gpointer" c:type="gpointer"/>
1364
1757
  </parameter>
1365
1758
  <parameter name="n_params" transfer-ownership="none">
1759
+ <doc xml:space="preserve">the length of the @param_types array</doc>
1366
1760
  <type name="gint" c:type="int"/>
1367
1761
  </parameter>
1368
1762
  <parameter name="param_types" transfer-ownership="none">
1369
- <type name="GType" c:type="GType*"/>
1763
+ <doc xml:space="preserve">the #GType of each argument from
1764
+ @args.</doc>
1765
+ <array length="5" zero-terminated="0" c:type="GType*">
1766
+ <type name="GType" c:type="GType"/>
1767
+ </array>
1370
1768
  </parameter>
1371
1769
  </parameters>
1372
1770
  </function>
1373
1771
  <function name="marshal_VOID__STRING"
1374
1772
  c:identifier="g_cclosure_marshal_VOID__STRING">
1375
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1376
- `void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data)`.</doc>
1773
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single string
1774
+ argument.</doc>
1377
1775
  <return-value transfer-ownership="none">
1378
1776
  <type name="none" c:type="void"/>
1379
1777
  </return-value>
1380
1778
  <parameters>
1381
1779
  <parameter name="closure" transfer-ownership="none">
1382
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1780
+ <doc xml:space="preserve">A #GClosure.</doc>
1383
1781
  <type name="Closure" c:type="GClosure*"/>
1384
1782
  </parameter>
1385
1783
  <parameter name="return_value" transfer-ownership="none">
1386
- <doc xml:space="preserve">ignored</doc>
1784
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1785
+ if the callback of closure doesn't return a value.</doc>
1387
1786
  <type name="Value" c:type="GValue*"/>
1388
1787
  </parameter>
1389
1788
  <parameter name="n_param_values" transfer-ownership="none">
1390
- <doc xml:space="preserve">2</doc>
1789
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1391
1790
  <type name="guint" c:type="guint"/>
1392
1791
  </parameter>
1393
1792
  <parameter name="param_values" transfer-ownership="none">
1394
- <doc xml:space="preserve">a #GValue array holding the instance and the #gchar* parameter</doc>
1793
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1794
+ on which to invoke the callback of closure.</doc>
1395
1795
  <type name="Value" c:type="const GValue*"/>
1396
1796
  </parameter>
1397
1797
  <parameter name="invocation_hint" transfer-ownership="none">
1398
- <doc xml:space="preserve">the invocation hint given as the last argument
1399
- to g_closure_invoke()</doc>
1798
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1799
+ g_closure_invoke().</doc>
1400
1800
  <type name="gpointer" c:type="gpointer"/>
1401
1801
  </parameter>
1402
1802
  <parameter name="marshal_data" transfer-ownership="none">
1403
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1803
+ <doc xml:space="preserve">Additional data specified when registering the
1804
+ marshaller, see g_closure_set_marshal() and
1805
+ g_closure_set_meta_marshal()</doc>
1404
1806
  <type name="gpointer" c:type="gpointer"/>
1405
1807
  </parameter>
1406
1808
  </parameters>
@@ -1408,64 +1810,89 @@ denotes a flags type.</doc>
1408
1810
  <function name="marshal_VOID__STRINGv"
1409
1811
  c:identifier="g_cclosure_marshal_VOID__STRINGv"
1410
1812
  introspectable="0">
1813
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__STRING().</doc>
1411
1814
  <return-value transfer-ownership="none">
1412
1815
  <type name="none" c:type="void"/>
1413
1816
  </return-value>
1414
1817
  <parameters>
1415
1818
  <parameter name="closure" transfer-ownership="none">
1819
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1416
1820
  <type name="Closure" c:type="GClosure*"/>
1417
1821
  </parameter>
1418
- <parameter name="return_value" transfer-ownership="none">
1822
+ <parameter name="return_value"
1823
+ transfer-ownership="none"
1824
+ nullable="1"
1825
+ allow-none="1">
1826
+ <doc xml:space="preserve">a #GValue to store the return
1827
+ value. May be %NULL if the callback of @closure doesn't return a
1828
+ value.</doc>
1419
1829
  <type name="Value" c:type="GValue*"/>
1420
1830
  </parameter>
1421
1831
  <parameter name="instance" transfer-ownership="none">
1832
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
1422
1833
  <type name="gpointer" c:type="gpointer"/>
1423
1834
  </parameter>
1424
1835
  <parameter name="args" transfer-ownership="none">
1836
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
1425
1837
  <type name="va_list" c:type="va_list"/>
1426
1838
  </parameter>
1427
- <parameter name="marshal_data" transfer-ownership="none">
1839
+ <parameter name="marshal_data"
1840
+ transfer-ownership="none"
1841
+ nullable="1"
1842
+ allow-none="1">
1843
+ <doc xml:space="preserve">additional data specified when
1844
+ registering the marshaller, see g_closure_set_marshal() and
1845
+ g_closure_set_meta_marshal()</doc>
1428
1846
  <type name="gpointer" c:type="gpointer"/>
1429
1847
  </parameter>
1430
1848
  <parameter name="n_params" transfer-ownership="none">
1849
+ <doc xml:space="preserve">the length of the @param_types array</doc>
1431
1850
  <type name="gint" c:type="int"/>
1432
1851
  </parameter>
1433
1852
  <parameter name="param_types" transfer-ownership="none">
1434
- <type name="GType" c:type="GType*"/>
1853
+ <doc xml:space="preserve">the #GType of each argument from
1854
+ @args.</doc>
1855
+ <array length="5" zero-terminated="0" c:type="GType*">
1856
+ <type name="GType" c:type="GType"/>
1857
+ </array>
1435
1858
  </parameter>
1436
1859
  </parameters>
1437
1860
  </function>
1438
1861
  <function name="marshal_VOID__UCHAR"
1439
1862
  c:identifier="g_cclosure_marshal_VOID__UCHAR">
1440
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1441
- `void (*callback) (gpointer instance, guchar arg1, gpointer user_data)`.</doc>
1863
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
1864
+ unsigned character argument.</doc>
1442
1865
  <return-value transfer-ownership="none">
1443
1866
  <type name="none" c:type="void"/>
1444
1867
  </return-value>
1445
1868
  <parameters>
1446
1869
  <parameter name="closure" transfer-ownership="none">
1447
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1870
+ <doc xml:space="preserve">A #GClosure.</doc>
1448
1871
  <type name="Closure" c:type="GClosure*"/>
1449
1872
  </parameter>
1450
1873
  <parameter name="return_value" transfer-ownership="none">
1451
- <doc xml:space="preserve">ignored</doc>
1874
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1875
+ if the callback of closure doesn't return a value.</doc>
1452
1876
  <type name="Value" c:type="GValue*"/>
1453
1877
  </parameter>
1454
1878
  <parameter name="n_param_values" transfer-ownership="none">
1455
- <doc xml:space="preserve">2</doc>
1879
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1456
1880
  <type name="guint" c:type="guint"/>
1457
1881
  </parameter>
1458
1882
  <parameter name="param_values" transfer-ownership="none">
1459
- <doc xml:space="preserve">a #GValue array holding the instance and the #guchar parameter</doc>
1883
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1884
+ on which to invoke the callback of closure.</doc>
1460
1885
  <type name="Value" c:type="const GValue*"/>
1461
1886
  </parameter>
1462
1887
  <parameter name="invocation_hint" transfer-ownership="none">
1463
- <doc xml:space="preserve">the invocation hint given as the last argument
1464
- to g_closure_invoke()</doc>
1888
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1889
+ g_closure_invoke().</doc>
1465
1890
  <type name="gpointer" c:type="gpointer"/>
1466
1891
  </parameter>
1467
1892
  <parameter name="marshal_data" transfer-ownership="none">
1468
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1893
+ <doc xml:space="preserve">Additional data specified when registering the
1894
+ marshaller, see g_closure_set_marshal() and
1895
+ g_closure_set_meta_marshal()</doc>
1469
1896
  <type name="gpointer" c:type="gpointer"/>
1470
1897
  </parameter>
1471
1898
  </parameters>
@@ -1473,99 +1900,128 @@ denotes a flags type.</doc>
1473
1900
  <function name="marshal_VOID__UCHARv"
1474
1901
  c:identifier="g_cclosure_marshal_VOID__UCHARv"
1475
1902
  introspectable="0">
1903
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UCHAR().</doc>
1476
1904
  <return-value transfer-ownership="none">
1477
1905
  <type name="none" c:type="void"/>
1478
1906
  </return-value>
1479
1907
  <parameters>
1480
1908
  <parameter name="closure" transfer-ownership="none">
1909
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1481
1910
  <type name="Closure" c:type="GClosure*"/>
1482
1911
  </parameter>
1483
- <parameter name="return_value" transfer-ownership="none">
1912
+ <parameter name="return_value"
1913
+ transfer-ownership="none"
1914
+ nullable="1"
1915
+ allow-none="1">
1916
+ <doc xml:space="preserve">a #GValue to store the return
1917
+ value. May be %NULL if the callback of @closure doesn't return a
1918
+ value.</doc>
1484
1919
  <type name="Value" c:type="GValue*"/>
1485
1920
  </parameter>
1486
1921
  <parameter name="instance" transfer-ownership="none">
1922
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
1487
1923
  <type name="gpointer" c:type="gpointer"/>
1488
1924
  </parameter>
1489
1925
  <parameter name="args" transfer-ownership="none">
1926
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
1490
1927
  <type name="va_list" c:type="va_list"/>
1491
1928
  </parameter>
1492
- <parameter name="marshal_data" transfer-ownership="none">
1929
+ <parameter name="marshal_data"
1930
+ transfer-ownership="none"
1931
+ nullable="1"
1932
+ allow-none="1">
1933
+ <doc xml:space="preserve">additional data specified when
1934
+ registering the marshaller, see g_closure_set_marshal() and
1935
+ g_closure_set_meta_marshal()</doc>
1493
1936
  <type name="gpointer" c:type="gpointer"/>
1494
1937
  </parameter>
1495
1938
  <parameter name="n_params" transfer-ownership="none">
1939
+ <doc xml:space="preserve">the length of the @param_types array</doc>
1496
1940
  <type name="gint" c:type="int"/>
1497
1941
  </parameter>
1498
1942
  <parameter name="param_types" transfer-ownership="none">
1499
- <type name="GType" c:type="GType*"/>
1943
+ <doc xml:space="preserve">the #GType of each argument from
1944
+ @args.</doc>
1945
+ <array length="5" zero-terminated="0" c:type="GType*">
1946
+ <type name="GType" c:type="GType"/>
1947
+ </array>
1500
1948
  </parameter>
1501
1949
  </parameters>
1502
1950
  </function>
1503
1951
  <function name="marshal_VOID__UINT"
1504
1952
  c:identifier="g_cclosure_marshal_VOID__UINT">
1505
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1506
- `void (*callback) (gpointer instance, guint arg1, gpointer user_data)`.</doc>
1953
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with with a single
1954
+ unsigned integer argument.</doc>
1507
1955
  <return-value transfer-ownership="none">
1508
1956
  <type name="none" c:type="void"/>
1509
1957
  </return-value>
1510
1958
  <parameters>
1511
1959
  <parameter name="closure" transfer-ownership="none">
1512
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1960
+ <doc xml:space="preserve">A #GClosure.</doc>
1513
1961
  <type name="Closure" c:type="GClosure*"/>
1514
1962
  </parameter>
1515
1963
  <parameter name="return_value" transfer-ownership="none">
1516
- <doc xml:space="preserve">ignored</doc>
1964
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1965
+ if the callback of closure doesn't return a value.</doc>
1517
1966
  <type name="Value" c:type="GValue*"/>
1518
1967
  </parameter>
1519
1968
  <parameter name="n_param_values" transfer-ownership="none">
1520
- <doc xml:space="preserve">2</doc>
1969
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1521
1970
  <type name="guint" c:type="guint"/>
1522
1971
  </parameter>
1523
1972
  <parameter name="param_values" transfer-ownership="none">
1524
- <doc xml:space="preserve">a #GValue array holding the instance and the #guint parameter</doc>
1973
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1974
+ on which to invoke the callback of closure.</doc>
1525
1975
  <type name="Value" c:type="const GValue*"/>
1526
1976
  </parameter>
1527
1977
  <parameter name="invocation_hint" transfer-ownership="none">
1528
- <doc xml:space="preserve">the invocation hint given as the last argument
1529
- to g_closure_invoke()</doc>
1978
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1979
+ g_closure_invoke().</doc>
1530
1980
  <type name="gpointer" c:type="gpointer"/>
1531
1981
  </parameter>
1532
1982
  <parameter name="marshal_data" transfer-ownership="none">
1533
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1983
+ <doc xml:space="preserve">Additional data specified when registering the
1984
+ marshaller, see g_closure_set_marshal() and
1985
+ g_closure_set_meta_marshal()</doc>
1534
1986
  <type name="gpointer" c:type="gpointer"/>
1535
1987
  </parameter>
1536
1988
  </parameters>
1537
1989
  </function>
1538
1990
  <function name="marshal_VOID__UINT_POINTER"
1539
1991
  c:identifier="g_cclosure_marshal_VOID__UINT_POINTER">
1540
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1541
- `void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data)`.</doc>
1992
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a unsigned int
1993
+ and a pointer as arguments.</doc>
1542
1994
  <return-value transfer-ownership="none">
1543
1995
  <type name="none" c:type="void"/>
1544
1996
  </return-value>
1545
1997
  <parameters>
1546
1998
  <parameter name="closure" transfer-ownership="none">
1547
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1999
+ <doc xml:space="preserve">A #GClosure.</doc>
1548
2000
  <type name="Closure" c:type="GClosure*"/>
1549
2001
  </parameter>
1550
2002
  <parameter name="return_value" transfer-ownership="none">
1551
- <doc xml:space="preserve">ignored</doc>
2003
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
2004
+ if the callback of closure doesn't return a value.</doc>
1552
2005
  <type name="Value" c:type="GValue*"/>
1553
2006
  </parameter>
1554
2007
  <parameter name="n_param_values" transfer-ownership="none">
1555
- <doc xml:space="preserve">3</doc>
2008
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1556
2009
  <type name="guint" c:type="guint"/>
1557
2010
  </parameter>
1558
2011
  <parameter name="param_values" transfer-ownership="none">
1559
- <doc xml:space="preserve">a #GValue array holding instance, arg1 and arg2</doc>
2012
+ <doc xml:space="preserve">An array of #GValues holding the arguments
2013
+ on which to invoke the callback of closure.</doc>
1560
2014
  <type name="Value" c:type="const GValue*"/>
1561
2015
  </parameter>
1562
2016
  <parameter name="invocation_hint" transfer-ownership="none">
1563
- <doc xml:space="preserve">the invocation hint given as the last argument
1564
- to g_closure_invoke()</doc>
2017
+ <doc xml:space="preserve">The invocation hint given as the last argument to
2018
+ g_closure_invoke().</doc>
1565
2019
  <type name="gpointer" c:type="gpointer"/>
1566
2020
  </parameter>
1567
2021
  <parameter name="marshal_data" transfer-ownership="none">
1568
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
2022
+ <doc xml:space="preserve">Additional data specified when registering the
2023
+ marshaller, see g_closure_set_marshal() and
2024
+ g_closure_set_meta_marshal()</doc>
1569
2025
  <type name="gpointer" c:type="gpointer"/>
1570
2026
  </parameter>
1571
2027
  </parameters>
@@ -1573,94 +2029,140 @@ denotes a flags type.</doc>
1573
2029
  <function name="marshal_VOID__UINT_POINTERv"
1574
2030
  c:identifier="g_cclosure_marshal_VOID__UINT_POINTERv"
1575
2031
  introspectable="0">
2032
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UINT_POINTER().</doc>
1576
2033
  <return-value transfer-ownership="none">
1577
2034
  <type name="none" c:type="void"/>
1578
2035
  </return-value>
1579
2036
  <parameters>
1580
2037
  <parameter name="closure" transfer-ownership="none">
2038
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1581
2039
  <type name="Closure" c:type="GClosure*"/>
1582
2040
  </parameter>
1583
- <parameter name="return_value" transfer-ownership="none">
2041
+ <parameter name="return_value"
2042
+ transfer-ownership="none"
2043
+ nullable="1"
2044
+ allow-none="1">
2045
+ <doc xml:space="preserve">a #GValue to store the return
2046
+ value. May be %NULL if the callback of @closure doesn't return a
2047
+ value.</doc>
1584
2048
  <type name="Value" c:type="GValue*"/>
1585
2049
  </parameter>
1586
2050
  <parameter name="instance" transfer-ownership="none">
2051
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
1587
2052
  <type name="gpointer" c:type="gpointer"/>
1588
2053
  </parameter>
1589
2054
  <parameter name="args" transfer-ownership="none">
2055
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
1590
2056
  <type name="va_list" c:type="va_list"/>
1591
2057
  </parameter>
1592
- <parameter name="marshal_data" transfer-ownership="none">
2058
+ <parameter name="marshal_data"
2059
+ transfer-ownership="none"
2060
+ nullable="1"
2061
+ allow-none="1">
2062
+ <doc xml:space="preserve">additional data specified when
2063
+ registering the marshaller, see g_closure_set_marshal() and
2064
+ g_closure_set_meta_marshal()</doc>
1593
2065
  <type name="gpointer" c:type="gpointer"/>
1594
2066
  </parameter>
1595
2067
  <parameter name="n_params" transfer-ownership="none">
2068
+ <doc xml:space="preserve">the length of the @param_types array</doc>
1596
2069
  <type name="gint" c:type="int"/>
1597
2070
  </parameter>
1598
2071
  <parameter name="param_types" transfer-ownership="none">
1599
- <type name="GType" c:type="GType*"/>
2072
+ <doc xml:space="preserve">the #GType of each argument from
2073
+ @args.</doc>
2074
+ <array length="5" zero-terminated="0" c:type="GType*">
2075
+ <type name="GType" c:type="GType"/>
2076
+ </array>
1600
2077
  </parameter>
1601
2078
  </parameters>
1602
2079
  </function>
1603
2080
  <function name="marshal_VOID__UINTv"
1604
2081
  c:identifier="g_cclosure_marshal_VOID__UINTv"
1605
2082
  introspectable="0">
2083
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UINT().</doc>
1606
2084
  <return-value transfer-ownership="none">
1607
2085
  <type name="none" c:type="void"/>
1608
2086
  </return-value>
1609
2087
  <parameters>
1610
2088
  <parameter name="closure" transfer-ownership="none">
2089
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1611
2090
  <type name="Closure" c:type="GClosure*"/>
1612
2091
  </parameter>
1613
- <parameter name="return_value" transfer-ownership="none">
2092
+ <parameter name="return_value"
2093
+ transfer-ownership="none"
2094
+ nullable="1"
2095
+ allow-none="1">
2096
+ <doc xml:space="preserve">a #GValue to store the return
2097
+ value. May be %NULL if the callback of @closure doesn't return a
2098
+ value.</doc>
1614
2099
  <type name="Value" c:type="GValue*"/>
1615
2100
  </parameter>
1616
2101
  <parameter name="instance" transfer-ownership="none">
2102
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
1617
2103
  <type name="gpointer" c:type="gpointer"/>
1618
2104
  </parameter>
1619
2105
  <parameter name="args" transfer-ownership="none">
2106
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
1620
2107
  <type name="va_list" c:type="va_list"/>
1621
2108
  </parameter>
1622
- <parameter name="marshal_data" transfer-ownership="none">
2109
+ <parameter name="marshal_data"
2110
+ transfer-ownership="none"
2111
+ nullable="1"
2112
+ allow-none="1">
2113
+ <doc xml:space="preserve">additional data specified when
2114
+ registering the marshaller, see g_closure_set_marshal() and
2115
+ g_closure_set_meta_marshal()</doc>
1623
2116
  <type name="gpointer" c:type="gpointer"/>
1624
2117
  </parameter>
1625
2118
  <parameter name="n_params" transfer-ownership="none">
2119
+ <doc xml:space="preserve">the length of the @param_types array</doc>
1626
2120
  <type name="gint" c:type="int"/>
1627
2121
  </parameter>
1628
2122
  <parameter name="param_types" transfer-ownership="none">
1629
- <type name="GType" c:type="GType*"/>
2123
+ <doc xml:space="preserve">the #GType of each argument from
2124
+ @args.</doc>
2125
+ <array length="5" zero-terminated="0" c:type="GType*">
2126
+ <type name="GType" c:type="GType"/>
2127
+ </array>
1630
2128
  </parameter>
1631
2129
  </parameters>
1632
2130
  </function>
1633
2131
  <function name="marshal_VOID__ULONG"
1634
2132
  c:identifier="g_cclosure_marshal_VOID__ULONG">
1635
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1636
- `void (*callback) (gpointer instance, gulong arg1, gpointer user_data)`.</doc>
2133
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
2134
+ unsigned long integer argument.</doc>
1637
2135
  <return-value transfer-ownership="none">
1638
2136
  <type name="none" c:type="void"/>
1639
2137
  </return-value>
1640
2138
  <parameters>
1641
2139
  <parameter name="closure" transfer-ownership="none">
1642
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
2140
+ <doc xml:space="preserve">A #GClosure.</doc>
1643
2141
  <type name="Closure" c:type="GClosure*"/>
1644
2142
  </parameter>
1645
2143
  <parameter name="return_value" transfer-ownership="none">
1646
- <doc xml:space="preserve">ignored</doc>
2144
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
2145
+ if the callback of closure doesn't return a value.</doc>
1647
2146
  <type name="Value" c:type="GValue*"/>
1648
2147
  </parameter>
1649
2148
  <parameter name="n_param_values" transfer-ownership="none">
1650
- <doc xml:space="preserve">2</doc>
2149
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1651
2150
  <type name="guint" c:type="guint"/>
1652
2151
  </parameter>
1653
2152
  <parameter name="param_values" transfer-ownership="none">
1654
- <doc xml:space="preserve">a #GValue array holding the instance and the #gulong parameter</doc>
2153
+ <doc xml:space="preserve">An array of #GValues holding the arguments
2154
+ on which to invoke the callback of closure.</doc>
1655
2155
  <type name="Value" c:type="const GValue*"/>
1656
2156
  </parameter>
1657
2157
  <parameter name="invocation_hint" transfer-ownership="none">
1658
- <doc xml:space="preserve">the invocation hint given as the last argument
1659
- to g_closure_invoke()</doc>
2158
+ <doc xml:space="preserve">The invocation hint given as the last argument to
2159
+ g_closure_invoke().</doc>
1660
2160
  <type name="gpointer" c:type="gpointer"/>
1661
2161
  </parameter>
1662
2162
  <parameter name="marshal_data" transfer-ownership="none">
1663
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
2163
+ <doc xml:space="preserve">Additional data specified when registering the
2164
+ marshaller, see g_closure_set_marshal() and
2165
+ g_closure_set_meta_marshal()</doc>
1664
2166
  <type name="gpointer" c:type="gpointer"/>
1665
2167
  </parameter>
1666
2168
  </parameters>
@@ -1668,65 +2170,89 @@ denotes a flags type.</doc>
1668
2170
  <function name="marshal_VOID__ULONGv"
1669
2171
  c:identifier="g_cclosure_marshal_VOID__ULONGv"
1670
2172
  introspectable="0">
2173
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__ULONG().</doc>
1671
2174
  <return-value transfer-ownership="none">
1672
2175
  <type name="none" c:type="void"/>
1673
2176
  </return-value>
1674
2177
  <parameters>
1675
2178
  <parameter name="closure" transfer-ownership="none">
2179
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1676
2180
  <type name="Closure" c:type="GClosure*"/>
1677
2181
  </parameter>
1678
- <parameter name="return_value" transfer-ownership="none">
2182
+ <parameter name="return_value"
2183
+ transfer-ownership="none"
2184
+ nullable="1"
2185
+ allow-none="1">
2186
+ <doc xml:space="preserve">a #GValue to store the return
2187
+ value. May be %NULL if the callback of @closure doesn't return a
2188
+ value.</doc>
1679
2189
  <type name="Value" c:type="GValue*"/>
1680
2190
  </parameter>
1681
2191
  <parameter name="instance" transfer-ownership="none">
2192
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
1682
2193
  <type name="gpointer" c:type="gpointer"/>
1683
2194
  </parameter>
1684
2195
  <parameter name="args" transfer-ownership="none">
2196
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
1685
2197
  <type name="va_list" c:type="va_list"/>
1686
2198
  </parameter>
1687
- <parameter name="marshal_data" transfer-ownership="none">
2199
+ <parameter name="marshal_data"
2200
+ transfer-ownership="none"
2201
+ nullable="1"
2202
+ allow-none="1">
2203
+ <doc xml:space="preserve">additional data specified when
2204
+ registering the marshaller, see g_closure_set_marshal() and
2205
+ g_closure_set_meta_marshal()</doc>
1688
2206
  <type name="gpointer" c:type="gpointer"/>
1689
2207
  </parameter>
1690
2208
  <parameter name="n_params" transfer-ownership="none">
2209
+ <doc xml:space="preserve">the length of the @param_types array</doc>
1691
2210
  <type name="gint" c:type="int"/>
1692
2211
  </parameter>
1693
2212
  <parameter name="param_types" transfer-ownership="none">
1694
- <type name="GType" c:type="GType*"/>
2213
+ <doc xml:space="preserve">the #GType of each argument from
2214
+ @args.</doc>
2215
+ <array length="5" zero-terminated="0" c:type="GType*">
2216
+ <type name="GType" c:type="GType"/>
2217
+ </array>
1695
2218
  </parameter>
1696
2219
  </parameters>
1697
2220
  </function>
1698
2221
  <function name="marshal_VOID__VARIANT"
1699
- c:identifier="g_cclosure_marshal_VOID__VARIANT"
1700
- version="2.26">
1701
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1702
- `void (*callback) (gpointer instance, GVariant *arg1, gpointer user_data)`.</doc>
2222
+ c:identifier="g_cclosure_marshal_VOID__VARIANT">
2223
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
2224
+ #GVariant argument.</doc>
1703
2225
  <return-value transfer-ownership="none">
1704
2226
  <type name="none" c:type="void"/>
1705
2227
  </return-value>
1706
2228
  <parameters>
1707
2229
  <parameter name="closure" transfer-ownership="none">
1708
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
2230
+ <doc xml:space="preserve">A #GClosure.</doc>
1709
2231
  <type name="Closure" c:type="GClosure*"/>
1710
2232
  </parameter>
1711
2233
  <parameter name="return_value" transfer-ownership="none">
1712
- <doc xml:space="preserve">ignored</doc>
2234
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
2235
+ if the callback of closure doesn't return a value.</doc>
1713
2236
  <type name="Value" c:type="GValue*"/>
1714
2237
  </parameter>
1715
2238
  <parameter name="n_param_values" transfer-ownership="none">
1716
- <doc xml:space="preserve">2</doc>
2239
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1717
2240
  <type name="guint" c:type="guint"/>
1718
2241
  </parameter>
1719
2242
  <parameter name="param_values" transfer-ownership="none">
1720
- <doc xml:space="preserve">a #GValue array holding the instance and the #GVariant* parameter</doc>
2243
+ <doc xml:space="preserve">An array of #GValues holding the arguments
2244
+ on which to invoke the callback of closure.</doc>
1721
2245
  <type name="Value" c:type="const GValue*"/>
1722
2246
  </parameter>
1723
2247
  <parameter name="invocation_hint" transfer-ownership="none">
1724
- <doc xml:space="preserve">the invocation hint given as the last argument
1725
- to g_closure_invoke()</doc>
2248
+ <doc xml:space="preserve">The invocation hint given as the last argument to
2249
+ g_closure_invoke().</doc>
1726
2250
  <type name="gpointer" c:type="gpointer"/>
1727
2251
  </parameter>
1728
2252
  <parameter name="marshal_data" transfer-ownership="none">
1729
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
2253
+ <doc xml:space="preserve">Additional data specified when registering the
2254
+ marshaller, see g_closure_set_marshal() and
2255
+ g_closure_set_meta_marshal()</doc>
1730
2256
  <type name="gpointer" c:type="gpointer"/>
1731
2257
  </parameter>
1732
2258
  </parameters>
@@ -1734,64 +2260,88 @@ denotes a flags type.</doc>
1734
2260
  <function name="marshal_VOID__VARIANTv"
1735
2261
  c:identifier="g_cclosure_marshal_VOID__VARIANTv"
1736
2262
  introspectable="0">
2263
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__VARIANT().</doc>
1737
2264
  <return-value transfer-ownership="none">
1738
2265
  <type name="none" c:type="void"/>
1739
2266
  </return-value>
1740
2267
  <parameters>
1741
2268
  <parameter name="closure" transfer-ownership="none">
2269
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1742
2270
  <type name="Closure" c:type="GClosure*"/>
1743
2271
  </parameter>
1744
- <parameter name="return_value" transfer-ownership="none">
2272
+ <parameter name="return_value"
2273
+ transfer-ownership="none"
2274
+ nullable="1"
2275
+ allow-none="1">
2276
+ <doc xml:space="preserve">a #GValue to store the return
2277
+ value. May be %NULL if the callback of @closure doesn't return a
2278
+ value.</doc>
1745
2279
  <type name="Value" c:type="GValue*"/>
1746
2280
  </parameter>
1747
2281
  <parameter name="instance" transfer-ownership="none">
2282
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
1748
2283
  <type name="gpointer" c:type="gpointer"/>
1749
2284
  </parameter>
1750
2285
  <parameter name="args" transfer-ownership="none">
2286
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
1751
2287
  <type name="va_list" c:type="va_list"/>
1752
2288
  </parameter>
1753
- <parameter name="marshal_data" transfer-ownership="none">
2289
+ <parameter name="marshal_data"
2290
+ transfer-ownership="none"
2291
+ nullable="1"
2292
+ allow-none="1">
2293
+ <doc xml:space="preserve">additional data specified when
2294
+ registering the marshaller, see g_closure_set_marshal() and
2295
+ g_closure_set_meta_marshal()</doc>
1754
2296
  <type name="gpointer" c:type="gpointer"/>
1755
2297
  </parameter>
1756
2298
  <parameter name="n_params" transfer-ownership="none">
2299
+ <doc xml:space="preserve">the length of the @param_types array</doc>
1757
2300
  <type name="gint" c:type="int"/>
1758
2301
  </parameter>
1759
2302
  <parameter name="param_types" transfer-ownership="none">
1760
- <type name="GType" c:type="GType*"/>
2303
+ <doc xml:space="preserve">the #GType of each argument from
2304
+ @args.</doc>
2305
+ <array length="5" zero-terminated="0" c:type="GType*">
2306
+ <type name="GType" c:type="GType"/>
2307
+ </array>
1761
2308
  </parameter>
1762
2309
  </parameters>
1763
2310
  </function>
1764
2311
  <function name="marshal_VOID__VOID"
1765
2312
  c:identifier="g_cclosure_marshal_VOID__VOID">
1766
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1767
- `void (*callback) (gpointer instance, gpointer user_data)`.</doc>
2313
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with no arguments.</doc>
1768
2314
  <return-value transfer-ownership="none">
1769
2315
  <type name="none" c:type="void"/>
1770
2316
  </return-value>
1771
2317
  <parameters>
1772
2318
  <parameter name="closure" transfer-ownership="none">
1773
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
2319
+ <doc xml:space="preserve">A #GClosure.</doc>
1774
2320
  <type name="Closure" c:type="GClosure*"/>
1775
2321
  </parameter>
1776
2322
  <parameter name="return_value" transfer-ownership="none">
1777
- <doc xml:space="preserve">ignored</doc>
2323
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
2324
+ if the callback of closure doesn't return a value.</doc>
1778
2325
  <type name="Value" c:type="GValue*"/>
1779
2326
  </parameter>
1780
2327
  <parameter name="n_param_values" transfer-ownership="none">
1781
- <doc xml:space="preserve">1</doc>
2328
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1782
2329
  <type name="guint" c:type="guint"/>
1783
2330
  </parameter>
1784
2331
  <parameter name="param_values" transfer-ownership="none">
1785
- <doc xml:space="preserve">a #GValue array holding only the instance</doc>
2332
+ <doc xml:space="preserve">An array of #GValues holding the arguments
2333
+ on which to invoke the callback of closure.</doc>
1786
2334
  <type name="Value" c:type="const GValue*"/>
1787
2335
  </parameter>
1788
2336
  <parameter name="invocation_hint" transfer-ownership="none">
1789
- <doc xml:space="preserve">the invocation hint given as the last argument
1790
- to g_closure_invoke()</doc>
2337
+ <doc xml:space="preserve">The invocation hint given as the last argument to
2338
+ g_closure_invoke().</doc>
1791
2339
  <type name="gpointer" c:type="gpointer"/>
1792
2340
  </parameter>
1793
2341
  <parameter name="marshal_data" transfer-ownership="none">
1794
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
2342
+ <doc xml:space="preserve">Additional data specified when registering the
2343
+ marshaller, see g_closure_set_marshal() and
2344
+ g_closure_set_meta_marshal()</doc>
1795
2345
  <type name="gpointer" c:type="gpointer"/>
1796
2346
  </parameter>
1797
2347
  </parameters>
@@ -1799,30 +2349,51 @@ denotes a flags type.</doc>
1799
2349
  <function name="marshal_VOID__VOIDv"
1800
2350
  c:identifier="g_cclosure_marshal_VOID__VOIDv"
1801
2351
  introspectable="0">
2352
+ <doc xml:space="preserve">The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__VOID().</doc>
1802
2353
  <return-value transfer-ownership="none">
1803
2354
  <type name="none" c:type="void"/>
1804
2355
  </return-value>
1805
2356
  <parameters>
1806
2357
  <parameter name="closure" transfer-ownership="none">
2358
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1807
2359
  <type name="Closure" c:type="GClosure*"/>
1808
2360
  </parameter>
1809
- <parameter name="return_value" transfer-ownership="none">
2361
+ <parameter name="return_value"
2362
+ transfer-ownership="none"
2363
+ nullable="1"
2364
+ allow-none="1">
2365
+ <doc xml:space="preserve">a #GValue to store the return
2366
+ value. May be %NULL if the callback of @closure doesn't return a
2367
+ value.</doc>
1810
2368
  <type name="Value" c:type="GValue*"/>
1811
2369
  </parameter>
1812
2370
  <parameter name="instance" transfer-ownership="none">
2371
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
1813
2372
  <type name="gpointer" c:type="gpointer"/>
1814
2373
  </parameter>
1815
2374
  <parameter name="args" transfer-ownership="none">
2375
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
1816
2376
  <type name="va_list" c:type="va_list"/>
1817
2377
  </parameter>
1818
- <parameter name="marshal_data" transfer-ownership="none">
2378
+ <parameter name="marshal_data"
2379
+ transfer-ownership="none"
2380
+ nullable="1"
2381
+ allow-none="1">
2382
+ <doc xml:space="preserve">additional data specified when
2383
+ registering the marshaller, see g_closure_set_marshal() and
2384
+ g_closure_set_meta_marshal()</doc>
1819
2385
  <type name="gpointer" c:type="gpointer"/>
1820
2386
  </parameter>
1821
2387
  <parameter name="n_params" transfer-ownership="none">
2388
+ <doc xml:space="preserve">the length of the @param_types array</doc>
1822
2389
  <type name="gint" c:type="int"/>
1823
2390
  </parameter>
1824
2391
  <parameter name="param_types" transfer-ownership="none">
1825
- <type name="GType" c:type="GType*"/>
2392
+ <doc xml:space="preserve">the #GType of each argument from
2393
+ @args.</doc>
2394
+ <array length="5" zero-terminated="0" c:type="GType*">
2395
+ <type name="GType" c:type="GType"/>
2396
+ </array>
1826
2397
  </parameter>
1827
2398
  </parameters>
1828
2399
  </function>
@@ -1871,31 +2442,54 @@ but used automatically by GLib when specifying a %NULL marshaller.</doc>
1871
2442
  </function>
1872
2443
  <function name="marshal_generic_va"
1873
2444
  c:identifier="g_cclosure_marshal_generic_va"
2445
+ version="2.30"
1874
2446
  introspectable="0">
2447
+ <doc xml:space="preserve">A generic #GVaClosureMarshal function implemented via
2448
+ [libffi](http://sourceware.org/libffi/).</doc>
1875
2449
  <return-value transfer-ownership="none">
1876
2450
  <type name="none" c:type="void"/>
1877
2451
  </return-value>
1878
2452
  <parameters>
1879
2453
  <parameter name="closure" transfer-ownership="none">
2454
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1880
2455
  <type name="Closure" c:type="GClosure*"/>
1881
2456
  </parameter>
1882
- <parameter name="return_value" transfer-ownership="none">
2457
+ <parameter name="return_value"
2458
+ transfer-ownership="none"
2459
+ nullable="1"
2460
+ allow-none="1">
2461
+ <doc xml:space="preserve">a #GValue to store the return
2462
+ value. May be %NULL if the callback of @closure doesn't return a
2463
+ value.</doc>
1883
2464
  <type name="Value" c:type="GValue*"/>
1884
2465
  </parameter>
1885
2466
  <parameter name="instance" transfer-ownership="none">
2467
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
1886
2468
  <type name="gpointer" c:type="gpointer"/>
1887
2469
  </parameter>
1888
2470
  <parameter name="args_list" transfer-ownership="none">
2471
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
1889
2472
  <type name="va_list" c:type="va_list"/>
1890
2473
  </parameter>
1891
- <parameter name="marshal_data" transfer-ownership="none">
2474
+ <parameter name="marshal_data"
2475
+ transfer-ownership="none"
2476
+ nullable="1"
2477
+ allow-none="1">
2478
+ <doc xml:space="preserve">additional data specified when
2479
+ registering the marshaller, see g_closure_set_marshal() and
2480
+ g_closure_set_meta_marshal()</doc>
1892
2481
  <type name="gpointer" c:type="gpointer"/>
1893
2482
  </parameter>
1894
2483
  <parameter name="n_params" transfer-ownership="none">
2484
+ <doc xml:space="preserve">the length of the @param_types array</doc>
1895
2485
  <type name="gint" c:type="int"/>
1896
2486
  </parameter>
1897
2487
  <parameter name="param_types" transfer-ownership="none">
1898
- <type name="GType" c:type="GType*"/>
2488
+ <doc xml:space="preserve">the #GType of each argument from
2489
+ @args_list.</doc>
2490
+ <array length="5" zero-terminated="0" c:type="GType*">
2491
+ <type name="GType" c:type="GType"/>
2492
+ </array>
1899
2493
  </parameter>
1900
2494
  </parameters>
1901
2495
  </function>
@@ -4338,7 +4932,7 @@ should not destroy the object in the normal way.</doc>
4338
4932
  <doc xml:space="preserve">Releases all references to other objects. This can be used to break
4339
4933
  reference cycles.
4340
4934
 
4341
- This functions should only be called from object system implementations.</doc>
4935
+ This function should only be called from object system implementations.</doc>
4342
4936
  <return-value transfer-ownership="none">
4343
4937
  <type name="none" c:type="void"/>
4344
4938
  </return-value>
@@ -4597,7 +5191,12 @@ It is an error to call this function when the freeze count is zero.</doc>
4597
5191
  </method>
4598
5192
  <method name="unref" c:identifier="g_object_unref">
4599
5193
  <doc xml:space="preserve">Decreases the reference count of @object. When its reference count
4600
- drops to 0, the object is finalized (i.e. its memory is freed).</doc>
5194
+ drops to 0, the object is finalized (i.e. its memory is freed).
5195
+
5196
+ If the pointer to the #GObject may be reused in future (for example, if it is
5197
+ an instance variable of another object), it is recommended to clear the
5198
+ pointer to %NULL rather than retain a dangling pointer to a potentially
5199
+ invalid #GObject instance. Use g_clear_object() for this.</doc>
4601
5200
  <return-value transfer-ownership="none">
4602
5201
  <type name="none" c:type="void"/>
4603
5202
  </return-value>
@@ -5196,7 +5795,7 @@ Since 2.13.0</doc>
5196
5795
  </constant>
5197
5796
  <bitfield name="ParamFlags" c:type="GParamFlags">
5198
5797
  <doc xml:space="preserve">Through the #GParamFlags flag values, certain aspects of parameters
5199
- can be configured. See also #G_PARAM_READWRITE and #G_PARAM_STATIC_STRINGS.</doc>
5798
+ can be configured. See also #G_PARAM_STATIC_STRINGS.</doc>
5200
5799
  <member name="readable" value="1" c:identifier="G_PARAM_READABLE">
5201
5800
  <doc xml:space="preserve">the parameter is readable</doc>
5202
5801
  </member>
@@ -5212,7 +5811,7 @@ can be configured. See also #G_PARAM_READWRITE and #G_PARAM_STATIC_STRINGS.</doc
5212
5811
  <member name="construct_only"
5213
5812
  value="8"
5214
5813
  c:identifier="G_PARAM_CONSTRUCT_ONLY">
5215
- <doc xml:space="preserve">the parameter will only be set upon object construction</doc>
5814
+ <doc xml:space="preserve">the parameter can only be set upon object construction</doc>
5216
5815
  </member>
5217
5816
  <member name="lax_validation"
5218
5817
  value="16"
@@ -5391,12 +5990,18 @@ e.g. a tooltip. The @nick and @blurb should ideally be localized.</doc>
5391
5990
  </parameters>
5392
5991
  </method>
5393
5992
  <method name="get_default_value"
5394
- c:identifier="g_param_spec_get_default_value">
5993
+ c:identifier="g_param_spec_get_default_value"
5994
+ version="2.38">
5995
+ <doc xml:space="preserve">Gets the default value of @param as a pointer to a #GValue.
5996
+
5997
+ The #GValue will remain value for the life of @param.</doc>
5395
5998
  <return-value transfer-ownership="none">
5999
+ <doc xml:space="preserve">a pointer to a #GValue which must not be modified</doc>
5396
6000
  <type name="Value" c:type="const GValue*"/>
5397
6001
  </return-value>
5398
6002
  <parameters>
5399
6003
  <instance-parameter name="param" transfer-ownership="none">
6004
+ <doc xml:space="preserve">a #GParamSpec</doc>
5400
6005
  <type name="ParamSpec" c:type="GParamSpec*"/>
5401
6006
  </instance-parameter>
5402
6007
  </parameters>
@@ -7077,7 +7682,12 @@ environment variable.</doc>
7077
7682
  <member name="signals" value="2" c:identifier="G_TYPE_DEBUG_SIGNALS">
7078
7683
  <doc xml:space="preserve">Print messages about signal emissions</doc>
7079
7684
  </member>
7080
- <member name="mask" value="3" c:identifier="G_TYPE_DEBUG_MASK">
7685
+ <member name="instance_count"
7686
+ value="4"
7687
+ c:identifier="G_TYPE_DEBUG_INSTANCE_COUNT">
7688
+ <doc xml:space="preserve">Keep a count of instances of each type</doc>
7689
+ </member>
7690
+ <member name="mask" value="7" c:identifier="G_TYPE_DEBUG_MASK">
7081
7691
  <doc xml:space="preserve">Mask covering all debug flags</doc>
7082
7692
  </member>
7083
7693
  </bitfield>
@@ -7922,16 +8532,7 @@ It is filled in by the g_type_query() function.</doc>
7922
8532
  </field>
7923
8533
  </record>
7924
8534
  <record name="TypeValueTable" c:type="GTypeValueTable">
7925
- <doc xml:space="preserve">- 'i' - Integers. passed as collect_values[].v_int.
7926
- - 'l' - Longs. passed as collect_values[].v_long.
7927
- - 'd' - Doubles. passed as collect_values[].v_double.
7928
- - 'p' - Pointers. passed as collect_values[].v_pointer.
7929
-
7930
- It should be noted that for variable argument list construction,
7931
- ANSI C promotes every type smaller than an integer to an int, and
7932
- floats to doubles. So for collection of short int or char, 'i'
7933
- needs to be used, and for collection of floats 'd'.
7934
- The #GTypeValueTable provides the functions required by the #GValue
8535
+ <doc xml:space="preserve">The #GTypeValueTable provides the functions required by the #GValue
7935
8536
  implementation, to serve as a container for values of a type.</doc>
7936
8537
  <field name="value_init">
7937
8538
  <callback name="value_init">
@@ -7988,7 +8589,15 @@ implementation, to serve as a container for values of a type.</doc>
7988
8589
  <doc xml:space="preserve">A string format describing how to collect the contents of
7989
8590
  this value bit-by-bit. Each character in the format represents
7990
8591
  an argument to be collected, and the characters themselves indicate
7991
- the type of the argument. Currently supported arguments are:</doc>
8592
+ the type of the argument. Currently supported arguments are:
8593
+ - 'i' - Integers. passed as collect_values[].v_int.
8594
+ - 'l' - Longs. passed as collect_values[].v_long.
8595
+ - 'd' - Doubles. passed as collect_values[].v_double.
8596
+ - 'p' - Pointers. passed as collect_values[].v_pointer.
8597
+ It should be noted that for variable argument list construction,
8598
+ ANSI C promotes every type smaller than an integer to an int, and
8599
+ floats to doubles. So for collection of short int or char, 'i'
8600
+ needs to be used, and for collection of floats 'd'.</doc>
7992
8601
  <type name="utf8" c:type="const gchar*"/>
7993
8602
  </field>
7994
8603
  <field name="collect_value">
@@ -8078,30 +8687,53 @@ objects.</doc>
8078
8687
  <callback name="VaClosureMarshal"
8079
8688
  c:type="GVaClosureMarshal"
8080
8689
  introspectable="0">
8690
+ <doc xml:space="preserve">This is the signature of va_list marshaller functions, an optional
8691
+ marshaller that can be used in some situations to avoid
8692
+ marshalling the signal argument into GValues.</doc>
8081
8693
  <return-value transfer-ownership="none">
8082
8694
  <type name="none" c:type="void"/>
8083
8695
  </return-value>
8084
8696
  <parameters>
8085
8697
  <parameter name="closure" transfer-ownership="none">
8698
+ <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
8086
8699
  <type name="Closure" c:type="GClosure*"/>
8087
8700
  </parameter>
8088
- <parameter name="return_value" transfer-ownership="none">
8701
+ <parameter name="return_value"
8702
+ transfer-ownership="none"
8703
+ nullable="1"
8704
+ allow-none="1">
8705
+ <doc xml:space="preserve">a #GValue to store the return
8706
+ value. May be %NULL if the callback of @closure doesn't return a
8707
+ value.</doc>
8089
8708
  <type name="Value" c:type="GValue*"/>
8090
8709
  </parameter>
8091
8710
  <parameter name="instance" transfer-ownership="none">
8711
+ <doc xml:space="preserve">the instance on which the closure is invoked.</doc>
8092
8712
  <type name="gpointer" c:type="gpointer"/>
8093
8713
  </parameter>
8094
8714
  <parameter name="args" transfer-ownership="none">
8715
+ <doc xml:space="preserve">va_list of arguments to be passed to the closure.</doc>
8095
8716
  <type name="va_list" c:type="va_list"/>
8096
8717
  </parameter>
8097
- <parameter name="marshal_data" transfer-ownership="none">
8718
+ <parameter name="marshal_data"
8719
+ transfer-ownership="none"
8720
+ nullable="1"
8721
+ allow-none="1">
8722
+ <doc xml:space="preserve">additional data specified when
8723
+ registering the marshaller, see g_closure_set_marshal() and
8724
+ g_closure_set_meta_marshal()</doc>
8098
8725
  <type name="gpointer" c:type="gpointer"/>
8099
8726
  </parameter>
8100
8727
  <parameter name="n_params" transfer-ownership="none">
8728
+ <doc xml:space="preserve">the length of the @param_types array</doc>
8101
8729
  <type name="gint" c:type="int"/>
8102
8730
  </parameter>
8103
8731
  <parameter name="param_types" transfer-ownership="none">
8104
- <type name="GType" c:type="GType*"/>
8732
+ <doc xml:space="preserve">the #GType of each argument from
8733
+ @args.</doc>
8734
+ <array length="5" zero-terminated="0" c:type="GType*">
8735
+ <type name="GType" c:type="GType"/>
8736
+ </array>
8105
8737
  </parameter>
8106
8738
  </parameters>
8107
8739
  </callback>
@@ -9863,26 +10495,41 @@ provided to copy and free opaque boxed structures of this type.</doc>
9863
10495
  <function name="cclosure_marshal_BOOLEAN__BOXED_BOXED"
9864
10496
  c:identifier="g_cclosure_marshal_BOOLEAN__BOXED_BOXED"
9865
10497
  moved-to="CClosure.marshal_BOOLEAN__BOXED_BOXED">
10498
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with handlers that
10499
+ take two boxed pointers as arguments and return a boolean. If you
10500
+ have such a signal, you will probably also need to use an
10501
+ accumulator, such as g_signal_accumulator_true_handled().</doc>
9866
10502
  <return-value transfer-ownership="none">
9867
10503
  <type name="none" c:type="void"/>
9868
10504
  </return-value>
9869
10505
  <parameters>
9870
10506
  <parameter name="closure" transfer-ownership="none">
10507
+ <doc xml:space="preserve">A #GClosure.</doc>
9871
10508
  <type name="Closure" c:type="GClosure*"/>
9872
10509
  </parameter>
9873
10510
  <parameter name="return_value" transfer-ownership="none">
10511
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10512
+ if the callback of closure doesn't return a value.</doc>
9874
10513
  <type name="Value" c:type="GValue*"/>
9875
10514
  </parameter>
9876
10515
  <parameter name="n_param_values" transfer-ownership="none">
10516
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
9877
10517
  <type name="guint" c:type="guint"/>
9878
10518
  </parameter>
9879
10519
  <parameter name="param_values" transfer-ownership="none">
10520
+ <doc xml:space="preserve">An array of #GValues holding the arguments
10521
+ on which to invoke the callback of closure.</doc>
9880
10522
  <type name="Value" c:type="const GValue*"/>
9881
10523
  </parameter>
9882
10524
  <parameter name="invocation_hint" transfer-ownership="none">
10525
+ <doc xml:space="preserve">The invocation hint given as the last argument to
10526
+ g_closure_invoke().</doc>
9883
10527
  <type name="gpointer" c:type="gpointer"/>
9884
10528
  </parameter>
9885
10529
  <parameter name="marshal_data" transfer-ownership="none">
10530
+ <doc xml:space="preserve">Additional data specified when registering the
10531
+ marshaller, see g_closure_set_marshal() and
10532
+ g_closure_set_meta_marshal()</doc>
9886
10533
  <type name="gpointer" c:type="gpointer"/>
9887
10534
  </parameter>
9888
10535
  </parameters>
@@ -9890,36 +10537,41 @@ provided to copy and free opaque boxed structures of this type.</doc>
9890
10537
  <function name="cclosure_marshal_BOOLEAN__FLAGS"
9891
10538
  c:identifier="g_cclosure_marshal_BOOLEAN__FLAGS"
9892
10539
  moved-to="CClosure.marshal_BOOLEAN__FLAGS">
9893
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
9894
- `gboolean (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter
9895
- denotes a flags type.</doc>
10540
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with handlers that
10541
+ take a flags type as an argument and return a boolean. If you have
10542
+ such a signal, you will probably also need to use an accumulator,
10543
+ such as g_signal_accumulator_true_handled().</doc>
9896
10544
  <return-value transfer-ownership="none">
9897
10545
  <type name="none" c:type="void"/>
9898
10546
  </return-value>
9899
10547
  <parameters>
9900
10548
  <parameter name="closure" transfer-ownership="none">
9901
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
10549
+ <doc xml:space="preserve">A #GClosure.</doc>
9902
10550
  <type name="Closure" c:type="GClosure*"/>
9903
10551
  </parameter>
9904
10552
  <parameter name="return_value" transfer-ownership="none">
9905
- <doc xml:space="preserve">a #GValue which can store the returned #gboolean</doc>
10553
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10554
+ if the callback of closure doesn't return a value.</doc>
9906
10555
  <type name="Value" c:type="GValue*"/>
9907
10556
  </parameter>
9908
10557
  <parameter name="n_param_values" transfer-ownership="none">
9909
- <doc xml:space="preserve">2</doc>
10558
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
9910
10559
  <type name="guint" c:type="guint"/>
9911
10560
  </parameter>
9912
10561
  <parameter name="param_values" transfer-ownership="none">
9913
- <doc xml:space="preserve">a #GValue array holding instance and arg1</doc>
10562
+ <doc xml:space="preserve">An array of #GValues holding the arguments
10563
+ on which to invoke the callback of closure.</doc>
9914
10564
  <type name="Value" c:type="const GValue*"/>
9915
10565
  </parameter>
9916
10566
  <parameter name="invocation_hint" transfer-ownership="none">
9917
- <doc xml:space="preserve">the invocation hint given as the last argument
9918
- to g_closure_invoke()</doc>
10567
+ <doc xml:space="preserve">The invocation hint given as the last argument to
10568
+ g_closure_invoke().</doc>
9919
10569
  <type name="gpointer" c:type="gpointer"/>
9920
10570
  </parameter>
9921
10571
  <parameter name="marshal_data" transfer-ownership="none">
9922
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
10572
+ <doc xml:space="preserve">Additional data specified when registering the
10573
+ marshaller, see g_closure_set_marshal() and
10574
+ g_closure_set_meta_marshal()</doc>
9923
10575
  <type name="gpointer" c:type="gpointer"/>
9924
10576
  </parameter>
9925
10577
  </parameters>
@@ -9927,35 +10579,40 @@ denotes a flags type.</doc>
9927
10579
  <function name="cclosure_marshal_STRING__OBJECT_POINTER"
9928
10580
  c:identifier="g_cclosure_marshal_STRING__OBJECT_POINTER"
9929
10581
  moved-to="CClosure.marshal_STRING__OBJECT_POINTER">
9930
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
9931
- `gchar* (*callback) (gpointer instance, GObject *arg1, gpointer arg2, gpointer user_data)`.</doc>
10582
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with handlers that
10583
+ take a #GObject and a pointer and produce a string. It is highly
10584
+ unlikely that your signal handler fits this description.</doc>
9932
10585
  <return-value transfer-ownership="none">
9933
10586
  <type name="none" c:type="void"/>
9934
10587
  </return-value>
9935
10588
  <parameters>
9936
10589
  <parameter name="closure" transfer-ownership="none">
9937
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
10590
+ <doc xml:space="preserve">A #GClosure.</doc>
9938
10591
  <type name="Closure" c:type="GClosure*"/>
9939
10592
  </parameter>
9940
10593
  <parameter name="return_value" transfer-ownership="none">
9941
- <doc xml:space="preserve">a #GValue, which can store the returned string</doc>
10594
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10595
+ if the callback of closure doesn't return a value.</doc>
9942
10596
  <type name="Value" c:type="GValue*"/>
9943
10597
  </parameter>
9944
10598
  <parameter name="n_param_values" transfer-ownership="none">
9945
- <doc xml:space="preserve">3</doc>
10599
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
9946
10600
  <type name="guint" c:type="guint"/>
9947
10601
  </parameter>
9948
10602
  <parameter name="param_values" transfer-ownership="none">
9949
- <doc xml:space="preserve">a #GValue array holding instance, arg1 and arg2</doc>
10603
+ <doc xml:space="preserve">An array of #GValues holding the arguments
10604
+ on which to invoke the callback of closure.</doc>
9950
10605
  <type name="Value" c:type="const GValue*"/>
9951
10606
  </parameter>
9952
10607
  <parameter name="invocation_hint" transfer-ownership="none">
9953
- <doc xml:space="preserve">the invocation hint given as the last argument
9954
- to g_closure_invoke()</doc>
10608
+ <doc xml:space="preserve">The invocation hint given as the last argument to
10609
+ g_closure_invoke().</doc>
9955
10610
  <type name="gpointer" c:type="gpointer"/>
9956
10611
  </parameter>
9957
10612
  <parameter name="marshal_data" transfer-ownership="none">
9958
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
10613
+ <doc xml:space="preserve">Additional data specified when registering the
10614
+ marshaller, see g_closure_set_marshal() and
10615
+ g_closure_set_meta_marshal()</doc>
9959
10616
  <type name="gpointer" c:type="gpointer"/>
9960
10617
  </parameter>
9961
10618
  </parameters>
@@ -9963,35 +10620,39 @@ denotes a flags type.</doc>
9963
10620
  <function name="cclosure_marshal_VOID__BOOLEAN"
9964
10621
  c:identifier="g_cclosure_marshal_VOID__BOOLEAN"
9965
10622
  moved-to="CClosure.marshal_VOID__BOOLEAN">
9966
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
9967
- `void (*callback) (gpointer instance, gboolean arg1, gpointer user_data)`.</doc>
10623
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
10624
+ boolean argument.</doc>
9968
10625
  <return-value transfer-ownership="none">
9969
10626
  <type name="none" c:type="void"/>
9970
10627
  </return-value>
9971
10628
  <parameters>
9972
10629
  <parameter name="closure" transfer-ownership="none">
9973
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
10630
+ <doc xml:space="preserve">A #GClosure.</doc>
9974
10631
  <type name="Closure" c:type="GClosure*"/>
9975
10632
  </parameter>
9976
10633
  <parameter name="return_value" transfer-ownership="none">
9977
- <doc xml:space="preserve">ignored</doc>
10634
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10635
+ if the callback of closure doesn't return a value.</doc>
9978
10636
  <type name="Value" c:type="GValue*"/>
9979
10637
  </parameter>
9980
10638
  <parameter name="n_param_values" transfer-ownership="none">
9981
- <doc xml:space="preserve">2</doc>
10639
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
9982
10640
  <type name="guint" c:type="guint"/>
9983
10641
  </parameter>
9984
10642
  <parameter name="param_values" transfer-ownership="none">
9985
- <doc xml:space="preserve">a #GValue array holding the instance and the #gboolean parameter</doc>
10643
+ <doc xml:space="preserve">An array of #GValues holding the arguments
10644
+ on which to invoke the callback of closure.</doc>
9986
10645
  <type name="Value" c:type="const GValue*"/>
9987
10646
  </parameter>
9988
10647
  <parameter name="invocation_hint" transfer-ownership="none">
9989
- <doc xml:space="preserve">the invocation hint given as the last argument
9990
- to g_closure_invoke()</doc>
10648
+ <doc xml:space="preserve">The invocation hint given as the last argument to
10649
+ g_closure_invoke().</doc>
9991
10650
  <type name="gpointer" c:type="gpointer"/>
9992
10651
  </parameter>
9993
10652
  <parameter name="marshal_data" transfer-ownership="none">
9994
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
10653
+ <doc xml:space="preserve">Additional data specified when registering the
10654
+ marshaller, see g_closure_set_marshal() and
10655
+ g_closure_set_meta_marshal()</doc>
9995
10656
  <type name="gpointer" c:type="gpointer"/>
9996
10657
  </parameter>
9997
10658
  </parameters>
@@ -9999,35 +10660,39 @@ denotes a flags type.</doc>
9999
10660
  <function name="cclosure_marshal_VOID__BOXED"
10000
10661
  c:identifier="g_cclosure_marshal_VOID__BOXED"
10001
10662
  moved-to="CClosure.marshal_VOID__BOXED">
10002
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10003
- `void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data)`.</doc>
10663
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
10664
+ argument which is any boxed pointer type.</doc>
10004
10665
  <return-value transfer-ownership="none">
10005
10666
  <type name="none" c:type="void"/>
10006
10667
  </return-value>
10007
10668
  <parameters>
10008
10669
  <parameter name="closure" transfer-ownership="none">
10009
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
10670
+ <doc xml:space="preserve">A #GClosure.</doc>
10010
10671
  <type name="Closure" c:type="GClosure*"/>
10011
10672
  </parameter>
10012
10673
  <parameter name="return_value" transfer-ownership="none">
10013
- <doc xml:space="preserve">ignored</doc>
10674
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10675
+ if the callback of closure doesn't return a value.</doc>
10014
10676
  <type name="Value" c:type="GValue*"/>
10015
10677
  </parameter>
10016
10678
  <parameter name="n_param_values" transfer-ownership="none">
10017
- <doc xml:space="preserve">2</doc>
10679
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10018
10680
  <type name="guint" c:type="guint"/>
10019
10681
  </parameter>
10020
10682
  <parameter name="param_values" transfer-ownership="none">
10021
- <doc xml:space="preserve">a #GValue array holding the instance and the #GBoxed* parameter</doc>
10683
+ <doc xml:space="preserve">An array of #GValues holding the arguments
10684
+ on which to invoke the callback of closure.</doc>
10022
10685
  <type name="Value" c:type="const GValue*"/>
10023
10686
  </parameter>
10024
10687
  <parameter name="invocation_hint" transfer-ownership="none">
10025
- <doc xml:space="preserve">the invocation hint given as the last argument
10026
- to g_closure_invoke()</doc>
10688
+ <doc xml:space="preserve">The invocation hint given as the last argument to
10689
+ g_closure_invoke().</doc>
10027
10690
  <type name="gpointer" c:type="gpointer"/>
10028
10691
  </parameter>
10029
10692
  <parameter name="marshal_data" transfer-ownership="none">
10030
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
10693
+ <doc xml:space="preserve">Additional data specified when registering the
10694
+ marshaller, see g_closure_set_marshal() and
10695
+ g_closure_set_meta_marshal()</doc>
10031
10696
  <type name="gpointer" c:type="gpointer"/>
10032
10697
  </parameter>
10033
10698
  </parameters>
@@ -10035,35 +10700,39 @@ denotes a flags type.</doc>
10035
10700
  <function name="cclosure_marshal_VOID__CHAR"
10036
10701
  c:identifier="g_cclosure_marshal_VOID__CHAR"
10037
10702
  moved-to="CClosure.marshal_VOID__CHAR">
10038
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10039
- `void (*callback) (gpointer instance, gchar arg1, gpointer user_data)`.</doc>
10703
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
10704
+ character argument.</doc>
10040
10705
  <return-value transfer-ownership="none">
10041
10706
  <type name="none" c:type="void"/>
10042
10707
  </return-value>
10043
10708
  <parameters>
10044
10709
  <parameter name="closure" transfer-ownership="none">
10045
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
10710
+ <doc xml:space="preserve">A #GClosure.</doc>
10046
10711
  <type name="Closure" c:type="GClosure*"/>
10047
10712
  </parameter>
10048
10713
  <parameter name="return_value" transfer-ownership="none">
10049
- <doc xml:space="preserve">ignored</doc>
10714
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10715
+ if the callback of closure doesn't return a value.</doc>
10050
10716
  <type name="Value" c:type="GValue*"/>
10051
10717
  </parameter>
10052
10718
  <parameter name="n_param_values" transfer-ownership="none">
10053
- <doc xml:space="preserve">2</doc>
10719
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10054
10720
  <type name="guint" c:type="guint"/>
10055
10721
  </parameter>
10056
10722
  <parameter name="param_values" transfer-ownership="none">
10057
- <doc xml:space="preserve">a #GValue array holding the instance and the #gchar parameter</doc>
10723
+ <doc xml:space="preserve">An array of #GValues holding the arguments
10724
+ on which to invoke the callback of closure.</doc>
10058
10725
  <type name="Value" c:type="const GValue*"/>
10059
10726
  </parameter>
10060
10727
  <parameter name="invocation_hint" transfer-ownership="none">
10061
- <doc xml:space="preserve">the invocation hint given as the last argument
10062
- to g_closure_invoke()</doc>
10728
+ <doc xml:space="preserve">The invocation hint given as the last argument to
10729
+ g_closure_invoke().</doc>
10063
10730
  <type name="gpointer" c:type="gpointer"/>
10064
10731
  </parameter>
10065
10732
  <parameter name="marshal_data" transfer-ownership="none">
10066
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
10733
+ <doc xml:space="preserve">Additional data specified when registering the
10734
+ marshaller, see g_closure_set_marshal() and
10735
+ g_closure_set_meta_marshal()</doc>
10067
10736
  <type name="gpointer" c:type="gpointer"/>
10068
10737
  </parameter>
10069
10738
  </parameters>
@@ -10071,35 +10740,39 @@ denotes a flags type.</doc>
10071
10740
  <function name="cclosure_marshal_VOID__DOUBLE"
10072
10741
  c:identifier="g_cclosure_marshal_VOID__DOUBLE"
10073
10742
  moved-to="CClosure.marshal_VOID__DOUBLE">
10074
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10075
- `void (*callback) (gpointer instance, gdouble arg1, gpointer user_data)`.</doc>
10743
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with one
10744
+ double-precision floating point argument.</doc>
10076
10745
  <return-value transfer-ownership="none">
10077
10746
  <type name="none" c:type="void"/>
10078
10747
  </return-value>
10079
10748
  <parameters>
10080
10749
  <parameter name="closure" transfer-ownership="none">
10081
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
10750
+ <doc xml:space="preserve">A #GClosure.</doc>
10082
10751
  <type name="Closure" c:type="GClosure*"/>
10083
10752
  </parameter>
10084
10753
  <parameter name="return_value" transfer-ownership="none">
10085
- <doc xml:space="preserve">ignored</doc>
10754
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10755
+ if the callback of closure doesn't return a value.</doc>
10086
10756
  <type name="Value" c:type="GValue*"/>
10087
10757
  </parameter>
10088
10758
  <parameter name="n_param_values" transfer-ownership="none">
10089
- <doc xml:space="preserve">2</doc>
10759
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10090
10760
  <type name="guint" c:type="guint"/>
10091
10761
  </parameter>
10092
10762
  <parameter name="param_values" transfer-ownership="none">
10093
- <doc xml:space="preserve">a #GValue array holding the instance and the #gdouble parameter</doc>
10763
+ <doc xml:space="preserve">An array of #GValues holding the arguments
10764
+ on which to invoke the callback of closure.</doc>
10094
10765
  <type name="Value" c:type="const GValue*"/>
10095
10766
  </parameter>
10096
10767
  <parameter name="invocation_hint" transfer-ownership="none">
10097
- <doc xml:space="preserve">the invocation hint given as the last argument
10098
- to g_closure_invoke()</doc>
10768
+ <doc xml:space="preserve">The invocation hint given as the last argument to
10769
+ g_closure_invoke().</doc>
10099
10770
  <type name="gpointer" c:type="gpointer"/>
10100
10771
  </parameter>
10101
10772
  <parameter name="marshal_data" transfer-ownership="none">
10102
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
10773
+ <doc xml:space="preserve">Additional data specified when registering the
10774
+ marshaller, see g_closure_set_marshal() and
10775
+ g_closure_set_meta_marshal()</doc>
10103
10776
  <type name="gpointer" c:type="gpointer"/>
10104
10777
  </parameter>
10105
10778
  </parameters>
@@ -10107,35 +10780,39 @@ denotes a flags type.</doc>
10107
10780
  <function name="cclosure_marshal_VOID__ENUM"
10108
10781
  c:identifier="g_cclosure_marshal_VOID__ENUM"
10109
10782
  moved-to="CClosure.marshal_VOID__ENUM">
10110
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10111
- `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes an enumeration type..</doc>
10783
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
10784
+ argument with an enumerated type.</doc>
10112
10785
  <return-value transfer-ownership="none">
10113
10786
  <type name="none" c:type="void"/>
10114
10787
  </return-value>
10115
10788
  <parameters>
10116
10789
  <parameter name="closure" transfer-ownership="none">
10117
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
10790
+ <doc xml:space="preserve">A #GClosure.</doc>
10118
10791
  <type name="Closure" c:type="GClosure*"/>
10119
10792
  </parameter>
10120
10793
  <parameter name="return_value" transfer-ownership="none">
10121
- <doc xml:space="preserve">ignored</doc>
10794
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10795
+ if the callback of closure doesn't return a value.</doc>
10122
10796
  <type name="Value" c:type="GValue*"/>
10123
10797
  </parameter>
10124
10798
  <parameter name="n_param_values" transfer-ownership="none">
10125
- <doc xml:space="preserve">2</doc>
10799
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10126
10800
  <type name="guint" c:type="guint"/>
10127
10801
  </parameter>
10128
10802
  <parameter name="param_values" transfer-ownership="none">
10129
- <doc xml:space="preserve">a #GValue array holding the instance and the enumeration parameter</doc>
10803
+ <doc xml:space="preserve">An array of #GValues holding the arguments
10804
+ on which to invoke the callback of closure.</doc>
10130
10805
  <type name="Value" c:type="const GValue*"/>
10131
10806
  </parameter>
10132
10807
  <parameter name="invocation_hint" transfer-ownership="none">
10133
- <doc xml:space="preserve">the invocation hint given as the last argument
10134
- to g_closure_invoke()</doc>
10808
+ <doc xml:space="preserve">The invocation hint given as the last argument to
10809
+ g_closure_invoke().</doc>
10135
10810
  <type name="gpointer" c:type="gpointer"/>
10136
10811
  </parameter>
10137
10812
  <parameter name="marshal_data" transfer-ownership="none">
10138
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
10813
+ <doc xml:space="preserve">Additional data specified when registering the
10814
+ marshaller, see g_closure_set_marshal() and
10815
+ g_closure_set_meta_marshal()</doc>
10139
10816
  <type name="gpointer" c:type="gpointer"/>
10140
10817
  </parameter>
10141
10818
  </parameters>
@@ -10143,35 +10820,39 @@ denotes a flags type.</doc>
10143
10820
  <function name="cclosure_marshal_VOID__FLAGS"
10144
10821
  c:identifier="g_cclosure_marshal_VOID__FLAGS"
10145
10822
  moved-to="CClosure.marshal_VOID__FLAGS">
10146
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10147
- `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes a flags type.</doc>
10823
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
10824
+ argument with a flags types.</doc>
10148
10825
  <return-value transfer-ownership="none">
10149
10826
  <type name="none" c:type="void"/>
10150
10827
  </return-value>
10151
10828
  <parameters>
10152
10829
  <parameter name="closure" transfer-ownership="none">
10153
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
10830
+ <doc xml:space="preserve">A #GClosure.</doc>
10154
10831
  <type name="Closure" c:type="GClosure*"/>
10155
10832
  </parameter>
10156
10833
  <parameter name="return_value" transfer-ownership="none">
10157
- <doc xml:space="preserve">ignored</doc>
10834
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10835
+ if the callback of closure doesn't return a value.</doc>
10158
10836
  <type name="Value" c:type="GValue*"/>
10159
10837
  </parameter>
10160
10838
  <parameter name="n_param_values" transfer-ownership="none">
10161
- <doc xml:space="preserve">2</doc>
10839
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10162
10840
  <type name="guint" c:type="guint"/>
10163
10841
  </parameter>
10164
10842
  <parameter name="param_values" transfer-ownership="none">
10165
- <doc xml:space="preserve">a #GValue array holding the instance and the flags parameter</doc>
10843
+ <doc xml:space="preserve">An array of #GValues holding the arguments
10844
+ on which to invoke the callback of closure.</doc>
10166
10845
  <type name="Value" c:type="const GValue*"/>
10167
10846
  </parameter>
10168
10847
  <parameter name="invocation_hint" transfer-ownership="none">
10169
- <doc xml:space="preserve">the invocation hint given as the last argument
10170
- to g_closure_invoke()</doc>
10848
+ <doc xml:space="preserve">The invocation hint given as the last argument to
10849
+ g_closure_invoke().</doc>
10171
10850
  <type name="gpointer" c:type="gpointer"/>
10172
10851
  </parameter>
10173
10852
  <parameter name="marshal_data" transfer-ownership="none">
10174
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
10853
+ <doc xml:space="preserve">Additional data specified when registering the
10854
+ marshaller, see g_closure_set_marshal() and
10855
+ g_closure_set_meta_marshal()</doc>
10175
10856
  <type name="gpointer" c:type="gpointer"/>
10176
10857
  </parameter>
10177
10858
  </parameters>
@@ -10179,35 +10860,39 @@ denotes a flags type.</doc>
10179
10860
  <function name="cclosure_marshal_VOID__FLOAT"
10180
10861
  c:identifier="g_cclosure_marshal_VOID__FLOAT"
10181
10862
  moved-to="CClosure.marshal_VOID__FLOAT">
10182
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10183
- `void (*callback) (gpointer instance, gfloat arg1, gpointer user_data)`.</doc>
10863
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with one
10864
+ single-precision floating point argument.</doc>
10184
10865
  <return-value transfer-ownership="none">
10185
10866
  <type name="none" c:type="void"/>
10186
10867
  </return-value>
10187
10868
  <parameters>
10188
10869
  <parameter name="closure" transfer-ownership="none">
10189
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
10870
+ <doc xml:space="preserve">A #GClosure.</doc>
10190
10871
  <type name="Closure" c:type="GClosure*"/>
10191
10872
  </parameter>
10192
10873
  <parameter name="return_value" transfer-ownership="none">
10193
- <doc xml:space="preserve">ignored</doc>
10874
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10875
+ if the callback of closure doesn't return a value.</doc>
10194
10876
  <type name="Value" c:type="GValue*"/>
10195
10877
  </parameter>
10196
10878
  <parameter name="n_param_values" transfer-ownership="none">
10197
- <doc xml:space="preserve">2</doc>
10879
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10198
10880
  <type name="guint" c:type="guint"/>
10199
10881
  </parameter>
10200
10882
  <parameter name="param_values" transfer-ownership="none">
10201
- <doc xml:space="preserve">a #GValue array holding the instance and the #gfloat parameter</doc>
10883
+ <doc xml:space="preserve">An array of #GValues holding the arguments
10884
+ on which to invoke the callback of closure.</doc>
10202
10885
  <type name="Value" c:type="const GValue*"/>
10203
10886
  </parameter>
10204
10887
  <parameter name="invocation_hint" transfer-ownership="none">
10205
- <doc xml:space="preserve">the invocation hint given as the last argument
10206
- to g_closure_invoke()</doc>
10888
+ <doc xml:space="preserve">The invocation hint given as the last argument to
10889
+ g_closure_invoke().</doc>
10207
10890
  <type name="gpointer" c:type="gpointer"/>
10208
10891
  </parameter>
10209
10892
  <parameter name="marshal_data" transfer-ownership="none">
10210
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
10893
+ <doc xml:space="preserve">Additional data specified when registering the
10894
+ marshaller, see g_closure_set_marshal() and
10895
+ g_closure_set_meta_marshal()</doc>
10211
10896
  <type name="gpointer" c:type="gpointer"/>
10212
10897
  </parameter>
10213
10898
  </parameters>
@@ -10215,35 +10900,39 @@ denotes a flags type.</doc>
10215
10900
  <function name="cclosure_marshal_VOID__INT"
10216
10901
  c:identifier="g_cclosure_marshal_VOID__INT"
10217
10902
  moved-to="CClosure.marshal_VOID__INT">
10218
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10219
- `void (*callback) (gpointer instance, gint arg1, gpointer user_data)`.</doc>
10903
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
10904
+ integer argument.</doc>
10220
10905
  <return-value transfer-ownership="none">
10221
10906
  <type name="none" c:type="void"/>
10222
10907
  </return-value>
10223
10908
  <parameters>
10224
10909
  <parameter name="closure" transfer-ownership="none">
10225
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
10910
+ <doc xml:space="preserve">A #GClosure.</doc>
10226
10911
  <type name="Closure" c:type="GClosure*"/>
10227
10912
  </parameter>
10228
10913
  <parameter name="return_value" transfer-ownership="none">
10229
- <doc xml:space="preserve">ignored</doc>
10914
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10915
+ if the callback of closure doesn't return a value.</doc>
10230
10916
  <type name="Value" c:type="GValue*"/>
10231
10917
  </parameter>
10232
10918
  <parameter name="n_param_values" transfer-ownership="none">
10233
- <doc xml:space="preserve">2</doc>
10919
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10234
10920
  <type name="guint" c:type="guint"/>
10235
10921
  </parameter>
10236
10922
  <parameter name="param_values" transfer-ownership="none">
10237
- <doc xml:space="preserve">a #GValue array holding the instance and the #gint parameter</doc>
10923
+ <doc xml:space="preserve">An array of #GValues holding the arguments
10924
+ on which to invoke the callback of closure.</doc>
10238
10925
  <type name="Value" c:type="const GValue*"/>
10239
10926
  </parameter>
10240
10927
  <parameter name="invocation_hint" transfer-ownership="none">
10241
- <doc xml:space="preserve">the invocation hint given as the last argument
10242
- to g_closure_invoke()</doc>
10928
+ <doc xml:space="preserve">The invocation hint given as the last argument to
10929
+ g_closure_invoke().</doc>
10243
10930
  <type name="gpointer" c:type="gpointer"/>
10244
10931
  </parameter>
10245
10932
  <parameter name="marshal_data" transfer-ownership="none">
10246
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
10933
+ <doc xml:space="preserve">Additional data specified when registering the
10934
+ marshaller, see g_closure_set_marshal() and
10935
+ g_closure_set_meta_marshal()</doc>
10247
10936
  <type name="gpointer" c:type="gpointer"/>
10248
10937
  </parameter>
10249
10938
  </parameters>
@@ -10251,35 +10940,39 @@ denotes a flags type.</doc>
10251
10940
  <function name="cclosure_marshal_VOID__LONG"
10252
10941
  c:identifier="g_cclosure_marshal_VOID__LONG"
10253
10942
  moved-to="CClosure.marshal_VOID__LONG">
10254
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10255
- `void (*callback) (gpointer instance, glong arg1, gpointer user_data)`.</doc>
10943
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with with a single
10944
+ long integer argument.</doc>
10256
10945
  <return-value transfer-ownership="none">
10257
10946
  <type name="none" c:type="void"/>
10258
10947
  </return-value>
10259
10948
  <parameters>
10260
10949
  <parameter name="closure" transfer-ownership="none">
10261
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
10950
+ <doc xml:space="preserve">A #GClosure.</doc>
10262
10951
  <type name="Closure" c:type="GClosure*"/>
10263
10952
  </parameter>
10264
10953
  <parameter name="return_value" transfer-ownership="none">
10265
- <doc xml:space="preserve">ignored</doc>
10954
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10955
+ if the callback of closure doesn't return a value.</doc>
10266
10956
  <type name="Value" c:type="GValue*"/>
10267
10957
  </parameter>
10268
10958
  <parameter name="n_param_values" transfer-ownership="none">
10269
- <doc xml:space="preserve">2</doc>
10959
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10270
10960
  <type name="guint" c:type="guint"/>
10271
10961
  </parameter>
10272
10962
  <parameter name="param_values" transfer-ownership="none">
10273
- <doc xml:space="preserve">a #GValue array holding the instance and the #glong parameter</doc>
10963
+ <doc xml:space="preserve">An array of #GValues holding the arguments
10964
+ on which to invoke the callback of closure.</doc>
10274
10965
  <type name="Value" c:type="const GValue*"/>
10275
10966
  </parameter>
10276
10967
  <parameter name="invocation_hint" transfer-ownership="none">
10277
- <doc xml:space="preserve">the invocation hint given as the last argument
10278
- to g_closure_invoke()</doc>
10968
+ <doc xml:space="preserve">The invocation hint given as the last argument to
10969
+ g_closure_invoke().</doc>
10279
10970
  <type name="gpointer" c:type="gpointer"/>
10280
10971
  </parameter>
10281
10972
  <parameter name="marshal_data" transfer-ownership="none">
10282
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
10973
+ <doc xml:space="preserve">Additional data specified when registering the
10974
+ marshaller, see g_closure_set_marshal() and
10975
+ g_closure_set_meta_marshal()</doc>
10283
10976
  <type name="gpointer" c:type="gpointer"/>
10284
10977
  </parameter>
10285
10978
  </parameters>
@@ -10287,35 +10980,39 @@ denotes a flags type.</doc>
10287
10980
  <function name="cclosure_marshal_VOID__OBJECT"
10288
10981
  c:identifier="g_cclosure_marshal_VOID__OBJECT"
10289
10982
  moved-to="CClosure.marshal_VOID__OBJECT">
10290
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10291
- `void (*callback) (gpointer instance, GObject *arg1, gpointer user_data)`.</doc>
10983
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
10984
+ #GObject argument.</doc>
10292
10985
  <return-value transfer-ownership="none">
10293
10986
  <type name="none" c:type="void"/>
10294
10987
  </return-value>
10295
10988
  <parameters>
10296
10989
  <parameter name="closure" transfer-ownership="none">
10297
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
10990
+ <doc xml:space="preserve">A #GClosure.</doc>
10298
10991
  <type name="Closure" c:type="GClosure*"/>
10299
10992
  </parameter>
10300
10993
  <parameter name="return_value" transfer-ownership="none">
10301
- <doc xml:space="preserve">ignored</doc>
10994
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10995
+ if the callback of closure doesn't return a value.</doc>
10302
10996
  <type name="Value" c:type="GValue*"/>
10303
10997
  </parameter>
10304
10998
  <parameter name="n_param_values" transfer-ownership="none">
10305
- <doc xml:space="preserve">2</doc>
10999
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10306
11000
  <type name="guint" c:type="guint"/>
10307
11001
  </parameter>
10308
11002
  <parameter name="param_values" transfer-ownership="none">
10309
- <doc xml:space="preserve">a #GValue array holding the instance and the #GObject* parameter</doc>
11003
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11004
+ on which to invoke the callback of closure.</doc>
10310
11005
  <type name="Value" c:type="const GValue*"/>
10311
11006
  </parameter>
10312
11007
  <parameter name="invocation_hint" transfer-ownership="none">
10313
- <doc xml:space="preserve">the invocation hint given as the last argument
10314
- to g_closure_invoke()</doc>
11008
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11009
+ g_closure_invoke().</doc>
10315
11010
  <type name="gpointer" c:type="gpointer"/>
10316
11011
  </parameter>
10317
11012
  <parameter name="marshal_data" transfer-ownership="none">
10318
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11013
+ <doc xml:space="preserve">Additional data specified when registering the
11014
+ marshaller, see g_closure_set_marshal() and
11015
+ g_closure_set_meta_marshal()</doc>
10319
11016
  <type name="gpointer" c:type="gpointer"/>
10320
11017
  </parameter>
10321
11018
  </parameters>
@@ -10323,35 +11020,39 @@ denotes a flags type.</doc>
10323
11020
  <function name="cclosure_marshal_VOID__PARAM"
10324
11021
  c:identifier="g_cclosure_marshal_VOID__PARAM"
10325
11022
  moved-to="CClosure.marshal_VOID__PARAM">
10326
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10327
- `void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data)`.</doc>
11023
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
11024
+ argument of type #GParamSpec.</doc>
10328
11025
  <return-value transfer-ownership="none">
10329
11026
  <type name="none" c:type="void"/>
10330
11027
  </return-value>
10331
11028
  <parameters>
10332
11029
  <parameter name="closure" transfer-ownership="none">
10333
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11030
+ <doc xml:space="preserve">A #GClosure.</doc>
10334
11031
  <type name="Closure" c:type="GClosure*"/>
10335
11032
  </parameter>
10336
11033
  <parameter name="return_value" transfer-ownership="none">
10337
- <doc xml:space="preserve">ignored</doc>
11034
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11035
+ if the callback of closure doesn't return a value.</doc>
10338
11036
  <type name="Value" c:type="GValue*"/>
10339
11037
  </parameter>
10340
11038
  <parameter name="n_param_values" transfer-ownership="none">
10341
- <doc xml:space="preserve">2</doc>
11039
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10342
11040
  <type name="guint" c:type="guint"/>
10343
11041
  </parameter>
10344
11042
  <parameter name="param_values" transfer-ownership="none">
10345
- <doc xml:space="preserve">a #GValue array holding the instance and the #GParamSpec* parameter</doc>
11043
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11044
+ on which to invoke the callback of closure.</doc>
10346
11045
  <type name="Value" c:type="const GValue*"/>
10347
11046
  </parameter>
10348
11047
  <parameter name="invocation_hint" transfer-ownership="none">
10349
- <doc xml:space="preserve">the invocation hint given as the last argument
10350
- to g_closure_invoke()</doc>
11048
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11049
+ g_closure_invoke().</doc>
10351
11050
  <type name="gpointer" c:type="gpointer"/>
10352
11051
  </parameter>
10353
11052
  <parameter name="marshal_data" transfer-ownership="none">
10354
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11053
+ <doc xml:space="preserve">Additional data specified when registering the
11054
+ marshaller, see g_closure_set_marshal() and
11055
+ g_closure_set_meta_marshal()</doc>
10355
11056
  <type name="gpointer" c:type="gpointer"/>
10356
11057
  </parameter>
10357
11058
  </parameters>
@@ -10359,35 +11060,43 @@ denotes a flags type.</doc>
10359
11060
  <function name="cclosure_marshal_VOID__POINTER"
10360
11061
  c:identifier="g_cclosure_marshal_VOID__POINTER"
10361
11062
  moved-to="CClosure.marshal_VOID__POINTER">
10362
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10363
- `void (*callback) (gpointer instance, gpointer arg1, gpointer user_data)`.</doc>
11063
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single raw
11064
+ pointer argument type.
11065
+
11066
+ If it is possible, it is better to use one of the more specific
11067
+ functions such as g_cclosure_marshal_VOID__OBJECT() or
11068
+ g_cclosure_marshal_VOID__OBJECT().</doc>
10364
11069
  <return-value transfer-ownership="none">
10365
11070
  <type name="none" c:type="void"/>
10366
11071
  </return-value>
10367
11072
  <parameters>
10368
11073
  <parameter name="closure" transfer-ownership="none">
10369
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11074
+ <doc xml:space="preserve">A #GClosure.</doc>
10370
11075
  <type name="Closure" c:type="GClosure*"/>
10371
11076
  </parameter>
10372
11077
  <parameter name="return_value" transfer-ownership="none">
10373
- <doc xml:space="preserve">ignored</doc>
11078
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11079
+ if the callback of closure doesn't return a value.</doc>
10374
11080
  <type name="Value" c:type="GValue*"/>
10375
11081
  </parameter>
10376
11082
  <parameter name="n_param_values" transfer-ownership="none">
10377
- <doc xml:space="preserve">2</doc>
11083
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10378
11084
  <type name="guint" c:type="guint"/>
10379
11085
  </parameter>
10380
11086
  <parameter name="param_values" transfer-ownership="none">
10381
- <doc xml:space="preserve">a #GValue array holding the instance and the #gpointer parameter</doc>
11087
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11088
+ on which to invoke the callback of closure.</doc>
10382
11089
  <type name="Value" c:type="const GValue*"/>
10383
11090
  </parameter>
10384
11091
  <parameter name="invocation_hint" transfer-ownership="none">
10385
- <doc xml:space="preserve">the invocation hint given as the last argument
10386
- to g_closure_invoke()</doc>
11092
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11093
+ g_closure_invoke().</doc>
10387
11094
  <type name="gpointer" c:type="gpointer"/>
10388
11095
  </parameter>
10389
11096
  <parameter name="marshal_data" transfer-ownership="none">
10390
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11097
+ <doc xml:space="preserve">Additional data specified when registering the
11098
+ marshaller, see g_closure_set_marshal() and
11099
+ g_closure_set_meta_marshal()</doc>
10391
11100
  <type name="gpointer" c:type="gpointer"/>
10392
11101
  </parameter>
10393
11102
  </parameters>
@@ -10395,35 +11104,39 @@ denotes a flags type.</doc>
10395
11104
  <function name="cclosure_marshal_VOID__STRING"
10396
11105
  c:identifier="g_cclosure_marshal_VOID__STRING"
10397
11106
  moved-to="CClosure.marshal_VOID__STRING">
10398
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10399
- `void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data)`.</doc>
11107
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single string
11108
+ argument.</doc>
10400
11109
  <return-value transfer-ownership="none">
10401
11110
  <type name="none" c:type="void"/>
10402
11111
  </return-value>
10403
11112
  <parameters>
10404
11113
  <parameter name="closure" transfer-ownership="none">
10405
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11114
+ <doc xml:space="preserve">A #GClosure.</doc>
10406
11115
  <type name="Closure" c:type="GClosure*"/>
10407
11116
  </parameter>
10408
11117
  <parameter name="return_value" transfer-ownership="none">
10409
- <doc xml:space="preserve">ignored</doc>
11118
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11119
+ if the callback of closure doesn't return a value.</doc>
10410
11120
  <type name="Value" c:type="GValue*"/>
10411
11121
  </parameter>
10412
11122
  <parameter name="n_param_values" transfer-ownership="none">
10413
- <doc xml:space="preserve">2</doc>
11123
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10414
11124
  <type name="guint" c:type="guint"/>
10415
11125
  </parameter>
10416
11126
  <parameter name="param_values" transfer-ownership="none">
10417
- <doc xml:space="preserve">a #GValue array holding the instance and the #gchar* parameter</doc>
11127
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11128
+ on which to invoke the callback of closure.</doc>
10418
11129
  <type name="Value" c:type="const GValue*"/>
10419
11130
  </parameter>
10420
11131
  <parameter name="invocation_hint" transfer-ownership="none">
10421
- <doc xml:space="preserve">the invocation hint given as the last argument
10422
- to g_closure_invoke()</doc>
11132
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11133
+ g_closure_invoke().</doc>
10423
11134
  <type name="gpointer" c:type="gpointer"/>
10424
11135
  </parameter>
10425
11136
  <parameter name="marshal_data" transfer-ownership="none">
10426
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11137
+ <doc xml:space="preserve">Additional data specified when registering the
11138
+ marshaller, see g_closure_set_marshal() and
11139
+ g_closure_set_meta_marshal()</doc>
10427
11140
  <type name="gpointer" c:type="gpointer"/>
10428
11141
  </parameter>
10429
11142
  </parameters>
@@ -10431,35 +11144,39 @@ denotes a flags type.</doc>
10431
11144
  <function name="cclosure_marshal_VOID__UCHAR"
10432
11145
  c:identifier="g_cclosure_marshal_VOID__UCHAR"
10433
11146
  moved-to="CClosure.marshal_VOID__UCHAR">
10434
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10435
- `void (*callback) (gpointer instance, guchar arg1, gpointer user_data)`.</doc>
11147
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
11148
+ unsigned character argument.</doc>
10436
11149
  <return-value transfer-ownership="none">
10437
11150
  <type name="none" c:type="void"/>
10438
11151
  </return-value>
10439
11152
  <parameters>
10440
11153
  <parameter name="closure" transfer-ownership="none">
10441
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11154
+ <doc xml:space="preserve">A #GClosure.</doc>
10442
11155
  <type name="Closure" c:type="GClosure*"/>
10443
11156
  </parameter>
10444
11157
  <parameter name="return_value" transfer-ownership="none">
10445
- <doc xml:space="preserve">ignored</doc>
11158
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11159
+ if the callback of closure doesn't return a value.</doc>
10446
11160
  <type name="Value" c:type="GValue*"/>
10447
11161
  </parameter>
10448
11162
  <parameter name="n_param_values" transfer-ownership="none">
10449
- <doc xml:space="preserve">2</doc>
11163
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10450
11164
  <type name="guint" c:type="guint"/>
10451
11165
  </parameter>
10452
11166
  <parameter name="param_values" transfer-ownership="none">
10453
- <doc xml:space="preserve">a #GValue array holding the instance and the #guchar parameter</doc>
11167
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11168
+ on which to invoke the callback of closure.</doc>
10454
11169
  <type name="Value" c:type="const GValue*"/>
10455
11170
  </parameter>
10456
11171
  <parameter name="invocation_hint" transfer-ownership="none">
10457
- <doc xml:space="preserve">the invocation hint given as the last argument
10458
- to g_closure_invoke()</doc>
11172
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11173
+ g_closure_invoke().</doc>
10459
11174
  <type name="gpointer" c:type="gpointer"/>
10460
11175
  </parameter>
10461
11176
  <parameter name="marshal_data" transfer-ownership="none">
10462
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11177
+ <doc xml:space="preserve">Additional data specified when registering the
11178
+ marshaller, see g_closure_set_marshal() and
11179
+ g_closure_set_meta_marshal()</doc>
10463
11180
  <type name="gpointer" c:type="gpointer"/>
10464
11181
  </parameter>
10465
11182
  </parameters>
@@ -10467,35 +11184,39 @@ denotes a flags type.</doc>
10467
11184
  <function name="cclosure_marshal_VOID__UINT"
10468
11185
  c:identifier="g_cclosure_marshal_VOID__UINT"
10469
11186
  moved-to="CClosure.marshal_VOID__UINT">
10470
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10471
- `void (*callback) (gpointer instance, guint arg1, gpointer user_data)`.</doc>
11187
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with with a single
11188
+ unsigned integer argument.</doc>
10472
11189
  <return-value transfer-ownership="none">
10473
11190
  <type name="none" c:type="void"/>
10474
11191
  </return-value>
10475
11192
  <parameters>
10476
11193
  <parameter name="closure" transfer-ownership="none">
10477
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11194
+ <doc xml:space="preserve">A #GClosure.</doc>
10478
11195
  <type name="Closure" c:type="GClosure*"/>
10479
11196
  </parameter>
10480
11197
  <parameter name="return_value" transfer-ownership="none">
10481
- <doc xml:space="preserve">ignored</doc>
11198
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11199
+ if the callback of closure doesn't return a value.</doc>
10482
11200
  <type name="Value" c:type="GValue*"/>
10483
11201
  </parameter>
10484
11202
  <parameter name="n_param_values" transfer-ownership="none">
10485
- <doc xml:space="preserve">2</doc>
11203
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10486
11204
  <type name="guint" c:type="guint"/>
10487
11205
  </parameter>
10488
11206
  <parameter name="param_values" transfer-ownership="none">
10489
- <doc xml:space="preserve">a #GValue array holding the instance and the #guint parameter</doc>
11207
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11208
+ on which to invoke the callback of closure.</doc>
10490
11209
  <type name="Value" c:type="const GValue*"/>
10491
11210
  </parameter>
10492
11211
  <parameter name="invocation_hint" transfer-ownership="none">
10493
- <doc xml:space="preserve">the invocation hint given as the last argument
10494
- to g_closure_invoke()</doc>
11212
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11213
+ g_closure_invoke().</doc>
10495
11214
  <type name="gpointer" c:type="gpointer"/>
10496
11215
  </parameter>
10497
11216
  <parameter name="marshal_data" transfer-ownership="none">
10498
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11217
+ <doc xml:space="preserve">Additional data specified when registering the
11218
+ marshaller, see g_closure_set_marshal() and
11219
+ g_closure_set_meta_marshal()</doc>
10499
11220
  <type name="gpointer" c:type="gpointer"/>
10500
11221
  </parameter>
10501
11222
  </parameters>
@@ -10503,35 +11224,39 @@ denotes a flags type.</doc>
10503
11224
  <function name="cclosure_marshal_VOID__UINT_POINTER"
10504
11225
  c:identifier="g_cclosure_marshal_VOID__UINT_POINTER"
10505
11226
  moved-to="CClosure.marshal_VOID__UINT_POINTER">
10506
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10507
- `void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data)`.</doc>
11227
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a unsigned int
11228
+ and a pointer as arguments.</doc>
10508
11229
  <return-value transfer-ownership="none">
10509
11230
  <type name="none" c:type="void"/>
10510
11231
  </return-value>
10511
11232
  <parameters>
10512
11233
  <parameter name="closure" transfer-ownership="none">
10513
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11234
+ <doc xml:space="preserve">A #GClosure.</doc>
10514
11235
  <type name="Closure" c:type="GClosure*"/>
10515
11236
  </parameter>
10516
11237
  <parameter name="return_value" transfer-ownership="none">
10517
- <doc xml:space="preserve">ignored</doc>
11238
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11239
+ if the callback of closure doesn't return a value.</doc>
10518
11240
  <type name="Value" c:type="GValue*"/>
10519
11241
  </parameter>
10520
11242
  <parameter name="n_param_values" transfer-ownership="none">
10521
- <doc xml:space="preserve">3</doc>
11243
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10522
11244
  <type name="guint" c:type="guint"/>
10523
11245
  </parameter>
10524
11246
  <parameter name="param_values" transfer-ownership="none">
10525
- <doc xml:space="preserve">a #GValue array holding instance, arg1 and arg2</doc>
11247
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11248
+ on which to invoke the callback of closure.</doc>
10526
11249
  <type name="Value" c:type="const GValue*"/>
10527
11250
  </parameter>
10528
11251
  <parameter name="invocation_hint" transfer-ownership="none">
10529
- <doc xml:space="preserve">the invocation hint given as the last argument
10530
- to g_closure_invoke()</doc>
11252
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11253
+ g_closure_invoke().</doc>
10531
11254
  <type name="gpointer" c:type="gpointer"/>
10532
11255
  </parameter>
10533
11256
  <parameter name="marshal_data" transfer-ownership="none">
10534
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11257
+ <doc xml:space="preserve">Additional data specified when registering the
11258
+ marshaller, see g_closure_set_marshal() and
11259
+ g_closure_set_meta_marshal()</doc>
10535
11260
  <type name="gpointer" c:type="gpointer"/>
10536
11261
  </parameter>
10537
11262
  </parameters>
@@ -10539,72 +11264,79 @@ denotes a flags type.</doc>
10539
11264
  <function name="cclosure_marshal_VOID__ULONG"
10540
11265
  c:identifier="g_cclosure_marshal_VOID__ULONG"
10541
11266
  moved-to="CClosure.marshal_VOID__ULONG">
10542
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10543
- `void (*callback) (gpointer instance, gulong arg1, gpointer user_data)`.</doc>
11267
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
11268
+ unsigned long integer argument.</doc>
10544
11269
  <return-value transfer-ownership="none">
10545
11270
  <type name="none" c:type="void"/>
10546
11271
  </return-value>
10547
11272
  <parameters>
10548
11273
  <parameter name="closure" transfer-ownership="none">
10549
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11274
+ <doc xml:space="preserve">A #GClosure.</doc>
10550
11275
  <type name="Closure" c:type="GClosure*"/>
10551
11276
  </parameter>
10552
11277
  <parameter name="return_value" transfer-ownership="none">
10553
- <doc xml:space="preserve">ignored</doc>
11278
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11279
+ if the callback of closure doesn't return a value.</doc>
10554
11280
  <type name="Value" c:type="GValue*"/>
10555
11281
  </parameter>
10556
11282
  <parameter name="n_param_values" transfer-ownership="none">
10557
- <doc xml:space="preserve">2</doc>
11283
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10558
11284
  <type name="guint" c:type="guint"/>
10559
11285
  </parameter>
10560
11286
  <parameter name="param_values" transfer-ownership="none">
10561
- <doc xml:space="preserve">a #GValue array holding the instance and the #gulong parameter</doc>
11287
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11288
+ on which to invoke the callback of closure.</doc>
10562
11289
  <type name="Value" c:type="const GValue*"/>
10563
11290
  </parameter>
10564
11291
  <parameter name="invocation_hint" transfer-ownership="none">
10565
- <doc xml:space="preserve">the invocation hint given as the last argument
10566
- to g_closure_invoke()</doc>
11292
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11293
+ g_closure_invoke().</doc>
10567
11294
  <type name="gpointer" c:type="gpointer"/>
10568
11295
  </parameter>
10569
11296
  <parameter name="marshal_data" transfer-ownership="none">
10570
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11297
+ <doc xml:space="preserve">Additional data specified when registering the
11298
+ marshaller, see g_closure_set_marshal() and
11299
+ g_closure_set_meta_marshal()</doc>
10571
11300
  <type name="gpointer" c:type="gpointer"/>
10572
11301
  </parameter>
10573
11302
  </parameters>
10574
11303
  </function>
10575
11304
  <function name="cclosure_marshal_VOID__VARIANT"
10576
11305
  c:identifier="g_cclosure_marshal_VOID__VARIANT"
10577
- moved-to="CClosure.marshal_VOID__VARIANT"
10578
- version="2.26">
10579
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10580
- `void (*callback) (gpointer instance, GVariant *arg1, gpointer user_data)`.</doc>
11306
+ moved-to="CClosure.marshal_VOID__VARIANT">
11307
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
11308
+ #GVariant argument.</doc>
10581
11309
  <return-value transfer-ownership="none">
10582
11310
  <type name="none" c:type="void"/>
10583
11311
  </return-value>
10584
11312
  <parameters>
10585
11313
  <parameter name="closure" transfer-ownership="none">
10586
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11314
+ <doc xml:space="preserve">A #GClosure.</doc>
10587
11315
  <type name="Closure" c:type="GClosure*"/>
10588
11316
  </parameter>
10589
11317
  <parameter name="return_value" transfer-ownership="none">
10590
- <doc xml:space="preserve">ignored</doc>
11318
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11319
+ if the callback of closure doesn't return a value.</doc>
10591
11320
  <type name="Value" c:type="GValue*"/>
10592
11321
  </parameter>
10593
11322
  <parameter name="n_param_values" transfer-ownership="none">
10594
- <doc xml:space="preserve">2</doc>
11323
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10595
11324
  <type name="guint" c:type="guint"/>
10596
11325
  </parameter>
10597
11326
  <parameter name="param_values" transfer-ownership="none">
10598
- <doc xml:space="preserve">a #GValue array holding the instance and the #GVariant* parameter</doc>
11327
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11328
+ on which to invoke the callback of closure.</doc>
10599
11329
  <type name="Value" c:type="const GValue*"/>
10600
11330
  </parameter>
10601
11331
  <parameter name="invocation_hint" transfer-ownership="none">
10602
- <doc xml:space="preserve">the invocation hint given as the last argument
10603
- to g_closure_invoke()</doc>
11332
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11333
+ g_closure_invoke().</doc>
10604
11334
  <type name="gpointer" c:type="gpointer"/>
10605
11335
  </parameter>
10606
11336
  <parameter name="marshal_data" transfer-ownership="none">
10607
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11337
+ <doc xml:space="preserve">Additional data specified when registering the
11338
+ marshaller, see g_closure_set_marshal() and
11339
+ g_closure_set_meta_marshal()</doc>
10608
11340
  <type name="gpointer" c:type="gpointer"/>
10609
11341
  </parameter>
10610
11342
  </parameters>
@@ -10612,35 +11344,38 @@ denotes a flags type.</doc>
10612
11344
  <function name="cclosure_marshal_VOID__VOID"
10613
11345
  c:identifier="g_cclosure_marshal_VOID__VOID"
10614
11346
  moved-to="CClosure.marshal_VOID__VOID">
10615
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10616
- `void (*callback) (gpointer instance, gpointer user_data)`.</doc>
11347
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with no arguments.</doc>
10617
11348
  <return-value transfer-ownership="none">
10618
11349
  <type name="none" c:type="void"/>
10619
11350
  </return-value>
10620
11351
  <parameters>
10621
11352
  <parameter name="closure" transfer-ownership="none">
10622
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11353
+ <doc xml:space="preserve">A #GClosure.</doc>
10623
11354
  <type name="Closure" c:type="GClosure*"/>
10624
11355
  </parameter>
10625
11356
  <parameter name="return_value" transfer-ownership="none">
10626
- <doc xml:space="preserve">ignored</doc>
11357
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11358
+ if the callback of closure doesn't return a value.</doc>
10627
11359
  <type name="Value" c:type="GValue*"/>
10628
11360
  </parameter>
10629
11361
  <parameter name="n_param_values" transfer-ownership="none">
10630
- <doc xml:space="preserve">1</doc>
11362
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10631
11363
  <type name="guint" c:type="guint"/>
10632
11364
  </parameter>
10633
11365
  <parameter name="param_values" transfer-ownership="none">
10634
- <doc xml:space="preserve">a #GValue array holding only the instance</doc>
11366
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11367
+ on which to invoke the callback of closure.</doc>
10635
11368
  <type name="Value" c:type="const GValue*"/>
10636
11369
  </parameter>
10637
11370
  <parameter name="invocation_hint" transfer-ownership="none">
10638
- <doc xml:space="preserve">the invocation hint given as the last argument
10639
- to g_closure_invoke()</doc>
11371
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11372
+ g_closure_invoke().</doc>
10640
11373
  <type name="gpointer" c:type="gpointer"/>
10641
11374
  </parameter>
10642
11375
  <parameter name="marshal_data" transfer-ownership="none">
10643
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11376
+ <doc xml:space="preserve">Additional data specified when registering the
11377
+ marshaller, see g_closure_set_marshal() and
11378
+ g_closure_set_meta_marshal()</doc>
10644
11379
  <type name="gpointer" c:type="gpointer"/>
10645
11380
  </parameter>
10646
11381
  </parameters>
@@ -11055,7 +11790,10 @@ definition than to write one yourself using g_flags_register_static().</doc>
11055
11790
  </function>
11056
11791
  <function name="param_spec_boolean" c:identifier="g_param_spec_boolean">
11057
11792
  <doc xml:space="preserve">Creates a new #GParamSpecBoolean instance specifying a %G_TYPE_BOOLEAN
11058
- property.
11793
+ property. In many cases, it may be more appropriate to use an enum with
11794
+ g_param_spec_enum(), both to improve code clarity by using explicitly named
11795
+ values, and to allow for more values to be added in future without breaking
11796
+ API.
11059
11797
 
11060
11798
  See g_param_spec_internal() for details on property names.</doc>
11061
11799
  <return-value transfer-ownership="full">
@@ -11545,6 +12283,8 @@ See g_param_spec_internal() for details on property names.</doc>
11545
12283
  </function>
11546
12284
  <function name="param_spec_pointer" c:identifier="g_param_spec_pointer">
11547
12285
  <doc xml:space="preserve">Creates a new #GParamSpecPointer instance specifying a pointer property.
12286
+ Where possible, it is better to use g_param_spec_object() or
12287
+ g_param_spec_boxed() to expose memory management information.
11548
12288
 
11549
12289
  See g_param_spec_internal() for details on property names.</doc>
11550
12290
  <return-value transfer-ownership="full">
@@ -12767,6 +13507,12 @@ not currently blocked.</doc>
12767
13507
  <doc xml:space="preserve">Returns whether there are any handlers connected to @instance for the
12768
13508
  given signal id and detail.
12769
13509
 
13510
+ If @detail is 0 then it will only match handlers that were connected
13511
+ without detail. If @detail is non-zero then it will match handlers
13512
+ connected both without detail and with the given detail. This is
13513
+ consistent with how a signal emitted with @detail would be delivered
13514
+ to those handlers.
13515
+
12770
13516
  One example of when you might use this is when the arguments to the
12771
13517
  signal are difficult to compute. A class implementor may opt to not
12772
13518
  emit the signal if no one is attached anyway, thus saving the cost
@@ -13287,18 +14033,26 @@ be considered constant and have to be left untouched.</doc>
13287
14033
  </parameters>
13288
14034
  </function>
13289
14035
  <function name="signal_set_va_marshaller"
13290
- c:identifier="g_signal_set_va_marshaller">
14036
+ c:identifier="g_signal_set_va_marshaller"
14037
+ version="2.32">
14038
+ <doc xml:space="preserve">Change the #GSignalCVaMarshaller used for a given signal. This is a
14039
+ specialised form of the marshaller that can often be used for the
14040
+ common case of a single connected signal handler and avoids the
14041
+ overhead of #GValue. Its use is optional.</doc>
13291
14042
  <return-value transfer-ownership="none">
13292
14043
  <type name="none" c:type="void"/>
13293
14044
  </return-value>
13294
14045
  <parameters>
13295
14046
  <parameter name="signal_id" transfer-ownership="none">
14047
+ <doc xml:space="preserve">the signal id</doc>
13296
14048
  <type name="guint" c:type="guint"/>
13297
14049
  </parameter>
13298
14050
  <parameter name="instance_type" transfer-ownership="none">
14051
+ <doc xml:space="preserve">the instance type on which to set the marshaller.</doc>
13299
14052
  <type name="GType" c:type="GType"/>
13300
14053
  </parameter>
13301
14054
  <parameter name="va_marshaller" transfer-ownership="none">
14055
+ <doc xml:space="preserve">the marshaller to set.</doc>
13302
14056
  <type name="SignalCVaMarshaller" c:type="GSignalCVaMarshaller"/>
13303
14057
  </parameter>
13304
14058
  </parameters>
@@ -14085,6 +14839,25 @@ fundamental type identifier.</doc>
14085
14839
  <type name="GType" c:type="GType"/>
14086
14840
  </return-value>
14087
14841
  </function>
14842
+ <function name="type_get_instance_count"
14843
+ c:identifier="g_type_get_instance_count"
14844
+ version="2.44">
14845
+ <doc xml:space="preserve">Returns the number of instances allocated of the particular type;
14846
+ this is only available if GLib is built with debugging support and
14847
+ the instance_count debug flag is set (by setting the GOBJECT_DEBUG
14848
+ variable to include instance-count).</doc>
14849
+ <return-value transfer-ownership="none">
14850
+ <doc xml:space="preserve">the number of instances allocated of the given type;
14851
+ if instance counts are not available, returns 0.</doc>
14852
+ <type name="gint" c:type="int"/>
14853
+ </return-value>
14854
+ <parameters>
14855
+ <parameter name="type" transfer-ownership="none">
14856
+ <doc xml:space="preserve">a #GType</doc>
14857
+ <type name="GType" c:type="GType"/>
14858
+ </parameter>
14859
+ </parameters>
14860
+ </function>
14088
14861
  <function name="type_get_plugin" c:identifier="g_type_get_plugin">
14089
14862
  <doc xml:space="preserve">Returns the #GTypePlugin structure for @type.</doc>
14090
14863
  <return-value transfer-ownership="none">