gobject-introspection 2.2.5-x86-mingw32 → 3.0.0-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (108) hide show
  1. checksums.yaml +4 -4
  2. data/Rakefile +3 -3
  3. data/ext/gobject-introspection/extconf.rb +1 -1
  4. data/ext/gobject-introspection/rb-gi-argument.c +2275 -708
  5. data/ext/gobject-introspection/rb-gi-constant-info.c +1 -1
  6. data/ext/gobject-introspection/rb-gi-constructor-info.c +2 -2
  7. data/ext/gobject-introspection/rb-gi-conversions.h +40 -36
  8. data/ext/gobject-introspection/rb-gi-field-info.c +32 -6
  9. data/ext/gobject-introspection/rb-gi-function-info.c +98 -63
  10. data/ext/gobject-introspection/rb-gi-loader.c +33 -1
  11. data/ext/gobject-introspection/rb-gi-method-info.c +3 -6
  12. data/ext/gobject-introspection/rb-gi-private.h +2 -1
  13. data/ext/gobject-introspection/rb-gi-repository.c +29 -29
  14. data/lib/2.0/gobject_introspection.so +0 -0
  15. data/lib/2.1/gobject_introspection.so +0 -0
  16. data/lib/2.2/gobject_introspection.so +0 -0
  17. data/lib/gobject-introspection/arg-info.rb +27 -0
  18. data/lib/gobject-introspection/callable-info.rb +3 -1
  19. data/lib/gobject-introspection/loader.rb +160 -31
  20. data/lib/gobject-introspection.rb +1 -0
  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">