gobject-introspection 3.1.1-x64-mingw32 → 3.1.2-x64-mingw32

Sign up to get free protection for your applications and to get access to all the features.
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>