gobject-introspection 3.1.1-x86-mingw32 → 3.1.2-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (97) hide show
  1. checksums.yaml +4 -4
  2. data/Rakefile +2 -2
  3. data/ext/gobject-introspection/extconf.rb +2 -2
  4. data/ext/gobject-introspection/rb-gi-argument.c +65 -10
  5. data/ext/gobject-introspection/rb-gi-field-info.c +81 -14
  6. data/ext/gobject-introspection/rb-gi-loader.c +8 -3
  7. data/ext/gobject-introspection/rb-gi-repository.c +5 -1
  8. data/lib/2.2/gobject_introspection.so +0 -0
  9. data/lib/2.3/gobject_introspection.so +0 -0
  10. data/lib/2.4/gobject_introspection.so +0 -0
  11. data/lib/gobject-introspection/loader.rb +49 -13
  12. data/lib/gobject-introspection/repository.rb +7 -0
  13. data/test/test-union-info.rb +34 -2
  14. data/vendor/local/bin/g-ir-compiler.exe +0 -0
  15. data/vendor/local/bin/g-ir-generate.exe +0 -0
  16. data/vendor/local/bin/g-ir-inspect.exe +0 -0
  17. data/vendor/local/bin/libgirepository-1.0-1.dll +0 -0
  18. data/vendor/local/lib/girepository-1.0/GIRepository-2.0.typelib +0 -0
  19. data/vendor/local/lib/girepository-1.0/GLib-2.0.typelib +0 -0
  20. data/vendor/local/lib/girepository-1.0/Gio-2.0.typelib +0 -0
  21. data/vendor/local/lib/gobject-introspection/giscanner/__init__.pyc +0 -0
  22. data/vendor/local/lib/gobject-introspection/giscanner/__init__.pyo +0 -0
  23. data/vendor/local/lib/gobject-introspection/giscanner/annotationmain.pyc +0 -0
  24. data/vendor/local/lib/gobject-introspection/giscanner/annotationmain.pyo +0 -0
  25. data/vendor/local/lib/gobject-introspection/giscanner/annotationparser.pyc +0 -0
  26. data/vendor/local/lib/gobject-introspection/giscanner/annotationparser.pyo +0 -0
  27. data/vendor/local/lib/gobject-introspection/giscanner/ast.pyc +0 -0
  28. data/vendor/local/lib/gobject-introspection/giscanner/ast.pyo +0 -0
  29. data/vendor/local/lib/gobject-introspection/giscanner/cachestore.pyc +0 -0
  30. data/vendor/local/lib/gobject-introspection/giscanner/cachestore.pyo +0 -0
  31. data/vendor/local/lib/gobject-introspection/giscanner/ccompiler.py +5 -4
  32. data/vendor/local/lib/gobject-introspection/giscanner/ccompiler.pyc +0 -0
  33. data/vendor/local/lib/gobject-introspection/giscanner/ccompiler.pyo +0 -0
  34. data/vendor/local/lib/gobject-introspection/giscanner/codegen.pyc +0 -0
  35. data/vendor/local/lib/gobject-introspection/giscanner/codegen.pyo +0 -0
  36. data/vendor/local/lib/gobject-introspection/giscanner/collections/__init__.pyc +0 -0
  37. data/vendor/local/lib/gobject-introspection/giscanner/collections/__init__.pyo +0 -0
  38. data/vendor/local/lib/gobject-introspection/giscanner/collections/counter.pyc +0 -0
  39. data/vendor/local/lib/gobject-introspection/giscanner/collections/counter.pyo +0 -0
  40. data/vendor/local/lib/gobject-introspection/giscanner/collections/ordereddict.pyc +0 -0
  41. data/vendor/local/lib/gobject-introspection/giscanner/collections/ordereddict.pyo +0 -0
  42. data/vendor/local/lib/gobject-introspection/giscanner/docmain.pyc +0 -0
  43. data/vendor/local/lib/gobject-introspection/giscanner/docmain.pyo +0 -0
  44. data/vendor/local/lib/gobject-introspection/giscanner/docwriter.pyc +0 -0
  45. data/vendor/local/lib/gobject-introspection/giscanner/docwriter.pyo +0 -0
  46. data/vendor/local/lib/gobject-introspection/giscanner/dumper.py +8 -7
  47. data/vendor/local/lib/gobject-introspection/giscanner/dumper.pyc +0 -0
  48. data/vendor/local/lib/gobject-introspection/giscanner/dumper.pyo +0 -0
  49. data/vendor/local/lib/gobject-introspection/giscanner/gdumpparser.pyc +0 -0
  50. data/vendor/local/lib/gobject-introspection/giscanner/gdumpparser.pyo +0 -0
  51. data/vendor/local/lib/gobject-introspection/giscanner/girparser.pyc +0 -0
  52. data/vendor/local/lib/gobject-introspection/giscanner/girparser.pyo +0 -0
  53. data/vendor/local/lib/gobject-introspection/giscanner/girwriter.py +1 -1
  54. data/vendor/local/lib/gobject-introspection/giscanner/girwriter.pyc +0 -0
  55. data/vendor/local/lib/gobject-introspection/giscanner/girwriter.pyo +0 -0
  56. data/vendor/local/lib/gobject-introspection/giscanner/introspectablepass.pyc +0 -0
  57. data/vendor/local/lib/gobject-introspection/giscanner/introspectablepass.pyo +0 -0
  58. data/vendor/local/lib/gobject-introspection/giscanner/libtoolimporter.pyc +0 -0
  59. data/vendor/local/lib/gobject-introspection/giscanner/libtoolimporter.pyo +0 -0
  60. data/vendor/local/lib/gobject-introspection/giscanner/maintransformer.pyc +0 -0
  61. data/vendor/local/lib/gobject-introspection/giscanner/maintransformer.pyo +0 -0
  62. data/vendor/local/lib/gobject-introspection/giscanner/message.pyc +0 -0
  63. data/vendor/local/lib/gobject-introspection/giscanner/message.pyo +0 -0
  64. data/vendor/local/lib/gobject-introspection/giscanner/msvccompiler.pyc +0 -0
  65. data/vendor/local/lib/gobject-introspection/giscanner/msvccompiler.pyo +0 -0
  66. data/vendor/local/lib/gobject-introspection/giscanner/scannermain.py +3 -0
  67. data/vendor/local/lib/gobject-introspection/giscanner/scannermain.pyc +0 -0
  68. data/vendor/local/lib/gobject-introspection/giscanner/scannermain.pyo +0 -0
  69. data/vendor/local/lib/gobject-introspection/giscanner/sectionparser.pyc +0 -0
  70. data/vendor/local/lib/gobject-introspection/giscanner/sectionparser.pyo +0 -0
  71. data/vendor/local/lib/gobject-introspection/giscanner/shlibs.pyc +0 -0
  72. data/vendor/local/lib/gobject-introspection/giscanner/shlibs.pyo +0 -0
  73. data/vendor/local/lib/gobject-introspection/giscanner/sourcescanner.pyc +0 -0
  74. data/vendor/local/lib/gobject-introspection/giscanner/sourcescanner.pyo +0 -0
  75. data/vendor/local/lib/gobject-introspection/giscanner/testcodegen.pyc +0 -0
  76. data/vendor/local/lib/gobject-introspection/giscanner/testcodegen.pyo +0 -0
  77. data/vendor/local/lib/gobject-introspection/giscanner/transformer.py +1 -6
  78. data/vendor/local/lib/gobject-introspection/giscanner/transformer.pyc +0 -0
  79. data/vendor/local/lib/gobject-introspection/giscanner/transformer.pyo +0 -0
  80. data/vendor/local/lib/gobject-introspection/giscanner/utils.pyc +0 -0
  81. data/vendor/local/lib/gobject-introspection/giscanner/utils.pyo +0 -0
  82. data/vendor/local/lib/gobject-introspection/giscanner/xmlwriter.pyc +0 -0
  83. data/vendor/local/lib/gobject-introspection/giscanner/xmlwriter.pyo +0 -0
  84. data/vendor/local/lib/libgirepository-1.0.a +0 -0
  85. data/vendor/local/lib/libgirepository-1.0.dll.a +0 -0
  86. data/vendor/local/lib/pkgconfig/gobject-introspection-1.0.pc +1 -1
  87. data/vendor/local/lib/pkgconfig/gobject-introspection-no-export-1.0.pc +1 -1
  88. data/vendor/local/share/gir-1.0/GIRepository-2.0.gir +18 -6
  89. data/vendor/local/share/gir-1.0/GLib-2.0.gir +186 -61
  90. data/vendor/local/share/gir-1.0/GObject-2.0.gir +565 -389
  91. data/vendor/local/share/gir-1.0/Gio-2.0.gir +921 -57
  92. data/vendor/local/share/gobject-introspection-1.0/Makefile.introspection +4 -0
  93. data/vendor/local/share/gobject-introspection-1.0/tests/gimarshallingtests.c +262 -0
  94. data/vendor/local/share/gobject-introspection-1.0/tests/gimarshallingtests.h +45 -1
  95. data/vendor/local/share/gobject-introspection-1.0/tests/regress.c +37 -0
  96. data/vendor/local/share/gobject-introspection-1.0/tests/regress.h +4 -0
  97. metadata +5 -5
data/vendor/local/share/gir-1.0/GObject-2.0.gir CHANGED
@@ -507,42 +507,47 @@ accumulator, such as g_signal_accumulator_true_handled().</doc>
507
507
  </function>
508
508
  <function name="marshal_BOOLEAN__FLAGS"
509
509
  c:identifier="g_cclosure_marshal_BOOLEAN__FLAGS">
510
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
511
- `gboolean (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter
512
- denotes a flags type.</doc>
510
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with handlers that
511
+ take a flags type as an argument and return a boolean. If you have
512
+ such a signal, you will probably also need to use an accumulator,
513
+ such as g_signal_accumulator_true_handled().</doc>
513
514
  <return-value transfer-ownership="none">
514
515
  <type name="none" c:type="void"/>
515
516
  </return-value>
516
517
  <parameters>
517
518
  <parameter name="closure" transfer-ownership="none">
518
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
519
+ <doc xml:space="preserve">A #GClosure.</doc>
519
520
  <type name="Closure" c:type="GClosure*"/>
520
521
  </parameter>
521
522
  <parameter name="return_value" transfer-ownership="none">
522
- <doc xml:space="preserve">a #GValue which can store the returned #gboolean</doc>
523
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
524
+ if the callback of closure doesn't return a value.</doc>
523
525
  <type name="Value" c:type="GValue*"/>
524
526
  </parameter>
525
527
  <parameter name="n_param_values" transfer-ownership="none">
526
- <doc xml:space="preserve">2</doc>
528
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
527
529
  <type name="guint" c:type="guint"/>
528
530
  </parameter>
529
531
  <parameter name="param_values" transfer-ownership="none">
530
- <doc xml:space="preserve">a #GValue array holding instance and arg1</doc>
532
+ <doc xml:space="preserve">An array of #GValues holding the arguments
533
+ on which to invoke the callback of closure.</doc>
531
534
  <type name="Value" c:type="const GValue*"/>
532
535
  </parameter>
533
536
  <parameter name="invocation_hint"
534
537
  transfer-ownership="none"
535
538
  nullable="1"
536
539
  allow-none="1">
537
- <doc xml:space="preserve">the invocation hint given as the last argument
538
- to g_closure_invoke()</doc>
540
+ <doc xml:space="preserve">The invocation hint given as the last argument to
541
+ g_closure_invoke().</doc>
539
542
  <type name="gpointer" c:type="gpointer"/>
540
543
  </parameter>
541
544
  <parameter name="marshal_data"
542
545
  transfer-ownership="none"
543
546
  nullable="1"
544
547
  allow-none="1">
545
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
548
+ <doc xml:space="preserve">Additional data specified when registering the
549
+ marshaller, see g_closure_set_marshal() and
550
+ g_closure_set_meta_marshal()</doc>
546
551
  <type name="gpointer" c:type="gpointer"/>
547
552
  </parameter>
548
553
  </parameters>
@@ -600,41 +605,46 @@ denotes a flags type.</doc>
600
605
  </function>
601
606
  <function name="marshal_STRING__OBJECT_POINTER"
602
607
  c:identifier="g_cclosure_marshal_STRING__OBJECT_POINTER">
603
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
604
- `gchar* (*callback) (gpointer instance, GObject *arg1, gpointer arg2, gpointer user_data)`.</doc>
608
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with handlers that
609
+ take a #GObject and a pointer and produce a string. It is highly
610
+ unlikely that your signal handler fits this description.</doc>
605
611
  <return-value transfer-ownership="none">
606
612
  <type name="none" c:type="void"/>
607
613
  </return-value>
608
614
  <parameters>
609
615
  <parameter name="closure" transfer-ownership="none">
610
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
616
+ <doc xml:space="preserve">A #GClosure.</doc>
611
617
  <type name="Closure" c:type="GClosure*"/>
612
618
  </parameter>
613
619
  <parameter name="return_value" transfer-ownership="none">
614
- <doc xml:space="preserve">a #GValue, which can store the returned string</doc>
620
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
621
+ if the callback of closure doesn't return a value.</doc>
615
622
  <type name="Value" c:type="GValue*"/>
616
623
  </parameter>
617
624
  <parameter name="n_param_values" transfer-ownership="none">
618
- <doc xml:space="preserve">3</doc>
625
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
619
626
  <type name="guint" c:type="guint"/>
620
627
  </parameter>
621
628
  <parameter name="param_values" transfer-ownership="none">
622
- <doc xml:space="preserve">a #GValue array holding instance, arg1 and arg2</doc>
629
+ <doc xml:space="preserve">An array of #GValues holding the arguments
630
+ on which to invoke the callback of closure.</doc>
623
631
  <type name="Value" c:type="const GValue*"/>
624
632
  </parameter>
625
633
  <parameter name="invocation_hint"
626
634
  transfer-ownership="none"
627
635
  nullable="1"
628
636
  allow-none="1">
629
- <doc xml:space="preserve">the invocation hint given as the last argument
630
- to g_closure_invoke()</doc>
637
+ <doc xml:space="preserve">The invocation hint given as the last argument to
638
+ g_closure_invoke().</doc>
631
639
  <type name="gpointer" c:type="gpointer"/>
632
640
  </parameter>
633
641
  <parameter name="marshal_data"
634
642
  transfer-ownership="none"
635
643
  nullable="1"
636
644
  allow-none="1">
637
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
645
+ <doc xml:space="preserve">Additional data specified when registering the
646
+ marshaller, see g_closure_set_marshal() and
647
+ g_closure_set_meta_marshal()</doc>
638
648
  <type name="gpointer" c:type="gpointer"/>
639
649
  </parameter>
640
650
  </parameters>
@@ -692,41 +702,45 @@ denotes a flags type.</doc>
692
702
  </function>
693
703
  <function name="marshal_VOID__BOOLEAN"
694
704
  c:identifier="g_cclosure_marshal_VOID__BOOLEAN">
695
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
696
- `void (*callback) (gpointer instance, gboolean arg1, gpointer user_data)`.</doc>
705
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
706
+ boolean argument.</doc>
697
707
  <return-value transfer-ownership="none">
698
708
  <type name="none" c:type="void"/>
699
709
  </return-value>
700
710
  <parameters>
701
711
  <parameter name="closure" transfer-ownership="none">
702
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
712
+ <doc xml:space="preserve">A #GClosure.</doc>
703
713
  <type name="Closure" c:type="GClosure*"/>
704
714
  </parameter>
705
715
  <parameter name="return_value" transfer-ownership="none">
706
- <doc xml:space="preserve">ignored</doc>
716
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
717
+ if the callback of closure doesn't return a value.</doc>
707
718
  <type name="Value" c:type="GValue*"/>
708
719
  </parameter>
709
720
  <parameter name="n_param_values" transfer-ownership="none">
710
- <doc xml:space="preserve">2</doc>
721
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
711
722
  <type name="guint" c:type="guint"/>
712
723
  </parameter>
713
724
  <parameter name="param_values" transfer-ownership="none">
714
- <doc xml:space="preserve">a #GValue array holding the instance and the #gboolean parameter</doc>
725
+ <doc xml:space="preserve">An array of #GValues holding the arguments
726
+ on which to invoke the callback of closure.</doc>
715
727
  <type name="Value" c:type="const GValue*"/>
716
728
  </parameter>
717
729
  <parameter name="invocation_hint"
718
730
  transfer-ownership="none"
719
731
  nullable="1"
720
732
  allow-none="1">
721
- <doc xml:space="preserve">the invocation hint given as the last argument
722
- to g_closure_invoke()</doc>
733
+ <doc xml:space="preserve">The invocation hint given as the last argument to
734
+ g_closure_invoke().</doc>
723
735
  <type name="gpointer" c:type="gpointer"/>
724
736
  </parameter>
725
737
  <parameter name="marshal_data"
726
738
  transfer-ownership="none"
727
739
  nullable="1"
728
740
  allow-none="1">
729
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
741
+ <doc xml:space="preserve">Additional data specified when registering the
742
+ marshaller, see g_closure_set_marshal() and
743
+ g_closure_set_meta_marshal()</doc>
730
744
  <type name="gpointer" c:type="gpointer"/>
731
745
  </parameter>
732
746
  </parameters>
@@ -784,41 +798,45 @@ denotes a flags type.</doc>
784
798
  </function>
785
799
  <function name="marshal_VOID__BOXED"
786
800
  c:identifier="g_cclosure_marshal_VOID__BOXED">
787
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
788
- `void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data)`.</doc>
801
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
802
+ argument which is any boxed pointer type.</doc>
789
803
  <return-value transfer-ownership="none">
790
804
  <type name="none" c:type="void"/>
791
805
  </return-value>
792
806
  <parameters>
793
807
  <parameter name="closure" transfer-ownership="none">
794
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
808
+ <doc xml:space="preserve">A #GClosure.</doc>
795
809
  <type name="Closure" c:type="GClosure*"/>
796
810
  </parameter>
797
811
  <parameter name="return_value" transfer-ownership="none">
798
- <doc xml:space="preserve">ignored</doc>
812
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
813
+ if the callback of closure doesn't return a value.</doc>
799
814
  <type name="Value" c:type="GValue*"/>
800
815
  </parameter>
801
816
  <parameter name="n_param_values" transfer-ownership="none">
802
- <doc xml:space="preserve">2</doc>
817
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
803
818
  <type name="guint" c:type="guint"/>
804
819
  </parameter>
805
820
  <parameter name="param_values" transfer-ownership="none">
806
- <doc xml:space="preserve">a #GValue array holding the instance and the #GBoxed* parameter</doc>
821
+ <doc xml:space="preserve">An array of #GValues holding the arguments
822
+ on which to invoke the callback of closure.</doc>
807
823
  <type name="Value" c:type="const GValue*"/>
808
824
  </parameter>
809
825
  <parameter name="invocation_hint"
810
826
  transfer-ownership="none"
811
827
  nullable="1"
812
828
  allow-none="1">
813
- <doc xml:space="preserve">the invocation hint given as the last argument
814
- to g_closure_invoke()</doc>
829
+ <doc xml:space="preserve">The invocation hint given as the last argument to
830
+ g_closure_invoke().</doc>
815
831
  <type name="gpointer" c:type="gpointer"/>
816
832
  </parameter>
817
833
  <parameter name="marshal_data"
818
834
  transfer-ownership="none"
819
835
  nullable="1"
820
836
  allow-none="1">
821
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
837
+ <doc xml:space="preserve">Additional data specified when registering the
838
+ marshaller, see g_closure_set_marshal() and
839
+ g_closure_set_meta_marshal()</doc>
822
840
  <type name="gpointer" c:type="gpointer"/>
823
841
  </parameter>
824
842
  </parameters>
@@ -876,41 +894,45 @@ denotes a flags type.</doc>
876
894
  </function>
877
895
  <function name="marshal_VOID__CHAR"
878
896
  c:identifier="g_cclosure_marshal_VOID__CHAR">
879
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
880
- `void (*callback) (gpointer instance, gchar arg1, gpointer user_data)`.</doc>
897
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
898
+ character argument.</doc>
881
899
  <return-value transfer-ownership="none">
882
900
  <type name="none" c:type="void"/>
883
901
  </return-value>
884
902
  <parameters>
885
903
  <parameter name="closure" transfer-ownership="none">
886
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
904
+ <doc xml:space="preserve">A #GClosure.</doc>
887
905
  <type name="Closure" c:type="GClosure*"/>
888
906
  </parameter>
889
907
  <parameter name="return_value" transfer-ownership="none">
890
- <doc xml:space="preserve">ignored</doc>
908
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
909
+ if the callback of closure doesn't return a value.</doc>
891
910
  <type name="Value" c:type="GValue*"/>
892
911
  </parameter>
893
912
  <parameter name="n_param_values" transfer-ownership="none">
894
- <doc xml:space="preserve">2</doc>
913
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
895
914
  <type name="guint" c:type="guint"/>
896
915
  </parameter>
897
916
  <parameter name="param_values" transfer-ownership="none">
898
- <doc xml:space="preserve">a #GValue array holding the instance and the #gchar parameter</doc>
917
+ <doc xml:space="preserve">An array of #GValues holding the arguments
918
+ on which to invoke the callback of closure.</doc>
899
919
  <type name="Value" c:type="const GValue*"/>
900
920
  </parameter>
901
921
  <parameter name="invocation_hint"
902
922
  transfer-ownership="none"
903
923
  nullable="1"
904
924
  allow-none="1">
905
- <doc xml:space="preserve">the invocation hint given as the last argument
906
- to g_closure_invoke()</doc>
925
+ <doc xml:space="preserve">The invocation hint given as the last argument to
926
+ g_closure_invoke().</doc>
907
927
  <type name="gpointer" c:type="gpointer"/>
908
928
  </parameter>
909
929
  <parameter name="marshal_data"
910
930
  transfer-ownership="none"
911
931
  nullable="1"
912
932
  allow-none="1">
913
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
933
+ <doc xml:space="preserve">Additional data specified when registering the
934
+ marshaller, see g_closure_set_marshal() and
935
+ g_closure_set_meta_marshal()</doc>
914
936
  <type name="gpointer" c:type="gpointer"/>
915
937
  </parameter>
916
938
  </parameters>
@@ -968,41 +990,45 @@ denotes a flags type.</doc>
968
990
  </function>
969
991
  <function name="marshal_VOID__DOUBLE"
970
992
  c:identifier="g_cclosure_marshal_VOID__DOUBLE">
971
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
972
- `void (*callback) (gpointer instance, gdouble arg1, gpointer user_data)`.</doc>
993
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with one
994
+ double-precision floating point argument.</doc>
973
995
  <return-value transfer-ownership="none">
974
996
  <type name="none" c:type="void"/>
975
997
  </return-value>
976
998
  <parameters>
977
999
  <parameter name="closure" transfer-ownership="none">
978
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1000
+ <doc xml:space="preserve">A #GClosure.</doc>
979
1001
  <type name="Closure" c:type="GClosure*"/>
980
1002
  </parameter>
981
1003
  <parameter name="return_value" transfer-ownership="none">
982
- <doc xml:space="preserve">ignored</doc>
1004
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1005
+ if the callback of closure doesn't return a value.</doc>
983
1006
  <type name="Value" c:type="GValue*"/>
984
1007
  </parameter>
985
1008
  <parameter name="n_param_values" transfer-ownership="none">
986
- <doc xml:space="preserve">2</doc>
1009
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
987
1010
  <type name="guint" c:type="guint"/>
988
1011
  </parameter>
989
1012
  <parameter name="param_values" transfer-ownership="none">
990
- <doc xml:space="preserve">a #GValue array holding the instance and the #gdouble parameter</doc>
1013
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1014
+ on which to invoke the callback of closure.</doc>
991
1015
  <type name="Value" c:type="const GValue*"/>
992
1016
  </parameter>
993
1017
  <parameter name="invocation_hint"
994
1018
  transfer-ownership="none"
995
1019
  nullable="1"
996
1020
  allow-none="1">
997
- <doc xml:space="preserve">the invocation hint given as the last argument
998
- to g_closure_invoke()</doc>
1021
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1022
+ g_closure_invoke().</doc>
999
1023
  <type name="gpointer" c:type="gpointer"/>
1000
1024
  </parameter>
1001
1025
  <parameter name="marshal_data"
1002
1026
  transfer-ownership="none"
1003
1027
  nullable="1"
1004
1028
  allow-none="1">
1005
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1029
+ <doc xml:space="preserve">Additional data specified when registering the
1030
+ marshaller, see g_closure_set_marshal() and
1031
+ g_closure_set_meta_marshal()</doc>
1006
1032
  <type name="gpointer" c:type="gpointer"/>
1007
1033
  </parameter>
1008
1034
  </parameters>
@@ -1060,41 +1086,45 @@ denotes a flags type.</doc>
1060
1086
  </function>
1061
1087
  <function name="marshal_VOID__ENUM"
1062
1088
  c:identifier="g_cclosure_marshal_VOID__ENUM">
1063
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1064
- `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes an enumeration type..</doc>
1089
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
1090
+ argument with an enumerated type.</doc>
1065
1091
  <return-value transfer-ownership="none">
1066
1092
  <type name="none" c:type="void"/>
1067
1093
  </return-value>
1068
1094
  <parameters>
1069
1095
  <parameter name="closure" transfer-ownership="none">
1070
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1096
+ <doc xml:space="preserve">A #GClosure.</doc>
1071
1097
  <type name="Closure" c:type="GClosure*"/>
1072
1098
  </parameter>
1073
1099
  <parameter name="return_value" transfer-ownership="none">
1074
- <doc xml:space="preserve">ignored</doc>
1100
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1101
+ if the callback of closure doesn't return a value.</doc>
1075
1102
  <type name="Value" c:type="GValue*"/>
1076
1103
  </parameter>
1077
1104
  <parameter name="n_param_values" transfer-ownership="none">
1078
- <doc xml:space="preserve">2</doc>
1105
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1079
1106
  <type name="guint" c:type="guint"/>
1080
1107
  </parameter>
1081
1108
  <parameter name="param_values" transfer-ownership="none">
1082
- <doc xml:space="preserve">a #GValue array holding the instance and the enumeration parameter</doc>
1109
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1110
+ on which to invoke the callback of closure.</doc>
1083
1111
  <type name="Value" c:type="const GValue*"/>
1084
1112
  </parameter>
1085
1113
  <parameter name="invocation_hint"
1086
1114
  transfer-ownership="none"
1087
1115
  nullable="1"
1088
1116
  allow-none="1">
1089
- <doc xml:space="preserve">the invocation hint given as the last argument
1090
- to g_closure_invoke()</doc>
1117
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1118
+ g_closure_invoke().</doc>
1091
1119
  <type name="gpointer" c:type="gpointer"/>
1092
1120
  </parameter>
1093
1121
  <parameter name="marshal_data"
1094
1122
  transfer-ownership="none"
1095
1123
  nullable="1"
1096
1124
  allow-none="1">
1097
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1125
+ <doc xml:space="preserve">Additional data specified when registering the
1126
+ marshaller, see g_closure_set_marshal() and
1127
+ g_closure_set_meta_marshal()</doc>
1098
1128
  <type name="gpointer" c:type="gpointer"/>
1099
1129
  </parameter>
1100
1130
  </parameters>
@@ -1152,41 +1182,45 @@ denotes a flags type.</doc>
1152
1182
  </function>
1153
1183
  <function name="marshal_VOID__FLAGS"
1154
1184
  c:identifier="g_cclosure_marshal_VOID__FLAGS">
1155
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1156
- `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes a flags type.</doc>
1185
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
1186
+ argument with a flags types.</doc>
1157
1187
  <return-value transfer-ownership="none">
1158
1188
  <type name="none" c:type="void"/>
1159
1189
  </return-value>
1160
1190
  <parameters>
1161
1191
  <parameter name="closure" transfer-ownership="none">
1162
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1192
+ <doc xml:space="preserve">A #GClosure.</doc>
1163
1193
  <type name="Closure" c:type="GClosure*"/>
1164
1194
  </parameter>
1165
1195
  <parameter name="return_value" transfer-ownership="none">
1166
- <doc xml:space="preserve">ignored</doc>
1196
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1197
+ if the callback of closure doesn't return a value.</doc>
1167
1198
  <type name="Value" c:type="GValue*"/>
1168
1199
  </parameter>
1169
1200
  <parameter name="n_param_values" transfer-ownership="none">
1170
- <doc xml:space="preserve">2</doc>
1201
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1171
1202
  <type name="guint" c:type="guint"/>
1172
1203
  </parameter>
1173
1204
  <parameter name="param_values" transfer-ownership="none">
1174
- <doc xml:space="preserve">a #GValue array holding the instance and the flags parameter</doc>
1205
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1206
+ on which to invoke the callback of closure.</doc>
1175
1207
  <type name="Value" c:type="const GValue*"/>
1176
1208
  </parameter>
1177
1209
  <parameter name="invocation_hint"
1178
1210
  transfer-ownership="none"
1179
1211
  nullable="1"
1180
1212
  allow-none="1">
1181
- <doc xml:space="preserve">the invocation hint given as the last argument
1182
- to g_closure_invoke()</doc>
1213
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1214
+ g_closure_invoke().</doc>
1183
1215
  <type name="gpointer" c:type="gpointer"/>
1184
1216
  </parameter>
1185
1217
  <parameter name="marshal_data"
1186
1218
  transfer-ownership="none"
1187
1219
  nullable="1"
1188
1220
  allow-none="1">
1189
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1221
+ <doc xml:space="preserve">Additional data specified when registering the
1222
+ marshaller, see g_closure_set_marshal() and
1223
+ g_closure_set_meta_marshal()</doc>
1190
1224
  <type name="gpointer" c:type="gpointer"/>
1191
1225
  </parameter>
1192
1226
  </parameters>
@@ -1244,41 +1278,45 @@ denotes a flags type.</doc>
1244
1278
  </function>
1245
1279
  <function name="marshal_VOID__FLOAT"
1246
1280
  c:identifier="g_cclosure_marshal_VOID__FLOAT">
1247
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1248
- `void (*callback) (gpointer instance, gfloat arg1, gpointer user_data)`.</doc>
1281
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with one
1282
+ single-precision floating point argument.</doc>
1249
1283
  <return-value transfer-ownership="none">
1250
1284
  <type name="none" c:type="void"/>
1251
1285
  </return-value>
1252
1286
  <parameters>
1253
1287
  <parameter name="closure" transfer-ownership="none">
1254
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1288
+ <doc xml:space="preserve">A #GClosure.</doc>
1255
1289
  <type name="Closure" c:type="GClosure*"/>
1256
1290
  </parameter>
1257
1291
  <parameter name="return_value" transfer-ownership="none">
1258
- <doc xml:space="preserve">ignored</doc>
1292
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1293
+ if the callback of closure doesn't return a value.</doc>
1259
1294
  <type name="Value" c:type="GValue*"/>
1260
1295
  </parameter>
1261
1296
  <parameter name="n_param_values" transfer-ownership="none">
1262
- <doc xml:space="preserve">2</doc>
1297
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1263
1298
  <type name="guint" c:type="guint"/>
1264
1299
  </parameter>
1265
1300
  <parameter name="param_values" transfer-ownership="none">
1266
- <doc xml:space="preserve">a #GValue array holding the instance and the #gfloat parameter</doc>
1301
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1302
+ on which to invoke the callback of closure.</doc>
1267
1303
  <type name="Value" c:type="const GValue*"/>
1268
1304
  </parameter>
1269
1305
  <parameter name="invocation_hint"
1270
1306
  transfer-ownership="none"
1271
1307
  nullable="1"
1272
1308
  allow-none="1">
1273
- <doc xml:space="preserve">the invocation hint given as the last argument
1274
- to g_closure_invoke()</doc>
1309
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1310
+ g_closure_invoke().</doc>
1275
1311
  <type name="gpointer" c:type="gpointer"/>
1276
1312
  </parameter>
1277
1313
  <parameter name="marshal_data"
1278
1314
  transfer-ownership="none"
1279
1315
  nullable="1"
1280
1316
  allow-none="1">
1281
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1317
+ <doc xml:space="preserve">Additional data specified when registering the
1318
+ marshaller, see g_closure_set_marshal() and
1319
+ g_closure_set_meta_marshal()</doc>
1282
1320
  <type name="gpointer" c:type="gpointer"/>
1283
1321
  </parameter>
1284
1322
  </parameters>
@@ -1336,41 +1374,45 @@ denotes a flags type.</doc>
1336
1374
  </function>
1337
1375
  <function name="marshal_VOID__INT"
1338
1376
  c:identifier="g_cclosure_marshal_VOID__INT">
1339
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1340
- `void (*callback) (gpointer instance, gint arg1, gpointer user_data)`.</doc>
1377
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
1378
+ integer argument.</doc>
1341
1379
  <return-value transfer-ownership="none">
1342
1380
  <type name="none" c:type="void"/>
1343
1381
  </return-value>
1344
1382
  <parameters>
1345
1383
  <parameter name="closure" transfer-ownership="none">
1346
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1384
+ <doc xml:space="preserve">A #GClosure.</doc>
1347
1385
  <type name="Closure" c:type="GClosure*"/>
1348
1386
  </parameter>
1349
1387
  <parameter name="return_value" transfer-ownership="none">
1350
- <doc xml:space="preserve">ignored</doc>
1388
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1389
+ if the callback of closure doesn't return a value.</doc>
1351
1390
  <type name="Value" c:type="GValue*"/>
1352
1391
  </parameter>
1353
1392
  <parameter name="n_param_values" transfer-ownership="none">
1354
- <doc xml:space="preserve">2</doc>
1393
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1355
1394
  <type name="guint" c:type="guint"/>
1356
1395
  </parameter>
1357
1396
  <parameter name="param_values" transfer-ownership="none">
1358
- <doc xml:space="preserve">a #GValue array holding the instance and the #gint parameter</doc>
1397
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1398
+ on which to invoke the callback of closure.</doc>
1359
1399
  <type name="Value" c:type="const GValue*"/>
1360
1400
  </parameter>
1361
1401
  <parameter name="invocation_hint"
1362
1402
  transfer-ownership="none"
1363
1403
  nullable="1"
1364
1404
  allow-none="1">
1365
- <doc xml:space="preserve">the invocation hint given as the last argument
1366
- to g_closure_invoke()</doc>
1405
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1406
+ g_closure_invoke().</doc>
1367
1407
  <type name="gpointer" c:type="gpointer"/>
1368
1408
  </parameter>
1369
1409
  <parameter name="marshal_data"
1370
1410
  transfer-ownership="none"
1371
1411
  nullable="1"
1372
1412
  allow-none="1">
1373
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1413
+ <doc xml:space="preserve">Additional data specified when registering the
1414
+ marshaller, see g_closure_set_marshal() and
1415
+ g_closure_set_meta_marshal()</doc>
1374
1416
  <type name="gpointer" c:type="gpointer"/>
1375
1417
  </parameter>
1376
1418
  </parameters>
@@ -1428,41 +1470,45 @@ denotes a flags type.</doc>
1428
1470
  </function>
1429
1471
  <function name="marshal_VOID__LONG"
1430
1472
  c:identifier="g_cclosure_marshal_VOID__LONG">
1431
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1432
- `void (*callback) (gpointer instance, glong arg1, gpointer user_data)`.</doc>
1473
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with with a single
1474
+ long integer argument.</doc>
1433
1475
  <return-value transfer-ownership="none">
1434
1476
  <type name="none" c:type="void"/>
1435
1477
  </return-value>
1436
1478
  <parameters>
1437
1479
  <parameter name="closure" transfer-ownership="none">
1438
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1480
+ <doc xml:space="preserve">A #GClosure.</doc>
1439
1481
  <type name="Closure" c:type="GClosure*"/>
1440
1482
  </parameter>
1441
1483
  <parameter name="return_value" transfer-ownership="none">
1442
- <doc xml:space="preserve">ignored</doc>
1484
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1485
+ if the callback of closure doesn't return a value.</doc>
1443
1486
  <type name="Value" c:type="GValue*"/>
1444
1487
  </parameter>
1445
1488
  <parameter name="n_param_values" transfer-ownership="none">
1446
- <doc xml:space="preserve">2</doc>
1489
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1447
1490
  <type name="guint" c:type="guint"/>
1448
1491
  </parameter>
1449
1492
  <parameter name="param_values" transfer-ownership="none">
1450
- <doc xml:space="preserve">a #GValue array holding the instance and the #glong parameter</doc>
1493
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1494
+ on which to invoke the callback of closure.</doc>
1451
1495
  <type name="Value" c:type="const GValue*"/>
1452
1496
  </parameter>
1453
1497
  <parameter name="invocation_hint"
1454
1498
  transfer-ownership="none"
1455
1499
  nullable="1"
1456
1500
  allow-none="1">
1457
- <doc xml:space="preserve">the invocation hint given as the last argument
1458
- to g_closure_invoke()</doc>
1501
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1502
+ g_closure_invoke().</doc>
1459
1503
  <type name="gpointer" c:type="gpointer"/>
1460
1504
  </parameter>
1461
1505
  <parameter name="marshal_data"
1462
1506
  transfer-ownership="none"
1463
1507
  nullable="1"
1464
1508
  allow-none="1">
1465
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1509
+ <doc xml:space="preserve">Additional data specified when registering the
1510
+ marshaller, see g_closure_set_marshal() and
1511
+ g_closure_set_meta_marshal()</doc>
1466
1512
  <type name="gpointer" c:type="gpointer"/>
1467
1513
  </parameter>
1468
1514
  </parameters>
@@ -1520,41 +1566,45 @@ denotes a flags type.</doc>
1520
1566
  </function>
1521
1567
  <function name="marshal_VOID__OBJECT"
1522
1568
  c:identifier="g_cclosure_marshal_VOID__OBJECT">
1523
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1524
- `void (*callback) (gpointer instance, GObject *arg1, gpointer user_data)`.</doc>
1569
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
1570
+ #GObject argument.</doc>
1525
1571
  <return-value transfer-ownership="none">
1526
1572
  <type name="none" c:type="void"/>
1527
1573
  </return-value>
1528
1574
  <parameters>
1529
1575
  <parameter name="closure" transfer-ownership="none">
1530
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1576
+ <doc xml:space="preserve">A #GClosure.</doc>
1531
1577
  <type name="Closure" c:type="GClosure*"/>
1532
1578
  </parameter>
1533
1579
  <parameter name="return_value" transfer-ownership="none">
1534
- <doc xml:space="preserve">ignored</doc>
1580
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1581
+ if the callback of closure doesn't return a value.</doc>
1535
1582
  <type name="Value" c:type="GValue*"/>
1536
1583
  </parameter>
1537
1584
  <parameter name="n_param_values" transfer-ownership="none">
1538
- <doc xml:space="preserve">2</doc>
1585
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1539
1586
  <type name="guint" c:type="guint"/>
1540
1587
  </parameter>
1541
1588
  <parameter name="param_values" transfer-ownership="none">
1542
- <doc xml:space="preserve">a #GValue array holding the instance and the #GObject* parameter</doc>
1589
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1590
+ on which to invoke the callback of closure.</doc>
1543
1591
  <type name="Value" c:type="const GValue*"/>
1544
1592
  </parameter>
1545
1593
  <parameter name="invocation_hint"
1546
1594
  transfer-ownership="none"
1547
1595
  nullable="1"
1548
1596
  allow-none="1">
1549
- <doc xml:space="preserve">the invocation hint given as the last argument
1550
- to g_closure_invoke()</doc>
1597
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1598
+ g_closure_invoke().</doc>
1551
1599
  <type name="gpointer" c:type="gpointer"/>
1552
1600
  </parameter>
1553
1601
  <parameter name="marshal_data"
1554
1602
  transfer-ownership="none"
1555
1603
  nullable="1"
1556
1604
  allow-none="1">
1557
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1605
+ <doc xml:space="preserve">Additional data specified when registering the
1606
+ marshaller, see g_closure_set_marshal() and
1607
+ g_closure_set_meta_marshal()</doc>
1558
1608
  <type name="gpointer" c:type="gpointer"/>
1559
1609
  </parameter>
1560
1610
  </parameters>
@@ -1612,41 +1662,45 @@ denotes a flags type.</doc>
1612
1662
  </function>
1613
1663
  <function name="marshal_VOID__PARAM"
1614
1664
  c:identifier="g_cclosure_marshal_VOID__PARAM">
1615
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1616
- `void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data)`.</doc>
1665
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
1666
+ argument of type #GParamSpec.</doc>
1617
1667
  <return-value transfer-ownership="none">
1618
1668
  <type name="none" c:type="void"/>
1619
1669
  </return-value>
1620
1670
  <parameters>
1621
1671
  <parameter name="closure" transfer-ownership="none">
1622
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1672
+ <doc xml:space="preserve">A #GClosure.</doc>
1623
1673
  <type name="Closure" c:type="GClosure*"/>
1624
1674
  </parameter>
1625
1675
  <parameter name="return_value" transfer-ownership="none">
1626
- <doc xml:space="preserve">ignored</doc>
1676
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1677
+ if the callback of closure doesn't return a value.</doc>
1627
1678
  <type name="Value" c:type="GValue*"/>
1628
1679
  </parameter>
1629
1680
  <parameter name="n_param_values" transfer-ownership="none">
1630
- <doc xml:space="preserve">2</doc>
1681
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1631
1682
  <type name="guint" c:type="guint"/>
1632
1683
  </parameter>
1633
1684
  <parameter name="param_values" transfer-ownership="none">
1634
- <doc xml:space="preserve">a #GValue array holding the instance and the #GParamSpec* parameter</doc>
1685
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1686
+ on which to invoke the callback of closure.</doc>
1635
1687
  <type name="Value" c:type="const GValue*"/>
1636
1688
  </parameter>
1637
1689
  <parameter name="invocation_hint"
1638
1690
  transfer-ownership="none"
1639
1691
  nullable="1"
1640
1692
  allow-none="1">
1641
- <doc xml:space="preserve">the invocation hint given as the last argument
1642
- to g_closure_invoke()</doc>
1693
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1694
+ g_closure_invoke().</doc>
1643
1695
  <type name="gpointer" c:type="gpointer"/>
1644
1696
  </parameter>
1645
1697
  <parameter name="marshal_data"
1646
1698
  transfer-ownership="none"
1647
1699
  nullable="1"
1648
1700
  allow-none="1">
1649
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1701
+ <doc xml:space="preserve">Additional data specified when registering the
1702
+ marshaller, see g_closure_set_marshal() and
1703
+ g_closure_set_meta_marshal()</doc>
1650
1704
  <type name="gpointer" c:type="gpointer"/>
1651
1705
  </parameter>
1652
1706
  </parameters>
@@ -1704,41 +1758,49 @@ denotes a flags type.</doc>
1704
1758
  </function>
1705
1759
  <function name="marshal_VOID__POINTER"
1706
1760
  c:identifier="g_cclosure_marshal_VOID__POINTER">
1707
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1708
- `void (*callback) (gpointer instance, gpointer arg1, gpointer user_data)`.</doc>
1761
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single raw
1762
+ pointer argument type.
1763
+
1764
+ If it is possible, it is better to use one of the more specific
1765
+ functions such as g_cclosure_marshal_VOID__OBJECT() or
1766
+ g_cclosure_marshal_VOID__OBJECT().</doc>
1709
1767
  <return-value transfer-ownership="none">
1710
1768
  <type name="none" c:type="void"/>
1711
1769
  </return-value>
1712
1770
  <parameters>
1713
1771
  <parameter name="closure" transfer-ownership="none">
1714
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1772
+ <doc xml:space="preserve">A #GClosure.</doc>
1715
1773
  <type name="Closure" c:type="GClosure*"/>
1716
1774
  </parameter>
1717
1775
  <parameter name="return_value" transfer-ownership="none">
1718
- <doc xml:space="preserve">ignored</doc>
1776
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1777
+ if the callback of closure doesn't return a value.</doc>
1719
1778
  <type name="Value" c:type="GValue*"/>
1720
1779
  </parameter>
1721
1780
  <parameter name="n_param_values" transfer-ownership="none">
1722
- <doc xml:space="preserve">2</doc>
1781
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1723
1782
  <type name="guint" c:type="guint"/>
1724
1783
  </parameter>
1725
1784
  <parameter name="param_values" transfer-ownership="none">
1726
- <doc xml:space="preserve">a #GValue array holding the instance and the #gpointer parameter</doc>
1785
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1786
+ on which to invoke the callback of closure.</doc>
1727
1787
  <type name="Value" c:type="const GValue*"/>
1728
1788
  </parameter>
1729
1789
  <parameter name="invocation_hint"
1730
1790
  transfer-ownership="none"
1731
1791
  nullable="1"
1732
1792
  allow-none="1">
1733
- <doc xml:space="preserve">the invocation hint given as the last argument
1734
- to g_closure_invoke()</doc>
1793
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1794
+ g_closure_invoke().</doc>
1735
1795
  <type name="gpointer" c:type="gpointer"/>
1736
1796
  </parameter>
1737
1797
  <parameter name="marshal_data"
1738
1798
  transfer-ownership="none"
1739
1799
  nullable="1"
1740
1800
  allow-none="1">
1741
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1801
+ <doc xml:space="preserve">Additional data specified when registering the
1802
+ marshaller, see g_closure_set_marshal() and
1803
+ g_closure_set_meta_marshal()</doc>
1742
1804
  <type name="gpointer" c:type="gpointer"/>
1743
1805
  </parameter>
1744
1806
  </parameters>
@@ -1796,41 +1858,45 @@ denotes a flags type.</doc>
1796
1858
  </function>
1797
1859
  <function name="marshal_VOID__STRING"
1798
1860
  c:identifier="g_cclosure_marshal_VOID__STRING">
1799
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1800
- `void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data)`.</doc>
1861
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single string
1862
+ argument.</doc>
1801
1863
  <return-value transfer-ownership="none">
1802
1864
  <type name="none" c:type="void"/>
1803
1865
  </return-value>
1804
1866
  <parameters>
1805
1867
  <parameter name="closure" transfer-ownership="none">
1806
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1868
+ <doc xml:space="preserve">A #GClosure.</doc>
1807
1869
  <type name="Closure" c:type="GClosure*"/>
1808
1870
  </parameter>
1809
1871
  <parameter name="return_value" transfer-ownership="none">
1810
- <doc xml:space="preserve">ignored</doc>
1872
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1873
+ if the callback of closure doesn't return a value.</doc>
1811
1874
  <type name="Value" c:type="GValue*"/>
1812
1875
  </parameter>
1813
1876
  <parameter name="n_param_values" transfer-ownership="none">
1814
- <doc xml:space="preserve">2</doc>
1877
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1815
1878
  <type name="guint" c:type="guint"/>
1816
1879
  </parameter>
1817
1880
  <parameter name="param_values" transfer-ownership="none">
1818
- <doc xml:space="preserve">a #GValue array holding the instance and the #gchar* parameter</doc>
1881
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1882
+ on which to invoke the callback of closure.</doc>
1819
1883
  <type name="Value" c:type="const GValue*"/>
1820
1884
  </parameter>
1821
1885
  <parameter name="invocation_hint"
1822
1886
  transfer-ownership="none"
1823
1887
  nullable="1"
1824
1888
  allow-none="1">
1825
- <doc xml:space="preserve">the invocation hint given as the last argument
1826
- to g_closure_invoke()</doc>
1889
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1890
+ g_closure_invoke().</doc>
1827
1891
  <type name="gpointer" c:type="gpointer"/>
1828
1892
  </parameter>
1829
1893
  <parameter name="marshal_data"
1830
1894
  transfer-ownership="none"
1831
1895
  nullable="1"
1832
1896
  allow-none="1">
1833
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1897
+ <doc xml:space="preserve">Additional data specified when registering the
1898
+ marshaller, see g_closure_set_marshal() and
1899
+ g_closure_set_meta_marshal()</doc>
1834
1900
  <type name="gpointer" c:type="gpointer"/>
1835
1901
  </parameter>
1836
1902
  </parameters>
@@ -1888,41 +1954,45 @@ denotes a flags type.</doc>
1888
1954
  </function>
1889
1955
  <function name="marshal_VOID__UCHAR"
1890
1956
  c:identifier="g_cclosure_marshal_VOID__UCHAR">
1891
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1892
- `void (*callback) (gpointer instance, guchar arg1, gpointer user_data)`.</doc>
1957
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
1958
+ unsigned character argument.</doc>
1893
1959
  <return-value transfer-ownership="none">
1894
1960
  <type name="none" c:type="void"/>
1895
1961
  </return-value>
1896
1962
  <parameters>
1897
1963
  <parameter name="closure" transfer-ownership="none">
1898
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
1964
+ <doc xml:space="preserve">A #GClosure.</doc>
1899
1965
  <type name="Closure" c:type="GClosure*"/>
1900
1966
  </parameter>
1901
1967
  <parameter name="return_value" transfer-ownership="none">
1902
- <doc xml:space="preserve">ignored</doc>
1968
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
1969
+ if the callback of closure doesn't return a value.</doc>
1903
1970
  <type name="Value" c:type="GValue*"/>
1904
1971
  </parameter>
1905
1972
  <parameter name="n_param_values" transfer-ownership="none">
1906
- <doc xml:space="preserve">2</doc>
1973
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1907
1974
  <type name="guint" c:type="guint"/>
1908
1975
  </parameter>
1909
1976
  <parameter name="param_values" transfer-ownership="none">
1910
- <doc xml:space="preserve">a #GValue array holding the instance and the #guchar parameter</doc>
1977
+ <doc xml:space="preserve">An array of #GValues holding the arguments
1978
+ on which to invoke the callback of closure.</doc>
1911
1979
  <type name="Value" c:type="const GValue*"/>
1912
1980
  </parameter>
1913
1981
  <parameter name="invocation_hint"
1914
1982
  transfer-ownership="none"
1915
1983
  nullable="1"
1916
1984
  allow-none="1">
1917
- <doc xml:space="preserve">the invocation hint given as the last argument
1918
- to g_closure_invoke()</doc>
1985
+ <doc xml:space="preserve">The invocation hint given as the last argument to
1986
+ g_closure_invoke().</doc>
1919
1987
  <type name="gpointer" c:type="gpointer"/>
1920
1988
  </parameter>
1921
1989
  <parameter name="marshal_data"
1922
1990
  transfer-ownership="none"
1923
1991
  nullable="1"
1924
1992
  allow-none="1">
1925
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
1993
+ <doc xml:space="preserve">Additional data specified when registering the
1994
+ marshaller, see g_closure_set_marshal() and
1995
+ g_closure_set_meta_marshal()</doc>
1926
1996
  <type name="gpointer" c:type="gpointer"/>
1927
1997
  </parameter>
1928
1998
  </parameters>
@@ -1980,82 +2050,90 @@ denotes a flags type.</doc>
1980
2050
  </function>
1981
2051
  <function name="marshal_VOID__UINT"
1982
2052
  c:identifier="g_cclosure_marshal_VOID__UINT">
1983
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
1984
- `void (*callback) (gpointer instance, guint arg1, gpointer user_data)`.</doc>
2053
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with with a single
2054
+ unsigned integer argument.</doc>
1985
2055
  <return-value transfer-ownership="none">
1986
2056
  <type name="none" c:type="void"/>
1987
2057
  </return-value>
1988
2058
  <parameters>
1989
2059
  <parameter name="closure" transfer-ownership="none">
1990
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
2060
+ <doc xml:space="preserve">A #GClosure.</doc>
1991
2061
  <type name="Closure" c:type="GClosure*"/>
1992
2062
  </parameter>
1993
2063
  <parameter name="return_value" transfer-ownership="none">
1994
- <doc xml:space="preserve">ignored</doc>
2064
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
2065
+ if the callback of closure doesn't return a value.</doc>
1995
2066
  <type name="Value" c:type="GValue*"/>
1996
2067
  </parameter>
1997
2068
  <parameter name="n_param_values" transfer-ownership="none">
1998
- <doc xml:space="preserve">2</doc>
2069
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
1999
2070
  <type name="guint" c:type="guint"/>
2000
2071
  </parameter>
2001
2072
  <parameter name="param_values" transfer-ownership="none">
2002
- <doc xml:space="preserve">a #GValue array holding the instance and the #guint parameter</doc>
2073
+ <doc xml:space="preserve">An array of #GValues holding the arguments
2074
+ on which to invoke the callback of closure.</doc>
2003
2075
  <type name="Value" c:type="const GValue*"/>
2004
2076
  </parameter>
2005
2077
  <parameter name="invocation_hint"
2006
2078
  transfer-ownership="none"
2007
2079
  nullable="1"
2008
2080
  allow-none="1">
2009
- <doc xml:space="preserve">the invocation hint given as the last argument
2010
- to g_closure_invoke()</doc>
2081
+ <doc xml:space="preserve">The invocation hint given as the last argument to
2082
+ g_closure_invoke().</doc>
2011
2083
  <type name="gpointer" c:type="gpointer"/>
2012
2084
  </parameter>
2013
2085
  <parameter name="marshal_data"
2014
2086
  transfer-ownership="none"
2015
2087
  nullable="1"
2016
2088
  allow-none="1">
2017
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
2089
+ <doc xml:space="preserve">Additional data specified when registering the
2090
+ marshaller, see g_closure_set_marshal() and
2091
+ g_closure_set_meta_marshal()</doc>
2018
2092
  <type name="gpointer" c:type="gpointer"/>
2019
2093
  </parameter>
2020
2094
  </parameters>
2021
2095
  </function>
2022
2096
  <function name="marshal_VOID__UINT_POINTER"
2023
2097
  c:identifier="g_cclosure_marshal_VOID__UINT_POINTER">
2024
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
2025
- `void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data)`.</doc>
2098
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a unsigned int
2099
+ and a pointer as arguments.</doc>
2026
2100
  <return-value transfer-ownership="none">
2027
2101
  <type name="none" c:type="void"/>
2028
2102
  </return-value>
2029
2103
  <parameters>
2030
2104
  <parameter name="closure" transfer-ownership="none">
2031
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
2105
+ <doc xml:space="preserve">A #GClosure.</doc>
2032
2106
  <type name="Closure" c:type="GClosure*"/>
2033
2107
  </parameter>
2034
2108
  <parameter name="return_value" transfer-ownership="none">
2035
- <doc xml:space="preserve">ignored</doc>
2109
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
2110
+ if the callback of closure doesn't return a value.</doc>
2036
2111
  <type name="Value" c:type="GValue*"/>
2037
2112
  </parameter>
2038
2113
  <parameter name="n_param_values" transfer-ownership="none">
2039
- <doc xml:space="preserve">3</doc>
2114
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
2040
2115
  <type name="guint" c:type="guint"/>
2041
2116
  </parameter>
2042
2117
  <parameter name="param_values" transfer-ownership="none">
2043
- <doc xml:space="preserve">a #GValue array holding instance, arg1 and arg2</doc>
2118
+ <doc xml:space="preserve">An array of #GValues holding the arguments
2119
+ on which to invoke the callback of closure.</doc>
2044
2120
  <type name="Value" c:type="const GValue*"/>
2045
2121
  </parameter>
2046
2122
  <parameter name="invocation_hint"
2047
2123
  transfer-ownership="none"
2048
2124
  nullable="1"
2049
2125
  allow-none="1">
2050
- <doc xml:space="preserve">the invocation hint given as the last argument
2051
- to g_closure_invoke()</doc>
2126
+ <doc xml:space="preserve">The invocation hint given as the last argument to
2127
+ g_closure_invoke().</doc>
2052
2128
  <type name="gpointer" c:type="gpointer"/>
2053
2129
  </parameter>
2054
2130
  <parameter name="marshal_data"
2055
2131
  transfer-ownership="none"
2056
2132
  nullable="1"
2057
2133
  allow-none="1">
2058
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
2134
+ <doc xml:space="preserve">Additional data specified when registering the
2135
+ marshaller, see g_closure_set_marshal() and
2136
+ g_closure_set_meta_marshal()</doc>
2059
2137
  <type name="gpointer" c:type="gpointer"/>
2060
2138
  </parameter>
2061
2139
  </parameters>
@@ -2164,41 +2242,45 @@ denotes a flags type.</doc>
2164
2242
  </function>
2165
2243
  <function name="marshal_VOID__ULONG"
2166
2244
  c:identifier="g_cclosure_marshal_VOID__ULONG">
2167
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
2168
- `void (*callback) (gpointer instance, gulong arg1, gpointer user_data)`.</doc>
2245
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
2246
+ unsigned long integer argument.</doc>
2169
2247
  <return-value transfer-ownership="none">
2170
2248
  <type name="none" c:type="void"/>
2171
2249
  </return-value>
2172
2250
  <parameters>
2173
2251
  <parameter name="closure" transfer-ownership="none">
2174
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
2252
+ <doc xml:space="preserve">A #GClosure.</doc>
2175
2253
  <type name="Closure" c:type="GClosure*"/>
2176
2254
  </parameter>
2177
2255
  <parameter name="return_value" transfer-ownership="none">
2178
- <doc xml:space="preserve">ignored</doc>
2256
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
2257
+ if the callback of closure doesn't return a value.</doc>
2179
2258
  <type name="Value" c:type="GValue*"/>
2180
2259
  </parameter>
2181
2260
  <parameter name="n_param_values" transfer-ownership="none">
2182
- <doc xml:space="preserve">2</doc>
2261
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
2183
2262
  <type name="guint" c:type="guint"/>
2184
2263
  </parameter>
2185
2264
  <parameter name="param_values" transfer-ownership="none">
2186
- <doc xml:space="preserve">a #GValue array holding the instance and the #gulong parameter</doc>
2265
+ <doc xml:space="preserve">An array of #GValues holding the arguments
2266
+ on which to invoke the callback of closure.</doc>
2187
2267
  <type name="Value" c:type="const GValue*"/>
2188
2268
  </parameter>
2189
2269
  <parameter name="invocation_hint"
2190
2270
  transfer-ownership="none"
2191
2271
  nullable="1"
2192
2272
  allow-none="1">
2193
- <doc xml:space="preserve">the invocation hint given as the last argument
2194
- to g_closure_invoke()</doc>
2273
+ <doc xml:space="preserve">The invocation hint given as the last argument to
2274
+ g_closure_invoke().</doc>
2195
2275
  <type name="gpointer" c:type="gpointer"/>
2196
2276
  </parameter>
2197
2277
  <parameter name="marshal_data"
2198
2278
  transfer-ownership="none"
2199
2279
  nullable="1"
2200
2280
  allow-none="1">
2201
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
2281
+ <doc xml:space="preserve">Additional data specified when registering the
2282
+ marshaller, see g_closure_set_marshal() and
2283
+ g_closure_set_meta_marshal()</doc>
2202
2284
  <type name="gpointer" c:type="gpointer"/>
2203
2285
  </parameter>
2204
2286
  </parameters>
@@ -2255,43 +2337,46 @@ denotes a flags type.</doc>
2255
2337
  </parameters>
2256
2338
  </function>
2257
2339
  <function name="marshal_VOID__VARIANT"
2258
- c:identifier="g_cclosure_marshal_VOID__VARIANT"
2259
- version="2.26">
2260
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
2261
- `void (*callback) (gpointer instance, GVariant *arg1, gpointer user_data)`.</doc>
2340
+ c:identifier="g_cclosure_marshal_VOID__VARIANT">
2341
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
2342
+ #GVariant argument.</doc>
2262
2343
  <return-value transfer-ownership="none">
2263
2344
  <type name="none" c:type="void"/>
2264
2345
  </return-value>
2265
2346
  <parameters>
2266
2347
  <parameter name="closure" transfer-ownership="none">
2267
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
2348
+ <doc xml:space="preserve">A #GClosure.</doc>
2268
2349
  <type name="Closure" c:type="GClosure*"/>
2269
2350
  </parameter>
2270
2351
  <parameter name="return_value" transfer-ownership="none">
2271
- <doc xml:space="preserve">ignored</doc>
2352
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
2353
+ if the callback of closure doesn't return a value.</doc>
2272
2354
  <type name="Value" c:type="GValue*"/>
2273
2355
  </parameter>
2274
2356
  <parameter name="n_param_values" transfer-ownership="none">
2275
- <doc xml:space="preserve">2</doc>
2357
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
2276
2358
  <type name="guint" c:type="guint"/>
2277
2359
  </parameter>
2278
2360
  <parameter name="param_values" transfer-ownership="none">
2279
- <doc xml:space="preserve">a #GValue array holding the instance and the #GVariant* parameter</doc>
2361
+ <doc xml:space="preserve">An array of #GValues holding the arguments
2362
+ on which to invoke the callback of closure.</doc>
2280
2363
  <type name="Value" c:type="const GValue*"/>
2281
2364
  </parameter>
2282
2365
  <parameter name="invocation_hint"
2283
2366
  transfer-ownership="none"
2284
2367
  nullable="1"
2285
2368
  allow-none="1">
2286
- <doc xml:space="preserve">the invocation hint given as the last argument
2287
- to g_closure_invoke()</doc>
2369
+ <doc xml:space="preserve">The invocation hint given as the last argument to
2370
+ g_closure_invoke().</doc>
2288
2371
  <type name="gpointer" c:type="gpointer"/>
2289
2372
  </parameter>
2290
2373
  <parameter name="marshal_data"
2291
2374
  transfer-ownership="none"
2292
2375
  nullable="1"
2293
2376
  allow-none="1">
2294
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
2377
+ <doc xml:space="preserve">Additional data specified when registering the
2378
+ marshaller, see g_closure_set_marshal() and
2379
+ g_closure_set_meta_marshal()</doc>
2295
2380
  <type name="gpointer" c:type="gpointer"/>
2296
2381
  </parameter>
2297
2382
  </parameters>
@@ -2349,41 +2434,44 @@ denotes a flags type.</doc>
2349
2434
  </function>
2350
2435
  <function name="marshal_VOID__VOID"
2351
2436
  c:identifier="g_cclosure_marshal_VOID__VOID">
2352
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
2353
- `void (*callback) (gpointer instance, gpointer user_data)`.</doc>
2437
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with no arguments.</doc>
2354
2438
  <return-value transfer-ownership="none">
2355
2439
  <type name="none" c:type="void"/>
2356
2440
  </return-value>
2357
2441
  <parameters>
2358
2442
  <parameter name="closure" transfer-ownership="none">
2359
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
2443
+ <doc xml:space="preserve">A #GClosure.</doc>
2360
2444
  <type name="Closure" c:type="GClosure*"/>
2361
2445
  </parameter>
2362
2446
  <parameter name="return_value" transfer-ownership="none">
2363
- <doc xml:space="preserve">ignored</doc>
2447
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
2448
+ if the callback of closure doesn't return a value.</doc>
2364
2449
  <type name="Value" c:type="GValue*"/>
2365
2450
  </parameter>
2366
2451
  <parameter name="n_param_values" transfer-ownership="none">
2367
- <doc xml:space="preserve">1</doc>
2452
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
2368
2453
  <type name="guint" c:type="guint"/>
2369
2454
  </parameter>
2370
2455
  <parameter name="param_values" transfer-ownership="none">
2371
- <doc xml:space="preserve">a #GValue array holding only the instance</doc>
2456
+ <doc xml:space="preserve">An array of #GValues holding the arguments
2457
+ on which to invoke the callback of closure.</doc>
2372
2458
  <type name="Value" c:type="const GValue*"/>
2373
2459
  </parameter>
2374
2460
  <parameter name="invocation_hint"
2375
2461
  transfer-ownership="none"
2376
2462
  nullable="1"
2377
2463
  allow-none="1">
2378
- <doc xml:space="preserve">the invocation hint given as the last argument
2379
- to g_closure_invoke()</doc>
2464
+ <doc xml:space="preserve">The invocation hint given as the last argument to
2465
+ g_closure_invoke().</doc>
2380
2466
  <type name="gpointer" c:type="gpointer"/>
2381
2467
  </parameter>
2382
2468
  <parameter name="marshal_data"
2383
2469
  transfer-ownership="none"
2384
2470
  nullable="1"
2385
2471
  allow-none="1">
2386
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
2472
+ <doc xml:space="preserve">Additional data specified when registering the
2473
+ marshaller, see g_closure_set_marshal() and
2474
+ g_closure_set_meta_marshal()</doc>
2387
2475
  <type name="gpointer" c:type="gpointer"/>
2388
2476
  </parameter>
2389
2477
  </parameters>
@@ -10755,42 +10843,47 @@ accumulator, such as g_signal_accumulator_true_handled().</doc>
10755
10843
  <function name="cclosure_marshal_BOOLEAN__FLAGS"
10756
10844
  c:identifier="g_cclosure_marshal_BOOLEAN__FLAGS"
10757
10845
  moved-to="CClosure.marshal_BOOLEAN__FLAGS">
10758
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10759
- `gboolean (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter
10760
- denotes a flags type.</doc>
10846
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with handlers that
10847
+ take a flags type as an argument and return a boolean. If you have
10848
+ such a signal, you will probably also need to use an accumulator,
10849
+ such as g_signal_accumulator_true_handled().</doc>
10761
10850
  <return-value transfer-ownership="none">
10762
10851
  <type name="none" c:type="void"/>
10763
10852
  </return-value>
10764
10853
  <parameters>
10765
10854
  <parameter name="closure" transfer-ownership="none">
10766
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
10855
+ <doc xml:space="preserve">A #GClosure.</doc>
10767
10856
  <type name="Closure" c:type="GClosure*"/>
10768
10857
  </parameter>
10769
10858
  <parameter name="return_value" transfer-ownership="none">
10770
- <doc xml:space="preserve">a #GValue which can store the returned #gboolean</doc>
10859
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10860
+ if the callback of closure doesn't return a value.</doc>
10771
10861
  <type name="Value" c:type="GValue*"/>
10772
10862
  </parameter>
10773
10863
  <parameter name="n_param_values" transfer-ownership="none">
10774
- <doc xml:space="preserve">2</doc>
10864
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10775
10865
  <type name="guint" c:type="guint"/>
10776
10866
  </parameter>
10777
10867
  <parameter name="param_values" transfer-ownership="none">
10778
- <doc xml:space="preserve">a #GValue array holding instance and arg1</doc>
10868
+ <doc xml:space="preserve">An array of #GValues holding the arguments
10869
+ on which to invoke the callback of closure.</doc>
10779
10870
  <type name="Value" c:type="const GValue*"/>
10780
10871
  </parameter>
10781
10872
  <parameter name="invocation_hint"
10782
10873
  transfer-ownership="none"
10783
10874
  nullable="1"
10784
10875
  allow-none="1">
10785
- <doc xml:space="preserve">the invocation hint given as the last argument
10786
- to g_closure_invoke()</doc>
10876
+ <doc xml:space="preserve">The invocation hint given as the last argument to
10877
+ g_closure_invoke().</doc>
10787
10878
  <type name="gpointer" c:type="gpointer"/>
10788
10879
  </parameter>
10789
10880
  <parameter name="marshal_data"
10790
10881
  transfer-ownership="none"
10791
10882
  nullable="1"
10792
10883
  allow-none="1">
10793
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
10884
+ <doc xml:space="preserve">Additional data specified when registering the
10885
+ marshaller, see g_closure_set_marshal() and
10886
+ g_closure_set_meta_marshal()</doc>
10794
10887
  <type name="gpointer" c:type="gpointer"/>
10795
10888
  </parameter>
10796
10889
  </parameters>
@@ -10798,41 +10891,46 @@ denotes a flags type.</doc>
10798
10891
  <function name="cclosure_marshal_STRING__OBJECT_POINTER"
10799
10892
  c:identifier="g_cclosure_marshal_STRING__OBJECT_POINTER"
10800
10893
  moved-to="CClosure.marshal_STRING__OBJECT_POINTER">
10801
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10802
- `gchar* (*callback) (gpointer instance, GObject *arg1, gpointer arg2, gpointer user_data)`.</doc>
10894
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with handlers that
10895
+ take a #GObject and a pointer and produce a string. It is highly
10896
+ unlikely that your signal handler fits this description.</doc>
10803
10897
  <return-value transfer-ownership="none">
10804
10898
  <type name="none" c:type="void"/>
10805
10899
  </return-value>
10806
10900
  <parameters>
10807
10901
  <parameter name="closure" transfer-ownership="none">
10808
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
10902
+ <doc xml:space="preserve">A #GClosure.</doc>
10809
10903
  <type name="Closure" c:type="GClosure*"/>
10810
10904
  </parameter>
10811
10905
  <parameter name="return_value" transfer-ownership="none">
10812
- <doc xml:space="preserve">a #GValue, which can store the returned string</doc>
10906
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10907
+ if the callback of closure doesn't return a value.</doc>
10813
10908
  <type name="Value" c:type="GValue*"/>
10814
10909
  </parameter>
10815
10910
  <parameter name="n_param_values" transfer-ownership="none">
10816
- <doc xml:space="preserve">3</doc>
10911
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10817
10912
  <type name="guint" c:type="guint"/>
10818
10913
  </parameter>
10819
10914
  <parameter name="param_values" transfer-ownership="none">
10820
- <doc xml:space="preserve">a #GValue array holding instance, arg1 and arg2</doc>
10915
+ <doc xml:space="preserve">An array of #GValues holding the arguments
10916
+ on which to invoke the callback of closure.</doc>
10821
10917
  <type name="Value" c:type="const GValue*"/>
10822
10918
  </parameter>
10823
10919
  <parameter name="invocation_hint"
10824
10920
  transfer-ownership="none"
10825
10921
  nullable="1"
10826
10922
  allow-none="1">
10827
- <doc xml:space="preserve">the invocation hint given as the last argument
10828
- to g_closure_invoke()</doc>
10923
+ <doc xml:space="preserve">The invocation hint given as the last argument to
10924
+ g_closure_invoke().</doc>
10829
10925
  <type name="gpointer" c:type="gpointer"/>
10830
10926
  </parameter>
10831
10927
  <parameter name="marshal_data"
10832
10928
  transfer-ownership="none"
10833
10929
  nullable="1"
10834
10930
  allow-none="1">
10835
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
10931
+ <doc xml:space="preserve">Additional data specified when registering the
10932
+ marshaller, see g_closure_set_marshal() and
10933
+ g_closure_set_meta_marshal()</doc>
10836
10934
  <type name="gpointer" c:type="gpointer"/>
10837
10935
  </parameter>
10838
10936
  </parameters>
@@ -10840,41 +10938,45 @@ denotes a flags type.</doc>
10840
10938
  <function name="cclosure_marshal_VOID__BOOLEAN"
10841
10939
  c:identifier="g_cclosure_marshal_VOID__BOOLEAN"
10842
10940
  moved-to="CClosure.marshal_VOID__BOOLEAN">
10843
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10844
- `void (*callback) (gpointer instance, gboolean arg1, gpointer user_data)`.</doc>
10941
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
10942
+ boolean argument.</doc>
10845
10943
  <return-value transfer-ownership="none">
10846
10944
  <type name="none" c:type="void"/>
10847
10945
  </return-value>
10848
10946
  <parameters>
10849
10947
  <parameter name="closure" transfer-ownership="none">
10850
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
10948
+ <doc xml:space="preserve">A #GClosure.</doc>
10851
10949
  <type name="Closure" c:type="GClosure*"/>
10852
10950
  </parameter>
10853
10951
  <parameter name="return_value" transfer-ownership="none">
10854
- <doc xml:space="preserve">ignored</doc>
10952
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10953
+ if the callback of closure doesn't return a value.</doc>
10855
10954
  <type name="Value" c:type="GValue*"/>
10856
10955
  </parameter>
10857
10956
  <parameter name="n_param_values" transfer-ownership="none">
10858
- <doc xml:space="preserve">2</doc>
10957
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10859
10958
  <type name="guint" c:type="guint"/>
10860
10959
  </parameter>
10861
10960
  <parameter name="param_values" transfer-ownership="none">
10862
- <doc xml:space="preserve">a #GValue array holding the instance and the #gboolean parameter</doc>
10961
+ <doc xml:space="preserve">An array of #GValues holding the arguments
10962
+ on which to invoke the callback of closure.</doc>
10863
10963
  <type name="Value" c:type="const GValue*"/>
10864
10964
  </parameter>
10865
10965
  <parameter name="invocation_hint"
10866
10966
  transfer-ownership="none"
10867
10967
  nullable="1"
10868
10968
  allow-none="1">
10869
- <doc xml:space="preserve">the invocation hint given as the last argument
10870
- to g_closure_invoke()</doc>
10969
+ <doc xml:space="preserve">The invocation hint given as the last argument to
10970
+ g_closure_invoke().</doc>
10871
10971
  <type name="gpointer" c:type="gpointer"/>
10872
10972
  </parameter>
10873
10973
  <parameter name="marshal_data"
10874
10974
  transfer-ownership="none"
10875
10975
  nullable="1"
10876
10976
  allow-none="1">
10877
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
10977
+ <doc xml:space="preserve">Additional data specified when registering the
10978
+ marshaller, see g_closure_set_marshal() and
10979
+ g_closure_set_meta_marshal()</doc>
10878
10980
  <type name="gpointer" c:type="gpointer"/>
10879
10981
  </parameter>
10880
10982
  </parameters>
@@ -10882,41 +10984,45 @@ denotes a flags type.</doc>
10882
10984
  <function name="cclosure_marshal_VOID__BOXED"
10883
10985
  c:identifier="g_cclosure_marshal_VOID__BOXED"
10884
10986
  moved-to="CClosure.marshal_VOID__BOXED">
10885
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10886
- `void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data)`.</doc>
10987
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
10988
+ argument which is any boxed pointer type.</doc>
10887
10989
  <return-value transfer-ownership="none">
10888
10990
  <type name="none" c:type="void"/>
10889
10991
  </return-value>
10890
10992
  <parameters>
10891
10993
  <parameter name="closure" transfer-ownership="none">
10892
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
10994
+ <doc xml:space="preserve">A #GClosure.</doc>
10893
10995
  <type name="Closure" c:type="GClosure*"/>
10894
10996
  </parameter>
10895
10997
  <parameter name="return_value" transfer-ownership="none">
10896
- <doc xml:space="preserve">ignored</doc>
10998
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
10999
+ if the callback of closure doesn't return a value.</doc>
10897
11000
  <type name="Value" c:type="GValue*"/>
10898
11001
  </parameter>
10899
11002
  <parameter name="n_param_values" transfer-ownership="none">
10900
- <doc xml:space="preserve">2</doc>
11003
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10901
11004
  <type name="guint" c:type="guint"/>
10902
11005
  </parameter>
10903
11006
  <parameter name="param_values" transfer-ownership="none">
10904
- <doc xml:space="preserve">a #GValue array holding the instance and the #GBoxed* parameter</doc>
11007
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11008
+ on which to invoke the callback of closure.</doc>
10905
11009
  <type name="Value" c:type="const GValue*"/>
10906
11010
  </parameter>
10907
11011
  <parameter name="invocation_hint"
10908
11012
  transfer-ownership="none"
10909
11013
  nullable="1"
10910
11014
  allow-none="1">
10911
- <doc xml:space="preserve">the invocation hint given as the last argument
10912
- to g_closure_invoke()</doc>
11015
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11016
+ g_closure_invoke().</doc>
10913
11017
  <type name="gpointer" c:type="gpointer"/>
10914
11018
  </parameter>
10915
11019
  <parameter name="marshal_data"
10916
11020
  transfer-ownership="none"
10917
11021
  nullable="1"
10918
11022
  allow-none="1">
10919
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11023
+ <doc xml:space="preserve">Additional data specified when registering the
11024
+ marshaller, see g_closure_set_marshal() and
11025
+ g_closure_set_meta_marshal()</doc>
10920
11026
  <type name="gpointer" c:type="gpointer"/>
10921
11027
  </parameter>
10922
11028
  </parameters>
@@ -10924,41 +11030,45 @@ denotes a flags type.</doc>
10924
11030
  <function name="cclosure_marshal_VOID__CHAR"
10925
11031
  c:identifier="g_cclosure_marshal_VOID__CHAR"
10926
11032
  moved-to="CClosure.marshal_VOID__CHAR">
10927
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10928
- `void (*callback) (gpointer instance, gchar arg1, gpointer user_data)`.</doc>
11033
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
11034
+ character argument.</doc>
10929
11035
  <return-value transfer-ownership="none">
10930
11036
  <type name="none" c:type="void"/>
10931
11037
  </return-value>
10932
11038
  <parameters>
10933
11039
  <parameter name="closure" transfer-ownership="none">
10934
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11040
+ <doc xml:space="preserve">A #GClosure.</doc>
10935
11041
  <type name="Closure" c:type="GClosure*"/>
10936
11042
  </parameter>
10937
11043
  <parameter name="return_value" transfer-ownership="none">
10938
- <doc xml:space="preserve">ignored</doc>
11044
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11045
+ if the callback of closure doesn't return a value.</doc>
10939
11046
  <type name="Value" c:type="GValue*"/>
10940
11047
  </parameter>
10941
11048
  <parameter name="n_param_values" transfer-ownership="none">
10942
- <doc xml:space="preserve">2</doc>
11049
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10943
11050
  <type name="guint" c:type="guint"/>
10944
11051
  </parameter>
10945
11052
  <parameter name="param_values" transfer-ownership="none">
10946
- <doc xml:space="preserve">a #GValue array holding the instance and the #gchar parameter</doc>
11053
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11054
+ on which to invoke the callback of closure.</doc>
10947
11055
  <type name="Value" c:type="const GValue*"/>
10948
11056
  </parameter>
10949
11057
  <parameter name="invocation_hint"
10950
11058
  transfer-ownership="none"
10951
11059
  nullable="1"
10952
11060
  allow-none="1">
10953
- <doc xml:space="preserve">the invocation hint given as the last argument
10954
- to g_closure_invoke()</doc>
11061
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11062
+ g_closure_invoke().</doc>
10955
11063
  <type name="gpointer" c:type="gpointer"/>
10956
11064
  </parameter>
10957
11065
  <parameter name="marshal_data"
10958
11066
  transfer-ownership="none"
10959
11067
  nullable="1"
10960
11068
  allow-none="1">
10961
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11069
+ <doc xml:space="preserve">Additional data specified when registering the
11070
+ marshaller, see g_closure_set_marshal() and
11071
+ g_closure_set_meta_marshal()</doc>
10962
11072
  <type name="gpointer" c:type="gpointer"/>
10963
11073
  </parameter>
10964
11074
  </parameters>
@@ -10966,41 +11076,45 @@ denotes a flags type.</doc>
10966
11076
  <function name="cclosure_marshal_VOID__DOUBLE"
10967
11077
  c:identifier="g_cclosure_marshal_VOID__DOUBLE"
10968
11078
  moved-to="CClosure.marshal_VOID__DOUBLE">
10969
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
10970
- `void (*callback) (gpointer instance, gdouble arg1, gpointer user_data)`.</doc>
11079
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with one
11080
+ double-precision floating point argument.</doc>
10971
11081
  <return-value transfer-ownership="none">
10972
11082
  <type name="none" c:type="void"/>
10973
11083
  </return-value>
10974
11084
  <parameters>
10975
11085
  <parameter name="closure" transfer-ownership="none">
10976
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11086
+ <doc xml:space="preserve">A #GClosure.</doc>
10977
11087
  <type name="Closure" c:type="GClosure*"/>
10978
11088
  </parameter>
10979
11089
  <parameter name="return_value" transfer-ownership="none">
10980
- <doc xml:space="preserve">ignored</doc>
11090
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11091
+ if the callback of closure doesn't return a value.</doc>
10981
11092
  <type name="Value" c:type="GValue*"/>
10982
11093
  </parameter>
10983
11094
  <parameter name="n_param_values" transfer-ownership="none">
10984
- <doc xml:space="preserve">2</doc>
11095
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
10985
11096
  <type name="guint" c:type="guint"/>
10986
11097
  </parameter>
10987
11098
  <parameter name="param_values" transfer-ownership="none">
10988
- <doc xml:space="preserve">a #GValue array holding the instance and the #gdouble parameter</doc>
11099
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11100
+ on which to invoke the callback of closure.</doc>
10989
11101
  <type name="Value" c:type="const GValue*"/>
10990
11102
  </parameter>
10991
11103
  <parameter name="invocation_hint"
10992
11104
  transfer-ownership="none"
10993
11105
  nullable="1"
10994
11106
  allow-none="1">
10995
- <doc xml:space="preserve">the invocation hint given as the last argument
10996
- to g_closure_invoke()</doc>
11107
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11108
+ g_closure_invoke().</doc>
10997
11109
  <type name="gpointer" c:type="gpointer"/>
10998
11110
  </parameter>
10999
11111
  <parameter name="marshal_data"
11000
11112
  transfer-ownership="none"
11001
11113
  nullable="1"
11002
11114
  allow-none="1">
11003
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11115
+ <doc xml:space="preserve">Additional data specified when registering the
11116
+ marshaller, see g_closure_set_marshal() and
11117
+ g_closure_set_meta_marshal()</doc>
11004
11118
  <type name="gpointer" c:type="gpointer"/>
11005
11119
  </parameter>
11006
11120
  </parameters>
@@ -11008,41 +11122,45 @@ denotes a flags type.</doc>
11008
11122
  <function name="cclosure_marshal_VOID__ENUM"
11009
11123
  c:identifier="g_cclosure_marshal_VOID__ENUM"
11010
11124
  moved-to="CClosure.marshal_VOID__ENUM">
11011
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
11012
- `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes an enumeration type..</doc>
11125
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
11126
+ argument with an enumerated type.</doc>
11013
11127
  <return-value transfer-ownership="none">
11014
11128
  <type name="none" c:type="void"/>
11015
11129
  </return-value>
11016
11130
  <parameters>
11017
11131
  <parameter name="closure" transfer-ownership="none">
11018
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11132
+ <doc xml:space="preserve">A #GClosure.</doc>
11019
11133
  <type name="Closure" c:type="GClosure*"/>
11020
11134
  </parameter>
11021
11135
  <parameter name="return_value" transfer-ownership="none">
11022
- <doc xml:space="preserve">ignored</doc>
11136
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11137
+ if the callback of closure doesn't return a value.</doc>
11023
11138
  <type name="Value" c:type="GValue*"/>
11024
11139
  </parameter>
11025
11140
  <parameter name="n_param_values" transfer-ownership="none">
11026
- <doc xml:space="preserve">2</doc>
11141
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
11027
11142
  <type name="guint" c:type="guint"/>
11028
11143
  </parameter>
11029
11144
  <parameter name="param_values" transfer-ownership="none">
11030
- <doc xml:space="preserve">a #GValue array holding the instance and the enumeration parameter</doc>
11145
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11146
+ on which to invoke the callback of closure.</doc>
11031
11147
  <type name="Value" c:type="const GValue*"/>
11032
11148
  </parameter>
11033
11149
  <parameter name="invocation_hint"
11034
11150
  transfer-ownership="none"
11035
11151
  nullable="1"
11036
11152
  allow-none="1">
11037
- <doc xml:space="preserve">the invocation hint given as the last argument
11038
- to g_closure_invoke()</doc>
11153
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11154
+ g_closure_invoke().</doc>
11039
11155
  <type name="gpointer" c:type="gpointer"/>
11040
11156
  </parameter>
11041
11157
  <parameter name="marshal_data"
11042
11158
  transfer-ownership="none"
11043
11159
  nullable="1"
11044
11160
  allow-none="1">
11045
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11161
+ <doc xml:space="preserve">Additional data specified when registering the
11162
+ marshaller, see g_closure_set_marshal() and
11163
+ g_closure_set_meta_marshal()</doc>
11046
11164
  <type name="gpointer" c:type="gpointer"/>
11047
11165
  </parameter>
11048
11166
  </parameters>
@@ -11050,41 +11168,45 @@ denotes a flags type.</doc>
11050
11168
  <function name="cclosure_marshal_VOID__FLAGS"
11051
11169
  c:identifier="g_cclosure_marshal_VOID__FLAGS"
11052
11170
  moved-to="CClosure.marshal_VOID__FLAGS">
11053
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
11054
- `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes a flags type.</doc>
11171
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
11172
+ argument with a flags types.</doc>
11055
11173
  <return-value transfer-ownership="none">
11056
11174
  <type name="none" c:type="void"/>
11057
11175
  </return-value>
11058
11176
  <parameters>
11059
11177
  <parameter name="closure" transfer-ownership="none">
11060
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11178
+ <doc xml:space="preserve">A #GClosure.</doc>
11061
11179
  <type name="Closure" c:type="GClosure*"/>
11062
11180
  </parameter>
11063
11181
  <parameter name="return_value" transfer-ownership="none">
11064
- <doc xml:space="preserve">ignored</doc>
11182
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11183
+ if the callback of closure doesn't return a value.</doc>
11065
11184
  <type name="Value" c:type="GValue*"/>
11066
11185
  </parameter>
11067
11186
  <parameter name="n_param_values" transfer-ownership="none">
11068
- <doc xml:space="preserve">2</doc>
11187
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
11069
11188
  <type name="guint" c:type="guint"/>
11070
11189
  </parameter>
11071
11190
  <parameter name="param_values" transfer-ownership="none">
11072
- <doc xml:space="preserve">a #GValue array holding the instance and the flags parameter</doc>
11191
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11192
+ on which to invoke the callback of closure.</doc>
11073
11193
  <type name="Value" c:type="const GValue*"/>
11074
11194
  </parameter>
11075
11195
  <parameter name="invocation_hint"
11076
11196
  transfer-ownership="none"
11077
11197
  nullable="1"
11078
11198
  allow-none="1">
11079
- <doc xml:space="preserve">the invocation hint given as the last argument
11080
- to g_closure_invoke()</doc>
11199
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11200
+ g_closure_invoke().</doc>
11081
11201
  <type name="gpointer" c:type="gpointer"/>
11082
11202
  </parameter>
11083
11203
  <parameter name="marshal_data"
11084
11204
  transfer-ownership="none"
11085
11205
  nullable="1"
11086
11206
  allow-none="1">
11087
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11207
+ <doc xml:space="preserve">Additional data specified when registering the
11208
+ marshaller, see g_closure_set_marshal() and
11209
+ g_closure_set_meta_marshal()</doc>
11088
11210
  <type name="gpointer" c:type="gpointer"/>
11089
11211
  </parameter>
11090
11212
  </parameters>
@@ -11092,41 +11214,45 @@ denotes a flags type.</doc>
11092
11214
  <function name="cclosure_marshal_VOID__FLOAT"
11093
11215
  c:identifier="g_cclosure_marshal_VOID__FLOAT"
11094
11216
  moved-to="CClosure.marshal_VOID__FLOAT">
11095
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
11096
- `void (*callback) (gpointer instance, gfloat arg1, gpointer user_data)`.</doc>
11217
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with one
11218
+ single-precision floating point argument.</doc>
11097
11219
  <return-value transfer-ownership="none">
11098
11220
  <type name="none" c:type="void"/>
11099
11221
  </return-value>
11100
11222
  <parameters>
11101
11223
  <parameter name="closure" transfer-ownership="none">
11102
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11224
+ <doc xml:space="preserve">A #GClosure.</doc>
11103
11225
  <type name="Closure" c:type="GClosure*"/>
11104
11226
  </parameter>
11105
11227
  <parameter name="return_value" transfer-ownership="none">
11106
- <doc xml:space="preserve">ignored</doc>
11228
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11229
+ if the callback of closure doesn't return a value.</doc>
11107
11230
  <type name="Value" c:type="GValue*"/>
11108
11231
  </parameter>
11109
11232
  <parameter name="n_param_values" transfer-ownership="none">
11110
- <doc xml:space="preserve">2</doc>
11233
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
11111
11234
  <type name="guint" c:type="guint"/>
11112
11235
  </parameter>
11113
11236
  <parameter name="param_values" transfer-ownership="none">
11114
- <doc xml:space="preserve">a #GValue array holding the instance and the #gfloat parameter</doc>
11237
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11238
+ on which to invoke the callback of closure.</doc>
11115
11239
  <type name="Value" c:type="const GValue*"/>
11116
11240
  </parameter>
11117
11241
  <parameter name="invocation_hint"
11118
11242
  transfer-ownership="none"
11119
11243
  nullable="1"
11120
11244
  allow-none="1">
11121
- <doc xml:space="preserve">the invocation hint given as the last argument
11122
- to g_closure_invoke()</doc>
11245
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11246
+ g_closure_invoke().</doc>
11123
11247
  <type name="gpointer" c:type="gpointer"/>
11124
11248
  </parameter>
11125
11249
  <parameter name="marshal_data"
11126
11250
  transfer-ownership="none"
11127
11251
  nullable="1"
11128
11252
  allow-none="1">
11129
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11253
+ <doc xml:space="preserve">Additional data specified when registering the
11254
+ marshaller, see g_closure_set_marshal() and
11255
+ g_closure_set_meta_marshal()</doc>
11130
11256
  <type name="gpointer" c:type="gpointer"/>
11131
11257
  </parameter>
11132
11258
  </parameters>
@@ -11134,41 +11260,45 @@ denotes a flags type.</doc>
11134
11260
  <function name="cclosure_marshal_VOID__INT"
11135
11261
  c:identifier="g_cclosure_marshal_VOID__INT"
11136
11262
  moved-to="CClosure.marshal_VOID__INT">
11137
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
11138
- `void (*callback) (gpointer instance, gint arg1, gpointer user_data)`.</doc>
11263
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
11264
+ integer argument.</doc>
11139
11265
  <return-value transfer-ownership="none">
11140
11266
  <type name="none" c:type="void"/>
11141
11267
  </return-value>
11142
11268
  <parameters>
11143
11269
  <parameter name="closure" transfer-ownership="none">
11144
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11270
+ <doc xml:space="preserve">A #GClosure.</doc>
11145
11271
  <type name="Closure" c:type="GClosure*"/>
11146
11272
  </parameter>
11147
11273
  <parameter name="return_value" transfer-ownership="none">
11148
- <doc xml:space="preserve">ignored</doc>
11274
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11275
+ if the callback of closure doesn't return a value.</doc>
11149
11276
  <type name="Value" c:type="GValue*"/>
11150
11277
  </parameter>
11151
11278
  <parameter name="n_param_values" transfer-ownership="none">
11152
- <doc xml:space="preserve">2</doc>
11279
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
11153
11280
  <type name="guint" c:type="guint"/>
11154
11281
  </parameter>
11155
11282
  <parameter name="param_values" transfer-ownership="none">
11156
- <doc xml:space="preserve">a #GValue array holding the instance and the #gint parameter</doc>
11283
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11284
+ on which to invoke the callback of closure.</doc>
11157
11285
  <type name="Value" c:type="const GValue*"/>
11158
11286
  </parameter>
11159
11287
  <parameter name="invocation_hint"
11160
11288
  transfer-ownership="none"
11161
11289
  nullable="1"
11162
11290
  allow-none="1">
11163
- <doc xml:space="preserve">the invocation hint given as the last argument
11164
- to g_closure_invoke()</doc>
11291
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11292
+ g_closure_invoke().</doc>
11165
11293
  <type name="gpointer" c:type="gpointer"/>
11166
11294
  </parameter>
11167
11295
  <parameter name="marshal_data"
11168
11296
  transfer-ownership="none"
11169
11297
  nullable="1"
11170
11298
  allow-none="1">
11171
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11299
+ <doc xml:space="preserve">Additional data specified when registering the
11300
+ marshaller, see g_closure_set_marshal() and
11301
+ g_closure_set_meta_marshal()</doc>
11172
11302
  <type name="gpointer" c:type="gpointer"/>
11173
11303
  </parameter>
11174
11304
  </parameters>
@@ -11176,41 +11306,45 @@ denotes a flags type.</doc>
11176
11306
  <function name="cclosure_marshal_VOID__LONG"
11177
11307
  c:identifier="g_cclosure_marshal_VOID__LONG"
11178
11308
  moved-to="CClosure.marshal_VOID__LONG">
11179
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
11180
- `void (*callback) (gpointer instance, glong arg1, gpointer user_data)`.</doc>
11309
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with with a single
11310
+ long integer argument.</doc>
11181
11311
  <return-value transfer-ownership="none">
11182
11312
  <type name="none" c:type="void"/>
11183
11313
  </return-value>
11184
11314
  <parameters>
11185
11315
  <parameter name="closure" transfer-ownership="none">
11186
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11316
+ <doc xml:space="preserve">A #GClosure.</doc>
11187
11317
  <type name="Closure" c:type="GClosure*"/>
11188
11318
  </parameter>
11189
11319
  <parameter name="return_value" transfer-ownership="none">
11190
- <doc xml:space="preserve">ignored</doc>
11320
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11321
+ if the callback of closure doesn't return a value.</doc>
11191
11322
  <type name="Value" c:type="GValue*"/>
11192
11323
  </parameter>
11193
11324
  <parameter name="n_param_values" transfer-ownership="none">
11194
- <doc xml:space="preserve">2</doc>
11325
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
11195
11326
  <type name="guint" c:type="guint"/>
11196
11327
  </parameter>
11197
11328
  <parameter name="param_values" transfer-ownership="none">
11198
- <doc xml:space="preserve">a #GValue array holding the instance and the #glong parameter</doc>
11329
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11330
+ on which to invoke the callback of closure.</doc>
11199
11331
  <type name="Value" c:type="const GValue*"/>
11200
11332
  </parameter>
11201
11333
  <parameter name="invocation_hint"
11202
11334
  transfer-ownership="none"
11203
11335
  nullable="1"
11204
11336
  allow-none="1">
11205
- <doc xml:space="preserve">the invocation hint given as the last argument
11206
- to g_closure_invoke()</doc>
11337
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11338
+ g_closure_invoke().</doc>
11207
11339
  <type name="gpointer" c:type="gpointer"/>
11208
11340
  </parameter>
11209
11341
  <parameter name="marshal_data"
11210
11342
  transfer-ownership="none"
11211
11343
  nullable="1"
11212
11344
  allow-none="1">
11213
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11345
+ <doc xml:space="preserve">Additional data specified when registering the
11346
+ marshaller, see g_closure_set_marshal() and
11347
+ g_closure_set_meta_marshal()</doc>
11214
11348
  <type name="gpointer" c:type="gpointer"/>
11215
11349
  </parameter>
11216
11350
  </parameters>
@@ -11218,41 +11352,45 @@ denotes a flags type.</doc>
11218
11352
  <function name="cclosure_marshal_VOID__OBJECT"
11219
11353
  c:identifier="g_cclosure_marshal_VOID__OBJECT"
11220
11354
  moved-to="CClosure.marshal_VOID__OBJECT">
11221
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
11222
- `void (*callback) (gpointer instance, GObject *arg1, gpointer user_data)`.</doc>
11355
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
11356
+ #GObject argument.</doc>
11223
11357
  <return-value transfer-ownership="none">
11224
11358
  <type name="none" c:type="void"/>
11225
11359
  </return-value>
11226
11360
  <parameters>
11227
11361
  <parameter name="closure" transfer-ownership="none">
11228
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11362
+ <doc xml:space="preserve">A #GClosure.</doc>
11229
11363
  <type name="Closure" c:type="GClosure*"/>
11230
11364
  </parameter>
11231
11365
  <parameter name="return_value" transfer-ownership="none">
11232
- <doc xml:space="preserve">ignored</doc>
11366
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11367
+ if the callback of closure doesn't return a value.</doc>
11233
11368
  <type name="Value" c:type="GValue*"/>
11234
11369
  </parameter>
11235
11370
  <parameter name="n_param_values" transfer-ownership="none">
11236
- <doc xml:space="preserve">2</doc>
11371
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
11237
11372
  <type name="guint" c:type="guint"/>
11238
11373
  </parameter>
11239
11374
  <parameter name="param_values" transfer-ownership="none">
11240
- <doc xml:space="preserve">a #GValue array holding the instance and the #GObject* parameter</doc>
11375
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11376
+ on which to invoke the callback of closure.</doc>
11241
11377
  <type name="Value" c:type="const GValue*"/>
11242
11378
  </parameter>
11243
11379
  <parameter name="invocation_hint"
11244
11380
  transfer-ownership="none"
11245
11381
  nullable="1"
11246
11382
  allow-none="1">
11247
- <doc xml:space="preserve">the invocation hint given as the last argument
11248
- to g_closure_invoke()</doc>
11383
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11384
+ g_closure_invoke().</doc>
11249
11385
  <type name="gpointer" c:type="gpointer"/>
11250
11386
  </parameter>
11251
11387
  <parameter name="marshal_data"
11252
11388
  transfer-ownership="none"
11253
11389
  nullable="1"
11254
11390
  allow-none="1">
11255
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11391
+ <doc xml:space="preserve">Additional data specified when registering the
11392
+ marshaller, see g_closure_set_marshal() and
11393
+ g_closure_set_meta_marshal()</doc>
11256
11394
  <type name="gpointer" c:type="gpointer"/>
11257
11395
  </parameter>
11258
11396
  </parameters>
@@ -11260,41 +11398,45 @@ denotes a flags type.</doc>
11260
11398
  <function name="cclosure_marshal_VOID__PARAM"
11261
11399
  c:identifier="g_cclosure_marshal_VOID__PARAM"
11262
11400
  moved-to="CClosure.marshal_VOID__PARAM">
11263
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
11264
- `void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data)`.</doc>
11401
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
11402
+ argument of type #GParamSpec.</doc>
11265
11403
  <return-value transfer-ownership="none">
11266
11404
  <type name="none" c:type="void"/>
11267
11405
  </return-value>
11268
11406
  <parameters>
11269
11407
  <parameter name="closure" transfer-ownership="none">
11270
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11408
+ <doc xml:space="preserve">A #GClosure.</doc>
11271
11409
  <type name="Closure" c:type="GClosure*"/>
11272
11410
  </parameter>
11273
11411
  <parameter name="return_value" transfer-ownership="none">
11274
- <doc xml:space="preserve">ignored</doc>
11412
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11413
+ if the callback of closure doesn't return a value.</doc>
11275
11414
  <type name="Value" c:type="GValue*"/>
11276
11415
  </parameter>
11277
11416
  <parameter name="n_param_values" transfer-ownership="none">
11278
- <doc xml:space="preserve">2</doc>
11417
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
11279
11418
  <type name="guint" c:type="guint"/>
11280
11419
  </parameter>
11281
11420
  <parameter name="param_values" transfer-ownership="none">
11282
- <doc xml:space="preserve">a #GValue array holding the instance and the #GParamSpec* parameter</doc>
11421
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11422
+ on which to invoke the callback of closure.</doc>
11283
11423
  <type name="Value" c:type="const GValue*"/>
11284
11424
  </parameter>
11285
11425
  <parameter name="invocation_hint"
11286
11426
  transfer-ownership="none"
11287
11427
  nullable="1"
11288
11428
  allow-none="1">
11289
- <doc xml:space="preserve">the invocation hint given as the last argument
11290
- to g_closure_invoke()</doc>
11429
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11430
+ g_closure_invoke().</doc>
11291
11431
  <type name="gpointer" c:type="gpointer"/>
11292
11432
  </parameter>
11293
11433
  <parameter name="marshal_data"
11294
11434
  transfer-ownership="none"
11295
11435
  nullable="1"
11296
11436
  allow-none="1">
11297
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11437
+ <doc xml:space="preserve">Additional data specified when registering the
11438
+ marshaller, see g_closure_set_marshal() and
11439
+ g_closure_set_meta_marshal()</doc>
11298
11440
  <type name="gpointer" c:type="gpointer"/>
11299
11441
  </parameter>
11300
11442
  </parameters>
@@ -11302,41 +11444,49 @@ denotes a flags type.</doc>
11302
11444
  <function name="cclosure_marshal_VOID__POINTER"
11303
11445
  c:identifier="g_cclosure_marshal_VOID__POINTER"
11304
11446
  moved-to="CClosure.marshal_VOID__POINTER">
11305
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
11306
- `void (*callback) (gpointer instance, gpointer arg1, gpointer user_data)`.</doc>
11447
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single raw
11448
+ pointer argument type.
11449
+
11450
+ If it is possible, it is better to use one of the more specific
11451
+ functions such as g_cclosure_marshal_VOID__OBJECT() or
11452
+ g_cclosure_marshal_VOID__OBJECT().</doc>
11307
11453
  <return-value transfer-ownership="none">
11308
11454
  <type name="none" c:type="void"/>
11309
11455
  </return-value>
11310
11456
  <parameters>
11311
11457
  <parameter name="closure" transfer-ownership="none">
11312
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11458
+ <doc xml:space="preserve">A #GClosure.</doc>
11313
11459
  <type name="Closure" c:type="GClosure*"/>
11314
11460
  </parameter>
11315
11461
  <parameter name="return_value" transfer-ownership="none">
11316
- <doc xml:space="preserve">ignored</doc>
11462
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11463
+ if the callback of closure doesn't return a value.</doc>
11317
11464
  <type name="Value" c:type="GValue*"/>
11318
11465
  </parameter>
11319
11466
  <parameter name="n_param_values" transfer-ownership="none">
11320
- <doc xml:space="preserve">2</doc>
11467
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
11321
11468
  <type name="guint" c:type="guint"/>
11322
11469
  </parameter>
11323
11470
  <parameter name="param_values" transfer-ownership="none">
11324
- <doc xml:space="preserve">a #GValue array holding the instance and the #gpointer parameter</doc>
11471
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11472
+ on which to invoke the callback of closure.</doc>
11325
11473
  <type name="Value" c:type="const GValue*"/>
11326
11474
  </parameter>
11327
11475
  <parameter name="invocation_hint"
11328
11476
  transfer-ownership="none"
11329
11477
  nullable="1"
11330
11478
  allow-none="1">
11331
- <doc xml:space="preserve">the invocation hint given as the last argument
11332
- to g_closure_invoke()</doc>
11479
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11480
+ g_closure_invoke().</doc>
11333
11481
  <type name="gpointer" c:type="gpointer"/>
11334
11482
  </parameter>
11335
11483
  <parameter name="marshal_data"
11336
11484
  transfer-ownership="none"
11337
11485
  nullable="1"
11338
11486
  allow-none="1">
11339
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11487
+ <doc xml:space="preserve">Additional data specified when registering the
11488
+ marshaller, see g_closure_set_marshal() and
11489
+ g_closure_set_meta_marshal()</doc>
11340
11490
  <type name="gpointer" c:type="gpointer"/>
11341
11491
  </parameter>
11342
11492
  </parameters>
@@ -11344,41 +11494,45 @@ denotes a flags type.</doc>
11344
11494
  <function name="cclosure_marshal_VOID__STRING"
11345
11495
  c:identifier="g_cclosure_marshal_VOID__STRING"
11346
11496
  moved-to="CClosure.marshal_VOID__STRING">
11347
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
11348
- `void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data)`.</doc>
11497
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single string
11498
+ argument.</doc>
11349
11499
  <return-value transfer-ownership="none">
11350
11500
  <type name="none" c:type="void"/>
11351
11501
  </return-value>
11352
11502
  <parameters>
11353
11503
  <parameter name="closure" transfer-ownership="none">
11354
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11504
+ <doc xml:space="preserve">A #GClosure.</doc>
11355
11505
  <type name="Closure" c:type="GClosure*"/>
11356
11506
  </parameter>
11357
11507
  <parameter name="return_value" transfer-ownership="none">
11358
- <doc xml:space="preserve">ignored</doc>
11508
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11509
+ if the callback of closure doesn't return a value.</doc>
11359
11510
  <type name="Value" c:type="GValue*"/>
11360
11511
  </parameter>
11361
11512
  <parameter name="n_param_values" transfer-ownership="none">
11362
- <doc xml:space="preserve">2</doc>
11513
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
11363
11514
  <type name="guint" c:type="guint"/>
11364
11515
  </parameter>
11365
11516
  <parameter name="param_values" transfer-ownership="none">
11366
- <doc xml:space="preserve">a #GValue array holding the instance and the #gchar* parameter</doc>
11517
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11518
+ on which to invoke the callback of closure.</doc>
11367
11519
  <type name="Value" c:type="const GValue*"/>
11368
11520
  </parameter>
11369
11521
  <parameter name="invocation_hint"
11370
11522
  transfer-ownership="none"
11371
11523
  nullable="1"
11372
11524
  allow-none="1">
11373
- <doc xml:space="preserve">the invocation hint given as the last argument
11374
- to g_closure_invoke()</doc>
11525
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11526
+ g_closure_invoke().</doc>
11375
11527
  <type name="gpointer" c:type="gpointer"/>
11376
11528
  </parameter>
11377
11529
  <parameter name="marshal_data"
11378
11530
  transfer-ownership="none"
11379
11531
  nullable="1"
11380
11532
  allow-none="1">
11381
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11533
+ <doc xml:space="preserve">Additional data specified when registering the
11534
+ marshaller, see g_closure_set_marshal() and
11535
+ g_closure_set_meta_marshal()</doc>
11382
11536
  <type name="gpointer" c:type="gpointer"/>
11383
11537
  </parameter>
11384
11538
  </parameters>
@@ -11386,41 +11540,45 @@ denotes a flags type.</doc>
11386
11540
  <function name="cclosure_marshal_VOID__UCHAR"
11387
11541
  c:identifier="g_cclosure_marshal_VOID__UCHAR"
11388
11542
  moved-to="CClosure.marshal_VOID__UCHAR">
11389
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
11390
- `void (*callback) (gpointer instance, guchar arg1, gpointer user_data)`.</doc>
11543
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
11544
+ unsigned character argument.</doc>
11391
11545
  <return-value transfer-ownership="none">
11392
11546
  <type name="none" c:type="void"/>
11393
11547
  </return-value>
11394
11548
  <parameters>
11395
11549
  <parameter name="closure" transfer-ownership="none">
11396
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11550
+ <doc xml:space="preserve">A #GClosure.</doc>
11397
11551
  <type name="Closure" c:type="GClosure*"/>
11398
11552
  </parameter>
11399
11553
  <parameter name="return_value" transfer-ownership="none">
11400
- <doc xml:space="preserve">ignored</doc>
11554
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11555
+ if the callback of closure doesn't return a value.</doc>
11401
11556
  <type name="Value" c:type="GValue*"/>
11402
11557
  </parameter>
11403
11558
  <parameter name="n_param_values" transfer-ownership="none">
11404
- <doc xml:space="preserve">2</doc>
11559
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
11405
11560
  <type name="guint" c:type="guint"/>
11406
11561
  </parameter>
11407
11562
  <parameter name="param_values" transfer-ownership="none">
11408
- <doc xml:space="preserve">a #GValue array holding the instance and the #guchar parameter</doc>
11563
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11564
+ on which to invoke the callback of closure.</doc>
11409
11565
  <type name="Value" c:type="const GValue*"/>
11410
11566
  </parameter>
11411
11567
  <parameter name="invocation_hint"
11412
11568
  transfer-ownership="none"
11413
11569
  nullable="1"
11414
11570
  allow-none="1">
11415
- <doc xml:space="preserve">the invocation hint given as the last argument
11416
- to g_closure_invoke()</doc>
11571
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11572
+ g_closure_invoke().</doc>
11417
11573
  <type name="gpointer" c:type="gpointer"/>
11418
11574
  </parameter>
11419
11575
  <parameter name="marshal_data"
11420
11576
  transfer-ownership="none"
11421
11577
  nullable="1"
11422
11578
  allow-none="1">
11423
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11579
+ <doc xml:space="preserve">Additional data specified when registering the
11580
+ marshaller, see g_closure_set_marshal() and
11581
+ g_closure_set_meta_marshal()</doc>
11424
11582
  <type name="gpointer" c:type="gpointer"/>
11425
11583
  </parameter>
11426
11584
  </parameters>
@@ -11428,41 +11586,45 @@ denotes a flags type.</doc>
11428
11586
  <function name="cclosure_marshal_VOID__UINT"
11429
11587
  c:identifier="g_cclosure_marshal_VOID__UINT"
11430
11588
  moved-to="CClosure.marshal_VOID__UINT">
11431
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
11432
- `void (*callback) (gpointer instance, guint arg1, gpointer user_data)`.</doc>
11589
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with with a single
11590
+ unsigned integer argument.</doc>
11433
11591
  <return-value transfer-ownership="none">
11434
11592
  <type name="none" c:type="void"/>
11435
11593
  </return-value>
11436
11594
  <parameters>
11437
11595
  <parameter name="closure" transfer-ownership="none">
11438
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11596
+ <doc xml:space="preserve">A #GClosure.</doc>
11439
11597
  <type name="Closure" c:type="GClosure*"/>
11440
11598
  </parameter>
11441
11599
  <parameter name="return_value" transfer-ownership="none">
11442
- <doc xml:space="preserve">ignored</doc>
11600
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11601
+ if the callback of closure doesn't return a value.</doc>
11443
11602
  <type name="Value" c:type="GValue*"/>
11444
11603
  </parameter>
11445
11604
  <parameter name="n_param_values" transfer-ownership="none">
11446
- <doc xml:space="preserve">2</doc>
11605
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
11447
11606
  <type name="guint" c:type="guint"/>
11448
11607
  </parameter>
11449
11608
  <parameter name="param_values" transfer-ownership="none">
11450
- <doc xml:space="preserve">a #GValue array holding the instance and the #guint parameter</doc>
11609
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11610
+ on which to invoke the callback of closure.</doc>
11451
11611
  <type name="Value" c:type="const GValue*"/>
11452
11612
  </parameter>
11453
11613
  <parameter name="invocation_hint"
11454
11614
  transfer-ownership="none"
11455
11615
  nullable="1"
11456
11616
  allow-none="1">
11457
- <doc xml:space="preserve">the invocation hint given as the last argument
11458
- to g_closure_invoke()</doc>
11617
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11618
+ g_closure_invoke().</doc>
11459
11619
  <type name="gpointer" c:type="gpointer"/>
11460
11620
  </parameter>
11461
11621
  <parameter name="marshal_data"
11462
11622
  transfer-ownership="none"
11463
11623
  nullable="1"
11464
11624
  allow-none="1">
11465
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11625
+ <doc xml:space="preserve">Additional data specified when registering the
11626
+ marshaller, see g_closure_set_marshal() and
11627
+ g_closure_set_meta_marshal()</doc>
11466
11628
  <type name="gpointer" c:type="gpointer"/>
11467
11629
  </parameter>
11468
11630
  </parameters>
@@ -11470,41 +11632,45 @@ denotes a flags type.</doc>
11470
11632
  <function name="cclosure_marshal_VOID__UINT_POINTER"
11471
11633
  c:identifier="g_cclosure_marshal_VOID__UINT_POINTER"
11472
11634
  moved-to="CClosure.marshal_VOID__UINT_POINTER">
11473
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
11474
- `void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data)`.</doc>
11635
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a unsigned int
11636
+ and a pointer as arguments.</doc>
11475
11637
  <return-value transfer-ownership="none">
11476
11638
  <type name="none" c:type="void"/>
11477
11639
  </return-value>
11478
11640
  <parameters>
11479
11641
  <parameter name="closure" transfer-ownership="none">
11480
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11642
+ <doc xml:space="preserve">A #GClosure.</doc>
11481
11643
  <type name="Closure" c:type="GClosure*"/>
11482
11644
  </parameter>
11483
11645
  <parameter name="return_value" transfer-ownership="none">
11484
- <doc xml:space="preserve">ignored</doc>
11646
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11647
+ if the callback of closure doesn't return a value.</doc>
11485
11648
  <type name="Value" c:type="GValue*"/>
11486
11649
  </parameter>
11487
11650
  <parameter name="n_param_values" transfer-ownership="none">
11488
- <doc xml:space="preserve">3</doc>
11651
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
11489
11652
  <type name="guint" c:type="guint"/>
11490
11653
  </parameter>
11491
11654
  <parameter name="param_values" transfer-ownership="none">
11492
- <doc xml:space="preserve">a #GValue array holding instance, arg1 and arg2</doc>
11655
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11656
+ on which to invoke the callback of closure.</doc>
11493
11657
  <type name="Value" c:type="const GValue*"/>
11494
11658
  </parameter>
11495
11659
  <parameter name="invocation_hint"
11496
11660
  transfer-ownership="none"
11497
11661
  nullable="1"
11498
11662
  allow-none="1">
11499
- <doc xml:space="preserve">the invocation hint given as the last argument
11500
- to g_closure_invoke()</doc>
11663
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11664
+ g_closure_invoke().</doc>
11501
11665
  <type name="gpointer" c:type="gpointer"/>
11502
11666
  </parameter>
11503
11667
  <parameter name="marshal_data"
11504
11668
  transfer-ownership="none"
11505
11669
  nullable="1"
11506
11670
  allow-none="1">
11507
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11671
+ <doc xml:space="preserve">Additional data specified when registering the
11672
+ marshaller, see g_closure_set_marshal() and
11673
+ g_closure_set_meta_marshal()</doc>
11508
11674
  <type name="gpointer" c:type="gpointer"/>
11509
11675
  </parameter>
11510
11676
  </parameters>
@@ -11512,84 +11678,91 @@ denotes a flags type.</doc>
11512
11678
  <function name="cclosure_marshal_VOID__ULONG"
11513
11679
  c:identifier="g_cclosure_marshal_VOID__ULONG"
11514
11680
  moved-to="CClosure.marshal_VOID__ULONG">
11515
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
11516
- `void (*callback) (gpointer instance, gulong arg1, gpointer user_data)`.</doc>
11681
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
11682
+ unsigned long integer argument.</doc>
11517
11683
  <return-value transfer-ownership="none">
11518
11684
  <type name="none" c:type="void"/>
11519
11685
  </return-value>
11520
11686
  <parameters>
11521
11687
  <parameter name="closure" transfer-ownership="none">
11522
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11688
+ <doc xml:space="preserve">A #GClosure.</doc>
11523
11689
  <type name="Closure" c:type="GClosure*"/>
11524
11690
  </parameter>
11525
11691
  <parameter name="return_value" transfer-ownership="none">
11526
- <doc xml:space="preserve">ignored</doc>
11692
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11693
+ if the callback of closure doesn't return a value.</doc>
11527
11694
  <type name="Value" c:type="GValue*"/>
11528
11695
  </parameter>
11529
11696
  <parameter name="n_param_values" transfer-ownership="none">
11530
- <doc xml:space="preserve">2</doc>
11697
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
11531
11698
  <type name="guint" c:type="guint"/>
11532
11699
  </parameter>
11533
11700
  <parameter name="param_values" transfer-ownership="none">
11534
- <doc xml:space="preserve">a #GValue array holding the instance and the #gulong parameter</doc>
11701
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11702
+ on which to invoke the callback of closure.</doc>
11535
11703
  <type name="Value" c:type="const GValue*"/>
11536
11704
  </parameter>
11537
11705
  <parameter name="invocation_hint"
11538
11706
  transfer-ownership="none"
11539
11707
  nullable="1"
11540
11708
  allow-none="1">
11541
- <doc xml:space="preserve">the invocation hint given as the last argument
11542
- to g_closure_invoke()</doc>
11709
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11710
+ g_closure_invoke().</doc>
11543
11711
  <type name="gpointer" c:type="gpointer"/>
11544
11712
  </parameter>
11545
11713
  <parameter name="marshal_data"
11546
11714
  transfer-ownership="none"
11547
11715
  nullable="1"
11548
11716
  allow-none="1">
11549
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11717
+ <doc xml:space="preserve">Additional data specified when registering the
11718
+ marshaller, see g_closure_set_marshal() and
11719
+ g_closure_set_meta_marshal()</doc>
11550
11720
  <type name="gpointer" c:type="gpointer"/>
11551
11721
  </parameter>
11552
11722
  </parameters>
11553
11723
  </function>
11554
11724
  <function name="cclosure_marshal_VOID__VARIANT"
11555
11725
  c:identifier="g_cclosure_marshal_VOID__VARIANT"
11556
- moved-to="CClosure.marshal_VOID__VARIANT"
11557
- version="2.26">
11558
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
11559
- `void (*callback) (gpointer instance, GVariant *arg1, gpointer user_data)`.</doc>
11726
+ moved-to="CClosure.marshal_VOID__VARIANT">
11727
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with a single
11728
+ #GVariant argument.</doc>
11560
11729
  <return-value transfer-ownership="none">
11561
11730
  <type name="none" c:type="void"/>
11562
11731
  </return-value>
11563
11732
  <parameters>
11564
11733
  <parameter name="closure" transfer-ownership="none">
11565
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11734
+ <doc xml:space="preserve">A #GClosure.</doc>
11566
11735
  <type name="Closure" c:type="GClosure*"/>
11567
11736
  </parameter>
11568
11737
  <parameter name="return_value" transfer-ownership="none">
11569
- <doc xml:space="preserve">ignored</doc>
11738
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11739
+ if the callback of closure doesn't return a value.</doc>
11570
11740
  <type name="Value" c:type="GValue*"/>
11571
11741
  </parameter>
11572
11742
  <parameter name="n_param_values" transfer-ownership="none">
11573
- <doc xml:space="preserve">2</doc>
11743
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
11574
11744
  <type name="guint" c:type="guint"/>
11575
11745
  </parameter>
11576
11746
  <parameter name="param_values" transfer-ownership="none">
11577
- <doc xml:space="preserve">a #GValue array holding the instance and the #GVariant* parameter</doc>
11747
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11748
+ on which to invoke the callback of closure.</doc>
11578
11749
  <type name="Value" c:type="const GValue*"/>
11579
11750
  </parameter>
11580
11751
  <parameter name="invocation_hint"
11581
11752
  transfer-ownership="none"
11582
11753
  nullable="1"
11583
11754
  allow-none="1">
11584
- <doc xml:space="preserve">the invocation hint given as the last argument
11585
- to g_closure_invoke()</doc>
11755
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11756
+ g_closure_invoke().</doc>
11586
11757
  <type name="gpointer" c:type="gpointer"/>
11587
11758
  </parameter>
11588
11759
  <parameter name="marshal_data"
11589
11760
  transfer-ownership="none"
11590
11761
  nullable="1"
11591
11762
  allow-none="1">
11592
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11763
+ <doc xml:space="preserve">Additional data specified when registering the
11764
+ marshaller, see g_closure_set_marshal() and
11765
+ g_closure_set_meta_marshal()</doc>
11593
11766
  <type name="gpointer" c:type="gpointer"/>
11594
11767
  </parameter>
11595
11768
  </parameters>
@@ -11597,41 +11770,44 @@ denotes a flags type.</doc>
11597
11770
  <function name="cclosure_marshal_VOID__VOID"
11598
11771
  c:identifier="g_cclosure_marshal_VOID__VOID"
11599
11772
  moved-to="CClosure.marshal_VOID__VOID">
11600
- <doc xml:space="preserve">A marshaller for a #GCClosure with a callback of type
11601
- `void (*callback) (gpointer instance, gpointer user_data)`.</doc>
11773
+ <doc xml:space="preserve">A #GClosureMarshal function for use with signals with no arguments.</doc>
11602
11774
  <return-value transfer-ownership="none">
11603
11775
  <type name="none" c:type="void"/>
11604
11776
  </return-value>
11605
11777
  <parameters>
11606
11778
  <parameter name="closure" transfer-ownership="none">
11607
- <doc xml:space="preserve">the #GClosure to which the marshaller belongs</doc>
11779
+ <doc xml:space="preserve">A #GClosure.</doc>
11608
11780
  <type name="Closure" c:type="GClosure*"/>
11609
11781
  </parameter>
11610
11782
  <parameter name="return_value" transfer-ownership="none">
11611
- <doc xml:space="preserve">ignored</doc>
11783
+ <doc xml:space="preserve">A #GValue to store the return value. May be %NULL
11784
+ if the callback of closure doesn't return a value.</doc>
11612
11785
  <type name="Value" c:type="GValue*"/>
11613
11786
  </parameter>
11614
11787
  <parameter name="n_param_values" transfer-ownership="none">
11615
- <doc xml:space="preserve">1</doc>
11788
+ <doc xml:space="preserve">The length of the @param_values array.</doc>
11616
11789
  <type name="guint" c:type="guint"/>
11617
11790
  </parameter>
11618
11791
  <parameter name="param_values" transfer-ownership="none">
11619
- <doc xml:space="preserve">a #GValue array holding only the instance</doc>
11792
+ <doc xml:space="preserve">An array of #GValues holding the arguments
11793
+ on which to invoke the callback of closure.</doc>
11620
11794
  <type name="Value" c:type="const GValue*"/>
11621
11795
  </parameter>
11622
11796
  <parameter name="invocation_hint"
11623
11797
  transfer-ownership="none"
11624
11798
  nullable="1"
11625
11799
  allow-none="1">
11626
- <doc xml:space="preserve">the invocation hint given as the last argument
11627
- to g_closure_invoke()</doc>
11800
+ <doc xml:space="preserve">The invocation hint given as the last argument to
11801
+ g_closure_invoke().</doc>
11628
11802
  <type name="gpointer" c:type="gpointer"/>
11629
11803
  </parameter>
11630
11804
  <parameter name="marshal_data"
11631
11805
  transfer-ownership="none"
11632
11806
  nullable="1"
11633
11807
  allow-none="1">
11634
- <doc xml:space="preserve">additional data specified when registering the marshaller</doc>
11808
+ <doc xml:space="preserve">Additional data specified when registering the
11809
+ marshaller, see g_closure_set_marshal() and
11810
+ g_closure_set_meta_marshal()</doc>
11635
11811
  <type name="gpointer" c:type="gpointer"/>
11636
11812
  </parameter>
11637
11813
  </parameters>
@@ -13229,7 +13405,7 @@ g_signal_override_class_handler().</doc>
13229
13405
  c:identifier="g_signal_connect_closure">
13230
13406
  <doc xml:space="preserve">Connects a closure to a signal for a particular object.</doc>
13231
13407
  <return-value transfer-ownership="none">
13232
- <doc xml:space="preserve">the handler id (always greater than 0 for successful connections)</doc>
13408
+ <doc xml:space="preserve">the handler ID (always greater than 0 for successful connections)</doc>
13233
13409
  <type name="gulong" c:type="gulong"/>
13234
13410
  </return-value>
13235
13411
  <parameters>
@@ -13256,7 +13432,7 @@ g_signal_override_class_handler().</doc>
13256
13432
  c:identifier="g_signal_connect_closure_by_id">
13257
13433
  <doc xml:space="preserve">Connects a closure to a signal for a particular object.</doc>
13258
13434
  <return-value transfer-ownership="none">
13259
- <doc xml:space="preserve">the handler id (always greater than 0 for successful connections)</doc>
13435
+ <doc xml:space="preserve">the handler ID (always greater than 0 for successful connections)</doc>
13260
13436
  <type name="gulong" c:type="gulong"/>
13261
13437
  </return-value>
13262
13438
  <parameters>
@@ -13292,7 +13468,7 @@ which will be called when the signal handler is disconnected and no longer
13292
13468
  used. Specify @connect_flags if you need `..._after()` or
13293
13469
  `..._swapped()` variants of this function.</doc>
13294
13470
  <return-value transfer-ownership="none">
13295
- <doc xml:space="preserve">the handler id (always greater than 0 for successful connections)</doc>
13471
+ <doc xml:space="preserve">the handler ID (always greater than 0 for successful connections)</doc>
13296
13472
  <type name="gulong" c:type="gulong"/>
13297
13473
  </return-value>
13298
13474
  <parameters>
@@ -13606,7 +13782,7 @@ If no handler was found, 0 is returned.</doc>
13606
13782
  </function>
13607
13783
  <function name="signal_handler_is_connected"
13608
13784
  c:identifier="g_signal_handler_is_connected">
13609
- <doc xml:space="preserve">Returns whether @handler_id is the id of a handler connected to @instance.</doc>
13785
+ <doc xml:space="preserve">Returns whether @handler_id is the ID of a handler connected to @instance.</doc>
13610
13786
  <return-value transfer-ownership="none">
13611
13787
  <doc xml:space="preserve">whether @handler_id identifies a handler connected to @instance.</doc>
13612
13788
  <type name="gboolean" c:type="gboolean"/>
@@ -13617,7 +13793,7 @@ If no handler was found, 0 is returned.</doc>
13617
13793
  <type name="Object" c:type="gpointer"/>
13618
13794
  </parameter>
13619
13795
  <parameter name="handler_id" transfer-ownership="none">
13620
- <doc xml:space="preserve">the handler id.</doc>
13796
+ <doc xml:space="preserve">the handler ID.</doc>
13621
13797
  <type name="gulong" c:type="gulong"/>
13622
13798
  </parameter>
13623
13799
  </parameters>