detached 048deed

Gir: Run copygir

commit
048deed5532b14af05720af7741f4e657cd59bd9
author
Jeroen Wijenbergh · · 2025-10-22 07:49 UTC
parent
48cc5ec
signature
SSH UnverifiedSHA256:8N5EoON8reSTMm461SyWlzRhib6IymBjUHb1p62kwyw The key is unknown
13 files · +23804 -22294
Unified
UnifiedSplit

this diff holds invisible characters (direction controls, zero-width characters). They are shown as <U+XXXX> markers, never applied.

M internal/gir/spec/Adw-1.gir +2109 -967 large diff (3076 lines changed): collapsed
load diff
M internal/gir/spec/GLib-2.0.gir +5033 -4066
@@ -5,9 +5,11 @@ and/or use gtk-doc annotations. -->
55 <repository version="1.2"
66 xmlns="http://www.gtk.org/introspection/core/1.0"
77 xmlns:c="http://www.gtk.org/introspection/c/1.0"
8+ xmlns:doc="http://www.gtk.org/introspection/doc/1.0"
89 xmlns:glib="http://www.gtk.org/introspection/glib/1.0">
910 <package name="glib-2.0"/>
1011 <c:include name="glib.h"/>
12+ <doc:format name="gi-docgen"/>
1113 <namespace name="GLib"
1214 version="2.0"
1315 shared-library="libgobject-2.0.so.0,libglib-2.0.so.0"
@@ -38,8 +40,8 @@ The year is represented with four digits.</doc>
3840 <alias name="MainContextPusher" c:type="GMainContextPusher">
3941 <doc xml:space="preserve"
4042 filename="glib/gmain.h"
41- line="582">Opaque type. See g_main_context_pusher_new() for details.</doc>
42- <source-position filename="glib/gmain.h" line="589"/>
43+ line="583">Opaque type. See g_main_context_pusher_new() for details.</doc>
44+ <source-position filename="glib/gmain.h" line="590"/>
4345 <type name="none" c:type="void"/>
4446 </alias>
4547 <alias name="MutexLocker" c:type="GMutexLocker">
@@ -52,7 +54,7 @@ The year is represented with four digits.</doc>
5254 <alias name="Pid" c:type="GPid">
5355 <doc xml:space="preserve"
5456 filename="glib/gmain.h"
55- line="159">A type which is used to hold a process identification.
57+ line="160">A type which is used to hold a process identification.
5658
5759 On UNIX, processes are identified by a process id (an integer),
5860 while Windows uses process handles (which are pointers).
@@ -131,7 +133,7 @@ g_autofree(), so that the reference counting metadata is also freed.</doc>
131133 <alias name="Strv" c:type="GStrv">
132134 <doc xml:space="preserve"
133135 filename="glib/gstrfuncs.c"
134- line="2535">A typedef alias for gchar**. This is mostly useful when used together with
136+ line="2539">A typedef alias for gchar**. This is mostly useful when used together with
135137 `g_auto()`.</doc>
136138 <source-position filename="glib/gstrfuncs.h" line="354"/>
137139 <type name="utf8" c:type="gchar**"/>
@@ -196,23 +198,43 @@ alignment.</doc>
196198 </parameter>
197199 </parameters>
198200 </function-macro>
199- <constant name="ALLOCATOR_LIST" value="1" c:type="G_ALLOCATOR_LIST">
201+ <constant name="ALLOCATOR_LIST"
202+ value="1"
203+ c:type="G_ALLOCATOR_LIST"
204+ deprecated="1"
205+ deprecated-version="2.10">
200206 <source-position filename="glib/deprecated/gallocator.h" line="32"/>
201207 <type name="gint" c:type="gint"/>
202208 </constant>
203- <constant name="ALLOCATOR_NODE" value="3" c:type="G_ALLOCATOR_NODE">
209+ <constant name="ALLOCATOR_NODE"
210+ value="3"
211+ c:type="G_ALLOCATOR_NODE"
212+ deprecated="1"
213+ deprecated-version="2.10">
204214 <source-position filename="glib/deprecated/gallocator.h" line="34"/>
205215 <type name="gint" c:type="gint"/>
206216 </constant>
207- <constant name="ALLOCATOR_SLIST" value="2" c:type="G_ALLOCATOR_SLIST">
217+ <constant name="ALLOCATOR_SLIST"
218+ value="2"
219+ c:type="G_ALLOCATOR_SLIST"
220+ deprecated="1"
221+ deprecated-version="2.10">
208222 <source-position filename="glib/deprecated/gallocator.h" line="33"/>
209223 <type name="gint" c:type="gint"/>
210224 </constant>
211- <constant name="ALLOC_AND_FREE" value="2" c:type="G_ALLOC_AND_FREE">
225+ <constant name="ALLOC_AND_FREE"
226+ value="2"
227+ c:type="G_ALLOC_AND_FREE"
228+ deprecated="1"
229+ deprecated-version="2.10">
212230 <source-position filename="glib/deprecated/gallocator.h" line="31"/>
213231 <type name="gint" c:type="gint"/>
214232 </constant>
215- <constant name="ALLOC_ONLY" value="1" c:type="G_ALLOC_ONLY">
233+ <constant name="ALLOC_ONLY"
234+ value="1"
235+ c:type="G_ALLOC_ONLY"
236+ deprecated="1"
237+ deprecated-version="2.10">
216238 <source-position filename="glib/deprecated/gallocator.h" line="30"/>
217239 <type name="gint" c:type="gint"/>
218240 </constant>
@@ -328,9 +350,17 @@ portable to those compilers.</doc>
328350 </parameter>
329351 </parameters>
330352 </function-macro>
331- <record name="Allocator" c:type="GAllocator" disguised="1" opaque="1">
353+ <record name="Allocator"
354+ c:type="GAllocator"
355+ disguised="1"
356+ opaque="1"
357+ deprecated="1"
358+ deprecated-version="2.10">
332359 <source-position filename="glib/deprecated/gallocator.h" line="27"/>
333- <method name="free" c:identifier="g_allocator_free">
360+ <method name="free"
361+ c:identifier="g_allocator_free"
362+ deprecated="1"
363+ deprecated-version="2.10">
334364 <source-position filename="glib/deprecated/gallocator.h" line="72"/>
335365 <return-value transfer-ownership="none">
336366 <type name="none" c:type="void"/>
@@ -341,7 +371,11 @@ portable to those compilers.</doc>
341371 </instance-parameter>
342372 </parameters>
343373 </method>
344- <function name="new" c:identifier="g_allocator_new" introspectable="0">
374+ <function name="new"
375+ c:identifier="g_allocator_new"
376+ introspectable="0"
377+ deprecated="1"
378+ deprecated-version="2.10">
345379 <source-position filename="glib/deprecated/gallocator.h" line="69"/>
346380 <return-value>
347381 <type name="Allocator" c:type="GAllocator*"/>
@@ -358,25 +392,27 @@ portable to those compilers.</doc>
358392 </record>
359393 <record name="Array"
360394 c:type="GArray"
395+ copy-function="g_array_ref"
396+ free-function="g_array_unref"
361397 glib:type-name="GArray"
362398 glib:get-type="g_array_get_type"
363399 c:symbol-prefix="array">
364400 <doc xml:space="preserve"
365401 filename="glib/garray.c"
366- line="54">Contains the public fields of a GArray.</doc>
402+ line="54">Contains the public fields of a `GArray`.</doc>
367403 <source-position filename="glib/garray.h" line="47"/>
368404 <field name="data" writable="1">
369405 <doc xml:space="preserve"
370406 filename="glib/garray.c"
371407 line="56">a pointer to the element data. The data may be moved as
372- elements are added to the #GArray.</doc>
408+ elements are added to the `GArray`.</doc>
373409 <type name="utf8" c:type="gchar*"/>
374410 </field>
375411 <field name="len" writable="1">
376412 <doc xml:space="preserve"
377413 filename="glib/garray.c"
378- line="58">the number of elements in the #GArray not including the
379- possible terminating zero element.</doc>
414+ line="58">the number of elements in the `GArray` not including the
415+ possible terminating zero element</doc>
380416 <type name="guint" c:type="guint"/>
381417 </field>
382418 <function name="append_vals"
@@ -384,12 +420,15 @@ portable to those compilers.</doc>
384420 introspectable="0">
385421 <doc xml:space="preserve"
386422 filename="glib/garray.c"
387- line="564">Adds @len elements onto the end of the array.</doc>
423+ line="569">Adds @len elements onto the end of the array.
424+
425+@data may be `NULL` if (and only if) @len is zero. If @len is zero, this
426+function is a no-op.</doc>
388427 <source-position filename="glib/garray.h" line="104"/>
389- <return-value>
428+ <return-value transfer-ownership="none">
390429 <doc xml:space="preserve"
391430 filename="glib/garray.c"
392- line="572">the #GArray</doc>
431+ line="580">The `GArray`</doc>
393432 <array name="GLib.Array" c:type="GArray*">
394433 <type name="gpointer" c:type="gpointer"/>
395434 </array>
@@ -398,21 +437,24 @@ portable to those compilers.</doc>
398437 <parameter name="array" transfer-ownership="none">
399438 <doc xml:space="preserve"
400439 filename="glib/garray.c"
401- line="566">a #GArray</doc>
440+ line="571">an array</doc>
402441 <array name="GLib.Array" c:type="GArray*">
403442 <type name="gpointer" c:type="gpointer"/>
404443 </array>
405444 </parameter>
406- <parameter name="data" transfer-ownership="none">
445+ <parameter name="data"
446+ transfer-ownership="none"
447+ nullable="1"
448+ allow-none="1">
407449 <doc xml:space="preserve"
408450 filename="glib/garray.c"
409- line="567">a pointer to the elements to append to the end of the array</doc>
451+ line="572">a pointer to the elements to append to the end of the array</doc>
410452 <type name="gpointer" c:type="gconstpointer"/>
411453 </parameter>
412454 <parameter name="len" transfer-ownership="none">
413455 <doc xml:space="preserve"
414456 filename="glib/garray.c"
415- line="568">the number of elements to append</doc>
457+ line="573">the number of elements to append</doc>
416458 <type name="guint" c:type="guint"/>
417459 </parameter>
418460 </parameters>
@@ -423,18 +465,18 @@ portable to those compilers.</doc>
423465 introspectable="0">
424466 <doc xml:space="preserve"
425467 filename="glib/garray.c"
426- line="967">Checks whether @target exists in @array by performing a binary
468+ line="979">Checks whether @target exists in @array by performing a binary
427469 search based on the given comparison function @compare_func which
428-get pointers to items as arguments. If the element is found, %TRUE
470+gets pointers to items as arguments. If the element is found, true
429471 is returned and the element’s index is returned in @out_match_index
430-(if non-%NULL). Otherwise, %FALSE is returned and @out_match_index
431-is undefined. If @target exists multiple times in @array, the index
432-of the first instance is returned. This search is using a binary
433-search, so the @array must absolutely be sorted to return a correct
434-result (if not, the function may produce false-negative).
472+(if non-`NULL`). Otherwise, false is returned and @out_match_index
473+is undefined. This search is using a binary search, so the @array must
474+absolutely be sorted to return a correct result (if not, the function may
475+produce false-negative).
435476
436-This example defines a comparison function and search an element in a #GArray:
437-|[&lt;!-- language="C" --&gt;
477+This example defines a comparison function and searches an element in a
478+`GArray`:
479+```c
438480 static gint
439481 cmpint (gconstpointer a, gconstpointer b)
440482 {
@@ -448,19 +490,19 @@ gint i = 424242;
448490 guint matched_index;
449491 gboolean result = g_array_binary_search (garray, &amp;i, cmpint, &amp;matched_index);
450492 ...
451-]|</doc>
493+```</doc>
452494 <source-position filename="glib/garray.h" line="137"/>
453495 <return-value transfer-ownership="none">
454496 <doc xml:space="preserve"
455497 filename="glib/garray.c"
456- line="1002">%TRUE if @target is one of the elements of @array, %FALSE otherwise.</doc>
498+ line="1014">true if @target is one of the elements of @array; false otherwise</doc>
457499 <type name="gboolean" c:type="gboolean"/>
458500 </return-value>
459501 <parameters>
460502 <parameter name="array" transfer-ownership="none">
461503 <doc xml:space="preserve"
462504 filename="glib/garray.c"
463- line="969">a #GArray.</doc>
505+ line="981">an array</doc>
464506 <array name="GLib.Array" c:type="GArray*">
465507 <type name="gpointer" c:type="gpointer"/>
466508 </array>
@@ -471,13 +513,15 @@ gboolean result = g_array_binary_search (garray, &amp;i, cmpint, &amp;matched_in
471513 allow-none="1">
472514 <doc xml:space="preserve"
473515 filename="glib/garray.c"
474- line="970">a pointer to the item to look up.</doc>
516+ line="982">a pointer to the item to look up</doc>
475517 <type name="gpointer" c:type="gconstpointer"/>
476518 </parameter>
477- <parameter name="compare_func" transfer-ownership="none">
519+ <parameter name="compare_func"
520+ transfer-ownership="none"
521+ scope="call">
478522 <doc xml:space="preserve"
479523 filename="glib/garray.c"
480- line="971">A #GCompareFunc used to locate @target.</doc>
524+ line="983">a comparison function to locate @target</doc>
481525 <type name="CompareFunc" c:type="GCompareFunc"/>
482526 </parameter>
483527 <parameter name="out_match_index"
@@ -488,8 +532,8 @@ gboolean result = g_array_binary_search (garray, &amp;i, cmpint, &amp;matched_in
488532 allow-none="1">
489533 <doc xml:space="preserve"
490534 filename="glib/garray.c"
491- line="972">return location
492- for the index of the element, if found.</doc>
535+ line="984">the return location
536+ for the index of the element, if found</doc>
493537 <type name="guint" c:type="guint*"/>
494538 </parameter>
495539 </parameters>
@@ -500,13 +544,13 @@ gboolean result = g_array_binary_search (garray, &amp;i, cmpint, &amp;matched_in
500544 introspectable="0">
501545 <doc xml:space="preserve"
502546 filename="glib/garray.c"
503- line="1569">Create a shallow copy of a #GArray. If the array elements consist of
547+ line="1584">Creates a shallow copy of a #GArray. If the array elements consist of
504548 pointers to data, the pointers are copied but the actual data is not.</doc>
505549 <source-position filename="glib/garray.h" line="93"/>
506550 <return-value transfer-ownership="container">
507551 <doc xml:space="preserve"
508552 filename="glib/garray.c"
509- line="1576">A copy of @array.</doc>
553+ line="1591">The copy of @array</doc>
510554 <array name="GLib.Array" c:type="GArray*">
511555 <type name="gpointer" c:type="gpointer"/>
512556 </array>
@@ -515,7 +559,7 @@ pointers to data, the pointers are copied but the actual data is not.</doc>
515559 <parameter name="array" transfer-ownership="none">
516560 <doc xml:space="preserve"
517561 filename="glib/garray.c"
518- line="1571">A #GArray.</doc>
562+ line="1586">an array</doc>
519563 <array name="GLib.Array" c:type="GArray*">
520564 <type name="gpointer" c:type="gpointer"/>
521565 </array>
@@ -525,33 +569,33 @@ pointers to data, the pointers are copied but the actual data is not.</doc>
525569 <function name="free" c:identifier="g_array_free" introspectable="0">
526570 <doc xml:space="preserve"
527571 filename="glib/garray.c"
528- line="487">Frees the memory allocated for the #GArray. If @free_segment is
529-%TRUE it frees the memory block holding the elements as well. Pass
530-%FALSE if you want to free the #GArray wrapper but preserve the
572+ line="492">Frees the memory allocated for the `GArray`. If @free_segment is
573+true it frees the memory block holding the elements as well. Pass
574+false if you want to free the `GArray` wrapper but preserve the
531575 underlying array for use elsewhere. If the reference count of
532-@array is greater than one, the #GArray wrapper is preserved but
533-the size of @array will be set to zero.
576+@array is greater than one, the `GArray` wrapper is preserved but
577+the size of @array will be set to zero.
534578
535579 If array contents point to dynamically-allocated memory, they should
536-be freed separately if @free_segment is %TRUE and no @clear_func
580+be freed separately if @free_segment is true and no @clear_func
537581 function has been set for @array.
538582
539-This function is not thread-safe. If using a #GArray from multiple
540-threads, use only the atomic g_array_ref() and g_array_unref()
541-functions.</doc>
583+This function is not thread-safe. If using a `GArray` from multiple
584+threads, use only the atomic [func@GLib.Array.ref] and
585+[func@GLib.Array.unref] functions.</doc>
542586 <source-position filename="glib/garray.h" line="95"/>
543587 <return-value transfer-ownership="full">
544588 <doc xml:space="preserve"
545589 filename="glib/garray.c"
546- line="507">the element data if @free_segment is %FALSE, otherwise
547- %NULL. The element data should be freed using g_free().</doc>
590+ line="512">The allocated element data if @free_segment is false, otherwise
591+ `NULL`</doc>
548592 <type name="utf8" c:type="gchar*"/>
549593 </return-value>
550594 <parameters>
551- <parameter name="array" transfer-ownership="none">
595+ <parameter name="array" transfer-ownership="full">
552596 <doc xml:space="preserve"
553597 filename="glib/garray.c"
554- line="489">a #GArray</doc>
598+ line="494">an array</doc>
555599 <array name="GLib.Array" c:type="GArray*">
556600 <type name="gpointer" c:type="gpointer"/>
557601 </array>
@@ -559,7 +603,7 @@ functions.</doc>
559603 <parameter name="free_segment" transfer-ownership="none">
560604 <doc xml:space="preserve"
561605 filename="glib/garray.c"
562- line="490">if %TRUE the actual element data is freed as well</doc>
606+ line="495">if true, the actual element data is freed as well</doc>
563607 <type name="gboolean" c:type="gboolean"/>
564608 </parameter>
565609 </parameters>
@@ -570,19 +614,19 @@ functions.</doc>
570614 introspectable="0">
571615 <doc xml:space="preserve"
572616 filename="glib/garray.c"
573- line="467">Gets the size of the elements in @array.</doc>
617+ line="472">Gets the size of the elements in @array.</doc>
574618 <source-position filename="glib/garray.h" line="102"/>
575619 <return-value transfer-ownership="none">
576620 <doc xml:space="preserve"
577621 filename="glib/garray.c"
578- line="473">Size of each element, in bytes</doc>
622+ line="478">The size of each element, in bytes</doc>
579623 <type name="guint" c:type="guint"/>
580624 </return-value>
581625 <parameters>
582626 <parameter name="array" transfer-ownership="none">
583627 <doc xml:space="preserve"
584628 filename="glib/garray.c"
585- line="469">A #GArray</doc>
629+ line="474">an array</doc>
586630 <array name="GLib.Array" c:type="GArray*">
587631 <type name="gpointer" c:type="gpointer"/>
588632 </array>
@@ -594,7 +638,7 @@ functions.</doc>
594638 introspectable="0">
595639 <doc xml:space="preserve"
596640 filename="glib/garray.c"
597- line="673">Inserts @len elements into a #GArray at the given index.
641+ line="681">Inserts @len elements into a `GArray` at the given index.
598642
599643 If @index_ is greater than the array’s current length, the array is expanded.
600644 The elements between the old end of the array and the newly inserted elements
@@ -605,13 +649,13 @@ If @index_ is less than the array’s current length, new entries will be
605649 inserted into the array, and the existing entries above @index_ will be moved
606650 upwards.
607651
608-@data may be %NULL if (and only if) @len is zero. If @len is zero, this
652+@data may be `NULL` if (and only if) @len is zero. If @len is zero, this
609653 function is a no-op.</doc>
610654 <source-position filename="glib/garray.h" line="112"/>
611655 <return-value>
612656 <doc xml:space="preserve"
613657 filename="glib/garray.c"
614- line="694">the #GArray</doc>
658+ line="702">The `GArray`</doc>
615659 <array name="GLib.Array" c:type="GArray*">
616660 <type name="gpointer" c:type="gpointer"/>
617661 </array>
@@ -620,7 +664,7 @@ function is a no-op.</doc>
620664 <parameter name="array" transfer-ownership="none">
621665 <doc xml:space="preserve"
622666 filename="glib/garray.c"
623- line="675">a #GArray</doc>
667+ line="683">an array</doc>
624668 <array name="GLib.Array" c:type="GArray*">
625669 <type name="gpointer" c:type="gpointer"/>
626670 </array>
@@ -628,7 +672,7 @@ function is a no-op.</doc>
628672 <parameter name="index_" transfer-ownership="none">
629673 <doc xml:space="preserve"
630674 filename="glib/garray.c"
631- line="676">the index to place the elements at</doc>
675+ line="684">the index to place the elements at</doc>
632676 <type name="guint" c:type="guint"/>
633677 </parameter>
634678 <parameter name="data"
@@ -637,13 +681,13 @@ function is a no-op.</doc>
637681 allow-none="1">
638682 <doc xml:space="preserve"
639683 filename="glib/garray.c"
640- line="677">a pointer to the elements to insert</doc>
684+ line="685">a pointer to the elements to insert</doc>
641685 <type name="gpointer" c:type="gconstpointer"/>
642686 </parameter>
643687 <parameter name="len" transfer-ownership="none">
644688 <doc xml:space="preserve"
645689 filename="glib/garray.c"
646- line="678">the number of elements to insert</doc>
690+ line="686">the number of elements to insert</doc>
647691 <type name="guint" c:type="guint"/>
648692 </parameter>
649693 </parameters>
@@ -651,12 +695,12 @@ function is a no-op.</doc>
651695 <function name="new" c:identifier="g_array_new" introspectable="0">
652696 <doc xml:space="preserve"
653697 filename="glib/garray.c"
654- line="122">Creates a new #GArray with a reference count of 1.</doc>
698+ line="122">Creates a new `GArray` with a reference count of 1.</doc>
655699 <source-position filename="glib/garray.h" line="72"/>
656- <return-value>
700+ <return-value transfer-ownership="full">
657701 <doc xml:space="preserve"
658702 filename="glib/garray.c"
659- line="132">the new #GArray</doc>
703+ line="132">The new `GArray`</doc>
660704 <array name="GLib.Array" c:type="GArray*">
661705 <type name="gpointer" c:type="gpointer"/>
662706 </array>
@@ -665,14 +709,14 @@ function is a no-op.</doc>
665709 <parameter name="zero_terminated" transfer-ownership="none">
666710 <doc xml:space="preserve"
667711 filename="glib/garray.c"
668- line="124">%TRUE if the array should have an extra element at
712+ line="124">if true, the array should have an extra element at
669713 the end which is set to 0</doc>
670714 <type name="gboolean" c:type="gboolean"/>
671715 </parameter>
672716 <parameter name="clear_" transfer-ownership="none">
673717 <doc xml:space="preserve"
674718 filename="glib/garray.c"
675- line="126">%TRUE if #GArray elements should be automatically cleared
719+ line="126">if true, `GArray` elements should be automatically cleared
676720 to 0 when they are allocated</doc>
677721 <type name="gboolean" c:type="gboolean"/>
678722 </parameter>
@@ -690,27 +734,27 @@ function is a no-op.</doc>
690734 introspectable="0">
691735 <doc xml:space="preserve"
692736 filename="glib/garray.c"
693- line="147">Creates a new #GArray with @data as array data, @len as length and a
737+ line="147">Creates a new `GArray` with @data as array data, @len as length and a
694738 reference count of 1.
695739
696740 This avoids having to copy the data manually, when it can just be
697741 inherited.
698-After this call, @data belongs to the #GArray and may no longer be
742+After this call, @data belongs to the `GArray` and may no longer be
699743 modified by the caller. The memory of @data has to be dynamically
700-allocated and will eventually be freed with g_free().
744+allocated and will eventually be freed with [func@GLib.free].
701745
702746 In case the elements need to be cleared when the array is freed, use
703-g_array_set_clear_func() to set a #GDestroyNotify function to perform
704-such task.
747+[func@GLib.Array.set_clear_func] to set a [callback@GLib.DestroyNotify]
748+function to perform such task.
705749
706-Do not use it if @len or @element_size are greater than %G_MAXUINT.
707-#GArray stores the length of its data in #guint, which may be shorter
708-than #gsize.</doc>
750+Do not use it if @len or @element_size are greater than
751+ [`G_MAXUINT`](types.html#guint). `GArray` stores the length of its data in
752+ `guint`, which may be shorter than `gsize`.</doc>
709753 <source-position filename="glib/garray.h" line="76"/>
710754 <return-value transfer-ownership="full">
711755 <doc xml:space="preserve"
712756 filename="glib/garray.c"
713- line="173">A new #GArray</doc>
757+ line="173">The new #GArray</doc>
714758 <array name="GLib.Array" c:type="GArray*">
715759 <type name="gpointer" c:type="gpointer"/>
716760 </array>
@@ -723,7 +767,7 @@ than #gsize.</doc>
723767 <doc xml:space="preserve"
724768 filename="glib/garray.c"
725769 line="149">an array of
726- elements of @element_size, or %NULL for an empty array</doc>
770+ elements of @element_size</doc>
727771 <array length="1" zero-terminated="0" c:type="gpointer">
728772 <type name="gpointer" c:type="gpointer"/>
729773 </array>
@@ -737,7 +781,7 @@ than #gsize.</doc>
737781 <parameter name="clear" transfer-ownership="none">
738782 <doc xml:space="preserve"
739783 filename="glib/garray.c"
740- line="152">%TRUE if #GArray elements should be automatically cleared
784+ line="152">if true, `GArray` elements should be automatically cleared
741785 to 0 when they are allocated</doc>
742786 <type name="gboolean" c:type="gboolean"/>
743787 </parameter>
@@ -755,39 +799,43 @@ than #gsize.</doc>
755799 introspectable="0">
756800 <doc xml:space="preserve"
757801 filename="glib/garray.c"
758- line="199">Creates a new #GArray with @data as array data, computing the length of it
802+ line="199">Creates a new `GArray` with @data as array data, computing the length of it
759803 and setting the reference count to 1.
760804
761805 This avoids having to copy the data manually, when it can just be
762806 inherited.
763-After this call, @data belongs to the #GArray and may no longer be
807+After this call, @data belongs to the `GArray` and may no longer be
764808 modified by the caller. The memory of @data has to be dynamically
765-allocated and will eventually be freed with g_free().
809+allocated and will eventually be freed with [func@GLib.free].
766810
767-The length is calculated by iterating through @data until the first %NULL
811+The length is calculated by iterating through @data until the first `NULL`
768812 element is found.
769813
770814 In case the elements need to be cleared when the array is freed, use
771-g_array_set_clear_func() to set a #GDestroyNotify function to perform
772-such task.
815+[func@GLib.Array.set_clear_func] to set a [callback@GLib.DestroyNotify]
816+function to perform such task.
773817
774-Do not use it if @data length or @element_size are greater than %G_MAXUINT.
775-#GArray stores the length of its data in #guint, which may be shorter
776-than #gsize.</doc>
818+Do not use it if @data length or @element_size are greater than
819+[`G_MAXUINT`](types.html#guint). `GArray` stores the length of its data in
820+`guint`, which may be shorter than `gsize`.</doc>
777821 <source-position filename="glib/garray.h" line="81"/>
778822 <return-value transfer-ownership="full">
779823 <doc xml:space="preserve"
780824 filename="glib/garray.c"
781- line="226">A new #GArray</doc>
825+ line="227">The new `GArray`</doc>
782826 <array name="GLib.Array" c:type="GArray*">
783827 <type name="gpointer" c:type="gpointer"/>
784828 </array>
785829 </return-value>
786830 <parameters>
787- <parameter name="data" transfer-ownership="none">
831+ <parameter name="data"
832+ transfer-ownership="full"
833+ nullable="1"
834+ allow-none="1">
788835 <doc xml:space="preserve"
789836 filename="glib/garray.c"
790- line="201">an array of elements of @element_size</doc>
837+ line="201">an array
838+ of elements of @element_size, `NULL` terminated</doc>
791839 <array c:type="gpointer">
792840 <type name="gpointer" c:type="gpointer"/>
793841 </array>
@@ -795,14 +843,14 @@ than #gsize.</doc>
795843 <parameter name="clear" transfer-ownership="none">
796844 <doc xml:space="preserve"
797845 filename="glib/garray.c"
798- line="202">%TRUE if #GArray elements should be automatically cleared
846+ line="203">if true, `GArray` elements should be automatically cleared
799847 to 0 when they are allocated</doc>
800848 <type name="gboolean" c:type="gboolean"/>
801849 </parameter>
802850 <parameter name="element_size" transfer-ownership="none">
803851 <doc xml:space="preserve"
804852 filename="glib/garray.c"
805- line="204">the size of each element in bytes</doc>
853+ line="205">the size of each element in bytes</doc>
806854 <type name="gsize" c:type="gsize"/>
807855 </parameter>
808856 </parameters>
@@ -812,19 +860,19 @@ than #gsize.</doc>
812860 introspectable="0">
813861 <doc xml:space="preserve"
814862 filename="glib/garray.c"
815- line="612">Adds @len elements onto the start of the array.
863+ line="620">Adds @len elements onto the start of the array.
816864
817-@data may be %NULL if (and only if) @len is zero. If @len is zero, this
865+@data may be `NULL` if (and only if) @len is zero. If @len is zero, this
818866 function is a no-op.
819867
820-This operation is slower than g_array_append_vals() since the
868+This operation is slower than [func@GLib.Array.append_vals] since the
821869 existing elements in the array have to be moved to make space for
822870 the new elements.</doc>
823871 <source-position filename="glib/garray.h" line="108"/>
824- <return-value>
872+ <return-value transfer-ownership="none">
825873 <doc xml:space="preserve"
826874 filename="glib/garray.c"
827- line="627">the #GArray</doc>
875+ line="635">The `GArray`</doc>
828876 <array name="GLib.Array" c:type="GArray*">
829877 <type name="gpointer" c:type="gpointer"/>
830878 </array>
@@ -833,7 +881,7 @@ the new elements.</doc>
833881 <parameter name="array" transfer-ownership="none">
834882 <doc xml:space="preserve"
835883 filename="glib/garray.c"
836- line="614">a #GArray</doc>
884+ line="622">an array</doc>
837885 <array name="GLib.Array" c:type="GArray*">
838886 <type name="gpointer" c:type="gpointer"/>
839887 </array>
@@ -844,13 +892,13 @@ the new elements.</doc>
844892 allow-none="1">
845893 <doc xml:space="preserve"
846894 filename="glib/garray.c"
847- line="615">a pointer to the elements to prepend to the start of the array</doc>
895+ line="623">a pointer to the elements to prepend to the start of the array</doc>
848896 <type name="gpointer" c:type="gconstpointer"/>
849897 </parameter>
850898 <parameter name="len" transfer-ownership="none">
851899 <doc xml:space="preserve"
852900 filename="glib/garray.c"
853- line="616">the number of elements to prepend, which may be zero</doc>
901+ line="624">the number of elements to prepend, which may be zero</doc>
854902 <type name="guint" c:type="guint"/>
855903 </parameter>
856904 </parameters>
@@ -861,13 +909,13 @@ the new elements.</doc>
861909 introspectable="0">
862910 <doc xml:space="preserve"
863911 filename="glib/garray.c"
864- line="416">Atomically increments the reference count of @array by one.
912+ line="421">Atomically increments the reference count of @array by one.
865913 This function is thread-safe and may be called from any thread.</doc>
866914 <source-position filename="glib/garray.h" line="98"/>
867- <return-value>
915+ <return-value transfer-ownership="full">
868916 <doc xml:space="preserve"
869917 filename="glib/garray.c"
870- line="423">The passed in #GArray</doc>
918+ line="428">The passed in `GArray`</doc>
871919 <array name="GLib.Array" c:type="GArray*">
872920 <type name="gpointer" c:type="gpointer"/>
873921 </array>
@@ -876,7 +924,7 @@ This function is thread-safe and may be called from any thread.</doc>
876924 <parameter name="array" transfer-ownership="none">
877925 <doc xml:space="preserve"
878926 filename="glib/garray.c"
879- line="418">A #GArray</doc>
927+ line="423">an array</doc>
880928 <array name="GLib.Array" c:type="GArray*">
881929 <type name="gpointer" c:type="gpointer"/>
882930 </array>
@@ -888,13 +936,13 @@ This function is thread-safe and may be called from any thread.</doc>
888936 introspectable="0">
889937 <doc xml:space="preserve"
890938 filename="glib/garray.c"
891- line="781">Removes the element at the given index from a #GArray. The following
939+ line="790">Removes the element at the given index from a `GArray`. The following
892940 elements are moved down one place.</doc>
893941 <source-position filename="glib/garray.h" line="120"/>
894- <return-value>
942+ <return-value transfer-ownership="none">
895943 <doc xml:space="preserve"
896944 filename="glib/garray.c"
897- line="789">the #GArray</doc>
945+ line="798">The `GArray`</doc>
898946 <array name="GLib.Array" c:type="GArray*">
899947 <type name="gpointer" c:type="gpointer"/>
900948 </array>
@@ -903,7 +951,7 @@ elements are moved down one place.</doc>
903951 <parameter name="array" transfer-ownership="none">
904952 <doc xml:space="preserve"
905953 filename="glib/garray.c"
906- line="783">a #GArray</doc>
954+ line="792">an array</doc>
907955 <array name="GLib.Array" c:type="GArray*">
908956 <type name="gpointer" c:type="gpointer"/>
909957 </array>
@@ -911,7 +959,7 @@ elements are moved down one place.</doc>
911959 <parameter name="index_" transfer-ownership="none">
912960 <doc xml:space="preserve"
913961 filename="glib/garray.c"
914- line="784">the index of the element to remove</doc>
962+ line="793">the index of the element to remove</doc>
915963 <type name="guint" c:type="guint"/>
916964 </parameter>
917965 </parameters>
@@ -921,15 +969,15 @@ elements are moved down one place.</doc>
921969 introspectable="0">
922970 <doc xml:space="preserve"
923971 filename="glib/garray.c"
924- line="819">Removes the element at the given index from a #GArray. The last
972+ line="828">Removes the element at the given index from a `GArray`. The last
925973 element in the array is used to fill in the space, so this function
926-does not preserve the order of the #GArray. But it is faster than
927-g_array_remove_index().</doc>
974+does not preserve the order of the `GArray`. But it is faster than
975+[func@GLib.Array.remove_index].</doc>
928976 <source-position filename="glib/garray.h" line="123"/>
929- <return-value>
977+ <return-value transfer-ownership="none">
930978 <doc xml:space="preserve"
931979 filename="glib/garray.c"
932- line="829">the #GArray</doc>
980+ line="838">The `GArray`</doc>
933981 <array name="GLib.Array" c:type="GArray*">
934982 <type name="gpointer" c:type="gpointer"/>
935983 </array>
@@ -938,7 +986,7 @@ g_array_remove_index().</doc>
938986 <parameter name="array" transfer-ownership="none">
939987 <doc xml:space="preserve"
940988 filename="glib/garray.c"
941- line="821">a @GArray</doc>
989+ line="830">an array</doc>
942990 <array name="GLib.Array" c:type="GArray*">
943991 <type name="gpointer" c:type="gpointer"/>
944992 </array>
@@ -946,7 +994,7 @@ g_array_remove_index().</doc>
946994 <parameter name="index_" transfer-ownership="none">
947995 <doc xml:space="preserve"
948996 filename="glib/garray.c"
949- line="822">the index of the element to remove</doc>
997+ line="831">the index of the element to remove</doc>
950998 <type name="guint" c:type="guint"/>
951999 </parameter>
9521000 </parameters>
@@ -957,13 +1005,13 @@ g_array_remove_index().</doc>
9571005 introspectable="0">
9581006 <doc xml:space="preserve"
9591007 filename="glib/garray.c"
960- line="859">Removes the given number of elements starting at the given index
961-from a #GArray. The following elements are moved to close the gap.</doc>
1008+ line="868">Removes the given number of elements starting at the given index
1009+from a `GArray`. The following elements are moved to close the gap.</doc>
9621010 <source-position filename="glib/garray.h" line="126"/>
963- <return-value>
1011+ <return-value transfer-ownership="none">
9641012 <doc xml:space="preserve"
9651013 filename="glib/garray.c"
966- line="868">the #GArray</doc>
1014+ line="877">The `GArray`</doc>
9671015 <array name="GLib.Array" c:type="GArray*">
9681016 <type name="gpointer" c:type="gpointer"/>
9691017 </array>
@@ -972,7 +1020,7 @@ from a #GArray. The following elements are moved to close the gap.</doc>
9721020 <parameter name="array" transfer-ownership="none">
9731021 <doc xml:space="preserve"
9741022 filename="glib/garray.c"
975- line="861">a @GArray</doc>
1023+ line="870">an array</doc>
9761024 <array name="GLib.Array" c:type="GArray*">
9771025 <type name="gpointer" c:type="gpointer"/>
9781026 </array>
@@ -980,13 +1028,13 @@ from a #GArray. The following elements are moved to close the gap.</doc>
9801028 <parameter name="index_" transfer-ownership="none">
9811029 <doc xml:space="preserve"
9821030 filename="glib/garray.c"
983- line="862">the index of the first element to remove</doc>
1031+ line="871">the index of the first element to remove</doc>
9841032 <type name="guint" c:type="guint"/>
9851033 </parameter>
9861034 <parameter name="length" transfer-ownership="none">
9871035 <doc xml:space="preserve"
9881036 filename="glib/garray.c"
989- line="863">the number of elements to remove</doc>
1037+ line="872">the number of elements to remove</doc>
9901038 <type name="guint" c:type="guint"/>
9911039 </parameter>
9921040 </parameters>
@@ -997,18 +1045,18 @@ from a #GArray. The following elements are moved to close the gap.</doc>
9971045 introspectable="0">
9981046 <doc xml:space="preserve"
9991047 filename="glib/garray.c"
1000- line="366">Sets a function to clear an element of @array.
1048+ line="371">Sets a function to clear an element of @array.
10011049
10021050 The @clear_func will be called when an element in the array
10031051 data segment is removed and when the array is freed and data
10041052 segment is deallocated as well. @clear_func will be passed a
10051053 pointer to the element to clear, rather than the element itself.
10061054
1007-Note that in contrast with other uses of #GDestroyNotify
1055+Note that in contrast with other uses of [callback@GLib.DestroyNotify]
10081056 functions, @clear_func is expected to clear the contents of
10091057 the array element it is given, but not free the element itself.
10101058
1011-|[&lt;!-- language="C" --&gt;
1059+```c
10121060 typedef struct
10131061 {
10141062 gchar *str;
@@ -1027,7 +1075,7 @@ GArray *garray = g_array_new (FALSE, FALSE, sizeof (ArrayElement));
10271075 g_array_set_clear_func (garray, (GDestroyNotify) array_element_clear);
10281076 // assign data to the structure
10291077 g_array_free (garray, TRUE);
1030-]|</doc>
1078+```</doc>
10311079 <source-position filename="glib/garray.h" line="142"/>
10321080 <return-value transfer-ownership="none">
10331081 <type name="none" c:type="void"/>
@@ -1036,15 +1084,19 @@ g_array_free (garray, TRUE);
10361084 <parameter name="array" transfer-ownership="none">
10371085 <doc xml:space="preserve"
10381086 filename="glib/garray.c"
1039- line="368">A #GArray</doc>
1087+ line="373">an array</doc>
10401088 <array name="GLib.Array" c:type="GArray*">
10411089 <type name="gpointer" c:type="gpointer"/>
10421090 </array>
10431091 </parameter>
1044- <parameter name="clear_func" transfer-ownership="none" scope="async">
1092+ <parameter name="clear_func"
1093+ transfer-ownership="none"
1094+ nullable="1"
1095+ allow-none="1"
1096+ scope="async">
10451097 <doc xml:space="preserve"
10461098 filename="glib/garray.c"
1047- line="369">a function to clear an element of @array</doc>
1099+ line="374">a function to clear an element of @array</doc>
10481100 <type name="DestroyNotify" c:type="GDestroyNotify"/>
10491101 </parameter>
10501102 </parameters>
@@ -1054,13 +1106,13 @@ g_array_free (garray, TRUE);
10541106 introspectable="0">
10551107 <doc xml:space="preserve"
10561108 filename="glib/garray.c"
1057- line="746">Sets the size of the array, expanding it if necessary. If the array
1058-was created with @clear_ set to %TRUE, the new elements are set to 0.</doc>
1109+ line="754">Sets the size of the array, expanding it if necessary. If the array
1110+was created with @clear_ set to true, the new elements are set to 0.</doc>
10591111 <source-position filename="glib/garray.h" line="117"/>
1060- <return-value>
1112+ <return-value transfer-ownership="none">
10611113 <doc xml:space="preserve"
10621114 filename="glib/garray.c"
1063- line="754">the #GArray</doc>
1115+ line="762">The `GArray`</doc>
10641116 <array name="GLib.Array" c:type="GArray*">
10651117 <type name="gpointer" c:type="gpointer"/>
10661118 </array>
@@ -1069,7 +1121,7 @@ was created with @clear_ set to %TRUE, the new elements are set to 0.</doc>
10691121 <parameter name="array" transfer-ownership="none">
10701122 <doc xml:space="preserve"
10711123 filename="glib/garray.c"
1072- line="748">a #GArray</doc>
1124+ line="756">an array</doc>
10731125 <array name="GLib.Array" c:type="GArray*">
10741126 <type name="gpointer" c:type="gpointer"/>
10751127 </array>
@@ -1077,7 +1129,7 @@ was created with @clear_ set to %TRUE, the new elements are set to 0.</doc>
10771129 <parameter name="length" transfer-ownership="none">
10781130 <doc xml:space="preserve"
10791131 filename="glib/garray.c"
1080- line="749">the new size of the #GArray</doc>
1132+ line="757">the new size of the #GArray</doc>
10811133 <type name="guint" c:type="guint"/>
10821134 </parameter>
10831135 </parameters>
@@ -1087,15 +1139,15 @@ was created with @clear_ set to %TRUE, the new elements are set to 0.</doc>
10871139 introspectable="0">
10881140 <doc xml:space="preserve"
10891141 filename="glib/garray.c"
1090- line="315">Creates a new #GArray with @reserved_size elements preallocated and
1142+ line="320">Creates a new `GArray` with @reserved_size elements preallocated and
10911143 a reference count of 1. This avoids frequent reallocation, if you
10921144 are going to add many elements to the array. Note however that the
10931145 size of the array is still 0.</doc>
10941146 <source-position filename="glib/garray.h" line="88"/>
1095- <return-value>
1147+ <return-value transfer-ownership="full">
10961148 <doc xml:space="preserve"
10971149 filename="glib/garray.c"
1098- line="329">the new #GArray</doc>
1150+ line="334">The new `GArray`</doc>
10991151 <array name="GLib.Array" c:type="GArray*">
11001152 <type name="gpointer" c:type="gpointer"/>
11011153 </array>
@@ -1104,27 +1156,27 @@ size of the array is still 0.</doc>
11041156 <parameter name="zero_terminated" transfer-ownership="none">
11051157 <doc xml:space="preserve"
11061158 filename="glib/garray.c"
1107- line="317">%TRUE if the array should have an extra element at
1159+ line="322">if true, the array should have an extra element at
11081160 the end with all bits cleared</doc>
11091161 <type name="gboolean" c:type="gboolean"/>
11101162 </parameter>
11111163 <parameter name="clear_" transfer-ownership="none">
11121164 <doc xml:space="preserve"
11131165 filename="glib/garray.c"
1114- line="319">%TRUE if all bits in the array should be cleared to 0 on
1166+ line="324">if true, all bits in the array should be cleared to 0 on
11151167 allocation</doc>
11161168 <type name="gboolean" c:type="gboolean"/>
11171169 </parameter>
11181170 <parameter name="element_size" transfer-ownership="none">
11191171 <doc xml:space="preserve"
11201172 filename="glib/garray.c"
1121- line="321">size of each element in the array</doc>
1173+ line="326">the size of each element in the array</doc>
11221174 <type name="guint" c:type="guint"/>
11231175 </parameter>
11241176 <parameter name="reserved_size" transfer-ownership="none">
11251177 <doc xml:space="preserve"
11261178 filename="glib/garray.c"
1127- line="322">number of elements preallocated</doc>
1179+ line="327">the number of elements preallocated</doc>
11281180 <type name="guint" c:type="guint"/>
11291181 </parameter>
11301182 </parameters>
@@ -1132,7 +1184,7 @@ size of the array is still 0.</doc>
11321184 <function name="sort" c:identifier="g_array_sort" introspectable="0">
11331185 <doc xml:space="preserve"
11341186 filename="glib/garray.c"
1135- line="906">Sorts a #GArray using @compare_func which should be a qsort()-style
1187+ line="918">Sorts a `GArray` using @compare_func which should be a `qsort()`-style
11361188 comparison function (returns less than zero for first arg is less
11371189 than second arg, zero for equal, greater zero if first arg is
11381190 greater than second arg).
@@ -1146,15 +1198,17 @@ This is guaranteed to be a stable sort since version 2.32.</doc>
11461198 <parameter name="array" transfer-ownership="none">
11471199 <doc xml:space="preserve"
11481200 filename="glib/garray.c"
1149- line="908">a #GArray</doc>
1201+ line="920">an array</doc>
11501202 <array name="GLib.Array" c:type="GArray*">
11511203 <type name="gpointer" c:type="gpointer"/>
11521204 </array>
11531205 </parameter>
1154- <parameter name="compare_func" transfer-ownership="none">
1206+ <parameter name="compare_func"
1207+ transfer-ownership="none"
1208+ scope="call">
11551209 <doc xml:space="preserve"
11561210 filename="glib/garray.c"
1157- line="909">comparison function</doc>
1211+ line="921">a comparison function</doc>
11581212 <type name="CompareFunc" c:type="GCompareFunc"/>
11591213 </parameter>
11601214 </parameters>
@@ -1164,7 +1218,7 @@ This is guaranteed to be a stable sort since version 2.32.</doc>
11641218 introspectable="0">
11651219 <doc xml:space="preserve"
11661220 filename="glib/garray.c"
1167- line="935">Like g_array_sort(), but the comparison function receives an extra
1221+ line="947">Like [func@GLib.Array.sort], but the comparison function receives an extra
11681222 user data argument.
11691223
11701224 This is guaranteed to be a stable sort since version 2.32.
@@ -1180,15 +1234,18 @@ This did not actually work, so any such code should be removed.</doc>
11801234 <parameter name="array" transfer-ownership="none">
11811235 <doc xml:space="preserve"
11821236 filename="glib/garray.c"
1183- line="937">a #GArray</doc>
1237+ line="949">an array</doc>
11841238 <array name="GLib.Array" c:type="GArray*">
11851239 <type name="gpointer" c:type="gpointer"/>
11861240 </array>
11871241 </parameter>
1188- <parameter name="compare_func" transfer-ownership="none" closure="2">
1242+ <parameter name="compare_func"
1243+ transfer-ownership="none"
1244+ scope="call"
1245+ closure="2">
11891246 <doc xml:space="preserve"
11901247 filename="glib/garray.c"
1191- line="938">comparison function</doc>
1248+ line="950">a comparison function</doc>
11921249 <type name="CompareDataFunc" c:type="GCompareDataFunc"/>
11931250 </parameter>
11941251 <parameter name="user_data"
@@ -1197,7 +1254,7 @@ This did not actually work, so any such code should be removed.</doc>
11971254 allow-none="1">
11981255 <doc xml:space="preserve"
11991256 filename="glib/garray.c"
1200- line="939">data to pass to @compare_func</doc>
1257+ line="951">the data to pass to @compare_func</doc>
12011258 <type name="gpointer" c:type="gpointer"/>
12021259 </parameter>
12031260 </parameters>
@@ -1208,37 +1265,37 @@ This did not actually work, so any such code should be removed.</doc>
12081265 introspectable="0">
12091266 <doc xml:space="preserve"
12101267 filename="glib/garray.c"
1211- line="264">Frees the data in the array and resets the size to zero, while
1268+ line="269">Frees the data in the array and resets the size to zero, while
12121269 the underlying array is preserved for use elsewhere and returned
12131270 to the caller.
12141271
1215-If the array was created with the @zero_terminate property
1216-set to %TRUE, the returned data is zero terminated too.
1272+Note that if the array was created with the @zero_terminate
1273+property set to true, this may still return `NULL` if the length
1274+of the array was zero and data was not yet allocated.
12171275
12181276 If array elements contain dynamically-allocated memory,
12191277 the array elements should also be freed by the caller.
12201278
12211279 A short example of use:
1222-|[&lt;!-- language="C" --&gt;
1280+```c
12231281 ...
12241282 gpointer data;
12251283 gsize data_len;
12261284 data = g_array_steal (some_array, &amp;data_len);
12271285 ...
1228-]|</doc>
1286+```</doc>
12291287 <source-position filename="glib/garray.h" line="85"/>
12301288 <return-value transfer-ownership="full" nullable="1">
12311289 <doc xml:space="preserve"
12321290 filename="glib/garray.c"
1233- line="289">the element data, which should be
1234- freed using g_free().</doc>
1291+ line="295">The allocated element data</doc>
12351292 <type name="gpointer" c:type="gpointer"/>
12361293 </return-value>
12371294 <parameters>
12381295 <parameter name="array" transfer-ownership="none">
12391296 <doc xml:space="preserve"
12401297 filename="glib/garray.c"
1241- line="266">a #GArray.</doc>
1298+ line="271">an array</doc>
12421299 <array name="GLib.Array" c:type="GArray*">
12431300 <type name="gpointer" c:type="gpointer"/>
12441301 </array>
@@ -1251,7 +1308,7 @@ data = g_array_steal (some_array, &amp;data_len);
12511308 allow-none="1">
12521309 <doc xml:space="preserve"
12531310 filename="glib/garray.c"
1254- line="267">pointer to retrieve the number of
1311+ line="272">a pointer to retrieve the number of
12551312 elements of the original array</doc>
12561313 <type name="gsize" c:type="gsize*"/>
12571314 </parameter>
@@ -1263,19 +1320,19 @@ data = g_array_steal (some_array, &amp;data_len);
12631320 introspectable="0">
12641321 <doc xml:space="preserve"
12651322 filename="glib/garray.c"
1266- line="446">Atomically decrements the reference count of @array by one. If the
1323+ line="451">Atomically decrements the reference count of @array by one. If the
12671324 reference count drops to 0, the effect is the same as calling
1268-g_array_free() with @free_segment set to %TRUE. This function is
1325+[func@GLib.Array.free] with @free_segment set to true. This function is
12691326 thread-safe and may be called from any thread.</doc>
12701327 <source-position filename="glib/garray.h" line="100"/>
12711328 <return-value transfer-ownership="none">
12721329 <type name="none" c:type="void"/>
12731330 </return-value>
12741331 <parameters>
1275- <parameter name="array" transfer-ownership="none">
1332+ <parameter name="array" transfer-ownership="full">
12761333 <doc xml:space="preserve"
12771334 filename="glib/garray.c"
1278- line="448">A #GArray</doc>
1335+ line="453">an array</doc>
12791336 <array name="GLib.Array" c:type="GArray*">
12801337 <type name="gpointer" c:type="gpointer"/>
12811338 </array>
@@ -1323,7 +1380,7 @@ It should only be accessed through the `g_async_queue_*` functions.</doc>
13231380 <method name="length" c:identifier="g_async_queue_length">
13241381 <doc xml:space="preserve"
13251382 filename="glib/gasyncqueue.c"
1326- line="618">Returns the length of the queue.
1383+ line="619">Returns the length of the queue.
13271384
13281385 Actually this function returns the number of data items in
13291386 the queue minus the number of waiting threads, so a negative
@@ -1335,14 +1392,14 @@ of the queue or due to scheduling.</doc>
13351392 <return-value transfer-ownership="none">
13361393 <doc xml:space="preserve"
13371394 filename="glib/gasyncqueue.c"
1338- line="631">the length of the @queue</doc>
1395+ line="632">the length of the @queue</doc>
13391396 <type name="gint" c:type="gint"/>
13401397 </return-value>
13411398 <parameters>
13421399 <instance-parameter name="queue" transfer-ownership="none">
13431400 <doc xml:space="preserve"
13441401 filename="glib/gasyncqueue.c"
1345- line="620">a #GAsyncQueue.</doc>
1402+ line="621">a #GAsyncQueue.</doc>
13461403 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
13471404 </instance-parameter>
13481405 </parameters>
@@ -1351,7 +1408,7 @@ of the queue or due to scheduling.</doc>
13511408 c:identifier="g_async_queue_length_unlocked">
13521409 <doc xml:space="preserve"
13531410 filename="glib/gasyncqueue.c"
1354- line="647">Returns the length of the queue.
1411+ line="648">Returns the length of the queue.
13551412
13561413 Actually this function returns the number of data items in
13571414 the queue minus the number of waiting threads, so a negative
@@ -1365,14 +1422,14 @@ This function must be called while holding the @queue's lock.</doc>
13651422 <return-value transfer-ownership="none">
13661423 <doc xml:space="preserve"
13671424 filename="glib/gasyncqueue.c"
1368- line="662">the length of the @queue.</doc>
1425+ line="663">the length of the @queue.</doc>
13691426 <type name="gint" c:type="gint"/>
13701427 </return-value>
13711428 <parameters>
13721429 <instance-parameter name="queue" transfer-ownership="none">
13731430 <doc xml:space="preserve"
13741431 filename="glib/gasyncqueue.c"
1375- line="649">a #GAsyncQueue</doc>
1432+ line="650">a #GAsyncQueue</doc>
13761433 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
13771434 </instance-parameter>
13781435 </parameters>
@@ -1405,20 +1462,20 @@ deadlock may occur.</doc>
14051462 <method name="pop" c:identifier="g_async_queue_pop">
14061463 <doc xml:space="preserve"
14071464 filename="glib/gasyncqueue.c"
1408- line="392">Pops data from the @queue. If @queue is empty, this function
1465+ line="393">Pops data from the @queue. If @queue is empty, this function
14091466 blocks until data becomes available.</doc>
14101467 <source-position filename="glib/gasyncqueue.h" line="76"/>
1411- <return-value transfer-ownership="none" nullable="1">
1468+ <return-value transfer-ownership="full">
14121469 <doc xml:space="preserve"
14131470 filename="glib/gasyncqueue.c"
1414- line="399">data from the queue</doc>
1471+ line="400">data from the queue</doc>
14151472 <type name="gpointer" c:type="gpointer"/>
14161473 </return-value>
14171474 <parameters>
14181475 <instance-parameter name="queue" transfer-ownership="none">
14191476 <doc xml:space="preserve"
14201477 filename="glib/gasyncqueue.c"
1421- line="394">a #GAsyncQueue</doc>
1478+ line="395">a #GAsyncQueue</doc>
14221479 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
14231480 </instance-parameter>
14241481 </parameters>
@@ -1426,22 +1483,22 @@ blocks until data becomes available.</doc>
14261483 <method name="pop_unlocked" c:identifier="g_async_queue_pop_unlocked">
14271484 <doc xml:space="preserve"
14281485 filename="glib/gasyncqueue.c"
1429- line="415">Pops data from the @queue. If @queue is empty, this function
1486+ line="416">Pops data from the @queue. If @queue is empty, this function
14301487 blocks until data becomes available.
14311488
14321489 This function must be called while holding the @queue's lock.</doc>
14331490 <source-position filename="glib/gasyncqueue.h" line="78"/>
1434- <return-value transfer-ownership="none" nullable="1">
1491+ <return-value transfer-ownership="full">
14351492 <doc xml:space="preserve"
14361493 filename="glib/gasyncqueue.c"
1437- line="424">data from the queue.</doc>
1494+ line="425">data from the queue.</doc>
14381495 <type name="gpointer" c:type="gpointer"/>
14391496 </return-value>
14401497 <parameters>
14411498 <instance-parameter name="queue" transfer-ownership="none">
14421499 <doc xml:space="preserve"
14431500 filename="glib/gasyncqueue.c"
1444- line="417">a #GAsyncQueue</doc>
1501+ line="418">a #GAsyncQueue</doc>
14451502 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
14461503 </instance-parameter>
14471504 </parameters>
@@ -1463,7 +1520,7 @@ The @data parameter must not be %NULL.</doc>
14631520 line="233">a #GAsyncQueue</doc>
14641521 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
14651522 </instance-parameter>
1466- <parameter name="data" transfer-ownership="none">
1523+ <parameter name="data" transfer-ownership="full">
14671524 <doc xml:space="preserve"
14681525 filename="glib/gasyncqueue.c"
14691526 line="234">data to push onto the @queue</doc>
@@ -1476,7 +1533,7 @@ The @data parameter must not be %NULL.</doc>
14761533 version="2.46">
14771534 <doc xml:space="preserve"
14781535 filename="glib/gasyncqueue.c"
1479- line="802">Pushes the @item into the @queue. @item must not be %NULL.
1536+ line="803">Pushes the @item into the @queue. @item must not be %NULL.
14801537 In contrast to g_async_queue_push(), this function
14811538 pushes the new item ahead of the items already in the queue,
14821539 so that it will be the next one to be popped off the queue.</doc>
@@ -1488,13 +1545,13 @@ so that it will be the next one to be popped off the queue.</doc>
14881545 <instance-parameter name="queue" transfer-ownership="none">
14891546 <doc xml:space="preserve"
14901547 filename="glib/gasyncqueue.c"
1491- line="804">a #GAsyncQueue</doc>
1548+ line="805">a #GAsyncQueue</doc>
14921549 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
14931550 </instance-parameter>
1494- <parameter name="item" transfer-ownership="none">
1551+ <parameter name="item" transfer-ownership="full">
14951552 <doc xml:space="preserve"
14961553 filename="glib/gasyncqueue.c"
1497- line="805">data to push into the @queue</doc>
1554+ line="806">data to push into the @queue</doc>
14981555 <type name="gpointer" c:type="gpointer"/>
14991556 </parameter>
15001557 </parameters>
@@ -1504,7 +1561,7 @@ so that it will be the next one to be popped off the queue.</doc>
15041561 version="2.46">
15051562 <doc xml:space="preserve"
15061563 filename="glib/gasyncqueue.c"
1507- line="826">Pushes the @item into the @queue. @item must not be %NULL.
1564+ line="827">Pushes the @item into the @queue. @item must not be %NULL.
15081565 In contrast to g_async_queue_push_unlocked(), this function
15091566 pushes the new item ahead of the items already in the queue,
15101567 so that it will be the next one to be popped off the queue.
@@ -1518,13 +1575,13 @@ This function must be called while holding the @queue's lock.</doc>
15181575 <instance-parameter name="queue" transfer-ownership="none">
15191576 <doc xml:space="preserve"
15201577 filename="glib/gasyncqueue.c"
1521- line="828">a #GAsyncQueue</doc>
1578+ line="829">a #GAsyncQueue</doc>
15221579 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
15231580 </instance-parameter>
1524- <parameter name="item" transfer-ownership="none">
1581+ <parameter name="item" transfer-ownership="full">
15251582 <doc xml:space="preserve"
15261583 filename="glib/gasyncqueue.c"
1527- line="829">data to push into the @queue</doc>
1584+ line="830">data to push into the @queue</doc>
15281585 <type name="gpointer" c:type="gpointer"/>
15291586 </parameter>
15301587 </parameters>
@@ -1555,7 +1612,7 @@ For an example of @func see g_async_queue_sort().</doc>
15551612 line="277">a #GAsyncQueue</doc>
15561613 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
15571614 </instance-parameter>
1558- <parameter name="data" transfer-ownership="none">
1615+ <parameter name="data" transfer-ownership="full">
15591616 <doc xml:space="preserve"
15601617 filename="glib/gasyncqueue.c"
15611618 line="278">the @data to push into the @queue</doc>
@@ -1612,10 +1669,7 @@ For an example of @func see g_async_queue_sort().</doc>
16121669 line="318">a #GAsyncQueue</doc>
16131670 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
16141671 </instance-parameter>
1615- <parameter name="data"
1616- transfer-ownership="none"
1617- nullable="1"
1618- allow-none="1">
1672+ <parameter name="data" transfer-ownership="full">
16191673 <doc xml:space="preserve"
16201674 filename="glib/gasyncqueue.c"
16211675 line="319">the data to push into the @queue</doc>
@@ -1660,7 +1714,7 @@ This function must be called while holding the @queue's lock.</doc>
16601714 line="254">a #GAsyncQueue</doc>
16611715 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
16621716 </instance-parameter>
1663- <parameter name="data" transfer-ownership="none">
1717+ <parameter name="data" transfer-ownership="full">
16641718 <doc xml:space="preserve"
16651719 filename="glib/gasyncqueue.c"
16661720 line="255">data to push onto the @queue</doc>
@@ -1715,25 +1769,25 @@ lock.</doc-deprecated>
17151769 <method name="remove" c:identifier="g_async_queue_remove" version="2.46">
17161770 <doc xml:space="preserve"
17171771 filename="glib/gasyncqueue.c"
1718- line="752">Remove an item from the queue.</doc>
1772+ line="753">Remove an item from the queue.</doc>
17191773 <source-position filename="glib/gasyncqueue.h" line="103"/>
17201774 <return-value transfer-ownership="none">
17211775 <doc xml:space="preserve"
17221776 filename="glib/gasyncqueue.c"
1723- line="759">%TRUE if the item was removed</doc>
1777+ line="760">%TRUE if the item was removed</doc>
17241778 <type name="gboolean" c:type="gboolean"/>
17251779 </return-value>
17261780 <parameters>
17271781 <instance-parameter name="queue" transfer-ownership="none">
17281782 <doc xml:space="preserve"
17291783 filename="glib/gasyncqueue.c"
1730- line="754">a #GAsyncQueue</doc>
1784+ line="755">a #GAsyncQueue</doc>
17311785 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
17321786 </instance-parameter>
17331787 <parameter name="item" transfer-ownership="none">
17341788 <doc xml:space="preserve"
17351789 filename="glib/gasyncqueue.c"
1736- line="755">the data to remove from the @queue</doc>
1790+ line="756">the data to remove from the @queue</doc>
17371791 <type name="gpointer" c:type="gpointer"/>
17381792 </parameter>
17391793 </parameters>
@@ -1743,30 +1797,27 @@ lock.</doc-deprecated>
17431797 version="2.46">
17441798 <doc xml:space="preserve"
17451799 filename="glib/gasyncqueue.c"
1746- line="779">Remove an item from the queue.
1800+ line="780">Remove an item from the queue.
17471801
17481802 This function must be called while holding the @queue's lock.</doc>
17491803 <source-position filename="glib/gasyncqueue.h" line="106"/>
17501804 <return-value transfer-ownership="none">
17511805 <doc xml:space="preserve"
17521806 filename="glib/gasyncqueue.c"
1753- line="788">%TRUE if the item was removed</doc>
1807+ line="789">%TRUE if the item was removed</doc>
17541808 <type name="gboolean" c:type="gboolean"/>
17551809 </return-value>
17561810 <parameters>
17571811 <instance-parameter name="queue" transfer-ownership="none">
17581812 <doc xml:space="preserve"
17591813 filename="glib/gasyncqueue.c"
1760- line="781">a #GAsyncQueue</doc>
1814+ line="782">a #GAsyncQueue</doc>
17611815 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
17621816 </instance-parameter>
1763- <parameter name="item"
1764- transfer-ownership="none"
1765- nullable="1"
1766- allow-none="1">
1817+ <parameter name="item" transfer-ownership="none">
17671818 <doc xml:space="preserve"
17681819 filename="glib/gasyncqueue.c"
1769- line="782">the data to remove from the @queue</doc>
1820+ line="783">the data to remove from the @queue</doc>
17701821 <type name="gpointer" c:type="gpointer"/>
17711822 </parameter>
17721823 </parameters>
@@ -1774,7 +1825,7 @@ This function must be called while holding the @queue's lock.</doc>
17741825 <method name="sort" c:identifier="g_async_queue_sort" version="2.10">
17751826 <doc xml:space="preserve"
17761827 filename="glib/gasyncqueue.c"
1777- line="672">Sorts @queue using @func.
1828+ line="673">Sorts @queue using @func.
17781829
17791830 The sort function @func is passed two elements of the @queue.
17801831 It should return 0 if they are equal, a negative value if the
@@ -1804,7 +1855,7 @@ lowest priority would be at the top of the queue, you could use:
18041855 <instance-parameter name="queue" transfer-ownership="none">
18051856 <doc xml:space="preserve"
18061857 filename="glib/gasyncqueue.c"
1807- line="674">a #GAsyncQueue</doc>
1858+ line="675">a #GAsyncQueue</doc>
18081859 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
18091860 </instance-parameter>
18101861 <parameter name="func"
@@ -1813,7 +1864,7 @@ lowest priority would be at the top of the queue, you could use:
18131864 closure="1">
18141865 <doc xml:space="preserve"
18151866 filename="glib/gasyncqueue.c"
1816- line="675">the #GCompareDataFunc is used to sort @queue</doc>
1867+ line="676">the #GCompareDataFunc is used to sort @queue</doc>
18171868 <type name="CompareDataFunc" c:type="GCompareDataFunc"/>
18181869 </parameter>
18191870 <parameter name="user_data"
@@ -1822,7 +1873,7 @@ lowest priority would be at the top of the queue, you could use:
18221873 allow-none="1">
18231874 <doc xml:space="preserve"
18241875 filename="glib/gasyncqueue.c"
1825- line="676">user data passed to @func</doc>
1876+ line="677">user data passed to @func</doc>
18261877 <type name="gpointer" c:type="gpointer"/>
18271878 </parameter>
18281879 </parameters>
@@ -1832,7 +1883,7 @@ lowest priority would be at the top of the queue, you could use:
18321883 version="2.10">
18331884 <doc xml:space="preserve"
18341885 filename="glib/gasyncqueue.c"
1835- line="716">Sorts @queue using @func.
1886+ line="717">Sorts @queue using @func.
18361887
18371888 The sort function @func is passed two elements of the @queue.
18381889 It should return 0 if they are equal, a negative value if the
@@ -1849,7 +1900,7 @@ This function must be called while holding the @queue's lock.</doc>
18491900 <instance-parameter name="queue" transfer-ownership="none">
18501901 <doc xml:space="preserve"
18511902 filename="glib/gasyncqueue.c"
1852- line="718">a #GAsyncQueue</doc>
1903+ line="719">a #GAsyncQueue</doc>
18531904 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
18541905 </instance-parameter>
18551906 <parameter name="func"
@@ -1858,7 +1909,7 @@ This function must be called while holding the @queue's lock.</doc>
18581909 closure="1">
18591910 <doc xml:space="preserve"
18601911 filename="glib/gasyncqueue.c"
1861- line="719">the #GCompareDataFunc is used to sort @queue</doc>
1912+ line="720">the #GCompareDataFunc is used to sort @queue</doc>
18621913 <type name="CompareDataFunc" c:type="GCompareDataFunc"/>
18631914 </parameter>
18641915 <parameter name="user_data"
@@ -1867,7 +1918,7 @@ This function must be called while holding the @queue's lock.</doc>
18671918 allow-none="1">
18681919 <doc xml:space="preserve"
18691920 filename="glib/gasyncqueue.c"
1870- line="720">user data passed to @func</doc>
1921+ line="721">user data passed to @func</doc>
18711922 <type name="gpointer" c:type="gpointer"/>
18721923 </parameter>
18731924 </parameters>
@@ -1877,7 +1928,7 @@ This function must be called while holding the @queue's lock.</doc>
18771928 deprecated="1">
18781929 <doc xml:space="preserve"
18791930 filename="glib/gasyncqueue.c"
1880- line="533">Pops data from the @queue. If the queue is empty, blocks until
1931+ line="534">Pops data from the @queue. If the queue is empty, blocks until
18811932 @end_time or until data becomes available.
18821933
18831934 If no data is received before @end_time, %NULL is returned.
@@ -1886,24 +1937,24 @@ To easily calculate @end_time, a combination of g_get_real_time()
18861937 and g_time_val_add() can be used.</doc>
18871938 <doc-deprecated xml:space="preserve">use g_async_queue_timeout_pop().</doc-deprecated>
18881939 <source-position filename="glib/gasyncqueue.h" line="117"/>
1889- <return-value transfer-ownership="none" nullable="1">
1940+ <return-value transfer-ownership="full" nullable="1">
18901941 <doc xml:space="preserve"
18911942 filename="glib/gasyncqueue.c"
1892- line="546">data from the queue or %NULL, when no data is
1893- received before @end_time.</doc>
1943+ line="547">data from the queue or %NULL, when no
1944+ data is received before @end_time.</doc>
18941945 <type name="gpointer" c:type="gpointer"/>
18951946 </return-value>
18961947 <parameters>
18971948 <instance-parameter name="queue" transfer-ownership="none">
18981949 <doc xml:space="preserve"
18991950 filename="glib/gasyncqueue.c"
1900- line="535">a #GAsyncQueue</doc>
1951+ line="536">a #GAsyncQueue</doc>
19011952 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
19021953 </instance-parameter>
19031954 <parameter name="end_time" transfer-ownership="none">
19041955 <doc xml:space="preserve"
19051956 filename="glib/gasyncqueue.c"
1906- line="536">a #GTimeVal, determining the final time</doc>
1957+ line="537">a #GTimeVal, determining the final time</doc>
19071958 <type name="TimeVal" c:type="GTimeVal*"/>
19081959 </parameter>
19091960 </parameters>
@@ -1913,7 +1964,7 @@ and g_time_val_add() can be used.</doc>
19131964 deprecated="1">
19141965 <doc xml:space="preserve"
19151966 filename="glib/gasyncqueue.c"
1916- line="577">Pops data from the @queue. If the queue is empty, blocks until
1967+ line="578">Pops data from the @queue. If the queue is empty, blocks until
19171968 @end_time or until data becomes available.
19181969
19191970 If no data is received before @end_time, %NULL is returned.
@@ -1924,24 +1975,24 @@ and g_time_val_add() can be used.
19241975 This function must be called while holding the @queue's lock.</doc>
19251976 <doc-deprecated xml:space="preserve">use g_async_queue_timeout_pop_unlocked().</doc-deprecated>
19261977 <source-position filename="glib/gasyncqueue.h" line="120"/>
1927- <return-value transfer-ownership="none" nullable="1">
1978+ <return-value transfer-ownership="full" nullable="1">
19281979 <doc xml:space="preserve"
19291980 filename="glib/gasyncqueue.c"
1930- line="592">data from the queue or %NULL, when no data is
1931- received before @end_time.</doc>
1981+ line="593">data from the queue or %NULL, when no
1982+ data is received before @end_time.</doc>
19321983 <type name="gpointer" c:type="gpointer"/>
19331984 </return-value>
19341985 <parameters>
19351986 <instance-parameter name="queue" transfer-ownership="none">
19361987 <doc xml:space="preserve"
19371988 filename="glib/gasyncqueue.c"
1938- line="579">a #GAsyncQueue</doc>
1989+ line="580">a #GAsyncQueue</doc>
19391990 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
19401991 </instance-parameter>
19411992 <parameter name="end_time" transfer-ownership="none">
19421993 <doc xml:space="preserve"
19431994 filename="glib/gasyncqueue.c"
1944- line="580">a #GTimeVal, determining the final time</doc>
1995+ line="581">a #GTimeVal, determining the final time</doc>
19451996 <type name="TimeVal" c:type="GTimeVal*"/>
19461997 </parameter>
19471998 </parameters>
@@ -1949,29 +2000,29 @@ This function must be called while holding the @queue's lock.</doc>
19492000 <method name="timeout_pop" c:identifier="g_async_queue_timeout_pop">
19502001 <doc xml:space="preserve"
19512002 filename="glib/gasyncqueue.c"
1952- line="478">Pops data from the @queue. If the queue is empty, blocks for
2003+ line="479">Pops data from the @queue. If the queue is empty, blocks for
19532004 @timeout microseconds, or until data becomes available.
19542005
19552006 If no data is received before the timeout, %NULL is returned.</doc>
19562007 <source-position filename="glib/gasyncqueue.h" line="84"/>
1957- <return-value transfer-ownership="none" nullable="1">
2008+ <return-value transfer-ownership="full" nullable="1">
19582009 <doc xml:space="preserve"
19592010 filename="glib/gasyncqueue.c"
1960- line="488">data from the queue or %NULL, when no data is
1961- received before the timeout.</doc>
2011+ line="489">data from the queue or %NULL, when no
2012+ data is received before the timeout.</doc>
19622013 <type name="gpointer" c:type="gpointer"/>
19632014 </return-value>
19642015 <parameters>
19652016 <instance-parameter name="queue" transfer-ownership="none">
19662017 <doc xml:space="preserve"
19672018 filename="glib/gasyncqueue.c"
1968- line="480">a #GAsyncQueue</doc>
2019+ line="481">a #GAsyncQueue</doc>
19692020 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
19702021 </instance-parameter>
19712022 <parameter name="timeout" transfer-ownership="none">
19722023 <doc xml:space="preserve"
19732024 filename="glib/gasyncqueue.c"
1974- line="481">the number of microseconds to wait</doc>
2025+ line="482">the number of microseconds to wait</doc>
19752026 <type name="guint64" c:type="guint64"/>
19762027 </parameter>
19772028 </parameters>
@@ -1980,31 +2031,31 @@ If no data is received before the timeout, %NULL is returned.</doc>
19802031 c:identifier="g_async_queue_timeout_pop_unlocked">
19812032 <doc xml:space="preserve"
19822033 filename="glib/gasyncqueue.c"
1983- line="507">Pops data from the @queue. If the queue is empty, blocks for
2034+ line="508">Pops data from the @queue. If the queue is empty, blocks for
19842035 @timeout microseconds, or until data becomes available.
19852036
19862037 If no data is received before the timeout, %NULL is returned.
19872038
19882039 This function must be called while holding the @queue's lock.</doc>
19892040 <source-position filename="glib/gasyncqueue.h" line="87"/>
1990- <return-value transfer-ownership="none" nullable="1">
2041+ <return-value transfer-ownership="full" nullable="1">
19912042 <doc xml:space="preserve"
19922043 filename="glib/gasyncqueue.c"
1993- line="519">data from the queue or %NULL, when no data is
1994- received before the timeout.</doc>
2044+ line="520">data from the queue or %NULL, when no
2045+ data is received before the timeout.</doc>
19952046 <type name="gpointer" c:type="gpointer"/>
19962047 </return-value>
19972048 <parameters>
19982049 <instance-parameter name="queue" transfer-ownership="none">
19992050 <doc xml:space="preserve"
20002051 filename="glib/gasyncqueue.c"
2001- line="509">a #GAsyncQueue</doc>
2052+ line="510">a #GAsyncQueue</doc>
20022053 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
20032054 </instance-parameter>
20042055 <parameter name="timeout" transfer-ownership="none">
20052056 <doc xml:space="preserve"
20062057 filename="glib/gasyncqueue.c"
2007- line="510">the number of microseconds to wait</doc>
2058+ line="511">the number of microseconds to wait</doc>
20082059 <type name="guint64" c:type="guint64"/>
20092060 </parameter>
20102061 </parameters>
@@ -2012,21 +2063,21 @@ This function must be called while holding the @queue's lock.</doc>
20122063 <method name="try_pop" c:identifier="g_async_queue_try_pop">
20132064 <doc xml:space="preserve"
20142065 filename="glib/gasyncqueue.c"
2015- line="434">Tries to pop data from the @queue. If no data is available,
2066+ line="435">Tries to pop data from the @queue. If no data is available,
20162067 %NULL is returned.</doc>
20172068 <source-position filename="glib/gasyncqueue.h" line="80"/>
2018- <return-value transfer-ownership="none" nullable="1">
2069+ <return-value transfer-ownership="full" nullable="1">
20192070 <doc xml:space="preserve"
20202071 filename="glib/gasyncqueue.c"
2021- line="441">data from the queue or %NULL, when no data is
2022- available immediately.</doc>
2072+ line="442">data from the queue or %NULL, when no
2073+ data is available immediately.</doc>
20232074 <type name="gpointer" c:type="gpointer"/>
20242075 </return-value>
20252076 <parameters>
20262077 <instance-parameter name="queue" transfer-ownership="none">
20272078 <doc xml:space="preserve"
20282079 filename="glib/gasyncqueue.c"
2029- line="436">a #GAsyncQueue</doc>
2080+ line="437">a #GAsyncQueue</doc>
20302081 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
20312082 </instance-parameter>
20322083 </parameters>
@@ -2035,23 +2086,23 @@ This function must be called while holding the @queue's lock.</doc>
20352086 c:identifier="g_async_queue_try_pop_unlocked">
20362087 <doc xml:space="preserve"
20372088 filename="glib/gasyncqueue.c"
2038- line="458">Tries to pop data from the @queue. If no data is available,
2089+ line="459">Tries to pop data from the @queue. If no data is available,
20392090 %NULL is returned.
20402091
20412092 This function must be called while holding the @queue's lock.</doc>
20422093 <source-position filename="glib/gasyncqueue.h" line="82"/>
2043- <return-value transfer-ownership="none" nullable="1">
2094+ <return-value transfer-ownership="full" nullable="1">
20442095 <doc xml:space="preserve"
20452096 filename="glib/gasyncqueue.c"
2046- line="467">data from the queue or %NULL, when no data is
2047- available immediately.</doc>
2097+ line="468">data from the queue or %NULL, when no
2098+ data is available immediately.</doc>
20482099 <type name="gpointer" c:type="gpointer"/>
20492100 </return-value>
20502101 <parameters>
20512102 <instance-parameter name="queue" transfer-ownership="none">
20522103 <doc xml:space="preserve"
20532104 filename="glib/gasyncqueue.c"
2054- line="460">a #GAsyncQueue</doc>
2105+ line="461">a #GAsyncQueue</doc>
20552106 <type name="AsyncQueue" c:type="GAsyncQueue*"/>
20562107 </instance-parameter>
20572108 </parameters>
@@ -2117,7 +2168,7 @@ lock.</doc-deprecated>
21172168 <type name="none" c:type="void"/>
21182169 </return-value>
21192170 <parameters>
2120- <instance-parameter name="queue" transfer-ownership="none">
2171+ <instance-parameter name="queue" transfer-ownership="full">
21212172 <doc xml:space="preserve"
21222173 filename="glib/gasyncqueue.c"
21232174 line="143">a #GAsyncQueue</doc>
@@ -4260,36 +4311,38 @@ guaranteed to be atomic by using g_file_set_contents() internally.</doc>
42604311 </enumeration>
42614312 <record name="ByteArray"
42624313 c:type="GByteArray"
4314+ copy-function="g_byte_array_ref"
4315+ free-function="g_byte_array_unref"
42634316 glib:type-name="GByteArray"
42644317 glib:get-type="g_byte_array_get_type"
42654318 c:symbol-prefix="byte_array">
42664319 <doc xml:space="preserve"
42674320 filename="glib/garray.c"
4268- line="2676">Contains the public fields of a GByteArray.</doc>
4321+ line="2696">Contains the public fields of a `GByteArray`.</doc>
42694322 <source-position filename="glib/garray.h" line="53"/>
42704323 <field name="data" writable="1">
42714324 <doc xml:space="preserve"
42724325 filename="glib/garray.c"
4273- line="2678">a pointer to the element data. The data may be moved as
4274- elements are added to the #GByteArray</doc>
4326+ line="2698">a pointer to the element data. The data may be moved as
4327+ elements are added to the `GByteArray`</doc>
42754328 <type name="guint8" c:type="guint8*"/>
42764329 </field>
42774330 <field name="len" writable="1">
42784331 <doc xml:space="preserve"
42794332 filename="glib/garray.c"
4280- line="2680">the number of elements in the #GByteArray</doc>
4333+ line="2700">the number of elements in the `GByteArray`</doc>
42814334 <type name="guint" c:type="guint"/>
42824335 </field>
42834336 <function name="append" c:identifier="g_byte_array_append">
42844337 <doc xml:space="preserve"
42854338 filename="glib/garray.c"
4286- line="2858">Adds the given bytes to the end of the #GByteArray.
4339+ line="2878">Adds the given bytes to the end of the `GByteArray`.
42874340 The array will grow in size automatically if necessary.</doc>
42884341 <source-position filename="glib/garray.h" line="293"/>
42894342 <return-value transfer-ownership="none">
42904343 <doc xml:space="preserve"
42914344 filename="glib/garray.c"
4292- line="2867">the #GByteArray</doc>
4345+ line="2887">The `GByteArray`</doc>
42934346 <array name="GLib.ByteArray" c:type="GByteArray*">
42944347 <type name="guint8" c:type="guint8"/>
42954348 </array>
@@ -4298,7 +4351,7 @@ The array will grow in size automatically if necessary.</doc>
42984351 <parameter name="array" transfer-ownership="none">
42994352 <doc xml:space="preserve"
43004353 filename="glib/garray.c"
4301- line="2860">a #GByteArray</doc>
4354+ line="2880">a byte array</doc>
43024355 <array name="GLib.ByteArray" c:type="GByteArray*">
43034356 <type name="guint8" c:type="guint8"/>
43044357 </array>
@@ -4306,13 +4359,15 @@ The array will grow in size automatically if necessary.</doc>
43064359 <parameter name="data" transfer-ownership="none">
43074360 <doc xml:space="preserve"
43084361 filename="glib/garray.c"
4309- line="2861">the byte data to be added</doc>
4310- <type name="guint8" c:type="const guint8*"/>
4362+ line="2881">the byte data to be added</doc>
4363+ <array length="2" zero-terminated="0" c:type="const guint8*">
4364+ <type name="guint8" c:type="guint8"/>
4365+ </array>
43114366 </parameter>
43124367 <parameter name="len" transfer-ownership="none">
43134368 <doc xml:space="preserve"
43144369 filename="glib/garray.c"
4315- line="2862">the number of bytes to add</doc>
4370+ line="2882">the number of bytes to add</doc>
43164371 <type name="guint" c:type="guint"/>
43174372 </parameter>
43184373 </parameters>
@@ -4320,23 +4375,25 @@ The array will grow in size automatically if necessary.</doc>
43204375 <function name="free" c:identifier="g_byte_array_free">
43214376 <doc xml:space="preserve"
43224377 filename="glib/garray.c"
4323- line="2775">Frees the memory allocated by the #GByteArray. If @free_segment is
4324-%TRUE it frees the actual byte data. If the reference count of
4325-@array is greater than one, the #GByteArray wrapper is preserved but
4378+ line="2794">Frees the memory allocated by the `GByteArray`. If @free_segment is
4379+true it frees the actual byte data. If the reference count of
4380+@array is greater than one, the `GByteArray` wrapper is preserved but
43264381 the size of @array will be set to zero.</doc>
43274382 <source-position filename="glib/garray.h" line="284"/>
4328- <return-value transfer-ownership="none">
4383+ <return-value transfer-ownership="full" nullable="1">
43294384 <doc xml:space="preserve"
43304385 filename="glib/garray.c"
4331- line="2785">the element data if @free_segment is %FALSE, otherwise
4332- %NULL. The element data should be freed using g_free().</doc>
4333- <type name="guint8" c:type="guint8*"/>
4386+ line="2804">The allocated element data if
4387+ @free_segment is false, otherwise `NULL`.</doc>
4388+ <array zero-terminated="0" c:type="guint8*">
4389+ <type name="guint8" c:type="guint8"/>
4390+ </array>
43344391 </return-value>
43354392 <parameters>
4336- <parameter name="array" transfer-ownership="none">
4393+ <parameter name="array" transfer-ownership="full">
43374394 <doc xml:space="preserve"
43384395 filename="glib/garray.c"
4339- line="2777">a #GByteArray</doc>
4396+ line="2796">a byte array</doc>
43404397 <array name="GLib.ByteArray" c:type="GByteArray*">
43414398 <type name="guint8" c:type="guint8"/>
43424399 </array>
@@ -4344,7 +4401,7 @@ the size of @array will be set to zero.</doc>
43444401 <parameter name="free_segment" transfer-ownership="none">
43454402 <doc xml:space="preserve"
43464403 filename="glib/garray.c"
4347- line="2778">if %TRUE the actual byte data is freed as well</doc>
4404+ line="2797">if true, the actual byte data is freed as well</doc>
43484405 <type name="gboolean" c:type="gboolean"/>
43494406 </parameter>
43504407 </parameters>
@@ -4354,27 +4411,28 @@ the size of @array will be set to zero.</doc>
43544411 version="2.32">
43554412 <doc xml:space="preserve"
43564413 filename="glib/garray.c"
4357- line="2795">Transfers the data from the #GByteArray into a new immutable #GBytes.
4414+ line="2814">Transfers the data from the `GByteArray` into a new immutable
4415+[struct@GLib.Bytes].
43584416
4359-The #GByteArray is freed unless the reference count of @array is greater
4360-than one, the #GByteArray wrapper is preserved but the size of @array
4361-will be set to zero.
4417+The `GByteArray` is freed unless the reference count of @array is greater
4418+than one, in which the `GByteArray` wrapper is preserved but the size of
4419+@array will be set to zero.
43624420
4363-This is identical to using g_bytes_new_take() and g_byte_array_free()
4364-together.</doc>
4421+This is identical to using [ctor@GLib.Bytes.new_take] and
4422+[func@GLib.ByteArray.free] together.</doc>
43654423 <source-position filename="glib/garray.h" line="287"/>
43664424 <return-value transfer-ownership="full">
43674425 <doc xml:space="preserve"
43684426 filename="glib/garray.c"
4369- line="2810">a new immutable #GBytes representing same
4370- byte data that was in the array</doc>
4427+ line="2830">The new immutable [struct@GLib.Bytes] representing
4428+ same byte data that was in the array</doc>
43714429 <type name="Bytes" c:type="GBytes*"/>
43724430 </return-value>
43734431 <parameters>
43744432 <parameter name="array" transfer-ownership="full">
43754433 <doc xml:space="preserve"
43764434 filename="glib/garray.c"
4377- line="2797">a #GByteArray</doc>
4435+ line="2816">a byte array</doc>
43784436 <array name="GLib.ByteArray" c:type="GByteArray*">
43794437 <type name="guint8" c:type="guint8"/>
43804438 </array>
@@ -4384,12 +4442,12 @@ together.</doc>
43844442 <function name="new" c:identifier="g_byte_array_new">
43854443 <doc xml:space="preserve"
43864444 filename="glib/garray.c"
4387- line="2685">Creates a new #GByteArray with a reference count of 1.</doc>
4445+ line="2705">Creates a new `GByteArray` with a reference count of 1.</doc>
43884446 <source-position filename="glib/garray.h" line="274"/>
43894447 <return-value transfer-ownership="full">
43904448 <doc xml:space="preserve"
43914449 filename="glib/garray.c"
4392- line="2690">the new #GByteArray</doc>
4450+ line="2710">The new `GByteArray`</doc>
43934451 <array name="GLib.ByteArray" c:type="GByteArray*">
43944452 <type name="guint8" c:type="guint8"/>
43954453 </array>
@@ -4400,19 +4458,19 @@ together.</doc>
44004458 version="2.32">
44014459 <doc xml:space="preserve"
44024460 filename="glib/garray.c"
4403- line="2720">Creates a byte array containing the @data.
4404-After this call, @data belongs to the #GByteArray and may no longer be
4461+ line="2739">Creates a byte array containing the @data.
4462+After this call, @data belongs to the `GByteArray` and may no longer be
44054463 modified by the caller. The memory of @data has to be dynamically
4406-allocated and will eventually be freed with g_free().
4464+allocated and will eventually be freed with [func@GLib.free].
44074465
4408-Do not use it if @len is greater than %G_MAXUINT. #GByteArray
4409-stores the length of its data in #guint, which may be shorter than
4410-#gsize.</doc>
4466+Do not use it if @len is greater than [`G_MAXUINT`](types.html#guint).
4467+`GByteArray` stores the length of its data in `guint`, which may be shorter
4468+than `gsize`.</doc>
44114469 <source-position filename="glib/garray.h" line="276"/>
44124470 <return-value transfer-ownership="full">
44134471 <doc xml:space="preserve"
44144472 filename="glib/garray.c"
4415- line="2736">a new #GByteArray</doc>
4473+ line="2755">The new `GByteArray`</doc>
44164474 <array name="GLib.ByteArray" c:type="GByteArray*">
44174475 <type name="guint8" c:type="guint8"/>
44184476 </array>
@@ -4421,7 +4479,7 @@ stores the length of its data in #guint, which may be shorter than
44214479 <parameter name="data" transfer-ownership="full">
44224480 <doc xml:space="preserve"
44234481 filename="glib/garray.c"
4424- line="2722">byte data for the array</doc>
4482+ line="2741">the byte data for the array</doc>
44254483 <array length="1" zero-terminated="0" c:type="guint8*">
44264484 <type name="guint8" c:type="guint8"/>
44274485 </array>
@@ -4429,7 +4487,7 @@ stores the length of its data in #guint, which may be shorter than
44294487 <parameter name="len" transfer-ownership="none">
44304488 <doc xml:space="preserve"
44314489 filename="glib/garray.c"
4432- line="2723">length of @data</doc>
4490+ line="2742">the length of @data</doc>
44334491 <type name="gsize" c:type="gsize"/>
44344492 </parameter>
44354493 </parameters>
@@ -4437,13 +4495,13 @@ stores the length of its data in #guint, which may be shorter than
44374495 <function name="prepend" c:identifier="g_byte_array_prepend">
44384496 <doc xml:space="preserve"
44394497 filename="glib/garray.c"
4440- line="2879">Adds the given data to the start of the #GByteArray.
4498+ line="2897">Adds the given data to the start of the `GByteArray`.
44414499 The array will grow in size automatically if necessary.</doc>
44424500 <source-position filename="glib/garray.h" line="297"/>
44434501 <return-value transfer-ownership="none">
44444502 <doc xml:space="preserve"
44454503 filename="glib/garray.c"
4446- line="2888">the #GByteArray</doc>
4504+ line="2906">The `GByteArray`</doc>
44474505 <array name="GLib.ByteArray" c:type="GByteArray*">
44484506 <type name="guint8" c:type="guint8"/>
44494507 </array>
@@ -4452,7 +4510,7 @@ The array will grow in size automatically if necessary.</doc>
44524510 <parameter name="array" transfer-ownership="none">
44534511 <doc xml:space="preserve"
44544512 filename="glib/garray.c"
4455- line="2881">a #GByteArray</doc>
4513+ line="2899">a byte array</doc>
44564514 <array name="GLib.ByteArray" c:type="GByteArray*">
44574515 <type name="guint8" c:type="guint8"/>
44584516 </array>
@@ -4460,13 +4518,15 @@ The array will grow in size automatically if necessary.</doc>
44604518 <parameter name="data" transfer-ownership="none">
44614519 <doc xml:space="preserve"
44624520 filename="glib/garray.c"
4463- line="2882">the byte data to be added</doc>
4464- <type name="guint8" c:type="const guint8*"/>
4521+ line="2900">the byte data to be added</doc>
4522+ <array length="2" zero-terminated="0" c:type="const guint8*">
4523+ <type name="guint8" c:type="guint8"/>
4524+ </array>
44654525 </parameter>
44664526 <parameter name="len" transfer-ownership="none">
44674527 <doc xml:space="preserve"
44684528 filename="glib/garray.c"
4469- line="2883">the number of bytes to add</doc>
4529+ line="2901">the number of bytes to add</doc>
44704530 <type name="guint" c:type="guint"/>
44714531 </parameter>
44724532 </parameters>
@@ -4474,13 +4534,13 @@ The array will grow in size automatically if necessary.</doc>
44744534 <function name="ref" c:identifier="g_byte_array_ref" version="2.22">
44754535 <doc xml:space="preserve"
44764536 filename="glib/garray.c"
4477- line="2824">Atomically increments the reference count of @array by one.
4537+ line="2844">Atomically increments the reference count of @array by one.
44784538 This function is thread-safe and may be called from any thread.</doc>
44794539 <source-position filename="glib/garray.h" line="289"/>
44804540 <return-value transfer-ownership="full">
44814541 <doc xml:space="preserve"
44824542 filename="glib/garray.c"
4483- line="2831">The passed in #GByteArray</doc>
4543+ line="2851">The passed in `GByteArray`</doc>
44844544 <array name="GLib.ByteArray" c:type="GByteArray*">
44854545 <type name="guint8" c:type="guint8"/>
44864546 </array>
@@ -4489,7 +4549,7 @@ This function is thread-safe and may be called from any thread.</doc>
44894549 <parameter name="array" transfer-ownership="none">
44904550 <doc xml:space="preserve"
44914551 filename="glib/garray.c"
4492- line="2826">A #GByteArray</doc>
4552+ line="2846">a byte array</doc>
44934553 <array name="GLib.ByteArray" c:type="GByteArray*">
44944554 <type name="guint8" c:type="guint8"/>
44954555 </array>
@@ -4499,13 +4559,13 @@ This function is thread-safe and may be called from any thread.</doc>
44994559 <function name="remove_index" c:identifier="g_byte_array_remove_index">
45004560 <doc xml:space="preserve"
45014561 filename="glib/garray.c"
4502- line="2918">Removes the byte at the given index from a #GByteArray.
4562+ line="2932">Removes the byte at the given index from a `GByteArray`.
45034563 The following bytes are moved down one place.</doc>
45044564 <source-position filename="glib/garray.h" line="304"/>
45054565 <return-value transfer-ownership="none">
45064566 <doc xml:space="preserve"
45074567 filename="glib/garray.c"
4508- line="2926">the #GByteArray</doc>
4568+ line="2940">The `GByteArray`</doc>
45094569 <array name="GLib.ByteArray" c:type="GByteArray*">
45104570 <type name="guint8" c:type="guint8"/>
45114571 </array>
@@ -4514,7 +4574,7 @@ The following bytes are moved down one place.</doc>
45144574 <parameter name="array" transfer-ownership="none">
45154575 <doc xml:space="preserve"
45164576 filename="glib/garray.c"
4517- line="2920">a #GByteArray</doc>
4577+ line="2934">a byte array</doc>
45184578 <array name="GLib.ByteArray" c:type="GByteArray*">
45194579 <type name="guint8" c:type="guint8"/>
45204580 </array>
@@ -4522,7 +4582,7 @@ The following bytes are moved down one place.</doc>
45224582 <parameter name="index_" transfer-ownership="none">
45234583 <doc xml:space="preserve"
45244584 filename="glib/garray.c"
4525- line="2921">the index of the byte to remove</doc>
4585+ line="2935">the index of the byte to remove</doc>
45264586 <type name="guint" c:type="guint"/>
45274587 </parameter>
45284588 </parameters>
@@ -4531,15 +4591,15 @@ The following bytes are moved down one place.</doc>
45314591 c:identifier="g_byte_array_remove_index_fast">
45324592 <doc xml:space="preserve"
45334593 filename="glib/garray.c"
4534- line="2937">Removes the byte at the given index from a #GByteArray. The last
4594+ line="2949">Removes the byte at the given index from a `GByteArray`. The last
45354595 element in the array is used to fill in the space, so this function
4536-does not preserve the order of the #GByteArray. But it is faster
4537-than g_byte_array_remove_index().</doc>
4596+does not preserve the order of the `GByteArray`. But it is faster
4597+than [func@GLib.ByteArray.remove_index].</doc>
45384598 <source-position filename="glib/garray.h" line="307"/>
45394599 <return-value transfer-ownership="none">
45404600 <doc xml:space="preserve"
45414601 filename="glib/garray.c"
4542- line="2947">the #GByteArray</doc>
4602+ line="2959">The `GByteArray`</doc>
45434603 <array name="GLib.ByteArray" c:type="GByteArray*">
45444604 <type name="guint8" c:type="guint8"/>
45454605 </array>
@@ -4548,7 +4608,7 @@ than g_byte_array_remove_index().</doc>
45484608 <parameter name="array" transfer-ownership="none">
45494609 <doc xml:space="preserve"
45504610 filename="glib/garray.c"
4551- line="2939">a #GByteArray</doc>
4611+ line="2951">a byte array</doc>
45524612 <array name="GLib.ByteArray" c:type="GByteArray*">
45534613 <type name="guint8" c:type="guint8"/>
45544614 </array>
@@ -4556,7 +4616,7 @@ than g_byte_array_remove_index().</doc>
45564616 <parameter name="index_" transfer-ownership="none">
45574617 <doc xml:space="preserve"
45584618 filename="glib/garray.c"
4559- line="2940">the index of the byte to remove</doc>
4619+ line="2952">the index of the byte to remove</doc>
45604620 <type name="guint" c:type="guint"/>
45614621 </parameter>
45624622 </parameters>
@@ -4566,13 +4626,13 @@ than g_byte_array_remove_index().</doc>
45664626 version="2.4">
45674627 <doc xml:space="preserve"
45684628 filename="glib/garray.c"
4569- line="2958">Removes the given number of bytes starting at the given index from a
4570-#GByteArray. The following elements are moved to close the gap.</doc>
4629+ line="2968">Removes the given number of bytes starting at the given index from a
4630+`GByteArray`. The following elements are moved to close the gap.</doc>
45714631 <source-position filename="glib/garray.h" line="310"/>
45724632 <return-value transfer-ownership="none">
45734633 <doc xml:space="preserve"
45744634 filename="glib/garray.c"
4575- line="2967">the #GByteArray</doc>
4635+ line="2977">The `GByteArray`</doc>
45764636 <array name="GLib.ByteArray" c:type="GByteArray*">
45774637 <type name="guint8" c:type="guint8"/>
45784638 </array>
@@ -4581,7 +4641,7 @@ than g_byte_array_remove_index().</doc>
45814641 <parameter name="array" transfer-ownership="none">
45824642 <doc xml:space="preserve"
45834643 filename="glib/garray.c"
4584- line="2960">a @GByteArray</doc>
4644+ line="2970">a byte array</doc>
45854645 <array name="GLib.ByteArray" c:type="GByteArray*">
45864646 <type name="guint8" c:type="guint8"/>
45874647 </array>
@@ -4589,13 +4649,13 @@ than g_byte_array_remove_index().</doc>
45894649 <parameter name="index_" transfer-ownership="none">
45904650 <doc xml:space="preserve"
45914651 filename="glib/garray.c"
4592- line="2961">the index of the first byte to remove</doc>
4652+ line="2971">the index of the first byte to remove</doc>
45934653 <type name="guint" c:type="guint"/>
45944654 </parameter>
45954655 <parameter name="length" transfer-ownership="none">
45964656 <doc xml:space="preserve"
45974657 filename="glib/garray.c"
4598- line="2962">the number of bytes to remove</doc>
4658+ line="2972">the number of bytes to remove</doc>
45994659 <type name="guint" c:type="guint"/>
46004660 </parameter>
46014661 </parameters>
@@ -4603,12 +4663,12 @@ than g_byte_array_remove_index().</doc>
46034663 <function name="set_size" c:identifier="g_byte_array_set_size">
46044664 <doc xml:space="preserve"
46054665 filename="glib/garray.c"
4606- line="2900">Sets the size of the #GByteArray, expanding it if necessary.</doc>
4666+ line="2916">Sets the size of the `GByteArray`, expanding it if necessary.</doc>
46074667 <source-position filename="glib/garray.h" line="301"/>
46084668 <return-value transfer-ownership="none">
46094669 <doc xml:space="preserve"
46104670 filename="glib/garray.c"
4611- line="2907">the #GByteArray</doc>
4671+ line="2923">The `GByteArray`</doc>
46124672 <array name="GLib.ByteArray" c:type="GByteArray*">
46134673 <type name="guint8" c:type="guint8"/>
46144674 </array>
@@ -4617,7 +4677,7 @@ than g_byte_array_remove_index().</doc>
46174677 <parameter name="array" transfer-ownership="none">
46184678 <doc xml:space="preserve"
46194679 filename="glib/garray.c"
4620- line="2902">a #GByteArray</doc>
4680+ line="2918">a byte array</doc>
46214681 <array name="GLib.ByteArray" c:type="GByteArray*">
46224682 <type name="guint8" c:type="guint8"/>
46234683 </array>
@@ -4625,7 +4685,7 @@ than g_byte_array_remove_index().</doc>
46254685 <parameter name="length" transfer-ownership="none">
46264686 <doc xml:space="preserve"
46274687 filename="glib/garray.c"
4628- line="2903">the new size of the #GByteArray</doc>
4688+ line="2919">the new size of the `GByteArray`</doc>
46294689 <type name="guint" c:type="guint"/>
46304690 </parameter>
46314691 </parameters>
@@ -4633,7 +4693,7 @@ than g_byte_array_remove_index().</doc>
46334693 <function name="sized_new" c:identifier="g_byte_array_sized_new">
46344694 <doc xml:space="preserve"
46354695 filename="glib/garray.c"
4636- line="2758">Creates a new #GByteArray with @reserved_size bytes preallocated.
4696+ line="2777">Creates a new `GByteArray` with @reserved_size bytes preallocated.
46374697 This avoids frequent reallocation, if you are going to add many
46384698 bytes to the array. Note however that the size of the array is still
46394699 0.</doc>
@@ -4641,7 +4701,7 @@ bytes to the array. Note however that the size of the array is still
46414701 <return-value transfer-ownership="full">
46424702 <doc xml:space="preserve"
46434703 filename="glib/garray.c"
4644- line="2767">the new #GByteArray</doc>
4704+ line="2786">The new `GByteArray`</doc>
46454705 <array name="GLib.ByteArray" c:type="GByteArray*">
46464706 <type name="guint8" c:type="guint8"/>
46474707 </array>
@@ -4650,7 +4710,7 @@ bytes to the array. Note however that the size of the array is still
46504710 <parameter name="reserved_size" transfer-ownership="none">
46514711 <doc xml:space="preserve"
46524712 filename="glib/garray.c"
4653- line="2760">number of bytes preallocated</doc>
4713+ line="2779">the number of bytes preallocated</doc>
46544714 <type name="guint" c:type="guint"/>
46554715 </parameter>
46564716 </parameters>
@@ -4658,8 +4718,8 @@ bytes to the array. Note however that the size of the array is still
46584718 <function name="sort" c:identifier="g_byte_array_sort">
46594719 <doc xml:space="preserve"
46604720 filename="glib/garray.c"
4661- line="2984">Sorts a byte array, using @compare_func which should be a
4662-qsort()-style comparison function (returns less than zero for first
4721+ line="2994">Sorts a byte array, using @compare_func which should be a
4722+`qsort()`-style comparison function (returns less than zero for first
46634723 arg is less than second arg, zero for equal, greater than zero if
46644724 first arg is greater than second arg).
46654725
@@ -4676,7 +4736,7 @@ their addresses.</doc>
46764736 <parameter name="array" transfer-ownership="none">
46774737 <doc xml:space="preserve"
46784738 filename="glib/garray.c"
4679- line="2986">a #GByteArray</doc>
4739+ line="2996">a byte array</doc>
46804740 <array name="GLib.ByteArray" c:type="GByteArray*">
46814741 <type name="guint8" c:type="guint8"/>
46824742 </array>
@@ -4686,7 +4746,7 @@ their addresses.</doc>
46864746 scope="call">
46874747 <doc xml:space="preserve"
46884748 filename="glib/garray.c"
4689- line="2987">comparison function</doc>
4749+ line="2997">the comparison function</doc>
46904750 <type name="CompareFunc" c:type="GCompareFunc"/>
46914751 </parameter>
46924752 </parameters>
@@ -4695,7 +4755,7 @@ their addresses.</doc>
46954755 c:identifier="g_byte_array_sort_with_data">
46964756 <doc xml:space="preserve"
46974757 filename="glib/garray.c"
4698- line="3007">Like g_byte_array_sort(), but the comparison function takes an extra
4758+ line="3017">Like [func@GLib.ByteArray.sort], but the comparison function takes an extra
46994759 user data argument.</doc>
47004760 <source-position filename="glib/garray.h" line="317"/>
47014761 <return-value transfer-ownership="none">
@@ -4705,7 +4765,7 @@ user data argument.</doc>
47054765 <parameter name="array" transfer-ownership="none">
47064766 <doc xml:space="preserve"
47074767 filename="glib/garray.c"
4708- line="3009">a #GByteArray</doc>
4768+ line="3019">a byte array</doc>
47094769 <array name="GLib.ByteArray" c:type="GByteArray*">
47104770 <type name="guint8" c:type="guint8"/>
47114771 </array>
@@ -4716,7 +4776,7 @@ user data argument.</doc>
47164776 closure="2">
47174777 <doc xml:space="preserve"
47184778 filename="glib/garray.c"
4719- line="3010">comparison function</doc>
4779+ line="3020">the comparison function</doc>
47204780 <type name="CompareDataFunc" c:type="GCompareDataFunc"/>
47214781 </parameter>
47224782 <parameter name="user_data"
@@ -4725,7 +4785,7 @@ user data argument.</doc>
47254785 allow-none="1">
47264786 <doc xml:space="preserve"
47274787 filename="glib/garray.c"
4728- line="3011">data to pass to @compare_func</doc>
4788+ line="3021">the data to pass to @compare_func</doc>
47294789 <type name="gpointer" c:type="gpointer"/>
47304790 </parameter>
47314791 </parameters>
@@ -4733,22 +4793,23 @@ user data argument.</doc>
47334793 <function name="steal" c:identifier="g_byte_array_steal" version="2.64">
47344794 <doc xml:space="preserve"
47354795 filename="glib/garray.c"
4736- line="2698">Frees the data in the array and resets the size to zero, while
4796+ line="2718">Frees the data in the array and resets the size to zero, while
47374797 the underlying array is preserved for use elsewhere and returned
47384798 to the caller.</doc>
47394799 <source-position filename="glib/garray.h" line="279"/>
47404800 <return-value transfer-ownership="full">
47414801 <doc xml:space="preserve"
47424802 filename="glib/garray.c"
4743- line="2708">the element data, which should be
4744- freed using g_free().</doc>
4745- <type name="guint8" c:type="guint8*"/>
4803+ line="2728">The allocated element data</doc>
4804+ <array length="1" zero-terminated="0" c:type="guint8*">
4805+ <type name="guint8" c:type="guint8"/>
4806+ </array>
47464807 </return-value>
47474808 <parameters>
47484809 <parameter name="array" transfer-ownership="none">
47494810 <doc xml:space="preserve"
47504811 filename="glib/garray.c"
4751- line="2700">a #GByteArray.</doc>
4812+ line="2720">a byte array</doc>
47524813 <array name="GLib.ByteArray" c:type="GByteArray*">
47534814 <type name="guint8" c:type="guint8"/>
47544815 </array>
@@ -4761,7 +4822,7 @@ to the caller.</doc>
47614822 allow-none="1">
47624823 <doc xml:space="preserve"
47634824 filename="glib/garray.c"
4764- line="2701">pointer to retrieve the number of
4825+ line="2721">the pointer to retrieve the number of
47654826 elements of the original array</doc>
47664827 <type name="gsize" c:type="gsize*"/>
47674828 </parameter>
@@ -4770,7 +4831,7 @@ to the caller.</doc>
47704831 <function name="unref" c:identifier="g_byte_array_unref" version="2.22">
47714832 <doc xml:space="preserve"
47724833 filename="glib/garray.c"
4773- line="2841">Atomically decrements the reference count of @array by one. If the
4834+ line="2861">Atomically decrements the reference count of @array by one. If the
47744835 reference count drops to 0, all memory allocated by the array is
47754836 released. This function is thread-safe and may be called from any
47764837 thread.</doc>
@@ -4779,10 +4840,10 @@ thread.</doc>
47794840 <type name="none" c:type="void"/>
47804841 </return-value>
47814842 <parameters>
4782- <parameter name="array" transfer-ownership="none">
4843+ <parameter name="array" transfer-ownership="full">
47834844 <doc xml:space="preserve"
47844845 filename="glib/garray.c"
4785- line="2843">A #GByteArray</doc>
4846+ line="2863">a byte array</doc>
47864847 <array name="GLib.ByteArray" c:type="GByteArray*">
47874848 <type name="guint8" c:type="guint8"/>
47884849 </array>
@@ -5911,7 +5972,7 @@ and [func@GLib.compute_checksum_for_string], respectively.</doc>
59115972 <constructor name="new" c:identifier="g_checksum_new" version="2.16">
59125973 <doc xml:space="preserve"
59135974 filename="glib/gchecksum.c"
5914- line="1449">Creates a new #GChecksum, using the checksum algorithm @checksum_type.
5975+ line="1450">Creates a new #GChecksum, using the checksum algorithm @checksum_type.
59155976 If the @checksum_type is not known, %NULL is returned.
59165977 A #GChecksum can be used to compute the checksum, or digest, of an
59175978 arbitrary binary blob, using different hashing algorithms.
@@ -5928,7 +5989,7 @@ on it anymore.</doc>
59285989 <return-value transfer-ownership="full" nullable="1">
59295990 <doc xml:space="preserve"
59305991 filename="glib/gchecksum.c"
5931- line="1467">the newly created #GChecksum, or %NULL.
5992+ line="1468">the newly created #GChecksum, or %NULL.
59325993 Use g_checksum_free() to free the memory allocated by it.</doc>
59335994 <type name="Checksum" c:type="GChecksum*"/>
59345995 </return-value>
@@ -5936,7 +5997,7 @@ on it anymore.</doc>
59365997 <parameter name="checksum_type" transfer-ownership="none">
59375998 <doc xml:space="preserve"
59385999 filename="glib/gchecksum.c"
5939- line="1451">the desired type of checksum</doc>
6000+ line="1452">the desired type of checksum</doc>
59406001 <type name="ChecksumType" c:type="GChecksumType"/>
59416002 </parameter>
59426003 </parameters>
@@ -5944,14 +6005,14 @@ on it anymore.</doc>
59446005 <method name="copy" c:identifier="g_checksum_copy" version="2.16">
59456006 <doc xml:space="preserve"
59466007 filename="glib/gchecksum.c"
5947- line="1527">Copies a #GChecksum. If @checksum has been closed, by calling
6008+ line="1528">Copies a #GChecksum. If @checksum has been closed, by calling
59486009 g_checksum_get_string() or g_checksum_get_digest(), the copied
59496010 checksum will be closed as well.</doc>
59506011 <source-position filename="glib/gchecksum.h" line="67"/>
59516012 <return-value transfer-ownership="full">
59526013 <doc xml:space="preserve"
59536014 filename="glib/gchecksum.c"
5954- line="1535">the copy of the passed #GChecksum. Use
6015+ line="1536">the copy of the passed #GChecksum. Use
59556016 g_checksum_free() when finished using it.</doc>
59566017 <type name="Checksum" c:type="GChecksum*"/>
59576018 </return-value>
@@ -5959,7 +6020,7 @@ checksum will be closed as well.</doc>
59596020 <instance-parameter name="checksum" transfer-ownership="none">
59606021 <doc xml:space="preserve"
59616022 filename="glib/gchecksum.c"
5962- line="1529">the #GChecksum to copy</doc>
6023+ line="1530">the #GChecksum to copy</doc>
59636024 <type name="Checksum" c:type="const GChecksum*"/>
59646025 </instance-parameter>
59656026 </parameters>
@@ -5967,7 +6028,7 @@ checksum will be closed as well.</doc>
59676028 <method name="free" c:identifier="g_checksum_free" version="2.16">
59686029 <doc xml:space="preserve"
59696030 filename="glib/gchecksum.c"
5970- line="1555">Frees the memory allocated for @checksum.</doc>
6031+ line="1556">Frees the memory allocated for @checksum.</doc>
59716032 <source-position filename="glib/gchecksum.h" line="69"/>
59726033 <return-value transfer-ownership="none">
59736034 <type name="none" c:type="void"/>
@@ -5976,7 +6037,7 @@ checksum will be closed as well.</doc>
59766037 <instance-parameter name="checksum" transfer-ownership="none">
59776038 <doc xml:space="preserve"
59786039 filename="glib/gchecksum.c"
5979- line="1557">a #GChecksum</doc>
6040+ line="1558">a #GChecksum</doc>
59806041 <type name="Checksum" c:type="GChecksum*"/>
59816042 </instance-parameter>
59826043 </parameters>
@@ -5987,7 +6048,7 @@ checksum will be closed as well.</doc>
59876048 introspectable="0">
59886049 <doc xml:space="preserve"
59896050 filename="glib/gchecksum.c"
5990- line="1685">Gets the digest from @checksum as a raw binary vector and places it
6051+ line="1703">Gets the digest from @checksum as a raw binary vector and places it
59916052 into @buffer. The size of the digest depends on the type of checksum.
59926053
59936054 Once this function has been called, the #GChecksum is closed and can
@@ -6000,13 +6061,13 @@ no longer be updated with g_checksum_update().</doc>
60006061 <instance-parameter name="checksum" transfer-ownership="none">
60016062 <doc xml:space="preserve"
60026063 filename="glib/gchecksum.c"
6003- line="1687">a #GChecksum</doc>
6064+ line="1705">a #GChecksum</doc>
60046065 <type name="Checksum" c:type="GChecksum*"/>
60056066 </instance-parameter>
60066067 <parameter name="buffer" transfer-ownership="none">
60076068 <doc xml:space="preserve"
60086069 filename="glib/gchecksum.c"
6009- line="1688">output buffer</doc>
6070+ line="1706">output buffer</doc>
60106071 <array length="1" zero-terminated="0" c:type="guint8*">
60116072 <type name="guint8" c:type="guint8"/>
60126073 </array>
@@ -6017,7 +6078,7 @@ no longer be updated with g_checksum_update().</doc>
60176078 transfer-ownership="full">
60186079 <doc xml:space="preserve"
60196080 filename="glib/gchecksum.c"
6020- line="1689">an inout parameter. The caller initializes it to the size of @buffer.
6081+ line="1707">an inout parameter. The caller initializes it to the size of @buffer.
60216082 After the call it contains the length of the digest.</doc>
60226083 <type name="gsize" c:type="gsize*"/>
60236084 </parameter>
@@ -6028,7 +6089,7 @@ no longer be updated with g_checksum_update().</doc>
60286089 version="2.16">
60296090 <doc xml:space="preserve"
60306091 filename="glib/gchecksum.c"
6031- line="1626">Gets the digest as a hexadecimal string.
6092+ line="1644">Gets the digest as a hexadecimal string.
60326093
60336094 Once this function has been called the #GChecksum can no longer be
60346095 updated with g_checksum_update().
@@ -6038,7 +6099,7 @@ The hexadecimal characters will be lower case.</doc>
60386099 <return-value transfer-ownership="none">
60396100 <doc xml:space="preserve"
60406101 filename="glib/gchecksum.c"
6041- line="1637">the hexadecimal representation of the checksum. The
6102+ line="1655">the hexadecimal representation of the checksum. The
60426103 returned string is owned by the checksum and should not be modified
60436104 or freed.</doc>
60446105 <type name="utf8" c:type="const gchar*"/>
@@ -6047,7 +6108,7 @@ The hexadecimal characters will be lower case.</doc>
60476108 <instance-parameter name="checksum" transfer-ownership="none">
60486109 <doc xml:space="preserve"
60496110 filename="glib/gchecksum.c"
6050- line="1628">a #GChecksum</doc>
6111+ line="1646">a #GChecksum</doc>
60516112 <type name="Checksum" c:type="GChecksum*"/>
60526113 </instance-parameter>
60536114 </parameters>
@@ -6055,7 +6116,7 @@ The hexadecimal characters will be lower case.</doc>
60556116 <method name="reset" c:identifier="g_checksum_reset" version="2.18">
60566117 <doc xml:space="preserve"
60576118 filename="glib/gchecksum.c"
6058- line="1488">Resets the state of the @checksum back to its initial state.</doc>
6119+ line="1489">Resets the state of the @checksum back to its initial state.</doc>
60596120 <source-position filename="glib/gchecksum.h" line="65"/>
60606121 <return-value transfer-ownership="none">
60616122 <type name="none" c:type="void"/>
@@ -6064,7 +6125,7 @@ The hexadecimal characters will be lower case.</doc>
60646125 <instance-parameter name="checksum" transfer-ownership="none">
60656126 <doc xml:space="preserve"
60666127 filename="glib/gchecksum.c"
6067- line="1490">the #GChecksum to reset</doc>
6128+ line="1491">the #GChecksum to reset</doc>
60686129 <type name="Checksum" c:type="GChecksum*"/>
60696130 </instance-parameter>
60706131 </parameters>
@@ -6072,7 +6133,7 @@ The hexadecimal characters will be lower case.</doc>
60726133 <method name="update" c:identifier="g_checksum_update" version="2.16">
60736134 <doc xml:space="preserve"
60746135 filename="glib/gchecksum.c"
6075- line="1574">Feeds @data into an existing #GChecksum. The checksum must still be
6136+ line="1614">Feeds @data into an existing #GChecksum. The checksum must still be
60766137 open, that is g_checksum_get_string() or g_checksum_get_digest() must
60776138 not have been called on @checksum.</doc>
60786139 <source-position filename="glib/gchecksum.h" line="71"/>
@@ -6083,13 +6144,13 @@ not have been called on @checksum.</doc>
60836144 <instance-parameter name="checksum" transfer-ownership="none">
60846145 <doc xml:space="preserve"
60856146 filename="glib/gchecksum.c"
6086- line="1576">a #GChecksum</doc>
6147+ line="1616">a #GChecksum</doc>
60876148 <type name="Checksum" c:type="GChecksum*"/>
60886149 </instance-parameter>
60896150 <parameter name="data" transfer-ownership="none">
60906151 <doc xml:space="preserve"
60916152 filename="glib/gchecksum.c"
6092- line="1577">buffer used to compute the checksum</doc>
6153+ line="1617">buffer used to compute the checksum</doc>
60936154 <array length="1" zero-terminated="0" c:type="const guchar*">
60946155 <type name="guint8"/>
60956156 </array>
@@ -6097,7 +6158,7 @@ not have been called on @checksum.</doc>
60976158 <parameter name="length" transfer-ownership="none">
60986159 <doc xml:space="preserve"
60996160 filename="glib/gchecksum.c"
6100- line="1578">size of the buffer, or -1 if it is a null-terminated string.</doc>
6161+ line="1618">size of the buffer, or -1 if it is a null-terminated string.</doc>
61016162 <type name="gssize" c:type="gssize"/>
61026163 </parameter>
61036164 </parameters>
@@ -6107,12 +6168,12 @@ not have been called on @checksum.</doc>
61076168 version="2.16">
61086169 <doc xml:space="preserve"
61096170 filename="glib/gchecksum.c"
6110- line="1408">Gets the length in bytes of digests of type @checksum_type</doc>
6171+ line="1409">Gets the length in bytes of digests of type @checksum_type</doc>
61116172 <source-position filename="glib/gchecksum.h" line="60"/>
61126173 <return-value transfer-ownership="none">
61136174 <doc xml:space="preserve"
61146175 filename="glib/gchecksum.c"
6115- line="1414">the checksum length, or -1 if @checksum_type is
6176+ line="1415">the checksum length, or -1 if @checksum_type is
61166177 not supported.</doc>
61176178 <type name="gssize" c:type="gssize"/>
61186179 </return-value>
@@ -6120,7 +6181,7 @@ not supported.</doc>
61206181 <parameter name="checksum_type" transfer-ownership="none">
61216182 <doc xml:space="preserve"
61226183 filename="glib/gchecksum.c"
6123- line="1410">a #GChecksumType</doc>
6184+ line="1411">a #GChecksumType</doc>
61246185 <type name="ChecksumType" c:type="GChecksumType"/>
61256186 </parameter>
61266187 </parameters>
@@ -6164,14 +6225,14 @@ date to include new hashing algorithm types.</doc>
61646225 <callback name="ChildWatchFunc" c:type="GChildWatchFunc">
61656226 <doc xml:space="preserve"
61666227 filename="glib/gmain.h"
6167- line="234">Prototype of a #GChildWatchSource callback, called when a child
6228+ line="235">Prototype of a #GChildWatchSource callback, called when a child
61686229 process has exited.
61696230
61706231 To interpret @wait_status, see the documentation for
61716232 [func@GLib.spawn_check_wait_status]. In particular,
61726233 on Unix platforms, note that it is usually not equal
61736234 to the integer passed to `exit()` or returned from `main()`.</doc>
6174- <source-position filename="glib/gmain.h" line="249"/>
6235+ <source-position filename="glib/gmain.h" line="250"/>
61756236 <return-value transfer-ownership="none">
61766237 <type name="none" c:type="void"/>
61776238 </return-value>
@@ -6179,13 +6240,13 @@ to the integer passed to `exit()` or returned from `main()`.</doc>
61796240 <parameter name="pid" transfer-ownership="none">
61806241 <doc xml:space="preserve"
61816242 filename="glib/gmain.h"
6182- line="236">the process id of the child process</doc>
6243+ line="237">the process id of the child process</doc>
61836244 <type name="Pid" c:type="GPid"/>
61846245 </parameter>
61856246 <parameter name="wait_status" transfer-ownership="none">
61866247 <doc xml:space="preserve"
61876248 filename="glib/gmain.h"
6188- line="237">Status information about the child process, encoded
6249+ line="238">Status information about the child process, encoded
61896250 in a platform-specific manner</doc>
61906251 <type name="gint" c:type="gint"/>
61916252 </parameter>
@@ -6196,7 +6257,7 @@ to the integer passed to `exit()` or returned from `main()`.</doc>
61966257 closure="2">
61976258 <doc xml:space="preserve"
61986259 filename="glib/gmain.h"
6199- line="239">user data passed to [func@GLib.child_watch_add]</doc>
6260+ line="240">user data passed to [func@GLib.child_watch_add]</doc>
62006261 <type name="gpointer" c:type="gpointer"/>
62016262 </parameter>
62026263 </parameters>
@@ -6204,11 +6265,11 @@ to the integer passed to `exit()` or returned from `main()`.</doc>
62046265 <callback name="ClearHandleFunc" c:type="GClearHandleFunc" version="2.56">
62056266 <doc xml:space="preserve"
62066267 filename="glib/gmain.h"
6207- line="843">Specifies the type of function passed to [func@GLib.clear_handle_id] The
6268+ line="846">Specifies the type of function passed to [func@GLib.clear_handle_id] The
62086269 implementation is expected to free the resource identified by @handle_id;
62096270 for instance, if @handle_id is a [struct@GLib.Source] ID,
62106271 [func@GLib.Source.remove] can be used.</doc>
6211- <source-position filename="glib/gmain.h" line="854"/>
6272+ <source-position filename="glib/gmain.h" line="857"/>
62126273 <return-value transfer-ownership="none">
62136274 <type name="none" c:type="void"/>
62146275 </return-value>
@@ -6216,7 +6277,7 @@ for instance, if @handle_id is a [struct@GLib.Source] ID,
62166277 <parameter name="handle_id" transfer-ownership="none">
62176278 <doc xml:space="preserve"
62186279 filename="glib/gmain.h"
6219- line="845">the handle ID to clear</doc>
6280+ line="848">the handle ID to clear</doc>
62206281 <type name="guint" c:type="guint"/>
62216282 </parameter>
62226283 </parameters>
@@ -6309,7 +6370,7 @@ integer if the first value comes after the second.</doc>
63096370 deprecated-version="2.26">
63106371 <doc xml:space="preserve"
63116372 filename="glib/deprecated/gcompletion.c"
6312- line="46">`GCompletion` provides support for automatic completion of a string
6373+ line="47">`GCompletion` provides support for automatic completion of a string
63136374 using any group of target strings. It is typically used for file
63146375 name completion as is common in many UNIX shells.
63156376
@@ -6335,7 +6396,7 @@ used and not very actively maintained.</doc>
63356396 <field name="items" writable="1">
63366397 <doc xml:space="preserve"
63376398 filename="glib/deprecated/gcompletion.c"
6338- line="48">list of target items (strings or data structures).</doc>
6399+ line="49">list of target items (strings or data structures).</doc>
63396400 <type name="GLib.List" c:type="GList*">
63406401 <type name="gpointer" c:type="gpointer"/>
63416402 </type>
@@ -6343,21 +6404,21 @@ used and not very actively maintained.</doc>
63436404 <field name="func" writable="1">
63446405 <doc xml:space="preserve"
63456406 filename="glib/deprecated/gcompletion.c"
6346- line="49">function which is called to get the string associated with a
6407+ line="50">function which is called to get the string associated with a
63476408 target item. It is %NULL if the target items are strings.</doc>
63486409 <type name="CompletionFunc" c:type="GCompletionFunc"/>
63496410 </field>
63506411 <field name="prefix" writable="1">
63516412 <doc xml:space="preserve"
63526413 filename="glib/deprecated/gcompletion.c"
6353- line="51">the last prefix passed to g_completion_complete() or
6414+ line="52">the last prefix passed to g_completion_complete() or
63546415 g_completion_complete_utf8().</doc>
63556416 <type name="utf8" c:type="gchar*"/>
63566417 </field>
63576418 <field name="cache" writable="1">
63586419 <doc xml:space="preserve"
63596420 filename="glib/deprecated/gcompletion.c"
6360- line="53">the list of items which begin with @prefix.</doc>
6421+ line="54">the list of items which begin with @prefix.</doc>
63616422 <type name="GLib.List" c:type="GList*">
63626423 <type name="gpointer" c:type="gpointer"/>
63636424 </type>
@@ -6365,7 +6426,7 @@ used and not very actively maintained.</doc>
63656426 <field name="strncmp_func" writable="1">
63666427 <doc xml:space="preserve"
63676428 filename="glib/deprecated/gcompletion.c"
6368- line="54">The function to use when comparing strings. Use
6429+ line="55">The function to use when comparing strings. Use
63696430 g_completion_set_compare() to modify this function.</doc>
63706431 <type name="CompletionStrncmpFunc" c:type="GCompletionStrncmpFunc"/>
63716432 </field>
@@ -6376,7 +6437,7 @@ used and not very actively maintained.</doc>
63766437 deprecated-version="2.26">
63776438 <doc xml:space="preserve"
63786439 filename="glib/deprecated/gcompletion.c"
6379- line="140">Adds items to the #GCompletion.</doc>
6440+ line="141">Adds items to the #GCompletion.</doc>
63806441 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
63816442 <source-position filename="glib/deprecated/gcompletion.h" line="62"/>
63826443 <return-value transfer-ownership="none">
@@ -6386,13 +6447,13 @@ used and not very actively maintained.</doc>
63866447 <instance-parameter name="cmp" transfer-ownership="none">
63876448 <doc xml:space="preserve"
63886449 filename="glib/deprecated/gcompletion.c"
6389- line="142">the #GCompletion.</doc>
6450+ line="143">the #GCompletion.</doc>
63906451 <type name="Completion" c:type="GCompletion*"/>
63916452 </instance-parameter>
63926453 <parameter name="items" transfer-ownership="none">
63936454 <doc xml:space="preserve"
63946455 filename="glib/deprecated/gcompletion.c"
6395- line="143">the list of items to add.</doc>
6456+ line="144">the list of items to add.</doc>
63966457 <type name="GLib.List" c:type="GList*">
63976458 <type name="gpointer" c:type="gpointer"/>
63986459 </type>
@@ -6405,7 +6466,7 @@ used and not very actively maintained.</doc>
64056466 deprecated-version="2.26">
64066467 <doc xml:space="preserve"
64076468 filename="glib/deprecated/gcompletion.c"
6408- line="212">Removes all items from the #GCompletion. The items are not freed, so if the
6469+ line="213">Removes all items from the #GCompletion. The items are not freed, so if the
64096470 memory was dynamically allocated, it should be freed after calling this
64106471 function.</doc>
64116472 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
@@ -6417,7 +6478,7 @@ function.</doc>
64176478 <instance-parameter name="cmp" transfer-ownership="none">
64186479 <doc xml:space="preserve"
64196480 filename="glib/deprecated/gcompletion.c"
6420- line="214">the #GCompletion.</doc>
6481+ line="215">the #GCompletion.</doc>
64216482 <type name="Completion" c:type="GCompletion*"/>
64226483 </instance-parameter>
64236484 </parameters>
@@ -6429,14 +6490,14 @@ function.</doc>
64296490 deprecated-version="2.26">
64306491 <doc xml:space="preserve"
64316492 filename="glib/deprecated/gcompletion.c"
6432- line="332">Attempts to complete the string @prefix using the #GCompletion
6493+ line="333">Attempts to complete the string @prefix using the #GCompletion
64336494 target items.</doc>
64346495 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
64356496 <source-position filename="glib/deprecated/gcompletion.h" line="70"/>
64366497 <return-value transfer-ownership="none">
64376498 <doc xml:space="preserve"
64386499 filename="glib/deprecated/gcompletion.c"
6439- line="345">the list of items whose strings begin with
6500+ line="346">the list of items whose strings begin with
64406501 @prefix. This should not be changed.</doc>
64416502 <type name="GLib.List" c:type="GList*">
64426503 <type name="gpointer" c:type="gpointer"/>
@@ -6446,20 +6507,20 @@ target items.</doc>
64466507 <instance-parameter name="cmp" transfer-ownership="none">
64476508 <doc xml:space="preserve"
64486509 filename="glib/deprecated/gcompletion.c"
6449- line="334">the #GCompletion.</doc>
6510+ line="335">the #GCompletion.</doc>
64506511 <type name="Completion" c:type="GCompletion*"/>
64516512 </instance-parameter>
64526513 <parameter name="prefix" transfer-ownership="none">
64536514 <doc xml:space="preserve"
64546515 filename="glib/deprecated/gcompletion.c"
6455- line="335">the prefix string, typically typed by the user, which is
6516+ line="336">the prefix string, typically typed by the user, which is
64566517 compared with each of the items.</doc>
64576518 <type name="utf8" c:type="const gchar*"/>
64586519 </parameter>
64596520 <parameter name="new_prefix" transfer-ownership="none">
64606521 <doc xml:space="preserve"
64616522 filename="glib/deprecated/gcompletion.c"
6462- line="337">if non-%NULL, returns the longest prefix which is
6523+ line="338">if non-%NULL, returns the longest prefix which is
64636524 common to all items that matched @prefix, or %NULL if
64646525 no items matched @prefix. This string should be freed
64656526 when no longer needed.</doc>
@@ -6474,7 +6535,7 @@ target items.</doc>
64746535 deprecated-version="2.26">
64756536 <doc xml:space="preserve"
64766537 filename="glib/deprecated/gcompletion.c"
6477- line="279">Attempts to complete the string @prefix using the #GCompletion target items.
6538+ line="280">Attempts to complete the string @prefix using the #GCompletion target items.
64786539 In contrast to g_completion_complete(), this function returns the largest common
64796540 prefix that is a valid UTF-8 string, omitting a possible common partial
64806541 character.
@@ -6486,7 +6547,7 @@ items are UTF-8 strings.</doc>
64866547 <return-value transfer-ownership="none">
64876548 <doc xml:space="preserve"
64886549 filename="glib/deprecated/gcompletion.c"
6489- line="296">the list of items whose strings begin with @prefix. This should
6550+ line="297">the list of items whose strings begin with @prefix. This should
64906551 not be changed.</doc>
64916552 <type name="GLib.List" c:type="GList*">
64926553 <type name="utf8"/>
@@ -6496,20 +6557,20 @@ not be changed.</doc>
64966557 <instance-parameter name="cmp" transfer-ownership="none">
64976558 <doc xml:space="preserve"
64986559 filename="glib/deprecated/gcompletion.c"
6499- line="281">the #GCompletion</doc>
6560+ line="282">the #GCompletion</doc>
65006561 <type name="Completion" c:type="GCompletion*"/>
65016562 </instance-parameter>
65026563 <parameter name="prefix" transfer-ownership="none">
65036564 <doc xml:space="preserve"
65046565 filename="glib/deprecated/gcompletion.c"
6505- line="282">the prefix string, typically used by the user, which is compared
6566+ line="283">the prefix string, typically used by the user, which is compared
65066567 with each of the items</doc>
65076568 <type name="utf8" c:type="const gchar*"/>
65086569 </parameter>
65096570 <parameter name="new_prefix" transfer-ownership="none">
65106571 <doc xml:space="preserve"
65116572 filename="glib/deprecated/gcompletion.c"
6512- line="284">if non-%NULL, returns the longest prefix which is common to all
6573+ line="285">if non-%NULL, returns the longest prefix which is common to all
65136574 items that matched @prefix, or %NULL if no items matched @prefix.
65146575 This string should be freed when no longer needed.</doc>
65156576 <type name="utf8" c:type="gchar**"/>
@@ -6522,7 +6583,7 @@ not be changed.</doc>
65226583 deprecated-version="2.26">
65236584 <doc xml:space="preserve"
65246585 filename="glib/deprecated/gcompletion.c"
6525- line="412">Frees all memory used by the #GCompletion. The items are not freed, so if
6586+ line="413">Frees all memory used by the #GCompletion. The items are not freed, so if
65266587 the memory was dynamically allocated, it should be freed after calling this
65276588 function.</doc>
65286589 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
@@ -6534,7 +6595,7 @@ function.</doc>
65346595 <instance-parameter name="cmp" transfer-ownership="none">
65356596 <doc xml:space="preserve"
65366597 filename="glib/deprecated/gcompletion.c"
6537- line="414">the #GCompletion.</doc>
6598+ line="415">the #GCompletion.</doc>
65386599 <type name="Completion" c:type="GCompletion*"/>
65396600 </instance-parameter>
65406601 </parameters>
@@ -6546,7 +6607,7 @@ function.</doc>
65466607 deprecated-version="2.26">
65476608 <doc xml:space="preserve"
65486609 filename="glib/deprecated/gcompletion.c"
6549- line="178">Removes items from a #GCompletion. The items are not freed, so if the memory
6610+ line="179">Removes items from a #GCompletion. The items are not freed, so if the memory
65506611 was dynamically allocated, free @items with g_list_free_full() after calling
65516612 this function.</doc>
65526613 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
@@ -6558,13 +6619,13 @@ this function.</doc>
65586619 <instance-parameter name="cmp" transfer-ownership="none">
65596620 <doc xml:space="preserve"
65606621 filename="glib/deprecated/gcompletion.c"
6561- line="180">the #GCompletion.</doc>
6622+ line="181">the #GCompletion.</doc>
65626623 <type name="Completion" c:type="GCompletion*"/>
65636624 </instance-parameter>
65646625 <parameter name="items" transfer-ownership="none">
65656626 <doc xml:space="preserve"
65666627 filename="glib/deprecated/gcompletion.c"
6567- line="181">the items to remove.</doc>
6628+ line="182">the items to remove.</doc>
65686629 <type name="GLib.List" c:type="GList*">
65696630 <type name="gpointer" c:type="gpointer"/>
65706631 </type>
@@ -6578,7 +6639,7 @@ this function.</doc>
65786639 deprecated-version="2.26">
65796640 <doc xml:space="preserve"
65806641 filename="glib/deprecated/gcompletion.c"
6581- line="431">Sets the function to use for string comparisons. The default string
6642+ line="432">Sets the function to use for string comparisons. The default string
65826643 comparison function is strncmp().</doc>
65836644 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
65846645 <source-position filename="glib/deprecated/gcompletion.h" line="78"/>
@@ -6589,13 +6650,13 @@ comparison function is strncmp().</doc>
65896650 <instance-parameter name="cmp" transfer-ownership="none">
65906651 <doc xml:space="preserve"
65916652 filename="glib/deprecated/gcompletion.c"
6592- line="433">a #GCompletion.</doc>
6653+ line="434">a #GCompletion.</doc>
65936654 <type name="Completion" c:type="GCompletion*"/>
65946655 </instance-parameter>
65956656 <parameter name="strncmp_func" transfer-ownership="none">
65966657 <doc xml:space="preserve"
65976658 filename="glib/deprecated/gcompletion.c"
6598- line="434">the string comparison function.</doc>
6659+ line="435">the string comparison function.</doc>
65996660 <type name="CompletionStrncmpFunc"
66006661 c:type="GCompletionStrncmpFunc"/>
66016662 </parameter>
@@ -6608,20 +6669,20 @@ comparison function is strncmp().</doc>
66086669 deprecated-version="2.26">
66096670 <doc xml:space="preserve"
66106671 filename="glib/deprecated/gcompletion.c"
6611- line="114">Creates a new #GCompletion.</doc>
6672+ line="115">Creates a new #GCompletion.</doc>
66126673 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
66136674 <source-position filename="glib/deprecated/gcompletion.h" line="60"/>
66146675 <return-value>
66156676 <doc xml:space="preserve"
66166677 filename="glib/deprecated/gcompletion.c"
6617- line="122">the new #GCompletion.</doc>
6678+ line="123">the new #GCompletion.</doc>
66186679 <type name="Completion" c:type="GCompletion*"/>
66196680 </return-value>
66206681 <parameters>
66216682 <parameter name="func" transfer-ownership="none">
66226683 <doc xml:space="preserve"
66236684 filename="glib/deprecated/gcompletion.c"
6624- line="116">the function to be called to return the string representing
6685+ line="117">the function to be called to return the string representing
66256686 an item in the #GCompletion, or %NULL if strings are going to
66266687 be used as the #GCompletion items.</doc>
66276688 <type name="CompletionFunc" c:type="GCompletionFunc"/>
@@ -6635,7 +6696,7 @@ comparison function is strncmp().</doc>
66356696 deprecated-version="2.26">
66366697 <doc xml:space="preserve"
66376698 filename="glib/deprecated/gcompletion.c"
6638- line="82">Specifies the type of the function passed to g_completion_new(). It
6699+ line="83">Specifies the type of the function passed to g_completion_new(). It
66396700 should return the string corresponding to the given target item.
66406701 This is used when you use data structures as #GCompletion items.</doc>
66416702 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
@@ -6643,7 +6704,7 @@ This is used when you use data structures as #GCompletion items.</doc>
66436704 <return-value transfer-ownership="full">
66446705 <doc xml:space="preserve"
66456706 filename="glib/deprecated/gcompletion.c"
6646- line="90">the string corresponding to the item.</doc>
6707+ line="91">the string corresponding to the item.</doc>
66476708 <type name="utf8" c:type="gchar*"/>
66486709 </return-value>
66496710 <parameters>
@@ -6653,7 +6714,7 @@ This is used when you use data structures as #GCompletion items.</doc>
66536714 allow-none="1">
66546715 <doc xml:space="preserve"
66556716 filename="glib/deprecated/gcompletion.c"
6656- line="84">the completion item.</doc>
6717+ line="85">the completion item.</doc>
66576718 <type name="gpointer" c:type="gpointer"/>
66586719 </parameter>
66596720 </parameters>
@@ -6664,7 +6725,7 @@ This is used when you use data structures as #GCompletion items.</doc>
66646725 deprecated-version="2.26">
66656726 <doc xml:space="preserve"
66666727 filename="glib/deprecated/gcompletion.c"
6667- line="94">Specifies the type of the function passed to
6728+ line="95">Specifies the type of the function passed to
66686729 g_completion_set_compare(). This is used when you use strings as
66696730 #GCompletion items.</doc>
66706731 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
@@ -6672,7 +6733,7 @@ g_completion_set_compare(). This is used when you use strings as
66726733 <return-value transfer-ownership="none">
66736734 <doc xml:space="preserve"
66746735 filename="glib/deprecated/gcompletion.c"
6675- line="104">an integer less than, equal to, or greater than zero if
6736+ line="105">an integer less than, equal to, or greater than zero if
66766737 the first @n bytes of @s1 is found, respectively, to be
66776738 less than, to match, or to be greater than the first @n
66786739 bytes of @s2.</doc>
@@ -6682,19 +6743,19 @@ g_completion_set_compare(). This is used when you use strings as
66826743 <parameter name="s1" transfer-ownership="none">
66836744 <doc xml:space="preserve"
66846745 filename="glib/deprecated/gcompletion.c"
6685- line="96">string to compare with @s2.</doc>
6746+ line="97">string to compare with @s2.</doc>
66866747 <type name="utf8" c:type="const gchar*"/>
66876748 </parameter>
66886749 <parameter name="s2" transfer-ownership="none">
66896750 <doc xml:space="preserve"
66906751 filename="glib/deprecated/gcompletion.c"
6691- line="97">string to compare with @s1.</doc>
6752+ line="98">string to compare with @s1.</doc>
66926753 <type name="utf8" c:type="const gchar*"/>
66936754 </parameter>
66946755 <parameter name="n" transfer-ownership="none">
66956756 <doc xml:space="preserve"
66966757 filename="glib/deprecated/gcompletion.c"
6697- line="98">maximal number of bytes to compare.</doc>
6758+ line="99">maximal number of bytes to compare.</doc>
66986759 <type name="gsize" c:type="gsize"/>
66996760 </parameter>
67006761 </parameters>
@@ -7208,10 +7269,10 @@ flags &amp; ~G_DATALIST_FLAGS_MASK != 0 is an error.</doc>
72087269 introspectable="0">
72097270 <doc xml:space="preserve"
72107271 filename="glib/gmessages.h"
7211- line="268">A convenience form of g_log_structured(), recommended to be added to
7272+ line="271">A convenience form of g_log_structured(), recommended to be added to
72127273 functions when debugging. It prints the current monotonic time and the code
72137274 location using %G_STRLOC.</doc>
7214- <source-position filename="glib/gmessages.h" line="277"/>
7275+ <source-position filename="glib/gmessages.h" line="280"/>
72157276 </function-macro>
72167277 <function-macro name="DEFINE_AUTOPTR_CLEANUP_FUNC"
72177278 c:identifier="G_DEFINE_AUTOPTR_CLEANUP_FUNC"
@@ -7667,6 +7728,15 @@ in the macro, so you shouldn't use double quotes.</doc>
76677728 </parameter>
76687729 </parameters>
76697730 </function-macro>
7731+ <function-macro name="DEPRECATED_ENUMERATOR_IN_2_86_FOR"
7732+ c:identifier="GLIB_DEPRECATED_ENUMERATOR_IN_2_86_FOR"
7733+ introspectable="0">
7734+ <source-position filename="glib/glib-visibility.h" line="1062"/>
7735+ <parameters>
7736+ <parameter name="f">
7737+ </parameter>
7738+ </parameters>
7739+ </function-macro>
76707740 <function-macro name="DEPRECATED_FOR"
76717741 c:identifier="GLIB_DEPRECATED_FOR"
76727742 introspectable="0">
@@ -7946,6 +8016,15 @@ in the macro, so you shouldn't use double quotes.</doc>
79468016 </parameter>
79478017 </parameters>
79488018 </function-macro>
8019+ <function-macro name="DEPRECATED_IN_2_86_FOR"
8020+ c:identifier="GLIB_DEPRECATED_IN_2_86_FOR"
8021+ introspectable="0">
8022+ <source-position filename="glib/glib-visibility.h" line="1058"/>
8023+ <parameters>
8024+ <parameter name="f">
8025+ </parameter>
8026+ </parameters>
8027+ </function-macro>
79498028 <function-macro name="DEPRECATED_MACRO_FOR"
79508029 c:identifier="GLIB_DEPRECATED_MACRO_FOR"
79518030 introspectable="0">
@@ -8225,6 +8304,15 @@ in the macro, so you shouldn't use double quotes.</doc>
82258304 </parameter>
82268305 </parameters>
82278306 </function-macro>
8307+ <function-macro name="DEPRECATED_MACRO_IN_2_86_FOR"
8308+ c:identifier="GLIB_DEPRECATED_MACRO_IN_2_86_FOR"
8309+ introspectable="0">
8310+ <source-position filename="glib/glib-visibility.h" line="1060"/>
8311+ <parameters>
8312+ <parameter name="f">
8313+ </parameter>
8314+ </parameters>
8315+ </function-macro>
82288316 <function-macro name="DEPRECATED_TYPE_FOR"
82298317 c:identifier="GLIB_DEPRECATED_TYPE_FOR"
82308318 introspectable="0">
@@ -8504,6 +8592,15 @@ in the macro, so you shouldn't use double quotes.</doc>
85048592 </parameter>
85058593 </parameters>
85068594 </function-macro>
8595+ <function-macro name="DEPRECATED_TYPE_IN_2_86_FOR"
8596+ c:identifier="GLIB_DEPRECATED_TYPE_IN_2_86_FOR"
8597+ introspectable="0">
8598+ <source-position filename="glib/glib-visibility.h" line="1064"/>
8599+ <parameters>
8600+ <parameter name="f">
8601+ </parameter>
8602+ </parameters>
8603+ </function-macro>
85078604 <constant name="DIR_SEPARATOR" value="47" c:type="G_DIR_SEPARATOR">
85088605 <doc xml:space="preserve"
85098606 filename="glib/docs.c"
@@ -8533,7 +8630,7 @@ See also: [Keyed data lists](datalist-and-dataset.html).</doc>
85338630 <callback name="DataForeachFunc" c:type="GDataForeachFunc">
85348631 <doc xml:space="preserve"
85358632 filename="glib/gdataset.c"
8536- line="1452">Specifies the type of function passed to g_dataset_foreach(). It is
8633+ line="1492">Specifies the type of function passed to g_dataset_foreach(). It is
85378634 called with each #GQuark id and associated data element, together
85388635 with the @user_data parameter supplied to g_dataset_foreach().</doc>
85398636 <source-position filename="glib/gdataset.h" line="40"/>
@@ -8544,7 +8641,7 @@ with the @user_data parameter supplied to g_dataset_foreach().</doc>
85448641 <parameter name="key_id" transfer-ownership="none">
85458642 <doc xml:space="preserve"
85468643 filename="glib/gdataset.c"
8547- line="1454">the #GQuark id to identifying the data element.</doc>
8644+ line="1494">the #GQuark id to identifying the data element.</doc>
85488645 <type name="Quark" c:type="GQuark"/>
85498646 </parameter>
85508647 <parameter name="data"
@@ -8553,7 +8650,7 @@ with the @user_data parameter supplied to g_dataset_foreach().</doc>
85538650 allow-none="1">
85548651 <doc xml:space="preserve"
85558652 filename="glib/gdataset.c"
8556- line="1455">the data element.</doc>
8653+ line="1495">the data element.</doc>
85578654 <type name="gpointer" c:type="gpointer"/>
85588655 </parameter>
85598656 <parameter name="user_data"
@@ -8563,7 +8660,7 @@ with the @user_data parameter supplied to g_dataset_foreach().</doc>
85638660 closure="2">
85648661 <doc xml:space="preserve"
85658662 filename="glib/gdataset.c"
8566- line="1456">user data passed to g_dataset_foreach().</doc>
8663+ line="1496">user data passed to g_dataset_foreach().</doc>
85678664 <type name="gpointer" c:type="gpointer"/>
85688665 </parameter>
85698666 </parameters>
@@ -8733,10 +8830,10 @@ valid.</doc>
87338830 <method name="add_days" c:identifier="g_date_add_days">
87348831 <doc xml:space="preserve"
87358832 filename="glib/gdate.c"
8736- line="1693">Increments a date some number of days.
8833+ line="1699">Increments a date some number of days.
87378834 To move forward by weeks, add weeks*7 days.
87388835 The date must be valid.</doc>
8739- <source-position filename="glib/gdate.h" line="223"/>
8836+ <source-position filename="glib/gdate.h" line="226"/>
87408837 <return-value transfer-ownership="none">
87418838 <type name="none" c:type="void"/>
87428839 </return-value>
@@ -8744,13 +8841,13 @@ The date must be valid.</doc>
87448841 <instance-parameter name="date" transfer-ownership="none">
87458842 <doc xml:space="preserve"
87468843 filename="glib/gdate.c"
8747- line="1695">a #GDate to increment</doc>
8844+ line="1701">a #GDate to increment</doc>
87488845 <type name="Date" c:type="GDate*"/>
87498846 </instance-parameter>
87508847 <parameter name="n_days" transfer-ownership="none">
87518848 <doc xml:space="preserve"
87528849 filename="glib/gdate.c"
8753- line="1696">number of days to move the date forward</doc>
8850+ line="1702">number of days to move the date forward</doc>
87548851 <type name="guint" c:type="guint"/>
87558852 </parameter>
87568853 </parameters>
@@ -8758,12 +8855,12 @@ The date must be valid.</doc>
87588855 <method name="add_months" c:identifier="g_date_add_months">
87598856 <doc xml:space="preserve"
87608857 filename="glib/gdate.c"
8761- line="1743">Increments a date by some number of months.
8858+ line="1749">Increments a date by some number of months.
87628859 If the day of the month is greater than 28,
87638860 this routine may change the day of the month
87648861 (because the destination month may not have
87658862 the current day in it). The date must be valid.</doc>
8766- <source-position filename="glib/gdate.h" line="231"/>
8863+ <source-position filename="glib/gdate.h" line="234"/>
87678864 <return-value transfer-ownership="none">
87688865 <type name="none" c:type="void"/>
87698866 </return-value>
@@ -8771,13 +8868,13 @@ the current day in it). The date must be valid.</doc>
87718868 <instance-parameter name="date" transfer-ownership="none">
87728869 <doc xml:space="preserve"
87738870 filename="glib/gdate.c"
8774- line="1745">a #GDate to increment</doc>
8871+ line="1751">a #GDate to increment</doc>
87758872 <type name="Date" c:type="GDate*"/>
87768873 </instance-parameter>
87778874 <parameter name="n_months" transfer-ownership="none">
87788875 <doc xml:space="preserve"
87798876 filename="glib/gdate.c"
8780- line="1746">number of months to move forward</doc>
8877+ line="1752">number of months to move forward</doc>
87818878 <type name="guint" c:type="guint"/>
87828879 </parameter>
87838880 </parameters>
@@ -8785,11 +8882,11 @@ the current day in it). The date must be valid.</doc>
87858882 <method name="add_years" c:identifier="g_date_add_years">
87868883 <doc xml:space="preserve"
87878884 filename="glib/gdate.c"
8788- line="1838">Increments a date by some number of years.
8885+ line="1844">Increments a date by some number of years.
87898886 If the date is February 29, and the destination
87908887 year is not a leap year, the date will be changed
87918888 to February 28. The date must be valid.</doc>
8792- <source-position filename="glib/gdate.h" line="239"/>
8889+ <source-position filename="glib/gdate.h" line="242"/>
87938890 <return-value transfer-ownership="none">
87948891 <type name="none" c:type="void"/>
87958892 </return-value>
@@ -8797,13 +8894,13 @@ to February 28. The date must be valid.</doc>
87978894 <instance-parameter name="date" transfer-ownership="none">
87988895 <doc xml:space="preserve"
87998896 filename="glib/gdate.c"
8800- line="1840">a #GDate to increment</doc>
8897+ line="1846">a #GDate to increment</doc>
88018898 <type name="Date" c:type="GDate*"/>
88028899 </instance-parameter>
88038900 <parameter name="n_years" transfer-ownership="none">
88048901 <doc xml:space="preserve"
88058902 filename="glib/gdate.c"
8806- line="1841">number of years to move forward</doc>
8903+ line="1847">number of years to move forward</doc>
88078904 <type name="guint" c:type="guint"/>
88088905 </parameter>
88098906 </parameters>
@@ -8811,12 +8908,12 @@ to February 28. The date must be valid.</doc>
88118908 <method name="clamp" c:identifier="g_date_clamp">
88128909 <doc xml:space="preserve"
88138910 filename="glib/gdate.c"
8814- line="2128">If @date is prior to @min_date, sets @date equal to @min_date.
8911+ line="2147">If @date is prior to @min_date, sets @date equal to @min_date.
88158912 If @date falls after @max_date, sets @date equal to @max_date.
88168913 Otherwise, @date is unchanged.
88178914 Either of @min_date and @max_date may be %NULL.
88188915 All non-%NULL dates must be valid.</doc>
8819- <source-position filename="glib/gdate.h" line="269"/>
8916+ <source-position filename="glib/gdate.h" line="275"/>
88208917 <return-value transfer-ownership="none">
88218918 <type name="none" c:type="void"/>
88228919 </return-value>
@@ -8824,19 +8921,19 @@ All non-%NULL dates must be valid.</doc>
88248921 <instance-parameter name="date" transfer-ownership="none">
88258922 <doc xml:space="preserve"
88268923 filename="glib/gdate.c"
8827- line="2130">a #GDate to clamp</doc>
8924+ line="2149">a #GDate to clamp</doc>
88288925 <type name="Date" c:type="GDate*"/>
88298926 </instance-parameter>
88308927 <parameter name="min_date" transfer-ownership="none">
88318928 <doc xml:space="preserve"
88328929 filename="glib/gdate.c"
8833- line="2131">minimum accepted value for @date</doc>
8930+ line="2150">minimum accepted value for @date</doc>
88348931 <type name="Date" c:type="const GDate*"/>
88358932 </parameter>
88368933 <parameter name="max_date" transfer-ownership="none">
88378934 <doc xml:space="preserve"
88388935 filename="glib/gdate.c"
8839- line="2132">maximum accepted value for @date</doc>
8936+ line="2151">maximum accepted value for @date</doc>
88408937 <type name="Date" c:type="const GDate*"/>
88418938 </parameter>
88428939 </parameters>
@@ -8844,11 +8941,11 @@ All non-%NULL dates must be valid.</doc>
88448941 <method name="clear" c:identifier="g_date_clear">
88458942 <doc xml:space="preserve"
88468943 filename="glib/gdate.c"
8847- line="860">Initializes one or more #GDate structs to a safe but invalid
8944+ line="866">Initializes one or more #GDate structs to a safe but invalid
88488945 state. The cleared dates will not represent an existing date, but will
88498946 not contain garbage. Useful to init a date declared on the stack.
88508947 Validity can be tested with g_date_valid().</doc>
8851- <source-position filename="glib/gdate.h" line="178"/>
8948+ <source-position filename="glib/gdate.h" line="181"/>
88528949 <return-value transfer-ownership="none">
88538950 <type name="none" c:type="void"/>
88548951 </return-value>
@@ -8856,13 +8953,13 @@ Validity can be tested with g_date_valid().</doc>
88568953 <instance-parameter name="date" transfer-ownership="none">
88578954 <doc xml:space="preserve"
88588955 filename="glib/gdate.c"
8859- line="862">pointer to one or more dates to clear</doc>
8956+ line="868">pointer to one or more dates to clear</doc>
88608957 <type name="Date" c:type="GDate*"/>
88618958 </instance-parameter>
88628959 <parameter name="n_dates" transfer-ownership="none">
88638960 <doc xml:space="preserve"
88648961 filename="glib/gdate.c"
8865- line="863">number of dates to clear</doc>
8962+ line="869">number of dates to clear</doc>
88668963 <type name="guint" c:type="guint"/>
88678964 </parameter>
88688965 </parameters>
@@ -8870,13 +8967,13 @@ Validity can be tested with g_date_valid().</doc>
88708967 <method name="compare" c:identifier="g_date_compare">
88718968 <doc xml:space="preserve"
88728969 filename="glib/gdate.c"
8873- line="2023">qsort()-style comparison function for dates.
8970+ line="2042">qsort()-style comparison function for dates.
88748971 Both dates must be valid.</doc>
8875- <source-position filename="glib/gdate.h" line="262"/>
8972+ <source-position filename="glib/gdate.h" line="268"/>
88768973 <return-value transfer-ownership="none">
88778974 <doc xml:space="preserve"
88788975 filename="glib/gdate.c"
8879- line="2031">0 for equal, less than zero if @lhs is less than @rhs,
8976+ line="2050">0 for equal, less than zero if @lhs is less than @rhs,
88808977 greater than zero if @lhs is greater than @rhs</doc>
88818978 <type name="gint" c:type="gint"/>
88828979 </return-value>
@@ -8884,13 +8981,13 @@ Both dates must be valid.</doc>
88848981 <instance-parameter name="lhs" transfer-ownership="none">
88858982 <doc xml:space="preserve"
88868983 filename="glib/gdate.c"
8887- line="2025">first date to compare</doc>
8984+ line="2044">first date to compare</doc>
88888985 <type name="Date" c:type="const GDate*"/>
88898986 </instance-parameter>
88908987 <parameter name="rhs" transfer-ownership="none">
88918988 <doc xml:space="preserve"
88928989 filename="glib/gdate.c"
8893- line="2026">second date to compare</doc>
8990+ line="2045">second date to compare</doc>
88948991 <type name="Date" c:type="const GDate*"/>
88958992 </parameter>
88968993 </parameters>
@@ -8920,27 +9017,27 @@ as is into the new object.</doc>
89209017 <method name="days_between" c:identifier="g_date_days_between">
89219018 <doc xml:space="preserve"
89229019 filename="glib/gdate.c"
8923- line="839">Computes the number of days between two dates.
9020+ line="845">Computes the number of days between two dates.
89249021 If @date2 is prior to @date1, the returned value is negative.
89259022 Both dates must be valid.</doc>
8926- <source-position filename="glib/gdate.h" line="257"/>
9023+ <source-position filename="glib/gdate.h" line="263"/>
89279024 <return-value transfer-ownership="none">
89289025 <doc xml:space="preserve"
89299026 filename="glib/gdate.c"
8930- line="848">the number of days between @date1 and @date2</doc>
9027+ line="854">the number of days between @date1 and @date2</doc>
89319028 <type name="gint" c:type="gint"/>
89329029 </return-value>
89339030 <parameters>
89349031 <instance-parameter name="date1" transfer-ownership="none">
89359032 <doc xml:space="preserve"
89369033 filename="glib/gdate.c"
8937- line="841">the first date</doc>
9034+ line="847">the first date</doc>
89389035 <type name="Date" c:type="const GDate*"/>
89399036 </instance-parameter>
89409037 <parameter name="date2" transfer-ownership="none">
89419038 <doc xml:space="preserve"
89429039 filename="glib/gdate.c"
8943- line="842">the second date</doc>
9040+ line="848">the second date</doc>
89449041 <type name="Date" c:type="const GDate*"/>
89459042 </parameter>
89469043 </parameters>
@@ -9008,20 +9105,20 @@ year. The date must be valid.</doc>
90089105 version="2.6">
90099106 <doc xml:space="preserve"
90109107 filename="glib/gdate.c"
9011- line="803">Returns the week of the year, where weeks are interpreted according
9108+ line="809">Returns the week of the year, where weeks are interpreted according
90129109 to ISO 8601.</doc>
9013- <source-position filename="glib/gdate.h" line="171"/>
9110+ <source-position filename="glib/gdate.h" line="174"/>
90149111 <return-value transfer-ownership="none">
90159112 <doc xml:space="preserve"
90169113 filename="glib/gdate.c"
9017- line="810">ISO 8601 week number of the year.</doc>
9114+ line="816">ISO 8601 week number of the year.</doc>
90189115 <type name="guint" c:type="guint"/>
90199116 </return-value>
90209117 <parameters>
90219118 <instance-parameter name="date" transfer-ownership="none">
90229119 <doc xml:space="preserve"
90239120 filename="glib/gdate.c"
9024- line="805">a valid #GDate</doc>
9121+ line="811">a valid #GDate</doc>
90259122 <type name="Date" c:type="const GDate*"/>
90269123 </instance-parameter>
90279124 </parameters>
@@ -9096,23 +9193,62 @@ The date must be valid.</doc>
90969193 c:identifier="g_date_get_sunday_week_of_year">
90979194 <doc xml:space="preserve"
90989195 filename="glib/gdate.c"
9099- line="768">Returns the week of the year during which this date falls, if
9196+ line="750">Returns the week of the year during which this date falls, if
91009197 weeks are understood to begin on Sunday. The date must be valid.
91019198 Can return 0 if the day is before the first Sunday of the year.</doc>
91029199 <source-position filename="glib/gdate.h" line="169"/>
91039200 <return-value transfer-ownership="none">
91049201 <doc xml:space="preserve"
91059202 filename="glib/gdate.c"
9106- line="776">week number</doc>
9203+ line="758">week number</doc>
9204+ <type name="guint" c:type="guint"/>
9205+ </return-value>
9206+ <parameters>
9207+ <instance-parameter name="date" transfer-ownership="none">
9208+ <doc xml:space="preserve"
9209+ filename="glib/gdate.c"
9210+ line="752">a #GDate</doc>
9211+ <type name="Date" c:type="const GDate*"/>
9212+ </instance-parameter>
9213+ </parameters>
9214+ </method>
9215+ <method name="get_week_of_year"
9216+ c:identifier="g_date_get_week_of_year"
9217+ version="2.86">
9218+ <doc xml:space="preserve"
9219+ filename="glib/gdate.c"
9220+ line="766">Calculates the week of the year during which this date falls.
9221+
9222+The result depends on which day is considered the first day of the week,
9223+which varies by locale. Both `date` and `first_day_of_week` must be valid.
9224+
9225+If @date is before the start of the first week of the year (for example,
9226+before the first Monday in January if @first_day_of_week is
9227+[enum@GLib.DateWeekday.MONDAY]) then zero will be returned.</doc>
9228+ <source-position filename="glib/gdate.h" line="171"/>
9229+ <return-value transfer-ownership="none">
9230+ <doc xml:space="preserve"
9231+ filename="glib/gdate.c"
9232+ line="783">week number (starting from 1), or `0` if @date is before the start
9233+ of the first week of the year</doc>
91079234 <type name="guint" c:type="guint"/>
91089235 </return-value>
91099236 <parameters>
91109237 <instance-parameter name="date" transfer-ownership="none">
91119238 <doc xml:space="preserve"
91129239 filename="glib/gdate.c"
9113- line="770">a #GDate</doc>
9240+ line="768">a [struct@GLib.Date]</doc>
91149241 <type name="Date" c:type="const GDate*"/>
91159242 </instance-parameter>
9243+ <parameter name="first_day_of_week" transfer-ownership="none">
9244+ <doc xml:space="preserve"
9245+ filename="glib/gdate.c"
9246+ line="769">the day which is considered the first day of the week
9247+ (for example, this would be [enum@GLib.DateWeekday.SUNDAY] in US locales,
9248+ [enum@GLib.DateWeekday.MONDAY] in British locales, and
9249+ [enum@GLib.DateWeekday.SATURDAY] in Egyptian locales</doc>
9250+ <type name="DateWeekday" c:type="GDateWeekday"/>
9251+ </parameter>
91169252 </parameters>
91179253 </method>
91189254 <method name="get_weekday" c:identifier="g_date_get_weekday">
@@ -9158,20 +9294,20 @@ Can return 0 if the day is before the first Sunday of the year.</doc>
91589294 <method name="is_first_of_month" c:identifier="g_date_is_first_of_month">
91599295 <doc xml:space="preserve"
91609296 filename="glib/gdate.c"
9161- line="1643">Returns %TRUE if the date is on the first of a month.
9297+ line="1649">Returns %TRUE if the date is on the first of a month.
91629298 The date must be valid.</doc>
9163- <source-position filename="glib/gdate.h" line="217"/>
9299+ <source-position filename="glib/gdate.h" line="220"/>
91649300 <return-value transfer-ownership="none">
91659301 <doc xml:space="preserve"
91669302 filename="glib/gdate.c"
9167- line="1650">%TRUE if the date is the first of the month</doc>
9303+ line="1656">%TRUE if the date is the first of the month</doc>
91689304 <type name="gboolean" c:type="gboolean"/>
91699305 </return-value>
91709306 <parameters>
91719307 <instance-parameter name="date" transfer-ownership="none">
91729308 <doc xml:space="preserve"
91739309 filename="glib/gdate.c"
9174- line="1645">a #GDate to check</doc>
9310+ line="1651">a #GDate to check</doc>
91759311 <type name="Date" c:type="const GDate*"/>
91769312 </instance-parameter>
91779313 </parameters>
@@ -9179,20 +9315,20 @@ The date must be valid.</doc>
91799315 <method name="is_last_of_month" c:identifier="g_date_is_last_of_month">
91809316 <doc xml:space="preserve"
91819317 filename="glib/gdate.c"
9182- line="1666">Returns %TRUE if the date is the last day of the month.
9318+ line="1672">Returns %TRUE if the date is the last day of the month.
91839319 The date must be valid.</doc>
9184- <source-position filename="glib/gdate.h" line="219"/>
9320+ <source-position filename="glib/gdate.h" line="222"/>
91859321 <return-value transfer-ownership="none">
91869322 <doc xml:space="preserve"
91879323 filename="glib/gdate.c"
9188- line="1673">%TRUE if the date is the last day of the month</doc>
9324+ line="1679">%TRUE if the date is the last day of the month</doc>
91899325 <type name="gboolean" c:type="gboolean"/>
91909326 </return-value>
91919327 <parameters>
91929328 <instance-parameter name="date" transfer-ownership="none">
91939329 <doc xml:space="preserve"
91949330 filename="glib/gdate.c"
9195- line="1668">a #GDate to check</doc>
9331+ line="1674">a #GDate to check</doc>
91969332 <type name="Date" c:type="const GDate*"/>
91979333 </instance-parameter>
91989334 </parameters>
@@ -9200,9 +9336,9 @@ The date must be valid.</doc>
92009336 <method name="order" c:identifier="g_date_order">
92019337 <doc xml:space="preserve"
92029338 filename="glib/gdate.c"
9203- line="2163">Checks if @date1 is less than or equal to @date2,
9339+ line="2182">Checks if @date1 is less than or equal to @date2,
92049340 and swap the values if this is not the case.</doc>
9205- <source-position filename="glib/gdate.h" line="275"/>
9341+ <source-position filename="glib/gdate.h" line="281"/>
92069342 <return-value transfer-ownership="none">
92079343 <type name="none" c:type="void"/>
92089344 </return-value>
@@ -9210,13 +9346,13 @@ and swap the values if this is not the case.</doc>
92109346 <instance-parameter name="date1" transfer-ownership="none">
92119347 <doc xml:space="preserve"
92129348 filename="glib/gdate.c"
9213- line="2165">the first date</doc>
9349+ line="2184">the first date</doc>
92149350 <type name="Date" c:type="GDate*"/>
92159351 </instance-parameter>
92169352 <parameter name="date2" transfer-ownership="none">
92179353 <doc xml:space="preserve"
92189354 filename="glib/gdate.c"
9219- line="2166">the second date</doc>
9355+ line="2185">the second date</doc>
92209356 <type name="Date" c:type="GDate*"/>
92219357 </parameter>
92229358 </parameters>
@@ -9224,9 +9360,9 @@ and swap the values if this is not the case.</doc>
92249360 <method name="set_day" c:identifier="g_date_set_day">
92259361 <doc xml:space="preserve"
92269362 filename="glib/gdate.c"
9227- line="1542">Sets the day of the month for a #GDate. If the resulting
9363+ line="1548">Sets the day of the month for a #GDate. If the resulting
92289364 day-month-year triplet is invalid, the date will be invalid.</doc>
9229- <source-position filename="glib/gdate.h" line="203"/>
9365+ <source-position filename="glib/gdate.h" line="206"/>
92309366 <return-value transfer-ownership="none">
92319367 <type name="none" c:type="void"/>
92329368 </return-value>
@@ -9234,13 +9370,13 @@ day-month-year triplet is invalid, the date will be invalid.</doc>
92349370 <instance-parameter name="date" transfer-ownership="none">
92359371 <doc xml:space="preserve"
92369372 filename="glib/gdate.c"
9237- line="1544">a #GDate</doc>
9373+ line="1550">a #GDate</doc>
92389374 <type name="Date" c:type="GDate*"/>
92399375 </instance-parameter>
92409376 <parameter name="day" transfer-ownership="none">
92419377 <doc xml:space="preserve"
92429378 filename="glib/gdate.c"
9243- line="1545">day to set</doc>
9379+ line="1551">day to set</doc>
92449380 <type name="DateDay" c:type="GDateDay"/>
92459381 </parameter>
92469382 </parameters>
@@ -9248,11 +9384,11 @@ day-month-year triplet is invalid, the date will be invalid.</doc>
92489384 <method name="set_dmy" c:identifier="g_date_set_dmy">
92499385 <doc xml:space="preserve"
92509386 filename="glib/gdate.c"
9251- line="1594">Sets the value of a #GDate from a day, month, and year.
9387+ line="1600">Sets the value of a #GDate from a day, month, and year.
92529388 The day-month-year triplet must be valid; if you aren't
92539389 sure it is, call g_date_valid_dmy() to check before you
92549390 set it.</doc>
9255- <source-position filename="glib/gdate.h" line="209"/>
9391+ <source-position filename="glib/gdate.h" line="212"/>
92569392 <return-value transfer-ownership="none">
92579393 <type name="none" c:type="void"/>
92589394 </return-value>
@@ -9260,25 +9396,25 @@ set it.</doc>
92609396 <instance-parameter name="date" transfer-ownership="none">
92619397 <doc xml:space="preserve"
92629398 filename="glib/gdate.c"
9263- line="1596">a #GDate</doc>
9399+ line="1602">a #GDate</doc>
92649400 <type name="Date" c:type="GDate*"/>
92659401 </instance-parameter>
92669402 <parameter name="day" transfer-ownership="none">
92679403 <doc xml:space="preserve"
92689404 filename="glib/gdate.c"
9269- line="1597">day</doc>
9405+ line="1603">day</doc>
92709406 <type name="DateDay" c:type="GDateDay"/>
92719407 </parameter>
92729408 <parameter name="month" transfer-ownership="none">
92739409 <doc xml:space="preserve"
92749410 filename="glib/gdate.c"
9275- line="1598">month</doc>
9411+ line="1604">month</doc>
92769412 <type name="DateMonth" c:type="GDateMonth"/>
92779413 </parameter>
92789414 <parameter name="y" transfer-ownership="none">
92799415 <doc xml:space="preserve"
92809416 filename="glib/gdate.c"
9281- line="1599">year</doc>
9417+ line="1605">year</doc>
92829418 <type name="DateYear" c:type="GDateYear"/>
92839419 </parameter>
92849420 </parameters>
@@ -9286,8 +9422,8 @@ set it.</doc>
92869422 <method name="set_julian" c:identifier="g_date_set_julian">
92879423 <doc xml:space="preserve"
92889424 filename="glib/gdate.c"
9289- line="1624">Sets the value of a #GDate from a Julian day number.</doc>
9290- <source-position filename="glib/gdate.h" line="214"/>
9425+ line="1630">Sets the value of a #GDate from a Julian day number.</doc>
9426+ <source-position filename="glib/gdate.h" line="217"/>
92919427 <return-value transfer-ownership="none">
92929428 <type name="none" c:type="void"/>
92939429 </return-value>
@@ -9295,13 +9431,13 @@ set it.</doc>
92959431 <instance-parameter name="date" transfer-ownership="none">
92969432 <doc xml:space="preserve"
92979433 filename="glib/gdate.c"
9298- line="1626">a #GDate</doc>
9434+ line="1632">a #GDate</doc>
92999435 <type name="Date" c:type="GDate*"/>
93009436 </instance-parameter>
93019437 <parameter name="julian_date" transfer-ownership="none">
93029438 <doc xml:space="preserve"
93039439 filename="glib/gdate.c"
9304- line="1627">Julian day number (days since January 1, Year 1)</doc>
9440+ line="1633">Julian day number (days since January 1, Year 1)</doc>
93059441 <type name="guint32" c:type="guint32"/>
93069442 </parameter>
93079443 </parameters>
@@ -9309,9 +9445,9 @@ set it.</doc>
93099445 <method name="set_month" c:identifier="g_date_set_month">
93109446 <doc xml:space="preserve"
93119447 filename="glib/gdate.c"
9312- line="1516">Sets the month of the year for a #GDate. If the resulting
9448+ line="1522">Sets the month of the year for a #GDate. If the resulting
93139449 day-month-year triplet is invalid, the date will be invalid.</doc>
9314- <source-position filename="glib/gdate.h" line="200"/>
9450+ <source-position filename="glib/gdate.h" line="203"/>
93159451 <return-value transfer-ownership="none">
93169452 <type name="none" c:type="void"/>
93179453 </return-value>
@@ -9319,13 +9455,13 @@ day-month-year triplet is invalid, the date will be invalid.</doc>
93199455 <instance-parameter name="date" transfer-ownership="none">
93209456 <doc xml:space="preserve"
93219457 filename="glib/gdate.c"
9322- line="1518">a #GDate</doc>
9458+ line="1524">a #GDate</doc>
93239459 <type name="Date" c:type="GDate*"/>
93249460 </instance-parameter>
93259461 <parameter name="month" transfer-ownership="none">
93269462 <doc xml:space="preserve"
93279463 filename="glib/gdate.c"
9328- line="1519">month to set</doc>
9464+ line="1525">month to set</doc>
93299465 <type name="DateMonth" c:type="GDateMonth"/>
93309466 </parameter>
93319467 </parameters>
@@ -9333,7 +9469,7 @@ day-month-year triplet is invalid, the date will be invalid.</doc>
93339469 <method name="set_parse" c:identifier="g_date_set_parse">
93349470 <doc xml:space="preserve"
93359471 filename="glib/gdate.c"
9336- line="1225">Parses a user-inputted string @str, and try to figure out what date it
9472+ line="1231">Parses a user-inputted string @str, and try to figure out what date it
93379473 represents, taking the [current locale](running.html#locale)
93389474 into account. If the string is successfully parsed, the date will be
93399475 valid after the call. Otherwise, it will be invalid. You should check
@@ -9344,7 +9480,7 @@ isn't very precise, and its exact behavior varies with the locale.
93449480 It's intended to be a heuristic routine that guesses what the user
93459481 means by a given string (and it does work pretty well in that
93469482 capacity).</doc>
9347- <source-position filename="glib/gdate.h" line="186"/>
9483+ <source-position filename="glib/gdate.h" line="189"/>
93489484 <return-value transfer-ownership="none">
93499485 <type name="none" c:type="void"/>
93509486 </return-value>
@@ -9352,13 +9488,13 @@ capacity).</doc>
93529488 <instance-parameter name="date" transfer-ownership="none">
93539489 <doc xml:space="preserve"
93549490 filename="glib/gdate.c"
9355- line="1227">a #GDate to fill in</doc>
9491+ line="1233">a #GDate to fill in</doc>
93569492 <type name="Date" c:type="GDate*"/>
93579493 </instance-parameter>
93589494 <parameter name="str" transfer-ownership="none">
93599495 <doc xml:space="preserve"
93609496 filename="glib/gdate.c"
9361- line="1228">string to parse</doc>
9497+ line="1234">string to parse</doc>
93629498 <type name="utf8" c:type="const gchar*"/>
93639499 </parameter>
93649500 </parameters>
@@ -9369,10 +9505,10 @@ capacity).</doc>
93699505 deprecated-version="2.10">
93709506 <doc xml:space="preserve"
93719507 filename="glib/gdate.c"
9372- line="1473">Sets the value of a date from a #GTime value.
9508+ line="1479">Sets the value of a date from a #GTime value.
93739509 The time to date conversion is done using the user's current timezone.</doc>
93749510 <doc-deprecated xml:space="preserve">Use g_date_set_time_t() instead.</doc-deprecated>
9375- <source-position filename="glib/gdate.h" line="196"/>
9511+ <source-position filename="glib/gdate.h" line="199"/>
93769512 <return-value transfer-ownership="none">
93779513 <type name="none" c:type="void"/>
93789514 </return-value>
@@ -9380,13 +9516,13 @@ The time to date conversion is done using the user's current timezone.</doc>
93809516 <instance-parameter name="date" transfer-ownership="none">
93819517 <doc xml:space="preserve"
93829518 filename="glib/gdate.c"
9383- line="1475">a #GDate.</doc>
9519+ line="1481">a #GDate.</doc>
93849520 <type name="Date" c:type="GDate*"/>
93859521 </instance-parameter>
93869522 <parameter name="time_" transfer-ownership="none">
93879523 <doc xml:space="preserve"
93889524 filename="glib/gdate.c"
9389- line="1476">#GTime value to set.</doc>
9525+ line="1482">#GTime value to set.</doc>
93909526 <type name="Time" c:type="GTime"/>
93919527 </parameter>
93929528 </parameters>
@@ -9396,7 +9532,7 @@ The time to date conversion is done using the user's current timezone.</doc>
93969532 version="2.10">
93979533 <doc xml:space="preserve"
93989534 filename="glib/gdate.c"
9399- line="1417">Sets the value of a date to the date corresponding to a time
9535+ line="1423">Sets the value of a date to the date corresponding to a time
94009536 specified as a time_t. The time to date conversion is done using
94019537 the user's current timezone.
94029538
@@ -9407,7 +9543,7 @@ To set the value of a date to the current day, you could write:
94079543 // handle the error
94089544 g_date_set_time_t (date, now);
94099545 ]|</doc>
9410- <source-position filename="glib/gdate.h" line="189"/>
9546+ <source-position filename="glib/gdate.h" line="192"/>
94119547 <return-value transfer-ownership="none">
94129548 <type name="none" c:type="void"/>
94139549 </return-value>
@@ -9415,13 +9551,13 @@ To set the value of a date to the current day, you could write:
94159551 <instance-parameter name="date" transfer-ownership="none">
94169552 <doc xml:space="preserve"
94179553 filename="glib/gdate.c"
9418- line="1419">a #GDate</doc>
9554+ line="1425">a #GDate</doc>
94199555 <type name="Date" c:type="GDate*"/>
94209556 </instance-parameter>
94219557 <parameter name="timet" transfer-ownership="none">
94229558 <doc xml:space="preserve"
94239559 filename="glib/gdate.c"
9424- line="1420">time_t value to set</doc>
9560+ line="1426">time_t value to set</doc>
94259561 <type name="time_t" c:type="time_t"/>
94269562 </parameter>
94279563 </parameters>
@@ -9433,14 +9569,14 @@ To set the value of a date to the current day, you could write:
94339569 deprecated-version="2.62">
94349570 <doc xml:space="preserve"
94359571 filename="glib/gdate.c"
9436- line="1492">Sets the value of a date from a #GTimeVal value. Note that the
9572+ line="1498">Sets the value of a date from a #GTimeVal value. Note that the
94379573 @tv_usec member is ignored, because #GDate can't make use of the
94389574 additional precision.
94399575
94409576 The time to date conversion is done using the user's current timezone.</doc>
94419577 <doc-deprecated xml:space="preserve">#GTimeVal is not year-2038-safe. Use g_date_set_time_t()
94429578 instead.</doc-deprecated>
9443- <source-position filename="glib/gdate.h" line="193"/>
9579+ <source-position filename="glib/gdate.h" line="196"/>
94449580 <return-value transfer-ownership="none">
94459581 <type name="none" c:type="void"/>
94469582 </return-value>
@@ -9448,13 +9584,13 @@ The time to date conversion is done using the user's current timezone.</doc>
94489584 <instance-parameter name="date" transfer-ownership="none">
94499585 <doc xml:space="preserve"
94509586 filename="glib/gdate.c"
9451- line="1494">a #GDate</doc>
9587+ line="1500">a #GDate</doc>
94529588 <type name="Date" c:type="GDate*"/>
94539589 </instance-parameter>
94549590 <parameter name="timeval" transfer-ownership="none">
94559591 <doc xml:space="preserve"
94569592 filename="glib/gdate.c"
9457- line="1495">#GTimeVal value to set</doc>
9593+ line="1501">#GTimeVal value to set</doc>
94589594 <type name="TimeVal" c:type="GTimeVal*"/>
94599595 </parameter>
94609596 </parameters>
@@ -9462,9 +9598,9 @@ The time to date conversion is done using the user's current timezone.</doc>
94629598 <method name="set_year" c:identifier="g_date_set_year">
94639599 <doc xml:space="preserve"
94649600 filename="glib/gdate.c"
9465- line="1568">Sets the year for a #GDate. If the resulting day-month-year
9601+ line="1574">Sets the year for a #GDate. If the resulting day-month-year
94669602 triplet is invalid, the date will be invalid.</doc>
9467- <source-position filename="glib/gdate.h" line="206"/>
9603+ <source-position filename="glib/gdate.h" line="209"/>
94689604 <return-value transfer-ownership="none">
94699605 <type name="none" c:type="void"/>
94709606 </return-value>
@@ -9472,13 +9608,13 @@ triplet is invalid, the date will be invalid.</doc>
94729608 <instance-parameter name="date" transfer-ownership="none">
94739609 <doc xml:space="preserve"
94749610 filename="glib/gdate.c"
9475- line="1570">a #GDate</doc>
9611+ line="1576">a #GDate</doc>
94769612 <type name="Date" c:type="GDate*"/>
94779613 </instance-parameter>
94789614 <parameter name="year" transfer-ownership="none">
94799615 <doc xml:space="preserve"
94809616 filename="glib/gdate.c"
9481- line="1571">year to set</doc>
9617+ line="1577">year to set</doc>
94829618 <type name="DateYear" c:type="GDateYear"/>
94839619 </parameter>
94849620 </parameters>
@@ -9486,10 +9622,10 @@ triplet is invalid, the date will be invalid.</doc>
94869622 <method name="subtract_days" c:identifier="g_date_subtract_days">
94879623 <doc xml:space="preserve"
94889624 filename="glib/gdate.c"
9489- line="1718">Moves a date some number of days into the past.
9625+ line="1724">Moves a date some number of days into the past.
94909626 To move by weeks, just move by weeks*7 days.
94919627 The date must be valid.</doc>
9492- <source-position filename="glib/gdate.h" line="226"/>
9628+ <source-position filename="glib/gdate.h" line="229"/>
94939629 <return-value transfer-ownership="none">
94949630 <type name="none" c:type="void"/>
94959631 </return-value>
@@ -9497,13 +9633,13 @@ The date must be valid.</doc>
94979633 <instance-parameter name="date" transfer-ownership="none">
94989634 <doc xml:space="preserve"
94999635 filename="glib/gdate.c"
9500- line="1720">a #GDate to decrement</doc>
9636+ line="1726">a #GDate to decrement</doc>
95019637 <type name="Date" c:type="GDate*"/>
95029638 </instance-parameter>
95039639 <parameter name="n_days" transfer-ownership="none">
95049640 <doc xml:space="preserve"
95059641 filename="glib/gdate.c"
9506- line="1721">number of days to move</doc>
9642+ line="1727">number of days to move</doc>
95079643 <type name="guint" c:type="guint"/>
95089644 </parameter>
95099645 </parameters>
@@ -9511,11 +9647,11 @@ The date must be valid.</doc>
95119647 <method name="subtract_months" c:identifier="g_date_subtract_months">
95129648 <doc xml:space="preserve"
95139649 filename="glib/gdate.c"
9514- line="1789">Moves a date some number of months into the past.
9650+ line="1795">Moves a date some number of months into the past.
95159651 If the current day of the month doesn't exist in
95169652 the destination month, the day of the month
95179653 may change. The date must be valid.</doc>
9518- <source-position filename="glib/gdate.h" line="234"/>
9654+ <source-position filename="glib/gdate.h" line="237"/>
95199655 <return-value transfer-ownership="none">
95209656 <type name="none" c:type="void"/>
95219657 </return-value>
@@ -9523,13 +9659,13 @@ may change. The date must be valid.</doc>
95239659 <instance-parameter name="date" transfer-ownership="none">
95249660 <doc xml:space="preserve"
95259661 filename="glib/gdate.c"
9526- line="1791">a #GDate to decrement</doc>
9662+ line="1797">a #GDate to decrement</doc>
95279663 <type name="Date" c:type="GDate*"/>
95289664 </instance-parameter>
95299665 <parameter name="n_months" transfer-ownership="none">
95309666 <doc xml:space="preserve"
95319667 filename="glib/gdate.c"
9532- line="1792">number of months to move</doc>
9668+ line="1798">number of months to move</doc>
95339669 <type name="guint" c:type="guint"/>
95349670 </parameter>
95359671 </parameters>
@@ -9537,12 +9673,12 @@ may change. The date must be valid.</doc>
95379673 <method name="subtract_years" c:identifier="g_date_subtract_years">
95389674 <doc xml:space="preserve"
95399675 filename="glib/gdate.c"
9540- line="1871">Moves a date some number of years into the past.
9676+ line="1877">Moves a date some number of years into the past.
95419677 If the current day doesn't exist in the destination
95429678 year (i.e. it's February 29 and you move to a non-leap-year)
95439679 then the day is changed to February 29. The date
95449680 must be valid.</doc>
9545- <source-position filename="glib/gdate.h" line="242"/>
9681+ <source-position filename="glib/gdate.h" line="245"/>
95469682 <return-value transfer-ownership="none">
95479683 <type name="none" c:type="void"/>
95489684 </return-value>
@@ -9550,13 +9686,13 @@ must be valid.</doc>
95509686 <instance-parameter name="date" transfer-ownership="none">
95519687 <doc xml:space="preserve"
95529688 filename="glib/gdate.c"
9553- line="1873">a #GDate to decrement</doc>
9689+ line="1879">a #GDate to decrement</doc>
95549690 <type name="Date" c:type="GDate*"/>
95559691 </instance-parameter>
95569692 <parameter name="n_years" transfer-ownership="none">
95579693 <doc xml:space="preserve"
95589694 filename="glib/gdate.c"
9559- line="1874">number of years to move</doc>
9695+ line="1880">number of years to move</doc>
95609696 <type name="guint" c:type="guint"/>
95619697 </parameter>
95629698 </parameters>
@@ -9564,9 +9700,9 @@ must be valid.</doc>
95649700 <method name="to_struct_tm" c:identifier="g_date_to_struct_tm">
95659701 <doc xml:space="preserve"
95669702 filename="glib/gdate.c"
9567- line="2083">Fills in the date-related bits of a struct tm using the @date value.
9703+ line="2102">Fills in the date-related bits of a struct tm using the @date value.
95689704 Initializes the non-date parts with something safe but meaningless.</doc>
9569- <source-position filename="glib/gdate.h" line="265"/>
9705+ <source-position filename="glib/gdate.h" line="271"/>
95709706 <return-value transfer-ownership="none">
95719707 <type name="none" c:type="void"/>
95729708 </return-value>
@@ -9574,13 +9710,13 @@ Initializes the non-date parts with something safe but meaningless.</doc>
95749710 <instance-parameter name="date" transfer-ownership="none">
95759711 <doc xml:space="preserve"
95769712 filename="glib/gdate.c"
9577- line="2085">a #GDate to set the struct tm from</doc>
9713+ line="2104">a #GDate to set the struct tm from</doc>
95789714 <type name="Date" c:type="const GDate*"/>
95799715 </instance-parameter>
95809716 <parameter name="tm" transfer-ownership="none">
95819717 <doc xml:space="preserve"
95829718 filename="glib/gdate.c"
9583- line="2086">struct tm to fill</doc>
9719+ line="2105">struct tm to fill</doc>
95849720 <type name="gpointer" c:type="tm*"/>
95859721 </parameter>
95869722 </parameters>
@@ -9611,26 +9747,26 @@ if it wasn't allocated by one of the g_date_new() variants.</doc>
96119747 c:identifier="g_date_get_days_in_month">
96129748 <doc xml:space="preserve"
96139749 filename="glib/gdate.c"
9614- line="1927">Returns the number of days in a month, taking leap
9750+ line="1933">Returns the number of days in a month, taking leap
96159751 years into account.</doc>
9616- <source-position filename="glib/gdate.h" line="247"/>
9752+ <source-position filename="glib/gdate.h" line="250"/>
96179753 <return-value transfer-ownership="none">
96189754 <doc xml:space="preserve"
96199755 filename="glib/gdate.c"
9620- line="1935">number of days in @month during the @year</doc>
9756+ line="1941">number of days in @month during the @year</doc>
96219757 <type name="guint8" c:type="guint8"/>
96229758 </return-value>
96239759 <parameters>
96249760 <parameter name="month" transfer-ownership="none">
96259761 <doc xml:space="preserve"
96269762 filename="glib/gdate.c"
9627- line="1929">month</doc>
9763+ line="1935">month</doc>
96289764 <type name="DateMonth" c:type="GDateMonth"/>
96299765 </parameter>
96309766 <parameter name="year" transfer-ownership="none">
96319767 <doc xml:space="preserve"
96329768 filename="glib/gdate.c"
9633- line="1930">year</doc>
9769+ line="1936">year</doc>
96349770 <type name="DateYear" c:type="GDateYear"/>
96359771 </parameter>
96369772 </parameters>
@@ -9639,25 +9775,25 @@ years into account.</doc>
96399775 c:identifier="g_date_get_monday_weeks_in_year">
96409776 <doc xml:space="preserve"
96419777 filename="glib/gdate.c"
9642- line="1951">Returns the number of weeks in the year, where weeks
9778+ line="1957">Returns the number of weeks in the year, where weeks
96439779 are taken to start on Monday. Will be 52 or 53. The
96449780 date must be valid. (Years always have 52 7-day periods,
96459781 plus 1 or 2 extra days depending on whether it's a leap
96469782 year. This function is basically telling you how many
96479783 Mondays are in the year, i.e. there are 53 Mondays if
96489784 one of the extra days happens to be a Monday.)</doc>
9649- <source-position filename="glib/gdate.h" line="250"/>
9785+ <source-position filename="glib/gdate.h" line="253"/>
96509786 <return-value transfer-ownership="none">
96519787 <doc xml:space="preserve"
96529788 filename="glib/gdate.c"
9653- line="1963">number of Mondays in the year</doc>
9789+ line="1969">number of Mondays in the year</doc>
96549790 <type name="guint8" c:type="guint8"/>
96559791 </return-value>
96569792 <parameters>
96579793 <parameter name="year" transfer-ownership="none">
96589794 <doc xml:space="preserve"
96599795 filename="glib/gdate.c"
9660- line="1953">a year</doc>
9796+ line="1959">a year</doc>
96619797 <type name="DateYear" c:type="GDateYear"/>
96629798 </parameter>
96639799 </parameters>
@@ -9666,50 +9802,89 @@ one of the extra days happens to be a Monday.)</doc>
96669802 c:identifier="g_date_get_sunday_weeks_in_year">
96679803 <doc xml:space="preserve"
96689804 filename="glib/gdate.c"
9669- line="1987">Returns the number of weeks in the year, where weeks
9805+ line="1977">Returns the number of weeks in the year, where weeks
96709806 are taken to start on Sunday. Will be 52 or 53. The
96719807 date must be valid. (Years always have 52 7-day periods,
96729808 plus 1 or 2 extra days depending on whether it's a leap
96739809 year. This function is basically telling you how many
96749810 Sundays are in the year, i.e. there are 53 Sundays if
96759811 one of the extra days happens to be a Sunday.)</doc>
9676- <source-position filename="glib/gdate.h" line="252"/>
9812+ <source-position filename="glib/gdate.h" line="255"/>
9813+ <return-value transfer-ownership="none">
9814+ <doc xml:space="preserve"
9815+ filename="glib/gdate.c"
9816+ line="1989">the number of weeks in @year</doc>
9817+ <type name="guint8" c:type="guint8"/>
9818+ </return-value>
9819+ <parameters>
9820+ <parameter name="year" transfer-ownership="none">
9821+ <doc xml:space="preserve"
9822+ filename="glib/gdate.c"
9823+ line="1979">year to count weeks in</doc>
9824+ <type name="DateYear" c:type="GDateYear"/>
9825+ </parameter>
9826+ </parameters>
9827+ </function>
9828+ <function name="get_weeks_in_year"
9829+ c:identifier="g_date_get_weeks_in_year"
9830+ version="2.86">
9831+ <doc xml:space="preserve"
9832+ filename="glib/gdate.c"
9833+ line="1997">Calculates the number of weeks in the year.
9834+
9835+The result depends on which day is considered the first day of the week,
9836+which varies by locale. `first_day_of_week` must be valid.
9837+
9838+The result will be either 52 or 53. Years always have 52 seven-day periods,
9839+plus one or two extra days depending on whether it’s a leap year. This
9840+function effectively calculates how many @first_day_of_week days there are in
9841+the year.</doc>
9842+ <source-position filename="glib/gdate.h" line="257"/>
96779843 <return-value transfer-ownership="none">
96789844 <doc xml:space="preserve"
96799845 filename="glib/gdate.c"
9680- line="1999">the number of weeks in @year</doc>
9846+ line="2015">the number of weeks in @year</doc>
96819847 <type name="guint8" c:type="guint8"/>
96829848 </return-value>
96839849 <parameters>
96849850 <parameter name="year" transfer-ownership="none">
96859851 <doc xml:space="preserve"
96869852 filename="glib/gdate.c"
9687- line="1989">year to count weeks in</doc>
9853+ line="1999">year to count weeks in</doc>
96889854 <type name="DateYear" c:type="GDateYear"/>
96899855 </parameter>
9856+ <parameter name="first_day_of_week" transfer-ownership="none">
9857+ <doc xml:space="preserve"
9858+ filename="glib/gdate.c"
9859+ line="2000">the day which is considered the first day of the week
9860+ (for example, this would be [enum@GLib.DateWeekday.SUNDAY] in US locales,
9861+ [enum@GLib.DateWeekday.MONDAY] in British locales, and
9862+ [enum@GLib.DateWeekday.SATURDAY] in Egyptian locales</doc>
9863+ <type name="DateWeekday" c:type="GDateWeekday"/>
9864+ </parameter>
96909865 </parameters>
96919866 </function>
96929867 <function name="is_leap_year" c:identifier="g_date_is_leap_year">
96939868 <doc xml:space="preserve"
96949869 filename="glib/gdate.c"
9695- line="1905">Returns %TRUE if the year is a leap year.
9870+ line="1911">Returns %TRUE if the year is a leap year.
96969871
96979872 For the purposes of this function, leap year is every year
96989873 divisible by 4 unless that year is divisible by 100. If it
96999874 is divisible by 100 it would be a leap year only if that year
97009875 is also divisible by 400.</doc>
9701- <source-position filename="glib/gdate.h" line="245"/>
9876+ <source-position filename="glib/gdate.h" line="248"/>
97029877 <return-value transfer-ownership="none">
97039878 <doc xml:space="preserve"
97049879 filename="glib/gdate.c"
9705- line="1916">%TRUE if the year is a leap year</doc>
9880+ line="1922">%TRUE if the year is a leap year</doc>
97069881 <type name="gboolean" c:type="gboolean"/>
97079882 </return-value>
97089883 <parameters>
97099884 <parameter name="year" transfer-ownership="none">
97109885 <doc xml:space="preserve"
97119886 filename="glib/gdate.c"
9712- line="1907">year to check</doc>
9887+ line="1913">year to check</doc>
97139888 <type name="DateYear" c:type="GDateYear"/>
97149889 </parameter>
97159890 </parameters>
@@ -9717,7 +9892,7 @@ is also divisible by 400.</doc>
97179892 <function name="strftime" c:identifier="g_date_strftime">
97189893 <doc xml:space="preserve"
97199894 filename="glib/gdate.c"
9720- line="2626">Generates a printed representation of the date, in a
9895+ line="2645">Generates a printed representation of the date, in a
97219896 [locale](running.html#locale)-specific way.
97229897 Works just like the platform's C library strftime() function,
97239898 but only accepts date-related formats; time-related formats
@@ -9730,36 +9905,36 @@ addition to those implemented by the platform's C library.
97309905 For example, don't expect that using g_date_strftime() would
97319906 make the \%F provided by the C99 strftime() work on Windows
97329907 where the C library only complies to C89.</doc>
9733- <source-position filename="glib/gdate.h" line="281"/>
9908+ <source-position filename="glib/gdate.h" line="287"/>
97349909 <return-value transfer-ownership="none">
97359910 <doc xml:space="preserve"
97369911 filename="glib/gdate.c"
9737- line="2647">number of characters written to the buffer, or `0` if the buffer was too small</doc>
9912+ line="2666">number of characters written to the buffer, or `0` if the buffer was too small</doc>
97389913 <type name="gsize" c:type="gsize"/>
97399914 </return-value>
97409915 <parameters>
97419916 <parameter name="s" transfer-ownership="none">
97429917 <doc xml:space="preserve"
97439918 filename="glib/gdate.c"
9744- line="2628">destination buffer</doc>
9919+ line="2647">destination buffer</doc>
97459920 <type name="utf8" c:type="gchar*"/>
97469921 </parameter>
97479922 <parameter name="slen" transfer-ownership="none">
97489923 <doc xml:space="preserve"
97499924 filename="glib/gdate.c"
9750- line="2629">buffer size</doc>
9925+ line="2648">buffer size</doc>
97519926 <type name="gsize" c:type="gsize"/>
97529927 </parameter>
97539928 <parameter name="format" transfer-ownership="none">
97549929 <doc xml:space="preserve"
97559930 filename="glib/gdate.c"
9756- line="2630">format string</doc>
9931+ line="2649">format string</doc>
97579932 <type name="utf8" c:type="const gchar*"/>
97589933 </parameter>
97599934 <parameter name="date" transfer-ownership="none">
97609935 <doc xml:space="preserve"
97619936 filename="glib/gdate.c"
9762- line="2631">valid #GDate</doc>
9937+ line="2650">valid #GDate</doc>
97639938 <type name="Date" c:type="const GDate*"/>
97649939 </parameter>
97659940 </parameters>
@@ -12098,7 +12273,7 @@ It is an error to call any of the `GDir` methods other than
1209812273 throws="1">
1209912274 <doc xml:space="preserve"
1210012275 filename="glib/gfileutils.c"
12101- line="1864">Creates a subdirectory in the preferred directory for temporary
12276+ line="1885">Creates a subdirectory in the preferred directory for temporary
1210212277 files (as returned by g_get_tmp_dir()).
1210312278
1210412279 @tmpl should be a string in the GLib file name encoding containing
@@ -12113,7 +12288,7 @@ modified, and might thus be a read-only literal string.</doc>
1211312288 <return-value transfer-ownership="full">
1211412289 <doc xml:space="preserve"
1211512290 filename="glib/gfileutils.c"
12116- line="1882">The actual name used. This string
12291+ line="1903">The actual name used. This string
1211712292 should be freed with g_free() when not needed any longer and is
1211812293 is in the GLib file name encoding. In case of errors, %NULL is
1211912294 returned and @error will be set.</doc>
@@ -12126,7 +12301,7 @@ modified, and might thus be a read-only literal string.</doc>
1212612301 allow-none="1">
1212712302 <doc xml:space="preserve"
1212812303 filename="glib/gfileutils.c"
12129- line="1866">Template for directory name,
12304+ line="1887">Template for directory name,
1213012305 as in g_mkdtemp(), basename only, or %NULL for a default template</doc>
1213112306 <type name="filename" c:type="const gchar*"/>
1213212307 </parameter>
@@ -12166,7 +12341,7 @@ as appropriate for a given platform. IEEE floats and doubles are supported
1216612341 <callback name="DuplicateFunc" c:type="GDuplicateFunc">
1216712342 <doc xml:space="preserve"
1216812343 filename="glib/gdataset.c"
12169- line="1224">The type of functions that are used to 'duplicate' an object.
12344+ line="1258">The type of functions that are used to 'duplicate' an object.
1217012345 What this means depends on the context, it could just be
1217112346 incrementing the reference count, if @data is a ref-counted
1217212347 object.</doc>
@@ -12174,7 +12349,7 @@ object.</doc>
1217412349 <return-value transfer-ownership="none" nullable="1">
1217512350 <doc xml:space="preserve"
1217612351 filename="glib/gdataset.c"
12177- line="1235">a duplicate of data</doc>
12352+ line="1269">a duplicate of data</doc>
1217812353 <type name="gpointer" c:type="gpointer"/>
1217912354 </return-value>
1218012355 <parameters>
@@ -12184,7 +12359,7 @@ object.</doc>
1218412359 allow-none="1">
1218512360 <doc xml:space="preserve"
1218612361 filename="glib/gdataset.c"
12187- line="1226">the data to duplicate</doc>
12362+ line="1260">the data to duplicate</doc>
1218812363 <type name="gpointer" c:type="gpointer"/>
1218912364 </parameter>
1219012365 <parameter name="user_data"
@@ -12194,7 +12369,7 @@ object.</doc>
1219412369 closure="1">
1219512370 <doc xml:space="preserve"
1219612371 filename="glib/gdataset.c"
12197- line="1227">user data that was specified in
12372+ line="1261">user data that was specified in
1219812373 g_datalist_id_dup_data()</doc>
1219912374 <type name="gpointer" c:type="gpointer"/>
1220012375 </parameter>
@@ -13082,19 +13257,19 @@ as appropriate for a given platform. IEEE floats and doubles are supported
1308213257 <bitfield name="FormatSizeFlags" c:type="GFormatSizeFlags">
1308313258 <doc xml:space="preserve"
1308413259 filename="glib/gutils.c"
13085- line="2912">Flags to modify the format of the string returned by g_format_size_full().</doc>
13260+ line="2914">Flags to modify the format of the string returned by g_format_size_full().</doc>
1308613261 <source-position filename="glib/gutils.h" line="302"/>
1308713262 <member name="default" value="0" c:identifier="G_FORMAT_SIZE_DEFAULT">
1308813263 <doc xml:space="preserve"
1308913264 filename="glib/gutils.c"
13090- line="2914">behave the same as g_format_size()</doc>
13265+ line="2916">behave the same as g_format_size()</doc>
1309113266 </member>
1309213267 <member name="long_format"
1309313268 value="1"
1309413269 c:identifier="G_FORMAT_SIZE_LONG_FORMAT">
1309513270 <doc xml:space="preserve"
1309613271 filename="glib/gutils.c"
13097- line="2915">include the exact number of bytes as part
13272+ line="2917">include the exact number of bytes as part
1309813273 of the returned string. For example, "45.6 kB (45,612 bytes)".</doc>
1309913274 </member>
1310013275 <member name="iec_units"
@@ -13102,7 +13277,7 @@ as appropriate for a given platform. IEEE floats and doubles are supported
1310213277 c:identifier="G_FORMAT_SIZE_IEC_UNITS">
1310313278 <doc xml:space="preserve"
1310413279 filename="glib/gutils.c"
13105- line="2917">use IEC (base 1024) units with "KiB"-style
13280+ line="2919">use IEC (base 1024) units with "KiB"-style
1310613281 suffixes. IEC units should only be used for reporting things with
1310713282 a strong "power of 2" basis, like RAM sizes or RAID stripe sizes.
1310813283 Network and storage sizes should be reported in the normal SI units.</doc>
@@ -13110,7 +13285,7 @@ as appropriate for a given platform. IEEE floats and doubles are supported
1311013285 <member name="bits" value="4" c:identifier="G_FORMAT_SIZE_BITS">
1311113286 <doc xml:space="preserve"
1311213287 filename="glib/gutils.c"
13113- line="2921">set the size as a quantity in bits, rather than
13288+ line="2923">set the size as a quantity in bits, rather than
1311413289 bytes, and return units in bits. For example, ‘Mbit’ rather than ‘MB’.</doc>
1311513290 </member>
1311613291 <member name="only_value"
@@ -13118,7 +13293,7 @@ as appropriate for a given platform. IEEE floats and doubles are supported
1311813293 c:identifier="G_FORMAT_SIZE_ONLY_VALUE">
1311913294 <doc xml:space="preserve"
1312013295 filename="glib/gutils.c"
13121- line="2923">return only value, without unit; this should
13296+ line="2925">return only value, without unit; this should
1312213297 not be used together with @G_FORMAT_SIZE_LONG_FORMAT
1312313298 nor @G_FORMAT_SIZE_ONLY_UNIT. Since: 2.74</doc>
1312413299 </member>
@@ -13127,7 +13302,7 @@ as appropriate for a given platform. IEEE floats and doubles are supported
1312713302 c:identifier="G_FORMAT_SIZE_ONLY_UNIT">
1312813303 <doc xml:space="preserve"
1312913304 filename="glib/gutils.c"
13130- line="2926">return only unit, without value; this should
13305+ line="2928">return only unit, without value; this should
1313113306 not be used together with @G_FORMAT_SIZE_LONG_FORMAT
1313213307 nor @G_FORMAT_SIZE_ONLY_VALUE. Since: 2.74</doc>
1313313308 </member>
@@ -13849,7 +14024,7 @@ following functions.</doc>
1384914024 <function name="add" c:identifier="g_hash_table_add" version="2.32">
1385014025 <doc xml:space="preserve"
1385114026 filename="glib/ghash.c"
13852- line="1637">This is a convenience function for using a #GHashTable as a set. It
14027+ line="1640">This is a convenience function for using a #GHashTable as a set. It
1385314028 is equivalent to calling g_hash_table_replace() with @key as both the
1385414029 key and the value.
1385514030
@@ -13868,14 +14043,14 @@ or not.</doc>
1386814043 <return-value transfer-ownership="none">
1386914044 <doc xml:space="preserve"
1387014045 filename="glib/ghash.c"
13871- line="1658">%TRUE if the key did not exist yet</doc>
14046+ line="1661">%TRUE if the key did not exist yet</doc>
1387214047 <type name="gboolean" c:type="gboolean"/>
1387314048 </return-value>
1387414049 <parameters>
1387514050 <parameter name="hash_table" transfer-ownership="none">
1387614051 <doc xml:space="preserve"
1387714052 filename="glib/ghash.c"
13878- line="1639">a #GHashTable</doc>
14053+ line="1642">a #GHashTable</doc>
1387914054 <type name="GLib.HashTable" c:type="GHashTable*">
1388014055 <type name="gpointer" c:type="gpointer"/>
1388114056 <type name="gpointer" c:type="gpointer"/>
@@ -13887,7 +14062,7 @@ or not.</doc>
1388714062 allow-none="1">
1388814063 <doc xml:space="preserve"
1388914064 filename="glib/ghash.c"
13890- line="1640">a key to insert</doc>
14065+ line="1643">a key to insert</doc>
1389114066 <type name="gpointer" c:type="gpointer"/>
1389214067 </parameter>
1389314068 </parameters>
@@ -13897,19 +14072,19 @@ or not.</doc>
1389714072 version="2.32">
1389814073 <doc xml:space="preserve"
1389914074 filename="glib/ghash.c"
13900- line="1669">Checks if @key is in @hash_table.</doc>
14075+ line="1672">Checks if @key is in @hash_table.</doc>
1390114076 <source-position filename="glib/ghash.h" line="105"/>
1390214077 <return-value transfer-ownership="none">
1390314078 <doc xml:space="preserve"
1390414079 filename="glib/ghash.c"
13905- line="1676">%TRUE if @key is in @hash_table, %FALSE otherwise.</doc>
14080+ line="1679">%TRUE if @key is in @hash_table, %FALSE otherwise.</doc>
1390614081 <type name="gboolean" c:type="gboolean"/>
1390714082 </return-value>
1390814083 <parameters>
1390914084 <parameter name="hash_table" transfer-ownership="none">
1391014085 <doc xml:space="preserve"
1391114086 filename="glib/ghash.c"
13912- line="1671">a #GHashTable</doc>
14087+ line="1674">a #GHashTable</doc>
1391314088 <type name="GLib.HashTable" c:type="GHashTable*">
1391414089 <type name="gpointer" c:type="gpointer"/>
1391514090 <type name="gpointer" c:type="gpointer"/>
@@ -13921,7 +14096,7 @@ or not.</doc>
1392114096 allow-none="1">
1392214097 <doc xml:space="preserve"
1392314098 filename="glib/ghash.c"
13924- line="1672">a key to check</doc>
14099+ line="1675">a key to check</doc>
1392514100 <type name="gpointer" c:type="gconstpointer"/>
1392614101 </parameter>
1392714102 </parameters>
@@ -13929,7 +14104,7 @@ or not.</doc>
1392914104 <function name="destroy" c:identifier="g_hash_table_destroy">
1393014105 <doc xml:space="preserve"
1393114106 filename="glib/ghash.c"
13932- line="1447">Destroys all keys and values in the #GHashTable and decrements its
14107+ line="1450">Destroys all keys and values in the #GHashTable and decrements its
1393314108 reference count by 1. If keys and/or values are dynamically allocated,
1393414109 you should either free them first or create the #GHashTable with destroy
1393514110 notifiers using g_hash_table_new_full(). In the latter case the destroy
@@ -13943,7 +14118,7 @@ destruction phase.</doc>
1394314118 <parameter name="hash_table" transfer-ownership="none">
1394414119 <doc xml:space="preserve"
1394514120 filename="glib/ghash.c"
13946- line="1449">a #GHashTable</doc>
14121+ line="1452">a #GHashTable</doc>
1394714122 <type name="GLib.HashTable" c:type="GHashTable*">
1394814123 <type name="gpointer" c:type="gpointer"/>
1394914124 <type name="gpointer" c:type="gpointer"/>
@@ -13954,7 +14129,7 @@ destruction phase.</doc>
1395414129 <function name="find" c:identifier="g_hash_table_find" version="2.4">
1395514130 <doc xml:space="preserve"
1395614131 filename="glib/ghash.c"
13957- line="2136">Calls the given function for key/value pairs in the #GHashTable
14132+ line="2139">Calls the given function for key/value pairs in the #GHashTable
1395814133 until @predicate returns %TRUE. The function is passed the key
1395914134 and value of each pair, and the given @user_data parameter. The
1396014135 hash table may not be modified while iterating over it (you can't
@@ -13971,7 +14146,7 @@ values in a hash table ends up needing O(n*n) operations).</doc>
1397114146 <return-value transfer-ownership="none" nullable="1">
1397214147 <doc xml:space="preserve"
1397314148 filename="glib/ghash.c"
13974- line="2156">The value of the first key/value pair is returned,
14149+ line="2159">The value of the first key/value pair is returned,
1397514150 for which @predicate evaluates to %TRUE. If no pair with the
1397614151 requested property is found, %NULL is returned.</doc>
1397714152 <type name="gpointer" c:type="gpointer"/>
@@ -13980,7 +14155,7 @@ values in a hash table ends up needing O(n*n) operations).</doc>
1398014155 <parameter name="hash_table" transfer-ownership="none">
1398114156 <doc xml:space="preserve"
1398214157 filename="glib/ghash.c"
13983- line="2138">a #GHashTable</doc>
14158+ line="2141">a #GHashTable</doc>
1398414159 <type name="GLib.HashTable" c:type="GHashTable*">
1398514160 <type name="gpointer" c:type="gpointer"/>
1398614161 <type name="gpointer" c:type="gpointer"/>
@@ -13992,7 +14167,7 @@ values in a hash table ends up needing O(n*n) operations).</doc>
1399214167 closure="2">
1399314168 <doc xml:space="preserve"
1399414169 filename="glib/ghash.c"
13995- line="2139">function to test the key/value pairs for a certain property</doc>
14170+ line="2142">function to test the key/value pairs for a certain property</doc>
1399614171 <type name="HRFunc" c:type="GHRFunc"/>
1399714172 </parameter>
1399814173 <parameter name="user_data"
@@ -14001,7 +14176,7 @@ values in a hash table ends up needing O(n*n) operations).</doc>
1400114176 allow-none="1">
1400214177 <doc xml:space="preserve"
1400314178 filename="glib/ghash.c"
14004- line="2140">user data to pass to the function</doc>
14179+ line="2143">user data to pass to the function</doc>
1400514180 <type name="gpointer" c:type="gpointer"/>
1400614181 </parameter>
1400714182 </parameters>
@@ -14009,7 +14184,7 @@ values in a hash table ends up needing O(n*n) operations).</doc>
1400914184 <function name="foreach" c:identifier="g_hash_table_foreach">
1401014185 <doc xml:space="preserve"
1401114186 filename="glib/ghash.c"
14012- line="2085">Calls the given function for each of the key/value pairs in the
14187+ line="2088">Calls the given function for each of the key/value pairs in the
1401314188 #GHashTable. The function is passed the key and value of each
1401414189 pair, and the given @user_data parameter. The hash table may not
1401514190 be modified while iterating over it (you can't add/remove
@@ -14029,7 +14204,7 @@ order searches in contrast to g_hash_table_lookup().</doc>
1402914204 <parameter name="hash_table" transfer-ownership="none">
1403014205 <doc xml:space="preserve"
1403114206 filename="glib/ghash.c"
14032- line="2087">a #GHashTable</doc>
14207+ line="2090">a #GHashTable</doc>
1403314208 <type name="GLib.HashTable" c:type="GHashTable*">
1403414209 <type name="gpointer" c:type="gpointer"/>
1403514210 <type name="gpointer" c:type="gpointer"/>
@@ -14041,7 +14216,7 @@ order searches in contrast to g_hash_table_lookup().</doc>
1404114216 closure="2">
1404214217 <doc xml:space="preserve"
1404314218 filename="glib/ghash.c"
14044- line="2088">the function to call for each key/value pair</doc>
14219+ line="2091">the function to call for each key/value pair</doc>
1404514220 <type name="HFunc" c:type="GHFunc"/>
1404614221 </parameter>
1404714222 <parameter name="user_data"
@@ -14050,7 +14225,7 @@ order searches in contrast to g_hash_table_lookup().</doc>
1405014225 allow-none="1">
1405114226 <doc xml:space="preserve"
1405214227 filename="glib/ghash.c"
14053- line="2089">user data to pass to the function</doc>
14228+ line="2092">user data to pass to the function</doc>
1405414229 <type name="gpointer" c:type="gpointer"/>
1405514230 </parameter>
1405614231 </parameters>
@@ -14059,7 +14234,7 @@ order searches in contrast to g_hash_table_lookup().</doc>
1405914234 c:identifier="g_hash_table_foreach_remove">
1406014235 <doc xml:space="preserve"
1406114236 filename="glib/ghash.c"
14062- line="2030">Calls the given function for each key/value pair in the
14237+ line="2033">Calls the given function for each key/value pair in the
1406314238 #GHashTable. If the function returns %TRUE, then the key/value
1406414239 pair is removed from the #GHashTable. If you supplied key or
1406514240 value destroy functions when creating the #GHashTable, they are
@@ -14071,14 +14246,14 @@ key/value pairs in the hash table.</doc>
1407114246 <return-value transfer-ownership="none">
1407214247 <doc xml:space="preserve"
1407314248 filename="glib/ghash.c"
14074- line="2045">the number of key/value pairs removed</doc>
14249+ line="2048">the number of key/value pairs removed</doc>
1407514250 <type name="guint" c:type="guint"/>
1407614251 </return-value>
1407714252 <parameters>
1407814253 <parameter name="hash_table" transfer-ownership="none">
1407914254 <doc xml:space="preserve"
1408014255 filename="glib/ghash.c"
14081- line="2032">a #GHashTable</doc>
14256+ line="2035">a #GHashTable</doc>
1408214257 <type name="GLib.HashTable" c:type="GHashTable*">
1408314258 <type name="gpointer" c:type="gpointer"/>
1408414259 <type name="gpointer" c:type="gpointer"/>
@@ -14090,7 +14265,7 @@ key/value pairs in the hash table.</doc>
1409014265 closure="2">
1409114266 <doc xml:space="preserve"
1409214267 filename="glib/ghash.c"
14093- line="2033">the function to call for each key/value pair</doc>
14268+ line="2036">the function to call for each key/value pair</doc>
1409414269 <type name="HRFunc" c:type="GHRFunc"/>
1409514270 </parameter>
1409614271 <parameter name="user_data"
@@ -14099,7 +14274,7 @@ key/value pairs in the hash table.</doc>
1409914274 allow-none="1">
1410014275 <doc xml:space="preserve"
1410114276 filename="glib/ghash.c"
14102- line="2034">user data to pass to the function</doc>
14277+ line="2037">user data to pass to the function</doc>
1410314278 <type name="gpointer" c:type="gpointer"/>
1410414279 </parameter>
1410514280 </parameters>
@@ -14107,7 +14282,7 @@ key/value pairs in the hash table.</doc>
1410714282 <function name="foreach_steal" c:identifier="g_hash_table_foreach_steal">
1410814283 <doc xml:space="preserve"
1410914284 filename="glib/ghash.c"
14110- line="2058">Calls the given function for each key/value pair in the
14285+ line="2061">Calls the given function for each key/value pair in the
1411114286 #GHashTable. If the function returns %TRUE, then the key/value
1411214287 pair is removed from the #GHashTable, but no key or value
1411314288 destroy functions are called.
@@ -14118,14 +14293,14 @@ key/value pairs in the hash table.</doc>
1411814293 <return-value transfer-ownership="none">
1411914294 <doc xml:space="preserve"
1412014295 filename="glib/ghash.c"
14121- line="2072">the number of key/value pairs removed.</doc>
14296+ line="2075">the number of key/value pairs removed.</doc>
1412214297 <type name="guint" c:type="guint"/>
1412314298 </return-value>
1412414299 <parameters>
1412514300 <parameter name="hash_table" transfer-ownership="none">
1412614301 <doc xml:space="preserve"
1412714302 filename="glib/ghash.c"
14128- line="2060">a #GHashTable</doc>
14303+ line="2063">a #GHashTable</doc>
1412914304 <type name="GLib.HashTable" c:type="GHashTable*">
1413014305 <type name="gpointer" c:type="gpointer"/>
1413114306 <type name="gpointer" c:type="gpointer"/>
@@ -14137,7 +14312,7 @@ key/value pairs in the hash table.</doc>
1413714312 closure="2">
1413814313 <doc xml:space="preserve"
1413914314 filename="glib/ghash.c"
14140- line="2061">the function to call for each key/value pair</doc>
14315+ line="2064">the function to call for each key/value pair</doc>
1414114316 <type name="HRFunc" c:type="GHRFunc"/>
1414214317 </parameter>
1414314318 <parameter name="user_data"
@@ -14146,7 +14321,7 @@ key/value pairs in the hash table.</doc>
1414614321 allow-none="1">
1414714322 <doc xml:space="preserve"
1414814323 filename="glib/ghash.c"
14149- line="2062">user data to pass to the function</doc>
14324+ line="2065">user data to pass to the function</doc>
1415014325 <type name="gpointer" c:type="gpointer"/>
1415114326 </parameter>
1415214327 </parameters>
@@ -14157,7 +14332,7 @@ key/value pairs in the hash table.</doc>
1415714332 introspectable="0">
1415814333 <doc xml:space="preserve"
1415914334 filename="glib/ghash.c"
14160- line="2218">Retrieves every key inside @hash_table. The returned data is valid
14335+ line="2221">Retrieves every key inside @hash_table. The returned data is valid
1416114336 until changes to the hash release those keys.
1416214337
1416314338 This iterates over every entry in the hash table to build its return value.
@@ -14167,7 +14342,7 @@ To iterate over the entries in a #GHashTable more efficiently, use a
1416714342 <return-value transfer-ownership="container">
1416814343 <doc xml:space="preserve"
1416914344 filename="glib/ghash.c"
14170- line="2229">a #GList containing all the keys
14345+ line="2232">a #GList containing all the keys
1417114346 inside the hash table. The content of the list is owned by the
1417214347 hash table and should not be modified or freed. Use g_list_free()
1417314348 when done using the list.</doc>
@@ -14179,7 +14354,7 @@ To iterate over the entries in a #GHashTable more efficiently, use a
1417914354 <parameter name="hash_table" transfer-ownership="none">
1418014355 <doc xml:space="preserve"
1418114356 filename="glib/ghash.c"
14182- line="2220">a #GHashTable</doc>
14357+ line="2223">a #GHashTable</doc>
1418314358 <type name="GLib.HashTable" c:type="GHashTable*">
1418414359 <type name="gpointer" c:type="gpointer"/>
1418514360 <type name="gpointer" c:type="gpointer"/>
@@ -14193,7 +14368,7 @@ To iterate over the entries in a #GHashTable more efficiently, use a
1419314368 introspectable="0">
1419414369 <doc xml:space="preserve"
1419514370 filename="glib/ghash.c"
14196- line="2254">Retrieves every key inside @hash_table, as an array.
14371+ line="2257">Retrieves every key inside @hash_table, as an array.
1419714372
1419814373 The returned array is %NULL-terminated but may contain %NULL as a
1419914374 key. Use @length to determine the true length if it's possible that
@@ -14214,7 +14389,7 @@ first to transfer ownership of the keys.</doc>
1421414389 <return-value transfer-ownership="container">
1421514390 <doc xml:space="preserve"
1421614391 filename="glib/ghash.c"
14217- line="2277">a
14392+ line="2280">a
1421814393 %NULL-terminated array containing each key from the table.</doc>
1421914394 <array length="1" zero-terminated="0" c:type="gpointer*">
1422014395 <type name="gpointer" c:type="gpointer"/>
@@ -14224,7 +14399,7 @@ first to transfer ownership of the keys.</doc>
1422414399 <parameter name="hash_table" transfer-ownership="none">
1422514400 <doc xml:space="preserve"
1422614401 filename="glib/ghash.c"
14227- line="2256">a #GHashTable</doc>
14402+ line="2259">a #GHashTable</doc>
1422814403 <type name="GLib.HashTable" c:type="GHashTable*">
1422914404 <type name="gpointer" c:type="gpointer"/>
1423014405 <type name="gpointer" c:type="gpointer"/>
@@ -14238,7 +14413,7 @@ first to transfer ownership of the keys.</doc>
1423814413 allow-none="1">
1423914414 <doc xml:space="preserve"
1424014415 filename="glib/ghash.c"
14241- line="2257">the length of the returned array</doc>
14416+ line="2260">the length of the returned array</doc>
1424214417 <type name="guint" c:type="guint*"/>
1424314418 </parameter>
1424414419 </parameters>
@@ -14249,7 +14424,7 @@ first to transfer ownership of the keys.</doc>
1424914424 introspectable="0">
1425014425 <doc xml:space="preserve"
1425114426 filename="glib/ghash.c"
14252- line="2304">Retrieves every key inside @hash_table, as a #GPtrArray.
14427+ line="2307">Retrieves every key inside @hash_table, as a #GPtrArray.
1425314428 The returned data is valid until changes to the hash release those keys.
1425414429
1425514430 This iterates over every entry in the hash table to build its return value.
@@ -14261,8 +14436,8 @@ You should always unref the returned array with g_ptr_array_unref().</doc>
1426114436 <return-value transfer-ownership="container">
1426214437 <doc xml:space="preserve"
1426314438 filename="glib/ghash.c"
14264- line="2317">a #GPtrArray containing each key from
14265-the table. Unref with with g_ptr_array_unref() when done.</doc>
14439+ line="2320">a #GPtrArray containing each key from
14440+the table. Unref with g_ptr_array_unref() when done.</doc>
1426614441 <array name="GLib.PtrArray" c:type="GPtrArray*">
1426714442 <type name="gpointer" c:type="gpointer"/>
1426814443 </array>
@@ -14271,7 +14446,7 @@ the table. Unref with with g_ptr_array_unref() when done.</doc>
1427114446 <parameter name="hash_table" transfer-ownership="none">
1427214447 <doc xml:space="preserve"
1427314448 filename="glib/ghash.c"
14274- line="2306">a #GHashTable</doc>
14449+ line="2309">a #GHashTable</doc>
1427514450 <type name="GLib.HashTable" c:type="GHashTable*">
1427614451 <type name="gpointer" c:type="gpointer"/>
1427714452 <type name="gpointer" c:type="gpointer"/>
@@ -14285,7 +14460,7 @@ the table. Unref with with g_ptr_array_unref() when done.</doc>
1428514460 introspectable="0">
1428614461 <doc xml:space="preserve"
1428714462 filename="glib/ghash.c"
14288- line="2343">Retrieves every value inside @hash_table. The returned data
14463+ line="2346">Retrieves every value inside @hash_table. The returned data
1428914464 is valid until @hash_table is modified.
1429014465
1429114466 This iterates over every entry in the hash table to build its return value.
@@ -14295,7 +14470,7 @@ To iterate over the entries in a #GHashTable more efficiently, use a
1429514470 <return-value transfer-ownership="container">
1429614471 <doc xml:space="preserve"
1429714472 filename="glib/ghash.c"
14298- line="2354">a #GList containing all the values
14473+ line="2357">a #GList containing all the values
1429914474 inside the hash table. The content of the list is owned by the
1430014475 hash table and should not be modified or freed. Use g_list_free()
1430114476 when done using the list.</doc>
@@ -14307,7 +14482,7 @@ To iterate over the entries in a #GHashTable more efficiently, use a
1430714482 <parameter name="hash_table" transfer-ownership="none">
1430814483 <doc xml:space="preserve"
1430914484 filename="glib/ghash.c"
14310- line="2345">a #GHashTable</doc>
14485+ line="2348">a #GHashTable</doc>
1431114486 <type name="GLib.HashTable" c:type="GHashTable*">
1431214487 <type name="gpointer" c:type="gpointer"/>
1431314488 <type name="gpointer" c:type="gpointer"/>
@@ -14321,7 +14496,7 @@ To iterate over the entries in a #GHashTable more efficiently, use a
1432114496 introspectable="0">
1432214497 <doc xml:space="preserve"
1432314498 filename="glib/ghash.c"
14324- line="2379">Retrieves every value inside @hash_table, as a #GPtrArray.
14499+ line="2382">Retrieves every value inside @hash_table, as a #GPtrArray.
1432514500 The returned data is valid until changes to the hash release those values.
1432614501
1432714502 This iterates over every entry in the hash table to build its return value.
@@ -14333,8 +14508,8 @@ You should always unref the returned array with g_ptr_array_unref().</doc>
1433314508 <return-value transfer-ownership="container">
1433414509 <doc xml:space="preserve"
1433514510 filename="glib/ghash.c"
14336- line="2392">a #GPtrArray containing each value from
14337-the table. Unref with with g_ptr_array_unref() when done.</doc>
14511+ line="2395">a #GPtrArray containing each value from
14512+the table. Unref with g_ptr_array_unref() when done.</doc>
1433814513 <array name="GLib.PtrArray" c:type="GPtrArray*">
1433914514 <type name="gpointer" c:type="gpointer"/>
1434014515 </array>
@@ -14343,7 +14518,7 @@ the table. Unref with with g_ptr_array_unref() when done.</doc>
1434314518 <parameter name="hash_table" transfer-ownership="none">
1434414519 <doc xml:space="preserve"
1434514520 filename="glib/ghash.c"
14346- line="2381">a #GHashTable</doc>
14521+ line="2384">a #GHashTable</doc>
1434714522 <type name="GLib.HashTable" c:type="GHashTable*">
1434814523 <type name="gpointer" c:type="gpointer"/>
1434914524 <type name="gpointer" c:type="gpointer"/>
@@ -14354,7 +14529,7 @@ the table. Unref with with g_ptr_array_unref() when done.</doc>
1435414529 <function name="insert" c:identifier="g_hash_table_insert">
1435514530 <doc xml:space="preserve"
1435614531 filename="glib/ghash.c"
14357- line="1580">Inserts a new key and value into a #GHashTable.
14532+ line="1583">Inserts a new key and value into a #GHashTable.
1435814533
1435914534 If the key already exists in the #GHashTable its current
1436014535 value is replaced with the new value. If you supplied a
@@ -14370,14 +14545,14 @@ or not.</doc>
1437014545 <return-value transfer-ownership="none">
1437114546 <doc xml:space="preserve"
1437214547 filename="glib/ghash.c"
14373- line="1599">%TRUE if the key did not exist yet</doc>
14548+ line="1602">%TRUE if the key did not exist yet</doc>
1437414549 <type name="gboolean" c:type="gboolean"/>
1437514550 </return-value>
1437614551 <parameters>
1437714552 <parameter name="hash_table" transfer-ownership="none">
1437814553 <doc xml:space="preserve"
1437914554 filename="glib/ghash.c"
14380- line="1582">a #GHashTable</doc>
14555+ line="1585">a #GHashTable</doc>
1438114556 <type name="GLib.HashTable" c:type="GHashTable*">
1438214557 <type name="gpointer" c:type="gpointer"/>
1438314558 <type name="gpointer" c:type="gpointer"/>
@@ -14389,7 +14564,7 @@ or not.</doc>
1438914564 allow-none="1">
1439014565 <doc xml:space="preserve"
1439114566 filename="glib/ghash.c"
14392- line="1583">a key to insert</doc>
14567+ line="1586">a key to insert</doc>
1439314568 <type name="gpointer" c:type="gpointer"/>
1439414569 </parameter>
1439514570 <parameter name="value"
@@ -14398,7 +14573,7 @@ or not.</doc>
1439814573 allow-none="1">
1439914574 <doc xml:space="preserve"
1440014575 filename="glib/ghash.c"
14401- line="1584">the value to associate with the key</doc>
14576+ line="1587">the value to associate with the key</doc>
1440214577 <type name="gpointer" c:type="gpointer"/>
1440314578 </parameter>
1440414579 </parameters>
@@ -14406,7 +14581,7 @@ or not.</doc>
1440614581 <function name="lookup" c:identifier="g_hash_table_lookup">
1440714582 <doc xml:space="preserve"
1440814583 filename="glib/ghash.c"
14409- line="1467">Looks up a key in a #GHashTable. Note that this function cannot
14584+ line="1470">Looks up a key in a #GHashTable. Note that this function cannot
1441014585 distinguish between a key that is not present and one which is present
1441114586 and has the value %NULL. If you need this distinction, use
1441214587 g_hash_table_lookup_extended().</doc>
@@ -14414,14 +14589,14 @@ g_hash_table_lookup_extended().</doc>
1441414589 <return-value transfer-ownership="none" nullable="1">
1441514590 <doc xml:space="preserve"
1441614591 filename="glib/ghash.c"
14417- line="1477">the associated value, or %NULL if the key is not found</doc>
14592+ line="1480">the associated value, or %NULL if the key is not found</doc>
1441814593 <type name="gpointer" c:type="gpointer"/>
1441914594 </return-value>
1442014595 <parameters>
1442114596 <parameter name="hash_table" transfer-ownership="none">
1442214597 <doc xml:space="preserve"
1442314598 filename="glib/ghash.c"
14424- line="1469">a #GHashTable</doc>
14599+ line="1472">a #GHashTable</doc>
1442514600 <type name="GLib.HashTable" c:type="GHashTable*">
1442614601 <type name="gpointer" c:type="gpointer"/>
1442714602 <type name="gpointer" c:type="gpointer"/>
@@ -14433,7 +14608,7 @@ g_hash_table_lookup_extended().</doc>
1443314608 allow-none="1">
1443414609 <doc xml:space="preserve"
1443514610 filename="glib/ghash.c"
14436- line="1470">the key to look up</doc>
14611+ line="1473">the key to look up</doc>
1443714612 <type name="gpointer" c:type="gconstpointer"/>
1443814613 </parameter>
1443914614 </parameters>
@@ -14442,7 +14617,7 @@ g_hash_table_lookup_extended().</doc>
1444214617 c:identifier="g_hash_table_lookup_extended">
1444314618 <doc xml:space="preserve"
1444414619 filename="glib/ghash.c"
14445- line="1495">Looks up a key in the #GHashTable, returning the original key and the
14620+ line="1498">Looks up a key in the #GHashTable, returning the original key and the
1444614621 associated value and a #gboolean which is %TRUE if the key was found. This
1444714622 is useful if you need to free the memory allocated for the original key,
1444814623 for example before calling g_hash_table_remove().
@@ -14454,14 +14629,14 @@ of @hash_table are %NULL-safe.</doc>
1445414629 <return-value transfer-ownership="none">
1445514630 <doc xml:space="preserve"
1445614631 filename="glib/ghash.c"
14457- line="1512">%TRUE if the key was found in the #GHashTable</doc>
14632+ line="1515">%TRUE if the key was found in the #GHashTable</doc>
1445814633 <type name="gboolean" c:type="gboolean"/>
1445914634 </return-value>
1446014635 <parameters>
1446114636 <parameter name="hash_table" transfer-ownership="none">
1446214637 <doc xml:space="preserve"
1446314638 filename="glib/ghash.c"
14464- line="1497">a #GHashTable</doc>
14639+ line="1500">a #GHashTable</doc>
1446514640 <type name="GLib.HashTable" c:type="GHashTable*">
1446614641 <type name="gpointer" c:type="gpointer"/>
1446714642 <type name="gpointer" c:type="gpointer"/>
@@ -14473,7 +14648,7 @@ of @hash_table are %NULL-safe.</doc>
1447314648 allow-none="1">
1447414649 <doc xml:space="preserve"
1447514650 filename="glib/ghash.c"
14476- line="1498">the key to look up</doc>
14651+ line="1501">the key to look up</doc>
1447714652 <type name="gpointer" c:type="gconstpointer"/>
1447814653 </parameter>
1447914654 <parameter name="orig_key"
@@ -14485,7 +14660,7 @@ of @hash_table are %NULL-safe.</doc>
1448514660 allow-none="1">
1448614661 <doc xml:space="preserve"
1448714662 filename="glib/ghash.c"
14488- line="1499">return location for the original key</doc>
14663+ line="1502">return location for the original key</doc>
1448914664 <type name="gpointer" c:type="gpointer*"/>
1449014665 </parameter>
1449114666 <parameter name="value"
@@ -14497,7 +14672,7 @@ of @hash_table are %NULL-safe.</doc>
1449714672 allow-none="1">
1449814673 <doc xml:space="preserve"
1449914674 filename="glib/ghash.c"
14500- line="1500">return location for the value associated
14675+ line="1503">return location for the value associated
1450114676 with the key</doc>
1450214677 <type name="gpointer" c:type="gpointer*"/>
1450314678 </parameter>
@@ -14506,7 +14681,7 @@ with the key</doc>
1450614681 <function name="new" c:identifier="g_hash_table_new" introspectable="0">
1450714682 <doc xml:space="preserve"
1450814683 filename="glib/ghash.c"
14509- line="956">Creates a new #GHashTable with a reference count of 1.
14684+ line="959">Creates a new #GHashTable with a reference count of 1.
1451014685
1451114686 Hash values returned by @hash_func are used to determine where keys
1451214687 are stored within the #GHashTable data structure. The g_direct_hash(),
@@ -14526,7 +14701,7 @@ its second.</doc>
1452614701 <return-value transfer-ownership="full">
1452714702 <doc xml:space="preserve"
1452814703 filename="glib/ghash.c"
14529- line="978">a new #GHashTable</doc>
14704+ line="981">a new #GHashTable</doc>
1453014705 <type name="GLib.HashTable" c:type="GHashTable*">
1453114706 <type name="gpointer" c:type="gpointer"/>
1453214707 <type name="gpointer" c:type="gpointer"/>
@@ -14536,13 +14711,13 @@ its second.</doc>
1453614711 <parameter name="hash_func" transfer-ownership="none">
1453714712 <doc xml:space="preserve"
1453814713 filename="glib/ghash.c"
14539- line="958">a function to create a hash value from a key</doc>
14714+ line="961">a function to create a hash value from a key</doc>
1454014715 <type name="HashFunc" c:type="GHashFunc"/>
1454114716 </parameter>
1454214717 <parameter name="key_equal_func" transfer-ownership="none">
1454314718 <doc xml:space="preserve"
1454414719 filename="glib/ghash.c"
14545- line="959">a function to check two keys for equality</doc>
14720+ line="962">a function to check two keys for equality</doc>
1454614721 <type name="EqualFunc" c:type="GEqualFunc"/>
1454714722 </parameter>
1454814723 </parameters>
@@ -14552,7 +14727,7 @@ its second.</doc>
1455214727 introspectable="0">
1455314728 <doc xml:space="preserve"
1455414729 filename="glib/ghash.c"
14555- line="988">Creates a new #GHashTable like g_hash_table_new() with a reference
14730+ line="991">Creates a new #GHashTable like g_hash_table_new() with a reference
1455614731 count of 1 and allows to specify functions to free the memory
1455714732 allocated for the key and value that get called when removing the
1455814733 entry from the #GHashTable.
@@ -14567,7 +14742,7 @@ g_hash_table_unref().</doc>
1456714742 <return-value transfer-ownership="full">
1456814743 <doc xml:space="preserve"
1456914744 filename="glib/ghash.c"
14570- line="1011">a new #GHashTable</doc>
14745+ line="1014">a new #GHashTable</doc>
1457114746 <type name="GLib.HashTable" c:type="GHashTable*">
1457214747 <type name="gpointer" c:type="gpointer"/>
1457314748 <type name="gpointer" c:type="gpointer"/>
@@ -14577,7 +14752,7 @@ g_hash_table_unref().</doc>
1457714752 <parameter name="hash_func" transfer-ownership="none">
1457814753 <doc xml:space="preserve"
1457914754 filename="glib/ghash.c"
14580- line="990">a function to create a hash value from a key</doc>
14755+ line="993">a function to create a hash value from a key</doc>
1458114756 <type name="HashFunc" c:type="GHashFunc"/>
1458214757 </parameter>
1458314758 <parameter name="key_equal_func"
@@ -14586,7 +14761,7 @@ g_hash_table_unref().</doc>
1458614761 destroy="3">
1458714762 <doc xml:space="preserve"
1458814763 filename="glib/ghash.c"
14589- line="991">a function to check two keys for equality</doc>
14764+ line="994">a function to check two keys for equality</doc>
1459014765 <type name="EqualFunc" c:type="GEqualFunc"/>
1459114766 </parameter>
1459214767 <parameter name="key_destroy_func"
@@ -14596,7 +14771,7 @@ g_hash_table_unref().</doc>
1459614771 scope="async">
1459714772 <doc xml:space="preserve"
1459814773 filename="glib/ghash.c"
14599- line="992">a function to free the memory allocated for the key
14774+ line="995">a function to free the memory allocated for the key
1460014775 used when removing the entry from the #GHashTable, or %NULL
1460114776 if you don't want to supply such a function.</doc>
1460214777 <type name="DestroyNotify" c:type="GDestroyNotify"/>
@@ -14608,7 +14783,7 @@ g_hash_table_unref().</doc>
1460814783 scope="async">
1460914784 <doc xml:space="preserve"
1461014785 filename="glib/ghash.c"
14611- line="995">a function to free the memory allocated for the
14786+ line="998">a function to free the memory allocated for the
1461214787 value used when removing the entry from the #GHashTable, or %NULL
1461314788 if you don't want to supply such a function.</doc>
1461414789 <type name="DestroyNotify" c:type="GDestroyNotify"/>
@@ -14620,7 +14795,7 @@ g_hash_table_unref().</doc>
1462014795 version="2.72">
1462114796 <doc xml:space="preserve"
1462214797 filename="glib/ghash.c"
14623- line="1038">Creates a new #GHashTable like g_hash_table_new_full() with a reference
14798+ line="1041">Creates a new #GHashTable like g_hash_table_new_full() with a reference
1462414799 count of 1.
1462514800
1462614801 It inherits the hash function, the key equal function, the key destroy function,
@@ -14632,7 +14807,7 @@ or values from @other_hash_table.</doc>
1463214807 <return-value transfer-ownership="full">
1463314808 <doc xml:space="preserve"
1463414809 filename="glib/ghash.c"
14635- line="1051">a new #GHashTable</doc>
14810+ line="1054">a new #GHashTable</doc>
1463614811 <type name="GLib.HashTable" c:type="GHashTable*">
1463714812 <type name="gpointer" c:type="gpointer"/>
1463814813 <type name="gpointer" c:type="gpointer"/>
@@ -14642,7 +14817,7 @@ or values from @other_hash_table.</doc>
1464214817 <parameter name="other_hash_table" transfer-ownership="none">
1464314818 <doc xml:space="preserve"
1464414819 filename="glib/ghash.c"
14645- line="1040">Another #GHashTable</doc>
14820+ line="1043">Another #GHashTable</doc>
1464614821 <type name="GLib.HashTable" c:type="GHashTable*">
1464714822 <type name="gpointer" c:type="gpointer"/>
1464814823 <type name="gpointer" c:type="gpointer"/>
@@ -14653,13 +14828,13 @@ or values from @other_hash_table.</doc>
1465314828 <function name="ref" c:identifier="g_hash_table_ref" version="2.10">
1465414829 <doc xml:space="preserve"
1465514830 filename="glib/ghash.c"
14656- line="1399">Atomically increments the reference count of @hash_table by one.
14831+ line="1402">Atomically increments the reference count of @hash_table by one.
1465714832 This function is MT-safe and may be called from any thread.</doc>
1465814833 <source-position filename="glib/ghash.h" line="161"/>
1465914834 <return-value transfer-ownership="full">
1466014835 <doc xml:space="preserve"
1466114836 filename="glib/ghash.c"
14662- line="1406">the passed in #GHashTable</doc>
14837+ line="1409">the passed in #GHashTable</doc>
1466314838 <type name="GLib.HashTable" c:type="GHashTable*">
1466414839 <type name="gpointer" c:type="gpointer"/>
1466514840 <type name="gpointer" c:type="gpointer"/>
@@ -14669,7 +14844,7 @@ This function is MT-safe and may be called from any thread.</doc>
1466914844 <parameter name="hash_table" transfer-ownership="none">
1467014845 <doc xml:space="preserve"
1467114846 filename="glib/ghash.c"
14672- line="1401">a valid #GHashTable</doc>
14847+ line="1404">a valid #GHashTable</doc>
1467314848 <type name="GLib.HashTable" c:type="GHashTable*">
1467414849 <type name="gpointer" c:type="gpointer"/>
1467514850 <type name="gpointer" c:type="gpointer"/>
@@ -14680,7 +14855,7 @@ This function is MT-safe and may be called from any thread.</doc>
1468014855 <function name="remove" c:identifier="g_hash_table_remove">
1468114856 <doc xml:space="preserve"
1468214857 filename="glib/ghash.c"
14683- line="1732">Removes a key and its associated value from a #GHashTable.
14858+ line="1735">Removes a key and its associated value from a #GHashTable.
1468414859
1468514860 If the #GHashTable was created using g_hash_table_new_full(), the
1468614861 key and value are freed using the supplied destroy functions, otherwise
@@ -14690,14 +14865,14 @@ yourself.</doc>
1469014865 <return-value transfer-ownership="none">
1469114866 <doc xml:space="preserve"
1469214867 filename="glib/ghash.c"
14693- line="1744">%TRUE if the key was found and removed from the #GHashTable</doc>
14868+ line="1747">%TRUE if the key was found and removed from the #GHashTable</doc>
1469414869 <type name="gboolean" c:type="gboolean"/>
1469514870 </return-value>
1469614871 <parameters>
1469714872 <parameter name="hash_table" transfer-ownership="none">
1469814873 <doc xml:space="preserve"
1469914874 filename="glib/ghash.c"
14700- line="1734">a #GHashTable</doc>
14875+ line="1737">a #GHashTable</doc>
1470114876 <type name="GLib.HashTable" c:type="GHashTable*">
1470214877 <type name="gpointer" c:type="gpointer"/>
1470314878 <type name="gpointer" c:type="gpointer"/>
@@ -14709,7 +14884,7 @@ yourself.</doc>
1470914884 allow-none="1">
1471014885 <doc xml:space="preserve"
1471114886 filename="glib/ghash.c"
14712- line="1735">the key to remove</doc>
14887+ line="1738">the key to remove</doc>
1471314888 <type name="gpointer" c:type="gconstpointer"/>
1471414889 </parameter>
1471514890 </parameters>
@@ -14719,7 +14894,7 @@ yourself.</doc>
1471914894 version="2.12">
1472014895 <doc xml:space="preserve"
1472114896 filename="glib/ghash.c"
14722- line="1849">Removes all keys and their associated values from a #GHashTable.
14897+ line="1852">Removes all keys and their associated values from a #GHashTable.
1472314898
1472414899 If the #GHashTable was created using g_hash_table_new_full(),
1472514900 the keys and values are freed using the supplied destroy functions,
@@ -14733,7 +14908,7 @@ values are freed yourself.</doc>
1473314908 <parameter name="hash_table" transfer-ownership="none">
1473414909 <doc xml:space="preserve"
1473514910 filename="glib/ghash.c"
14736- line="1851">a #GHashTable</doc>
14911+ line="1854">a #GHashTable</doc>
1473714912 <type name="GLib.HashTable" c:type="GHashTable*">
1473814913 <type name="gpointer" c:type="gpointer"/>
1473914914 <type name="gpointer" c:type="gpointer"/>
@@ -14744,7 +14919,7 @@ values are freed yourself.</doc>
1474414919 <function name="replace" c:identifier="g_hash_table_replace">
1474514920 <doc xml:space="preserve"
1474614921 filename="glib/ghash.c"
14747- line="1609">Inserts a new key and value into a #GHashTable similar to
14922+ line="1612">Inserts a new key and value into a #GHashTable similar to
1474814923 g_hash_table_insert(). The difference is that if the key
1474914924 already exists in the #GHashTable, it gets replaced by the
1475014925 new key. If you supplied a @value_destroy_func when creating
@@ -14759,14 +14934,14 @@ or not.</doc>
1475914934 <return-value transfer-ownership="none">
1476014935 <doc xml:space="preserve"
1476114936 filename="glib/ghash.c"
14762- line="1627">%TRUE if the key did not exist yet</doc>
14937+ line="1630">%TRUE if the key did not exist yet</doc>
1476314938 <type name="gboolean" c:type="gboolean"/>
1476414939 </return-value>
1476514940 <parameters>
1476614941 <parameter name="hash_table" transfer-ownership="none">
1476714942 <doc xml:space="preserve"
1476814943 filename="glib/ghash.c"
14769- line="1611">a #GHashTable</doc>
14944+ line="1614">a #GHashTable</doc>
1477014945 <type name="GLib.HashTable" c:type="GHashTable*">
1477114946 <type name="gpointer" c:type="gpointer"/>
1477214947 <type name="gpointer" c:type="gpointer"/>
@@ -14778,7 +14953,7 @@ or not.</doc>
1477814953 allow-none="1">
1477914954 <doc xml:space="preserve"
1478014955 filename="glib/ghash.c"
14781- line="1612">a key to insert</doc>
14956+ line="1615">a key to insert</doc>
1478214957 <type name="gpointer" c:type="gpointer"/>
1478314958 </parameter>
1478414959 <parameter name="value"
@@ -14787,7 +14962,7 @@ or not.</doc>
1478714962 allow-none="1">
1478814963 <doc xml:space="preserve"
1478914964 filename="glib/ghash.c"
14790- line="1613">the value to associate with the key</doc>
14965+ line="1616">the value to associate with the key</doc>
1479114966 <type name="gpointer" c:type="gpointer"/>
1479214967 </parameter>
1479314968 </parameters>
@@ -14795,19 +14970,19 @@ or not.</doc>
1479514970 <function name="size" c:identifier="g_hash_table_size">
1479614971 <doc xml:space="preserve"
1479714972 filename="glib/ghash.c"
14798- line="2202">Returns the number of elements contained in the #GHashTable.</doc>
14973+ line="2205">Returns the number of elements contained in the #GHashTable.</doc>
1479914974 <source-position filename="glib/ghash.h" line="129"/>
1480014975 <return-value transfer-ownership="none">
1480114976 <doc xml:space="preserve"
1480214977 filename="glib/ghash.c"
14803- line="2208">the number of key/value pairs in the #GHashTable.</doc>
14978+ line="2211">the number of key/value pairs in the #GHashTable.</doc>
1480414979 <type name="guint" c:type="guint"/>
1480514980 </return-value>
1480614981 <parameters>
1480714982 <parameter name="hash_table" transfer-ownership="none">
1480814983 <doc xml:space="preserve"
1480914984 filename="glib/ghash.c"
14810- line="2204">a #GHashTable</doc>
14985+ line="2207">a #GHashTable</doc>
1481114986 <type name="GLib.HashTable" c:type="GHashTable*">
1481214987 <type name="gpointer" c:type="gpointer"/>
1481314988 <type name="gpointer" c:type="gpointer"/>
@@ -14818,20 +14993,20 @@ or not.</doc>
1481814993 <function name="steal" c:identifier="g_hash_table_steal">
1481914994 <doc xml:space="preserve"
1482014995 filename="glib/ghash.c"
14821- line="1753">Removes a key and its associated value from a #GHashTable without
14996+ line="1756">Removes a key and its associated value from a #GHashTable without
1482214997 calling the key and value destroy functions.</doc>
1482314998 <source-position filename="glib/ghash.h" line="88"/>
1482414999 <return-value transfer-ownership="none">
1482515000 <doc xml:space="preserve"
1482615001 filename="glib/ghash.c"
14827- line="1761">%TRUE if the key was found and removed from the #GHashTable</doc>
15002+ line="1764">%TRUE if the key was found and removed from the #GHashTable</doc>
1482815003 <type name="gboolean" c:type="gboolean"/>
1482915004 </return-value>
1483015005 <parameters>
1483115006 <parameter name="hash_table" transfer-ownership="none">
1483215007 <doc xml:space="preserve"
1483315008 filename="glib/ghash.c"
14834- line="1755">a #GHashTable</doc>
15009+ line="1758">a #GHashTable</doc>
1483515010 <type name="GLib.HashTable" c:type="GHashTable*">
1483615011 <type name="gpointer" c:type="gpointer"/>
1483715012 <type name="gpointer" c:type="gpointer"/>
@@ -14843,7 +15018,7 @@ calling the key and value destroy functions.</doc>
1484315018 allow-none="1">
1484415019 <doc xml:space="preserve"
1484515020 filename="glib/ghash.c"
14846- line="1756">the key to remove</doc>
15021+ line="1759">the key to remove</doc>
1484715022 <type name="gpointer" c:type="gconstpointer"/>
1484815023 </parameter>
1484915024 </parameters>
@@ -14853,7 +15028,7 @@ calling the key and value destroy functions.</doc>
1485315028 version="2.12">
1485415029 <doc xml:space="preserve"
1485515030 filename="glib/ghash.c"
14856- line="1876">Removes all keys and their associated values from a #GHashTable
15031+ line="1879">Removes all keys and their associated values from a #GHashTable
1485715032 without calling the key and value destroy functions.</doc>
1485815033 <source-position filename="glib/ghash.h" line="96"/>
1485915034 <return-value transfer-ownership="none">
@@ -14863,7 +15038,7 @@ without calling the key and value destroy functions.</doc>
1486315038 <parameter name="hash_table" transfer-ownership="none">
1486415039 <doc xml:space="preserve"
1486515040 filename="glib/ghash.c"
14866- line="1878">a #GHashTable</doc>
15041+ line="1881">a #GHashTable</doc>
1486715042 <type name="GLib.HashTable" c:type="GHashTable*">
1486815043 <type name="gpointer" c:type="gpointer"/>
1486915044 <type name="gpointer" c:type="gpointer"/>
@@ -14877,7 +15052,7 @@ without calling the key and value destroy functions.</doc>
1487715052 introspectable="0">
1487815053 <doc xml:space="preserve"
1487915054 filename="glib/ghash.c"
14880- line="1899">Removes all keys and their associated values from a #GHashTable
15055+ line="1902">Removes all keys and their associated values from a #GHashTable
1488115056 without calling the key destroy functions, returning the keys
1488215057 as a #GPtrArray with the free func set to the @hash_table key
1488315058 destroy function.</doc>
@@ -14885,8 +15060,8 @@ destroy function.</doc>
1488515060 <return-value transfer-ownership="container">
1488615061 <doc xml:space="preserve"
1488715062 filename="glib/ghash.c"
14888- line="1908">a #GPtrArray containing each key of
14889-the table. Unref with with g_ptr_array_unref() when done.</doc>
15063+ line="1911">a #GPtrArray containing each key of
15064+the table. Unref with g_ptr_array_unref() when done.</doc>
1489015065 <array name="GLib.PtrArray" c:type="GPtrArray*">
1489115066 <type name="gpointer" c:type="gpointer"/>
1489215067 </array>
@@ -14895,7 +15070,7 @@ the table. Unref with with g_ptr_array_unref() when done.</doc>
1489515070 <parameter name="hash_table" transfer-ownership="none">
1489615071 <doc xml:space="preserve"
1489715072 filename="glib/ghash.c"
14898- line="1901">a #GHashTable</doc>
15073+ line="1904">a #GHashTable</doc>
1489915074 <type name="GLib.HashTable" c:type="GHashTable*">
1490015075 <type name="gpointer" c:type="gpointer"/>
1490115076 <type name="gpointer" c:type="gpointer"/>
@@ -14909,7 +15084,7 @@ the table. Unref with with g_ptr_array_unref() when done.</doc>
1490915084 introspectable="0">
1491015085 <doc xml:space="preserve"
1491115086 filename="glib/ghash.c"
14912- line="1936">Removes all keys and their associated values from a #GHashTable
15087+ line="1939">Removes all keys and their associated values from a #GHashTable
1491315088 without calling the value destroy functions, returning the values
1491415089 as a #GPtrArray with the free func set to the @hash_table value
1491515090 destroy function.</doc>
@@ -14917,8 +15092,8 @@ destroy function.</doc>
1491715092 <return-value transfer-ownership="container">
1491815093 <doc xml:space="preserve"
1491915094 filename="glib/ghash.c"
14920- line="1945">a #GPtrArray containing each value of
14921-the table. Unref with with g_ptr_array_unref() when done.</doc>
15095+ line="1948">a #GPtrArray containing each value of
15096+the table. Unref with g_ptr_array_unref() when done.</doc>
1492215097 <array name="GLib.PtrArray" c:type="GPtrArray*">
1492315098 <type name="gpointer" c:type="gpointer"/>
1492415099 </array>
@@ -14927,7 +15102,7 @@ the table. Unref with with g_ptr_array_unref() when done.</doc>
1492715102 <parameter name="hash_table" transfer-ownership="none">
1492815103 <doc xml:space="preserve"
1492915104 filename="glib/ghash.c"
14930- line="1938">a #GHashTable</doc>
15105+ line="1941">a #GHashTable</doc>
1493115106 <type name="GLib.HashTable" c:type="GHashTable*">
1493215107 <type name="gpointer" c:type="gpointer"/>
1493315108 <type name="gpointer" c:type="gpointer"/>
@@ -14940,7 +15115,7 @@ the table. Unref with with g_ptr_array_unref() when done.</doc>
1494015115 version="2.58">
1494115116 <doc xml:space="preserve"
1494215117 filename="glib/ghash.c"
14943- line="1770">Looks up a key in the #GHashTable, stealing the original key and the
15118+ line="1773">Looks up a key in the #GHashTable, stealing the original key and the
1494415119 associated value and returning %TRUE if the key was found. If the key was
1494515120 not found, %FALSE is returned.
1494615121
@@ -14961,14 +15136,14 @@ stealing both the key and the value from such a dictionary, the value was
1496115136 <return-value transfer-ownership="none">
1496215137 <doc xml:space="preserve"
1496315138 filename="glib/ghash.c"
14964- line="1797">%TRUE if the key was found in the #GHashTable</doc>
15139+ line="1800">%TRUE if the key was found in the #GHashTable</doc>
1496515140 <type name="gboolean" c:type="gboolean"/>
1496615141 </return-value>
1496715142 <parameters>
1496815143 <parameter name="hash_table" transfer-ownership="none">
1496915144 <doc xml:space="preserve"
1497015145 filename="glib/ghash.c"
14971- line="1772">a #GHashTable</doc>
15146+ line="1775">a #GHashTable</doc>
1497215147 <type name="GLib.HashTable" c:type="GHashTable*">
1497315148 <type name="gpointer" c:type="gpointer"/>
1497415149 <type name="gpointer" c:type="gpointer"/>
@@ -14980,7 +15155,7 @@ stealing both the key and the value from such a dictionary, the value was
1498015155 allow-none="1">
1498115156 <doc xml:space="preserve"
1498215157 filename="glib/ghash.c"
14983- line="1773">the key to look up</doc>
15158+ line="1776">the key to look up</doc>
1498415159 <type name="gpointer" c:type="gconstpointer"/>
1498515160 </parameter>
1498615161 <parameter name="stolen_key"
@@ -14992,7 +15167,7 @@ stealing both the key and the value from such a dictionary, the value was
1499215167 allow-none="1">
1499315168 <doc xml:space="preserve"
1499415169 filename="glib/ghash.c"
14995- line="1774">return location for the
15170+ line="1777">return location for the
1499615171 original key</doc>
1499715172 <type name="gpointer" c:type="gpointer*"/>
1499815173 </parameter>
@@ -15005,7 +15180,7 @@ stealing both the key and the value from such a dictionary, the value was
1500515180 allow-none="1">
1500615181 <doc xml:space="preserve"
1500715182 filename="glib/ghash.c"
15008- line="1776">return location
15183+ line="1779">return location
1500915184 for the value associated with the key</doc>
1501015185 <type name="gpointer" c:type="gpointer*"/>
1501115186 </parameter>
@@ -15014,7 +15189,7 @@ stealing both the key and the value from such a dictionary, the value was
1501415189 <function name="unref" c:identifier="g_hash_table_unref" version="2.10">
1501515190 <doc xml:space="preserve"
1501615191 filename="glib/ghash.c"
15017- line="1420">Atomically decrements the reference count of @hash_table by one.
15192+ line="1423">Atomically decrements the reference count of @hash_table by one.
1501815193 If the reference count drops to 0, all keys and values will be
1501915194 destroyed, and all memory allocated by the hash table is released.
1502015195 This function is MT-safe and may be called from any thread.</doc>
@@ -15026,7 +15201,7 @@ This function is MT-safe and may be called from any thread.</doc>
1502615201 <parameter name="hash_table" transfer-ownership="full">
1502715202 <doc xml:space="preserve"
1502815203 filename="glib/ghash.c"
15029- line="1422">a valid #GHashTable</doc>
15204+ line="1425">a valid #GHashTable</doc>
1503015205 <type name="GLib.HashTable" c:type="GHashTable*">
1503115206 <type name="gpointer" c:type="gpointer"/>
1503215207 <type name="gpointer" c:type="gpointer"/>
@@ -15069,12 +15244,12 @@ table is not defined.</doc>
1506915244 version="2.16">
1507015245 <doc xml:space="preserve"
1507115246 filename="glib/ghash.c"
15072- line="1156">Returns the #GHashTable associated with @iter.</doc>
15247+ line="1159">Returns the #GHashTable associated with @iter.</doc>
1507315248 <source-position filename="glib/ghash.h" line="151"/>
1507415249 <return-value transfer-ownership="none">
1507515250 <doc xml:space="preserve"
1507615251 filename="glib/ghash.c"
15077- line="1162">the #GHashTable associated with @iter.</doc>
15252+ line="1165">the #GHashTable associated with @iter.</doc>
1507815253 <type name="GLib.HashTable" c:type="GHashTable*">
1507915254 <type name="gpointer" c:type="gpointer"/>
1508015255 <type name="gpointer" c:type="gpointer"/>
@@ -15084,7 +15259,7 @@ table is not defined.</doc>
1508415259 <instance-parameter name="iter" transfer-ownership="none">
1508515260 <doc xml:space="preserve"
1508615261 filename="glib/ghash.c"
15087- line="1158">an initialized #GHashTableIter</doc>
15262+ line="1161">an initialized #GHashTableIter</doc>
1508815263 <type name="HashTableIter" c:type="GHashTableIter*"/>
1508915264 </instance-parameter>
1509015265 </parameters>
@@ -15092,7 +15267,7 @@ table is not defined.</doc>
1509215267 <method name="init" c:identifier="g_hash_table_iter_init" version="2.16">
1509315268 <doc xml:space="preserve"
1509415269 filename="glib/ghash.c"
15095- line="1065">Initializes a key/value pair iterator and associates it with
15270+ line="1068">Initializes a key/value pair iterator and associates it with
1509615271 @hash_table. Modifying the hash table after calling this function
1509715272 invalidates the returned iterator.
1509815273
@@ -15117,13 +15292,13 @@ while (g_hash_table_iter_next (&amp;iter, &amp;key, &amp;value))
1511715292 <instance-parameter name="iter" transfer-ownership="none">
1511815293 <doc xml:space="preserve"
1511915294 filename="glib/ghash.c"
15120- line="1067">an uninitialized #GHashTableIter</doc>
15295+ line="1070">an uninitialized #GHashTableIter</doc>
1512115296 <type name="HashTableIter" c:type="GHashTableIter*"/>
1512215297 </instance-parameter>
1512315298 <parameter name="hash_table" transfer-ownership="none">
1512415299 <doc xml:space="preserve"
1512515300 filename="glib/ghash.c"
15126- line="1068">a #GHashTable</doc>
15301+ line="1071">a #GHashTable</doc>
1512715302 <type name="GLib.HashTable" c:type="GHashTable*">
1512815303 <type name="gpointer" c:type="gpointer"/>
1512915304 <type name="gpointer" c:type="gpointer"/>
@@ -15134,21 +15309,21 @@ while (g_hash_table_iter_next (&amp;iter, &amp;key, &amp;value))
1513415309 <method name="next" c:identifier="g_hash_table_iter_next" version="2.16">
1513515310 <doc xml:space="preserve"
1513615311 filename="glib/ghash.c"
15137- line="1106">Advances @iter and retrieves the key and/or value that are now
15312+ line="1109">Advances @iter and retrieves the key and/or value that are now
1513815313 pointed to as a result of this advancement. If %FALSE is returned,
1513915314 @key and @value are not set, and the iterator becomes invalid.</doc>
1514015315 <source-position filename="glib/ghash.h" line="147"/>
1514115316 <return-value transfer-ownership="none">
1514215317 <doc xml:space="preserve"
1514315318 filename="glib/ghash.c"
15144- line="1116">%FALSE if the end of the #GHashTable has been reached.</doc>
15319+ line="1119">%FALSE if the end of the #GHashTable has been reached.</doc>
1514515320 <type name="gboolean" c:type="gboolean"/>
1514615321 </return-value>
1514715322 <parameters>
1514815323 <instance-parameter name="iter" transfer-ownership="none">
1514915324 <doc xml:space="preserve"
1515015325 filename="glib/ghash.c"
15151- line="1108">an initialized #GHashTableIter</doc>
15326+ line="1111">an initialized #GHashTableIter</doc>
1515215327 <type name="HashTableIter" c:type="GHashTableIter*"/>
1515315328 </instance-parameter>
1515415329 <parameter name="key"
@@ -15160,7 +15335,7 @@ pointed to as a result of this advancement. If %FALSE is returned,
1516015335 allow-none="1">
1516115336 <doc xml:space="preserve"
1516215337 filename="glib/ghash.c"
15163- line="1109">a location to store the key</doc>
15338+ line="1112">a location to store the key</doc>
1516415339 <type name="gpointer" c:type="gpointer*"/>
1516515340 </parameter>
1516615341 <parameter name="value"
@@ -15172,7 +15347,7 @@ pointed to as a result of this advancement. If %FALSE is returned,
1517215347 allow-none="1">
1517315348 <doc xml:space="preserve"
1517415349 filename="glib/ghash.c"
15175- line="1110">a location to store the value</doc>
15350+ line="1113">a location to store the value</doc>
1517615351 <type name="gpointer" c:type="gpointer*"/>
1517715352 </parameter>
1517815353 </parameters>
@@ -15182,7 +15357,7 @@ pointed to as a result of this advancement. If %FALSE is returned,
1518215357 version="2.16">
1518315358 <doc xml:space="preserve"
1518415359 filename="glib/ghash.c"
15185- line="1192">Removes the key/value pair currently pointed to by the iterator
15360+ line="1195">Removes the key/value pair currently pointed to by the iterator
1518615361 from its associated #GHashTable. Can only be called after
1518715362 g_hash_table_iter_next() returned %TRUE, and cannot be called
1518815363 more than once for the same key/value pair.
@@ -15208,7 +15383,7 @@ while (g_hash_table_iter_next (&amp;iter, &amp;key, &amp;value))
1520815383 <instance-parameter name="iter" transfer-ownership="none">
1520915384 <doc xml:space="preserve"
1521015385 filename="glib/ghash.c"
15211- line="1194">an initialized #GHashTableIter</doc>
15386+ line="1197">an initialized #GHashTableIter</doc>
1521215387 <type name="HashTableIter" c:type="GHashTableIter*"/>
1521315388 </instance-parameter>
1521415389 </parameters>
@@ -15218,7 +15393,7 @@ while (g_hash_table_iter_next (&amp;iter, &amp;key, &amp;value))
1521815393 version="2.30">
1521915394 <doc xml:space="preserve"
1522015395 filename="glib/ghash.c"
15221- line="1337">Replaces the value currently pointed to by the iterator
15396+ line="1340">Replaces the value currently pointed to by the iterator
1522215397 from its associated #GHashTable. Can only be called after
1522315398 g_hash_table_iter_next() returned %TRUE.
1522415399
@@ -15232,7 +15407,7 @@ If you supplied a @value_destroy_func when creating the
1523215407 <instance-parameter name="iter" transfer-ownership="none">
1523315408 <doc xml:space="preserve"
1523415409 filename="glib/ghash.c"
15235- line="1339">an initialized #GHashTableIter</doc>
15410+ line="1342">an initialized #GHashTableIter</doc>
1523615411 <type name="HashTableIter" c:type="GHashTableIter*"/>
1523715412 </instance-parameter>
1523815413 <parameter name="value"
@@ -15241,7 +15416,7 @@ If you supplied a @value_destroy_func when creating the
1524115416 allow-none="1">
1524215417 <doc xml:space="preserve"
1524315418 filename="glib/ghash.c"
15244- line="1340">the value to replace with</doc>
15419+ line="1343">the value to replace with</doc>
1524515420 <type name="gpointer" c:type="gpointer"/>
1524615421 </parameter>
1524715422 </parameters>
@@ -15251,7 +15426,7 @@ If you supplied a @value_destroy_func when creating the
1525115426 version="2.16">
1525215427 <doc xml:space="preserve"
1525315428 filename="glib/ghash.c"
15254- line="1380">Removes the key/value pair currently pointed to by the
15429+ line="1383">Removes the key/value pair currently pointed to by the
1525515430 iterator from its associated #GHashTable, without calling
1525615431 the key and value destroy functions. Can only be called
1525715432 after g_hash_table_iter_next() returned %TRUE, and cannot
@@ -15264,7 +15439,7 @@ be called more than once for the same key/value pair.</doc>
1526415439 <instance-parameter name="iter" transfer-ownership="none">
1526515440 <doc xml:space="preserve"
1526615441 filename="glib/ghash.c"
15267- line="1382">an initialized #GHashTableIter</doc>
15442+ line="1385">an initialized #GHashTableIter</doc>
1526815443 <type name="HashTableIter" c:type="GHashTableIter*"/>
1526915444 </instance-parameter>
1527015445 </parameters>
@@ -16051,7 +16226,7 @@ g_hook_next_valid() until %NULL is returned.)</doc>
1605116226 filename="glib/ghook.c"
1605216227 line="399">Increments the reference count for a #GHook.</doc>
1605316228 <source-position filename="glib/ghook.h" line="117"/>
16054- <return-value>
16229+ <return-value transfer-ownership="full">
1605516230 <doc xml:space="preserve"
1605616231 filename="glib/ghook.c"
1605716232 line="406">the @hook that was passed in (since 2.6)</doc>
@@ -19004,7 +19179,7 @@ as booleans then [error@GLib.KeyFileError.INVALID_VALUE] is returned.</doc>
1900419179 throws="1">
1900519180 <doc xml:space="preserve"
1900619181 filename="glib/gkeyfile.c"
19007- line="3712">Retrieves a comment above @key from @group_name.
19182+ line="3717">Retrieves a comment above @key from @group_name.
1900819183
1900919184 If @key is `NULL` then @comment will be read from above
1901019185 @group_name. If both @key and @group_name are `NULL`, then
@@ -19017,14 +19192,14 @@ the line breaks between lines, but does not include the final line break.</doc>
1901719192 <return-value transfer-ownership="full">
1901819193 <doc xml:space="preserve"
1901919194 filename="glib/gkeyfile.c"
19020- line="3729">a comment that should be freed with [func@GLib.free]</doc>
19195+ line="3734">a comment that should be freed with [func@GLib.free]</doc>
1902119196 <type name="utf8" c:type="gchar*"/>
1902219197 </return-value>
1902319198 <parameters>
1902419199 <instance-parameter name="key_file" transfer-ownership="none">
1902519200 <doc xml:space="preserve"
1902619201 filename="glib/gkeyfile.c"
19027- line="3714">a key file</doc>
19202+ line="3719">a key file</doc>
1902819203 <type name="KeyFile" c:type="GKeyFile*"/>
1902919204 </instance-parameter>
1903019205 <parameter name="group_name"
@@ -19033,7 +19208,7 @@ the line breaks between lines, but does not include the final line break.</doc>
1903319208 allow-none="1">
1903419209 <doc xml:space="preserve"
1903519210 filename="glib/gkeyfile.c"
19036- line="3715">a group name, or `NULL` to get a top-level comment</doc>
19211+ line="3720">a group name, or `NULL` to get a top-level comment</doc>
1903719212 <type name="utf8" c:type="const gchar*"/>
1903819213 </parameter>
1903919214 <parameter name="key"
@@ -19042,7 +19217,7 @@ the line breaks between lines, but does not include the final line break.</doc>
1904219217 allow-none="1">
1904319218 <doc xml:space="preserve"
1904419219 filename="glib/gkeyfile.c"
19045- line="3716">a key, or `NULL` to get a group comment</doc>
19220+ line="3721">a key, or `NULL` to get a group comment</doc>
1904619221 <type name="utf8" c:type="const gchar*"/>
1904719222 </parameter>
1904819223 </parameters>
@@ -19762,25 +19937,25 @@ is returned. If the @group_name cannot be found,
1976219937 version="2.6">
1976319938 <doc xml:space="preserve"
1976419939 filename="glib/gkeyfile.c"
19765- line="3783">Looks whether the key file has the group @group_name.</doc>
19940+ line="3788">Looks whether the key file has the group @group_name.</doc>
1976619941 <source-position filename="glib/gkeyfile.h" line="118"/>
1976719942 <return-value transfer-ownership="none">
1976819943 <doc xml:space="preserve"
1976919944 filename="glib/gkeyfile.c"
19770- line="3790">true if @group_name is a part of @key_file, false otherwise.</doc>
19945+ line="3795">true if @group_name is a part of @key_file, false otherwise.</doc>
1977119946 <type name="gboolean" c:type="gboolean"/>
1977219947 </return-value>
1977319948 <parameters>
1977419949 <instance-parameter name="key_file" transfer-ownership="none">
1977519950 <doc xml:space="preserve"
1977619951 filename="glib/gkeyfile.c"
19777- line="3785">a key file</doc>
19952+ line="3790">a key file</doc>
1977819953 <type name="KeyFile" c:type="GKeyFile*"/>
1977919954 </instance-parameter>
1978019955 <parameter name="group_name" transfer-ownership="none">
1978119956 <doc xml:space="preserve"
1978219957 filename="glib/gkeyfile.c"
19783- line="3786">a group name</doc>
19958+ line="3791">a group name</doc>
1978419959 <type name="utf8" c:type="const gchar*"/>
1978519960 </parameter>
1978619961 </parameters>
@@ -19792,7 +19967,7 @@ is returned. If the @group_name cannot be found,
1979219967 throws="1">
1979319968 <doc xml:space="preserve"
1979419969 filename="glib/gkeyfile.c"
19795- line="3839">Looks whether the key file has the key @key in the group
19970+ line="3844">Looks whether the key file has the key @key in the group
1979619971 @group_name.
1979719972
1979819973 Note that this function does not follow the rules for [struct@GLib.Error]
@@ -19807,26 +19982,26 @@ a key exists.</doc>
1980719982 <return-value transfer-ownership="none">
1980819983 <doc xml:space="preserve"
1980919984 filename="glib/gkeyfile.c"
19810- line="3858">true if @key is a part of @group_name, false otherwise</doc>
19985+ line="3863">true if @key is a part of @group_name, false otherwise</doc>
1981119986 <type name="gboolean" c:type="gboolean"/>
1981219987 </return-value>
1981319988 <parameters>
1981419989 <instance-parameter name="key_file" transfer-ownership="none">
1981519990 <doc xml:space="preserve"
1981619991 filename="glib/gkeyfile.c"
19817- line="3841">a key file</doc>
19992+ line="3846">a key file</doc>
1981819993 <type name="KeyFile" c:type="GKeyFile*"/>
1981919994 </instance-parameter>
1982019995 <parameter name="group_name" transfer-ownership="none">
1982119996 <doc xml:space="preserve"
1982219997 filename="glib/gkeyfile.c"
19823- line="3842">a group name</doc>
19998+ line="3847">a group name</doc>
1982419999 <type name="utf8" c:type="const gchar*"/>
1982520000 </parameter>
1982620001 <parameter name="key" transfer-ownership="none">
1982720002 <doc xml:space="preserve"
1982820003 filename="glib/gkeyfile.c"
19829- line="3843">a key name</doc>
20004+ line="3848">a key name</doc>
1983020005 <type name="utf8" c:type="const gchar*"/>
1983120006 </parameter>
1983220007 </parameters>
@@ -20108,7 +20283,7 @@ error. If the @file is not found, [error@GLib.FileError.NOENT] is returned.</doc
2010820283 throws="1">
2010920284 <doc xml:space="preserve"
2011020285 filename="glib/gkeyfile.c"
20111- line="3749">Removes a comment above @key from @group_name.
20286+ line="3754">Removes a comment above @key from @group_name.
2011220287
2011320288 If @key is `NULL` then @comment will be removed above @group_name.
2011420289 If both @key and @group_name are `NULL`, then @comment will
@@ -20117,14 +20292,14 @@ be removed above the first group in the file.</doc>
2011720292 <return-value transfer-ownership="none">
2011820293 <doc xml:space="preserve"
2011920294 filename="glib/gkeyfile.c"
20120- line="3762">true if the comment was removed, false otherwise</doc>
20295+ line="3767">true if the comment was removed, false otherwise</doc>
2012120296 <type name="gboolean" c:type="gboolean"/>
2012220297 </return-value>
2012320298 <parameters>
2012420299 <instance-parameter name="key_file" transfer-ownership="none">
2012520300 <doc xml:space="preserve"
2012620301 filename="glib/gkeyfile.c"
20127- line="3751">a key file</doc>
20302+ line="3756">a key file</doc>
2012820303 <type name="KeyFile" c:type="GKeyFile*"/>
2012920304 </instance-parameter>
2013020305 <parameter name="group_name"
@@ -20133,7 +20308,7 @@ be removed above the first group in the file.</doc>
2013320308 allow-none="1">
2013420309 <doc xml:space="preserve"
2013520310 filename="glib/gkeyfile.c"
20136- line="3752">a group name, or `NULL` to get a top-level comment</doc>
20311+ line="3757">a group name, or `NULL` to get a top-level comment</doc>
2013720312 <type name="utf8" c:type="const gchar*"/>
2013820313 </parameter>
2013920314 <parameter name="key"
@@ -20142,7 +20317,7 @@ be removed above the first group in the file.</doc>
2014220317 allow-none="1">
2014320318 <doc xml:space="preserve"
2014420319 filename="glib/gkeyfile.c"
20145- line="3753">a key, or `NULL` to get a group comment</doc>
20320+ line="3758">a key, or `NULL` to get a group comment</doc>
2014620321 <type name="utf8" c:type="const gchar*"/>
2014720322 </parameter>
2014820323 </parameters>
@@ -20153,26 +20328,26 @@ be removed above the first group in the file.</doc>
2015320328 throws="1">
2015420329 <doc xml:space="preserve"
2015520330 filename="glib/gkeyfile.c"
20156- line="4047">Removes the specified group, @group_name,
20331+ line="4052">Removes the specified group, @group_name,
2015720332 from the key file.</doc>
2015820333 <source-position filename="glib/gkeyfile.h" line="297"/>
2015920334 <return-value transfer-ownership="none">
2016020335 <doc xml:space="preserve"
2016120336 filename="glib/gkeyfile.c"
20162- line="4056">true if the group was removed, false otherwise</doc>
20337+ line="4061">true if the group was removed, false otherwise</doc>
2016320338 <type name="gboolean" c:type="gboolean"/>
2016420339 </return-value>
2016520340 <parameters>
2016620341 <instance-parameter name="key_file" transfer-ownership="none">
2016720342 <doc xml:space="preserve"
2016820343 filename="glib/gkeyfile.c"
20169- line="4049">a key file</doc>
20344+ line="4054">a key file</doc>
2017020345 <type name="KeyFile" c:type="GKeyFile*"/>
2017120346 </instance-parameter>
2017220347 <parameter name="group_name" transfer-ownership="none">
2017320348 <doc xml:space="preserve"
2017420349 filename="glib/gkeyfile.c"
20175- line="4050">a group name</doc>
20350+ line="4055">a group name</doc>
2017620351 <type name="utf8" c:type="const gchar*"/>
2017720352 </parameter>
2017820353 </parameters>
@@ -20183,31 +20358,31 @@ from the key file.</doc>
2018320358 throws="1">
2018420359 <doc xml:space="preserve"
2018520360 filename="glib/gkeyfile.c"
20186- line="4117">Removes @key in @group_name from the key file.</doc>
20361+ line="4122">Removes @key in @group_name from the key file.</doc>
2018720362 <source-position filename="glib/gkeyfile.h" line="292"/>
2018820363 <return-value transfer-ownership="none">
2018920364 <doc xml:space="preserve"
2019020365 filename="glib/gkeyfile.c"
20191- line="4126">true if the key was removed, false otherwise</doc>
20366+ line="4131">true if the key was removed, false otherwise</doc>
2019220367 <type name="gboolean" c:type="gboolean"/>
2019320368 </return-value>
2019420369 <parameters>
2019520370 <instance-parameter name="key_file" transfer-ownership="none">
2019620371 <doc xml:space="preserve"
2019720372 filename="glib/gkeyfile.c"
20198- line="4119">a key file</doc>
20373+ line="4124">a key file</doc>
2019920374 <type name="KeyFile" c:type="GKeyFile*"/>
2020020375 </instance-parameter>
2020120376 <parameter name="group_name" transfer-ownership="none">
2020220377 <doc xml:space="preserve"
2020320378 filename="glib/gkeyfile.c"
20204- line="4120">a group name</doc>
20379+ line="4125">a group name</doc>
2020520380 <type name="utf8" c:type="const gchar*"/>
2020620381 </parameter>
2020720382 <parameter name="key" transfer-ownership="none">
2020820383 <doc xml:space="preserve"
2020920384 filename="glib/gkeyfile.c"
20210- line="4121">a key name to remove</doc>
20385+ line="4126">a key name to remove</doc>
2021120386 <type name="utf8" c:type="const gchar*"/>
2021220387 </parameter>
2021320388 </parameters>
@@ -20218,7 +20393,7 @@ from the key file.</doc>
2021820393 throws="1">
2021920394 <doc xml:space="preserve"
2022020395 filename="glib/gkeyfile.c"
20221- line="4737">Writes the contents of @key_file to @filename using
20396+ line="4742">Writes the contents of @key_file to @filename using
2022220397 [func@GLib.file_set_contents].
2022320398
2022420399 If you need stricter guarantees about durability of
@@ -20232,20 +20407,20 @@ This function can fail for any of the reasons that
2023220407 <return-value transfer-ownership="none">
2023320408 <doc xml:space="preserve"
2023420409 filename="glib/gkeyfile.c"
20235- line="4754">true if successful, false otherwise</doc>
20410+ line="4759">true if successful, false otherwise</doc>
2023620411 <type name="gboolean" c:type="gboolean"/>
2023720412 </return-value>
2023820413 <parameters>
2023920414 <instance-parameter name="key_file" transfer-ownership="none">
2024020415 <doc xml:space="preserve"
2024120416 filename="glib/gkeyfile.c"
20242- line="4739">a key file</doc>
20417+ line="4744">a key file</doc>
2024320418 <type name="KeyFile" c:type="GKeyFile*"/>
2024420419 </instance-parameter>
2024520420 <parameter name="filename" transfer-ownership="none">
2024620421 <doc xml:space="preserve"
2024720422 filename="glib/gkeyfile.c"
20248- line="4740">the name of the file to write to</doc>
20423+ line="4745">the name of the file to write to</doc>
2024920424 <type name="utf8" c:type="const gchar*"/>
2025020425 </parameter>
2025120426 </parameters>
@@ -20348,13 +20523,18 @@ If @key is `NULL` then @comment will be written above @group_name.
2034820523 If both @key and @group_name are `NULL`, then @comment will be
2034920524 written above the first group in the file.
2035020525
20526+Passing a non-existent @group_name or @key to this function returns
20527+false and populates @error. (In contrast, passing a non-existent
20528+`group_name` or `key` to [method@GLib.KeyFile.set_string]
20529+creates the associated group name and key.)
20530+
2035120531 Note that this function prepends a `#` comment marker to
2035220532 each line of @comment.</doc>
2035320533 <source-position filename="glib/gkeyfile.h" line="275"/>
2035420534 <return-value transfer-ownership="none">
2035520535 <doc xml:space="preserve"
2035620536 filename="glib/gkeyfile.c"
20357- line="3502">true if the comment was written, false otherwise</doc>
20537+ line="3507">true if the comment was written, false otherwise</doc>
2035820538 <type name="gboolean" c:type="gboolean"/>
2035920539 </return-value>
2036020540 <parameters>
@@ -21197,7 +21377,7 @@ module.</doc>
2119721377 <constant name="LOG_DOMAIN" value="0" c:type="G_LOG_DOMAIN">
2119821378 <doc xml:space="preserve"
2119921379 filename="glib/gmessages.c"
21200- line="91">Defines the log domain. See [Log Domains](#log-domains).
21380+ line="90">Defines the log domain. See [Log Domains](#log-domains).
2120121381
2120221382 Libraries should define this so that any messages
2120321383 which they log can be differentiated from messages from other
@@ -21220,13 +21400,13 @@ AM_CPPFLAGS = -DG_LOG_DOMAIN=\"Gtk\"
2122021400 Applications can choose to leave it as the default %NULL (or `""`)
2122121401 domain. However, defining the domain offers the same advantages as
2122221402 above.</doc>
21223- <source-position filename="glib/gmessages.h" line="320"/>
21403+ <source-position filename="glib/gmessages.h" line="323"/>
2122421404 <type name="gchar" c:type="gchar"/>
2122521405 </constant>
2122621406 <constant name="LOG_FATAL_MASK" value="5" c:type="G_LOG_FATAL_MASK">
2122721407 <doc xml:space="preserve"
2122821408 filename="glib/gmessages.c"
21229- line="121">GLib log levels that are considered fatal by default.
21409+ line="120">GLib log levels that are considered fatal by default.
2123021410
2123121411 This is not used if structured logging is enabled; see
2123221412 [Using Structured Logging](logging.html#using-structured-logging).</doc>
@@ -21238,7 +21418,7 @@ This is not used if structured logging is enabled; see
2123821418 c:type="G_LOG_LEVEL_USER_SHIFT">
2123921419 <doc xml:space="preserve"
2124021420 filename="glib/gmessages.c"
21241- line="174">Log levels below `1&lt;&lt;G_LOG_LEVEL_USER_SHIFT` are used by GLib.
21421+ line="173">Log levels below `1&lt;&lt;G_LOG_LEVEL_USER_SHIFT` are used by GLib.
2124221422 Higher bits can be used for user-defined log levels.</doc>
2124321423 <source-position filename="glib/gmessages.h" line="51"/>
2124421424 <type name="gint" c:type="gint"/>
@@ -22190,7 +22370,10 @@ described in the #GList introduction.</doc>
2219022370 </parameter>
2219122371 </parameters>
2219222372 </function>
22193- <function name="pop_allocator" c:identifier="g_list_pop_allocator">
22373+ <function name="pop_allocator"
22374+ c:identifier="g_list_pop_allocator"
22375+ deprecated="1"
22376+ deprecated-version="2.10">
2219422377 <source-position filename="glib/deprecated/gallocator.h" line="76"/>
2219522378 <return-value transfer-ownership="none">
2219622379 <type name="none" c:type="void"/>
@@ -22280,7 +22463,10 @@ element than the start of the list. Use g_list_insert_before() instead.</doc>
2228022463 </parameter>
2228122464 </parameters>
2228222465 </function>
22283- <function name="push_allocator" c:identifier="g_list_push_allocator">
22466+ <function name="push_allocator"
22467+ c:identifier="g_list_push_allocator"
22468+ deprecated="1"
22469+ deprecated-version="2.10">
2228422470 <source-position filename="glib/deprecated/gallocator.h" line="74"/>
2228522471 <return-value transfer-ownership="none">
2228622472 <type name="none" c:type="void"/>
@@ -22522,37 +22708,37 @@ a user data argument.</doc>
2252222708 <record name="LogField" c:type="GLogField" version="2.50">
2252322709 <doc xml:space="preserve"
2252422710 filename="glib/gmessages.h"
22525- line="142">Structure representing a single field in a structured log entry. See
22711+ line="145">Structure representing a single field in a structured log entry. See
2252622712 g_log_structured() for details.
2252722713
2252822714 Log fields may contain arbitrary values, including binary with embedded nul
2252922715 bytes. If the field contains a string, the string must be UTF-8 encoded and
2253022716 have a trailing nul byte. Otherwise, @length must be set to a non-negative
2253122717 value.</doc>
22532- <source-position filename="glib/gmessages.h" line="164"/>
22718+ <source-position filename="glib/gmessages.h" line="167"/>
2253322719 <field name="key" writable="1">
2253422720 <doc xml:space="preserve"
2253522721 filename="glib/gmessages.h"
22536- line="144">field name (UTF-8 string)</doc>
22722+ line="147">field name (UTF-8 string)</doc>
2253722723 <type name="utf8" c:type="const gchar*"/>
2253822724 </field>
2253922725 <field name="value" writable="1">
2254022726 <doc xml:space="preserve"
2254122727 filename="glib/gmessages.h"
22542- line="145">field value (arbitrary bytes)</doc>
22728+ line="148">field value (arbitrary bytes)</doc>
2254322729 <type name="gpointer" c:type="gconstpointer"/>
2254422730 </field>
2254522731 <field name="length" writable="1">
2254622732 <doc xml:space="preserve"
2254722733 filename="glib/gmessages.h"
22548- line="146">length of @value, in bytes, or -1 if it is nul-terminated</doc>
22734+ line="149">length of @value, in bytes, or -1 if it is nul-terminated</doc>
2254922735 <type name="gssize" c:type="gssize"/>
2255022736 </field>
2255122737 </record>
2255222738 <callback name="LogFunc" c:type="GLogFunc">
2255322739 <doc xml:space="preserve"
2255422740 filename="glib/gmessages.c"
22555- line="130">Specifies the prototype of log handler functions.
22741+ line="129">Specifies the prototype of log handler functions.
2255622742
2255722743 The default log handler, [func@GLib.log_default_handler], automatically appends a
2255822744 new-line character to @message when printing it. It is advised that any
@@ -22576,20 +22762,20 @@ This is not used if structured logging is enabled; see
2257622762 allow-none="1">
2257722763 <doc xml:space="preserve"
2257822764 filename="glib/gmessages.c"
22579- line="132">the log domain of the message</doc>
22765+ line="131">the log domain of the message</doc>
2258022766 <type name="utf8" c:type="const gchar*"/>
2258122767 </parameter>
2258222768 <parameter name="log_level" transfer-ownership="none">
2258322769 <doc xml:space="preserve"
2258422770 filename="glib/gmessages.c"
22585- line="133">the log level of the message (including the
22771+ line="132">the log level of the message (including the
2258622772 fatal and recursion flags)</doc>
2258722773 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
2258822774 </parameter>
2258922775 <parameter name="message" transfer-ownership="none">
2259022776 <doc xml:space="preserve"
2259122777 filename="glib/gmessages.c"
22592- line="135">the message to process</doc>
22778+ line="134">the message to process</doc>
2259322779 <type name="utf8" c:type="const gchar*"/>
2259422780 </parameter>
2259522781 <parameter name="user_data"
@@ -22599,7 +22785,7 @@ This is not used if structured logging is enabled; see
2259922785 closure="3">
2260022786 <doc xml:space="preserve"
2260122787 filename="glib/gmessages.c"
22602- line="136">user data, set in [func@GLib.log_set_handler]</doc>
22788+ line="135">user data, set in [func@GLib.log_set_handler]</doc>
2260322789 <type name="gpointer" c:type="gpointer"/>
2260422790 </parameter>
2260522791 </parameters>
@@ -22607,7 +22793,7 @@ This is not used if structured logging is enabled; see
2260722793 <bitfield name="LogLevelFlags" c:type="GLogLevelFlags">
2260822794 <doc xml:space="preserve"
2260922795 filename="glib/gmessages.c"
22610- line="153">Flags specifying the level of log messages.
22796+ line="152">Flags specifying the level of log messages.
2261122797
2261222798 It is possible to change how GLib treats messages of the various
2261322799 levels using [func@GLib.log_set_handler] and [func@GLib.log_set_fatal_mask].</doc>
@@ -22617,17 +22803,17 @@ levels using [func@GLib.log_set_handler] and [func@GLib.log_set_fatal_mask].</do
2261722803 c:identifier="G_LOG_FLAG_RECURSION">
2261822804 <doc xml:space="preserve"
2261922805 filename="glib/gmessages.c"
22620- line="155">internal flag</doc>
22806+ line="154">internal flag</doc>
2262122807 </member>
2262222808 <member name="flag_fatal" value="2" c:identifier="G_LOG_FLAG_FATAL">
2262322809 <doc xml:space="preserve"
2262422810 filename="glib/gmessages.c"
22625- line="156">internal flag</doc>
22811+ line="155">internal flag</doc>
2262622812 </member>
2262722813 <member name="level_error" value="4" c:identifier="G_LOG_LEVEL_ERROR">
2262822814 <doc xml:space="preserve"
2262922815 filename="glib/gmessages.c"
22630- line="157">log level for errors, see [func@GLib.error].
22816+ line="156">log level for errors, see [func@GLib.error].
2263122817 This level is also used for messages produced by [func@GLib.assert].</doc>
2263222818 </member>
2263322819 <member name="level_critical"
@@ -22635,7 +22821,7 @@ levels using [func@GLib.log_set_handler] and [func@GLib.log_set_fatal_mask].</do
2263522821 c:identifier="G_LOG_LEVEL_CRITICAL">
2263622822 <doc xml:space="preserve"
2263722823 filename="glib/gmessages.c"
22638- line="159">log level for critical warning messages, see
22824+ line="158">log level for critical warning messages, see
2263922825 [func@GLib.critical]. This level is also used for messages produced by
2264022826 [func@GLib.return_if_fail] and [func@GLib.return_val_if_fail].</doc>
2264122827 </member>
@@ -22644,35 +22830,35 @@ levels using [func@GLib.log_set_handler] and [func@GLib.log_set_fatal_mask].</do
2264422830 c:identifier="G_LOG_LEVEL_WARNING">
2264522831 <doc xml:space="preserve"
2264622832 filename="glib/gmessages.c"
22647- line="162">log level for warnings, see [func@GLib.warning]</doc>
22833+ line="161">log level for warnings, see [func@GLib.warning]</doc>
2264822834 </member>
2264922835 <member name="level_message"
2265022836 value="32"
2265122837 c:identifier="G_LOG_LEVEL_MESSAGE">
2265222838 <doc xml:space="preserve"
2265322839 filename="glib/gmessages.c"
22654- line="163">log level for messages, see [func@GLib.message]</doc>
22840+ line="162">log level for messages, see [func@GLib.message]</doc>
2265522841 </member>
2265622842 <member name="level_info" value="64" c:identifier="G_LOG_LEVEL_INFO">
2265722843 <doc xml:space="preserve"
2265822844 filename="glib/gmessages.c"
22659- line="164">log level for informational messages, see [func@GLib.info]</doc>
22845+ line="163">log level for informational messages, see [func@GLib.info]</doc>
2266022846 </member>
2266122847 <member name="level_debug" value="128" c:identifier="G_LOG_LEVEL_DEBUG">
2266222848 <doc xml:space="preserve"
2266322849 filename="glib/gmessages.c"
22664- line="165">log level for debug messages, see [func@GLib.debug]</doc>
22850+ line="164">log level for debug messages, see [func@GLib.debug]</doc>
2266522851 </member>
2266622852 <member name="level_mask" value="-4" c:identifier="G_LOG_LEVEL_MASK">
2266722853 <doc xml:space="preserve"
2266822854 filename="glib/gmessages.c"
22669- line="166">a mask including all log levels</doc>
22855+ line="165">a mask including all log levels</doc>
2267022856 </member>
2267122857 </bitfield>
2267222858 <callback name="LogWriterFunc" c:type="GLogWriterFunc" version="2.50">
2267322859 <doc xml:space="preserve"
2267422860 filename="glib/gmessages.h"
22675- line="166">Writer function for log entries. A log entry is a collection of one or more
22861+ line="169">Writer function for log entries. A log entry is a collection of one or more
2267622862 #GLogFields, using the standard [field names from journal
2267722863 specification](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html).
2267822864 See g_log_structured() for more information.
@@ -22690,11 +22876,11 @@ error handling the message (for example, if the writer function is meant to
2269022876 send messages to a remote logging server and there is a network error), it
2269122877 should return %G_LOG_WRITER_UNHANDLED. This allows writer functions to be
2269222878 chained and fall back to simpler handlers in case of failure.</doc>
22693- <source-position filename="glib/gmessages.h" line="197"/>
22879+ <source-position filename="glib/gmessages.h" line="200"/>
2269422880 <return-value transfer-ownership="none">
2269522881 <doc xml:space="preserve"
2269622882 filename="glib/gmessages.h"
22697- line="192">%G_LOG_WRITER_HANDLED if the log entry was handled successfully;
22883+ line="195">%G_LOG_WRITER_HANDLED if the log entry was handled successfully;
2269822884 %G_LOG_WRITER_UNHANDLED otherwise</doc>
2269922885 <type name="LogWriterOutput" c:type="GLogWriterOutput"/>
2270022886 </return-value>
@@ -22702,13 +22888,13 @@ chained and fall back to simpler handlers in case of failure.</doc>
2270222888 <parameter name="log_level" transfer-ownership="none">
2270322889 <doc xml:space="preserve"
2270422890 filename="glib/gmessages.h"
22705- line="168">log level of the message</doc>
22891+ line="171">log level of the message</doc>
2270622892 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
2270722893 </parameter>
2270822894 <parameter name="fields" transfer-ownership="none">
2270922895 <doc xml:space="preserve"
2271022896 filename="glib/gmessages.h"
22711- line="169">fields forming the message</doc>
22897+ line="172">fields forming the message</doc>
2271222898 <array length="2" zero-terminated="0" c:type="const GLogField*">
2271322899 <type name="LogField" c:type="GLogField"/>
2271422900 </array>
@@ -22716,7 +22902,7 @@ chained and fall back to simpler handlers in case of failure.</doc>
2271622902 <parameter name="n_fields" transfer-ownership="none">
2271722903 <doc xml:space="preserve"
2271822904 filename="glib/gmessages.h"
22719- line="170">number of @fields</doc>
22905+ line="173">number of @fields</doc>
2272022906 <type name="gsize" c:type="gsize"/>
2272122907 </parameter>
2272222908 <parameter name="user_data"
@@ -22726,7 +22912,7 @@ chained and fall back to simpler handlers in case of failure.</doc>
2272622912 closure="3">
2272722913 <doc xml:space="preserve"
2272822914 filename="glib/gmessages.h"
22729- line="171">user data passed to g_log_set_writer_func()</doc>
22915+ line="174">user data passed to g_log_set_writer_func()</doc>
2273022916 <type name="gpointer" c:type="gpointer"/>
2273122917 </parameter>
2273222918 </parameters>
@@ -22736,22 +22922,22 @@ chained and fall back to simpler handlers in case of failure.</doc>
2273622922 c:type="GLogWriterOutput">
2273722923 <doc xml:space="preserve"
2273822924 filename="glib/gmessages.h"
22739- line="122">Return values from #GLogWriterFuncs to indicate whether the given log entry
22925+ line="125">Return values from #GLogWriterFuncs to indicate whether the given log entry
2274022926 was successfully handled by the writer, or whether there was an error in
2274122927 handling it (and hence a fallback writer should be used).
2274222928
2274322929 If a #GLogWriterFunc ignores a log entry, it should return
2274422930 %G_LOG_WRITER_HANDLED.</doc>
22745- <source-position filename="glib/gmessages.h" line="140"/>
22931+ <source-position filename="glib/gmessages.h" line="143"/>
2274622932 <member name="handled" value="1" c:identifier="G_LOG_WRITER_HANDLED">
2274722933 <doc xml:space="preserve"
2274822934 filename="glib/gmessages.h"
22749- line="124">Log writer has handled the log entry.</doc>
22935+ line="127">Log writer has handled the log entry.</doc>
2275022936 </member>
2275122937 <member name="unhandled" value="0" c:identifier="G_LOG_WRITER_UNHANDLED">
2275222938 <doc xml:space="preserve"
2275322939 filename="glib/gmessages.h"
22754- line="125">Log writer could not handle the log entry.</doc>
22940+ line="128">Log writer could not handle the log entry.</doc>
2275522941 </member>
2275622942 </enumeration>
2275722943 <constant name="MAJOR_VERSION" value="2" c:type="GLIB_MAJOR_VERSION">
@@ -22799,7 +22985,7 @@ linked against at application run time.</doc>
2279922985 <source-position filename="glib/gtypes.h" line="76"/>
2280022986 <type name="guint8" c:type="guint8"/>
2280122987 </constant>
22802- <constant name="MICRO_VERSION" value="4" c:type="GLIB_MICRO_VERSION">
22988+ <constant name="MICRO_VERSION" value="0" c:type="GLIB_MICRO_VERSION">
2280322989 <doc xml:space="preserve"
2280422990 filename="glib/gversion.c"
2280522991 line="78">The micro version number of the GLib library.
@@ -22841,7 +23027,7 @@ linked against at application run time.</doc>
2284123027 <source-position filename="glib/gtypes.h" line="74"/>
2284223028 <type name="gint8" c:type="gint8"/>
2284323029 </constant>
22844- <constant name="MINOR_VERSION" value="84" c:type="GLIB_MINOR_VERSION">
23030+ <constant name="MINOR_VERSION" value="86" c:type="GLIB_MINOR_VERSION">
2284523031 <doc xml:space="preserve"
2284623032 filename="glib/gversion.c"
2284723033 line="59">The minor version number of the GLib library.
@@ -22919,12 +23105,12 @@ type representing a set of sources to be handled in a main loop.</doc>
2291923105 <constructor name="new" c:identifier="g_main_context_new">
2292023106 <doc xml:space="preserve"
2292123107 filename="glib/gmain.c"
22922- line="605">Creates a new [struct@GLib.MainContext] structure.</doc>
22923- <source-position filename="glib/gmain.h" line="487"/>
23108+ line="649">Creates a new [struct@GLib.MainContext] structure.</doc>
23109+ <source-position filename="glib/gmain.h" line="488"/>
2292423110 <return-value transfer-ownership="full">
2292523111 <doc xml:space="preserve"
2292623112 filename="glib/gmain.c"
22927- line="610">the new #GMainContext</doc>
23113+ line="654">the new main context</doc>
2292823114 <type name="MainContext" c:type="GMainContext*"/>
2292923115 </return-value>
2293023116 </constructor>
@@ -22933,20 +23119,20 @@ type representing a set of sources to be handled in a main loop.</doc>
2293323119 version="2.72">
2293423120 <doc xml:space="preserve"
2293523121 filename="glib/gmain.c"
22936- line="618">Creates a new [struct@GLib.MainContext] structure.</doc>
22937- <source-position filename="glib/gmain.h" line="490"/>
23122+ line="662">Creates a new [struct@GLib.MainContext] structure.</doc>
23123+ <source-position filename="glib/gmain.h" line="491"/>
2293823124 <return-value transfer-ownership="full">
2293923125 <doc xml:space="preserve"
2294023126 filename="glib/gmain.c"
22941- line="625">the new #GMainContext</doc>
23127+ line="669">the new main context</doc>
2294223128 <type name="MainContext" c:type="GMainContext*"/>
2294323129 </return-value>
2294423130 <parameters>
2294523131 <parameter name="flags" transfer-ownership="none">
2294623132 <doc xml:space="preserve"
2294723133 filename="glib/gmain.c"
22948- line="620">a bitwise-OR combination of #GMainContextFlags flags that can only be
22949- set at creation time.</doc>
23134+ line="664">a bitwise-OR combination of flags that can only be set at creation
23135+ time</doc>
2295023136 <type name="MainContextFlags" c:type="GMainContextFlags"/>
2295123137 </parameter>
2295223138 </parameters>
@@ -22954,9 +23140,10 @@ type representing a set of sources to be handled in a main loop.</doc>
2295423140 <method name="acquire" c:identifier="g_main_context_acquire">
2295523141 <doc xml:space="preserve"
2295623142 filename="glib/gmain.c"
22957- line="3438">Tries to become the owner of the specified context.
23143+ line="3605">Tries to become the owner of the specified context.
23144+
2295823145 If some other thread is the owner of the context,
22959-returns %FALSE immediately. Ownership is properly
23146+returns false immediately. Ownership is properly
2296023147 recursive: the owner can require ownership again
2296123148 and will release ownership when [method@GLib.MainContext.release]
2296223149 is called as many times as [method@GLib.MainContext.acquire].
@@ -22966,14 +23153,13 @@ can call [method@GLib.MainContext.prepare], [method@GLib.MainContext.query],
2296623153 [method@GLib.MainContext.check], [method@GLib.MainContext.dispatch],
2296723154 [method@GLib.MainContext.release].
2296823155
22969-Since 2.76 @context can be %NULL to use the global-default
23156+Since 2.76 @context can be `NULL` to use the global-default
2297023157 main context.</doc>
22971- <source-position filename="glib/gmain.h" line="523"/>
23158+ <source-position filename="glib/gmain.h" line="524"/>
2297223159 <return-value transfer-ownership="none">
2297323160 <doc xml:space="preserve"
2297423161 filename="glib/gmain.c"
22975- line="3458">%TRUE if the operation succeeded, and
22976- this thread is now the owner of @context.</doc>
23162+ line="3626">true if this thread is now the owner of @context, false otherwise</doc>
2297723163 <type name="gboolean" c:type="gboolean"/>
2297823164 </return-value>
2297923165 <parameters>
@@ -22983,7 +23169,7 @@ main context.</doc>
2298323169 allow-none="1">
2298423170 <doc xml:space="preserve"
2298523171 filename="glib/gmain.c"
22986- line="3440">a #GMainContext (if %NULL, the global-default
23172+ line="3607">a main context (if `NULL`, the global-default
2298723173 main context will be used)</doc>
2298823174 <type name="MainContext" c:type="GMainContext*"/>
2298923175 </instance-parameter>
@@ -22992,10 +23178,12 @@ main context.</doc>
2299223178 <method name="add_poll" c:identifier="g_main_context_add_poll">
2299323179 <doc xml:space="preserve"
2299423180 filename="glib/gmain.c"
22995- line="4700">Adds a file descriptor to the set of file descriptors polled for
22996-this context. This will very seldom be used directly. Instead
22997-a typical event source will use `g_source_add_unix_fd` instead.</doc>
22998- <source-position filename="glib/gmain.h" line="559"/>
23181+ line="4879">Adds a file descriptor to the set of file descriptors polled for
23182+this context.
23183+
23184+This will very seldom be used directly. Instead
23185+a typical event source will use `g_source_add_unix_fd()` instead.</doc>
23186+ <source-position filename="glib/gmain.h" line="560"/>
2299923187 <return-value transfer-ownership="none">
2300023188 <type name="none" c:type="void"/>
2300123189 </return-value>
@@ -23006,23 +23194,23 @@ a typical event source will use `g_source_add_unix_fd` instead.</doc>
2300623194 allow-none="1">
2300723195 <doc xml:space="preserve"
2300823196 filename="glib/gmain.c"
23009- line="4702">a #GMainContext (or %NULL for the global-default
23197+ line="4881">a main context (or `NULL` for the global-default
2301023198 main context)</doc>
2301123199 <type name="MainContext" c:type="GMainContext*"/>
2301223200 </instance-parameter>
2301323201 <parameter name="fd" transfer-ownership="none">
2301423202 <doc xml:space="preserve"
2301523203 filename="glib/gmain.c"
23016- line="4704">a #GPollFD structure holding information about a file
23017- descriptor to watch.</doc>
23204+ line="4883">a [struct@GLib.PollFD] structure holding information about a file
23205+ descriptor to watch.</doc>
2301823206 <type name="PollFD" c:type="GPollFD*"/>
2301923207 </parameter>
2302023208 <parameter name="priority" transfer-ownership="none">
2302123209 <doc xml:space="preserve"
2302223210 filename="glib/gmain.c"
23023- line="4706">the priority for this file descriptor which should be
23024- the same as the priority used for [method@GLib.Source.attach] to ensure
23025- that the file descriptor is polled whenever the results may be needed.</doc>
23211+ line="4885">the priority for this file descriptor which should be
23212+ the same as the priority used for [method@GLib.Source.attach] to ensure
23213+ that the file descriptor is polled whenever the results may be needed.</doc>
2302623214 <type name="gint" c:type="gint"/>
2302723215 </parameter>
2302823216 </parameters>
@@ -23030,7 +23218,9 @@ a typical event source will use `g_source_add_unix_fd` instead.</doc>
2303023218 <method name="check" c:identifier="g_main_context_check">
2303123219 <doc xml:space="preserve"
2303223220 filename="glib/gmain.c"
23033- line="3995">Passes the results of polling back to the main loop. You should be
23221+ line="4169">Passes the results of polling back to the main loop.
23222+
23223+You should be
2303423224 careful to pass @fds and its length @n_fds as received from
2303523225 [method@GLib.MainContext.query], as this functions relies on assumptions
2303623226 on how @fds is filled.
@@ -23038,13 +23228,13 @@ on how @fds is filled.
2303823228 You must have successfully acquired the context with
2303923229 [method@GLib.MainContext.acquire] before you may call this function.
2304023230
23041-Since 2.76 @context can be %NULL to use the global-default
23231+Since 2.76 @context can be `NULL` to use the global-default
2304223232 main context.</doc>
23043- <source-position filename="glib/gmain.h" line="543"/>
23233+ <source-position filename="glib/gmain.h" line="544"/>
2304423234 <return-value transfer-ownership="none">
2304523235 <doc xml:space="preserve"
2304623236 filename="glib/gmain.c"
23047- line="4015">%TRUE if some sources are ready to be dispatched.</doc>
23237+ line="4191">true if some sources are ready to be dispatched, false otherwise</doc>
2304823238 <type name="gboolean" c:type="gboolean"/>
2304923239 </return-value>
2305023240 <parameters>
@@ -23054,21 +23244,21 @@ main context.</doc>
2305423244 allow-none="1">
2305523245 <doc xml:space="preserve"
2305623246 filename="glib/gmain.c"
23057- line="3997">a #GMainContext (if %NULL, the global-default
23247+ line="4171">a main context (if `NULL`, the global-default
2305823248 main context will be used)</doc>
2305923249 <type name="MainContext" c:type="GMainContext*"/>
2306023250 </instance-parameter>
2306123251 <parameter name="max_priority" transfer-ownership="none">
2306223252 <doc xml:space="preserve"
2306323253 filename="glib/gmain.c"
23064- line="3999">the maximum numerical priority of sources to check</doc>
23254+ line="4173">the maximum numerical priority of sources to check</doc>
2306523255 <type name="gint" c:type="gint"/>
2306623256 </parameter>
2306723257 <parameter name="fds" transfer-ownership="none">
2306823258 <doc xml:space="preserve"
2306923259 filename="glib/gmain.c"
23070- line="4000">array of #GPollFD's that was passed to
23071- the last call to [method@GLib.MainContext.query]</doc>
23260+ line="4174">array of [struct@GLib.PollFD]s that was passed to
23261+ the last call to [method@GLib.MainContext.query]</doc>
2307223262 <array length="2" zero-terminated="0" c:type="GPollFD*">
2307323263 <type name="PollFD" c:type="GPollFD"/>
2307423264 </array>
@@ -23076,7 +23266,7 @@ main context.</doc>
2307623266 <parameter name="n_fds" transfer-ownership="none">
2307723267 <doc xml:space="preserve"
2307823268 filename="glib/gmain.c"
23079- line="4002">return value of [method@GLib.MainContext.query]</doc>
23269+ line="4176">return value of [method@GLib.MainContext.query]</doc>
2308023270 <type name="gint" c:type="gint"/>
2308123271 </parameter>
2308223272 </parameters>
@@ -23084,14 +23274,14 @@ main context.</doc>
2308423274 <method name="dispatch" c:identifier="g_main_context_dispatch">
2308523275 <doc xml:space="preserve"
2308623276 filename="glib/gmain.c"
23087- line="4216">Dispatches all pending sources.
23277+ line="4392">Dispatches all pending sources.
2308823278
2308923279 You must have successfully acquired the context with
2309023280 [method@GLib.MainContext.acquire] before you may call this function.
2309123281
23092-Since 2.76 @context can be %NULL to use the global-default
23282+Since 2.76 @context can be `NULL` to use the global-default
2309323283 main context.</doc>
23094- <source-position filename="glib/gmain.h" line="548"/>
23284+ <source-position filename="glib/gmain.h" line="549"/>
2309523285 <return-value transfer-ownership="none">
2309623286 <type name="none" c:type="void"/>
2309723287 </return-value>
@@ -23102,7 +23292,7 @@ main context.</doc>
2310223292 allow-none="1">
2310323293 <doc xml:space="preserve"
2310423294 filename="glib/gmain.c"
23105- line="4218">a #GMainContext (if %NULL, the global-default
23295+ line="4394">a main context (if `NULL`, the global-default
2310623296 main context will be used)</doc>
2310723297 <type name="MainContext" c:type="GMainContext*"/>
2310823298 </instance-parameter>
@@ -23112,14 +23302,16 @@ main context.</doc>
2311223302 c:identifier="g_main_context_find_source_by_funcs_user_data">
2311323303 <doc xml:space="preserve"
2311423304 filename="glib/gmain.c"
23115- line="2424">Finds a source with the given source functions and user data. If
23116-multiple sources exist with the same source function and user data,
23305+ line="2575">Finds a source with the given source functions and user data.
23306+
23307+If multiple sources exist with the same source function and user data,
2311723308 the first one found will be returned.</doc>
23118- <source-position filename="glib/gmain.h" line="514"/>
23119- <return-value transfer-ownership="none">
23309+ <source-position filename="glib/gmain.h" line="515"/>
23310+ <return-value transfer-ownership="none" nullable="1">
2312023311 <doc xml:space="preserve"
2312123312 filename="glib/gmain.c"
23122- line="2435">the source, if one was found, otherwise %NULL</doc>
23313+ line="2587">the source, if one was found,
23314+ otherwise `NULL`</doc>
2312323315 <type name="Source" c:type="GSource*"/>
2312423316 </return-value>
2312523317 <parameters>
@@ -23129,14 +23321,14 @@ the first one found will be returned.</doc>
2312923321 allow-none="1">
2313023322 <doc xml:space="preserve"
2313123323 filename="glib/gmain.c"
23132- line="2426">a #GMainContext (if %NULL, the global-default
23324+ line="2577">a main context (if `NULL`, the global-default
2313323325 main context will be used).</doc>
2313423326 <type name="MainContext" c:type="GMainContext*"/>
2313523327 </instance-parameter>
2313623328 <parameter name="funcs" transfer-ownership="none">
2313723329 <doc xml:space="preserve"
2313823330 filename="glib/gmain.c"
23139- line="2428">the @source_funcs passed to [ctor@GLib.Source.new].</doc>
23331+ line="2579">the @source_funcs passed to [ctor@GLib.Source.new]</doc>
2314023332 <type name="SourceFuncs" c:type="GSourceFuncs*"/>
2314123333 </parameter>
2314223334 <parameter name="user_data"
@@ -23145,7 +23337,7 @@ the first one found will be returned.</doc>
2314523337 allow-none="1">
2314623338 <doc xml:space="preserve"
2314723339 filename="glib/gmain.c"
23148- line="2429">the user data from the callback.</doc>
23340+ line="2580">the user data from the callback</doc>
2314923341 <type name="gpointer" c:type="gpointer"/>
2315023342 </parameter>
2315123343 </parameters>
@@ -23154,7 +23346,7 @@ the first one found will be returned.</doc>
2315423346 c:identifier="g_main_context_find_source_by_id">
2315523347 <doc xml:space="preserve"
2315623348 filename="glib/gmain.c"
23157- line="2378">Finds a #GSource given a pair of context and ID.
23349+ line="2529">Finds a [struct@GLib.Source] given a pair of context and ID.
2315823350
2315923351 It is a programmer error to attempt to look up a non-existent source.
2316023352
@@ -23166,11 +23358,11 @@ idle may already have run and been removed by the time this function
2316623358 is called on its (now invalid) source ID. This source ID may have
2316723359 been reissued, leading to the operation being performed against the
2316823360 wrong source.</doc>
23169- <source-position filename="glib/gmain.h" line="508"/>
23361+ <source-position filename="glib/gmain.h" line="509"/>
2317023362 <return-value transfer-ownership="none">
2317123363 <doc xml:space="preserve"
2317223364 filename="glib/gmain.c"
23173- line="2397">the #GSource</doc>
23365+ line="2548">the source</doc>
2317423366 <type name="Source" c:type="GSource*"/>
2317523367 </return-value>
2317623368 <parameters>
@@ -23180,14 +23372,14 @@ wrong source.</doc>
2318023372 allow-none="1">
2318123373 <doc xml:space="preserve"
2318223374 filename="glib/gmain.c"
23183- line="2380">a #GMainContext (if %NULL, the global-default
23375+ line="2531">a main context (if `NULL`, the global-default
2318423376 main context will be used)</doc>
2318523377 <type name="MainContext" c:type="GMainContext*"/>
2318623378 </instance-parameter>
2318723379 <parameter name="source_id" transfer-ownership="none">
2318823380 <doc xml:space="preserve"
2318923381 filename="glib/gmain.c"
23190- line="2382">the source ID, as returned by [method@GLib.Source.get_id].</doc>
23382+ line="2533">the source ID, as returned by [method@GLib.Source.get_id]</doc>
2319123383 <type name="guint" c:type="guint"/>
2319223384 </parameter>
2319323385 </parameters>
@@ -23196,14 +23388,16 @@ wrong source.</doc>
2319623388 c:identifier="g_main_context_find_source_by_user_data">
2319723389 <doc xml:space="preserve"
2319823390 filename="glib/gmain.c"
23199- line="2475">Finds a source with the given user data for the callback. If
23200-multiple sources exist with the same user data, the first
23391+ line="2628">Finds a source with the given user data for the callback.
23392+
23393+If multiple sources exist with the same user data, the first
2320123394 one found will be returned.</doc>
23202- <source-position filename="glib/gmain.h" line="511"/>
23203- <return-value transfer-ownership="none">
23395+ <source-position filename="glib/gmain.h" line="512"/>
23396+ <return-value transfer-ownership="none" nullable="1">
2320423397 <doc xml:space="preserve"
2320523398 filename="glib/gmain.c"
23206- line="2485">the source, if one was found, otherwise %NULL</doc>
23399+ line="2639">the source, if one was found,
23400+ otherwise `NULL`</doc>
2320723401 <type name="Source" c:type="GSource*"/>
2320823402 </return-value>
2320923403 <parameters>
@@ -23213,7 +23407,7 @@ one found will be returned.</doc>
2321323407 allow-none="1">
2321423408 <doc xml:space="preserve"
2321523409 filename="glib/gmain.c"
23216- line="2477">a #GMainContext (if %NULL, the global-default
23410+ line="2630">a main context (if `NULL`, the global-default
2321723411 main context will be used)</doc>
2321823412 <type name="MainContext" c:type="GMainContext*"/>
2321923413 </instance-parameter>
@@ -23223,7 +23417,7 @@ one found will be returned.</doc>
2322323417 allow-none="1">
2322423418 <doc xml:space="preserve"
2322523419 filename="glib/gmain.c"
23226- line="2479">the user_data for the callback.</doc>
23420+ line="2632">the user_data for the callback</doc>
2322723421 <type name="gpointer" c:type="gpointer"/>
2322823422 </parameter>
2322923423 </parameters>
@@ -23233,12 +23427,12 @@ one found will be returned.</doc>
2323323427 introspectable="0">
2323423428 <doc xml:space="preserve"
2323523429 filename="glib/gmain.c"
23236- line="4932">Gets the poll function set by [method@GLib.MainContext.set_poll_func].</doc>
23237- <source-position filename="glib/gmain.h" line="554"/>
23430+ line="5115">Gets the poll function set by [method@GLib.MainContext.set_poll_func].</doc>
23431+ <source-position filename="glib/gmain.h" line="555"/>
2323823432 <return-value>
2323923433 <doc xml:space="preserve"
2324023434 filename="glib/gmain.c"
23241- line="4939">the poll function</doc>
23435+ line="5122">the poll function</doc>
2324223436 <type name="PollFunc" c:type="GPollFunc"/>
2324323437 </return-value>
2324423438 <parameters>
@@ -23248,7 +23442,7 @@ one found will be returned.</doc>
2324823442 allow-none="1">
2324923443 <doc xml:space="preserve"
2325023444 filename="glib/gmain.c"
23251- line="4934">a #GMainContext (if %NULL, the global-default
23445+ line="5117">a main context (if `NULL`, the global-default
2325223446 main context will be used)</doc>
2325323447 <type name="MainContext" c:type="GMainContext*"/>
2325423448 </instance-parameter>
@@ -23260,16 +23454,16 @@ one found will be returned.</doc>
2326023454 introspectable="0">
2326123455 <doc xml:space="preserve"
2326223456 filename="glib/gmain.c"
23263- line="6461">Invokes a function in such a way that @context is owned during the
23457+ line="6646">Invokes a function in such a way that @context is owned during the
2326423458 invocation of @function.
2326523459
23266-If @context is %NULL then the global-default main context — as
23460+If @context is `NULL` then the global-default main context — as
2326723461 returned by [func@GLib.MainContext.default] — is used.
2326823462
2326923463 If @context is owned by the current thread, @function is called
2327023464 directly. Otherwise, if @context is the thread-default main context
23271-of the current thread and [method@GLib.MainContext.acquire] succeeds, then
23272-@function is called and [method@GLib.MainContext.release] is called
23465+of the current thread and [method@GLib.MainContext.acquire] succeeds,
23466+then @function is called and [method@GLib.MainContext.release] is called
2327323467 afterwards.
2327423468
2327523469 In any other case, an idle source is created to call @function and
@@ -23278,10 +23472,10 @@ thread). The idle source is attached with [const@GLib.PRIORITY_DEFAULT]
2327823472 priority. If you want a different priority, use
2327923473 [method@GLib.MainContext.invoke_full].
2328023474
23281-Note that, as with normal idle functions, @function should probably
23282-return %FALSE. If it returns %TRUE, it will be continuously run in a
23283-loop (and may prevent this call from returning).</doc>
23284- <source-position filename="glib/gmain.h" line="983"/>
23475+Note that, as with normal idle functions, @function should probably return
23476+[const@GLib.SOURCE_REMOVE]. If it returns [const@GLib.SOURCE_CONTINUE], it
23477+will be continuously run in a loop (and may prevent this call from returning).</doc>
23478+ <source-position filename="glib/gmain.h" line="986"/>
2328523479 <return-value transfer-ownership="none">
2328623480 <type name="none" c:type="void"/>
2328723481 </return-value>
@@ -23292,14 +23486,14 @@ loop (and may prevent this call from returning).</doc>
2329223486 allow-none="1">
2329323487 <doc xml:space="preserve"
2329423488 filename="glib/gmain.c"
23295- line="6463">a #GMainContext, or %NULL for the global-default
23489+ line="6648">a main context, or `NULL` for the global-default
2329623490 main context</doc>
2329723491 <type name="MainContext" c:type="GMainContext*"/>
2329823492 </instance-parameter>
2329923493 <parameter name="function" transfer-ownership="none" closure="1">
2330023494 <doc xml:space="preserve"
2330123495 filename="glib/gmain.c"
23302- line="6465">function to call</doc>
23496+ line="6650">function to call</doc>
2330323497 <type name="SourceFunc" c:type="GSourceFunc"/>
2330423498 </parameter>
2330523499 <parameter name="data"
@@ -23308,7 +23502,7 @@ loop (and may prevent this call from returning).</doc>
2330823502 allow-none="1">
2330923503 <doc xml:space="preserve"
2331023504 filename="glib/gmain.c"
23311- line="6466">data to pass to @function</doc>
23505+ line="6651">data to pass to @function</doc>
2331223506 <type name="gpointer" c:type="gpointer"/>
2331323507 </parameter>
2331423508 </parameters>
@@ -23318,16 +23512,17 @@ loop (and may prevent this call from returning).</doc>
2331823512 version="2.28">
2331923513 <doc xml:space="preserve"
2332023514 filename="glib/gmain.c"
23321- line="6502">Invokes a function in such a way that @context is owned during the
23515+ line="6687">Invokes a function in such a way that @context is owned during the
2332223516 invocation of @function.
2332323517
2332423518 This function is the same as [method@GLib.MainContext.invoke] except that it
2332523519 lets you specify the priority in case @function ends up being
23326-scheduled as an idle and also lets you give a #GDestroyNotify for @data.
23520+scheduled as an idle and also lets you give a [callback@GLib.DestroyNotify]
23521+for @data.
2332723522
23328-@notify should not assume that it is called from any particular
23523+The @notify function should not assume that it is called from any particular
2332923524 thread or with any particular context acquired.</doc>
23330- <source-position filename="glib/gmain.h" line="977"/>
23525+ <source-position filename="glib/gmain.h" line="980"/>
2333123526 <return-value transfer-ownership="none">
2333223527 <type name="none" c:type="void"/>
2333323528 </return-value>
@@ -23338,14 +23533,14 @@ thread or with any particular context acquired.</doc>
2333823533 allow-none="1">
2333923534 <doc xml:space="preserve"
2334023535 filename="glib/gmain.c"
23341- line="6504">a #GMainContext, or %NULL for the global-default
23536+ line="6689">a main context, or `NULL` for the global-default
2334223537 main context</doc>
2334323538 <type name="MainContext" c:type="GMainContext*"/>
2334423539 </instance-parameter>
2334523540 <parameter name="priority" transfer-ownership="none">
2334623541 <doc xml:space="preserve"
2334723542 filename="glib/gmain.c"
23348- line="6506">the priority at which to run @function</doc>
23543+ line="6691">the priority at which to run @function</doc>
2334923544 <type name="gint" c:type="gint"/>
2335023545 </parameter>
2335123546 <parameter name="function"
@@ -23355,7 +23550,7 @@ thread or with any particular context acquired.</doc>
2335523550 destroy="3">
2335623551 <doc xml:space="preserve"
2335723552 filename="glib/gmain.c"
23358- line="6507">function to call</doc>
23553+ line="6692">function to call</doc>
2335923554 <type name="SourceFunc" c:type="GSourceFunc"/>
2336023555 </parameter>
2336123556 <parameter name="data"
@@ -23364,7 +23559,7 @@ thread or with any particular context acquired.</doc>
2336423559 allow-none="1">
2336523560 <doc xml:space="preserve"
2336623561 filename="glib/gmain.c"
23367- line="6508">data to pass to @function</doc>
23562+ line="6693">data to pass to @function</doc>
2336823563 <type name="gpointer" c:type="gpointer"/>
2336923564 </parameter>
2337023565 <parameter name="notify"
@@ -23374,7 +23569,7 @@ thread or with any particular context acquired.</doc>
2337423569 scope="async">
2337523570 <doc xml:space="preserve"
2337623571 filename="glib/gmain.c"
23377- line="6509">a function to call when @data is no longer in use, or %NULL.</doc>
23572+ line="6694">a function to call when @data is no longer in use</doc>
2337823573 <type name="DestroyNotify" c:type="GDestroyNotify"/>
2337923574 </parameter>
2338023575 </parameters>
@@ -23384,15 +23579,17 @@ thread or with any particular context acquired.</doc>
2338423579 version="2.10">
2338523580 <doc xml:space="preserve"
2338623581 filename="glib/gmain.c"
23387- line="5005">Determines whether this thread holds the (recursive)
23388-ownership of this [struct@GLib.MainContext]. This is useful to
23582+ line="5191">Determines whether this thread holds the (recursive)
23583+ownership of this [struct@GLib.MainContext].
23584+
23585+This is useful to
2338923586 know before waiting on another thread that may be
2339023587 blocking to get ownership of @context.</doc>
23391- <source-position filename="glib/gmain.h" line="527"/>
23588+ <source-position filename="glib/gmain.h" line="528"/>
2339223589 <return-value transfer-ownership="none">
2339323590 <doc xml:space="preserve"
2339423591 filename="glib/gmain.c"
23395- line="5015">%TRUE if current thread is owner of @context.</doc>
23592+ line="5203">true if current thread is owner of @context, false otherwise</doc>
2339623593 <type name="gboolean" c:type="gboolean"/>
2339723594 </return-value>
2339823595 <parameters>
@@ -23402,7 +23599,7 @@ blocking to get ownership of @context.</doc>
2340223599 allow-none="1">
2340323600 <doc xml:space="preserve"
2340423601 filename="glib/gmain.c"
23405- line="5007">a #GMainContext (if %NULL, the global-default
23602+ line="5193">a main context (if `NULL`, the global-default
2340623603 main context will be used)</doc>
2340723604 <type name="MainContext" c:type="GMainContext*"/>
2340823605 </instance-parameter>
@@ -23411,23 +23608,24 @@ blocking to get ownership of @context.</doc>
2341123608 <method name="iteration" c:identifier="g_main_context_iteration">
2341223609 <doc xml:space="preserve"
2341323610 filename="glib/gmain.c"
23414- line="4349">Runs a single iteration for the given main loop. This involves
23611+ line="4525">Runs a single iteration for the given main loop.
23612+
23613+This involves
2341523614 checking to see if any event sources are ready to be processed,
23416-then if no events sources are ready and @may_block is %TRUE, waiting
23615+then if no events sources are ready and @may_block is true, waiting
2341723616 for a source to become ready, then dispatching the highest priority
23418-events sources that are ready. Otherwise, if @may_block is %FALSE
23419-sources are not waited to become ready, only those highest priority
23420-events sources will be dispatched (if any), that are ready at this
23421-given moment without further waiting.
23617+events sources that are ready. Otherwise, if @may_block is false,
23618+this function does not wait for sources to become ready, and only the highest
23619+priority sources which are already ready (if any) will be dispatched.
2342223620
23423-Note that even when @may_block is %TRUE, it is still possible for
23424-[method@GLib.MainContext.iteration] to return %FALSE, since the wait may
23621+Note that even when @may_block is true, it is still possible for
23622+[method@GLib.MainContext.iteration] to return false, since the wait may
2342523623 be interrupted for other reasons than an event source becoming ready.</doc>
23426- <source-position filename="glib/gmain.h" line="500"/>
23624+ <source-position filename="glib/gmain.h" line="501"/>
2342723625 <return-value transfer-ownership="none">
2342823626 <doc xml:space="preserve"
2342923627 filename="glib/gmain.c"
23430- line="4368">%TRUE if events were dispatched.</doc>
23628+ line="4545">true if events were dispatched, false otherwise</doc>
2343123629 <type name="gboolean" c:type="gboolean"/>
2343223630 </return-value>
2343323631 <parameters>
@@ -23437,14 +23635,14 @@ be interrupted for other reasons than an event source becoming ready.</doc>
2343723635 allow-none="1">
2343823636 <doc xml:space="preserve"
2343923637 filename="glib/gmain.c"
23440- line="4351">a #GMainContext (if %NULL, the global-default
23638+ line="4527">a main context (if `NULL`, the global-default
2344123639 main context will be used)</doc>
2344223640 <type name="MainContext" c:type="GMainContext*"/>
2344323641 </instance-parameter>
2344423642 <parameter name="may_block" transfer-ownership="none">
2344523643 <doc xml:space="preserve"
2344623644 filename="glib/gmain.c"
23447- line="4353">whether the call may block.</doc>
23645+ line="4529">whether the call may block</doc>
2344823646 <type name="gboolean" c:type="gboolean"/>
2344923647 </parameter>
2345023648 </parameters>
@@ -23452,12 +23650,12 @@ be interrupted for other reasons than an event source becoming ready.</doc>
2345223650 <method name="pending" c:identifier="g_main_context_pending">
2345323651 <doc xml:space="preserve"
2345423652 filename="glib/gmain.c"
23455- line="4325">Checks if any sources have pending events for the given context.</doc>
23456- <source-position filename="glib/gmain.h" line="503"/>
23653+ line="4501">Checks if any sources have pending events for the given context.</doc>
23654+ <source-position filename="glib/gmain.h" line="504"/>
2345723655 <return-value transfer-ownership="none">
2345823656 <doc xml:space="preserve"
2345923657 filename="glib/gmain.c"
23460- line="4332">%TRUE if events are pending.</doc>
23658+ line="4508">true if events are pending, false otherwise</doc>
2346123659 <type name="gboolean" c:type="gboolean"/>
2346223660 </return-value>
2346323661 <parameters>
@@ -23467,7 +23665,7 @@ be interrupted for other reasons than an event source becoming ready.</doc>
2346723665 allow-none="1">
2346823666 <doc xml:space="preserve"
2346923667 filename="glib/gmain.c"
23470- line="4327">a #GMainContext (if %NULL, the global-default
23668+ line="4503">a main context (if `NULL`, the global-default
2347123669 main context will be used)</doc>
2347223670 <type name="MainContext" c:type="GMainContext*"/>
2347323671 </instance-parameter>
@@ -23478,9 +23676,9 @@ be interrupted for other reasons than an event source becoming ready.</doc>
2347823676 version="2.22">
2347923677 <doc xml:space="preserve"
2348023678 filename="glib/gmain.c"
23481- line="814">Pops @context off the thread-default context stack (verifying that
23679+ line="854">Pops @context off the thread-default context stack (verifying that
2348223680 it was on the top of the stack).</doc>
23483- <source-position filename="glib/gmain.h" line="576"/>
23681+ <source-position filename="glib/gmain.h" line="577"/>
2348423682 <return-value transfer-ownership="none">
2348523683 <type name="none" c:type="void"/>
2348623684 </return-value>
@@ -23491,7 +23689,7 @@ it was on the top of the stack).</doc>
2349123689 allow-none="1">
2349223690 <doc xml:space="preserve"
2349323691 filename="glib/gmain.c"
23494- line="816">a #GMainContext, or %NULL for the global-default
23692+ line="856">a main context, or `NULL` for the global-default
2349523693 main context</doc>
2349623694 <type name="MainContext" c:type="GMainContext*"/>
2349723695 </instance-parameter>
@@ -23500,17 +23698,19 @@ it was on the top of the stack).</doc>
2350023698 <method name="prepare" c:identifier="g_main_context_prepare">
2350123699 <doc xml:space="preserve"
2350223700 filename="glib/gmain.c"
23503- line="3658">Prepares to poll sources within a main loop. The resulting information
23701+ line="3828">Prepares to poll sources within a main loop.
23702+
23703+The resulting information
2350423704 for polling is determined by calling [method@GLib.MainContext.query].
2350523705
2350623706 You must have successfully acquired the context with
2350723707 [method@GLib.MainContext.acquire] before you may call this function.</doc>
23508- <source-position filename="glib/gmain.h" line="534"/>
23708+ <source-position filename="glib/gmain.h" line="535"/>
2350923709 <return-value transfer-ownership="none">
2351023710 <doc xml:space="preserve"
2351123711 filename="glib/gmain.c"
23512- line="3671">%TRUE if some source is ready to be dispatched
23513- prior to polling.</doc>
23712+ line="3843">true if some source is ready to be dispatched prior to polling,
23713+ false otherwise</doc>
2351423714 <type name="gboolean" c:type="gboolean"/>
2351523715 </return-value>
2351623716 <parameters>
@@ -23520,7 +23720,7 @@ You must have successfully acquired the context with
2352023720 allow-none="1">
2352123721 <doc xml:space="preserve"
2352223722 filename="glib/gmain.c"
23523- line="3660">a #GMainContext (if %NULL, the global-default
23723+ line="3830">a main context (if `NULL`, the global-default
2352423724 main context will be used)</doc>
2352523725 <type name="MainContext" c:type="GMainContext*"/>
2352623726 </instance-parameter>
@@ -23532,8 +23732,8 @@ You must have successfully acquired the context with
2353223732 allow-none="1">
2353323733 <doc xml:space="preserve"
2353423734 filename="glib/gmain.c"
23535- line="3662">location to store priority of highest priority
23536- source already ready.</doc>
23735+ line="3832">location to store priority of highest priority
23736+ source already ready</doc>
2353723737 <type name="gint" c:type="gint*"/>
2353823738 </parameter>
2353923739 </parameters>
@@ -23543,7 +23743,7 @@ You must have successfully acquired the context with
2354323743 version="2.22">
2354423744 <doc xml:space="preserve"
2354523745 filename="glib/gmain.c"
23546- line="741">Acquires @context and sets it as the thread-default context for the
23746+ line="781">Acquires @context and sets it as the thread-default context for the
2354723747 current thread. This will cause certain asynchronous operations
2354823748 (such as most [Gio](../gio/index.html)-based I/O) which are
2354923749 started in this thread to run under @context and deliver their
@@ -23561,8 +23761,8 @@ ever call [method@GLib.MainContext.pop_thread_default], assuming you want
2356123761 the new [struct@GLib.MainContext] to be the default for the whole lifecycle
2356223762 of the thread.
2356323763
23564-If you don't have control over how the new thread was created (e.g.
23565-in the new thread isn't newly created, or if the thread life
23764+If you don’t have control over how the new thread was created (e.g.
23765+in the new thread isn’t newly created, or if the thread life
2356623766 cycle is managed by a #GThreadPool), it is always suggested to wrap
2356723767 the logic that needs to use the new [struct@GLib.MainContext] inside a
2356823768 [method@GLib.MainContext.push_thread_default] /
@@ -23580,9 +23780,9 @@ ensure that no other asynchronous operations accidentally get
2358023780 started while the non-default context is active.
2358123781
2358223782 Beware that libraries that predate this function may not correctly
23583-handle being used from a thread with a thread-default context. Eg,
23584-see g_file_supports_thread_contexts().</doc>
23585- <source-position filename="glib/gmain.h" line="574"/>
23783+handle being used from a thread with a thread-default context. For example,
23784+see `g_file_supports_thread_contexts()`.</doc>
23785+ <source-position filename="glib/gmain.h" line="575"/>
2358623786 <return-value transfer-ownership="none">
2358723787 <type name="none" c:type="void"/>
2358823788 </return-value>
@@ -23593,7 +23793,7 @@ see g_file_supports_thread_contexts().</doc>
2359323793 allow-none="1">
2359423794 <doc xml:space="preserve"
2359523795 filename="glib/gmain.c"
23596- line="743">a #GMainContext, or %NULL for the global-default
23796+ line="783">a main context, or `NULL` for the global-default
2359723797 main context</doc>
2359823798 <type name="MainContext" c:type="GMainContext*"/>
2359923799 </instance-parameter>
@@ -23604,7 +23804,7 @@ see g_file_supports_thread_contexts().</doc>
2360423804 version="2.64">
2360523805 <doc xml:space="preserve"
2360623806 filename="glib/gmain.h"
23607- line="591">Push @main_context as the new thread-default main context for the current
23807+ line="592">Push @main_context as the new thread-default main context for the current
2360823808 thread, using [method@GLib.MainContext.push_thread_default], and return a
2360923809 new [alias@GLib.MainContextPusher]. Pop with g_main_context_pusher_free().
2361023810 Using [method@GLib.MainContext.pop_thread_default] on @main_context while a
@@ -23641,18 +23841,18 @@ my_object_do_stuff (MyObject *self)
2364123841 // Code with main context no longer the thread default here
2364223842 }
2364323843 ]|</doc>
23644- <source-position filename="glib/gmain.h" line="638"/>
23844+ <source-position filename="glib/gmain.h" line="639"/>
2364523845 <return-value transfer-ownership="full">
2364623846 <doc xml:space="preserve"
2364723847 filename="glib/gmain.h"
23648- line="633">a #GMainContextPusher</doc>
23848+ line="634">a #GMainContextPusher</doc>
2364923849 <type name="MainContextPusher" c:type="GMainContextPusher*"/>
2365023850 </return-value>
2365123851 <parameters>
2365223852 <instance-parameter name="main_context" transfer-ownership="none">
2365323853 <doc xml:space="preserve"
2365423854 filename="glib/gmain.h"
23655- line="593">a main context to push</doc>
23855+ line="594">a main context to push</doc>
2365623856 <type name="MainContext" c:type="GMainContext*"/>
2365723857 </instance-parameter>
2365823858 </parameters>
@@ -23660,20 +23860,22 @@ my_object_do_stuff (MyObject *self)
2366023860 <method name="query" c:identifier="g_main_context_query">
2366123861 <doc xml:space="preserve"
2366223862 filename="glib/gmain.c"
23663- line="3878">Determines information necessary to poll this main loop. You should
23863+ line="4050">Determines information necessary to poll this main loop.
23864+
23865+You should
2366423866 be careful to pass the resulting @fds array and its length @n_fds
23665-as is when calling [method@GLib.MainContext.check], as this function relies
23867+as-is when calling [method@GLib.MainContext.check], as this function relies
2366623868 on assumptions made when the array is filled.
2366723869
2366823870 You must have successfully acquired the context with
2366923871 [method@GLib.MainContext.acquire] before you may call this function.</doc>
23670- <source-position filename="glib/gmain.h" line="537"/>
23872+ <source-position filename="glib/gmain.h" line="538"/>
2367123873 <return-value transfer-ownership="none">
2367223874 <doc xml:space="preserve"
2367323875 filename="glib/gmain.c"
23674- line="3896">the number of records actually stored in @fds,
23876+ line="4070">the number of records actually stored in @fds,
2367523877 or, if more than @n_fds records need to be stored, the number
23676- of records that need to be stored.</doc>
23878+ of records that need to be stored</doc>
2367723879 <type name="gint" c:type="gint"/>
2367823880 </return-value>
2367923881 <parameters>
@@ -23683,14 +23885,14 @@ You must have successfully acquired the context with
2368323885 allow-none="1">
2368423886 <doc xml:space="preserve"
2368523887 filename="glib/gmain.c"
23686- line="3880">a #GMainContext (if %NULL, the global-default
23888+ line="4052">a main context (if `NULL`, the global-default
2368723889 main context will be used)</doc>
2368823890 <type name="MainContext" c:type="GMainContext*"/>
2368923891 </instance-parameter>
2369023892 <parameter name="max_priority" transfer-ownership="none">
2369123893 <doc xml:space="preserve"
2369223894 filename="glib/gmain.c"
23693- line="3882">maximum priority source to check</doc>
23895+ line="4054">maximum priority source to check</doc>
2369423896 <type name="gint" c:type="gint"/>
2369523897 </parameter>
2369623898 <parameter name="timeout_"
@@ -23699,7 +23901,7 @@ You must have successfully acquired the context with
2369923901 transfer-ownership="full">
2370023902 <doc xml:space="preserve"
2370123903 filename="glib/gmain.c"
23702- line="3883">location to store timeout to be used in polling</doc>
23904+ line="4055">location to store timeout to be used in polling</doc>
2370323905 <type name="gint" c:type="gint*"/>
2370423906 </parameter>
2370523907 <parameter name="fds"
@@ -23708,8 +23910,8 @@ You must have successfully acquired the context with
2370823910 transfer-ownership="none">
2370923911 <doc xml:space="preserve"
2371023912 filename="glib/gmain.c"
23711- line="3884">location to
23712- store #GPollFD records that need to be polled.</doc>
23913+ line="4056">location to
23914+ store [struct@GLib.PollFD] records that need to be polled</doc>
2371323915 <array length="3" zero-terminated="0" c:type="GPollFD*">
2371423916 <type name="PollFD" c:type="GPollFD"/>
2371523917 </array>
@@ -23717,7 +23919,7 @@ You must have successfully acquired the context with
2371723919 <parameter name="n_fds" transfer-ownership="none">
2371823920 <doc xml:space="preserve"
2371923921 filename="glib/gmain.c"
23720- line="3886">length of @fds.</doc>
23922+ line="4058">length of @fds</doc>
2372123923 <type name="gint" c:type="gint"/>
2372223924 </parameter>
2372323925 </parameters>
@@ -23725,19 +23927,19 @@ You must have successfully acquired the context with
2372523927 <method name="ref" c:identifier="g_main_context_ref">
2372623928 <doc xml:space="preserve"
2372723929 filename="glib/gmain.c"
23728- line="468">Increases the reference count on a [struct@GLib.MainContext] object by one.</doc>
23729- <source-position filename="glib/gmain.h" line="493"/>
23930+ line="476">Increases the reference count on a [struct@GLib.MainContext] object by one.</doc>
23931+ <source-position filename="glib/gmain.h" line="494"/>
2373023932 <return-value transfer-ownership="full">
2373123933 <doc xml:space="preserve"
2373223934 filename="glib/gmain.c"
23733- line="474">the @context that was passed in (since 2.6)</doc>
23935+ line="482">the @context that was passed in (since 2.6)</doc>
2373423936 <type name="MainContext" c:type="GMainContext*"/>
2373523937 </return-value>
2373623938 <parameters>
2373723939 <instance-parameter name="context" transfer-ownership="none">
2373823940 <doc xml:space="preserve"
2373923941 filename="glib/gmain.c"
23740- line="470">a #GMainContext</doc>
23942+ line="478">a main context</doc>
2374123943 <type name="MainContext" c:type="GMainContext*"/>
2374223944 </instance-parameter>
2374323945 </parameters>
@@ -23745,14 +23947,16 @@ You must have successfully acquired the context with
2374523947 <method name="release" c:identifier="g_main_context_release">
2374623948 <doc xml:space="preserve"
2374723949 filename="glib/gmain.c"
23748- line="3502">Releases ownership of a context previously acquired by this thread
23749-with [method@GLib.MainContext.acquire]. If the context was acquired multiple
23950+ line="3669">Releases ownership of a context previously acquired by this thread
23951+with [method@GLib.MainContext.acquire].
23952+
23953+If the context was acquired multiple
2375023954 times, the ownership will be released only when [method@GLib.MainContext.release]
2375123955 is called as many times as it was acquired.
2375223956
2375323957 You must have successfully acquired the context with
2375423958 [method@GLib.MainContext.acquire] before you may call this function.</doc>
23755- <source-position filename="glib/gmain.h" line="525"/>
23959+ <source-position filename="glib/gmain.h" line="526"/>
2375623960 <return-value transfer-ownership="none">
2375723961 <type name="none" c:type="void"/>
2375823962 </return-value>
@@ -23763,7 +23967,7 @@ You must have successfully acquired the context with
2376323967 allow-none="1">
2376423968 <doc xml:space="preserve"
2376523969 filename="glib/gmain.c"
23766- line="3504">a #GMainContext (if %NULL, the global-default
23970+ line="3671">a main context (if `NULL`, the global-default
2376723971 main context will be used)</doc>
2376823972 <type name="MainContext" c:type="GMainContext*"/>
2376923973 </instance-parameter>
@@ -23772,9 +23976,9 @@ You must have successfully acquired the context with
2377223976 <method name="remove_poll" c:identifier="g_main_context_remove_poll">
2377323977 <doc xml:space="preserve"
2377423978 filename="glib/gmain.c"
23775- line="4775">Removes file descriptor from the set of file descriptors to be
23979+ line="4956">Removes file descriptor from the set of file descriptors to be
2377623980 polled for a particular context.</doc>
23777- <source-position filename="glib/gmain.h" line="563"/>
23981+ <source-position filename="glib/gmain.h" line="564"/>
2377823982 <return-value transfer-ownership="none">
2377923983 <type name="none" c:type="void"/>
2378023984 </return-value>
@@ -23785,14 +23989,14 @@ polled for a particular context.</doc>
2378523989 allow-none="1">
2378623990 <doc xml:space="preserve"
2378723991 filename="glib/gmain.c"
23788- line="4777">a #GMainContext (if %NULL, the global-default
23992+ line="4958">a main context (if `NULL`, the global-default
2378923993 main context will be used)</doc>
2379023994 <type name="MainContext" c:type="GMainContext*"/>
2379123995 </instance-parameter>
2379223996 <parameter name="fd" transfer-ownership="none">
2379323997 <doc xml:space="preserve"
2379423998 filename="glib/gmain.c"
23795- line="4779">a #GPollFD descriptor previously added with
23999+ line="4960">a [struct@GLib.PollFD] descriptor previously added with
2379624000 [method@GLib.MainContext.add_poll]</doc>
2379724001 <type name="PollFD" c:type="GPollFD*"/>
2379824002 </parameter>
@@ -23803,14 +24007,15 @@ polled for a particular context.</doc>
2380324007 introspectable="0">
2380424008 <doc xml:space="preserve"
2380524009 filename="glib/gmain.c"
23806- line="4899">Sets the function to use to handle polling of file descriptors. It
23807-will be used instead of the poll() system call
23808-(or GLib's replacement function, which is used where
23809-poll() isn't available).
24010+ line="5081">Sets the function to use to handle polling of file descriptors.
24011+
24012+It will be used instead of the [`poll()`](man:poll(2)) system call
24013+(or GLib’s replacement function, which is used where
24014+`poll()` isn’t available).
2381024015
2381124016 This function could possibly be used to integrate the GLib event
2381224017 loop with an external event loop.</doc>
23813- <source-position filename="glib/gmain.h" line="551"/>
24018+ <source-position filename="glib/gmain.h" line="552"/>
2381424019 <return-value transfer-ownership="none">
2381524020 <type name="none" c:type="void"/>
2381624021 </return-value>
@@ -23821,14 +24026,14 @@ loop with an external event loop.</doc>
2382124026 allow-none="1">
2382224027 <doc xml:space="preserve"
2382324028 filename="glib/gmain.c"
23824- line="4901">a #GMainContext (if %NULL, the global-default
24029+ line="5083">a main context (if `NULL`, the global-default
2382524030 main context will be used)</doc>
2382624031 <type name="MainContext" c:type="GMainContext*"/>
2382724032 </instance-parameter>
2382824033 <parameter name="func" transfer-ownership="none">
2382924034 <doc xml:space="preserve"
2383024035 filename="glib/gmain.c"
23831- line="4903">the function to call to poll all file descriptors</doc>
24036+ line="5085">the function to call to poll all file descriptors</doc>
2383224037 <type name="PollFunc" c:type="GPollFunc"/>
2383324038 </parameter>
2383424039 </parameters>
@@ -23836,10 +24041,10 @@ loop with an external event loop.</doc>
2383624041 <method name="unref" c:identifier="g_main_context_unref">
2383724042 <doc xml:space="preserve"
2383824043 filename="glib/gmain.c"
23839- line="496">Decreases the reference count on a [struct@GLib.MainContext] object by one.
24044+ line="504">Decreases the reference count on a [struct@GLib.MainContext] object by one.
2384024045 If
2384124046 the result is zero, free the context and free all associated memory.</doc>
23842- <source-position filename="glib/gmain.h" line="495"/>
24047+ <source-position filename="glib/gmain.h" line="496"/>
2384324048 <return-value transfer-ownership="none">
2384424049 <type name="none" c:type="void"/>
2384524050 </return-value>
@@ -23847,7 +24052,7 @@ the result is zero, free the context and free all associated memory.</doc>
2384724052 <instance-parameter name="context" transfer-ownership="none">
2384824053 <doc xml:space="preserve"
2384924054 filename="glib/gmain.c"
23850- line="498">a #GMainContext</doc>
24055+ line="506">a main context</doc>
2385124056 <type name="MainContext" c:type="GMainContext*"/>
2385224057 </instance-parameter>
2385324058 </parameters>
@@ -23858,19 +24063,20 @@ the result is zero, free the context and free all associated memory.</doc>
2385824063 deprecated-version="2.58">
2385924064 <doc xml:space="preserve"
2386024065 filename="glib/gmain.c"
23861- line="3617">Tries to become the owner of the specified context,
23862-as with [method@GLib.MainContext.acquire]. But if another thread
24066+ line="3786">Tries to become the owner of the specified context, and waits on @cond if
24067+another thread is the owner.
24068+
24069+This is the same as [method@GLib.MainContext.acquire], but if another thread
2386324070 is the owner, atomically drop @mutex and wait on @cond until
2386424071 that owner releases ownership or until @cond is signaled, then
2386524072 try again (once) to become the owner.</doc>
2386624073 <doc-deprecated xml:space="preserve">Use [method@GLib.MainContext.is_owner] and separate
2386724074 locking instead.</doc-deprecated>
23868- <source-position filename="glib/gmain.h" line="529"/>
24075+ <source-position filename="glib/gmain.h" line="530"/>
2386924076 <return-value transfer-ownership="none">
2387024077 <doc xml:space="preserve"
2387124078 filename="glib/gmain.c"
23872- line="3630">%TRUE if the operation succeeded, and
23873- this thread is now the owner of @context.</doc>
24079+ line="3801">true if this thread is now the owner of @context, false otherwise</doc>
2387424080 <type name="gboolean" c:type="gboolean"/>
2387524081 </return-value>
2387624082 <parameters>
@@ -23880,20 +24086,20 @@ try again (once) to become the owner.</doc>
2388024086 allow-none="1">
2388124087 <doc xml:space="preserve"
2388224088 filename="glib/gmain.c"
23883- line="3619">a #GMainContext (if %NULL, the global-default
24089+ line="3788">a main context (if `NULL`, the global-default
2388424090 main context will be used)</doc>
2388524091 <type name="MainContext" c:type="GMainContext*"/>
2388624092 </instance-parameter>
2388724093 <parameter name="cond" transfer-ownership="none">
2388824094 <doc xml:space="preserve"
2388924095 filename="glib/gmain.c"
23890- line="3621">a condition variable</doc>
24096+ line="3790">a condition variable</doc>
2389124097 <type name="Cond" c:type="GCond*"/>
2389224098 </parameter>
2389324099 <parameter name="mutex" transfer-ownership="none">
2389424100 <doc xml:space="preserve"
2389524101 filename="glib/gmain.c"
23896- line="3622">a mutex, currently held</doc>
24102+ line="3791">a mutex, currently held</doc>
2389724103 <type name="Mutex" c:type="GMutex*"/>
2389824104 </parameter>
2389924105 </parameters>
@@ -23901,10 +24107,13 @@ try again (once) to become the owner.</doc>
2390124107 <method name="wakeup" c:identifier="g_main_context_wakeup">
2390224108 <doc xml:space="preserve"
2390324109 filename="glib/gmain.c"
23904- line="4958">If @context is currently blocking in [method@GLib.MainContext.iteration]
23905-waiting for a source to become ready, cause it to stop blocking
23906-and return. Otherwise, cause the next invocation of
23907-[method@GLib.MainContext.iteration] to return without blocking.
24110+ line="5141">Wake up @context if it’s currently blocking in
24111+[method@GLib.MainContext.iteration], causing it to stop blocking.
24112+
24113+The @context could be blocking waiting for a source to become ready.
24114+Otherwise, if @context is not currently blocking, this function causes the
24115+next invocation of [method@GLib.MainContext.iteration] to return without
24116+blocking.
2390824117
2390924118 This API is useful for low-level control over [struct@GLib.MainContext]; for
2391024119 example, integrating it with main loop implementations such as
@@ -23913,23 +24122,23 @@ example, integrating it with main loop implementations such as
2391324122 Another related use for this function is when implementing a main
2391424123 loop with a termination condition, computed from multiple threads:
2391524124
23916-|[&lt;!-- language="C" --&gt;
24125+```c
2391724126 #define NUM_TASKS 10
2391824127 static gint tasks_remaining = NUM_TASKS; // (atomic)
2391924128 ...
2392024129
2392124130 while (g_atomic_int_get (&amp;tasks_remaining) != 0)
2392224131 g_main_context_iteration (NULL, TRUE);
23923-]|
24132+```
2392424133
2392524134 Then in a thread:
23926-|[&lt;!-- language="C" --&gt;
23927- perform_work();
24135+```c
24136+ perform_work ();
2392824137
2392924138 if (g_atomic_int_dec_and_test (&amp;tasks_remaining))
2393024139 g_main_context_wakeup (NULL);
23931-]|</doc>
23932- <source-position filename="glib/gmain.h" line="521"/>
24140+```</doc>
24141+ <source-position filename="glib/gmain.h" line="522"/>
2393324142 <return-value transfer-ownership="none">
2393424143 <type name="none" c:type="void"/>
2393524144 </return-value>
@@ -23940,7 +24149,7 @@ Then in a thread:
2394024149 allow-none="1">
2394124150 <doc xml:space="preserve"
2394224151 filename="glib/gmain.c"
23943- line="4960">a #GMainContext (if %NULL, the global-default
24152+ line="5143">a main context (if `NULL`, the global-default
2394424153 main context will be used)</doc>
2394524154 <type name="MainContext" c:type="GMainContext*"/>
2394624155 </instance-parameter>
@@ -23949,15 +24158,17 @@ Then in a thread:
2394924158 <function name="default" c:identifier="g_main_context_default">
2395024159 <doc xml:space="preserve"
2395124160 filename="glib/gmain.c"
23952- line="687">Returns the global-default main context. This is the main context
24161+ line="725">Returns the global-default main context.
24162+
24163+This is the main context
2395324164 used for main loop functions when a main loop is not explicitly
23954-specified, and corresponds to the "main" main loop. See also
24165+specified, and corresponds to the ‘main’ main loop. See also
2395524166 [func@GLib.MainContext.get_thread_default].</doc>
23956- <source-position filename="glib/gmain.h" line="497"/>
24167+ <source-position filename="glib/gmain.h" line="498"/>
2395724168 <return-value transfer-ownership="none">
2395824169 <doc xml:space="preserve"
2395924170 filename="glib/gmain.c"
23960- line="695">the global-default main context.</doc>
24171+ line="735">the global-default main context.</doc>
2396124172 <type name="MainContext" c:type="GMainContext*"/>
2396224173 </return-value>
2396324174 </function>
@@ -23966,23 +24177,24 @@ specified, and corresponds to the "main" main loop. See also
2396624177 version="2.22">
2396724178 <doc xml:space="preserve"
2396824179 filename="glib/gmain.c"
23969- line="846">Gets the thread-default #GMainContext for this thread. Asynchronous
23970-operations that want to be able to be run in contexts other than
24180+ line="886">Gets the thread-default main context for this thread.
24181+
24182+Asynchronous operations that want to be able to be run in contexts other than
2397124183 the default one should call this method or
2397224184 [func@GLib.MainContext.ref_thread_default] to get a
2397324185 [struct@GLib.MainContext] to add their [struct@GLib.Source]s to. (Note that
2397424186 even in single-threaded programs applications may sometimes want to
2397524187 temporarily push a non-default context, so it is not safe to assume that
23976-this will always return %NULL if you are running in the default thread.)
24188+this will always return `NULL` if you are running in the default thread.)
2397724189
2397824190 If you need to hold a reference on the context, use
2397924191 [func@GLib.MainContext.ref_thread_default] instead.</doc>
23980- <source-position filename="glib/gmain.h" line="578"/>
24192+ <source-position filename="glib/gmain.h" line="579"/>
2398124193 <return-value transfer-ownership="none" nullable="1">
2398224194 <doc xml:space="preserve"
2398324195 filename="glib/gmain.c"
23984- line="861">the thread-default #GMainContext, or
23985-%NULL if the thread-default context is the global-default main context.</doc>
24196+ line="902">the thread-default main context, or
24197+ `NULL` if the thread-default context is the global-default main context</doc>
2398624198 <type name="MainContext" c:type="GMainContext*"/>
2398724199 </return-value>
2398824200 </function>
@@ -23992,12 +24204,12 @@ If you need to hold a reference on the context, use
2399224204 introspectable="0">
2399324205 <doc xml:space="preserve"
2399424206 filename="glib/gmain.h"
23995- line="649">Pop @pusher’s main context as the thread default main context.
24207+ line="650">Pop @pusher’s main context as the thread default main context.
2399624208 See g_main_context_pusher_new() for details.
2399724209
2399824210 This will pop the [struct@GLib.MainContext] as the current thread-default
2399924211 main context, but will not call [method@GLib.MainContext.unref] on it.</doc>
24000- <source-position filename="glib/gmain.h" line="663"/>
24212+ <source-position filename="glib/gmain.h" line="664"/>
2400124213 <return-value transfer-ownership="none">
2400224214 <type name="none" c:type="void"/>
2400324215 </return-value>
@@ -24005,7 +24217,7 @@ main context, but will not call [method@GLib.MainContext.unref] on it.</doc>
2400524217 <parameter name="pusher" transfer-ownership="full">
2400624218 <doc xml:space="preserve"
2400724219 filename="glib/gmain.h"
24008- line="651">a #GMainContextPusher</doc>
24220+ line="652">a #GMainContextPusher</doc>
2400924221 <type name="MainContextPusher" c:type="GMainContextPusher*"/>
2401024222 </parameter>
2401124223 </parameters>
@@ -24015,19 +24227,21 @@ main context, but will not call [method@GLib.MainContext.unref] on it.</doc>
2401524227 version="2.32">
2401624228 <doc xml:space="preserve"
2401724229 filename="glib/gmain.c"
24018- line="878">Gets the thread-default [struct@GLib.MainContext] for this thread, as with
24019-[func@GLib.MainContext.get_thread_default], but also adds a reference to
24020-it with [method@GLib.MainContext.ref]. In addition, unlike
24230+ line="918">Gets a reference to the thread-default [struct@GLib.MainContext] for this
24231+thread
24232+
24233+This is the same as [func@GLib.MainContext.get_thread_default], but it also
24234+adds a reference to the returned main context with [method@GLib.MainContext.ref].
24235+In addition, unlike
2402124236 [func@GLib.MainContext.get_thread_default], if the thread-default context
2402224237 is the global-default context, this will return that
2402324238 [struct@GLib.MainContext] (with a ref added to it) rather than returning
24024-%NULL.</doc>
24025- <source-position filename="glib/gmain.h" line="580"/>
24239+`NULL`.</doc>
24240+ <source-position filename="glib/gmain.h" line="581"/>
2402624241 <return-value transfer-ownership="full">
2402724242 <doc xml:space="preserve"
2402824243 filename="glib/gmain.c"
24029- line="889">the thread-default #GMainContext. Unref
24030- with [method@GLib.MainContext.unref] when you are done with it.</doc>
24244+ line="932">the thread-default main context</doc>
2403124245 <type name="MainContext" c:type="GMainContext*"/>
2403224246 </return-value>
2403324247 </function>
@@ -24070,12 +24284,12 @@ representing the main event loop of a GLib or GTK application.</doc>
2407024284 <constructor name="new" c:identifier="g_main_loop_new">
2407124285 <doc xml:space="preserve"
2407224286 filename="glib/gmain.c"
24073- line="4385">Creates a new [struct@GLib.MainLoop] structure.</doc>
24074- <source-position filename="glib/gmain.h" line="676"/>
24287+ line="4562">Creates a new [struct@GLib.MainLoop] structure.</doc>
24288+ <source-position filename="glib/gmain.h" line="677"/>
2407524289 <return-value transfer-ownership="full">
2407624290 <doc xml:space="preserve"
2407724291 filename="glib/gmain.c"
24078- line="4395">a new #GMainLoop.</doc>
24292+ line="4572">a new main loop</doc>
2407924293 <type name="MainLoop" c:type="GMainLoop*"/>
2408024294 </return-value>
2408124295 <parameters>
@@ -24085,16 +24299,16 @@ representing the main event loop of a GLib or GTK application.</doc>
2408524299 allow-none="1">
2408624300 <doc xml:space="preserve"
2408724301 filename="glib/gmain.c"
24088- line="4387">a #GMainContext (if %NULL, the global-default
24302+ line="4564">a main context (if `NULL`, the global-default
2408924303 main context will be used).</doc>
2409024304 <type name="MainContext" c:type="GMainContext*"/>
2409124305 </parameter>
2409224306 <parameter name="is_running" transfer-ownership="none">
2409324307 <doc xml:space="preserve"
2409424308 filename="glib/gmain.c"
24095- line="4389">set to %TRUE to indicate that the loop is running. This
24096-is not very important since calling [method@GLib.MainLoop.run] will set this
24097-to %TRUE anyway.</doc>
24309+ line="4566">set to true to indicate that the loop is running. This
24310+ is not very important since calling [method@GLib.MainLoop.run] will set this
24311+ to true anyway.</doc>
2409824312 <type name="gboolean" c:type="gboolean"/>
2409924313 </parameter>
2410024314 </parameters>
@@ -24102,19 +24316,19 @@ to %TRUE anyway.</doc>
2410224316 <method name="get_context" c:identifier="g_main_loop_get_context">
2410324317 <doc xml:space="preserve"
2410424318 filename="glib/gmain.c"
24105- line="4570">Returns the [struct@GLib.MainContext] of @loop.</doc>
24106- <source-position filename="glib/gmain.h" line="689"/>
24319+ line="4749">Returns the [struct@GLib.MainContext] of @loop.</doc>
24320+ <source-position filename="glib/gmain.h" line="690"/>
2410724321 <return-value transfer-ownership="none">
2410824322 <doc xml:space="preserve"
2410924323 filename="glib/gmain.c"
24110- line="4576">the [struct@GLib.MainContext] of @loop</doc>
24324+ line="4755">the [struct@GLib.MainContext] of @loop</doc>
2411124325 <type name="MainContext" c:type="GMainContext*"/>
2411224326 </return-value>
2411324327 <parameters>
2411424328 <instance-parameter name="loop" transfer-ownership="none">
2411524329 <doc xml:space="preserve"
2411624330 filename="glib/gmain.c"
24117- line="4572">a #GMainLoop.</doc>
24331+ line="4751">a main loop</doc>
2411824332 <type name="MainLoop" c:type="GMainLoop*"/>
2411924333 </instance-parameter>
2412024334 </parameters>
@@ -24122,20 +24336,20 @@ to %TRUE anyway.</doc>
2412224336 <method name="is_running" c:identifier="g_main_loop_is_running">
2412324337 <doc xml:space="preserve"
2412424338 filename="glib/gmain.c"
24125- line="4552">Checks to see if the main loop is currently being run via
24339+ line="4731">Checks to see if the main loop is currently being run via
2412624340 [method@GLib.MainLoop.run].</doc>
24127- <source-position filename="glib/gmain.h" line="687"/>
24341+ <source-position filename="glib/gmain.h" line="688"/>
2412824342 <return-value transfer-ownership="none">
2412924343 <doc xml:space="preserve"
2413024344 filename="glib/gmain.c"
24131- line="4559">%TRUE if the mainloop is currently being run.</doc>
24345+ line="4738">true if the main loop is currently being run, false otherwise</doc>
2413224346 <type name="gboolean" c:type="gboolean"/>
2413324347 </return-value>
2413424348 <parameters>
2413524349 <instance-parameter name="loop" transfer-ownership="none">
2413624350 <doc xml:space="preserve"
2413724351 filename="glib/gmain.c"
24138- line="4554">a #GMainLoop.</doc>
24352+ line="4733">a main loop</doc>
2413924353 <type name="MainLoop" c:type="GMainLoop*"/>
2414024354 </instance-parameter>
2414124355 </parameters>
@@ -24143,12 +24357,12 @@ to %TRUE anyway.</doc>
2414324357 <method name="quit" c:identifier="g_main_loop_quit">
2414424358 <doc xml:space="preserve"
2414524359 filename="glib/gmain.c"
24146- line="4525">Stops a [struct@GLib.MainLoop] from running. Any calls to
24360+ line="4704">Stops a [struct@GLib.MainLoop] from running. Any calls to
2414724361 [method@GLib.MainLoop.run] for the loop will return.
2414824362
2414924363 Note that sources that have already been dispatched when
2415024364 [method@GLib.MainLoop.quit] is called will still be executed.</doc>
24151- <source-position filename="glib/gmain.h" line="681"/>
24365+ <source-position filename="glib/gmain.h" line="682"/>
2415224366 <return-value transfer-ownership="none">
2415324367 <type name="none" c:type="void"/>
2415424368 </return-value>
@@ -24156,7 +24370,7 @@ Note that sources that have already been dispatched when
2415624370 <instance-parameter name="loop" transfer-ownership="none">
2415724371 <doc xml:space="preserve"
2415824372 filename="glib/gmain.c"
24159- line="4527">a #GMainLoop</doc>
24373+ line="4706">a main loop</doc>
2416024374 <type name="MainLoop" c:type="GMainLoop*"/>
2416124375 </instance-parameter>
2416224376 </parameters>
@@ -24164,19 +24378,19 @@ Note that sources that have already been dispatched when
2416424378 <method name="ref" c:identifier="g_main_loop_ref">
2416524379 <doc xml:space="preserve"
2416624380 filename="glib/gmain.c"
24167- line="4418">Increases the reference count on a [struct@GLib.MainLoop] object by one.</doc>
24168- <source-position filename="glib/gmain.h" line="683"/>
24381+ line="4595">Increases the reference count on a [struct@GLib.MainLoop] object by one.</doc>
24382+ <source-position filename="glib/gmain.h" line="684"/>
2416924383 <return-value transfer-ownership="full">
2417024384 <doc xml:space="preserve"
2417124385 filename="glib/gmain.c"
24172- line="4424">@loop</doc>
24386+ line="4601">@loop</doc>
2417324387 <type name="MainLoop" c:type="GMainLoop*"/>
2417424388 </return-value>
2417524389 <parameters>
2417624390 <instance-parameter name="loop" transfer-ownership="none">
2417724391 <doc xml:space="preserve"
2417824392 filename="glib/gmain.c"
24179- line="4420">a #GMainLoop</doc>
24393+ line="4597">a main loop</doc>
2418024394 <type name="MainLoop" c:type="GMainLoop*"/>
2418124395 </instance-parameter>
2418224396 </parameters>
@@ -24184,11 +24398,12 @@ Note that sources that have already been dispatched when
2418424398 <method name="run" c:identifier="g_main_loop_run">
2418524399 <doc xml:space="preserve"
2418624400 filename="glib/gmain.c"
24187- line="4457">Runs a main loop until [method@GLib.MainLoop.quit] is called on the loop.
24188-If this is called for the thread of the loop's #GMainContext,
24401+ line="4635">Runs a main loop until [method@GLib.MainLoop.quit] is called on the loop.
24402+
24403+If this is called from the thread of the loop’s [struct@GLib.MainContext],
2418924404 it will process events from the loop, otherwise it will
2419024405 simply wait.</doc>
24191- <source-position filename="glib/gmain.h" line="679"/>
24406+ <source-position filename="glib/gmain.h" line="680"/>
2419224407 <return-value transfer-ownership="none">
2419324408 <type name="none" c:type="void"/>
2419424409 </return-value>
@@ -24196,7 +24411,7 @@ simply wait.</doc>
2419624411 <instance-parameter name="loop" transfer-ownership="none">
2419724412 <doc xml:space="preserve"
2419824413 filename="glib/gmain.c"
24199- line="4459">a #GMainLoop</doc>
24414+ line="4637">a main loop</doc>
2420024415 <type name="MainLoop" c:type="GMainLoop*"/>
2420124416 </instance-parameter>
2420224417 </parameters>
@@ -24204,9 +24419,10 @@ simply wait.</doc>
2420424419 <method name="unref" c:identifier="g_main_loop_unref">
2420524420 <doc xml:space="preserve"
2420624421 filename="glib/gmain.c"
24207- line="4437">Decreases the reference count on a [struct@GLib.MainLoop] object by one. If
24208-the result is zero, free the loop and free all associated memory.</doc>
24209- <source-position filename="glib/gmain.h" line="685"/>
24422+ line="4614">Decreases the reference count on a [struct@GLib.MainLoop] object by one.
24423+
24424+If the result is zero, the loop and all associated memory are freed.</doc>
24425+ <source-position filename="glib/gmain.h" line="686"/>
2421024426 <return-value transfer-ownership="none">
2421124427 <type name="none" c:type="void"/>
2421224428 </return-value>
@@ -24214,7 +24430,7 @@ the result is zero, free the loop and free all associated memory.</doc>
2421424430 <instance-parameter name="loop" transfer-ownership="none">
2421524431 <doc xml:space="preserve"
2421624432 filename="glib/gmain.c"
24217- line="4439">a #GMainLoop</doc>
24433+ line="4616">a main loop</doc>
2421824434 <type name="MainLoop" c:type="GMainLoop*"/>
2421924435 </instance-parameter>
2422024436 </parameters>
@@ -24238,7 +24454,7 @@ not be accessed directly.</doc>
2423824454 throws="1">
2423924455 <doc xml:space="preserve"
2424024456 filename="glib/gmappedfile.c"
24241- line="219">Maps a file into memory. On UNIX, this is using the mmap() function.
24457+ line="225">Maps a file into memory. On UNIX, this is using the mmap() function.
2424224458
2424324459 If @writable is %TRUE, the mapped buffer may be modified, otherwise
2424424460 it is an error to modify the mapped buffer. Modifications to the buffer
@@ -24258,7 +24474,7 @@ to the #GFileError value %G_FILE_ERROR_INVAL.</doc>
2425824474 <return-value transfer-ownership="full">
2425924475 <doc xml:space="preserve"
2426024476 filename="glib/gmappedfile.c"
24261- line="243">a newly allocated #GMappedFile which must be unref'd
24477+ line="249">a newly allocated #GMappedFile which must be unref'd
2426224478 with g_mapped_file_unref(), or %NULL if the mapping failed.</doc>
2426324479 <type name="MappedFile" c:type="GMappedFile*"/>
2426424480 </return-value>
@@ -24266,14 +24482,14 @@ to the #GFileError value %G_FILE_ERROR_INVAL.</doc>
2426624482 <parameter name="filename" transfer-ownership="none">
2426724483 <doc xml:space="preserve"
2426824484 filename="glib/gmappedfile.c"
24269- line="221">The path of the file to load, in the GLib
24485+ line="227">The path of the file to load, in the GLib
2427024486 filename encoding</doc>
2427124487 <type name="filename" c:type="const gchar*"/>
2427224488 </parameter>
2427324489 <parameter name="writable" transfer-ownership="none">
2427424490 <doc xml:space="preserve"
2427524491 filename="glib/gmappedfile.c"
24276- line="223">whether the mapping should be writable</doc>
24492+ line="229">whether the mapping should be writable</doc>
2427724493 <type name="gboolean" c:type="gboolean"/>
2427824494 </parameter>
2427924495 </parameters>
@@ -24284,7 +24500,7 @@ to the #GFileError value %G_FILE_ERROR_INVAL.</doc>
2428424500 throws="1">
2428524501 <doc xml:space="preserve"
2428624502 filename="glib/gmappedfile.c"
24287- line="283">Maps a file into memory. On UNIX, this is using the mmap() function.
24503+ line="293">Maps a file into memory. On UNIX, this is using the mmap() function.
2428824504
2428924505 If @writable is %TRUE, the mapped buffer may be modified, otherwise
2429024506 it is an error to modify the mapped buffer. Modifications to the buffer
@@ -24299,7 +24515,7 @@ atomically (e.g. using g_file_set_contents()).</doc>
2429924515 <return-value transfer-ownership="full">
2430024516 <doc xml:space="preserve"
2430124517 filename="glib/gmappedfile.c"
24302- line="301">a newly allocated #GMappedFile which must be unref'd
24518+ line="311">a newly allocated #GMappedFile which must be unref'd
2430324519 with g_mapped_file_unref(), or %NULL if the mapping failed.</doc>
2430424520 <type name="MappedFile" c:type="GMappedFile*"/>
2430524521 </return-value>
@@ -24307,13 +24523,13 @@ atomically (e.g. using g_file_set_contents()).</doc>
2430724523 <parameter name="fd" transfer-ownership="none">
2430824524 <doc xml:space="preserve"
2430924525 filename="glib/gmappedfile.c"
24310- line="285">The file descriptor of the file to load</doc>
24526+ line="295">The file descriptor of the file to load</doc>
2431124527 <type name="gint" c:type="gint"/>
2431224528 </parameter>
2431324529 <parameter name="writable" transfer-ownership="none">
2431424530 <doc xml:space="preserve"
2431524531 filename="glib/gmappedfile.c"
24316- line="286">whether the mapping should be writable</doc>
24532+ line="296">whether the mapping should be writable</doc>
2431724533 <type name="gboolean" c:type="gboolean"/>
2431824534 </parameter>
2431924535 </parameters>
@@ -24325,7 +24541,7 @@ atomically (e.g. using g_file_set_contents()).</doc>
2432524541 deprecated-version="2.22">
2432624542 <doc xml:space="preserve"
2432724543 filename="glib/gmappedfile.c"
24328- line="355">This call existed before #GMappedFile had refcounting and is currently
24544+ line="365">This call existed before #GMappedFile had refcounting and is currently
2432924545 exactly the same as g_mapped_file_unref().</doc>
2433024546 <doc-deprecated xml:space="preserve">Use g_mapped_file_unref() instead.</doc-deprecated>
2433124547 <source-position filename="glib/gmappedfile.h" line="56"/>
@@ -24336,7 +24552,7 @@ exactly the same as g_mapped_file_unref().</doc>
2433624552 <instance-parameter name="file" transfer-ownership="none">
2433724553 <doc xml:space="preserve"
2433824554 filename="glib/gmappedfile.c"
24339- line="357">a #GMappedFile</doc>
24555+ line="367">a #GMappedFile</doc>
2434024556 <type name="MappedFile" c:type="GMappedFile*"/>
2434124557 </instance-parameter>
2434224558 </parameters>
@@ -24346,14 +24562,14 @@ exactly the same as g_mapped_file_unref().</doc>
2434624562 version="2.34">
2434724563 <doc xml:space="preserve"
2434824564 filename="glib/gmappedfile.c"
24349- line="412">Creates a new #GBytes which references the data mapped from @file.
24565+ line="422">Creates a new #GBytes which references the data mapped from @file.
2435024566 The mapped contents of the file must not be modified after creating this
2435124567 bytes object, because a #GBytes should be immutable.</doc>
2435224568 <source-position filename="glib/gmappedfile.h" line="49"/>
2435324569 <return-value transfer-ownership="full">
2435424570 <doc xml:space="preserve"
2435524571 filename="glib/gmappedfile.c"
24356- line="420">A newly allocated #GBytes referencing data
24572+ line="430">A newly allocated #GBytes referencing data
2435724573 from @file</doc>
2435824574 <type name="Bytes" c:type="GBytes*"/>
2435924575 </return-value>
@@ -24361,7 +24577,7 @@ bytes object, because a #GBytes should be immutable.</doc>
2436124577 <instance-parameter name="file" transfer-ownership="none">
2436224578 <doc xml:space="preserve"
2436324579 filename="glib/gmappedfile.c"
24364- line="414">a #GMappedFile</doc>
24580+ line="424">a #GMappedFile</doc>
2436524581 <type name="MappedFile" c:type="GMappedFile*"/>
2436624582 </instance-parameter>
2436724583 </parameters>
@@ -24371,7 +24587,7 @@ bytes object, because a #GBytes should be immutable.</doc>
2437124587 version="2.8">
2437224588 <doc xml:space="preserve"
2437324589 filename="glib/gmappedfile.c"
24374- line="332">Returns the contents of a #GMappedFile.
24590+ line="342">Returns the contents of a #GMappedFile.
2437524591
2437624592 Note that the contents may not be zero-terminated,
2437724593 even if the #GMappedFile is backed by a text file.
@@ -24381,14 +24597,14 @@ If the file is empty then %NULL is returned.</doc>
2438124597 <return-value transfer-ownership="none" nullable="1">
2438224598 <doc xml:space="preserve"
2438324599 filename="glib/gmappedfile.c"
24384- line="343">the contents of @file, or %NULL.</doc>
24600+ line="353">the contents of @file, or %NULL.</doc>
2438524601 <type name="utf8" c:type="gchar*"/>
2438624602 </return-value>
2438724603 <parameters>
2438824604 <instance-parameter name="file" transfer-ownership="none">
2438924605 <doc xml:space="preserve"
2439024606 filename="glib/gmappedfile.c"
24391- line="334">a #GMappedFile</doc>
24607+ line="344">a #GMappedFile</doc>
2439224608 <type name="MappedFile" c:type="GMappedFile*"/>
2439324609 </instance-parameter>
2439424610 </parameters>
@@ -24398,19 +24614,19 @@ If the file is empty then %NULL is returned.</doc>
2439824614 version="2.8">
2439924615 <doc xml:space="preserve"
2440024616 filename="glib/gmappedfile.c"
24401- line="314">Returns the length of the contents of a #GMappedFile.</doc>
24617+ line="324">Returns the length of the contents of a #GMappedFile.</doc>
2440224618 <source-position filename="glib/gmappedfile.h" line="45"/>
2440324619 <return-value transfer-ownership="none">
2440424620 <doc xml:space="preserve"
2440524621 filename="glib/gmappedfile.c"
24406- line="320">the length of the contents of @file.</doc>
24622+ line="330">the length of the contents of @file.</doc>
2440724623 <type name="gsize" c:type="gsize"/>
2440824624 </return-value>
2440924625 <parameters>
2441024626 <instance-parameter name="file" transfer-ownership="none">
2441124627 <doc xml:space="preserve"
2441224628 filename="glib/gmappedfile.c"
24413- line="316">a #GMappedFile</doc>
24629+ line="326">a #GMappedFile</doc>
2441424630 <type name="MappedFile" c:type="GMappedFile*"/>
2441524631 </instance-parameter>
2441624632 </parameters>
@@ -24418,20 +24634,20 @@ If the file is empty then %NULL is returned.</doc>
2441824634 <method name="ref" c:identifier="g_mapped_file_ref" version="2.22">
2441924635 <doc xml:space="preserve"
2442024636 filename="glib/gmappedfile.c"
24421- line="371">Increments the reference count of @file by one. It is safe to call
24637+ line="381">Increments the reference count of @file by one. It is safe to call
2442224638 this function from any thread.</doc>
2442324639 <source-position filename="glib/gmappedfile.h" line="51"/>
2442424640 <return-value transfer-ownership="full">
2442524641 <doc xml:space="preserve"
2442624642 filename="glib/gmappedfile.c"
24427- line="378">the passed in #GMappedFile.</doc>
24643+ line="388">the passed in #GMappedFile.</doc>
2442824644 <type name="MappedFile" c:type="GMappedFile*"/>
2442924645 </return-value>
2443024646 <parameters>
2443124647 <instance-parameter name="file" transfer-ownership="none">
2443224648 <doc xml:space="preserve"
2443324649 filename="glib/gmappedfile.c"
24434- line="373">a #GMappedFile</doc>
24650+ line="383">a #GMappedFile</doc>
2443524651 <type name="MappedFile" c:type="GMappedFile*"/>
2443624652 </instance-parameter>
2443724653 </parameters>
@@ -24439,7 +24655,7 @@ this function from any thread.</doc>
2443924655 <method name="unref" c:identifier="g_mapped_file_unref">
2444024656 <doc xml:space="preserve"
2444124657 filename="glib/gmappedfile.c"
24442- line="392">Decrements the reference count of @file by one. If the reference count
24658+ line="402">Decrements the reference count of @file by one. If the reference count
2444324659 drops to 0, unmaps the buffer of @file and frees it.
2444424660
2444524661 It is safe to call this function from any thread.
@@ -24453,7 +24669,7 @@ Since 2.22</doc>
2445324669 <instance-parameter name="file" transfer-ownership="none">
2445424670 <doc xml:space="preserve"
2445524671 filename="glib/gmappedfile.c"
24456- line="394">a #GMappedFile</doc>
24672+ line="404">a #GMappedFile</doc>
2445724673 <type name="MappedFile" c:type="GMappedFile*"/>
2445824674 </instance-parameter>
2445924675 </parameters>
@@ -24468,7 +24684,7 @@ bitwise OR the type with the flag %G_MARKUP_COLLECT_OPTIONAL.
2446824684
2446924685 It is likely that this enum will be extended in the future to
2447024686 support other types.</doc>
24471- <source-position filename="glib/gmarkup.h" line="250"/>
24687+ <source-position filename="glib/gmarkup.h" line="254"/>
2447224688 <member name="invalid" value="0" c:identifier="G_MARKUP_COLLECT_INVALID">
2447324689 <doc xml:space="preserve"
2447424690 filename="glib/gmarkup.c"
@@ -24596,7 +24812,7 @@ marked-up documents. You can feed any number of documents into
2459624812 a context, as long as no errors occur; once an error occurs,
2459724813 the parse context can't continue to parse text (you have to
2459824814 free it and create a new parse context).</doc>
24599- <source-position filename="glib/gmarkup.h" line="191"/>
24815+ <source-position filename="glib/gmarkup.h" line="195"/>
2460024816 <return-value transfer-ownership="full">
2460124817 <doc xml:space="preserve"
2460224818 filename="glib/gmarkup.c"
@@ -24646,7 +24862,7 @@ fed into the parse context with g_markup_parse_context_parse().
2464624862
2464724863 This function reports an error if the document isn't complete,
2464824864 for example if elements are still open.</doc>
24649- <source-position filename="glib/gmarkup.h" line="214"/>
24865+ <source-position filename="glib/gmarkup.h" line="218"/>
2465024866 <return-value transfer-ownership="none">
2465124867 <doc xml:space="preserve"
2465224868 filename="glib/gmarkup.c"
@@ -24669,7 +24885,7 @@ for example if elements are still open.</doc>
2466924885
2467024886 This function can't be called from inside one of the
2467124887 #GMarkupParser functions or while a subparser is pushed.</doc>
24672- <source-position filename="glib/gmarkup.h" line="200"/>
24888+ <source-position filename="glib/gmarkup.h" line="204"/>
2467324889 <return-value transfer-ownership="none">
2467424890 <type name="none" c:type="void"/>
2467524891 </return-value>
@@ -24692,7 +24908,7 @@ This function can't be called from inside one of the
2469224908 If called from the start_element or end_element handlers this will
2469324909 give the element_name as passed to those functions. For the parent
2469424910 elements, see g_markup_parse_context_get_element_stack().</doc>
24695- <source-position filename="glib/gmarkup.h" line="217"/>
24911+ <source-position filename="glib/gmarkup.h" line="221"/>
2469624912 <return-value transfer-ownership="none">
2469724913 <doc xml:space="preserve"
2469824914 filename="glib/gmarkup.c"
@@ -24724,7 +24940,7 @@ This function is intended to be used in the start_element and
2472424940 end_element handlers where g_markup_parse_context_get_element()
2472524941 would merely return the name of the element that is being
2472624942 processed.</doc>
24727- <source-position filename="glib/gmarkup.h" line="219"/>
24943+ <source-position filename="glib/gmarkup.h" line="223"/>
2472824944 <return-value transfer-ownership="none">
2472924945 <doc xml:space="preserve"
2473024946 filename="glib/gmarkup.c"
@@ -24750,7 +24966,7 @@ processed.</doc>
2475024966 that line. Intended for use in error messages; there are no strict
2475124967 semantics for what constitutes the "current" line number other than
2475224968 "the best number we could come up with for error messages."</doc>
24753- <source-position filename="glib/gmarkup.h" line="223"/>
24969+ <source-position filename="glib/gmarkup.h" line="227"/>
2475424970 <return-value transfer-ownership="none">
2475524971 <type name="none" c:type="void"/>
2475624972 </return-value>
@@ -24795,7 +25011,7 @@ semantics for what constitutes the "current" line number other than
2479525011 This will either be the user_data that was provided to
2479625012 g_markup_parse_context_new() or to the most recent call
2479725013 of g_markup_parse_context_push().</doc>
24798- <source-position filename="glib/gmarkup.h" line="227"/>
25014+ <source-position filename="glib/gmarkup.h" line="231"/>
2479925015 <return-value transfer-ownership="none" nullable="1">
2480025016 <doc xml:space="preserve"
2480125017 filename="glib/gmarkup.c"
@@ -24828,7 +25044,7 @@ connection or file, you feed each received chunk of data into this
2482825044 function, aborting the process if an error occurs. Once an error
2482925045 is reported, no further data may be fed to the #GMarkupParseContext;
2483025046 all errors are fatal.</doc>
24831- <source-position filename="glib/gmarkup.h" line="202"/>
25047+ <source-position filename="glib/gmarkup.h" line="206"/>
2483225048 <return-value transfer-ownership="none">
2483325049 <doc xml:space="preserve"
2483425050 filename="glib/gmarkup.c"
@@ -24874,7 +25090,7 @@ This function is not intended to be directly called by users
2487425090 interested in invoking subparsers. Instead, it is intended to
2487525091 be used by the subparsers themselves to implement a higher-level
2487625092 interface.</doc>
24877- <source-position filename="glib/gmarkup.h" line="211"/>
25093+ <source-position filename="glib/gmarkup.h" line="215"/>
2487825094 <return-value transfer-ownership="none" nullable="1">
2487925095 <doc xml:space="preserve"
2488025096 filename="glib/gmarkup.c"
@@ -25009,7 +25225,7 @@ static void end_element (context, element_name, ...)
2500925225 // else, handle other tags...
2501025226 }
2501125227 ]|</doc>
25012- <source-position filename="glib/gmarkup.h" line="207"/>
25228+ <source-position filename="glib/gmarkup.h" line="211"/>
2501325229 <return-value transfer-ownership="none">
2501425230 <type name="none" c:type="void"/>
2501525231 </return-value>
@@ -25043,7 +25259,7 @@ static void end_element (context, element_name, ...)
2504325259 <doc xml:space="preserve"
2504425260 filename="glib/gmarkup.c"
2504525261 line="220">Increases the reference count of @context.</doc>
25046- <source-position filename="glib/gmarkup.h" line="196"/>
25262+ <source-position filename="glib/gmarkup.h" line="200"/>
2504725263 <return-value transfer-ownership="full">
2504825264 <doc xml:space="preserve"
2504925265 filename="glib/gmarkup.c"
@@ -25066,7 +25282,7 @@ static void end_element (context, element_name, ...)
2506625282 filename="glib/gmarkup.c"
2506725283 line="241">Decreases the reference count of @context. When its reference count
2506825284 drops to 0, it is freed.</doc>
25069- <source-position filename="glib/gmarkup.h" line="198"/>
25285+ <source-position filename="glib/gmarkup.h" line="202"/>
2507025286 <return-value transfer-ownership="none">
2507125287 <type name="none" c:type="void"/>
2507225288 </return-value>
@@ -25141,8 +25357,12 @@ can set an error; in particular the %G_MARKUP_ERROR_UNKNOWN_ELEMENT,
2514125357 %G_MARKUP_ERROR_UNKNOWN_ATTRIBUTE, and %G_MARKUP_ERROR_INVALID_CONTENT
2514225358 errors are intended to be set from these callbacks. If you set an error
2514325359 from a callback, g_markup_parse_context_parse() will report that error
25144-back to its caller.</doc>
25145- <source-position filename="glib/gmarkup.h" line="188"/>
25360+back to its caller.
25361+
25362+Refer to the [GMarkup](../glib/markup.html) documentation to understand
25363+the scope and limitations of `GMarkupParser`. In particular, it is not a
25364+full XML parser and it must not be used to process untrusted data.</doc>
25365+ <source-position filename="glib/gmarkup.h" line="192"/>
2514625366 <field name="start_element">
2514725367 <doc xml:space="preserve"
2514825368 filename="glib/gmarkup.h"
@@ -25150,7 +25370,7 @@ back to its caller.</doc>
2515025370 is seen. The callback's @attribute_names and @attribute_values parameters
2515125371 are %NULL-terminated.</doc>
2515225372 <callback name="start_element" throws="1">
25153- <source-position filename="glib/gmarkup.h" line="150"/>
25373+ <source-position filename="glib/gmarkup.h" line="154"/>
2515425374 <return-value transfer-ownership="none">
2515525375 <type name="none" c:type="void"/>
2515625376 </return-value>
@@ -25184,7 +25404,7 @@ back to its caller.</doc>
2518425404 is seen. Note that this is also called for empty tags like
2518525405 `&lt;empty/&gt;`.</doc>
2518625406 <callback name="end_element" throws="1">
25187- <source-position filename="glib/gmarkup.h" line="158"/>
25407+ <source-position filename="glib/gmarkup.h" line="162"/>
2518825408 <return-value transfer-ownership="none">
2518925409 <type name="none" c:type="void"/>
2519025410 </return-value>
@@ -25214,7 +25434,7 @@ back to its caller.</doc>
2521425434 %G_MARKUP_TREAT_CDATA_AS_TEXT flag is set, this function is also
2521525435 called for the content of CDATA marked sections.</doc>
2521625436 <callback name="text" throws="1">
25217- <source-position filename="glib/gmarkup.h" line="165"/>
25437+ <source-position filename="glib/gmarkup.h" line="169"/>
2521825438 <return-value transfer-ownership="none">
2521925439 <type name="none" c:type="void"/>
2522025440 </return-value>
@@ -25247,7 +25467,7 @@ back to its caller.</doc>
2524725467 %G_MARKUP_TREAT_CDATA_AS_TEXT flag is not set, this function is also
2524825468 called for CDATA marked sections.</doc>
2524925469 <callback name="passthrough" throws="1">
25250- <source-position filename="glib/gmarkup.h" line="176"/>
25470+ <source-position filename="glib/gmarkup.h" line="180"/>
2525125471 <return-value transfer-ownership="none">
2525225472 <type name="none" c:type="void"/>
2525325473 </return-value>
@@ -25276,7 +25496,7 @@ back to its caller.</doc>
2527625496 filename="glib/gmarkup.h"
2527725497 line="137">Callback to invoke when an error occurs.</doc>
2527825498 <callback name="error">
25279- <source-position filename="glib/gmarkup.h" line="185"/>
25499+ <source-position filename="glib/gmarkup.h" line="189"/>
2528025500 <return-value transfer-ownership="none">
2528125501 <type name="none" c:type="void"/>
2528225502 </return-value>
@@ -25315,7 +25535,7 @@ matches.</doc>
2531525535 throws="1">
2531625536 <doc xml:space="preserve"
2531725537 filename="glib/gregex.c"
25318- line="1329">Returns a new string containing the text in @string_to_expand with
25538+ line="1404">Returns a new string containing the text in @string_to_expand with
2531925539 references and escape sequences expanded. References refer to the last
2532025540 match done with @string against @regex and have the same syntax used by
2532125541 g_regex_replace().
@@ -25336,7 +25556,7 @@ contains references.</doc>
2533625556 <return-value transfer-ownership="full" nullable="1">
2533725557 <doc xml:space="preserve"
2533825558 filename="glib/gregex.c"
25339- line="1353">the expanded string, or %NULL if an error occurred</doc>
25559+ line="1428">the expanded string, or %NULL if an error occurred</doc>
2534025560 <type name="utf8" c:type="gchar*"/>
2534125561 </return-value>
2534225562 <parameters>
@@ -25346,13 +25566,13 @@ contains references.</doc>
2534625566 allow-none="1">
2534725567 <doc xml:space="preserve"
2534825568 filename="glib/gregex.c"
25349- line="1331">a #GMatchInfo or %NULL</doc>
25569+ line="1406">a #GMatchInfo or %NULL</doc>
2535025570 <type name="MatchInfo" c:type="const GMatchInfo*"/>
2535125571 </instance-parameter>
2535225572 <parameter name="string_to_expand" transfer-ownership="none">
2535325573 <doc xml:space="preserve"
2535425574 filename="glib/gregex.c"
25355- line="1332">the string to expand</doc>
25575+ line="1407">the string to expand</doc>
2535625576 <type name="utf8" c:type="const gchar*"/>
2535725577 </parameter>
2535825578 </parameters>
@@ -25360,7 +25580,7 @@ contains references.</doc>
2536025580 <method name="fetch" c:identifier="g_match_info_fetch" version="2.14">
2536125581 <doc xml:space="preserve"
2536225582 filename="glib/gregex.c"
25363- line="1392">Retrieves the text matching the @match_num'th capturing
25583+ line="1467">Retrieves the text matching the @match_num'th capturing
2536425584 parentheses. 0 is the full text of the match, 1 is the first paren
2536525585 set, 2 the second, and so on.
2536625586
@@ -25380,7 +25600,7 @@ so you cannot call this function after freeing the string.</doc>
2538025600 <return-value transfer-ownership="full" nullable="1">
2538125601 <doc xml:space="preserve"
2538225602 filename="glib/gregex.c"
25383- line="1414">The matched substring, or %NULL if an error
25603+ line="1489">The matched substring, or %NULL if an error
2538425604 occurred. You have to free the string yourself</doc>
2538525605 <type name="utf8" c:type="gchar*"/>
2538625606 </return-value>
@@ -25388,13 +25608,13 @@ so you cannot call this function after freeing the string.</doc>
2538825608 <instance-parameter name="match_info" transfer-ownership="none">
2538925609 <doc xml:space="preserve"
2539025610 filename="glib/gregex.c"
25391- line="1394">#GMatchInfo structure</doc>
25611+ line="1469">#GMatchInfo structure</doc>
2539225612 <type name="MatchInfo" c:type="const GMatchInfo*"/>
2539325613 </instance-parameter>
2539425614 <parameter name="match_num" transfer-ownership="none">
2539525615 <doc xml:space="preserve"
2539625616 filename="glib/gregex.c"
25397- line="1395">number of the sub expression</doc>
25617+ line="1470">number of the sub expression</doc>
2539825618 <type name="gint" c:type="gint"/>
2539925619 </parameter>
2540025620 </parameters>
@@ -25404,7 +25624,7 @@ so you cannot call this function after freeing the string.</doc>
2540425624 version="2.14">
2540525625 <doc xml:space="preserve"
2540625626 filename="glib/gregex.c"
25407- line="1609">Bundles up pointers to each of the matching substrings from a match
25627+ line="1879">Bundles up pointers to each of the matching substrings from a match
2540825628 and stores them in an array of gchar pointers. The first element in
2540925629 the returned array is the match number 0, i.e. the entire matched
2541025630 text.
@@ -25424,7 +25644,7 @@ so you cannot call this function after freeing the string.</doc>
2542425644 <return-value transfer-ownership="full">
2542525645 <doc xml:space="preserve"
2542625646 filename="glib/gregex.c"
25427- line="1630">a %NULL-terminated array of gchar *
25647+ line="1900">a %NULL-terminated array of gchar *
2542825648 pointers. It must be freed using g_strfreev(). If the previous
2542925649 match failed %NULL is returned</doc>
2543025650 <array c:type="gchar**">
@@ -25435,7 +25655,7 @@ so you cannot call this function after freeing the string.</doc>
2543525655 <instance-parameter name="match_info" transfer-ownership="none">
2543625656 <doc xml:space="preserve"
2543725657 filename="glib/gregex.c"
25438- line="1611">a #GMatchInfo structure</doc>
25658+ line="1881">a #GMatchInfo structure</doc>
2543925659 <type name="MatchInfo" c:type="const GMatchInfo*"/>
2544025660 </instance-parameter>
2544125661 </parameters>
@@ -25445,7 +25665,7 @@ so you cannot call this function after freeing the string.</doc>
2544525665 version="2.14">
2544625666 <doc xml:space="preserve"
2544725667 filename="glib/gregex.c"
25448- line="1535">Retrieves the text matching the capturing parentheses named @name.
25668+ line="1802">Retrieves the text matching the capturing parentheses named @name.
2544925669
2545025670 If @name is a valid sub pattern name but it didn't match anything
2545125671 (e.g. sub pattern `"X"`, matching `"b"` against `"(?P&lt;X&gt;a)?b"`)
@@ -25457,7 +25677,7 @@ so you cannot call this function after freeing the string.</doc>
2545725677 <return-value transfer-ownership="full" nullable="1">
2545825678 <doc xml:space="preserve"
2545925679 filename="glib/gregex.c"
25460- line="1549">The matched substring, or %NULL if an error
25680+ line="1816">The matched substring, or %NULL if an error
2546125681 occurred. You have to free the string yourself</doc>
2546225682 <type name="utf8" c:type="gchar*"/>
2546325683 </return-value>
@@ -25465,13 +25685,13 @@ so you cannot call this function after freeing the string.</doc>
2546525685 <instance-parameter name="match_info" transfer-ownership="none">
2546625686 <doc xml:space="preserve"
2546725687 filename="glib/gregex.c"
25468- line="1537">#GMatchInfo structure</doc>
25688+ line="1804">#GMatchInfo structure</doc>
2546925689 <type name="MatchInfo" c:type="const GMatchInfo*"/>
2547025690 </instance-parameter>
2547125691 <parameter name="name" transfer-ownership="none">
2547225692 <doc xml:space="preserve"
2547325693 filename="glib/gregex.c"
25474- line="1538">name of the subexpression</doc>
25694+ line="1805">name of the subexpression</doc>
2547525695 <type name="utf8" c:type="const gchar*"/>
2547625696 </parameter>
2547725697 </parameters>
@@ -25481,16 +25701,19 @@ so you cannot call this function after freeing the string.</doc>
2548125701 version="2.14">
2548225702 <doc xml:space="preserve"
2548325703 filename="glib/gregex.c"
25484- line="1570">Retrieves the position in bytes of the capturing parentheses named @name.
25704+ line="1837">Retrieves the position in bytes of the capturing parentheses named @name.
2548525705
2548625706 If @name is a valid sub pattern name but it didn't match anything
2548725707 (e.g. sub pattern `"X"`, matching `"b"` against `"(?P&lt;X&gt;a)?b"`)
25488-then @start_pos and @end_pos are set to -1 and %TRUE is returned.</doc>
25708+then @start_pos and @end_pos are set to -1 and %TRUE is returned.
25709+
25710+As @end_pos is set to the byte after the final byte of the match (on success),
25711+the length of the match can be calculated as `end_pos - start_pos`.</doc>
2548925712 <source-position filename="glib/gregex.h" line="603"/>
2549025713 <return-value transfer-ownership="none">
2549125714 <doc xml:space="preserve"
2549225715 filename="glib/gregex.c"
25493- line="1585">%TRUE if the position was fetched, %FALSE otherwise.
25716+ line="1855">%TRUE if the position was fetched, %FALSE otherwise.
2549425717 If the position cannot be fetched, @start_pos and @end_pos
2549525718 are left unchanged.</doc>
2549625719 <type name="gboolean" c:type="gboolean"/>
@@ -25499,13 +25722,13 @@ then @start_pos and @end_pos are set to -1 and %TRUE is returned.</doc>
2549925722 <instance-parameter name="match_info" transfer-ownership="none">
2550025723 <doc xml:space="preserve"
2550125724 filename="glib/gregex.c"
25502- line="1572">#GMatchInfo structure</doc>
25725+ line="1839">#GMatchInfo structure</doc>
2550325726 <type name="MatchInfo" c:type="const GMatchInfo*"/>
2550425727 </instance-parameter>
2550525728 <parameter name="name" transfer-ownership="none">
2550625729 <doc xml:space="preserve"
2550725730 filename="glib/gregex.c"
25508- line="1573">name of the subexpression</doc>
25731+ line="1840">name of the subexpression</doc>
2550925732 <type name="utf8" c:type="const gchar*"/>
2551025733 </parameter>
2551125734 <parameter name="start_pos"
@@ -25516,7 +25739,7 @@ then @start_pos and @end_pos are set to -1 and %TRUE is returned.</doc>
2551625739 allow-none="1">
2551725740 <doc xml:space="preserve"
2551825741 filename="glib/gregex.c"
25519- line="1574">pointer to location where to store
25742+ line="1841">pointer to location where to store
2552025743 the start position, or %NULL</doc>
2552125744 <type name="gint" c:type="gint*"/>
2552225745 </parameter>
@@ -25528,8 +25751,8 @@ then @start_pos and @end_pos are set to -1 and %TRUE is returned.</doc>
2552825751 allow-none="1">
2552925752 <doc xml:space="preserve"
2553025753 filename="glib/gregex.c"
25531- line="1576">pointer to location where to store
25532- the end position, or %NULL</doc>
25754+ line="1843">pointer to location where to store
25755+ the end position (the byte after the final byte of the match), or %NULL</doc>
2553325756 <type name="gint" c:type="gint*"/>
2553425757 </parameter>
2553525758 </parameters>
@@ -25539,39 +25762,231 @@ then @start_pos and @end_pos are set to -1 and %TRUE is returned.</doc>
2553925762 version="2.14">
2554025763 <doc xml:space="preserve"
2554125764 filename="glib/gregex.c"
25542- line="1441">Retrieves the position in bytes of the @match_num'th capturing
25543-parentheses. 0 is the full text of the match, 1 is the first
25544-paren set, 2 the second, and so on.
25765+ line="1516">Returns the start and end positions (in bytes) of a successfully matching
25766+capture parenthesis.
25767+
25768+Valid values for @match_num are `0` for the full text of the match,
25769+`1` for the first paren set, `2` for the second, and so on.
25770+
25771+As @end_pos is set to the byte after the final byte of the match (on success),
25772+the length of the match can be calculated as `end_pos - start_pos`.
25773+
25774+As a best practice, initialize @start_pos and @end_pos to identifiable
25775+values, such as `G_MAXINT`, so that you can test if
25776+`g_match_info_fetch_pos()` actually changed the value for a given
25777+capture parenthesis.
25778+
25779+The parameter @match_num corresponds to a matched capture parenthesis. The
25780+actual value you use for @match_num depends on the method used to generate
25781+@match_info. The following sections describe those methods.
25782+
25783+## Methods Using Non-deterministic Finite Automata Matching
25784+
25785+The methods [method@GLib.Regex.match] and [method@GLib.Regex.match_full]
25786+return a [struct@GLib.MatchInfo] using traditional (greedy) pattern
25787+matching, also known as
25788+[Non-deterministic Finite Automaton](https://en.wikipedia.org/wiki/Nondeterministic_finite_automaton)
25789+(NFA) matching. You pass the returned `GMatchInfo` from these methods to
25790+`g_match_info_fetch_pos()` to determine the start and end positions
25791+of capture parentheses. The values for @match_num correspond to the capture
25792+parentheses in order, with `0` corresponding to the entire matched string.
25793+
25794+@match_num can refer to a capture parenthesis with no match. For example,
25795+the string `b` matches against the pattern `(a)?b`, but the capture
25796+parenthesis `(a)` has no match. In this case, `g_match_info_fetch_pos()`
25797+returns true and sets @start_pos and @end_pos to `-1` when called with
25798+`match_num` as `1` (for `(a)`).
25799+
25800+For an expanded example, a regex pattern is `(a)?(.*?)the (.*)`,
25801+and a candidate string is `glib regexes are the best`. In this scenario
25802+there are four capture parentheses numbered 0–3: an implicit one
25803+for the entire string, and three explicitly declared in the regex pattern.
25804+
25805+Given this example, the following table describes the return values
25806+from `g_match_info_fetch_pos()` for various values of @match_num.
25807+
25808+`match_num` | Contents | Return value | Returned `start_pos` | Returned `end_pos`
25809+----------- | -------- | ------------ | -------------------- | ------------------
25810+0 | Matches entire string | True | 0 | 25
25811+1 | Does not match first character | True | -1 | -1
25812+2 | All text before `the ` | True | 0 | 17
25813+3 | All text after `the ` | True | 21 | 25
25814+4 | Capture paren out of range | False | Unchanged | Unchanged
25815+
25816+The following code sample and output implements this example.
25817+
25818+``` { .c }
25819+#include &lt;glib.h&gt;
2554525820
25546-If @match_num is a valid sub pattern but it didn't match anything
25547-(e.g. sub pattern 1, matching "b" against "(a)?b") then @start_pos
25548-and @end_pos are set to -1 and %TRUE is returned.
25821+int
25822+main (int argc, char *argv[])
25823+{
25824+ g_autoptr(GError) local_error = NULL;
25825+ const char *regex_pattern = "(a)?(.*?)the (.*)";
25826+ const char *test_string = "glib regexes are the best";
25827+ g_autoptr(GRegex) regex = NULL;
25828+
25829+ regex = g_regex_new (regex_pattern,
25830+ G_REGEX_DEFAULT,
25831+ G_REGEX_MATCH_DEFAULT,
25832+ &amp;local_error);
25833+ if (regex == NULL)
25834+ {
25835+ g_printerr ("Error creating regex: %s\n", local_error-&gt;message);
25836+ return 1;
25837+ }
2554925838
25550-If the match was obtained using the DFA algorithm, that is using
25551-g_regex_match_all() or g_regex_match_all_full(), the retrieved
25552-position is not that of a set of parentheses but that of a matched
25553-substring. Substrings are matched in reverse order of length, so
25554-0 is the longest match.</doc>
25839+ g_autoptr(GMatchInfo) match_info = NULL;
25840+ g_regex_match (regex, test_string, G_REGEX_MATCH_DEFAULT, &amp;match_info);
25841+
25842+ int n_matched_strings = g_match_info_get_match_count (match_info);
25843+
25844+ // Print header line
25845+ g_print ("match_num Contents Return value returned start_pos returned end_pos\n");
25846+
25847+ // Iterate over each capture paren, including one that is out of range as a demonstration.
25848+ for (int match_num = 0; match_num &lt;= n_matched_strings; match_num++)
25849+ {
25850+ gboolean found_match;
25851+ g_autofree char *paren_string = NULL;
25852+ int start_pos = G_MAXINT;
25853+ int end_pos = G_MAXINT;
25854+
25855+ found_match = g_match_info_fetch_pos (match_info,
25856+ match_num,
25857+ &amp;start_pos,
25858+ &amp;end_pos);
25859+
25860+ // If no match, display N/A as the found string.
25861+ if (start_pos == G_MAXINT || start_pos == -1)
25862+ paren_string = g_strdup ("N/A");
25863+ else
25864+ paren_string = g_strndup (test_string + start_pos, end_pos - start_pos);
25865+
25866+ g_print ("%-9d %-25s %-12d %-18d %d\n", match_num, paren_string, found_match, start_pos, end_pos);
25867+ }
25868+
25869+ return 0;
25870+}
25871+```
25872+
25873+```
25874+match_num Contents Return value returned start_pos returned end_pos
25875+0 glib regexes are the best 1 0 25
25876+1 N/A 1 -1 -1
25877+2 glib regexes are 1 0 17
25878+3 best 1 21 25
25879+4 N/A 0 2147483647 2147483647
25880+```
25881+## Methods Using Deterministic Finite Automata Matching
25882+
25883+The methods [method@GLib.Regex.match_all] and
25884+[method@GLib.Regex.match_all_full]
25885+return a `GMatchInfo` using
25886+[Deterministic Finite Automaton](https://en.wikipedia.org/wiki/Deterministic_finite_automaton)
25887+(DFA) pattern matching. This algorithm detects overlapping matches. You pass
25888+the returned `GMatchInfo` from these methods to `g_match_info_fetch_pos()`
25889+to determine the start and end positions of each overlapping match. Use the
25890+method [method@GLib.MatchInfo.get_match_count] to determine the number
25891+of overlapping matches.
25892+
25893+For example, a regex pattern is `&lt;.*&gt;`, and a candidate string is
25894+`&lt;a&gt; &lt;b&gt; &lt;c&gt;`. In this scenario there are three implicit capture
25895+parentheses: one for the entire string, one for `&lt;a&gt; &lt;b&gt;`, and one for `&lt;a&gt;`.
25896+
25897+Given this example, the following table describes the return values from
25898+`g_match_info_fetch_pos()` for various values of @match_num.
25899+
25900+`match_num` | Contents | Return value | Returned `start_pos` | Returned `end_pos`
25901+----------- | -------- | ------------ | -------------------- | ------------------
25902+0 | Matches entire string | True | 0 | 11
25903+1 | Matches `&lt;a&gt; &lt;b&gt;` | True | 0 | 7
25904+2 | Matches `&lt;a&gt;` | True | 0 | 3
25905+3 | Capture paren out of range | False | Unchanged | Unchanged
25906+
25907+The following code sample and output implements this example.
25908+
25909+``` { .c }
25910+#include &lt;glib.h&gt;
25911+
25912+int
25913+main (int argc, char *argv[])
25914+{
25915+ g_autoptr(GError) local_error = NULL;
25916+ const char *regex_pattern = "&lt;.*&gt;";
25917+ const char *test_string = "&lt;a&gt; &lt;b&gt; &lt;c&gt;";
25918+ g_autoptr(GRegex) regex = NULL;
25919+
25920+ regex = g_regex_new (regex_pattern,
25921+ G_REGEX_DEFAULT,
25922+ G_REGEX_MATCH_DEFAULT,
25923+ &amp;local_error);
25924+ if (regex == NULL)
25925+ {
25926+ g_printerr ("Error creating regex: %s\n", local_error-&gt;message);
25927+ return -1;
25928+ }
25929+
25930+ g_autoptr(GMatchInfo) match_info = NULL;
25931+ g_regex_match_all (regex, test_string, G_REGEX_MATCH_DEFAULT, &amp;match_info);
25932+
25933+ int n_matched_strings = g_match_info_get_match_count (match_info);
25934+
25935+ // Print header line
25936+ g_print ("match_num Contents Return value returned start_pos returned end_pos\n");
25937+
25938+ // Iterate over each capture paren, including one that is out of range as a demonstration.
25939+ for (int match_num = 0; match_num &lt;= n_matched_strings; match_num++)
25940+ {
25941+ gboolean found_match;
25942+ g_autofree char *paren_string = NULL;
25943+ int start_pos = G_MAXINT;
25944+ int end_pos = G_MAXINT;
25945+
25946+ found_match = g_match_info_fetch_pos (match_info, match_num, &amp;start_pos, &amp;end_pos);
25947+
25948+ // If no match, display N/A as the found string.
25949+ if (start_pos == G_MAXINT || start_pos == -1)
25950+ paren_string = g_strdup ("N/A");
25951+ else
25952+ paren_string = g_strndup (test_string + start_pos, end_pos - start_pos);
25953+
25954+ g_print ("%-9d %-25s %-12d %-18d %d\n", match_num, paren_string, found_match, start_pos, end_pos);
25955+ }
25956+
25957+ return 0;
25958+}
25959+```
25960+
25961+```
25962+match_num Contents Return value returned start_pos returned end_pos
25963+0 &lt;a&gt; &lt;b&gt; &lt;c&gt; 1 0 11
25964+1 &lt;a&gt; &lt;b&gt; 1 0 7
25965+2 &lt;a&gt; 1 0 3
25966+3 N/A 0 2147483647 2147483647
25967+```</doc>
2555525968 <source-position filename="glib/gregex.h" line="595"/>
2555625969 <return-value transfer-ownership="none">
2555725970 <doc xml:space="preserve"
2555825971 filename="glib/gregex.c"
25559- line="1464">%TRUE if the position was fetched, %FALSE otherwise. If
25560- the position cannot be fetched, @start_pos and @end_pos are left
25561- unchanged</doc>
25972+ line="1729">True if @match_num is within range, false otherwise. If
25973+ the capture paren has a match, @start_pos and @end_pos contain the
25974+ start and end positions (in bytes) of the matching substring. If the
25975+ capture paren has no match, @start_pos and @end_pos are `-1`. If
25976+ @match_num is out of range, @start_pos and @end_pos are left unchanged.</doc>
2556225977 <type name="gboolean" c:type="gboolean"/>
2556325978 </return-value>
2556425979 <parameters>
2556525980 <instance-parameter name="match_info" transfer-ownership="none">
2556625981 <doc xml:space="preserve"
2556725982 filename="glib/gregex.c"
25568- line="1443">#GMatchInfo structure</doc>
25983+ line="1518">#GMatchInfo structure</doc>
2556925984 <type name="MatchInfo" c:type="const GMatchInfo*"/>
2557025985 </instance-parameter>
2557125986 <parameter name="match_num" transfer-ownership="none">
2557225987 <doc xml:space="preserve"
2557325988 filename="glib/gregex.c"
25574- line="1444">number of the sub expression</doc>
25989+ line="1519">number of the capture parenthesis</doc>
2557525990 <type name="gint" c:type="gint"/>
2557625991 </parameter>
2557725992 <parameter name="start_pos"
@@ -25582,7 +25997,7 @@ substring. Substrings are matched in reverse order of length, so
2558225997 allow-none="1">
2558325998 <doc xml:space="preserve"
2558425999 filename="glib/gregex.c"
25585- line="1445">pointer to location where to store
26000+ line="1520">pointer to location where to store
2558626001 the start position, or %NULL</doc>
2558726002 <type name="gint" c:type="gint*"/>
2558826003 </parameter>
@@ -25594,8 +26009,8 @@ substring. Substrings are matched in reverse order of length, so
2559426009 allow-none="1">
2559526010 <doc xml:space="preserve"
2559626011 filename="glib/gregex.c"
25597- line="1447">pointer to location where to store
25598- the end position, or %NULL</doc>
26012+ line="1522">pointer to location where to store
26013+ the end position (the byte after the final byte of the match), or %NULL</doc>
2559926014 <type name="gint" c:type="gint*"/>
2560026015 </parameter>
2560126016 </parameters>
@@ -25603,7 +26018,7 @@ substring. Substrings are matched in reverse order of length, so
2560326018 <method name="free" c:identifier="g_match_info_free" version="2.14">
2560426019 <doc xml:space="preserve"
2560526020 filename="glib/gregex.c"
25606- line="1056">If @match_info is not %NULL, calls g_match_info_unref(); otherwise does
26021+ line="1131">If @match_info is not %NULL, calls g_match_info_unref(); otherwise does
2560726022 nothing.</doc>
2560826023 <source-position filename="glib/gregex.h" line="577"/>
2560926024 <return-value transfer-ownership="none">
@@ -25616,7 +26031,7 @@ nothing.</doc>
2561626031 allow-none="1">
2561726032 <doc xml:space="preserve"
2561826033 filename="glib/gregex.c"
25619- line="1058">a #GMatchInfo, or %NULL</doc>
26034+ line="1133">a #GMatchInfo, or %NULL</doc>
2562026035 <type name="MatchInfo" c:type="GMatchInfo*"/>
2562126036 </instance-parameter>
2562226037 </parameters>
@@ -25626,7 +26041,7 @@ nothing.</doc>
2562626041 version="2.14">
2562726042 <doc xml:space="preserve"
2562826043 filename="glib/gregex.c"
25629- line="1246">Retrieves the number of matched substrings (including substring 0,
26044+ line="1321">Retrieves the number of matched substrings (including substring 0,
2563026045 that is the whole matched text), so 1 is returned if the pattern
2563126046 has no substrings in it and 0 is returned if the match failed.
2563226047
@@ -25638,14 +26053,14 @@ the number of matched substrings.</doc>
2563826053 <return-value transfer-ownership="none">
2563926054 <doc xml:space="preserve"
2564026055 filename="glib/gregex.c"
25641- line="1259">Number of matched substrings, or -1 if an error occurred</doc>
26056+ line="1334">Number of matched substrings, or -1 if an error occurred</doc>
2564226057 <type name="gint" c:type="gint"/>
2564326058 </return-value>
2564426059 <parameters>
2564526060 <instance-parameter name="match_info" transfer-ownership="none">
2564626061 <doc xml:space="preserve"
2564726062 filename="glib/gregex.c"
25648- line="1248">a #GMatchInfo structure</doc>
26063+ line="1323">a #GMatchInfo structure</doc>
2564926064 <type name="MatchInfo" c:type="const GMatchInfo*"/>
2565026065 </instance-parameter>
2565126066 </parameters>
@@ -25655,21 +26070,21 @@ the number of matched substrings.</doc>
2565526070 version="2.14">
2565626071 <doc xml:space="preserve"
2565726072 filename="glib/gregex.c"
25658- line="973">Returns #GRegex object used in @match_info. It belongs to Glib
26073+ line="1048">Returns #GRegex object used in @match_info. It belongs to Glib
2565926074 and must not be freed. Use g_regex_ref() if you need to keep it
2566026075 after you free @match_info object.</doc>
2566126076 <source-position filename="glib/gregex.h" line="568"/>
2566226077 <return-value transfer-ownership="none">
2566326078 <doc xml:space="preserve"
2566426079 filename="glib/gregex.c"
25665- line="981">#GRegex object used in @match_info</doc>
26080+ line="1056">#GRegex object used in @match_info</doc>
2566626081 <type name="Regex" c:type="GRegex*"/>
2566726082 </return-value>
2566826083 <parameters>
2566926084 <instance-parameter name="match_info" transfer-ownership="none">
2567026085 <doc xml:space="preserve"
2567126086 filename="glib/gregex.c"
25672- line="975">a #GMatchInfo</doc>
26087+ line="1050">a #GMatchInfo</doc>
2567326088 <type name="MatchInfo" c:type="const GMatchInfo*"/>
2567426089 </instance-parameter>
2567526090 </parameters>
@@ -25679,21 +26094,21 @@ after you free @match_info object.</doc>
2567926094 version="2.14">
2568026095 <doc xml:space="preserve"
2568126096 filename="glib/gregex.c"
25682- line="992">Returns the string searched with @match_info. This is the
26097+ line="1067">Returns the string searched with @match_info. This is the
2568326098 string passed to g_regex_match() or g_regex_replace() so
2568426099 you may not free it before calling this function.</doc>
2568526100 <source-position filename="glib/gregex.h" line="570"/>
2568626101 <return-value transfer-ownership="none">
2568726102 <doc xml:space="preserve"
2568826103 filename="glib/gregex.c"
25689- line="1000">the string searched with @match_info</doc>
26104+ line="1075">the string searched with @match_info</doc>
2569026105 <type name="utf8" c:type="const gchar*"/>
2569126106 </return-value>
2569226107 <parameters>
2569326108 <instance-parameter name="match_info" transfer-ownership="none">
2569426109 <doc xml:space="preserve"
2569526110 filename="glib/gregex.c"
25696- line="994">a #GMatchInfo</doc>
26111+ line="1069">a #GMatchInfo</doc>
2569726112 <type name="MatchInfo" c:type="const GMatchInfo*"/>
2569826113 </instance-parameter>
2569926114 </parameters>
@@ -25703,7 +26118,7 @@ you may not free it before calling this function.</doc>
2570326118 version="2.14">
2570426119 <doc xml:space="preserve"
2570526120 filename="glib/gregex.c"
25706- line="1279">Usually if the string passed to g_regex_match*() matches as far as
26121+ line="1354">Usually if the string passed to g_regex_match*() matches as far as
2570726122 it goes, but is too short to match the entire pattern, %FALSE is
2570826123 returned. There are circumstances where it might be helpful to
2570926124 distinguish this case from other cases in which there is no match.
@@ -25740,14 +26155,14 @@ See pcrepartial(3) for more information on partial matching.</doc>
2574026155 <return-value transfer-ownership="none">
2574126156 <doc xml:space="preserve"
2574226157 filename="glib/gregex.c"
25743- line="1317">%TRUE if the match was partial, %FALSE otherwise</doc>
26158+ line="1392">%TRUE if the match was partial, %FALSE otherwise</doc>
2574426159 <type name="gboolean" c:type="gboolean"/>
2574526160 </return-value>
2574626161 <parameters>
2574726162 <instance-parameter name="match_info" transfer-ownership="none">
2574826163 <doc xml:space="preserve"
2574926164 filename="glib/gregex.c"
25750- line="1281">a #GMatchInfo structure</doc>
26165+ line="1356">a #GMatchInfo structure</doc>
2575126166 <type name="MatchInfo" c:type="const GMatchInfo*"/>
2575226167 </instance-parameter>
2575326168 </parameters>
@@ -25757,12 +26172,12 @@ See pcrepartial(3) for more information on partial matching.</doc>
2575726172 version="2.14">
2575826173 <doc xml:space="preserve"
2575926174 filename="glib/gregex.c"
25760- line="1227">Returns whether the previous match operation succeeded.</doc>
26175+ line="1302">Returns whether the previous match operation succeeded.</doc>
2576126176 <source-position filename="glib/gregex.h" line="582"/>
2576226177 <return-value transfer-ownership="none">
2576326178 <doc xml:space="preserve"
2576426179 filename="glib/gregex.c"
25765- line="1233">%TRUE if the previous match operation succeeded,
26180+ line="1308">%TRUE if the previous match operation succeeded,
2576626181 %FALSE otherwise</doc>
2576726182 <type name="gboolean" c:type="gboolean"/>
2576826183 </return-value>
@@ -25770,7 +26185,7 @@ See pcrepartial(3) for more information on partial matching.</doc>
2577026185 <instance-parameter name="match_info" transfer-ownership="none">
2577126186 <doc xml:space="preserve"
2577226187 filename="glib/gregex.c"
25773- line="1229">a #GMatchInfo structure</doc>
26188+ line="1304">a #GMatchInfo structure</doc>
2577426189 <type name="MatchInfo" c:type="const GMatchInfo*"/>
2577526190 </instance-parameter>
2577626191 </parameters>
@@ -25781,7 +26196,7 @@ See pcrepartial(3) for more information on partial matching.</doc>
2578126196 throws="1">
2578226197 <doc xml:space="preserve"
2578326198 filename="glib/gregex.c"
25784- line="1074">Scans for the next match using the same parameters of the previous
26199+ line="1149">Scans for the next match using the same parameters of the previous
2578526200 call to g_regex_match_full() or g_regex_match() that returned
2578626201 @match_info.
2578726202
@@ -25791,14 +26206,14 @@ cannot free it before calling this function.</doc>
2579126206 <return-value transfer-ownership="none">
2579226207 <doc xml:space="preserve"
2579326208 filename="glib/gregex.c"
25794- line="1086">%TRUE is the string matched, %FALSE otherwise</doc>
26209+ line="1161">%TRUE is the string matched, %FALSE otherwise</doc>
2579526210 <type name="gboolean" c:type="gboolean"/>
2579626211 </return-value>
2579726212 <parameters>
2579826213 <instance-parameter name="match_info" transfer-ownership="none">
2579926214 <doc xml:space="preserve"
2580026215 filename="glib/gregex.c"
25801- line="1076">a #GMatchInfo structure</doc>
26216+ line="1151">a #GMatchInfo structure</doc>
2580226217 <type name="MatchInfo" c:type="GMatchInfo*"/>
2580326218 </instance-parameter>
2580426219 </parameters>
@@ -25806,19 +26221,19 @@ cannot free it before calling this function.</doc>
2580626221 <method name="ref" c:identifier="g_match_info_ref" version="2.30">
2580726222 <doc xml:space="preserve"
2580826223 filename="glib/gregex.c"
25809- line="1011">Increases reference count of @match_info by 1.</doc>
26224+ line="1086">Increases reference count of @match_info by 1.</doc>
2581026225 <source-position filename="glib/gregex.h" line="573"/>
2581126226 <return-value transfer-ownership="full">
2581226227 <doc xml:space="preserve"
2581326228 filename="glib/gregex.c"
25814- line="1017">@match_info</doc>
26229+ line="1092">@match_info</doc>
2581526230 <type name="MatchInfo" c:type="GMatchInfo*"/>
2581626231 </return-value>
2581726232 <parameters>
2581826233 <instance-parameter name="match_info" transfer-ownership="none">
2581926234 <doc xml:space="preserve"
2582026235 filename="glib/gregex.c"
25821- line="1013">a #GMatchInfo</doc>
26236+ line="1088">a #GMatchInfo</doc>
2582226237 <type name="MatchInfo" c:type="GMatchInfo*"/>
2582326238 </instance-parameter>
2582426239 </parameters>
@@ -25826,7 +26241,7 @@ cannot free it before calling this function.</doc>
2582626241 <method name="unref" c:identifier="g_match_info_unref" version="2.30">
2582726242 <doc xml:space="preserve"
2582826243 filename="glib/gregex.c"
25829- line="1029">Decreases reference count of @match_info by 1. When reference count drops
26244+ line="1104">Decreases reference count of @match_info by 1. When reference count drops
2583026245 to zero, it frees all the memory associated with the match_info structure.</doc>
2583126246 <source-position filename="glib/gregex.h" line="575"/>
2583226247 <return-value transfer-ownership="none">
@@ -25836,15 +26251,23 @@ to zero, it frees all the memory associated with the match_info structure.</doc>
2583626251 <instance-parameter name="match_info" transfer-ownership="none">
2583726252 <doc xml:space="preserve"
2583826253 filename="glib/gregex.c"
25839- line="1031">a #GMatchInfo</doc>
26254+ line="1106">a #GMatchInfo</doc>
2584026255 <type name="MatchInfo" c:type="GMatchInfo*"/>
2584126256 </instance-parameter>
2584226257 </parameters>
2584326258 </method>
2584426259 </record>
25845- <record name="MemChunk" c:type="GMemChunk" disguised="1" opaque="1">
26260+ <record name="MemChunk"
26261+ c:type="GMemChunk"
26262+ disguised="1"
26263+ opaque="1"
26264+ deprecated="1"
26265+ deprecated-version="2.10">
2584626266 <source-position filename="glib/deprecated/gallocator.h" line="28"/>
25847- <method name="alloc" c:identifier="g_mem_chunk_alloc">
26267+ <method name="alloc"
26268+ c:identifier="g_mem_chunk_alloc"
26269+ deprecated="1"
26270+ deprecated-version="2.10">
2584826271 <source-position filename="glib/deprecated/gallocator.h" line="50"/>
2584926272 <return-value transfer-ownership="none" nullable="1">
2585026273 <type name="gpointer" c:type="gpointer"/>
@@ -25855,7 +26278,10 @@ to zero, it frees all the memory associated with the match_info structure.</doc>
2585526278 </instance-parameter>
2585626279 </parameters>
2585726280 </method>
25858- <method name="alloc0" c:identifier="g_mem_chunk_alloc0">
26281+ <method name="alloc0"
26282+ c:identifier="g_mem_chunk_alloc0"
26283+ deprecated="1"
26284+ deprecated-version="2.10">
2585926285 <source-position filename="glib/deprecated/gallocator.h" line="52"/>
2586026286 <return-value transfer-ownership="none" nullable="1">
2586126287 <type name="gpointer" c:type="gpointer"/>
@@ -25866,7 +26292,10 @@ to zero, it frees all the memory associated with the match_info structure.</doc>
2586626292 </instance-parameter>
2586726293 </parameters>
2586826294 </method>
25869- <method name="clean" c:identifier="g_mem_chunk_clean">
26295+ <method name="clean"
26296+ c:identifier="g_mem_chunk_clean"
26297+ deprecated="1"
26298+ deprecated-version="2.10">
2587026299 <source-position filename="glib/deprecated/gallocator.h" line="57"/>
2587126300 <return-value transfer-ownership="none">
2587226301 <type name="none" c:type="void"/>
@@ -25877,7 +26306,10 @@ to zero, it frees all the memory associated with the match_info structure.</doc>
2587726306 </instance-parameter>
2587826307 </parameters>
2587926308 </method>
25880- <method name="destroy" c:identifier="g_mem_chunk_destroy">
26309+ <method name="destroy"
26310+ c:identifier="g_mem_chunk_destroy"
26311+ deprecated="1"
26312+ deprecated-version="2.10">
2588126313 <source-position filename="glib/deprecated/gallocator.h" line="48"/>
2588226314 <return-value transfer-ownership="none">
2588326315 <type name="none" c:type="void"/>
@@ -25888,7 +26320,10 @@ to zero, it frees all the memory associated with the match_info structure.</doc>
2588826320 </instance-parameter>
2588926321 </parameters>
2589026322 </method>
25891- <method name="free" c:identifier="g_mem_chunk_free">
26323+ <method name="free"
26324+ c:identifier="g_mem_chunk_free"
26325+ deprecated="1"
26326+ deprecated-version="2.10">
2589226327 <source-position filename="glib/deprecated/gallocator.h" line="54"/>
2589326328 <return-value transfer-ownership="none">
2589426329 <type name="none" c:type="void"/>
@@ -25905,7 +26340,10 @@ to zero, it frees all the memory associated with the match_info structure.</doc>
2590526340 </parameter>
2590626341 </parameters>
2590726342 </method>
25908- <method name="print" c:identifier="g_mem_chunk_print">
26343+ <method name="print"
26344+ c:identifier="g_mem_chunk_print"
26345+ deprecated="1"
26346+ deprecated-version="2.10">
2590926347 <source-position filename="glib/deprecated/gallocator.h" line="61"/>
2591026348 <return-value transfer-ownership="none">
2591126349 <type name="none" c:type="void"/>
@@ -25916,7 +26354,10 @@ to zero, it frees all the memory associated with the match_info structure.</doc>
2591626354 </instance-parameter>
2591726355 </parameters>
2591826356 </method>
25919- <method name="reset" c:identifier="g_mem_chunk_reset">
26357+ <method name="reset"
26358+ c:identifier="g_mem_chunk_reset"
26359+ deprecated="1"
26360+ deprecated-version="2.10">
2592026361 <source-position filename="glib/deprecated/gallocator.h" line="59"/>
2592126362 <return-value transfer-ownership="none">
2592226363 <type name="none" c:type="void"/>
@@ -25927,13 +26368,20 @@ to zero, it frees all the memory associated with the match_info structure.</doc>
2592726368 </instance-parameter>
2592826369 </parameters>
2592926370 </method>
25930- <function name="info" c:identifier="g_mem_chunk_info">
26371+ <function name="info"
26372+ c:identifier="g_mem_chunk_info"
26373+ deprecated="1"
26374+ deprecated-version="2.10">
2593126375 <source-position filename="glib/deprecated/gallocator.h" line="63"/>
2593226376 <return-value transfer-ownership="none">
2593326377 <type name="none" c:type="void"/>
2593426378 </return-value>
2593526379 </function>
25936- <function name="new" c:identifier="g_mem_chunk_new" introspectable="0">
26380+ <function name="new"
26381+ c:identifier="g_mem_chunk_new"
26382+ introspectable="0"
26383+ deprecated="1"
26384+ deprecated-version="2.10">
2593726385 <source-position filename="glib/deprecated/gallocator.h" line="43"/>
2593826386 <return-value>
2593926387 <type name="MemChunk" c:type="GMemChunk*"/>
@@ -27148,13 +27596,19 @@ Used to create the first node in a tree.</doc>
2714827596 </parameter>
2714927597 </parameters>
2715027598 </function>
27151- <function name="pop_allocator" c:identifier="g_node_pop_allocator">
27599+ <function name="pop_allocator"
27600+ c:identifier="g_node_pop_allocator"
27601+ deprecated="1"
27602+ deprecated-version="2.10">
2715227603 <source-position filename="glib/deprecated/gallocator.h" line="84"/>
2715327604 <return-value transfer-ownership="none">
2715427605 <type name="none" c:type="void"/>
2715527606 </return-value>
2715627607 </function>
27157- <function name="push_allocator" c:identifier="g_node_push_allocator">
27608+ <function name="push_allocator"
27609+ c:identifier="g_node_push_allocator"
27610+ deprecated="1"
27611+ deprecated-version="2.10">
2715827612 <source-position filename="glib/deprecated/gallocator.h" line="82"/>
2715927613 <return-value transfer-ownership="none">
2716027614 <type name="none" c:type="void"/>
@@ -27805,19 +28259,19 @@ Please note that parsed arguments need to be freed separately (see
2780528259 version="2.12">
2780628260 <doc xml:space="preserve"
2780728261 filename="glib/goption.c"
27808- line="2552">Returns the description. See g_option_context_set_description().</doc>
28262+ line="2555">Returns the description. See g_option_context_set_description().</doc>
2780928263 <source-position filename="glib/goption.h" line="343"/>
2781028264 <return-value transfer-ownership="none">
2781128265 <doc xml:space="preserve"
2781228266 filename="glib/goption.c"
27813- line="2558">the description</doc>
28267+ line="2561">the description</doc>
2781428268 <type name="utf8" c:type="const gchar*"/>
2781528269 </return-value>
2781628270 <parameters>
2781728271 <instance-parameter name="context" transfer-ownership="none">
2781828272 <doc xml:space="preserve"
2781928273 filename="glib/goption.c"
27820- line="2554">a #GOptionContext</doc>
28274+ line="2557">a #GOptionContext</doc>
2782128275 <type name="OptionContext" c:type="GOptionContext*"/>
2782228276 </instance-parameter>
2782328277 </parameters>
@@ -27964,19 +28418,19 @@ See g_option_context_set_strict_posix() for more information.</doc>
2796428418 version="2.12">
2796528419 <doc xml:space="preserve"
2796628420 filename="glib/goption.c"
27967- line="2509">Returns the summary. See g_option_context_set_summary().</doc>
28421+ line="2512">Returns the summary. See g_option_context_set_summary().</doc>
2796828422 <source-position filename="glib/goption.h" line="338"/>
2796928423 <return-value transfer-ownership="none">
2797028424 <doc xml:space="preserve"
2797128425 filename="glib/goption.c"
27972- line="2515">the summary</doc>
28426+ line="2518">the summary</doc>
2797328427 <type name="utf8" c:type="const gchar*"/>
2797428428 </return-value>
2797528429 <parameters>
2797628430 <instance-parameter name="context" transfer-ownership="none">
2797728431 <doc xml:space="preserve"
2797828432 filename="glib/goption.c"
27979- line="2511">a #GOptionContext</doc>
28433+ line="2514">a #GOptionContext</doc>
2798028434 <type name="OptionContext" c:type="GOptionContext*"/>
2798128435 </instance-parameter>
2798228436 </parameters>
@@ -27987,7 +28441,7 @@ See g_option_context_set_strict_posix() for more information.</doc>
2798728441 throws="1">
2798828442 <doc xml:space="preserve"
2798928443 filename="glib/goption.c"
27990- line="1773">Parses the command line arguments, recognizing options
28444+ line="1775">Parses the command line arguments, recognizing options
2799128445 which have been added to @context. A side-effect of
2799228446 calling this function is that g_set_prgname() will be
2799328447 called.
@@ -28012,7 +28466,7 @@ character set conversion of string and filename arguments.</doc>
2801228466 <return-value transfer-ownership="none">
2801328467 <doc xml:space="preserve"
2801428468 filename="glib/goption.c"
28015- line="1802">%TRUE if the parsing was successful,
28469+ line="1804">%TRUE if the parsing was successful,
2801628470 %FALSE if an error occurred</doc>
2801728471 <type name="gboolean" c:type="gboolean"/>
2801828472 </return-value>
@@ -28020,7 +28474,7 @@ character set conversion of string and filename arguments.</doc>
2802028474 <instance-parameter name="context" transfer-ownership="none">
2802128475 <doc xml:space="preserve"
2802228476 filename="glib/goption.c"
28023- line="1775">a #GOptionContext</doc>
28477+ line="1777">a #GOptionContext</doc>
2802428478 <type name="OptionContext" c:type="GOptionContext*"/>
2802528479 </instance-parameter>
2802628480 <parameter name="argc"
@@ -28030,7 +28484,7 @@ character set conversion of string and filename arguments.</doc>
2803028484 optional="1">
2803128485 <doc xml:space="preserve"
2803228486 filename="glib/goption.c"
28033- line="1776">a pointer to the number of command line arguments</doc>
28487+ line="1778">a pointer to the number of command line arguments</doc>
2803428488 <type name="gint" c:type="gint*"/>
2803528489 </parameter>
2803628490 <parameter name="argv"
@@ -28040,7 +28494,7 @@ character set conversion of string and filename arguments.</doc>
2804028494 optional="1">
2804128495 <doc xml:space="preserve"
2804228496 filename="glib/goption.c"
28043- line="1777">a pointer to the array of command line arguments</doc>
28497+ line="1779">a pointer to the array of command line arguments</doc>
2804428498 <array length="0" zero-terminated="0" c:type="gchar***">
2804528499 <type name="utf8" c:type="gchar**"/>
2804628500 </array>
@@ -28053,7 +28507,7 @@ character set conversion of string and filename arguments.</doc>
2805328507 throws="1">
2805428508 <doc xml:space="preserve"
2805528509 filename="glib/goption.c"
28056- line="2570">Parses the command line arguments.
28510+ line="2573">Parses the command line arguments.
2805728511
2805828512 This function is similar to g_option_context_parse() except that it
2805928513 respects the normal memory rules when dealing with a strv instead of
@@ -28073,7 +28527,7 @@ This function is useful if you are trying to use #GOptionContext with
2807328527 <return-value transfer-ownership="none">
2807428528 <doc xml:space="preserve"
2807528529 filename="glib/goption.c"
28076- line="2596">%TRUE if the parsing was successful,
28530+ line="2599">%TRUE if the parsing was successful,
2807728531 %FALSE if an error occurred</doc>
2807828532 <type name="gboolean" c:type="gboolean"/>
2807928533 </return-value>
@@ -28081,7 +28535,7 @@ This function is useful if you are trying to use #GOptionContext with
2808128535 <instance-parameter name="context" transfer-ownership="none">
2808228536 <doc xml:space="preserve"
2808328537 filename="glib/goption.c"
28084- line="2572">a #GOptionContext</doc>
28538+ line="2575">a #GOptionContext</doc>
2808528539 <type name="OptionContext" c:type="GOptionContext*"/>
2808628540 </instance-parameter>
2808728541 <parameter name="arguments"
@@ -28091,7 +28545,7 @@ This function is useful if you are trying to use #GOptionContext with
2809128545 optional="1">
2809228546 <doc xml:space="preserve"
2809328547 filename="glib/goption.c"
28094- line="2573">a pointer
28548+ line="2576">a pointer
2809528549 to the command line arguments (which must be in UTF-8 on Windows).
2809628550 Starting with GLib 2.62, @arguments can be %NULL, which matches
2809728551 g_option_context_parse().</doc>
@@ -28106,7 +28560,7 @@ This function is useful if you are trying to use #GOptionContext with
2810628560 version="2.12">
2810728561 <doc xml:space="preserve"
2810828562 filename="glib/goption.c"
28109- line="2527">Adds a string to be displayed in `--help` output after the list
28563+ line="2530">Adds a string to be displayed in `--help` output after the list
2811028564 of options. This text often includes a bug reporting address.
2811128565
2811228566 Note that the summary is translated (see
@@ -28119,7 +28573,7 @@ g_option_context_set_translate_func()).</doc>
2811928573 <instance-parameter name="context" transfer-ownership="none">
2812028574 <doc xml:space="preserve"
2812128575 filename="glib/goption.c"
28122- line="2529">a #GOptionContext</doc>
28576+ line="2532">a #GOptionContext</doc>
2812328577 <type name="OptionContext" c:type="GOptionContext*"/>
2812428578 </instance-parameter>
2812528579 <parameter name="description"
@@ -28128,7 +28582,7 @@ g_option_context_set_translate_func()).</doc>
2812828582 allow-none="1">
2812928583 <doc xml:space="preserve"
2813028584 filename="glib/goption.c"
28131- line="2530">a string to be shown in `--help` output
28585+ line="2533">a string to be shown in `--help` output
2813228586 after the list of options, or %NULL</doc>
2813328587 <type name="utf8" c:type="const gchar*"/>
2813428588 </parameter>
@@ -28275,7 +28729,7 @@ parsing).</doc>
2827528729 version="2.12">
2827628730 <doc xml:space="preserve"
2827728731 filename="glib/goption.c"
28278- line="2483">Adds a string to be displayed in `--help` output before the list
28732+ line="2486">Adds a string to be displayed in `--help` output before the list
2827928733 of options. This is typically a summary of the program functionality.
2828028734
2828128735 Note that the summary is translated (see
@@ -28289,7 +28743,7 @@ g_option_context_set_translation_domain()).</doc>
2828928743 <instance-parameter name="context" transfer-ownership="none">
2829028744 <doc xml:space="preserve"
2829128745 filename="glib/goption.c"
28292- line="2485">a #GOptionContext</doc>
28746+ line="2488">a #GOptionContext</doc>
2829328747 <type name="OptionContext" c:type="GOptionContext*"/>
2829428748 </instance-parameter>
2829528749 <parameter name="summary"
@@ -28298,7 +28752,7 @@ g_option_context_set_translation_domain()).</doc>
2829828752 allow-none="1">
2829928753 <doc xml:space="preserve"
2830028754 filename="glib/goption.c"
28301- line="2486">a string to be shown in `--help` output
28755+ line="2489">a string to be shown in `--help` output
2830228756 before the list of options, or %NULL</doc>
2830328757 <type name="utf8" c:type="const gchar*"/>
2830428758 </parameter>
@@ -28309,7 +28763,7 @@ g_option_context_set_translation_domain()).</doc>
2830928763 version="2.12">
2831028764 <doc xml:space="preserve"
2831128765 filename="glib/goption.c"
28312- line="2424">Sets the function which is used to translate the contexts
28766+ line="2427">Sets the function which is used to translate the contexts
2831328767 user-visible strings, for `--help` output. If @func is %NULL,
2831428768 strings are not translated.
2831528769
@@ -28328,7 +28782,7 @@ domain, see g_option_context_set_translation_domain().</doc>
2832828782 <instance-parameter name="context" transfer-ownership="none">
2832928783 <doc xml:space="preserve"
2833028784 filename="glib/goption.c"
28331- line="2426">a #GOptionContext</doc>
28785+ line="2429">a #GOptionContext</doc>
2833228786 <type name="OptionContext" c:type="GOptionContext*"/>
2833328787 </instance-parameter>
2833428788 <parameter name="func"
@@ -28340,7 +28794,7 @@ domain, see g_option_context_set_translation_domain().</doc>
2834028794 destroy="2">
2834128795 <doc xml:space="preserve"
2834228796 filename="glib/goption.c"
28343- line="2427">the #GTranslateFunc, or %NULL</doc>
28797+ line="2430">the #GTranslateFunc, or %NULL</doc>
2834428798 <type name="TranslateFunc" c:type="GTranslateFunc"/>
2834528799 </parameter>
2834628800 <parameter name="data"
@@ -28349,7 +28803,7 @@ domain, see g_option_context_set_translation_domain().</doc>
2834928803 allow-none="1">
2835028804 <doc xml:space="preserve"
2835128805 filename="glib/goption.c"
28352- line="2428">user data to pass to @func, or %NULL</doc>
28806+ line="2431">user data to pass to @func, or %NULL</doc>
2835328807 <type name="gpointer" c:type="gpointer"/>
2835428808 </parameter>
2835528809 <parameter name="destroy_notify"
@@ -28359,7 +28813,7 @@ domain, see g_option_context_set_translation_domain().</doc>
2835928813 scope="async">
2836028814 <doc xml:space="preserve"
2836128815 filename="glib/goption.c"
28362- line="2429">a function which gets called to free @data, or %NULL</doc>
28816+ line="2432">a function which gets called to free @data, or %NULL</doc>
2836328817 <type name="DestroyNotify" c:type="GDestroyNotify"/>
2836428818 </parameter>
2836528819 </parameters>
@@ -28369,7 +28823,7 @@ domain, see g_option_context_set_translation_domain().</doc>
2836928823 version="2.12">
2837028824 <doc xml:space="preserve"
2837128825 filename="glib/goption.c"
28372- line="2461">A convenience function to use gettext() for translating
28826+ line="2464">A convenience function to use gettext() for translating
2837328827 user-visible strings.</doc>
2837428828 <source-position filename="glib/goption.h" line="382"/>
2837528829 <return-value transfer-ownership="none">
@@ -28379,13 +28833,13 @@ user-visible strings.</doc>
2837928833 <instance-parameter name="context" transfer-ownership="none">
2838028834 <doc xml:space="preserve"
2838128835 filename="glib/goption.c"
28382- line="2463">a #GOptionContext</doc>
28836+ line="2466">a #GOptionContext</doc>
2838328837 <type name="OptionContext" c:type="GOptionContext*"/>
2838428838 </instance-parameter>
2838528839 <parameter name="domain" transfer-ownership="none">
2838628840 <doc xml:space="preserve"
2838728841 filename="glib/goption.c"
28388- line="2464">the domain to use</doc>
28842+ line="2467">the domain to use</doc>
2838928843 <type name="utf8" c:type="const gchar*"/>
2839028844 </parameter>
2839128845 </parameters>
@@ -28676,7 +29130,7 @@ the application can then add to its #GOptionContext.</doc>
2867629130 <constructor name="new" c:identifier="g_option_group_new" version="2.6">
2867729131 <doc xml:space="preserve"
2867829132 filename="glib/goption.c"
28679- line="2133">Creates a new #GOptionGroup.
29133+ line="2136">Creates a new #GOptionGroup.
2868029134
2868129135 @description is typically used to provide a title for the group. If so, it
2868229136 is recommended that it’s written in title case, and has a trailing colon so
@@ -28686,7 +29140,7 @@ that it matches the style of built-in GLib group titles such as
2868629140 <return-value transfer-ownership="full">
2868729141 <doc xml:space="preserve"
2868829142 filename="glib/goption.c"
28689- line="2154">a newly created option group. It should be added
29143+ line="2157">a newly created option group. It should be added
2869029144 to a #GOptionContext or freed with g_option_group_unref().</doc>
2869129145 <type name="OptionGroup" c:type="GOptionGroup*"/>
2869229146 </return-value>
@@ -28694,14 +29148,14 @@ that it matches the style of built-in GLib group titles such as
2869429148 <parameter name="name" transfer-ownership="none">
2869529149 <doc xml:space="preserve"
2869629150 filename="glib/goption.c"
28697- line="2135">the name for the option group, this is used to provide
29151+ line="2138">the name for the option group, this is used to provide
2869829152 help for the options in this group with `--help-`@name</doc>
2869929153 <type name="utf8" c:type="const gchar*"/>
2870029154 </parameter>
2870129155 <parameter name="description" transfer-ownership="none">
2870229156 <doc xml:space="preserve"
2870329157 filename="glib/goption.c"
28704- line="2137">a description for this group to be shown in
29158+ line="2140">a description for this group to be shown in
2870529159 `--help`. This string is translated using the translation
2870629160 domain or translation function of the group</doc>
2870729161 <type name="utf8" c:type="const gchar*"/>
@@ -28709,7 +29163,7 @@ that it matches the style of built-in GLib group titles such as
2870929163 <parameter name="help_description" transfer-ownership="none">
2871029164 <doc xml:space="preserve"
2871129165 filename="glib/goption.c"
28712- line="2140">a description for the `--help-`@name option.
29166+ line="2143">a description for the `--help-`@name option.
2871329167 This string is translated using the translation domain or translation function
2871429168 of the group</doc>
2871529169 <type name="utf8" c:type="const gchar*"/>
@@ -28720,7 +29174,7 @@ that it matches the style of built-in GLib group titles such as
2872029174 allow-none="1">
2872129175 <doc xml:space="preserve"
2872229176 filename="glib/goption.c"
28723- line="2143">user data that will be passed to the pre- and post-parse hooks,
29177+ line="2146">user data that will be passed to the pre- and post-parse hooks,
2872429178 the error hook and to callbacks of %G_OPTION_ARG_CALLBACK options, or %NULL</doc>
2872529179 <type name="gpointer" c:type="gpointer"/>
2872629180 </parameter>
@@ -28731,7 +29185,7 @@ that it matches the style of built-in GLib group titles such as
2873129185 scope="async">
2873229186 <doc xml:space="preserve"
2873329187 filename="glib/goption.c"
28734- line="2145">a function that will be called to free @user_data, or %NULL</doc>
29188+ line="2148">a function that will be called to free @user_data, or %NULL</doc>
2873529189 <type name="DestroyNotify" c:type="GDestroyNotify"/>
2873629190 </parameter>
2873729191 </parameters>
@@ -28741,7 +29195,7 @@ that it matches the style of built-in GLib group titles such as
2874129195 version="2.6">
2874229196 <doc xml:space="preserve"
2874329197 filename="glib/goption.c"
28744- line="2251">Adds the options specified in @entries to @group.</doc>
29198+ line="2254">Adds the options specified in @entries to @group.</doc>
2874529199 <source-position filename="glib/goption.h" line="418"/>
2874629200 <return-value transfer-ownership="none">
2874729201 <type name="none" c:type="void"/>
@@ -28750,13 +29204,13 @@ that it matches the style of built-in GLib group titles such as
2875029204 <instance-parameter name="group" transfer-ownership="none">
2875129205 <doc xml:space="preserve"
2875229206 filename="glib/goption.c"
28753- line="2253">a #GOptionGroup</doc>
29207+ line="2256">a #GOptionGroup</doc>
2875429208 <type name="OptionGroup" c:type="GOptionGroup*"/>
2875529209 </instance-parameter>
2875629210 <parameter name="entries" transfer-ownership="none">
2875729211 <doc xml:space="preserve"
2875829212 filename="glib/goption.c"
28759- line="2254">a %NULL-terminated array of #GOptionEntrys</doc>
29213+ line="2257">a %NULL-terminated array of #GOptionEntrys</doc>
2876029214 <array c:type="const GOptionEntry*">
2876129215 <type name="OptionEntry" c:type="GOptionEntry"/>
2876229216 </array>
@@ -28770,7 +29224,7 @@ that it matches the style of built-in GLib group titles such as
2877029224 deprecated-version="2.44">
2877129225 <doc xml:space="preserve"
2877229226 filename="glib/goption.c"
28773- line="2181">Frees a #GOptionGroup. Note that you must not free groups
29227+ line="2184">Frees a #GOptionGroup. Note that you must not free groups
2877429228 which have been added to a #GOptionContext.</doc>
2877529229 <doc-deprecated xml:space="preserve">Use g_option_group_unref() instead.</doc-deprecated>
2877629230 <source-position filename="glib/goption.h" line="412"/>
@@ -28781,7 +29235,7 @@ which have been added to a #GOptionContext.</doc>
2878129235 <instance-parameter name="group" transfer-ownership="none">
2878229236 <doc xml:space="preserve"
2878329237 filename="glib/goption.c"
28784- line="2183">a #GOptionGroup</doc>
29238+ line="2186">a #GOptionGroup</doc>
2878529239 <type name="OptionGroup" c:type="GOptionGroup*"/>
2878629240 </instance-parameter>
2878729241 </parameters>
@@ -28789,19 +29243,19 @@ which have been added to a #GOptionContext.</doc>
2878929243 <method name="ref" c:identifier="g_option_group_ref" version="2.44">
2879029244 <doc xml:space="preserve"
2879129245 filename="glib/goption.c"
28792- line="2198">Increments the reference count of @group by one.</doc>
29246+ line="2201">Increments the reference count of @group by one.</doc>
2879329247 <source-position filename="glib/goption.h" line="414"/>
2879429248 <return-value transfer-ownership="full">
2879529249 <doc xml:space="preserve"
2879629250 filename="glib/goption.c"
28797- line="2204">a #GOptionGroup</doc>
29251+ line="2207">a #GOptionGroup</doc>
2879829252 <type name="OptionGroup" c:type="GOptionGroup*"/>
2879929253 </return-value>
2880029254 <parameters>
2880129255 <instance-parameter name="group" transfer-ownership="none">
2880229256 <doc xml:space="preserve"
2880329257 filename="glib/goption.c"
28804- line="2200">a #GOptionGroup</doc>
29258+ line="2203">a #GOptionGroup</doc>
2880529259 <type name="OptionGroup" c:type="GOptionGroup*"/>
2880629260 </instance-parameter>
2880729261 </parameters>
@@ -28812,7 +29266,7 @@ which have been added to a #GOptionContext.</doc>
2881229266 introspectable="0">
2881329267 <doc xml:space="preserve"
2881429268 filename="glib/goption.c"
28815- line="2340">Associates a function with @group which will be called
29269+ line="2343">Associates a function with @group which will be called
2881629270 from g_option_context_parse() when an error occurs.
2881729271
2881829272 Note that the user data to be passed to @error_func can be
@@ -28825,13 +29279,13 @@ specified when constructing the group with g_option_group_new().</doc>
2882529279 <instance-parameter name="group" transfer-ownership="none">
2882629280 <doc xml:space="preserve"
2882729281 filename="glib/goption.c"
28828- line="2342">a #GOptionGroup</doc>
29282+ line="2345">a #GOptionGroup</doc>
2882929283 <type name="OptionGroup" c:type="GOptionGroup*"/>
2883029284 </instance-parameter>
2883129285 <parameter name="error_func" transfer-ownership="none">
2883229286 <doc xml:space="preserve"
2883329287 filename="glib/goption.c"
28834- line="2343">a function to call when an error occurs</doc>
29288+ line="2346">a function to call when an error occurs</doc>
2883529289 <type name="OptionErrorFunc" c:type="GOptionErrorFunc"/>
2883629290 </parameter>
2883729291 </parameters>
@@ -28842,7 +29296,7 @@ specified when constructing the group with g_option_group_new().</doc>
2884229296 introspectable="0">
2884329297 <doc xml:space="preserve"
2884429298 filename="glib/goption.c"
28845- line="2313">Associates two functions with @group which will be called
29299+ line="2316">Associates two functions with @group which will be called
2884629300 from g_option_context_parse() before the first option is parsed
2884729301 and after the last option has been parsed, respectively.
2884829302
@@ -28857,7 +29311,7 @@ with g_option_group_new().</doc>
2885729311 <instance-parameter name="group" transfer-ownership="none">
2885829312 <doc xml:space="preserve"
2885929313 filename="glib/goption.c"
28860- line="2315">a #GOptionGroup</doc>
29314+ line="2318">a #GOptionGroup</doc>
2886129315 <type name="OptionGroup" c:type="GOptionGroup*"/>
2886229316 </instance-parameter>
2886329317 <parameter name="pre_parse_func"
@@ -28866,7 +29320,7 @@ with g_option_group_new().</doc>
2886629320 allow-none="1">
2886729321 <doc xml:space="preserve"
2886829322 filename="glib/goption.c"
28869- line="2316">a function to call before parsing, or %NULL</doc>
29323+ line="2319">a function to call before parsing, or %NULL</doc>
2887029324 <type name="OptionParseFunc" c:type="GOptionParseFunc"/>
2887129325 </parameter>
2887229326 <parameter name="post_parse_func"
@@ -28875,7 +29329,7 @@ with g_option_group_new().</doc>
2887529329 allow-none="1">
2887629330 <doc xml:space="preserve"
2887729331 filename="glib/goption.c"
28878- line="2317">a function to call after parsing, or %NULL</doc>
29332+ line="2320">a function to call after parsing, or %NULL</doc>
2887929333 <type name="OptionParseFunc" c:type="GOptionParseFunc"/>
2888029334 </parameter>
2888129335 </parameters>
@@ -28885,7 +29339,7 @@ with g_option_group_new().</doc>
2888529339 version="2.6">
2888629340 <doc xml:space="preserve"
2888729341 filename="glib/goption.c"
28888- line="2363">Sets the function which is used to translate user-visible strings,
29342+ line="2366">Sets the function which is used to translate user-visible strings,
2888929343 for `--help` output. Different groups can use different
2889029344 #GTranslateFuncs. If @func is %NULL, strings are not translated.
2889129345
@@ -28899,7 +29353,7 @@ domain, see g_option_group_set_translation_domain().</doc>
2889929353 <instance-parameter name="group" transfer-ownership="none">
2890029354 <doc xml:space="preserve"
2890129355 filename="glib/goption.c"
28902- line="2365">a #GOptionGroup</doc>
29356+ line="2368">a #GOptionGroup</doc>
2890329357 <type name="OptionGroup" c:type="GOptionGroup*"/>
2890429358 </instance-parameter>
2890529359 <parameter name="func"
@@ -28911,7 +29365,7 @@ domain, see g_option_group_set_translation_domain().</doc>
2891129365 destroy="2">
2891229366 <doc xml:space="preserve"
2891329367 filename="glib/goption.c"
28914- line="2366">the #GTranslateFunc, or %NULL</doc>
29368+ line="2369">the #GTranslateFunc, or %NULL</doc>
2891529369 <type name="TranslateFunc" c:type="GTranslateFunc"/>
2891629370 </parameter>
2891729371 <parameter name="data"
@@ -28920,7 +29374,7 @@ domain, see g_option_group_set_translation_domain().</doc>
2892029374 allow-none="1">
2892129375 <doc xml:space="preserve"
2892229376 filename="glib/goption.c"
28923- line="2367">user data to pass to @func, or %NULL</doc>
29377+ line="2370">user data to pass to @func, or %NULL</doc>
2892429378 <type name="gpointer" c:type="gpointer"/>
2892529379 </parameter>
2892629380 <parameter name="destroy_notify"
@@ -28930,7 +29384,7 @@ domain, see g_option_group_set_translation_domain().</doc>
2893029384 scope="async">
2893129385 <doc xml:space="preserve"
2893229386 filename="glib/goption.c"
28933- line="2368">a function which gets called to free @data, or %NULL</doc>
29387+ line="2371">a function which gets called to free @data, or %NULL</doc>
2893429388 <type name="DestroyNotify" c:type="GDestroyNotify"/>
2893529389 </parameter>
2893629390 </parameters>
@@ -28940,7 +29394,7 @@ domain, see g_option_group_set_translation_domain().</doc>
2894029394 version="2.6">
2894129395 <doc xml:space="preserve"
2894229396 filename="glib/goption.c"
28943- line="2402">A convenience function to use gettext() for translating
29397+ line="2405">A convenience function to use gettext() for translating
2894429398 user-visible strings.</doc>
2894529399 <source-position filename="glib/goption.h" line="426"/>
2894629400 <return-value transfer-ownership="none">
@@ -28950,13 +29404,13 @@ user-visible strings.</doc>
2895029404 <instance-parameter name="group" transfer-ownership="none">
2895129405 <doc xml:space="preserve"
2895229406 filename="glib/goption.c"
28953- line="2404">a #GOptionGroup</doc>
29407+ line="2407">a #GOptionGroup</doc>
2895429408 <type name="OptionGroup" c:type="GOptionGroup*"/>
2895529409 </instance-parameter>
2895629410 <parameter name="domain" transfer-ownership="none">
2895729411 <doc xml:space="preserve"
2895829412 filename="glib/goption.c"
28959- line="2405">the domain to use</doc>
29413+ line="2408">the domain to use</doc>
2896029414 <type name="utf8" c:type="const gchar*"/>
2896129415 </parameter>
2896229416 </parameters>
@@ -28964,7 +29418,7 @@ user-visible strings.</doc>
2896429418 <method name="unref" c:identifier="g_option_group_unref" version="2.44">
2896529419 <doc xml:space="preserve"
2896629420 filename="glib/goption.c"
28967- line="2218">Decrements the reference count of @group by one.
29421+ line="2221">Decrements the reference count of @group by one.
2896829422 If the reference count drops to 0, the @group will be freed.
2896929423 and all memory allocated by the @group is released.</doc>
2897029424 <source-position filename="glib/goption.h" line="416"/>
@@ -28975,7 +29429,7 @@ and all memory allocated by the @group is released.</doc>
2897529429 <instance-parameter name="group" transfer-ownership="none">
2897629430 <doc xml:space="preserve"
2897729431 filename="glib/goption.c"
28978- line="2220">a #GOptionGroup</doc>
29432+ line="2223">a #GOptionGroup</doc>
2897929433 <type name="OptionGroup" c:type="GOptionGroup*"/>
2898029434 </instance-parameter>
2898129435 </parameters>
@@ -29084,7 +29538,7 @@ GdkColor *favourite = traveller_get_favourite_colour (traveller);
2908429538 <constant name="PID_FORMAT" value="i" c:type="G_PID_FORMAT" version="2.50">
2908529539 <doc xml:space="preserve"
2908629540 filename="glib/gmain.h"
29087- line="172">A format specifier that can be used in printf()-style format strings
29541+ line="173">A format specifier that can be used in printf()-style format strings
2908829542 when printing a #GPid.</doc>
2908929543 <source-position filename="glib/glibconfig.h" line="201"/>
2909029544 <type name="utf8" c:type="gchar*"/>
@@ -29114,12 +29568,12 @@ when printing the @fd member of a #GPollFD.</doc>
2911429568 <constant name="PRIORITY_DEFAULT" value="0" c:type="G_PRIORITY_DEFAULT">
2911529569 <doc xml:space="preserve"
2911629570 filename="glib/gmain.h"
29117- line="422">Use this for default priority event sources.
29571+ line="423">Use this for default priority event sources.
2911829572
2911929573 In GLib this priority is used when adding timeout functions
2912029574 with [func@GLib.timeout_add]. In GDK this priority is used for events
2912129575 from the X server.</doc>
29122- <source-position filename="glib/gmain.h" line="431"/>
29576+ <source-position filename="glib/gmain.h" line="432"/>
2912329577 <type name="gint" c:type="gint"/>
2912429578 </constant>
2912529579 <constant name="PRIORITY_DEFAULT_IDLE"
@@ -29127,20 +29581,20 @@ from the X server.</doc>
2912729581 c:type="G_PRIORITY_DEFAULT_IDLE">
2912829582 <doc xml:space="preserve"
2912929583 filename="glib/gmain.h"
29130- line="445">Use this for default priority idle functions.
29584+ line="446">Use this for default priority idle functions.
2913129585
2913229586 In GLib this priority is used when adding idle functions with
2913329587 [func@GLib.idle_add].</doc>
29134- <source-position filename="glib/gmain.h" line="453"/>
29588+ <source-position filename="glib/gmain.h" line="454"/>
2913529589 <type name="gint" c:type="gint"/>
2913629590 </constant>
2913729591 <constant name="PRIORITY_HIGH" value="-100" c:type="G_PRIORITY_HIGH">
2913829592 <doc xml:space="preserve"
2913929593 filename="glib/gmain.h"
29140- line="413">Use this for high priority event sources.
29594+ line="414">Use this for high priority event sources.
2914129595
2914229596 It is not used within GLib or GTK.</doc>
29143- <source-position filename="glib/gmain.h" line="420"/>
29597+ <source-position filename="glib/gmain.h" line="421"/>
2914429598 <type name="gint" c:type="gint"/>
2914529599 </constant>
2914629600 <constant name="PRIORITY_HIGH_IDLE"
@@ -29148,22 +29602,22 @@ It is not used within GLib or GTK.</doc>
2914829602 c:type="G_PRIORITY_HIGH_IDLE">
2914929603 <doc xml:space="preserve"
2915029604 filename="glib/gmain.h"
29151- line="433">Use this for high priority idle functions.
29605+ line="434">Use this for high priority idle functions.
2915229606
2915329607 GTK uses %G_PRIORITY_HIGH_IDLE + 10 for resizing operations,
2915429608 and %G_PRIORITY_HIGH_IDLE + 20 for redrawing operations. (This is
2915529609 done to ensure that any pending resizes are processed before any
2915629610 pending redraws, so that widgets are not redrawn twice unnecessarily.)</doc>
29157- <source-position filename="glib/gmain.h" line="443"/>
29611+ <source-position filename="glib/gmain.h" line="444"/>
2915829612 <type name="gint" c:type="gint"/>
2915929613 </constant>
2916029614 <constant name="PRIORITY_LOW" value="300" c:type="G_PRIORITY_LOW">
2916129615 <doc xml:space="preserve"
2916229616 filename="glib/gmain.h"
29163- line="455">Use this for very low priority background tasks.
29617+ line="456">Use this for very low priority background tasks.
2916429618
2916529619 It is not used within GLib or GTK.</doc>
29166- <source-position filename="glib/gmain.h" line="462"/>
29620+ <source-position filename="glib/gmain.h" line="463"/>
2916729621 <type name="gint" c:type="gint"/>
2916829622 </constant>
2916929623 <function-macro name="PRIVATE_INIT"
@@ -29649,7 +30103,7 @@ If the path buffer is empty, this function returns `NULL`.</doc>
2964930103 line="555">Compares two path buffers for equality and returns `TRUE`
2965030104 if they are equal.
2965130105
29652-The path inside the paths buffers are not going to be normalized,
30106+The paths inside the path buffers are not going to be normalized,
2965330107 so `X/Y/Z/A/..`, `X/./Y/Z` and `X/Y/Z` are not going to be considered
2965430108 equal.
2965530109
@@ -29768,19 +30222,19 @@ pattern compilation.</doc>
2976830222 <method name="copy" c:identifier="g_pattern_spec_copy" version="2.70">
2976930223 <doc xml:space="preserve"
2977030224 filename="glib/gpattern.c"
29771- line="395">Copies @pspec in a new [type@GLib.PatternSpec].</doc>
30225+ line="405">Copies @pspec in a new [type@GLib.PatternSpec].</doc>
2977230226 <source-position filename="glib/gpattern.h" line="39"/>
2977330227 <return-value transfer-ownership="full">
2977430228 <doc xml:space="preserve"
2977530229 filename="glib/gpattern.c"
29776- line="401">a copy of @pspec.</doc>
30230+ line="411">a copy of @pspec.</doc>
2977730231 <type name="PatternSpec" c:type="GPatternSpec*"/>
2977830232 </return-value>
2977930233 <parameters>
2978030234 <instance-parameter name="pspec" transfer-ownership="none">
2978130235 <doc xml:space="preserve"
2978230236 filename="glib/gpattern.c"
29783- line="397">a #GPatternSpec</doc>
30237+ line="407">a #GPatternSpec</doc>
2978430238 <type name="PatternSpec" c:type="GPatternSpec*"/>
2978530239 </instance-parameter>
2978630240 </parameters>
@@ -29788,26 +30242,26 @@ pattern compilation.</doc>
2978830242 <method name="equal" c:identifier="g_pattern_spec_equal">
2978930243 <doc xml:space="preserve"
2979030244 filename="glib/gpattern.c"
29791- line="434">Compares two compiled pattern specs and returns whether they will
30245+ line="444">Compares two compiled pattern specs and returns whether they will
2979230246 match the same set of strings.</doc>
2979330247 <source-position filename="glib/gpattern.h" line="41"/>
2979430248 <return-value transfer-ownership="none">
2979530249 <doc xml:space="preserve"
2979630250 filename="glib/gpattern.c"
29797- line="442">Whether the compiled patterns are equal</doc>
30251+ line="452">Whether the compiled patterns are equal</doc>
2979830252 <type name="gboolean" c:type="gboolean"/>
2979930253 </return-value>
2980030254 <parameters>
2980130255 <instance-parameter name="pspec1" transfer-ownership="none">
2980230256 <doc xml:space="preserve"
2980330257 filename="glib/gpattern.c"
29804- line="436">a #GPatternSpec</doc>
30258+ line="446">a #GPatternSpec</doc>
2980530259 <type name="PatternSpec" c:type="GPatternSpec*"/>
2980630260 </instance-parameter>
2980730261 <parameter name="pspec2" transfer-ownership="none">
2980830262 <doc xml:space="preserve"
2980930263 filename="glib/gpattern.c"
29810- line="437">another #GPatternSpec</doc>
30264+ line="447">another #GPatternSpec</doc>
2981130265 <type name="PatternSpec" c:type="GPatternSpec*"/>
2981230266 </parameter>
2981330267 </parameters>
@@ -29815,7 +30269,7 @@ match the same set of strings.</doc>
2981530269 <method name="free" c:identifier="g_pattern_spec_free">
2981630270 <doc xml:space="preserve"
2981730271 filename="glib/gpattern.c"
29818- line="419">Frees the memory allocated for the [type@GLib.PatternSpec].</doc>
30272+ line="429">Frees the memory allocated for the [type@GLib.PatternSpec].</doc>
2981930273 <source-position filename="glib/gpattern.h" line="37"/>
2982030274 <return-value transfer-ownership="none">
2982130275 <type name="none" c:type="void"/>
@@ -29824,7 +30278,7 @@ match the same set of strings.</doc>
2982430278 <instance-parameter name="pspec" transfer-ownership="none">
2982530279 <doc xml:space="preserve"
2982630280 filename="glib/gpattern.c"
29827- line="421">a #GPatternSpec</doc>
30281+ line="431">a #GPatternSpec</doc>
2982830282 <type name="PatternSpec" c:type="GPatternSpec*"/>
2982930283 </instance-parameter>
2983030284 </parameters>
@@ -29894,7 +30348,7 @@ does not contain any multibyte characters. GLib offers the
2989430348 version="2.70">
2989530349 <doc xml:space="preserve"
2989630350 filename="glib/gpattern.c"
29897- line="456">Matches a string against a compiled pattern.
30351+ line="466">Matches a string against a compiled pattern.
2989830352
2989930353 If the string is to be
2990030354 matched against more than one pattern, consider using
@@ -29903,20 +30357,20 @@ matched against more than one pattern, consider using
2990330357 <return-value transfer-ownership="none">
2990430358 <doc xml:space="preserve"
2990530359 filename="glib/gpattern.c"
29906- line="467">%TRUE if @string matches @pspec</doc>
30360+ line="477">%TRUE if @string matches @pspec</doc>
2990730361 <type name="gboolean" c:type="gboolean"/>
2990830362 </return-value>
2990930363 <parameters>
2991030364 <instance-parameter name="pspec" transfer-ownership="none">
2991130365 <doc xml:space="preserve"
2991230366 filename="glib/gpattern.c"
29913- line="458">a #GPatternSpec</doc>
30367+ line="468">a #GPatternSpec</doc>
2991430368 <type name="PatternSpec" c:type="GPatternSpec*"/>
2991530369 </instance-parameter>
2991630370 <parameter name="string" transfer-ownership="none">
2991730371 <doc xml:space="preserve"
2991830372 filename="glib/gpattern.c"
29919- line="459">the UTF-8 encoded string to match</doc>
30373+ line="469">the UTF-8 encoded string to match</doc>
2992030374 <type name="utf8" c:type="const gchar*"/>
2992130375 </parameter>
2992230376 </parameters>
@@ -29993,9 +30447,9 @@ The semantics of the function should match those of the poll() system call.</doc
2999330447 <callback name="PrintFunc" c:type="GPrintFunc">
2999430448 <doc xml:space="preserve"
2999530449 filename="glib/gmessages.h"
29996- line="518">Specifies the type of the print handler functions.
30450+ line="521">Specifies the type of the print handler functions.
2999730451 These are called with the complete formatted string to output.</doc>
29998- <source-position filename="glib/gmessages.h" line="525"/>
30452+ <source-position filename="glib/gmessages.h" line="528"/>
2999930453 <return-value transfer-ownership="none">
3000030454 <type name="none" c:type="void"/>
3000130455 </return-value>
@@ -30003,7 +30457,7 @@ These are called with the complete formatted string to output.</doc>
3000330457 <parameter name="string" transfer-ownership="none">
3000430458 <doc xml:space="preserve"
3000530459 filename="glib/gmessages.h"
30006- line="520">the message to output</doc>
30460+ line="523">the message to output</doc>
3000730461 <type name="utf8" c:type="const gchar*"/>
3000830462 </parameter>
3000930463 </parameters>
@@ -30154,30 +30608,32 @@ the #GDestroyNotify for @key is not called on the old value.</doc>
3015430608 </record>
3015530609 <record name="PtrArray"
3015630610 c:type="GPtrArray"
30611+ copy-function="g_ptr_array_ref"
30612+ free-function="g_ptr_array_unref"
3015730613 glib:type-name="GPtrArray"
3015830614 glib:get-type="g_ptr_array_get_type"
3015930615 c:symbol-prefix="ptr_array">
3016030616 <doc xml:space="preserve"
3016130617 filename="glib/garray.c"
30162- line="1086">Contains the public fields of a pointer array.</doc>
30618+ line="1098">Contains the public fields of a `GPtrArray`.</doc>
3016330619 <source-position filename="glib/garray.h" line="59"/>
3016430620 <field name="pdata" writable="1">
3016530621 <doc xml:space="preserve"
3016630622 filename="glib/garray.c"
30167- line="1088">points to the array of pointers, which may be moved when the
30623+ line="1100">a pointer to the array of pointers, which may be moved when the
3016830624 array grows</doc>
3016930625 <type name="gpointer" c:type="gpointer*"/>
3017030626 </field>
3017130627 <field name="len" writable="1">
3017230628 <doc xml:space="preserve"
3017330629 filename="glib/garray.c"
30174- line="1090">number of pointers in the array</doc>
30630+ line="1102">the number of pointers in the array</doc>
3017530631 <type name="guint" c:type="guint"/>
3017630632 </field>
3017730633 <function name="add" c:identifier="g_ptr_array_add" introspectable="0">
3017830634 <doc xml:space="preserve"
3017930635 filename="glib/garray.c"
30180- line="2204">Adds a pointer to the end of the pointer array. The array will grow
30636+ line="2221">Adds a pointer to the end of the pointer array. The array will grow
3018130637 in size automatically if necessary.</doc>
3018230638 <source-position filename="glib/garray.h" line="224"/>
3018330639 <return-value transfer-ownership="none">
@@ -30187,7 +30643,7 @@ in size automatically if necessary.</doc>
3018730643 <parameter name="array" transfer-ownership="none">
3018830644 <doc xml:space="preserve"
3018930645 filename="glib/garray.c"
30190- line="2206">a #GPtrArray</doc>
30646+ line="2223">a pointer array</doc>
3019130647 <array name="GLib.PtrArray" c:type="GPtrArray*">
3019230648 <type name="gpointer" c:type="gpointer"/>
3019330649 </array>
@@ -30198,7 +30654,7 @@ in size automatically if necessary.</doc>
3019830654 allow-none="1">
3019930655 <doc xml:space="preserve"
3020030656 filename="glib/garray.c"
30201- line="2207">the pointer to add</doc>
30657+ line="2224">the pointer to add</doc>
3020230658 <type name="gpointer" c:type="gpointer"/>
3020330659 </parameter>
3020430660 </parameters>
@@ -30209,25 +30665,27 @@ in size automatically if necessary.</doc>
3020930665 introspectable="0">
3021030666 <doc xml:space="preserve"
3021130667 filename="glib/garray.c"
30212- line="1485">Makes a full (deep) copy of a #GPtrArray.
30668+ line="1498">Makes a full (deep) copy of a `GPtrArray`.
3021330669
30214-@func, as a #GCopyFunc, takes two arguments, the data to be copied
30215-and a @user_data pointer. On common processor architectures, it's safe to
30216-pass %NULL as @user_data if the copy function takes only one argument. You
30670+@func, as a [callback@GLib.CopyFunc], takes two arguments, the data to be
30671+copied
30672+and a @user_data pointer. On common processor architectures, it’s safe to
30673+pass `NULL` as @user_data if the copy function takes only one argument. You
3021730674 may get compiler warnings from this though if compiling with GCC’s
3021830675 `-Wcast-function-type` warning.
3021930676
30220-If @func is %NULL, then only the pointers (and not what they are
30221-pointing to) are copied to the new #GPtrArray.
30677+If @func is `NULL`, then only the pointers (and not what they are
30678+pointing to) are copied to the new `GPtrArray`.
3022230679
30223-The copy of @array will have the same #GDestroyNotify for its elements as
30224-@array. The copy will also be %NULL terminated if (and only if) the source
30680+The copy of @array will have the same [callback@GLib.DestroyNotify] for its
30681+elements as
30682+@array. The copy will also be `NULL` terminated if (and only if) the source
3022530683 array is.</doc>
3022630684 <source-position filename="glib/garray.h" line="168"/>
3022730685 <return-value transfer-ownership="full">
3022830686 <doc xml:space="preserve"
3022930687 filename="glib/garray.c"
30230- line="1506">a deep copy of the initial #GPtrArray.</doc>
30688+ line="1521">The deep copy of the initial `GPtrArray`</doc>
3023130689 <array name="GLib.PtrArray" c:type="GPtrArray*">
3023230690 <type name="gpointer" c:type="gpointer"/>
3023330691 </array>
@@ -30236,7 +30694,7 @@ array is.</doc>
3023630694 <parameter name="array" transfer-ownership="none">
3023730695 <doc xml:space="preserve"
3023830696 filename="glib/garray.c"
30239- line="1487">#GPtrArray to duplicate</doc>
30697+ line="1500">a pointer array to duplicate</doc>
3024030698 <array name="GLib.PtrArray" c:type="GPtrArray*">
3024130699 <type name="gpointer" c:type="gpointer"/>
3024230700 </array>
@@ -30245,10 +30703,11 @@ array is.</doc>
3024530703 transfer-ownership="none"
3024630704 nullable="1"
3024730705 allow-none="1"
30706+ scope="call"
3024830707 closure="2">
3024930708 <doc xml:space="preserve"
3025030709 filename="glib/garray.c"
30251- line="1488">a copy function used to copy every element in the array</doc>
30710+ line="1501">a copy function used to copy every element in the array</doc>
3025230711 <type name="CopyFunc" c:type="GCopyFunc"/>
3025330712 </parameter>
3025430713 <parameter name="user_data"
@@ -30257,7 +30716,7 @@ array is.</doc>
3025730716 allow-none="1">
3025830717 <doc xml:space="preserve"
3025930718 filename="glib/garray.c"
30260- line="1489">user data passed to the copy function @func, or %NULL</doc>
30719+ line="1502">the user data passed to the copy function @func</doc>
3026130720 <type name="gpointer" c:type="gpointer"/>
3026230721 </parameter>
3026330722 </parameters>
@@ -30268,20 +30727,21 @@ array is.</doc>
3026830727 introspectable="0">
3026930728 <doc xml:space="preserve"
3027030729 filename="glib/garray.c"
30271- line="2228">Adds all pointers of @array to the end of the array @array_to_extend.
30730+ line="2245">Adds all pointers of @array to the end of the array @array_to_extend.
3027230731 The array will grow in size automatically if needed. @array_to_extend is
3027330732 modified in-place.
3027430733
30275-@func, as a #GCopyFunc, takes two arguments, the data to be copied
30276-and a @user_data pointer. On common processor architectures, it's safe to
30277-pass %NULL as @user_data if the copy function takes only one argument. You
30734+@func, as a [callback@GLib.CopyFunc], takes two arguments, the data to be
30735+copied
30736+and a @user_data pointer. On common processor architectures, it’s safe to
30737+pass `NULL` as @user_data if the copy function takes only one argument. You
3027830738 may get compiler warnings from this though if compiling with GCC’s
3027930739 `-Wcast-function-type` warning.
3028030740
30281-If @func is %NULL, then only the pointers (and not what they are
30282-pointing to) are copied to the new #GPtrArray.
30741+If @func is `NULL`, then only the pointers (and not what they are
30742+pointing to) are copied to the new `GPtrArray`.
3028330743
30284-Whether @array_to_extend is %NULL terminated stays unchanged by this function.</doc>
30744+Whether @array_to_extend is `NULL` terminated stays unchanged by this function.</doc>
3028530745 <source-position filename="glib/garray.h" line="227"/>
3028630746 <return-value transfer-ownership="none">
3028730747 <type name="none" c:type="void"/>
@@ -30290,7 +30750,7 @@ Whether @array_to_extend is %NULL terminated stays unchanged by this function.</
3029030750 <parameter name="array_to_extend" transfer-ownership="none">
3029130751 <doc xml:space="preserve"
3029230752 filename="glib/garray.c"
30293- line="2230">a #GPtrArray.</doc>
30753+ line="2247">a pointer array</doc>
3029430754 <array name="GLib.PtrArray" c:type="GPtrArray*">
3029530755 <type name="gpointer" c:type="gpointer"/>
3029630756 </array>
@@ -30298,7 +30758,7 @@ Whether @array_to_extend is %NULL terminated stays unchanged by this function.</
3029830758 <parameter name="array" transfer-ownership="none">
3029930759 <doc xml:space="preserve"
3030030760 filename="glib/garray.c"
30301- line="2231">a #GPtrArray to add to the end of @array_to_extend.</doc>
30761+ line="2248">a pointer array to add to the end of @array_to_extend</doc>
3030230762 <array name="GLib.PtrArray" c:type="GPtrArray*">
3030330763 <type name="gpointer" c:type="gpointer"/>
3030430764 </array>
@@ -30307,10 +30767,11 @@ Whether @array_to_extend is %NULL terminated stays unchanged by this function.</
3030730767 transfer-ownership="none"
3030830768 nullable="1"
3030930769 allow-none="1"
30770+ scope="call"
3031030771 closure="3">
3031130772 <doc xml:space="preserve"
3031230773 filename="glib/garray.c"
30313- line="2232">a copy function used to copy every element in the array</doc>
30774+ line="2249">a copy function used to copy every element in the array</doc>
3031430775 <type name="CopyFunc" c:type="GCopyFunc"/>
3031530776 </parameter>
3031630777 <parameter name="user_data"
@@ -30319,7 +30780,7 @@ Whether @array_to_extend is %NULL terminated stays unchanged by this function.</
3031930780 allow-none="1">
3032030781 <doc xml:space="preserve"
3032130782 filename="glib/garray.c"
30322- line="2233">user data passed to the copy function @func, or %NULL</doc>
30783+ line="2250">the user data passed to the copy function @func</doc>
3032330784 <type name="gpointer" c:type="gpointer"/>
3032430785 </parameter>
3032530786 </parameters>
@@ -30330,12 +30791,12 @@ Whether @array_to_extend is %NULL terminated stays unchanged by this function.</
3033030791 introspectable="0">
3033130792 <doc xml:space="preserve"
3033230793 filename="glib/garray.c"
30333- line="2291">Adds all the pointers in @array to the end of @array_to_extend, transferring
30794+ line="2305">Adds all the pointers in @array to the end of @array_to_extend, transferring
3033430795 ownership of each element from @array to @array_to_extend and modifying
3033530796 @array_to_extend in-place. @array is then freed.
3033630797
30337-As with g_ptr_array_free(), @array will be destroyed if its reference count
30338-is 1. If its reference count is higher, it will be decremented and the
30798+As with [func@GLib.PtrArray.free], @array will be destroyed if its reference
30799+count is 1. If its reference count is higher, it will be decremented and the
3033930800 length of @array set to zero.</doc>
3034030801 <source-position filename="glib/garray.h" line="232"/>
3034130802 <return-value transfer-ownership="none">
@@ -30345,7 +30806,7 @@ length of @array set to zero.</doc>
3034530806 <parameter name="array_to_extend" transfer-ownership="none">
3034630807 <doc xml:space="preserve"
3034730808 filename="glib/garray.c"
30348- line="2293">a #GPtrArray.</doc>
30809+ line="2307">a pointer array</doc>
3034930810 <array name="GLib.PtrArray" c:type="GPtrArray*">
3035030811 <type name="gpointer" c:type="gpointer"/>
3035130812 </array>
@@ -30353,8 +30814,8 @@ length of @array set to zero.</doc>
3035330814 <parameter name="array" transfer-ownership="container">
3035430815 <doc xml:space="preserve"
3035530816 filename="glib/garray.c"
30356- line="2294">a #GPtrArray to add to the end of
30357- @array_to_extend.</doc>
30817+ line="2308">a pointer array to add to the end of
30818+ @array_to_extend</doc>
3035830819 <array name="GLib.PtrArray" c:type="GPtrArray*">
3035930820 <type name="gpointer" c:type="gpointer"/>
3036030821 </array>
@@ -30367,25 +30828,26 @@ length of @array set to zero.</doc>
3036730828 introspectable="0">
3036830829 <doc xml:space="preserve"
3036930830 filename="glib/garray.c"
30370- line="2601">Checks whether @needle exists in @haystack. If the element is found, %TRUE is
30371-returned and the element’s index is returned in @index_ (if non-%NULL).
30372-Otherwise, %FALSE is returned and @index_ is undefined. If @needle exists
30831+ line="2620">Checks whether @needle exists in @haystack. If the element is found, true
30832+is returned and the element’s index is returned in @index_ (if non-`NULL`).
30833+Otherwise, false is returned and @index_ is undefined. If @needle exists
3037330834 multiple times in @haystack, the index of the first instance is returned.
3037430835
3037530836 This does pointer comparisons only. If you want to use more complex equality
30376-checks, such as string comparisons, use g_ptr_array_find_with_equal_func().</doc>
30837+checks, such as string comparisons, use
30838+[func@GLib.PtrArray.find_with_equal_func].</doc>
3037730839 <source-position filename="glib/garray.h" line="257"/>
3037830840 <return-value transfer-ownership="none">
3037930841 <doc xml:space="preserve"
3038030842 filename="glib/garray.c"
30381- line="2616">%TRUE if @needle is one of the elements of @haystack</doc>
30843+ line="2636">true if @needle is one of the elements of @haystack; false otherwise</doc>
3038230844 <type name="gboolean" c:type="gboolean"/>
3038330845 </return-value>
3038430846 <parameters>
3038530847 <parameter name="haystack" transfer-ownership="none">
3038630848 <doc xml:space="preserve"
3038730849 filename="glib/garray.c"
30388- line="2603">pointer array to be searched</doc>
30850+ line="2622">the pointer array to be searched</doc>
3038930851 <array name="GLib.PtrArray" c:type="GPtrArray*">
3039030852 <type name="gpointer" c:type="gpointer"/>
3039130853 </array>
@@ -30396,7 +30858,7 @@ checks, such as string comparisons, use g_ptr_array_find_with_equal_func().</doc
3039630858 allow-none="1">
3039730859 <doc xml:space="preserve"
3039830860 filename="glib/garray.c"
30399- line="2604">pointer to look for</doc>
30861+ line="2623">the pointer to look for</doc>
3040030862 <type name="gpointer" c:type="gconstpointer"/>
3040130863 </parameter>
3040230864 <parameter name="index_"
@@ -30407,7 +30869,7 @@ checks, such as string comparisons, use g_ptr_array_find_with_equal_func().</doc
3040730869 allow-none="1">
3040830870 <doc xml:space="preserve"
3040930871 filename="glib/garray.c"
30410- line="2605">return location for the index of
30872+ line="2624">the return location for the index of
3041130873 the element, if found</doc>
3041230874 <type name="guint" c:type="guint*"/>
3041330875 </parameter>
@@ -30419,27 +30881,27 @@ checks, such as string comparisons, use g_ptr_array_find_with_equal_func().</doc
3041930881 introspectable="0">
3042030882 <doc xml:space="preserve"
3042130883 filename="glib/garray.c"
30422- line="2627">Checks whether @needle exists in @haystack, using the given @equal_func.
30423-If the element is found, %TRUE is returned and the element’s index is
30424-returned in @index_ (if non-%NULL). Otherwise, %FALSE is returned and @index_
30884+ line="2647">Checks whether @needle exists in @haystack, using the given @equal_func.
30885+If the element is found, true is returned and the element’s index is
30886+returned in @index_ (if non-`NULL`). Otherwise, false is returned and @index_
3042530887 is undefined. If @needle exists multiple times in @haystack, the index of
3042630888 the first instance is returned.
3042730889
3042830890 @equal_func is called with the element from the array as its first parameter,
30429-and @needle as its second parameter. If @equal_func is %NULL, pointer
30891+and @needle as its second parameter. If @equal_func is `NULL`, pointer
3043030892 equality is used.</doc>
3043130893 <source-position filename="glib/garray.h" line="261"/>
3043230894 <return-value transfer-ownership="none">
3043330895 <doc xml:space="preserve"
3043430896 filename="glib/garray.c"
30435- line="2647">%TRUE if @needle is one of the elements of @haystack</doc>
30897+ line="2667">true if @needle is one of the elements of @haystack; false otherwise</doc>
3043630898 <type name="gboolean" c:type="gboolean"/>
3043730899 </return-value>
3043830900 <parameters>
3043930901 <parameter name="haystack" transfer-ownership="none">
3044030902 <doc xml:space="preserve"
3044130903 filename="glib/garray.c"
30442- line="2629">pointer array to be searched</doc>
30904+ line="2649">the pointer array to be searched</doc>
3044330905 <array name="GLib.PtrArray" c:type="GPtrArray*">
3044430906 <type name="gpointer" c:type="gpointer"/>
3044530907 </array>
@@ -30450,7 +30912,7 @@ equality is used.</doc>
3045030912 allow-none="1">
3045130913 <doc xml:space="preserve"
3045230914 filename="glib/garray.c"
30453- line="2630">pointer to look for</doc>
30915+ line="2650">the pointer to look for</doc>
3045430916 <type name="gpointer" c:type="gconstpointer"/>
3045530917 </parameter>
3045630918 <parameter name="equal_func"
@@ -30459,8 +30921,8 @@ equality is used.</doc>
3045930921 allow-none="1">
3046030922 <doc xml:space="preserve"
3046130923 filename="glib/garray.c"
30462- line="2631">the function to call for each element, which should
30463- return %TRUE when the desired element is found; or %NULL to use pointer
30924+ line="2651">the function to call for each element, which should
30925+ return true when the desired element is found; or `NULL` to use pointer
3046430926 equality</doc>
3046530927 <type name="EqualFunc" c:type="GEqualFunc"/>
3046630928 </parameter>
@@ -30472,7 +30934,7 @@ equality is used.</doc>
3047230934 allow-none="1">
3047330935 <doc xml:space="preserve"
3047430936 filename="glib/garray.c"
30475- line="2634">return location for the index of
30937+ line="2654">the return location for the index of
3047630938 the element, if found</doc>
3047730939 <type name="guint" c:type="guint*"/>
3047830940 </parameter>
@@ -30484,7 +30946,7 @@ equality is used.</doc>
3048430946 introspectable="0">
3048530947 <doc xml:space="preserve"
3048630948 filename="glib/garray.c"
30487- line="2577">Calls a function for each element of a #GPtrArray. @func must not
30949+ line="2596">Calls a function for each element of a `GPtrArray`. @func must not
3048830950 add elements to or remove elements from the array.</doc>
3048930951 <source-position filename="glib/garray.h" line="253"/>
3049030952 <return-value transfer-ownership="none">
@@ -30494,15 +30956,18 @@ add elements to or remove elements from the array.</doc>
3049430956 <parameter name="array" transfer-ownership="none">
3049530957 <doc xml:space="preserve"
3049630958 filename="glib/garray.c"
30497- line="2579">a #GPtrArray</doc>
30959+ line="2598">a pointer array</doc>
3049830960 <array name="GLib.PtrArray" c:type="GPtrArray*">
3049930961 <type name="gpointer" c:type="gpointer"/>
3050030962 </array>
3050130963 </parameter>
30502- <parameter name="func" transfer-ownership="none" closure="2">
30964+ <parameter name="func"
30965+ transfer-ownership="none"
30966+ scope="call"
30967+ closure="2">
3050330968 <doc xml:space="preserve"
3050430969 filename="glib/garray.c"
30505- line="2580">the function to call for each array element</doc>
30970+ line="2599">the function to call for each array element</doc>
3050630971 <type name="Func" c:type="GFunc"/>
3050730972 </parameter>
3050830973 <parameter name="user_data"
@@ -30511,7 +30976,7 @@ add elements to or remove elements from the array.</doc>
3051130976 allow-none="1">
3051230977 <doc xml:space="preserve"
3051330978 filename="glib/garray.c"
30514- line="2581">user data to pass to the function</doc>
30979+ line="2600">the user data to pass to the function</doc>
3051530980 <type name="gpointer" c:type="gpointer"/>
3051630981 </parameter>
3051730982 </parameters>
@@ -30519,37 +30984,39 @@ add elements to or remove elements from the array.</doc>
3051930984 <function name="free" c:identifier="g_ptr_array_free" introspectable="0">
3052030985 <doc xml:space="preserve"
3052130986 filename="glib/garray.c"
30522- line="1776">Frees the memory allocated for the #GPtrArray. If @free_segment is %TRUE
30523-it frees the memory block holding the elements as well. Pass %FALSE
30524-if you want to free the #GPtrArray wrapper but preserve the
30987+ line="1791">Frees the memory allocated for the `GPtrArray`. If @free_segment is true
30988+it frees the memory block holding the elements as well. Pass false
30989+if you want to free the `GPtrArray` wrapper but preserve the
3052530990 underlying array for use elsewhere. If the reference count of @array
30526-is greater than one, the #GPtrArray wrapper is preserved but the
30991+is greater than one, the `GPtrArray` wrapper is preserved but the
3052730992 size of @array will be set to zero.
3052830993
3052930994 If array contents point to dynamically-allocated memory, they should
30530-be freed separately if @free_segment is %TRUE and no #GDestroyNotify
30531-function has been set for @array.
30995+be freed separately if @free_segment is true and no
30996+[callback@GLib.DestroyNotify] function has been set for @array.
3053230997
30533-Note that if the array is %NULL terminated and @free_segment is %FALSE
30534-then this will always return an allocated %NULL terminated buffer.
30535-If pdata is previously %NULL, a new buffer will be allocated.
30998+Note that if the array is `NULL` terminated and @free_segment is false
30999+then this will always return an allocated `NULL` terminated buffer.
31000+If `pdata` is previously `NULL`, a new buffer will be allocated.
3053631001
30537-This function is not thread-safe. If using a #GPtrArray from multiple
30538-threads, use only the atomic g_ptr_array_ref() and g_ptr_array_unref()
30539-functions.</doc>
31002+This function is not thread-safe. If using a `GPtrArray` from multiple
31003+threads, use only the atomic [func@GLib.PtrArray.ref] and
31004+[func@GLib.PtrArray.unref] functions.</doc>
3054031005 <source-position filename="glib/garray.h" line="189"/>
3054131006 <return-value transfer-ownership="full" nullable="1">
3054231007 <doc xml:space="preserve"
3054331008 filename="glib/garray.c"
30544- line="1800">the pointer array if @free_segment is
30545- %FALSE, otherwise %NULL. The pointer array should be freed using g_free().</doc>
30546- <type name="gpointer" c:type="gpointer*"/>
31009+ line="1815">The allocated pointer array if
31010+ @free_segment is false, otherwise `NULL`.</doc>
31011+ <array zero-terminated="0" c:type="gpointer*">
31012+ <type name="gpointer" c:type="gpointer"/>
31013+ </array>
3054731014 </return-value>
3054831015 <parameters>
30549- <parameter name="array" transfer-ownership="none">
31016+ <parameter name="array" transfer-ownership="full">
3055031017 <doc xml:space="preserve"
3055131018 filename="glib/garray.c"
30552- line="1778">a #GPtrArray</doc>
31019+ line="1793">a pointer array</doc>
3055331020 <array name="GLib.PtrArray" c:type="GPtrArray*">
3055431021 <type name="gpointer" c:type="gpointer"/>
3055531022 </array>
@@ -30557,7 +31024,7 @@ functions.</doc>
3055731024 <parameter name="free_segment" transfer-ownership="none">
3055831025 <doc xml:space="preserve"
3055931026 filename="glib/garray.c"
30560- line="1779">if %TRUE the actual pointer array is freed as well</doc>
31027+ line="1794">if true, the actual pointer array is freed as well</doc>
3056131028 <type name="gboolean" c:type="gboolean"/>
3056231029 </parameter>
3056331030 </parameters>
@@ -30568,7 +31035,7 @@ functions.</doc>
3056831035 introspectable="0">
3056931036 <doc xml:space="preserve"
3057031037 filename="glib/garray.c"
30571- line="2324">Inserts an element into the pointer array at the given index. The
31038+ line="2341">Inserts an element into the pointer array at the given index. The
3057231039 array will grow in size automatically if necessary.</doc>
3057331040 <source-position filename="glib/garray.h" line="235"/>
3057431041 <return-value transfer-ownership="none">
@@ -30578,7 +31045,7 @@ array will grow in size automatically if necessary.</doc>
3057831045 <parameter name="array" transfer-ownership="none">
3057931046 <doc xml:space="preserve"
3058031047 filename="glib/garray.c"
30581- line="2326">a #GPtrArray</doc>
31048+ line="2343">a pointer array</doc>
3058231049 <array name="GLib.PtrArray" c:type="GPtrArray*">
3058331050 <type name="gpointer" c:type="gpointer"/>
3058431051 </array>
@@ -30586,7 +31053,7 @@ array will grow in size automatically if necessary.</doc>
3058631053 <parameter name="index_" transfer-ownership="none">
3058731054 <doc xml:space="preserve"
3058831055 filename="glib/garray.c"
30589- line="2327">the index to place the new element at, or -1 to append</doc>
31056+ line="2344">the index to place the new element at, or -1 to append</doc>
3059031057 <type name="gint" c:type="gint"/>
3059131058 </parameter>
3059231059 <parameter name="data"
@@ -30595,7 +31062,7 @@ array will grow in size automatically if necessary.</doc>
3059531062 allow-none="1">
3059631063 <doc xml:space="preserve"
3059731064 filename="glib/garray.c"
30598- line="2328">the pointer to add.</doc>
31065+ line="2345">the pointer to add</doc>
3059931066 <type name="gpointer" c:type="gpointer"/>
3060031067 </parameter>
3060131068 </parameters>
@@ -30606,24 +31073,24 @@ array will grow in size automatically if necessary.</doc>
3060631073 introspectable="0">
3060731074 <doc xml:space="preserve"
3060831075 filename="glib/garray.c"
30609- line="1706">Gets whether the @array was constructed as %NULL-terminated.
31076+ line="1721">Checks whether the @array was constructed as `NULL`-terminated.
3061031077
30611-This will only return %TRUE for arrays constructed by passing %TRUE to the
30612-`null_terminated` argument of g_ptr_array_new_null_terminated(). It will not
30613-return %TRUE for normal arrays which have had a %NULL element appended to
30614-them.</doc>
31078+This will only return true for arrays constructed by passing true to the
31079+`null_terminated` argument of [func@GLib.PtrArray.new_null_terminated]. It
31080+will not return true for normal arrays which have had a `NULL` element
31081+appended to them.</doc>
3061531082 <source-position filename="glib/garray.h" line="267"/>
3061631083 <return-value transfer-ownership="none">
3061731084 <doc xml:space="preserve"
3061831085 filename="glib/garray.c"
30619- line="1717">%TRUE if the array is made to be %NULL terminated.</doc>
31086+ line="1732">true if the array is made to be `NULL` terminated; false otherwise</doc>
3062031087 <type name="gboolean" c:type="gboolean"/>
3062131088 </return-value>
3062231089 <parameters>
3062331090 <parameter name="array" transfer-ownership="none">
3062431091 <doc xml:space="preserve"
3062531092 filename="glib/garray.c"
30626- line="1708">the #GPtrArray</doc>
31093+ line="1723">a pointer array</doc>
3062731094 <array name="GLib.PtrArray" c:type="GPtrArray*">
3062831095 <type name="gpointer" c:type="gpointer"/>
3062931096 </array>
@@ -30633,12 +31100,12 @@ them.</doc>
3063331100 <function name="new" c:identifier="g_ptr_array_new" introspectable="0">
3063431101 <doc xml:space="preserve"
3063531102 filename="glib/garray.c"
30636- line="1165">Creates a new #GPtrArray with a reference count of 1.</doc>
31103+ line="1173">Creates a new `GPtrArray` with a reference count of 1.</doc>
3063731104 <source-position filename="glib/garray.h" line="151"/>
30638- <return-value>
31105+ <return-value transfer-ownership="full">
3063931106 <doc xml:space="preserve"
3064031107 filename="glib/garray.c"
30641- line="1170">the new #GPtrArray</doc>
31108+ line="1178">The new `GPtrArray`</doc>
3064231109 <array name="GLib.PtrArray" c:type="GPtrArray*">
3064331110 <type name="gpointer" c:type="gpointer"/>
3064431111 </array>
@@ -30650,27 +31117,28 @@ them.</doc>
3065031117 introspectable="0">
3065131118 <doc xml:space="preserve"
3065231119 filename="glib/garray.c"
30653- line="1313">Creates a new #GPtrArray, copying @len pointers from @data, and setting
31120+ line="1326">Creates a new `GPtrArray`, copying @len pointers from @data, and setting
3065431121 the array’s reference count to 1.
3065531122
3065631123 This avoids having to manually add each element one by one.
3065731124
3065831125 If @copy_func is provided, then it is used to copy each element before
30659-adding them to the new array. If it is %NULL then the pointers are copied
31126+adding them to the new array. If it is `NULL` then the pointers are copied
3066031127 directly.
3066131128
3066231129 It also sets @element_free_func for freeing each element when the array is
30663-destroyed either via g_ptr_array_unref(), when g_ptr_array_free() is called
30664-with @free_segment set to %TRUE or when removing elements.
31130+destroyed either via [func@GLib.PtrArray.unref], when
31131+[func@GLib.PtrArray.free] is called with @free_segment set to true or when
31132+removing elements.
3066531133
30666-Do not use it if @len is greater than %G_MAXUINT. #GPtrArray
30667-stores the length of its data in #guint, which may be shorter than
30668-#gsize.</doc>
31134+Do not use it if @len is greater than [`G_MAXUINT`](types.html#guint).
31135+`GPtrArray` stores the length of its data in `guint`, which may be shorter
31136+than `gsize`.</doc>
3066931137 <source-position filename="glib/garray.h" line="159"/>
3067031138 <return-value transfer-ownership="full">
3067131139 <doc xml:space="preserve"
3067231140 filename="glib/garray.c"
30673- line="1341">A new #GPtrArray</doc>
31141+ line="1354">The new `GPtrArray`</doc>
3067431142 <array name="GLib.PtrArray" c:type="GPtrArray*">
3067531143 <type name="gpointer" c:type="gpointer"/>
3067631144 </array>
@@ -30682,8 +31150,7 @@ stores the length of its data in #guint, which may be shorter than
3068231150 allow-none="1">
3068331151 <doc xml:space="preserve"
3068431152 filename="glib/garray.c"
30685- line="1315">an array of pointers,
30686-or %NULL for an empty array</doc>
31153+ line="1328">an array of pointers</doc>
3068731154 <array length="1" zero-terminated="0" c:type="gpointer*">
3068831155 <type name="gpointer" c:type="gpointer"/>
3068931156 </array>
@@ -30691,7 +31158,7 @@ or %NULL for an empty array</doc>
3069131158 <parameter name="len" transfer-ownership="none">
3069231159 <doc xml:space="preserve"
3069331160 filename="glib/garray.c"
30694- line="1317">the number of pointers in @data</doc>
31161+ line="1329">the number of pointers in @data</doc>
3069531162 <type name="gsize" c:type="gsize"/>
3069631163 </parameter>
3069731164 <parameter name="copy_func"
@@ -30703,8 +31170,8 @@ or %NULL for an empty array</doc>
3070331170 destroy="4">
3070431171 <doc xml:space="preserve"
3070531172 filename="glib/garray.c"
30706- line="1318">a copy function used to copy every element in the
30707- array or %NULL.</doc>
31173+ line="1330">a copy function used to copy every element in the
31174+ array</doc>
3070831175 <type name="CopyFunc" c:type="GCopyFunc"/>
3070931176 </parameter>
3071031177 <parameter name="copy_func_user_data"
@@ -30713,7 +31180,7 @@ or %NULL for an empty array</doc>
3071331180 allow-none="1">
3071431181 <doc xml:space="preserve"
3071531182 filename="glib/garray.c"
30716- line="1320">user data passed to @copy_func, or %NULL</doc>
31183+ line="1332">the user data passed to @copy_func</doc>
3071731184 <type name="gpointer" c:type="gpointer"/>
3071831185 </parameter>
3071931186 <parameter name="element_free_func"
@@ -30723,8 +31190,8 @@ or %NULL for an empty array</doc>
3072331190 scope="async">
3072431191 <doc xml:space="preserve"
3072531192 filename="glib/garray.c"
30726- line="1321">a function to free elements on @array
30727- destruction or %NULL</doc>
31193+ line="1333">a function to free elements on @array
31194+ destruction</doc>
3072831195 <type name="DestroyNotify" c:type="GDestroyNotify"/>
3072931196 </parameter>
3073031197 </parameters>
@@ -30735,23 +31202,24 @@ or %NULL for an empty array</doc>
3073531202 introspectable="0">
3073631203 <doc xml:space="preserve"
3073731204 filename="glib/garray.c"
30738- line="1359">Creates a new #GPtrArray copying the pointers from @data after having
31205+ line="1372">Creates a new `GPtrArray` copying the pointers from @data after having
3073931206 computed the length of it and with a reference count of 1.
3074031207 This avoids having to manually add each element one by one.
3074131208 If @copy_func is provided, then it is used to copy the data in the new
3074231209 array.
30743-It also set @element_free_func for freeing each element when the array is
30744-destroyed either via g_ptr_array_unref(), when g_ptr_array_free() is called
30745-with @free_segment set to %TRUE or when removing elements.
31210+It also sets @element_free_func for freeing each element when the array is
31211+destroyed either via [func@GLib.PtrArray.unref], when
31212+[func@GLib.PtrArray.free] is called with @free_segment set to true or when
31213+removing elements.
3074631214
30747-Do not use it if the @data has more than %G_MAXUINT elements. #GPtrArray
30748-stores the length of its data in #guint, which may be shorter than
30749-#gsize.</doc>
31215+Do not use it if the @data has more than [`G_MAXUINT`](types.html#guint)
31216+elements. `GPtrArray` stores the length of its data in `guint`, which may be
31217+shorter than `gsize`.</doc>
3075031218 <source-position filename="glib/garray.h" line="184"/>
3075131219 <return-value transfer-ownership="full">
3075231220 <doc xml:space="preserve"
3075331221 filename="glib/garray.c"
30754- line="1382">A new #GPtrArray</doc>
31222+ line="1396">The new `GPtrArray`</doc>
3075531223 <array name="GLib.PtrArray" c:type="GPtrArray*">
3075631224 <type name="gpointer" c:type="gpointer"/>
3075731225 </array>
@@ -30763,8 +31231,8 @@ stores the length of its data in #guint, which may be shorter than
3076331231 allow-none="1">
3076431232 <doc xml:space="preserve"
3076531233 filename="glib/garray.c"
30766- line="1361">an array of
30767- pointers, %NULL terminated; or %NULL for an empty array</doc>
31234+ line="1374">an array of
31235+ pointers, `NULL` terminated</doc>
3076831236 <array c:type="gpointer*">
3076931237 <type name="gpointer" c:type="gpointer"/>
3077031238 </array>
@@ -30778,8 +31246,8 @@ stores the length of its data in #guint, which may be shorter than
3077831246 destroy="3">
3077931247 <doc xml:space="preserve"
3078031248 filename="glib/garray.c"
30781- line="1363">a copy function used to copy every element in the
30782- array or %NULL.</doc>
31249+ line="1376">a copy function used to copy every element in the
31250+ array</doc>
3078331251 <type name="CopyFunc" c:type="GCopyFunc"/>
3078431252 </parameter>
3078531253 <parameter name="copy_func_user_data"
@@ -30788,7 +31256,7 @@ stores the length of its data in #guint, which may be shorter than
3078831256 allow-none="1">
3078931257 <doc xml:space="preserve"
3079031258 filename="glib/garray.c"
30791- line="1365">user data passed to @copy_func, or %NULL</doc>
31259+ line="1378">the user data passed to @copy_func</doc>
3079231260 <type name="gpointer" c:type="gpointer"/>
3079331261 </parameter>
3079431262 <parameter name="element_free_func"
@@ -30798,8 +31266,8 @@ stores the length of its data in #guint, which may be shorter than
3079831266 scope="async">
3079931267 <doc xml:space="preserve"
3080031268 filename="glib/garray.c"
30801- line="1366">a function to free elements on @array
30802- destruction or %NULL</doc>
31269+ line="1379">a function to free elements on @array
31270+ destruction</doc>
3080331271 <type name="DestroyNotify" c:type="GDestroyNotify"/>
3080431272 </parameter>
3080531273 </parameters>
@@ -30810,18 +31278,18 @@ stores the length of its data in #guint, which may be shorter than
3081031278 introspectable="0">
3081131279 <doc xml:space="preserve"
3081231280 filename="glib/garray.c"
30813- line="1620">Creates a new #GPtrArray with @reserved_size pointers preallocated
31281+ line="1635">Creates a new `GPtrArray` with @reserved_size pointers preallocated
3081431282 and a reference count of 1. This avoids frequent reallocation, if
3081531283 you are going to add many pointers to the array. Note however that
30816-the size of the array is still 0. It also set @element_free_func
31284+the size of the array is still 0. It also sets @element_free_func
3081731285 for freeing each element when the array is destroyed either via
30818-g_ptr_array_unref(), when g_ptr_array_free() is called with
30819-@free_segment set to %TRUE or when removing elements.</doc>
31286+[func@GLib.PtrArray.unref], when [func@GLib.PtrArray.free] is called with
31287+@free_segment set to true or when removing elements.</doc>
3082031288 <source-position filename="glib/garray.h" line="174"/>
3082131289 <return-value transfer-ownership="full">
3082231290 <doc xml:space="preserve"
3082331291 filename="glib/garray.c"
30824- line="1634">A new #GPtrArray</doc>
31292+ line="1649">The new `GPtrArray`</doc>
3082531293 <array name="GLib.PtrArray" c:type="GPtrArray*">
3082631294 <type name="gpointer" c:type="gpointer"/>
3082731295 </array>
@@ -30830,7 +31298,7 @@ g_ptr_array_unref(), when g_ptr_array_free() is called with
3083031298 <parameter name="reserved_size" transfer-ownership="none">
3083131299 <doc xml:space="preserve"
3083231300 filename="glib/garray.c"
30833- line="1622">number of pointers preallocated</doc>
31301+ line="1637">the number of pointers preallocated</doc>
3083431302 <type name="guint" c:type="guint"/>
3083531303 </parameter>
3083631304 <parameter name="element_free_func"
@@ -30840,8 +31308,8 @@ g_ptr_array_unref(), when g_ptr_array_free() is called with
3084031308 scope="async">
3084131309 <doc xml:space="preserve"
3084231310 filename="glib/garray.c"
30843- line="1623">A function to free elements with
30844- destroy @array or %NULL</doc>
31311+ line="1638">a function to free elements with
31312+ destroy @array</doc>
3084531313 <type name="DestroyNotify" c:type="GDestroyNotify"/>
3084631314 </parameter>
3084731315 </parameters>
@@ -30852,26 +31320,26 @@ g_ptr_array_unref(), when g_ptr_array_free() is called with
3085231320 introspectable="0">
3085331321 <doc xml:space="preserve"
3085431322 filename="glib/garray.c"
30855- line="1645">Like g_ptr_array_new_full() but also allows to set the array to
30856-be %NULL terminated. A %NULL terminated pointer array has an
30857-additional %NULL pointer after the last element, beyond the
31323+ line="1660">Like [func@GLib.PtrArray.new_full] but also allows to set the array to
31324+be `NULL` terminated. A `NULL` terminated pointer array has an
31325+additional `NULL` pointer after the last element, beyond the
3085831326 current length.
3085931327
30860-#GPtrArray created by other constructors are not automatically %NULL
31328+`GPtrArray` created by other constructors are not automatically `NULL`
3086131329 terminated.
3086231330
30863-Note that if the @array's length is zero and currently no
30864-data array is allocated, then pdata will still be %NULL.
30865-%GPtrArray will only %NULL terminate pdata, if an actual
31331+Note that if the @array’s length is zero and currently no
31332+data array is allocated, then `pdata` will still be `NULL`.
31333+`GPtrArray` will only `NULL` terminate `pdata`, if an actual
3086631334 array is allocated. It does not guarantee that an array
3086731335 is always allocated. In other words, if the length is zero,
30868-then pdata may either point to a %NULL terminated array of length
30869-zero or be %NULL.</doc>
31336+then `pdata` may either point to a `NULL` terminated array of length
31337+zero or be `NULL`.</doc>
3087031338 <source-position filename="glib/garray.h" line="177"/>
3087131339 <return-value transfer-ownership="full">
3087231340 <doc xml:space="preserve"
3087331341 filename="glib/garray.c"
30874- line="1671">A new #GPtrArray</doc>
31342+ line="1686">The new `GPtrArray`</doc>
3087531343 <array name="GLib.PtrArray" c:type="GPtrArray*">
3087631344 <type name="gpointer" c:type="gpointer"/>
3087731345 </array>
@@ -30880,8 +31348,8 @@ zero or be %NULL.</doc>
3088031348 <parameter name="reserved_size" transfer-ownership="none">
3088131349 <doc xml:space="preserve"
3088231350 filename="glib/garray.c"
30883- line="1647">number of pointers preallocated.
30884- If @null_terminated is %TRUE, the actually allocated
31351+ line="1662">the number of pointers preallocated.
31352+ If @null_terminated is `TRUE`, the actually allocated
3088531353 buffer size is @reserved_size plus 1, unless @reserved_size
3088631354 is zero, in which case no initial buffer gets allocated.</doc>
3088731355 <type name="guint" c:type="guint"/>
@@ -30893,14 +31361,14 @@ zero or be %NULL.</doc>
3089331361 scope="async">
3089431362 <doc xml:space="preserve"
3089531363 filename="glib/garray.c"
30896- line="1651">A function to free elements with
30897- destroy @array or %NULL</doc>
31364+ line="1666">a function to free elements during
31365+ destruction of @array</doc>
3089831366 <type name="DestroyNotify" c:type="GDestroyNotify"/>
3089931367 </parameter>
3090031368 <parameter name="null_terminated" transfer-ownership="none">
3090131369 <doc xml:space="preserve"
3090231370 filename="glib/garray.c"
30903- line="1653">whether to make the array as %NULL terminated.</doc>
31371+ line="1668">if true, make the array `NULL` terminated</doc>
3090431372 <type name="gboolean" c:type="gboolean"/>
3090531373 </parameter>
3090631374 </parameters>
@@ -30911,26 +31379,27 @@ zero or be %NULL.</doc>
3091131379 introspectable="0">
3091231380 <doc xml:space="preserve"
3091331381 filename="glib/garray.c"
30914- line="1178">Creates a new #GPtrArray with @data as pointers, @len as length and a
31382+ line="1186">Creates a new `GPtrArray` with @data as pointers, @len as length and a
3091531383 reference count of 1.
3091631384
3091731385 This avoids having to copy such data manually.
30918-After this call, @data belongs to the #GPtrArray and may no longer be
31386+After this call, @data belongs to the `GPtrArray` and may no longer be
3091931387 modified by the caller. The memory of @data has to be dynamically
30920-allocated and will eventually be freed with g_free().
31388+allocated and will eventually be freed with [func@GLib.free].
3092131389
3092231390 It also sets @element_free_func for freeing each element when the array is
30923-destroyed either via g_ptr_array_unref(), when g_ptr_array_free() is called
30924-with @free_segment set to %TRUE or when removing elements.
31391+destroyed either via [func@GLib.PtrArray.unref], when
31392+[func@GLib.PtrArray.free] is called with @free_segment set to true or when
31393+removing elements.
3092531394
30926-Do not use it if @len is greater than %G_MAXUINT. #GPtrArray
30927-stores the length of its data in #guint, which may be shorter than
30928-#gsize.</doc>
31395+Do not use it if @len is greater than [`G_MAXUINT`](types.html#guint).
31396+`GPtrArray` stores the length of its data in `guint`, which may be shorter
31397+than `gsize`.</doc>
3092931398 <source-position filename="glib/garray.h" line="155"/>
3093031399 <return-value transfer-ownership="full">
3093131400 <doc xml:space="preserve"
3093231401 filename="glib/garray.c"
30933- line="1202">A new #GPtrArray</doc>
31402+ line="1210">The new `GPtrArray`</doc>
3093431403 <array name="GLib.PtrArray" c:type="GPtrArray*">
3093531404 <type name="gpointer" c:type="gpointer"/>
3093631405 </array>
@@ -30942,8 +31411,7 @@ stores the length of its data in #guint, which may be shorter than
3094231411 allow-none="1">
3094331412 <doc xml:space="preserve"
3094431413 filename="glib/garray.c"
30945- line="1180">an array of pointers,
30946- or %NULL for an empty array</doc>
31414+ line="1188">an array of pointers</doc>
3094731415 <array length="1" zero-terminated="0" c:type="gpointer*">
3094831416 <type name="gpointer" c:type="gpointer"/>
3094931417 </array>
@@ -30951,7 +31419,7 @@ stores the length of its data in #guint, which may be shorter than
3095131419 <parameter name="len" transfer-ownership="none">
3095231420 <doc xml:space="preserve"
3095331421 filename="glib/garray.c"
30954- line="1182">the number of pointers in @data</doc>
31422+ line="1189">the number of pointers in @data</doc>
3095531423 <type name="gsize" c:type="gsize"/>
3095631424 </parameter>
3095731425 <parameter name="element_free_func"
@@ -30961,8 +31429,8 @@ stores the length of its data in #guint, which may be shorter than
3096131429 scope="async">
3096231430 <doc xml:space="preserve"
3096331431 filename="glib/garray.c"
30964- line="1183">A function to free elements on @array
30965- destruction or %NULL</doc>
31432+ line="1190">a function to free elements on @array
31433+ destruction</doc>
3096631434 <type name="DestroyNotify" c:type="GDestroyNotify"/>
3096731435 </parameter>
3096831436 </parameters>
@@ -30973,29 +31441,30 @@ stores the length of its data in #guint, which may be shorter than
3097331441 introspectable="0">
3097431442 <doc xml:space="preserve"
3097531443 filename="glib/garray.c"
30976- line="1227">Creates a new #GPtrArray with @data as pointers, computing the length of it
31444+ line="1235">Creates a new `GPtrArray` with @data as pointers, computing the length of it
3097731445 and setting the reference count to 1.
3097831446
3097931447 This avoids having to copy such data manually.
30980-After this call, @data belongs to the #GPtrArray and may no longer be
31448+After this call, @data belongs to the `GPtrArray` and may no longer be
3098131449 modified by the caller. The memory of @data has to be dynamically
30982-allocated and will eventually be freed with g_free().
31450+allocated and will eventually be freed with [func@GLib.free].
3098331451
30984-The length is calculated by iterating through @data until the first %NULL
31452+The length is calculated by iterating through @data until the first `NULL`
3098531453 element is found.
3098631454
3098731455 It also sets @element_free_func for freeing each element when the array is
30988-destroyed either via g_ptr_array_unref(), when g_ptr_array_free() is called
30989-with @free_segment set to %TRUE or when removing elements.
31456+destroyed either via [func@GLib.PtrArray.unref], when
31457+[func@GLib.PtrArray.free] is called with @free_segment set to true or when
31458+removing elements.
3099031459
30991-Do not use it if the @data length is greater than %G_MAXUINT. #GPtrArray
30992-stores the length of its data in #guint, which may be shorter than
30993-#gsize.</doc>
31460+Do not use it if the @data length is greater than
31461+[`G_MAXUINT`](types.html#guint). `GPtrArray` stores the length of its data
31462+in `guint`, which may be shorter than `gsize`.</doc>
3099431463 <source-position filename="glib/garray.h" line="181"/>
3099531464 <return-value transfer-ownership="full">
3099631465 <doc xml:space="preserve"
3099731466 filename="glib/garray.c"
30998- line="1253">A new #GPtrArray</doc>
31467+ line="1262">The new `GPtrArray`</doc>
3099931468 <array name="GLib.PtrArray" c:type="GPtrArray*">
3100031469 <type name="gpointer" c:type="gpointer"/>
3100131470 </array>
@@ -31007,8 +31476,8 @@ stores the length of its data in #guint, which may be shorter than
3100731476 allow-none="1">
3100831477 <doc xml:space="preserve"
3100931478 filename="glib/garray.c"
31010- line="1229">an array
31011- of pointers, %NULL terminated, or %NULL for an empty array</doc>
31479+ line="1237">an array
31480+ of pointers, `NULL` terminated</doc>
3101231481 <array c:type="gpointer*">
3101331482 <type name="gpointer" c:type="gpointer"/>
3101431483 </array>
@@ -31020,8 +31489,8 @@ stores the length of its data in #guint, which may be shorter than
3102031489 scope="async">
3102131490 <doc xml:space="preserve"
3102231491 filename="glib/garray.c"
31023- line="1231">a function to free elements on @array
31024- destruction or %NULL</doc>
31492+ line="1239">a function to free elements on @array
31493+ destruction</doc>
3102531494 <type name="DestroyNotify" c:type="GDestroyNotify"/>
3102631495 </parameter>
3102731496 </parameters>
@@ -31032,15 +31501,15 @@ stores the length of its data in #guint, which may be shorter than
3103231501 introspectable="0">
3103331502 <doc xml:space="preserve"
3103431503 filename="glib/garray.c"
31035- line="1600">Creates a new #GPtrArray with a reference count of 1 and use
31504+ line="1615">Creates a new `GPtrArray` with a reference count of 1 and use
3103631505 @element_free_func for freeing each element when the array is destroyed
31037-either via g_ptr_array_unref(), when g_ptr_array_free() is called with
31038-@free_segment set to %TRUE or when removing elements.</doc>
31506+either via [func@GLib.PtrArray.unref], when [func@GLib.PtrArray.free] is
31507+called with @free_segment set to true or when removing elements.</doc>
3103931508 <source-position filename="glib/garray.h" line="153"/>
3104031509 <return-value transfer-ownership="full">
3104131510 <doc xml:space="preserve"
3104231511 filename="glib/garray.c"
31043- line="1610">A new #GPtrArray</doc>
31512+ line="1625">The new `GPtrArray`</doc>
3104431513 <array name="GLib.PtrArray" c:type="GPtrArray*">
3104531514 <type name="gpointer" c:type="gpointer"/>
3104631515 </array>
@@ -31053,8 +31522,8 @@ either via g_ptr_array_unref(), when g_ptr_array_free() is called with
3105331522 scope="async">
3105431523 <doc xml:space="preserve"
3105531524 filename="glib/garray.c"
31056- line="1602">A function to free elements with
31057- destroy @array or %NULL</doc>
31525+ line="1617">a function to free elements with
31526+ destroy @array</doc>
3105831527 <type name="DestroyNotify" c:type="GDestroyNotify"/>
3105931528 </parameter>
3106031529 </parameters>
@@ -31065,13 +31534,13 @@ either via g_ptr_array_unref(), when g_ptr_array_free() is called with
3106531534 introspectable="0">
3106631535 <doc xml:space="preserve"
3106731536 filename="glib/garray.c"
31068- line="1729">Atomically increments the reference count of @array by one.
31537+ line="1744">Atomically increments the reference count of @array by one.
3106931538 This function is thread-safe and may be called from any thread.</doc>
3107031539 <source-position filename="glib/garray.h" line="192"/>
31071- <return-value>
31540+ <return-value transfer-ownership="full">
3107231541 <doc xml:space="preserve"
3107331542 filename="glib/garray.c"
31074- line="1736">The passed in #GPtrArray</doc>
31543+ line="1751">The passed in `GPtrArray`</doc>
3107531544 <array name="GLib.PtrArray" c:type="GPtrArray*">
3107631545 <type name="gpointer" c:type="gpointer"/>
3107731546 </array>
@@ -31080,7 +31549,7 @@ This function is thread-safe and may be called from any thread.</doc>
3108031549 <parameter name="array" transfer-ownership="none">
3108131550 <doc xml:space="preserve"
3108231551 filename="glib/garray.c"
31083- line="1731">a #GPtrArray</doc>
31552+ line="1746">a pointer array</doc>
3108431553 <array name="GLib.PtrArray" c:type="GPtrArray*">
3108531554 <type name="gpointer" c:type="gpointer"/>
3108631555 </array>
@@ -31092,26 +31561,25 @@ This function is thread-safe and may be called from any thread.</doc>
3109231561 introspectable="0">
3109331562 <doc xml:space="preserve"
3109431563 filename="glib/garray.c"
31095- line="2129">Removes the first occurrence of the given pointer from the pointer
31564+ line="2147">Removes the first occurrence of the given pointer from the pointer
3109631565 array. The following elements are moved down one place. If @array
31097-has a non-%NULL #GDestroyNotify function it is called for the
31566+has a non-`NULL` [callback@GLib.DestroyNotify] function it is called for the
3109831567 removed element.
3109931568
31100-It returns %TRUE if the pointer was removed, or %FALSE if the
31569+It returns true if the pointer was removed, or false if the
3110131570 pointer was not found.</doc>
3110231571 <source-position filename="glib/garray.h" line="214"/>
3110331572 <return-value transfer-ownership="none">
3110431573 <doc xml:space="preserve"
3110531574 filename="glib/garray.c"
31106- line="2142">%TRUE if the pointer is removed, %FALSE if the pointer
31107- is not found in the array</doc>
31575+ line="2160">true if the pointer is found and removed; false otherwise</doc>
3110831576 <type name="gboolean" c:type="gboolean"/>
3110931577 </return-value>
3111031578 <parameters>
3111131579 <parameter name="array" transfer-ownership="none">
3111231580 <doc xml:space="preserve"
3111331581 filename="glib/garray.c"
31114- line="2131">a #GPtrArray</doc>
31582+ line="2149">a pointer array</doc>
3111531583 <array name="GLib.PtrArray" c:type="GPtrArray*">
3111631584 <type name="gpointer" c:type="gpointer"/>
3111731585 </array>
@@ -31122,7 +31590,7 @@ pointer was not found.</doc>
3112231590 allow-none="1">
3112331591 <doc xml:space="preserve"
3112431592 filename="glib/garray.c"
31125- line="2132">the pointer to remove</doc>
31593+ line="2150">the pointer to remove</doc>
3112631594 <type name="gpointer" c:type="gpointer"/>
3112731595 </parameter>
3112831596 </parameters>
@@ -31132,26 +31600,26 @@ pointer was not found.</doc>
3113231600 introspectable="0">
3113331601 <doc xml:space="preserve"
3113431602 filename="glib/garray.c"
31135- line="2166">Removes the first occurrence of the given pointer from the pointer
31603+ line="2183">Removes the first occurrence of the given pointer from the pointer
3113631604 array. The last element in the array is used to fill in the space,
3113731605 so this function does not preserve the order of the array. But it
31138-is faster than g_ptr_array_remove(). If @array has a non-%NULL
31139-#GDestroyNotify function it is called for the removed element.
31606+is faster than [func@GLib.PtrArray.remove]. If @array has a non-`NULL`
31607+[callback@GLib.DestroyNotify] function it is called for the removed element.
3114031608
31141-It returns %TRUE if the pointer was removed, or %FALSE if the
31609+It returns true if the pointer was removed, or false if the
3114231610 pointer was not found.</doc>
3114331611 <source-position filename="glib/garray.h" line="217"/>
3114431612 <return-value transfer-ownership="none">
3114531613 <doc xml:space="preserve"
3114631614 filename="glib/garray.c"
31147- line="2180">%TRUE if the pointer was found in the array</doc>
31615+ line="2197">true if the pointer is found and removed; false otherwise</doc>
3114831616 <type name="gboolean" c:type="gboolean"/>
3114931617 </return-value>
3115031618 <parameters>
3115131619 <parameter name="array" transfer-ownership="none">
3115231620 <doc xml:space="preserve"
3115331621 filename="glib/garray.c"
31154- line="2168">a #GPtrArray</doc>
31622+ line="2185">a pointer array</doc>
3115531623 <array name="GLib.PtrArray" c:type="GPtrArray*">
3115631624 <type name="gpointer" c:type="gpointer"/>
3115731625 </array>
@@ -31162,7 +31630,7 @@ pointer was not found.</doc>
3116231630 allow-none="1">
3116331631 <doc xml:space="preserve"
3116431632 filename="glib/garray.c"
31165- line="2169">the pointer to remove</doc>
31633+ line="2186">the pointer to remove</doc>
3116631634 <type name="gpointer" c:type="gpointer"/>
3116731635 </parameter>
3116831636 </parameters>
@@ -31172,23 +31640,25 @@ pointer was not found.</doc>
3117231640 introspectable="0">
3117331641 <doc xml:space="preserve"
3117431642 filename="glib/garray.c"
31175- line="1988">Removes the pointer at the given index from the pointer array.
31643+ line="2001">Removes the pointer at the given index from the pointer array.
3117631644 The following elements are moved down one place. If @array has
31177-a non-%NULL #GDestroyNotify function it is called for the removed
31645+a non-`NULL` [callback@GLib.DestroyNotify] function it is called for the
31646+removed
3117831647 element. If so, the return value from this function will potentially point
31179-to freed memory (depending on the #GDestroyNotify implementation).</doc>
31648+to freed memory (depending on the [callback@GLib.DestroyNotify]
31649+implementation).</doc>
3118031650 <source-position filename="glib/garray.h" line="202"/>
3118131651 <return-value transfer-ownership="none" nullable="1">
3118231652 <doc xml:space="preserve"
3118331653 filename="glib/garray.c"
31184- line="1999">the pointer which was removed</doc>
31654+ line="2014">The pointer which was removed</doc>
3118531655 <type name="gpointer" c:type="gpointer"/>
3118631656 </return-value>
3118731657 <parameters>
3118831658 <parameter name="array" transfer-ownership="none">
3118931659 <doc xml:space="preserve"
3119031660 filename="glib/garray.c"
31191- line="1990">a #GPtrArray</doc>
31661+ line="2003">a pointer array</doc>
3119231662 <array name="GLib.PtrArray" c:type="GPtrArray*">
3119331663 <type name="gpointer" c:type="gpointer"/>
3119431664 </array>
@@ -31196,7 +31666,7 @@ to freed memory (depending on the #GDestroyNotify implementation).</doc>
3119631666 <parameter name="index_" transfer-ownership="none">
3119731667 <doc xml:space="preserve"
3119831668 filename="glib/garray.c"
31199- line="1991">the index of the pointer to remove</doc>
31669+ line="2004">the index of the pointer to remove</doc>
3120031670 <type name="guint" c:type="guint"/>
3120131671 </parameter>
3120231672 </parameters>
@@ -31206,25 +31676,26 @@ to freed memory (depending on the #GDestroyNotify implementation).</doc>
3120631676 introspectable="0">
3120731677 <doc xml:space="preserve"
3120831678 filename="glib/garray.c"
31209- line="2008">Removes the pointer at the given index from the pointer array.
31679+ line="2023">Removes the pointer at the given index from the pointer array.
3121031680 The last element in the array is used to fill in the space, so
3121131681 this function does not preserve the order of the array. But it
31212-is faster than g_ptr_array_remove_index(). If @array has a non-%NULL
31213-#GDestroyNotify function it is called for the removed element. If so, the
31682+is faster than [func@GLib.PtrArray.remove_index]. If @array has a non-`NULL`
31683+[callback@GLib.DestroyNotify] function it is called for the removed element.
31684+If so, the
3121431685 return value from this function will potentially point to freed memory
31215-(depending on the #GDestroyNotify implementation).</doc>
31686+(depending on the [callback@GLib.DestroyNotify] implementation).</doc>
3121631687 <source-position filename="glib/garray.h" line="205"/>
3121731688 <return-value transfer-ownership="none" nullable="1">
3121831689 <doc xml:space="preserve"
3121931690 filename="glib/garray.c"
31220- line="2021">the pointer which was removed</doc>
31691+ line="2037">The pointer which was removed</doc>
3122131692 <type name="gpointer" c:type="gpointer"/>
3122231693 </return-value>
3122331694 <parameters>
3122431695 <parameter name="array" transfer-ownership="none">
3122531696 <doc xml:space="preserve"
3122631697 filename="glib/garray.c"
31227- line="2010">a #GPtrArray</doc>
31698+ line="2025">a pointer array</doc>
3122831699 <array name="GLib.PtrArray" c:type="GPtrArray*">
3122931700 <type name="gpointer" c:type="gpointer"/>
3123031701 </array>
@@ -31232,7 +31703,7 @@ return value from this function will potentially point to freed memory
3123231703 <parameter name="index_" transfer-ownership="none">
3123331704 <doc xml:space="preserve"
3123431705 filename="glib/garray.c"
31235- line="2011">the index of the pointer to remove</doc>
31706+ line="2026">the index of the pointer to remove</doc>
3123631707 <type name="guint" c:type="guint"/>
3123731708 </parameter>
3123831709 </parameters>
@@ -31243,15 +31714,15 @@ return value from this function will potentially point to freed memory
3124331714 introspectable="0">
3124431715 <doc xml:space="preserve"
3124531716 filename="glib/garray.c"
31246- line="2072">Removes the given number of pointers starting at the given index
31247-from a #GPtrArray. The following elements are moved to close the
31248-gap. If @array has a non-%NULL #GDestroyNotify function it is
31717+ line="2090">Removes the given number of pointers starting at the given index
31718+from a `GPtrArray`. The following elements are moved to close the
31719+gap. If @array has a non-`NULL` [callback@GLib.DestroyNotify] function it is
3124931720 called for the removed elements.</doc>
3125031721 <source-position filename="glib/garray.h" line="220"/>
31251- <return-value>
31722+ <return-value transfer-ownership="none">
3125231723 <doc xml:space="preserve"
3125331724 filename="glib/garray.c"
31254- line="2083">the @array</doc>
31725+ line="2101">The @array</doc>
3125531726 <array name="GLib.PtrArray" c:type="GPtrArray*">
3125631727 <type name="gpointer" c:type="gpointer"/>
3125731728 </array>
@@ -31260,7 +31731,7 @@ called for the removed elements.</doc>
3126031731 <parameter name="array" transfer-ownership="none">
3126131732 <doc xml:space="preserve"
3126231733 filename="glib/garray.c"
31263- line="2074">a @GPtrArray</doc>
31734+ line="2092">a pointer array</doc>
3126431735 <array name="GLib.PtrArray" c:type="GPtrArray*">
3126531736 <type name="gpointer" c:type="gpointer"/>
3126631737 </array>
@@ -31268,13 +31739,13 @@ called for the removed elements.</doc>
3126831739 <parameter name="index_" transfer-ownership="none">
3126931740 <doc xml:space="preserve"
3127031741 filename="glib/garray.c"
31271- line="2075">the index of the first pointer to remove</doc>
31742+ line="2093">the index of the first pointer to remove</doc>
3127231743 <type name="guint" c:type="guint"/>
3127331744 </parameter>
3127431745 <parameter name="length" transfer-ownership="none">
3127531746 <doc xml:space="preserve"
3127631747 filename="glib/garray.c"
31277- line="2076">the number of pointers to remove</doc>
31748+ line="2094">the number of pointers to remove</doc>
3127831749 <type name="guint" c:type="guint"/>
3127931750 </parameter>
3128031751 </parameters>
@@ -31285,9 +31756,9 @@ called for the removed elements.</doc>
3128531756 introspectable="0">
3128631757 <doc xml:space="preserve"
3128731758 filename="glib/garray.c"
31288- line="1683">Sets a function for freeing each element when @array is destroyed
31289-either via g_ptr_array_unref(), when g_ptr_array_free() is called
31290-with @free_segment set to %TRUE or when removing elements.</doc>
31759+ line="1698">Sets a function for freeing each element when @array is destroyed
31760+either via [func@GLib.PtrArray.unref], when [func@GLib.PtrArray.free] is
31761+called with @free_segment set to true or when removing elements.</doc>
3129131762 <source-position filename="glib/garray.h" line="196"/>
3129231763 <return-value transfer-ownership="none">
3129331764 <type name="none" c:type="void"/>
@@ -31296,7 +31767,7 @@ with @free_segment set to %TRUE or when removing elements.</doc>
3129631767 <parameter name="array" transfer-ownership="none">
3129731768 <doc xml:space="preserve"
3129831769 filename="glib/garray.c"
31299- line="1685">A #GPtrArray</doc>
31770+ line="1700">a pointer array</doc>
3130031771 <array name="GLib.PtrArray" c:type="GPtrArray*">
3130131772 <type name="gpointer" c:type="gpointer"/>
3130231773 </array>
@@ -31308,8 +31779,8 @@ with @free_segment set to %TRUE or when removing elements.</doc>
3130831779 scope="async">
3130931780 <doc xml:space="preserve"
3131031781 filename="glib/garray.c"
31311- line="1686">A function to free elements with
31312- destroy @array or %NULL</doc>
31782+ line="1701">a function to free elements during
31783+ destruction of @array</doc>
3131331784 <type name="DestroyNotify" c:type="GDestroyNotify"/>
3131431785 </parameter>
3131531786 </parameters>
@@ -31319,10 +31790,10 @@ with @free_segment set to %TRUE or when removing elements.</doc>
3131931790 introspectable="0">
3132031791 <doc xml:space="preserve"
3132131792 filename="glib/garray.c"
31322- line="1905">Sets the size of the array. When making the array larger,
31323-newly-added elements will be set to %NULL. When making it smaller,
31324-if @array has a non-%NULL #GDestroyNotify function then it will be
31325-called for the removed elements.</doc>
31793+ line="1922">Sets the size of the array. When making the array larger,
31794+newly-added elements will be set to `NULL`. When making it smaller,
31795+if @array has a non-`NULL` [callback@GLib.DestroyNotify] function then it
31796+will be called for the removed elements.</doc>
3132631797 <source-position filename="glib/garray.h" line="199"/>
3132731798 <return-value transfer-ownership="none">
3132831799 <type name="none" c:type="void"/>
@@ -31331,7 +31802,7 @@ called for the removed elements.</doc>
3133131802 <parameter name="array" transfer-ownership="none">
3133231803 <doc xml:space="preserve"
3133331804 filename="glib/garray.c"
31334- line="1907">a #GPtrArray</doc>
31805+ line="1924">a pointer array</doc>
3133531806 <array name="GLib.PtrArray" c:type="GPtrArray*">
3133631807 <type name="gpointer" c:type="gpointer"/>
3133731808 </array>
@@ -31339,7 +31810,7 @@ called for the removed elements.</doc>
3133931810 <parameter name="length" transfer-ownership="none">
3134031811 <doc xml:space="preserve"
3134131812 filename="glib/garray.c"
31342- line="1908">the new length of the pointer array</doc>
31813+ line="1925">the new length of the pointer array</doc>
3134331814 <type name="gint" c:type="gint"/>
3134431815 </parameter>
3134531816 </parameters>
@@ -31349,15 +31820,15 @@ called for the removed elements.</doc>
3134931820 introspectable="0">
3135031821 <doc xml:space="preserve"
3135131822 filename="glib/garray.c"
31352- line="1552">Creates a new #GPtrArray with @reserved_size pointers preallocated
31823+ line="1567">Creates a new `GPtrArray` with @reserved_size pointers preallocated
3135331824 and a reference count of 1. This avoids frequent reallocation, if
3135431825 you are going to add many pointers to the array. Note however that
3135531826 the size of the array is still 0.</doc>
3135631827 <source-position filename="glib/garray.h" line="172"/>
31357- <return-value>
31828+ <return-value transfer-ownership="full">
3135831829 <doc xml:space="preserve"
3135931830 filename="glib/garray.c"
31360- line="1561">the new #GPtrArray</doc>
31831+ line="1576">The new `GPtrArray`</doc>
3136131832 <array name="GLib.PtrArray" c:type="GPtrArray*">
3136231833 <type name="gpointer" c:type="gpointer"/>
3136331834 </array>
@@ -31366,7 +31837,7 @@ the size of the array is still 0.</doc>
3136631837 <parameter name="reserved_size" transfer-ownership="none">
3136731838 <doc xml:space="preserve"
3136831839 filename="glib/garray.c"
31369- line="1554">number of pointers preallocated</doc>
31840+ line="1569">the number of pointers preallocated</doc>
3137031841 <type name="guint" c:type="guint"/>
3137131842 </parameter>
3137231843 </parameters>
@@ -31374,19 +31845,20 @@ the size of the array is still 0.</doc>
3137431845 <function name="sort" c:identifier="g_ptr_array_sort" introspectable="0">
3137531846 <doc xml:space="preserve"
3137631847 filename="glib/garray.c"
31377- line="2364">Sorts the array, using @compare_func which should be a qsort()-style
31848+ line="2381">Sorts the array, using @compare_func which should be a `qsort()`-style
3137831849 comparison function (returns less than zero for first arg is less
3137931850 than second arg, zero for equal, greater than zero if first arg is
3138031851 greater than second arg).
3138131852
31382-Note that the comparison function for g_ptr_array_sort() doesn't
31853+Note that the comparison function for [func@GLib.PtrArray.sort] doesn’t
3138331854 take the pointers from the array as arguments, it takes pointers to
3138431855 the pointers in the array.
3138531856
31386-Use g_ptr_array_sort_values() if you want to use normal
31387-#GCompareFuncs, otherwise here is a full example of use:
31857+Use [func@GLib.PtrArray.sort_values] if you want to use normal
31858+[callback@GLib.CompareFunc] instances, otherwise here is a full example of
31859+use:
3138831860
31389-|[&lt;!-- language="C" --&gt;
31861+```c
3139031862 typedef struct
3139131863 {
3139231864 gchar *name;
@@ -31409,7 +31881,7 @@ g_autoptr (GPtrArray) file_list = NULL;
3140931881 ...
3141031882 // now sort it with
3141131883 g_ptr_array_sort (file_list, sort_filelist);
31412-]|
31884+```
3141331885
3141431886 This is guaranteed to be a stable sort since version 2.32.</doc>
3141531887 <source-position filename="glib/garray.h" line="239"/>
@@ -31420,15 +31892,17 @@ This is guaranteed to be a stable sort since version 2.32.</doc>
3142031892 <parameter name="array" transfer-ownership="none">
3142131893 <doc xml:space="preserve"
3142231894 filename="glib/garray.c"
31423- line="2366">a #GPtrArray</doc>
31895+ line="2383">a pointer array</doc>
3142431896 <array name="GLib.PtrArray" c:type="GPtrArray*">
3142531897 <type name="gpointer" c:type="gpointer"/>
3142631898 </array>
3142731899 </parameter>
31428- <parameter name="compare_func" transfer-ownership="none">
31900+ <parameter name="compare_func"
31901+ transfer-ownership="none"
31902+ scope="call">
3142931903 <doc xml:space="preserve"
3143031904 filename="glib/garray.c"
31431- line="2367">comparison function</doc>
31905+ line="2384">a comparison function</doc>
3143231906 <type name="CompareFunc" c:type="GCompareFunc"/>
3143331907 </parameter>
3143431908 </parameters>
@@ -31439,7 +31913,7 @@ This is guaranteed to be a stable sort since version 2.32.</doc>
3143931913 introspectable="0">
3144031914 <doc xml:space="preserve"
3144131915 filename="glib/garray.c"
31442- line="2513">Sorts the array, using @compare_func which should be a qsort()-style
31916+ line="2532">Sorts the array, using @compare_func which should be a `qsort()`-style
3144331917 comparison function (returns less than zero for first arg is less
3144431918 than second arg, zero for equal, greater than zero if first arg is
3144531919 greater than second arg).
@@ -31453,15 +31927,17 @@ This is guaranteed to be a stable sort.</doc>
3145331927 <parameter name="array" transfer-ownership="none">
3145431928 <doc xml:space="preserve"
3145531929 filename="glib/garray.c"
31456- line="2515">a #GPtrArray</doc>
31930+ line="2534">a pointer array</doc>
3145731931 <array name="GLib.PtrArray" c:type="GPtrArray*">
3145831932 <type name="gpointer" c:type="gpointer"/>
3145931933 </array>
3146031934 </parameter>
31461- <parameter name="compare_func" transfer-ownership="none">
31935+ <parameter name="compare_func"
31936+ transfer-ownership="none"
31937+ scope="call">
3146231938 <doc xml:space="preserve"
3146331939 filename="glib/garray.c"
31464- line="2516">a #GCompareFunc comparison function</doc>
31940+ line="2535">a comparison function</doc>
3146531941 <type name="CompareFunc" c:type="GCompareFunc"/>
3146631942 </parameter>
3146731943 </parameters>
@@ -31472,8 +31948,8 @@ This is guaranteed to be a stable sort.</doc>
3147231948 introspectable="0">
3147331949 <doc xml:space="preserve"
3147431950 filename="glib/garray.c"
31475- line="2552">Like g_ptr_array_sort_values(), but the comparison function has an extra
31476-user data argument.
31951+ line="2571">Like [func@GLib.PtrArray.sort_values], but the comparison function has an
31952+extra user data argument.
3147731953
3147831954 This is guaranteed to be a stable sort.</doc>
3147931955 <source-position filename="glib/garray.h" line="249"/>
@@ -31484,15 +31960,18 @@ This is guaranteed to be a stable sort.</doc>
3148431960 <parameter name="array" transfer-ownership="none">
3148531961 <doc xml:space="preserve"
3148631962 filename="glib/garray.c"
31487- line="2554">a #GPtrArray</doc>
31963+ line="2573">a pointer array</doc>
3148831964 <array name="GLib.PtrArray" c:type="GPtrArray*">
3148931965 <type name="gpointer" c:type="gpointer"/>
3149031966 </array>
3149131967 </parameter>
31492- <parameter name="compare_func" transfer-ownership="none" closure="2">
31968+ <parameter name="compare_func"
31969+ transfer-ownership="none"
31970+ scope="call"
31971+ closure="2">
3149331972 <doc xml:space="preserve"
3149431973 filename="glib/garray.c"
31495- line="2555">a #GCompareDataFunc comparison function</doc>
31974+ line="2574">a comparison function</doc>
3149631975 <type name="CompareDataFunc" c:type="GCompareDataFunc"/>
3149731976 </parameter>
3149831977 <parameter name="user_data"
@@ -31501,7 +31980,7 @@ This is guaranteed to be a stable sort.</doc>
3150131980 allow-none="1">
3150231981 <doc xml:space="preserve"
3150331982 filename="glib/garray.c"
31504- line="2556">data to pass to @compare_func</doc>
31983+ line="2575">the data to pass to @compare_func</doc>
3150531984 <type name="gpointer" c:type="gpointer"/>
3150631985 </parameter>
3150731986 </parameters>
@@ -31511,17 +31990,18 @@ This is guaranteed to be a stable sort.</doc>
3151131990 introspectable="0">
3151231991 <doc xml:space="preserve"
3151331992 filename="glib/garray.c"
31514- line="2425">Like g_ptr_array_sort(), but the comparison function has an extra
31993+ line="2443">Like [func@GLib.PtrArray.sort], but the comparison function has an extra
3151531994 user data argument.
3151631995
31517-Note that the comparison function for g_ptr_array_sort_with_data()
31518-doesn't take the pointers from the array as arguments, it takes
31996+Note that the comparison function for [func@GLib.PtrArray.sort_with_data]
31997+doesn’t take the pointers from the array as arguments, it takes
3151931998 pointers to the pointers in the array.
3152031999
31521-Use g_ptr_array_sort_values_with_data() if you want to use normal
31522-#GCompareDataFuncs, otherwise here is a full example of use:
32000+Use [func@GLib.PtrArray.sort_values_with_data] if you want to use normal
32001+[callback@GLib.CompareDataFunc] instances, otherwise here is a full example
32002+of use:
3152332003
31524-|[&lt;!-- language="C" --&gt;
32004+```c
3152532005 typedef enum { SORT_NAME, SORT_SIZE } SortMode;
3152632006
3152732007 typedef struct
@@ -31564,7 +32044,7 @@ sort_mode = SORT_NAME;
3156432044 g_ptr_array_sort_with_data (file_list,
3156532045 sort_filelist,
3156632046 GINT_TO_POINTER (sort_mode));
31567-]|
32047+```
3156832048
3156932049 This is guaranteed to be a stable sort since version 2.32.</doc>
3157032050 <source-position filename="glib/garray.h" line="242"/>
@@ -31575,15 +32055,18 @@ This is guaranteed to be a stable sort since version 2.32.</doc>
3157532055 <parameter name="array" transfer-ownership="none">
3157632056 <doc xml:space="preserve"
3157732057 filename="glib/garray.c"
31578- line="2427">a #GPtrArray</doc>
32058+ line="2445">a pointer array</doc>
3157932059 <array name="GLib.PtrArray" c:type="GPtrArray*">
3158032060 <type name="gpointer" c:type="gpointer"/>
3158132061 </array>
3158232062 </parameter>
31583- <parameter name="compare_func" transfer-ownership="none" closure="2">
32063+ <parameter name="compare_func"
32064+ transfer-ownership="none"
32065+ scope="call"
32066+ closure="2">
3158432067 <doc xml:space="preserve"
3158532068 filename="glib/garray.c"
31586- line="2428">comparison function</doc>
32069+ line="2446">a comparison function</doc>
3158732070 <type name="CompareDataFunc" c:type="GCompareDataFunc"/>
3158832071 </parameter>
3158932072 <parameter name="user_data"
@@ -31592,7 +32075,7 @@ This is guaranteed to be a stable sort since version 2.32.</doc>
3159232075 allow-none="1">
3159332076 <doc xml:space="preserve"
3159432077 filename="glib/garray.c"
31595- line="2429">data to pass to @compare_func</doc>
32078+ line="2447">the data to pass to @compare_func</doc>
3159632079 <type name="gpointer" c:type="gpointer"/>
3159732080 </parameter>
3159832081 </parameters>
@@ -31603,20 +32086,20 @@ This is guaranteed to be a stable sort since version 2.32.</doc>
3160332086 introspectable="0">
3160432087 <doc xml:space="preserve"
3160532088 filename="glib/garray.c"
31606- line="1407">Frees the data in the array and resets the size to zero, while
32089+ line="1421">Frees the data in the array and resets the size to zero, while
3160732090 the underlying array is preserved for use elsewhere and returned
3160832091 to the caller.
3160932092
31610-Note that if the array is %NULL terminated this may still return
31611-%NULL if the length of the array was zero and pdata was not yet
32093+Note that if the array is `NULL` terminated this may still return
32094+`NULL` if the length of the array was zero and pdata was not yet
3161232095 allocated.
3161332096
31614-Even if set, the #GDestroyNotify function will never be called
32097+Even if set, the [callback@GLib.DestroyNotify] function will never be called
3161532098 on the current contents of the array and the caller is
3161632099 responsible for freeing the array elements.
3161732100
3161832101 An example of use:
31619-|[&lt;!-- language="C" --&gt;
32102+```c
3162032103 g_autoptr(GPtrArray) chunk_buffer = g_ptr_array_new_with_free_func (g_bytes_unref);
3162132104
3162232105 // Some part of your application appends a number of chunks to the pointer array.
@@ -31646,21 +32129,22 @@ g_free (chunks);
3164632129 // After calling g_ptr_array_steal(), the pointer array can be reused for the
3164732130 // next set of chunks.
3164832131 g_assert (chunk_buffer-&gt;len == 0);
31649-]|</doc>
32132+```</doc>
3165032133 <source-position filename="glib/garray.h" line="165"/>
3165132134 <return-value transfer-ownership="full" nullable="1">
3165232135 <doc xml:space="preserve"
3165332136 filename="glib/garray.c"
31654- line="1458">the element data, which should be
31655- freed using g_free(). This may be %NULL if the array doesn’t have any
31656- elements (i.e. if `*len` is zero).</doc>
31657- <type name="gpointer" c:type="gpointer*"/>
32137+ line="1472">The allocated element data.
32138+ This may be `NULL`if the array doesn’t have any elements (i.e. if `*len` is zero).</doc>
32139+ <array length="1" zero-terminated="0" c:type="gpointer*">
32140+ <type name="gpointer" c:type="gpointer"/>
32141+ </array>
3165832142 </return-value>
3165932143 <parameters>
3166032144 <parameter name="array" transfer-ownership="none">
3166132145 <doc xml:space="preserve"
3166232146 filename="glib/garray.c"
31663- line="1409">a #GPtrArray.</doc>
32147+ line="1423">a pointer array</doc>
3166432148 <array name="GLib.PtrArray" c:type="GPtrArray*">
3166532149 <type name="gpointer" c:type="gpointer"/>
3166632150 </array>
@@ -31673,7 +32157,7 @@ g_assert (chunk_buffer-&gt;len == 0);
3167332157 allow-none="1">
3167432158 <doc xml:space="preserve"
3167532159 filename="glib/garray.c"
31676- line="1410">pointer to retrieve the number of
32160+ line="1424">a pointer to retrieve the number of
3167732161 elements of the original array</doc>
3167832162 <type name="gsize" c:type="gsize*"/>
3167932163 </parameter>
@@ -31685,22 +32169,23 @@ g_assert (chunk_buffer-&gt;len == 0);
3168532169 introspectable="0">
3168632170 <doc xml:space="preserve"
3168732171 filename="glib/garray.c"
31688- line="2030">Removes the pointer at the given index from the pointer array.
31689-The following elements are moved down one place. The #GDestroyNotify for
32172+ line="2046">Removes the pointer at the given index from the pointer array.
32173+The following elements are moved down one place. The
32174+[callback@GLib.DestroyNotify] for
3169032175 @array is *not* called on the removed element; ownership is transferred to
3169132176 the caller of this function.</doc>
3169232177 <source-position filename="glib/garray.h" line="208"/>
3169332178 <return-value transfer-ownership="full" nullable="1">
3169432179 <doc xml:space="preserve"
3169532180 filename="glib/garray.c"
31696- line="2040">the pointer which was removed</doc>
32181+ line="2057">The pointer which was removed</doc>
3169732182 <type name="gpointer" c:type="gpointer"/>
3169832183 </return-value>
3169932184 <parameters>
3170032185 <parameter name="array" transfer-ownership="none">
3170132186 <doc xml:space="preserve"
3170232187 filename="glib/garray.c"
31703- line="2032">a #GPtrArray</doc>
32188+ line="2048">a pointer array</doc>
3170432189 <array name="GLib.PtrArray" c:type="GPtrArray*">
3170532190 <type name="gpointer" c:type="gpointer"/>
3170632191 </array>
@@ -31708,7 +32193,7 @@ the caller of this function.</doc>
3170832193 <parameter name="index_" transfer-ownership="none">
3170932194 <doc xml:space="preserve"
3171032195 filename="glib/garray.c"
31711- line="2033">the index of the pointer to steal</doc>
32196+ line="2049">the index of the pointer to steal</doc>
3171232197 <type name="guint" c:type="guint"/>
3171332198 </parameter>
3171432199 </parameters>
@@ -31719,24 +32204,25 @@ the caller of this function.</doc>
3171932204 introspectable="0">
3172032205 <doc xml:space="preserve"
3172132206 filename="glib/garray.c"
31722- line="2050">Removes the pointer at the given index from the pointer array.
32207+ line="2067">Removes the pointer at the given index from the pointer array.
3172332208 The last element in the array is used to fill in the space, so
3172432209 this function does not preserve the order of the array. But it
31725-is faster than g_ptr_array_steal_index(). The #GDestroyNotify for @array is
32210+is faster than [func@GLib.PtrArray.steal_index]. The
32211+[callback@GLib.DestroyNotify] for @array is
3172632212 *not* called on the removed element; ownership is transferred to the caller
3172732213 of this function.</doc>
3172832214 <source-position filename="glib/garray.h" line="211"/>
3172932215 <return-value transfer-ownership="full" nullable="1">
3173032216 <doc xml:space="preserve"
3173132217 filename="glib/garray.c"
31732- line="2062">the pointer which was removed</doc>
32218+ line="2080">The pointer which was removed</doc>
3173332219 <type name="gpointer" c:type="gpointer"/>
3173432220 </return-value>
3173532221 <parameters>
3173632222 <parameter name="array" transfer-ownership="none">
3173732223 <doc xml:space="preserve"
3173832224 filename="glib/garray.c"
31739- line="2052">a #GPtrArray</doc>
32225+ line="2069">a pointer array</doc>
3174032226 <array name="GLib.PtrArray" c:type="GPtrArray*">
3174132227 <type name="gpointer" c:type="gpointer"/>
3174232228 </array>
@@ -31744,7 +32230,7 @@ of this function.</doc>
3174432230 <parameter name="index_" transfer-ownership="none">
3174532231 <doc xml:space="preserve"
3174632232 filename="glib/garray.c"
31747- line="2053">the index of the pointer to steal</doc>
32233+ line="2070">the index of the pointer to steal</doc>
3174832234 <type name="guint" c:type="guint"/>
3174932235 </parameter>
3175032236 </parameters>
@@ -31755,19 +32241,19 @@ of this function.</doc>
3175532241 introspectable="0">
3175632242 <doc xml:space="preserve"
3175732243 filename="glib/garray.c"
31758- line="1754">Atomically decrements the reference count of @array by one. If the
32244+ line="1769">Atomically decrements the reference count of @array by one. If the
3175932245 reference count drops to 0, the effect is the same as calling
31760-g_ptr_array_free() with @free_segment set to %TRUE. This function
32246+[func@GLib.PtrArray.free] with @free_segment set to true. This function
3176132247 is thread-safe and may be called from any thread.</doc>
3176232248 <source-position filename="glib/garray.h" line="194"/>
3176332249 <return-value transfer-ownership="none">
3176432250 <type name="none" c:type="void"/>
3176532251 </return-value>
3176632252 <parameters>
31767- <parameter name="array" transfer-ownership="none">
32253+ <parameter name="array" transfer-ownership="full">
3176832254 <doc xml:space="preserve"
3176932255 filename="glib/garray.c"
31770- line="1756">A #GPtrArray</doc>
32256+ line="1771">a pointer array</doc>
3177132257 <array name="GLib.PtrArray" c:type="GPtrArray*">
3177232258 <type name="gpointer" c:type="gpointer"/>
3177332259 </array>
@@ -33525,13 +34011,13 @@ variable, which could be before any statement in the case
3352534011 c:symbol-prefix="rand">
3352634012 <doc xml:space="preserve"
3352734013 filename="glib/grand.c"
33528- line="65">The GRand struct is an opaque data structure. It should only be
34014+ line="66">The GRand struct is an opaque data structure. It should only be
3352934015 accessed through the g_rand_* functions.</doc>
3353034016 <source-position filename="glib/grand.h" line="38"/>
3353134017 <constructor name="new" c:identifier="g_rand_new">
3353234018 <doc xml:space="preserve"
3353334019 filename="glib/grand.c"
33534- line="158">Creates a new random number generator initialized with a seed taken
34020+ line="159">Creates a new random number generator initialized with a seed taken
3353534021 either from `/dev/urandom` (if existing) or from the current time
3353634022 (as a fallback).
3353734023
@@ -33540,26 +34026,26 @@ On Windows, the seed is taken from rand_s().</doc>
3354034026 <return-value transfer-ownership="full">
3354134027 <doc xml:space="preserve"
3354234028 filename="glib/grand.c"
33543- line="167">the new #GRand</doc>
34029+ line="168">the new #GRand</doc>
3354434030 <type name="Rand" c:type="GRand*"/>
3354534031 </return-value>
3354634032 </constructor>
3354734033 <constructor name="new_with_seed" c:identifier="g_rand_new_with_seed">
3354834034 <doc xml:space="preserve"
3354934035 filename="glib/grand.c"
33550- line="121">Creates a new random number generator initialized with @seed.</doc>
34036+ line="122">Creates a new random number generator initialized with @seed.</doc>
3355134037 <source-position filename="glib/grand.h" line="50"/>
3355234038 <return-value transfer-ownership="full">
3355334039 <doc xml:space="preserve"
3355434040 filename="glib/grand.c"
33555- line="127">the new #GRand</doc>
34041+ line="128">the new #GRand</doc>
3355634042 <type name="Rand" c:type="GRand*"/>
3355734043 </return-value>
3355834044 <parameters>
3355934045 <parameter name="seed" transfer-ownership="none">
3356034046 <doc xml:space="preserve"
3356134047 filename="glib/grand.c"
33562- line="123">a value to initialize the random number generator</doc>
34048+ line="124">a value to initialize the random number generator</doc>
3356334049 <type name="guint32" c:type="guint32"/>
3356434050 </parameter>
3356534051 </parameters>
@@ -33569,25 +34055,25 @@ On Windows, the seed is taken from rand_s().</doc>
3356934055 version="2.4">
3357034056 <doc xml:space="preserve"
3357134057 filename="glib/grand.c"
33572- line="137">Creates a new random number generator initialized with @seed.</doc>
34058+ line="138">Creates a new random number generator initialized with @seed.</doc>
3357334059 <source-position filename="glib/grand.h" line="52"/>
3357434060 <return-value transfer-ownership="full">
3357534061 <doc xml:space="preserve"
3357634062 filename="glib/grand.c"
33577- line="145">the new #GRand</doc>
34063+ line="146">the new #GRand</doc>
3357834064 <type name="Rand" c:type="GRand*"/>
3357934065 </return-value>
3358034066 <parameters>
3358134067 <parameter name="seed" transfer-ownership="none">
3358234068 <doc xml:space="preserve"
3358334069 filename="glib/grand.c"
33584- line="139">an array of seeds to initialize the random number generator</doc>
34070+ line="140">an array of seeds to initialize the random number generator</doc>
3358534071 <type name="guint32" c:type="const guint32*"/>
3358634072 </parameter>
3358734073 <parameter name="seed_length" transfer-ownership="none">
3358834074 <doc xml:space="preserve"
3358934075 filename="glib/grand.c"
33590- line="140">an array of seeds to initialize the random number
34076+ line="141">an array of seeds to initialize the random number
3359134077 generator</doc>
3359234078 <type name="guint" c:type="guint"/>
3359334079 </parameter>
@@ -33596,21 +34082,21 @@ On Windows, the seed is taken from rand_s().</doc>
3359634082 <method name="copy" c:identifier="g_rand_copy" version="2.4">
3359734083 <doc xml:space="preserve"
3359834084 filename="glib/grand.c"
33599- line="254">Copies a #GRand into a new one with the same exact state as before.
34085+ line="255">Copies a #GRand into a new one with the same exact state as before.
3360034086 This way you can take a snapshot of the random number generator for
3360134087 replaying later.</doc>
3360234088 <source-position filename="glib/grand.h" line="59"/>
3360334089 <return-value transfer-ownership="full">
3360434090 <doc xml:space="preserve"
3360534091 filename="glib/grand.c"
33606- line="262">the new #GRand</doc>
34092+ line="263">the new #GRand</doc>
3360734093 <type name="Rand" c:type="GRand*"/>
3360834094 </return-value>
3360934095 <parameters>
3361034096 <instance-parameter name="rand_" transfer-ownership="none">
3361134097 <doc xml:space="preserve"
3361234098 filename="glib/grand.c"
33613- line="256">a #GRand</doc>
34099+ line="257">a #GRand</doc>
3361434100 <type name="Rand" c:type="GRand*"/>
3361534101 </instance-parameter>
3361634102 </parameters>
@@ -33618,20 +34104,20 @@ replaying later.</doc>
3361834104 <method name="double" c:identifier="g_rand_double">
3361934105 <doc xml:space="preserve"
3362034106 filename="glib/grand.c"
33621- line="523">Returns the next random #gdouble from @rand_ equally distributed over
34107+ line="524">Returns the next random #gdouble from @rand_ equally distributed over
3362234108 the range [0..1).</doc>
3362334109 <source-position filename="glib/grand.h" line="77"/>
3362434110 <return-value transfer-ownership="none">
3362534111 <doc xml:space="preserve"
3362634112 filename="glib/grand.c"
33627- line="530">a random number</doc>
34113+ line="531">a random number</doc>
3362834114 <type name="gdouble" c:type="gdouble"/>
3362934115 </return-value>
3363034116 <parameters>
3363134117 <instance-parameter name="rand_" transfer-ownership="none">
3363234118 <doc xml:space="preserve"
3363334119 filename="glib/grand.c"
33634- line="525">a #GRand</doc>
34120+ line="526">a #GRand</doc>
3363534121 <type name="Rand" c:type="GRand*"/>
3363634122 </instance-parameter>
3363734123 </parameters>
@@ -33639,32 +34125,32 @@ the range [0..1).</doc>
3363934125 <method name="double_range" c:identifier="g_rand_double_range">
3364034126 <doc xml:space="preserve"
3364134127 filename="glib/grand.c"
33642- line="548">Returns the next random #gdouble from @rand_ equally distributed over
34128+ line="549">Returns the next random #gdouble from @rand_ equally distributed over
3364334129 the range [@begin..@end).</doc>
3364434130 <source-position filename="glib/grand.h" line="79"/>
3364534131 <return-value transfer-ownership="none">
3364634132 <doc xml:space="preserve"
3364734133 filename="glib/grand.c"
33648- line="557">a random number</doc>
34134+ line="558">a random number</doc>
3364934135 <type name="gdouble" c:type="gdouble"/>
3365034136 </return-value>
3365134137 <parameters>
3365234138 <instance-parameter name="rand_" transfer-ownership="none">
3365334139 <doc xml:space="preserve"
3365434140 filename="glib/grand.c"
33655- line="550">a #GRand</doc>
34141+ line="551">a #GRand</doc>
3365634142 <type name="Rand" c:type="GRand*"/>
3365734143 </instance-parameter>
3365834144 <parameter name="begin" transfer-ownership="none">
3365934145 <doc xml:space="preserve"
3366034146 filename="glib/grand.c"
33661- line="551">lower closed bound of the interval</doc>
34147+ line="552">lower closed bound of the interval</doc>
3366234148 <type name="gdouble" c:type="gdouble"/>
3366334149 </parameter>
3366434150 <parameter name="end" transfer-ownership="none">
3366534151 <doc xml:space="preserve"
3366634152 filename="glib/grand.c"
33667- line="552">upper open bound of the interval</doc>
34153+ line="553">upper open bound of the interval</doc>
3366834154 <type name="gdouble" c:type="gdouble"/>
3366934155 </parameter>
3367034156 </parameters>
@@ -33672,7 +34158,7 @@ the range [@begin..@end).</doc>
3367234158 <method name="free" c:identifier="g_rand_free">
3367334159 <doc xml:space="preserve"
3367434160 filename="glib/grand.c"
33675- line="240">Frees the memory allocated for the #GRand.</doc>
34161+ line="241">Frees the memory allocated for the #GRand.</doc>
3367634162 <source-position filename="glib/grand.h" line="57"/>
3367734163 <return-value transfer-ownership="none">
3367834164 <type name="none" c:type="void"/>
@@ -33681,7 +34167,7 @@ the range [@begin..@end).</doc>
3368134167 <instance-parameter name="rand_" transfer-ownership="none">
3368234168 <doc xml:space="preserve"
3368334169 filename="glib/grand.c"
33684- line="242">a #GRand</doc>
34170+ line="243">a #GRand</doc>
3368534171 <type name="Rand" c:type="GRand*"/>
3368634172 </instance-parameter>
3368734173 </parameters>
@@ -33689,20 +34175,20 @@ the range [@begin..@end).</doc>
3368934175 <method name="int" c:identifier="g_rand_int">
3369034176 <doc xml:space="preserve"
3369134177 filename="glib/grand.c"
33692- line="392">Returns the next random #guint32 from @rand_ equally distributed over
34178+ line="393">Returns the next random #guint32 from @rand_ equally distributed over
3369334179 the range [0..2^32-1].</doc>
3369434180 <source-position filename="glib/grand.h" line="71"/>
3369534181 <return-value transfer-ownership="none">
3369634182 <doc xml:space="preserve"
3369734183 filename="glib/grand.c"
33698- line="399">a random number</doc>
34184+ line="400">a random number</doc>
3369934185 <type name="guint32" c:type="guint32"/>
3370034186 </return-value>
3370134187 <parameters>
3370234188 <instance-parameter name="rand_" transfer-ownership="none">
3370334189 <doc xml:space="preserve"
3370434190 filename="glib/grand.c"
33705- line="394">a #GRand</doc>
34191+ line="395">a #GRand</doc>
3370634192 <type name="Rand" c:type="GRand*"/>
3370734193 </instance-parameter>
3370834194 </parameters>
@@ -33710,32 +34196,32 @@ the range [0..2^32-1].</doc>
3371034196 <method name="int_range" c:identifier="g_rand_int_range">
3371134197 <doc xml:space="preserve"
3371234198 filename="glib/grand.c"
33713- line="439">Returns the next random #gint32 from @rand_ equally distributed over
34199+ line="440">Returns the next random #gint32 from @rand_ equally distributed over
3371434200 the range [@begin..@end-1].</doc>
3371534201 <source-position filename="glib/grand.h" line="73"/>
3371634202 <return-value transfer-ownership="none">
3371734203 <doc xml:space="preserve"
3371834204 filename="glib/grand.c"
33719- line="448">a random number</doc>
34205+ line="449">a random number</doc>
3372034206 <type name="gint32" c:type="gint32"/>
3372134207 </return-value>
3372234208 <parameters>
3372334209 <instance-parameter name="rand_" transfer-ownership="none">
3372434210 <doc xml:space="preserve"
3372534211 filename="glib/grand.c"
33726- line="441">a #GRand</doc>
34212+ line="442">a #GRand</doc>
3372734213 <type name="Rand" c:type="GRand*"/>
3372834214 </instance-parameter>
3372934215 <parameter name="begin" transfer-ownership="none">
3373034216 <doc xml:space="preserve"
3373134217 filename="glib/grand.c"
33732- line="442">lower closed bound of the interval</doc>
34218+ line="443">lower closed bound of the interval</doc>
3373334219 <type name="gint32" c:type="gint32"/>
3373434220 </parameter>
3373534221 <parameter name="end" transfer-ownership="none">
3373634222 <doc xml:space="preserve"
3373734223 filename="glib/grand.c"
33738- line="443">upper open bound of the interval</doc>
34224+ line="444">upper open bound of the interval</doc>
3373934225 <type name="gint32" c:type="gint32"/>
3374034226 </parameter>
3374134227 </parameters>
@@ -33743,7 +34229,7 @@ the range [@begin..@end-1].</doc>
3374334229 <method name="set_seed" c:identifier="g_rand_set_seed">
3374434230 <doc xml:space="preserve"
3374534231 filename="glib/grand.c"
33746- line="279">Sets the seed for the random number generator #GRand to @seed.</doc>
34232+ line="280">Sets the seed for the random number generator #GRand to @seed.</doc>
3374734233 <source-position filename="glib/grand.h" line="61"/>
3374834234 <return-value transfer-ownership="none">
3374934235 <type name="none" c:type="void"/>
@@ -33752,13 +34238,13 @@ the range [@begin..@end-1].</doc>
3375234238 <instance-parameter name="rand_" transfer-ownership="none">
3375334239 <doc xml:space="preserve"
3375434240 filename="glib/grand.c"
33755- line="281">a #GRand</doc>
34241+ line="282">a #GRand</doc>
3375634242 <type name="Rand" c:type="GRand*"/>
3375734243 </instance-parameter>
3375834244 <parameter name="seed" transfer-ownership="none">
3375934245 <doc xml:space="preserve"
3376034246 filename="glib/grand.c"
33761- line="282">a value to reinitialize the random number generator</doc>
34247+ line="283">a value to reinitialize the random number generator</doc>
3376234248 <type name="guint32" c:type="guint32"/>
3376334249 </parameter>
3376434250 </parameters>
@@ -33768,7 +34254,7 @@ the range [@begin..@end-1].</doc>
3376834254 version="2.4">
3376934255 <doc xml:space="preserve"
3377034256 filename="glib/grand.c"
33771- line="323">Initializes the random number generator by an array of longs.
34257+ line="324">Initializes the random number generator by an array of longs.
3377234258 Array can be of arbitrary size, though only the first 624 values
3377334259 are taken. This function is useful if you have many low entropy
3377434260 seeds, or if you require more then 32 bits of actual entropy for
@@ -33781,19 +34267,19 @@ your application.</doc>
3378134267 <instance-parameter name="rand_" transfer-ownership="none">
3378234268 <doc xml:space="preserve"
3378334269 filename="glib/grand.c"
33784- line="325">a #GRand</doc>
34270+ line="326">a #GRand</doc>
3378534271 <type name="Rand" c:type="GRand*"/>
3378634272 </instance-parameter>
3378734273 <parameter name="seed" transfer-ownership="none">
3378834274 <doc xml:space="preserve"
3378934275 filename="glib/grand.c"
33790- line="326">array to initialize with</doc>
34276+ line="327">array to initialize with</doc>
3379134277 <type name="guint32" c:type="const guint32*"/>
3379234278 </parameter>
3379334279 <parameter name="seed_length" transfer-ownership="none">
3379434280 <doc xml:space="preserve"
3379534281 filename="glib/grand.c"
33796- line="327">length of array</doc>
34282+ line="328">length of array</doc>
3379734283 <type name="guint" c:type="guint"/>
3379834284 </parameter>
3379934285 </parameters>
@@ -33965,58 +34451,133 @@ locked by the current thread leads to undefined behaviour.</doc>
3396534451 c:symbol-prefix="regex">
3396634452 <doc xml:space="preserve"
3396734453 filename="glib/gregex.c"
33968- line="42">A `GRegex` is the "compiled" form of a regular expression pattern.
34454+ line="42">A `GRegex` is a compiled form of a regular expression.
34455+
34456+After instantiating a `GRegex`, you can use its methods to find matches
34457+in a string, replace matches within a string, or split the string at matches.
3396934458
3397034459 `GRegex` implements regular expression pattern matching using syntax and
33971-semantics similar to Perl regular expression. See the
33972-[PCRE documentation](man:pcrepattern(3)) for the syntax definition.
33973-
33974-Some functions accept a @start_position argument, setting it differs
33975-from just passing over a shortened string and setting %G_REGEX_MATCH_NOTBOL
33976-in the case of a pattern that begins with any kind of lookbehind assertion.
33977-For example, consider the pattern "\Biss\B" which finds occurrences of "iss"
33978-in the middle of words. ("\B" matches only if the current position in the
33979-subject is not a word boundary.) When applied to the string "Mississipi"
33980-from the fourth byte, namely "issipi", it does not match, because "\B" is
33981-always false at the start of the subject, which is deemed to be a word
33982-boundary. However, if the entire string is passed , but with
33983-@start_position set to 4, it finds the second occurrence of "iss" because
33984-it is able to look behind the starting point to discover that it is
33985-preceded by a letter.
33986-
33987-Note that, unless you set the %G_REGEX_RAW flag, all the strings passed
33988-to these functions must be encoded in UTF-8. The lengths and the positions
33989-inside the strings are in bytes and not in characters, so, for instance,
33990-"\xc3\xa0" (i.e. "à") is two bytes long but it is treated as a
33991-single character. If you set %G_REGEX_RAW the strings can be non-valid
33992-UTF-8 strings and a byte is treated as a character, so "\xc3\xa0" is two
33993-bytes and two characters long.
33994-
33995-When matching a pattern, "\n" matches only against a "\n" character in
33996-the string, and "\r" matches only a "\r" character. To match any newline
33997-sequence use "\R". This particular group matches either the two-character
33998-sequence CR + LF ("\r\n"), or one of the single characters LF (linefeed,
33999-U+000A, "\n"), VT vertical tab, U+000B, "\v"), FF (formfeed, U+000C, "\f"),
34000-CR (carriage return, U+000D, "\r"), NEL (next line, U+0085), LS (line
34001-separator, U+2028), or PS (paragraph separator, U+2029).
34460+semantics (such as character classes, quantifiers, and capture groups)
34461+similar to Perl regular expression. See the
34462+[PCRE documentation](man:pcre2pattern(3)) for details.
34463+
34464+A typical scenario for regex pattern matching is to check if a string
34465+matches a pattern. The following statements implement this scenario.
34466+
34467+``` { .c }
34468+const char *regex_pattern = ".*GLib.*";
34469+const char *string_to_search = "You will love the GLib implementation of regex";
34470+g_autoptr(GMatchInfo) match_info = NULL;
34471+g_autoptr(GRegex) regex = NULL;
34472+
34473+regex = g_regex_new (regex_pattern, G_REGEX_DEFAULT, G_REGEX_MATCH_DEFAULT, NULL);
34474+g_assert (regex != NULL);
34475+
34476+if (g_regex_match (regex, string_to_search, G_REGEX_MATCH_DEFAULT, &amp;match_info))
34477+ {
34478+ int start_pos, end_pos;
34479+ g_match_info_fetch_pos (match_info, 0, &amp;start_pos, &amp;end_pos);
34480+ g_print ("Match successful! Overall pattern matches bytes %d to %d\n", start_pos, end_pos);
34481+ }
34482+else
34483+ {
34484+ g_print ("No match!\n");
34485+ }
34486+```
34487+
34488+The constructor for `GRegex` includes two sets of bitmapped flags:
34489+
34490+* [flags@GLib.RegexCompileFlags]—These flags
34491+control how GLib compiles the regex. There are options for case
34492+sensitivity, multiline, ignoring whitespace, etc.
34493+* [flags@GLib.RegexMatchFlags]—These flags control
34494+`GRegex`’s matching behavior, such as anchoring and customizing definitions
34495+for newline characters.
34496+
34497+Some regex patterns include backslash assertions, such as `\d` (digit) or
34498+`\D` (non-digit). The regex pattern must escape those backslashes. For
34499+example, the pattern `"\\d\\D"` matches a digit followed by a non-digit.
34500+
34501+GLib’s implementation of pattern matching includes a `start_position`
34502+argument for some of the match, replace, and split methods. Specifying
34503+a start position provides flexibility when you want to ignore the first
34504+_n_ characters of a string, but want to incorporate backslash assertions
34505+at character _n_ - 1. For example, a database field contains inconsistent
34506+spelling for a job title: `healthcare provider` and `health-care provider`.
34507+The database manager wants to make the spelling consistent by adding a
34508+hyphen when it is missing. The following regex pattern tests for the string
34509+`care` preceded by a non-word boundary character (instead of a hyphen)
34510+and followed by a space.
34511+
34512+``` { .c }
34513+const char *regex_pattern = "\\Bcare\\s";
34514+```
34515+
34516+An efficient way to match with this pattern is to start examining at
34517+`start_position` 6 in the string `healthcare` or `health-care`.
34518+
34519+``` { .c }
34520+const char *regex_pattern = "\\Bcare\\s";
34521+const char *string_to_search = "healthcare provider";
34522+g_autoptr(GMatchInfo) match_info = NULL;
34523+g_autoptr(GRegex) regex = NULL;
34524+
34525+regex = g_regex_new (
34526+ regex_pattern,
34527+ G_REGEX_DEFAULT,
34528+ G_REGEX_MATCH_DEFAULT,
34529+ NULL);
34530+g_assert (regex != NULL);
34531+
34532+g_regex_match_full (
34533+ regex,
34534+ string_to_search,
34535+ -1,
34536+ 6, // position of 'c' in the test string.
34537+ G_REGEX_MATCH_DEFAULT,
34538+ &amp;match_info,
34539+ NULL);
34540+```
34541+
34542+The method [method@GLib.Regex.match_full] (and other methods implementing
34543+`start_pos`) allow for lookback before the start position to determine if
34544+the previous character satisfies an assertion.
34545+
34546+Unless you set the [flags@GLib.RegexCompileFlags.RAW] as one of
34547+the `GRegexCompileFlags`, all the strings passed to `GRegex` methods must
34548+be encoded in UTF-8. The lengths and the positions inside the strings are
34549+in bytes and not in characters, so, for instance, `\xc3\xa0` (i.e., `à`)
34550+is two bytes long but it is treated as a single character. If you set
34551+`G_REGEX_RAW`, the strings can be non-valid UTF-8 strings and a byte is
34552+treated as a character, so `\xc3\xa0` is two bytes and two characters long.
34553+
34554+Regarding line endings, `\n` matches a `\n` character, and `\r` matches
34555+a `\r` character. More generally, `\R` matches all typical line endings:
34556+CR + LF (`\r\n`), LF (linefeed, U+000A, `\n`), VT (vertical tab, U+000B,
34557+`\v`), FF (formfeed, U+000C, `\f`), CR (carriage return, U+000D, `\r`),
34558+NEL (next line, U+0085), LS (line separator, U+2028), and PS (paragraph
34559+separator, U+2029).
3400234560
3400334561 The behaviour of the dot, circumflex, and dollar metacharacters are
34004-affected by newline characters, the default is to recognize any newline
34005-character (the same characters recognized by "\R"). This can be changed
34006-with `G_REGEX_NEWLINE_CR`, `G_REGEX_NEWLINE_LF` and `G_REGEX_NEWLINE_CRLF`
34007-compile options, and with `G_REGEX_MATCH_NEWLINE_ANY`,
34008-`G_REGEX_MATCH_NEWLINE_CR`, `G_REGEX_MATCH_NEWLINE_LF` and
34009-`G_REGEX_MATCH_NEWLINE_CRLF` match options. These settings are also
34010-relevant when compiling a pattern if `G_REGEX_EXTENDED` is set, and an
34011-unescaped "#" outside a character class is encountered. This indicates
34012-a comment that lasts until after the next newline.
34013-
34014-Creating and manipulating the same `GRegex` structure from different
34015-threads is not a problem as `GRegex` does not modify its internal
34016-state between creation and destruction, on the other hand `GMatchInfo`
34017-is not threadsafe.
34018-
34019-The regular expressions low-level functionalities are obtained through
34562+affected by newline characters. By default, `GRegex` matches any newline
34563+character matched by `\R`. You can limit the matched newline characters by
34564+specifying the [flags@GLib.RegexMatchFlags.NEWLINE_CR],
34565+[flags@GLib.RegexMatchFlags.NEWLINE_LF], and
34566+[flags@GLib.RegexMatchFlags.NEWLINE_CRLF] compile options, and
34567+with [flags@GLib.RegexMatchFlags.NEWLINE_ANY],
34568+[flags@GLib.RegexMatchFlags.NEWLINE_CR],
34569+[flags@GLib.RegexMatchFlags.NEWLINE_LF] and
34570+[flags@GLib.RegexMatchFlags.NEWLINE_CRLF] match options.
34571+These settings are also relevant when compiling a pattern if
34572+[flags@GLib.RegexCompileFlags.EXTENDED] is set and an unescaped
34573+`#` outside a character class is encountered. This indicates a comment
34574+that lasts until after the next newline.
34575+
34576+Because `GRegex` does not modify its internal state between creation and
34577+destruction, you can create and modify the same `GRegex` instance from
34578+different threads. In contrast, [struct@GLib.MatchInfo] is not thread safe.
34579+
34580+The regular expression low-level functionalities are obtained through
3402034581 the excellent [PCRE](http://www.pcre.org/) library written by Philip Hazel.</doc>
3402134582 <source-position filename="glib/gregex.h" line="416"/>
3402234583 <constructor name="new"
@@ -34025,13 +34586,13 @@ the excellent [PCRE](http://www.pcre.org/) library written by Philip Hazel.</doc
3402534586 throws="1">
3402634587 <doc xml:space="preserve"
3402734588 filename="glib/gregex.c"
34028- line="1710">Compiles the regular expression to an internal form, and does
34589+ line="1980">Compiles the regular expression to an internal form, and does
3402934590 the initial setup of the #GRegex structure.</doc>
3403034591 <source-position filename="glib/gregex.h" line="450"/>
3403134592 <return-value transfer-ownership="full" nullable="1">
3403234593 <doc xml:space="preserve"
3403334594 filename="glib/gregex.c"
34034- line="1720">a #GRegex structure or %NULL if an error occurred. Call
34595+ line="1990">a #GRegex structure or %NULL if an error occurred. Call
3403534596 g_regex_unref() when you are done with it</doc>
3403634597 <type name="Regex" c:type="GRegex*"/>
3403734598 </return-value>
@@ -34039,19 +34600,19 @@ the initial setup of the #GRegex structure.</doc>
3403934600 <parameter name="pattern" transfer-ownership="none">
3404034601 <doc xml:space="preserve"
3404134602 filename="glib/gregex.c"
34042- line="1712">the regular expression</doc>
34603+ line="1982">the regular expression</doc>
3404334604 <type name="utf8" c:type="const gchar*"/>
3404434605 </parameter>
3404534606 <parameter name="compile_options" transfer-ownership="none">
3404634607 <doc xml:space="preserve"
3404734608 filename="glib/gregex.c"
34048- line="1713">compile options for the regular expression, or 0</doc>
34609+ line="1983">compile options for the regular expression, or 0</doc>
3404934610 <type name="RegexCompileFlags" c:type="GRegexCompileFlags"/>
3405034611 </parameter>
3405134612 <parameter name="match_options" transfer-ownership="none">
3405234613 <doc xml:space="preserve"
3405334614 filename="glib/gregex.c"
34054- line="1714">match options for the regular expression, or 0</doc>
34615+ line="1984">match options for the regular expression, or 0</doc>
3405534616 <type name="RegexMatchFlags" c:type="GRegexMatchFlags"/>
3405634617 </parameter>
3405734618 </parameters>
@@ -34061,19 +34622,19 @@ the initial setup of the #GRegex structure.</doc>
3406134622 version="2.14">
3406234623 <doc xml:space="preserve"
3406334624 filename="glib/gregex.c"
34064- line="1959">Returns the number of capturing subpatterns in the pattern.</doc>
34625+ line="2229">Returns the number of capturing subpatterns in the pattern.</doc>
3406534626 <source-position filename="glib/gregex.h" line="463"/>
3406634627 <return-value transfer-ownership="none">
3406734628 <doc xml:space="preserve"
3406834629 filename="glib/gregex.c"
34069- line="1965">the number of capturing subpatterns</doc>
34630+ line="2235">the number of capturing subpatterns</doc>
3407034631 <type name="gint" c:type="gint"/>
3407134632 </return-value>
3407234633 <parameters>
3407334634 <instance-parameter name="regex" transfer-ownership="none">
3407434635 <doc xml:space="preserve"
3407534636 filename="glib/gregex.c"
34076- line="1961">a #GRegex</doc>
34637+ line="2231">a #GRegex</doc>
3407734638 <type name="Regex" c:type="const GRegex*"/>
3407834639 </instance-parameter>
3407934640 </parameters>
@@ -34083,7 +34644,7 @@ the initial setup of the #GRegex structure.</doc>
3408334644 version="2.26">
3408434645 <doc xml:space="preserve"
3408534646 filename="glib/gregex.c"
34086- line="2022">Returns the compile options that @regex was created with.
34647+ line="2292">Returns the compile options that @regex was created with.
3408734648
3408834649 Depending on the version of PCRE that is used, this may or may not
3408934650 include flags set by option expressions such as `(?i)` found at the
@@ -34092,14 +34653,14 @@ top-level within the compiled pattern.</doc>
3409234653 <return-value transfer-ownership="none">
3409334654 <doc xml:space="preserve"
3409434655 filename="glib/gregex.c"
34095- line="2032">flags from #GRegexCompileFlags</doc>
34656+ line="2302">flags from #GRegexCompileFlags</doc>
3409634657 <type name="RegexCompileFlags" c:type="GRegexCompileFlags"/>
3409734658 </return-value>
3409834659 <parameters>
3409934660 <instance-parameter name="regex" transfer-ownership="none">
3410034661 <doc xml:space="preserve"
3410134662 filename="glib/gregex.c"
34102- line="2024">a #GRegex</doc>
34663+ line="2294">a #GRegex</doc>
3410334664 <type name="Regex" c:type="const GRegex*"/>
3410434665 </instance-parameter>
3410534666 </parameters>
@@ -34109,19 +34670,19 @@ top-level within the compiled pattern.</doc>
3410934670 version="2.34">
3411034671 <doc xml:space="preserve"
3411134672 filename="glib/gregex.c"
34112- line="1979">Checks whether the pattern contains explicit CR or LF references.</doc>
34673+ line="2249">Checks whether the pattern contains explicit CR or LF references.</doc>
3411334674 <source-position filename="glib/gregex.h" line="465"/>
3411434675 <return-value transfer-ownership="none">
3411534676 <doc xml:space="preserve"
3411634677 filename="glib/gregex.c"
34117- line="1985">%TRUE if the pattern contains explicit CR or LF references</doc>
34678+ line="2255">%TRUE if the pattern contains explicit CR or LF references</doc>
3411834679 <type name="gboolean" c:type="gboolean"/>
3411934680 </return-value>
3412034681 <parameters>
3412134682 <instance-parameter name="regex" transfer-ownership="none">
3412234683 <doc xml:space="preserve"
3412334684 filename="glib/gregex.c"
34124- line="1981">a #GRegex structure</doc>
34685+ line="2251">a #GRegex structure</doc>
3412534686 <type name="Regex" c:type="const GRegex*"/>
3412634687 </instance-parameter>
3412734688 </parameters>
@@ -34131,19 +34692,19 @@ top-level within the compiled pattern.</doc>
3413134692 version="2.26">
3413234693 <doc xml:space="preserve"
3413334694 filename="glib/gregex.c"
34134- line="2081">Returns the match options that @regex was created with.</doc>
34695+ line="2351">Returns the match options that @regex was created with.</doc>
3413534696 <source-position filename="glib/gregex.h" line="481"/>
3413634697 <return-value transfer-ownership="none">
3413734698 <doc xml:space="preserve"
3413834699 filename="glib/gregex.c"
34139- line="2087">flags from #GRegexMatchFlags</doc>
34700+ line="2357">flags from #GRegexMatchFlags</doc>
3414034701 <type name="RegexMatchFlags" c:type="GRegexMatchFlags"/>
3414134702 </return-value>
3414234703 <parameters>
3414334704 <instance-parameter name="regex" transfer-ownership="none">
3414434705 <doc xml:space="preserve"
3414534706 filename="glib/gregex.c"
34146- line="2083">a #GRegex</doc>
34707+ line="2353">a #GRegex</doc>
3414734708 <type name="Regex" c:type="const GRegex*"/>
3414834709 </instance-parameter>
3414934710 </parameters>
@@ -34153,21 +34714,21 @@ top-level within the compiled pattern.</doc>
3415334714 version="2.14">
3415434715 <doc xml:space="preserve"
3415534716 filename="glib/gregex.c"
34156- line="1937">Returns the number of the highest back reference
34717+ line="2207">Returns the number of the highest back reference
3415734718 in the pattern, or 0 if the pattern does not contain
3415834719 back references.</doc>
3415934720 <source-position filename="glib/gregex.h" line="461"/>
3416034721 <return-value transfer-ownership="none">
3416134722 <doc xml:space="preserve"
3416234723 filename="glib/gregex.c"
34163- line="1945">the number of the highest back reference</doc>
34724+ line="2215">the number of the highest back reference</doc>
3416434725 <type name="gint" c:type="gint"/>
3416534726 </return-value>
3416634727 <parameters>
3416734728 <instance-parameter name="regex" transfer-ownership="none">
3416834729 <doc xml:space="preserve"
3416934730 filename="glib/gregex.c"
34170- line="1939">a #GRegex</doc>
34731+ line="2209">a #GRegex</doc>
3417134732 <type name="Regex" c:type="const GRegex*"/>
3417234733 </instance-parameter>
3417334734 </parameters>
@@ -34177,21 +34738,21 @@ back references.</doc>
3417734738 version="2.38">
3417834739 <doc xml:space="preserve"
3417934740 filename="glib/gregex.c"
34180- line="1999">Gets the number of characters in the longest lookbehind assertion in the
34741+ line="2269">Gets the number of characters in the longest lookbehind assertion in the
3418134742 pattern. This information is useful when doing multi-segment matching using
3418234743 the partial matching facilities.</doc>
3418334744 <source-position filename="glib/gregex.h" line="467"/>
3418434745 <return-value transfer-ownership="none">
3418534746 <doc xml:space="preserve"
3418634747 filename="glib/gregex.c"
34187- line="2007">the number of characters in the longest lookbehind assertion.</doc>
34748+ line="2277">the number of characters in the longest lookbehind assertion.</doc>
3418834749 <type name="gint" c:type="gint"/>
3418934750 </return-value>
3419034751 <parameters>
3419134752 <instance-parameter name="regex" transfer-ownership="none">
3419234753 <doc xml:space="preserve"
3419334754 filename="glib/gregex.c"
34194- line="2001">a #GRegex structure</doc>
34755+ line="2271">a #GRegex structure</doc>
3419534756 <type name="Regex" c:type="const GRegex*"/>
3419634757 </instance-parameter>
3419734758 </parameters>
@@ -34201,20 +34762,20 @@ the partial matching facilities.</doc>
3420134762 version="2.14">
3420234763 <doc xml:space="preserve"
3420334764 filename="glib/gregex.c"
34204- line="1918">Gets the pattern string associated with @regex, i.e. a copy of
34765+ line="2188">Gets the pattern string associated with @regex, i.e. a copy of
3420534766 the string passed to g_regex_new().</doc>
3420634767 <source-position filename="glib/gregex.h" line="459"/>
3420734768 <return-value transfer-ownership="none">
3420834769 <doc xml:space="preserve"
3420934770 filename="glib/gregex.c"
34210- line="1925">the pattern of @regex</doc>
34771+ line="2195">the pattern of @regex</doc>
3421134772 <type name="utf8" c:type="const gchar*"/>
3421234773 </return-value>
3421334774 <parameters>
3421434775 <instance-parameter name="regex" transfer-ownership="none">
3421534776 <doc xml:space="preserve"
3421634777 filename="glib/gregex.c"
34217- line="1920">a #GRegex structure</doc>
34778+ line="2190">a #GRegex structure</doc>
3421834779 <type name="Regex" c:type="const GRegex*"/>
3421934780 </instance-parameter>
3422034781 </parameters>
@@ -34224,12 +34785,12 @@ the string passed to g_regex_new().</doc>
3422434785 version="2.14">
3422534786 <doc xml:space="preserve"
3422634787 filename="glib/gregex.c"
34227- line="2503">Retrieves the number of the subexpression named @name.</doc>
34788+ line="2773">Retrieves the number of the subexpression named @name.</doc>
3422834789 <source-position filename="glib/gregex.h" line="469"/>
3422934790 <return-value transfer-ownership="none">
3423034791 <doc xml:space="preserve"
3423134792 filename="glib/gregex.c"
34232- line="2510">The number of the subexpression or -1 if @name
34793+ line="2780">The number of the subexpression or -1 if @name
3423334794 does not exists</doc>
3423434795 <type name="gint" c:type="gint"/>
3423534796 </return-value>
@@ -34237,13 +34798,13 @@ the string passed to g_regex_new().</doc>
3423734798 <instance-parameter name="regex" transfer-ownership="none">
3423834799 <doc xml:space="preserve"
3423934800 filename="glib/gregex.c"
34240- line="2505">#GRegex structure</doc>
34801+ line="2775">#GRegex structure</doc>
3424134802 <type name="Regex" c:type="const GRegex*"/>
3424234803 </instance-parameter>
3424334804 <parameter name="name" transfer-ownership="none">
3424434805 <doc xml:space="preserve"
3424534806 filename="glib/gregex.c"
34246- line="2506">name of the subexpression</doc>
34807+ line="2776">name of the subexpression</doc>
3424734808 <type name="utf8" c:type="const gchar*"/>
3424834809 </parameter>
3424934810 </parameters>
@@ -34251,7 +34812,7 @@ the string passed to g_regex_new().</doc>
3425134812 <method name="match" c:identifier="g_regex_match" version="2.14">
3425234813 <doc xml:space="preserve"
3425334814 filename="glib/gregex.c"
34254- line="2144">Scans for a match in @string for the pattern in @regex.
34815+ line="2414">Scans for a match in @string for the pattern in @regex.
3425534816 The @match_options are combined with the match options specified
3425634817 when the @regex structure was created, letting you have more
3425734818 flexibility in reusing #GRegex structures.
@@ -34295,26 +34856,26 @@ freeing or modifying @string then the behaviour is undefined.</doc>
3429534856 <return-value transfer-ownership="none">
3429634857 <doc xml:space="preserve"
3429734858 filename="glib/gregex.c"
34298- line="2193">%TRUE is the string matched, %FALSE otherwise</doc>
34859+ line="2463">%TRUE is the string matched, %FALSE otherwise</doc>
3429934860 <type name="gboolean" c:type="gboolean"/>
3430034861 </return-value>
3430134862 <parameters>
3430234863 <instance-parameter name="regex" transfer-ownership="none">
3430334864 <doc xml:space="preserve"
3430434865 filename="glib/gregex.c"
34305- line="2146">a #GRegex structure from g_regex_new()</doc>
34866+ line="2416">a #GRegex structure from g_regex_new()</doc>
3430634867 <type name="Regex" c:type="const GRegex*"/>
3430734868 </instance-parameter>
3430834869 <parameter name="string" transfer-ownership="none">
3430934870 <doc xml:space="preserve"
3431034871 filename="glib/gregex.c"
34311- line="2147">the string to scan for matches</doc>
34872+ line="2417">the string to scan for matches</doc>
3431234873 <type name="utf8" c:type="const gchar*"/>
3431334874 </parameter>
3431434875 <parameter name="match_options" transfer-ownership="none">
3431534876 <doc xml:space="preserve"
3431634877 filename="glib/gregex.c"
34317- line="2148">match options</doc>
34878+ line="2418">match options</doc>
3431834879 <type name="RegexMatchFlags" c:type="GRegexMatchFlags"/>
3431934880 </parameter>
3432034881 <parameter name="match_info"
@@ -34325,7 +34886,7 @@ freeing or modifying @string then the behaviour is undefined.</doc>
3432534886 allow-none="1">
3432634887 <doc xml:space="preserve"
3432734888 filename="glib/gregex.c"
34328- line="2149">pointer to location where to store
34889+ line="2419">pointer to location where to store
3432934890 the #GMatchInfo, or %NULL if you do not need it</doc>
3433034891 <type name="MatchInfo" c:type="GMatchInfo**"/>
3433134892 </parameter>
@@ -34334,7 +34895,7 @@ freeing or modifying @string then the behaviour is undefined.</doc>
3433434895 <method name="match_all" c:identifier="g_regex_match_all" version="2.14">
3433534896 <doc xml:space="preserve"
3433634897 filename="glib/gregex.c"
34337- line="2303">Using the standard algorithm for regular expression matching only
34898+ line="2573">Using the standard algorithm for regular expression matching only
3433834899 the longest match in the string is retrieved. This function uses
3433934900 a different algorithm so it can retrieve all the possible matches.
3434034901 For more documentation see g_regex_match_all_full().
@@ -34352,26 +34913,26 @@ freeing or modifying @string then the behaviour is undefined.</doc>
3435234913 <return-value transfer-ownership="none">
3435334914 <doc xml:space="preserve"
3435434915 filename="glib/gregex.c"
34355- line="2326">%TRUE is the string matched, %FALSE otherwise</doc>
34916+ line="2596">%TRUE is the string matched, %FALSE otherwise</doc>
3435634917 <type name="gboolean" c:type="gboolean"/>
3435734918 </return-value>
3435834919 <parameters>
3435934920 <instance-parameter name="regex" transfer-ownership="none">
3436034921 <doc xml:space="preserve"
3436134922 filename="glib/gregex.c"
34362- line="2305">a #GRegex structure from g_regex_new()</doc>
34923+ line="2575">a #GRegex structure from g_regex_new()</doc>
3436334924 <type name="Regex" c:type="const GRegex*"/>
3436434925 </instance-parameter>
3436534926 <parameter name="string" transfer-ownership="none">
3436634927 <doc xml:space="preserve"
3436734928 filename="glib/gregex.c"
34368- line="2306">the string to scan for matches</doc>
34929+ line="2576">the string to scan for matches</doc>
3436934930 <type name="utf8" c:type="const gchar*"/>
3437034931 </parameter>
3437134932 <parameter name="match_options" transfer-ownership="none">
3437234933 <doc xml:space="preserve"
3437334934 filename="glib/gregex.c"
34374- line="2307">match options</doc>
34935+ line="2577">match options</doc>
3437534936 <type name="RegexMatchFlags" c:type="GRegexMatchFlags"/>
3437634937 </parameter>
3437734938 <parameter name="match_info"
@@ -34382,7 +34943,7 @@ freeing or modifying @string then the behaviour is undefined.</doc>
3438234943 allow-none="1">
3438334944 <doc xml:space="preserve"
3438434945 filename="glib/gregex.c"
34385- line="2308">pointer to location where to store
34946+ line="2578">pointer to location where to store
3438634947 the #GMatchInfo, or %NULL if you do not need it</doc>
3438734948 <type name="MatchInfo" c:type="GMatchInfo**"/>
3438834949 </parameter>
@@ -34394,7 +34955,7 @@ freeing or modifying @string then the behaviour is undefined.</doc>
3439434955 throws="1">
3439534956 <doc xml:space="preserve"
3439634957 filename="glib/gregex.c"
34397- line="2340">Using the standard algorithm for regular expression matching only
34958+ line="2610">Using the standard algorithm for regular expression matching only
3439834959 the longest match in the @string is retrieved, it is not possible
3439934960 to obtain all the available matches. For instance matching
3440034961 `"&lt;a&gt; &lt;b&gt; &lt;c&gt;"` against the pattern `"&lt;.*&gt;"`
@@ -34436,20 +34997,20 @@ freeing or modifying @string then the behaviour is undefined.</doc>
3443634997 <return-value transfer-ownership="none">
3443734998 <doc xml:space="preserve"
3443834999 filename="glib/gregex.c"
34439- line="2390">%TRUE is the string matched, %FALSE otherwise</doc>
35000+ line="2660">%TRUE is the string matched, %FALSE otherwise</doc>
3444035001 <type name="gboolean" c:type="gboolean"/>
3444135002 </return-value>
3444235003 <parameters>
3444335004 <instance-parameter name="regex" transfer-ownership="none">
3444435005 <doc xml:space="preserve"
3444535006 filename="glib/gregex.c"
34446- line="2342">a #GRegex structure from g_regex_new()</doc>
35007+ line="2612">a #GRegex structure from g_regex_new()</doc>
3444735008 <type name="Regex" c:type="const GRegex*"/>
3444835009 </instance-parameter>
3444935010 <parameter name="string" transfer-ownership="none">
3445035011 <doc xml:space="preserve"
3445135012 filename="glib/gregex.c"
34452- line="2343">the string to scan for matches</doc>
35013+ line="2613">the string to scan for matches</doc>
3445335014 <array length="1" zero-terminated="0" c:type="const gchar*">
3445435015 <type name="utf8" c:type="gchar"/>
3445535016 </array>
@@ -34457,19 +35018,19 @@ freeing or modifying @string then the behaviour is undefined.</doc>
3445735018 <parameter name="string_len" transfer-ownership="none">
3445835019 <doc xml:space="preserve"
3445935020 filename="glib/gregex.c"
34460- line="2344">the length of @string, in bytes, or -1 if @string is nul-terminated</doc>
35021+ line="2614">the length of @string, in bytes, or -1 if @string is nul-terminated</doc>
3446135022 <type name="gssize" c:type="gssize"/>
3446235023 </parameter>
3446335024 <parameter name="start_position" transfer-ownership="none">
3446435025 <doc xml:space="preserve"
3446535026 filename="glib/gregex.c"
34466- line="2345">starting index of the string to match, in bytes</doc>
35027+ line="2615">starting index of the string to match, in bytes</doc>
3446735028 <type name="gint" c:type="gint"/>
3446835029 </parameter>
3446935030 <parameter name="match_options" transfer-ownership="none">
3447035031 <doc xml:space="preserve"
3447135032 filename="glib/gregex.c"
34472- line="2346">match options</doc>
35033+ line="2616">match options</doc>
3447335034 <type name="RegexMatchFlags" c:type="GRegexMatchFlags"/>
3447435035 </parameter>
3447535036 <parameter name="match_info"
@@ -34480,7 +35041,7 @@ freeing or modifying @string then the behaviour is undefined.</doc>
3448035041 allow-none="1">
3448135042 <doc xml:space="preserve"
3448235043 filename="glib/gregex.c"
34483- line="2347">pointer to location where to store
35044+ line="2617">pointer to location where to store
3448435045 the #GMatchInfo, or %NULL if you do not need it</doc>
3448535046 <type name="MatchInfo" c:type="GMatchInfo**"/>
3448635047 </parameter>
@@ -34492,7 +35053,7 @@ freeing or modifying @string then the behaviour is undefined.</doc>
3449235053 throws="1">
3449335054 <doc xml:space="preserve"
3449435055 filename="glib/gregex.c"
34495- line="2207">Scans for a match in @string for the pattern in @regex.
35056+ line="2477">Scans for a match in @string for the pattern in @regex.
3449635057 The @match_options are combined with the match options specified
3449735058 when the @regex structure was created, letting you have more
3449835059 flexibility in reusing #GRegex structures.
@@ -34547,20 +35108,20 @@ print_uppercase_words (const gchar *string)
3454735108 <return-value transfer-ownership="none">
3454835109 <doc xml:space="preserve"
3454935110 filename="glib/gregex.c"
34550- line="2270">%TRUE is the string matched, %FALSE otherwise</doc>
35111+ line="2540">%TRUE is the string matched, %FALSE otherwise</doc>
3455135112 <type name="gboolean" c:type="gboolean"/>
3455235113 </return-value>
3455335114 <parameters>
3455435115 <instance-parameter name="regex" transfer-ownership="none">
3455535116 <doc xml:space="preserve"
3455635117 filename="glib/gregex.c"
34557- line="2209">a #GRegex structure from g_regex_new()</doc>
35118+ line="2479">a #GRegex structure from g_regex_new()</doc>
3455835119 <type name="Regex" c:type="const GRegex*"/>
3455935120 </instance-parameter>
3456035121 <parameter name="string" transfer-ownership="none">
3456135122 <doc xml:space="preserve"
3456235123 filename="glib/gregex.c"
34563- line="2210">the string to scan for matches</doc>
35124+ line="2480">the string to scan for matches</doc>
3456435125 <array length="1" zero-terminated="0" c:type="const gchar*">
3456535126 <type name="utf8" c:type="gchar"/>
3456635127 </array>
@@ -34568,19 +35129,19 @@ print_uppercase_words (const gchar *string)
3456835129 <parameter name="string_len" transfer-ownership="none">
3456935130 <doc xml:space="preserve"
3457035131 filename="glib/gregex.c"
34571- line="2211">the length of @string, in bytes, or -1 if @string is nul-terminated</doc>
35132+ line="2481">the length of @string, in bytes, or -1 if @string is nul-terminated</doc>
3457235133 <type name="gssize" c:type="gssize"/>
3457335134 </parameter>
3457435135 <parameter name="start_position" transfer-ownership="none">
3457535136 <doc xml:space="preserve"
3457635137 filename="glib/gregex.c"
34577- line="2212">starting index of the string to match, in bytes</doc>
35138+ line="2482">starting index of the string to match, in bytes</doc>
3457835139 <type name="gint" c:type="gint"/>
3457935140 </parameter>
3458035141 <parameter name="match_options" transfer-ownership="none">
3458135142 <doc xml:space="preserve"
3458235143 filename="glib/gregex.c"
34583- line="2213">match options</doc>
35144+ line="2483">match options</doc>
3458435145 <type name="RegexMatchFlags" c:type="GRegexMatchFlags"/>
3458535146 </parameter>
3458635147 <parameter name="match_info"
@@ -34591,7 +35152,7 @@ print_uppercase_words (const gchar *string)
3459135152 allow-none="1">
3459235153 <doc xml:space="preserve"
3459335154 filename="glib/gregex.c"
34594- line="2214">pointer to location where to store
35155+ line="2484">pointer to location where to store
3459535156 the #GMatchInfo, or %NULL if you do not need it</doc>
3459635157 <type name="MatchInfo" c:type="GMatchInfo**"/>
3459735158 </parameter>
@@ -34600,19 +35161,19 @@ print_uppercase_words (const gchar *string)
3460035161 <method name="ref" c:identifier="g_regex_ref" version="2.14">
3460135162 <doc xml:space="preserve"
3460235163 filename="glib/gregex.c"
34603- line="1660">Increases reference count of @regex by 1.</doc>
35164+ line="1930">Increases reference count of @regex by 1.</doc>
3460435165 <source-position filename="glib/gregex.h" line="455"/>
3460535166 <return-value transfer-ownership="full">
3460635167 <doc xml:space="preserve"
3460735168 filename="glib/gregex.c"
34608- line="1666">@regex</doc>
35169+ line="1936">@regex</doc>
3460935170 <type name="Regex" c:type="GRegex*"/>
3461035171 </return-value>
3461135172 <parameters>
3461235173 <instance-parameter name="regex" transfer-ownership="none">
3461335174 <doc xml:space="preserve"
3461435175 filename="glib/gregex.c"
34615- line="1662">a #GRegex</doc>
35176+ line="1932">a #GRegex</doc>
3461635177 <type name="Regex" c:type="GRegex*"/>
3461735178 </instance-parameter>
3461835179 </parameters>
@@ -34623,7 +35184,7 @@ print_uppercase_words (const gchar *string)
3462335184 throws="1">
3462435185 <doc xml:space="preserve"
3462535186 filename="glib/gregex.c"
34626- line="3257">Replaces all occurrences of the pattern in @regex with the
35187+ line="3527">Replaces all occurrences of the pattern in @regex with the
3462735188 replacement text. Backreferences of the form `\number` or
3462835189 `\g&lt;number&gt;` in the replacement text are interpolated by the
3462935190 number-th captured subexpression of the match, `\g&lt;name&gt;` refers
@@ -34653,20 +35214,20 @@ begins with any kind of lookbehind assertion, such as "\b".</doc>
3465335214 <return-value transfer-ownership="full">
3465435215 <doc xml:space="preserve"
3465535216 filename="glib/gregex.c"
34656- line="3294">a newly allocated string containing the replacements</doc>
35217+ line="3564">a newly allocated string containing the replacements</doc>
3465735218 <type name="utf8" c:type="gchar*"/>
3465835219 </return-value>
3465935220 <parameters>
3466035221 <instance-parameter name="regex" transfer-ownership="none">
3466135222 <doc xml:space="preserve"
3466235223 filename="glib/gregex.c"
34663- line="3259">a #GRegex structure</doc>
35224+ line="3529">a #GRegex structure</doc>
3466435225 <type name="Regex" c:type="const GRegex*"/>
3466535226 </instance-parameter>
3466635227 <parameter name="string" transfer-ownership="none">
3466735228 <doc xml:space="preserve"
3466835229 filename="glib/gregex.c"
34669- line="3260">the string to perform matches against</doc>
35230+ line="3530">the string to perform matches against</doc>
3467035231 <array length="1" zero-terminated="0" c:type="const gchar*">
3467135232 <type name="utf8" c:type="gchar"/>
3467235233 </array>
@@ -34674,25 +35235,25 @@ begins with any kind of lookbehind assertion, such as "\b".</doc>
3467435235 <parameter name="string_len" transfer-ownership="none">
3467535236 <doc xml:space="preserve"
3467635237 filename="glib/gregex.c"
34677- line="3261">the length of @string, in bytes, or -1 if @string is nul-terminated</doc>
35238+ line="3531">the length of @string, in bytes, or -1 if @string is nul-terminated</doc>
3467835239 <type name="gssize" c:type="gssize"/>
3467935240 </parameter>
3468035241 <parameter name="start_position" transfer-ownership="none">
3468135242 <doc xml:space="preserve"
3468235243 filename="glib/gregex.c"
34683- line="3262">starting index of the string to match, in bytes</doc>
35244+ line="3532">starting index of the string to match, in bytes</doc>
3468435245 <type name="gint" c:type="gint"/>
3468535246 </parameter>
3468635247 <parameter name="replacement" transfer-ownership="none">
3468735248 <doc xml:space="preserve"
3468835249 filename="glib/gregex.c"
34689- line="3263">text to replace each match with</doc>
35250+ line="3533">text to replace each match with</doc>
3469035251 <type name="utf8" c:type="const gchar*"/>
3469135252 </parameter>
3469235253 <parameter name="match_options" transfer-ownership="none">
3469335254 <doc xml:space="preserve"
3469435255 filename="glib/gregex.c"
34695- line="3264">options for the match</doc>
35256+ line="3534">options for the match</doc>
3469635257 <type name="RegexMatchFlags" c:type="GRegexMatchFlags"/>
3469735258 </parameter>
3469835259 </parameters>
@@ -34703,7 +35264,7 @@ begins with any kind of lookbehind assertion, such as "\b".</doc>
3470335264 throws="1">
3470435265 <doc xml:space="preserve"
3470535266 filename="glib/gregex.c"
34706- line="3391">Replaces occurrences of the pattern in regex with the output of
35267+ line="3661">Replaces occurrences of the pattern in regex with the output of
3470735268 @eval for that occurrence.
3470835269
3470935270 Setting @start_position differs from just passing over a shortened
@@ -34752,20 +35313,20 @@ g_hash_table_destroy (h);
3475235313 <return-value transfer-ownership="full">
3475335314 <doc xml:space="preserve"
3475435315 filename="glib/gregex.c"
34755- line="3448">a newly allocated string containing the replacements</doc>
35316+ line="3718">a newly allocated string containing the replacements</doc>
3475635317 <type name="utf8" c:type="gchar*"/>
3475735318 </return-value>
3475835319 <parameters>
3475935320 <instance-parameter name="regex" transfer-ownership="none">
3476035321 <doc xml:space="preserve"
3476135322 filename="glib/gregex.c"
34762- line="3393">a #GRegex structure from g_regex_new()</doc>
35323+ line="3663">a #GRegex structure from g_regex_new()</doc>
3476335324 <type name="Regex" c:type="const GRegex*"/>
3476435325 </instance-parameter>
3476535326 <parameter name="string" transfer-ownership="none">
3476635327 <doc xml:space="preserve"
3476735328 filename="glib/gregex.c"
34768- line="3394">string to perform matches against</doc>
35329+ line="3664">string to perform matches against</doc>
3476935330 <array length="1" zero-terminated="0" c:type="const gchar*">
3477035331 <type name="utf8" c:type="gchar"/>
3477135332 </array>
@@ -34773,19 +35334,19 @@ g_hash_table_destroy (h);
3477335334 <parameter name="string_len" transfer-ownership="none">
3477435335 <doc xml:space="preserve"
3477535336 filename="glib/gregex.c"
34776- line="3395">the length of @string, in bytes, or -1 if @string is nul-terminated</doc>
35337+ line="3665">the length of @string, in bytes, or -1 if @string is nul-terminated</doc>
3477735338 <type name="gssize" c:type="gssize"/>
3477835339 </parameter>
3477935340 <parameter name="start_position" transfer-ownership="none">
3478035341 <doc xml:space="preserve"
3478135342 filename="glib/gregex.c"
34782- line="3396">starting index of the string to match, in bytes</doc>
35343+ line="3666">starting index of the string to match, in bytes</doc>
3478335344 <type name="gint" c:type="gint"/>
3478435345 </parameter>
3478535346 <parameter name="match_options" transfer-ownership="none">
3478635347 <doc xml:space="preserve"
3478735348 filename="glib/gregex.c"
34788- line="3397">options for the match</doc>
35349+ line="3667">options for the match</doc>
3478935350 <type name="RegexMatchFlags" c:type="GRegexMatchFlags"/>
3479035351 </parameter>
3479135352 <parameter name="eval"
@@ -34794,7 +35355,7 @@ g_hash_table_destroy (h);
3479435355 closure="5">
3479535356 <doc xml:space="preserve"
3479635357 filename="glib/gregex.c"
34797- line="3398">a function to call for each match</doc>
35358+ line="3668">a function to call for each match</doc>
3479835359 <type name="RegexEvalCallback" c:type="GRegexEvalCallback"/>
3479935360 </parameter>
3480035361 <parameter name="user_data"
@@ -34803,7 +35364,7 @@ g_hash_table_destroy (h);
3480335364 allow-none="1">
3480435365 <doc xml:space="preserve"
3480535366 filename="glib/gregex.c"
34806- line="3399">user data to pass to the function</doc>
35367+ line="3669">user data to pass to the function</doc>
3480735368 <type name="gpointer" c:type="gpointer"/>
3480835369 </parameter>
3480935370 </parameters>
@@ -34814,7 +35375,7 @@ g_hash_table_destroy (h);
3481435375 throws="1">
3481535376 <doc xml:space="preserve"
3481635377 filename="glib/gregex.c"
34817- line="3348">Replaces all occurrences of the pattern in @regex with the
35378+ line="3618">Replaces all occurrences of the pattern in @regex with the
3481835379 replacement text. @replacement is replaced literally, to
3481935380 include backreferences use g_regex_replace().
3482035381
@@ -34826,20 +35387,20 @@ assertion, such as "\b".</doc>
3482635387 <return-value transfer-ownership="full">
3482735388 <doc xml:space="preserve"
3482835389 filename="glib/gregex.c"
34829- line="3367">a newly allocated string containing the replacements</doc>
35390+ line="3637">a newly allocated string containing the replacements</doc>
3483035391 <type name="utf8" c:type="gchar*"/>
3483135392 </return-value>
3483235393 <parameters>
3483335394 <instance-parameter name="regex" transfer-ownership="none">
3483435395 <doc xml:space="preserve"
3483535396 filename="glib/gregex.c"
34836- line="3350">a #GRegex structure</doc>
35397+ line="3620">a #GRegex structure</doc>
3483735398 <type name="Regex" c:type="const GRegex*"/>
3483835399 </instance-parameter>
3483935400 <parameter name="string" transfer-ownership="none">
3484035401 <doc xml:space="preserve"
3484135402 filename="glib/gregex.c"
34842- line="3351">the string to perform matches against</doc>
35403+ line="3621">the string to perform matches against</doc>
3484335404 <array length="1" zero-terminated="0" c:type="const gchar*">
3484435405 <type name="utf8" c:type="gchar"/>
3484535406 </array>
@@ -34847,25 +35408,25 @@ assertion, such as "\b".</doc>
3484735408 <parameter name="string_len" transfer-ownership="none">
3484835409 <doc xml:space="preserve"
3484935410 filename="glib/gregex.c"
34850- line="3352">the length of @string, in bytes, or -1 if @string is nul-terminated</doc>
35411+ line="3622">the length of @string, in bytes, or -1 if @string is nul-terminated</doc>
3485135412 <type name="gssize" c:type="gssize"/>
3485235413 </parameter>
3485335414 <parameter name="start_position" transfer-ownership="none">
3485435415 <doc xml:space="preserve"
3485535416 filename="glib/gregex.c"
34856- line="3353">starting index of the string to match, in bytes</doc>
35417+ line="3623">starting index of the string to match, in bytes</doc>
3485735418 <type name="gint" c:type="gint"/>
3485835419 </parameter>
3485935420 <parameter name="replacement" transfer-ownership="none">
3486035421 <doc xml:space="preserve"
3486135422 filename="glib/gregex.c"
34862- line="3354">text to replace each match with</doc>
35423+ line="3624">text to replace each match with</doc>
3486335424 <type name="utf8" c:type="const gchar*"/>
3486435425 </parameter>
3486535426 <parameter name="match_options" transfer-ownership="none">
3486635427 <doc xml:space="preserve"
3486735428 filename="glib/gregex.c"
34868- line="3355">options for the match</doc>
35429+ line="3625">options for the match</doc>
3486935430 <type name="RegexMatchFlags" c:type="GRegexMatchFlags"/>
3487035431 </parameter>
3487135432 </parameters>
@@ -34873,7 +35434,7 @@ assertion, such as "\b".</doc>
3487335434 <method name="split" c:identifier="g_regex_split" version="2.14">
3487435435 <doc xml:space="preserve"
3487535436 filename="glib/gregex.c"
34876- line="2589">Breaks the string on the pattern, and returns an array of the tokens.
35437+ line="2859">Breaks the string on the pattern, and returns an array of the tokens.
3487735438 If the pattern contains capturing parentheses, then the text for each
3487835439 of the substrings will also be returned. If the pattern does not match
3487935440 anywhere in the string, then the whole string is returned as the first
@@ -34894,7 +35455,7 @@ For example splitting "ab c" using as a separator "\s*", you will get
3489435455 <return-value transfer-ownership="full">
3489535456 <doc xml:space="preserve"
3489635457 filename="glib/gregex.c"
34897- line="2613">a %NULL-terminated gchar ** array. Free
35458+ line="2883">a %NULL-terminated gchar ** array. Free
3489835459 it using g_strfreev()</doc>
3489935460 <array c:type="gchar**">
3490035461 <type name="utf8"/>
@@ -34904,19 +35465,19 @@ it using g_strfreev()</doc>
3490435465 <instance-parameter name="regex" transfer-ownership="none">
3490535466 <doc xml:space="preserve"
3490635467 filename="glib/gregex.c"
34907- line="2591">a #GRegex structure</doc>
35468+ line="2861">a #GRegex structure</doc>
3490835469 <type name="Regex" c:type="const GRegex*"/>
3490935470 </instance-parameter>
3491035471 <parameter name="string" transfer-ownership="none">
3491135472 <doc xml:space="preserve"
3491235473 filename="glib/gregex.c"
34913- line="2592">the string to split with the pattern</doc>
35474+ line="2862">the string to split with the pattern</doc>
3491435475 <type name="utf8" c:type="const gchar*"/>
3491535476 </parameter>
3491635477 <parameter name="match_options" transfer-ownership="none">
3491735478 <doc xml:space="preserve"
3491835479 filename="glib/gregex.c"
34919- line="2593">match time option flags</doc>
35480+ line="2863">match time option flags</doc>
3492035481 <type name="RegexMatchFlags" c:type="GRegexMatchFlags"/>
3492135482 </parameter>
3492235483 </parameters>
@@ -34927,7 +35488,7 @@ it using g_strfreev()</doc>
3492735488 throws="1">
3492835489 <doc xml:space="preserve"
3492935490 filename="glib/gregex.c"
34930- line="2627">Breaks the string on the pattern, and returns an array of the tokens.
35491+ line="2897">Breaks the string on the pattern, and returns an array of the tokens.
3493135492 If the pattern contains capturing parentheses, then the text for each
3493235493 of the substrings will also be returned. If the pattern does not match
3493335494 anywhere in the string, then the whole string is returned as the first
@@ -34952,7 +35513,7 @@ that begins with any kind of lookbehind assertion, such as "\b".</doc>
3495235513 <return-value transfer-ownership="full">
3495335514 <doc xml:space="preserve"
3495435515 filename="glib/gregex.c"
34955- line="2660">a %NULL-terminated gchar ** array. Free
35516+ line="2930">a %NULL-terminated gchar ** array. Free
3495635517 it using g_strfreev()</doc>
3495735518 <array c:type="gchar**">
3495835519 <type name="utf8"/>
@@ -34962,13 +35523,13 @@ it using g_strfreev()</doc>
3496235523 <instance-parameter name="regex" transfer-ownership="none">
3496335524 <doc xml:space="preserve"
3496435525 filename="glib/gregex.c"
34965- line="2629">a #GRegex structure</doc>
35526+ line="2899">a #GRegex structure</doc>
3496635527 <type name="Regex" c:type="const GRegex*"/>
3496735528 </instance-parameter>
3496835529 <parameter name="string" transfer-ownership="none">
3496935530 <doc xml:space="preserve"
3497035531 filename="glib/gregex.c"
34971- line="2630">the string to split with the pattern</doc>
35532+ line="2900">the string to split with the pattern</doc>
3497235533 <array length="1" zero-terminated="0" c:type="const gchar*">
3497335534 <type name="utf8" c:type="gchar"/>
3497435535 </array>
@@ -34976,25 +35537,25 @@ it using g_strfreev()</doc>
3497635537 <parameter name="string_len" transfer-ownership="none">
3497735538 <doc xml:space="preserve"
3497835539 filename="glib/gregex.c"
34979- line="2631">the length of @string, in bytes, or -1 if @string is nul-terminated</doc>
35540+ line="2901">the length of @string, in bytes, or -1 if @string is nul-terminated</doc>
3498035541 <type name="gssize" c:type="gssize"/>
3498135542 </parameter>
3498235543 <parameter name="start_position" transfer-ownership="none">
3498335544 <doc xml:space="preserve"
3498435545 filename="glib/gregex.c"
34985- line="2632">starting index of the string to match, in bytes</doc>
35546+ line="2902">starting index of the string to match, in bytes</doc>
3498635547 <type name="gint" c:type="gint"/>
3498735548 </parameter>
3498835549 <parameter name="match_options" transfer-ownership="none">
3498935550 <doc xml:space="preserve"
3499035551 filename="glib/gregex.c"
34991- line="2633">match time option flags</doc>
35552+ line="2903">match time option flags</doc>
3499235553 <type name="RegexMatchFlags" c:type="GRegexMatchFlags"/>
3499335554 </parameter>
3499435555 <parameter name="max_tokens" transfer-ownership="none">
3499535556 <doc xml:space="preserve"
3499635557 filename="glib/gregex.c"
34997- line="2634">the maximum number of tokens to split @string into.
35558+ line="2904">the maximum number of tokens to split @string into.
3499835559 If this is less than 1, the string is split completely</doc>
3499935560 <type name="gint" c:type="gint"/>
3500035561 </parameter>
@@ -35003,7 +35564,7 @@ it using g_strfreev()</doc>
3500335564 <method name="unref" c:identifier="g_regex_unref" version="2.14">
3500435565 <doc xml:space="preserve"
3500535566 filename="glib/gregex.c"
35006- line="1678">Decreases reference count of @regex by 1. When reference count drops
35567+ line="1948">Decreases reference count of @regex by 1. When reference count drops
3500735568 to zero, it frees all the memory associated with the regex structure.</doc>
3500835569 <source-position filename="glib/gregex.h" line="457"/>
3500935570 <return-value transfer-ownership="none">
@@ -35013,7 +35574,7 @@ to zero, it frees all the memory associated with the regex structure.</doc>
3501335574 <instance-parameter name="regex" transfer-ownership="none">
3501435575 <doc xml:space="preserve"
3501535576 filename="glib/gregex.c"
35016- line="1680">a #GRegex</doc>
35577+ line="1950">a #GRegex</doc>
3501735578 <type name="Regex" c:type="GRegex*"/>
3501835579 </instance-parameter>
3501935580 </parameters>
@@ -35024,7 +35585,7 @@ to zero, it frees all the memory associated with the regex structure.</doc>
3502435585 throws="1">
3502535586 <doc xml:space="preserve"
3502635587 filename="glib/gregex.c"
35027- line="3503">Checks whether @replacement is a valid replacement string
35588+ line="3773">Checks whether @replacement is a valid replacement string
3502835589 (see g_regex_replace()), i.e. that all escape sequences in
3502935590 it are valid.
3503035591
@@ -35037,14 +35598,14 @@ subpattern) requires valid #GMatchInfo object.</doc>
3503735598 <return-value transfer-ownership="none">
3503835599 <doc xml:space="preserve"
3503935600 filename="glib/gregex.c"
35040- line="3520">whether @replacement is a valid replacement string</doc>
35601+ line="3790">whether @replacement is a valid replacement string</doc>
3504135602 <type name="gboolean" c:type="gboolean"/>
3504235603 </return-value>
3504335604 <parameters>
3504435605 <parameter name="replacement" transfer-ownership="none">
3504535606 <doc xml:space="preserve"
3504635607 filename="glib/gregex.c"
35047- line="3505">the replacement string</doc>
35608+ line="3775">the replacement string</doc>
3504835609 <type name="utf8" c:type="const gchar*"/>
3504935610 </parameter>
3505035611 <parameter name="has_references"
@@ -35055,7 +35616,7 @@ subpattern) requires valid #GMatchInfo object.</doc>
3505535616 allow-none="1">
3505635617 <doc xml:space="preserve"
3505735618 filename="glib/gregex.c"
35058- line="3506">location to store information about
35619+ line="3776">location to store information about
3505935620 references in @replacement or %NULL</doc>
3506035621 <type name="gboolean" c:type="gboolean*"/>
3506135622 </parameter>
@@ -35071,7 +35632,7 @@ subpattern) requires valid #GMatchInfo object.</doc>
3507135632 version="2.30">
3507235633 <doc xml:space="preserve"
3507335634 filename="glib/gregex.c"
35074- line="3548">Escapes the nul characters in @string to "\x00". It can be used
35635+ line="3818">Escapes the nul characters in @string to "\x00". It can be used
3507535636 to compile a regex with embedded nul characters.
3507635637
3507735638 For completeness, @length can be -1 for a nul-terminated string.
@@ -35080,20 +35641,20 @@ In this case the output string will be of course equal to @string.</doc>
3508035641 <return-value transfer-ownership="full">
3508135642 <doc xml:space="preserve"
3508235643 filename="glib/gregex.c"
35083- line="3559">a newly-allocated escaped string</doc>
35644+ line="3829">a newly-allocated escaped string</doc>
3508435645 <type name="utf8" c:type="gchar*"/>
3508535646 </return-value>
3508635647 <parameters>
3508735648 <parameter name="string" transfer-ownership="none">
3508835649 <doc xml:space="preserve"
3508935650 filename="glib/gregex.c"
35090- line="3550">the string to escape</doc>
35651+ line="3820">the string to escape</doc>
3509135652 <type name="utf8" c:type="const gchar*"/>
3509235653 </parameter>
3509335654 <parameter name="length" transfer-ownership="none">
3509435655 <doc xml:space="preserve"
3509535656 filename="glib/gregex.c"
35096- line="3551">the length of @string</doc>
35657+ line="3821">the length of @string</doc>
3509735658 <type name="gint" c:type="gint"/>
3509835659 </parameter>
3509935660 </parameters>
@@ -35103,7 +35664,7 @@ In this case the output string will be of course equal to @string.</doc>
3510335664 version="2.14">
3510435665 <doc xml:space="preserve"
3510535666 filename="glib/gregex.c"
35106- line="3616">Escapes the special characters used for regular expressions
35667+ line="3886">Escapes the special characters used for regular expressions
3510735668 in @string, for instance "a.b*c" becomes "a\.b\*c". This
3510835669 function is useful to dynamically generate regular expressions.
3510935670
@@ -35114,20 +35675,20 @@ in @length.</doc>
3511435675 <return-value transfer-ownership="full">
3511535676 <doc xml:space="preserve"
3511635677 filename="glib/gregex.c"
35117- line="3629">a newly-allocated escaped string</doc>
35678+ line="3899">a newly-allocated escaped string</doc>
3511835679 <type name="utf8" c:type="gchar*"/>
3511935680 </return-value>
3512035681 <parameters>
3512135682 <parameter name="string" transfer-ownership="none">
3512235683 <doc xml:space="preserve"
3512335684 filename="glib/gregex.c"
35124- line="3618">the string to escape</doc>
35685+ line="3888">the string to escape</doc>
3512535686 <type name="utf8" c:type="const gchar*"/>
3512635687 </parameter>
3512735688 <parameter name="length" transfer-ownership="none">
3512835689 <doc xml:space="preserve"
3512935690 filename="glib/gregex.c"
35130- line="3619">the length of @string, in bytes, or -1 if @string is nul-terminated</doc>
35691+ line="3889">the length of @string, in bytes, or -1 if @string is nul-terminated</doc>
3513135692 <type name="gint" c:type="gint"/>
3513235693 </parameter>
3513335694 </parameters>
@@ -35137,7 +35698,7 @@ in @length.</doc>
3513735698 version="2.14">
3513835699 <doc xml:space="preserve"
3513935700 filename="glib/gregex.c"
35140- line="2105">Scans for a match in @string for @pattern.
35701+ line="2375">Scans for a match in @string for @pattern.
3514135702
3514235703 This function is equivalent to g_regex_match() but it does not
3514335704 require to compile the pattern with g_regex_new(), avoiding some
@@ -35151,32 +35712,32 @@ g_regex_new() and then use g_regex_match().</doc>
3515135712 <return-value transfer-ownership="none">
3515235713 <doc xml:space="preserve"
3515335714 filename="glib/gregex.c"
35154- line="2123">%TRUE if the string matched, %FALSE otherwise</doc>
35715+ line="2393">%TRUE if the string matched, %FALSE otherwise</doc>
3515535716 <type name="gboolean" c:type="gboolean"/>
3515635717 </return-value>
3515735718 <parameters>
3515835719 <parameter name="pattern" transfer-ownership="none">
3515935720 <doc xml:space="preserve"
3516035721 filename="glib/gregex.c"
35161- line="2107">the regular expression</doc>
35722+ line="2377">the regular expression</doc>
3516235723 <type name="utf8" c:type="const gchar*"/>
3516335724 </parameter>
3516435725 <parameter name="string" transfer-ownership="none">
3516535726 <doc xml:space="preserve"
3516635727 filename="glib/gregex.c"
35167- line="2108">the string to scan for matches</doc>
35728+ line="2378">the string to scan for matches</doc>
3516835729 <type name="utf8" c:type="const gchar*"/>
3516935730 </parameter>
3517035731 <parameter name="compile_options" transfer-ownership="none">
3517135732 <doc xml:space="preserve"
3517235733 filename="glib/gregex.c"
35173- line="2109">compile options for the regular expression, or 0</doc>
35734+ line="2379">compile options for the regular expression, or 0</doc>
3517435735 <type name="RegexCompileFlags" c:type="GRegexCompileFlags"/>
3517535736 </parameter>
3517635737 <parameter name="match_options" transfer-ownership="none">
3517735738 <doc xml:space="preserve"
3517835739 filename="glib/gregex.c"
35179- line="2110">match options, or 0</doc>
35740+ line="2380">match options, or 0</doc>
3518035741 <type name="RegexMatchFlags" c:type="GRegexMatchFlags"/>
3518135742 </parameter>
3518235743 </parameters>
@@ -35186,7 +35747,7 @@ g_regex_new() and then use g_regex_match().</doc>
3518635747 version="2.14">
3518735748 <doc xml:space="preserve"
3518835749 filename="glib/gregex.c"
35189- line="2531">Breaks the string on the pattern, and returns an array of
35750+ line="2801">Breaks the string on the pattern, and returns an array of
3519035751 the tokens. If the pattern contains capturing parentheses,
3519135752 then the text for each of the substrings will also be returned.
3519235753 If the pattern does not match anywhere in the string, then the
@@ -35217,7 +35778,7 @@ characters. For example splitting "ab c" using as a separator
3521735778 <return-value transfer-ownership="full">
3521835779 <doc xml:space="preserve"
3521935780 filename="glib/gregex.c"
35220- line="2566">a %NULL-terminated array of strings. Free
35781+ line="2836">a %NULL-terminated array of strings. Free
3522135782 it using g_strfreev()</doc>
3522235783 <array c:type="gchar**">
3522335784 <type name="utf8"/>
@@ -35227,25 +35788,25 @@ it using g_strfreev()</doc>
3522735788 <parameter name="pattern" transfer-ownership="none">
3522835789 <doc xml:space="preserve"
3522935790 filename="glib/gregex.c"
35230- line="2533">the regular expression</doc>
35791+ line="2803">the regular expression</doc>
3523135792 <type name="utf8" c:type="const gchar*"/>
3523235793 </parameter>
3523335794 <parameter name="string" transfer-ownership="none">
3523435795 <doc xml:space="preserve"
3523535796 filename="glib/gregex.c"
35236- line="2534">the string to scan for matches</doc>
35797+ line="2804">the string to scan for matches</doc>
3523735798 <type name="utf8" c:type="const gchar*"/>
3523835799 </parameter>
3523935800 <parameter name="compile_options" transfer-ownership="none">
3524035801 <doc xml:space="preserve"
3524135802 filename="glib/gregex.c"
35242- line="2535">compile options for the regular expression, or 0</doc>
35803+ line="2805">compile options for the regular expression, or 0</doc>
3524335804 <type name="RegexCompileFlags" c:type="GRegexCompileFlags"/>
3524435805 </parameter>
3524535806 <parameter name="match_options" transfer-ownership="none">
3524635807 <doc xml:space="preserve"
3524735808 filename="glib/gregex.c"
35248- line="2536">match options, or 0</doc>
35809+ line="2806">match options, or 0</doc>
3524935810 <type name="RegexMatchFlags" c:type="GRegexMatchFlags"/>
3525035811 </parameter>
3525135812 </parameters>
@@ -36119,21 +36680,21 @@ used.</doc>
3611936680 deprecated-version="2.26">
3612036681 <doc xml:space="preserve"
3612136682 filename="glib/deprecated/grel.c"
36122- line="485">Returns the number of tuples in a #GRelation that have the given
36683+ line="519">Returns the number of tuples in a #GRelation that have the given
3612336684 value in the given field.</doc>
3612436685 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
3612536686 <source-position filename="glib/deprecated/grel.h" line="67"/>
3612636687 <return-value transfer-ownership="none">
3612736688 <doc xml:space="preserve"
3612836689 filename="glib/deprecated/grel.c"
36129- line="494">the number of matches.</doc>
36690+ line="528">the number of matches.</doc>
3613036691 <type name="gint" c:type="gint"/>
3613136692 </return-value>
3613236693 <parameters>
3613336694 <instance-parameter name="relation" transfer-ownership="none">
3613436695 <doc xml:space="preserve"
3613536696 filename="glib/deprecated/grel.c"
36136- line="487">a #GRelation.</doc>
36697+ line="521">a #GRelation.</doc>
3613736698 <type name="Relation" c:type="GRelation*"/>
3613836699 </instance-parameter>
3613936700 <parameter name="key"
@@ -36142,13 +36703,13 @@ value in the given field.</doc>
3614236703 allow-none="1">
3614336704 <doc xml:space="preserve"
3614436705 filename="glib/deprecated/grel.c"
36145- line="488">the value to compare with.</doc>
36706+ line="522">the value to compare with.</doc>
3614636707 <type name="gpointer" c:type="gconstpointer"/>
3614736708 </parameter>
3614836709 <parameter name="field" transfer-ownership="none">
3614936710 <doc xml:space="preserve"
3615036711 filename="glib/deprecated/grel.c"
36151- line="489">the field of each record to match.</doc>
36712+ line="523">the field of each record to match.</doc>
3615236713 <type name="gint" c:type="gint"/>
3615336714 </parameter>
3615436715 </parameters>
@@ -36159,21 +36720,21 @@ value in the given field.</doc>
3615936720 deprecated-version="2.26">
3616036721 <doc xml:space="preserve"
3616136722 filename="glib/deprecated/grel.c"
36162- line="372">Deletes any records from a #GRelation that have the given key value
36723+ line="377">Deletes any records from a #GRelation that have the given key value
3616336724 in the given field.</doc>
3616436725 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
3616536726 <source-position filename="glib/deprecated/grel.h" line="59"/>
3616636727 <return-value transfer-ownership="none">
3616736728 <doc xml:space="preserve"
3616836729 filename="glib/deprecated/grel.c"
36169- line="381">the number of records deleted.</doc>
36730+ line="386">the number of records deleted.</doc>
3617036731 <type name="gint" c:type="gint"/>
3617136732 </return-value>
3617236733 <parameters>
3617336734 <instance-parameter name="relation" transfer-ownership="none">
3617436735 <doc xml:space="preserve"
3617536736 filename="glib/deprecated/grel.c"
36176- line="374">a #GRelation.</doc>
36737+ line="379">a #GRelation.</doc>
3617736738 <type name="Relation" c:type="GRelation*"/>
3617836739 </instance-parameter>
3617936740 <parameter name="key"
@@ -36182,13 +36743,13 @@ in the given field.</doc>
3618236743 allow-none="1">
3618336744 <doc xml:space="preserve"
3618436745 filename="glib/deprecated/grel.c"
36185- line="375">the value to compare with.</doc>
36746+ line="380">the value to compare with.</doc>
3618636747 <type name="gpointer" c:type="gconstpointer"/>
3618736748 </parameter>
3618836749 <parameter name="field" transfer-ownership="none">
3618936750 <doc xml:space="preserve"
3619036751 filename="glib/deprecated/grel.c"
36191- line="376">the field of each record to match.</doc>
36752+ line="381">the field of each record to match.</doc>
3619236753 <type name="gint" c:type="gint"/>
3619336754 </parameter>
3619436755 </parameters>
@@ -36199,7 +36760,7 @@ in the given field.</doc>
3619936760 deprecated-version="2.26">
3620036761 <doc xml:space="preserve"
3620136762 filename="glib/deprecated/grel.c"
36202- line="222">Destroys the #GRelation, freeing all memory allocated. However, it
36763+ line="231">Destroys the #GRelation, freeing all memory allocated. However, it
3620336764 does not free memory allocated for the tuple data, so you should
3620436765 free that first if appropriate.</doc>
3620536766 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
@@ -36211,7 +36772,7 @@ free that first if appropriate.</doc>
3621136772 <instance-parameter name="relation" transfer-ownership="none">
3621236773 <doc xml:space="preserve"
3621336774 filename="glib/deprecated/grel.c"
36214- line="224">a #GRelation.</doc>
36775+ line="233">a #GRelation.</doc>
3621536776 <type name="Relation" c:type="GRelation*"/>
3621636777 </instance-parameter>
3621736778 </parameters>
@@ -36223,7 +36784,7 @@ free that first if appropriate.</doc>
3622336784 deprecated-version="2.26">
3622436785 <doc xml:space="preserve"
3622536786 filename="glib/deprecated/grel.c"
36226- line="520">Returns %TRUE if a record with the given values exists in a
36787+ line="547">Returns %TRUE if a record with the given values exists in a
3622736788 #GRelation. Note that the values are compared directly, so that, for
3622836789 example, two copies of the same string will not match.</doc>
3622936790 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
@@ -36231,20 +36792,20 @@ example, two copies of the same string will not match.</doc>
3623136792 <return-value transfer-ownership="none">
3623236793 <doc xml:space="preserve"
3623336794 filename="glib/deprecated/grel.c"
36234- line="530">%TRUE if a record matches.</doc>
36795+ line="557">%TRUE if a record matches.</doc>
3623536796 <type name="gboolean" c:type="gboolean"/>
3623636797 </return-value>
3623736798 <parameters>
3623836799 <instance-parameter name="relation" transfer-ownership="none">
3623936800 <doc xml:space="preserve"
3624036801 filename="glib/deprecated/grel.c"
36241- line="522">a #GRelation.</doc>
36802+ line="549">a #GRelation.</doc>
3624236803 <type name="Relation" c:type="GRelation*"/>
3624336804 </instance-parameter>
3624436805 <parameter name="..." transfer-ownership="none">
3624536806 <doc xml:space="preserve"
3624636807 filename="glib/deprecated/grel.c"
36247- line="523">the fields of the record to compare. The number must match
36808+ line="550">the fields of the record to compare. The number must match
3624836809 the number of fields in the #GRelation.</doc>
3624936810 <varargs/>
3625036811 </parameter>
@@ -36257,7 +36818,7 @@ example, two copies of the same string will not match.</doc>
3625736818 deprecated-version="2.26">
3625836819 <doc xml:space="preserve"
3625936820 filename="glib/deprecated/grel.c"
36260- line="256">Creates an index on the given field. Note that this must be called
36821+ line="263">Creates an index on the given field. Note that this must be called
3626136822 before any records are added to the #GRelation.</doc>
3626236823 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
3626336824 <source-position filename="glib/deprecated/grel.h" line="51"/>
@@ -36268,25 +36829,25 @@ before any records are added to the #GRelation.</doc>
3626836829 <instance-parameter name="relation" transfer-ownership="none">
3626936830 <doc xml:space="preserve"
3627036831 filename="glib/deprecated/grel.c"
36271- line="258">a #GRelation.</doc>
36832+ line="265">a #GRelation.</doc>
3627236833 <type name="Relation" c:type="GRelation*"/>
3627336834 </instance-parameter>
3627436835 <parameter name="field" transfer-ownership="none">
3627536836 <doc xml:space="preserve"
3627636837 filename="glib/deprecated/grel.c"
36277- line="259">the field to index, counting from 0.</doc>
36838+ line="266">the field to index, counting from 0.</doc>
3627836839 <type name="gint" c:type="gint"/>
3627936840 </parameter>
3628036841 <parameter name="hash_func" transfer-ownership="none">
3628136842 <doc xml:space="preserve"
3628236843 filename="glib/deprecated/grel.c"
36283- line="260">a function to produce a hash value from the field data.</doc>
36844+ line="267">a function to produce a hash value from the field data.</doc>
3628436845 <type name="HashFunc" c:type="GHashFunc"/>
3628536846 </parameter>
3628636847 <parameter name="key_equal_func" transfer-ownership="none">
3628736848 <doc xml:space="preserve"
3628836849 filename="glib/deprecated/grel.c"
36289- line="261">a function to compare two values of the given field.</doc>
36850+ line="268">a function to compare two values of the given field.</doc>
3629036851 <type name="EqualFunc" c:type="GEqualFunc"/>
3629136852 </parameter>
3629236853 </parameters>
@@ -36298,7 +36859,7 @@ before any records are added to the #GRelation.</doc>
3629836859 deprecated-version="2.26">
3629936860 <doc xml:space="preserve"
3630036861 filename="glib/deprecated/grel.c"
36301- line="281">Inserts a record into a #GRelation.</doc>
36862+ line="288">Inserts a record into a #GRelation.</doc>
3630236863 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
3630336864 <source-position filename="glib/deprecated/grel.h" line="56"/>
3630436865 <return-value transfer-ownership="none">
@@ -36308,13 +36869,13 @@ before any records are added to the #GRelation.</doc>
3630836869 <instance-parameter name="relation" transfer-ownership="none">
3630936870 <doc xml:space="preserve"
3631036871 filename="glib/deprecated/grel.c"
36311- line="283">a #GRelation.</doc>
36872+ line="290">a #GRelation.</doc>
3631236873 <type name="Relation" c:type="GRelation*"/>
3631336874 </instance-parameter>
3631436875 <parameter name="..." transfer-ownership="none">
3631536876 <doc xml:space="preserve"
3631636877 filename="glib/deprecated/grel.c"
36317- line="284">the fields of the record to add. These must match the
36878+ line="291">the fields of the record to add. These must match the
3631836879 number of fields in the #GRelation, and of type #gpointer
3631936880 or #gconstpointer.</doc>
3632036881 <varargs/>
@@ -36327,7 +36888,7 @@ before any records are added to the #GRelation.</doc>
3632736888 deprecated-version="2.26">
3632836889 <doc xml:space="preserve"
3632936890 filename="glib/deprecated/grel.c"
36330- line="649">Outputs information about all records in a #GRelation, as well as
36891+ line="679">Outputs information about all records in a #GRelation, as well as
3633136892 the indexes. It is for debugging.</doc>
3633236893 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
3633336894 <source-position filename="glib/deprecated/grel.h" line="74"/>
@@ -36338,7 +36899,7 @@ the indexes. It is for debugging.</doc>
3633836899 <instance-parameter name="relation" transfer-ownership="none">
3633936900 <doc xml:space="preserve"
3634036901 filename="glib/deprecated/grel.c"
36341- line="651">a #GRelation.</doc>
36902+ line="681">a #GRelation.</doc>
3634236903 <type name="Relation" c:type="GRelation*"/>
3634336904 </instance-parameter>
3634436905 </parameters>
@@ -36350,7 +36911,7 @@ the indexes. It is for debugging.</doc>
3635036911 deprecated-version="2.26">
3635136912 <doc xml:space="preserve"
3635236913 filename="glib/deprecated/grel.c"
36353- line="437">Returns all of the tuples which have the given key in the given
36914+ line="445">Returns all of the tuples which have the given key in the given
3635436915 field. Use g_tuples_index() to access the returned records. The
3635536916 returned records should be freed with g_tuples_destroy().</doc>
3635636917 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
@@ -36358,14 +36919,14 @@ returned records should be freed with g_tuples_destroy().</doc>
3635836919 <return-value>
3635936920 <doc xml:space="preserve"
3636036921 filename="glib/deprecated/grel.c"
36361- line="447">the records (tuples) that matched.</doc>
36922+ line="455">the records (tuples) that matched.</doc>
3636236923 <type name="Tuples" c:type="GTuples*"/>
3636336924 </return-value>
3636436925 <parameters>
3636536926 <instance-parameter name="relation" transfer-ownership="none">
3636636927 <doc xml:space="preserve"
3636736928 filename="glib/deprecated/grel.c"
36368- line="439">a #GRelation.</doc>
36929+ line="447">a #GRelation.</doc>
3636936930 <type name="Relation" c:type="GRelation*"/>
3637036931 </instance-parameter>
3637136932 <parameter name="key"
@@ -36374,13 +36935,13 @@ returned records should be freed with g_tuples_destroy().</doc>
3637436935 allow-none="1">
3637536936 <doc xml:space="preserve"
3637636937 filename="glib/deprecated/grel.c"
36377- line="440">the value to compare with.</doc>
36938+ line="448">the value to compare with.</doc>
3637836939 <type name="gpointer" c:type="gconstpointer"/>
3637936940 </parameter>
3638036941 <parameter name="field" transfer-ownership="none">
3638136942 <doc xml:space="preserve"
3638236943 filename="glib/deprecated/grel.c"
36383- line="441">the field of each record to match.</doc>
36944+ line="449">the field of each record to match.</doc>
3638436945 <type name="gint" c:type="gint"/>
3638536946 </parameter>
3638636947 </parameters>
@@ -36392,21 +36953,21 @@ returned records should be freed with g_tuples_destroy().</doc>
3639236953 deprecated-version="2.26">
3639336954 <doc xml:space="preserve"
3639436955 filename="glib/deprecated/grel.c"
36395- line="183">Creates a new #GRelation with the given number of fields. Note that
36956+ line="187">Creates a new #GRelation with the given number of fields. Note that
3639636957 currently the number of fields must be 2.</doc>
3639736958 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
3639836959 <source-position filename="glib/deprecated/grel.h" line="47"/>
3639936960 <return-value>
3640036961 <doc xml:space="preserve"
3640136962 filename="glib/deprecated/grel.c"
36402- line="190">a new #GRelation.</doc>
36963+ line="194">a new #GRelation.</doc>
3640336964 <type name="Relation" c:type="GRelation*"/>
3640436965 </return-value>
3640536966 <parameters>
3640636967 <parameter name="fields" transfer-ownership="none">
3640736968 <doc xml:space="preserve"
3640836969 filename="glib/deprecated/grel.c"
36409- line="185">the number of fields.</doc>
36970+ line="189">the number of fields.</doc>
3641036971 <type name="gint" c:type="gint"/>
3641136972 </parameter>
3641236973 </parameters>
@@ -36513,8 +37074,8 @@ g_slist_insert_sorted() functions and so is rarely used on its own.</doc>
3651337074 filename="glib/gslist.c"
3651437075 line="153">Adds a new element on to the end of the list.
3651537076
36516-The return value is the new start of the list, which may
36517-have changed, so make sure you store the new value.
37077+Note that the return value is the new start of the list
37078+if @list was empty; make sure you store the new value.
3651837079
3651937080 Note that g_slist_append() has to traverse the entire list
3652037081 to find the end, which is inefficient when adding multiple
@@ -36537,7 +37098,7 @@ number_list = g_slist_append (number_list, GINT_TO_POINTER (14));
3653737098 <return-value>
3653837099 <doc xml:space="preserve"
3653937100 filename="glib/gslist.c"
36540- line="181">the new start of the #GSList</doc>
37101+ line="181">either @list or the new start of the #GSList if @list was %NULL</doc>
3654137102 <type name="GLib.SList" c:type="GSList*">
3654237103 <type name="gpointer" c:type="gpointer"/>
3654337104 </type>
@@ -36565,14 +37126,14 @@ number_list = g_slist_append (number_list, GINT_TO_POINTER (14));
3656537126 <function name="concat" c:identifier="g_slist_concat" introspectable="0">
3656637127 <doc xml:space="preserve"
3656737128 filename="glib/gslist.c"
36568- line="339">Adds the second #GSList onto the end of the first #GSList.
37129+ line="340">Adds the second #GSList onto the end of the first #GSList.
3656937130 Note that the elements of the second #GSList are not copied.
3657037131 They are used directly.</doc>
3657137132 <source-position filename="glib/gslist.h" line="83"/>
3657237133 <return-value>
3657337134 <doc xml:space="preserve"
3657437135 filename="glib/gslist.c"
36575- line="348">the start of the new #GSList</doc>
37136+ line="349">the start of the new #GSList</doc>
3657637137 <type name="GLib.SList" c:type="GSList*">
3657737138 <type name="gpointer" c:type="gpointer"/>
3657837139 </type>
@@ -36581,7 +37142,7 @@ They are used directly.</doc>
3658137142 <parameter name="list1" transfer-ownership="none">
3658237143 <doc xml:space="preserve"
3658337144 filename="glib/gslist.c"
36584- line="341">a #GSList</doc>
37145+ line="342">a #GSList</doc>
3658537146 <type name="GLib.SList" c:type="GSList*">
3658637147 <type name="gpointer" c:type="gpointer"/>
3658737148 </type>
@@ -36589,7 +37150,7 @@ They are used directly.</doc>
3658937150 <parameter name="list2" transfer-ownership="none">
3659037151 <doc xml:space="preserve"
3659137152 filename="glib/gslist.c"
36592- line="342">the #GSList to add to the end of the first #GSList</doc>
37153+ line="343">the #GSList to add to the end of the first #GSList</doc>
3659337154 <type name="GLib.SList" c:type="GSList*">
3659437155 <type name="gpointer" c:type="gpointer"/>
3659537156 </type>
@@ -36599,7 +37160,7 @@ They are used directly.</doc>
3659937160 <function name="copy" c:identifier="g_slist_copy" introspectable="0">
3660037161 <doc xml:space="preserve"
3660137162 filename="glib/gslist.c"
36602- line="502">Copies a #GSList.
37163+ line="503">Copies a #GSList.
3660337164
3660437165 Note that this is a "shallow" copy. If the list elements
3660537166 consist of pointers to data, the pointers are copied but
@@ -36609,7 +37170,7 @@ to copy the data as well.</doc>
3660937170 <return-value>
3661037171 <doc xml:space="preserve"
3661137172 filename="glib/gslist.c"
36612- line="513">a copy of @list</doc>
37173+ line="514">a copy of @list</doc>
3661337174 <type name="GLib.SList" c:type="GSList*">
3661437175 <type name="gpointer" c:type="gpointer"/>
3661537176 </type>
@@ -36618,7 +37179,7 @@ to copy the data as well.</doc>
3661837179 <parameter name="list" transfer-ownership="none">
3661937180 <doc xml:space="preserve"
3662037181 filename="glib/gslist.c"
36621- line="504">a #GSList</doc>
37182+ line="505">a #GSList</doc>
3662237183 <type name="GLib.SList" c:type="GSList*">
3662337184 <type name="gpointer" c:type="gpointer"/>
3662437185 </type>
@@ -36631,7 +37192,7 @@ to copy the data as well.</doc>
3663137192 introspectable="0">
3663237193 <doc xml:space="preserve"
3663337194 filename="glib/gslist.c"
36634- line="521">Makes a full (deep) copy of a #GSList.
37195+ line="522">Makes a full (deep) copy of a #GSList.
3663537196
3663637197 In contrast with g_slist_copy(), this function uses @func to make a copy of
3663737198 each list element, in addition to copying the list container itself.
@@ -36655,7 +37216,7 @@ g_slist_free_full (another_list, g_object_unref);
3665537216 <return-value>
3665637217 <doc xml:space="preserve"
3665737218 filename="glib/gslist.c"
36658- line="548">a full copy of @list, use g_slist_free_full() to free it</doc>
37219+ line="549">a full copy of @list, use g_slist_free_full() to free it</doc>
3665937220 <type name="GLib.SList" c:type="GSList*">
3666037221 <type name="gpointer" c:type="gpointer"/>
3666137222 </type>
@@ -36664,7 +37225,7 @@ g_slist_free_full (another_list, g_object_unref);
3666437225 <parameter name="list" transfer-ownership="none">
3666537226 <doc xml:space="preserve"
3666637227 filename="glib/gslist.c"
36667- line="523">a #GSList</doc>
37228+ line="524">a #GSList</doc>
3666837229 <type name="GLib.SList" c:type="GSList*">
3666937230 <type name="gpointer" c:type="gpointer"/>
3667037231 </type>
@@ -36675,7 +37236,7 @@ g_slist_free_full (another_list, g_object_unref);
3667537236 closure="2">
3667637237 <doc xml:space="preserve"
3667737238 filename="glib/gslist.c"
36678- line="524">a copy function used to copy every element in the list</doc>
37239+ line="525">a copy function used to copy every element in the list</doc>
3667937240 <type name="CopyFunc" c:type="GCopyFunc"/>
3668037241 </parameter>
3668137242 <parameter name="user_data"
@@ -36684,7 +37245,7 @@ g_slist_free_full (another_list, g_object_unref);
3668437245 allow-none="1">
3668537246 <doc xml:space="preserve"
3668637247 filename="glib/gslist.c"
36687- line="525">user data passed to the copy function @func, or #NULL</doc>
37248+ line="526">user data passed to the copy function @func, or #NULL</doc>
3668837249 <type name="gpointer" c:type="gpointer"/>
3668937250 </parameter>
3669037251 </parameters>
@@ -36694,7 +37255,7 @@ g_slist_free_full (another_list, g_object_unref);
3669437255 introspectable="0">
3669537256 <doc xml:space="preserve"
3669637257 filename="glib/gslist.c"
36697- line="475">Removes the node link_ from the list and frees it.
37258+ line="476">Removes the node link_ from the list and frees it.
3669837259 Compare this to g_slist_remove_link() which removes the node
3669937260 without freeing it.
3670037261
@@ -36707,7 +37268,7 @@ consider a different data structure, such as the doubly-linked
3670737268 <return-value>
3670837269 <doc xml:space="preserve"
3670937270 filename="glib/gslist.c"
36710- line="490">the new head of @list</doc>
37271+ line="491">the new head of @list</doc>
3671137272 <type name="GLib.SList" c:type="GSList*">
3671237273 <type name="gpointer" c:type="gpointer"/>
3671337274 </type>
@@ -36716,7 +37277,7 @@ consider a different data structure, such as the doubly-linked
3671637277 <parameter name="list" transfer-ownership="none">
3671737278 <doc xml:space="preserve"
3671837279 filename="glib/gslist.c"
36719- line="477">a #GSList</doc>
37280+ line="478">a #GSList</doc>
3672037281 <type name="GLib.SList" c:type="GSList*">
3672137282 <type name="gpointer" c:type="gpointer"/>
3672237283 </type>
@@ -36724,7 +37285,7 @@ consider a different data structure, such as the doubly-linked
3672437285 <parameter name="link_" transfer-ownership="none">
3672537286 <doc xml:space="preserve"
3672637287 filename="glib/gslist.c"
36727- line="478">node to delete</doc>
37288+ line="479">node to delete</doc>
3672837289 <type name="GLib.SList" c:type="GSList*">
3672937290 <type name="gpointer" c:type="gpointer"/>
3673037291 </type>
@@ -36734,13 +37295,13 @@ consider a different data structure, such as the doubly-linked
3673437295 <function name="find" c:identifier="g_slist_find" introspectable="0">
3673537296 <doc xml:space="preserve"
3673637297 filename="glib/gslist.c"
36737- line="650">Finds the element in a #GSList which
37298+ line="651">Finds the element in a #GSList which
3673837299 contains the given data.</doc>
3673937300 <source-position filename="glib/gslist.h" line="110"/>
3674037301 <return-value>
3674137302 <doc xml:space="preserve"
3674237303 filename="glib/gslist.c"
36743- line="658">the found #GSList element,
37304+ line="659">the found #GSList element,
3674437305 or %NULL if it is not found</doc>
3674537306 <type name="GLib.SList" c:type="GSList*">
3674637307 <type name="gpointer" c:type="gpointer"/>
@@ -36750,7 +37311,7 @@ contains the given data.</doc>
3675037311 <parameter name="list" transfer-ownership="none">
3675137312 <doc xml:space="preserve"
3675237313 filename="glib/gslist.c"
36753- line="652">a #GSList</doc>
37314+ line="653">a #GSList</doc>
3675437315 <type name="GLib.SList" c:type="GSList*">
3675537316 <type name="gpointer" c:type="gpointer"/>
3675637317 </type>
@@ -36761,7 +37322,7 @@ contains the given data.</doc>
3676137322 allow-none="1">
3676237323 <doc xml:space="preserve"
3676337324 filename="glib/gslist.c"
36764- line="653">the element data to find</doc>
37325+ line="654">the element data to find</doc>
3676537326 <type name="gpointer" c:type="gconstpointer"/>
3676637327 </parameter>
3676737328 </parameters>
@@ -36771,7 +37332,7 @@ contains the given data.</doc>
3677137332 introspectable="0">
3677237333 <doc xml:space="preserve"
3677337334 filename="glib/gslist.c"
36774- line="676">Finds an element in a #GSList, using a supplied function to
37335+ line="677">Finds an element in a #GSList, using a supplied function to
3677537336 find the desired element. It iterates over the list, calling
3677637337 the given function which should return 0 when the desired
3677737338 element is found. The function takes two #gconstpointer arguments,
@@ -36781,7 +37342,7 @@ given user data.</doc>
3678137342 <return-value>
3678237343 <doc xml:space="preserve"
3678337344 filename="glib/gslist.c"
36784- line="690">the found #GSList element, or %NULL if it is not found</doc>
37345+ line="691">the found #GSList element, or %NULL if it is not found</doc>
3678537346 <type name="GLib.SList" c:type="GSList*">
3678637347 <type name="gpointer" c:type="gpointer"/>
3678737348 </type>
@@ -36790,7 +37351,7 @@ given user data.</doc>
3679037351 <parameter name="list" transfer-ownership="none">
3679137352 <doc xml:space="preserve"
3679237353 filename="glib/gslist.c"
36793- line="678">a #GSList</doc>
37354+ line="679">a #GSList</doc>
3679437355 <type name="GLib.SList" c:type="GSList*">
3679537356 <type name="gpointer" c:type="gpointer"/>
3679637357 </type>
@@ -36801,13 +37362,13 @@ given user data.</doc>
3680137362 allow-none="1">
3680237363 <doc xml:space="preserve"
3680337364 filename="glib/gslist.c"
36804- line="679">user data passed to the function</doc>
37365+ line="680">user data passed to the function</doc>
3680537366 <type name="gpointer" c:type="gconstpointer"/>
3680637367 </parameter>
3680737368 <parameter name="func" transfer-ownership="none" scope="call">
3680837369 <doc xml:space="preserve"
3680937370 filename="glib/gslist.c"
36810- line="680">the function to call for each element.
37371+ line="681">the function to call for each element.
3681137372 It should return 0 when the desired element is found</doc>
3681237373 <type name="CompareFunc" c:type="GCompareFunc"/>
3681337374 </parameter>
@@ -36818,7 +37379,7 @@ given user data.</doc>
3681837379 introspectable="0">
3681937380 <doc xml:space="preserve"
3682037381 filename="glib/gslist.c"
36821- line="817">Calls a function for each element of a #GSList.
37382+ line="818">Calls a function for each element of a #GSList.
3682237383
3682337384 It is safe for @func to remove the element from @list, but it must
3682437385 not modify any part of the list after that element.</doc>
@@ -36830,7 +37391,7 @@ not modify any part of the list after that element.</doc>
3683037391 <parameter name="list" transfer-ownership="none">
3683137392 <doc xml:space="preserve"
3683237393 filename="glib/gslist.c"
36833- line="819">a #GSList</doc>
37394+ line="820">a #GSList</doc>
3683437395 <type name="GLib.SList" c:type="GSList*">
3683537396 <type name="gpointer" c:type="gpointer"/>
3683637397 </type>
@@ -36841,7 +37402,7 @@ not modify any part of the list after that element.</doc>
3684137402 closure="2">
3684237403 <doc xml:space="preserve"
3684337404 filename="glib/gslist.c"
36844- line="820">the function to call with each element's data</doc>
37405+ line="821">the function to call with each element's data</doc>
3684537406 <type name="Func" c:type="GFunc"/>
3684637407 </parameter>
3684737408 <parameter name="user_data"
@@ -36850,7 +37411,7 @@ not modify any part of the list after that element.</doc>
3685037411 allow-none="1">
3685137412 <doc xml:space="preserve"
3685237413 filename="glib/gslist.c"
36853- line="821">user data to pass to the function</doc>
37414+ line="822">user data to pass to the function</doc>
3685437415 <type name="gpointer" c:type="gpointer"/>
3685537416 </parameter>
3685637417 </parameters>
@@ -36950,13 +37511,13 @@ g_slist_free_full (g_steal_pointer (&amp;list_of_owned_things), g_object_unref);
3695037511 <function name="index" c:identifier="g_slist_index" introspectable="0">
3695137512 <doc xml:space="preserve"
3695237513 filename="glib/gslist.c"
36953- line="738">Gets the position of the element containing
37514+ line="739">Gets the position of the element containing
3695437515 the given data (starting from 0).</doc>
3695537516 <source-position filename="glib/gslist.h" line="120"/>
3695637517 <return-value transfer-ownership="none">
3695737518 <doc xml:space="preserve"
3695837519 filename="glib/gslist.c"
36959- line="746">the index of the element containing the data,
37520+ line="747">the index of the element containing the data,
3696037521 or -1 if the data is not found</doc>
3696137522 <type name="gint" c:type="gint"/>
3696237523 </return-value>
@@ -36964,7 +37525,7 @@ the given data (starting from 0).</doc>
3696437525 <parameter name="list" transfer-ownership="none">
3696537526 <doc xml:space="preserve"
3696637527 filename="glib/gslist.c"
36967- line="740">a #GSList</doc>
37528+ line="741">a #GSList</doc>
3696837529 <type name="GLib.SList" c:type="GSList*">
3696937530 <type name="gpointer" c:type="gpointer"/>
3697037531 </type>
@@ -36975,7 +37536,7 @@ the given data (starting from 0).</doc>
3697537536 allow-none="1">
3697637537 <doc xml:space="preserve"
3697737538 filename="glib/gslist.c"
36978- line="741">the data to find</doc>
37539+ line="742">the data to find</doc>
3697937540 <type name="gpointer" c:type="gconstpointer"/>
3698037541 </parameter>
3698137542 </parameters>
@@ -36983,12 +37544,12 @@ the given data (starting from 0).</doc>
3698337544 <function name="insert" c:identifier="g_slist_insert" introspectable="0">
3698437545 <doc xml:space="preserve"
3698537546 filename="glib/gslist.c"
36986- line="238">Inserts a new element into the list at the given position.</doc>
37547+ line="239">Inserts a new element into the list at the given position.</doc>
3698737548 <source-position filename="glib/gslist.h" line="66"/>
3698837549 <return-value>
3698937550 <doc xml:space="preserve"
3699037551 filename="glib/gslist.c"
36991- line="249">the new start of the #GSList</doc>
37552+ line="250">the (possibly changed) start of the #GSList</doc>
3699237553 <type name="GLib.SList" c:type="GSList*">
3699337554 <type name="gpointer" c:type="gpointer"/>
3699437555 </type>
@@ -36997,7 +37558,7 @@ the given data (starting from 0).</doc>
3699737558 <parameter name="list" transfer-ownership="none">
3699837559 <doc xml:space="preserve"
3699937560 filename="glib/gslist.c"
37000- line="240">a #GSList</doc>
37561+ line="241">a #GSList</doc>
3700137562 <type name="GLib.SList" c:type="GSList*">
3700237563 <type name="gpointer" c:type="gpointer"/>
3700337564 </type>
@@ -37008,13 +37569,13 @@ the given data (starting from 0).</doc>
3700837569 allow-none="1">
3700937570 <doc xml:space="preserve"
3701037571 filename="glib/gslist.c"
37011- line="241">the data for the new element</doc>
37572+ line="242">the data for the new element</doc>
3701237573 <type name="gpointer" c:type="gpointer"/>
3701337574 </parameter>
3701437575 <parameter name="position" transfer-ownership="none">
3701537576 <doc xml:space="preserve"
3701637577 filename="glib/gslist.c"
37017- line="242">the position to insert the element.
37578+ line="243">the position to insert the element.
3701837579 If this is negative, or is larger than the number
3701937580 of elements in the list, the new element is added on
3702037581 to the end of the list.</doc>
@@ -37027,12 +37588,12 @@ the given data (starting from 0).</doc>
3702737588 introspectable="0">
3702837589 <doc xml:space="preserve"
3702937590 filename="glib/gslist.c"
37030- line="289">Inserts a node before @sibling containing @data.</doc>
37591+ line="290">Inserts a node before @sibling containing @data.</doc>
3703137592 <source-position filename="glib/gslist.h" line="79"/>
3703237593 <return-value>
3703337594 <doc xml:space="preserve"
3703437595 filename="glib/gslist.c"
37035- line="297">the new head of the list.</doc>
37596+ line="298">the new head of the list.</doc>
3703637597 <type name="GLib.SList" c:type="GSList*">
3703737598 <type name="gpointer" c:type="gpointer"/>
3703837599 </type>
@@ -37041,7 +37602,7 @@ the given data (starting from 0).</doc>
3704137602 <parameter name="slist" transfer-ownership="none">
3704237603 <doc xml:space="preserve"
3704337604 filename="glib/gslist.c"
37044- line="291">a #GSList</doc>
37605+ line="292">a #GSList</doc>
3704537606 <type name="GLib.SList" c:type="GSList*">
3704637607 <type name="gpointer" c:type="gpointer"/>
3704737608 </type>
@@ -37049,7 +37610,7 @@ the given data (starting from 0).</doc>
3704937610 <parameter name="sibling" transfer-ownership="none">
3705037611 <doc xml:space="preserve"
3705137612 filename="glib/gslist.c"
37052- line="292">node to insert @data before</doc>
37613+ line="293">node to insert @data before</doc>
3705337614 <type name="GLib.SList" c:type="GSList*">
3705437615 <type name="gpointer" c:type="gpointer"/>
3705537616 </type>
@@ -37060,7 +37621,7 @@ the given data (starting from 0).</doc>
3706037621 allow-none="1">
3706137622 <doc xml:space="preserve"
3706237623 filename="glib/gslist.c"
37063- line="293">data to put in the newly-inserted node</doc>
37624+ line="294">data to put in the newly-inserted node</doc>
3706437625 <type name="gpointer" c:type="gpointer"/>
3706537626 </parameter>
3706637627 </parameters>
@@ -37070,13 +37631,13 @@ the given data (starting from 0).</doc>
3707037631 introspectable="0">
3707137632 <doc xml:space="preserve"
3707237633 filename="glib/gslist.c"
37073- line="895">Inserts a new element into the list, using the given
37634+ line="896">Inserts a new element into the list, using the given
3707437635 comparison function to determine its position.</doc>
3707537636 <source-position filename="glib/gslist.h" line="70"/>
3707637637 <return-value>
3707737638 <doc xml:space="preserve"
3707837639 filename="glib/gslist.c"
37079- line="906">the new start of the #GSList</doc>
37640+ line="907">the new start of the #GSList</doc>
3708037641 <type name="GLib.SList" c:type="GSList*">
3708137642 <type name="gpointer" c:type="gpointer"/>
3708237643 </type>
@@ -37085,7 +37646,7 @@ comparison function to determine its position.</doc>
3708537646 <parameter name="list" transfer-ownership="none">
3708637647 <doc xml:space="preserve"
3708737648 filename="glib/gslist.c"
37088- line="897">a #GSList</doc>
37649+ line="898">a #GSList</doc>
3708937650 <type name="GLib.SList" c:type="GSList*">
3709037651 <type name="gpointer" c:type="gpointer"/>
3709137652 </type>
@@ -37096,13 +37657,13 @@ comparison function to determine its position.</doc>
3709637657 allow-none="1">
3709737658 <doc xml:space="preserve"
3709837659 filename="glib/gslist.c"
37099- line="898">the data for the new element</doc>
37660+ line="899">the data for the new element</doc>
3710037661 <type name="gpointer" c:type="gpointer"/>
3710137662 </parameter>
3710237663 <parameter name="func" transfer-ownership="none" scope="call">
3710337664 <doc xml:space="preserve"
3710437665 filename="glib/gslist.c"
37105- line="899">the function to compare elements in the list.
37666+ line="900">the function to compare elements in the list.
3710637667 It should return a number &gt; 0 if the first parameter
3710737668 comes after the second parameter in the sort order.</doc>
3710837669 <type name="CompareFunc" c:type="GCompareFunc"/>
@@ -37115,13 +37676,13 @@ comparison function to determine its position.</doc>
3711537676 introspectable="0">
3711637677 <doc xml:space="preserve"
3711737678 filename="glib/gslist.c"
37118- line="916">Inserts a new element into the list, using the given
37679+ line="917">Inserts a new element into the list, using the given
3711937680 comparison function to determine its position.</doc>
3712037681 <source-position filename="glib/gslist.h" line="74"/>
3712137682 <return-value>
3712237683 <doc xml:space="preserve"
3712337684 filename="glib/gslist.c"
37124- line="928">the new start of the #GSList</doc>
37685+ line="929">the new start of the #GSList</doc>
3712537686 <type name="GLib.SList" c:type="GSList*">
3712637687 <type name="gpointer" c:type="gpointer"/>
3712737688 </type>
@@ -37130,7 +37691,7 @@ comparison function to determine its position.</doc>
3713037691 <parameter name="list" transfer-ownership="none">
3713137692 <doc xml:space="preserve"
3713237693 filename="glib/gslist.c"
37133- line="918">a #GSList</doc>
37694+ line="919">a #GSList</doc>
3713437695 <type name="GLib.SList" c:type="GSList*">
3713537696 <type name="gpointer" c:type="gpointer"/>
3713637697 </type>
@@ -37141,7 +37702,7 @@ comparison function to determine its position.</doc>
3714137702 allow-none="1">
3714237703 <doc xml:space="preserve"
3714337704 filename="glib/gslist.c"
37144- line="919">the data for the new element</doc>
37705+ line="920">the data for the new element</doc>
3714537706 <type name="gpointer" c:type="gpointer"/>
3714637707 </parameter>
3714737708 <parameter name="func"
@@ -37150,7 +37711,7 @@ comparison function to determine its position.</doc>
3715037711 closure="3">
3715137712 <doc xml:space="preserve"
3715237713 filename="glib/gslist.c"
37153- line="920">the function to compare elements in the list.
37714+ line="921">the function to compare elements in the list.
3715437715 It should return a number &gt; 0 if the first parameter
3715537716 comes after the second parameter in the sort order.</doc>
3715637717 <type name="CompareDataFunc" c:type="GCompareDataFunc"/>
@@ -37161,7 +37722,7 @@ comparison function to determine its position.</doc>
3716137722 allow-none="1">
3716237723 <doc xml:space="preserve"
3716337724 filename="glib/gslist.c"
37164- line="923">data to pass to comparison function</doc>
37725+ line="924">data to pass to comparison function</doc>
3716537726 <type name="gpointer" c:type="gpointer"/>
3716637727 </parameter>
3716737728 </parameters>
@@ -37169,14 +37730,14 @@ comparison function to determine its position.</doc>
3716937730 <function name="last" c:identifier="g_slist_last" introspectable="0">
3717037731 <doc xml:space="preserve"
3717137732 filename="glib/gslist.c"
37172- line="767">Gets the last element in a #GSList.
37733+ line="768">Gets the last element in a #GSList.
3717337734
3717437735 This function iterates over the whole list.</doc>
3717537736 <source-position filename="glib/gslist.h" line="123"/>
3717637737 <return-value>
3717737738 <doc xml:space="preserve"
3717837739 filename="glib/gslist.c"
37179- line="775">the last element in the #GSList,
37740+ line="776">the last element in the #GSList,
3718037741 or %NULL if the #GSList has no elements</doc>
3718137742 <type name="GLib.SList" c:type="GSList*">
3718237743 <type name="gpointer" c:type="gpointer"/>
@@ -37186,7 +37747,7 @@ This function iterates over the whole list.</doc>
3718637747 <parameter name="list" transfer-ownership="none">
3718737748 <doc xml:space="preserve"
3718837749 filename="glib/gslist.c"
37189- line="769">a #GSList</doc>
37750+ line="770">a #GSList</doc>
3719037751 <type name="GLib.SList" c:type="GSList*">
3719137752 <type name="gpointer" c:type="gpointer"/>
3719237753 </type>
@@ -37196,7 +37757,7 @@ This function iterates over the whole list.</doc>
3719637757 <function name="length" c:identifier="g_slist_length" introspectable="0">
3719737758 <doc xml:space="preserve"
3719837759 filename="glib/gslist.c"
37199- line="790">Gets the number of elements in a #GSList.
37760+ line="791">Gets the number of elements in a #GSList.
3720037761
3720137762 This function iterates over the whole list to
3720237763 count its elements. To check whether the list is non-empty, it is faster to
@@ -37205,14 +37766,14 @@ check @list against %NULL.</doc>
3720537766 <return-value transfer-ownership="none">
3720637767 <doc xml:space="preserve"
3720737768 filename="glib/gslist.c"
37208- line="800">the number of elements in the #GSList</doc>
37769+ line="801">the number of elements in the #GSList</doc>
3720937770 <type name="guint" c:type="guint"/>
3721037771 </return-value>
3721137772 <parameters>
3721237773 <parameter name="list" transfer-ownership="none">
3721337774 <doc xml:space="preserve"
3721437775 filename="glib/gslist.c"
37215- line="792">a #GSList</doc>
37776+ line="793">a #GSList</doc>
3721637777 <type name="GLib.SList" c:type="GSList*">
3721737778 <type name="gpointer" c:type="gpointer"/>
3721837779 </type>
@@ -37222,12 +37783,12 @@ check @list against %NULL.</doc>
3722237783 <function name="nth" c:identifier="g_slist_nth" introspectable="0">
3722337784 <doc xml:space="preserve"
3722437785 filename="glib/gslist.c"
37225- line="610">Gets the element at the given position in a #GSList.</doc>
37786+ line="611">Gets the element at the given position in a #GSList.</doc>
3722637787 <source-position filename="glib/gslist.h" line="107"/>
3722737788 <return-value>
3722837789 <doc xml:space="preserve"
3722937790 filename="glib/gslist.c"
37230- line="617">the element, or %NULL if the position is off
37791+ line="618">the element, or %NULL if the position is off
3723137792 the end of the #GSList</doc>
3723237793 <type name="GLib.SList" c:type="GSList*">
3723337794 <type name="gpointer" c:type="gpointer"/>
@@ -37237,7 +37798,7 @@ check @list against %NULL.</doc>
3723737798 <parameter name="list" transfer-ownership="none">
3723837799 <doc xml:space="preserve"
3723937800 filename="glib/gslist.c"
37240- line="612">a #GSList</doc>
37801+ line="613">a #GSList</doc>
3724137802 <type name="GLib.SList" c:type="GSList*">
3724237803 <type name="gpointer" c:type="gpointer"/>
3724337804 </type>
@@ -37245,7 +37806,7 @@ check @list against %NULL.</doc>
3724537806 <parameter name="n" transfer-ownership="none">
3724637807 <doc xml:space="preserve"
3724737808 filename="glib/gslist.c"
37248- line="613">the position of the element, counting from 0</doc>
37809+ line="614">the position of the element, counting from 0</doc>
3724937810 <type name="guint" c:type="guint"/>
3725037811 </parameter>
3725137812 </parameters>
@@ -37255,12 +37816,12 @@ check @list against %NULL.</doc>
3725537816 introspectable="0">
3725637817 <doc xml:space="preserve"
3725737818 filename="glib/gslist.c"
37258- line="630">Gets the data of the element at the given position.</doc>
37819+ line="631">Gets the data of the element at the given position.</doc>
3725937820 <source-position filename="glib/gslist.h" line="138"/>
3726037821 <return-value transfer-ownership="none" nullable="1">
3726137822 <doc xml:space="preserve"
3726237823 filename="glib/gslist.c"
37263- line="637">the element's data, or %NULL if the position
37824+ line="638">the element's data, or %NULL if the position
3726437825 is off the end of the #GSList</doc>
3726537826 <type name="gpointer" c:type="gpointer"/>
3726637827 </return-value>
@@ -37268,7 +37829,7 @@ check @list against %NULL.</doc>
3726837829 <parameter name="list" transfer-ownership="none">
3726937830 <doc xml:space="preserve"
3727037831 filename="glib/gslist.c"
37271- line="632">a #GSList</doc>
37832+ line="633">a #GSList</doc>
3727237833 <type name="GLib.SList" c:type="GSList*">
3727337834 <type name="gpointer" c:type="gpointer"/>
3727437835 </type>
@@ -37276,12 +37837,15 @@ check @list against %NULL.</doc>
3727637837 <parameter name="n" transfer-ownership="none">
3727737838 <doc xml:space="preserve"
3727837839 filename="glib/gslist.c"
37279- line="633">the position of the element</doc>
37840+ line="634">the position of the element</doc>
3728037841 <type name="guint" c:type="guint"/>
3728137842 </parameter>
3728237843 </parameters>
3728337844 </function>
37284- <function name="pop_allocator" c:identifier="g_slist_pop_allocator">
37845+ <function name="pop_allocator"
37846+ c:identifier="g_slist_pop_allocator"
37847+ deprecated="1"
37848+ deprecated-version="2.10">
3728537849 <source-position filename="glib/deprecated/gallocator.h" line="80"/>
3728637850 <return-value transfer-ownership="none">
3728737851 <type name="none" c:type="void"/>
@@ -37292,13 +37856,13 @@ check @list against %NULL.</doc>
3729237856 introspectable="0">
3729337857 <doc xml:space="preserve"
3729437858 filename="glib/gslist.c"
37295- line="709">Gets the position of the given element
37859+ line="710">Gets the position of the given element
3729637860 in the #GSList (starting from 0).</doc>
3729737861 <source-position filename="glib/gslist.h" line="117"/>
3729837862 <return-value transfer-ownership="none">
3729937863 <doc xml:space="preserve"
3730037864 filename="glib/gslist.c"
37301- line="717">the position of the element in the #GSList,
37865+ line="718">the position of the element in the #GSList,
3730237866 or -1 if the element is not found</doc>
3730337867 <type name="gint" c:type="gint"/>
3730437868 </return-value>
@@ -37306,7 +37870,7 @@ in the #GSList (starting from 0).</doc>
3730637870 <parameter name="list" transfer-ownership="none">
3730737871 <doc xml:space="preserve"
3730837872 filename="glib/gslist.c"
37309- line="711">a #GSList</doc>
37873+ line="712">a #GSList</doc>
3731037874 <type name="GLib.SList" c:type="GSList*">
3731137875 <type name="gpointer" c:type="gpointer"/>
3731237876 </type>
@@ -37314,7 +37878,7 @@ in the #GSList (starting from 0).</doc>
3731437878 <parameter name="llink" transfer-ownership="none">
3731537879 <doc xml:space="preserve"
3731637880 filename="glib/gslist.c"
37317- line="712">an element in the #GSList</doc>
37881+ line="713">an element in the #GSList</doc>
3731837882 <type name="GLib.SList" c:type="GSList*">
3731937883 <type name="gpointer" c:type="gpointer"/>
3732037884 </type>
@@ -37328,8 +37892,8 @@ in the #GSList (starting from 0).</doc>
3732837892 filename="glib/gslist.c"
3732937893 line="206">Adds a new element on to the start of the list.
3733037894
37331-The return value is the new start of the list, which
37332-may have changed, so make sure you store the new value.
37895+Note that the return value is the new start of the list,
37896+which will have changed, so make sure you store the new value.
3733337897
3733437898 |[&lt;!-- language="C" --&gt;
3733537899 // Notice that it is initialized to the empty list.
@@ -37341,7 +37905,8 @@ list = g_slist_prepend (list, "first");
3734137905 <return-value>
3734237906 <doc xml:space="preserve"
3734337907 filename="glib/gslist.c"
37344- line="223">the new start of the #GSList</doc>
37908+ line="223">a pointer to the newly prepended element,
37909+which is the new start of the #GSList</doc>
3734537910 <type name="GLib.SList" c:type="GSList*">
3734637911 <type name="gpointer" c:type="gpointer"/>
3734737912 </type>
@@ -37366,7 +37931,10 @@ list = g_slist_prepend (list, "first");
3736637931 </parameter>
3736737932 </parameters>
3736837933 </function>
37369- <function name="push_allocator" c:identifier="g_slist_push_allocator">
37934+ <function name="push_allocator"
37935+ c:identifier="g_slist_push_allocator"
37936+ deprecated="1"
37937+ deprecated-version="2.10">
3737037938 <source-position filename="glib/deprecated/gallocator.h" line="78"/>
3737137939 <return-value transfer-ownership="none">
3737237940 <type name="none" c:type="void"/>
@@ -37380,14 +37948,14 @@ list = g_slist_prepend (list, "first");
3738037948 <function name="remove" c:identifier="g_slist_remove" introspectable="0">
3738137949 <doc xml:space="preserve"
3738237950 filename="glib/gslist.c"
37383- line="390">Removes an element from a #GSList.
37951+ line="391">Removes an element from a #GSList.
3738437952 If two elements contain the same data, only the first is removed.
3738537953 If none of the elements contain the data, the #GSList is unchanged.</doc>
3738637954 <source-position filename="glib/gslist.h" line="86"/>
3738737955 <return-value>
3738837956 <doc xml:space="preserve"
3738937957 filename="glib/gslist.c"
37390- line="399">the new start of the #GSList</doc>
37958+ line="400">the new start of the #GSList</doc>
3739137959 <type name="GLib.SList" c:type="GSList*">
3739237960 <type name="gpointer" c:type="gpointer"/>
3739337961 </type>
@@ -37396,7 +37964,7 @@ If none of the elements contain the data, the #GSList is unchanged.</doc>
3739637964 <parameter name="list" transfer-ownership="none">
3739737965 <doc xml:space="preserve"
3739837966 filename="glib/gslist.c"
37399- line="392">a #GSList</doc>
37967+ line="393">a #GSList</doc>
3740037968 <type name="GLib.SList" c:type="GSList*">
3740137969 <type name="gpointer" c:type="gpointer"/>
3740237970 </type>
@@ -37407,7 +37975,7 @@ If none of the elements contain the data, the #GSList is unchanged.</doc>
3740737975 allow-none="1">
3740837976 <doc xml:space="preserve"
3740937977 filename="glib/gslist.c"
37410- line="393">the data of the element to remove</doc>
37978+ line="394">the data of the element to remove</doc>
3741137979 <type name="gpointer" c:type="gconstpointer"/>
3741237980 </parameter>
3741337981 </parameters>
@@ -37417,7 +37985,7 @@ If none of the elements contain the data, the #GSList is unchanged.</doc>
3741737985 introspectable="0">
3741837986 <doc xml:space="preserve"
3741937987 filename="glib/gslist.c"
37420- line="408">Removes all list nodes with data equal to @data.
37988+ line="409">Removes all list nodes with data equal to @data.
3742137989 Returns the new head of the list. Contrast with
3742237990 g_slist_remove() which removes only the first node
3742337991 matching the given data.</doc>
@@ -37425,7 +37993,7 @@ matching the given data.</doc>
3742537993 <return-value>
3742637994 <doc xml:space="preserve"
3742737995 filename="glib/gslist.c"
37428- line="418">new head of @list</doc>
37996+ line="419">new head of @list</doc>
3742937997 <type name="GLib.SList" c:type="GSList*">
3743037998 <type name="gpointer" c:type="gpointer"/>
3743137999 </type>
@@ -37434,7 +38002,7 @@ matching the given data.</doc>
3743438002 <parameter name="list" transfer-ownership="none">
3743538003 <doc xml:space="preserve"
3743638004 filename="glib/gslist.c"
37437- line="410">a #GSList</doc>
38005+ line="411">a #GSList</doc>
3743838006 <type name="GLib.SList" c:type="GSList*">
3743938007 <type name="gpointer" c:type="gpointer"/>
3744038008 </type>
@@ -37445,7 +38013,7 @@ matching the given data.</doc>
3744538013 allow-none="1">
3744638014 <doc xml:space="preserve"
3744738015 filename="glib/gslist.c"
37448- line="411">data to remove</doc>
38016+ line="412">data to remove</doc>
3744938017 <type name="gpointer" c:type="gconstpointer"/>
3745038018 </parameter>
3745138019 </parameters>
@@ -37455,7 +38023,7 @@ matching the given data.</doc>
3745538023 introspectable="0">
3745638024 <doc xml:space="preserve"
3745738025 filename="glib/gslist.c"
37458- line="450">Removes an element from a #GSList, without
38026+ line="451">Removes an element from a #GSList, without
3745938027 freeing the element. The removed element's next
3746038028 link is set to %NULL, so that it becomes a
3746138029 self-contained list with one element.
@@ -37469,7 +38037,7 @@ such as the doubly-linked #GList.</doc>
3746938037 <return-value>
3747038038 <doc xml:space="preserve"
3747138039 filename="glib/gslist.c"
37472- line="466">the new start of the #GSList, without the element</doc>
38040+ line="467">the new start of the #GSList, without the element</doc>
3747338041 <type name="GLib.SList" c:type="GSList*">
3747438042 <type name="gpointer" c:type="gpointer"/>
3747538043 </type>
@@ -37478,7 +38046,7 @@ such as the doubly-linked #GList.</doc>
3747838046 <parameter name="list" transfer-ownership="none">
3747938047 <doc xml:space="preserve"
3748038048 filename="glib/gslist.c"
37481- line="452">a #GSList</doc>
38049+ line="453">a #GSList</doc>
3748238050 <type name="GLib.SList" c:type="GSList*">
3748338051 <type name="gpointer" c:type="gpointer"/>
3748438052 </type>
@@ -37486,7 +38054,7 @@ such as the doubly-linked #GList.</doc>
3748638054 <parameter name="link_" transfer-ownership="none">
3748738055 <doc xml:space="preserve"
3748838056 filename="glib/gslist.c"
37489- line="453">an element in the #GSList</doc>
38057+ line="454">an element in the #GSList</doc>
3749038058 <type name="GLib.SList" c:type="GSList*">
3749138059 <type name="gpointer" c:type="gpointer"/>
3749238060 </type>
@@ -37498,12 +38066,12 @@ such as the doubly-linked #GList.</doc>
3749838066 introspectable="0">
3749938067 <doc xml:space="preserve"
3750038068 filename="glib/gslist.c"
37501- line="584">Reverses a #GSList.</doc>
38069+ line="585">Reverses a #GSList.</doc>
3750238070 <source-position filename="glib/gslist.h" line="98"/>
3750338071 <return-value>
3750438072 <doc xml:space="preserve"
3750538073 filename="glib/gslist.c"
37506- line="590">the start of the reversed #GSList</doc>
38074+ line="591">the start of the reversed #GSList</doc>
3750738075 <type name="GLib.SList" c:type="GSList*">
3750838076 <type name="gpointer" c:type="gpointer"/>
3750938077 </type>
@@ -37512,7 +38080,7 @@ such as the doubly-linked #GList.</doc>
3751238080 <parameter name="list" transfer-ownership="none">
3751338081 <doc xml:space="preserve"
3751438082 filename="glib/gslist.c"
37515- line="586">a #GSList</doc>
38083+ line="587">a #GSList</doc>
3751638084 <type name="GLib.SList" c:type="GSList*">
3751738085 <type name="gpointer" c:type="gpointer"/>
3751838086 </type>
@@ -37522,13 +38090,13 @@ such as the doubly-linked #GList.</doc>
3752238090 <function name="sort" c:identifier="g_slist_sort" introspectable="0">
3752338091 <doc xml:space="preserve"
3752438092 filename="glib/gslist.c"
37525- line="1002">Sorts a #GSList using the given comparison function. The algorithm
38093+ line="1003">Sorts a #GSList using the given comparison function. The algorithm
3752638094 used is a stable sort.</doc>
3752738095 <source-position filename="glib/gslist.h" line="131"/>
3752838096 <return-value>
3752938097 <doc xml:space="preserve"
3753038098 filename="glib/gslist.c"
37531- line="1014">the start of the sorted #GSList</doc>
38099+ line="1015">the start of the sorted #GSList</doc>
3753238100 <type name="GLib.SList" c:type="GSList*">
3753338101 <type name="gpointer" c:type="gpointer"/>
3753438102 </type>
@@ -37537,7 +38105,7 @@ used is a stable sort.</doc>
3753738105 <parameter name="list" transfer-ownership="none">
3753838106 <doc xml:space="preserve"
3753938107 filename="glib/gslist.c"
37540- line="1004">a #GSList</doc>
38108+ line="1005">a #GSList</doc>
3754138109 <type name="GLib.SList" c:type="GSList*">
3754238110 <type name="gpointer" c:type="gpointer"/>
3754338111 </type>
@@ -37547,7 +38115,7 @@ used is a stable sort.</doc>
3754738115 scope="call">
3754838116 <doc xml:space="preserve"
3754938117 filename="glib/gslist.c"
37550- line="1005">the comparison function used to sort the #GSList.
38118+ line="1006">the comparison function used to sort the #GSList.
3755138119 This function is passed the data from 2 elements of the #GSList
3755238120 and should return 0 if they are equal, a negative value if the
3755338121 first element comes before the second, or a positive value if
@@ -37561,12 +38129,12 @@ used is a stable sort.</doc>
3756138129 introspectable="0">
3756238130 <doc xml:space="preserve"
3756338131 filename="glib/gslist.c"
37564- line="1023">Like g_slist_sort(), but the sort function accepts a user data argument.</doc>
38132+ line="1024">Like g_slist_sort(), but the sort function accepts a user data argument.</doc>
3756538133 <source-position filename="glib/gslist.h" line="134"/>
3756638134 <return-value>
3756738135 <doc xml:space="preserve"
3756838136 filename="glib/gslist.c"
37569- line="1031">new head of the list</doc>
38137+ line="1032">new head of the list</doc>
3757038138 <type name="GLib.SList" c:type="GSList*">
3757138139 <type name="gpointer" c:type="gpointer"/>
3757238140 </type>
@@ -37575,7 +38143,7 @@ used is a stable sort.</doc>
3757538143 <parameter name="list" transfer-ownership="none">
3757638144 <doc xml:space="preserve"
3757738145 filename="glib/gslist.c"
37578- line="1025">a #GSList</doc>
38146+ line="1026">a #GSList</doc>
3757938147 <type name="GLib.SList" c:type="GSList*">
3758038148 <type name="gpointer" c:type="gpointer"/>
3758138149 </type>
@@ -37586,7 +38154,7 @@ used is a stable sort.</doc>
3758638154 closure="2">
3758738155 <doc xml:space="preserve"
3758838156 filename="glib/gslist.c"
37589- line="1026">comparison function</doc>
38157+ line="1027">comparison function</doc>
3759038158 <type name="CompareDataFunc" c:type="GCompareDataFunc"/>
3759138159 </parameter>
3759238160 <parameter name="user_data"
@@ -37595,7 +38163,7 @@ used is a stable sort.</doc>
3759538163 allow-none="1">
3759638164 <doc xml:space="preserve"
3759738165 filename="glib/gslist.c"
37598- line="1027">data to pass to comparison function</doc>
38166+ line="1028">data to pass to comparison function</doc>
3759938167 <type name="gpointer" c:type="gpointer"/>
3760038168 </parameter>
3760138169 </parameters>
@@ -37607,9 +38175,9 @@ used is a stable sort.</doc>
3760738175 version="2.32">
3760838176 <doc xml:space="preserve"
3760938177 filename="glib/gmain.h"
37610- line="474">Use this macro as the return value of a [callback@GLib.SourceFunc] to leave
38178+ line="475">Use this macro as the return value of a [callback@GLib.SourceFunc] to leave
3761138179 the [struct@GLib.Source] in the main loop.</doc>
37612- <source-position filename="glib/gmain.h" line="482"/>
38180+ <source-position filename="glib/gmain.h" line="483"/>
3761338181 <type name="gboolean" c:type="gboolean"/>
3761438182 </constant>
3761538183 <function-macro name="SOURCE_FUNC"
@@ -37618,7 +38186,7 @@ the [struct@GLib.Source] in the main loop.</doc>
3761838186 introspectable="0">
3761938187 <doc xml:space="preserve"
3762038188 filename="glib/gmain.h"
37621- line="215">Cast a function pointer to a [callback@GLib.SourceFunc], suppressing
38189+ line="216">Cast a function pointer to a [callback@GLib.SourceFunc], suppressing
3762238190 warnings from GCC 8 onwards with `-Wextra` or `-Wcast-function-type` enabled
3762338191 about the function types being incompatible.
3762438192
@@ -37628,12 +38196,12 @@ arguments than [callback@GLib.SourceFunc]. Casting the function with
3762838196 `(GSourceFunc)` to call [method@GLib.Source.set_callback] will trigger a
3762938197 warning, even though it will be cast back to the correct type before it is
3763038198 called by the source.</doc>
37631- <source-position filename="glib/gmain.h" line="232"/>
38199+ <source-position filename="glib/gmain.h" line="233"/>
3763238200 <parameters>
3763338201 <parameter name="f">
3763438202 <doc xml:space="preserve"
3763538203 filename="glib/gmain.h"
37636- line="217">a function pointer.</doc>
38204+ line="218">a function pointer.</doc>
3763738205 </parameter>
3763838206 </parameters>
3763938207 </function-macro>
@@ -37643,9 +38211,9 @@ called by the source.</doc>
3764338211 version="2.32">
3764438212 <doc xml:space="preserve"
3764538213 filename="glib/gmain.h"
37646- line="464">Use this macro as the return value of a [callback@GLib.SourceFunc] to remove
38214+ line="465">Use this macro as the return value of a [callback@GLib.SourceFunc] to remove
3764738215 the [struct@GLib.Source] from the main loop.</doc>
37648- <source-position filename="glib/gmain.h" line="472"/>
38216+ <source-position filename="glib/gmain.h" line="473"/>
3764938217 <type name="gboolean" c:type="gboolean"/>
3765038218 </constant>
3765138219 <constant name="SQRT2" value="1.414214" c:type="G_SQRT2">
@@ -40251,7 +40819,7 @@ if @a comes before @b, and a positive value if @b comes before @a.</doc>
4025140819 filename="glib/gmain.h"
4025240820 line="80">The `GSource` struct is an opaque data type
4025340821 representing an event source.</doc>
40254- <source-position filename="glib/gmain.h" line="289"/>
40822+ <source-position filename="glib/gmain.h" line="290"/>
4025540823 <field name="callback_data" readable="0" private="1">
4025640824 <type name="gpointer" c:type="gpointer"/>
4025740825 </field>
@@ -40296,33 +40864,35 @@ representing an event source.</doc>
4029640864 <constructor name="new" c:identifier="g_source_new">
4029740865 <doc xml:space="preserve"
4029840866 filename="glib/gmain.c"
40299- line="907">Creates a new [struct@GLib.Source] structure. The size is specified to
40867+ line="948">Creates a new [struct@GLib.Source] structure.
40868+
40869+The size is specified to
4030040870 allow creating structures derived from [struct@GLib.Source] that contain
4030140871 additional data. The size passed in must be at least
4030240872 `sizeof (GSource)`.
4030340873
40304-The source will not initially be associated with any #GMainContext
40874+The source will not initially be associated with any [struct@GLib.MainContext]
4030540875 and must be added to one with [method@GLib.Source.attach] before it will be
4030640876 executed.</doc>
40307- <source-position filename="glib/gmain.h" line="694"/>
40877+ <source-position filename="glib/gmain.h" line="695"/>
4030840878 <return-value transfer-ownership="full">
4030940879 <doc xml:space="preserve"
4031040880 filename="glib/gmain.c"
40311- line="922">the newly-created #GSource.</doc>
40881+ line="965">the newly-created source</doc>
4031240882 <type name="Source" c:type="GSource*"/>
4031340883 </return-value>
4031440884 <parameters>
4031540885 <parameter name="source_funcs" transfer-ownership="none">
4031640886 <doc xml:space="preserve"
4031740887 filename="glib/gmain.c"
40318- line="909">structure containing functions that implement
40319- the sources behavior.</doc>
40888+ line="950">structure containing functions that implement
40889+ the source‘s behavior</doc>
4032040890 <type name="SourceFuncs" c:type="GSourceFuncs*"/>
4032140891 </parameter>
4032240892 <parameter name="struct_size" transfer-ownership="none">
4032340893 <doc xml:space="preserve"
4032440894 filename="glib/gmain.c"
40325- line="911">size of the [struct@GLib.Source] structure to create.</doc>
40895+ line="952">size of the [struct@GLib.Source] structure to create, in bytes</doc>
4032640896 <type name="guint" c:type="guint"/>
4032740897 </parameter>
4032840898 </parameters>
@@ -40332,25 +40902,26 @@ executed.</doc>
4033240902 version="2.28">
4033340903 <doc xml:space="preserve"
4033440904 filename="glib/gmain.c"
40335- line="1514">Adds @child_source to @source as a "polled" source; when @source is
40336-added to a [struct@GLib.MainContext], @child_source will be automatically
40337-added with the same priority, when @child_source is triggered, it will
40338-cause @source to dispatch (in addition to calling its own
40339-callback), and when @source is destroyed, it will destroy
40340-@child_source as well. (@source will also still be dispatched if
40341-its own prepare/check functions indicate that it is ready.)
40342-
40343-If you don't need @child_source to do anything on its own when it
40344-triggers, you can call g_source_set_dummy_callback() on it to set a
40345-callback that does nothing (except return %TRUE if appropriate).
40346-
40347-@source will hold a reference on @child_source while @child_source
40905+ line="1624">Adds @child_source to @source as a ‘polled’ source.
40906+
40907+When @source is added to a [struct@GLib.MainContext], @child_source will be
40908+automatically added with the same priority. When @child_source is triggered,
40909+it will cause @source to dispatch (in addition to calling its own callback),
40910+and when @source is destroyed, it will destroy @child_source as well.
40911+
40912+The @source will also still be dispatched if its own prepare/check functions
40913+indicate that it is ready.
40914+
40915+If you don’t need @child_source to do anything on its own when it
40916+triggers, you can call `g_source_set_dummy_callback()` on it to set a
40917+callback that does nothing (except return true if appropriate).
40918+
40919+The @source will hold a reference on @child_source while @child_source
4034840920 is attached to it.
4034940921
40350-This API is only intended to be used by implementations of
40351-[struct@GLib.Source]. Do not call this API on a [struct@GLib.Source] that
40352-you did not create.</doc>
40353- <source-position filename="glib/gmain.h" line="791"/>
40922+This API is only intended to be used by implementations of [struct@GLib.Source].
40923+Do not call this API on a [struct@GLib.Source] that you did not create.</doc>
40924+ <source-position filename="glib/gmain.h" line="794"/>
4035440925 <return-value transfer-ownership="none">
4035540926 <type name="none" c:type="void"/>
4035640927 </return-value>
@@ -40358,13 +40929,13 @@ you did not create.</doc>
4035840929 <instance-parameter name="source" transfer-ownership="none">
4035940930 <doc xml:space="preserve"
4036040931 filename="glib/gmain.c"
40361- line="1516">a #GSource</doc>
40932+ line="1626">a source</doc>
4036240933 <type name="Source" c:type="GSource*"/>
4036340934 </instance-parameter>
4036440935 <parameter name="child_source" transfer-ownership="none">
4036540936 <doc xml:space="preserve"
4036640937 filename="glib/gmain.c"
40367- line="1517">a second #GSource that @source should "poll"</doc>
40938+ line="1627">a second source that @source should ‘poll’</doc>
4036840939 <type name="Source" c:type="GSource*"/>
4036940940 </parameter>
4037040941 </parameters>
@@ -40372,19 +40943,21 @@ you did not create.</doc>
4037240943 <method name="add_poll" c:identifier="g_source_add_poll">
4037340944 <doc xml:space="preserve"
4037440945 filename="glib/gmain.c"
40375- line="1432">Adds a file descriptor to the set of file descriptors polled for
40376-this source. This is usually combined with [ctor@GLib.Source.new] to add an
40377-event source. The event source's check function will typically test
40378-the @revents field in the #GPollFD struct and return %TRUE if events need
40379-to be processed.
40946+ line="1537">Adds a file descriptor to the set of file descriptors polled for
40947+this source.
40948+
40949+This is usually combined with [ctor@GLib.Source.new] to add an
40950+event source. The event source’s check function will typically test
40951+the @revents field in the [struct@GLib.PollFD] struct and return true if
40952+events need to be processed.
4038040953
4038140954 This API is only intended to be used by implementations of [struct@GLib.Source].
4038240955 Do not call this API on a [struct@GLib.Source] that you did not create.
4038340956
4038440957 Using this API forces the linear scanning of event sources on each
4038540958 main loop iteration. Newly-written event sources should try to use
40386-`g_source_add_unix_fd` instead of this API.</doc>
40387- <source-position filename="glib/gmain.h" line="784"/>
40959+`g_source_add_unix_fd()` instead of this API.</doc>
40960+ <source-position filename="glib/gmain.h" line="787"/>
4038840961 <return-value transfer-ownership="none">
4038940962 <type name="none" c:type="void"/>
4039040963 </return-value>
@@ -40392,14 +40965,14 @@ main loop iteration. Newly-written event sources should try to use
4039240965 <instance-parameter name="source" transfer-ownership="none">
4039340966 <doc xml:space="preserve"
4039440967 filename="glib/gmain.c"
40395- line="1434">a #GSource</doc>
40968+ line="1539">a source</doc>
4039640969 <type name="Source" c:type="GSource*"/>
4039740970 </instance-parameter>
4039840971 <parameter name="fd" transfer-ownership="none">
4039940972 <doc xml:space="preserve"
4040040973 filename="glib/gmain.c"
40401- line="1435">a #GPollFD structure holding information about a file
40402- descriptor to watch.</doc>
40974+ line="1540">a [struct@GLib.PollFD] structure holding information about a file
40975+ descriptor to watch</doc>
4040340976 <type name="PollFD" c:type="GPollFD*"/>
4040440977 </parameter>
4040540978 </parameters>
@@ -40409,43 +40982,43 @@ main loop iteration. Newly-written event sources should try to use
4040940982 version="2.36">
4041040983 <doc xml:space="preserve"
4041140984 filename="glib/gmain.c"
40412- line="2652">Monitors @fd for the IO events in @events.
40985+ line="2812">Monitors @fd for the IO events in @events.
4041340986
4041440987 The tag returned by this function can be used to remove or modify the
40415-monitoring of the fd using [method@GLib.Source.remove_unix_fd] or
40988+monitoring of the @fd using [method@GLib.Source.remove_unix_fd] or
4041640989 [method@GLib.Source.modify_unix_fd].
4041740990
40418-It is not necessary to remove the fd before destroying the source; it
40419-will be cleaned up automatically.
40991+It is not necessary to remove the file descriptor before destroying the
40992+source; it will be cleaned up automatically.
4042040993
40421-This API is only intended to be used by implementations of #GSource.
40422-Do not call this API on a #GSource that you did not create.
40994+This API is only intended to be used by implementations of [struct@GLib.Source].
40995+Do not call this API on a [struct@GLib.Source] that you did not create.
4042340996
4042440997 As the name suggests, this function is not available on Windows.</doc>
40425- <source-position filename="glib/gmain.h" line="762"/>
40998+ <source-position filename="glib/gmain.h" line="765"/>
4042640999 <return-value transfer-ownership="none">
4042741000 <doc xml:space="preserve"
4042841001 filename="glib/gmain.c"
40429- line="2672">an opaque tag</doc>
41002+ line="2832">an opaque tag</doc>
4043041003 <type name="gpointer" c:type="gpointer"/>
4043141004 </return-value>
4043241005 <parameters>
4043341006 <instance-parameter name="source" transfer-ownership="none">
4043441007 <doc xml:space="preserve"
4043541008 filename="glib/gmain.c"
40436- line="2654">a #GSource</doc>
41009+ line="2814">a source</doc>
4043741010 <type name="Source" c:type="GSource*"/>
4043841011 </instance-parameter>
4043941012 <parameter name="fd" transfer-ownership="none">
4044041013 <doc xml:space="preserve"
4044141014 filename="glib/gmain.c"
40442- line="2655">the fd to monitor</doc>
41015+ line="2815">the file descriptor to monitor</doc>
4044341016 <type name="gint" c:type="gint"/>
4044441017 </parameter>
4044541018 <parameter name="events" transfer-ownership="none">
4044641019 <doc xml:space="preserve"
4044741020 filename="glib/gmain.c"
40448- line="2656">an event mask</doc>
41021+ line="2816">an event mask</doc>
4044941022 <type name="IOCondition" c:type="GIOCondition"/>
4045041023 </parameter>
4045141024 </parameters>
@@ -40453,24 +41026,26 @@ As the name suggests, this function is not available on Windows.</doc>
4045341026 <method name="attach" c:identifier="g_source_attach">
4045441027 <doc xml:space="preserve"
4045541028 filename="glib/gmain.c"
40456- line="1237">Adds a [struct@GLib.Source] to a @context so that it will be executed within
40457-that context. Remove it by calling [method@GLib.Source.destroy].
41029+ line="1283">Adds a [struct@GLib.Source] to a @context so that it will be executed within
41030+that context.
41031+
41032+Remove it by calling [method@GLib.Source.destroy].
4045841033
4045941034 This function is safe to call from any thread, regardless of which thread
4046041035 the @context is running in.</doc>
40461- <source-position filename="glib/gmain.h" line="709"/>
41036+ <source-position filename="glib/gmain.h" line="710"/>
4046241037 <return-value transfer-ownership="none">
4046341038 <doc xml:space="preserve"
4046441039 filename="glib/gmain.c"
40465- line="1249">the ID (greater than 0) for the source within the
40466- #GMainContext.</doc>
41040+ line="1297">the ID (greater than 0) for the source within the
41041+ [struct@GLib.MainContext]</doc>
4046741042 <type name="guint" c:type="guint"/>
4046841043 </return-value>
4046941044 <parameters>
4047041045 <instance-parameter name="source" transfer-ownership="none">
4047141046 <doc xml:space="preserve"
4047241047 filename="glib/gmain.c"
40473- line="1239">a #GSource</doc>
41048+ line="1285">a source</doc>
4047441049 <type name="Source" c:type="GSource*"/>
4047541050 </instance-parameter>
4047641051 <parameter name="context"
@@ -40479,7 +41054,7 @@ the @context is running in.</doc>
4047941054 allow-none="1">
4048041055 <doc xml:space="preserve"
4048141056 filename="glib/gmain.c"
40482- line="1240">a #GMainContext (if %NULL, the global-default
41057+ line="1286">a main context (if `NULL`, the global-default
4048341058 main context will be used)</doc>
4048441059 <type name="MainContext" c:type="GMainContext*"/>
4048541060 </parameter>
@@ -40488,8 +41063,10 @@ the @context is running in.</doc>
4048841063 <method name="destroy" c:identifier="g_source_destroy">
4048941064 <doc xml:space="preserve"
4049041065 filename="glib/gmain.c"
40491- line="1336">Removes a source from its [struct@GLib.MainContext], if any, and mark it as
40492-destroyed. The source cannot be subsequently added to another
41066+ line="1400">Removes a source from its [struct@GLib.MainContext], if any, and marks it as
41067+destroyed.
41068+
41069+The source cannot be subsequently added to another
4049341070 context. It is safe to call this on sources which have already been
4049441071 removed from their context.
4049541072
@@ -40501,9 +41078,9 @@ the [struct@GLib.MainContext] is running in.
4050141078
4050241079 If the source is currently attached to a [struct@GLib.MainContext],
4050341080 destroying it will effectively unset the callback similar to calling
40504-[method@GLib.Source.set_callback]. This can mean, that the data's
40505-#GDestroyNotify gets called right away.</doc>
40506- <source-position filename="glib/gmain.h" line="712"/>
41081+[method@GLib.Source.set_callback]. This can mean, that the data’s
41082+[callback@GLib.DestroyNotify] gets called right away.</doc>
41083+ <source-position filename="glib/gmain.h" line="713"/>
4050741084 <return-value transfer-ownership="none">
4050841085 <type name="none" c:type="void"/>
4050941086 </return-value>
@@ -40511,7 +41088,36 @@ destroying it will effectively unset the callback similar to calling
4051141088 <instance-parameter name="source" transfer-ownership="none">
4051241089 <doc xml:space="preserve"
4051341090 filename="glib/gmain.c"
40514- line="1338">a #GSource</doc>
41091+ line="1402">a source</doc>
41092+ <type name="Source" c:type="GSource*"/>
41093+ </instance-parameter>
41094+ </parameters>
41095+ </method>
41096+ <method name="dup_context"
41097+ c:identifier="g_source_dup_context"
41098+ version="2.86">
41099+ <doc xml:space="preserve"
41100+ filename="glib/gmain.c"
41101+ line="1511">Gets a reference to the [struct@GLib.MainContext] with which the source is
41102+associated.
41103+
41104+You can call this on a source that has been destroyed. You can
41105+always call this function on the source returned from
41106+[func@GLib.main_current_source].</doc>
41107+ <source-position filename="glib/gmain.h" line="731"/>
41108+ <return-value transfer-ownership="full" nullable="1">
41109+ <doc xml:space="preserve"
41110+ filename="glib/gmain.c"
41111+ line="1522">the [struct@GLib.MainContext] with which
41112+ the source is associated, or `NULL` if the context has not yet been added
41113+ to a source</doc>
41114+ <type name="MainContext" c:type="GMainContext*"/>
41115+ </return-value>
41116+ <parameters>
41117+ <instance-parameter name="source" transfer-ownership="none">
41118+ <doc xml:space="preserve"
41119+ filename="glib/gmain.c"
41120+ line="1513">a source</doc>
4051541121 <type name="Source" c:type="GSource*"/>
4051641122 </instance-parameter>
4051741123 </parameters>
@@ -40519,20 +41125,21 @@ destroying it will effectively unset the callback similar to calling
4051941125 <method name="get_can_recurse" c:identifier="g_source_get_can_recurse">
4052041126 <doc xml:space="preserve"
4052141127 filename="glib/gmain.c"
40522- line="2025">Checks whether a source is allowed to be called recursively.
40523-see [method@GLib.Source.set_can_recurse].</doc>
40524- <source-position filename="glib/gmain.h" line="723"/>
41128+ line="2161">Checks whether a source is allowed to be called recursively.
41129+
41130+See [method@GLib.Source.set_can_recurse].</doc>
41131+ <source-position filename="glib/gmain.h" line="724"/>
4052541132 <return-value transfer-ownership="none">
4052641133 <doc xml:space="preserve"
4052741134 filename="glib/gmain.c"
40528- line="2032">whether recursion is allowed.</doc>
41135+ line="2169">whether recursion is allowed</doc>
4052941136 <type name="gboolean" c:type="gboolean"/>
4053041137 </return-value>
4053141138 <parameters>
4053241139 <instance-parameter name="source" transfer-ownership="none">
4053341140 <doc xml:space="preserve"
4053441141 filename="glib/gmain.c"
40535- line="2027">a #GSource</doc>
41142+ line="2163">a source</doc>
4053641143 <type name="Source" c:type="GSource*"/>
4053741144 </instance-parameter>
4053841145 </parameters>
@@ -40540,28 +41147,32 @@ see [method@GLib.Source.set_can_recurse].</doc>
4054041147 <method name="get_context" c:identifier="g_source_get_context">
4054141148 <doc xml:space="preserve"
4054241149 filename="glib/gmain.c"
40543- line="1405">Gets the [struct@GLib.MainContext] with which the source is associated.
41150+ line="1480">Gets the [struct@GLib.MainContext] with which the source is associated.
4054441151
4054541152 You can call this on a source that has been destroyed, provided
4054641153 that the [struct@GLib.MainContext] it was attached to still exists (in which
4054741154 case it will return that [struct@GLib.MainContext]). In particular, you can
4054841155 always call this function on the source returned from
4054941156 [func@GLib.main_current_source]. But calling this function on a source
40550-whose [struct@GLib.MainContext] has been destroyed is an error.</doc>
40551- <source-position filename="glib/gmain.h" line="728"/>
41157+whose [struct@GLib.MainContext] has been destroyed is an error.
41158+
41159+If the associated [struct@GLib.MainContext] could be destroy concurrently from
41160+a different thread, then this function is not safe to call and
41161+[method@GLib.Source.dup_context] should be used instead.</doc>
41162+ <source-position filename="glib/gmain.h" line="729"/>
4055241163 <return-value transfer-ownership="none" nullable="1">
4055341164 <doc xml:space="preserve"
4055441165 filename="glib/gmain.c"
40555- line="1418">the #GMainContext with which the
40556- source is associated, or %NULL if the context has not
40557- yet been added to a source.</doc>
41166+ line="1497">the main context with which the
41167+ source is associated, or `NULL` if the context has not yet been added to a
41168+ source</doc>
4055841169 <type name="MainContext" c:type="GMainContext*"/>
4055941170 </return-value>
4056041171 <parameters>
4056141172 <instance-parameter name="source" transfer-ownership="none">
4056241173 <doc xml:space="preserve"
4056341174 filename="glib/gmain.c"
40564- line="1407">a #GSource</doc>
41175+ line="1482">a source</doc>
4056541176 <type name="Source" c:type="GSource*"/>
4056641177 </instance-parameter>
4056741178 </parameters>
@@ -40572,10 +41183,10 @@ whose [struct@GLib.MainContext] has been destroyed is an error.</doc>
4057241183 deprecated-version="2.28">
4057341184 <doc xml:space="preserve"
4057441185 filename="glib/gmain.c"
40575- line="4837">This function ignores @source and is otherwise the same as
41186+ line="5018">This function ignores @source and is otherwise the same as
4057641187 [func@GLib.get_current_time].</doc>
4057741188 <doc-deprecated xml:space="preserve">use [method@GLib.Source.get_time] instead</doc-deprecated>
40578- <source-position filename="glib/gmain.h" line="799"/>
41189+ <source-position filename="glib/gmain.h" line="802"/>
4057941190 <return-value transfer-ownership="none">
4058041191 <type name="none" c:type="void"/>
4058141192 </return-value>
@@ -40583,13 +41194,13 @@ whose [struct@GLib.MainContext] has been destroyed is an error.</doc>
4058341194 <instance-parameter name="source" transfer-ownership="none">
4058441195 <doc xml:space="preserve"
4058541196 filename="glib/gmain.c"
40586- line="4839">a #GSource</doc>
41197+ line="5020">a source</doc>
4058741198 <type name="Source" c:type="GSource*"/>
4058841199 </instance-parameter>
4058941200 <parameter name="timeval" transfer-ownership="none">
4059041201 <doc xml:space="preserve"
4059141202 filename="glib/gmain.c"
40592- line="4840">#GTimeVal structure in which to store current time.</doc>
41203+ line="5021">[struct@GLib.TimeVal] structure in which to store current time</doc>
4059341204 <type name="TimeVal" c:type="GTimeVal*"/>
4059441205 </parameter>
4059541206 </parameters>
@@ -40597,7 +41208,9 @@ whose [struct@GLib.MainContext] has been destroyed is an error.</doc>
4059741208 <method name="get_id" c:identifier="g_source_get_id">
4059841209 <doc xml:space="preserve"
4059941210 filename="glib/gmain.c"
40600- line="1372">Returns the numeric ID for a particular source. The ID of a source
41211+ line="1441">Returns the numeric ID for a particular source.
41212+
41213+The ID of a source
4060141214 is a positive integer which is unique within a particular main loop
4060241215 context. The reverse mapping from ID to source is done by
4060341216 [method@GLib.MainContext.find_source_by_id].
@@ -40607,18 +41220,18 @@ You can only call this function while the source is associated to a
4060741220 [method@GLib.Source.attach] or after [method@GLib.Source.destroy] yields
4060841221 undefined behavior. The ID returned is unique within the
4060941222 [struct@GLib.MainContext] instance passed to [method@GLib.Source.attach].</doc>
40610- <source-position filename="glib/gmain.h" line="725"/>
41223+ <source-position filename="glib/gmain.h" line="726"/>
4061141224 <return-value transfer-ownership="none">
4061241225 <doc xml:space="preserve"
4061341226 filename="glib/gmain.c"
40614- line="1387">the ID (greater than 0) for the source</doc>
41227+ line="1458">the ID (greater than 0) for the source</doc>
4061541228 <type name="guint" c:type="guint"/>
4061641229 </return-value>
4061741230 <parameters>
4061841231 <instance-parameter name="source" transfer-ownership="none">
4061941232 <doc xml:space="preserve"
4062041233 filename="glib/gmain.c"
40621- line="1374">a #GSource</doc>
41234+ line="1443">a source</doc>
4062241235 <type name="Source" c:type="GSource*"/>
4062341236 </instance-parameter>
4062441237 </parameters>
@@ -40626,20 +41239,22 @@ undefined behavior. The ID returned is unique within the
4062641239 <method name="get_name" c:identifier="g_source_get_name" version="2.26">
4062741240 <doc xml:space="preserve"
4062841241 filename="glib/gmain.c"
40629- line="2130">Gets a name for the source, used in debugging and profiling. The
40630-name may be #NULL if it has never been set with [method@GLib.Source.set_name].</doc>
40631- <source-position filename="glib/gmain.h" line="749"/>
41242+ line="2272">Gets a name for the source, used in debugging and profiling.
41243+
41244+The
41245+name may be `NULL` if it has never been set with [method@GLib.Source.set_name].</doc>
41246+ <source-position filename="glib/gmain.h" line="752"/>
4063241247 <return-value transfer-ownership="none" nullable="1">
4063341248 <doc xml:space="preserve"
4063441249 filename="glib/gmain.c"
40635- line="2137">the name of the source</doc>
41250+ line="2281">the name of the source</doc>
4063641251 <type name="utf8" c:type="const char*"/>
4063741252 </return-value>
4063841253 <parameters>
4063941254 <instance-parameter name="source" transfer-ownership="none">
4064041255 <doc xml:space="preserve"
4064141256 filename="glib/gmain.c"
40642- line="2132">a #GSource</doc>
41257+ line="2274">a source</doc>
4064341258 <type name="Source" c:type="GSource*"/>
4064441259 </instance-parameter>
4064541260 </parameters>
@@ -40647,19 +41262,19 @@ name may be #NULL if it has never been set with [method@GLib.Source.set_name].</
4064741262 <method name="get_priority" c:identifier="g_source_get_priority">
4064841263 <doc xml:space="preserve"
4064941264 filename="glib/gmain.c"
40650- line="1888">Gets the priority of a source.</doc>
40651- <source-position filename="glib/gmain.h" line="718"/>
41265+ line="2015">Gets the priority of a source.</doc>
41266+ <source-position filename="glib/gmain.h" line="719"/>
4065241267 <return-value transfer-ownership="none">
4065341268 <doc xml:space="preserve"
4065441269 filename="glib/gmain.c"
40655- line="1894">the priority of the source</doc>
41270+ line="2021">the priority of the source</doc>
4065641271 <type name="gint" c:type="gint"/>
4065741272 </return-value>
4065841273 <parameters>
4065941274 <instance-parameter name="source" transfer-ownership="none">
4066041275 <doc xml:space="preserve"
4066141276 filename="glib/gmain.c"
40662- line="1890">a #GSource</doc>
41277+ line="2017">a source</doc>
4066341278 <type name="Source" c:type="GSource*"/>
4066441279 </instance-parameter>
4066541280 </parameters>
@@ -40667,23 +41282,23 @@ name may be #NULL if it has never been set with [method@GLib.Source.set_name].</
4066741282 <method name="get_ready_time" c:identifier="g_source_get_ready_time">
4066841283 <doc xml:space="preserve"
4066941284 filename="glib/gmain.c"
40670- line="1971">Gets the "ready time" of @source, as set by
41285+ line="2103">Gets the ‘ready time’ of @source, as set by
4067141286 [method@GLib.Source.set_ready_time].
4067241287
40673-Any time before or equal to the current monotonic time (including 0)
41288+Any time before or equal to the current monotonic time (including zero)
4067441289 is an indication that the source will fire immediately.</doc>
40675- <source-position filename="glib/gmain.h" line="758"/>
41290+ <source-position filename="glib/gmain.h" line="761"/>
4067641291 <return-value transfer-ownership="none">
4067741292 <doc xml:space="preserve"
4067841293 filename="glib/gmain.c"
40679- line="1981">the monotonic ready time, -1 for "never"</doc>
41294+ line="2113">the monotonic ready time, `-1` for ‘never’</doc>
4068041295 <type name="gint64" c:type="gint64"/>
4068141296 </return-value>
4068241297 <parameters>
4068341298 <instance-parameter name="source" transfer-ownership="none">
4068441299 <doc xml:space="preserve"
4068541300 filename="glib/gmain.c"
40686- line="1973">a #GSource</doc>
41301+ line="2105">a source</doc>
4068741302 <type name="Source" c:type="GSource*"/>
4068841303 </instance-parameter>
4068941304 </parameters>
@@ -40691,25 +41306,27 @@ is an indication that the source will fire immediately.</doc>
4069141306 <method name="get_time" c:identifier="g_source_get_time" version="2.28">
4069241307 <doc xml:space="preserve"
4069341308 filename="glib/gmain.c"
40694- line="4856">Gets the time to be used when checking this source. The advantage of
41309+ line="5037">Gets the time to be used when checking this source.
41310+
41311+The advantage of
4069541312 calling this function over calling [func@GLib.get_monotonic_time] directly is
4069641313 that when checking multiple sources, GLib can cache a single value
4069741314 instead of having to repeatedly get the system monotonic time.
4069841315
4069941316 The time here is the system monotonic time, if available, or some
4070041317 other reasonable alternative otherwise. See [func@GLib.get_monotonic_time].</doc>
40701- <source-position filename="glib/gmain.h" line="804"/>
41318+ <source-position filename="glib/gmain.h" line="807"/>
4070241319 <return-value transfer-ownership="none">
4070341320 <doc xml:space="preserve"
4070441321 filename="glib/gmain.c"
40705- line="4868">the monotonic time in microseconds</doc>
41322+ line="5051">the monotonic time in microseconds</doc>
4070641323 <type name="gint64" c:type="gint64"/>
4070741324 </return-value>
4070841325 <parameters>
4070941326 <instance-parameter name="source" transfer-ownership="none">
4071041327 <doc xml:space="preserve"
4071141328 filename="glib/gmain.c"
40712- line="4858">a #GSource</doc>
41329+ line="5039">a source</doc>
4071341330 <type name="Source" c:type="GSource*"/>
4071441331 </instance-parameter>
4071541332 </parameters>
@@ -40719,13 +41336,13 @@ other reasonable alternative otherwise. See [func@GLib.get_monotonic_time].</do
4071941336 version="2.12">
4072041337 <doc xml:space="preserve"
4072141338 filename="glib/gmain.c"
40722- line="3172">Returns whether @source has been destroyed.
41339+ line="3338">Returns whether @source has been destroyed.
4072341340
4072441341 This is important when you operate upon your objects
4072541342 from within idle handlers, but may have freed the object
4072641343 before the dispatch of your idle handler.
4072741344
40728-|[&lt;!-- language="C" --&gt;
41345+```c
4072941346 static gboolean
4073041347 idle_callback (gpointer data)
4073141348 {
@@ -40767,7 +41384,7 @@ some_widget_finalize (GObject *object)
4076741384
4076841385 G_OBJECT_CLASS (parent_class)-&gt;finalize (object);
4076941386 }
40770-]|
41387+```
4077141388
4077241389 This will fail in a multi-threaded application if the
4077341390 widget is destroyed before the idle handler fires due
@@ -40775,7 +41392,7 @@ to the use after free in the callback. A solution, to
4077541392 this particular problem, is to check to if the source
4077641393 has already been destroy within the callback.
4077741394
40778-|[&lt;!-- language="C" --&gt;
41395+```c
4077941396 static gboolean
4078041397 idle_callback (gpointer data)
4078141398 {
@@ -40790,25 +41407,25 @@ idle_callback (gpointer data)
4079041407
4079141408 return FALSE;
4079241409 }
40793-]|
41410+```
4079441411
4079541412 Calls to this function from a thread other than the one acquired by the
40796-[struct@GLib.MainContext] the #GSource is attached to are typically
41413+[struct@GLib.MainContext] the [struct@GLib.Source] is attached to are typically
4079741414 redundant, as the source could be destroyed immediately after this function
4079841415 returns. However, once a source is destroyed it cannot be un-destroyed, so
4079941416 this function can be used for opportunistic checks from any thread.</doc>
40800- <source-position filename="glib/gmain.h" line="740"/>
41417+ <source-position filename="glib/gmain.h" line="743"/>
4080141418 <return-value transfer-ownership="none">
4080241419 <doc xml:space="preserve"
4080341420 filename="glib/gmain.c"
40804- line="3255">%TRUE if the source has been destroyed</doc>
41421+ line="3421">true if the source has been destroyed, false otherwise</doc>
4080541422 <type name="gboolean" c:type="gboolean"/>
4080641423 </return-value>
4080741424 <parameters>
4080841425 <instance-parameter name="source" transfer-ownership="none">
4080941426 <doc xml:space="preserve"
4081041427 filename="glib/gmain.c"
40811- line="3174">a #GSource</doc>
41428+ line="3340">a source</doc>
4081241429 <type name="Source" c:type="GSource*"/>
4081341430 </instance-parameter>
4081441431 </parameters>
@@ -40818,18 +41435,18 @@ this function can be used for opportunistic checks from any thread.</doc>
4081841435 version="2.36">
4081941436 <doc xml:space="preserve"
4082041437 filename="glib/gmain.c"
40821- line="2710">Updates the event mask to watch for the fd identified by @tag.
41438+ line="2870">Updates the event mask to watch for the file descriptor identified by @tag.
4082241439
40823-@tag is the tag returned from [method@GLib.Source.add_unix_fd].
41440+The @tag is the tag returned from [method@GLib.Source.add_unix_fd].
4082441441
40825-If you want to remove a fd, don't set its event mask to zero.
41442+If you want to remove a file descriptor, don’t set its event mask to zero.
4082641443 Instead, call [method@GLib.Source.remove_unix_fd].
4082741444
40828-This API is only intended to be used by implementations of #GSource.
40829-Do not call this API on a #GSource that you did not create.
41445+This API is only intended to be used by implementations of [struct@GLib.Source].
41446+Do not call this API on a [struct@GLib.Source] that you did not create.
4083041447
4083141448 As the name suggests, this function is not available on Windows.</doc>
40832- <source-position filename="glib/gmain.h" line="766"/>
41449+ <source-position filename="glib/gmain.h" line="769"/>
4083341450 <return-value transfer-ownership="none">
4083441451 <type name="none" c:type="void"/>
4083541452 </return-value>
@@ -40837,19 +41454,19 @@ As the name suggests, this function is not available on Windows.</doc>
4083741454 <instance-parameter name="source" transfer-ownership="none">
4083841455 <doc xml:space="preserve"
4083941456 filename="glib/gmain.c"
40840- line="2712">a #GSource</doc>
41457+ line="2872">a source</doc>
4084141458 <type name="Source" c:type="GSource*"/>
4084241459 </instance-parameter>
4084341460 <parameter name="tag" transfer-ownership="none">
4084441461 <doc xml:space="preserve"
4084541462 filename="glib/gmain.c"
40846- line="2713">the tag from [method@GLib.Source.add_unix_fd]</doc>
41463+ line="2873">the tag from [method@GLib.Source.add_unix_fd]</doc>
4084741464 <type name="gpointer" c:type="gpointer"/>
4084841465 </parameter>
4084941466 <parameter name="new_events" transfer-ownership="none">
4085041467 <doc xml:space="preserve"
4085141468 filename="glib/gmain.c"
40852- line="2714">the new event mask to watch</doc>
41469+ line="2874">the new event mask to watch</doc>
4085341470 <type name="IOCondition" c:type="GIOCondition"/>
4085441471 </parameter>
4085541472 </parameters>
@@ -40859,34 +41476,34 @@ As the name suggests, this function is not available on Windows.</doc>
4085941476 version="2.36">
4086041477 <doc xml:space="preserve"
4086141478 filename="glib/gmain.c"
40862- line="2799">Queries the events reported for the fd corresponding to @tag on
40863-@source during the last poll.
41479+ line="2963">Queries the events reported for the file descriptor corresponding to @tag
41480+on @source during the last poll.
4086441481
4086541482 The return value of this function is only defined when the function
4086641483 is called from the check or dispatch functions for @source.
4086741484
40868-This API is only intended to be used by implementations of #GSource.
40869-Do not call this API on a #GSource that you did not create.
41485+This API is only intended to be used by implementations of [struct@GLib.Source].
41486+Do not call this API on a [struct@GLib.Source] that you did not create.
4087041487
4087141488 As the name suggests, this function is not available on Windows.</doc>
40872- <source-position filename="glib/gmain.h" line="773"/>
41489+ <source-position filename="glib/gmain.h" line="776"/>
4087341490 <return-value transfer-ownership="none">
4087441491 <doc xml:space="preserve"
4087541492 filename="glib/gmain.c"
40876- line="2815">the conditions reported on the fd</doc>
41493+ line="2979">the conditions reported on the file descriptor</doc>
4087741494 <type name="IOCondition" c:type="GIOCondition"/>
4087841495 </return-value>
4087941496 <parameters>
4088041497 <instance-parameter name="source" transfer-ownership="none">
4088141498 <doc xml:space="preserve"
4088241499 filename="glib/gmain.c"
40883- line="2801">a #GSource</doc>
41500+ line="2965">a source</doc>
4088441501 <type name="Source" c:type="GSource*"/>
4088541502 </instance-parameter>
4088641503 <parameter name="tag" transfer-ownership="none">
4088741504 <doc xml:space="preserve"
4088841505 filename="glib/gmain.c"
40889- line="2802">the tag from [method@GLib.Source.add_unix_fd]</doc>
41506+ line="2966">the tag from [method@GLib.Source.add_unix_fd]</doc>
4089041507 <type name="gpointer" c:type="gpointer"/>
4089141508 </parameter>
4089241509 </parameters>
@@ -40894,19 +41511,19 @@ As the name suggests, this function is not available on Windows.</doc>
4089441511 <method name="ref" c:identifier="g_source_ref">
4089541512 <doc xml:space="preserve"
4089641513 filename="glib/gmain.c"
40897- line="2190">Increases the reference count on a source by one.</doc>
40898- <source-position filename="glib/gmain.h" line="704"/>
41514+ line="2333">Increases the reference count on a source by one.</doc>
41515+ <source-position filename="glib/gmain.h" line="705"/>
4089941516 <return-value transfer-ownership="full">
4090041517 <doc xml:space="preserve"
4090141518 filename="glib/gmain.c"
40902- line="2196">@source</doc>
41519+ line="2339">@source</doc>
4090341520 <type name="Source" c:type="GSource*"/>
4090441521 </return-value>
4090541522 <parameters>
4090641523 <instance-parameter name="source" transfer-ownership="none">
4090741524 <doc xml:space="preserve"
4090841525 filename="glib/gmain.c"
40909- line="2192">a #GSource</doc>
41526+ line="2335">a source</doc>
4091041527 <type name="Source" c:type="GSource*"/>
4091141528 </instance-parameter>
4091241529 </parameters>
@@ -40916,11 +41533,11 @@ As the name suggests, this function is not available on Windows.</doc>
4091641533 version="2.28">
4091741534 <doc xml:space="preserve"
4091841535 filename="glib/gmain.c"
40919- line="1590">Detaches @child_source from @source and destroys it.
41536+ line="1702">Detaches @child_source from @source and destroys it.
4092041537
40921-This API is only intended to be used by implementations of #GSource.
40922-Do not call this API on a #GSource that you did not create.</doc>
40923- <source-position filename="glib/gmain.h" line="794"/>
41538+This API is only intended to be used by implementations of [struct@GLib.Source].
41539+Do not call this API on a [struct@GLib.Source] that you did not create.</doc>
41540+ <source-position filename="glib/gmain.h" line="797"/>
4092441541 <return-value transfer-ownership="none">
4092541542 <type name="none" c:type="void"/>
4092641543 </return-value>
@@ -40928,14 +41545,14 @@ Do not call this API on a #GSource that you did not create.</doc>
4092841545 <instance-parameter name="source" transfer-ownership="none">
4092941546 <doc xml:space="preserve"
4093041547 filename="glib/gmain.c"
40931- line="1592">a #GSource</doc>
41548+ line="1704">a source</doc>
4093241549 <type name="Source" c:type="GSource*"/>
4093341550 </instance-parameter>
4093441551 <parameter name="child_source" transfer-ownership="none">
4093541552 <doc xml:space="preserve"
4093641553 filename="glib/gmain.c"
40937- line="1593">a #GSource previously passed to
40938- [method@GLib.Source.add_child_source].</doc>
41554+ line="1705">a source previously passed to
41555+ [method@GLib.Source.add_child_source]</doc>
4093941556 <type name="Source" c:type="GSource*"/>
4094041557 </parameter>
4094141558 </parameters>
@@ -40943,12 +41560,12 @@ Do not call this API on a #GSource that you did not create.</doc>
4094341560 <method name="remove_poll" c:identifier="g_source_remove_poll">
4094441561 <doc xml:space="preserve"
4094541562 filename="glib/gmain.c"
40946- line="1477">Removes a file descriptor from the set of file descriptors polled for
41563+ line="1585">Removes a file descriptor from the set of file descriptors polled for
4094741564 this source.
4094841565
4094941566 This API is only intended to be used by implementations of [struct@GLib.Source].
4095041567 Do not call this API on a [struct@GLib.Source] that you did not create.</doc>
40951- <source-position filename="glib/gmain.h" line="787"/>
41568+ <source-position filename="glib/gmain.h" line="790"/>
4095241569 <return-value transfer-ownership="none">
4095341570 <type name="none" c:type="void"/>
4095441571 </return-value>
@@ -40956,13 +41573,14 @@ Do not call this API on a [struct@GLib.Source] that you did not create.</doc>
4095641573 <instance-parameter name="source" transfer-ownership="none">
4095741574 <doc xml:space="preserve"
4095841575 filename="glib/gmain.c"
40959- line="1479">a #GSource</doc>
41576+ line="1587">a source</doc>
4096041577 <type name="Source" c:type="GSource*"/>
4096141578 </instance-parameter>
4096241579 <parameter name="fd" transfer-ownership="none">
4096341580 <doc xml:space="preserve"
4096441581 filename="glib/gmain.c"
40965- line="1480">a #GPollFD structure previously passed to [method@GLib.Source.add_poll].</doc>
41582+ line="1588">a [struct@GLib.PollFD] structure previously passed to
41583+ [method@GLib.Source.add_poll]</doc>
4096641584 <type name="PollFD" c:type="GPollFD*"/>
4096741585 </parameter>
4096841586 </parameters>
@@ -40972,17 +41590,17 @@ Do not call this API on a [struct@GLib.Source] that you did not create.</doc>
4097241590 version="2.36">
4097341591 <doc xml:space="preserve"
4097441592 filename="glib/gmain.c"
40975- line="2751">Reverses the effect of a previous call to [method@GLib.Source.add_unix_fd].
41593+ line="2914">Reverses the effect of a previous call to [method@GLib.Source.add_unix_fd].
4097641594
40977-You only need to call this if you want to remove an fd from being
41595+You only need to call this if you want to remove a file descriptor from being
4097841596 watched while keeping the same source around. In the normal case you
4097941597 will just want to destroy the source.
4098041598
40981-This API is only intended to be used by implementations of #GSource.
40982-Do not call this API on a #GSource that you did not create.
41599+This API is only intended to be used by implementations of [struct@GLib.Source].
41600+Do not call this API on a [struct@GLib.Source] that you did not create.
4098341601
4098441602 As the name suggests, this function is not available on Windows.</doc>
40985- <source-position filename="glib/gmain.h" line="770"/>
41603+ <source-position filename="glib/gmain.h" line="773"/>
4098641604 <return-value transfer-ownership="none">
4098741605 <type name="none" c:type="void"/>
4098841606 </return-value>
@@ -40990,13 +41608,13 @@ As the name suggests, this function is not available on Windows.</doc>
4099041608 <instance-parameter name="source" transfer-ownership="none">
4099141609 <doc xml:space="preserve"
4099241610 filename="glib/gmain.c"
40993- line="2753">a #GSource</doc>
41611+ line="2916">a source</doc>
4099441612 <type name="Source" c:type="GSource*"/>
4099541613 </instance-parameter>
4099641614 <parameter name="tag" transfer-ownership="none">
4099741615 <doc xml:space="preserve"
4099841616 filename="glib/gmain.c"
40999- line="2754">the tag from [method@GLib.Source.add_unix_fd]</doc>
41617+ line="2917">the tag from [method@GLib.Source.add_unix_fd]</doc>
4100041618 <type name="gpointer" c:type="gpointer"/>
4100141619 </parameter>
4100241620 </parameters>
@@ -41004,18 +41622,18 @@ As the name suggests, this function is not available on Windows.</doc>
4100441622 <method name="set_callback" c:identifier="g_source_set_callback">
4100541623 <doc xml:space="preserve"
4100641624 filename="glib/gmain.c"
41007- line="1724">Sets the callback function for a source. The callback for a source is
41008-called from the source's dispatch function.
41625+ line="1844">Sets the callback function for a source. The callback for a source is
41626+called from the source’s dispatch function.
4100941627
4101041628 The exact type of @func depends on the type of source; ie. you
4101141629 should not count on @func being called with @data as its first
4101241630 parameter. Cast @func with [func@GLib.SOURCE_FUNC] to avoid warnings about
4101341631 incompatible function types.
4101441632
41015-See [mainloop memory management](main-loop.html#memory-management-of-sources) for details
41633+See [main loop memory management](main-loop.html#memory-management-of-sources) for details
4101641634 on how to handle memory management of @data.
4101741635
41018-Typically, you won't use this function. Instead use functions specific
41636+Typically, you won’t use this function. Instead use functions specific
4101941637 to the type of source you are using, such as [func@GLib.idle_add] or
4102041638 [func@GLib.timeout_add].
4102141639
@@ -41025,7 +41643,7 @@ the source is dispatched after this call returns.
4102541643
4102641644 Note that [method@GLib.Source.destroy] for a currently attached source has the effect
4102741645 of also unsetting the callback.</doc>
41028- <source-position filename="glib/gmain.h" line="731"/>
41646+ <source-position filename="glib/gmain.h" line="734"/>
4102941647 <return-value transfer-ownership="none">
4103041648 <type name="none" c:type="void"/>
4103141649 </return-value>
@@ -41033,7 +41651,7 @@ of also unsetting the callback.</doc>
4103341651 <instance-parameter name="source" transfer-ownership="none">
4103441652 <doc xml:space="preserve"
4103541653 filename="glib/gmain.c"
41036- line="1726">the source</doc>
41654+ line="1846">the source</doc>
4103741655 <type name="Source" c:type="GSource*"/>
4103841656 </instance-parameter>
4103941657 <parameter name="func"
@@ -41043,7 +41661,7 @@ of also unsetting the callback.</doc>
4104341661 destroy="2">
4104441662 <doc xml:space="preserve"
4104541663 filename="glib/gmain.c"
41046- line="1727">a callback function</doc>
41664+ line="1847">a callback function</doc>
4104741665 <type name="SourceFunc" c:type="GSourceFunc"/>
4104841666 </parameter>
4104941667 <parameter name="data"
@@ -41052,7 +41670,7 @@ of also unsetting the callback.</doc>
4105241670 allow-none="1">
4105341671 <doc xml:space="preserve"
4105441672 filename="glib/gmain.c"
41055- line="1728">the data to pass to callback function</doc>
41673+ line="1848">the data to pass to callback function</doc>
4105641674 <type name="gpointer" c:type="gpointer"/>
4105741675 </parameter>
4105841676 <parameter name="notify"
@@ -41062,7 +41680,7 @@ of also unsetting the callback.</doc>
4106241680 scope="async">
4106341681 <doc xml:space="preserve"
4106441682 filename="glib/gmain.c"
41065- line="1729">a function to call when @data is no longer in use, or %NULL.</doc>
41683+ line="1849">a function to call when @data is no longer in use</doc>
4106641684 <type name="DestroyNotify" c:type="GDestroyNotify"/>
4106741685 </parameter>
4106841686 </parameters>
@@ -41071,17 +41689,19 @@ of also unsetting the callback.</doc>
4107141689 c:identifier="g_source_set_callback_indirect">
4107241690 <doc xml:space="preserve"
4107341691 filename="glib/gmain.c"
41074- line="1667">Sets the callback function storing the data as a refcounted callback
41075-"object". This is used internally. Note that calling
41692+ line="1782">Sets the callback function storing the data as a reference counted callback
41693+‘object’.
41694+
41695+This is used internally. Note that calling
4107641696 [method@GLib.Source.set_callback_indirect] assumes
4107741697 an initial reference count on @callback_data, and thus
41078-@callback_funcs-&gt;unref will eventually be called once more
41079-than @callback_funcs-&gt;ref.
41698+`callback_funcs-&gt;unref` will eventually be called once more than
41699+`callback_funcs-&gt;ref`.
4108041700
4108141701 It is safe to call this function multiple times on a source which has already
4108241702 been attached to a context. The changes will take effect for the next time
4108341703 the source is dispatched after this call returns.</doc>
41084- <source-position filename="glib/gmain.h" line="779"/>
41704+ <source-position filename="glib/gmain.h" line="782"/>
4108541705 <return-value transfer-ownership="none">
4108641706 <type name="none" c:type="void"/>
4108741707 </return-value>
@@ -41089,7 +41709,7 @@ the source is dispatched after this call returns.</doc>
4108941709 <instance-parameter name="source" transfer-ownership="none">
4109041710 <doc xml:space="preserve"
4109141711 filename="glib/gmain.c"
41092- line="1669">the source</doc>
41712+ line="1784">the source</doc>
4109341713 <type name="Source" c:type="GSource*"/>
4109441714 </instance-parameter>
4109541715 <parameter name="callback_data"
@@ -41098,14 +41718,14 @@ the source is dispatched after this call returns.</doc>
4109841718 allow-none="1">
4109941719 <doc xml:space="preserve"
4110041720 filename="glib/gmain.c"
41101- line="1670">pointer to callback data "object"</doc>
41721+ line="1785">pointer to callback data ‘object’</doc>
4110241722 <type name="gpointer" c:type="gpointer"/>
4110341723 </parameter>
4110441724 <parameter name="callback_funcs" transfer-ownership="none">
4110541725 <doc xml:space="preserve"
4110641726 filename="glib/gmain.c"
41107- line="1671">functions for reference counting @callback_data
41108- and getting the callback and data</doc>
41727+ line="1786">functions for reference counting @callback_data
41728+ and getting the callback and data</doc>
4110941729 <type name="SourceCallbackFuncs" c:type="GSourceCallbackFuncs*"/>
4111041730 </parameter>
4111141731 </parameters>
@@ -41113,11 +41733,12 @@ the source is dispatched after this call returns.</doc>
4111341733 <method name="set_can_recurse" c:identifier="g_source_set_can_recurse">
4111441734 <doc xml:space="preserve"
4111541735 filename="glib/gmain.c"
41116- line="1992">Sets whether a source can be called recursively. If @can_recurse is
41117-%TRUE, then while the source is being dispatched then this source
41118-will be processed normally. Otherwise, all processing of this
41736+ line="2124">Sets whether a source can be called recursively.
41737+
41738+If @can_recurse is true, then while the source is being dispatched then this
41739+source will be processed normally. Otherwise, all processing of this
4111941740 source is blocked until the dispatch function returns.</doc>
41120- <source-position filename="glib/gmain.h" line="720"/>
41741+ <source-position filename="glib/gmain.h" line="721"/>
4112141742 <return-value transfer-ownership="none">
4112241743 <type name="none" c:type="void"/>
4112341744 </return-value>
@@ -41125,13 +41746,13 @@ source is blocked until the dispatch function returns.</doc>
4112541746 <instance-parameter name="source" transfer-ownership="none">
4112641747 <doc xml:space="preserve"
4112741748 filename="glib/gmain.c"
41128- line="1994">a #GSource</doc>
41749+ line="2126">a source</doc>
4112941750 <type name="Source" c:type="GSource*"/>
4113041751 </instance-parameter>
4113141752 <parameter name="can_recurse" transfer-ownership="none">
4113241753 <doc xml:space="preserve"
4113341754 filename="glib/gmain.c"
41134- line="1995">whether recursion is allowed for this source</doc>
41755+ line="2127">whether recursion is allowed for this source</doc>
4113541756 <type name="gboolean" c:type="gboolean"/>
4113641757 </parameter>
4113741758 </parameters>
@@ -41142,24 +41763,27 @@ source is blocked until the dispatch function returns.</doc>
4114241763 introspectable="0">
4114341764 <doc xml:space="preserve"
4114441765 filename="glib/gmain.c"
41145- line="953">Set @dispose as dispose function on @source. @dispose will be called once
41146-the reference count of @source reaches 0 but before any of the state of the
41147-source is freed, especially before the finalize function is called.
41766+ line="996">Set @dispose as dispose function on @source.
41767+
41768+The @dispose function will be called once the reference count of @source
41769+reaches zero but before any of the state of the source is freed, especially
41770+before the finalize function (set as part of the [type@GLib.SourceFuncs]) is
41771+called.
4114841772
4114941773 This means that at this point @source is still a valid [struct@GLib.Source]
4115041774 and it is allow for the reference count to increase again until @dispose
4115141775 returns.
4115241776
41153-The dispose function can be used to clear any "weak" references to the
41154-@source in other data structures in a thread-safe way where it is possible
41155-for another thread to increase the reference count of @source again while
41156-it is being freed.
41777+The dispose function can be used to clear any ‘weak’ references to
41778+the @source in other data structures in a thread-safe way where it is
41779+possible for another thread to increase the reference count of @source again
41780+while it is being freed.
4115741781
41158-The finalize function can not be used for this purpose as at that point
41159-@source is already partially freed and not valid anymore.
41782+The finalize function can not be used for this purpose as at that
41783+point @source is already partially freed and not valid any more.
4116041784
41161-This should only ever be called from #GSource implementations.</doc>
41162- <source-position filename="glib/gmain.h" line="699"/>
41785+This should only ever be called from [struct@GLib.Source] implementations.</doc>
41786+ <source-position filename="glib/gmain.h" line="700"/>
4116341787 <return-value transfer-ownership="none">
4116441788 <type name="none" c:type="void"/>
4116541789 </return-value>
@@ -41167,13 +41791,13 @@ This should only ever be called from #GSource implementations.</doc>
4116741791 <instance-parameter name="source" transfer-ownership="none">
4116841792 <doc xml:space="preserve"
4116941793 filename="glib/gmain.c"
41170- line="955">A #GSource to set the dispose function on</doc>
41794+ line="998">a source to set the dispose function on</doc>
4117141795 <type name="Source" c:type="GSource*"/>
4117241796 </instance-parameter>
4117341797 <parameter name="dispose" transfer-ownership="none">
4117441798 <doc xml:space="preserve"
4117541799 filename="glib/gmain.c"
41176- line="956">#GSourceDisposeFunc to set on the source</doc>
41800+ line="999">dispose function to set on the source</doc>
4117741801 <type name="SourceDisposeFunc" c:type="GSourceDisposeFunc"/>
4117841802 </parameter>
4117941803 </parameters>
@@ -41183,9 +41807,11 @@ This should only ever be called from #GSource implementations.</doc>
4118341807 version="2.12">
4118441808 <doc xml:space="preserve"
4118541809 filename="glib/gmain.c"
41186- line="1777">Sets the source functions (can be used to override
41187-default implementations) of an unattached source.</doc>
41188- <source-position filename="glib/gmain.h" line="737"/>
41810+ line="1897">Sets the source functions of an unattached source.
41811+
41812+These can be used to override the default implementations for the type
41813+of @source.</doc>
41814+ <source-position filename="glib/gmain.h" line="740"/>
4118941815 <return-value transfer-ownership="none">
4119041816 <type name="none" c:type="void"/>
4119141817 </return-value>
@@ -41193,13 +41819,13 @@ default implementations) of an unattached source.</doc>
4119341819 <instance-parameter name="source" transfer-ownership="none">
4119441820 <doc xml:space="preserve"
4119541821 filename="glib/gmain.c"
41196- line="1779">a #GSource</doc>
41822+ line="1899">a source</doc>
4119741823 <type name="Source" c:type="GSource*"/>
4119841824 </instance-parameter>
4119941825 <parameter name="funcs" transfer-ownership="none">
4120041826 <doc xml:space="preserve"
4120141827 filename="glib/gmain.c"
41202- line="1780">the new #GSourceFuncs</doc>
41828+ line="1900">the new source functions</doc>
4120341829 <type name="SourceFuncs" c:type="GSourceFuncs*"/>
4120441830 </parameter>
4120541831 </parameters>
@@ -41207,17 +41833,19 @@ default implementations) of an unattached source.</doc>
4120741833 <method name="set_name" c:identifier="g_source_set_name" version="2.26">
4120841834 <doc xml:space="preserve"
4120941835 filename="glib/gmain.c"
41210- line="2079">Sets a name for the source, used in debugging and profiling.
41211-The name defaults to #NULL.
41836+ line="2219">Sets a name for the source, used in debugging and profiling.
41837+
41838+The name defaults to `NULL`.
4121241839
4121341840 The source name should describe in a human-readable way
41214-what the source does. For example, "X11 event queue"
41215-or "GTK repaint idle handler" or whatever it is.
41841+what the source does. For example, ‘X11 event queue’
41842+or ‘GTK repaint idle handler’.
4121641843
4121741844 It is permitted to call this function multiple times, but is not
4121841845 recommended due to the potential performance impact. For example,
41219-one could change the name in the "check" function of a #GSourceFuncs
41220-to include details like the event type in the source name.
41846+one could change the name in the `check` function of a
41847+[struct@GLib.SourceFuncs] to include details like the event type in the
41848+source name.
4122141849
4122241850 Use caution if changing the name while another thread may be
4122341851 accessing it with [method@GLib.Source.get_name]; that function does not copy
@@ -41225,7 +41853,7 @@ the value, and changing the value will free it while the other thread
4122541853 may be attempting to use it.
4122641854
4122741855 Also see [method@GLib.Source.set_static_name].</doc>
41228- <source-position filename="glib/gmain.h" line="743"/>
41856+ <source-position filename="glib/gmain.h" line="746"/>
4122941857 <return-value transfer-ownership="none">
4123041858 <type name="none" c:type="void"/>
4123141859 </return-value>
@@ -41233,13 +41861,13 @@ Also see [method@GLib.Source.set_static_name].</doc>
4123341861 <instance-parameter name="source" transfer-ownership="none">
4123441862 <doc xml:space="preserve"
4123541863 filename="glib/gmain.c"
41236- line="2081">a #GSource</doc>
41864+ line="2221">a source</doc>
4123741865 <type name="Source" c:type="GSource*"/>
4123841866 </instance-parameter>
4123941867 <parameter name="name" transfer-ownership="none">
4124041868 <doc xml:space="preserve"
4124141869 filename="glib/gmain.c"
41242- line="2082">debug name for the source</doc>
41870+ line="2222">debug name for the source</doc>
4124341871 <type name="utf8" c:type="const char*"/>
4124441872 </parameter>
4124541873 </parameters>
@@ -41247,7 +41875,9 @@ Also see [method@GLib.Source.set_static_name].</doc>
4124741875 <method name="set_priority" c:identifier="g_source_set_priority">
4124841876 <doc xml:space="preserve"
4124941877 filename="glib/gmain.c"
41250- line="1855">Sets the priority of a source. While the main loop is being run, a
41878+ line="1977">Sets the priority of a source.
41879+
41880+While the main loop is being run, a
4125141881 source will be dispatched if it is ready to be dispatched and no
4125241882 sources at a higher (numerically smaller) priority are ready to be
4125341883 dispatched.
@@ -41255,7 +41885,7 @@ dispatched.
4125541885 A child source always has the same priority as its parent. It is not
4125641886 permitted to change the priority of a source once it has been added
4125741887 as a child of another source.</doc>
41258- <source-position filename="glib/gmain.h" line="715"/>
41888+ <source-position filename="glib/gmain.h" line="716"/>
4125941889 <return-value transfer-ownership="none">
4126041890 <type name="none" c:type="void"/>
4126141891 </return-value>
@@ -41263,13 +41893,13 @@ as a child of another source.</doc>
4126341893 <instance-parameter name="source" transfer-ownership="none">
4126441894 <doc xml:space="preserve"
4126541895 filename="glib/gmain.c"
41266- line="1857">a #GSource</doc>
41896+ line="1979">a source</doc>
4126741897 <type name="Source" c:type="GSource*"/>
4126841898 </instance-parameter>
4126941899 <parameter name="priority" transfer-ownership="none">
4127041900 <doc xml:space="preserve"
4127141901 filename="glib/gmain.c"
41272- line="1858">the new priority.</doc>
41902+ line="1980">the new priority</doc>
4127341903 <type name="gint" c:type="gint"/>
4127441904 </parameter>
4127541905 </parameters>
@@ -41279,12 +41909,14 @@ as a child of another source.</doc>
4127941909 version="2.36">
4128041910 <doc xml:space="preserve"
4128141911 filename="glib/gmain.c"
41282- line="1905">Sets a #GSource to be dispatched when the given monotonic time is
41283-reached (or passed). If the monotonic time is in the past (as it
41284-always will be if @ready_time is 0) then the source will be
41912+ line="2032">Sets a source to be dispatched when the given monotonic time is
41913+reached (or passed).
41914+
41915+If the monotonic time is in the past (as it
41916+always will be if @ready_time is `0`) then the source will be
4128541917 dispatched immediately.
4128641918
41287-If @ready_time is -1 then the source is never woken up on the basis
41919+If @ready_time is `-1` then the source is never woken up on the basis
4128841920 of the passage of time.
4128941921
4129041922 Dispatching the source does not reset the ready time. You should do
@@ -41296,12 +41928,12 @@ other suggests that it would be delivered first, and the ready time
4129641928 for both sources is reached during the same main context iteration,
4129741929 then the order of dispatch is undefined.
4129841930
41299-It is a no-op to call this function on a #GSource which has already been
41300-destroyed with [method@GLib.Source.destroy].
41931+It is a no-op to call this function on a [struct@GLib.Source] which has
41932+already been destroyed with [method@GLib.Source.destroy].
4130141933
41302-This API is only intended to be used by implementations of #GSource.
41303-Do not call this API on a #GSource that you did not create.</doc>
41304- <source-position filename="glib/gmain.h" line="755"/>
41934+This API is only intended to be used by implementations of [struct@GLib.Source].
41935+Do not call this API on a [struct@GLib.Source] that you did not create.</doc>
41936+ <source-position filename="glib/gmain.h" line="758"/>
4130541937 <return-value transfer-ownership="none">
4130641938 <type name="none" c:type="void"/>
4130741939 </return-value>
@@ -41309,14 +41941,14 @@ Do not call this API on a #GSource that you did not create.</doc>
4130941941 <instance-parameter name="source" transfer-ownership="none">
4131041942 <doc xml:space="preserve"
4131141943 filename="glib/gmain.c"
41312- line="1907">a #GSource</doc>
41944+ line="2034">a source</doc>
4131341945 <type name="Source" c:type="GSource*"/>
4131441946 </instance-parameter>
4131541947 <parameter name="ready_time" transfer-ownership="none">
4131641948 <doc xml:space="preserve"
4131741949 filename="glib/gmain.c"
41318- line="1908">the monotonic time at which the source will be ready,
41319- 0 for "immediately", -1 for "never"</doc>
41950+ line="2035">the monotonic time at which the source will be ready;
41951+ `0` for ‘immediately’, `-1` for ‘never’</doc>
4132041952 <type name="gint64" c:type="gint64"/>
4132141953 </parameter>
4132241954 </parameters>
@@ -41326,10 +41958,10 @@ Do not call this API on a #GSource that you did not create.</doc>
4132641958 version="2.70">
4132741959 <doc xml:space="preserve"
4132841960 filename="glib/gmain.c"
41329- line="2112">A variant of [method@GLib.Source.set_name] that does not
41961+ line="2254">A variant of [method@GLib.Source.set_name] that does not
4133041962 duplicate the @name, and can only be used with
4133141963 string literals.</doc>
41332- <source-position filename="glib/gmain.h" line="746"/>
41964+ <source-position filename="glib/gmain.h" line="749"/>
4133341965 <return-value transfer-ownership="none">
4133441966 <type name="none" c:type="void"/>
4133541967 </return-value>
@@ -41337,13 +41969,13 @@ string literals.</doc>
4133741969 <instance-parameter name="source" transfer-ownership="none">
4133841970 <doc xml:space="preserve"
4133941971 filename="glib/gmain.c"
41340- line="2114">a #GSource</doc>
41972+ line="2256">a source</doc>
4134141973 <type name="Source" c:type="GSource*"/>
4134241974 </instance-parameter>
4134341975 <parameter name="name" transfer-ownership="none">
4134441976 <doc xml:space="preserve"
4134541977 filename="glib/gmain.c"
41346- line="2115">debug name for the source</doc>
41978+ line="2257">debug name for the source</doc>
4134741979 <type name="utf8" c:type="const char*"/>
4134841980 </parameter>
4134941981 </parameters>
@@ -41351,10 +41983,11 @@ string literals.</doc>
4135141983 <method name="unref" c:identifier="g_source_unref">
4135241984 <doc xml:space="preserve"
4135341985 filename="glib/gmain.c"
41354- line="2361">Decreases the reference count of a source by one. If the
41355-resulting reference count is zero the source and associated
41986+ line="2504">Decreases the reference count of a source by one.
41987+
41988+If the resulting reference count is zero the source and associated
4135641989 memory will be destroyed.</doc>
41357- <source-position filename="glib/gmain.h" line="706"/>
41990+ <source-position filename="glib/gmain.h" line="707"/>
4135841991 <return-value transfer-ownership="none">
4135941992 <type name="none" c:type="void"/>
4136041993 </return-value>
@@ -41362,7 +41995,7 @@ memory will be destroyed.</doc>
4136241995 <instance-parameter name="source" transfer-ownership="none">
4136341996 <doc xml:space="preserve"
4136441997 filename="glib/gmain.c"
41365- line="2363">a #GSource</doc>
41998+ line="2506">a source</doc>
4136641999 <type name="Source" c:type="GSource*"/>
4136742000 </instance-parameter>
4136842001 </parameters>
@@ -41370,10 +42003,12 @@ memory will be destroyed.</doc>
4137042003 <function name="remove" c:identifier="g_source_remove">
4137142004 <doc xml:space="preserve"
4137242005 filename="glib/gmain.c"
41373- line="2521">Removes the source with the given ID from the default main context. You must
42006+ line="2676">Removes the source with the given ID from the default main context.
42007+
42008+You must
4137442009 use [method@GLib.Source.destroy] for sources added to a non-default main context.
4137542010
41376-The ID of a #GSource is given by [method@GLib.Source.get_id], or will be
42011+The ID of a [struct@GLib.Source] is given by [method@GLib.Source.get_id], or will be
4137742012 returned by the functions [method@GLib.Source.attach], [func@GLib.idle_add],
4137842013 [func@GLib.idle_add_full], [func@GLib.timeout_add],
4137942014 [func@GLib.timeout_add_full], [func@GLib.child_watch_add],
@@ -41390,18 +42025,18 @@ idle may already have run and been removed by the time this function
4139042025 is called on its (now invalid) source ID. This source ID may have
4139142026 been reissued, leading to the operation being performed against the
4139242027 wrong source.</doc>
41393- <source-position filename="glib/gmain.h" line="836"/>
42028+ <source-position filename="glib/gmain.h" line="839"/>
4139442029 <return-value transfer-ownership="none">
4139542030 <doc xml:space="preserve"
4139642031 filename="glib/gmain.c"
41397- line="2546">%TRUE if the source was found and removed.</doc>
42032+ line="2703">true if the source was found and removed, false otherwise</doc>
4139842033 <type name="gboolean" c:type="gboolean"/>
4139942034 </return-value>
4140042035 <parameters>
4140142036 <parameter name="tag" transfer-ownership="none">
4140242037 <doc xml:space="preserve"
4140342038 filename="glib/gmain.c"
41404- line="2523">the ID of the source to remove.</doc>
42039+ line="2678">the ID of the source to remove.</doc>
4140542040 <type name="guint" c:type="guint"/>
4140642041 </parameter>
4140742042 </parameters>
@@ -41410,21 +42045,23 @@ wrong source.</doc>
4141042045 c:identifier="g_source_remove_by_funcs_user_data">
4141142046 <doc xml:space="preserve"
4141242047 filename="glib/gmain.c"
41413- line="2589">Removes a source from the default main loop context given the
41414-source functions and user data. If multiple sources exist with the
41415-same source functions and user data, only one will be destroyed.</doc>
41416- <source-position filename="glib/gmain.h" line="840"/>
42048+ line="2747">Removes a source from the default main loop context given the
42049+source functions and user data.
42050+
42051+If multiple sources exist with the same source functions and user data, only
42052+one will be destroyed.</doc>
42053+ <source-position filename="glib/gmain.h" line="843"/>
4141742054 <return-value transfer-ownership="none">
4141842055 <doc xml:space="preserve"
4141942056 filename="glib/gmain.c"
41420- line="2598">%TRUE if a source was found and removed.</doc>
42057+ line="2758">true if a source was found and removed, false otherwise</doc>
4142142058 <type name="gboolean" c:type="gboolean"/>
4142242059 </return-value>
4142342060 <parameters>
4142442061 <parameter name="funcs" transfer-ownership="none">
4142542062 <doc xml:space="preserve"
4142642063 filename="glib/gmain.c"
41427- line="2591">The @source_funcs passed to [ctor@GLib.Source.new]</doc>
42064+ line="2749">the @source_funcs passed to [ctor@GLib.Source.new]</doc>
4142842065 <type name="SourceFuncs" c:type="GSourceFuncs*"/>
4142942066 </parameter>
4143042067 <parameter name="user_data"
@@ -41433,7 +42070,7 @@ same source functions and user data, only one will be destroyed.</doc>
4143342070 allow-none="1">
4143442071 <doc xml:space="preserve"
4143542072 filename="glib/gmain.c"
41436- line="2592">the user data for the callback</doc>
42073+ line="2750">the user data for the callback</doc>
4143742074 <type name="gpointer" c:type="gpointer"/>
4143842075 </parameter>
4143942076 </parameters>
@@ -41442,14 +42079,15 @@ same source functions and user data, only one will be destroyed.</doc>
4144242079 c:identifier="g_source_remove_by_user_data">
4144342080 <doc xml:space="preserve"
4144442081 filename="glib/gmain.c"
41445- line="2564">Removes a source from the default main loop context given the user
41446-data for the callback. If multiple sources exist with the same user
41447-data, only one will be destroyed.</doc>
41448- <source-position filename="glib/gmain.h" line="838"/>
42082+ line="2721">Removes a source from the default main loop context given the user
42083+data for the callback.
42084+
42085+If multiple sources exist with the same user data, only one will be destroyed.</doc>
42086+ <source-position filename="glib/gmain.h" line="841"/>
4144942087 <return-value transfer-ownership="none">
4145042088 <doc xml:space="preserve"
4145142089 filename="glib/gmain.c"
41452- line="2572">%TRUE if a source was found and removed.</doc>
42090+ line="2730">true if a source was found and removed, false otherwise</doc>
4145342091 <type name="gboolean" c:type="gboolean"/>
4145442092 </return-value>
4145542093 <parameters>
@@ -41459,7 +42097,7 @@ data, only one will be destroyed.</doc>
4145942097 allow-none="1">
4146042098 <doc xml:space="preserve"
4146142099 filename="glib/gmain.c"
41462- line="2566">the user_data for the callback.</doc>
42100+ line="2723">the user_data for the callback</doc>
4146342101 <type name="gpointer" c:type="gpointer"/>
4146442102 </parameter>
4146542103 </parameters>
@@ -41469,7 +42107,7 @@ data, only one will be destroyed.</doc>
4146942107 version="2.26">
4147042108 <doc xml:space="preserve"
4147142109 filename="glib/gmain.c"
41472- line="2150">Sets the name of a source using its ID.
42110+ line="2293">Sets the name of a source using its ID.
4147342111
4147442112 This is a convenience utility to set source names from the return
4147542113 value of [func@GLib.idle_add], [func@GLib.timeout_add], etc.
@@ -41485,7 +42123,7 @@ idle may already have run and been removed by the time this function
4148542123 is called on its (now invalid) source ID. This source ID may have
4148642124 been reissued, leading to the operation being performed against the
4148742125 wrong source.</doc>
41488- <source-position filename="glib/gmain.h" line="751"/>
42126+ <source-position filename="glib/gmain.h" line="754"/>
4148942127 <return-value transfer-ownership="none">
4149042128 <type name="none" c:type="void"/>
4149142129 </return-value>
@@ -41493,13 +42131,13 @@ wrong source.</doc>
4149342131 <parameter name="tag" transfer-ownership="none">
4149442132 <doc xml:space="preserve"
4149542133 filename="glib/gmain.c"
41496- line="2152">a #GSource ID</doc>
42134+ line="2295">a source ID</doc>
4149742135 <type name="guint" c:type="guint"/>
4149842136 </parameter>
4149942137 <parameter name="name" transfer-ownership="none">
4150042138 <doc xml:space="preserve"
4150142139 filename="glib/gmain.c"
41502- line="2153">debug name for the source</doc>
42140+ line="2296">debug name for the source</doc>
4150342141 <type name="utf8" c:type="const char*"/>
4150442142 </parameter>
4150542143 </parameters>
@@ -41510,13 +42148,13 @@ wrong source.</doc>
4151042148 filename="glib/gmain.h"
4151142149 line="89">The `GSourceCallbackFuncs` struct contains
4151242150 functions for managing callback objects.</doc>
41513- <source-position filename="glib/gmain.h" line="299"/>
42151+ <source-position filename="glib/gmain.h" line="300"/>
4151442152 <field name="ref">
4151542153 <doc xml:space="preserve"
4151642154 filename="glib/gmain.h"
4151742155 line="91">Called when a reference is added to the callback object</doc>
4151842156 <callback name="ref">
41519- <source-position filename="glib/gmain.h" line="293"/>
42157+ <source-position filename="glib/gmain.h" line="294"/>
4152042158 <return-value transfer-ownership="none">
4152142159 <type name="none" c:type="void"/>
4152242160 </return-value>
@@ -41532,7 +42170,7 @@ functions for managing callback objects.</doc>
4153242170 filename="glib/gmain.h"
4153342171 line="92">Called when a reference to the callback object is dropped</doc>
4153442172 <callback name="unref">
41535- <source-position filename="glib/gmain.h" line="294"/>
42173+ <source-position filename="glib/gmain.h" line="295"/>
4153642174 <return-value transfer-ownership="none">
4153742175 <type name="none" c:type="void"/>
4153842176 </return-value>
@@ -41549,7 +42187,7 @@ functions for managing callback objects.</doc>
4154942187 line="93">Called to extract the callback function and data from the
4155042188 callback object.</doc>
4155142189 <callback name="get" introspectable="0">
41552- <source-position filename="glib/gmain.h" line="295"/>
42190+ <source-position filename="glib/gmain.h" line="296"/>
4155342191 <return-value transfer-ownership="none">
4155442192 <type name="none" c:type="void"/>
4155542193 </return-value>
@@ -41578,9 +42216,9 @@ functions for managing callback objects.</doc>
4157842216 version="2.64">
4157942217 <doc xml:space="preserve"
4158042218 filename="glib/gmain.h"
41581- line="254">Dispose function for @source. See [method@GLib.Source.set_dispose_function]
42219+ line="255">Dispose function for @source. See [method@GLib.Source.set_dispose_function]
4158242220 for details.</doc>
41583- <source-position filename="glib/gmain.h" line="264"/>
42221+ <source-position filename="glib/gmain.h" line="265"/>
4158442222 <return-value transfer-ownership="none">
4158542223 <type name="none" c:type="void"/>
4158642224 </return-value>
@@ -41588,7 +42226,7 @@ for details.</doc>
4158842226 <parameter name="source" transfer-ownership="none">
4158942227 <doc xml:space="preserve"
4159042228 filename="glib/gmain.h"
41591- line="256">#GSource that is currently being disposed</doc>
42229+ line="257">#GSource that is currently being disposed</doc>
4159242230 <type name="Source" c:type="GSource*"/>
4159342231 </parameter>
4159442232 </parameters>
@@ -41596,9 +42234,9 @@ for details.</doc>
4159642234 <callback name="SourceDummyMarshal" c:type="GSourceDummyMarshal">
4159742235 <doc xml:space="preserve"
4159842236 filename="glib/gmain.h"
41599- line="301">This is just a placeholder for #GClosureMarshal,
42237+ line="302">This is just a placeholder for #GClosureMarshal,
4160042238 which cannot be used here for dependency reasons.</doc>
41601- <source-position filename="glib/gmain.h" line="307"/>
42239+ <source-position filename="glib/gmain.h" line="308"/>
4160242240 <return-value transfer-ownership="none">
4160342241 <type name="none" c:type="void"/>
4160442242 </return-value>
@@ -41606,18 +42244,18 @@ which cannot be used here for dependency reasons.</doc>
4160642244 <callback name="SourceFunc" c:type="GSourceFunc">
4160742245 <doc xml:space="preserve"
4160842246 filename="glib/gmain.h"
41609- line="182">Specifies the type of function passed to [func@GLib.timeout_add],
42247+ line="183">Specifies the type of function passed to [func@GLib.timeout_add],
4161042248 [func@GLib.timeout_add_full], [func@GLib.idle_add], and
4161142249 [func@GLib.idle_add_full].
4161242250
4161342251 When calling [method@GLib.Source.set_callback], you may need to cast a
4161442252 function of a different type to this type. Use [func@GLib.SOURCE_FUNC] to
4161542253 avoid warnings about incompatible function types.</doc>
41616- <source-position filename="glib/gmain.h" line="199"/>
42254+ <source-position filename="glib/gmain.h" line="200"/>
4161742255 <return-value transfer-ownership="none">
4161842256 <doc xml:space="preserve"
4161942257 filename="glib/gmain.h"
41620- line="195">%FALSE if the source should be removed.
42258+ line="196">%FALSE if the source should be removed.
4162142259 [const@GLib.SOURCE_CONTINUE] and [const@GLib.SOURCE_REMOVE] are more
4162242260 memorable names for the return value.</doc>
4162342261 <type name="gboolean" c:type="gboolean"/>
@@ -41630,7 +42268,7 @@ memorable names for the return value.</doc>
4163042268 closure="0">
4163142269 <doc xml:space="preserve"
4163242270 filename="glib/gmain.h"
41633- line="184">data passed to the function, set when the source was
42271+ line="185">data passed to the function, set when the source was
4163442272 created with one of the above functions</doc>
4163542273 <type name="gpointer" c:type="gpointer"/>
4163642274 </parameter>
@@ -41659,12 +42297,12 @@ any events need to be processed. It sets the returned timeout to -1 to
4165942297 indicate that it doesn't mind how long the poll() call blocks. In the
4166042298 check function, it tests the results of the poll() call to see if the
4166142299 required condition has been met, and returns %TRUE if so.</doc>
41662- <source-position filename="glib/gmain.h" line="409"/>
42300+ <source-position filename="glib/gmain.h" line="410"/>
4166342301 <field name="prepare" writable="1">
4166442302 <doc xml:space="preserve"
4166542303 filename="glib/gmain.h"
41666- line="103">Called before all the file descriptors are polled. If the
41667- source can determine that it is ready here (without waiting for the
42304+ line="103">Called before all the file descriptors are polled. If
42305+ the source can determine that it is ready here (without waiting for the
4166842306 results of the poll() call) it should return %TRUE. It can also return
4166942307 a @timeout_ value which should be the maximum timeout (in milliseconds)
4167042308 which should be passed to the poll() call. The actual timeout used will
@@ -41679,9 +42317,9 @@ required condition has been met, and returns %TRUE if so.</doc>
4167942317 <field name="check" writable="1">
4168042318 <doc xml:space="preserve"
4168142319 filename="glib/gmain.h"
41682- line="114">Called after all the file descriptors are polled. The source
41683- should return %TRUE if it is ready to be dispatched. Note that some
41684- time may have passed since the previous prepare function was called,
42320+ line="114">Called after all the file descriptors are polled. The
42321+ source should return %TRUE if it is ready to be dispatched. Note that
42322+ some time may have passed since the previous prepare function was called,
4168542323 so the source should be checked again here. Since 2.36 this may
4168642324 be %NULL, in which case the effect is as if the function always returns
4168742325 %FALSE.</doc>
@@ -41706,11 +42344,12 @@ required condition has been met, and returns %TRUE if so.</doc>
4170642344 <field name="finalize" writable="1">
4170742345 <doc xml:space="preserve"
4170842346 filename="glib/gmain.h"
41709- line="130">Called when the source is finalized. At this point, the source
41710- will have been destroyed, had its callback cleared, and have been removed
41711- from its [struct@GLib.MainContext], but it will still have its final
41712- reference count, so methods can be called on it from within this
41713- function.</doc>
42347+ line="130">Called when the source is finalized. At this point,
42348+ the source will have been destroyed, had its callback cleared, and have
42349+ been removed from its [struct@GLib.MainContext], but it will still have
42350+ its final reference count, so methods can be called on it from within
42351+ this function. This may be %NULL, in which case the effect is as if the
42352+ function does nothing and returns.</doc>
4171442353 <type name="SourceFuncsFinalizeFunc"
4171542354 c:type="GSourceFuncsFinalizeFunc"/>
4171642355 </field>
@@ -41726,7 +42365,7 @@ required condition has been met, and returns %TRUE if so.</doc>
4172642365 version="2.82">
4172742366 <doc xml:space="preserve"
4172842367 filename="glib/gmain.h"
41729- line="336">Checks if the source is ready to be dispatched.
42368+ line="337">Checks if the source is ready to be dispatched.
4173042369
4173142370 Called after all the file descriptors are polled. The source
4173242371 should return %TRUE if it is ready to be dispatched. Note that some
@@ -41735,18 +42374,18 @@ so the source should be checked again here.
4173542374
4173642375 Since 2.36 this may be `NULL`, in which case the effect is
4173742376 as if the function always returns `FALSE`.</doc>
41738- <source-position filename="glib/gmain.h" line="354"/>
42377+ <source-position filename="glib/gmain.h" line="355"/>
4173942378 <return-value transfer-ownership="none">
4174042379 <doc xml:space="preserve"
4174142380 filename="glib/gmain.h"
41742- line="350">%TRUE if ready to be dispatched, %FALSE otherwise</doc>
42381+ line="351">%TRUE if ready to be dispatched, %FALSE otherwise</doc>
4174342382 <type name="gboolean" c:type="gboolean"/>
4174442383 </return-value>
4174542384 <parameters>
4174642385 <parameter name="source" transfer-ownership="none">
4174742386 <doc xml:space="preserve"
4174842387 filename="glib/gmain.h"
41749- line="338">The #GSource</doc>
42388+ line="339">The #GSource</doc>
4175042389 <type name="Source" c:type="GSource*"/>
4175142390 </parameter>
4175242391 </parameters>
@@ -41757,7 +42396,7 @@ as if the function always returns `FALSE`.</doc>
4175742396 introspectable="0">
4175842397 <doc xml:space="preserve"
4175942398 filename="glib/gmain.h"
41760- line="356">Dispatches the source callback.
42399+ line="357">Dispatches the source callback.
4176142400
4176242401 Called to dispatch the event source, after it has returned
4176342402 `TRUE` in either its prepare or its check function, or if a ready time
@@ -41768,11 +42407,11 @@ function should call the callback function with @user_data and whatever
4176842407 additional parameters are needed for this type of event source. The
4176942408 return value of the dispatch function should be [const@GLib.SOURCE_REMOVE]
4177042409 if the source should be removed or [const@GLib.SOURCE_CONTINUE] to keep it.</doc>
41771- <source-position filename="glib/gmain.h" line="379"/>
42410+ <source-position filename="glib/gmain.h" line="380"/>
4177242411 <return-value transfer-ownership="none">
4177342412 <doc xml:space="preserve"
4177442413 filename="glib/gmain.h"
41775- line="374">[const@GLib.SOURCE_REMOVE] if the source should be removed,
42414+ line="375">[const@GLib.SOURCE_REMOVE] if the source should be removed,
4177642415 [const@GLib.SOURCE_CONTINUE] otherwise.</doc>
4177742416 <type name="gboolean" c:type="gboolean"/>
4177842417 </return-value>
@@ -41780,7 +42419,7 @@ if the source should be removed or [const@GLib.SOURCE_CONTINUE] to keep it.</doc
4178042419 <parameter name="source" transfer-ownership="none">
4178142420 <doc xml:space="preserve"
4178242421 filename="glib/gmain.h"
41783- line="358">The #GSource</doc>
42422+ line="359">The #GSource</doc>
4178442423 <type name="Source" c:type="GSource*"/>
4178542424 </parameter>
4178642425 <parameter name="callback"
@@ -41790,7 +42429,7 @@ if the source should be removed or [const@GLib.SOURCE_CONTINUE] to keep it.</doc
4179042429 closure="2">
4179142430 <doc xml:space="preserve"
4179242431 filename="glib/gmain.h"
41793- line="359">The #GSourceFunc to call</doc>
42432+ line="360">The #GSourceFunc to call</doc>
4179442433 <type name="SourceFunc" c:type="GSourceFunc"/>
4179542434 </parameter>
4179642435 <parameter name="user_data"
@@ -41800,7 +42439,7 @@ if the source should be removed or [const@GLib.SOURCE_CONTINUE] to keep it.</doc
4180042439 closure="2">
4180142440 <doc xml:space="preserve"
4180242441 filename="glib/gmain.h"
41803- line="360">data to pass to @callback</doc>
42442+ line="361">data to pass to @callback</doc>
4180442443 <type name="gpointer" c:type="gpointer"/>
4180542444 </parameter>
4180642445 </parameters>
@@ -41810,13 +42449,13 @@ if the source should be removed or [const@GLib.SOURCE_CONTINUE] to keep it.</doc
4181042449 version="2.82">
4181142450 <doc xml:space="preserve"
4181242451 filename="glib/gmain.h"
41813- line="383">Finalizes the source.
42452+ line="384">Finalizes the source.
4181442453
4181542454 Called when the source is finalized. At this point, the source
4181642455 will have been destroyed, had its callback cleared, and have been removed
4181742456 from its [type@GLib.MainContext], but it will still have its final reference
4181842457 count, so methods can be called on it from within this function.</doc>
41819- <source-position filename="glib/gmain.h" line="396"/>
42458+ <source-position filename="glib/gmain.h" line="397"/>
4182042459 <return-value transfer-ownership="none">
4182142460 <type name="none" c:type="void"/>
4182242461 </return-value>
@@ -41824,7 +42463,7 @@ count, so methods can be called on it from within this function.</doc>
4182442463 <parameter name="source" transfer-ownership="none">
4182542464 <doc xml:space="preserve"
4182642465 filename="glib/gmain.h"
41827- line="385">The #GSource</doc>
42466+ line="386">The #GSource</doc>
4182842467 <type name="Source" c:type="GSource*"/>
4182942468 </parameter>
4183042469 </parameters>
@@ -41834,7 +42473,7 @@ count, so methods can be called on it from within this function.</doc>
4183442473 version="2.82">
4183542474 <doc xml:space="preserve"
4183642475 filename="glib/gmain.h"
41837- line="309">Checks the source for readiness.
42476+ line="310">Checks the source for readiness.
4183842477
4183942478 Called before all the file descriptors are polled. If the
4184042479 source can determine that it is ready here (without waiting for the
@@ -41848,18 +42487,18 @@ ready time set, then the lower of the two will be used.
4184842487
4184942488 Since 2.36 this may be `NULL`, in which case the effect is as if the
4185042489 function always returns `FALSE` with a timeout of `-1`.</doc>
41851- <source-position filename="glib/gmain.h" line="333"/>
42490+ <source-position filename="glib/gmain.h" line="334"/>
4185242491 <return-value transfer-ownership="none">
4185342492 <doc xml:space="preserve"
4185442493 filename="glib/gmain.h"
41855- line="329">%TRUE if the source is ready, %FALSE otherwise</doc>
42494+ line="330">%TRUE if the source is ready, %FALSE otherwise</doc>
4185642495 <type name="gboolean" c:type="gboolean"/>
4185742496 </return-value>
4185842497 <parameters>
4185942498 <parameter name="source" transfer-ownership="none">
4186042499 <doc xml:space="preserve"
4186142500 filename="glib/gmain.h"
41862- line="311">The #GSource</doc>
42501+ line="312">The #GSource</doc>
4186342502 <type name="Source" c:type="GSource*"/>
4186442503 </parameter>
4186542504 <parameter name="timeout_"
@@ -41870,7 +42509,7 @@ function always returns `FALSE` with a timeout of `-1`.</doc>
4187042509 allow-none="1">
4187142510 <doc xml:space="preserve"
4187242511 filename="glib/gmain.h"
41873- line="312">the maximum timeout (in milliseconds) which should be passed to the poll call</doc>
42512+ line="313">the maximum timeout (in milliseconds) which should be passed to the poll call</doc>
4187442513 <type name="gint" c:type="gint*"/>
4187542514 </parameter>
4187642515 </parameters>
@@ -41878,11 +42517,11 @@ function always returns `FALSE` with a timeout of `-1`.</doc>
4187842517 <callback name="SourceOnceFunc" c:type="GSourceOnceFunc" version="2.74">
4187942518 <doc xml:space="preserve"
4188042519 filename="glib/gmain.h"
41881- line="201">A source function that is only called once before being removed from the main
42520+ line="202">A source function that is only called once before being removed from the main
4188242521 context automatically.
4188342522
4188442523 See: [func@GLib.idle_add_once], [func@GLib.timeout_add_once]</doc>
41885- <source-position filename="glib/gmain.h" line="213"/>
42524+ <source-position filename="glib/gmain.h" line="214"/>
4188642525 <return-value transfer-ownership="none">
4188742526 <type name="none" c:type="void"/>
4188842527 </return-value>
@@ -41894,7 +42533,7 @@ See: [func@GLib.idle_add_once], [func@GLib.timeout_add_once]</doc>
4189442533 closure="0">
4189542534 <doc xml:space="preserve"
4189642535 filename="glib/gmain.h"
41897- line="203">data passed to the function, set when the source was
42536+ line="204">data passed to the function, set when the source was
4189842537 created</doc>
4189942538 <type name="gpointer" c:type="gpointer"/>
4190042539 </parameter>
@@ -42183,7 +42822,7 @@ list to the `g_spawn...` function.</doc>
4218342822 <record name="StatBuf" c:type="GStatBuf" disguised="1" opaque="1">
4218442823 <doc xml:space="preserve"
4218542824 filename="glib/gstdio.c"
42186- line="1284">A type corresponding to the appropriate struct type for the stat()
42825+ line="1295">A type corresponding to the appropriate struct type for the stat()
4218742826 system call, depending on the platform and/or compiler being used.
4218842827
4218942828 See g_stat() for more information.</doc>
@@ -43100,7 +43739,7 @@ bytes.</doc>
4310043739 line="148">Creates a new #GString, initialized with the given string.
4310143740
4310243741 After this call, @init belongs to the #GString and may no longer be
43103-modified by the caller. The memory of @data has to be dynamically
43742+modified by the caller. The memory of @init has to be dynamically
4310443743 allocated and will eventually be freed with g_free().</doc>
4310543744 <source-position filename="glib/gstring.h" line="55"/>
4310643745 <return-value transfer-ownership="full">
@@ -43149,26 +43788,26 @@ too often.</doc>
4314943788 <method name="append" c:identifier="g_string_append">
4315043789 <doc xml:space="preserve"
4315143790 filename="glib/gstring.c"
43152- line="579">Adds a string onto the end of a #GString, expanding
43791+ line="611">Adds a string onto the end of a #GString, expanding
4315343792 it if necessary.</doc>
43154- <source-position filename="glib/gstring.h" line="105"/>
43793+ <source-position filename="glib/gstring.h" line="107"/>
4315543794 <return-value transfer-ownership="none">
4315643795 <doc xml:space="preserve"
4315743796 filename="glib/gstring.c"
43158- line="587">@string</doc>
43797+ line="619">@string</doc>
4315943798 <type name="String" c:type="GString*"/>
4316043799 </return-value>
4316143800 <parameters>
4316243801 <instance-parameter name="string" transfer-ownership="none">
4316343802 <doc xml:space="preserve"
4316443803 filename="glib/gstring.c"
43165- line="581">a #GString</doc>
43804+ line="613">a #GString</doc>
4316643805 <type name="String" c:type="GString*"/>
4316743806 </instance-parameter>
4316843807 <parameter name="val" transfer-ownership="none">
4316943808 <doc xml:space="preserve"
4317043809 filename="glib/gstring.c"
43171- line="582">the string to append onto the end of @string</doc>
43810+ line="614">the string to append onto the end of @string</doc>
4317243811 <type name="utf8" c:type="const gchar*"/>
4317343812 </parameter>
4317443813 </parameters>
@@ -43176,26 +43815,26 @@ it if necessary.</doc>
4317643815 <method name="append_c" c:identifier="g_string_append_c">
4317743816 <doc xml:space="preserve"
4317843817 filename="glib/gstring.c"
43179- line="622">Adds a byte onto the end of a #GString, expanding
43818+ line="654">Adds a byte onto the end of a #GString, expanding
4318043819 it if necessary.</doc>
43181- <source-position filename="glib/gstring.h" line="112"/>
43820+ <source-position filename="glib/gstring.h" line="114"/>
4318243821 <return-value transfer-ownership="none">
4318343822 <doc xml:space="preserve"
4318443823 filename="glib/gstring.c"
43185- line="630">@string</doc>
43824+ line="662">@string</doc>
4318643825 <type name="String" c:type="GString*"/>
4318743826 </return-value>
4318843827 <parameters>
4318943828 <instance-parameter name="string" transfer-ownership="none">
4319043829 <doc xml:space="preserve"
4319143830 filename="glib/gstring.c"
43192- line="624">a #GString</doc>
43831+ line="656">a #GString</doc>
4319343832 <type name="String" c:type="GString*"/>
4319443833 </instance-parameter>
4319543834 <parameter name="c" transfer-ownership="none">
4319643835 <doc xml:space="preserve"
4319743836 filename="glib/gstring.c"
43198- line="625">the byte to append onto the end of @string</doc>
43837+ line="657">the byte to append onto the end of @string</doc>
4319943838 <type name="gchar" c:type="gchar"/>
4320043839 </parameter>
4320143840 </parameters>
@@ -43203,7 +43842,7 @@ it if necessary.</doc>
4320343842 <method name="append_len" c:identifier="g_string_append_len">
4320443843 <doc xml:space="preserve"
4320543844 filename="glib/gstring.c"
43206- line="596">Appends @len bytes of @val to @string.
43845+ line="628">Appends @len bytes of @val to @string.
4320743846
4320843847 If @len is positive, @val may contain embedded nuls and need
4320943848 not be nul-terminated. It is the caller's responsibility to
@@ -43212,30 +43851,30 @@ ensure that @val has at least @len addressable bytes.
4321243851 If @len is negative, @val must be nul-terminated and @len
4321343852 is considered to request the entire string length. This
4321443853 makes g_string_append_len() equivalent to g_string_append().</doc>
43215- <source-position filename="glib/gstring.h" line="108"/>
43854+ <source-position filename="glib/gstring.h" line="110"/>
4321643855 <return-value transfer-ownership="none">
4321743856 <doc xml:space="preserve"
4321843857 filename="glib/gstring.c"
43219- line="612">@string</doc>
43858+ line="644">@string</doc>
4322043859 <type name="String" c:type="GString*"/>
4322143860 </return-value>
4322243861 <parameters>
4322343862 <instance-parameter name="string" transfer-ownership="none">
4322443863 <doc xml:space="preserve"
4322543864 filename="glib/gstring.c"
43226- line="598">a #GString</doc>
43865+ line="630">a #GString</doc>
4322743866 <type name="String" c:type="GString*"/>
4322843867 </instance-parameter>
4322943868 <parameter name="val" transfer-ownership="none">
4323043869 <doc xml:space="preserve"
4323143870 filename="glib/gstring.c"
43232- line="599">bytes to append</doc>
43871+ line="631">bytes to append</doc>
4323343872 <type name="utf8" c:type="const gchar*"/>
4323443873 </parameter>
4323543874 <parameter name="len" transfer-ownership="none">
4323643875 <doc xml:space="preserve"
4323743876 filename="glib/gstring.c"
43238- line="600">number of bytes of @val to use, or -1 for all of @val</doc>
43877+ line="632">number of bytes of @val to use, or -1 for all of @val</doc>
4323943878 <type name="gssize" c:type="gssize"/>
4324043879 </parameter>
4324143880 </parameters>
@@ -43245,10 +43884,10 @@ makes g_string_append_len() equivalent to g_string_append().</doc>
4324543884 introspectable="0">
4324643885 <doc xml:space="preserve"
4324743886 filename="glib/gstring.c"
43248- line="1416">Appends a formatted string onto the end of a #GString.
43887+ line="1448">Appends a formatted string onto the end of a #GString.
4324943888 This function is similar to g_string_printf() except
4325043889 that the text is appended to the #GString.</doc>
43251- <source-position filename="glib/gstring.h" line="179"/>
43890+ <source-position filename="glib/gstring.h" line="181"/>
4325243891 <return-value transfer-ownership="none">
4325343892 <type name="none" c:type="void"/>
4325443893 </return-value>
@@ -43256,19 +43895,19 @@ that the text is appended to the #GString.</doc>
4325643895 <instance-parameter name="string" transfer-ownership="none">
4325743896 <doc xml:space="preserve"
4325843897 filename="glib/gstring.c"
43259- line="1418">a #GString</doc>
43898+ line="1450">a #GString</doc>
4326043899 <type name="String" c:type="GString*"/>
4326143900 </instance-parameter>
4326243901 <parameter name="format" transfer-ownership="none">
4326343902 <doc xml:space="preserve"
4326443903 filename="glib/gstring.c"
43265- line="1419">the string format. See the printf() documentation</doc>
43904+ line="1451">the string format. See the printf() documentation</doc>
4326643905 <type name="utf8" c:type="const gchar*"/>
4326743906 </parameter>
4326843907 <parameter name="..." transfer-ownership="none">
4326943908 <doc xml:space="preserve"
4327043909 filename="glib/gstring.c"
43271- line="1420">the parameters to insert into the format string</doc>
43910+ line="1452">the parameters to insert into the format string</doc>
4327243911 <varargs/>
4327343912 </parameter>
4327443913 </parameters>
@@ -43276,26 +43915,26 @@ that the text is appended to the #GString.</doc>
4327643915 <method name="append_unichar" c:identifier="g_string_append_unichar">
4327743916 <doc xml:space="preserve"
4327843917 filename="glib/gstring.c"
43279- line="641">Converts a Unicode character into UTF-8, and appends it
43918+ line="673">Converts a Unicode character into UTF-8, and appends it
4328043919 to the string.</doc>
43281- <source-position filename="glib/gstring.h" line="115"/>
43920+ <source-position filename="glib/gstring.h" line="117"/>
4328243921 <return-value transfer-ownership="none">
4328343922 <doc xml:space="preserve"
4328443923 filename="glib/gstring.c"
43285- line="649">@string</doc>
43924+ line="681">@string</doc>
4328643925 <type name="String" c:type="GString*"/>
4328743926 </return-value>
4328843927 <parameters>
4328943928 <instance-parameter name="string" transfer-ownership="none">
4329043929 <doc xml:space="preserve"
4329143930 filename="glib/gstring.c"
43292- line="643">a #GString</doc>
43931+ line="675">a #GString</doc>
4329343932 <type name="String" c:type="GString*"/>
4329443933 </instance-parameter>
4329543934 <parameter name="wc" transfer-ownership="none">
4329643935 <doc xml:space="preserve"
4329743936 filename="glib/gstring.c"
43298- line="644">a Unicode character</doc>
43937+ line="676">a Unicode character</doc>
4329943938 <type name="gunichar" c:type="gunichar"/>
4330043939 </parameter>
4330143940 </parameters>
@@ -43305,39 +43944,39 @@ to the string.</doc>
4330543944 version="2.16">
4330643945 <doc xml:space="preserve"
4330743946 filename="glib/gstring.c"
43308- line="553">Appends @unescaped to @string, escaping any characters that
43947+ line="585">Appends @unescaped to @string, escaping any characters that
4330943948 are reserved in URIs using URI-style escape sequences.</doc>
43310- <source-position filename="glib/gstring.h" line="183"/>
43949+ <source-position filename="glib/gstring.h" line="185"/>
4331143950 <return-value transfer-ownership="none">
4331243951 <doc xml:space="preserve"
4331343952 filename="glib/gstring.c"
43314- line="564">@string</doc>
43953+ line="596">@string</doc>
4331543954 <type name="String" c:type="GString*"/>
4331643955 </return-value>
4331743956 <parameters>
4331843957 <instance-parameter name="string" transfer-ownership="none">
4331943958 <doc xml:space="preserve"
4332043959 filename="glib/gstring.c"
43321- line="555">a #GString</doc>
43960+ line="587">a #GString</doc>
4332243961 <type name="String" c:type="GString*"/>
4332343962 </instance-parameter>
4332443963 <parameter name="unescaped" transfer-ownership="none">
4332543964 <doc xml:space="preserve"
4332643965 filename="glib/gstring.c"
43327- line="556">a string</doc>
43966+ line="588">a string</doc>
4332843967 <type name="utf8" c:type="const gchar*"/>
4332943968 </parameter>
4333043969 <parameter name="reserved_chars_allowed" transfer-ownership="none">
4333143970 <doc xml:space="preserve"
4333243971 filename="glib/gstring.c"
43333- line="557">a string of reserved characters allowed
43972+ line="589">a string of reserved characters allowed
4333443973 to be used, or %NULL</doc>
4333543974 <type name="utf8" c:type="const gchar*"/>
4333643975 </parameter>
4333743976 <parameter name="allow_utf8" transfer-ownership="none">
4333843977 <doc xml:space="preserve"
4333943978 filename="glib/gstring.c"
43340- line="559">set %TRUE if the escaped string may include UTF8 characters</doc>
43979+ line="591">set %TRUE if the escaped string may include UTF8 characters</doc>
4334143980 <type name="gboolean" c:type="gboolean"/>
4334243981 </parameter>
4334343982 </parameters>
@@ -43348,11 +43987,11 @@ are reserved in URIs using URI-style escape sequences.</doc>
4334843987 introspectable="0">
4334943988 <doc xml:space="preserve"
4335043989 filename="glib/gstring.c"
43351- line="1302">Appends a formatted string onto the end of a #GString.
43990+ line="1334">Appends a formatted string onto the end of a #GString.
4335243991 This function is similar to g_string_append_printf()
4335343992 except that the arguments to the format string are passed
4335443993 as a va_list.</doc>
43355- <source-position filename="glib/gstring.h" line="174"/>
43994+ <source-position filename="glib/gstring.h" line="176"/>
4335643995 <return-value transfer-ownership="none">
4335743996 <type name="none" c:type="void"/>
4335843997 </return-value>
@@ -43360,19 +43999,19 @@ as a va_list.</doc>
4336043999 <instance-parameter name="string" transfer-ownership="none">
4336144000 <doc xml:space="preserve"
4336244001 filename="glib/gstring.c"
43363- line="1304">a #GString</doc>
44002+ line="1336">a #GString</doc>
4336444003 <type name="String" c:type="GString*"/>
4336544004 </instance-parameter>
4336644005 <parameter name="format" transfer-ownership="none">
4336744006 <doc xml:space="preserve"
4336844007 filename="glib/gstring.c"
43369- line="1305">the string format. See the printf() documentation</doc>
44008+ line="1337">the string format. See the printf() documentation</doc>
4337044009 <type name="utf8" c:type="const gchar*"/>
4337144010 </parameter>
4337244011 <parameter name="args" transfer-ownership="none">
4337344012 <doc xml:space="preserve"
4337444013 filename="glib/gstring.c"
43375- line="1306">the list of arguments to insert in the output</doc>
44014+ line="1338">the list of arguments to insert in the output</doc>
4337644015 <type name="va_list" c:type="va_list"/>
4337744016 </parameter>
4337844017 </parameters>
@@ -43380,12 +44019,12 @@ as a va_list.</doc>
4338044019 <method name="ascii_down" c:identifier="g_string_ascii_down">
4338144020 <doc xml:space="preserve"
4338244021 filename="glib/gstring.c"
43383- line="1172">Converts all uppercase ASCII letters to lowercase ASCII letters.</doc>
43384- <source-position filename="glib/gstring.h" line="161"/>
44022+ line="1204">Converts all uppercase ASCII letters to lowercase ASCII letters.</doc>
44023+ <source-position filename="glib/gstring.h" line="163"/>
4338544024 <return-value transfer-ownership="none">
4338644025 <doc xml:space="preserve"
4338744026 filename="glib/gstring.c"
43388- line="1178">passed-in @string pointer, with all the
44027+ line="1210">passed-in @string pointer, with all the
4338944028 uppercase characters converted to lowercase in place,
4339044029 with semantics that exactly match g_ascii_tolower().</doc>
4339144030 <type name="String" c:type="GString*"/>
@@ -43394,7 +44033,7 @@ as a va_list.</doc>
4339444033 <instance-parameter name="string" transfer-ownership="none">
4339544034 <doc xml:space="preserve"
4339644035 filename="glib/gstring.c"
43397- line="1174">a GString</doc>
44036+ line="1206">a GString</doc>
4339844037 <type name="String" c:type="GString*"/>
4339944038 </instance-parameter>
4340044039 </parameters>
@@ -43402,12 +44041,12 @@ as a va_list.</doc>
4340244041 <method name="ascii_up" c:identifier="g_string_ascii_up">
4340344042 <doc xml:space="preserve"
4340444043 filename="glib/gstring.c"
43405- line="1203">Converts all lowercase ASCII letters to uppercase ASCII letters.</doc>
43406- <source-position filename="glib/gstring.h" line="163"/>
44044+ line="1235">Converts all lowercase ASCII letters to uppercase ASCII letters.</doc>
44045+ <source-position filename="glib/gstring.h" line="165"/>
4340744046 <return-value transfer-ownership="none">
4340844047 <doc xml:space="preserve"
4340944048 filename="glib/gstring.c"
43410- line="1209">passed-in @string pointer, with all the
44049+ line="1241">passed-in @string pointer, with all the
4341144050 lowercase characters converted to uppercase in place,
4341244051 with semantics that exactly match g_ascii_toupper().</doc>
4341344052 <type name="String" c:type="GString*"/>
@@ -43416,7 +44055,7 @@ as a va_list.</doc>
4341644055 <instance-parameter name="string" transfer-ownership="none">
4341744056 <doc xml:space="preserve"
4341844057 filename="glib/gstring.c"
43419- line="1205">a GString</doc>
44058+ line="1237">a GString</doc>
4342044059 <type name="String" c:type="GString*"/>
4342144060 </instance-parameter>
4342244061 </parameters>
@@ -43424,55 +44063,78 @@ as a va_list.</doc>
4342444063 <method name="assign" c:identifier="g_string_assign">
4342544064 <doc xml:space="preserve"
4342644065 filename="glib/gstring.c"
43427- line="365">Copies the bytes from a string into a #GString,
44066+ line="397">Copies the bytes from a string into a #GString,
4342844067 destroying any previous contents. It is rather like
4342944068 the standard strcpy() function, except that you do not
4343044069 have to worry about having enough space to copy the string.</doc>
43431- <source-position filename="glib/gstring.h" line="91"/>
44070+ <source-position filename="glib/gstring.h" line="93"/>
4343244071 <return-value transfer-ownership="none">
4343344072 <doc xml:space="preserve"
4343444073 filename="glib/gstring.c"
43435- line="376">@string</doc>
44074+ line="408">@string</doc>
4343644075 <type name="String" c:type="GString*"/>
4343744076 </return-value>
4343844077 <parameters>
4343944078 <instance-parameter name="string" transfer-ownership="none">
4344044079 <doc xml:space="preserve"
4344144080 filename="glib/gstring.c"
43442- line="367">the destination #GString. Its current contents
44081+ line="399">the destination #GString. Its current contents
4344344082 are destroyed.</doc>
4344444083 <type name="String" c:type="GString*"/>
4344544084 </instance-parameter>
4344644085 <parameter name="rval" transfer-ownership="none">
4344744086 <doc xml:space="preserve"
4344844087 filename="glib/gstring.c"
43449- line="369">the string to copy into @string</doc>
44088+ line="401">the string to copy into @string</doc>
4345044089 <type name="utf8" c:type="const gchar*"/>
4345144090 </parameter>
4345244091 </parameters>
4345344092 </method>
44093+ <method name="copy" c:identifier="g_string_copy" version="2.86">
44094+ <doc xml:space="preserve"
44095+ filename="glib/gstring.c"
44096+ line="217">Copies the [struct@GLib.String] instance and its contents.
44097+
44098+This will preserve the allocation length of the [struct@GLib.String] in the
44099+copy.</doc>
44100+ <source-position filename="glib/gstring.h" line="62"/>
44101+ <return-value transfer-ownership="full">
44102+ <doc xml:space="preserve"
44103+ filename="glib/gstring.c"
44104+ line="226">a copy of @string</doc>
44105+ <type name="String" c:type="GString*"/>
44106+ </return-value>
44107+ <parameters>
44108+ <instance-parameter name="string" transfer-ownership="none">
44109+ <doc xml:space="preserve"
44110+ filename="glib/gstring.c"
44111+ line="219">a string</doc>
44112+ <type name="String" c:type="GString*"/>
44113+ </instance-parameter>
44114+ </parameters>
44115+ </method>
4345444116 <method name="down"
4345544117 c:identifier="g_string_down"
4345644118 deprecated="1"
4345744119 deprecated-version="2.2">
4345844120 <doc xml:space="preserve"
4345944121 filename="glib/gstring.c"
43460- line="1234">Converts a #GString to lowercase.</doc>
44122+ line="1266">Converts a #GString to lowercase.</doc>
4346144123 <doc-deprecated xml:space="preserve">This function uses the locale-specific
4346244124 tolower() function, which is almost never the right thing.
4346344125 Use g_string_ascii_down() or g_utf8_strdown() instead.</doc-deprecated>
43464- <source-position filename="glib/gstring.h" line="291"/>
44126+ <source-position filename="glib/gstring.h" line="293"/>
4346544127 <return-value transfer-ownership="none">
4346644128 <doc xml:space="preserve"
4346744129 filename="glib/gstring.c"
43468- line="1240">the #GString</doc>
44130+ line="1272">the #GString</doc>
4346944131 <type name="String" c:type="GString*"/>
4347044132 </return-value>
4347144133 <parameters>
4347244134 <instance-parameter name="string" transfer-ownership="none">
4347344135 <doc xml:space="preserve"
4347444136 filename="glib/gstring.c"
43475- line="1236">a #GString</doc>
44137+ line="1268">a #GString</doc>
4347644138 <type name="String" c:type="GString*"/>
4347744139 </instance-parameter>
4347844140 </parameters>
@@ -43480,13 +44142,13 @@ have to worry about having enough space to copy the string.</doc>
4348044142 <method name="equal" c:identifier="g_string_equal">
4348144143 <doc xml:space="preserve"
4348244144 filename="glib/gstring.c"
43483- line="304">Compares two strings for equality, returning %TRUE if they are equal.
44145+ line="336">Compares two strings for equality, returning %TRUE if they are equal.
4348444146 For use with #GHashTable.</doc>
43485- <source-position filename="glib/gstring.h" line="86"/>
44147+ <source-position filename="glib/gstring.h" line="88"/>
4348644148 <return-value transfer-ownership="none">
4348744149 <doc xml:space="preserve"
4348844150 filename="glib/gstring.c"
43489- line="312">%TRUE if the strings are the same length and contain the
44151+ line="344">%TRUE if the strings are the same length and contain the
4349044152 same bytes</doc>
4349144153 <type name="gboolean" c:type="gboolean"/>
4349244154 </return-value>
@@ -43494,13 +44156,13 @@ For use with #GHashTable.</doc>
4349444156 <instance-parameter name="v" transfer-ownership="none">
4349544157 <doc xml:space="preserve"
4349644158 filename="glib/gstring.c"
43497- line="306">a #GString</doc>
44159+ line="338">a #GString</doc>
4349844160 <type name="String" c:type="const GString*"/>
4349944161 </instance-parameter>
4350044162 <parameter name="v2" transfer-ownership="none">
4350144163 <doc xml:space="preserve"
4350244164 filename="glib/gstring.c"
43503- line="307">another #GString</doc>
44165+ line="339">another #GString</doc>
4350444166 <type name="String" c:type="const GString*"/>
4350544167 </parameter>
4350644168 </parameters>
@@ -43508,32 +44170,32 @@ For use with #GHashTable.</doc>
4350844170 <method name="erase" c:identifier="g_string_erase">
4350944171 <doc xml:space="preserve"
4351044172 filename="glib/gstring.c"
43511- line="963">Removes @len bytes from a #GString, starting at position @pos.
44173+ line="995">Removes @len bytes from a #GString, starting at position @pos.
4351244174 The rest of the #GString is shifted down to fill the gap.</doc>
43513- <source-position filename="glib/gstring.h" line="152"/>
44175+ <source-position filename="glib/gstring.h" line="154"/>
4351444176 <return-value transfer-ownership="none">
4351544177 <doc xml:space="preserve"
4351644178 filename="glib/gstring.c"
43517- line="973">@string</doc>
44179+ line="1005">@string</doc>
4351844180 <type name="String" c:type="GString*"/>
4351944181 </return-value>
4352044182 <parameters>
4352144183 <instance-parameter name="string" transfer-ownership="none">
4352244184 <doc xml:space="preserve"
4352344185 filename="glib/gstring.c"
43524- line="965">a #GString</doc>
44186+ line="997">a #GString</doc>
4352544187 <type name="String" c:type="GString*"/>
4352644188 </instance-parameter>
4352744189 <parameter name="pos" transfer-ownership="none">
4352844190 <doc xml:space="preserve"
4352944191 filename="glib/gstring.c"
43530- line="966">the position of the content to remove</doc>
44192+ line="998">the position of the content to remove</doc>
4353144193 <type name="gssize" c:type="gssize"/>
4353244194 </parameter>
4353344195 <parameter name="len" transfer-ownership="none">
4353444196 <doc xml:space="preserve"
4353544197 filename="glib/gstring.c"
43536- line="967">the number of bytes to remove, or -1 to remove all
44198+ line="999">the number of bytes to remove, or -1 to remove all
4353744199 following bytes</doc>
4353844200 <type name="gssize" c:type="gssize"/>
4353944201 </parameter>
@@ -43542,18 +44204,18 @@ The rest of the #GString is shifted down to fill the gap.</doc>
4354244204 <method name="free" c:identifier="g_string_free">
4354344205 <doc xml:space="preserve"
4354444206 filename="glib/gstring.c"
43545- line="217">Frees the memory allocated for the #GString.
44207+ line="249">Frees the memory allocated for the #GString.
4354644208 If @free_segment is %TRUE it also frees the character data. If
4354744209 it's %FALSE, the caller gains ownership of the buffer and must
4354844210 free it after use with g_free().
4354944211
4355044212 Instead of passing %FALSE to this function, consider using
4355144213 g_string_free_and_steal().</doc>
43552- <source-position filename="glib/gstring.h" line="62"/>
44214+ <source-position filename="glib/gstring.h" line="64"/>
4355344215 <return-value transfer-ownership="full" nullable="1">
4355444216 <doc xml:space="preserve"
4355544217 filename="glib/gstring.c"
43556- line="230">the character data of @string
44218+ line="262">the character data of @string
4355744219 (i.e. %NULL if @free_segment is %TRUE)</doc>
4355844220 <type name="utf8" c:type="gchar*"/>
4355944221 </return-value>
@@ -43561,13 +44223,13 @@ g_string_free_and_steal().</doc>
4356144223 <instance-parameter name="string" transfer-ownership="full">
4356244224 <doc xml:space="preserve"
4356344225 filename="glib/gstring.c"
43564- line="219">a #GString</doc>
44226+ line="251">a #GString</doc>
4356544227 <type name="String" c:type="GString*"/>
4356644228 </instance-parameter>
4356744229 <parameter name="free_segment" transfer-ownership="none">
4356844230 <doc xml:space="preserve"
4356944231 filename="glib/gstring.c"
43570- line="220">if %TRUE, the actual character data is freed as well</doc>
44232+ line="252">if %TRUE, the actual character data is freed as well</doc>
4357144233 <type name="gboolean" c:type="gboolean"/>
4357244234 </parameter>
4357344235 </parameters>
@@ -43577,22 +44239,22 @@ g_string_free_and_steal().</doc>
4357744239 version="2.76">
4357844240 <doc xml:space="preserve"
4357944241 filename="glib/gstring.c"
43580- line="254">Frees the memory allocated for the #GString.
44242+ line="286">Frees the memory allocated for the #GString.
4358144243
4358244244 The caller gains ownership of the buffer and
4358344245 must free it after use with g_free().</doc>
43584- <source-position filename="glib/gstring.h" line="65"/>
44246+ <source-position filename="glib/gstring.h" line="67"/>
4358544247 <return-value transfer-ownership="full">
4358644248 <doc xml:space="preserve"
4358744249 filename="glib/gstring.c"
43588- line="263">the character data of @string</doc>
44250+ line="295">the character data of @string</doc>
4358944251 <type name="utf8" c:type="gchar*"/>
4359044252 </return-value>
4359144253 <parameters>
4359244254 <instance-parameter name="string" transfer-ownership="full">
4359344255 <doc xml:space="preserve"
4359444256 filename="glib/gstring.c"
43595- line="256">a #GString</doc>
44257+ line="288">a #GString</doc>
4359644258 <type name="String" c:type="GString*"/>
4359744259 </instance-parameter>
4359844260 </parameters>
@@ -43602,7 +44264,7 @@ must free it after use with g_free().</doc>
4360244264 version="2.34">
4360344265 <doc xml:space="preserve"
4360444266 filename="glib/gstring.c"
43605- line="273">Transfers ownership of the contents of @string to a newly allocated
44267+ line="305">Transfers ownership of the contents of @string to a newly allocated
4360644268 #GBytes. The #GString structure itself is deallocated, and it is
4360744269 therefore invalid to use @string after invoking this function.
4360844270
@@ -43610,18 +44272,18 @@ Note that while #GString ensures that its buffer always has a
4361044272 trailing nul character (not reflected in its "len"), the returned
4361144273 #GBytes does not include this extra nul; i.e. it has length exactly
4361244274 equal to the "len" member.</doc>
43613- <source-position filename="glib/gstring.h" line="84"/>
44275+ <source-position filename="glib/gstring.h" line="86"/>
4361444276 <return-value transfer-ownership="full">
4361544277 <doc xml:space="preserve"
4361644278 filename="glib/gstring.c"
43617- line="286">A newly allocated #GBytes containing contents of @string; @string itself is freed</doc>
44279+ line="318">A newly allocated #GBytes containing contents of @string; @string itself is freed</doc>
4361844280 <type name="Bytes" c:type="GBytes*"/>
4361944281 </return-value>
4362044282 <parameters>
4362144283 <instance-parameter name="string" transfer-ownership="full">
4362244284 <doc xml:space="preserve"
4362344285 filename="glib/gstring.c"
43624- line="275">a #GString</doc>
44286+ line="307">a #GString</doc>
4362544287 <type name="String" c:type="GString*"/>
4362644288 </instance-parameter>
4362744289 </parameters>
@@ -43629,19 +44291,19 @@ equal to the "len" member.</doc>
4362944291 <method name="hash" c:identifier="g_string_hash">
4363044292 <doc xml:space="preserve"
4363144293 filename="glib/gstring.c"
43632- line="340">Creates a hash code for @str; for use with #GHashTable.</doc>
43633- <source-position filename="glib/gstring.h" line="89"/>
44294+ line="372">Creates a hash code for @str; for use with #GHashTable.</doc>
44295+ <source-position filename="glib/gstring.h" line="91"/>
4363444296 <return-value transfer-ownership="none">
4363544297 <doc xml:space="preserve"
4363644298 filename="glib/gstring.c"
43637- line="346">hash code for @str</doc>
44299+ line="378">hash code for @str</doc>
4363844300 <type name="guint" c:type="guint"/>
4363944301 </return-value>
4364044302 <parameters>
4364144303 <instance-parameter name="str" transfer-ownership="none">
4364244304 <doc xml:space="preserve"
4364344305 filename="glib/gstring.c"
43644- line="342">a string to hash</doc>
44306+ line="374">a string to hash</doc>
4364544307 <type name="String" c:type="const GString*"/>
4364644308 </instance-parameter>
4364744309 </parameters>
@@ -43649,32 +44311,32 @@ equal to the "len" member.</doc>
4364944311 <method name="insert" c:identifier="g_string_insert">
4365044312 <doc xml:space="preserve"
4365144313 filename="glib/gstring.c"
43652- line="741">Inserts a copy of a string into a #GString,
44314+ line="773">Inserts a copy of a string into a #GString,
4365344315 expanding it if necessary.</doc>
43654- <source-position filename="glib/gstring.h" line="131"/>
44316+ <source-position filename="glib/gstring.h" line="133"/>
4365544317 <return-value transfer-ownership="none">
4365644318 <doc xml:space="preserve"
4365744319 filename="glib/gstring.c"
43658- line="750">@string</doc>
44320+ line="782">@string</doc>
4365944321 <type name="String" c:type="GString*"/>
4366044322 </return-value>
4366144323 <parameters>
4366244324 <instance-parameter name="string" transfer-ownership="none">
4366344325 <doc xml:space="preserve"
4366444326 filename="glib/gstring.c"
43665- line="743">a #GString</doc>
44327+ line="775">a #GString</doc>
4366644328 <type name="String" c:type="GString*"/>
4366744329 </instance-parameter>
4366844330 <parameter name="pos" transfer-ownership="none">
4366944331 <doc xml:space="preserve"
4367044332 filename="glib/gstring.c"
43671- line="744">the position to insert the copy of the string</doc>
44333+ line="776">the position to insert the copy of the string</doc>
4367244334 <type name="gssize" c:type="gssize"/>
4367344335 </parameter>
4367444336 <parameter name="val" transfer-ownership="none">
4367544337 <doc xml:space="preserve"
4367644338 filename="glib/gstring.c"
43677- line="745">the string to insert</doc>
44339+ line="777">the string to insert</doc>
4367844340 <type name="utf8" c:type="const gchar*"/>
4367944341 </parameter>
4368044342 </parameters>
@@ -43682,31 +44344,31 @@ expanding it if necessary.</doc>
4368244344 <method name="insert_c" c:identifier="g_string_insert_c">
4368344345 <doc xml:space="preserve"
4368444346 filename="glib/gstring.c"
43685- line="760">Inserts a byte into a #GString, expanding it if necessary.</doc>
43686- <source-position filename="glib/gstring.h" line="135"/>
44347+ line="792">Inserts a byte into a #GString, expanding it if necessary.</doc>
44348+ <source-position filename="glib/gstring.h" line="137"/>
4368744349 <return-value transfer-ownership="none">
4368844350 <doc xml:space="preserve"
4368944351 filename="glib/gstring.c"
43690- line="768">@string</doc>
44352+ line="800">@string</doc>
4369144353 <type name="String" c:type="GString*"/>
4369244354 </return-value>
4369344355 <parameters>
4369444356 <instance-parameter name="string" transfer-ownership="none">
4369544357 <doc xml:space="preserve"
4369644358 filename="glib/gstring.c"
43697- line="762">a #GString</doc>
44359+ line="794">a #GString</doc>
4369844360 <type name="String" c:type="GString*"/>
4369944361 </instance-parameter>
4370044362 <parameter name="pos" transfer-ownership="none">
4370144363 <doc xml:space="preserve"
4370244364 filename="glib/gstring.c"
43703- line="763">the position to insert the byte</doc>
44365+ line="795">the position to insert the byte</doc>
4370444366 <type name="gssize" c:type="gssize"/>
4370544367 </parameter>
4370644368 <parameter name="c" transfer-ownership="none">
4370744369 <doc xml:space="preserve"
4370844370 filename="glib/gstring.c"
43709- line="764">the byte to insert</doc>
44371+ line="796">the byte to insert</doc>
4371044372 <type name="gchar" c:type="gchar"/>
4371144373 </parameter>
4371244374 </parameters>
@@ -43714,7 +44376,7 @@ expanding it if necessary.</doc>
4371444376 <method name="insert_len" c:identifier="g_string_insert_len">
4371544377 <doc xml:space="preserve"
4371644378 filename="glib/gstring.c"
43717- line="447">Inserts @len bytes of @val into @string at @pos.
44379+ line="479">Inserts @len bytes of @val into @string at @pos.
4371844380
4371944381 If @len is positive, @val may contain embedded nuls and need
4372044382 not be nul-terminated. It is the caller's responsibility to
@@ -43724,37 +44386,37 @@ If @len is negative, @val must be nul-terminated and @len
4372444386 is considered to request the entire string length.
4372544387
4372644388 If @pos is -1, bytes are inserted at the end of the string.</doc>
43727- <source-position filename="glib/gstring.h" line="100"/>
44389+ <source-position filename="glib/gstring.h" line="102"/>
4372844390 <return-value transfer-ownership="none">
4372944391 <doc xml:space="preserve"
4373044392 filename="glib/gstring.c"
43731- line="466">@string</doc>
44393+ line="498">@string</doc>
4373244394 <type name="String" c:type="GString*"/>
4373344395 </return-value>
4373444396 <parameters>
4373544397 <instance-parameter name="string" transfer-ownership="none">
4373644398 <doc xml:space="preserve"
4373744399 filename="glib/gstring.c"
43738- line="449">a #GString</doc>
44400+ line="481">a #GString</doc>
4373944401 <type name="String" c:type="GString*"/>
4374044402 </instance-parameter>
4374144403 <parameter name="pos" transfer-ownership="none">
4374244404 <doc xml:space="preserve"
4374344405 filename="glib/gstring.c"
43744- line="450">position in @string where insertion should
44406+ line="482">position in @string where insertion should
4374544407 happen, or -1 for at the end</doc>
4374644408 <type name="gssize" c:type="gssize"/>
4374744409 </parameter>
4374844410 <parameter name="val" transfer-ownership="none">
4374944411 <doc xml:space="preserve"
4375044412 filename="glib/gstring.c"
43751- line="452">bytes to insert</doc>
44413+ line="484">bytes to insert</doc>
4375244414 <type name="utf8" c:type="const gchar*"/>
4375344415 </parameter>
4375444416 <parameter name="len" transfer-ownership="none">
4375544417 <doc xml:space="preserve"
4375644418 filename="glib/gstring.c"
43757- line="453">number of bytes of @val to insert, or -1 for all of @val</doc>
44419+ line="485">number of bytes of @val to insert, or -1 for all of @val</doc>
4375844420 <type name="gssize" c:type="gssize"/>
4375944421 </parameter>
4376044422 </parameters>
@@ -43762,33 +44424,33 @@ If @pos is -1, bytes are inserted at the end of the string.</doc>
4376244424 <method name="insert_unichar" c:identifier="g_string_insert_unichar">
4376344425 <doc xml:space="preserve"
4376444426 filename="glib/gstring.c"
43765- line="803">Converts a Unicode character into UTF-8, and insert it
44427+ line="835">Converts a Unicode character into UTF-8, and insert it
4376644428 into the string at the given position.</doc>
43767- <source-position filename="glib/gstring.h" line="139"/>
44429+ <source-position filename="glib/gstring.h" line="141"/>
4376844430 <return-value transfer-ownership="none">
4376944431 <doc xml:space="preserve"
4377044432 filename="glib/gstring.c"
43771- line="813">@string</doc>
44433+ line="845">@string</doc>
4377244434 <type name="String" c:type="GString*"/>
4377344435 </return-value>
4377444436 <parameters>
4377544437 <instance-parameter name="string" transfer-ownership="none">
4377644438 <doc xml:space="preserve"
4377744439 filename="glib/gstring.c"
43778- line="805">a #GString</doc>
44440+ line="837">a #GString</doc>
4377944441 <type name="String" c:type="GString*"/>
4378044442 </instance-parameter>
4378144443 <parameter name="pos" transfer-ownership="none">
4378244444 <doc xml:space="preserve"
4378344445 filename="glib/gstring.c"
43784- line="806">the position at which to insert character, or -1
44446+ line="838">the position at which to insert character, or -1
4378544447 to append at the end of the string</doc>
4378644448 <type name="gssize" c:type="gssize"/>
4378744449 </parameter>
4378844450 <parameter name="wc" transfer-ownership="none">
4378944451 <doc xml:space="preserve"
4379044452 filename="glib/gstring.c"
43791- line="808">a Unicode character</doc>
44453+ line="840">a Unicode character</doc>
4379244454 <type name="gunichar" c:type="gunichar"/>
4379344455 </parameter>
4379444456 </parameters>
@@ -43798,31 +44460,31 @@ into the string at the given position.</doc>
4379844460 version="2.14">
4379944461 <doc xml:space="preserve"
4380044462 filename="glib/gstring.c"
43801- line="890">Overwrites part of a string, lengthening it if necessary.</doc>
43802- <source-position filename="glib/gstring.h" line="143"/>
44463+ line="922">Overwrites part of a string, lengthening it if necessary.</doc>
44464+ <source-position filename="glib/gstring.h" line="145"/>
4380344465 <return-value transfer-ownership="none">
4380444466 <doc xml:space="preserve"
4380544467 filename="glib/gstring.c"
43806- line="898">@string</doc>
44468+ line="930">@string</doc>
4380744469 <type name="String" c:type="GString*"/>
4380844470 </return-value>
4380944471 <parameters>
4381044472 <instance-parameter name="string" transfer-ownership="none">
4381144473 <doc xml:space="preserve"
4381244474 filename="glib/gstring.c"
43813- line="892">a #GString</doc>
44475+ line="924">a #GString</doc>
4381444476 <type name="String" c:type="GString*"/>
4381544477 </instance-parameter>
4381644478 <parameter name="pos" transfer-ownership="none">
4381744479 <doc xml:space="preserve"
4381844480 filename="glib/gstring.c"
43819- line="893">the position at which to start overwriting</doc>
44481+ line="925">the position at which to start overwriting</doc>
4382044482 <type name="gsize" c:type="gsize"/>
4382144483 </parameter>
4382244484 <parameter name="val" transfer-ownership="none">
4382344485 <doc xml:space="preserve"
4382444486 filename="glib/gstring.c"
43825- line="894">the string that will overwrite the @string starting at @pos</doc>
44487+ line="926">the string that will overwrite the @string starting at @pos</doc>
4382644488 <type name="utf8" c:type="const gchar*"/>
4382744489 </parameter>
4382844490 </parameters>
@@ -43832,38 +44494,38 @@ into the string at the given position.</doc>
4383244494 version="2.14">
4383344495 <doc xml:space="preserve"
4383444496 filename="glib/gstring.c"
43835- line="911">Overwrites part of a string, lengthening it if necessary.
44497+ line="943">Overwrites part of a string, lengthening it if necessary.
4383644498 This function will work with embedded nuls.</doc>
43837- <source-position filename="glib/gstring.h" line="147"/>
44499+ <source-position filename="glib/gstring.h" line="149"/>
4383844500 <return-value transfer-ownership="none">
4383944501 <doc xml:space="preserve"
4384044502 filename="glib/gstring.c"
43841- line="921">@string</doc>
44503+ line="953">@string</doc>
4384244504 <type name="String" c:type="GString*"/>
4384344505 </return-value>
4384444506 <parameters>
4384544507 <instance-parameter name="string" transfer-ownership="none">
4384644508 <doc xml:space="preserve"
4384744509 filename="glib/gstring.c"
43848- line="913">a #GString</doc>
44510+ line="945">a #GString</doc>
4384944511 <type name="String" c:type="GString*"/>
4385044512 </instance-parameter>
4385144513 <parameter name="pos" transfer-ownership="none">
4385244514 <doc xml:space="preserve"
4385344515 filename="glib/gstring.c"
43854- line="914">the position at which to start overwriting</doc>
44516+ line="946">the position at which to start overwriting</doc>
4385544517 <type name="gsize" c:type="gsize"/>
4385644518 </parameter>
4385744519 <parameter name="val" transfer-ownership="none">
4385844520 <doc xml:space="preserve"
4385944521 filename="glib/gstring.c"
43860- line="915">the string that will overwrite the @string starting at @pos</doc>
44522+ line="947">the string that will overwrite the @string starting at @pos</doc>
4386144523 <type name="utf8" c:type="const gchar*"/>
4386244524 </parameter>
4386344525 <parameter name="len" transfer-ownership="none">
4386444526 <doc xml:space="preserve"
4386544527 filename="glib/gstring.c"
43866- line="916">the number of bytes to write from @val</doc>
44528+ line="948">the number of bytes to write from @val</doc>
4386744529 <type name="gssize" c:type="gssize"/>
4386844530 </parameter>
4386944531 </parameters>
@@ -43871,26 +44533,26 @@ This function will work with embedded nuls.</doc>
4387144533 <method name="prepend" c:identifier="g_string_prepend">
4387244534 <doc xml:space="preserve"
4387344535 filename="glib/gstring.c"
43874- line="660">Adds a string on to the start of a #GString,
44536+ line="692">Adds a string on to the start of a #GString,
4387544537 expanding it if necessary.</doc>
43876- <source-position filename="glib/gstring.h" line="118"/>
44538+ <source-position filename="glib/gstring.h" line="120"/>
4387744539 <return-value transfer-ownership="none">
4387844540 <doc xml:space="preserve"
4387944541 filename="glib/gstring.c"
43880- line="668">@string</doc>
44542+ line="700">@string</doc>
4388144543 <type name="String" c:type="GString*"/>
4388244544 </return-value>
4388344545 <parameters>
4388444546 <instance-parameter name="string" transfer-ownership="none">
4388544547 <doc xml:space="preserve"
4388644548 filename="glib/gstring.c"
43887- line="662">a #GString</doc>
44549+ line="694">a #GString</doc>
4388844550 <type name="String" c:type="GString*"/>
4388944551 </instance-parameter>
4389044552 <parameter name="val" transfer-ownership="none">
4389144553 <doc xml:space="preserve"
4389244554 filename="glib/gstring.c"
43893- line="663">the string to prepend on the start of @string</doc>
44555+ line="695">the string to prepend on the start of @string</doc>
4389444556 <type name="utf8" c:type="const gchar*"/>
4389544557 </parameter>
4389644558 </parameters>
@@ -43898,26 +44560,26 @@ expanding it if necessary.</doc>
4389844560 <method name="prepend_c" c:identifier="g_string_prepend_c">
4389944561 <doc xml:space="preserve"
4390044562 filename="glib/gstring.c"
43901- line="703">Adds a byte onto the start of a #GString,
44563+ line="735">Adds a byte onto the start of a #GString,
4390244564 expanding it if necessary.</doc>
43903- <source-position filename="glib/gstring.h" line="121"/>
44565+ <source-position filename="glib/gstring.h" line="123"/>
4390444566 <return-value transfer-ownership="none">
4390544567 <doc xml:space="preserve"
4390644568 filename="glib/gstring.c"
43907- line="711">@string</doc>
44569+ line="743">@string</doc>
4390844570 <type name="String" c:type="GString*"/>
4390944571 </return-value>
4391044572 <parameters>
4391144573 <instance-parameter name="string" transfer-ownership="none">
4391244574 <doc xml:space="preserve"
4391344575 filename="glib/gstring.c"
43914- line="705">a #GString</doc>
44576+ line="737">a #GString</doc>
4391544577 <type name="String" c:type="GString*"/>
4391644578 </instance-parameter>
4391744579 <parameter name="c" transfer-ownership="none">
4391844580 <doc xml:space="preserve"
4391944581 filename="glib/gstring.c"
43920- line="706">the byte to prepend on the start of the #GString</doc>
44582+ line="738">the byte to prepend on the start of the #GString</doc>
4392144583 <type name="gchar" c:type="gchar"/>
4392244584 </parameter>
4392344585 </parameters>
@@ -43925,7 +44587,7 @@ expanding it if necessary.</doc>
4392544587 <method name="prepend_len" c:identifier="g_string_prepend_len">
4392644588 <doc xml:space="preserve"
4392744589 filename="glib/gstring.c"
43928- line="677">Prepends @len bytes of @val to @string.
44590+ line="709">Prepends @len bytes of @val to @string.
4392944591
4393044592 If @len is positive, @val may contain embedded nuls and need
4393144593 not be nul-terminated. It is the caller's responsibility to
@@ -43934,30 +44596,30 @@ ensure that @val has at least @len addressable bytes.
4393444596 If @len is negative, @val must be nul-terminated and @len
4393544597 is considered to request the entire string length. This
4393644598 makes g_string_prepend_len() equivalent to g_string_prepend().</doc>
43937- <source-position filename="glib/gstring.h" line="127"/>
44599+ <source-position filename="glib/gstring.h" line="129"/>
4393844600 <return-value transfer-ownership="none">
4393944601 <doc xml:space="preserve"
4394044602 filename="glib/gstring.c"
43941- line="693">@string</doc>
44603+ line="725">@string</doc>
4394244604 <type name="String" c:type="GString*"/>
4394344605 </return-value>
4394444606 <parameters>
4394544607 <instance-parameter name="string" transfer-ownership="none">
4394644608 <doc xml:space="preserve"
4394744609 filename="glib/gstring.c"
43948- line="679">a #GString</doc>
44610+ line="711">a #GString</doc>
4394944611 <type name="String" c:type="GString*"/>
4395044612 </instance-parameter>
4395144613 <parameter name="val" transfer-ownership="none">
4395244614 <doc xml:space="preserve"
4395344615 filename="glib/gstring.c"
43954- line="680">bytes to prepend</doc>
44616+ line="712">bytes to prepend</doc>
4395544617 <type name="utf8" c:type="const gchar*"/>
4395644618 </parameter>
4395744619 <parameter name="len" transfer-ownership="none">
4395844620 <doc xml:space="preserve"
4395944621 filename="glib/gstring.c"
43960- line="681">number of bytes in @val to prepend, or -1 for all of @val</doc>
44622+ line="713">number of bytes in @val to prepend, or -1 for all of @val</doc>
4396144623 <type name="gssize" c:type="gssize"/>
4396244624 </parameter>
4396344625 </parameters>
@@ -43965,26 +44627,26 @@ makes g_string_prepend_len() equivalent to g_string_prepend().</doc>
4396544627 <method name="prepend_unichar" c:identifier="g_string_prepend_unichar">
4396644628 <doc xml:space="preserve"
4396744629 filename="glib/gstring.c"
43968- line="722">Converts a Unicode character into UTF-8, and prepends it
44630+ line="754">Converts a Unicode character into UTF-8, and prepends it
4396944631 to the string.</doc>
43970- <source-position filename="glib/gstring.h" line="124"/>
44632+ <source-position filename="glib/gstring.h" line="126"/>
4397144633 <return-value transfer-ownership="none">
4397244634 <doc xml:space="preserve"
4397344635 filename="glib/gstring.c"
43974- line="730">@string</doc>
44636+ line="762">@string</doc>
4397544637 <type name="String" c:type="GString*"/>
4397644638 </return-value>
4397744639 <parameters>
4397844640 <instance-parameter name="string" transfer-ownership="none">
4397944641 <doc xml:space="preserve"
4398044642 filename="glib/gstring.c"
43981- line="724">a #GString</doc>
44643+ line="756">a #GString</doc>
4398244644 <type name="String" c:type="GString*"/>
4398344645 </instance-parameter>
4398444646 <parameter name="wc" transfer-ownership="none">
4398544647 <doc xml:space="preserve"
4398644648 filename="glib/gstring.c"
43987- line="725">a Unicode character</doc>
44649+ line="757">a Unicode character</doc>
4398844650 <type name="gunichar" c:type="gunichar"/>
4398944651 </parameter>
4399044652 </parameters>
@@ -43992,12 +44654,12 @@ to the string.</doc>
4399244654 <method name="printf" c:identifier="g_string_printf" introspectable="0">
4399344655 <doc xml:space="preserve"
4399444656 filename="glib/gstring.c"
43995- line="1377">Writes a formatted string into a #GString.
44657+ line="1409">Writes a formatted string into a #GString.
4399644658 This is similar to the standard sprintf() function,
4399744659 except that the #GString buffer automatically expands
4399844660 to contain the results. The previous contents of the
4399944661 #GString are destroyed.</doc>
44000- <source-position filename="glib/gstring.h" line="170"/>
44662+ <source-position filename="glib/gstring.h" line="172"/>
4400144663 <return-value transfer-ownership="none">
4400244664 <type name="none" c:type="void"/>
4400344665 </return-value>
@@ -44005,19 +44667,19 @@ to contain the results. The previous contents of the
4400544667 <instance-parameter name="string" transfer-ownership="none">
4400644668 <doc xml:space="preserve"
4400744669 filename="glib/gstring.c"
44008- line="1379">a #GString</doc>
44670+ line="1411">a #GString</doc>
4400944671 <type name="String" c:type="GString*"/>
4401044672 </instance-parameter>
4401144673 <parameter name="format" transfer-ownership="none">
4401244674 <doc xml:space="preserve"
4401344675 filename="glib/gstring.c"
44014- line="1380">the string format. See the printf() documentation</doc>
44676+ line="1412">the string format. See the printf() documentation</doc>
4401544677 <type name="utf8" c:type="const gchar*"/>
4401644678 </parameter>
4401744679 <parameter name="..." transfer-ownership="none">
4401844680 <doc xml:space="preserve"
4401944681 filename="glib/gstring.c"
44020- line="1381">the parameters to insert into the format string</doc>
44682+ line="1413">the parameters to insert into the format string</doc>
4402144683 <varargs/>
4402244684 </parameter>
4402344685 </parameters>
@@ -44025,7 +44687,7 @@ to contain the results. The previous contents of the
4402544687 <method name="replace" c:identifier="g_string_replace" version="2.68">
4402644688 <doc xml:space="preserve"
4402744689 filename="glib/gstring.c"
44028- line="1008">Replaces the string @find with the string @replace in a #GString up to
44690+ line="1040">Replaces the string @find with the string @replace in a #GString up to
4402944691 @limit times. If the number of instances of @find in the #GString is
4403044692 less than @limit, all instances are replaced. If @limit is `0`,
4403144693 all instances of @find are replaced.
@@ -44034,36 +44696,36 @@ If @find is the empty string, since versions 2.69.1 and 2.68.4 the
4403444696 replacement will be inserted no more than once per possible position
4403544697 (beginning of string, end of string and between characters). This did
4403644698 not work correctly in earlier versions.</doc>
44037- <source-position filename="glib/gstring.h" line="156"/>
44699+ <source-position filename="glib/gstring.h" line="158"/>
4403844700 <return-value transfer-ownership="none">
4403944701 <doc xml:space="preserve"
4404044702 filename="glib/gstring.c"
44041- line="1026">the number of find and replace operations performed.</doc>
44703+ line="1058">the number of find and replace operations performed.</doc>
4404244704 <type name="guint" c:type="guint"/>
4404344705 </return-value>
4404444706 <parameters>
4404544707 <instance-parameter name="string" transfer-ownership="none">
4404644708 <doc xml:space="preserve"
4404744709 filename="glib/gstring.c"
44048- line="1010">a #GString</doc>
44710+ line="1042">a #GString</doc>
4404944711 <type name="String" c:type="GString*"/>
4405044712 </instance-parameter>
4405144713 <parameter name="find" transfer-ownership="none">
4405244714 <doc xml:space="preserve"
4405344715 filename="glib/gstring.c"
44054- line="1011">the string to find in @string</doc>
44716+ line="1043">the string to find in @string</doc>
4405544717 <type name="utf8" c:type="const gchar*"/>
4405644718 </parameter>
4405744719 <parameter name="replace" transfer-ownership="none">
4405844720 <doc xml:space="preserve"
4405944721 filename="glib/gstring.c"
44060- line="1012">the string to insert in place of @find</doc>
44722+ line="1044">the string to insert in place of @find</doc>
4406144723 <type name="utf8" c:type="const gchar*"/>
4406244724 </parameter>
4406344725 <parameter name="limit" transfer-ownership="none">
4406444726 <doc xml:space="preserve"
4406544727 filename="glib/gstring.c"
44066- line="1013">the maximum instances of @find to replace with @replace, or `0` for
44728+ line="1045">the maximum instances of @find to replace with @replace, or `0` for
4406744729 no limit</doc>
4406844730 <type name="guint" c:type="guint"/>
4406944731 </parameter>
@@ -44072,29 +44734,29 @@ no limit</doc>
4407244734 <method name="set_size" c:identifier="g_string_set_size">
4407344735 <doc xml:space="preserve"
4407444736 filename="glib/gstring.c"
44075- line="419">Sets the length of a #GString. If the length is less than
44737+ line="451">Sets the length of a #GString. If the length is less than
4407644738 the current length, the string will be truncated. If the
4407744739 length is greater than the current length, the contents
4407844740 of the newly added area are undefined. (However, as
4407944741 always, string-&gt;str[string-&gt;len] will be a nul byte.)</doc>
44080- <source-position filename="glib/gstring.h" line="97"/>
44742+ <source-position filename="glib/gstring.h" line="99"/>
4408144743 <return-value transfer-ownership="none">
4408244744 <doc xml:space="preserve"
4408344745 filename="glib/gstring.c"
44084- line="430">@string</doc>
44746+ line="462">@string</doc>
4408544747 <type name="String" c:type="GString*"/>
4408644748 </return-value>
4408744749 <parameters>
4408844750 <instance-parameter name="string" transfer-ownership="none">
4408944751 <doc xml:space="preserve"
4409044752 filename="glib/gstring.c"
44091- line="421">a #GString</doc>
44753+ line="453">a #GString</doc>
4409244754 <type name="String" c:type="GString*"/>
4409344755 </instance-parameter>
4409444756 <parameter name="len" transfer-ownership="none">
4409544757 <doc xml:space="preserve"
4409644758 filename="glib/gstring.c"
44097- line="422">the new length</doc>
44759+ line="454">the new length</doc>
4409844760 <type name="gsize" c:type="gsize"/>
4409944761 </parameter>
4410044762 </parameters>
@@ -44102,25 +44764,25 @@ always, string-&gt;str[string-&gt;len] will be a nul byte.)</doc>
4410244764 <method name="truncate" c:identifier="g_string_truncate">
4410344765 <doc xml:space="preserve"
4410444766 filename="glib/gstring.c"
44105- line="398">Cuts off the end of the GString, leaving the first @len bytes.</doc>
44106- <source-position filename="glib/gstring.h" line="94"/>
44767+ line="430">Cuts off the end of the GString, leaving the first @len bytes.</doc>
44768+ <source-position filename="glib/gstring.h" line="96"/>
4410744769 <return-value transfer-ownership="none">
4410844770 <doc xml:space="preserve"
4410944771 filename="glib/gstring.c"
44110- line="405">@string</doc>
44772+ line="437">@string</doc>
4411144773 <type name="String" c:type="GString*"/>
4411244774 </return-value>
4411344775 <parameters>
4411444776 <instance-parameter name="string" transfer-ownership="none">
4411544777 <doc xml:space="preserve"
4411644778 filename="glib/gstring.c"
44117- line="400">a #GString</doc>
44779+ line="432">a #GString</doc>
4411844780 <type name="String" c:type="GString*"/>
4411944781 </instance-parameter>
4412044782 <parameter name="len" transfer-ownership="none">
4412144783 <doc xml:space="preserve"
4412244784 filename="glib/gstring.c"
44123- line="401">the new size of @string</doc>
44785+ line="433">the new size of @string</doc>
4412444786 <type name="gsize" c:type="gsize"/>
4412544787 </parameter>
4412644788 </parameters>
@@ -44131,22 +44793,22 @@ always, string-&gt;str[string-&gt;len] will be a nul byte.)</doc>
4413144793 deprecated-version="2.2">
4413244794 <doc xml:space="preserve"
4413344795 filename="glib/gstring.c"
44134- line="1268">Converts a #GString to uppercase.</doc>
44796+ line="1300">Converts a #GString to uppercase.</doc>
4413544797 <doc-deprecated xml:space="preserve">This function uses the locale-specific
4413644798 toupper() function, which is almost never the right thing.
4413744799 Use g_string_ascii_up() or g_utf8_strup() instead.</doc-deprecated>
44138- <source-position filename="glib/gstring.h" line="293"/>
44800+ <source-position filename="glib/gstring.h" line="295"/>
4413944801 <return-value transfer-ownership="none">
4414044802 <doc xml:space="preserve"
4414144803 filename="glib/gstring.c"
44142- line="1274">@string</doc>
44804+ line="1306">@string</doc>
4414344805 <type name="String" c:type="GString*"/>
4414444806 </return-value>
4414544807 <parameters>
4414644808 <instance-parameter name="string" transfer-ownership="none">
4414744809 <doc xml:space="preserve"
4414844810 filename="glib/gstring.c"
44149- line="1270">a #GString</doc>
44811+ line="1302">a #GString</doc>
4415044812 <type name="String" c:type="GString*"/>
4415144813 </instance-parameter>
4415244814 </parameters>
@@ -44157,10 +44819,10 @@ always, string-&gt;str[string-&gt;len] will be a nul byte.)</doc>
4415744819 introspectable="0">
4415844820 <doc xml:space="preserve"
4415944821 filename="glib/gstring.c"
44160- line="1341">Writes a formatted string into a #GString.
44822+ line="1373">Writes a formatted string into a #GString.
4416144823 This function is similar to g_string_printf() except that
4416244824 the arguments to the format string are passed as a va_list.</doc>
44163- <source-position filename="glib/gstring.h" line="165"/>
44825+ <source-position filename="glib/gstring.h" line="167"/>
4416444826 <return-value transfer-ownership="none">
4416544827 <type name="none" c:type="void"/>
4416644828 </return-value>
@@ -44168,19 +44830,19 @@ the arguments to the format string are passed as a va_list.</doc>
4416844830 <instance-parameter name="string" transfer-ownership="none">
4416944831 <doc xml:space="preserve"
4417044832 filename="glib/gstring.c"
44171- line="1343">a #GString</doc>
44833+ line="1375">a #GString</doc>
4417244834 <type name="String" c:type="GString*"/>
4417344835 </instance-parameter>
4417444836 <parameter name="format" transfer-ownership="none">
4417544837 <doc xml:space="preserve"
4417644838 filename="glib/gstring.c"
44177- line="1344">the string format. See the printf() documentation</doc>
44839+ line="1376">the string format. See the printf() documentation</doc>
4417844840 <type name="utf8" c:type="const gchar*"/>
4417944841 </parameter>
4418044842 <parameter name="args" transfer-ownership="none">
4418144843 <doc xml:space="preserve"
4418244844 filename="glib/gstring.c"
44183- line="1345">the parameters to insert into the format string</doc>
44845+ line="1377">the parameters to insert into the format string</doc>
4418444846 <type name="va_list" c:type="va_list"/>
4418544847 </parameter>
4418644848 </parameters>
@@ -46315,7 +46977,7 @@ can be stopped by calling [func@GLib.ThreadPool.stop_unused_threads].</doc>
4631546977 <method name="free" c:identifier="g_thread_pool_free">
4631646978 <doc xml:space="preserve"
4631746979 filename="glib/gthreadpool.c"
46318- line="876">Frees all resources allocated for @pool.
46980+ line="888">Frees all resources allocated for @pool.
4631946981
4632046982 If @immediate is %TRUE, no new task is processed for @pool.
4632146983 Otherwise @pool is not freed before the last task is processed.
@@ -46337,19 +46999,19 @@ After calling this function @pool must not be used anymore.</doc>
4633746999 <instance-parameter name="pool" transfer-ownership="none">
4633847000 <doc xml:space="preserve"
4633947001 filename="glib/gthreadpool.c"
46340- line="878">a #GThreadPool</doc>
47002+ line="890">a #GThreadPool</doc>
4634147003 <type name="ThreadPool" c:type="GThreadPool*"/>
4634247004 </instance-parameter>
4634347005 <parameter name="immediate" transfer-ownership="none">
4634447006 <doc xml:space="preserve"
4634547007 filename="glib/gthreadpool.c"
46346- line="879">should @pool shut down immediately?</doc>
47008+ line="891">should @pool shut down immediately?</doc>
4634747009 <type name="gboolean" c:type="gboolean"/>
4634847010 </parameter>
4634947011 <parameter name="wait_" transfer-ownership="none">
4635047012 <doc xml:space="preserve"
4635147013 filename="glib/gthreadpool.c"
46352- line="880">should the function wait for all tasks to be finished?</doc>
47014+ line="892">should the function wait for all tasks to be finished?</doc>
4635347015 <type name="gboolean" c:type="gboolean"/>
4635447016 </parameter>
4635547017 </parameters>
@@ -46358,19 +47020,19 @@ After calling this function @pool must not be used anymore.</doc>
4635847020 c:identifier="g_thread_pool_get_max_threads">
4635947021 <doc xml:space="preserve"
4636047022 filename="glib/gthreadpool.c"
46361- line="800">Returns the maximal number of threads for @pool.</doc>
47023+ line="812">Returns the maximal number of threads for @pool.</doc>
4636247024 <source-position filename="glib/gthreadpool.h" line="86"/>
4636347025 <return-value transfer-ownership="none">
4636447026 <doc xml:space="preserve"
4636547027 filename="glib/gthreadpool.c"
46366- line="806">the maximal number of threads</doc>
47028+ line="818">the maximal number of threads</doc>
4636747029 <type name="gint" c:type="gint"/>
4636847030 </return-value>
4636947031 <parameters>
4637047032 <instance-parameter name="pool" transfer-ownership="none">
4637147033 <doc xml:space="preserve"
4637247034 filename="glib/gthreadpool.c"
46373- line="802">a #GThreadPool</doc>
47035+ line="814">a #GThreadPool</doc>
4637447036 <type name="ThreadPool" c:type="GThreadPool*"/>
4637547037 </instance-parameter>
4637647038 </parameters>
@@ -46379,19 +47041,19 @@ After calling this function @pool must not be used anymore.</doc>
4637947041 c:identifier="g_thread_pool_get_num_threads">
4638047042 <doc xml:space="preserve"
4638147043 filename="glib/gthreadpool.c"
46382- line="826">Returns the number of threads currently running in @pool.</doc>
47044+ line="838">Returns the number of threads currently running in @pool.</doc>
4638347045 <source-position filename="glib/gthreadpool.h" line="88"/>
4638447046 <return-value transfer-ownership="none">
4638547047 <doc xml:space="preserve"
4638647048 filename="glib/gthreadpool.c"
46387- line="832">the number of threads currently running</doc>
47049+ line="844">the number of threads currently running</doc>
4638847050 <type name="guint" c:type="guint"/>
4638947051 </return-value>
4639047052 <parameters>
4639147053 <instance-parameter name="pool" transfer-ownership="none">
4639247054 <doc xml:space="preserve"
4639347055 filename="glib/gthreadpool.c"
46394- line="828">a #GThreadPool</doc>
47056+ line="840">a #GThreadPool</doc>
4639547057 <type name="ThreadPool" c:type="GThreadPool*"/>
4639647058 </instance-parameter>
4639747059 </parameters>
@@ -46401,20 +47063,20 @@ After calling this function @pool must not be used anymore.</doc>
4640147063 version="2.46">
4640247064 <doc xml:space="preserve"
4640347065 filename="glib/gthreadpool.c"
46404- line="1120">Moves the item to the front of the queue of unprocessed
47066+ line="1132">Moves the item to the front of the queue of unprocessed
4640547067 items, so that it will be processed next.</doc>
4640647068 <source-position filename="glib/gthreadpool.h" line="78"/>
4640747069 <return-value transfer-ownership="none">
4640847070 <doc xml:space="preserve"
4640947071 filename="glib/gthreadpool.c"
46410- line="1128">%TRUE if the item was found and moved</doc>
47072+ line="1140">%TRUE if the item was found and moved</doc>
4641147073 <type name="gboolean" c:type="gboolean"/>
4641247074 </return-value>
4641347075 <parameters>
4641447076 <instance-parameter name="pool" transfer-ownership="none">
4641547077 <doc xml:space="preserve"
4641647078 filename="glib/gthreadpool.c"
46417- line="1122">a #GThreadPool</doc>
47079+ line="1134">a #GThreadPool</doc>
4641847080 <type name="ThreadPool" c:type="GThreadPool*"/>
4641947081 </instance-parameter>
4642047082 <parameter name="data"
@@ -46423,7 +47085,7 @@ items, so that it will be processed next.</doc>
4642347085 allow-none="1">
4642447086 <doc xml:space="preserve"
4642547087 filename="glib/gthreadpool.c"
46426- line="1123">an unprocessed item in the pool</doc>
47088+ line="1135">an unprocessed item in the pool</doc>
4642747089 <type name="gpointer" c:type="gpointer"/>
4642847090 </parameter>
4642947091 </parameters>
@@ -46431,7 +47093,7 @@ items, so that it will be processed next.</doc>
4643147093 <method name="push" c:identifier="g_thread_pool_push" throws="1">
4643247094 <doc xml:space="preserve"
4643347095 filename="glib/gthreadpool.c"
46434- line="668">Inserts @data into the list of tasks to be executed by @pool.
47096+ line="680">Inserts @data into the list of tasks to be executed by @pool.
4643547097
4643647098 When the number of currently running threads is lower than the
4643747099 maximal allowed number of threads, a new thread is started (or
@@ -46449,14 +47111,14 @@ Before version 2.32, this function did not return a success status.</doc>
4644947111 <return-value transfer-ownership="none">
4645047112 <doc xml:space="preserve"
4645147113 filename="glib/gthreadpool.c"
46452- line="689">%TRUE on success, %FALSE if an error occurred</doc>
47114+ line="701">%TRUE on success, %FALSE if an error occurred</doc>
4645347115 <type name="gboolean" c:type="gboolean"/>
4645447116 </return-value>
4645547117 <parameters>
4645647118 <instance-parameter name="pool" transfer-ownership="none">
4645747119 <doc xml:space="preserve"
4645847120 filename="glib/gthreadpool.c"
46459- line="670">a #GThreadPool</doc>
47121+ line="682">a #GThreadPool</doc>
4646047122 <type name="ThreadPool" c:type="GThreadPool*"/>
4646147123 </instance-parameter>
4646247124 <parameter name="data"
@@ -46465,7 +47127,7 @@ Before version 2.32, this function did not return a success status.</doc>
4646547127 allow-none="1">
4646647128 <doc xml:space="preserve"
4646747129 filename="glib/gthreadpool.c"
46468- line="671">a new task for @pool</doc>
47130+ line="683">a new task for @pool</doc>
4646947131 <type name="gpointer" c:type="gpointer"/>
4647047132 </parameter>
4647147133 </parameters>
@@ -46475,7 +47137,7 @@ Before version 2.32, this function did not return a success status.</doc>
4647547137 throws="1">
4647647138 <doc xml:space="preserve"
4647747139 filename="glib/gthreadpool.c"
46478- line="726">Sets the maximal allowed number of threads for @pool.
47140+ line="738">Sets the maximal allowed number of threads for @pool.
4647947141 A value of -1 means that the maximal number of threads
4648047142 is unlimited. If @pool is an exclusive thread pool, setting
4648147143 the maximal number of threads to -1 is not allowed.
@@ -46499,20 +47161,20 @@ Before version 2.32, this function did not return a success status.</doc>
4649947161 <return-value transfer-ownership="none">
4650047162 <doc xml:space="preserve"
4650147163 filename="glib/gthreadpool.c"
46502- line="754">%TRUE on success, %FALSE if an error occurred</doc>
47164+ line="766">%TRUE on success, %FALSE if an error occurred</doc>
4650347165 <type name="gboolean" c:type="gboolean"/>
4650447166 </return-value>
4650547167 <parameters>
4650647168 <instance-parameter name="pool" transfer-ownership="none">
4650747169 <doc xml:space="preserve"
4650847170 filename="glib/gthreadpool.c"
46509- line="728">a #GThreadPool</doc>
47171+ line="740">a #GThreadPool</doc>
4651047172 <type name="ThreadPool" c:type="GThreadPool*"/>
4651147173 </instance-parameter>
4651247174 <parameter name="max_threads" transfer-ownership="none">
4651347175 <doc xml:space="preserve"
4651447176 filename="glib/gthreadpool.c"
46515- line="729">a new maximal number of threads for @pool,
47177+ line="741">a new maximal number of threads for @pool,
4651647178 or -1 for unlimited</doc>
4651747179 <type name="gint" c:type="gint"/>
4651847180 </parameter>
@@ -46524,7 +47186,7 @@ Before version 2.32, this function did not return a success status.</doc>
4652447186 introspectable="0">
4652547187 <doc xml:space="preserve"
4652647188 filename="glib/gthreadpool.c"
46527- line="1072">Sets the function used to sort the list of tasks. This allows the
47189+ line="1084">Sets the function used to sort the list of tasks. This allows the
4652847190 tasks to be processed by a priority determined by @func, and not
4652947191 just in the order in which they were added to the pool.
4653047192
@@ -46541,13 +47203,13 @@ created.</doc>
4654147203 <instance-parameter name="pool" transfer-ownership="none">
4654247204 <doc xml:space="preserve"
4654347205 filename="glib/gthreadpool.c"
46544- line="1074">a #GThreadPool</doc>
47206+ line="1086">a #GThreadPool</doc>
4654547207 <type name="ThreadPool" c:type="GThreadPool*"/>
4654647208 </instance-parameter>
4654747209 <parameter name="func" transfer-ownership="none" closure="1">
4654847210 <doc xml:space="preserve"
4654947211 filename="glib/gthreadpool.c"
46550- line="1075">the #GCompareDataFunc used to sort the list of tasks.
47212+ line="1087">the #GCompareDataFunc used to sort the list of tasks.
4655147213 This function is passed two tasks. It should return
4655247214 0 if the order in which they are handled does not matter,
4655347215 a negative value if the first task should be processed before
@@ -46561,7 +47223,7 @@ created.</doc>
4656147223 allow-none="1">
4656247224 <doc xml:space="preserve"
4656347225 filename="glib/gthreadpool.c"
46564- line="1081">user data passed to @func</doc>
47226+ line="1093">user data passed to @func</doc>
4656547227 <type name="gpointer" c:type="gpointer"/>
4656647228 </parameter>
4656747229 </parameters>
@@ -46569,19 +47231,19 @@ created.</doc>
4656947231 <method name="unprocessed" c:identifier="g_thread_pool_unprocessed">
4657047232 <doc xml:space="preserve"
4657147233 filename="glib/gthreadpool.c"
46572- line="852">Returns the number of tasks still unprocessed in @pool.</doc>
47234+ line="864">Returns the number of tasks still unprocessed in @pool.</doc>
4657347235 <source-position filename="glib/gthreadpool.h" line="72"/>
4657447236 <return-value transfer-ownership="none">
4657547237 <doc xml:space="preserve"
4657647238 filename="glib/gthreadpool.c"
46577- line="858">the number of unprocessed tasks</doc>
47239+ line="870">the number of unprocessed tasks</doc>
4657847240 <type name="guint" c:type="guint"/>
4657947241 </return-value>
4658047242 <parameters>
4658147243 <instance-parameter name="pool" transfer-ownership="none">
4658247244 <doc xml:space="preserve"
4658347245 filename="glib/gthreadpool.c"
46584- line="854">a #GThreadPool</doc>
47246+ line="866">a #GThreadPool</doc>
4658547247 <type name="ThreadPool" c:type="GThreadPool*"/>
4658647248 </instance-parameter>
4658747249 </parameters>
@@ -46591,7 +47253,7 @@ created.</doc>
4659147253 version="2.10">
4659247254 <doc xml:space="preserve"
4659347255 filename="glib/gthreadpool.c"
46594- line="1191">This function will return the maximum @interval that a
47256+ line="1203">This function will return the maximum @interval that a
4659547257 thread will wait in the thread pool for new tasks before
4659647258 being stopped.
4659747259
@@ -46601,7 +47263,7 @@ pool for new work are not stopped.</doc>
4660147263 <return-value transfer-ownership="none">
4660247264 <doc xml:space="preserve"
4660347265 filename="glib/gthreadpool.c"
46604- line="1201">the maximum @interval (milliseconds) to wait
47266+ line="1213">the maximum @interval (milliseconds) to wait
4660547267 for new tasks in the thread pool before stopping the
4660647268 thread</doc>
4660747269 <type name="guint" c:type="guint"/>
@@ -46611,12 +47273,12 @@ pool for new work are not stopped.</doc>
4661147273 c:identifier="g_thread_pool_get_max_unused_threads">
4661247274 <doc xml:space="preserve"
4661347275 filename="glib/gthreadpool.c"
46614- line="1028">Returns the maximal allowed number of unused threads.</doc>
47276+ line="1040">Returns the maximal allowed number of unused threads.</doc>
4661547277 <source-position filename="glib/gthreadpool.h" line="93"/>
4661647278 <return-value transfer-ownership="none">
4661747279 <doc xml:space="preserve"
4661847280 filename="glib/gthreadpool.c"
46619- line="1033">the maximal number of unused threads</doc>
47281+ line="1045">the maximal number of unused threads</doc>
4662047282 <type name="gint" c:type="gint"/>
4662147283 </return-value>
4662247284 </function>
@@ -46624,12 +47286,12 @@ pool for new work are not stopped.</doc>
4662447286 c:identifier="g_thread_pool_get_num_unused_threads">
4662547287 <doc xml:space="preserve"
4662647288 filename="glib/gthreadpool.c"
46627- line="1041">Returns the number of currently unused threads.</doc>
47289+ line="1053">Returns the number of currently unused threads.</doc>
4662847290 <source-position filename="glib/gthreadpool.h" line="95"/>
4662947291 <return-value transfer-ownership="none">
4663047292 <doc xml:space="preserve"
4663147293 filename="glib/gthreadpool.c"
46632- line="1046">the number of currently unused threads</doc>
47294+ line="1058">the number of currently unused threads</doc>
4663347295 <type name="guint" c:type="guint"/>
4663447296 </return-value>
4663547297 </function>
@@ -46791,7 +47453,7 @@ and freed before all tasks have been executed.
4679147453 version="2.10">
4679247454 <doc xml:space="preserve"
4679347455 filename="glib/gthreadpool.c"
46794- line="1150">This function will set the maximum @interval that a thread
47456+ line="1162">This function will set the maximum @interval that a thread
4679547457 waiting in the pool for new tasks can be idle for before
4679647458 being stopped. This function is similar to calling
4679747459 g_thread_pool_stop_unused_threads() on a regular timeout,
@@ -46808,7 +47470,7 @@ The default value is 15000 (15 seconds).</doc>
4680847470 <parameter name="interval" transfer-ownership="none">
4680947471 <doc xml:space="preserve"
4681047472 filename="glib/gthreadpool.c"
46811- line="1152">the maximum @interval (in milliseconds)
47473+ line="1164">the maximum @interval (in milliseconds)
4681247474 a thread can be idle</doc>
4681347475 <type name="guint" c:type="guint"/>
4681447476 </parameter>
@@ -46818,7 +47480,7 @@ The default value is 15000 (15 seconds).</doc>
4681847480 c:identifier="g_thread_pool_set_max_unused_threads">
4681947481 <doc xml:space="preserve"
4682047482 filename="glib/gthreadpool.c"
46821- line="989">Sets the maximal number of unused threads to @max_threads.
47483+ line="1001">Sets the maximal number of unused threads to @max_threads.
4682247484 If @max_threads is -1, no limit is imposed on the number
4682347485 of unused threads.
4682447486
@@ -46831,7 +47493,7 @@ The default value is 8 since GLib 2.84. Previously the default value was 2.</doc
4683147493 <parameter name="max_threads" transfer-ownership="none">
4683247494 <doc xml:space="preserve"
4683347495 filename="glib/gthreadpool.c"
46834- line="991">maximal number of unused threads</doc>
47496+ line="1003">maximal number of unused threads</doc>
4683547497 <type name="gint" c:type="gint"/>
4683647498 </parameter>
4683747499 </parameters>
@@ -46840,7 +47502,7 @@ The default value is 8 since GLib 2.84. Previously the default value was 2.</doc
4684047502 c:identifier="g_thread_pool_stop_unused_threads">
4684147503 <doc xml:space="preserve"
4684247504 filename="glib/gthreadpool.c"
46843- line="1054">Stops all currently unused threads. This does not change the
47505+ line="1066">Stops all currently unused threads. This does not change the
4684447506 maximal number of unused threads. This function can be used to
4684547507 regularly stop all unused threads e.g. from g_timeout_add().</doc>
4684647508 <source-position filename="glib/gthreadpool.h" line="97"/>
@@ -49390,7 +50052,7 @@ if the passed node was already the first one.</doc>
4939050052 deprecated-version="2.26">
4939150053 <doc xml:space="preserve"
4939250054 filename="glib/deprecated/grel.c"
49393- line="109">The #GTuples struct is used to return records (or tuples) from the
50055+ line="113">The #GTuples struct is used to return records (or tuples) from the
4939450056 #GRelation by g_relation_select(). It only contains one public
4939550057 member - the number of records that matched. To access the matched
4939650058 records, you must use g_tuples_index().</doc>
@@ -49399,7 +50061,7 @@ records, you must use g_tuples_index().</doc>
4939950061 <field name="len" writable="1">
4940050062 <doc xml:space="preserve"
4940150063 filename="glib/deprecated/grel.c"
49402- line="111">the number of records that matched.</doc>
50064+ line="115">the number of records that matched.</doc>
4940350065 <type name="guint" c:type="guint"/>
4940450066 </field>
4940550067 <method name="destroy"
@@ -49408,7 +50070,7 @@ records, you must use g_tuples_index().</doc>
4940850070 deprecated-version="2.26">
4940950071 <doc xml:space="preserve"
4941050072 filename="glib/deprecated/grel.c"
49411- line="556">Frees the records which were returned by g_relation_select(). This
50073+ line="582">Frees the records which were returned by g_relation_select(). This
4941250074 should always be called after g_relation_select() when you are
4941350075 finished with the records. The records are not removed from the
4941450076 #GRelation.</doc>
@@ -49421,7 +50083,7 @@ finished with the records. The records are not removed from the
4942150083 <instance-parameter name="tuples" transfer-ownership="none">
4942250084 <doc xml:space="preserve"
4942350085 filename="glib/deprecated/grel.c"
49424- line="558">the tuple data to free.</doc>
50086+ line="584">the tuple data to free.</doc>
4942550087 <type name="Tuples" c:type="GTuples*"/>
4942650088 </instance-parameter>
4942750089 </parameters>
@@ -49432,7 +50094,7 @@ finished with the records. The records are not removed from the
4943250094 deprecated-version="2.26">
4943350095 <doc xml:space="preserve"
4943450096 filename="glib/deprecated/grel.c"
49435- line="579">Gets a field from the records returned by g_relation_select(). It
50097+ line="605">Gets a field from the records returned by g_relation_select(). It
4943650098 returns the given field of the record at the given index. The
4943750099 returned value should not be changed.</doc>
4943850100 <doc-deprecated xml:space="preserve">Rarely used API</doc-deprecated>
@@ -49440,26 +50102,26 @@ returned value should not be changed.</doc>
4944050102 <return-value transfer-ownership="none" nullable="1">
4944150103 <doc xml:space="preserve"
4944250104 filename="glib/deprecated/grel.c"
49443- line="589">the field of the record.</doc>
50105+ line="615">the field of the record.</doc>
4944450106 <type name="gpointer" c:type="gpointer"/>
4944550107 </return-value>
4944650108 <parameters>
4944750109 <instance-parameter name="tuples" transfer-ownership="none">
4944850110 <doc xml:space="preserve"
4944950111 filename="glib/deprecated/grel.c"
49450- line="581">the tuple data, returned by g_relation_select().</doc>
50112+ line="607">the tuple data, returned by g_relation_select().</doc>
4945150113 <type name="Tuples" c:type="GTuples*"/>
4945250114 </instance-parameter>
4945350115 <parameter name="index_" transfer-ownership="none">
4945450116 <doc xml:space="preserve"
4945550117 filename="glib/deprecated/grel.c"
49456- line="582">the index of the record.</doc>
50118+ line="608">the index of the record.</doc>
4945750119 <type name="gint" c:type="gint"/>
4945850120 </parameter>
4945950121 <parameter name="field" transfer-ownership="none">
4946050122 <doc xml:space="preserve"
4946150123 filename="glib/deprecated/grel.c"
49462- line="583">the field to return.</doc>
50124+ line="609">the field to return.</doc>
4946350125 <type name="gint" c:type="gint"/>
4946450126 </parameter>
4946550127 </parameters>
@@ -54666,7 +55328,7 @@ Since 2.24</doc>
5466655328 version="2.32">
5466755329 <doc xml:space="preserve"
5466855330 filename="glib/gversionmacros.h"
54669- line="451">A macro that should be defined by the user prior to including
55331+ line="460">A macro that should be defined by the user prior to including
5467055332 the glib.h header.
5467155333 The definition should be one of the predefined GLib version
5467255334 macros: %GLIB_VERSION_2_26, %GLIB_VERSION_2_28,...
@@ -54678,7 +55340,7 @@ If the compiler is configured to warn about the use of deprecated
5467855340 functions, then using functions that were deprecated in version
5467955341 %GLIB_VERSION_MIN_REQUIRED or earlier will cause warnings (but
5468055342 using functions deprecated in later releases will not).</doc>
54681- <source-position filename="glib/gversionmacros.h" line="477"/>
55343+ <source-position filename="glib/gversionmacros.h" line="486"/>
5468255344 <type name="gint" c:type="gint"/>
5468355345 </constant>
5468455346 <record name="Variant"
@@ -60880,7 +61542,7 @@ On non-Windows platforms, expands to nothing.</doc>
6088061542 introspectable="0">
6088161543 <doc xml:space="preserve"
6088261544 filename="glib/gutils.c"
60883- line="3335">A wrapper for the POSIX abort() function.
61545+ line="3337">A wrapper for the POSIX abort() function.
6088461546
6088561547 On Windows it is a function that makes extra effort (including a call
6088661548 to abort()) to ensure that a debugger-catchable exception is thrown
@@ -60892,7 +61554,7 @@ See your C library manual for more details about abort().</doc>
6089261554 <function name="access" c:identifier="g_access" version="2.8">
6089361555 <doc xml:space="preserve"
6089461556 filename="glib/gstdio.c"
60895- line="914">A wrapper for the POSIX access() function. This function is used to
61557+ line="925">A wrapper for the POSIX access() function. This function is used to
6089661558 test a pathname for one or several of read, write or execute
6089761559 permissions, or just existence.
6089861560
@@ -60908,7 +61570,7 @@ See your C library manual for more details about access().</doc>
6090861570 <return-value transfer-ownership="none">
6090961571 <doc xml:space="preserve"
6091061572 filename="glib/gstdio.c"
60911- line="933">zero if the pathname refers to an existing file system
61573+ line="944">zero if the pathname refers to an existing file system
6091261574 object that has all the tested permissions, or -1 otherwise
6091361575 or on error.</doc>
6091461576 <type name="gint" c:type="int"/>
@@ -60917,14 +61579,14 @@ See your C library manual for more details about access().</doc>
6091761579 <parameter name="filename" transfer-ownership="none">
6091861580 <doc xml:space="preserve"
6091961581 filename="glib/gstdio.c"
60920- line="916">a pathname in the GLib file name encoding
61582+ line="927">a pathname in the GLib file name encoding
6092161583 (UTF-8 on Windows)</doc>
6092261584 <type name="filename" c:type="const gchar*"/>
6092361585 </parameter>
6092461586 <parameter name="mode" transfer-ownership="none">
6092561587 <doc xml:space="preserve"
6092661588 filename="glib/gstdio.c"
60927- line="918">as in access()</doc>
61589+ line="929">as in access()</doc>
6092861590 <type name="gint" c:type="int"/>
6092961591 </parameter>
6093061592 </parameters>
@@ -61136,23 +61798,23 @@ Note that the @size argument will be evaluated multiple times.</doc>
6113661798 introspectable="0">
6113761799 <doc xml:space="preserve"
6113861800 filename="glib/garray.c"
61139- line="574">Adds the value on to the end of the array. The array will grow in
61801+ line="582">Adds the value on to the end of the array. The array will grow in
6114061802 size automatically if necessary.
6114161803
61142-g_array_append_val() is a macro which uses a reference to the value
61804+`g_array_append_val()` is a macro which uses a reference to the value
6114361805 parameter @v. This means that you cannot use it with literal values
61144-such as "27". You must use variables.</doc>
61806+such as `"27"`. You must use variables.</doc>
6114561807 <source-position filename="glib/garray.h" line="66"/>
6114661808 <parameters>
6114761809 <parameter name="a">
6114861810 <doc xml:space="preserve"
6114961811 filename="glib/garray.c"
61150- line="576">a #GArray</doc>
61812+ line="584">an array</doc>
6115161813 </parameter>
6115261814 <parameter name="v">
6115361815 <doc xml:space="preserve"
6115461816 filename="glib/garray.c"
61155- line="577">the value to append to the #GArray</doc>
61817+ line="585">the value to append to the #GArray</doc>
6115661818 </parameter>
6115761819 </parameters>
6115861820 </function-macro>
@@ -61161,23 +61823,23 @@ such as "27". You must use variables.</doc>
6116161823 introspectable="0">
6116261824 <doc xml:space="preserve"
6116361825 filename="glib/garray.c"
61164- line="75">Returns the element of a #GArray at the given index. The return
61826+ line="75">Returns the element of a `GArray` at the given index. The return
6116561827 value is cast to the given type. This is the main way to read or write an
61166-element in a #GArray.
61828+element in a `GArray`.
6116761829
6116861830 Writing an element is typically done by reference, as in the following
61169-example. This example gets a pointer to an element in a #GArray, and then
61831+example. This example gets a pointer to an element in a `GArray`, and then
6117061832 writes to a field in it:
61171-|[&lt;!-- language="C" --&gt;
61833+```c
6117261834 EDayViewEvent *event;
6117361835 // This gets a pointer to the 4th element in the array of
6117461836 // EDayViewEvent structs.
6117561837 event = &amp;g_array_index (events, EDayViewEvent, 3);
6117661838 event-&gt;start_time = g_get_current_time ();
61177-]|
61839+```
6117861840
6117961841 This example reads from and writes to an array of integers:
61180-|[&lt;!-- language="C" --&gt;
61842+```c
6118161843 g_autoptr(GArray) int_array = g_array_new (FALSE, FALSE, sizeof (guint));
6118261844 for (guint i = 0; i &lt; 10; i++)
6118361845 g_array_append_val (int_array, i);
@@ -61185,13 +61847,13 @@ This example reads from and writes to an array of integers:
6118561847 guint *my_int = &amp;g_array_index (int_array, guint, 1);
6118661848 g_print ("Int at index 1 is %u; decrementing it\n", *my_int);
6118761849 *my_int = *my_int - 1;
61188-]|</doc>
61850+```</doc>
6118961851 <source-position filename="glib/garray.h" line="69"/>
6119061852 <parameters>
6119161853 <parameter name="a">
6119261854 <doc xml:space="preserve"
6119361855 filename="glib/garray.c"
61194- line="77">a #GArray</doc>
61856+ line="77">an array</doc>
6119561857 </parameter>
6119661858 <parameter name="t">
6119761859 <doc xml:space="preserve"
@@ -61210,27 +61872,27 @@ This example reads from and writes to an array of integers:
6121061872 introspectable="0">
6121161873 <doc xml:space="preserve"
6121261874 filename="glib/garray.c"
61213- line="696">Inserts an element into an array at the given index.
61875+ line="704">Inserts an element into an array at the given index.
6121461876
61215-g_array_insert_val() is a macro which uses a reference to the value
61877+`g_array_insert_val()` is a macro which uses a reference to the value
6121661878 parameter @v. This means that you cannot use it with literal values
61217-such as "27". You must use variables.</doc>
61879+such as `"27"`. You must use variables.</doc>
6121861880 <source-position filename="glib/garray.h" line="68"/>
6121961881 <parameters>
6122061882 <parameter name="a">
6122161883 <doc xml:space="preserve"
6122261884 filename="glib/garray.c"
61223- line="698">a #GArray</doc>
61885+ line="706">an array</doc>
6122461886 </parameter>
6122561887 <parameter name="i">
6122661888 <doc xml:space="preserve"
6122761889 filename="glib/garray.c"
61228- line="699">the index to place the element at</doc>
61890+ line="707">the index to place the element at</doc>
6122961891 </parameter>
6123061892 <parameter name="v">
6123161893 <doc xml:space="preserve"
6123261894 filename="glib/garray.c"
61233- line="700">the value to insert into the array</doc>
61895+ line="708">the value to insert into the array</doc>
6123461896 </parameter>
6123561897 </parameters>
6123661898 </function-macro>
@@ -61241,27 +61903,27 @@ such as "27". You must use variables.</doc>
6124161903 introspectable="0">
6124261904 <doc xml:space="preserve"
6124361905 filename="glib/garray.c"
61244- line="147">Creates a new #GArray with @data as array data, @len as length and a
61906+ line="147">Creates a new `GArray` with @data as array data, @len as length and a
6124561907 reference count of 1.
6124661908
6124761909 This avoids having to copy the data manually, when it can just be
6124861910 inherited.
61249-After this call, @data belongs to the #GArray and may no longer be
61911+After this call, @data belongs to the `GArray` and may no longer be
6125061912 modified by the caller. The memory of @data has to be dynamically
61251-allocated and will eventually be freed with g_free().
61913+allocated and will eventually be freed with [func@GLib.free].
6125261914
6125361915 In case the elements need to be cleared when the array is freed, use
61254-g_array_set_clear_func() to set a #GDestroyNotify function to perform
61255-such task.
61916+[func@GLib.Array.set_clear_func] to set a [callback@GLib.DestroyNotify]
61917+function to perform such task.
6125661918
61257-Do not use it if @len or @element_size are greater than %G_MAXUINT.
61258-#GArray stores the length of its data in #guint, which may be shorter
61259-than #gsize.</doc>
61919+Do not use it if @len or @element_size are greater than
61920+ [`G_MAXUINT`](types.html#guint). `GArray` stores the length of its data in
61921+ `guint`, which may be shorter than `gsize`.</doc>
6126061922 <source-position filename="glib/garray.h" line="76"/>
6126161923 <return-value transfer-ownership="full">
6126261924 <doc xml:space="preserve"
6126361925 filename="glib/garray.c"
61264- line="173">A new #GArray</doc>
61926+ line="173">The new #GArray</doc>
6126561927 <array name="GLib.Array" c:type="GArray*">
6126661928 <type name="gpointer" c:type="gpointer"/>
6126761929 </array>
@@ -61274,7 +61936,7 @@ than #gsize.</doc>
6127461936 <doc xml:space="preserve"
6127561937 filename="glib/garray.c"
6127661938 line="149">an array of
61277- elements of @element_size, or %NULL for an empty array</doc>
61939+ elements of @element_size</doc>
6127861940 <array length="1" zero-terminated="0" c:type="gpointer">
6127961941 <type name="gpointer" c:type="gpointer"/>
6128061942 </array>
@@ -61288,7 +61950,7 @@ than #gsize.</doc>
6128861950 <parameter name="clear" transfer-ownership="none">
6128961951 <doc xml:space="preserve"
6129061952 filename="glib/garray.c"
61291- line="152">%TRUE if #GArray elements should be automatically cleared
61953+ line="152">if true, `GArray` elements should be automatically cleared
6129261954 to 0 when they are allocated</doc>
6129361955 <type name="gboolean" c:type="gboolean"/>
6129461956 </parameter>
@@ -61307,39 +61969,43 @@ than #gsize.</doc>
6130761969 introspectable="0">
6130861970 <doc xml:space="preserve"
6130961971 filename="glib/garray.c"
61310- line="199">Creates a new #GArray with @data as array data, computing the length of it
61972+ line="199">Creates a new `GArray` with @data as array data, computing the length of it
6131161973 and setting the reference count to 1.
6131261974
6131361975 This avoids having to copy the data manually, when it can just be
6131461976 inherited.
61315-After this call, @data belongs to the #GArray and may no longer be
61977+After this call, @data belongs to the `GArray` and may no longer be
6131661978 modified by the caller. The memory of @data has to be dynamically
61317-allocated and will eventually be freed with g_free().
61979+allocated and will eventually be freed with [func@GLib.free].
6131861980
61319-The length is calculated by iterating through @data until the first %NULL
61981+The length is calculated by iterating through @data until the first `NULL`
6132061982 element is found.
6132161983
6132261984 In case the elements need to be cleared when the array is freed, use
61323-g_array_set_clear_func() to set a #GDestroyNotify function to perform
61324-such task.
61985+[func@GLib.Array.set_clear_func] to set a [callback@GLib.DestroyNotify]
61986+function to perform such task.
6132561987
61326-Do not use it if @data length or @element_size are greater than %G_MAXUINT.
61327-#GArray stores the length of its data in #guint, which may be shorter
61328-than #gsize.</doc>
61988+Do not use it if @data length or @element_size are greater than
61989+[`G_MAXUINT`](types.html#guint). `GArray` stores the length of its data in
61990+`guint`, which may be shorter than `gsize`.</doc>
6132961991 <source-position filename="glib/garray.h" line="81"/>
6133061992 <return-value transfer-ownership="full">
6133161993 <doc xml:space="preserve"
6133261994 filename="glib/garray.c"
61333- line="226">A new #GArray</doc>
61995+ line="227">The new `GArray`</doc>
6133461996 <array name="GLib.Array" c:type="GArray*">
6133561997 <type name="gpointer" c:type="gpointer"/>
6133661998 </array>
6133761999 </return-value>
6133862000 <parameters>
61339- <parameter name="data" transfer-ownership="none">
62001+ <parameter name="data"
62002+ transfer-ownership="full"
62003+ nullable="1"
62004+ allow-none="1">
6134062005 <doc xml:space="preserve"
6134162006 filename="glib/garray.c"
61342- line="201">an array of elements of @element_size</doc>
62007+ line="201">an array
62008+ of elements of @element_size, `NULL` terminated</doc>
6134362009 <array c:type="gpointer">
6134462010 <type name="gpointer" c:type="gpointer"/>
6134562011 </array>
@@ -61347,14 +62013,14 @@ than #gsize.</doc>
6134762013 <parameter name="clear" transfer-ownership="none">
6134862014 <doc xml:space="preserve"
6134962015 filename="glib/garray.c"
61350- line="202">%TRUE if #GArray elements should be automatically cleared
62016+ line="203">if true, `GArray` elements should be automatically cleared
6135162017 to 0 when they are allocated</doc>
6135262018 <type name="gboolean" c:type="gboolean"/>
6135362019 </parameter>
6135462020 <parameter name="element_size" transfer-ownership="none">
6135562021 <doc xml:space="preserve"
6135662022 filename="glib/garray.c"
61357- line="204">the size of each element in bytes</doc>
62023+ line="205">the size of each element in bytes</doc>
6135862024 <type name="gsize" c:type="gsize"/>
6135962025 </parameter>
6136062026 </parameters>
@@ -61364,34 +62030,34 @@ than #gsize.</doc>
6136462030 introspectable="0">
6136562031 <doc xml:space="preserve"
6136662032 filename="glib/garray.c"
61367- line="629">Adds the value on to the start of the array. The array will grow in
62033+ line="637">Adds the value on to the start of the array. The array will grow in
6136862034 size automatically if necessary.
6136962035
61370-This operation is slower than g_array_append_val() since the
62036+This operation is slower than [func@GLib.array_append_val] since the
6137162037 existing elements in the array have to be moved to make space for
6137262038 the new element.
6137362039
61374-g_array_prepend_val() is a macro which uses a reference to the value
62040+`g_array_prepend_val()` is a macro which uses a reference to the value
6137562041 parameter @v. This means that you cannot use it with literal values
61376-such as "27". You must use variables.</doc>
62042+such as `"27"`. You must use variables.</doc>
6137762043 <source-position filename="glib/garray.h" line="67"/>
6137862044 <parameters>
6137962045 <parameter name="a">
6138062046 <doc xml:space="preserve"
6138162047 filename="glib/garray.c"
61382- line="631">a #GArray</doc>
62048+ line="639">an array</doc>
6138362049 </parameter>
6138462050 <parameter name="v">
6138562051 <doc xml:space="preserve"
6138662052 filename="glib/garray.c"
61387- line="632">the value to prepend to the #GArray</doc>
62053+ line="640">the value to prepend to the #GArray</doc>
6138862054 </parameter>
6138962055 </parameters>
6139062056 </function-macro>
6139162057 <function name="ascii_digit_value" c:identifier="g_ascii_digit_value">
6139262058 <doc xml:space="preserve"
6139362059 filename="glib/gstrfuncs.c"
61394- line="1755">Determines the numeric value of a character as a decimal digit. If the
62060+ line="1759">Determines the numeric value of a character as a decimal digit. If the
6139562061 character is not a decimal digit according to [func@GLib.ascii_isdigit],
6139662062 `-1` is returned.
6139762063
@@ -61401,14 +62067,14 @@ there's no worry about sign extension if characters are signed.</doc>
6140162067 <return-value transfer-ownership="none">
6140262068 <doc xml:space="preserve"
6140362069 filename="glib/gstrfuncs.c"
61404- line="1766">the numerical value of @c if it is a decimal digit, `-1` otherwise</doc>
62070+ line="1770">the numerical value of @c if it is a decimal digit, `-1` otherwise</doc>
6140562071 <type name="gint" c:type="gint"/>
6140662072 </return-value>
6140762073 <parameters>
6140862074 <parameter name="c" transfer-ownership="none">
6140962075 <doc xml:space="preserve"
6141062076 filename="glib/gstrfuncs.c"
61411- line="1757">an ASCII character</doc>
62077+ line="1761">an ASCII character</doc>
6141262078 <type name="gchar" c:type="gchar"/>
6141362079 </parameter>
6141462080 </parameters>
@@ -61416,7 +62082,7 @@ there's no worry about sign extension if characters are signed.</doc>
6141662082 <function name="ascii_dtostr" c:identifier="g_ascii_dtostr">
6141762083 <doc xml:space="preserve"
6141862084 filename="glib/gstrfuncs.c"
61419- line="858">Converts a `gdouble` to a string, using the '.' as
62085+ line="862">Converts a `gdouble` to a string, using the '.' as
6142062086 decimal point.
6142162087
6142262088 This function generates enough precision that converting
@@ -61429,26 +62095,26 @@ nul character, which is always added.</doc>
6142962095 <return-value transfer-ownership="full">
6143062096 <doc xml:space="preserve"
6143162097 filename="glib/gstrfuncs.c"
61432- line="874">the pointer to the buffer with the converted string</doc>
62098+ line="878">the pointer to the buffer with the converted string</doc>
6143362099 <type name="utf8" c:type="gchar*"/>
6143462100 </return-value>
6143562101 <parameters>
6143662102 <parameter name="buffer" transfer-ownership="none">
6143762103 <doc xml:space="preserve"
6143862104 filename="glib/gstrfuncs.c"
61439- line="860">a buffer to place the resulting string in</doc>
62105+ line="864">a buffer to place the resulting string in</doc>
6144062106 <type name="utf8" c:type="gchar*"/>
6144162107 </parameter>
6144262108 <parameter name="buf_len" transfer-ownership="none">
6144362109 <doc xml:space="preserve"
6144462110 filename="glib/gstrfuncs.c"
61445- line="861">the length of the buffer</doc>
62111+ line="865">the length of the buffer</doc>
6144662112 <type name="gint" c:type="gint"/>
6144762113 </parameter>
6144862114 <parameter name="d" transfer-ownership="none">
6144962115 <doc xml:space="preserve"
6145062116 filename="glib/gstrfuncs.c"
61451- line="862">the value to convert</doc>
62117+ line="866">the value to convert</doc>
6145262118 <type name="gdouble" c:type="gdouble"/>
6145362119 </parameter>
6145462120 </parameters>
@@ -61456,7 +62122,7 @@ nul character, which is always added.</doc>
6145662122 <function name="ascii_formatd" c:identifier="g_ascii_formatd">
6145762123 <doc xml:space="preserve"
6145862124 filename="glib/gstrfuncs.c"
61459- line="887">Converts a `gdouble` to a string, using the '.' as
62125+ line="891">Converts a `gdouble` to a string, using the '.' as
6146062126 decimal point. To format the number you pass in
6146162127 a `printf()`-style format string. Allowed conversion
6146262128 specifiers are 'e', 'E', 'f', 'F', 'g' and 'G'.
@@ -61472,33 +62138,33 @@ string, use [func@GLib.ascii_dtostr].</doc>
6147262138 <return-value transfer-ownership="full">
6147362139 <doc xml:space="preserve"
6147462140 filename="glib/gstrfuncs.c"
61475- line="908">the pointer to the buffer with the converted string</doc>
62141+ line="912">the pointer to the buffer with the converted string</doc>
6147662142 <type name="utf8" c:type="gchar*"/>
6147762143 </return-value>
6147862144 <parameters>
6147962145 <parameter name="buffer" transfer-ownership="none">
6148062146 <doc xml:space="preserve"
6148162147 filename="glib/gstrfuncs.c"
61482- line="889">a buffer to place the resulting string in</doc>
62148+ line="893">a buffer to place the resulting string in</doc>
6148362149 <type name="utf8" c:type="gchar*"/>
6148462150 </parameter>
6148562151 <parameter name="buf_len" transfer-ownership="none">
6148662152 <doc xml:space="preserve"
6148762153 filename="glib/gstrfuncs.c"
61488- line="890">the length of the buffer</doc>
62154+ line="894">the length of the buffer</doc>
6148962155 <type name="gint" c:type="gint"/>
6149062156 </parameter>
6149162157 <parameter name="format" transfer-ownership="none">
6149262158 <doc xml:space="preserve"
6149362159 filename="glib/gstrfuncs.c"
61494- line="891">the `printf()`-style format to use for the
62160+ line="895">the `printf()`-style format to use for the
6149562161 code to use for converting</doc>
6149662162 <type name="utf8" c:type="const gchar*"/>
6149762163 </parameter>
6149862164 <parameter name="d" transfer-ownership="none">
6149962165 <doc xml:space="preserve"
6150062166 filename="glib/gstrfuncs.c"
61501- line="893">the value to convert</doc>
62167+ line="897">the value to convert</doc>
6150262168 <type name="gdouble" c:type="gdouble"/>
6150362169 </parameter>
6150462170 </parameters>
@@ -61742,7 +62408,7 @@ cast to `guchar` before passing a possibly non-ASCII character in.</doc>
6174262408 <function name="ascii_strcasecmp" c:identifier="g_ascii_strcasecmp">
6174362409 <doc xml:space="preserve"
6174462410 filename="glib/gstrfuncs.c"
61745- line="1802">Compare two strings, ignoring the case of ASCII characters.
62411+ line="1806">Compare two strings, ignoring the case of ASCII characters.
6174662412
6174762413 Unlike the BSD `strcasecmp()` function, this only recognizes standard
6174862414 ASCII letters and ignores the locale, treating all non-ASCII
@@ -61761,7 +62427,7 @@ Both @s1 and @s2 must be non-`NULL`.</doc>
6176162427 <return-value transfer-ownership="none">
6176262428 <doc xml:space="preserve"
6176362429 filename="glib/gstrfuncs.c"
61764- line="1823">0 if the strings match, a negative value if @s1 &lt; @s2,
62430+ line="1827">0 if the strings match, a negative value if @s1 &lt; @s2,
6176562431 or a positive value if @s1 &gt; @s2</doc>
6176662432 <type name="gint" c:type="gint"/>
6176762433 </return-value>
@@ -61769,13 +62435,13 @@ Both @s1 and @s2 must be non-`NULL`.</doc>
6176962435 <parameter name="s1" transfer-ownership="none">
6177062436 <doc xml:space="preserve"
6177162437 filename="glib/gstrfuncs.c"
61772- line="1804">string to compare with @s2</doc>
62438+ line="1808">string to compare with @s2</doc>
6177362439 <type name="utf8" c:type="const gchar*"/>
6177462440 </parameter>
6177562441 <parameter name="s2" transfer-ownership="none">
6177662442 <doc xml:space="preserve"
6177762443 filename="glib/gstrfuncs.c"
61778- line="1805">string to compare with @s1</doc>
62444+ line="1809">string to compare with @s1</doc>
6177962445 <type name="utf8" c:type="const gchar*"/>
6178062446 </parameter>
6178162447 </parameters>
@@ -61783,13 +62449,13 @@ Both @s1 and @s2 must be non-`NULL`.</doc>
6178362449 <function name="ascii_strdown" c:identifier="g_ascii_strdown">
6178462450 <doc xml:space="preserve"
6178562451 filename="glib/gstrfuncs.c"
61786- line="1545">Converts all upper case ASCII letters to lower case ASCII letters, with
62452+ line="1549">Converts all upper case ASCII letters to lower case ASCII letters, with
6178762453 semantics that exactly match [func@GLib.ascii_tolower].</doc>
6178862454 <source-position filename="glib/gstrfuncs.h" line="258"/>
6178962455 <return-value transfer-ownership="full">
6179062456 <doc xml:space="preserve"
6179162457 filename="glib/gstrfuncs.c"
61792- line="1553">a newly-allocated string, with all the upper case characters in
62458+ line="1557">a newly-allocated string, with all the upper case characters in
6179362459 @str converted to lower case. (Note that this is unlike the old
6179462460 [func@GLib.strdown], which modified the string in place.)</doc>
6179562461 <type name="utf8" c:type="gchar*"/>
@@ -61798,13 +62464,13 @@ semantics that exactly match [func@GLib.ascii_tolower].</doc>
6179862464 <parameter name="str" transfer-ownership="none">
6179962465 <doc xml:space="preserve"
6180062466 filename="glib/gstrfuncs.c"
61801- line="1547">a string</doc>
62467+ line="1551">a string</doc>
6180262468 <type name="utf8" c:type="const gchar*"/>
6180362469 </parameter>
6180462470 <parameter name="len" transfer-ownership="none">
6180562471 <doc xml:space="preserve"
6180662472 filename="glib/gstrfuncs.c"
61807- line="1548">length of @str in bytes, or `-1` if @str is nul-terminated</doc>
62473+ line="1552">length of @str in bytes, or `-1` if @str is nul-terminated</doc>
6180862474 <type name="gssize" c:type="gssize"/>
6180962475 </parameter>
6181062476 </parameters>
@@ -61815,7 +62481,7 @@ semantics that exactly match [func@GLib.ascii_tolower].</doc>
6181562481 throws="1">
6181662482 <doc xml:space="preserve"
6181762483 filename="glib/gstrfuncs.c"
61818- line="3298">A convenience function for converting a string to a signed number.
62484+ line="3302">A convenience function for converting a string to a signed number.
6181962485
6182062486 This function assumes that @str contains only a number of the given
6182162487 @base that is within inclusive bounds limited by @min and @max. If
@@ -61840,32 +62506,32 @@ characters.</doc>
6184062506 <return-value transfer-ownership="none">
6184162507 <doc xml:space="preserve"
6184262508 filename="glib/gstrfuncs.c"
61843- line="3329">true if @str was a number, false otherwise</doc>
62509+ line="3333">true if @str was a number, false otherwise</doc>
6184462510 <type name="gboolean" c:type="gboolean"/>
6184562511 </return-value>
6184662512 <parameters>
6184762513 <parameter name="str" transfer-ownership="none">
6184862514 <doc xml:space="preserve"
6184962515 filename="glib/gstrfuncs.c"
61850- line="3300">a string to convert</doc>
62516+ line="3304">a string to convert</doc>
6185162517 <type name="utf8" c:type="const gchar*"/>
6185262518 </parameter>
6185362519 <parameter name="base" transfer-ownership="none">
6185462520 <doc xml:space="preserve"
6185562521 filename="glib/gstrfuncs.c"
61856- line="3301">base of a parsed number</doc>
62522+ line="3305">base of a parsed number</doc>
6185762523 <type name="guint" c:type="guint"/>
6185862524 </parameter>
6185962525 <parameter name="min" transfer-ownership="none">
6186062526 <doc xml:space="preserve"
6186162527 filename="glib/gstrfuncs.c"
61862- line="3302">a lower bound (inclusive)</doc>
62528+ line="3306">a lower bound (inclusive)</doc>
6186362529 <type name="gint64" c:type="gint64"/>
6186462530 </parameter>
6186562531 <parameter name="max" transfer-ownership="none">
6186662532 <doc xml:space="preserve"
6186762533 filename="glib/gstrfuncs.c"
61868- line="3303">an upper bound (inclusive)</doc>
62534+ line="3307">an upper bound (inclusive)</doc>
6186962535 <type name="gint64" c:type="gint64"/>
6187062536 </parameter>
6187162537 <parameter name="out_num"
@@ -61876,7 +62542,7 @@ characters.</doc>
6187662542 allow-none="1">
6187762543 <doc xml:space="preserve"
6187862544 filename="glib/gstrfuncs.c"
61879- line="3304">a return location for a number</doc>
62545+ line="3308">a return location for a number</doc>
6188062546 <type name="gint64" c:type="gint64*"/>
6188162547 </parameter>
6188262548 </parameters>
@@ -61887,7 +62553,7 @@ characters.</doc>
6188762553 throws="1">
6188862554 <doc xml:space="preserve"
6188962555 filename="glib/gstrfuncs.c"
61890- line="3399">A convenience function for converting a string to an unsigned number.
62556+ line="3403">A convenience function for converting a string to an unsigned number.
6189162557
6189262558 This function assumes that @str contains only a number of the given
6189362559 @base that is within inclusive bounds limited by @min and @max. If
@@ -61913,32 +62579,32 @@ characters.</doc>
6191362579 <return-value transfer-ownership="none">
6191462580 <doc xml:space="preserve"
6191562581 filename="glib/gstrfuncs.c"
61916- line="3431">true if @str was a number, false otherwise</doc>
62582+ line="3435">true if @str was a number, false otherwise</doc>
6191762583 <type name="gboolean" c:type="gboolean"/>
6191862584 </return-value>
6191962585 <parameters>
6192062586 <parameter name="str" transfer-ownership="none">
6192162587 <doc xml:space="preserve"
6192262588 filename="glib/gstrfuncs.c"
61923- line="3401">a string</doc>
62589+ line="3405">a string</doc>
6192462590 <type name="utf8" c:type="const gchar*"/>
6192562591 </parameter>
6192662592 <parameter name="base" transfer-ownership="none">
6192762593 <doc xml:space="preserve"
6192862594 filename="glib/gstrfuncs.c"
61929- line="3402">base of a parsed number</doc>
62595+ line="3406">base of a parsed number</doc>
6193062596 <type name="guint" c:type="guint"/>
6193162597 </parameter>
6193262598 <parameter name="min" transfer-ownership="none">
6193362599 <doc xml:space="preserve"
6193462600 filename="glib/gstrfuncs.c"
61935- line="3403">a lower bound (inclusive)</doc>
62601+ line="3407">a lower bound (inclusive)</doc>
6193662602 <type name="guint64" c:type="guint64"/>
6193762603 </parameter>
6193862604 <parameter name="max" transfer-ownership="none">
6193962605 <doc xml:space="preserve"
6194062606 filename="glib/gstrfuncs.c"
61941- line="3404">an upper bound (inclusive)</doc>
62607+ line="3408">an upper bound (inclusive)</doc>
6194262608 <type name="guint64" c:type="guint64"/>
6194362609 </parameter>
6194462610 <parameter name="out_num"
@@ -61949,7 +62615,7 @@ characters.</doc>
6194962615 allow-none="1">
6195062616 <doc xml:space="preserve"
6195162617 filename="glib/gstrfuncs.c"
61952- line="3405">a return location for a number</doc>
62618+ line="3409">a return location for a number</doc>
6195362619 <type name="guint64" c:type="guint64*"/>
6195462620 </parameter>
6195562621 </parameters>
@@ -61957,7 +62623,7 @@ characters.</doc>
6195762623 <function name="ascii_strncasecmp" c:identifier="g_ascii_strncasecmp">
6195862624 <doc xml:space="preserve"
6195962625 filename="glib/gstrfuncs.c"
61960- line="1847">Compare @s1 and @s2, ignoring the case of ASCII characters and any
62626+ line="1851">Compare @s1 and @s2, ignoring the case of ASCII characters and any
6196162627 characters after the first @n in each string. If either string is
6196262628 less than @n bytes long, comparison will stop at the first nul byte
6196362629 encountered.
@@ -61973,7 +62639,7 @@ corresponding to ASCII letters always represent themselves.</doc>
6197362639 <return-value transfer-ownership="none">
6197462640 <doc xml:space="preserve"
6197562641 filename="glib/gstrfuncs.c"
61976- line="1866">0 if the strings match, a negative value if @s1 &lt; @s2,
62642+ line="1870">0 if the strings match, a negative value if @s1 &lt; @s2,
6197762643 or a positive value if @s1 &gt; @s2</doc>
6197862644 <type name="gint" c:type="gint"/>
6197962645 </return-value>
@@ -61981,19 +62647,19 @@ corresponding to ASCII letters always represent themselves.</doc>
6198162647 <parameter name="s1" transfer-ownership="none">
6198262648 <doc xml:space="preserve"
6198362649 filename="glib/gstrfuncs.c"
61984- line="1849">string to compare with @s2</doc>
62650+ line="1853">string to compare with @s2</doc>
6198562651 <type name="utf8" c:type="const gchar*"/>
6198662652 </parameter>
6198762653 <parameter name="s2" transfer-ownership="none">
6198862654 <doc xml:space="preserve"
6198962655 filename="glib/gstrfuncs.c"
61990- line="1850">string to compare with @s1</doc>
62656+ line="1854">string to compare with @s1</doc>
6199162657 <type name="utf8" c:type="const gchar*"/>
6199262658 </parameter>
6199362659 <parameter name="n" transfer-ownership="none">
6199462660 <doc xml:space="preserve"
6199562661 filename="glib/gstrfuncs.c"
61996- line="1851">number of characters to compare</doc>
62662+ line="1855">number of characters to compare</doc>
6199762663 <type name="gsize" c:type="gsize"/>
6199862664 </parameter>
6199962665 </parameters>
@@ -62001,7 +62667,7 @@ corresponding to ASCII letters always represent themselves.</doc>
6200162667 <function name="ascii_strtod" c:identifier="g_ascii_strtod">
6200262668 <doc xml:space="preserve"
6200362669 filename="glib/gstrfuncs.c"
62004- line="655">Converts a string to a floating point value.
62670+ line="659">Converts a string to a floating point value.
6200562671
6200662672 This function behaves like the standard `strtod()` function
6200762673 does in the C locale. It does this without actually changing
@@ -62028,14 +62694,14 @@ you can reliably detect overflow and underflow.</doc>
6202862694 <return-value transfer-ownership="none">
6202962695 <doc xml:space="preserve"
6203062696 filename="glib/gstrfuncs.c"
62031- line="685">the converted value</doc>
62697+ line="689">the converted value</doc>
6203262698 <type name="gdouble" c:type="gdouble"/>
6203362699 </return-value>
6203462700 <parameters>
6203562701 <parameter name="nptr" transfer-ownership="none">
6203662702 <doc xml:space="preserve"
6203762703 filename="glib/gstrfuncs.c"
62038- line="657">the string to convert to a numeric value</doc>
62704+ line="661">the string to convert to a numeric value</doc>
6203962705 <type name="utf8" c:type="const gchar*"/>
6204062706 </parameter>
6204162707 <parameter name="endptr"
@@ -62046,7 +62712,7 @@ you can reliably detect overflow and underflow.</doc>
6204662712 allow-none="1">
6204762713 <doc xml:space="preserve"
6204862714 filename="glib/gstrfuncs.c"
62049- line="658">if non-`NULL`, it returns the
62715+ line="662">if non-`NULL`, it returns the
6205062716 character after the last character used in the conversion</doc>
6205162717 <type name="utf8" c:type="gchar**"/>
6205262718 </parameter>
@@ -62057,7 +62723,7 @@ you can reliably detect overflow and underflow.</doc>
6205762723 version="2.12">
6205862724 <doc xml:space="preserve"
6205962725 filename="glib/gstrfuncs.c"
62060- line="1196">Converts a string to a `gint64` value.
62726+ line="1200">Converts a string to a `gint64` value.
6206162727
6206262728 This function behaves like the standard `strtoll()` function
6206362729 does in the C locale. It does this without actually
@@ -62079,14 +62745,14 @@ string conversion fails, zero is returned, and @endptr returns @nptr
6207962745 <return-value transfer-ownership="none">
6208062746 <doc xml:space="preserve"
6208162747 filename="glib/gstrfuncs.c"
62082- line="1222">the converted value, or zero on error</doc>
62748+ line="1226">the converted value, or zero on error</doc>
6208362749 <type name="gint64" c:type="gint64"/>
6208462750 </return-value>
6208562751 <parameters>
6208662752 <parameter name="nptr" transfer-ownership="none">
6208762753 <doc xml:space="preserve"
6208862754 filename="glib/gstrfuncs.c"
62089- line="1198">the string to convert to a numeric value</doc>
62755+ line="1202">the string to convert to a numeric value</doc>
6209062756 <type name="utf8" c:type="const gchar*"/>
6209162757 </parameter>
6209262758 <parameter name="endptr"
@@ -62097,14 +62763,14 @@ string conversion fails, zero is returned, and @endptr returns @nptr
6209762763 allow-none="1">
6209862764 <doc xml:space="preserve"
6209962765 filename="glib/gstrfuncs.c"
62100- line="1199">if non-`NULL`, it returns the
62766+ line="1203">if non-`NULL`, it returns the
6210162767 character after the last character used in the conversion</doc>
6210262768 <type name="utf8" c:type="gchar**"/>
6210362769 </parameter>
6210462770 <parameter name="base" transfer-ownership="none">
6210562771 <doc xml:space="preserve"
6210662772 filename="glib/gstrfuncs.c"
62107- line="1201">to be used for the conversion, 2..36 or 0</doc>
62773+ line="1205">to be used for the conversion, 2..36 or 0</doc>
6210862774 <type name="guint" c:type="guint"/>
6210962775 </parameter>
6211062776 </parameters>
@@ -62114,7 +62780,7 @@ string conversion fails, zero is returned, and @endptr returns @nptr
6211462780 version="2.2">
6211562781 <doc xml:space="preserve"
6211662782 filename="glib/gstrfuncs.c"
62117- line="1140">Converts a string to a `guint64` value.
62783+ line="1144">Converts a string to a `guint64` value.
6211862784
6211962785 This function behaves like the standard `strtoull()` function
6212062786 does in the C locale. It does this without actually
@@ -62141,14 +62807,14 @@ If the string conversion fails, zero is returned, and @endptr returns
6214162807 <return-value transfer-ownership="none">
6214262808 <doc xml:space="preserve"
6214362809 filename="glib/gstrfuncs.c"
62144- line="1171">the converted value, or zero on error</doc>
62810+ line="1175">the converted value, or zero on error</doc>
6214562811 <type name="guint64" c:type="guint64"/>
6214662812 </return-value>
6214762813 <parameters>
6214862814 <parameter name="nptr" transfer-ownership="none">
6214962815 <doc xml:space="preserve"
6215062816 filename="glib/gstrfuncs.c"
62151- line="1142">the string to convert to a numeric value</doc>
62817+ line="1146">the string to convert to a numeric value</doc>
6215262818 <type name="utf8" c:type="const gchar*"/>
6215362819 </parameter>
6215462820 <parameter name="endptr"
@@ -62159,14 +62825,14 @@ If the string conversion fails, zero is returned, and @endptr returns
6215962825 allow-none="1">
6216062826 <doc xml:space="preserve"
6216162827 filename="glib/gstrfuncs.c"
62162- line="1143">if non-`NULL`, it returns the
62828+ line="1147">if non-`NULL`, it returns the
6216362829 character after the last character used in the conversion</doc>
6216462830 <type name="utf8" c:type="gchar**"/>
6216562831 </parameter>
6216662832 <parameter name="base" transfer-ownership="none">
6216762833 <doc xml:space="preserve"
6216862834 filename="glib/gstrfuncs.c"
62169- line="1145">to be used for the conversion, 2..36 or 0</doc>
62835+ line="1149">to be used for the conversion, 2..36 or 0</doc>
6217062836 <type name="guint" c:type="guint"/>
6217162837 </parameter>
6217262838 </parameters>
@@ -62174,13 +62840,13 @@ If the string conversion fails, zero is returned, and @endptr returns
6217462840 <function name="ascii_strup" c:identifier="g_ascii_strup">
6217562841 <doc xml:space="preserve"
6217662842 filename="glib/gstrfuncs.c"
62177- line="1576">Converts all lower case ASCII letters to upper case ASCII letters, with
62843+ line="1580">Converts all lower case ASCII letters to upper case ASCII letters, with
6217862844 semantics that exactly match [func@GLib.ascii_toupper].</doc>
6217962845 <source-position filename="glib/gstrfuncs.h" line="261"/>
6218062846 <return-value transfer-ownership="full">
6218162847 <doc xml:space="preserve"
6218262848 filename="glib/gstrfuncs.c"
62183- line="1584">a newly-allocated string, with all the lower case characters
62849+ line="1588">a newly-allocated string, with all the lower case characters
6218462850 in @str converted to upper case. (Note that this is unlike the old
6218562851 [func@GLib.strup], which modified the string in place.)</doc>
6218662852 <type name="utf8" c:type="gchar*"/>
@@ -62189,13 +62855,13 @@ semantics that exactly match [func@GLib.ascii_toupper].</doc>
6218962855 <parameter name="str" transfer-ownership="none">
6219062856 <doc xml:space="preserve"
6219162857 filename="glib/gstrfuncs.c"
62192- line="1578">a string</doc>
62858+ line="1582">a string</doc>
6219362859 <type name="utf8" c:type="const gchar*"/>
6219462860 </parameter>
6219562861 <parameter name="len" transfer-ownership="none">
6219662862 <doc xml:space="preserve"
6219762863 filename="glib/gstrfuncs.c"
62198- line="1579">length of @str in bytes, or `-1` if @str is nul-terminated</doc>
62864+ line="1583">length of @str in bytes, or `-1` if @str is nul-terminated</doc>
6219962865 <type name="gssize" c:type="gssize"/>
6220062866 </parameter>
6220162867 </parameters>
@@ -62203,7 +62869,7 @@ semantics that exactly match [func@GLib.ascii_toupper].</doc>
6220362869 <function name="ascii_tolower" c:identifier="g_ascii_tolower">
6220462870 <doc xml:space="preserve"
6220562871 filename="glib/gstrfuncs.c"
62206- line="1709">Convert a character to ASCII lower case. If the character is not an
62872+ line="1713">Convert a character to ASCII lower case. If the character is not an
6220762873 ASCII upper case letter, it is returned unchanged.
6220862874
6220962875 Unlike the standard C library `tolower()` function, this only
@@ -62217,14 +62883,14 @@ before passing a possibly non-ASCII character in.</doc>
6221762883 <return-value transfer-ownership="none">
6221862884 <doc xml:space="preserve"
6221962885 filename="glib/gstrfuncs.c"
62220- line="1724">the result of the conversion</doc>
62886+ line="1728">the result of the conversion</doc>
6222162887 <type name="gchar" c:type="gchar"/>
6222262888 </return-value>
6222362889 <parameters>
6222462890 <parameter name="c" transfer-ownership="none">
6222562891 <doc xml:space="preserve"
6222662892 filename="glib/gstrfuncs.c"
62227- line="1711">any character</doc>
62893+ line="1715">any character</doc>
6222862894 <type name="gchar" c:type="gchar"/>
6222962895 </parameter>
6223062896 </parameters>
@@ -62232,7 +62898,7 @@ before passing a possibly non-ASCII character in.</doc>
6223262898 <function name="ascii_toupper" c:identifier="g_ascii_toupper">
6223362899 <doc xml:space="preserve"
6223462900 filename="glib/gstrfuncs.c"
62235- line="1732">Convert a character to ASCII upper case. If the character is not an
62901+ line="1736">Convert a character to ASCII upper case. If the character is not an
6223662902 ASCII lower case letter, it is returned unchanged.
6223762903
6223862904 Unlike the standard C library `toupper()` function, this only
@@ -62246,14 +62912,14 @@ before passing a possibly non-ASCII character in.</doc>
6224662912 <return-value transfer-ownership="none">
6224762913 <doc xml:space="preserve"
6224862914 filename="glib/gstrfuncs.c"
62249- line="1747">the result of the conversion</doc>
62915+ line="1751">the result of the conversion</doc>
6225062916 <type name="gchar" c:type="gchar"/>
6225162917 </return-value>
6225262918 <parameters>
6225362919 <parameter name="c" transfer-ownership="none">
6225462920 <doc xml:space="preserve"
6225562921 filename="glib/gstrfuncs.c"
62256- line="1734">any character</doc>
62922+ line="1738">any character</doc>
6225762923 <type name="gchar" c:type="gchar"/>
6225862924 </parameter>
6225962925 </parameters>
@@ -62261,7 +62927,7 @@ before passing a possibly non-ASCII character in.</doc>
6226162927 <function name="ascii_xdigit_value" c:identifier="g_ascii_xdigit_value">
6226262928 <doc xml:space="preserve"
6226362929 filename="glib/gstrfuncs.c"
62264- line="1776">Determines the numeric value of a character as a hexadecimal digit. If the
62930+ line="1780">Determines the numeric value of a character as a hexadecimal digit. If the
6226562931 character is not a hex digit according to [func@GLib.ascii_isxdigit],
6226662932 `-1` is returned.
6226762933
@@ -62274,14 +62940,14 @@ there's no worry about sign extension if characters are signed.</doc>
6227462940 <return-value transfer-ownership="none">
6227562941 <doc xml:space="preserve"
6227662942 filename="glib/gstrfuncs.c"
62277- line="1790">the numerical value of @c if it is a hex digit, `-1` otherwise</doc>
62943+ line="1794">the numerical value of @c if it is a hex digit, `-1` otherwise</doc>
6227862944 <type name="gint" c:type="gint"/>
6227962945 </return-value>
6228062946 <parameters>
6228162947 <parameter name="c" transfer-ownership="none">
6228262948 <doc xml:space="preserve"
6228362949 filename="glib/gstrfuncs.c"
62284- line="1778">an ASCII character</doc>
62950+ line="1782">an ASCII character</doc>
6228562951 <type name="gchar" c:type="gchar"/>
6228662952 </parameter>
6228762953 </parameters>
@@ -62823,7 +63489,7 @@ See [func@GLib.test_set_nonfatal_assertions].</doc>
6282363489 </parameters>
6282463490 </function-macro>
6282563491 <function name="assert_warning" c:identifier="g_assert_warning">
62826- <source-position filename="glib/gmessages.h" line="304"/>
63492+ <source-position filename="glib/gmessages.h" line="307"/>
6282763493 <return-value transfer-ownership="none">
6282863494 <type name="none" c:type="void"/>
6282963495 </return-value>
@@ -63208,11 +63874,14 @@ the pointer passed to it should not be `volatile`.</doc>
6320863874 <type name="gint" c:type="gint"/>
6320963875 </return-value>
6321063876 <parameters>
63211- <parameter name="atomic" transfer-ownership="none">
63877+ <parameter name="atomic"
63878+ transfer-ownership="none"
63879+ nullable="1"
63880+ allow-none="1">
6321263881 <doc xml:space="preserve"
6321363882 filename="glib/gatomic.c"
6321463883 line="238">a pointer to a #gint or #guint</doc>
63215- <type name="gint" c:type="volatile gint*"/>
63884+ <type name="gpointer" c:type="volatile gint*"/>
6321663885 </parameter>
6321763886 <parameter name="val" transfer-ownership="none">
6321863887 <doc xml:space="preserve"
@@ -63245,11 +63914,14 @@ the pointer passed to it should not be `volatile`.</doc>
6324563914 <type name="guint" c:type="guint"/>
6324663915 </return-value>
6324763916 <parameters>
63248- <parameter name="atomic" transfer-ownership="none">
63917+ <parameter name="atomic"
63918+ transfer-ownership="none"
63919+ nullable="1"
63920+ allow-none="1">
6324963921 <doc xml:space="preserve"
6325063922 filename="glib/gatomic.c"
6325163923 line="267">a pointer to a #gint or #guint</doc>
63252- <type name="guint" c:type="volatile guint*"/>
63924+ <type name="gpointer" c:type="volatile guint*"/>
6325363925 </parameter>
6325463926 <parameter name="val" transfer-ownership="none">
6325563927 <doc xml:space="preserve"
@@ -63284,11 +63956,14 @@ the pointer passed to it should not be `volatile`.</doc>
6328463956 <type name="gboolean" c:type="gboolean"/>
6328563957 </return-value>
6328663958 <parameters>
63287- <parameter name="atomic" transfer-ownership="none">
63959+ <parameter name="atomic"
63960+ transfer-ownership="none"
63961+ nullable="1"
63962+ allow-none="1">
6328863963 <doc xml:space="preserve"
6328963964 filename="glib/gatomic.c"
6329063965 line="149">a pointer to a #gint or #guint</doc>
63291- <type name="gint" c:type="volatile gint*"/>
63966+ <type name="gpointer" c:type="volatile gint*"/>
6329263967 </parameter>
6329363968 <parameter name="oldval" transfer-ownership="none">
6329463969 <doc xml:space="preserve"
@@ -63329,11 +64004,14 @@ See also g_atomic_int_compare_and_exchange()</doc>
6332964004 <type name="gboolean" c:type="gboolean"/>
6333064005 </return-value>
6333164006 <parameters>
63332- <parameter name="atomic" transfer-ownership="none">
64007+ <parameter name="atomic"
64008+ transfer-ownership="none"
64009+ nullable="1"
64010+ allow-none="1">
6333364011 <doc xml:space="preserve"
6333464012 filename="glib/gatomic.c"
6333564013 line="180">a pointer to a #gint or #guint</doc>
63336- <type name="gint" c:type="gint*"/>
64014+ <type name="gpointer" c:type="gint*"/>
6333764015 </parameter>
6333864016 <parameter name="oldval" transfer-ownership="none">
6333964017 <doc xml:space="preserve"
@@ -63380,11 +64058,14 @@ the pointer passed to it should not be `volatile`.</doc>
6338064058 <type name="gboolean" c:type="gboolean"/>
6338164059 </return-value>
6338264060 <parameters>
63383- <parameter name="atomic" transfer-ownership="none">
64061+ <parameter name="atomic"
64062+ transfer-ownership="none"
64063+ nullable="1"
64064+ allow-none="1">
6338464065 <doc xml:space="preserve"
6338564066 filename="glib/gatomic.c"
6338664067 line="125">a pointer to a #gint or #guint</doc>
63387- <type name="gint" c:type="volatile gint*"/>
64068+ <type name="gpointer" c:type="volatile gint*"/>
6338864069 </parameter>
6338964070 </parameters>
6339064071 </function>
@@ -63409,11 +64090,14 @@ This call acts as a full compiler and hardware memory barrier.</doc>
6340964090 <type name="gint" c:type="gint"/>
6341064091 </return-value>
6341164092 <parameters>
63412- <parameter name="atomic" transfer-ownership="none">
64093+ <parameter name="atomic"
64094+ transfer-ownership="none"
64095+ nullable="1"
64096+ allow-none="1">
6341364097 <doc xml:space="preserve"
6341464098 filename="glib/gatomic.c"
6341564099 line="213">a pointer to a #gint or #guint</doc>
63416- <type name="gint" c:type="gint*"/>
64100+ <type name="gpointer" c:type="gint*"/>
6341764101 </parameter>
6341864102 <parameter name="newval" transfer-ownership="none">
6341964103 <doc xml:space="preserve"
@@ -63442,11 +64126,14 @@ compatibility reasons. Don't use this function in new code.</doc>
6344264126 <type name="gint" c:type="gint"/>
6344364127 </return-value>
6344464128 <parameters>
63445- <parameter name="atomic" transfer-ownership="none">
64129+ <parameter name="atomic"
64130+ transfer-ownership="none"
64131+ nullable="1"
64132+ allow-none="1">
6344664133 <doc xml:space="preserve"
6344764134 filename="glib/gatomic.c"
6344864135 line="1152">a pointer to a #gint</doc>
63449- <type name="gint" c:type="volatile gint*"/>
64136+ <type name="gpointer" c:type="volatile gint*"/>
6345064137 </parameter>
6345164138 <parameter name="val" transfer-ownership="none">
6345264139 <doc xml:space="preserve"
@@ -63476,11 +64163,14 @@ the pointer passed to it should not be `volatile`.</doc>
6347664163 <type name="gint" c:type="gint"/>
6347764164 </return-value>
6347864165 <parameters>
63479- <parameter name="atomic" transfer-ownership="none">
64166+ <parameter name="atomic"
64167+ transfer-ownership="none"
64168+ nullable="1"
64169+ allow-none="1">
6348064170 <doc xml:space="preserve"
6348164171 filename="glib/gatomic.c"
6348264172 line="60">a pointer to a #gint or #guint</doc>
63483- <type name="gint" c:type="volatile const gint*"/>
64173+ <type name="gpointer" c:type="volatile const gint*"/>
6348464174 </parameter>
6348564175 </parameters>
6348664176 </function>
@@ -63502,11 +64192,14 @@ the pointer passed to it should not be `volatile`.</doc>
6350264192 <type name="none" c:type="void"/>
6350364193 </return-value>
6350464194 <parameters>
63505- <parameter name="atomic" transfer-ownership="none">
64195+ <parameter name="atomic"
64196+ transfer-ownership="none"
64197+ nullable="1"
64198+ allow-none="1">
6350664199 <doc xml:space="preserve"
6350764200 filename="glib/gatomic.c"
6350864201 line="104">a pointer to a #gint or #guint</doc>
63509- <type name="gint" c:type="volatile gint*"/>
64202+ <type name="gpointer" c:type="volatile gint*"/>
6351064203 </parameter>
6351164204 </parameters>
6351264205 </function>
@@ -63533,11 +64226,14 @@ the pointer passed to it should not be `volatile`.</doc>
6353364226 <type name="guint" c:type="guint"/>
6353464227 </return-value>
6353564228 <parameters>
63536- <parameter name="atomic" transfer-ownership="none">
64229+ <parameter name="atomic"
64230+ transfer-ownership="none"
64231+ nullable="1"
64232+ allow-none="1">
6353764233 <doc xml:space="preserve"
6353864234 filename="glib/gatomic.c"
6353964235 line="294">a pointer to a #gint or #guint</doc>
63540- <type name="guint" c:type="volatile guint*"/>
64236+ <type name="gpointer" c:type="volatile guint*"/>
6354164237 </parameter>
6354264238 <parameter name="val" transfer-ownership="none">
6354364239 <doc xml:space="preserve"
@@ -63564,11 +64260,14 @@ the pointer passed to it should not be `volatile`.</doc>
6356464260 <type name="none" c:type="void"/>
6356564261 </return-value>
6356664262 <parameters>
63567- <parameter name="atomic" transfer-ownership="none">
64263+ <parameter name="atomic"
64264+ transfer-ownership="none"
64265+ nullable="1"
64266+ allow-none="1">
6356864267 <doc xml:space="preserve"
6356964268 filename="glib/gatomic.c"
6357064269 line="82">a pointer to a #gint or #guint</doc>
63571- <type name="gint" c:type="volatile gint*"/>
64270+ <type name="gpointer" c:type="volatile gint*"/>
6357264271 </parameter>
6357364272 <parameter name="newval" transfer-ownership="none">
6357464273 <doc xml:space="preserve"
@@ -63601,11 +64300,14 @@ the pointer passed to it should not be `volatile`.</doc>
6360164300 <type name="guint" c:type="guint"/>
6360264301 </return-value>
6360364302 <parameters>
63604- <parameter name="atomic" transfer-ownership="none">
64303+ <parameter name="atomic"
64304+ transfer-ownership="none"
64305+ nullable="1"
64306+ allow-none="1">
6360564307 <doc xml:space="preserve"
6360664308 filename="glib/gatomic.c"
6360764309 line="321">a pointer to a #gint or #guint</doc>
63608- <type name="guint" c:type="volatile guint*"/>
64310+ <type name="gpointer" c:type="volatile guint*"/>
6360964311 </parameter>
6361064312 <parameter name="val" transfer-ownership="none">
6361164313 <doc xml:space="preserve"
@@ -64312,7 +65014,10 @@ g_atomic_ref_count_init() to be used again.</doc>
6431265014 <type name="none" c:type="void"/>
6431365015 </return-value>
6431465016 <parameters>
64315- <parameter name="arc" transfer-ownership="none">
65017+ <parameter name="arc"
65018+ direction="out"
65019+ caller-allocates="0"
65020+ transfer-ownership="full">
6431665021 <doc xml:space="preserve"
6431765022 filename="glib/grefcount.c"
6431865023 line="183">the address of an atomic reference count variable</doc>
@@ -64646,7 +65351,7 @@ or certain other protocols.</doc>
6464665351 deprecated-version="2.2">
6464765352 <doc xml:space="preserve"
6464865353 filename="glib/gfileutils.c"
64649- line="2539">Gets the name of the file without any leading directory
65354+ line="2560">Gets the name of the file without any leading directory
6465065355 components. It returns a pointer into the given file name
6465165356 string.</doc>
6465265357 <doc-deprecated xml:space="preserve">Use g_path_get_basename() instead, but notice
@@ -64657,7 +65362,7 @@ string.</doc>
6465765362 <return-value transfer-ownership="none">
6465865363 <doc xml:space="preserve"
6465965364 filename="glib/gfileutils.c"
64660- line="2547">the name of the file without any leading
65365+ line="2568">the name of the file without any leading
6466165366 directory components</doc>
6466265367 <type name="filename" c:type="const gchar*"/>
6466365368 </return-value>
@@ -64665,7 +65370,7 @@ string.</doc>
6466565370 <parameter name="file_name" transfer-ownership="none">
6466665371 <doc xml:space="preserve"
6466765372 filename="glib/gfileutils.c"
64668- line="2541">the name of the file</doc>
65373+ line="2562">the name of the file</doc>
6466965374 <type name="filename" c:type="const gchar*"/>
6467065375 </parameter>
6467165376 </parameters>
@@ -64673,7 +65378,7 @@ string.</doc>
6467365378 <function name="bit_lock" c:identifier="g_bit_lock" version="2.24">
6467465379 <doc xml:space="preserve"
6467565380 filename="glib/gbitlock.c"
64676- line="189">Sets the indicated @lock_bit in @address. If the bit is already
65381+ line="284">Sets the indicated @lock_bit in @address. If the bit is already
6467765382 set, this call will block until g_bit_unlock() unsets the
6467865383 corresponding bit.
6467965384
@@ -64692,20 +65397,66 @@ artifact and the argument passed to it should not be `volatile`.</doc>
6469265397 <type name="none" c:type="void"/>
6469365398 </return-value>
6469465399 <parameters>
64695- <parameter name="address" transfer-ownership="none">
65400+ <parameter name="address"
65401+ transfer-ownership="none"
65402+ nullable="1"
65403+ allow-none="1">
6469665404 <doc xml:space="preserve"
6469765405 filename="glib/gbitlock.c"
64698- line="191">a pointer to an integer</doc>
64699- <type name="gint" c:type="volatile gint*"/>
65406+ line="286">a pointer to an integer</doc>
65407+ <type name="gpointer" c:type="volatile gint*"/>
6470065408 </parameter>
6470165409 <parameter name="lock_bit" transfer-ownership="none">
6470265410 <doc xml:space="preserve"
6470365411 filename="glib/gbitlock.c"
64704- line="192">a bit value between 0 and 31</doc>
65412+ line="287">a bit value between 0 and 31</doc>
6470565413 <type name="gint" c:type="gint"/>
6470665414 </parameter>
6470765415 </parameters>
6470865416 </function>
65417+ <function name="bit_lock_and_get"
65418+ c:identifier="g_bit_lock_and_get"
65419+ version="2.86">
65420+ <doc xml:space="preserve"
65421+ filename="glib/gbitlock.c"
65422+ line="221">Sets the indicated @lock_bit in @address and atomically returns the new value.
65423+
65424+This is like [func@GLib.bit_lock], except it can atomically return the new value at
65425+@address (right after obtaining the lock). Thus the value returned in @out_val
65426+always has the @lock_bit set.</doc>
65427+ <source-position filename="glib/gbitlock.h" line="38"/>
65428+ <return-value transfer-ownership="none">
65429+ <type name="none" c:type="void"/>
65430+ </return-value>
65431+ <parameters>
65432+ <parameter name="address"
65433+ transfer-ownership="none"
65434+ nullable="1"
65435+ allow-none="1">
65436+ <doc xml:space="preserve"
65437+ filename="glib/gbitlock.c"
65438+ line="223">a pointer to an integer</doc>
65439+ <type name="gpointer" c:type="gint*"/>
65440+ </parameter>
65441+ <parameter name="lock_bit" transfer-ownership="none">
65442+ <doc xml:space="preserve"
65443+ filename="glib/gbitlock.c"
65444+ line="224">a bit value between 0 and 31</doc>
65445+ <type name="guint" c:type="guint"/>
65446+ </parameter>
65447+ <parameter name="out_val"
65448+ direction="out"
65449+ caller-allocates="0"
65450+ transfer-ownership="full"
65451+ optional="1"
65452+ allow-none="1">
65453+ <doc xml:space="preserve"
65454+ filename="glib/gbitlock.c"
65455+ line="225">return location for the new value of the integer</doc>
65456+ <type name="gint" c:type="gint*"/>
65457+ </parameter>
65458+ </parameters>
65459+ </function>
6470965460 <function name="bit_nth_lsf" c:identifier="g_bit_nth_lsf">
6471065461 <doc xml:space="preserve"
6471165462 filename="glib/gutils.c"
@@ -64791,7 +65542,7 @@ e.g. if @number is 4, 3 bits are needed.</doc>
6479165542 <function name="bit_trylock" c:identifier="g_bit_trylock" version="2.24">
6479265543 <doc xml:space="preserve"
6479365544 filename="glib/gbitlock.c"
64794- line="263">Sets the indicated @lock_bit in @address, returning %TRUE if
65545+ line="313">Sets the indicated @lock_bit in @address, returning %TRUE if
6479565546 successful. If the bit is already set, returns %FALSE immediately.
6479665547
6479765548 Attempting to lock on two different bits within the same integer is
@@ -64804,24 +65555,27 @@ This function accesses @address atomically. All other accesses to
6480465555 @address must be atomic in order for this function to work
6480565556 reliably. While @address has a `volatile` qualifier, this is a historical
6480665557 artifact and the argument passed to it should not be `volatile`.</doc>
64807- <source-position filename="glib/gbitlock.h" line="38"/>
65558+ <source-position filename="glib/gbitlock.h" line="43"/>
6480865559 <return-value transfer-ownership="none">
6480965560 <doc xml:space="preserve"
6481065561 filename="glib/gbitlock.c"
64811- line="282">%TRUE if the lock was acquired</doc>
65562+ line="332">%TRUE if the lock was acquired</doc>
6481265563 <type name="gboolean" c:type="gboolean"/>
6481365564 </return-value>
6481465565 <parameters>
64815- <parameter name="address" transfer-ownership="none">
65566+ <parameter name="address"
65567+ transfer-ownership="none"
65568+ nullable="1"
65569+ allow-none="1">
6481665570 <doc xml:space="preserve"
6481765571 filename="glib/gbitlock.c"
64818- line="265">a pointer to an integer</doc>
64819- <type name="gint" c:type="volatile gint*"/>
65572+ line="315">a pointer to an integer</doc>
65573+ <type name="gpointer" c:type="volatile gint*"/>
6482065574 </parameter>
6482165575 <parameter name="lock_bit" transfer-ownership="none">
6482265576 <doc xml:space="preserve"
6482365577 filename="glib/gbitlock.c"
64824- line="266">a bit value between 0 and 31</doc>
65578+ line="316">a bit value between 0 and 31</doc>
6482565579 <type name="gint" c:type="gint"/>
6482665580 </parameter>
6482765581 </parameters>
@@ -64829,7 +65583,7 @@ artifact and the argument passed to it should not be `volatile`.</doc>
6482965583 <function name="bit_unlock" c:identifier="g_bit_unlock" version="2.24">
6483065584 <doc xml:space="preserve"
6483165585 filename="glib/gbitlock.c"
64832- line="312">Clears the indicated @lock_bit in @address. If another thread is
65586+ line="362">Clears the indicated @lock_bit in @address. If another thread is
6483365587 currently blocked in g_bit_lock() on this same bit then it will be
6483465588 woken up.
6483565589
@@ -64837,26 +65591,79 @@ This function accesses @address atomically. All other accesses to
6483765591 @address must be atomic in order for this function to work
6483865592 reliably. While @address has a `volatile` qualifier, this is a historical
6483965593 artifact and the argument passed to it should not be `volatile`.</doc>
64840- <source-position filename="glib/gbitlock.h" line="41"/>
65594+ <source-position filename="glib/gbitlock.h" line="46"/>
6484165595 <return-value transfer-ownership="none">
6484265596 <type name="none" c:type="void"/>
6484365597 </return-value>
6484465598 <parameters>
64845- <parameter name="address" transfer-ownership="none">
65599+ <parameter name="address"
65600+ transfer-ownership="none"
65601+ nullable="1"
65602+ allow-none="1">
65603+ <doc xml:space="preserve"
65604+ filename="glib/gbitlock.c"
65605+ line="364">a pointer to an integer</doc>
65606+ <type name="gpointer" c:type="volatile gint*"/>
65607+ </parameter>
65608+ <parameter name="lock_bit" transfer-ownership="none">
65609+ <doc xml:space="preserve"
65610+ filename="glib/gbitlock.c"
65611+ line="365">a bit value between 0 and 31</doc>
65612+ <type name="gint" c:type="gint"/>
65613+ </parameter>
65614+ </parameters>
65615+ </function>
65616+ <function name="bit_unlock_and_set"
65617+ c:identifier="g_bit_unlock_and_set"
65618+ version="2.86">
65619+ <doc xml:space="preserve"
65620+ filename="glib/gbitlock.c"
65621+ line="401">This is like [func@GLib.bit_unlock] but also atomically sets @address to
65622+@val.
65623+
65624+If @preserve_mask is not zero, then the @preserve_mask bits will be
65625+preserved in @address and are not set to @val.
65626+
65627+Note that the @lock_bit bit will always be unset regardless of
65628+@val, @preserve_mask and the currently set value in @address.</doc>
65629+ <source-position filename="glib/gbitlock.h" line="50"/>
65630+ <return-value transfer-ownership="none">
65631+ <type name="none" c:type="void"/>
65632+ </return-value>
65633+ <parameters>
65634+ <parameter name="address"
65635+ transfer-ownership="none"
65636+ nullable="1"
65637+ allow-none="1">
6484665638 <doc xml:space="preserve"
6484765639 filename="glib/gbitlock.c"
64848- line="314">a pointer to an integer</doc>
64849- <type name="gint" c:type="volatile gint*"/>
65640+ line="403">a pointer to an integer</doc>
65641+ <type name="gpointer" c:type="gint*"/>
6485065642 </parameter>
6485165643 <parameter name="lock_bit" transfer-ownership="none">
6485265644 <doc xml:space="preserve"
6485365645 filename="glib/gbitlock.c"
64854- line="315">a bit value between 0 and 31</doc>
65646+ line="404">a bit value between 0 and 31</doc>
65647+ <type name="guint" c:type="guint"/>
65648+ </parameter>
65649+ <parameter name="new_val" transfer-ownership="none">
65650+ <doc xml:space="preserve"
65651+ filename="glib/gbitlock.c"
65652+ line="405">the new value to set</doc>
65653+ <type name="gint" c:type="gint"/>
65654+ </parameter>
65655+ <parameter name="preserve_mask" transfer-ownership="none">
65656+ <doc xml:space="preserve"
65657+ filename="glib/gbitlock.c"
65658+ line="406">mask for bits from @address to preserve</doc>
6485565659 <type name="gint" c:type="gint"/>
6485665660 </parameter>
6485765661 </parameters>
6485865662 </function>
64859- <function name="blow_chunks" c:identifier="g_blow_chunks">
65663+ <function name="blow_chunks"
65664+ c:identifier="g_blow_chunks"
65665+ deprecated="1"
65666+ deprecated-version="2.10">
6486065667 <source-position filename="glib/deprecated/gallocator.h" line="65"/>
6486165668 <return-value transfer-ownership="none">
6486265669 <type name="none" c:type="void"/>
@@ -64874,7 +65681,7 @@ artifact and the argument passed to it should not be `volatile`.</doc>
6487465681 introspectable="0">
6487565682 <doc xml:space="preserve"
6487665683 filename="glib/gfileutils.c"
64877- line="2271">Creates a filename from a series of elements using the correct
65684+ line="2292">Creates a filename from a series of elements using the correct
6487865685 separator for the current platform.
6487965686
6488065687 On Unix, this function behaves identically to `g_build_path
@@ -64896,20 +65703,20 @@ If you are building a path programmatically you may want to use
6489665703 <return-value transfer-ownership="full">
6489765704 <doc xml:space="preserve"
6489865705 filename="glib/gfileutils.c"
64899- line="2295">the newly allocated path</doc>
65706+ line="2316">the newly allocated path</doc>
6490065707 <type name="filename" c:type="gchar*"/>
6490165708 </return-value>
6490265709 <parameters>
6490365710 <parameter name="first_element" transfer-ownership="none">
6490465711 <doc xml:space="preserve"
6490565712 filename="glib/gfileutils.c"
64906- line="2273">the first element in the path</doc>
65713+ line="2294">the first element in the path</doc>
6490765714 <type name="filename" c:type="const gchar*"/>
6490865715 </parameter>
6490965716 <parameter name="..." transfer-ownership="none">
6491065717 <doc xml:space="preserve"
6491165718 filename="glib/gfileutils.c"
64912- line="2274">remaining elements in path, terminated by %NULL</doc>
65719+ line="2295">remaining elements in path, terminated by %NULL</doc>
6491365720 <varargs/>
6491465721 </parameter>
6491565722 </parameters>
@@ -64920,7 +65727,7 @@ If you are building a path programmatically you may want to use
6492065727 introspectable="0">
6492165728 <doc xml:space="preserve"
6492265729 filename="glib/gfileutils.c"
64923- line="2219">Creates a filename from a list of elements using the correct
65730+ line="2240">Creates a filename from a list of elements using the correct
6492465731 separator for the current platform.
6492565732
6492665733 Behaves exactly like g_build_filename(), but takes the path elements
@@ -64932,20 +65739,20 @@ functions.</doc>
6493265739 <return-value transfer-ownership="full">
6493365740 <doc xml:space="preserve"
6493465741 filename="glib/gfileutils.c"
64935- line="2233">the newly allocated path</doc>
65742+ line="2254">the newly allocated path</doc>
6493665743 <type name="filename" c:type="gchar*"/>
6493765744 </return-value>
6493865745 <parameters>
6493965746 <parameter name="first_element" transfer-ownership="none">
6494065747 <doc xml:space="preserve"
6494165748 filename="glib/gfileutils.c"
64942- line="2221">the first element in the path</doc>
65749+ line="2242">the first element in the path</doc>
6494365750 <type name="filename" c:type="const gchar*"/>
6494465751 </parameter>
6494565752 <parameter name="args" transfer-ownership="none">
6494665753 <doc xml:space="preserve"
6494765754 filename="glib/gfileutils.c"
64948- line="2222">va_list of remaining elements in path</doc>
65755+ line="2243">va_list of remaining elements in path</doc>
6494965756 <type name="va_list" c:type="va_list*"/>
6495065757 </parameter>
6495165758 </parameters>
@@ -64955,7 +65762,7 @@ functions.</doc>
6495565762 version="2.8">
6495665763 <doc xml:space="preserve"
6495765764 filename="glib/gfileutils.c"
64958- line="2246">Creates a filename from a vector of elements using the correct
65765+ line="2267">Creates a filename from a vector of elements using the correct
6495965766 separator for the current platform.
6496065767
6496165768 This function behaves exactly like g_build_filename(), but takes the path
@@ -64968,14 +65775,14 @@ If you are building a path programmatically you may want to use
6496865775 <return-value transfer-ownership="full">
6496965776 <doc xml:space="preserve"
6497065777 filename="glib/gfileutils.c"
64971- line="2261">the newly allocated path</doc>
65778+ line="2282">the newly allocated path</doc>
6497265779 <type name="filename" c:type="gchar*"/>
6497365780 </return-value>
6497465781 <parameters>
6497565782 <parameter name="args" transfer-ownership="none">
6497665783 <doc xml:space="preserve"
6497765784 filename="glib/gfileutils.c"
64978- line="2248">%NULL-terminated
65785+ line="2269">%NULL-terminated
6497965786 array of strings containing the path elements.</doc>
6498065787 <array c:type="gchar**">
6498165788 <type name="filename"/>
@@ -64986,7 +65793,7 @@ If you are building a path programmatically you may want to use
6498665793 <function name="build_path" c:identifier="g_build_path" introspectable="0">
6498765794 <doc xml:space="preserve"
6498865795 filename="glib/gfileutils.c"
64989- line="2033">Creates a path from a series of elements using @separator as the
65796+ line="2054">Creates a path from a series of elements using @separator as the
6499065797 separator between elements.
6499165798
6499265799 At the boundary between two elements, any trailing occurrences of
@@ -65018,26 +65825,26 @@ of the separator are ignored.</doc>
6501865825 <return-value transfer-ownership="full">
6501965826 <doc xml:space="preserve"
6502065827 filename="glib/gfileutils.c"
65021- line="2068">the newly allocated path</doc>
65828+ line="2089">the newly allocated path</doc>
6502265829 <type name="filename" c:type="gchar*"/>
6502365830 </return-value>
6502465831 <parameters>
6502565832 <parameter name="separator" transfer-ownership="none">
6502665833 <doc xml:space="preserve"
6502765834 filename="glib/gfileutils.c"
65028- line="2035">a string used to separator the elements of the path.</doc>
65835+ line="2056">a string used to separate the elements of the path.</doc>
6502965836 <type name="filename" c:type="const gchar*"/>
6503065837 </parameter>
6503165838 <parameter name="first_element" transfer-ownership="none">
6503265839 <doc xml:space="preserve"
6503365840 filename="glib/gfileutils.c"
65034- line="2036">the first element in the path</doc>
65841+ line="2057">the first element in the path</doc>
6503565842 <type name="filename" c:type="const gchar*"/>
6503665843 </parameter>
6503765844 <parameter name="..." transfer-ownership="none">
6503865845 <doc xml:space="preserve"
6503965846 filename="glib/gfileutils.c"
65040- line="2037">remaining elements in path, terminated by %NULL</doc>
65847+ line="2058">remaining elements in path, terminated by %NULL</doc>
6504165848 <varargs/>
6504265849 </parameter>
6504365850 </parameters>
@@ -65045,7 +65852,7 @@ of the separator are ignored.</doc>
6504565852 <function name="build_pathv" c:identifier="g_build_pathv" version="2.8">
6504665853 <doc xml:space="preserve"
6504765854 filename="glib/gfileutils.c"
65048- line="2006">Behaves exactly like g_build_path(), but takes the path elements
65855+ line="2027">Behaves exactly like g_build_path(), but takes the path elements
6504965856 as a string array, instead of variadic arguments.
6505065857
6505165858 This function is mainly meant for language bindings.</doc>
@@ -65053,7 +65860,7 @@ This function is mainly meant for language bindings.</doc>
6505365860 <return-value transfer-ownership="full">
6505465861 <doc xml:space="preserve"
6505565862 filename="glib/gfileutils.c"
65056- line="2017">a newly-allocated string that
65863+ line="2038">a newly-allocated string that
6505765864 must be freed with g_free().</doc>
6505865865 <type name="filename" c:type="gchar*"/>
6505965866 </return-value>
@@ -65061,13 +65868,13 @@ This function is mainly meant for language bindings.</doc>
6506165868 <parameter name="separator" transfer-ownership="none">
6506265869 <doc xml:space="preserve"
6506365870 filename="glib/gfileutils.c"
65064- line="2008">a string used to separator the elements of the path.</doc>
65871+ line="2029">a string used to separate the elements of the path.</doc>
6506565872 <type name="utf8" c:type="const gchar*"/>
6506665873 </parameter>
6506765874 <parameter name="args" transfer-ownership="none">
6506865875 <doc xml:space="preserve"
6506965876 filename="glib/gfileutils.c"
65070- line="2009">%NULL-terminated
65877+ line="2030">%NULL-terminated
6507165878 array of strings containing the path elements.</doc>
6507265879 <array c:type="gchar**">
6507365880 <type name="filename"/>
@@ -65080,13 +65887,13 @@ This function is mainly meant for language bindings.</doc>
6508065887 moved-to="ByteArray.append">
6508165888 <doc xml:space="preserve"
6508265889 filename="glib/garray.c"
65083- line="2858">Adds the given bytes to the end of the #GByteArray.
65890+ line="2878">Adds the given bytes to the end of the `GByteArray`.
6508465891 The array will grow in size automatically if necessary.</doc>
6508565892 <source-position filename="glib/garray.h" line="293"/>
6508665893 <return-value transfer-ownership="none">
6508765894 <doc xml:space="preserve"
6508865895 filename="glib/garray.c"
65089- line="2867">the #GByteArray</doc>
65896+ line="2887">The `GByteArray`</doc>
6509065897 <array name="GLib.ByteArray" c:type="GByteArray*">
6509165898 <type name="guint8" c:type="guint8"/>
6509265899 </array>
@@ -65095,7 +65902,7 @@ The array will grow in size automatically if necessary.</doc>
6509565902 <parameter name="array" transfer-ownership="none">
6509665903 <doc xml:space="preserve"
6509765904 filename="glib/garray.c"
65098- line="2860">a #GByteArray</doc>
65905+ line="2880">a byte array</doc>
6509965906 <array name="GLib.ByteArray" c:type="GByteArray*">
6510065907 <type name="guint8" c:type="guint8"/>
6510165908 </array>
@@ -65103,13 +65910,15 @@ The array will grow in size automatically if necessary.</doc>
6510365910 <parameter name="data" transfer-ownership="none">
6510465911 <doc xml:space="preserve"
6510565912 filename="glib/garray.c"
65106- line="2861">the byte data to be added</doc>
65107- <type name="guint8" c:type="const guint8*"/>
65913+ line="2881">the byte data to be added</doc>
65914+ <array length="2" zero-terminated="0" c:type="const guint8*">
65915+ <type name="guint8" c:type="guint8"/>
65916+ </array>
6510865917 </parameter>
6510965918 <parameter name="len" transfer-ownership="none">
6511065919 <doc xml:space="preserve"
6511165920 filename="glib/garray.c"
65112- line="2862">the number of bytes to add</doc>
65921+ line="2882">the number of bytes to add</doc>
6511365922 <type name="guint" c:type="guint"/>
6511465923 </parameter>
6511565924 </parameters>
@@ -65119,23 +65928,25 @@ The array will grow in size automatically if necessary.</doc>
6511965928 moved-to="ByteArray.free">
6512065929 <doc xml:space="preserve"
6512165930 filename="glib/garray.c"
65122- line="2775">Frees the memory allocated by the #GByteArray. If @free_segment is
65123-%TRUE it frees the actual byte data. If the reference count of
65124-@array is greater than one, the #GByteArray wrapper is preserved but
65931+ line="2794">Frees the memory allocated by the `GByteArray`. If @free_segment is
65932+true it frees the actual byte data. If the reference count of
65933+@array is greater than one, the `GByteArray` wrapper is preserved but
6512565934 the size of @array will be set to zero.</doc>
6512665935 <source-position filename="glib/garray.h" line="284"/>
65127- <return-value transfer-ownership="none">
65936+ <return-value transfer-ownership="full" nullable="1">
6512865937 <doc xml:space="preserve"
6512965938 filename="glib/garray.c"
65130- line="2785">the element data if @free_segment is %FALSE, otherwise
65131- %NULL. The element data should be freed using g_free().</doc>
65132- <type name="guint8" c:type="guint8*"/>
65939+ line="2804">The allocated element data if
65940+ @free_segment is false, otherwise `NULL`.</doc>
65941+ <array zero-terminated="0" c:type="guint8*">
65942+ <type name="guint8" c:type="guint8"/>
65943+ </array>
6513365944 </return-value>
6513465945 <parameters>
65135- <parameter name="array" transfer-ownership="none">
65946+ <parameter name="array" transfer-ownership="full">
6513665947 <doc xml:space="preserve"
6513765948 filename="glib/garray.c"
65138- line="2777">a #GByteArray</doc>
65949+ line="2796">a byte array</doc>
6513965950 <array name="GLib.ByteArray" c:type="GByteArray*">
6514065951 <type name="guint8" c:type="guint8"/>
6514165952 </array>
@@ -65143,7 +65954,7 @@ the size of @array will be set to zero.</doc>
6514365954 <parameter name="free_segment" transfer-ownership="none">
6514465955 <doc xml:space="preserve"
6514565956 filename="glib/garray.c"
65146- line="2778">if %TRUE the actual byte data is freed as well</doc>
65957+ line="2797">if true, the actual byte data is freed as well</doc>
6514765958 <type name="gboolean" c:type="gboolean"/>
6514865959 </parameter>
6514965960 </parameters>
@@ -65154,27 +65965,28 @@ the size of @array will be set to zero.</doc>
6515465965 version="2.32">
6515565966 <doc xml:space="preserve"
6515665967 filename="glib/garray.c"
65157- line="2795">Transfers the data from the #GByteArray into a new immutable #GBytes.
65968+ line="2814">Transfers the data from the `GByteArray` into a new immutable
65969+[struct@GLib.Bytes].
6515865970
65159-The #GByteArray is freed unless the reference count of @array is greater
65160-than one, the #GByteArray wrapper is preserved but the size of @array
65161-will be set to zero.
65971+The `GByteArray` is freed unless the reference count of @array is greater
65972+than one, in which the `GByteArray` wrapper is preserved but the size of
65973+@array will be set to zero.
6516265974
65163-This is identical to using g_bytes_new_take() and g_byte_array_free()
65164-together.</doc>
65975+This is identical to using [ctor@GLib.Bytes.new_take] and
65976+[func@GLib.ByteArray.free] together.</doc>
6516565977 <source-position filename="glib/garray.h" line="287"/>
6516665978 <return-value transfer-ownership="full">
6516765979 <doc xml:space="preserve"
6516865980 filename="glib/garray.c"
65169- line="2810">a new immutable #GBytes representing same
65170- byte data that was in the array</doc>
65981+ line="2830">The new immutable [struct@GLib.Bytes] representing
65982+ same byte data that was in the array</doc>
6517165983 <type name="Bytes" c:type="GBytes*"/>
6517265984 </return-value>
6517365985 <parameters>
6517465986 <parameter name="array" transfer-ownership="full">
6517565987 <doc xml:space="preserve"
6517665988 filename="glib/garray.c"
65177- line="2797">a #GByteArray</doc>
65989+ line="2816">a byte array</doc>
6517865990 <array name="GLib.ByteArray" c:type="GByteArray*">
6517965991 <type name="guint8" c:type="guint8"/>
6518065992 </array>
@@ -65186,12 +65998,12 @@ together.</doc>
6518665998 moved-to="ByteArray.new">
6518765999 <doc xml:space="preserve"
6518866000 filename="glib/garray.c"
65189- line="2685">Creates a new #GByteArray with a reference count of 1.</doc>
66001+ line="2705">Creates a new `GByteArray` with a reference count of 1.</doc>
6519066002 <source-position filename="glib/garray.h" line="274"/>
6519166003 <return-value transfer-ownership="full">
6519266004 <doc xml:space="preserve"
6519366005 filename="glib/garray.c"
65194- line="2690">the new #GByteArray</doc>
66006+ line="2710">The new `GByteArray`</doc>
6519566007 <array name="GLib.ByteArray" c:type="GByteArray*">
6519666008 <type name="guint8" c:type="guint8"/>
6519766009 </array>
@@ -65203,19 +66015,19 @@ together.</doc>
6520366015 version="2.32">
6520466016 <doc xml:space="preserve"
6520566017 filename="glib/garray.c"
65206- line="2720">Creates a byte array containing the @data.
65207-After this call, @data belongs to the #GByteArray and may no longer be
66018+ line="2739">Creates a byte array containing the @data.
66019+After this call, @data belongs to the `GByteArray` and may no longer be
6520866020 modified by the caller. The memory of @data has to be dynamically
65209-allocated and will eventually be freed with g_free().
66021+allocated and will eventually be freed with [func@GLib.free].
6521066022
65211-Do not use it if @len is greater than %G_MAXUINT. #GByteArray
65212-stores the length of its data in #guint, which may be shorter than
65213-#gsize.</doc>
66023+Do not use it if @len is greater than [`G_MAXUINT`](types.html#guint).
66024+`GByteArray` stores the length of its data in `guint`, which may be shorter
66025+than `gsize`.</doc>
6521466026 <source-position filename="glib/garray.h" line="276"/>
6521566027 <return-value transfer-ownership="full">
6521666028 <doc xml:space="preserve"
6521766029 filename="glib/garray.c"
65218- line="2736">a new #GByteArray</doc>
66030+ line="2755">The new `GByteArray`</doc>
6521966031 <array name="GLib.ByteArray" c:type="GByteArray*">
6522066032 <type name="guint8" c:type="guint8"/>
6522166033 </array>
@@ -65224,7 +66036,7 @@ stores the length of its data in #guint, which may be shorter than
6522466036 <parameter name="data" transfer-ownership="full">
6522566037 <doc xml:space="preserve"
6522666038 filename="glib/garray.c"
65227- line="2722">byte data for the array</doc>
66039+ line="2741">the byte data for the array</doc>
6522866040 <array length="1" zero-terminated="0" c:type="guint8*">
6522966041 <type name="guint8" c:type="guint8"/>
6523066042 </array>
@@ -65232,7 +66044,7 @@ stores the length of its data in #guint, which may be shorter than
6523266044 <parameter name="len" transfer-ownership="none">
6523366045 <doc xml:space="preserve"
6523466046 filename="glib/garray.c"
65235- line="2723">length of @data</doc>
66047+ line="2742">the length of @data</doc>
6523666048 <type name="gsize" c:type="gsize"/>
6523766049 </parameter>
6523866050 </parameters>
@@ -65242,13 +66054,13 @@ stores the length of its data in #guint, which may be shorter than
6524266054 moved-to="ByteArray.prepend">
6524366055 <doc xml:space="preserve"
6524466056 filename="glib/garray.c"
65245- line="2879">Adds the given data to the start of the #GByteArray.
66057+ line="2897">Adds the given data to the start of the `GByteArray`.
6524666058 The array will grow in size automatically if necessary.</doc>
6524766059 <source-position filename="glib/garray.h" line="297"/>
6524866060 <return-value transfer-ownership="none">
6524966061 <doc xml:space="preserve"
6525066062 filename="glib/garray.c"
65251- line="2888">the #GByteArray</doc>
66063+ line="2906">The `GByteArray`</doc>
6525266064 <array name="GLib.ByteArray" c:type="GByteArray*">
6525366065 <type name="guint8" c:type="guint8"/>
6525466066 </array>
@@ -65257,7 +66069,7 @@ The array will grow in size automatically if necessary.</doc>
6525766069 <parameter name="array" transfer-ownership="none">
6525866070 <doc xml:space="preserve"
6525966071 filename="glib/garray.c"
65260- line="2881">a #GByteArray</doc>
66072+ line="2899">a byte array</doc>
6526166073 <array name="GLib.ByteArray" c:type="GByteArray*">
6526266074 <type name="guint8" c:type="guint8"/>
6526366075 </array>
@@ -65265,13 +66077,15 @@ The array will grow in size automatically if necessary.</doc>
6526566077 <parameter name="data" transfer-ownership="none">
6526666078 <doc xml:space="preserve"
6526766079 filename="glib/garray.c"
65268- line="2882">the byte data to be added</doc>
65269- <type name="guint8" c:type="const guint8*"/>
66080+ line="2900">the byte data to be added</doc>
66081+ <array length="2" zero-terminated="0" c:type="const guint8*">
66082+ <type name="guint8" c:type="guint8"/>
66083+ </array>
6527066084 </parameter>
6527166085 <parameter name="len" transfer-ownership="none">
6527266086 <doc xml:space="preserve"
6527366087 filename="glib/garray.c"
65274- line="2883">the number of bytes to add</doc>
66088+ line="2901">the number of bytes to add</doc>
6527566089 <type name="guint" c:type="guint"/>
6527666090 </parameter>
6527766091 </parameters>
@@ -65282,13 +66096,13 @@ The array will grow in size automatically if necessary.</doc>
6528266096 version="2.22">
6528366097 <doc xml:space="preserve"
6528466098 filename="glib/garray.c"
65285- line="2824">Atomically increments the reference count of @array by one.
66099+ line="2844">Atomically increments the reference count of @array by one.
6528666100 This function is thread-safe and may be called from any thread.</doc>
6528766101 <source-position filename="glib/garray.h" line="289"/>
6528866102 <return-value transfer-ownership="full">
6528966103 <doc xml:space="preserve"
6529066104 filename="glib/garray.c"
65291- line="2831">The passed in #GByteArray</doc>
66105+ line="2851">The passed in `GByteArray`</doc>
6529266106 <array name="GLib.ByteArray" c:type="GByteArray*">
6529366107 <type name="guint8" c:type="guint8"/>
6529466108 </array>
@@ -65297,7 +66111,7 @@ This function is thread-safe and may be called from any thread.</doc>
6529766111 <parameter name="array" transfer-ownership="none">
6529866112 <doc xml:space="preserve"
6529966113 filename="glib/garray.c"
65300- line="2826">A #GByteArray</doc>
66114+ line="2846">a byte array</doc>
6530166115 <array name="GLib.ByteArray" c:type="GByteArray*">
6530266116 <type name="guint8" c:type="guint8"/>
6530366117 </array>
@@ -65309,13 +66123,13 @@ This function is thread-safe and may be called from any thread.</doc>
6530966123 moved-to="ByteArray.remove_index">
6531066124 <doc xml:space="preserve"
6531166125 filename="glib/garray.c"
65312- line="2918">Removes the byte at the given index from a #GByteArray.
66126+ line="2932">Removes the byte at the given index from a `GByteArray`.
6531366127 The following bytes are moved down one place.</doc>
6531466128 <source-position filename="glib/garray.h" line="304"/>
6531566129 <return-value transfer-ownership="none">
6531666130 <doc xml:space="preserve"
6531766131 filename="glib/garray.c"
65318- line="2926">the #GByteArray</doc>
66132+ line="2940">The `GByteArray`</doc>
6531966133 <array name="GLib.ByteArray" c:type="GByteArray*">
6532066134 <type name="guint8" c:type="guint8"/>
6532166135 </array>
@@ -65324,7 +66138,7 @@ The following bytes are moved down one place.</doc>
6532466138 <parameter name="array" transfer-ownership="none">
6532566139 <doc xml:space="preserve"
6532666140 filename="glib/garray.c"
65327- line="2920">a #GByteArray</doc>
66141+ line="2934">a byte array</doc>
6532866142 <array name="GLib.ByteArray" c:type="GByteArray*">
6532966143 <type name="guint8" c:type="guint8"/>
6533066144 </array>
@@ -65332,7 +66146,7 @@ The following bytes are moved down one place.</doc>
6533266146 <parameter name="index_" transfer-ownership="none">
6533366147 <doc xml:space="preserve"
6533466148 filename="glib/garray.c"
65335- line="2921">the index of the byte to remove</doc>
66149+ line="2935">the index of the byte to remove</doc>
6533666150 <type name="guint" c:type="guint"/>
6533766151 </parameter>
6533866152 </parameters>
@@ -65342,15 +66156,15 @@ The following bytes are moved down one place.</doc>
6534266156 moved-to="ByteArray.remove_index_fast">
6534366157 <doc xml:space="preserve"
6534466158 filename="glib/garray.c"
65345- line="2937">Removes the byte at the given index from a #GByteArray. The last
66159+ line="2949">Removes the byte at the given index from a `GByteArray`. The last
6534666160 element in the array is used to fill in the space, so this function
65347-does not preserve the order of the #GByteArray. But it is faster
65348-than g_byte_array_remove_index().</doc>
66161+does not preserve the order of the `GByteArray`. But it is faster
66162+than [func@GLib.ByteArray.remove_index].</doc>
6534966163 <source-position filename="glib/garray.h" line="307"/>
6535066164 <return-value transfer-ownership="none">
6535166165 <doc xml:space="preserve"
6535266166 filename="glib/garray.c"
65353- line="2947">the #GByteArray</doc>
66167+ line="2959">The `GByteArray`</doc>
6535466168 <array name="GLib.ByteArray" c:type="GByteArray*">
6535566169 <type name="guint8" c:type="guint8"/>
6535666170 </array>
@@ -65359,7 +66173,7 @@ than g_byte_array_remove_index().</doc>
6535966173 <parameter name="array" transfer-ownership="none">
6536066174 <doc xml:space="preserve"
6536166175 filename="glib/garray.c"
65362- line="2939">a #GByteArray</doc>
66176+ line="2951">a byte array</doc>
6536366177 <array name="GLib.ByteArray" c:type="GByteArray*">
6536466178 <type name="guint8" c:type="guint8"/>
6536566179 </array>
@@ -65367,7 +66181,7 @@ than g_byte_array_remove_index().</doc>
6536766181 <parameter name="index_" transfer-ownership="none">
6536866182 <doc xml:space="preserve"
6536966183 filename="glib/garray.c"
65370- line="2940">the index of the byte to remove</doc>
66184+ line="2952">the index of the byte to remove</doc>
6537166185 <type name="guint" c:type="guint"/>
6537266186 </parameter>
6537366187 </parameters>
@@ -65378,13 +66192,13 @@ than g_byte_array_remove_index().</doc>
6537866192 version="2.4">
6537966193 <doc xml:space="preserve"
6538066194 filename="glib/garray.c"
65381- line="2958">Removes the given number of bytes starting at the given index from a
65382-#GByteArray. The following elements are moved to close the gap.</doc>
66195+ line="2968">Removes the given number of bytes starting at the given index from a
66196+`GByteArray`. The following elements are moved to close the gap.</doc>
6538366197 <source-position filename="glib/garray.h" line="310"/>
6538466198 <return-value transfer-ownership="none">
6538566199 <doc xml:space="preserve"
6538666200 filename="glib/garray.c"
65387- line="2967">the #GByteArray</doc>
66201+ line="2977">The `GByteArray`</doc>
6538866202 <array name="GLib.ByteArray" c:type="GByteArray*">
6538966203 <type name="guint8" c:type="guint8"/>
6539066204 </array>
@@ -65393,7 +66207,7 @@ than g_byte_array_remove_index().</doc>
6539366207 <parameter name="array" transfer-ownership="none">
6539466208 <doc xml:space="preserve"
6539566209 filename="glib/garray.c"
65396- line="2960">a @GByteArray</doc>
66210+ line="2970">a byte array</doc>
6539766211 <array name="GLib.ByteArray" c:type="GByteArray*">
6539866212 <type name="guint8" c:type="guint8"/>
6539966213 </array>
@@ -65401,13 +66215,13 @@ than g_byte_array_remove_index().</doc>
6540166215 <parameter name="index_" transfer-ownership="none">
6540266216 <doc xml:space="preserve"
6540366217 filename="glib/garray.c"
65404- line="2961">the index of the first byte to remove</doc>
66218+ line="2971">the index of the first byte to remove</doc>
6540566219 <type name="guint" c:type="guint"/>
6540666220 </parameter>
6540766221 <parameter name="length" transfer-ownership="none">
6540866222 <doc xml:space="preserve"
6540966223 filename="glib/garray.c"
65410- line="2962">the number of bytes to remove</doc>
66224+ line="2972">the number of bytes to remove</doc>
6541166225 <type name="guint" c:type="guint"/>
6541266226 </parameter>
6541366227 </parameters>
@@ -65417,12 +66231,12 @@ than g_byte_array_remove_index().</doc>
6541766231 moved-to="ByteArray.set_size">
6541866232 <doc xml:space="preserve"
6541966233 filename="glib/garray.c"
65420- line="2900">Sets the size of the #GByteArray, expanding it if necessary.</doc>
66234+ line="2916">Sets the size of the `GByteArray`, expanding it if necessary.</doc>
6542166235 <source-position filename="glib/garray.h" line="301"/>
6542266236 <return-value transfer-ownership="none">
6542366237 <doc xml:space="preserve"
6542466238 filename="glib/garray.c"
65425- line="2907">the #GByteArray</doc>
66239+ line="2923">The `GByteArray`</doc>
6542666240 <array name="GLib.ByteArray" c:type="GByteArray*">
6542766241 <type name="guint8" c:type="guint8"/>
6542866242 </array>
@@ -65431,7 +66245,7 @@ than g_byte_array_remove_index().</doc>
6543166245 <parameter name="array" transfer-ownership="none">
6543266246 <doc xml:space="preserve"
6543366247 filename="glib/garray.c"
65434- line="2902">a #GByteArray</doc>
66248+ line="2918">a byte array</doc>
6543566249 <array name="GLib.ByteArray" c:type="GByteArray*">
6543666250 <type name="guint8" c:type="guint8"/>
6543766251 </array>
@@ -65439,7 +66253,7 @@ than g_byte_array_remove_index().</doc>
6543966253 <parameter name="length" transfer-ownership="none">
6544066254 <doc xml:space="preserve"
6544166255 filename="glib/garray.c"
65442- line="2903">the new size of the #GByteArray</doc>
66256+ line="2919">the new size of the `GByteArray`</doc>
6544366257 <type name="guint" c:type="guint"/>
6544466258 </parameter>
6544566259 </parameters>
@@ -65449,7 +66263,7 @@ than g_byte_array_remove_index().</doc>
6544966263 moved-to="ByteArray.sized_new">
6545066264 <doc xml:space="preserve"
6545166265 filename="glib/garray.c"
65452- line="2758">Creates a new #GByteArray with @reserved_size bytes preallocated.
66266+ line="2777">Creates a new `GByteArray` with @reserved_size bytes preallocated.
6545366267 This avoids frequent reallocation, if you are going to add many
6545466268 bytes to the array. Note however that the size of the array is still
6545566269 0.</doc>
@@ -65457,7 +66271,7 @@ bytes to the array. Note however that the size of the array is still
6545766271 <return-value transfer-ownership="full">
6545866272 <doc xml:space="preserve"
6545966273 filename="glib/garray.c"
65460- line="2767">the new #GByteArray</doc>
66274+ line="2786">The new `GByteArray`</doc>
6546166275 <array name="GLib.ByteArray" c:type="GByteArray*">
6546266276 <type name="guint8" c:type="guint8"/>
6546366277 </array>
@@ -65466,7 +66280,7 @@ bytes to the array. Note however that the size of the array is still
6546666280 <parameter name="reserved_size" transfer-ownership="none">
6546766281 <doc xml:space="preserve"
6546866282 filename="glib/garray.c"
65469- line="2760">number of bytes preallocated</doc>
66283+ line="2779">the number of bytes preallocated</doc>
6547066284 <type name="guint" c:type="guint"/>
6547166285 </parameter>
6547266286 </parameters>
@@ -65476,8 +66290,8 @@ bytes to the array. Note however that the size of the array is still
6547666290 moved-to="ByteArray.sort">
6547766291 <doc xml:space="preserve"
6547866292 filename="glib/garray.c"
65479- line="2984">Sorts a byte array, using @compare_func which should be a
65480-qsort()-style comparison function (returns less than zero for first
66293+ line="2994">Sorts a byte array, using @compare_func which should be a
66294+`qsort()`-style comparison function (returns less than zero for first
6548166295 arg is less than second arg, zero for equal, greater than zero if
6548266296 first arg is greater than second arg).
6548366297
@@ -65494,7 +66308,7 @@ their addresses.</doc>
6549466308 <parameter name="array" transfer-ownership="none">
6549566309 <doc xml:space="preserve"
6549666310 filename="glib/garray.c"
65497- line="2986">a #GByteArray</doc>
66311+ line="2996">a byte array</doc>
6549866312 <array name="GLib.ByteArray" c:type="GByteArray*">
6549966313 <type name="guint8" c:type="guint8"/>
6550066314 </array>
@@ -65502,7 +66316,7 @@ their addresses.</doc>
6550266316 <parameter name="compare_func" transfer-ownership="none" scope="call">
6550366317 <doc xml:space="preserve"
6550466318 filename="glib/garray.c"
65505- line="2987">comparison function</doc>
66319+ line="2997">the comparison function</doc>
6550666320 <type name="CompareFunc" c:type="GCompareFunc"/>
6550766321 </parameter>
6550866322 </parameters>
@@ -65512,7 +66326,7 @@ their addresses.</doc>
6551266326 moved-to="ByteArray.sort_with_data">
6551366327 <doc xml:space="preserve"
6551466328 filename="glib/garray.c"
65515- line="3007">Like g_byte_array_sort(), but the comparison function takes an extra
66329+ line="3017">Like [func@GLib.ByteArray.sort], but the comparison function takes an extra
6551666330 user data argument.</doc>
6551766331 <source-position filename="glib/garray.h" line="317"/>
6551866332 <return-value transfer-ownership="none">
@@ -65522,7 +66336,7 @@ user data argument.</doc>
6552266336 <parameter name="array" transfer-ownership="none">
6552366337 <doc xml:space="preserve"
6552466338 filename="glib/garray.c"
65525- line="3009">a #GByteArray</doc>
66339+ line="3019">a byte array</doc>
6552666340 <array name="GLib.ByteArray" c:type="GByteArray*">
6552766341 <type name="guint8" c:type="guint8"/>
6552866342 </array>
@@ -65533,7 +66347,7 @@ user data argument.</doc>
6553366347 closure="2">
6553466348 <doc xml:space="preserve"
6553566349 filename="glib/garray.c"
65536- line="3010">comparison function</doc>
66350+ line="3020">the comparison function</doc>
6553766351 <type name="CompareDataFunc" c:type="GCompareDataFunc"/>
6553866352 </parameter>
6553966353 <parameter name="user_data"
@@ -65542,7 +66356,7 @@ user data argument.</doc>
6554266356 allow-none="1">
6554366357 <doc xml:space="preserve"
6554466358 filename="glib/garray.c"
65545- line="3011">data to pass to @compare_func</doc>
66359+ line="3021">the data to pass to @compare_func</doc>
6554666360 <type name="gpointer" c:type="gpointer"/>
6554766361 </parameter>
6554866362 </parameters>
@@ -65553,22 +66367,23 @@ user data argument.</doc>
6555366367 version="2.64">
6555466368 <doc xml:space="preserve"
6555566369 filename="glib/garray.c"
65556- line="2698">Frees the data in the array and resets the size to zero, while
66370+ line="2718">Frees the data in the array and resets the size to zero, while
6555766371 the underlying array is preserved for use elsewhere and returned
6555866372 to the caller.</doc>
6555966373 <source-position filename="glib/garray.h" line="279"/>
6556066374 <return-value transfer-ownership="full">
6556166375 <doc xml:space="preserve"
6556266376 filename="glib/garray.c"
65563- line="2708">the element data, which should be
65564- freed using g_free().</doc>
65565- <type name="guint8" c:type="guint8*"/>
66377+ line="2728">The allocated element data</doc>
66378+ <array length="1" zero-terminated="0" c:type="guint8*">
66379+ <type name="guint8" c:type="guint8"/>
66380+ </array>
6556666381 </return-value>
6556766382 <parameters>
6556866383 <parameter name="array" transfer-ownership="none">
6556966384 <doc xml:space="preserve"
6557066385 filename="glib/garray.c"
65571- line="2700">a #GByteArray.</doc>
66386+ line="2720">a byte array</doc>
6557266387 <array name="GLib.ByteArray" c:type="GByteArray*">
6557366388 <type name="guint8" c:type="guint8"/>
6557466389 </array>
@@ -65581,7 +66396,7 @@ to the caller.</doc>
6558166396 allow-none="1">
6558266397 <doc xml:space="preserve"
6558366398 filename="glib/garray.c"
65584- line="2701">pointer to retrieve the number of
66399+ line="2721">the pointer to retrieve the number of
6558566400 elements of the original array</doc>
6558666401 <type name="gsize" c:type="gsize*"/>
6558766402 </parameter>
@@ -65593,7 +66408,7 @@ to the caller.</doc>
6559366408 version="2.22">
6559466409 <doc xml:space="preserve"
6559566410 filename="glib/garray.c"
65596- line="2841">Atomically decrements the reference count of @array by one. If the
66411+ line="2861">Atomically decrements the reference count of @array by one. If the
6559766412 reference count drops to 0, all memory allocated by the array is
6559866413 released. This function is thread-safe and may be called from any
6559966414 thread.</doc>
@@ -65602,10 +66417,10 @@ thread.</doc>
6560266417 <type name="none" c:type="void"/>
6560366418 </return-value>
6560466419 <parameters>
65605- <parameter name="array" transfer-ownership="none">
66420+ <parameter name="array" transfer-ownership="full">
6560666421 <doc xml:space="preserve"
6560766422 filename="glib/garray.c"
65608- line="2843">A #GByteArray</doc>
66423+ line="2863">a byte array</doc>
6560966424 <array name="GLib.ByteArray" c:type="GByteArray*">
6561066425 <type name="guint8" c:type="guint8"/>
6561166426 </array>
@@ -65617,7 +66432,7 @@ thread.</doc>
6561766432 version="2.58">
6561866433 <doc xml:space="preserve"
6561966434 filename="glib/gfileutils.c"
65620- line="2768">Gets the canonical file name from @filename. All triple slashes are turned into
66435+ line="2789">Gets the canonical file name from @filename. All triple slashes are turned into
6562166436 single slashes, and all `..` and `.`s resolved against @relative_to.
6562266437
6562366438 Symlinks are not followed, and the returned path is guaranteed to be absolute.
@@ -65635,7 +66450,7 @@ No file system I/O is done.</doc>
6563566450 <return-value transfer-ownership="full">
6563666451 <doc xml:space="preserve"
6563766452 filename="glib/gfileutils.c"
65638- line="2789">a newly allocated string with the
66453+ line="2810">a newly allocated string with the
6563966454 canonical file path</doc>
6564066455 <type name="filename" c:type="gchar*"/>
6564166456 </return-value>
@@ -65643,7 +66458,7 @@ No file system I/O is done.</doc>
6564366458 <parameter name="filename" transfer-ownership="none">
6564466459 <doc xml:space="preserve"
6564566460 filename="glib/gfileutils.c"
65646- line="2770">the name of the file</doc>
66461+ line="2791">the name of the file</doc>
6564766462 <type name="filename" c:type="const gchar*"/>
6564866463 </parameter>
6564966464 <parameter name="relative_to"
@@ -65652,7 +66467,7 @@ No file system I/O is done.</doc>
6565266467 allow-none="1">
6565366468 <doc xml:space="preserve"
6565466469 filename="glib/gfileutils.c"
65655- line="2771">the relative directory, or %NULL
66470+ line="2792">the relative directory, or %NULL
6565666471 to use the current working directory</doc>
6565766472 <type name="filename" c:type="const gchar*"/>
6565866473 </parameter>
@@ -65661,7 +66476,7 @@ to use the current working directory</doc>
6566166476 <function name="chdir" c:identifier="g_chdir" version="2.8">
6566266477 <doc xml:space="preserve"
6566366478 filename="glib/gstdio.c"
65664- line="1244">A wrapper for the POSIX chdir() function. The function changes the
66479+ line="1255">A wrapper for the POSIX chdir() function. The function changes the
6566566480 current directory of the process to @path.
6566666481
6566766482 See your C library manual for more details about chdir().</doc>
@@ -65669,14 +66484,14 @@ See your C library manual for more details about chdir().</doc>
6566966484 <return-value transfer-ownership="none">
6567066485 <doc xml:space="preserve"
6567166486 filename="glib/gstdio.c"
65672- line="1254">0 on success, -1 if an error occurred.</doc>
66487+ line="1265">0 on success, -1 if an error occurred.</doc>
6567366488 <type name="gint" c:type="int"/>
6567466489 </return-value>
6567566490 <parameters>
6567666491 <parameter name="path" transfer-ownership="none">
6567766492 <doc xml:space="preserve"
6567866493 filename="glib/gstdio.c"
65679- line="1246">a pathname in the GLib file name encoding
66494+ line="1257">a pathname in the GLib file name encoding
6568066495 (UTF-8 on Windows)</doc>
6568166496 <type name="filename" c:type="const gchar*"/>
6568266497 </parameter>
@@ -65739,12 +66554,12 @@ version `@required_major.@required_minor.@required_micro`
6573966554 version="2.16">
6574066555 <doc xml:space="preserve"
6574166556 filename="glib/gchecksum.c"
65742- line="1408">Gets the length in bytes of digests of type @checksum_type</doc>
66557+ line="1409">Gets the length in bytes of digests of type @checksum_type</doc>
6574366558 <source-position filename="glib/gchecksum.h" line="60"/>
6574466559 <return-value transfer-ownership="none">
6574566560 <doc xml:space="preserve"
6574666561 filename="glib/gchecksum.c"
65747- line="1414">the checksum length, or -1 if @checksum_type is
66562+ line="1415">the checksum length, or -1 if @checksum_type is
6574866563 not supported.</doc>
6574966564 <type name="gssize" c:type="gssize"/>
6575066565 </return-value>
@@ -65752,7 +66567,7 @@ not supported.</doc>
6575266567 <parameter name="checksum_type" transfer-ownership="none">
6575366568 <doc xml:space="preserve"
6575466569 filename="glib/gchecksum.c"
65755- line="1410">a #GChecksumType</doc>
66570+ line="1411">a #GChecksumType</doc>
6575666571 <type name="ChecksumType" c:type="GChecksumType"/>
6575766572 </parameter>
6575866573 </parameters>
@@ -65764,20 +66579,20 @@ not supported.</doc>
6576466579 introspectable="0">
6576566580 <doc xml:space="preserve"
6576666581 filename="glib/gmain.c"
65767- line="6201">Sets a function to be called when the child indicated by @pid
66582+ line="6384">Sets a function to be called when the child indicated by @pid
6576866583 exits, at a default priority, [const@GLib.PRIORITY_DEFAULT].
6576966584
6577066585 If you obtain @pid from [func@GLib.spawn_async] or
6577166586 [func@GLib.spawn_async_with_pipes] you will need to pass
65772-%G_SPAWN_DO_NOT_REAP_CHILD as flag to the spawn function for the child
65773-watching to work.
66587+[flags@GLib.SpawnFlags.DO_NOT_REAP_CHILD] as a flag to the spawn function for
66588+the child watching to work.
6577466589
65775-Note that on platforms where #GPid must be explicitly closed
66590+Note that on platforms where [type@GLib.Pid] must be explicitly closed
6577666591 (see [func@GLib.spawn_close_pid]) @pid must not be closed while the
6577766592 source is still active. Typically, you will want to call
6577866593 [func@GLib.spawn_close_pid] in the callback function for the source.
6577966594
65780-GLib supports only a single callback per process id.
66595+GLib supports only a single callback per process ID.
6578166596 On POSIX platforms, the same restrictions mentioned for
6578266597 [func@GLib.child_watch_source_new] apply to this function.
6578366598
@@ -65785,26 +66600,26 @@ This internally creates a main loop source using
6578566600 [func@GLib.child_watch_source_new] and attaches it to the main loop context
6578666601 using [method@GLib.Source.attach]. You can do these steps manually if you
6578766602 need greater control.</doc>
65788- <source-position filename="glib/gmain.h" line="959"/>
66603+ <source-position filename="glib/gmain.h" line="962"/>
6578966604 <return-value transfer-ownership="none">
6579066605 <doc xml:space="preserve"
6579166606 filename="glib/gmain.c"
65792- line="6231">the ID (greater than 0) of the event source.</doc>
66607+ line="6414">the ID (greater than 0) of the event source</doc>
6579366608 <type name="guint" c:type="guint"/>
6579466609 </return-value>
6579566610 <parameters>
6579666611 <parameter name="pid" transfer-ownership="none">
6579766612 <doc xml:space="preserve"
6579866613 filename="glib/gmain.c"
65799- line="6203">process id to watch. On POSIX the positive pid of a child
65800- process. On Windows a handle for a process (which doesn't have
65801- to be a child).</doc>
66614+ line="6386">process to watch — on POSIX systems, this is the positive PID of a
66615+ child process; on Windows it is a handle for a process (which doesn’t have
66616+ to be a child)</doc>
6580266617 <type name="Pid" c:type="GPid"/>
6580366618 </parameter>
6580466619 <parameter name="function" transfer-ownership="none" closure="2">
6580566620 <doc xml:space="preserve"
6580666621 filename="glib/gmain.c"
65807- line="6206">function to call</doc>
66622+ line="6389">function to call</doc>
6580866623 <type name="ChildWatchFunc" c:type="GChildWatchFunc"/>
6580966624 </parameter>
6581066625 <parameter name="data"
@@ -65813,7 +66628,7 @@ need greater control.</doc>
6581366628 allow-none="1">
6581466629 <doc xml:space="preserve"
6581566630 filename="glib/gmain.c"
65816- line="6207">data to pass to @function</doc>
66631+ line="6390">data to pass to @function</doc>
6581766632 <type name="gpointer" c:type="gpointer"/>
6581866633 </parameter>
6581966634 </parameters>
@@ -65824,24 +66639,24 @@ need greater control.</doc>
6582466639 version="2.4">
6582566640 <doc xml:space="preserve"
6582666641 filename="glib/gmain.c"
65827- line="6133">Sets a function to be called when the child indicated by @pid
66642+ line="6316">Sets a function to be called when the child indicated by @pid
6582866643 exits, at the priority @priority.
6582966644
6583066645 If you obtain @pid from [func@GLib.spawn_async] or
6583166646 [func@GLib.spawn_async_with_pipes] you will need to pass
65832-%G_SPAWN_DO_NOT_REAP_CHILD as flag to the spawn function for the child
65833-watching to work.
66647+[flags@GLib.SpawnFlags.DO_NOT_REAP_CHILD] as a flag to the spawn function for
66648+the child watching to work.
6583466649
6583566650 In many programs, you will want to call [func@GLib.spawn_check_wait_status]
6583666651 in the callback to determine whether or not the child exited
6583766652 successfully.
6583866653
65839-Also, note that on platforms where #GPid must be explicitly closed
66654+Also, note that on platforms where [type@GLib.Pid] must be explicitly closed
6584066655 (see [func@GLib.spawn_close_pid]) @pid must not be closed while the source
6584166656 is still active. Typically, you should invoke [func@GLib.spawn_close_pid]
6584266657 in the callback function for the source.
6584366658
65844-GLib supports only a single callback per process id.
66659+GLib supports only a single callback per process ID.
6584566660 On POSIX platforms, the same restrictions mentioned for
6584666661 [func@GLib.child_watch_source_new] apply to this function.
6584766662
@@ -65849,27 +66664,28 @@ This internally creates a main loop source using
6584966664 [func@GLib.child_watch_source_new] and attaches it to the main loop context
6585066665 using [method@GLib.Source.attach]. You can do these steps manually if you
6585166666 need greater control.</doc>
65852- <source-position filename="glib/gmain.h" line="953"/>
66667+ <source-position filename="glib/gmain.h" line="956"/>
6585366668 <return-value transfer-ownership="none">
6585466669 <doc xml:space="preserve"
6585566670 filename="glib/gmain.c"
65856- line="6170">the ID (greater than 0) of the event source.</doc>
66671+ line="6354">the ID (greater than 0) of the event source</doc>
6585766672 <type name="guint" c:type="guint"/>
6585866673 </return-value>
6585966674 <parameters>
6586066675 <parameter name="priority" transfer-ownership="none">
6586166676 <doc xml:space="preserve"
6586266677 filename="glib/gmain.c"
65863- line="6135">the priority of the idle source. Typically this will be in the
66678+ line="6318">the priority of the idle source; typically this will be in the
6586466679 range between [const@GLib.PRIORITY_DEFAULT_IDLE] and
65865- [const@GLib.PRIORITY_HIGH_IDLE].</doc>
66680+ [const@GLib.PRIORITY_HIGH_IDLE]</doc>
6586666681 <type name="gint" c:type="gint"/>
6586766682 </parameter>
6586866683 <parameter name="pid" transfer-ownership="none">
6586966684 <doc xml:space="preserve"
6587066685 filename="glib/gmain.c"
65871- line="6138">process to watch. On POSIX the positive pid of a child process. On
65872-Windows a handle for a process (which doesn't have to be a child).</doc>
66686+ line="6321">process to watch — on POSIX systems, this is the positive PID of a
66687+ child process; on Windows it is a handle for a process (which doesn’t have
66688+ to be a child)</doc>
6587366689 <type name="Pid" c:type="GPid"/>
6587466690 </parameter>
6587566691 <parameter name="function"
@@ -65879,7 +66695,7 @@ Windows a handle for a process (which doesn't have to be a child).</doc>
6587966695 destroy="4">
6588066696 <doc xml:space="preserve"
6588166697 filename="glib/gmain.c"
65882- line="6140">function to call</doc>
66698+ line="6324">function to call</doc>
6588366699 <type name="ChildWatchFunc" c:type="GChildWatchFunc"/>
6588466700 </parameter>
6588566701 <parameter name="data"
@@ -65888,7 +66704,7 @@ Windows a handle for a process (which doesn't have to be a child).</doc>
6588866704 allow-none="1">
6588966705 <doc xml:space="preserve"
6589066706 filename="glib/gmain.c"
65891- line="6141">data to pass to @function</doc>
66707+ line="6325">data to pass to @function</doc>
6589266708 <type name="gpointer" c:type="gpointer"/>
6589366709 </parameter>
6589466710 <parameter name="notify"
@@ -65898,7 +66714,7 @@ Windows a handle for a process (which doesn't have to be a child).</doc>
6589866714 scope="async">
6589966715 <doc xml:space="preserve"
6590066716 filename="glib/gmain.c"
65901- line="6142">function to call when the idle is removed, or %NULL</doc>
66717+ line="6326">function to call when the idle is removed</doc>
6590266718 <type name="DestroyNotify" c:type="GDestroyNotify"/>
6590366719 </parameter>
6590466720 </parameters>
@@ -65908,16 +66724,16 @@ Windows a handle for a process (which doesn't have to be a child).</doc>
6590866724 version="2.4">
6590966725 <doc xml:space="preserve"
6591066726 filename="glib/gmain.c"
65911- line="6017">Creates a new child_watch source.
66727+ line="6200">Creates a new child watch source.
6591266728
6591366729 The source will not initially be associated with any
6591466730 [struct@GLib.MainContext] and must be added to one with
6591566731 [method@GLib.Source.attach] before it will be executed.
6591666732
6591766733 Note that child watch sources can only be used in conjunction with
65918-`g_spawn...` when the %G_SPAWN_DO_NOT_REAP_CHILD flag is used.
66734+`g_spawn...` when the [flags@GLib.SpawnFlags.DO_NOT_REAP_CHILD] flag is used.
6591966735
65920-Note that on platforms where #GPid must be explicitly closed
66736+Note that on platforms where [type@GLib.Pid] must be explicitly closed
6592166737 (see [func@GLib.spawn_close_pid]) @pid must not be closed while the
6592266738 source is still active. Typically, you will want to call
6592366739 [func@GLib.spawn_close_pid] in the callback function for the source.
@@ -65925,42 +66741,43 @@ source is still active. Typically, you will want to call
6592566741 On POSIX platforms, the following restrictions apply to this API
6592666742 due to limitations in POSIX process interfaces:
6592766743
65928-* @pid must be a child of this process
65929-* @pid must be positive
65930-* the application must not call `waitpid` with a non-positive
65931- first argument, for instance in another thread
65932-* the application must not wait for @pid to exit by any other
66744+* @pid must be a child of this process.
66745+* @pid must be positive.
66746+* The application must not call [`waitpid()`](man:waitpid(1)) with a
66747+ non-positive first argument, for instance in another thread.
66748+* The application must not wait for @pid to exit by any other
6593366749 mechanism, including `waitpid(pid, ...)` or a second child-watch
65934- source for the same @pid
65935-* the application must not ignore `SIGCHLD`
65936-* Before 2.78, the application could not send a signal (`kill()`) to the
66750+ source for the same @pid.
66751+* The application must not ignore `SIGCHLD`.
66752+* Before 2.78, the application could not send a signal ([`kill()`](man:kill(2))) to the
6593766753 watched @pid in a race free manner. Since 2.78, you can do that while the
6593866754 associated [struct@GLib.MainContext] is acquired.
6593966755 * Before 2.78, even after destroying the [struct@GLib.Source], you could not
65940- be sure that @pid wasn't already reaped. Hence, it was also not
66756+ be sure that @pid wasn’t already reaped. Hence, it was also not
6594166757 safe to `kill()` or `waitpid()` on the process ID after the child watch
6594266758 source was gone. Destroying the source before it fired made it
6594366759 impossible to reliably reap the process.
6594466760
6594566761 If any of those conditions are not met, this and related APIs will
6594666762 not work correctly. This can often be diagnosed via a GLib warning
65947-stating that `ECHILD` was received by `waitpid`.
66763+stating that `ECHILD` was received by `waitpid()`.
6594866764
65949-Calling `waitpid` for specific processes other than @pid remains a
65950-valid thing to do.</doc>
65951- <source-position filename="glib/gmain.h" line="815"/>
66765+Calling [`waitpid()`](man:waitpid(2)) for specific processes other than @pid
66766+remains a valid thing to do.</doc>
66767+ <source-position filename="glib/gmain.h" line="818"/>
6595266768 <return-value transfer-ownership="full">
6595366769 <doc xml:space="preserve"
6595466770 filename="glib/gmain.c"
65955- line="6063">the newly-created child watch source</doc>
66771+ line="6247">the newly-created child watch source</doc>
6595666772 <type name="Source" c:type="GSource*"/>
6595766773 </return-value>
6595866774 <parameters>
6595966775 <parameter name="pid" transfer-ownership="none">
6596066776 <doc xml:space="preserve"
6596166777 filename="glib/gmain.c"
65962- line="6019">process to watch. On POSIX the positive pid of a child process. On
65963-Windows a handle for a process (which doesn't have to be a child).</doc>
66778+ line="6202">process to watch — on POSIX systems, this is the positive PID of a
66779+ child process; on Windows it is a handle for a process (which doesn’t have
66780+ to be a child)</doc>
6596466781 <type name="Pid" c:type="GPid"/>
6596566782 </parameter>
6596666783 </parameters>
@@ -65968,7 +66785,7 @@ Windows a handle for a process (which doesn't have to be a child).</doc>
6596866785 <function name="chmod" c:identifier="g_chmod" version="2.8">
6596966786 <doc xml:space="preserve"
6597066787 filename="glib/gstdio.c"
65971- line="970">A wrapper for the POSIX chmod() function. The chmod() function is
66788+ line="981">A wrapper for the POSIX chmod() function. The chmod() function is
6597266789 used to set the permissions of a file system object.
6597366790
6597466791 On Windows the file protection mechanism is not at all POSIX-like,
@@ -65982,28 +66799,30 @@ See your C library manual for more details about chmod().</doc>
6598266799 <return-value transfer-ownership="none">
6598366800 <doc xml:space="preserve"
6598466801 filename="glib/gstdio.c"
65985- line="987">0 if the operation succeeded, -1 on error</doc>
66802+ line="998">0 if the operation succeeded, -1 on error</doc>
6598666803 <type name="gint" c:type="int"/>
6598766804 </return-value>
6598866805 <parameters>
6598966806 <parameter name="filename" transfer-ownership="none">
6599066807 <doc xml:space="preserve"
6599166808 filename="glib/gstdio.c"
65992- line="972">a pathname in the GLib file name encoding
66809+ line="983">a pathname in the GLib file name encoding
6599366810 (UTF-8 on Windows)</doc>
6599466811 <type name="filename" c:type="const gchar*"/>
6599566812 </parameter>
6599666813 <parameter name="mode" transfer-ownership="none">
6599766814 <doc xml:space="preserve"
6599866815 filename="glib/gstdio.c"
65999- line="974">as in chmod()</doc>
66816+ line="985">as in chmod()</doc>
6600066817 <type name="gint" c:type="int"/>
6600166818 </parameter>
6600266819 </parameters>
6600366820 </function>
6600466821 <function-macro name="chunk_free"
6600566822 c:identifier="g_chunk_free"
66006- introspectable="0">
66823+ introspectable="0"
66824+ deprecated="1"
66825+ deprecated-version="2.10">
6600766826 <source-position filename="glib/deprecated/gallocator.h" line="38"/>
6600866827 <parameters>
6600966828 <parameter name="mem">
@@ -66014,7 +66833,9 @@ See your C library manual for more details about chmod().</doc>
6601466833 </function-macro>
6601566834 <function-macro name="chunk_new"
6601666835 c:identifier="g_chunk_new"
66017- introspectable="0">
66836+ introspectable="0"
66837+ deprecated="1"
66838+ deprecated-version="2.10">
6601866839 <source-position filename="glib/deprecated/gallocator.h" line="36"/>
6601966840 <parameters>
6602066841 <parameter name="type">
@@ -66025,7 +66846,9 @@ See your C library manual for more details about chmod().</doc>
6602566846 </function-macro>
6602666847 <function-macro name="chunk_new0"
6602766848 c:identifier="g_chunk_new0"
66028- introspectable="0">
66849+ introspectable="0"
66850+ deprecated="1"
66851+ deprecated-version="2.10">
6602966852 <source-position filename="glib/deprecated/gallocator.h" line="37"/>
6603066853 <parameters>
6603166854 <parameter name="type">
@@ -66128,9 +66951,9 @@ This function is also useful in conjunction with #g_autofd.</doc>
6612866951 introspectable="0">
6612966952 <doc xml:space="preserve"
6613066953 filename="glib/gmain.c"
66131- line="2618">Clears a numeric handler, such as a #GSource ID.
66954+ line="2778">Clears a numeric handler, such as a [struct@GLib.Source] ID.
6613266955
66133-@tag_ptr must be a valid pointer to the variable holding the handler.
66956+The @tag_ptr must be a valid pointer to the variable holding the handler.
6613466957
6613566958 If the ID is zero then this function does nothing.
6613666959 Otherwise, @clear_func is called with the ID as a parameter, and the tag is
@@ -66138,7 +66961,7 @@ set to zero.
6613866961
6613966962 A macro is also included that allows this function to be used without
6614066963 pointer casts.</doc>
66141- <source-position filename="glib/gmain.h" line="857"/>
66964+ <source-position filename="glib/gmain.h" line="860"/>
6614266965 <return-value transfer-ownership="none">
6614366966 <type name="none" c:type="void"/>
6614466967 </return-value>
@@ -66146,13 +66969,13 @@ pointer casts.</doc>
6614666969 <parameter name="tag_ptr" transfer-ownership="none">
6614766970 <doc xml:space="preserve"
6614866971 filename="glib/gmain.c"
66149- line="2620">a pointer to the handler ID</doc>
66972+ line="2780">a pointer to the handler ID</doc>
6615066973 <type name="guint" c:type="guint*"/>
6615166974 </parameter>
6615266975 <parameter name="clear_func" transfer-ownership="none">
6615366976 <doc xml:space="preserve"
6615466977 filename="glib/gmain.c"
66155- line="2621">the function to call to clear the handler</doc>
66978+ line="2781">the function to call to clear the handler</doc>
6615666979 <type name="ClearHandleFunc" c:type="GClearHandleFunc"/>
6615766980 </parameter>
6615866981 </parameters>
@@ -66262,7 +67085,7 @@ g_clear_pointer (&amp;sync, destroy_sync);
6626267085 introspectable="0">
6626367086 <doc xml:space="preserve"
6626467087 filename="glib/gslist.c"
66265- line="1041">Clears a pointer to a #GSList, freeing it and, optionally, freeing its elements using @destroy.
67088+ line="1042">Clears a pointer to a #GSList, freeing it and, optionally, freeing its elements using @destroy.
6626667089
6626767090 @slist_ptr must be a valid pointer. If @slist_ptr points to a null #GSList, this does nothing.</doc>
6626867091 <source-position filename="glib/gslist.h" line="142"/>
@@ -66273,7 +67096,7 @@ g_clear_pointer (&amp;sync, destroy_sync);
6627367096 <parameter name="slist_ptr" transfer-ownership="none">
6627467097 <doc xml:space="preserve"
6627567098 filename="glib/gslist.c"
66276- line="1043">a #GSList return location</doc>
67099+ line="1044">a #GSList return location</doc>
6627767100 <type name="GLib.SList" c:type="GSList**">
6627867101 <type name="gpointer" c:type="gpointer"/>
6627967102 </type>
@@ -66285,7 +67108,7 @@ g_clear_pointer (&amp;sync, destroy_sync);
6628567108 scope="async">
6628667109 <doc xml:space="preserve"
6628767110 filename="glib/gslist.c"
66288- line="1044">the function to pass to g_slist_free_full() or %NULL to not free elements</doc>
67111+ line="1045">the function to pass to g_slist_free_full() or %NULL to not free elements</doc>
6628967112 <type name="DestroyNotify" c:type="GDestroyNotify"/>
6629067113 </parameter>
6629167114 </parameters>
@@ -66293,7 +67116,7 @@ g_clear_pointer (&amp;sync, destroy_sync);
6629367116 <function name="close" c:identifier="g_close" version="2.36" throws="1">
6629467117 <doc xml:space="preserve"
6629567118 filename="glib/gstdio.c"
66296- line="1747">This wraps the close() call. In case of error, %errno will be
67119+ line="1768">This wraps the close() call. In case of error, %errno will be
6629767120 preserved, but the error will also be stored as a #GError in @error.
6629867121 In case of success, %errno is undefined.
6629967122
@@ -66314,14 +67137,14 @@ See [`signal(7)`](man:signal(7)) and
6631467137 <return-value transfer-ownership="none">
6631567138 <doc xml:space="preserve"
6631667139 filename="glib/gstdio.c"
66317- line="1770">%TRUE on success, %FALSE if there was an error.</doc>
67140+ line="1791">%TRUE on success, %FALSE if there was an error.</doc>
6631867141 <type name="gboolean" c:type="gboolean"/>
6631967142 </return-value>
6632067143 <parameters>
6632167144 <parameter name="fd" transfer-ownership="none">
6632267145 <doc xml:space="preserve"
6632367146 filename="glib/gstdio.c"
66324- line="1749">A file descriptor</doc>
67147+ line="1770">A file descriptor</doc>
6632567148 <type name="gint" c:type="gint"/>
6632667149 </parameter>
6632767150 </parameters>
@@ -66365,7 +67188,7 @@ See [`signal(7)`](man:signal(7)) and
6636567188 version="2.34">
6636667189 <doc xml:space="preserve"
6636767190 filename="glib/gchecksum.c"
66368- line="1838">Computes the checksum for a binary @data. This is a
67191+ line="1863">Computes the checksum for a binary @data. This is a
6636967192 convenience wrapper for g_checksum_new(), g_checksum_get_string()
6637067193 and g_checksum_free().
6637167194
@@ -66374,7 +67197,7 @@ The hexadecimal string returned will be in lower case.</doc>
6637467197 <return-value transfer-ownership="full" nullable="1">
6637567198 <doc xml:space="preserve"
6637667199 filename="glib/gchecksum.c"
66377- line="1849">the digest of the binary data as a
67200+ line="1874">the digest of the binary data as a
6637867201 string in hexadecimal, or %NULL if g_checksum_new() fails for
6637967202 @checksum_type. The returned string should be freed with g_free() when
6638067203 done using it.</doc>
@@ -66384,13 +67207,13 @@ The hexadecimal string returned will be in lower case.</doc>
6638467207 <parameter name="checksum_type" transfer-ownership="none">
6638567208 <doc xml:space="preserve"
6638667209 filename="glib/gchecksum.c"
66387- line="1840">a #GChecksumType</doc>
67210+ line="1865">a #GChecksumType</doc>
6638867211 <type name="ChecksumType" c:type="GChecksumType"/>
6638967212 </parameter>
6639067213 <parameter name="data" transfer-ownership="none">
6639167214 <doc xml:space="preserve"
6639267215 filename="glib/gchecksum.c"
66393- line="1841">binary blob to compute the digest of</doc>
67216+ line="1866">binary blob to compute the digest of</doc>
6639467217 <type name="Bytes" c:type="GBytes*"/>
6639567218 </parameter>
6639667219 </parameters>
@@ -66400,7 +67223,7 @@ The hexadecimal string returned will be in lower case.</doc>
6640067223 version="2.16">
6640167224 <doc xml:space="preserve"
6640267225 filename="glib/gchecksum.c"
66403- line="1769">Computes the checksum for a binary @data of @length. This is a
67226+ line="1790">Computes the checksum for a binary @data of @length. This is a
6640467227 convenience wrapper for g_checksum_new(), g_checksum_get_string()
6640567228 and g_checksum_free().
6640667229
@@ -66409,7 +67232,7 @@ The hexadecimal string returned will be in lower case.</doc>
6640967232 <return-value transfer-ownership="full" nullable="1">
6641067233 <doc xml:space="preserve"
6641167234 filename="glib/gchecksum.c"
66412- line="1781">the digest of the binary data as a
67235+ line="1802">the digest of the binary data as a
6641367236 string in hexadecimal, or %NULL if g_checksum_new() fails for
6641467237 @checksum_type. The returned string should be freed with g_free() when
6641567238 done using it.</doc>
@@ -66419,13 +67242,13 @@ The hexadecimal string returned will be in lower case.</doc>
6641967242 <parameter name="checksum_type" transfer-ownership="none">
6642067243 <doc xml:space="preserve"
6642167244 filename="glib/gchecksum.c"
66422- line="1771">a #GChecksumType</doc>
67245+ line="1792">a #GChecksumType</doc>
6642367246 <type name="ChecksumType" c:type="GChecksumType"/>
6642467247 </parameter>
6642567248 <parameter name="data" transfer-ownership="none">
6642667249 <doc xml:space="preserve"
6642767250 filename="glib/gchecksum.c"
66428- line="1772">binary blob to compute the digest of</doc>
67251+ line="1793">binary blob to compute the digest of</doc>
6642967252 <array length="2" zero-terminated="0" c:type="const guchar*">
6643067253 <type name="guint8"/>
6643167254 </array>
@@ -66433,7 +67256,7 @@ The hexadecimal string returned will be in lower case.</doc>
6643367256 <parameter name="length" transfer-ownership="none">
6643467257 <doc xml:space="preserve"
6643567258 filename="glib/gchecksum.c"
66436- line="1773">length of @data</doc>
67259+ line="1794">length of @data</doc>
6643767260 <type name="gsize" c:type="gsize"/>
6643867261 </parameter>
6643967262 </parameters>
@@ -66443,14 +67266,14 @@ The hexadecimal string returned will be in lower case.</doc>
6644367266 version="2.16">
6644467267 <doc xml:space="preserve"
6644567268 filename="glib/gchecksum.c"
66446- line="1809">Computes the checksum of a string.
67269+ line="1830">Computes the checksum of a string.
6644767270
6644867271 The hexadecimal string returned will be in lower case.</doc>
6644967272 <source-position filename="glib/gchecksum.h" line="86"/>
6645067273 <return-value transfer-ownership="full" nullable="1">
6645167274 <doc xml:space="preserve"
6645267275 filename="glib/gchecksum.c"
66453- line="1819">the checksum as a hexadecimal string,
67276+ line="1840">the checksum as a hexadecimal string,
6645467277 or %NULL if g_checksum_new() fails for @checksum_type. The returned string
6645567278 should be freed with g_free() when done using it.</doc>
6645667279 <type name="utf8" c:type="gchar*"/>
@@ -66459,19 +67282,19 @@ The hexadecimal string returned will be in lower case.</doc>
6645967282 <parameter name="checksum_type" transfer-ownership="none">
6646067283 <doc xml:space="preserve"
6646167284 filename="glib/gchecksum.c"
66462- line="1811">a #GChecksumType</doc>
67285+ line="1832">a #GChecksumType</doc>
6646367286 <type name="ChecksumType" c:type="GChecksumType"/>
6646467287 </parameter>
6646567288 <parameter name="str" transfer-ownership="none">
6646667289 <doc xml:space="preserve"
6646767290 filename="glib/gchecksum.c"
66468- line="1812">the string to compute the checksum of</doc>
67291+ line="1833">the string to compute the checksum of</doc>
6646967292 <type name="utf8" c:type="const gchar*"/>
6647067293 </parameter>
6647167294 <parameter name="length" transfer-ownership="none">
6647267295 <doc xml:space="preserve"
6647367296 filename="glib/gchecksum.c"
66474- line="1813">the length of the string, or -1 if the string is null-terminated.</doc>
67297+ line="1834">the length of the string, or -1 if the string is null-terminated.</doc>
6647567298 <type name="gssize" c:type="gssize"/>
6647667299 </parameter>
6647767300 </parameters>
@@ -66939,7 +67762,7 @@ unrepresentable characters, use g_convert_with_fallback().</doc>
6693967762 <function name="creat" c:identifier="g_creat" version="2.8">
6694067763 <doc xml:space="preserve"
6694167764 filename="glib/gstdio.c"
66942- line="1081">A wrapper for the POSIX creat() function. The creat() function is
67765+ line="1092">A wrapper for the POSIX creat() function. The creat() function is
6694367766 used to convert a pathname into a file descriptor, creating a file
6694467767 if necessary.
6694567768
@@ -66962,7 +67785,7 @@ See your C library manual for more details about creat().</doc>
6696267785 <return-value transfer-ownership="none">
6696367786 <doc xml:space="preserve"
6696467787 filename="glib/gstdio.c"
66965- line="1107">a new file descriptor, or -1 if an error occurred.
67788+ line="1118">a new file descriptor, or -1 if an error occurred.
6696667789 The return value can be used exactly like the return value
6696767790 from creat().</doc>
6696867791 <type name="gint" c:type="int"/>
@@ -66971,14 +67794,14 @@ See your C library manual for more details about creat().</doc>
6697167794 <parameter name="filename" transfer-ownership="none">
6697267795 <doc xml:space="preserve"
6697367796 filename="glib/gstdio.c"
66974- line="1083">a pathname in the GLib file name encoding
67797+ line="1094">a pathname in the GLib file name encoding
6697567798 (UTF-8 on Windows)</doc>
6697667799 <type name="filename" c:type="const gchar*"/>
6697767800 </parameter>
6697867801 <parameter name="mode" transfer-ownership="none">
6697967802 <doc xml:space="preserve"
6698067803 filename="glib/gstdio.c"
66981- line="1085">as in creat()</doc>
67804+ line="1096">as in creat()</doc>
6698267805 <type name="gint" c:type="int"/>
6698367806 </parameter>
6698467807 </parameters>
@@ -66988,7 +67811,7 @@ See your C library manual for more details about creat().</doc>
6698867811 introspectable="0">
6698967812 <doc xml:space="preserve"
6699067813 filename="glib/gmessages.c"
66991- line="240">Logs a ‘critical warning’ ([flags@GLib.LogLevelFlags.LEVEL_CRITICAL]).
67814+ line="239">Logs a ‘critical warning’ ([flags@GLib.LogLevelFlags.LEVEL_CRITICAL]).
6699267815
6699367816 Critical warnings are intended to be used in the event of an error
6699467817 that originated in the current process (a programmer error).
@@ -67000,7 +67823,7 @@ somewhere in the current program (or its libraries).
6700067823
6700167824 You can make critical warnings fatal at runtime by
6700267825 setting the `G_DEBUG` environment variable (see
67003-[Running GLib Applications](glib-running.html)):
67826+[Running GLib Applications](running.html)):
6700467827
6700567828 ```
6700667829 G_DEBUG=fatal-warnings gdb ./my-program
@@ -67021,12 +67844,12 @@ manually.
6702167844 If structured logging is enabled, this will use [func@GLib.log_structured];
6702267845 otherwise it will use [func@GLib.log]. See
6702367846 [Using Structured Logging](logging.html#using-structured-logging).</doc>
67024- <source-position filename="glib/gmessages.h" line="334"/>
67847+ <source-position filename="glib/gmessages.h" line="337"/>
6702567848 <parameters>
6702667849 <parameter name="...">
6702767850 <doc xml:space="preserve"
6702867851 filename="glib/gmessages.c"
67029- line="242">format string, followed by parameters to insert into the format string
67852+ line="241">format string, followed by parameters to insert into the format string
6703067853 (as with `printf()`)</doc>
6703167854 </parameter>
6703267855 </parameters>
@@ -67036,7 +67859,7 @@ otherwise it will use [func@GLib.log]. See
6703667859 introspectable="0">
6703767860 <doc xml:space="preserve"
6703867861 filename="glib/gdataset.c"
67039- line="502">Frees all the data elements of the datalist.
67862+ line="498">Frees all the data elements of the datalist.
6704067863 The data elements' destroy functions are called
6704167864 if they have been set.</doc>
6704267865 <source-position filename="glib/gdataset.h" line="49"/>
@@ -67047,7 +67870,7 @@ if they have been set.</doc>
6704767870 <parameter name="datalist" transfer-ownership="none">
6704867871 <doc xml:space="preserve"
6704967872 filename="glib/gdataset.c"
67050- line="504">a datalist.</doc>
67873+ line="500">a datalist.</doc>
6705167874 <type name="Data" c:type="GData**"/>
6705267875 </parameter>
6705367876 </parameters>
@@ -67055,7 +67878,7 @@ if they have been set.</doc>
6705567878 <function name="datalist_foreach" c:identifier="g_datalist_foreach">
6705667879 <doc xml:space="preserve"
6705767880 filename="glib/gdataset.c"
67058- line="1502">Calls the given function for each data element of the datalist. The
67881+ line="1542">Calls the given function for each data element of the datalist. The
6705967882 function is called with each data element's #GQuark id and data,
6706067883 together with the given @user_data parameter. Note that this
6706167884 function is NOT thread-safe. So unless @datalist can be protected
@@ -67073,7 +67896,7 @@ than skipping over elements that are removed.</doc>
6707367896 <parameter name="datalist" transfer-ownership="none">
6707467897 <doc xml:space="preserve"
6707567898 filename="glib/gdataset.c"
67076- line="1504">a datalist.</doc>
67899+ line="1544">a datalist.</doc>
6707767900 <type name="Data" c:type="GData**"/>
6707867901 </parameter>
6707967902 <parameter name="func"
@@ -67082,7 +67905,7 @@ than skipping over elements that are removed.</doc>
6708267905 closure="2">
6708367906 <doc xml:space="preserve"
6708467907 filename="glib/gdataset.c"
67085- line="1505">the function to call for each data element.</doc>
67908+ line="1545">the function to call for each data element.</doc>
6708667909 <type name="DataForeachFunc" c:type="GDataForeachFunc"/>
6708767910 </parameter>
6708867911 <parameter name="user_data"
@@ -67091,7 +67914,7 @@ than skipping over elements that are removed.</doc>
6709167914 allow-none="1">
6709267915 <doc xml:space="preserve"
6709367916 filename="glib/gdataset.c"
67094- line="1506">user data to pass to the function.</doc>
67917+ line="1546">user data to pass to the function.</doc>
6709567918 <type name="gpointer" c:type="gpointer"/>
6709667919 </parameter>
6709767920 </parameters>
@@ -67099,13 +67922,13 @@ than skipping over elements that are removed.</doc>
6709967922 <function name="datalist_get_data" c:identifier="g_datalist_get_data">
6710067923 <doc xml:space="preserve"
6710167924 filename="glib/gdataset.c"
67102- line="1385">Gets a data element, using its string identifier. This is slower than
67925+ line="1419">Gets a data element, using its string identifier. This is slower than
6710367926 g_datalist_id_get_data() because it compares strings.</doc>
6710467927 <source-position filename="glib/gdataset.h" line="125"/>
6710567928 <return-value transfer-ownership="none" nullable="1">
6710667929 <doc xml:space="preserve"
6710767930 filename="glib/gdataset.c"
67108- line="1393">the data element, or %NULL if it
67931+ line="1427">the data element, or %NULL if it
6710967932 is not found.</doc>
6711067933 <type name="gpointer" c:type="gpointer"/>
6711167934 </return-value>
@@ -67113,13 +67936,13 @@ g_datalist_id_get_data() because it compares strings.</doc>
6711367936 <parameter name="datalist" transfer-ownership="none">
6711467937 <doc xml:space="preserve"
6711567938 filename="glib/gdataset.c"
67116- line="1387">a datalist.</doc>
67939+ line="1421">a datalist.</doc>
6711767940 <type name="Data" c:type="GData**"/>
6711867941 </parameter>
6711967942 <parameter name="key" transfer-ownership="none">
6712067943 <doc xml:space="preserve"
6712167944 filename="glib/gdataset.c"
67122- line="1388">the string identifying a data element.</doc>
67945+ line="1422">the string identifying a data element.</doc>
6712367946 <type name="utf8" c:type="const gchar*"/>
6712467947 </parameter>
6712567948 </parameters>
@@ -67129,20 +67952,20 @@ g_datalist_id_get_data() because it compares strings.</doc>
6712967952 version="2.8">
6713067953 <doc xml:space="preserve"
6713167954 filename="glib/gdataset.c"
67132- line="1627">Gets flags values packed in together with the datalist.
67955+ line="1667">Gets flags values packed in together with the datalist.
6713367956 See g_datalist_set_flags().</doc>
6713467957 <source-position filename="glib/gdataset.h" line="102"/>
6713567958 <return-value transfer-ownership="none">
6713667959 <doc xml:space="preserve"
6713767960 filename="glib/gdataset.c"
67138- line="1634">the flags of the datalist</doc>
67961+ line="1674">the flags of the datalist</doc>
6713967962 <type name="guint" c:type="guint"/>
6714067963 </return-value>
6714167964 <parameters>
6714267965 <parameter name="datalist" transfer-ownership="none">
6714367966 <doc xml:space="preserve"
6714467967 filename="glib/gdataset.c"
67145- line="1629">pointer to the location that holds a list</doc>
67968+ line="1669">pointer to the location that holds a list</doc>
6714667969 <type name="Data" c:type="GData**"/>
6714767970 </parameter>
6714867971 </parameters>
@@ -67153,7 +67976,7 @@ See g_datalist_set_flags().</doc>
6715367976 introspectable="0">
6715467977 <doc xml:space="preserve"
6715567978 filename="glib/gdataset.c"
67156- line="1238">This is a variant of g_datalist_id_get_data() which
67979+ line="1272">This is a variant of g_datalist_id_get_data() which
6715767980 returns a 'duplicate' of the value. @dup_func defines the
6715867981 meaning of 'duplicate' in this context, it could e.g.
6715967982 take a reference on a ref-counted object.
@@ -67170,7 +67993,7 @@ threads are using the same datalist and the same key.</doc>
6717067993 <return-value transfer-ownership="none" nullable="1">
6717167994 <doc xml:space="preserve"
6717267995 filename="glib/gdataset.c"
67173- line="1260">the result of calling @dup_func on the value
67996+ line="1294">the result of calling @dup_func on the value
6717467997 associated with @key_id in @datalist, or %NULL if not set.
6717567998 If @dup_func is %NULL, the value is returned unmodified.</doc>
6717667999 <type name="gpointer" c:type="gpointer"/>
@@ -67179,13 +68002,13 @@ threads are using the same datalist and the same key.</doc>
6717968002 <parameter name="datalist" transfer-ownership="none">
6718068003 <doc xml:space="preserve"
6718168004 filename="glib/gdataset.c"
67182- line="1240">location of a datalist</doc>
68005+ line="1274">location of a datalist</doc>
6718368006 <type name="Data" c:type="GData**"/>
6718468007 </parameter>
6718568008 <parameter name="key_id" transfer-ownership="none">
6718668009 <doc xml:space="preserve"
6718768010 filename="glib/gdataset.c"
67188- line="1241">the #GQuark identifying a data element</doc>
68011+ line="1275">the #GQuark identifying a data element</doc>
6718968012 <type name="Quark" c:type="GQuark"/>
6719068013 </parameter>
6719168014 <parameter name="dup_func"
@@ -67196,7 +68019,7 @@ threads are using the same datalist and the same key.</doc>
6719668019 closure="3">
6719768020 <doc xml:space="preserve"
6719868021 filename="glib/gdataset.c"
67199- line="1242">function to
68022+ line="1276">function to
6720068023 duplicate the old value</doc>
6720168024 <type name="DuplicateFunc" c:type="GDuplicateFunc"/>
6720268025 </parameter>
@@ -67206,7 +68029,7 @@ threads are using the same datalist and the same key.</doc>
6720668029 allow-none="1">
6720768030 <doc xml:space="preserve"
6720868031 filename="glib/gdataset.c"
67209- line="1244">passed as user_data to @dup_func</doc>
68032+ line="1278">passed as user_data to @dup_func</doc>
6721068033 <type name="gpointer" c:type="gpointer"/>
6721168034 </parameter>
6721268035 </parameters>
@@ -67215,12 +68038,12 @@ threads are using the same datalist and the same key.</doc>
6721568038 c:identifier="g_datalist_id_get_data">
6721668039 <doc xml:space="preserve"
6721768040 filename="glib/gdataset.c"
67218- line="1207">Retrieves the data element corresponding to @key_id.</doc>
68041+ line="1241">Retrieves the data element corresponding to @key_id.</doc>
6721968042 <source-position filename="glib/gdataset.h" line="51"/>
6722068043 <return-value transfer-ownership="none" nullable="1">
6722168044 <doc xml:space="preserve"
6722268045 filename="glib/gdataset.c"
67223- line="1214">the data element, or %NULL if
68046+ line="1248">the data element, or %NULL if
6722468047 it is not found.</doc>
6722568048 <type name="gpointer" c:type="gpointer"/>
6722668049 </return-value>
@@ -67228,13 +68051,13 @@ threads are using the same datalist and the same key.</doc>
6722868051 <parameter name="datalist" transfer-ownership="none">
6722968052 <doc xml:space="preserve"
6723068053 filename="glib/gdataset.c"
67231- line="1209">a datalist.</doc>
68054+ line="1243">a datalist.</doc>
6723268055 <type name="Data" c:type="GData**"/>
6723368056 </parameter>
6723468057 <parameter name="key_id" transfer-ownership="none">
6723568058 <doc xml:space="preserve"
6723668059 filename="glib/gdataset.c"
67237- line="1210">the #GQuark identifying a data element.</doc>
68060+ line="1244">the #GQuark identifying a data element.</doc>
6723868061 <type name="Quark" c:type="GQuark"/>
6723968062 </parameter>
6724068063 </parameters>
@@ -67303,13 +68126,13 @@ Since 2.84, performance is improved for larger number of keys.</doc>
6730368126 introspectable="0">
6730468127 <doc xml:space="preserve"
6730568128 filename="glib/gdataset.c"
67306- line="1026">Removes an element, without calling its destroy notification
68129+ line="1029">Removes an element, without calling its destroy notification
6730768130 function.</doc>
6730868131 <source-position filename="glib/gdataset.h" line="79"/>
6730968132 <return-value transfer-ownership="none" nullable="1">
6731068133 <doc xml:space="preserve"
6731168134 filename="glib/gdataset.c"
67312- line="1034">the data previously stored at @key_id,
68135+ line="1037">the data previously stored at @key_id,
6731368136 or %NULL if none.</doc>
6731468137 <type name="gpointer" c:type="gpointer"/>
6731568138 </return-value>
@@ -67317,13 +68140,13 @@ function.</doc>
6731768140 <parameter name="datalist" transfer-ownership="none">
6731868141 <doc xml:space="preserve"
6731968142 filename="glib/gdataset.c"
67320- line="1028">a datalist.</doc>
68143+ line="1031">a datalist.</doc>
6732168144 <type name="Data" c:type="GData**"/>
6732268145 </parameter>
6732368146 <parameter name="key_id" transfer-ownership="none">
6732468147 <doc xml:space="preserve"
6732568148 filename="glib/gdataset.c"
67326- line="1029">the #GQuark identifying a data element.</doc>
68149+ line="1032">the #GQuark identifying a data element.</doc>
6732768150 <type name="Quark" c:type="GQuark"/>
6732868151 </parameter>
6732968152 </parameters>
@@ -67334,7 +68157,7 @@ function.</doc>
6733468157 introspectable="0">
6733568158 <doc xml:space="preserve"
6733668159 filename="glib/gdataset.c"
67337- line="1293">Compares the member that is associated with @key_id in
68160+ line="1327">Compares the member that is associated with @key_id in
6733868161 @datalist to @oldval, and if they are the same, replace
6733968162 @oldval with @newval.
6734068163
@@ -67351,7 +68174,7 @@ should not destroy the object in the normal way.</doc>
6735168174 <return-value transfer-ownership="none">
6735268175 <doc xml:space="preserve"
6735368176 filename="glib/gdataset.c"
67354- line="1316">%TRUE if the existing value for @key_id was replaced
68177+ line="1350">%TRUE if the existing value for @key_id was replaced
6735568178 by @newval, %FALSE otherwise.</doc>
6735668179 <type name="gboolean" c:type="gboolean"/>
6735768180 </return-value>
@@ -67359,13 +68182,13 @@ should not destroy the object in the normal way.</doc>
6735968182 <parameter name="datalist" transfer-ownership="none">
6736068183 <doc xml:space="preserve"
6736168184 filename="glib/gdataset.c"
67362- line="1295">location of a datalist</doc>
68185+ line="1329">location of a datalist</doc>
6736368186 <type name="Data" c:type="GData**"/>
6736468187 </parameter>
6736568188 <parameter name="key_id" transfer-ownership="none">
6736668189 <doc xml:space="preserve"
6736768190 filename="glib/gdataset.c"
67368- line="1296">the #GQuark identifying a data element</doc>
68191+ line="1330">the #GQuark identifying a data element</doc>
6736968192 <type name="Quark" c:type="GQuark"/>
6737068193 </parameter>
6737168194 <parameter name="oldval"
@@ -67374,7 +68197,7 @@ should not destroy the object in the normal way.</doc>
6737468197 allow-none="1">
6737568198 <doc xml:space="preserve"
6737668199 filename="glib/gdataset.c"
67377- line="1297">the old value to compare against</doc>
68200+ line="1331">the old value to compare against</doc>
6737868201 <type name="gpointer" c:type="gpointer"/>
6737968202 </parameter>
6738068203 <parameter name="newval"
@@ -67383,7 +68206,7 @@ should not destroy the object in the normal way.</doc>
6738368206 allow-none="1">
6738468207 <doc xml:space="preserve"
6738568208 filename="glib/gdataset.c"
67386- line="1298">the new value to replace it with</doc>
68209+ line="1332">the new value to replace it with</doc>
6738768210 <type name="gpointer" c:type="gpointer"/>
6738868211 </parameter>
6738968212 <parameter name="destroy"
@@ -67393,7 +68216,7 @@ should not destroy the object in the normal way.</doc>
6739368216 scope="async">
6739468217 <doc xml:space="preserve"
6739568218 filename="glib/gdataset.c"
67396- line="1299">destroy notify for the new value</doc>
68219+ line="1333">destroy notify for the new value</doc>
6739768220 <type name="DestroyNotify" c:type="GDestroyNotify"/>
6739868221 </parameter>
6739968222 <parameter name="old_destroy"
@@ -67405,7 +68228,7 @@ should not destroy the object in the normal way.</doc>
6740568228 scope="async">
6740668229 <doc xml:space="preserve"
6740768230 filename="glib/gdataset.c"
67408- line="1300">destroy notify for the existing value</doc>
68231+ line="1334">destroy notify for the existing value</doc>
6740968232 <type name="DestroyNotify" c:type="GDestroyNotify*"/>
6741068233 </parameter>
6741168234 </parameters>
@@ -67495,7 +68318,7 @@ function is called.</doc>
6749568318 introspectable="0">
6749668319 <doc xml:space="preserve"
6749768320 filename="glib/gdataset.c"
67498- line="1561">Resets the datalist to %NULL. It does not free any memory or call
68321+ line="1601">Resets the datalist to %NULL. It does not free any memory or call
6749968322 any destroy functions.</doc>
6750068323 <source-position filename="glib/gdataset.h" line="47"/>
6750168324 <return-value transfer-ownership="none">
@@ -67505,7 +68328,7 @@ any destroy functions.</doc>
6750568328 <parameter name="datalist" transfer-ownership="none">
6750668329 <doc xml:space="preserve"
6750768330 filename="glib/gdataset.c"
67508- line="1563">a pointer to a pointer to a datalist.</doc>
68331+ line="1603">a pointer to a pointer to a datalist.</doc>
6750968332 <type name="Data" c:type="GData**"/>
6751068333 </parameter>
6751168334 </parameters>
@@ -67536,18 +68359,18 @@ destroy function is called if it has been set.</doc>
6753668359 introspectable="0">
6753768360 <doc xml:space="preserve"
6753868361 filename="glib/gdataset.c"
67539- line="1037">Removes an element, without calling its destroy notifier.</doc>
68362+ line="1040">Removes an element, without calling its destroy notifier.</doc>
6754068363 <source-position filename="glib/gdataset.h" line="110"/>
6754168364 <parameters>
6754268365 <parameter name="dl">
6754368366 <doc xml:space="preserve"
6754468367 filename="glib/gdataset.c"
67545- line="1039">a datalist.</doc>
68368+ line="1042">a datalist.</doc>
6754668369 </parameter>
6754768370 <parameter name="k">
6754868371 <doc xml:space="preserve"
6754968372 filename="glib/gdataset.c"
67550- line="1040">the string identifying the data element.</doc>
68373+ line="1043">the string identifying the data element.</doc>
6755168374 </parameter>
6755268375 </parameters>
6755368376 </function-macro>
@@ -67617,7 +68440,7 @@ and the function to be called when the data element is removed.</doc>
6761768440 version="2.8">
6761868441 <doc xml:space="preserve"
6761968442 filename="glib/gdataset.c"
67620- line="1576">Turns on flag values for a data list. This function is used
68443+ line="1616">Turns on flag values for a data list. This function is used
6762168444 to keep a small number of boolean flags in an object with
6762268445 a data list without using any additional space. It is
6762368446 not generally useful except in circumstances where space
@@ -67631,13 +68454,13 @@ example.)</doc>
6763168454 <parameter name="datalist" transfer-ownership="none">
6763268455 <doc xml:space="preserve"
6763368456 filename="glib/gdataset.c"
67634- line="1578">pointer to the location that holds a list</doc>
68457+ line="1618">pointer to the location that holds a list</doc>
6763568458 <type name="Data" c:type="GData**"/>
6763668459 </parameter>
6763768460 <parameter name="flags" transfer-ownership="none">
6763868461 <doc xml:space="preserve"
6763968462 filename="glib/gdataset.c"
67640- line="1579">the flags to turn on. The values of the flags are
68463+ line="1619">the flags to turn on. The values of the flags are
6764168464 restricted by %G_DATALIST_FLAGS_MASK (currently
6764268465 3; giving two possible boolean flags).
6764368466 A value for @flags that doesn't fit within the mask is
@@ -67651,7 +68474,7 @@ example.)</doc>
6765168474 version="2.8">
6765268475 <doc xml:space="preserve"
6765368476 filename="glib/gdataset.c"
67654- line="1604">Turns off flag values for a data list. See g_datalist_unset_flags()</doc>
68477+ line="1644">Turns off flag values for a data list. See g_datalist_unset_flags()</doc>
6765568478 <source-position filename="glib/gdataset.h" line="99"/>
6765668479 <return-value transfer-ownership="none">
6765768480 <type name="none" c:type="void"/>
@@ -67660,13 +68483,13 @@ example.)</doc>
6766068483 <parameter name="datalist" transfer-ownership="none">
6766168484 <doc xml:space="preserve"
6766268485 filename="glib/gdataset.c"
67663- line="1606">pointer to the location that holds a list</doc>
68486+ line="1646">pointer to the location that holds a list</doc>
6766468487 <type name="Data" c:type="GData**"/>
6766568488 </parameter>
6766668489 <parameter name="flags" transfer-ownership="none">
6766768490 <doc xml:space="preserve"
6766868491 filename="glib/gdataset.c"
67669- line="1607">the flags to turn off. The values of the flags are
68492+ line="1647">the flags to turn off. The values of the flags are
6767068493 restricted by %G_DATALIST_FLAGS_MASK (currently
6767168494 3: giving two possible boolean flags).
6767268495 A value for @flags that doesn't fit within the mask is
@@ -67678,7 +68501,7 @@ example.)</doc>
6767868501 <function name="dataset_destroy" c:identifier="g_dataset_destroy">
6767968502 <doc xml:space="preserve"
6768068503 filename="glib/gdataset.c"
67681- line="579">Destroys the dataset, freeing all memory allocated, and calling any
68504+ line="575">Destroys the dataset, freeing all memory allocated, and calling any
6768268505 destroy functions set for data elements.</doc>
6768368506 <source-position filename="glib/gdataset.h" line="120"/>
6768468507 <return-value transfer-ownership="none">
@@ -67688,7 +68511,7 @@ destroy functions set for data elements.</doc>
6768868511 <parameter name="dataset_location" transfer-ownership="none">
6768968512 <doc xml:space="preserve"
6769068513 filename="glib/gdataset.c"
67691- line="581">the location identifying the dataset.</doc>
68514+ line="577">the location identifying the dataset.</doc>
6769268515 <type name="gpointer" c:type="gconstpointer"/>
6769368516 </parameter>
6769468517 </parameters>
@@ -67696,7 +68519,7 @@ destroy functions set for data elements.</doc>
6769668519 <function name="dataset_foreach" c:identifier="g_dataset_foreach">
6769768520 <doc xml:space="preserve"
6769868521 filename="glib/gdataset.c"
67699- line="1463">Calls the given function for each data element which is associated
68522+ line="1503">Calls the given function for each data element which is associated
6770068523 with the given location. Note that this function is NOT thread-safe.
6770168524 So unless @dataset_location can be protected from any modifications
6770268525 during invocation of this function, it should not be called.
@@ -67712,7 +68535,7 @@ than skipping over elements that are removed.</doc>
6771268535 <parameter name="dataset_location" transfer-ownership="none">
6771368536 <doc xml:space="preserve"
6771468537 filename="glib/gdataset.c"
67715- line="1465">the location identifying the dataset.</doc>
68538+ line="1505">the location identifying the dataset.</doc>
6771668539 <type name="gpointer" c:type="gconstpointer"/>
6771768540 </parameter>
6771868541 <parameter name="func"
@@ -67721,7 +68544,7 @@ than skipping over elements that are removed.</doc>
6772168544 closure="2">
6772268545 <doc xml:space="preserve"
6772368546 filename="glib/gdataset.c"
67724- line="1466">the function to call for each data element.</doc>
68547+ line="1506">the function to call for each data element.</doc>
6772568548 <type name="DataForeachFunc" c:type="GDataForeachFunc"/>
6772668549 </parameter>
6772768550 <parameter name="user_data"
@@ -67730,7 +68553,7 @@ than skipping over elements that are removed.</doc>
6773068553 allow-none="1">
6773168554 <doc xml:space="preserve"
6773268555 filename="glib/gdataset.c"
67733- line="1467">user data to pass to the function.</doc>
68556+ line="1507">user data to pass to the function.</doc>
6773468557 <type name="gpointer" c:type="gpointer"/>
6773568558 </parameter>
6773668559 </parameters>
@@ -67740,30 +68563,30 @@ than skipping over elements that are removed.</doc>
6774068563 introspectable="0">
6774168564 <doc xml:space="preserve"
6774268565 filename="glib/gdataset.c"
67743- line="1175">Gets the data element corresponding to a string.</doc>
68566+ line="1206">Gets the data element corresponding to a string.</doc>
6774468567 <source-position filename="glib/gdataset.h" line="143"/>
6774568568 <parameters>
6774668569 <parameter name="l">
6774768570 <doc xml:space="preserve"
6774868571 filename="glib/gdataset.c"
67749- line="1177">the location identifying the dataset.</doc>
68572+ line="1208">the location identifying the dataset.</doc>
6775068573 </parameter>
6775168574 <parameter name="k">
6775268575 <doc xml:space="preserve"
6775368576 filename="glib/gdataset.c"
67754- line="1178">the string identifying the data element.</doc>
68577+ line="1209">the string identifying the data element.</doc>
6775568578 </parameter>
6775668579 </parameters>
6775768580 </function-macro>
6775868581 <function name="dataset_id_get_data" c:identifier="g_dataset_id_get_data">
6775968582 <doc xml:space="preserve"
6776068583 filename="glib/gdataset.c"
67761- line="1165">Gets the data element corresponding to a #GQuark.</doc>
68584+ line="1196">Gets the data element corresponding to a #GQuark.</doc>
6776268585 <source-position filename="glib/gdataset.h" line="122"/>
6776368586 <return-value transfer-ownership="none" nullable="1">
6776468587 <doc xml:space="preserve"
6776568588 filename="glib/gdataset.c"
67766- line="1172">the data element corresponding to
68589+ line="1203">the data element corresponding to
6776768590 the #GQuark, or %NULL if it is not found.</doc>
6776868591 <type name="gpointer" c:type="gpointer"/>
6776968592 </return-value>
@@ -67771,13 +68594,13 @@ than skipping over elements that are removed.</doc>
6777168594 <parameter name="dataset_location" transfer-ownership="none">
6777268595 <doc xml:space="preserve"
6777368596 filename="glib/gdataset.c"
67774- line="1167">the location identifying the dataset.</doc>
68597+ line="1198">the location identifying the dataset.</doc>
6777568598 <type name="gpointer" c:type="gconstpointer"/>
6777668599 </parameter>
6777768600 <parameter name="key_id" transfer-ownership="none">
6777868601 <doc xml:space="preserve"
6777968602 filename="glib/gdataset.c"
67780- line="1168">the #GQuark id to identify the data element.</doc>
68603+ line="1199">the #GQuark id to identify the data element.</doc>
6778168604 <type name="Quark" c:type="GQuark"/>
6778268605 </parameter>
6778368606 </parameters>
@@ -68010,26 +68833,26 @@ function to call when the data element is destroyed.</doc>
6801068833 moved-to="Date.get_days_in_month">
6801168834 <doc xml:space="preserve"
6801268835 filename="glib/gdate.c"
68013- line="1927">Returns the number of days in a month, taking leap
68836+ line="1933">Returns the number of days in a month, taking leap
6801468837 years into account.</doc>
68015- <source-position filename="glib/gdate.h" line="247"/>
68838+ <source-position filename="glib/gdate.h" line="250"/>
6801668839 <return-value transfer-ownership="none">
6801768840 <doc xml:space="preserve"
6801868841 filename="glib/gdate.c"
68019- line="1935">number of days in @month during the @year</doc>
68842+ line="1941">number of days in @month during the @year</doc>
6802068843 <type name="guint8" c:type="guint8"/>
6802168844 </return-value>
6802268845 <parameters>
6802368846 <parameter name="month" transfer-ownership="none">
6802468847 <doc xml:space="preserve"
6802568848 filename="glib/gdate.c"
68026- line="1929">month</doc>
68849+ line="1935">month</doc>
6802768850 <type name="DateMonth" c:type="GDateMonth"/>
6802868851 </parameter>
6802968852 <parameter name="year" transfer-ownership="none">
6803068853 <doc xml:space="preserve"
6803168854 filename="glib/gdate.c"
68032- line="1930">year</doc>
68855+ line="1936">year</doc>
6803368856 <type name="DateYear" c:type="GDateYear"/>
6803468857 </parameter>
6803568858 </parameters>
@@ -68039,25 +68862,25 @@ years into account.</doc>
6803968862 moved-to="Date.get_monday_weeks_in_year">
6804068863 <doc xml:space="preserve"
6804168864 filename="glib/gdate.c"
68042- line="1951">Returns the number of weeks in the year, where weeks
68865+ line="1957">Returns the number of weeks in the year, where weeks
6804368866 are taken to start on Monday. Will be 52 or 53. The
6804468867 date must be valid. (Years always have 52 7-day periods,
6804568868 plus 1 or 2 extra days depending on whether it's a leap
6804668869 year. This function is basically telling you how many
6804768870 Mondays are in the year, i.e. there are 53 Mondays if
6804868871 one of the extra days happens to be a Monday.)</doc>
68049- <source-position filename="glib/gdate.h" line="250"/>
68872+ <source-position filename="glib/gdate.h" line="253"/>
6805068873 <return-value transfer-ownership="none">
6805168874 <doc xml:space="preserve"
6805268875 filename="glib/gdate.c"
68053- line="1963">number of Mondays in the year</doc>
68876+ line="1969">number of Mondays in the year</doc>
6805468877 <type name="guint8" c:type="guint8"/>
6805568878 </return-value>
6805668879 <parameters>
6805768880 <parameter name="year" transfer-ownership="none">
6805868881 <doc xml:space="preserve"
6805968882 filename="glib/gdate.c"
68060- line="1953">a year</doc>
68883+ line="1959">a year</doc>
6806168884 <type name="DateYear" c:type="GDateYear"/>
6806268885 </parameter>
6806368886 </parameters>
@@ -68067,52 +68890,92 @@ one of the extra days happens to be a Monday.)</doc>
6806768890 moved-to="Date.get_sunday_weeks_in_year">
6806868891 <doc xml:space="preserve"
6806968892 filename="glib/gdate.c"
68070- line="1987">Returns the number of weeks in the year, where weeks
68893+ line="1977">Returns the number of weeks in the year, where weeks
6807168894 are taken to start on Sunday. Will be 52 or 53. The
6807268895 date must be valid. (Years always have 52 7-day periods,
6807368896 plus 1 or 2 extra days depending on whether it's a leap
6807468897 year. This function is basically telling you how many
6807568898 Sundays are in the year, i.e. there are 53 Sundays if
6807668899 one of the extra days happens to be a Sunday.)</doc>
68077- <source-position filename="glib/gdate.h" line="252"/>
68900+ <source-position filename="glib/gdate.h" line="255"/>
6807868901 <return-value transfer-ownership="none">
6807968902 <doc xml:space="preserve"
6808068903 filename="glib/gdate.c"
68081- line="1999">the number of weeks in @year</doc>
68904+ line="1989">the number of weeks in @year</doc>
6808268905 <type name="guint8" c:type="guint8"/>
6808368906 </return-value>
6808468907 <parameters>
6808568908 <parameter name="year" transfer-ownership="none">
6808668909 <doc xml:space="preserve"
6808768910 filename="glib/gdate.c"
68088- line="1989">year to count weeks in</doc>
68911+ line="1979">year to count weeks in</doc>
6808968912 <type name="DateYear" c:type="GDateYear"/>
6809068913 </parameter>
6809168914 </parameters>
6809268915 </function>
68916+ <function name="date_get_weeks_in_year"
68917+ c:identifier="g_date_get_weeks_in_year"
68918+ moved-to="Date.get_weeks_in_year"
68919+ version="2.86">
68920+ <doc xml:space="preserve"
68921+ filename="glib/gdate.c"
68922+ line="1997">Calculates the number of weeks in the year.
68923+
68924+The result depends on which day is considered the first day of the week,
68925+which varies by locale. `first_day_of_week` must be valid.
68926+
68927+The result will be either 52 or 53. Years always have 52 seven-day periods,
68928+plus one or two extra days depending on whether it’s a leap year. This
68929+function effectively calculates how many @first_day_of_week days there are in
68930+the year.</doc>
68931+ <source-position filename="glib/gdate.h" line="257"/>
68932+ <return-value transfer-ownership="none">
68933+ <doc xml:space="preserve"
68934+ filename="glib/gdate.c"
68935+ line="2015">the number of weeks in @year</doc>
68936+ <type name="guint8" c:type="guint8"/>
68937+ </return-value>
68938+ <parameters>
68939+ <parameter name="year" transfer-ownership="none">
68940+ <doc xml:space="preserve"
68941+ filename="glib/gdate.c"
68942+ line="1999">year to count weeks in</doc>
68943+ <type name="DateYear" c:type="GDateYear"/>
68944+ </parameter>
68945+ <parameter name="first_day_of_week" transfer-ownership="none">
68946+ <doc xml:space="preserve"
68947+ filename="glib/gdate.c"
68948+ line="2000">the day which is considered the first day of the week
68949+ (for example, this would be [enum@GLib.DateWeekday.SUNDAY] in US locales,
68950+ [enum@GLib.DateWeekday.MONDAY] in British locales, and
68951+ [enum@GLib.DateWeekday.SATURDAY] in Egyptian locales</doc>
68952+ <type name="DateWeekday" c:type="GDateWeekday"/>
68953+ </parameter>
68954+ </parameters>
68955+ </function>
6809368956 <function name="date_is_leap_year"
6809468957 c:identifier="g_date_is_leap_year"
6809568958 moved-to="Date.is_leap_year">
6809668959 <doc xml:space="preserve"
6809768960 filename="glib/gdate.c"
68098- line="1905">Returns %TRUE if the year is a leap year.
68961+ line="1911">Returns %TRUE if the year is a leap year.
6809968962
6810068963 For the purposes of this function, leap year is every year
6810168964 divisible by 4 unless that year is divisible by 100. If it
6810268965 is divisible by 100 it would be a leap year only if that year
6810368966 is also divisible by 400.</doc>
68104- <source-position filename="glib/gdate.h" line="245"/>
68967+ <source-position filename="glib/gdate.h" line="248"/>
6810568968 <return-value transfer-ownership="none">
6810668969 <doc xml:space="preserve"
6810768970 filename="glib/gdate.c"
68108- line="1916">%TRUE if the year is a leap year</doc>
68971+ line="1922">%TRUE if the year is a leap year</doc>
6810968972 <type name="gboolean" c:type="gboolean"/>
6811068973 </return-value>
6811168974 <parameters>
6811268975 <parameter name="year" transfer-ownership="none">
6811368976 <doc xml:space="preserve"
6811468977 filename="glib/gdate.c"
68115- line="1907">year to check</doc>
68978+ line="1913">year to check</doc>
6811668979 <type name="DateYear" c:type="GDateYear"/>
6811768980 </parameter>
6811868981 </parameters>
@@ -68122,7 +68985,7 @@ is also divisible by 400.</doc>
6812268985 moved-to="Date.strftime">
6812368986 <doc xml:space="preserve"
6812468987 filename="glib/gdate.c"
68125- line="2626">Generates a printed representation of the date, in a
68988+ line="2645">Generates a printed representation of the date, in a
6812668989 [locale](running.html#locale)-specific way.
6812768990 Works just like the platform's C library strftime() function,
6812868991 but only accepts date-related formats; time-related formats
@@ -68135,36 +68998,36 @@ addition to those implemented by the platform's C library.
6813568998 For example, don't expect that using g_date_strftime() would
6813668999 make the \%F provided by the C99 strftime() work on Windows
6813769000 where the C library only complies to C89.</doc>
68138- <source-position filename="glib/gdate.h" line="281"/>
69001+ <source-position filename="glib/gdate.h" line="287"/>
6813969002 <return-value transfer-ownership="none">
6814069003 <doc xml:space="preserve"
6814169004 filename="glib/gdate.c"
68142- line="2647">number of characters written to the buffer, or `0` if the buffer was too small</doc>
69005+ line="2666">number of characters written to the buffer, or `0` if the buffer was too small</doc>
6814369006 <type name="gsize" c:type="gsize"/>
6814469007 </return-value>
6814569008 <parameters>
6814669009 <parameter name="s" transfer-ownership="none">
6814769010 <doc xml:space="preserve"
6814869011 filename="glib/gdate.c"
68149- line="2628">destination buffer</doc>
69012+ line="2647">destination buffer</doc>
6815069013 <type name="utf8" c:type="gchar*"/>
6815169014 </parameter>
6815269015 <parameter name="slen" transfer-ownership="none">
6815369016 <doc xml:space="preserve"
6815469017 filename="glib/gdate.c"
68155- line="2629">buffer size</doc>
69018+ line="2648">buffer size</doc>
6815669019 <type name="gsize" c:type="gsize"/>
6815769020 </parameter>
6815869021 <parameter name="format" transfer-ownership="none">
6815969022 <doc xml:space="preserve"
6816069023 filename="glib/gdate.c"
68161- line="2630">format string</doc>
69024+ line="2649">format string</doc>
6816269025 <type name="utf8" c:type="const gchar*"/>
6816369026 </parameter>
6816469027 <parameter name="date" transfer-ownership="none">
6816569028 <doc xml:space="preserve"
6816669029 filename="glib/gdate.c"
68167- line="2631">valid #GDate</doc>
69030+ line="2650">valid #GDate</doc>
6816869031 <type name="Date" c:type="const GDate*"/>
6816969032 </parameter>
6817069033 </parameters>
@@ -68365,7 +69228,7 @@ dcgettext() directly.</doc>
6836569228 introspectable="0">
6836669229 <doc xml:space="preserve"
6836769230 filename="glib/gmessages.c"
68368- line="334">A convenience function/macro to log a debug message.
69231+ line="333">A convenience function/macro to log a debug message.
6836969232
6837069233 The message should typically *not* be translated to the user’s language.
6837169234
@@ -68382,12 +69245,12 @@ to set the allowed domains at runtime, use
6838269245 If structured logging is enabled, this will use [func@GLib.log_structured];
6838369246 otherwise it will use [func@GLib.log]. See
6838469247 [Using Structured Logging](logging.html#using-structured-logging).</doc>
68385- <source-position filename="glib/gmessages.h" line="343"/>
69248+ <source-position filename="glib/gmessages.h" line="346"/>
6838669249 <parameters>
6838769250 <parameter name="...">
6838869251 <doc xml:space="preserve"
6838969252 filename="glib/gmessages.c"
68390- line="336">format string, followed by parameters to insert into the format string
69253+ line="335">format string, followed by parameters to insert into the format string
6839169254 (as with `printf()`)</doc>
6839269255 </parameter>
6839369256 </parameters>
@@ -68460,7 +69323,7 @@ but use the _() macro for translations.</doc>
6846069323 throws="1">
6846169324 <doc xml:space="preserve"
6846269325 filename="glib/gfileutils.c"
68463- line="1864">Creates a subdirectory in the preferred directory for temporary
69326+ line="1885">Creates a subdirectory in the preferred directory for temporary
6846469327 files (as returned by g_get_tmp_dir()).
6846569328
6846669329 @tmpl should be a string in the GLib file name encoding containing
@@ -68475,7 +69338,7 @@ modified, and might thus be a read-only literal string.</doc>
6847569338 <return-value transfer-ownership="full">
6847669339 <doc xml:space="preserve"
6847769340 filename="glib/gfileutils.c"
68478- line="1882">The actual name used. This string
69341+ line="1903">The actual name used. This string
6847969342 should be freed with g_free() when not needed any longer and is
6848069343 is in the GLib file name encoding. In case of errors, %NULL is
6848169344 returned and @error will be set.</doc>
@@ -68488,7 +69351,7 @@ modified, and might thus be a read-only literal string.</doc>
6848869351 allow-none="1">
6848969352 <doc xml:space="preserve"
6849069353 filename="glib/gfileutils.c"
68491- line="1866">Template for directory name,
69354+ line="1887">Template for directory name,
6849269355 as in g_mkdtemp(), basename only, or %NULL for a default template</doc>
6849369356 <type name="filename" c:type="const gchar*"/>
6849469357 </parameter>
@@ -68497,7 +69360,7 @@ modified, and might thus be a read-only literal string.</doc>
6849769360 <function name="direct_equal" c:identifier="g_direct_equal">
6849869361 <doc xml:space="preserve"
6849969362 filename="glib/ghash.c"
68500- line="2500">Compares two #gpointer arguments and returns %TRUE if they are equal.
69363+ line="2503">Compares two #gpointer arguments and returns %TRUE if they are equal.
6850169364 It can be passed to g_hash_table_new() as the @key_equal_func
6850269365 parameter, when using opaque pointers compared by pointer value as
6850369366 keys in a #GHashTable.
@@ -68508,7 +69371,7 @@ stored in pointers, such as `GINT_TO_POINTER (n)`.</doc>
6850869371 <return-value transfer-ownership="none">
6850969372 <doc xml:space="preserve"
6851069373 filename="glib/ghash.c"
68511- line="2513">%TRUE if the two keys match.</doc>
69374+ line="2516">%TRUE if the two keys match.</doc>
6851269375 <type name="gboolean" c:type="gboolean"/>
6851369376 </return-value>
6851469377 <parameters>
@@ -68518,7 +69381,7 @@ stored in pointers, such as `GINT_TO_POINTER (n)`.</doc>
6851869381 allow-none="1">
6851969382 <doc xml:space="preserve"
6852069383 filename="glib/ghash.c"
68521- line="2502">a key</doc>
69384+ line="2505">a key</doc>
6852269385 <type name="gpointer" c:type="gconstpointer"/>
6852369386 </parameter>
6852469387 <parameter name="v2"
@@ -68527,7 +69390,7 @@ stored in pointers, such as `GINT_TO_POINTER (n)`.</doc>
6852769390 allow-none="1">
6852869391 <doc xml:space="preserve"
6852969392 filename="glib/ghash.c"
68530- line="2503">a key to compare with @v1</doc>
69393+ line="2506">a key to compare with @v1</doc>
6853169394 <type name="gpointer" c:type="gconstpointer"/>
6853269395 </parameter>
6853369396 </parameters>
@@ -68535,7 +69398,7 @@ stored in pointers, such as `GINT_TO_POINTER (n)`.</doc>
6853569398 <function name="direct_hash" c:identifier="g_direct_hash">
6853669399 <doc xml:space="preserve"
6853769400 filename="glib/ghash.c"
68538- line="2480">Converts a gpointer to a hash value.
69401+ line="2483">Converts a gpointer to a hash value.
6853969402 It can be passed to g_hash_table_new() as the @hash_func parameter,
6854069403 when using opaque pointers compared by pointer value as keys in a
6854169404 #GHashTable.
@@ -68546,7 +69409,7 @@ stored in pointers, such as `GINT_TO_POINTER (n)`.</doc>
6854669409 <return-value transfer-ownership="none">
6854769410 <doc xml:space="preserve"
6854869411 filename="glib/ghash.c"
68549- line="2492">a hash value corresponding to the key.</doc>
69412+ line="2495">a hash value corresponding to the key.</doc>
6855069413 <type name="guint" c:type="guint"/>
6855169414 </return-value>
6855269415 <parameters>
@@ -68556,7 +69419,7 @@ stored in pointers, such as `GINT_TO_POINTER (n)`.</doc>
6855669419 allow-none="1">
6855769420 <doc xml:space="preserve"
6855869421 filename="glib/ghash.c"
68559- line="2482">a #gpointer key</doc>
69422+ line="2485">a #gpointer key</doc>
6856069423 <type name="gpointer" c:type="gconstpointer"/>
6856169424 </parameter>
6856269425 </parameters>
@@ -68611,7 +69474,7 @@ proper.</doc>
6861169474 <function name="double_equal" c:identifier="g_double_equal" version="2.22">
6861269475 <doc xml:space="preserve"
6861369476 filename="glib/ghash.c"
68614- line="2654">Compares the two #gdouble values being pointed to and returns
69477+ line="2657">Compares the two #gdouble values being pointed to and returns
6861569478 %TRUE if they are equal.
6861669479 It can be passed to g_hash_table_new() as the @key_equal_func
6861769480 parameter, when using non-%NULL pointers to doubles as keys in a
@@ -68620,20 +69483,20 @@ parameter, when using non-%NULL pointers to doubles as keys in a
6862069483 <return-value transfer-ownership="none">
6862169484 <doc xml:space="preserve"
6862269485 filename="glib/ghash.c"
68623- line="2665">%TRUE if the two keys match.</doc>
69486+ line="2668">%TRUE if the two keys match.</doc>
6862469487 <type name="gboolean" c:type="gboolean"/>
6862569488 </return-value>
6862669489 <parameters>
6862769490 <parameter name="v1" transfer-ownership="none">
6862869491 <doc xml:space="preserve"
6862969492 filename="glib/ghash.c"
68630- line="2656">a pointer to a #gdouble key</doc>
69493+ line="2659">a pointer to a #gdouble key</doc>
6863169494 <type name="gpointer" c:type="gconstpointer"/>
6863269495 </parameter>
6863369496 <parameter name="v2" transfer-ownership="none">
6863469497 <doc xml:space="preserve"
6863569498 filename="glib/ghash.c"
68636- line="2657">a pointer to a #gdouble key to compare with @v1</doc>
69499+ line="2660">a pointer to a #gdouble key to compare with @v1</doc>
6863769500 <type name="gpointer" c:type="gconstpointer"/>
6863869501 </parameter>
6863969502 </parameters>
@@ -68641,7 +69504,7 @@ parameter, when using non-%NULL pointers to doubles as keys in a
6864169504 <function name="double_hash" c:identifier="g_double_hash" version="2.22">
6864269505 <doc xml:space="preserve"
6864369506 filename="glib/ghash.c"
68644- line="2676">Converts a pointer to a #gdouble to a hash value.
69507+ line="2679">Converts a pointer to a #gdouble to a hash value.
6864569508 It can be passed to g_hash_table_new() as the @hash_func parameter,
6864669509 It can be passed to g_hash_table_new() as the @hash_func parameter,
6864769510 when using non-%NULL pointers to doubles as keys in a #GHashTable.</doc>
@@ -68649,14 +69512,14 @@ when using non-%NULL pointers to doubles as keys in a #GHashTable.</doc>
6864969512 <return-value transfer-ownership="none">
6865069513 <doc xml:space="preserve"
6865169514 filename="glib/ghash.c"
68652- line="2685">a hash value corresponding to the key.</doc>
69515+ line="2688">a hash value corresponding to the key.</doc>
6865369516 <type name="guint" c:type="guint"/>
6865469517 </return-value>
6865569518 <parameters>
6865669519 <parameter name="v" transfer-ownership="none">
6865769520 <doc xml:space="preserve"
6865869521 filename="glib/ghash.c"
68659- line="2678">a pointer to a #gdouble key</doc>
69522+ line="2681">a pointer to a #gdouble key</doc>
6866069523 <type name="gpointer" c:type="gconstpointer"/>
6866169524 </parameter>
6866269525 </parameters>
@@ -68890,7 +69753,7 @@ environment @envp.</doc>
6889069753 <function-macro name="error" c:identifier="g_error" introspectable="0">
6889169754 <doc xml:space="preserve"
6889269755 filename="glib/gmessages.c"
68893- line="280">A convenience function/macro to log an error message.
69756+ line="279">A convenience function/macro to log an error message.
6889469757
6889569758 The message should typically *not* be translated to the user’s language.
6889669759
@@ -68911,12 +69774,12 @@ manually.
6891169774 If structured logging is enabled, this will use [func@GLib.log_structured];
6891269775 otherwise it will use [func@GLib.log]. See
6891369776 [Using Structured Logging](logging.html#using-structured-logging).</doc>
68914- <source-position filename="glib/gmessages.h" line="325"/>
69777+ <source-position filename="glib/gmessages.h" line="328"/>
6891569778 <parameters>
6891669779 <parameter name="...">
6891769780 <doc xml:space="preserve"
6891869781 filename="glib/gmessages.c"
68919- line="282">format string, followed by parameters to insert into the format string
69782+ line="281">format string, followed by parameters to insert into the format string
6892069783 (as with `printf()`)</doc>
6892169784 </parameter>
6892269785 </parameters>
@@ -69170,7 +70033,7 @@ codes are those in the #GFileError enumeration. In the error case,
6917070033 <function name="file_open_tmp" c:identifier="g_file_open_tmp" throws="1">
6917170034 <doc xml:space="preserve"
6917270035 filename="glib/gfileutils.c"
69173- line="1808">Opens a file for writing in the preferred directory for temporary
70036+ line="1829">Opens a file for writing in the preferred directory for temporary
6917470037 files (as returned by g_get_tmp_dir()).
6917570038
6917670039 @tmpl should be a string in the GLib file name encoding containing
@@ -69190,7 +70053,7 @@ name encoding.</doc>
6919070053 <return-value transfer-ownership="none">
6919170054 <doc xml:space="preserve"
6919270055 filename="glib/gfileutils.c"
69193- line="1833">A file handle (as from open()) to the file opened for
70056+ line="1854">A file handle (as from open()) to the file opened for
6919470057 reading and writing. The file is opened in binary mode on platforms
6919570058 where there is a difference. The file handle should be closed with
6919670059 close(). In case of errors, -1 is returned and @error will be set.</doc>
@@ -69203,7 +70066,7 @@ name encoding.</doc>
6920370066 allow-none="1">
6920470067 <doc xml:space="preserve"
6920570068 filename="glib/gfileutils.c"
69206- line="1810">Template for file name, as in
70069+ line="1831">Template for file name, as in
6920770070 g_mkstemp(), basename only, or %NULL for a default template</doc>
6920870071 <type name="filename" c:type="const gchar*"/>
6920970072 </parameter>
@@ -69213,7 +70076,7 @@ name encoding.</doc>
6921370076 transfer-ownership="full">
6921470077 <doc xml:space="preserve"
6921570078 filename="glib/gfileutils.c"
69216- line="1812">location to store actual name used,
70079+ line="1833">location to store actual name used,
6921770080 or %NULL</doc>
6921870081 <type name="filename" c:type="gchar**"/>
6921970082 </parameter>
@@ -69225,7 +70088,7 @@ name encoding.</doc>
6922570088 throws="1">
6922670089 <doc xml:space="preserve"
6922770090 filename="glib/gfileutils.c"
69228- line="2311">Reads the contents of the symbolic link @filename like the POSIX
70091+ line="2332">Reads the contents of the symbolic link @filename like the POSIX
6922970092 `readlink()` function.
6923070093
6923170094 The returned string is in the encoding used for filenames. Use
@@ -69252,7 +70115,7 @@ if (!g_path_is_absolute (link_target))
6925270115 <return-value transfer-ownership="full">
6925370116 <doc xml:space="preserve"
6925470117 filename="glib/gfileutils.c"
69255- line="2340">A newly-allocated string with
70118+ line="2361">A newly-allocated string with
6925670119 the contents of the symbolic link, or %NULL if an error occurred.</doc>
6925770120 <type name="filename" c:type="gchar*"/>
6925870121 </return-value>
@@ -69260,7 +70123,7 @@ if (!g_path_is_absolute (link_target))
6926070123 <parameter name="filename" transfer-ownership="none">
6926170124 <doc xml:space="preserve"
6926270125 filename="glib/gfileutils.c"
69263- line="2313">the symbolic link</doc>
70126+ line="2334">the symbolic link</doc>
6926470127 <type name="filename" c:type="const gchar*"/>
6926570128 </parameter>
6926670129 </parameters>
@@ -69364,8 +70227,8 @@ Note that the name for the temporary file is constructed by appending up
6936470227 to 7 characters to @filename.
6936570228
6936670229 If the file didn’t exist before and is created, it will be given the
69367-permissions from @mode. Otherwise, the permissions of the existing file may
69368-be changed to @mode depending on @flags, or they may remain unchanged.</doc>
70230+permissions from @mode. Otherwise, the permissions of the existing file will
70231+remain unchanged.</doc>
6936970232 <source-position filename="glib/gfileutils.h" line="131"/>
6937070233 <return-value transfer-ownership="none">
6937170234 <doc xml:space="preserve"
@@ -69831,7 +70694,7 @@ including the type suffix.</doc>
6983170694 <function name="fopen" c:identifier="g_fopen" version="2.6">
6983270695 <doc xml:space="preserve"
6983370696 filename="glib/gstdio.c"
69834- line="1542">A wrapper for the stdio `fopen()` function. The `fopen()` function
70697+ line="1553">A wrapper for the stdio `fopen()` function. The `fopen()` function
6983570698 opens a file and associates a new stream with it.
6983670699
6983770700 Because file descriptors are specific to the C library on Windows,
@@ -69846,12 +70709,19 @@ See your C library manual for more details about `fopen()`.
6984670709 As `close()` and `fclose()` are part of the C library, this implies that it is
6984770710 currently impossible to close a file if the application C library and the C library
6984870711 used by GLib are different. Convenience functions like g_file_set_contents_full()
69849-avoid this problem.</doc>
70712+avoid this problem.
70713+
70714+Since GLib 2.86, the `e` option is supported in @mode on all platforms. On
70715+Unix platforms it will set `O_CLOEXEC` on the opened file descriptor. On
70716+Windows platforms it will be converted to the
70717+[`N` modifier](https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/fopen-wfopen?view=msvc-170).
70718+It is recommended to set `e` unconditionally, unless you know the returned
70719+file should be shared between this process and a new fork.</doc>
6985070720 <source-position filename="glib/gstdio.h" line="157"/>
6985170721 <return-value transfer-ownership="none" nullable="1">
6985270722 <doc xml:space="preserve"
6985370723 filename="glib/gstdio.c"
69854- line="1565">A `FILE*` if the file was successfully opened, or %NULL if
70724+ line="1583">A `FILE*` if the file was successfully opened, or %NULL if
6985570725 an error occurred</doc>
6985670726 <type name="gpointer" c:type="FILE*"/>
6985770727 </return-value>
@@ -69859,14 +70729,14 @@ avoid this problem.</doc>
6985970729 <parameter name="filename" transfer-ownership="none">
6986070730 <doc xml:space="preserve"
6986170731 filename="glib/gstdio.c"
69862- line="1544">a pathname in the GLib file name encoding
70732+ line="1555">a pathname in the GLib file name encoding
6986370733 (UTF-8 on Windows)</doc>
6986470734 <type name="filename" c:type="const gchar*"/>
6986570735 </parameter>
6986670736 <parameter name="mode" transfer-ownership="none">
6986770737 <doc xml:space="preserve"
6986870738 filename="glib/gstdio.c"
69869- line="1546">a string describing the mode in which the file should be opened</doc>
70739+ line="1557">a string describing the mode in which the file should be opened</doc>
6987070740 <type name="utf8" c:type="const gchar*"/>
6987170741 </parameter>
6987270742 </parameters>
@@ -69874,7 +70744,7 @@ avoid this problem.</doc>
6987470744 <function name="format_size" c:identifier="g_format_size" version="2.30">
6987570745 <doc xml:space="preserve"
6987670746 filename="glib/gutils.c"
69877- line="2883">Formats a size (for example the size of a file) into a human readable
70747+ line="2885">Formats a size (for example the size of a file) into a human readable
6987870748 string. Sizes are rounded to the nearest size prefix (kB, MB, GB)
6987970749 and are displayed rounded to the nearest tenth. E.g. the file size
6988070750 3292528 bytes will be converted into the string "3.2 MB". The returned string
@@ -69891,7 +70761,7 @@ formatted.</doc>
6989170761 <return-value transfer-ownership="full">
6989270762 <doc xml:space="preserve"
6989370763 filename="glib/gutils.c"
69894- line="2901">a newly-allocated formatted string containing
70764+ line="2903">a newly-allocated formatted string containing
6989570765 a human readable file size</doc>
6989670766 <type name="utf8" c:type="gchar*"/>
6989770767 </return-value>
@@ -69899,7 +70769,7 @@ formatted.</doc>
6989970769 <parameter name="size" transfer-ownership="none">
6990070770 <doc xml:space="preserve"
6990170771 filename="glib/gutils.c"
69902- line="2885">a size in bytes</doc>
70772+ line="2887">a size in bytes</doc>
6990370773 <type name="guint64" c:type="guint64"/>
6990470774 </parameter>
6990570775 </parameters>
@@ -69911,7 +70781,7 @@ formatted.</doc>
6991170781 deprecated-version="2.30">
6991270782 <doc xml:space="preserve"
6991370783 filename="glib/gutils.c"
69914- line="3181">Formats a size (for example the size of a file) into a human
70784+ line="3183">Formats a size (for example the size of a file) into a human
6991570785 readable string. Sizes are rounded to the nearest size prefix
6991670786 (KB, MB, GB) and are displayed rounded to the nearest tenth.
6991770787 E.g. the file size 3292528 bytes will be converted into the
@@ -69926,7 +70796,7 @@ This string should be freed with g_free() when not needed any longer.</doc>
6992670796 <return-value transfer-ownership="full">
6992770797 <doc xml:space="preserve"
6992870798 filename="glib/gutils.c"
69929- line="3195">a newly-allocated formatted string
70799+ line="3197">a newly-allocated formatted string
6993070800 containing a human readable file size</doc>
6993170801 <type name="utf8" c:type="gchar*"/>
6993270802 </return-value>
@@ -69934,7 +70804,7 @@ This string should be freed with g_free() when not needed any longer.</doc>
6993470804 <parameter name="size" transfer-ownership="none">
6993570805 <doc xml:space="preserve"
6993670806 filename="glib/gutils.c"
69937- line="3183">a size in bytes</doc>
70807+ line="3185">a size in bytes</doc>
6993870808 <type name="gint64" c:type="goffset"/>
6993970809 </parameter>
6994070810 </parameters>
@@ -69944,7 +70814,7 @@ This string should be freed with g_free() when not needed any longer.</doc>
6994470814 version="2.30">
6994570815 <doc xml:space="preserve"
6994670816 filename="glib/gutils.c"
69947- line="2936">Formats a size.
70817+ line="2938">Formats a size.
6994870818
6994970819 This function is similar to g_format_size() but allows for flags
6995070820 that modify the output. See #GFormatSizeFlags.</doc>
@@ -69952,7 +70822,7 @@ that modify the output. See #GFormatSizeFlags.</doc>
6995270822 <return-value transfer-ownership="full">
6995370823 <doc xml:space="preserve"
6995470824 filename="glib/gutils.c"
69955- line="2946">a newly-allocated formatted string
70825+ line="2948">a newly-allocated formatted string
6995670826 containing a human readable file size</doc>
6995770827 <type name="utf8" c:type="gchar*"/>
6995870828 </return-value>
@@ -69960,13 +70830,13 @@ that modify the output. See #GFormatSizeFlags.</doc>
6996070830 <parameter name="size" transfer-ownership="none">
6996170831 <doc xml:space="preserve"
6996270832 filename="glib/gutils.c"
69963- line="2938">a size in bytes</doc>
70833+ line="2940">a size in bytes</doc>
6996470834 <type name="guint64" c:type="guint64"/>
6996570835 </parameter>
6996670836 <parameter name="flags" transfer-ownership="none">
6996770837 <doc xml:space="preserve"
6996870838 filename="glib/gutils.c"
69969- line="2939">#GFormatSizeFlags to modify the output</doc>
70839+ line="2941">#GFormatSizeFlags to modify the output</doc>
6997070840 <type name="FormatSizeFlags" c:type="GFormatSizeFlags"/>
6997170841 </parameter>
6997270842 </parameters>
@@ -69977,7 +70847,7 @@ that modify the output. See #GFormatSizeFlags.</doc>
6997770847 introspectable="0">
6997870848 <doc xml:space="preserve"
6997970849 filename="glib/gprintf.c"
69980- line="64">An implementation of the standard `fprintf()` function which supports
70850+ line="65">An implementation of the standard `fprintf()` function which supports
6998170851 positional parameters, as specified in the Single Unix Specification.
6998270852
6998370853 `glib/gprintf.h` must be explicitly included in order to use this function.</doc>
@@ -69985,27 +70855,27 @@ positional parameters, as specified in the Single Unix Specification.
6998570855 <return-value transfer-ownership="none">
6998670856 <doc xml:space="preserve"
6998770857 filename="glib/gprintf.c"
69988- line="76">the number of bytes printed</doc>
70858+ line="77">the number of bytes printed</doc>
6998970859 <type name="gint" c:type="gint"/>
6999070860 </return-value>
6999170861 <parameters>
6999270862 <parameter name="file" transfer-ownership="none">
6999370863 <doc xml:space="preserve"
6999470864 filename="glib/gprintf.c"
69995- line="66">the stream to write to</doc>
70865+ line="67">the stream to write to</doc>
6999670866 <type name="gpointer" c:type="FILE*"/>
6999770867 </parameter>
6999870868 <parameter name="format" transfer-ownership="none">
6999970869 <doc xml:space="preserve"
7000070870 filename="glib/gprintf.c"
70001- line="67">a standard `printf()` format string, but notice
70871+ line="68">a standard `printf()` format string, but notice
7000270872 [string precision pitfalls](string-utils.html#string-precision-pitfalls)</doc>
7000370873 <type name="utf8" c:type="const gchar*"/>
7000470874 </parameter>
7000570875 <parameter name="..." transfer-ownership="none">
7000670876 <doc xml:space="preserve"
7000770877 filename="glib/gprintf.c"
70008- line="69">the arguments to insert in the output</doc>
70878+ line="70">the arguments to insert in the output</doc>
7000970879 <varargs/>
7001070880 </parameter>
7001170881 </parameters>
@@ -70081,15 +70951,18 @@ since GLib 2.78.</doc>
7008170951 <function name="freopen" c:identifier="g_freopen" version="2.6">
7008270952 <doc xml:space="preserve"
7008370953 filename="glib/gstdio.c"
70084- line="1609">A wrapper for the POSIX freopen() function. The freopen() function
70954+ line="1627">A wrapper for the POSIX freopen() function. The freopen() function
7008570955 opens a file and associates it with an existing stream.
7008670956
70087-See your C library manual for more details about freopen().</doc>
70957+See your C library manual for more details about freopen().
70958+
70959+Since GLib 2.86, the `e` option is supported in @mode on all platforms. See
70960+the documentation for [func@GLib.fopen] for more details.</doc>
7008870961 <source-position filename="glib/gstdio.h" line="161"/>
7008970962 <return-value transfer-ownership="none" nullable="1">
7009070963 <doc xml:space="preserve"
7009170964 filename="glib/gstdio.c"
70092- line="1621">A FILE* if the file was successfully opened, or %NULL if
70965+ line="1642">A FILE* if the file was successfully opened, or %NULL if
7009370966 an error occurred.</doc>
7009470967 <type name="gpointer" c:type="FILE*"/>
7009570968 </return-value>
@@ -70097,14 +70970,14 @@ See your C library manual for more details about freopen().</doc>
7009770970 <parameter name="filename" transfer-ownership="none">
7009870971 <doc xml:space="preserve"
7009970972 filename="glib/gstdio.c"
70100- line="1611">a pathname in the GLib file name encoding
70973+ line="1629">a pathname in the GLib file name encoding
7010170974 (UTF-8 on Windows)</doc>
7010270975 <type name="filename" c:type="const gchar*"/>
7010370976 </parameter>
7010470977 <parameter name="mode" transfer-ownership="none">
7010570978 <doc xml:space="preserve"
7010670979 filename="glib/gstdio.c"
70107- line="1613">a string describing the mode in which the file should be opened</doc>
70980+ line="1631">a string describing the mode in which the file should be opened</doc>
7010870981 <type name="utf8" c:type="const gchar*"/>
7010970982 </parameter>
7011070983 <parameter name="stream"
@@ -70113,7 +70986,7 @@ See your C library manual for more details about freopen().</doc>
7011370986 allow-none="1">
7011470987 <doc xml:space="preserve"
7011570988 filename="glib/gstdio.c"
70116- line="1614">an existing stream which will be reused, or %NULL</doc>
70989+ line="1632">an existing stream which will be reused, or %NULL</doc>
7011770990 <type name="gpointer" c:type="FILE*"/>
7011870991 </parameter>
7011970992 </parameters>
@@ -70121,7 +70994,7 @@ See your C library manual for more details about freopen().</doc>
7012170994 <function name="fsync" c:identifier="g_fsync" version="2.64">
7012270995 <doc xml:space="preserve"
7012370996 filename="glib/gstdio.c"
70124- line="1666">A wrapper for the POSIX `fsync()` function. On Windows, `_commit()` will be
70997+ line="1687">A wrapper for the POSIX `fsync()` function. On Windows, `_commit()` will be
7012570998 used. On macOS, `fcntl(F_FULLFSYNC)` will be used.
7012670999 The `fsync()` function is used to synchronize a file's in-core
7012771000 state with that of the disk.
@@ -70133,7 +71006,7 @@ See the C library manual for more details about fsync().</doc>
7013371006 <return-value transfer-ownership="none">
7013471007 <doc xml:space="preserve"
7013571008 filename="glib/gstdio.c"
70136- line="1679">0 on success, or -1 if an error occurred.
71009+ line="1700">0 on success, or -1 if an error occurred.
7013771010 The return value can be used exactly like the return value from fsync().</doc>
7013871011 <type name="gint" c:type="gint"/>
7013971012 </return-value>
@@ -70141,7 +71014,7 @@ The return value can be used exactly like the return value from fsync().</doc>
7014171014 <parameter name="fd" transfer-ownership="none">
7014271015 <doc xml:space="preserve"
7014371016 filename="glib/gstdio.c"
70144- line="1668">a file descriptor</doc>
71017+ line="1689">a file descriptor</doc>
7014571018 <type name="gint" c:type="gint"/>
7014671019 </parameter>
7014771020 </parameters>
@@ -70170,7 +71043,7 @@ been called).</doc>
7017071043 <function name="get_charset" c:identifier="g_get_charset">
7017171044 <doc xml:space="preserve"
7017271045 filename="glib/gcharset.c"
70173- line="174">Obtains the character set for the [current locale](running.html#locale);
71046+ line="175">Obtains the character set for the [current locale](running.html#locale);
7017471047 you might use this character set as an argument to g_convert(), to convert
7017571048 from the current locale's encoding to some other encoding. (Frequently
7017671049 g_locale_to_utf8() and g_locale_from_utf8() are nice shortcuts, though.)
@@ -70195,7 +71068,7 @@ freed.</doc>
7019571068 <return-value transfer-ownership="none">
7019671069 <doc xml:space="preserve"
7019771070 filename="glib/gcharset.c"
70198- line="201">%TRUE if the returned charset is UTF-8</doc>
71071+ line="202">%TRUE if the returned charset is UTF-8</doc>
7019971072 <type name="gboolean" c:type="gboolean"/>
7020071073 </return-value>
7020171074 <parameters>
@@ -70207,7 +71080,7 @@ freed.</doc>
7020771080 allow-none="1">
7020871081 <doc xml:space="preserve"
7020971082 filename="glib/gcharset.c"
70210- line="176">return location for character set
71083+ line="177">return location for character set
7021171084 name, or %NULL.</doc>
7021271085 <type name="utf8" c:type="const char**"/>
7021371086 </parameter>
@@ -70216,12 +71089,12 @@ freed.</doc>
7021671089 <function name="get_codeset" c:identifier="g_get_codeset">
7021771090 <doc xml:space="preserve"
7021871091 filename="glib/gcharset.c"
70219- line="315">Gets the character set for the current locale.</doc>
71092+ line="316">Gets the character set for the current locale.</doc>
7022071093 <source-position filename="glib/gcharset.h" line="35"/>
7022171094 <return-value transfer-ownership="full">
7022271095 <doc xml:space="preserve"
7022371096 filename="glib/gcharset.c"
70224- line="320">a newly allocated string containing the name
71097+ line="321">a newly allocated string containing the name
7022571098 of the character set. This string must be freed with g_free().</doc>
7022671099 <type name="utf8" c:type="gchar*"/>
7022771100 </return-value>
@@ -70231,7 +71104,7 @@ freed.</doc>
7023171104 version="2.62">
7023271105 <doc xml:space="preserve"
7023371106 filename="glib/gcharset.c"
70234- line="333">Obtains the character set used by the console attached to the process,
71107+ line="334">Obtains the character set used by the console attached to the process,
7023571108 which is suitable for printing output to the terminal.
7023671109
7023771110 Usually this matches the result returned by g_get_charset(), but in
@@ -70252,7 +71125,7 @@ freed.</doc>
7025271125 <return-value transfer-ownership="none">
7025371126 <doc xml:space="preserve"
7025471127 filename="glib/gcharset.c"
70255- line="356">%TRUE if the returned charset is UTF-8</doc>
71128+ line="357">%TRUE if the returned charset is UTF-8</doc>
7025671129 <type name="gboolean" c:type="gboolean"/>
7025771130 </return-value>
7025871131 <parameters>
@@ -70264,7 +71137,7 @@ freed.</doc>
7026471137 allow-none="1">
7026571138 <doc xml:space="preserve"
7026671139 filename="glib/gcharset.c"
70267- line="335">return location for character set
71140+ line="336">return location for character set
7026871141 name, or %NULL.</doc>
7026971142 <type name="utf8" c:type="const char**"/>
7027071143 </parameter>
@@ -70273,7 +71146,7 @@ freed.</doc>
7027371146 <function name="get_current_dir" c:identifier="g_get_current_dir">
7027471147 <doc xml:space="preserve"
7027571148 filename="glib/gfileutils.c"
70276- line="2922">Gets the current directory.
71149+ line="2943">Gets the current directory.
7027771150
7027871151 The returned string should be freed when no longer needed.
7027971152 The encoding of the returned string is system defined.
@@ -70287,7 +71160,7 @@ the current directory is the target of a symbolic link.</doc>
7028771160 <return-value transfer-ownership="full">
7028871161 <doc xml:space="preserve"
7028971162 filename="glib/gfileutils.c"
70290- line="2936">the current directory</doc>
71163+ line="2957">the current directory</doc>
7029171164 <type name="filename" c:type="gchar*"/>
7029271165 </return-value>
7029371166 </function>
@@ -70297,12 +71170,15 @@ the current directory is the target of a symbolic link.</doc>
7029771170 deprecated-version="2.62">
7029871171 <doc xml:space="preserve"
7029971172 filename="glib/gmain.c"
70300- line="2835">Equivalent to the UNIX gettimeofday() function, but portable.
71173+ line="2998">Queries the system wall-clock time.
71174+
71175+This is equivalent to the UNIX [`gettimeofday()`](man:gettimeofday(2))
71176+function, but portable.
7030171177
7030271178 You may find [func@GLib.get_real_time] to be more convenient.</doc>
70303- <doc-deprecated xml:space="preserve">#GTimeVal is not year-2038-safe. Use
71179+ <doc-deprecated xml:space="preserve">[struct@GLib.TimeVal] is not year-2038-safe. Use
7030471180 [func@GLib.get_real_time] instead.</doc-deprecated>
70305- <source-position filename="glib/gmain.h" line="825"/>
71181+ <source-position filename="glib/gmain.h" line="828"/>
7030671182 <return-value transfer-ownership="none">
7030771183 <type name="none" c:type="void"/>
7030871184 </return-value>
@@ -70310,7 +71186,7 @@ You may find [func@GLib.get_real_time] to be more convenient.</doc>
7031071186 <parameter name="result" transfer-ownership="none">
7031171187 <doc xml:space="preserve"
7031271188 filename="glib/gmain.c"
70313- line="2837">#GTimeVal structure in which to store current time.</doc>
71189+ line="3000">[struct@GLib.TimeVal] structure in which to store current time</doc>
7031471190 <type name="TimeVal" c:type="GTimeVal*"/>
7031571191 </parameter>
7031671192 </parameters>
@@ -70453,7 +71329,7 @@ The encoding of the returned string is UTF-8.</doc>
7045371329 version="2.6">
7045471330 <doc xml:space="preserve"
7045571331 filename="glib/gcharset.c"
70456- line="751">Computes a list of applicable locale names, which can be used to
71332+ line="752">Computes a list of applicable locale names, which can be used to
7045771333 e.g. construct locale-dependent filenames or search paths. The returned
7045871334 list is sorted from most desirable to least desirable and always contains
7045971335 the default locale "C".
@@ -70468,7 +71344,7 @@ user.</doc>
7046871344 <return-value transfer-ownership="none">
7046971345 <doc xml:space="preserve"
7047071346 filename="glib/gcharset.c"
70471- line="766">a %NULL-terminated array of strings owned by GLib
71347+ line="767">a %NULL-terminated array of strings owned by GLib
7047271348 that must not be modified or freed.</doc>
7047371349 <array c:type="const gchar* const*">
7047471350 <type name="utf8"/>
@@ -70480,7 +71356,7 @@ user.</doc>
7048071356 version="2.58">
7048171357 <doc xml:space="preserve"
7048271358 filename="glib/gcharset.c"
70483- line="777">Computes a list of applicable locale names with a locale category name,
71359+ line="778">Computes a list of applicable locale names with a locale category name,
7048471360 which can be used to construct the fallback locale-dependent filenames
7048571361 or search paths. The returned list is sorted from most desirable to
7048671362 least desirable and always contains the default locale "C".
@@ -70494,7 +71370,7 @@ g_get_language_names() returns g_get_language_names_with_category("LC_MESSAGES")
7049471370 <return-value transfer-ownership="none">
7049571371 <doc xml:space="preserve"
7049671372 filename="glib/gcharset.c"
70497- line="792">a %NULL-terminated array of strings owned by
71373+ line="793">a %NULL-terminated array of strings owned by
7049871374 the thread g_get_language_names_with_category was called from.
7049971375 It must not be modified or freed. It must be copied if planned to be used in another thread.</doc>
7050071376 <array c:type="const gchar* const*">
@@ -70505,7 +71381,7 @@ g_get_language_names() returns g_get_language_names_with_category("LC_MESSAGES")
7050571381 <parameter name="category_name" transfer-ownership="none">
7050671382 <doc xml:space="preserve"
7050771383 filename="glib/gcharset.c"
70508- line="779">a locale category name</doc>
71384+ line="780">a locale category name</doc>
7050971385 <type name="utf8" c:type="const gchar*"/>
7051071386 </parameter>
7051171387 </parameters>
@@ -70515,7 +71391,7 @@ g_get_language_names() returns g_get_language_names_with_category("LC_MESSAGES")
7051571391 version="2.28">
7051671392 <doc xml:space="preserve"
7051771393 filename="glib/gcharset.c"
70518- line="644">Returns a list of derived variants of @locale, which can be used to
71394+ line="645">Returns a list of derived variants of @locale, which can be used to
7051971395 e.g. construct locale-dependent filenames or search paths. The returned
7052071396 list is sorted from most desirable to least desirable.
7052171397 This function handles territory, charset and extra locale modifiers. See
@@ -70534,7 +71410,7 @@ use g_get_language_names().</doc>
7053471410 <return-value transfer-ownership="full">
7053571411 <doc xml:space="preserve"
7053671412 filename="glib/gcharset.c"
70537- line="664">a newly
71413+ line="665">a newly
7053871414 allocated array of newly allocated strings with the locale variants. Free with
7053971415 g_strfreev().</doc>
7054071416 <array c:type="gchar**">
@@ -70545,7 +71421,7 @@ use g_get_language_names().</doc>
7054571421 <parameter name="locale" transfer-ownership="none">
7054671422 <doc xml:space="preserve"
7054771423 filename="glib/gcharset.c"
70548- line="646">a locale identifier</doc>
71424+ line="647">a locale identifier</doc>
7054971425 <type name="utf8" c:type="const gchar*"/>
7055071426 </parameter>
7055171427 </parameters>
@@ -70555,21 +71431,22 @@ use g_get_language_names().</doc>
7055571431 version="2.28">
7055671432 <doc xml:space="preserve"
7055771433 filename="glib/gmain.c"
70558- line="2906">Queries the system monotonic time.
71434+ line="3071">Queries the system monotonic time.
7055971435
70560-The monotonic clock will always increase and doesn't suffer
71436+The monotonic clock will always increase and doesn’t suffer
7056171437 discontinuities when the user (or NTP) changes the system time. It
7056271438 may or may not continue to tick during times where the machine is
7056371439 suspended.
7056471440
7056571441 We try to use the clock that corresponds as closely as possible to
70566-the passage of time as measured by system calls such as poll() but it
71442+the passage of time as measured by system calls such as
71443+[`poll()`](man:poll(2)) but it
7056771444 may not always be possible to do this.</doc>
70568- <source-position filename="glib/gmain.h" line="829"/>
71445+ <source-position filename="glib/gmain.h" line="832"/>
7056971446 <return-value transfer-ownership="none">
7057071447 <doc xml:space="preserve"
7057171448 filename="glib/gmain.c"
70572- line="2920">the monotonic time, in microseconds</doc>
71449+ line="3086">the monotonic time, in microseconds</doc>
7057371450 <type name="gint64" c:type="gint64"/>
7057471451 </return-value>
7057571452 </function>
@@ -70593,7 +71470,7 @@ similar cases.</doc>
7059371470 <function name="get_os_info" c:identifier="g_get_os_info" version="2.64">
7059471471 <doc xml:space="preserve"
7059571472 filename="glib/gutils.c"
70596- line="1659">Get information about the operating system.
71473+ line="1661">Get information about the operating system.
7059771474
7059871475 On Linux this comes from the `/etc/os-release` file. On other systems, it may
7059971476 come from a variety of sources. You can either use the standard key names
@@ -70605,7 +71482,7 @@ check if the result is %NULL.</doc>
7060571482 <return-value transfer-ownership="full" nullable="1">
7060671483 <doc xml:space="preserve"
7060771484 filename="glib/gutils.c"
70608- line="1672">The associated value for the requested key or %NULL if
71485+ line="1674">The associated value for the requested key or %NULL if
7060971486 this information is not provided.</doc>
7061071487 <type name="utf8" c:type="gchar*"/>
7061171488 </return-value>
@@ -70613,7 +71490,7 @@ check if the result is %NULL.</doc>
7061371490 <parameter name="key_name" transfer-ownership="none">
7061471491 <doc xml:space="preserve"
7061571492 filename="glib/gutils.c"
70616- line="1661">a key for the OS info being requested, for example %G_OS_INFO_KEY_NAME.</doc>
71493+ line="1663">a key for the OS info being requested, for example %G_OS_INFO_KEY_NAME.</doc>
7061771494 <type name="utf8" c:type="const gchar*"/>
7061871495 </parameter>
7061971496 </parameters>
@@ -70660,20 +71537,20 @@ returned.</doc>
7066071537 version="2.28">
7066171538 <doc xml:space="preserve"
7066271539 filename="glib/gmain.c"
70663- line="2861">Queries the system wall-clock time.
71540+ line="3027">Queries the system wall-clock time.
7066471541
70665-This call is functionally equivalent to [func@GLib.get_current_time] except
70666-that the return value is often more convenient than dealing with a
70667-#GTimeVal.
71542+This is equivalent to the UNIX [`gettimeofday()`](man:gettimeofday(2))
71543+function, but portable.
7066871544
7066971545 You should only use this call if you are actually interested in the real
7067071546 wall-clock time. [func@GLib.get_monotonic_time] is probably more useful for
7067171547 measuring intervals.</doc>
70672- <source-position filename="glib/gmain.h" line="831"/>
71548+ <source-position filename="glib/gmain.h" line="834"/>
7067371549 <return-value transfer-ownership="none">
7067471550 <doc xml:space="preserve"
7067571551 filename="glib/gmain.c"
70676- line="2874">the number of microseconds since January 1, 1970 UTC.</doc>
71552+ line="3039">the number of microseconds since
71553+ [January 1, 1970 UTC](https://en.wikipedia.org/wiki/Unix_time)</doc>
7067771554 <type name="gint64" c:type="gint64"/>
7067871555 </return-value>
7067971556 </function>
@@ -70682,7 +71559,7 @@ measuring intervals.</doc>
7068271559 version="2.6">
7068371560 <doc xml:space="preserve"
7068471561 filename="glib/gutils.c"
70685- line="2809">Returns an ordered list of base directories in which to access
71562+ line="2811">Returns an ordered list of base directories in which to access
7068671563 system-wide configuration information.
7068771564
7068871565 On UNIX platforms this is determined using the mechanisms described
@@ -70706,7 +71583,7 @@ it’s not thread-safe to modify environment variables at runtime.</doc>
7070671583 <return-value transfer-ownership="none">
7070771584 <doc xml:space="preserve"
7070871585 filename="glib/gutils.c"
70709- line="2833">
71586+ line="2835">
7071071587 a %NULL-terminated array of strings owned by GLib that must not be
7071171588 modified or freed.</doc>
7071271589 <array c:type="const gchar* const*">
@@ -70719,7 +71596,7 @@ it’s not thread-safe to modify environment variables at runtime.</doc>
7071971596 version="2.6">
7072071597 <doc xml:space="preserve"
7072171598 filename="glib/gutils.c"
70722- line="2717">Returns an ordered list of base directories in which to access
71599+ line="2719">Returns an ordered list of base directories in which to access
7072371600 system-wide application data.
7072471601
7072571602 On UNIX platforms this is determined using the mechanisms described
@@ -70757,7 +71634,7 @@ it’s not thread-safe to modify environment variables at runtime.</doc>
7075771634 <return-value transfer-ownership="none">
7075871635 <doc xml:space="preserve"
7075971636 filename="glib/gutils.c"
70760- line="2755">
71637+ line="2757">
7076171638 a %NULL-terminated array of strings owned by GLib that must not be
7076271639 modified or freed.</doc>
7076371640 <array c:type="const gchar* const*">
@@ -70795,7 +71672,7 @@ string.</doc>
7079571672 version="2.6">
7079671673 <doc xml:space="preserve"
7079771674 filename="glib/gutils.c"
70798- line="2018">Returns a base directory in which to store non-essential, cached
71675+ line="2020">Returns a base directory in which to store non-essential, cached
7079971676 data specific to particular user.
7080071677
7080171678 On UNIX platforms this is determined using the mechanisms described
@@ -70815,7 +71692,7 @@ it’s not thread-safe to modify environment variables at runtime.</doc>
7081571692 <return-value transfer-ownership="none">
7081671693 <doc xml:space="preserve"
7081771694 filename="glib/gutils.c"
70818- line="2038">a string owned by GLib that
71695+ line="2040">a string owned by GLib that
7081971696 must not be modified or freed.</doc>
7082071697 <type name="filename" c:type="const gchar*"/>
7082171698 </return-value>
@@ -70825,7 +71702,7 @@ it’s not thread-safe to modify environment variables at runtime.</doc>
7082571702 version="2.6">
7082671703 <doc xml:space="preserve"
7082771704 filename="glib/gutils.c"
70828- line="1954">Returns a base directory in which to store user-specific application
71705+ line="1956">Returns a base directory in which to store user-specific application
7082971706 configuration information such as user preferences and settings.
7083071707
7083171708 On UNIX platforms this is determined using the mechanisms described
@@ -70846,7 +71723,7 @@ it’s not thread-safe to modify environment variables at runtime.</doc>
7084671723 <return-value transfer-ownership="none">
7084771724 <doc xml:space="preserve"
7084871725 filename="glib/gutils.c"
70849- line="1975">a string owned by GLib that
71726+ line="1977">a string owned by GLib that
7085071727 must not be modified or freed.</doc>
7085171728 <type name="filename" c:type="const gchar*"/>
7085271729 </return-value>
@@ -70856,7 +71733,7 @@ it’s not thread-safe to modify environment variables at runtime.</doc>
7085671733 version="2.6">
7085771734 <doc xml:space="preserve"
7085871735 filename="glib/gutils.c"
70859- line="1889">Returns a base directory in which to access application data such
71736+ line="1891">Returns a base directory in which to access application data such
7086071737 as icons that is customized for a particular user.
7086171738
7086271739 On UNIX platforms this is determined using the mechanisms described
@@ -70877,7 +71754,7 @@ it’s not thread-safe to modify environment variables at runtime.</doc>
7087771754 <return-value transfer-ownership="none">
7087871755 <doc xml:space="preserve"
7087971756 filename="glib/gutils.c"
70880- line="1910">a string owned by GLib that must
71757+ line="1912">a string owned by GLib that must
7088171758 not be modified or freed.</doc>
7088271759 <type name="filename" c:type="const gchar*"/>
7088371760 </return-value>
@@ -70902,7 +71779,7 @@ consistent on a machine. On Windows, it is always UTF-8.</doc>
7090271779 version="2.28">
7090371780 <doc xml:space="preserve"
7090471781 filename="glib/gutils.c"
70905- line="2160">Returns a directory that is unique to the current user on the local
71782+ line="2162">Returns a directory that is unique to the current user on the local
7090671783 system.
7090771784
7090871785 This is determined using the mechanisms described
@@ -70919,7 +71796,7 @@ it’s not thread-safe to modify environment variables at runtime.</doc>
7091971796 <return-value transfer-ownership="none">
7092071797 <doc xml:space="preserve"
7092171798 filename="glib/gutils.c"
70922- line="2177">a string owned by GLib that must not be
71799+ line="2179">a string owned by GLib that must not be
7092371800 modified or freed.</doc>
7092471801 <type name="filename" c:type="const gchar*"/>
7092571802 </return-value>
@@ -70929,7 +71806,7 @@ it’s not thread-safe to modify environment variables at runtime.</doc>
7092971806 version="2.14">
7093071807 <doc xml:space="preserve"
7093171808 filename="glib/gutils.c"
70932- line="2450">Returns the full path of a special directory using its logical id.
71809+ line="2452">Returns the full path of a special directory using its logical id.
7093371810
7093471811 On UNIX this is done using the XDG special user directories.
7093571812 For compatibility with existing practise, %G_USER_DIRECTORY_DESKTOP
@@ -70943,7 +71820,7 @@ will not reflect any change once the special directories are loaded.</doc>
7094371820 <return-value transfer-ownership="none" nullable="1">
7094471821 <doc xml:space="preserve"
7094571822 filename="glib/gutils.c"
70946- line="2465">the path to the specified special
71823+ line="2467">the path to the specified special
7094771824 directory, or %NULL if the logical id was not found. The returned string is
7094871825 owned by GLib and should not be modified or freed.</doc>
7094971826 <type name="filename" c:type="const gchar*"/>
@@ -70952,7 +71829,7 @@ will not reflect any change once the special directories are loaded.</doc>
7095271829 <parameter name="directory" transfer-ownership="none">
7095371830 <doc xml:space="preserve"
7095471831 filename="glib/gutils.c"
70955- line="2452">the logical id of special directory</doc>
71832+ line="2454">the logical id of special directory</doc>
7095671833 <type name="UserDirectory" c:type="GUserDirectory"/>
7095771834 </parameter>
7095871835 </parameters>
@@ -70962,7 +71839,7 @@ will not reflect any change once the special directories are loaded.</doc>
7096271839 version="2.72">
7096371840 <doc xml:space="preserve"
7096471841 filename="glib/gutils.c"
70965- line="2081">Returns a base directory in which to store state files specific to
71842+ line="2083">Returns a base directory in which to store state files specific to
7096671843 particular user.
7096771844
7096871845 On UNIX platforms this is determined using the mechanisms described
@@ -70983,7 +71860,7 @@ it’s not thread-safe to modify environment variables at runtime.</doc>
7098371860 <return-value transfer-ownership="none">
7098471861 <doc xml:space="preserve"
7098571862 filename="glib/gutils.c"
70986- line="2102">a string owned by GLib that
71863+ line="2104">a string owned by GLib that
7098771864 must not be modified or freed.</doc>
7098871865 <type name="filename" c:type="const gchar*"/>
7098971866 </return-value>
@@ -71023,7 +71900,7 @@ references to other environment variables, they are expanded.</doc>
7102371900 version="2.32">
7102471901 <doc xml:space="preserve"
7102571902 filename="glib/ghash.c"
71026- line="1637">This is a convenience function for using a #GHashTable as a set. It
71903+ line="1640">This is a convenience function for using a #GHashTable as a set. It
7102771904 is equivalent to calling g_hash_table_replace() with @key as both the
7102871905 key and the value.
7102971906
@@ -71042,14 +71919,14 @@ or not.</doc>
7104271919 <return-value transfer-ownership="none">
7104371920 <doc xml:space="preserve"
7104471921 filename="glib/ghash.c"
71045- line="1658">%TRUE if the key did not exist yet</doc>
71922+ line="1661">%TRUE if the key did not exist yet</doc>
7104671923 <type name="gboolean" c:type="gboolean"/>
7104771924 </return-value>
7104871925 <parameters>
7104971926 <parameter name="hash_table" transfer-ownership="none">
7105071927 <doc xml:space="preserve"
7105171928 filename="glib/ghash.c"
71052- line="1639">a #GHashTable</doc>
71929+ line="1642">a #GHashTable</doc>
7105371930 <type name="GLib.HashTable" c:type="GHashTable*">
7105471931 <type name="gpointer" c:type="gpointer"/>
7105571932 <type name="gpointer" c:type="gpointer"/>
@@ -71061,7 +71938,7 @@ or not.</doc>
7106171938 allow-none="1">
7106271939 <doc xml:space="preserve"
7106371940 filename="glib/ghash.c"
71064- line="1640">a key to insert</doc>
71941+ line="1643">a key to insert</doc>
7106571942 <type name="gpointer" c:type="gpointer"/>
7106671943 </parameter>
7106771944 </parameters>
@@ -71072,19 +71949,19 @@ or not.</doc>
7107271949 version="2.32">
7107371950 <doc xml:space="preserve"
7107471951 filename="glib/ghash.c"
71075- line="1669">Checks if @key is in @hash_table.</doc>
71952+ line="1672">Checks if @key is in @hash_table.</doc>
7107671953 <source-position filename="glib/ghash.h" line="105"/>
7107771954 <return-value transfer-ownership="none">
7107871955 <doc xml:space="preserve"
7107971956 filename="glib/ghash.c"
71080- line="1676">%TRUE if @key is in @hash_table, %FALSE otherwise.</doc>
71957+ line="1679">%TRUE if @key is in @hash_table, %FALSE otherwise.</doc>
7108171958 <type name="gboolean" c:type="gboolean"/>
7108271959 </return-value>
7108371960 <parameters>
7108471961 <parameter name="hash_table" transfer-ownership="none">
7108571962 <doc xml:space="preserve"
7108671963 filename="glib/ghash.c"
71087- line="1671">a #GHashTable</doc>
71964+ line="1674">a #GHashTable</doc>
7108871965 <type name="GLib.HashTable" c:type="GHashTable*">
7108971966 <type name="gpointer" c:type="gpointer"/>
7109071967 <type name="gpointer" c:type="gpointer"/>
@@ -71096,7 +71973,7 @@ or not.</doc>
7109671973 allow-none="1">
7109771974 <doc xml:space="preserve"
7109871975 filename="glib/ghash.c"
71099- line="1672">a key to check</doc>
71976+ line="1675">a key to check</doc>
7110071977 <type name="gpointer" c:type="gconstpointer"/>
7110171978 </parameter>
7110271979 </parameters>
@@ -71106,7 +71983,7 @@ or not.</doc>
7110671983 moved-to="HashTable.destroy">
7110771984 <doc xml:space="preserve"
7110871985 filename="glib/ghash.c"
71109- line="1447">Destroys all keys and values in the #GHashTable and decrements its
71986+ line="1450">Destroys all keys and values in the #GHashTable and decrements its
7111071987 reference count by 1. If keys and/or values are dynamically allocated,
7111171988 you should either free them first or create the #GHashTable with destroy
7111271989 notifiers using g_hash_table_new_full(). In the latter case the destroy
@@ -71120,7 +71997,7 @@ destruction phase.</doc>
7112071997 <parameter name="hash_table" transfer-ownership="none">
7112171998 <doc xml:space="preserve"
7112271999 filename="glib/ghash.c"
71123- line="1449">a #GHashTable</doc>
72000+ line="1452">a #GHashTable</doc>
7112472001 <type name="GLib.HashTable" c:type="GHashTable*">
7112572002 <type name="gpointer" c:type="gpointer"/>
7112672003 <type name="gpointer" c:type="gpointer"/>
@@ -71134,7 +72011,7 @@ destruction phase.</doc>
7113472011 version="2.4">
7113572012 <doc xml:space="preserve"
7113672013 filename="glib/ghash.c"
71137- line="2136">Calls the given function for key/value pairs in the #GHashTable
72014+ line="2139">Calls the given function for key/value pairs in the #GHashTable
7113872015 until @predicate returns %TRUE. The function is passed the key
7113972016 and value of each pair, and the given @user_data parameter. The
7114072017 hash table may not be modified while iterating over it (you can't
@@ -71151,7 +72028,7 @@ values in a hash table ends up needing O(n*n) operations).</doc>
7115172028 <return-value transfer-ownership="none" nullable="1">
7115272029 <doc xml:space="preserve"
7115372030 filename="glib/ghash.c"
71154- line="2156">The value of the first key/value pair is returned,
72031+ line="2159">The value of the first key/value pair is returned,
7115572032 for which @predicate evaluates to %TRUE. If no pair with the
7115672033 requested property is found, %NULL is returned.</doc>
7115772034 <type name="gpointer" c:type="gpointer"/>
@@ -71160,7 +72037,7 @@ values in a hash table ends up needing O(n*n) operations).</doc>
7116072037 <parameter name="hash_table" transfer-ownership="none">
7116172038 <doc xml:space="preserve"
7116272039 filename="glib/ghash.c"
71163- line="2138">a #GHashTable</doc>
72040+ line="2141">a #GHashTable</doc>
7116472041 <type name="GLib.HashTable" c:type="GHashTable*">
7116572042 <type name="gpointer" c:type="gpointer"/>
7116672043 <type name="gpointer" c:type="gpointer"/>
@@ -71172,7 +72049,7 @@ values in a hash table ends up needing O(n*n) operations).</doc>
7117272049 closure="2">
7117372050 <doc xml:space="preserve"
7117472051 filename="glib/ghash.c"
71175- line="2139">function to test the key/value pairs for a certain property</doc>
72052+ line="2142">function to test the key/value pairs for a certain property</doc>
7117672053 <type name="HRFunc" c:type="GHRFunc"/>
7117772054 </parameter>
7117872055 <parameter name="user_data"
@@ -71181,7 +72058,7 @@ values in a hash table ends up needing O(n*n) operations).</doc>
7118172058 allow-none="1">
7118272059 <doc xml:space="preserve"
7118372060 filename="glib/ghash.c"
71184- line="2140">user data to pass to the function</doc>
72061+ line="2143">user data to pass to the function</doc>
7118572062 <type name="gpointer" c:type="gpointer"/>
7118672063 </parameter>
7118772064 </parameters>
@@ -71191,7 +72068,7 @@ values in a hash table ends up needing O(n*n) operations).</doc>
7119172068 moved-to="HashTable.foreach">
7119272069 <doc xml:space="preserve"
7119372070 filename="glib/ghash.c"
71194- line="2085">Calls the given function for each of the key/value pairs in the
72071+ line="2088">Calls the given function for each of the key/value pairs in the
7119572072 #GHashTable. The function is passed the key and value of each
7119672073 pair, and the given @user_data parameter. The hash table may not
7119772074 be modified while iterating over it (you can't add/remove
@@ -71211,7 +72088,7 @@ order searches in contrast to g_hash_table_lookup().</doc>
7121172088 <parameter name="hash_table" transfer-ownership="none">
7121272089 <doc xml:space="preserve"
7121372090 filename="glib/ghash.c"
71214- line="2087">a #GHashTable</doc>
72091+ line="2090">a #GHashTable</doc>
7121572092 <type name="GLib.HashTable" c:type="GHashTable*">
7121672093 <type name="gpointer" c:type="gpointer"/>
7121772094 <type name="gpointer" c:type="gpointer"/>
@@ -71223,7 +72100,7 @@ order searches in contrast to g_hash_table_lookup().</doc>
7122372100 closure="2">
7122472101 <doc xml:space="preserve"
7122572102 filename="glib/ghash.c"
71226- line="2088">the function to call for each key/value pair</doc>
72103+ line="2091">the function to call for each key/value pair</doc>
7122772104 <type name="HFunc" c:type="GHFunc"/>
7122872105 </parameter>
7122972106 <parameter name="user_data"
@@ -71232,7 +72109,7 @@ order searches in contrast to g_hash_table_lookup().</doc>
7123272109 allow-none="1">
7123372110 <doc xml:space="preserve"
7123472111 filename="glib/ghash.c"
71235- line="2089">user data to pass to the function</doc>
72112+ line="2092">user data to pass to the function</doc>
7123672113 <type name="gpointer" c:type="gpointer"/>
7123772114 </parameter>
7123872115 </parameters>
@@ -71242,7 +72119,7 @@ order searches in contrast to g_hash_table_lookup().</doc>
7124272119 moved-to="HashTable.foreach_remove">
7124372120 <doc xml:space="preserve"
7124472121 filename="glib/ghash.c"
71245- line="2030">Calls the given function for each key/value pair in the
72122+ line="2033">Calls the given function for each key/value pair in the
7124672123 #GHashTable. If the function returns %TRUE, then the key/value
7124772124 pair is removed from the #GHashTable. If you supplied key or
7124872125 value destroy functions when creating the #GHashTable, they are
@@ -71254,14 +72131,14 @@ key/value pairs in the hash table.</doc>
7125472131 <return-value transfer-ownership="none">
7125572132 <doc xml:space="preserve"
7125672133 filename="glib/ghash.c"
71257- line="2045">the number of key/value pairs removed</doc>
72134+ line="2048">the number of key/value pairs removed</doc>
7125872135 <type name="guint" c:type="guint"/>
7125972136 </return-value>
7126072137 <parameters>
7126172138 <parameter name="hash_table" transfer-ownership="none">
7126272139 <doc xml:space="preserve"
7126372140 filename="glib/ghash.c"
71264- line="2032">a #GHashTable</doc>
72141+ line="2035">a #GHashTable</doc>
7126572142 <type name="GLib.HashTable" c:type="GHashTable*">
7126672143 <type name="gpointer" c:type="gpointer"/>
7126772144 <type name="gpointer" c:type="gpointer"/>
@@ -71273,7 +72150,7 @@ key/value pairs in the hash table.</doc>
7127372150 closure="2">
7127472151 <doc xml:space="preserve"
7127572152 filename="glib/ghash.c"
71276- line="2033">the function to call for each key/value pair</doc>
72153+ line="2036">the function to call for each key/value pair</doc>
7127772154 <type name="HRFunc" c:type="GHRFunc"/>
7127872155 </parameter>
7127972156 <parameter name="user_data"
@@ -71282,7 +72159,7 @@ key/value pairs in the hash table.</doc>
7128272159 allow-none="1">
7128372160 <doc xml:space="preserve"
7128472161 filename="glib/ghash.c"
71285- line="2034">user data to pass to the function</doc>
72162+ line="2037">user data to pass to the function</doc>
7128672163 <type name="gpointer" c:type="gpointer"/>
7128772164 </parameter>
7128872165 </parameters>
@@ -71292,7 +72169,7 @@ key/value pairs in the hash table.</doc>
7129272169 moved-to="HashTable.foreach_steal">
7129372170 <doc xml:space="preserve"
7129472171 filename="glib/ghash.c"
71295- line="2058">Calls the given function for each key/value pair in the
72172+ line="2061">Calls the given function for each key/value pair in the
7129672173 #GHashTable. If the function returns %TRUE, then the key/value
7129772174 pair is removed from the #GHashTable, but no key or value
7129872175 destroy functions are called.
@@ -71303,14 +72180,14 @@ key/value pairs in the hash table.</doc>
7130372180 <return-value transfer-ownership="none">
7130472181 <doc xml:space="preserve"
7130572182 filename="glib/ghash.c"
71306- line="2072">the number of key/value pairs removed.</doc>
72183+ line="2075">the number of key/value pairs removed.</doc>
7130772184 <type name="guint" c:type="guint"/>
7130872185 </return-value>
7130972186 <parameters>
7131072187 <parameter name="hash_table" transfer-ownership="none">
7131172188 <doc xml:space="preserve"
7131272189 filename="glib/ghash.c"
71313- line="2060">a #GHashTable</doc>
72190+ line="2063">a #GHashTable</doc>
7131472191 <type name="GLib.HashTable" c:type="GHashTable*">
7131572192 <type name="gpointer" c:type="gpointer"/>
7131672193 <type name="gpointer" c:type="gpointer"/>
@@ -71322,7 +72199,7 @@ key/value pairs in the hash table.</doc>
7132272199 closure="2">
7132372200 <doc xml:space="preserve"
7132472201 filename="glib/ghash.c"
71325- line="2061">the function to call for each key/value pair</doc>
72202+ line="2064">the function to call for each key/value pair</doc>
7132672203 <type name="HRFunc" c:type="GHRFunc"/>
7132772204 </parameter>
7132872205 <parameter name="user_data"
@@ -71331,7 +72208,7 @@ key/value pairs in the hash table.</doc>
7133172208 allow-none="1">
7133272209 <doc xml:space="preserve"
7133372210 filename="glib/ghash.c"
71334- line="2062">user data to pass to the function</doc>
72211+ line="2065">user data to pass to the function</doc>
7133572212 <type name="gpointer" c:type="gpointer"/>
7133672213 </parameter>
7133772214 </parameters>
@@ -71359,7 +72236,7 @@ release of GLib. It does nothing.</doc>
7135972236 introspectable="0">
7136072237 <doc xml:space="preserve"
7136172238 filename="glib/ghash.c"
71362- line="2304">Retrieves every key inside @hash_table, as a #GPtrArray.
72239+ line="2307">Retrieves every key inside @hash_table, as a #GPtrArray.
7136372240 The returned data is valid until changes to the hash release those keys.
7136472241
7136572242 This iterates over every entry in the hash table to build its return value.
@@ -71371,8 +72248,8 @@ You should always unref the returned array with g_ptr_array_unref().</doc>
7137172248 <return-value transfer-ownership="container">
7137272249 <doc xml:space="preserve"
7137372250 filename="glib/ghash.c"
71374- line="2317">a #GPtrArray containing each key from
71375-the table. Unref with with g_ptr_array_unref() when done.</doc>
72251+ line="2320">a #GPtrArray containing each key from
72252+the table. Unref with g_ptr_array_unref() when done.</doc>
7137672253 <array name="GLib.PtrArray" c:type="GPtrArray*">
7137772254 <type name="gpointer" c:type="gpointer"/>
7137872255 </array>
@@ -71381,7 +72258,7 @@ the table. Unref with with g_ptr_array_unref() when done.</doc>
7138172258 <parameter name="hash_table" transfer-ownership="none">
7138272259 <doc xml:space="preserve"
7138372260 filename="glib/ghash.c"
71384- line="2306">a #GHashTable</doc>
72261+ line="2309">a #GHashTable</doc>
7138572262 <type name="GLib.HashTable" c:type="GHashTable*">
7138672263 <type name="gpointer" c:type="gpointer"/>
7138772264 <type name="gpointer" c:type="gpointer"/>
@@ -71396,7 +72273,7 @@ the table. Unref with with g_ptr_array_unref() when done.</doc>
7139672273 introspectable="0">
7139772274 <doc xml:space="preserve"
7139872275 filename="glib/ghash.c"
71399- line="2379">Retrieves every value inside @hash_table, as a #GPtrArray.
72276+ line="2382">Retrieves every value inside @hash_table, as a #GPtrArray.
7140072277 The returned data is valid until changes to the hash release those values.
7140172278
7140272279 This iterates over every entry in the hash table to build its return value.
@@ -71408,8 +72285,8 @@ You should always unref the returned array with g_ptr_array_unref().</doc>
7140872285 <return-value transfer-ownership="container">
7140972286 <doc xml:space="preserve"
7141072287 filename="glib/ghash.c"
71411- line="2392">a #GPtrArray containing each value from
71412-the table. Unref with with g_ptr_array_unref() when done.</doc>
72288+ line="2395">a #GPtrArray containing each value from
72289+the table. Unref with g_ptr_array_unref() when done.</doc>
7141372290 <array name="GLib.PtrArray" c:type="GPtrArray*">
7141472291 <type name="gpointer" c:type="gpointer"/>
7141572292 </array>
@@ -71418,7 +72295,7 @@ the table. Unref with with g_ptr_array_unref() when done.</doc>
7141872295 <parameter name="hash_table" transfer-ownership="none">
7141972296 <doc xml:space="preserve"
7142072297 filename="glib/ghash.c"
71421- line="2381">a #GHashTable</doc>
72298+ line="2384">a #GHashTable</doc>
7142272299 <type name="GLib.HashTable" c:type="GHashTable*">
7142372300 <type name="gpointer" c:type="gpointer"/>
7142472301 <type name="gpointer" c:type="gpointer"/>
@@ -71431,7 +72308,7 @@ the table. Unref with with g_ptr_array_unref() when done.</doc>
7143172308 moved-to="HashTable.insert">
7143272309 <doc xml:space="preserve"
7143372310 filename="glib/ghash.c"
71434- line="1580">Inserts a new key and value into a #GHashTable.
72311+ line="1583">Inserts a new key and value into a #GHashTable.
7143572312
7143672313 If the key already exists in the #GHashTable its current
7143772314 value is replaced with the new value. If you supplied a
@@ -71447,14 +72324,14 @@ or not.</doc>
7144772324 <return-value transfer-ownership="none">
7144872325 <doc xml:space="preserve"
7144972326 filename="glib/ghash.c"
71450- line="1599">%TRUE if the key did not exist yet</doc>
72327+ line="1602">%TRUE if the key did not exist yet</doc>
7145172328 <type name="gboolean" c:type="gboolean"/>
7145272329 </return-value>
7145372330 <parameters>
7145472331 <parameter name="hash_table" transfer-ownership="none">
7145572332 <doc xml:space="preserve"
7145672333 filename="glib/ghash.c"
71457- line="1582">a #GHashTable</doc>
72334+ line="1585">a #GHashTable</doc>
7145872335 <type name="GLib.HashTable" c:type="GHashTable*">
7145972336 <type name="gpointer" c:type="gpointer"/>
7146072337 <type name="gpointer" c:type="gpointer"/>
@@ -71466,7 +72343,7 @@ or not.</doc>
7146672343 allow-none="1">
7146772344 <doc xml:space="preserve"
7146872345 filename="glib/ghash.c"
71469- line="1583">a key to insert</doc>
72346+ line="1586">a key to insert</doc>
7147072347 <type name="gpointer" c:type="gpointer"/>
7147172348 </parameter>
7147272349 <parameter name="value"
@@ -71475,7 +72352,7 @@ or not.</doc>
7147572352 allow-none="1">
7147672353 <doc xml:space="preserve"
7147772354 filename="glib/ghash.c"
71478- line="1584">the value to associate with the key</doc>
72355+ line="1587">the value to associate with the key</doc>
7147972356 <type name="gpointer" c:type="gpointer"/>
7148072357 </parameter>
7148172358 </parameters>
@@ -71485,7 +72362,7 @@ or not.</doc>
7148572362 moved-to="HashTable.lookup">
7148672363 <doc xml:space="preserve"
7148772364 filename="glib/ghash.c"
71488- line="1467">Looks up a key in a #GHashTable. Note that this function cannot
72365+ line="1470">Looks up a key in a #GHashTable. Note that this function cannot
7148972366 distinguish between a key that is not present and one which is present
7149072367 and has the value %NULL. If you need this distinction, use
7149172368 g_hash_table_lookup_extended().</doc>
@@ -71493,14 +72370,14 @@ g_hash_table_lookup_extended().</doc>
7149372370 <return-value transfer-ownership="none" nullable="1">
7149472371 <doc xml:space="preserve"
7149572372 filename="glib/ghash.c"
71496- line="1477">the associated value, or %NULL if the key is not found</doc>
72373+ line="1480">the associated value, or %NULL if the key is not found</doc>
7149772374 <type name="gpointer" c:type="gpointer"/>
7149872375 </return-value>
7149972376 <parameters>
7150072377 <parameter name="hash_table" transfer-ownership="none">
7150172378 <doc xml:space="preserve"
7150272379 filename="glib/ghash.c"
71503- line="1469">a #GHashTable</doc>
72380+ line="1472">a #GHashTable</doc>
7150472381 <type name="GLib.HashTable" c:type="GHashTable*">
7150572382 <type name="gpointer" c:type="gpointer"/>
7150672383 <type name="gpointer" c:type="gpointer"/>
@@ -71512,7 +72389,7 @@ g_hash_table_lookup_extended().</doc>
7151272389 allow-none="1">
7151372390 <doc xml:space="preserve"
7151472391 filename="glib/ghash.c"
71515- line="1470">the key to look up</doc>
72392+ line="1473">the key to look up</doc>
7151672393 <type name="gpointer" c:type="gconstpointer"/>
7151772394 </parameter>
7151872395 </parameters>
@@ -71522,7 +72399,7 @@ g_hash_table_lookup_extended().</doc>
7152272399 moved-to="HashTable.lookup_extended">
7152372400 <doc xml:space="preserve"
7152472401 filename="glib/ghash.c"
71525- line="1495">Looks up a key in the #GHashTable, returning the original key and the
72402+ line="1498">Looks up a key in the #GHashTable, returning the original key and the
7152672403 associated value and a #gboolean which is %TRUE if the key was found. This
7152772404 is useful if you need to free the memory allocated for the original key,
7152872405 for example before calling g_hash_table_remove().
@@ -71534,14 +72411,14 @@ of @hash_table are %NULL-safe.</doc>
7153472411 <return-value transfer-ownership="none">
7153572412 <doc xml:space="preserve"
7153672413 filename="glib/ghash.c"
71537- line="1512">%TRUE if the key was found in the #GHashTable</doc>
72414+ line="1515">%TRUE if the key was found in the #GHashTable</doc>
7153872415 <type name="gboolean" c:type="gboolean"/>
7153972416 </return-value>
7154072417 <parameters>
7154172418 <parameter name="hash_table" transfer-ownership="none">
7154272419 <doc xml:space="preserve"
7154372420 filename="glib/ghash.c"
71544- line="1497">a #GHashTable</doc>
72421+ line="1500">a #GHashTable</doc>
7154572422 <type name="GLib.HashTable" c:type="GHashTable*">
7154672423 <type name="gpointer" c:type="gpointer"/>
7154772424 <type name="gpointer" c:type="gpointer"/>
@@ -71553,7 +72430,7 @@ of @hash_table are %NULL-safe.</doc>
7155372430 allow-none="1">
7155472431 <doc xml:space="preserve"
7155572432 filename="glib/ghash.c"
71556- line="1498">the key to look up</doc>
72433+ line="1501">the key to look up</doc>
7155772434 <type name="gpointer" c:type="gconstpointer"/>
7155872435 </parameter>
7155972436 <parameter name="orig_key"
@@ -71565,7 +72442,7 @@ of @hash_table are %NULL-safe.</doc>
7156572442 allow-none="1">
7156672443 <doc xml:space="preserve"
7156772444 filename="glib/ghash.c"
71568- line="1499">return location for the original key</doc>
72445+ line="1502">return location for the original key</doc>
7156972446 <type name="gpointer" c:type="gpointer*"/>
7157072447 </parameter>
7157172448 <parameter name="value"
@@ -71577,7 +72454,7 @@ of @hash_table are %NULL-safe.</doc>
7157772454 allow-none="1">
7157872455 <doc xml:space="preserve"
7157972456 filename="glib/ghash.c"
71580- line="1500">return location for the value associated
72457+ line="1503">return location for the value associated
7158172458 with the key</doc>
7158272459 <type name="gpointer" c:type="gpointer*"/>
7158372460 </parameter>
@@ -71589,7 +72466,7 @@ with the key</doc>
7158972466 version="2.72">
7159072467 <doc xml:space="preserve"
7159172468 filename="glib/ghash.c"
71592- line="1038">Creates a new #GHashTable like g_hash_table_new_full() with a reference
72469+ line="1041">Creates a new #GHashTable like g_hash_table_new_full() with a reference
7159372470 count of 1.
7159472471
7159572472 It inherits the hash function, the key equal function, the key destroy function,
@@ -71601,7 +72478,7 @@ or values from @other_hash_table.</doc>
7160172478 <return-value transfer-ownership="full">
7160272479 <doc xml:space="preserve"
7160372480 filename="glib/ghash.c"
71604- line="1051">a new #GHashTable</doc>
72481+ line="1054">a new #GHashTable</doc>
7160572482 <type name="GLib.HashTable" c:type="GHashTable*">
7160672483 <type name="gpointer" c:type="gpointer"/>
7160772484 <type name="gpointer" c:type="gpointer"/>
@@ -71611,7 +72488,7 @@ or values from @other_hash_table.</doc>
7161172488 <parameter name="other_hash_table" transfer-ownership="none">
7161272489 <doc xml:space="preserve"
7161372490 filename="glib/ghash.c"
71614- line="1040">Another #GHashTable</doc>
72491+ line="1043">Another #GHashTable</doc>
7161572492 <type name="GLib.HashTable" c:type="GHashTable*">
7161672493 <type name="gpointer" c:type="gpointer"/>
7161772494 <type name="gpointer" c:type="gpointer"/>
@@ -71625,13 +72502,13 @@ or values from @other_hash_table.</doc>
7162572502 version="2.10">
7162672503 <doc xml:space="preserve"
7162772504 filename="glib/ghash.c"
71628- line="1399">Atomically increments the reference count of @hash_table by one.
72505+ line="1402">Atomically increments the reference count of @hash_table by one.
7162972506 This function is MT-safe and may be called from any thread.</doc>
7163072507 <source-position filename="glib/ghash.h" line="161"/>
7163172508 <return-value transfer-ownership="full">
7163272509 <doc xml:space="preserve"
7163372510 filename="glib/ghash.c"
71634- line="1406">the passed in #GHashTable</doc>
72511+ line="1409">the passed in #GHashTable</doc>
7163572512 <type name="GLib.HashTable" c:type="GHashTable*">
7163672513 <type name="gpointer" c:type="gpointer"/>
7163772514 <type name="gpointer" c:type="gpointer"/>
@@ -71641,7 +72518,7 @@ This function is MT-safe and may be called from any thread.</doc>
7164172518 <parameter name="hash_table" transfer-ownership="none">
7164272519 <doc xml:space="preserve"
7164372520 filename="glib/ghash.c"
71644- line="1401">a valid #GHashTable</doc>
72521+ line="1404">a valid #GHashTable</doc>
7164572522 <type name="GLib.HashTable" c:type="GHashTable*">
7164672523 <type name="gpointer" c:type="gpointer"/>
7164772524 <type name="gpointer" c:type="gpointer"/>
@@ -71654,7 +72531,7 @@ This function is MT-safe and may be called from any thread.</doc>
7165472531 moved-to="HashTable.remove">
7165572532 <doc xml:space="preserve"
7165672533 filename="glib/ghash.c"
71657- line="1732">Removes a key and its associated value from a #GHashTable.
72534+ line="1735">Removes a key and its associated value from a #GHashTable.
7165872535
7165972536 If the #GHashTable was created using g_hash_table_new_full(), the
7166072537 key and value are freed using the supplied destroy functions, otherwise
@@ -71664,14 +72541,14 @@ yourself.</doc>
7166472541 <return-value transfer-ownership="none">
7166572542 <doc xml:space="preserve"
7166672543 filename="glib/ghash.c"
71667- line="1744">%TRUE if the key was found and removed from the #GHashTable</doc>
72544+ line="1747">%TRUE if the key was found and removed from the #GHashTable</doc>
7166872545 <type name="gboolean" c:type="gboolean"/>
7166972546 </return-value>
7167072547 <parameters>
7167172548 <parameter name="hash_table" transfer-ownership="none">
7167272549 <doc xml:space="preserve"
7167372550 filename="glib/ghash.c"
71674- line="1734">a #GHashTable</doc>
72551+ line="1737">a #GHashTable</doc>
7167572552 <type name="GLib.HashTable" c:type="GHashTable*">
7167672553 <type name="gpointer" c:type="gpointer"/>
7167772554 <type name="gpointer" c:type="gpointer"/>
@@ -71683,7 +72560,7 @@ yourself.</doc>
7168372560 allow-none="1">
7168472561 <doc xml:space="preserve"
7168572562 filename="glib/ghash.c"
71686- line="1735">the key to remove</doc>
72563+ line="1738">the key to remove</doc>
7168772564 <type name="gpointer" c:type="gconstpointer"/>
7168872565 </parameter>
7168972566 </parameters>
@@ -71694,7 +72571,7 @@ yourself.</doc>
7169472571 version="2.12">
7169572572 <doc xml:space="preserve"
7169672573 filename="glib/ghash.c"
71697- line="1849">Removes all keys and their associated values from a #GHashTable.
72574+ line="1852">Removes all keys and their associated values from a #GHashTable.
7169872575
7169972576 If the #GHashTable was created using g_hash_table_new_full(),
7170072577 the keys and values are freed using the supplied destroy functions,
@@ -71708,7 +72585,7 @@ values are freed yourself.</doc>
7170872585 <parameter name="hash_table" transfer-ownership="none">
7170972586 <doc xml:space="preserve"
7171072587 filename="glib/ghash.c"
71711- line="1851">a #GHashTable</doc>
72588+ line="1854">a #GHashTable</doc>
7171272589 <type name="GLib.HashTable" c:type="GHashTable*">
7171372590 <type name="gpointer" c:type="gpointer"/>
7171472591 <type name="gpointer" c:type="gpointer"/>
@@ -71721,7 +72598,7 @@ values are freed yourself.</doc>
7172172598 moved-to="HashTable.replace">
7172272599 <doc xml:space="preserve"
7172372600 filename="glib/ghash.c"
71724- line="1609">Inserts a new key and value into a #GHashTable similar to
72601+ line="1612">Inserts a new key and value into a #GHashTable similar to
7172572602 g_hash_table_insert(). The difference is that if the key
7172672603 already exists in the #GHashTable, it gets replaced by the
7172772604 new key. If you supplied a @value_destroy_func when creating
@@ -71736,14 +72613,14 @@ or not.</doc>
7173672613 <return-value transfer-ownership="none">
7173772614 <doc xml:space="preserve"
7173872615 filename="glib/ghash.c"
71739- line="1627">%TRUE if the key did not exist yet</doc>
72616+ line="1630">%TRUE if the key did not exist yet</doc>
7174072617 <type name="gboolean" c:type="gboolean"/>
7174172618 </return-value>
7174272619 <parameters>
7174372620 <parameter name="hash_table" transfer-ownership="none">
7174472621 <doc xml:space="preserve"
7174572622 filename="glib/ghash.c"
71746- line="1611">a #GHashTable</doc>
72623+ line="1614">a #GHashTable</doc>
7174772624 <type name="GLib.HashTable" c:type="GHashTable*">
7174872625 <type name="gpointer" c:type="gpointer"/>
7174972626 <type name="gpointer" c:type="gpointer"/>
@@ -71755,7 +72632,7 @@ or not.</doc>
7175572632 allow-none="1">
7175672633 <doc xml:space="preserve"
7175772634 filename="glib/ghash.c"
71758- line="1612">a key to insert</doc>
72635+ line="1615">a key to insert</doc>
7175972636 <type name="gpointer" c:type="gpointer"/>
7176072637 </parameter>
7176172638 <parameter name="value"
@@ -71764,7 +72641,7 @@ or not.</doc>
7176472641 allow-none="1">
7176572642 <doc xml:space="preserve"
7176672643 filename="glib/ghash.c"
71767- line="1613">the value to associate with the key</doc>
72644+ line="1616">the value to associate with the key</doc>
7176872645 <type name="gpointer" c:type="gpointer"/>
7176972646 </parameter>
7177072647 </parameters>
@@ -71774,19 +72651,19 @@ or not.</doc>
7177472651 moved-to="HashTable.size">
7177572652 <doc xml:space="preserve"
7177672653 filename="glib/ghash.c"
71777- line="2202">Returns the number of elements contained in the #GHashTable.</doc>
72654+ line="2205">Returns the number of elements contained in the #GHashTable.</doc>
7177872655 <source-position filename="glib/ghash.h" line="129"/>
7177972656 <return-value transfer-ownership="none">
7178072657 <doc xml:space="preserve"
7178172658 filename="glib/ghash.c"
71782- line="2208">the number of key/value pairs in the #GHashTable.</doc>
72659+ line="2211">the number of key/value pairs in the #GHashTable.</doc>
7178372660 <type name="guint" c:type="guint"/>
7178472661 </return-value>
7178572662 <parameters>
7178672663 <parameter name="hash_table" transfer-ownership="none">
7178772664 <doc xml:space="preserve"
7178872665 filename="glib/ghash.c"
71789- line="2204">a #GHashTable</doc>
72666+ line="2207">a #GHashTable</doc>
7179072667 <type name="GLib.HashTable" c:type="GHashTable*">
7179172668 <type name="gpointer" c:type="gpointer"/>
7179272669 <type name="gpointer" c:type="gpointer"/>
@@ -71799,20 +72676,20 @@ or not.</doc>
7179972676 moved-to="HashTable.steal">
7180072677 <doc xml:space="preserve"
7180172678 filename="glib/ghash.c"
71802- line="1753">Removes a key and its associated value from a #GHashTable without
72679+ line="1756">Removes a key and its associated value from a #GHashTable without
7180372680 calling the key and value destroy functions.</doc>
7180472681 <source-position filename="glib/ghash.h" line="88"/>
7180572682 <return-value transfer-ownership="none">
7180672683 <doc xml:space="preserve"
7180772684 filename="glib/ghash.c"
71808- line="1761">%TRUE if the key was found and removed from the #GHashTable</doc>
72685+ line="1764">%TRUE if the key was found and removed from the #GHashTable</doc>
7180972686 <type name="gboolean" c:type="gboolean"/>
7181072687 </return-value>
7181172688 <parameters>
7181272689 <parameter name="hash_table" transfer-ownership="none">
7181372690 <doc xml:space="preserve"
7181472691 filename="glib/ghash.c"
71815- line="1755">a #GHashTable</doc>
72692+ line="1758">a #GHashTable</doc>
7181672693 <type name="GLib.HashTable" c:type="GHashTable*">
7181772694 <type name="gpointer" c:type="gpointer"/>
7181872695 <type name="gpointer" c:type="gpointer"/>
@@ -71824,7 +72701,7 @@ calling the key and value destroy functions.</doc>
7182472701 allow-none="1">
7182572702 <doc xml:space="preserve"
7182672703 filename="glib/ghash.c"
71827- line="1756">the key to remove</doc>
72704+ line="1759">the key to remove</doc>
7182872705 <type name="gpointer" c:type="gconstpointer"/>
7182972706 </parameter>
7183072707 </parameters>
@@ -71835,7 +72712,7 @@ calling the key and value destroy functions.</doc>
7183572712 version="2.12">
7183672713 <doc xml:space="preserve"
7183772714 filename="glib/ghash.c"
71838- line="1876">Removes all keys and their associated values from a #GHashTable
72715+ line="1879">Removes all keys and their associated values from a #GHashTable
7183972716 without calling the key and value destroy functions.</doc>
7184072717 <source-position filename="glib/ghash.h" line="96"/>
7184172718 <return-value transfer-ownership="none">
@@ -71845,7 +72722,7 @@ without calling the key and value destroy functions.</doc>
7184572722 <parameter name="hash_table" transfer-ownership="none">
7184672723 <doc xml:space="preserve"
7184772724 filename="glib/ghash.c"
71848- line="1878">a #GHashTable</doc>
72725+ line="1881">a #GHashTable</doc>
7184972726 <type name="GLib.HashTable" c:type="GHashTable*">
7185072727 <type name="gpointer" c:type="gpointer"/>
7185172728 <type name="gpointer" c:type="gpointer"/>
@@ -71860,7 +72737,7 @@ without calling the key and value destroy functions.</doc>
7186072737 introspectable="0">
7186172738 <doc xml:space="preserve"
7186272739 filename="glib/ghash.c"
71863- line="1899">Removes all keys and their associated values from a #GHashTable
72740+ line="1902">Removes all keys and their associated values from a #GHashTable
7186472741 without calling the key destroy functions, returning the keys
7186572742 as a #GPtrArray with the free func set to the @hash_table key
7186672743 destroy function.</doc>
@@ -71868,8 +72745,8 @@ destroy function.</doc>
7186872745 <return-value transfer-ownership="container">
7186972746 <doc xml:space="preserve"
7187072747 filename="glib/ghash.c"
71871- line="1908">a #GPtrArray containing each key of
71872-the table. Unref with with g_ptr_array_unref() when done.</doc>
72748+ line="1911">a #GPtrArray containing each key of
72749+the table. Unref with g_ptr_array_unref() when done.</doc>
7187372750 <array name="GLib.PtrArray" c:type="GPtrArray*">
7187472751 <type name="gpointer" c:type="gpointer"/>
7187572752 </array>
@@ -71878,7 +72755,7 @@ the table. Unref with with g_ptr_array_unref() when done.</doc>
7187872755 <parameter name="hash_table" transfer-ownership="none">
7187972756 <doc xml:space="preserve"
7188072757 filename="glib/ghash.c"
71881- line="1901">a #GHashTable</doc>
72758+ line="1904">a #GHashTable</doc>
7188272759 <type name="GLib.HashTable" c:type="GHashTable*">
7188372760 <type name="gpointer" c:type="gpointer"/>
7188472761 <type name="gpointer" c:type="gpointer"/>
@@ -71893,7 +72770,7 @@ the table. Unref with with g_ptr_array_unref() when done.</doc>
7189372770 introspectable="0">
7189472771 <doc xml:space="preserve"
7189572772 filename="glib/ghash.c"
71896- line="1936">Removes all keys and their associated values from a #GHashTable
72773+ line="1939">Removes all keys and their associated values from a #GHashTable
7189772774 without calling the value destroy functions, returning the values
7189872775 as a #GPtrArray with the free func set to the @hash_table value
7189972776 destroy function.</doc>
@@ -71901,8 +72778,8 @@ destroy function.</doc>
7190172778 <return-value transfer-ownership="container">
7190272779 <doc xml:space="preserve"
7190372780 filename="glib/ghash.c"
71904- line="1945">a #GPtrArray containing each value of
71905-the table. Unref with with g_ptr_array_unref() when done.</doc>
72781+ line="1948">a #GPtrArray containing each value of
72782+the table. Unref with g_ptr_array_unref() when done.</doc>
7190672783 <array name="GLib.PtrArray" c:type="GPtrArray*">
7190772784 <type name="gpointer" c:type="gpointer"/>
7190872785 </array>
@@ -71911,7 +72788,7 @@ the table. Unref with with g_ptr_array_unref() when done.</doc>
7191172788 <parameter name="hash_table" transfer-ownership="none">
7191272789 <doc xml:space="preserve"
7191372790 filename="glib/ghash.c"
71914- line="1938">a #GHashTable</doc>
72791+ line="1941">a #GHashTable</doc>
7191572792 <type name="GLib.HashTable" c:type="GHashTable*">
7191672793 <type name="gpointer" c:type="gpointer"/>
7191772794 <type name="gpointer" c:type="gpointer"/>
@@ -71925,7 +72802,7 @@ the table. Unref with with g_ptr_array_unref() when done.</doc>
7192572802 version="2.58">
7192672803 <doc xml:space="preserve"
7192772804 filename="glib/ghash.c"
71928- line="1770">Looks up a key in the #GHashTable, stealing the original key and the
72805+ line="1773">Looks up a key in the #GHashTable, stealing the original key and the
7192972806 associated value and returning %TRUE if the key was found. If the key was
7193072807 not found, %FALSE is returned.
7193172808
@@ -71946,14 +72823,14 @@ stealing both the key and the value from such a dictionary, the value was
7194672823 <return-value transfer-ownership="none">
7194772824 <doc xml:space="preserve"
7194872825 filename="glib/ghash.c"
71949- line="1797">%TRUE if the key was found in the #GHashTable</doc>
72826+ line="1800">%TRUE if the key was found in the #GHashTable</doc>
7195072827 <type name="gboolean" c:type="gboolean"/>
7195172828 </return-value>
7195272829 <parameters>
7195372830 <parameter name="hash_table" transfer-ownership="none">
7195472831 <doc xml:space="preserve"
7195572832 filename="glib/ghash.c"
71956- line="1772">a #GHashTable</doc>
72833+ line="1775">a #GHashTable</doc>
7195772834 <type name="GLib.HashTable" c:type="GHashTable*">
7195872835 <type name="gpointer" c:type="gpointer"/>
7195972836 <type name="gpointer" c:type="gpointer"/>
@@ -71965,7 +72842,7 @@ stealing both the key and the value from such a dictionary, the value was
7196572842 allow-none="1">
7196672843 <doc xml:space="preserve"
7196772844 filename="glib/ghash.c"
71968- line="1773">the key to look up</doc>
72845+ line="1776">the key to look up</doc>
7196972846 <type name="gpointer" c:type="gconstpointer"/>
7197072847 </parameter>
7197172848 <parameter name="stolen_key"
@@ -71977,7 +72854,7 @@ stealing both the key and the value from such a dictionary, the value was
7197772854 allow-none="1">
7197872855 <doc xml:space="preserve"
7197972856 filename="glib/ghash.c"
71980- line="1774">return location for the
72857+ line="1777">return location for the
7198172858 original key</doc>
7198272859 <type name="gpointer" c:type="gpointer*"/>
7198372860 </parameter>
@@ -71990,7 +72867,7 @@ stealing both the key and the value from such a dictionary, the value was
7199072867 allow-none="1">
7199172868 <doc xml:space="preserve"
7199272869 filename="glib/ghash.c"
71993- line="1776">return location
72870+ line="1779">return location
7199472871 for the value associated with the key</doc>
7199572872 <type name="gpointer" c:type="gpointer*"/>
7199672873 </parameter>
@@ -72018,7 +72895,7 @@ release of GLib. It does nothing.</doc>
7201872895 version="2.10">
7201972896 <doc xml:space="preserve"
7202072897 filename="glib/ghash.c"
72021- line="1420">Atomically decrements the reference count of @hash_table by one.
72898+ line="1423">Atomically decrements the reference count of @hash_table by one.
7202272899 If the reference count drops to 0, all keys and values will be
7202372900 destroyed, and all memory allocated by the hash table is released.
7202472901 This function is MT-safe and may be called from any thread.</doc>
@@ -72030,7 +72907,7 @@ This function is MT-safe and may be called from any thread.</doc>
7203072907 <parameter name="hash_table" transfer-ownership="full">
7203172908 <doc xml:space="preserve"
7203272909 filename="glib/ghash.c"
72033- line="1422">a valid #GHashTable</doc>
72910+ line="1425">a valid #GHashTable</doc>
7203472911 <type name="GLib.HashTable" c:type="GHashTable*">
7203572912 <type name="gpointer" c:type="gpointer"/>
7203672913 <type name="gpointer" c:type="gpointer"/>
@@ -72258,7 +73135,7 @@ from the #GHookList and g_hook_free() is called to free it.</doc>
7225873135 version="2.22">
7225973136 <doc xml:space="preserve"
7226073137 filename="glib/ghostutils.c"
72261- line="718">Tests if @hostname contains segments with an ASCII-compatible
73138+ line="726">Tests if @hostname contains segments with an ASCII-compatible
7226273139 encoding of an Internationalized Domain Name. If this returns
7226373140 %TRUE, you should decode the hostname with g_hostname_to_unicode()
7226473141 before displaying it to the user.
@@ -72270,7 +73147,7 @@ g_hostname_is_ascii_encoded() to both return %TRUE for a name.</doc>
7227073147 <return-value transfer-ownership="none">
7227173148 <doc xml:space="preserve"
7227273149 filename="glib/ghostutils.c"
72273- line="731">%TRUE if @hostname contains any ASCII-encoded
73150+ line="739">%TRUE if @hostname contains any ASCII-encoded
7227473151 segments.</doc>
7227573152 <type name="gboolean" c:type="gboolean"/>
7227673153 </return-value>
@@ -72278,7 +73155,7 @@ segments.</doc>
7227873155 <parameter name="hostname" transfer-ownership="none">
7227973156 <doc xml:space="preserve"
7228073157 filename="glib/ghostutils.c"
72281- line="720">a hostname</doc>
73158+ line="728">a hostname</doc>
7228273159 <type name="utf8" c:type="const gchar*"/>
7228373160 </parameter>
7228473161 </parameters>
@@ -72288,7 +73165,7 @@ segments.</doc>
7228873165 version="2.22">
7228973166 <doc xml:space="preserve"
7229073167 filename="glib/ghostutils.c"
72291- line="751">Tests if @hostname is the string form of an IPv4 or IPv6 address.
73168+ line="759">Tests if @hostname is the string form of an IPv4 or IPv6 address.
7229273169 (Eg, "192.168.0.1".)
7229373170
7229473171 Since 2.66, IPv6 addresses with a zone-id are accepted (RFC6874).</doc>
@@ -72296,14 +73173,14 @@ Since 2.66, IPv6 addresses with a zone-id are accepted (RFC6874).</doc>
7229673173 <return-value transfer-ownership="none">
7229773174 <doc xml:space="preserve"
7229873175 filename="glib/ghostutils.c"
72299- line="760">%TRUE if @hostname is an IP address</doc>
73176+ line="768">%TRUE if @hostname is an IP address</doc>
7230073177 <type name="gboolean" c:type="gboolean"/>
7230173178 </return-value>
7230273179 <parameters>
7230373180 <parameter name="hostname" transfer-ownership="none">
7230473181 <doc xml:space="preserve"
7230573182 filename="glib/ghostutils.c"
72306- line="753">a hostname (or IP address in string form)</doc>
73183+ line="761">a hostname (or IP address in string form)</doc>
7230773184 <type name="utf8" c:type="const gchar*"/>
7230873185 </parameter>
7230973186 </parameters>
@@ -72313,7 +73190,7 @@ Since 2.66, IPv6 addresses with a zone-id are accepted (RFC6874).</doc>
7231373190 version="2.22">
7231473191 <doc xml:space="preserve"
7231573192 filename="glib/ghostutils.c"
72316- line="540">Tests if @hostname contains Unicode characters. If this returns
73193+ line="546">Tests if @hostname contains Unicode characters. If this returns
7231773194 %TRUE, you need to encode the hostname with g_hostname_to_ascii()
7231873195 before using it in non-IDN-aware contexts.
7231973196
@@ -72324,14 +73201,14 @@ g_hostname_is_ascii_encoded() to both return %TRUE for a name.</doc>
7232473201 <return-value transfer-ownership="none">
7232573202 <doc xml:space="preserve"
7232673203 filename="glib/ghostutils.c"
72327- line="552">%TRUE if @hostname contains any non-ASCII characters</doc>
73204+ line="558">%TRUE if @hostname contains any non-ASCII characters</doc>
7232873205 <type name="gboolean" c:type="gboolean"/>
7232973206 </return-value>
7233073207 <parameters>
7233173208 <parameter name="hostname" transfer-ownership="none">
7233273209 <doc xml:space="preserve"
7233373210 filename="glib/ghostutils.c"
72334- line="542">a hostname</doc>
73211+ line="548">a hostname</doc>
7233573212 <type name="utf8" c:type="const gchar*"/>
7233673213 </parameter>
7233773214 </parameters>
@@ -72341,14 +73218,14 @@ g_hostname_is_ascii_encoded() to both return %TRUE for a name.</doc>
7234173218 version="2.22">
7234273219 <doc xml:space="preserve"
7234373220 filename="glib/ghostutils.c"
72344- line="444">Converts @hostname to its canonical ASCII form; an ASCII-only
73221+ line="450">Converts @hostname to its canonical ASCII form; an ASCII-only
7234573222 string containing no uppercase letters and not ending with a
7234673223 trailing dot.</doc>
7234773224 <source-position filename="glib/ghostutils.h" line="39"/>
7234873225 <return-value transfer-ownership="full" nullable="1">
7234973226 <doc xml:space="preserve"
7235073227 filename="glib/ghostutils.c"
72351- line="452">an ASCII hostname, which must be freed,
73228+ line="458">an ASCII hostname, which must be freed,
7235273229 or %NULL if @hostname is in some way invalid.</doc>
7235373230 <type name="utf8" c:type="gchar*"/>
7235473231 </return-value>
@@ -72356,7 +73233,7 @@ trailing dot.</doc>
7235673233 <parameter name="hostname" transfer-ownership="none">
7235773234 <doc xml:space="preserve"
7235873235 filename="glib/ghostutils.c"
72359- line="446">a valid UTF-8 or ASCII hostname</doc>
73236+ line="452">a valid UTF-8 or ASCII hostname</doc>
7236073237 <type name="utf8" c:type="const gchar*"/>
7236173238 </parameter>
7236273239 </parameters>
@@ -72366,7 +73243,7 @@ trailing dot.</doc>
7236673243 version="2.22">
7236773244 <doc xml:space="preserve"
7236873245 filename="glib/ghostutils.c"
72369- line="647">Converts @hostname to its canonical presentation form; a UTF-8
73246+ line="655">Converts @hostname to its canonical presentation form; a UTF-8
7237073247 string in Unicode normalization form C, containing no uppercase
7237173248 letters, no forbidden characters, and no ASCII-encoded segments,
7237273249 and not ending with a trailing dot.
@@ -72377,7 +73254,7 @@ the canonical presentation form will be entirely ASCII.</doc>
7237773254 <return-value transfer-ownership="full" nullable="1">
7237873255 <doc xml:space="preserve"
7237973256 filename="glib/ghostutils.c"
72380- line="659">a UTF-8 hostname, which must be freed,
73257+ line="667">a UTF-8 hostname, which must be freed,
7238173258 or %NULL if @hostname is in some way invalid.</doc>
7238273259 <type name="utf8" c:type="gchar*"/>
7238373260 </return-value>
@@ -72385,7 +73262,7 @@ the canonical presentation form will be entirely ASCII.</doc>
7238573262 <parameter name="hostname" transfer-ownership="none">
7238673263 <doc xml:space="preserve"
7238773264 filename="glib/ghostutils.c"
72388- line="649">a valid UTF-8 or ASCII hostname</doc>
73265+ line="657">a valid UTF-8 or ASCII hostname</doc>
7238973266 <type name="utf8" c:type="const gchar*"/>
7239073267 </parameter>
7239173268 </parameters>
@@ -72522,13 +73399,15 @@ more convenient than the raw iconv wrappers.</doc>
7252273399 introspectable="0">
7252373400 <doc xml:space="preserve"
7252473401 filename="glib/gmain.c"
72525- line="6393">Adds a function to be called whenever there are no higher priority
72526-events pending to the default main loop. The function is given the
73402+ line="6575">Adds a function to be called whenever there are no higher priority
73403+events pending to the default main loop.
73404+
73405+The function is given the
7252773406 default idle priority, [const@GLib.PRIORITY_DEFAULT_IDLE]. If the function
72528-returns %FALSE it is automatically removed from the list of event
72529-sources and will not be called again.
73407+returns [const@GLib.SOURCE_REMOVE] it is automatically removed from the list
73408+of event sources and will not be called again.
7253073409
72531-See [mainloop memory management](main-loop.html#memory-management-of-sources) for details
73410+See [main loop memory management](main-loop.html#memory-management-of-sources) for details
7253273411 on how to handle the return value and memory management of @data.
7253373412
7253473413 This internally creates a main loop source using [func@GLib.idle_source_new]
@@ -72536,18 +73415,18 @@ and attaches it to the global [struct@GLib.MainContext] using
7253673415 [method@GLib.Source.attach], so the callback will be invoked in whichever
7253773416 thread is running that main context. You can do these steps manually if you
7253873417 need greater control or to use a custom main context.</doc>
72539- <source-position filename="glib/gmain.h" line="963"/>
73418+ <source-position filename="glib/gmain.h" line="966"/>
7254073419 <return-value transfer-ownership="none">
7254173420 <doc xml:space="preserve"
7254273421 filename="glib/gmain.c"
72543- line="6413">the ID (greater than 0) of the event source.</doc>
73422+ line="6597">the ID (greater than 0) of the event source</doc>
7254473423 <type name="guint" c:type="guint"/>
7254573424 </return-value>
7254673425 <parameters>
7254773426 <parameter name="function" transfer-ownership="none" closure="1">
7254873427 <doc xml:space="preserve"
7254973428 filename="glib/gmain.c"
72550- line="6395">function to call</doc>
73429+ line="6577">function to call</doc>
7255173430 <type name="SourceFunc" c:type="GSourceFunc"/>
7255273431 </parameter>
7255373432 <parameter name="data"
@@ -72556,7 +73435,7 @@ need greater control or to use a custom main context.</doc>
7255673435 allow-none="1">
7255773436 <doc xml:space="preserve"
7255873437 filename="glib/gmain.c"
72559- line="6396">data to pass to @function.</doc>
73438+ line="6578">data to pass to @function</doc>
7256073439 <type name="gpointer" c:type="gpointer"/>
7256173440 </parameter>
7256273441 </parameters>
@@ -72566,13 +73445,13 @@ need greater control or to use a custom main context.</doc>
7256673445 shadows="idle_add">
7256773446 <doc xml:space="preserve"
7256873447 filename="glib/gmain.c"
72569- line="6358">Adds a function to be called whenever there are no higher priority
73448+ line="6540">Adds a function to be called whenever there are no higher priority
7257073449 events pending.
7257173450
72572-If the function returns [const@GLib.SOURCE_REMOVE] or %FALSE it is automatically
73451+If the function returns [const@GLib.SOURCE_REMOVE] it is automatically
7257373452 removed from the list of event sources and will not be called again.
7257473453
72575-See [mainloop memory management](main-loop.html#memory-management-of-sources) for details
73454+See [main loop memory management](main-loop.html#memory-management-of-sources) for details
7257673455 on how to handle the return value and memory management of @data.
7257773456
7257873457 This internally creates a main loop source using [func@GLib.idle_source_new]
@@ -72580,20 +73459,20 @@ and attaches it to the global [struct@GLib.MainContext] using
7258073459 [method@GLib.Source.attach], so the callback will be invoked in whichever
7258173460 thread is running that main context. You can do these steps manually if you
7258273461 need greater control or to use a custom main context.</doc>
72583- <source-position filename="glib/gmain.h" line="966"/>
73462+ <source-position filename="glib/gmain.h" line="969"/>
7258473463 <return-value transfer-ownership="none">
7258573464 <doc xml:space="preserve"
7258673465 filename="glib/gmain.c"
72587- line="6382">the ID (greater than 0) of the event source.</doc>
73466+ line="6564">the ID (greater than 0) of the event source</doc>
7258873467 <type name="guint" c:type="guint"/>
7258973468 </return-value>
7259073469 <parameters>
7259173470 <parameter name="priority" transfer-ownership="none">
7259273471 <doc xml:space="preserve"
7259373472 filename="glib/gmain.c"
72594- line="6360">the priority of the idle source. Typically this will be in the
73473+ line="6542">the priority of the idle source; typically this will be in the
7259573474 range between [const@GLib.PRIORITY_DEFAULT_IDLE] and
72596- [const@GLib.PRIORITY_HIGH_IDLE].</doc>
73475+ [const@GLib.PRIORITY_HIGH_IDLE]</doc>
7259773476 <type name="gint" c:type="gint"/>
7259873477 </parameter>
7259973478 <parameter name="function"
@@ -72603,7 +73482,7 @@ need greater control or to use a custom main context.</doc>
7260373482 destroy="3">
7260473483 <doc xml:space="preserve"
7260573484 filename="glib/gmain.c"
72606- line="6363">function to call</doc>
73485+ line="6545">function to call</doc>
7260773486 <type name="SourceFunc" c:type="GSourceFunc"/>
7260873487 </parameter>
7260973488 <parameter name="data"
@@ -72612,7 +73491,7 @@ need greater control or to use a custom main context.</doc>
7261273491 allow-none="1">
7261373492 <doc xml:space="preserve"
7261473493 filename="glib/gmain.c"
72615- line="6364">data to pass to @function</doc>
73494+ line="6546">data to pass to @function</doc>
7261673495 <type name="gpointer" c:type="gpointer"/>
7261773496 </parameter>
7261873497 <parameter name="notify"
@@ -72622,7 +73501,7 @@ need greater control or to use a custom main context.</doc>
7262273501 scope="async">
7262373502 <doc xml:space="preserve"
7262473503 filename="glib/gmain.c"
72625- line="6365">function to call when the idle is removed, or %NULL</doc>
73504+ line="6547">function to call when the idle is removed</doc>
7262673505 <type name="DestroyNotify" c:type="GDestroyNotify"/>
7262773506 </parameter>
7262873507 </parameters>
@@ -72633,26 +73512,28 @@ need greater control or to use a custom main context.</doc>
7263373512 introspectable="0">
7263473513 <doc xml:space="preserve"
7263573514 filename="glib/gmain.c"
72636- line="6422">Adds a function to be called whenever there are no higher priority
72637-events pending to the default main loop. The function is given the
73515+ line="6606">Adds a function to be called whenever there are no higher priority
73516+events pending to the default main loop.
73517+
73518+The function is given the
7263873519 default idle priority, [const@GLib.PRIORITY_DEFAULT_IDLE].
7263973520
7264073521 The function will only be called once and then the source will be
7264173522 automatically removed from the main context.
7264273523
7264373524 This function otherwise behaves like [func@GLib.idle_add].</doc>
72644- <source-position filename="glib/gmain.h" line="971"/>
73525+ <source-position filename="glib/gmain.h" line="974"/>
7264573526 <return-value transfer-ownership="none">
7264673527 <doc xml:space="preserve"
7264773528 filename="glib/gmain.c"
72648- line="6436">the ID (greater than 0) of the event source</doc>
73529+ line="6622">the ID (greater than 0) of the event source</doc>
7264973530 <type name="guint" c:type="guint"/>
7265073531 </return-value>
7265173532 <parameters>
7265273533 <parameter name="function" transfer-ownership="none" closure="1">
7265373534 <doc xml:space="preserve"
7265473535 filename="glib/gmain.c"
72655- line="6424">function to call</doc>
73536+ line="6608">function to call</doc>
7265673537 <type name="SourceOnceFunc" c:type="GSourceOnceFunc"/>
7265773538 </parameter>
7265873539 <parameter name="data"
@@ -72661,7 +73542,7 @@ This function otherwise behaves like [func@GLib.idle_add].</doc>
7266173542 allow-none="1">
7266273543 <doc xml:space="preserve"
7266373544 filename="glib/gmain.c"
72664- line="6425">data to pass to @function</doc>
73545+ line="6609">data to pass to @function</doc>
7266573546 <type name="gpointer" c:type="gpointer"/>
7266673547 </parameter>
7266773548 </parameters>
@@ -72669,12 +73550,12 @@ This function otherwise behaves like [func@GLib.idle_add].</doc>
7266973550 <function name="idle_remove_by_data" c:identifier="g_idle_remove_by_data">
7267073551 <doc xml:space="preserve"
7267173552 filename="glib/gmain.c"
72672- line="6447">Removes the idle function with the given data.</doc>
72673- <source-position filename="glib/gmain.h" line="974"/>
73553+ line="6632">Removes the idle function with the given data.</doc>
73554+ <source-position filename="glib/gmain.h" line="977"/>
7267473555 <return-value transfer-ownership="none">
7267573556 <doc xml:space="preserve"
7267673557 filename="glib/gmain.c"
72677- line="6453">%TRUE if an idle source was found and removed.</doc>
73558+ line="6638">true if an idle source was found and removed, false otherwise</doc>
7267873559 <type name="gboolean" c:type="gboolean"/>
7267973560 </return-value>
7268073561 <parameters>
@@ -72684,7 +73565,7 @@ This function otherwise behaves like [func@GLib.idle_add].</doc>
7268473565 allow-none="1">
7268573566 <doc xml:space="preserve"
7268673567 filename="glib/gmain.c"
72687- line="6449">the data for the idle source's callback.</doc>
73568+ line="6634">the data for the idle source’s callback.</doc>
7268873569 <type name="gpointer" c:type="gpointer"/>
7268973570 </parameter>
7269073571 </parameters>
@@ -72692,7 +73573,7 @@ This function otherwise behaves like [func@GLib.idle_add].</doc>
7269273573 <function name="idle_source_new" c:identifier="g_idle_source_new">
7269373574 <doc xml:space="preserve"
7269473575 filename="glib/gmain.c"
72695- line="6311">Creates a new idle source.
73576+ line="6493">Creates a new idle source.
7269673577
7269773578 The source will not initially be associated with any
7269873579 [struct@GLib.MainContext] and must be added to one with
@@ -72700,11 +73581,11 @@ The source will not initially be associated with any
7270073581 default priority for idle sources is [const@GLib.PRIORITY_DEFAULT_IDLE], as
7270173582 compared to other sources which have a default priority of
7270273583 [const@GLib.PRIORITY_DEFAULT].</doc>
72703- <source-position filename="glib/gmain.h" line="813"/>
73584+ <source-position filename="glib/gmain.h" line="816"/>
7270473585 <return-value transfer-ownership="full">
7270573586 <doc xml:space="preserve"
7270673587 filename="glib/gmain.c"
72707- line="6323">the newly-created idle source</doc>
73588+ line="6505">the newly-created idle source</doc>
7270873589 <type name="Source" c:type="GSource*"/>
7270973590 </return-value>
7271073591 </function>
@@ -72714,7 +73595,7 @@ compared to other sources which have a default priority of
7271473595 introspectable="0">
7271573596 <doc xml:space="preserve"
7271673597 filename="glib/gmessages.c"
72717- line="308">A convenience function/macro to log an informational message.
73598+ line="307">A convenience function/macro to log an informational message.
7271873599
7271973600 Seldom used.
7272073601
@@ -72731,12 +73612,12 @@ to set the allowed domains at runtime, use
7273173612 If structured logging is enabled, this will use [func@GLib.log_structured];
7273273613 otherwise it will use [func@GLib.log]. See
7273373614 [Using Structured Logging](logging.html#using-structured-logging).</doc>
72734- <source-position filename="glib/gmessages.h" line="340"/>
73615+ <source-position filename="glib/gmessages.h" line="343"/>
7273573616 <parameters>
7273673617 <parameter name="...">
7273773618 <doc xml:space="preserve"
7273873619 filename="glib/gmessages.c"
72739- line="310">format string, followed by parameters to insert into the format string
73620+ line="309">format string, followed by parameters to insert into the format string
7274073621 (as with `printf()`)</doc>
7274173622 </parameter>
7274273623 </parameters>
@@ -72744,7 +73625,7 @@ otherwise it will use [func@GLib.log]. See
7274473625 <function name="int64_equal" c:identifier="g_int64_equal" version="2.22">
7274573626 <doc xml:space="preserve"
7274673627 filename="glib/ghash.c"
72747- line="2610">Compares the two #gint64 values being pointed to and returns
73628+ line="2613">Compares the two #gint64 values being pointed to and returns
7274873629 %TRUE if they are equal.
7274973630 It can be passed to g_hash_table_new() as the @key_equal_func
7275073631 parameter, when using non-%NULL pointers to 64-bit integers as keys in a
@@ -72753,20 +73634,20 @@ parameter, when using non-%NULL pointers to 64-bit integers as keys in a
7275373634 <return-value transfer-ownership="none">
7275473635 <doc xml:space="preserve"
7275573636 filename="glib/ghash.c"
72756- line="2621">%TRUE if the two keys match.</doc>
73637+ line="2624">%TRUE if the two keys match.</doc>
7275773638 <type name="gboolean" c:type="gboolean"/>
7275873639 </return-value>
7275973640 <parameters>
7276073641 <parameter name="v1" transfer-ownership="none">
7276173642 <doc xml:space="preserve"
7276273643 filename="glib/ghash.c"
72763- line="2612">a pointer to a #gint64 key</doc>
73644+ line="2615">a pointer to a #gint64 key</doc>
7276473645 <type name="gpointer" c:type="gconstpointer"/>
7276573646 </parameter>
7276673647 <parameter name="v2" transfer-ownership="none">
7276773648 <doc xml:space="preserve"
7276873649 filename="glib/ghash.c"
72769- line="2613">a pointer to a #gint64 key to compare with @v1</doc>
73650+ line="2616">a pointer to a #gint64 key to compare with @v1</doc>
7277073651 <type name="gpointer" c:type="gconstpointer"/>
7277173652 </parameter>
7277273653 </parameters>
@@ -72774,7 +73655,7 @@ parameter, when using non-%NULL pointers to 64-bit integers as keys in a
7277473655 <function name="int64_hash" c:identifier="g_int64_hash" version="2.22">
7277573656 <doc xml:space="preserve"
7277673657 filename="glib/ghash.c"
72777- line="2632">Converts a pointer to a #gint64 to a hash value.
73658+ line="2635">Converts a pointer to a #gint64 to a hash value.
7277873659
7277973660 It can be passed to g_hash_table_new() as the @hash_func parameter,
7278073661 when using non-%NULL pointers to 64-bit integer values as keys in a
@@ -72783,14 +73664,14 @@ when using non-%NULL pointers to 64-bit integer values as keys in a
7278373664 <return-value transfer-ownership="none">
7278473665 <doc xml:space="preserve"
7278573666 filename="glib/ghash.c"
72786- line="2642">a hash value corresponding to the key.</doc>
73667+ line="2645">a hash value corresponding to the key.</doc>
7278773668 <type name="guint" c:type="guint"/>
7278873669 </return-value>
7278973670 <parameters>
7279073671 <parameter name="v" transfer-ownership="none">
7279173672 <doc xml:space="preserve"
7279273673 filename="glib/ghash.c"
72793- line="2634">a pointer to a #gint64 key</doc>
73674+ line="2637">a pointer to a #gint64 key</doc>
7279473675 <type name="gpointer" c:type="gconstpointer"/>
7279573676 </parameter>
7279673677 </parameters>
@@ -72798,7 +73679,7 @@ when using non-%NULL pointers to 64-bit integer values as keys in a
7279873679 <function name="int_equal" c:identifier="g_int_equal">
7279973680 <doc xml:space="preserve"
7280073681 filename="glib/ghash.c"
72801- line="2522">Compares the two #gint values being pointed to and returns
73682+ line="2525">Compares the two #gint values being pointed to and returns
7280273683 %TRUE if they are equal.
7280373684 It can be passed to g_hash_table_new() as the @key_equal_func
7280473685 parameter, when using non-%NULL pointers to integers as keys in a
@@ -72811,20 +73692,20 @@ directly: if your hash table's keys are of the form
7281173692 <return-value transfer-ownership="none">
7281273693 <doc xml:space="preserve"
7281373694 filename="glib/ghash.c"
72814- line="2537">%TRUE if the two keys match.</doc>
73695+ line="2540">%TRUE if the two keys match.</doc>
7281573696 <type name="gboolean" c:type="gboolean"/>
7281673697 </return-value>
7281773698 <parameters>
7281873699 <parameter name="v1" transfer-ownership="none">
7281973700 <doc xml:space="preserve"
7282073701 filename="glib/ghash.c"
72821- line="2524">a pointer to a #gint key</doc>
73702+ line="2527">a pointer to a #gint key</doc>
7282273703 <type name="gpointer" c:type="gconstpointer"/>
7282373704 </parameter>
7282473705 <parameter name="v2" transfer-ownership="none">
7282573706 <doc xml:space="preserve"
7282673707 filename="glib/ghash.c"
72827- line="2525">a pointer to a #gint key to compare with @v1</doc>
73708+ line="2528">a pointer to a #gint key to compare with @v1</doc>
7282873709 <type name="gpointer" c:type="gconstpointer"/>
7282973710 </parameter>
7283073711 </parameters>
@@ -72832,7 +73713,7 @@ directly: if your hash table's keys are of the form
7283273713 <function name="int_hash" c:identifier="g_int_hash">
7283373714 <doc xml:space="preserve"
7283473715 filename="glib/ghash.c"
72835- line="2546">Converts a pointer to a #gint to a hash value.
73716+ line="2549">Converts a pointer to a #gint to a hash value.
7283673717 It can be passed to g_hash_table_new() as the @hash_func parameter,
7283773718 when using non-%NULL pointers to integer values as keys in a #GHashTable.
7283873719
@@ -72843,14 +73724,14 @@ directly: if your hash table's keys are of the form
7284373724 <return-value transfer-ownership="none">
7284473725 <doc xml:space="preserve"
7284573726 filename="glib/ghash.c"
72846- line="2558">a hash value corresponding to the key.</doc>
73727+ line="2561">a hash value corresponding to the key.</doc>
7284773728 <type name="guint" c:type="guint"/>
7284873729 </return-value>
7284973730 <parameters>
7285073731 <parameter name="v" transfer-ownership="none">
7285173732 <doc xml:space="preserve"
7285273733 filename="glib/ghash.c"
72853- line="2548">a pointer to a #gint key</doc>
73734+ line="2551">a pointer to a #gint key</doc>
7285473735 <type name="gpointer" c:type="gconstpointer"/>
7285573736 </parameter>
7285673737 </parameters>
@@ -73122,7 +74003,9 @@ Note that it is considered perfectly acceptable to access
7312274003 </function-macro>
7312374004 <function name="list_pop_allocator"
7312474005 c:identifier="g_list_pop_allocator"
73125- moved-to="List.pop_allocator">
74006+ moved-to="List.pop_allocator"
74007+ deprecated="1"
74008+ deprecated-version="2.10">
7312674009 <source-position filename="glib/deprecated/gallocator.h" line="76"/>
7312774010 <return-value transfer-ownership="none">
7312874011 <type name="none" c:type="void"/>
@@ -73147,7 +74030,9 @@ Note that it is considered perfectly acceptable to access
7314774030 </function-macro>
7314874031 <function name="list_push_allocator"
7314974032 c:identifier="g_list_push_allocator"
73150- moved-to="List.push_allocator">
74033+ moved-to="List.push_allocator"
74034+ deprecated="1"
74035+ deprecated-version="2.10">
7315174036 <source-position filename="glib/deprecated/gallocator.h" line="74"/>
7315274037 <return-value transfer-ownership="none">
7315374038 <type name="none" c:type="void"/>
@@ -73328,7 +74213,7 @@ may contain embedded nul characters.</doc>
7332874213 <function name="log" c:identifier="g_log" introspectable="0">
7332974214 <doc xml:space="preserve"
7333074215 filename="glib/gmessages.c"
73331- line="1298">Logs an error or debugging message.
74216+ line="1302">Logs an error or debugging message.
7333274217
7333374218 If the log level has been set as fatal, [func@GLib.BREAKPOINT] is called
7333474219 to terminate the program. See the documentation for [func@GLib.BREAKPOINT] for
@@ -73351,27 +74236,27 @@ output via the structured log writer function (see [func@GLib.log_set_writer_fun
7335174236 allow-none="1">
7335274237 <doc xml:space="preserve"
7335374238 filename="glib/gmessages.c"
73354- line="1300">the log domain, usually `G_LOG_DOMAIN`, or `NULL`
74239+ line="1304">the log domain, usually `G_LOG_DOMAIN`, or `NULL`
7335574240 for the default</doc>
7335674241 <type name="utf8" c:type="const gchar*"/>
7335774242 </parameter>
7335874243 <parameter name="log_level" transfer-ownership="none">
7335974244 <doc xml:space="preserve"
7336074245 filename="glib/gmessages.c"
73361- line="1302">the log level, either from [type@GLib.LogLevelFlags]
74246+ line="1306">the log level, either from [type@GLib.LogLevelFlags]
7336274247 or a user-defined level</doc>
7336374248 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
7336474249 </parameter>
7336574250 <parameter name="format" transfer-ownership="none">
7336674251 <doc xml:space="preserve"
7336774252 filename="glib/gmessages.c"
73368- line="1304">the message format. See the `printf()` documentation</doc>
74253+ line="1308">the message format. See the `printf()` documentation</doc>
7336974254 <type name="utf8" c:type="const gchar*"/>
7337074255 </parameter>
7337174256 <parameter name="..." transfer-ownership="none">
7337274257 <doc xml:space="preserve"
7337374258 filename="glib/gmessages.c"
73374- line="1305">the parameters to insert into the format string</doc>
74259+ line="1309">the parameters to insert into the format string</doc>
7337574260 <varargs/>
7337674261 </parameter>
7337774262 </parameters>
@@ -73379,7 +74264,7 @@ output via the structured log writer function (see [func@GLib.log_set_writer_fun
7337974264 <function name="log_default_handler" c:identifier="g_log_default_handler">
7338074265 <doc xml:space="preserve"
7338174266 filename="glib/gmessages.c"
73382- line="3352">The default log handler set up by GLib; [func@GLib.log_set_default_handler]
74267+ line="3442">The default log handler set up by GLib; [func@GLib.log_set_default_handler]
7338374268 allows to install an alternate default log handler.
7338474269
7338574270 This is used if no log handler has been set for the particular log
@@ -73421,14 +74306,14 @@ This has no effect if structured logging is enabled; see
7342174306 allow-none="1">
7342274307 <doc xml:space="preserve"
7342374308 filename="glib/gmessages.c"
73424- line="3354">the log domain of the message, or `NULL` for the
74309+ line="3444">the log domain of the message, or `NULL` for the
7342574310 default `""` application domain</doc>
7342674311 <type name="utf8" c:type="const gchar*"/>
7342774312 </parameter>
7342874313 <parameter name="log_level" transfer-ownership="none">
7342974314 <doc xml:space="preserve"
7343074315 filename="glib/gmessages.c"
73431- line="3356">the level of the message</doc>
74316+ line="3446">the level of the message</doc>
7343274317 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
7343374318 </parameter>
7343474319 <parameter name="message"
@@ -73437,7 +74322,7 @@ This has no effect if structured logging is enabled; see
7343774322 allow-none="1">
7343874323 <doc xml:space="preserve"
7343974324 filename="glib/gmessages.c"
73440- line="3357">the message</doc>
74325+ line="3447">the message</doc>
7344174326 <type name="utf8" c:type="const gchar*"/>
7344274327 </parameter>
7344374328 <parameter name="unused_data"
@@ -73446,17 +74331,58 @@ This has no effect if structured logging is enabled; see
7344674331 allow-none="1">
7344774332 <doc xml:space="preserve"
7344874333 filename="glib/gmessages.c"
73449- line="3358">data passed from [func@GLib.log] which is unused</doc>
74334+ line="3448">data passed from [func@GLib.log] which is unused</doc>
7345074335 <type name="gpointer" c:type="gpointer"/>
7345174336 </parameter>
7345274337 </parameters>
7345374338 </function>
74339+ <function name="log_get_always_fatal"
74340+ c:identifier="g_log_get_always_fatal"
74341+ version="2.86">
74342+ <doc xml:space="preserve"
74343+ filename="glib/gmessages.c"
74344+ line="571">Gets the current fatal mask.
74345+
74346+This is mostly used by custom log writers to make fatal messages
74347+(`fatal-warnings`, `fatal-criticals`) work as expected, when using the
74348+`G_DEBUG` environment variable (see [Running GLib Applications](running.html)).
74349+
74350+An example usage is shown below:
74351+
74352+```c
74353+static GLogWriterOutput
74354+my_custom_log_writer_fn (GLogLevelFlags log_level,
74355+ const GLogField *fields,
74356+ gsize n_fields,
74357+ gpointer user_data)
74358+{
74359+
74360+ // abort if the message was fatal
74361+ if (log_level &amp; g_log_get_always_fatal ())
74362+ g_abort ();
74363+
74364+ // custom log handling code
74365+ ...
74366+ ...
74367+
74368+ // success
74369+ return G_LOG_WRITER_HANDLED;
74370+}
74371+```</doc>
74372+ <source-position filename="glib/gmessages.h" line="121"/>
74373+ <return-value transfer-ownership="none">
74374+ <doc xml:space="preserve"
74375+ filename="glib/gmessages.c"
74376+ line="603">the current fatal mask</doc>
74377+ <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
74378+ </return-value>
74379+ </function>
7345474380 <function name="log_get_debug_enabled"
7345574381 c:identifier="g_log_get_debug_enabled"
7345674382 version="2.72">
7345774383 <doc xml:space="preserve"
7345874384 filename="glib/gmessages.c"
73459- line="3018">Return whether debug output from the GLib logging system is enabled.
74385+ line="3104">Return whether debug output from the GLib logging system is enabled.
7346074386
7346174387 Note that this should not be used to conditionalise calls to [func@GLib.debug] or
7346274388 other logging functions; it should only be used from [type@GLib.LogWriterFunc]
@@ -73465,18 +74391,18 @@ implementations.
7346574391 Note also that the value of this does not depend on `G_MESSAGES_DEBUG`, nor
7346674392 `DEBUG_INVOCATION`, nor [func@GLib.log_writer_default_set_debug_domains]; see
7346774393 the docs for [func@GLib.log_set_debug_enabled].</doc>
73468- <source-position filename="glib/gmessages.h" line="264"/>
74394+ <source-position filename="glib/gmessages.h" line="267"/>
7346974395 <return-value transfer-ownership="none">
7347074396 <doc xml:space="preserve"
7347174397 filename="glib/gmessages.c"
73472- line="3031">`TRUE` if debug output is enabled, `FALSE` otherwise</doc>
74398+ line="3117">`TRUE` if debug output is enabled, `FALSE` otherwise</doc>
7347374399 <type name="gboolean" c:type="gboolean"/>
7347474400 </return-value>
7347574401 </function>
7347674402 <function name="log_remove_handler" c:identifier="g_log_remove_handler">
7347774403 <doc xml:space="preserve"
7347874404 filename="glib/gmessages.c"
73479- line="853">Removes the log handler.
74405+ line="906">Removes the log handler.
7348074406
7348174407 This has no effect if structured logging is enabled; see
7348274408 [Using Structured Logging](logging.html#using-structured-logging).</doc>
@@ -73488,13 +74414,13 @@ This has no effect if structured logging is enabled; see
7348874414 <parameter name="log_domain" transfer-ownership="none">
7348974415 <doc xml:space="preserve"
7349074416 filename="glib/gmessages.c"
73491- line="855">the log domain</doc>
74417+ line="908">the log domain</doc>
7349274418 <type name="utf8" c:type="const gchar*"/>
7349374419 </parameter>
7349474420 <parameter name="handler_id" transfer-ownership="none">
7349574421 <doc xml:space="preserve"
7349674422 filename="glib/gmessages.c"
73497- line="856">the ID of the handler, which was returned
74423+ line="909">the ID of the handler, which was returned
7349874424 in [func@GLib.log_set_handler]</doc>
7349974425 <type name="guint" c:type="guint"/>
7350074426 </parameter>
@@ -73504,7 +74430,7 @@ This has no effect if structured logging is enabled; see
7350474430 c:identifier="g_log_set_always_fatal">
7350574431 <doc xml:space="preserve"
7350674432 filename="glib/gmessages.c"
73507- line="560">Sets the message levels which are always fatal, in any log domain.
74433+ line="613">Sets the message levels which are always fatal, in any log domain.
7350874434
7350974435 When a message with any of these levels is logged the program terminates.
7351074436 You can only set the levels defined by GLib to be fatal.
@@ -73512,7 +74438,7 @@ You can only set the levels defined by GLib to be fatal.
7351274438
7351374439 You can also make some message levels fatal at runtime by setting
7351474440 the `G_DEBUG` environment variable (see
73515-[Running GLib Applications](glib-running.html)).
74441+[Running GLib Applications](running.html)).
7351674442
7351774443 Libraries should not call this function, as it affects all messages logged
7351874444 by a process, including those from other libraries.
@@ -73525,14 +74451,14 @@ are fatal. See [Using Structured Logging](logging.html#using-structured-logging)
7352574451 <return-value transfer-ownership="none">
7352674452 <doc xml:space="preserve"
7352774453 filename="glib/gmessages.c"
73528- line="583">the old fatal mask</doc>
74454+ line="636">the old fatal mask</doc>
7352974455 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
7353074456 </return-value>
7353174457 <parameters>
7353274458 <parameter name="fatal_mask" transfer-ownership="none">
7353374459 <doc xml:space="preserve"
7353474460 filename="glib/gmessages.c"
73535- line="562">the mask containing bits set for each level of error which is
74461+ line="615">the mask containing bits set for each level of error which is
7353674462 to be fatal</doc>
7353774463 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
7353874464 </parameter>
@@ -73543,7 +74469,7 @@ are fatal. See [Using Structured Logging](logging.html#using-structured-logging)
7354374469 version="2.72">
7354474470 <doc xml:space="preserve"
7354574471 filename="glib/gmessages.c"
73546- line="3041">Enable or disable debug output from the GLib logging system for all domains.
74472+ line="3127">Enable or disable debug output from the GLib logging system for all domains.
7354774473
7354874474 This value interacts disjunctively with `G_MESSAGES_DEBUG`, `DEBUG_INVOCATION` and
7354974475 [func@GLib.log_writer_default_set_debug_domains] — if any of them would allow
@@ -73551,7 +74477,7 @@ a debug message to be outputted, it will be.
7355174477
7355274478 Note that this should not be used from within library code to enable debug
7355374479 output — it is intended for external use.</doc>
73554- <source-position filename="glib/gmessages.h" line="266"/>
74480+ <source-position filename="glib/gmessages.h" line="269"/>
7355574481 <return-value transfer-ownership="none">
7355674482 <type name="none" c:type="void"/>
7355774483 </return-value>
@@ -73559,7 +74485,7 @@ output — it is intended for external use.</doc>
7355974485 <parameter name="enabled" transfer-ownership="none">
7356074486 <doc xml:space="preserve"
7356174487 filename="glib/gmessages.c"
73562- line="3043">`TRUE` to enable debug output, `FALSE` otherwise</doc>
74488+ line="3129">`TRUE` to enable debug output, `FALSE` otherwise</doc>
7356374489 <type name="gboolean" c:type="gboolean"/>
7356474490 </parameter>
7356574491 </parameters>
@@ -73570,7 +74496,7 @@ output — it is intended for external use.</doc>
7357074496 introspectable="0">
7357174497 <doc xml:space="preserve"
7357274498 filename="glib/gmessages.c"
73573- line="781">Installs a default log handler which is used if no
74499+ line="834">Installs a default log handler which is used if no
7357474500 log handler has been set for the particular log domain
7357574501 and log level combination.
7357674502
@@ -73582,14 +74508,14 @@ This has no effect if structured logging is enabled; see
7358274508 <return-value>
7358374509 <doc xml:space="preserve"
7358474510 filename="glib/gmessages.c"
73585- line="795">the previous default log handler</doc>
74511+ line="848">the previous default log handler</doc>
7358674512 <type name="LogFunc" c:type="GLogFunc"/>
7358774513 </return-value>
7358874514 <parameters>
7358974515 <parameter name="log_func" transfer-ownership="none" closure="1">
7359074516 <doc xml:space="preserve"
7359174517 filename="glib/gmessages.c"
73592- line="783">the log handler function</doc>
74518+ line="836">the log handler function</doc>
7359374519 <type name="LogFunc" c:type="GLogFunc"/>
7359474520 </parameter>
7359574521 <parameter name="user_data"
@@ -73598,7 +74524,7 @@ This has no effect if structured logging is enabled; see
7359874524 allow-none="1">
7359974525 <doc xml:space="preserve"
7360074526 filename="glib/gmessages.c"
73601- line="784">data passed to the log handler</doc>
74527+ line="837">data passed to the log handler</doc>
7360274528 <type name="gpointer" c:type="gpointer"/>
7360374529 </parameter>
7360474530 </parameters>
@@ -73606,7 +74532,7 @@ This has no effect if structured logging is enabled; see
7360674532 <function name="log_set_fatal_mask" c:identifier="g_log_set_fatal_mask">
7360774533 <doc xml:space="preserve"
7360874534 filename="glib/gmessages.c"
73609- line="607">Sets the log levels which are fatal in the given domain.
74535+ line="660">Sets the log levels which are fatal in the given domain.
7361074536
7361174537 [flags@GLib.LogLevelFlags.LEVEL_ERROR] is always fatal.
7361274538
@@ -73624,20 +74550,20 @@ This function is mostly intended to be used with
7362474550 <return-value transfer-ownership="none">
7362574551 <doc xml:space="preserve"
7362674552 filename="glib/gmessages.c"
73627- line="627">the old fatal mask for the log domain</doc>
74553+ line="680">the old fatal mask for the log domain</doc>
7362874554 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
7362974555 </return-value>
7363074556 <parameters>
7363174557 <parameter name="log_domain" transfer-ownership="none">
7363274558 <doc xml:space="preserve"
7363374559 filename="glib/gmessages.c"
73634- line="609">the log domain</doc>
74560+ line="662">the log domain</doc>
7363574561 <type name="utf8" c:type="const gchar*"/>
7363674562 </parameter>
7363774563 <parameter name="fatal_mask" transfer-ownership="none">
7363874564 <doc xml:space="preserve"
7363974565 filename="glib/gmessages.c"
73640- line="610">the new fatal mask</doc>
74566+ line="663">the new fatal mask</doc>
7364174567 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
7364274568 </parameter>
7364374569 </parameters>
@@ -73648,7 +74574,7 @@ This function is mostly intended to be used with
7364874574 introspectable="0">
7364974575 <doc xml:space="preserve"
7365074576 filename="glib/gmessages.c"
73651- line="659">Sets the log handler for a domain and a set of log levels.
74577+ line="712">Sets the log handler for a domain and a set of log levels.
7365274578
7365374579 To handle fatal and recursive messages the @log_levels parameter
7365474580 must be combined with the [flags@GLib.LogLevelFlags.FLAG_FATAL] and [flags@GLib.LogLevelFlags.FLAG_RECURSION]
@@ -73689,7 +74615,7 @@ g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL
7368974615 <return-value transfer-ownership="none">
7369074616 <doc xml:space="preserve"
7369174617 filename="glib/gmessages.c"
73692- line="708">the id of the new handler</doc>
74618+ line="761">the id of the new handler</doc>
7369374619 <type name="guint" c:type="guint"/>
7369474620 </return-value>
7369574621 <parameters>
@@ -73699,14 +74625,14 @@ g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL
7369974625 allow-none="1">
7370074626 <doc xml:space="preserve"
7370174627 filename="glib/gmessages.c"
73702- line="661">the log domain
74628+ line="714">the log domain
7370374629 application domain</doc>
7370474630 <type name="utf8" c:type="const gchar*"/>
7370574631 </parameter>
7370674632 <parameter name="log_levels" transfer-ownership="none">
7370774633 <doc xml:space="preserve"
7370874634 filename="glib/gmessages.c"
73709- line="663">the log levels to apply the log handler for.
74635+ line="716">the log levels to apply the log handler for.
7371074636 To handle fatal and recursive messages as well, combine
7371174637 the log levels with the [flags@GLib.LogLevelFlags.FLAG_FATAL] and
7371274638 [flags@GLib.LogLevelFlags.FLAG_RECURSION] bit flags.</doc>
@@ -73715,7 +74641,7 @@ g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL
7371574641 <parameter name="log_func" transfer-ownership="none" closure="3">
7371674642 <doc xml:space="preserve"
7371774643 filename="glib/gmessages.c"
73718- line="667">the log handler function</doc>
74644+ line="720">the log handler function</doc>
7371974645 <type name="LogFunc" c:type="GLogFunc"/>
7372074646 </parameter>
7372174647 <parameter name="user_data"
@@ -73724,7 +74650,7 @@ g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL
7372474650 allow-none="1">
7372574651 <doc xml:space="preserve"
7372674652 filename="glib/gmessages.c"
73727- line="668">data passed to the log handler</doc>
74653+ line="721">data passed to the log handler</doc>
7372874654 <type name="gpointer" c:type="gpointer"/>
7372974655 </parameter>
7373074656 </parameters>
@@ -73735,7 +74661,7 @@ g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL
7373574661 version="2.46">
7373674662 <doc xml:space="preserve"
7373774663 filename="glib/gmessages.c"
73738- line="719">Like [func@GLib.log_set_handler], but takes a destroy notify for the @user_data.
74664+ line="772">Like [func@GLib.log_set_handler], but takes a destroy notify for the @user_data.
7373974665
7374074666 This has no effect if structured logging is enabled; see
7374174667 [Using Structured Logging](logging.html#using-structured-logging).
@@ -73746,7 +74672,7 @@ application domain.</doc>
7374674672 <return-value transfer-ownership="none">
7374774673 <doc xml:space="preserve"
7374874674 filename="glib/gmessages.c"
73749- line="739">the ID of the new handler</doc>
74675+ line="792">the ID of the new handler</doc>
7375074676 <type name="guint" c:type="guint"/>
7375174677 </return-value>
7375274678 <parameters>
@@ -73756,14 +74682,14 @@ application domain.</doc>
7375674682 allow-none="1">
7375774683 <doc xml:space="preserve"
7375874684 filename="glib/gmessages.c"
73759- line="721">the log domain
74685+ line="774">the log domain
7376074686 application domain</doc>
7376174687 <type name="utf8" c:type="const gchar*"/>
7376274688 </parameter>
7376374689 <parameter name="log_levels" transfer-ownership="none">
7376474690 <doc xml:space="preserve"
7376574691 filename="glib/gmessages.c"
73766- line="723">the log levels to apply the log handler for.
74692+ line="776">the log levels to apply the log handler for.
7376774693 To handle fatal and recursive messages as well, combine
7376874694 the log levels with the [flags@GLib.LogLevelFlags.FLAG_FATAL] and
7376974695 [flags@GLib.LogLevelFlags.FLAG_RECURSION] bit flags.</doc>
@@ -73776,7 +74702,7 @@ application domain.</doc>
7377674702 destroy="4">
7377774703 <doc xml:space="preserve"
7377874704 filename="glib/gmessages.c"
73779- line="727">the log handler function</doc>
74705+ line="780">the log handler function</doc>
7378074706 <type name="LogFunc" c:type="GLogFunc"/>
7378174707 </parameter>
7378274708 <parameter name="user_data"
@@ -73785,13 +74711,13 @@ application domain.</doc>
7378574711 allow-none="1">
7378674712 <doc xml:space="preserve"
7378774713 filename="glib/gmessages.c"
73788- line="728">data passed to the log handler</doc>
74714+ line="781">data passed to the log handler</doc>
7378974715 <type name="gpointer" c:type="gpointer"/>
7379074716 </parameter>
7379174717 <parameter name="destroy" transfer-ownership="none" scope="async">
7379274718 <doc xml:space="preserve"
7379374719 filename="glib/gmessages.c"
73794- line="729">destroy notify for @user_data, or `NULL`</doc>
74720+ line="782">destroy notify for @user_data, or `NULL`</doc>
7379574721 <type name="DestroyNotify" c:type="GDestroyNotify"/>
7379674722 </parameter>
7379774723 </parameters>
@@ -73801,7 +74727,7 @@ application domain.</doc>
7380174727 version="2.50">
7380274728 <doc xml:space="preserve"
7380374729 filename="glib/gmessages.c"
73804- line="1936">Set a writer function which will be called to format and write out each log
74730+ line="1958">Set a writer function which will be called to format and write out each log
7380574731 message.
7380674732
7380774733 Each program should set a writer function, or the default writer
@@ -73812,7 +74738,7 @@ install a writer function, as there must be a single, central point where
7381274738 log messages are formatted and outputted.
7381374739
7381474740 There can only be one writer function. It is an error to set more than one.</doc>
73815- <source-position filename="glib/gmessages.h" line="217"/>
74741+ <source-position filename="glib/gmessages.h" line="220"/>
7381674742 <return-value transfer-ownership="none">
7381774743 <type name="none" c:type="void"/>
7381874744 </return-value>
@@ -73824,7 +74750,7 @@ There can only be one writer function. It is an error to set more than one.</doc
7382474750 destroy="2">
7382574751 <doc xml:space="preserve"
7382674752 filename="glib/gmessages.c"
73827- line="1938">log writer function, which must not be `NULL`</doc>
74753+ line="1960">log writer function, which must not be `NULL`</doc>
7382874754 <type name="LogWriterFunc" c:type="GLogWriterFunc"/>
7382974755 </parameter>
7383074756 <parameter name="user_data"
@@ -73833,7 +74759,7 @@ There can only be one writer function. It is an error to set more than one.</doc
7383374759 allow-none="1">
7383474760 <doc xml:space="preserve"
7383574761 filename="glib/gmessages.c"
73836- line="1939">user data to pass to @func</doc>
74762+ line="1961">user data to pass to @func</doc>
7383774763 <type name="gpointer" c:type="gpointer"/>
7383874764 </parameter>
7383974765 <parameter name="user_data_free"
@@ -73842,7 +74768,7 @@ There can only be one writer function. It is an error to set more than one.</doc
7384274768 destroy="0">
7384374769 <doc xml:space="preserve"
7384474770 filename="glib/gmessages.c"
73845- line="1940">function to free @user_data once it’s
74771+ line="1962">function to free @user_data once it’s
7384674772 finished with, if non-`NULL`</doc>
7384774773 <type name="DestroyNotify" c:type="GDestroyNotify"/>
7384874774 </parameter>
@@ -73854,7 +74780,7 @@ There can only be one writer function. It is an error to set more than one.</doc
7385474780 introspectable="0">
7385574781 <doc xml:space="preserve"
7385674782 filename="glib/gmessages.c"
73857- line="1502">Log a message with structured data.
74783+ line="1506">Log a message with structured data.
7385874784
7385974785 The message will be passed through to the log writer set by the application
7386074786 using [func@GLib.log_set_writer_func]. If the message is fatal (i.e. its log level
@@ -73943,7 +74869,7 @@ field for which `printf()`-style formatting is supported.
7394374869 The default writer function for `stdout` and `stderr` will automatically
7394474870 append a new-line character after the message, so you should not add one
7394574871 manually to the format string.</doc>
73946- <source-position filename="glib/gmessages.h" line="203"/>
74872+ <source-position filename="glib/gmessages.h" line="206"/>
7394774873 <return-value transfer-ownership="none">
7394874874 <type name="none" c:type="void"/>
7394974875 </return-value>
@@ -73951,20 +74877,20 @@ manually to the format string.</doc>
7395174877 <parameter name="log_domain" transfer-ownership="none">
7395274878 <doc xml:space="preserve"
7395374879 filename="glib/gmessages.c"
73954- line="1504">log domain, usually `G_LOG_DOMAIN`</doc>
74880+ line="1508">log domain, usually `G_LOG_DOMAIN`</doc>
7395574881 <type name="utf8" c:type="const gchar*"/>
7395674882 </parameter>
7395774883 <parameter name="log_level" transfer-ownership="none">
7395874884 <doc xml:space="preserve"
7395974885 filename="glib/gmessages.c"
73960- line="1505">log level, either from [type@GLib.LogLevelFlags], or a user-defined
74886+ line="1509">log level, either from [type@GLib.LogLevelFlags], or a user-defined
7396174887 level</doc>
7396274888 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
7396374889 </parameter>
7396474890 <parameter name="..." transfer-ownership="none">
7396574891 <doc xml:space="preserve"
7396674892 filename="glib/gmessages.c"
73967- line="1507">key-value pairs of structured data to add to the log entry, followed
74893+ line="1511">key-value pairs of structured data to add to the log entry, followed
7396874894 by the key `MESSAGE`, followed by a `printf()`-style message format,
7396974895 followed by parameters to insert in the format string</doc>
7397074896 <varargs/>
@@ -73976,7 +74902,7 @@ manually to the format string.</doc>
7397674902 version="2.50">
7397774903 <doc xml:space="preserve"
7397874904 filename="glib/gmessages.c"
73979- line="1824">Log a message with structured data.
74905+ line="1831">Log a message with structured data.
7398074906
7398174907 The message will be passed through to the log writer set by the application
7398274908 using [func@GLib.log_set_writer_func]. If the
@@ -73987,7 +74913,7 @@ See [func@GLib.log_structured] for more documentation.
7398774913
7398874914 This assumes that @log_level is already present in @fields (typically as the
7398974915 `PRIORITY` field).</doc>
73990- <source-position filename="glib/gmessages.h" line="207"/>
74916+ <source-position filename="glib/gmessages.h" line="210"/>
7399174917 <return-value transfer-ownership="none">
7399274918 <type name="none" c:type="void"/>
7399374919 </return-value>
@@ -73995,14 +74921,14 @@ This assumes that @log_level is already present in @fields (typically as the
7399574921 <parameter name="log_level" transfer-ownership="none">
7399674922 <doc xml:space="preserve"
7399774923 filename="glib/gmessages.c"
73998- line="1826">log level, either from [type@GLib.LogLevelFlags], or a user-defined
74924+ line="1833">log level, either from [type@GLib.LogLevelFlags], or a user-defined
7399974925 level</doc>
7400074926 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
7400174927 </parameter>
7400274928 <parameter name="fields" transfer-ownership="none">
7400374929 <doc xml:space="preserve"
7400474930 filename="glib/gmessages.c"
74005- line="1828">key–value pairs of structured data to add
74931+ line="1835">key–value pairs of structured data to add
7400674932 to the log message</doc>
7400774933 <array length="2" zero-terminated="0" c:type="const GLogField*">
7400874934 <type name="LogField" c:type="GLogField"/>
@@ -74011,7 +74937,7 @@ This assumes that @log_level is already present in @fields (typically as the
7401174937 <parameter name="n_fields" transfer-ownership="none">
7401274938 <doc xml:space="preserve"
7401374939 filename="glib/gmessages.c"
74014- line="1830">number of elements in the @fields array</doc>
74940+ line="1837">number of elements in the @fields array</doc>
7401574941 <type name="gsize" c:type="gsize"/>
7401674942 </parameter>
7401774943 </parameters>
@@ -74019,7 +74945,7 @@ This assumes that @log_level is already present in @fields (typically as the
7401974945 <function name="log_structured_standard"
7402074946 c:identifier="g_log_structured_standard"
7402174947 introspectable="0">
74022- <source-position filename="glib/gmessages.h" line="311"/>
74948+ <source-position filename="glib/gmessages.h" line="314"/>
7402374949 <return-value transfer-ownership="none">
7402474950 <type name="none" c:type="void"/>
7402574951 </return-value>
@@ -74050,7 +74976,7 @@ This assumes that @log_level is already present in @fields (typically as the
7405074976 <function name="log_variant" c:identifier="g_log_variant" version="2.50">
7405174977 <doc xml:space="preserve"
7405274978 filename="glib/gmessages.c"
74053- line="1707">Log a message with structured data, accepting the data within a [type@GLib.Variant].
74979+ line="1714">Log a message with structured data, accepting the data within a [type@GLib.Variant].
7405474980
7405574981 This version is especially useful for use in other languages, via introspection.
7405674982
@@ -74065,7 +74991,7 @@ to the log writer as such. The size of the array should not be higher than
7406574991 [method@GLib.Variant.print] will be used to convert the value into a string.
7406674992
7406774993 For more details on its usage and about the parameters, see [func@GLib.log_structured].</doc>
74068- <source-position filename="glib/gmessages.h" line="212"/>
74994+ <source-position filename="glib/gmessages.h" line="215"/>
7406974995 <return-value transfer-ownership="none">
7407074996 <type name="none" c:type="void"/>
7407174997 </return-value>
@@ -74076,20 +75002,20 @@ For more details on its usage and about the parameters, see [func@GLib.log_struc
7407675002 allow-none="1">
7407775003 <doc xml:space="preserve"
7407875004 filename="glib/gmessages.c"
74079- line="1709">log domain, usually `G_LOG_DOMAIN`</doc>
75005+ line="1716">log domain, usually `G_LOG_DOMAIN`</doc>
7408075006 <type name="utf8" c:type="const gchar*"/>
7408175007 </parameter>
7408275008 <parameter name="log_level" transfer-ownership="none">
7408375009 <doc xml:space="preserve"
7408475010 filename="glib/gmessages.c"
74085- line="1710">log level, either from [type@GLib.LogLevelFlags], or a user-defined
75011+ line="1717">log level, either from [type@GLib.LogLevelFlags], or a user-defined
7408675012 level</doc>
7408775013 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
7408875014 </parameter>
7408975015 <parameter name="fields" transfer-ownership="none">
7409075016 <doc xml:space="preserve"
7409175017 filename="glib/gmessages.c"
74092- line="1712">a dictionary ([type@GLib.Variant] of the type `G_VARIANT_TYPE_VARDICT`)
75018+ line="1719">a dictionary ([type@GLib.Variant] of the type `G_VARIANT_TYPE_VARDICT`)
7409375019 containing the key-value pairs of message data.</doc>
7409475020 <type name="Variant" c:type="GVariant*"/>
7409575021 </parameter>
@@ -74100,7 +75026,7 @@ containing the key-value pairs of message data.</doc>
7410075026 version="2.50">
7410175027 <doc xml:space="preserve"
7410275028 filename="glib/gmessages.c"
74103- line="2859">Format a structured log message and output it to the default log destination
75029+ line="2945">Format a structured log message and output it to the default log destination
7410475030 for the platform.
7410575031
7410675032 On Linux, this is typically the systemd journal, falling
@@ -74122,11 +75048,11 @@ the environment, or set at runtime by [func@GLib.log_writer_default_set_debug_do
7412275048 [func@GLib.log_writer_default] uses the mask set by [func@GLib.log_set_always_fatal] to
7412375049 determine which messages are fatal. When using a custom writer function instead it is
7412475050 up to the writer function to determine which log messages are fatal.</doc>
74125- <source-position filename="glib/gmessages.h" line="248"/>
75051+ <source-position filename="glib/gmessages.h" line="251"/>
7412675052 <return-value transfer-ownership="none">
7412775053 <doc xml:space="preserve"
7412875054 filename="glib/gmessages.c"
74129- line="2891">[enum@GLib.LogWriterOutput.HANDLED] on success,
75055+ line="2977">[enum@GLib.LogWriterOutput.HANDLED] on success,
7413075056 [enum@GLib.LogWriterOutput.UNHANDLED] otherwise</doc>
7413175057 <type name="LogWriterOutput" c:type="GLogWriterOutput"/>
7413275058 </return-value>
@@ -74134,14 +75060,14 @@ up to the writer function to determine which log messages are fatal.</doc>
7413475060 <parameter name="log_level" transfer-ownership="none">
7413575061 <doc xml:space="preserve"
7413675062 filename="glib/gmessages.c"
74137- line="2861">log level, either from [type@GLib.LogLevelFlags], or a user-defined
75063+ line="2947">log level, either from [type@GLib.LogLevelFlags], or a user-defined
7413875064 level</doc>
7413975065 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
7414075066 </parameter>
7414175067 <parameter name="fields" transfer-ownership="none">
7414275068 <doc xml:space="preserve"
7414375069 filename="glib/gmessages.c"
74144- line="2863">key–value pairs of structured data forming
75070+ line="2949">key–value pairs of structured data forming
7414575071 the log message</doc>
7414675072 <array length="2" zero-terminated="0" c:type="const GLogField*">
7414775073 <type name="LogField" c:type="GLogField"/>
@@ -74150,7 +75076,7 @@ up to the writer function to determine which log messages are fatal.</doc>
7415075076 <parameter name="n_fields" transfer-ownership="none">
7415175077 <doc xml:space="preserve"
7415275078 filename="glib/gmessages.c"
74153- line="2865">number of elements in the @fields array</doc>
75079+ line="2951">number of elements in the @fields array</doc>
7415475080 <type name="gsize" c:type="gsize"/>
7415575081 </parameter>
7415675082 <parameter name="user_data"
@@ -74159,7 +75085,7 @@ up to the writer function to determine which log messages are fatal.</doc>
7415975085 allow-none="1">
7416075086 <doc xml:space="preserve"
7416175087 filename="glib/gmessages.c"
74162- line="2866">user data passed to [func@GLib.log_set_writer_func]</doc>
75088+ line="2952">user data passed to [func@GLib.log_set_writer_func]</doc>
7416375089 <type name="gpointer" c:type="gpointer"/>
7416475090 </parameter>
7416575091 </parameters>
@@ -74169,11 +75095,11 @@ up to the writer function to determine which log messages are fatal.</doc>
7416975095 version="2.80">
7417075096 <doc xml:space="preserve"
7417175097 filename="glib/gmessages.c"
74172- line="2716">Reset the list of domains to be logged, that might be initially set by the
75098+ line="2802">Reset the list of domains to be logged, that might be initially set by the
7417375099 `G_MESSAGES_DEBUG` or `DEBUG_INVOCATION` environment variables.
7417475100
7417575101 This function is thread-safe.</doc>
74176- <source-position filename="glib/gmessages.h" line="259"/>
75102+ <source-position filename="glib/gmessages.h" line="262"/>
7417775103 <return-value transfer-ownership="none">
7417875104 <type name="none" c:type="void"/>
7417975105 </return-value>
@@ -74184,7 +75110,7 @@ This function is thread-safe.</doc>
7418475110 allow-none="1">
7418575111 <doc xml:space="preserve"
7418675112 filename="glib/gmessages.c"
74187- line="2718">`NULL`-terminated array with domains to be printed.
75113+ line="2804">`NULL`-terminated array with domains to be printed.
7418875114 `NULL` or an array with no values means none. Array with a single value `"all"` means all.</doc>
7418975115 <type name="utf8" c:type="const gchar* const*"/>
7419075116 </parameter>
@@ -74195,7 +75121,7 @@ This function is thread-safe.</doc>
7419575121 version="2.68">
7419675122 <doc xml:space="preserve"
7419775123 filename="glib/gmessages.c"
74198- line="1043">Configure whether the built-in log functions will output all log messages to
75124+ line="1047">Configure whether the built-in log functions will output all log messages to
7419975125 `stderr`.
7420075126
7420175127 The built-in log functions are [func@GLib.log_default_handler] for the
@@ -74210,7 +75136,7 @@ to reserve `stdout` for structured output such as JSON or XML.
7421075136 This function sets global state. It is not thread-aware, and should be
7421175137 called at the very start of a program, before creating any other threads
7421275138 or creating objects that could create worker threads of their own.</doc>
74213- <source-position filename="glib/gmessages.h" line="254"/>
75139+ <source-position filename="glib/gmessages.h" line="257"/>
7421475140 <return-value transfer-ownership="none">
7421575141 <type name="none" c:type="void"/>
7421675142 </return-value>
@@ -74218,7 +75144,7 @@ or creating objects that could create worker threads of their own.</doc>
7421875144 <parameter name="use_stderr" transfer-ownership="none">
7421975145 <doc xml:space="preserve"
7422075146 filename="glib/gmessages.c"
74221- line="1045">If `TRUE`, use `stderr` for log messages that would
75147+ line="1049">If `TRUE`, use `stderr` for log messages that would
7422275148 normally have appeared on `stdout`</doc>
7422375149 <type name="gboolean" c:type="gboolean"/>
7422475150 </parameter>
@@ -74229,7 +75155,7 @@ or creating objects that could create worker threads of their own.</doc>
7422975155 version="2.68">
7423075156 <doc xml:space="preserve"
7423175157 filename="glib/gmessages.c"
74232- line="2814">Check whether [func@GLib.log_writer_default] and [func@GLib.log_default_handler] would
75158+ line="2900">Check whether [func@GLib.log_writer_default] and [func@GLib.log_default_handler] would
7423375159 ignore a message with the given domain and level.
7423475160
7423575161 As with [func@GLib.log_default_handler], this function drops debug and informational
@@ -74256,11 +75182,11 @@ if (!g_log_writer_default_would_drop (G_LOG_LEVEL_DEBUG, G_LOG_DOMAIN))
7425675182 g_debug ("my_object result: %s", result);
7425775183 }
7425875184 ```</doc>
74259- <source-position filename="glib/gmessages.h" line="256"/>
75185+ <source-position filename="glib/gmessages.h" line="259"/>
7426075186 <return-value transfer-ownership="none">
7426175187 <doc xml:space="preserve"
7426275188 filename="glib/gmessages.c"
74263- line="2848">`TRUE` if the log message would be dropped by GLib’s
75189+ line="2934">`TRUE` if the log message would be dropped by GLib’s
7426475190 default log handlers</doc>
7426575191 <type name="gboolean" c:type="gboolean"/>
7426675192 </return-value>
@@ -74268,7 +75194,7 @@ if (!g_log_writer_default_would_drop (G_LOG_LEVEL_DEBUG, G_LOG_DOMAIN))
7426875194 <parameter name="log_level" transfer-ownership="none">
7426975195 <doc xml:space="preserve"
7427075196 filename="glib/gmessages.c"
74271- line="2817">log level, either from [type@GLib.LogLevelFlags], or a user-defined
75197+ line="2903">log level, either from [type@GLib.LogLevelFlags], or a user-defined
7427275198 level</doc>
7427375199 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
7427475200 </parameter>
@@ -74278,7 +75204,7 @@ if (!g_log_writer_default_would_drop (G_LOG_LEVEL_DEBUG, G_LOG_DOMAIN))
7427875204 allow-none="1">
7427975205 <doc xml:space="preserve"
7428075206 filename="glib/gmessages.c"
74281- line="2816">log domain</doc>
75207+ line="2902">log domain</doc>
7428275208 <type name="utf8" c:type="const char*"/>
7428375209 </parameter>
7428475210 </parameters>
@@ -74288,7 +75214,7 @@ if (!g_log_writer_default_would_drop (G_LOG_LEVEL_DEBUG, G_LOG_DOMAIN))
7428875214 version="2.50">
7428975215 <doc xml:space="preserve"
7429075216 filename="glib/gmessages.c"
74291- line="2125">Format a structured log message as a string suitable for outputting to the
75217+ line="2274">Format a structured log message as a string suitable for outputting to the
7429275218 terminal (or elsewhere).
7429375219
7429475220 This will include the values of all fields it knows
@@ -74299,11 +75225,11 @@ unknown fields.
7429975225 The returned string does **not** have a trailing new-line character. It is
7430075226 encoded in the character set of the current locale, which is not necessarily
7430175227 UTF-8.</doc>
74302- <source-position filename="glib/gmessages.h" line="227"/>
75228+ <source-position filename="glib/gmessages.h" line="230"/>
7430375229 <return-value transfer-ownership="full">
7430475230 <doc xml:space="preserve"
7430575231 filename="glib/gmessages.c"
74306- line="2148">string containing the formatted log message, in
75232+ line="2297">string containing the formatted log message, in
7430775233 the character set of the current locale</doc>
7430875234 <type name="utf8" c:type="gchar*"/>
7430975235 </return-value>
@@ -74311,14 +75237,14 @@ UTF-8.</doc>
7431175237 <parameter name="log_level" transfer-ownership="none">
7431275238 <doc xml:space="preserve"
7431375239 filename="glib/gmessages.c"
74314- line="2127">log level, either from [type@GLib.LogLevelFlags], or a user-defined
75240+ line="2276">log level, either from [type@GLib.LogLevelFlags], or a user-defined
7431575241 level</doc>
7431675242 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
7431775243 </parameter>
7431875244 <parameter name="fields" transfer-ownership="none">
7431975245 <doc xml:space="preserve"
7432075246 filename="glib/gmessages.c"
74321- line="2129">key–value pairs of structured data forming
75247+ line="2278">key–value pairs of structured data forming
7432275248 the log message</doc>
7432375249 <array length="2" zero-terminated="0" c:type="const GLogField*">
7432475250 <type name="LogField" c:type="GLogField"/>
@@ -74327,13 +75253,13 @@ UTF-8.</doc>
7432775253 <parameter name="n_fields" transfer-ownership="none">
7432875254 <doc xml:space="preserve"
7432975255 filename="glib/gmessages.c"
74330- line="2131">number of elements in the @fields array</doc>
75256+ line="2280">number of elements in the @fields array</doc>
7433175257 <type name="gsize" c:type="gsize"/>
7433275258 </parameter>
7433375259 <parameter name="use_color" transfer-ownership="none">
7433475260 <doc xml:space="preserve"
7433575261 filename="glib/gmessages.c"
74336- line="2132">`TRUE` to use
75262+ line="2281">`TRUE` to use
7433775263 [ANSI color escape sequences](https://en.wikipedia.org/wiki/ANSI_escape_code)
7433875264 when formatting the message, `FALSE` to not</doc>
7433975265 <type name="gboolean" c:type="gboolean"/>
@@ -74345,7 +75271,7 @@ UTF-8.</doc>
7434575271 version="2.50">
7434675272 <doc xml:space="preserve"
7434775273 filename="glib/gmessages.c"
74348- line="2096">Check whether the given @output_fd file descriptor is a connection to the
75274+ line="2118">Check whether the given @output_fd file descriptor is a connection to the
7434975275 systemd journal, or something else (like a log file or `stdout` or
7435075276 `stderr`).
7435175277
@@ -74354,18 +75280,18 @@ the following construct without needing any additional error handling:
7435475280 ```c
7435575281 is_journald = g_log_writer_is_journald (fileno (stderr));
7435675282 ```</doc>
74357- <source-position filename="glib/gmessages.h" line="224"/>
75283+ <source-position filename="glib/gmessages.h" line="227"/>
7435875284 <return-value transfer-ownership="none">
7435975285 <doc xml:space="preserve"
7436075286 filename="glib/gmessages.c"
74361- line="2110">`TRUE` if @output_fd points to the journal, `FALSE` otherwise</doc>
75287+ line="2132">`TRUE` if @output_fd points to the journal, `FALSE` otherwise</doc>
7436275288 <type name="gboolean" c:type="gboolean"/>
7436375289 </return-value>
7436475290 <parameters>
7436575291 <parameter name="output_fd" transfer-ownership="none">
7436675292 <doc xml:space="preserve"
7436775293 filename="glib/gmessages.c"
74368- line="2098">output file descriptor to check</doc>
75294+ line="2120">output file descriptor to check</doc>
7436975295 <type name="gint" c:type="gint"/>
7437075296 </parameter>
7437175297 </parameters>
@@ -74375,7 +75301,7 @@ is_journald = g_log_writer_is_journald (fileno (stderr));
7437575301 version="2.50">
7437675302 <doc xml:space="preserve"
7437775303 filename="glib/gmessages.c"
74378- line="2458">Format a structured log message and send it to the systemd journal as a set
75304+ line="2543">Format a structured log message and send it to the systemd journal as a set
7437975305 of key–value pairs.
7438075306
7438175307 All fields are sent to the journal, but if a field has
@@ -74386,25 +75312,25 @@ This is suitable for use as a [type@GLib.LogWriterFunc].
7438675312
7438775313 If GLib has been compiled without systemd support, this function is still
7438875314 defined, but will always return [enum@GLib.LogWriterOutput.UNHANDLED].</doc>
74389- <source-position filename="glib/gmessages.h" line="238"/>
75315+ <source-position filename="glib/gmessages.h" line="241"/>
7439075316 <return-value transfer-ownership="none">
7439175317 <doc xml:space="preserve"
7439275318 filename="glib/gmessages.c"
74393- line="2479">[enum@GLib.LogWriterOutput.HANDLED] on success, [enum@GLib.LogWriterOutput.UNHANDLED] otherwise</doc>
75319+ line="2564">[enum@GLib.LogWriterOutput.HANDLED] on success, [enum@GLib.LogWriterOutput.UNHANDLED] otherwise</doc>
7439475320 <type name="LogWriterOutput" c:type="GLogWriterOutput"/>
7439575321 </return-value>
7439675322 <parameters>
7439775323 <parameter name="log_level" transfer-ownership="none">
7439875324 <doc xml:space="preserve"
7439975325 filename="glib/gmessages.c"
74400- line="2460">log level, either from [type@GLib.LogLevelFlags], or a user-defined
75326+ line="2545">log level, either from [type@GLib.LogLevelFlags], or a user-defined
7440175327 level</doc>
7440275328 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
7440375329 </parameter>
7440475330 <parameter name="fields" transfer-ownership="none">
7440575331 <doc xml:space="preserve"
7440675332 filename="glib/gmessages.c"
74407- line="2462">key–value pairs of structured data forming
75333+ line="2547">key–value pairs of structured data forming
7440875334 the log message</doc>
7440975335 <array length="2" zero-terminated="0" c:type="const GLogField*">
7441075336 <type name="LogField" c:type="GLogField"/>
@@ -74413,7 +75339,7 @@ defined, but will always return [enum@GLib.LogWriterOutput.UNHANDLED].</doc>
7441375339 <parameter name="n_fields" transfer-ownership="none">
7441475340 <doc xml:space="preserve"
7441575341 filename="glib/gmessages.c"
74416- line="2464">number of elements in the @fields array</doc>
75342+ line="2549">number of elements in the @fields array</doc>
7441775343 <type name="gsize" c:type="gsize"/>
7441875344 </parameter>
7441975345 <parameter name="user_data"
@@ -74422,7 +75348,7 @@ defined, but will always return [enum@GLib.LogWriterOutput.UNHANDLED].</doc>
7442275348 allow-none="1">
7442375349 <doc xml:space="preserve"
7442475350 filename="glib/gmessages.c"
74425- line="2465">user data passed to [func@GLib.log_set_writer_func]</doc>
75351+ line="2550">user data passed to [func@GLib.log_set_writer_func]</doc>
7442675352 <type name="gpointer" c:type="gpointer"/>
7442775353 </parameter>
7442875354 </parameters>
@@ -74432,7 +75358,7 @@ defined, but will always return [enum@GLib.LogWriterOutput.UNHANDLED].</doc>
7443275358 version="2.50">
7443375359 <doc xml:space="preserve"
7443475360 filename="glib/gmessages.c"
74435- line="2571">Format a structured log message and print it to either `stdout` or `stderr`,
75361+ line="2656">Format a structured log message and print it to either `stdout` or `stderr`,
7443675362 depending on its log level.
7443775363
7443875364 [flags@GLib.LogLevelFlags.LEVEL_INFO] and [flags@GLib.LogLevelFlags.LEVEL_DEBUG] messages
@@ -74449,11 +75375,11 @@ they will be used in the output.
7444975375 A trailing new-line character is added to the log message when it is printed.
7445075376
7445175377 This is suitable for use as a [type@GLib.LogWriterFunc].</doc>
74452- <source-position filename="glib/gmessages.h" line="243"/>
75378+ <source-position filename="glib/gmessages.h" line="246"/>
7445375379 <return-value transfer-ownership="none">
7445475380 <doc xml:space="preserve"
7445575381 filename="glib/gmessages.c"
74456- line="2598">[enum@GLib.LogWriterOutput.HANDLED] on success,
75382+ line="2683">[enum@GLib.LogWriterOutput.HANDLED] on success,
7445775383 [enum@GLib.LogWriterOutput.UNHANDLED] otherwise</doc>
7445875384 <type name="LogWriterOutput" c:type="GLogWriterOutput"/>
7445975385 </return-value>
@@ -74461,14 +75387,14 @@ This is suitable for use as a [type@GLib.LogWriterFunc].</doc>
7446175387 <parameter name="log_level" transfer-ownership="none">
7446275388 <doc xml:space="preserve"
7446375389 filename="glib/gmessages.c"
74464- line="2573">log level, either from [type@GLib.LogLevelFlags], or a user-defined
75390+ line="2658">log level, either from [type@GLib.LogLevelFlags], or a user-defined
7446575391 level</doc>
7446675392 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
7446775393 </parameter>
7446875394 <parameter name="fields" transfer-ownership="none">
7446975395 <doc xml:space="preserve"
7447075396 filename="glib/gmessages.c"
74471- line="2575">key–value pairs of structured data forming
75397+ line="2660">key–value pairs of structured data forming
7447275398 the log message</doc>
7447375399 <array length="2" zero-terminated="0" c:type="const GLogField*">
7447475400 <type name="LogField" c:type="GLogField"/>
@@ -74477,7 +75403,7 @@ This is suitable for use as a [type@GLib.LogWriterFunc].</doc>
7447775403 <parameter name="n_fields" transfer-ownership="none">
7447875404 <doc xml:space="preserve"
7447975405 filename="glib/gmessages.c"
74480- line="2577">number of elements in the @fields array</doc>
75406+ line="2662">number of elements in the @fields array</doc>
7448175407 <type name="gsize" c:type="gsize"/>
7448275408 </parameter>
7448375409 <parameter name="user_data"
@@ -74486,7 +75412,7 @@ This is suitable for use as a [type@GLib.LogWriterFunc].</doc>
7448675412 allow-none="1">
7448775413 <doc xml:space="preserve"
7448875414 filename="glib/gmessages.c"
74489- line="2578">user data passed to [func@GLib.log_set_writer_func]</doc>
75415+ line="2663">user data passed to [func@GLib.log_set_writer_func]</doc>
7449075416 <type name="gpointer" c:type="gpointer"/>
7449175417 </parameter>
7449275418 </parameters>
@@ -74496,22 +75422,22 @@ This is suitable for use as a [type@GLib.LogWriterFunc].</doc>
7449675422 version="2.50">
7449775423 <doc xml:space="preserve"
7449875424 filename="glib/gmessages.c"
74499- line="1980">Check whether the given @output_fd file descriptor supports
75425+ line="2002">Check whether the given @output_fd file descriptor supports
7450075426 [ANSI color escape sequences](https://en.wikipedia.org/wiki/ANSI_escape_code).
7450175427
7450275428 If so, they can safely be used when formatting log messages.</doc>
74503- <source-position filename="glib/gmessages.h" line="222"/>
75429+ <source-position filename="glib/gmessages.h" line="225"/>
7450475430 <return-value transfer-ownership="none">
7450575431 <doc xml:space="preserve"
7450675432 filename="glib/gmessages.c"
74507- line="1989">`TRUE` if ANSI color escapes are supported, `FALSE` otherwise</doc>
75433+ line="2011">`TRUE` if ANSI color escapes are supported, `FALSE` otherwise</doc>
7450875434 <type name="gboolean" c:type="gboolean"/>
7450975435 </return-value>
7451075436 <parameters>
7451175437 <parameter name="output_fd" transfer-ownership="none">
7451275438 <doc xml:space="preserve"
7451375439 filename="glib/gmessages.c"
74514- line="1982">output file descriptor to check</doc>
75440+ line="2004">output file descriptor to check</doc>
7451575441 <type name="gint" c:type="gint"/>
7451675442 </parameter>
7451775443 </parameters>
@@ -74521,7 +75447,7 @@ If so, they can safely be used when formatting log messages.</doc>
7452175447 version="2.80">
7452275448 <doc xml:space="preserve"
7452375449 filename="glib/gmessages.c"
74524- line="2260">Format a structured log message and send it to the syslog daemon. Only fields
75450+ line="2345">Format a structured log message and send it to the syslog daemon. Only fields
7452575451 which are understood by this function are included in the formatted string
7452675452 which is printed.
7452775453
@@ -74533,25 +75459,25 @@ This is suitable for use as a [type@GLib.LogWriterFunc].
7453375459
7453475460 If syslog is not supported, this function is still defined, but will always
7453575461 return [enum@GLib.LogWriterOutput.UNHANDLED].</doc>
74536- <source-position filename="glib/gmessages.h" line="233"/>
75462+ <source-position filename="glib/gmessages.h" line="236"/>
7453775463 <return-value transfer-ownership="none">
7453875464 <doc xml:space="preserve"
7453975465 filename="glib/gmessages.c"
74540- line="2282">[enum@GLib.LogWriterOutput.HANDLED] on success, [enum@GLib.LogWriterOutput.UNHANDLED] otherwise</doc>
75466+ line="2367">[enum@GLib.LogWriterOutput.HANDLED] on success, [enum@GLib.LogWriterOutput.UNHANDLED] otherwise</doc>
7454175467 <type name="LogWriterOutput" c:type="GLogWriterOutput"/>
7454275468 </return-value>
7454375469 <parameters>
7454475470 <parameter name="log_level" transfer-ownership="none">
7454575471 <doc xml:space="preserve"
7454675472 filename="glib/gmessages.c"
74547- line="2262">log level, either from [type@GLib.LogLevelFlags], or a user-defined
75473+ line="2347">log level, either from [type@GLib.LogLevelFlags], or a user-defined
7454875474 level</doc>
7454975475 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
7455075476 </parameter>
7455175477 <parameter name="fields" transfer-ownership="none">
7455275478 <doc xml:space="preserve"
7455375479 filename="glib/gmessages.c"
74554- line="2264">key–value pairs of structured data forming
75480+ line="2349">key–value pairs of structured data forming
7455575481 the log message</doc>
7455675482 <array length="2" zero-terminated="0" c:type="const GLogField*">
7455775483 <type name="LogField" c:type="GLogField"/>
@@ -74560,7 +75486,7 @@ return [enum@GLib.LogWriterOutput.UNHANDLED].</doc>
7456075486 <parameter name="n_fields" transfer-ownership="none">
7456175487 <doc xml:space="preserve"
7456275488 filename="glib/gmessages.c"
74563- line="2266">number of elements in the @fields array</doc>
75489+ line="2351">number of elements in the @fields array</doc>
7456475490 <type name="gsize" c:type="gsize"/>
7456575491 </parameter>
7456675492 <parameter name="user_data"
@@ -74569,7 +75495,7 @@ return [enum@GLib.LogWriterOutput.UNHANDLED].</doc>
7456975495 allow-none="1">
7457075496 <doc xml:space="preserve"
7457175497 filename="glib/gmessages.c"
74572- line="2267">user data passed to [func@GLib.log_set_writer_func]</doc>
75498+ line="2352">user data passed to [func@GLib.log_set_writer_func]</doc>
7457375499 <type name="gpointer" c:type="gpointer"/>
7457475500 </parameter>
7457575501 </parameters>
@@ -74577,7 +75503,7 @@ return [enum@GLib.LogWriterOutput.UNHANDLED].</doc>
7457775503 <function name="logv" c:identifier="g_logv" introspectable="0">
7457875504 <doc xml:space="preserve"
7457975505 filename="glib/gmessages.c"
74580- line="1135">Logs an error or debugging message.
75506+ line="1139">Logs an error or debugging message.
7458175507
7458275508 If the log level has been set as fatal, [func@GLib.BREAKPOINT] is called
7458375509 to terminate the program. See the documentation for [func@GLib.BREAKPOINT] for
@@ -74603,26 +75529,26 @@ application domain.</doc>
7460375529 allow-none="1">
7460475530 <doc xml:space="preserve"
7460575531 filename="glib/gmessages.c"
74606- line="1137">the log domain
75532+ line="1141">the log domain
7460775533 application domain</doc>
7460875534 <type name="utf8" c:type="const gchar*"/>
7460975535 </parameter>
7461075536 <parameter name="log_level" transfer-ownership="none">
7461175537 <doc xml:space="preserve"
7461275538 filename="glib/gmessages.c"
74613- line="1139">the log level</doc>
75539+ line="1143">the log level</doc>
7461475540 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
7461575541 </parameter>
7461675542 <parameter name="format" transfer-ownership="none">
7461775543 <doc xml:space="preserve"
7461875544 filename="glib/gmessages.c"
74619- line="1140">the message format. See the `printf()` documentation</doc>
75545+ line="1144">the message format. See the `printf()` documentation</doc>
7462075546 <type name="utf8" c:type="const gchar*"/>
7462175547 </parameter>
7462275548 <parameter name="args" transfer-ownership="none">
7462375549 <doc xml:space="preserve"
7462475550 filename="glib/gmessages.c"
74625- line="1141">the parameters to insert into the format string</doc>
75551+ line="1145">the parameters to insert into the format string</doc>
7462675552 <type name="va_list" c:type="va_list"/>
7462775553 </parameter>
7462875554 </parameters>
@@ -74630,7 +75556,7 @@ application domain.</doc>
7463075556 <function name="lstat" c:identifier="g_lstat" version="2.6">
7463175557 <doc xml:space="preserve"
7463275558 filename="glib/gstdio.c"
74633- line="1351">A wrapper for the POSIX lstat() function. The lstat() function is
75559+ line="1362">A wrapper for the POSIX lstat() function. The lstat() function is
7463475560 like stat() except that in the case of symbolic links, it returns
7463575561 information about the symbolic link itself and not the file that it
7463675562 refers to. If the system does not support symbolic links g_lstat()
@@ -74641,7 +75567,7 @@ See your C library manual for more details about lstat().</doc>
7464175567 <return-value transfer-ownership="none">
7464275568 <doc xml:space="preserve"
7464375569 filename="glib/gstdio.c"
74644- line="1366">0 if the information was successfully retrieved,
75570+ line="1377">0 if the information was successfully retrieved,
7464575571 -1 if an error occurred</doc>
7464675572 <type name="gint" c:type="int"/>
7464775573 </return-value>
@@ -74649,14 +75575,14 @@ See your C library manual for more details about lstat().</doc>
7464975575 <parameter name="filename" transfer-ownership="none">
7465075576 <doc xml:space="preserve"
7465175577 filename="glib/gstdio.c"
74652- line="1353">a pathname in the GLib file name encoding
75578+ line="1364">a pathname in the GLib file name encoding
7465375579 (UTF-8 on Windows)</doc>
7465475580 <type name="filename" c:type="const gchar*"/>
7465575581 </parameter>
7465675582 <parameter name="buf" transfer-ownership="none">
7465775583 <doc xml:space="preserve"
7465875584 filename="glib/gstdio.c"
74659- line="1355">a pointer to a stat struct, which will be filled with the file
75585+ line="1366">a pointer to a stat struct, which will be filled with the file
7466075586 information</doc>
7466175587 <type name="StatBuf" c:type="GStatBuf*"/>
7466275588 </parameter>
@@ -74721,15 +75647,17 @@ See your C library manual for more details about lstat().</doc>
7472175647 moved-to="MainContext.default">
7472275648 <doc xml:space="preserve"
7472375649 filename="glib/gmain.c"
74724- line="687">Returns the global-default main context. This is the main context
75650+ line="725">Returns the global-default main context.
75651+
75652+This is the main context
7472575653 used for main loop functions when a main loop is not explicitly
74726-specified, and corresponds to the "main" main loop. See also
75654+specified, and corresponds to the ‘main’ main loop. See also
7472775655 [func@GLib.MainContext.get_thread_default].</doc>
74728- <source-position filename="glib/gmain.h" line="497"/>
75656+ <source-position filename="glib/gmain.h" line="498"/>
7472975657 <return-value transfer-ownership="none">
7473075658 <doc xml:space="preserve"
7473175659 filename="glib/gmain.c"
74732- line="695">the global-default main context.</doc>
75660+ line="735">the global-default main context.</doc>
7473375661 <type name="MainContext" c:type="GMainContext*"/>
7473475662 </return-value>
7473575663 </function>
@@ -74739,23 +75667,24 @@ specified, and corresponds to the "main" main loop. See also
7473975667 version="2.22">
7474075668 <doc xml:space="preserve"
7474175669 filename="glib/gmain.c"
74742- line="846">Gets the thread-default #GMainContext for this thread. Asynchronous
74743-operations that want to be able to be run in contexts other than
75670+ line="886">Gets the thread-default main context for this thread.
75671+
75672+Asynchronous operations that want to be able to be run in contexts other than
7474475673 the default one should call this method or
7474575674 [func@GLib.MainContext.ref_thread_default] to get a
7474675675 [struct@GLib.MainContext] to add their [struct@GLib.Source]s to. (Note that
7474775676 even in single-threaded programs applications may sometimes want to
7474875677 temporarily push a non-default context, so it is not safe to assume that
74749-this will always return %NULL if you are running in the default thread.)
75678+this will always return `NULL` if you are running in the default thread.)
7475075679
7475175680 If you need to hold a reference on the context, use
7475275681 [func@GLib.MainContext.ref_thread_default] instead.</doc>
74753- <source-position filename="glib/gmain.h" line="578"/>
75682+ <source-position filename="glib/gmain.h" line="579"/>
7475475683 <return-value transfer-ownership="none" nullable="1">
7475575684 <doc xml:space="preserve"
7475675685 filename="glib/gmain.c"
74757- line="861">the thread-default #GMainContext, or
74758-%NULL if the thread-default context is the global-default main context.</doc>
75686+ line="902">the thread-default main context, or
75687+ `NULL` if the thread-default context is the global-default main context</doc>
7475975688 <type name="MainContext" c:type="GMainContext*"/>
7476075689 </return-value>
7476175690 </function>
@@ -74765,19 +75694,21 @@ If you need to hold a reference on the context, use
7476575694 version="2.32">
7476675695 <doc xml:space="preserve"
7476775696 filename="glib/gmain.c"
74768- line="878">Gets the thread-default [struct@GLib.MainContext] for this thread, as with
74769-[func@GLib.MainContext.get_thread_default], but also adds a reference to
74770-it with [method@GLib.MainContext.ref]. In addition, unlike
75697+ line="918">Gets a reference to the thread-default [struct@GLib.MainContext] for this
75698+thread
75699+
75700+This is the same as [func@GLib.MainContext.get_thread_default], but it also
75701+adds a reference to the returned main context with [method@GLib.MainContext.ref].
75702+In addition, unlike
7477175703 [func@GLib.MainContext.get_thread_default], if the thread-default context
7477275704 is the global-default context, this will return that
7477375705 [struct@GLib.MainContext] (with a ref added to it) rather than returning
74774-%NULL.</doc>
74775- <source-position filename="glib/gmain.h" line="580"/>
75706+`NULL`.</doc>
75707+ <source-position filename="glib/gmain.h" line="581"/>
7477675708 <return-value transfer-ownership="full">
7477775709 <doc xml:space="preserve"
7477875710 filename="glib/gmain.c"
74779- line="889">the thread-default #GMainContext. Unref
74780- with [method@GLib.MainContext.unref] when you are done with it.</doc>
75711+ line="932">the thread-default main context</doc>
7478175712 <type name="MainContext" c:type="GMainContext*"/>
7478275713 </return-value>
7478375714 </function>
@@ -74786,30 +75717,32 @@ is the global-default context, this will return that
7478675717 version="2.12">
7478775718 <doc xml:space="preserve"
7478875719 filename="glib/gmain.c"
74789- line="3156">Returns the currently firing source for this thread.</doc>
74790- <source-position filename="glib/gmain.h" line="569"/>
75720+ line="3322">Returns the currently firing source for this thread.</doc>
75721+ <source-position filename="glib/gmain.h" line="570"/>
7479175722 <return-value transfer-ownership="none" nullable="1">
7479275723 <doc xml:space="preserve"
7479375724 filename="glib/gmain.c"
74794- line="3161">The currently firing source or %NULL.</doc>
75725+ line="3327">the currently firing source, or `NULL`
75726+ if none is firing</doc>
7479575727 <type name="Source" c:type="GSource*"/>
7479675728 </return-value>
7479775729 </function>
7479875730 <function name="main_depth" c:identifier="g_main_depth">
7479975731 <doc xml:space="preserve"
7480075732 filename="glib/gmain.c"
74801- line="3042">Returns the depth of the stack of calls to
75733+ line="3207">Returns the depth of the stack of calls to
7480275734 [method@GLib.MainContext.dispatch] on any #GMainContext in the current thread.
74803-That is, when called from the toplevel, it gives 0. When
75735+
75736+That is, when called from the top level, it gives `0`. When
7480475737 called from within a callback from [method@GLib.MainContext.iteration]
74805-(or [method@GLib.MainLoop.run], etc.) it returns 1. When called from within
75738+(or [method@GLib.MainLoop.run], etc.) it returns `1`. When called from within
7480675739 a callback to a recursive call to [method@GLib.MainContext.iteration],
74807-it returns 2. And so forth.
75740+it returns `2`. And so forth.
7480875741
7480975742 This function is useful in a situation like the following:
74810-Imagine an extremely simple "garbage collected" system.
75743+Imagine an extremely simple ‘garbage collected’ system.
7481175744
74812-|[&lt;!-- language="C" --&gt;
75745+```c
7481375746 static GList *free_list;
7481475747
7481575748 gpointer
@@ -74837,16 +75770,16 @@ while (TRUE);
7483775770 g_main_context_iteration (NULL, TRUE);
7483875771 free_allocated_memory();
7483975772 }
74840-]|
75773+```
7484175774
7484275775 This works from an application, however, if you want to do the same
7484375776 thing from a library, it gets more difficult, since you no longer
7484475777 control the main loop. You might think you can simply use an idle
74845-function to make the call to free_allocated_memory(), but that
74846-doesn't work, since the idle function could be called from a
75778+function to make the call to `free_allocated_memory()`, but that
75779+doesn’t work, since the idle function could be called from a
7484775780 recursive callback. This can be fixed by using [func@GLib.main_depth]
7484875781
74849-|[&lt;!-- language="C" --&gt;
75782+```c
7485075783 gpointer
7485175784 allocate_memory (gsize size)
7485275785 {
@@ -74877,33 +75810,33 @@ free_allocated_memory (void)
7487775810 l = next;
7487875811 }
7487975812 }
74880-]|
75813+```
7488175814
7488275815 There is a temptation to use [func@GLib.main_depth] to solve
7488375816 problems with reentrancy. For instance, while waiting for data
7488475817 to be received from the network in response to a menu item,
7488575818 the menu item might be selected again. It might seem that
74886-one could make the menu item's callback return immediately
75819+one could make the menu item’s callback return immediately
7488775820 and do nothing if [func@GLib.main_depth] returns a value greater than 1.
7488875821 However, this should be avoided since the user then sees selecting
74889-the menu item do nothing. Furthermore, you'll find yourself adding
75822+the menu item do nothing. Furthermore, you’ll find yourself adding
7489075823 these checks all over your code, since there are doubtless many,
7489175824 many things that the user could do. Instead, you can use the
7489275825 following techniques:
7489375826
74894-1. Use gtk_widget_set_sensitive() or modal dialogs to prevent
75827+1. Use `gtk_widget_set_sensitive()` or modal dialogs to prevent
7489575828 the user from interacting with elements while the main
7489675829 loop is recursing.
7489775830
74898-2. Avoid main loop recursion in situations where you can't handle
75831+2. Avoid main loop recursion in situations where you can’t handle
7489975832 arbitrary callbacks. Instead, structure your code so that you
7490075833 simply return to the main loop and then get called again when
7490175834 there is more work to do.</doc>
74902- <source-position filename="glib/gmain.h" line="567"/>
75835+ <source-position filename="glib/gmain.h" line="568"/>
7490375836 <return-value transfer-ownership="none">
7490475837 <doc xml:space="preserve"
7490575838 filename="glib/gmain.c"
74906- line="3147">The main loop recursion level in the current thread</doc>
75839+ line="3313">the main loop recursion level in the current thread</doc>
7490775840 <type name="gint" c:type="gint"/>
7490875841 </return-value>
7490975842 </function>
@@ -75198,7 +76131,7 @@ attributes (of type %G_MARKUP_ERROR_INVALID_CONTENT) as well
7519876131 as parse errors for boolean-valued attributes (again of type
7519976132 %G_MARKUP_ERROR_INVALID_CONTENT). In all of these cases %FALSE
7520076133 will be returned and @error will be set as appropriate.</doc>
75201- <source-position filename="glib/gmarkup.h" line="255"/>
76134+ <source-position filename="glib/gmarkup.h" line="259"/>
7520276135 <return-value transfer-ownership="none">
7520376136 <doc xml:space="preserve"
7520476137 filename="glib/gmarkup.c"
@@ -75274,7 +76207,7 @@ the range of &amp;#x1; ... &amp;#x1f; for all control sequences
7527476207 except for tabstop, newline and carriage return. The character
7527576208 references in this range are not valid XML 1.0, but they are
7527676209 valid XML 1.1 and will be accepted by the GMarkup parser.</doc>
75277- <source-position filename="glib/gmarkup.h" line="231"/>
76210+ <source-position filename="glib/gmarkup.h" line="235"/>
7527876211 <return-value transfer-ownership="full">
7527976212 <doc xml:space="preserve"
7528076213 filename="glib/gmarkup.c"
@@ -75320,7 +76253,7 @@ output = g_markup_printf_escaped ("&lt;purchase&gt;"
7532076253 "&lt;/purchase&gt;",
7532176254 store, item);
7532276255 ]|</doc>
75323- <source-position filename="glib/gmarkup.h" line="235"/>
76256+ <source-position filename="glib/gmarkup.h" line="239"/>
7532476257 <return-value transfer-ownership="full">
7532576258 <doc xml:space="preserve"
7532676259 filename="glib/gmarkup.c"
@@ -75352,7 +76285,7 @@ output = g_markup_printf_escaped ("&lt;purchase&gt;"
7535276285 line="2399">Formats the data in @args according to @format, escaping
7535376286 all string and character arguments in the fashion
7535476287 of g_markup_escape_text(). See g_markup_printf_escaped().</doc>
75355- <source-position filename="glib/gmarkup.h" line="238"/>
76288+ <source-position filename="glib/gmarkup.h" line="242"/>
7535676289 <return-value transfer-ownership="full">
7535776290 <doc xml:space="preserve"
7535876291 filename="glib/gmarkup.c"
@@ -75377,7 +76310,9 @@ of g_markup_escape_text(). See g_markup_printf_escaped().</doc>
7537776310 </function>
7537876311 <function-macro name="mem_chunk_create"
7537976312 c:identifier="g_mem_chunk_create"
75380- introspectable="0">
76313+ introspectable="0"
76314+ deprecated="1"
76315+ deprecated-version="2.10">
7538176316 <source-position filename="glib/deprecated/gallocator.h" line="39"/>
7538276317 <parameters>
7538376318 <parameter name="type">
@@ -75390,7 +76325,9 @@ of g_markup_escape_text(). See g_markup_printf_escaped().</doc>
7539076325 </function-macro>
7539176326 <function name="mem_chunk_info"
7539276327 c:identifier="g_mem_chunk_info"
75393- moved-to="MemChunk.info">
76328+ moved-to="MemChunk.info"
76329+ deprecated="1"
76330+ deprecated-version="2.10">
7539476331 <source-position filename="glib/deprecated/gallocator.h" line="63"/>
7539576332 <return-value transfer-ownership="none">
7539676333 <type name="none" c:type="void"/>
@@ -75558,7 +76495,7 @@ The source and destination areas may overlap.</doc>
7555876495 <function-macro name="message" c:identifier="g_message" introspectable="0">
7555976496 <doc xml:space="preserve"
7556076497 filename="glib/gmessages.c"
75561- line="181">A convenience function/macro to log a normal message.
76498+ line="180">A convenience function/macro to log a normal message.
7556276499
7556376500 If [func@GLib.log_default_handler] is used as the log handler function, a new-line
7556476501 character will automatically be appended to @..., and need not be entered
@@ -75567,12 +76504,12 @@ manually.
7556776504 If structured logging is enabled, this will use [func@GLib.log_structured];
7556876505 otherwise it will use [func@GLib.log]. See
7556976506 [Using Structured Logging](logging.html#using-structured-logging).</doc>
75570- <source-position filename="glib/gmessages.h" line="331"/>
76507+ <source-position filename="glib/gmessages.h" line="334"/>
7557176508 <parameters>
7557276509 <parameter name="...">
7557376510 <doc xml:space="preserve"
7557476511 filename="glib/gmessages.c"
75575- line="183">format string, followed by parameters to insert into the format string
76512+ line="182">format string, followed by parameters to insert into the format string
7557676513 (as with `printf()`)</doc>
7557776514 </parameter>
7557876515 </parameters>
@@ -75580,7 +76517,7 @@ otherwise it will use [func@GLib.log]. See
7558076517 <function name="mkdir" c:identifier="g_mkdir" version="2.6">
7558176518 <doc xml:space="preserve"
7558276519 filename="glib/gstdio.c"
75583- line="1200">A wrapper for the POSIX mkdir() function. The mkdir() function
76520+ line="1211">A wrapper for the POSIX mkdir() function. The mkdir() function
7558476521 attempts to create a directory with the given name and permissions.
7558576522 The mode argument is ignored on Windows.
7558676523
@@ -75589,7 +76526,7 @@ See your C library manual for more details about mkdir().</doc>
7558976526 <return-value transfer-ownership="none">
7559076527 <doc xml:space="preserve"
7559176528 filename="glib/gstdio.c"
75592- line="1212">0 if the directory was successfully created, -1 if an error
76529+ line="1223">0 if the directory was successfully created, -1 if an error
7559376530 occurred</doc>
7559476531 <type name="gint" c:type="int"/>
7559576532 </return-value>
@@ -75597,14 +76534,14 @@ See your C library manual for more details about mkdir().</doc>
7559776534 <parameter name="filename" transfer-ownership="none">
7559876535 <doc xml:space="preserve"
7559976536 filename="glib/gstdio.c"
75600- line="1202">a pathname in the GLib file name encoding
76537+ line="1213">a pathname in the GLib file name encoding
7560176538 (UTF-8 on Windows)</doc>
7560276539 <type name="filename" c:type="const gchar*"/>
7560376540 </parameter>
7560476541 <parameter name="mode" transfer-ownership="none">
7560576542 <doc xml:space="preserve"
7560676543 filename="glib/gstdio.c"
75607- line="1204">permissions to use for the newly created directory</doc>
76544+ line="1215">permissions to use for the newly created directory</doc>
7560876545 <type name="gint" c:type="int"/>
7560976546 </parameter>
7561076547 </parameters>
@@ -75645,7 +76582,7 @@ created. Returns -1 if an error occurred, with errno set.</doc>
7564576582 introspectable="0">
7564676583 <doc xml:space="preserve"
7564776584 filename="glib/gfileutils.c"
75648- line="1633">Creates a temporary directory in the current directory.
76585+ line="1654">Creates a temporary directory in the current directory.
7564976586
7565076587 See the [`mkdtemp()`](man:mkdtemp(3)) documentation on most UNIX-like systems.
7565176588
@@ -75665,7 +76602,7 @@ g_dir_make_tmp() instead.</doc>
7566576602 <return-value transfer-ownership="full" nullable="1">
7566676603 <doc xml:space="preserve"
7566776604 filename="glib/gfileutils.c"
75668- line="1654">A pointer to @tmpl, which has been
76605+ line="1675">A pointer to @tmpl, which has been
7566976606 modified to hold the directory name. In case of errors, %NULL is
7567076607 returned and %errno will be set.</doc>
7567176608 <type name="filename" c:type="gchar*"/>
@@ -75674,7 +76611,7 @@ g_dir_make_tmp() instead.</doc>
7567476611 <parameter name="tmpl" transfer-ownership="none">
7567576612 <doc xml:space="preserve"
7567676613 filename="glib/gfileutils.c"
75677- line="1635">template directory name</doc>
76614+ line="1656">template directory name</doc>
7567876615 <type name="filename" c:type="gchar*"/>
7567976616 </parameter>
7568076617 </parameters>
@@ -75685,7 +76622,7 @@ g_dir_make_tmp() instead.</doc>
7568576622 introspectable="0">
7568676623 <doc xml:space="preserve"
7568776624 filename="glib/gfileutils.c"
75688- line="1595">Creates a temporary directory in the current directory.
76625+ line="1616">Creates a temporary directory in the current directory.
7568976626
7569076627 See the [`mkdtemp()`](man:mkdtemp(3)) documentation on most UNIX-like systems.
7569176628
@@ -75705,7 +76642,7 @@ g_dir_make_tmp() instead.</doc>
7570576642 <return-value transfer-ownership="full" nullable="1">
7570676643 <doc xml:space="preserve"
7570776644 filename="glib/gfileutils.c"
75708- line="1617">A pointer to @tmpl, which has been
76645+ line="1638">A pointer to @tmpl, which has been
7570976646 modified to hold the directory name. In case of errors, %NULL is
7571076647 returned, and %errno will be set.</doc>
7571176648 <type name="filename" c:type="gchar*"/>
@@ -75714,13 +76651,13 @@ g_dir_make_tmp() instead.</doc>
7571476651 <parameter name="tmpl" transfer-ownership="none">
7571576652 <doc xml:space="preserve"
7571676653 filename="glib/gfileutils.c"
75717- line="1597">template directory name</doc>
76654+ line="1618">template directory name</doc>
7571876655 <type name="filename" c:type="gchar*"/>
7571976656 </parameter>
7572076657 <parameter name="mode" transfer-ownership="none">
7572176658 <doc xml:space="preserve"
7572276659 filename="glib/gfileutils.c"
75723- line="1598">permissions to create the temporary directory with</doc>
76660+ line="1619">permissions to create the temporary directory with</doc>
7572476661 <type name="gint" c:type="gint"/>
7572576662 </parameter>
7572676663 </parameters>
@@ -75728,7 +76665,7 @@ g_dir_make_tmp() instead.</doc>
7572876665 <function name="mkstemp" c:identifier="g_mkstemp" introspectable="0">
7572976666 <doc xml:space="preserve"
7573076667 filename="glib/gfileutils.c"
75731- line="1703">Opens a temporary file in the current directory.
76668+ line="1724">Opens a temporary file in the current directory.
7573276669
7573376670 See the [`mkstemp()`](man:mkstemp(3)) documentation on most UNIX-like systems.
7573476671
@@ -75743,7 +76680,7 @@ Most importantly, on Windows it should be in UTF-8.</doc>
7574376680 <return-value transfer-ownership="none">
7574476681 <doc xml:space="preserve"
7574576682 filename="glib/gfileutils.c"
75746- line="1719">A file handle (as from open()) to the file
76683+ line="1740">A file handle (as from open()) to the file
7574776684 opened for reading and writing. The file is opened in binary
7574876685 mode on platforms where there is a difference. The file handle
7574976686 should be closed with close(). In case of errors, -1 is
@@ -75754,7 +76691,7 @@ Most importantly, on Windows it should be in UTF-8.</doc>
7575476691 <parameter name="tmpl" transfer-ownership="none">
7575576692 <doc xml:space="preserve"
7575676693 filename="glib/gfileutils.c"
75757- line="1705">template filename</doc>
76694+ line="1726">template filename</doc>
7575876695 <type name="filename" c:type="gchar*"/>
7575976696 </parameter>
7576076697 </parameters>
@@ -75765,7 +76702,7 @@ Most importantly, on Windows it should be in UTF-8.</doc>
7576576702 introspectable="0">
7576676703 <doc xml:space="preserve"
7576776704 filename="glib/gfileutils.c"
75768- line="1666">Opens a temporary file in the current directory.
76705+ line="1687">Opens a temporary file in the current directory.
7576976706
7577076707 See the [`mkstemp()`](man:mkstemp(3)) documentation on most UNIX-like systems.
7577176708
@@ -75781,7 +76718,7 @@ on Windows it should be in UTF-8.</doc>
7578176718 <return-value transfer-ownership="none">
7578276719 <doc xml:space="preserve"
7578376720 filename="glib/gfileutils.c"
75784- line="1686">A file handle (as from open()) to the file
76721+ line="1707">A file handle (as from open()) to the file
7578576722 opened for reading and writing. The file handle should be
7578676723 closed with close(). In case of errors, -1 is returned
7578776724 and %errno will be set.</doc>
@@ -75791,20 +76728,20 @@ on Windows it should be in UTF-8.</doc>
7579176728 <parameter name="tmpl" transfer-ownership="none">
7579276729 <doc xml:space="preserve"
7579376730 filename="glib/gfileutils.c"
75794- line="1668">template filename</doc>
76731+ line="1689">template filename</doc>
7579576732 <type name="filename" c:type="gchar*"/>
7579676733 </parameter>
7579776734 <parameter name="flags" transfer-ownership="none">
7579876735 <doc xml:space="preserve"
7579976736 filename="glib/gfileutils.c"
75800- line="1669">flags to pass to an open() call in addition to O_EXCL
76737+ line="1690">flags to pass to an open() call in addition to O_EXCL
7580176738 and O_CREAT, which are passed automatically</doc>
7580276739 <type name="gint" c:type="gint"/>
7580376740 </parameter>
7580476741 <parameter name="mode" transfer-ownership="none">
7580576742 <doc xml:space="preserve"
7580676743 filename="glib/gfileutils.c"
75807- line="1671">permissions to create the temporary file with</doc>
76744+ line="1692">permissions to create the temporary file with</doc>
7580876745 <type name="gint" c:type="gint"/>
7580976746 </parameter>
7581076747 </parameters>
@@ -76071,7 +77008,9 @@ vulnerability.</doc>
7607177008 </function-macro>
7607277009 <function name="node_pop_allocator"
7607377010 c:identifier="g_node_pop_allocator"
76074- moved-to="Node.pop_allocator">
77011+ moved-to="Node.pop_allocator"
77012+ deprecated="1"
77013+ deprecated-version="2.10">
7607577014 <source-position filename="glib/deprecated/gallocator.h" line="84"/>
7607677015 <return-value transfer-ownership="none">
7607777016 <type name="none" c:type="void"/>
@@ -76114,7 +77053,9 @@ vulnerability.</doc>
7611477053 </function-macro>
7611577054 <function name="node_push_allocator"
7611677055 c:identifier="g_node_push_allocator"
76117- moved-to="Node.push_allocator">
77056+ moved-to="Node.push_allocator"
77057+ deprecated="1"
77058+ deprecated-version="2.10">
7611877059 <source-position filename="glib/deprecated/gallocator.h" line="82"/>
7611977060 <return-value transfer-ownership="none">
7612077061 <type name="none" c:type="void"/>
@@ -76154,7 +77095,7 @@ vulnerability.</doc>
7615477095 <function name="nullify_pointer" c:identifier="g_nullify_pointer">
7615577096 <doc xml:space="preserve"
7615677097 filename="glib/gutils.c"
76157- line="2855">Set the pointer at the specified location to %NULL.</doc>
77098+ line="2857">Set the pointer at the specified location to %NULL.</doc>
7615877099 <source-position filename="glib/gutils.h" line="292"/>
7615977100 <return-value transfer-ownership="none">
7616077101 <type name="none" c:type="void"/>
@@ -76163,7 +77104,7 @@ vulnerability.</doc>
7616377104 <parameter name="nullify_location" transfer-ownership="none">
7616477105 <doc xml:space="preserve"
7616577106 filename="glib/gutils.c"
76166- line="2857">the memory address of the pointer.</doc>
77107+ line="2859">the memory address of the pointer.</doc>
7616777108 <type name="gpointer" c:type="gpointer*"/>
7616877109 </parameter>
7616977110 </parameters>
@@ -76221,7 +77162,7 @@ If "[P]roceed" is selected, the function returns.
7622177162 This function may cause different actions on non-UNIX platforms.
7622277163
7622377164 On Windows consider using the `G_DEBUGGER` environment
76224-variable (see [Running GLib Applications](glib-running.html)) and
77165+variable (see [Running GLib Applications](running.html)) and
7622577166 calling g_on_error_stack_trace() instead.</doc>
7622677167 <source-position filename="glib/gbacktrace.h" line="43"/>
7622777168 <return-value transfer-ownership="none">
@@ -76255,7 +77196,7 @@ When running on Windows, this function is *not* called by
7625577196 g_on_error_query(). If called directly, it will raise an
7625677197 exception, which will crash the program. If the `G_DEBUGGER` environment
7625777198 variable is set, a debugger will be invoked to attach and
76258-handle that exception (see [Running GLib Applications](glib-running.html)).</doc>
77199+handle that exception (see [Running GLib Applications](running.html)).</doc>
7625977200 <source-position filename="glib/gbacktrace.h" line="45"/>
7626077201 <return-value transfer-ownership="none">
7626177202 <type name="none" c:type="void"/>
@@ -76505,7 +77446,7 @@ can be used to initialize pointers (or #guintptr) instead of #gsize.</doc>
7650577446 <function name="open" c:identifier="g_open" version="2.6">
7650677447 <doc xml:space="preserve"
7650777448 filename="glib/gstdio.c"
76508- line="1017">A wrapper for the POSIX open() function. The open() function is
77449+ line="1028">A wrapper for the POSIX open() function. The open() function is
7650977450 used to convert a pathname into a file descriptor.
7651077451
7651177452 On POSIX systems file descriptors are implemented by the operating
@@ -76527,7 +77468,7 @@ See your C library manual for more details about open().</doc>
7652777468 <return-value transfer-ownership="none">
7652877469 <doc xml:space="preserve"
7652977470 filename="glib/gstdio.c"
76530- line="1043">a new file descriptor, or -1 if an error occurred.
77471+ line="1054">a new file descriptor, or -1 if an error occurred.
7653177472 The return value can be used exactly like the return value
7653277473 from open().</doc>
7653377474 <type name="gint" c:type="int"/>
@@ -76536,20 +77477,20 @@ See your C library manual for more details about open().</doc>
7653677477 <parameter name="filename" transfer-ownership="none">
7653777478 <doc xml:space="preserve"
7653877479 filename="glib/gstdio.c"
76539- line="1019">a pathname in the GLib file name encoding
77480+ line="1030">a pathname in the GLib file name encoding
7654077481 (UTF-8 on Windows)</doc>
7654177482 <type name="filename" c:type="const gchar*"/>
7654277483 </parameter>
7654377484 <parameter name="flags" transfer-ownership="none">
7654477485 <doc xml:space="preserve"
7654577486 filename="glib/gstdio.c"
76546- line="1021">as in open()</doc>
77487+ line="1032">as in open()</doc>
7654777488 <type name="gint" c:type="int"/>
7654877489 </parameter>
7654977490 <parameter name="mode" transfer-ownership="none">
7655077491 <doc xml:space="preserve"
7655177492 filename="glib/gstdio.c"
76552- line="1022">as in open()</doc>
77493+ line="1033">as in open()</doc>
7655377494 <type name="gint" c:type="int"/>
7655477495 </parameter>
7655577496 </parameters>
@@ -76618,7 +77559,7 @@ commas, or %NULL.</doc>
7661877559 line="555">Compares two path buffers for equality and returns `TRUE`
7661977560 if they are equal.
7662077561
76621-The path inside the paths buffers are not going to be normalized,
77562+The paths inside the path buffers are not going to be normalized,
7662277563 so `X/Y/Z/A/..`, `X/./Y/Z` and `X/Y/Z` are not going to be considered
7662377564 equal.
7662477565
@@ -76650,7 +77591,7 @@ This function can be passed to g_hash_table_new() as the
7665077591 <function name="path_get_basename" c:identifier="g_path_get_basename">
7665177592 <doc xml:space="preserve"
7665277593 filename="glib/gfileutils.c"
76653- line="2584">Gets the last component of the filename.
77594+ line="2605">Gets the last component of the filename.
7665477595
7665577596 If @file_name ends with a directory separator it gets the component
7665677597 before the last slash. If @file_name consists only of directory
@@ -76660,7 +77601,7 @@ separator is returned. If @file_name is empty, it gets ".".</doc>
7666077601 <return-value transfer-ownership="full">
7666177602 <doc xml:space="preserve"
7666277603 filename="glib/gfileutils.c"
76663- line="2595">a newly allocated string
77604+ line="2616">a newly allocated string
7666477605 containing the last component of the filename</doc>
7666577606 <type name="filename" c:type="gchar*"/>
7666677607 </return-value>
@@ -76668,7 +77609,7 @@ separator is returned. If @file_name is empty, it gets ".".</doc>
7666877609 <parameter name="file_name" transfer-ownership="none">
7666977610 <doc xml:space="preserve"
7667077611 filename="glib/gfileutils.c"
76671- line="2586">the name of the file</doc>
77612+ line="2607">the name of the file</doc>
7667277613 <type name="filename" c:type="const gchar*"/>
7667377614 </parameter>
7667477615 </parameters>
@@ -76676,7 +77617,7 @@ separator is returned. If @file_name is empty, it gets ".".</doc>
7667677617 <function name="path_get_dirname" c:identifier="g_path_get_dirname">
7667777618 <doc xml:space="preserve"
7667877619 filename="glib/gfileutils.c"
76679- line="2661">Gets the directory components of a file name. For example, the directory
77620+ line="2682">Gets the directory components of a file name. For example, the directory
7668077621 component of `/usr/bin/test` is `/usr/bin`. The directory component of `/`
7668177622 is `/`.
7668277623
@@ -76686,14 +77627,14 @@ The returned string should be freed when no longer needed.</doc>
7668677627 <return-value transfer-ownership="full">
7668777628 <doc xml:space="preserve"
7668877629 filename="glib/gfileutils.c"
76689- line="2672">the directory components of the file</doc>
77630+ line="2693">the directory components of the file</doc>
7669077631 <type name="filename" c:type="gchar*"/>
7669177632 </return-value>
7669277633 <parameters>
7669377634 <parameter name="file_name" transfer-ownership="none">
7669477635 <doc xml:space="preserve"
7669577636 filename="glib/gfileutils.c"
76696- line="2663">the name of the file</doc>
77637+ line="2684">the name of the file</doc>
7669777638 <type name="filename" c:type="const gchar*"/>
7669877639 </parameter>
7669977640 </parameters>
@@ -76701,7 +77642,7 @@ The returned string should be freed when no longer needed.</doc>
7670177642 <function name="path_is_absolute" c:identifier="g_path_is_absolute">
7670277643 <doc xml:space="preserve"
7670377644 filename="glib/gfileutils.c"
76704- line="2419">Returns %TRUE if the given @file_name is an absolute file name.
77645+ line="2440">Returns %TRUE if the given @file_name is an absolute file name.
7670577646 Note that this is a somewhat vague concept on Windows.
7670677647
7670777648 On POSIX systems, an absolute file name is well-defined. It always
@@ -76729,14 +77670,14 @@ Windows-specific code.</doc>
7672977670 <return-value transfer-ownership="none">
7673077671 <doc xml:space="preserve"
7673177672 filename="glib/gfileutils.c"
76732- line="2448">%TRUE if @file_name is absolute</doc>
77673+ line="2469">%TRUE if @file_name is absolute</doc>
7673377674 <type name="gboolean" c:type="gboolean"/>
7673477675 </return-value>
7673577676 <parameters>
7673677677 <parameter name="file_name" transfer-ownership="none">
7673777678 <doc xml:space="preserve"
7673877679 filename="glib/gfileutils.c"
76739- line="2421">a file name</doc>
77680+ line="2442">a file name</doc>
7674077681 <type name="filename" c:type="const gchar*"/>
7674177682 </parameter>
7674277683 </parameters>
@@ -76744,14 +77685,14 @@ Windows-specific code.</doc>
7674477685 <function name="path_skip_root" c:identifier="g_path_skip_root">
7674577686 <doc xml:space="preserve"
7674677687 filename="glib/gfileutils.c"
76747- line="2468">Returns a pointer into @file_name after the root component,
77688+ line="2489">Returns a pointer into @file_name after the root component,
7674877689 i.e. after the "/" in UNIX or "C:\" under Windows. If @file_name
7674977690 is not an absolute path it returns %NULL.</doc>
7675077691 <source-position filename="glib/gfileutils.h" line="204"/>
7675177692 <return-value transfer-ownership="none" nullable="1">
7675277693 <doc xml:space="preserve"
7675377694 filename="glib/gfileutils.c"
76754- line="2476">a pointer into @file_name after the
77695+ line="2497">a pointer into @file_name after the
7675577696 root component</doc>
7675677697 <type name="filename" c:type="const gchar*"/>
7675777698 </return-value>
@@ -76759,7 +77700,7 @@ is not an absolute path it returns %NULL.</doc>
7675977700 <parameter name="file_name" transfer-ownership="none">
7676077701 <doc xml:space="preserve"
7676177702 filename="glib/gfileutils.c"
76762- line="2470">a file name</doc>
77703+ line="2491">a file name</doc>
7676377704 <type name="filename" c:type="const gchar*"/>
7676477705 </parameter>
7676577706 </parameters>
@@ -76833,7 +77774,7 @@ does not contain any multibyte characters. GLib offers the
7683377774 c:identifier="g_pattern_match_simple">
7683477775 <doc xml:space="preserve"
7683577776 filename="glib/gpattern.c"
76836- line="502">Matches a string against a pattern given as a string.
77777+ line="512">Matches a string against a pattern given as a string.
7683777778
7683877779 If this
7683977780 function is to be called in a loop, it’s more efficient to compile
@@ -76843,20 +77784,20 @@ the pattern once with [ctor@GLib.PatternSpec.new] and call
7684377784 <return-value transfer-ownership="none">
7684477785 <doc xml:space="preserve"
7684577786 filename="glib/gpattern.c"
76846- line="514">%TRUE if @string matches @pspec</doc>
77787+ line="524">%TRUE if @string matches @pspec</doc>
7684777788 <type name="gboolean" c:type="gboolean"/>
7684877789 </return-value>
7684977790 <parameters>
7685077791 <parameter name="pattern" transfer-ownership="none">
7685177792 <doc xml:space="preserve"
7685277793 filename="glib/gpattern.c"
76853- line="504">the UTF-8 encoded pattern</doc>
77794+ line="514">the UTF-8 encoded pattern</doc>
7685477795 <type name="utf8" c:type="const gchar*"/>
7685577796 </parameter>
7685677797 <parameter name="string" transfer-ownership="none">
7685777798 <doc xml:space="preserve"
7685877799 filename="glib/gpattern.c"
76859- line="505">the UTF-8 encoded string to match</doc>
77800+ line="515">the UTF-8 encoded string to match</doc>
7686077801 <type name="utf8" c:type="const gchar*"/>
7686177802 </parameter>
7686277803 </parameters>
@@ -76868,7 +77809,7 @@ the pattern once with [ctor@GLib.PatternSpec.new] and call
7686877809 deprecated-version="2.70">
7686977810 <doc xml:space="preserve"
7687077811 filename="glib/gpattern.c"
76871- line="481">Matches a string against a compiled pattern.
77812+ line="491">Matches a string against a compiled pattern.
7687277813
7687377814 If the string is to be
7687477815 matched against more than one pattern, consider using
@@ -76878,20 +77819,20 @@ matched against more than one pattern, consider using
7687877819 <return-value transfer-ownership="none">
7687977820 <doc xml:space="preserve"
7688077821 filename="glib/gpattern.c"
76881- line="492">%TRUE if @string matches @pspec</doc>
77822+ line="502">%TRUE if @string matches @pspec</doc>
7688277823 <type name="gboolean" c:type="gboolean"/>
7688377824 </return-value>
7688477825 <parameters>
7688577826 <parameter name="pspec" transfer-ownership="none">
7688677827 <doc xml:space="preserve"
7688777828 filename="glib/gpattern.c"
76888- line="483">a #GPatternSpec</doc>
77829+ line="493">a #GPatternSpec</doc>
7688977830 <type name="PatternSpec" c:type="GPatternSpec*"/>
7689077831 </parameter>
7689177832 <parameter name="string" transfer-ownership="none">
7689277833 <doc xml:space="preserve"
7689377834 filename="glib/gpattern.c"
76894- line="484">the UTF-8 encoded string to match</doc>
77835+ line="494">the UTF-8 encoded string to match</doc>
7689577836 <type name="utf8" c:type="const gchar*"/>
7689677837 </parameter>
7689777838 </parameters>
@@ -76901,7 +77842,7 @@ matched against more than one pattern, consider using
7690177842 version="2.30">
7690277843 <doc xml:space="preserve"
7690377844 filename="glib/gbitlock.c"
76904- line="495">This is equivalent to g_bit_lock, but working on pointers (or other
77845+ line="584">This is equivalent to g_bit_lock, but working on pointers (or other
7690577846 pointer-sized values).
7690677847
7690777848 For portability reasons, you may only lock on the bottom 32 bits of
@@ -76909,7 +77850,7 @@ the pointer.
7690977850
7691077851 While @address has a `volatile` qualifier, this is a historical
7691177852 artifact and the argument passed to it should not be `volatile`.</doc>
76912- <source-position filename="glib/gbitlock.h" line="45"/>
77853+ <source-position filename="glib/gbitlock.h" line="56"/>
7691377854 <return-value transfer-ownership="none">
7691477855 <type name="none" c:type="void"/>
7691577856 </return-value>
@@ -76917,13 +77858,13 @@ artifact and the argument passed to it should not be `volatile`.</doc>
7691777858 <parameter name="address" transfer-ownership="none">
7691877859 <doc xml:space="preserve"
7691977860 filename="glib/gbitlock.c"
76920- line="497">a pointer to a #gpointer-sized value</doc>
77861+ line="586">a pointer to a #gpointer-sized value</doc>
7692177862 <type name="gpointer" c:type="void*"/>
7692277863 </parameter>
7692377864 <parameter name="lock_bit" transfer-ownership="none">
7692477865 <doc xml:space="preserve"
7692577866 filename="glib/gbitlock.c"
76926- line="498">a bit value between 0 and 31</doc>
77867+ line="587">a bit value between 0 and 31</doc>
7692777868 <type name="gint" c:type="gint"/>
7692877869 </parameter>
7692977870 </parameters>
@@ -76933,12 +77874,12 @@ artifact and the argument passed to it should not be `volatile`.</doc>
7693377874 version="2.80">
7693477875 <doc xml:space="preserve"
7693577876 filename="glib/gbitlock.c"
76936- line="425">This is equivalent to g_bit_lock, but working on pointers (or other
77877+ line="522">This is equivalent to g_bit_lock, but working on pointers (or other
7693777878 pointer-sized values).
7693877879
7693977880 For portability reasons, you may only lock on the bottom 32 bits of
7694077881 the pointer.</doc>
76941- <source-position filename="glib/gbitlock.h" line="49"/>
77882+ <source-position filename="glib/gbitlock.h" line="60"/>
7694277883 <return-value transfer-ownership="none">
7694377884 <type name="none" c:type="void"/>
7694477885 </return-value>
@@ -76946,13 +77887,13 @@ the pointer.</doc>
7694677887 <parameter name="address" transfer-ownership="none">
7694777888 <doc xml:space="preserve"
7694877889 filename="glib/gbitlock.c"
76949- line="427">a pointer to a #gpointer-sized value</doc>
77890+ line="524">a pointer to a #gpointer-sized value</doc>
7695077891 <type name="gpointer" c:type="gpointer"/>
7695177892 </parameter>
7695277893 <parameter name="lock_bit" transfer-ownership="none">
7695377894 <doc xml:space="preserve"
7695477895 filename="glib/gbitlock.c"
76955- line="428">a bit value between 0 and 31</doc>
77896+ line="525">a bit value between 0 and 31</doc>
7695677897 <type name="guint" c:type="guint"/>
7695777898 </parameter>
7695877899 <parameter name="out_ptr"
@@ -76963,7 +77904,7 @@ the pointer.</doc>
7696377904 allow-none="1">
7696477905 <doc xml:space="preserve"
7696577906 filename="glib/gbitlock.c"
76966- line="429">returns the set pointer atomically.
77907+ line="526">returns the set pointer atomically.
7696777908 This is the value after setting the lock, it thus always has the
7696877909 lock bit set, while previously @address had the lockbit unset.
7696977910 You may also use g_pointer_bit_lock_mask_ptr() to clear the lock bit.</doc>
@@ -76976,13 +77917,13 @@ the pointer.</doc>
7697677917 version="2.80">
7697777918 <doc xml:space="preserve"
7697877919 filename="glib/gbitlock.c"
76979- line="619">This mangles @ptr as g_pointer_bit_lock() and g_pointer_bit_unlock()
77920+ line="702">This mangles @ptr as g_pointer_bit_lock() and g_pointer_bit_unlock()
7698077921 do.</doc>
76981- <source-position filename="glib/gbitlock.h" line="61"/>
77922+ <source-position filename="glib/gbitlock.h" line="72"/>
7698277923 <return-value transfer-ownership="none" nullable="1">
7698377924 <doc xml:space="preserve"
7698477925 filename="glib/gbitlock.c"
76985- line="637">the mangled pointer.</doc>
77926+ line="720">the mangled pointer.</doc>
7698677927 <type name="gpointer" c:type="gpointer"/>
7698777928 </return-value>
7698877929 <parameters>
@@ -76992,27 +77933,27 @@ do.</doc>
7699277933 allow-none="1">
7699377934 <doc xml:space="preserve"
7699477935 filename="glib/gbitlock.c"
76995- line="621">the pointer to mask</doc>
77936+ line="704">the pointer to mask</doc>
7699677937 <type name="gpointer" c:type="gpointer"/>
7699777938 </parameter>
7699877939 <parameter name="lock_bit" transfer-ownership="none">
7699977940 <doc xml:space="preserve"
7700077941 filename="glib/gbitlock.c"
77001- line="622">the bit to set/clear. If set to `G_MAXUINT`, the
77942+ line="705">the bit to set/clear. If set to `G_MAXUINT`, the
7700277943 lockbit is taken from @preserve_ptr or @ptr (depending on @preserve_mask).</doc>
7700377944 <type name="guint" c:type="guint"/>
7700477945 </parameter>
7700577946 <parameter name="set" transfer-ownership="none">
7700677947 <doc xml:space="preserve"
7700777948 filename="glib/gbitlock.c"
77008- line="624">whether to set (lock) the bit or unset (unlock). This
77949+ line="707">whether to set (lock) the bit or unset (unlock). This
7700977950 has no effect, if @lock_bit is set to `G_MAXUINT`.</doc>
7701077951 <type name="gboolean" c:type="gboolean"/>
7701177952 </parameter>
7701277953 <parameter name="preserve_mask" transfer-ownership="none">
7701377954 <doc xml:space="preserve"
7701477955 filename="glib/gbitlock.c"
77015- line="626">if non-zero, a bit-mask for @preserve_ptr. The
77956+ line="709">if non-zero, a bit-mask for @preserve_ptr. The
7701677957 @preserve_mask bits from @preserve_ptr are set in the result.
7701777958 Note that the @lock_bit bit will be always set according to @set,
7701877959 regardless of @preserve_mask and @preserve_ptr (unless @lock_bit is
@@ -77025,7 +77966,7 @@ do.</doc>
7702577966 allow-none="1">
7702677967 <doc xml:space="preserve"
7702777968 filename="glib/gbitlock.c"
77028- line="631">if @preserve_mask is non-zero, the bits
77969+ line="714">if @preserve_mask is non-zero, the bits
7702977970 from this pointer are set in the result.</doc>
7703077971 <type name="gpointer" c:type="gpointer"/>
7703177972 </parameter>
@@ -77036,7 +77977,7 @@ do.</doc>
7703677977 version="2.30">
7703777978 <doc xml:space="preserve"
7703877979 filename="glib/gbitlock.c"
77039- line="518">This is equivalent to g_bit_trylock(), but working on pointers (or
77980+ line="607">This is equivalent to g_bit_trylock(), but working on pointers (or
7704077981 other pointer-sized values).
7704177982
7704277983 For portability reasons, you may only lock on the bottom 32 bits of
@@ -77044,24 +77985,24 @@ the pointer.
7704477985
7704577986 While @address has a `volatile` qualifier, this is a historical
7704677987 artifact and the argument passed to it should not be `volatile`.</doc>
77047- <source-position filename="glib/gbitlock.h" line="54"/>
77988+ <source-position filename="glib/gbitlock.h" line="65"/>
7704877989 <return-value transfer-ownership="none">
7704977990 <doc xml:space="preserve"
7705077991 filename="glib/gbitlock.c"
77051- line="532">%TRUE if the lock was acquired</doc>
77992+ line="621">%TRUE if the lock was acquired</doc>
7705277993 <type name="gboolean" c:type="gboolean"/>
7705377994 </return-value>
7705477995 <parameters>
7705577996 <parameter name="address" transfer-ownership="none">
7705677997 <doc xml:space="preserve"
7705777998 filename="glib/gbitlock.c"
77058- line="520">a pointer to a #gpointer-sized value</doc>
77999+ line="609">a pointer to a #gpointer-sized value</doc>
7705978000 <type name="gpointer" c:type="void*"/>
7706078001 </parameter>
7706178002 <parameter name="lock_bit" transfer-ownership="none">
7706278003 <doc xml:space="preserve"
7706378004 filename="glib/gbitlock.c"
77064- line="521">a bit value between 0 and 31</doc>
78005+ line="610">a bit value between 0 and 31</doc>
7706578006 <type name="gint" c:type="gint"/>
7706678007 </parameter>
7706778008 </parameters>
@@ -77071,7 +78012,7 @@ artifact and the argument passed to it should not be `volatile`.</doc>
7707178012 version="2.30">
7707278013 <doc xml:space="preserve"
7707378014 filename="glib/gbitlock.c"
77074- line="569">This is equivalent to g_bit_unlock, but working on pointers (or other
78015+ line="658">This is equivalent to g_bit_unlock, but working on pointers (or other
7707578016 pointer-sized values).
7707678017
7707778018 For portability reasons, you may only lock on the bottom 32 bits of
@@ -77079,7 +78020,7 @@ the pointer.
7707978020
7708078021 While @address has a `volatile` qualifier, this is a historical
7708178022 artifact and the argument passed to it should not be `volatile`.</doc>
77082- <source-position filename="glib/gbitlock.h" line="57"/>
78023+ <source-position filename="glib/gbitlock.h" line="68"/>
7708378024 <return-value transfer-ownership="none">
7708478025 <type name="none" c:type="void"/>
7708578026 </return-value>
@@ -77087,13 +78028,13 @@ artifact and the argument passed to it should not be `volatile`.</doc>
7708778028 <parameter name="address" transfer-ownership="none">
7708878029 <doc xml:space="preserve"
7708978030 filename="glib/gbitlock.c"
77090- line="571">a pointer to a #gpointer-sized value</doc>
78031+ line="660">a pointer to a #gpointer-sized value</doc>
7709178032 <type name="gpointer" c:type="void*"/>
7709278033 </parameter>
7709378034 <parameter name="lock_bit" transfer-ownership="none">
7709478035 <doc xml:space="preserve"
7709578036 filename="glib/gbitlock.c"
77096- line="572">a bit value between 0 and 31</doc>
78037+ line="661">a bit value between 0 and 31</doc>
7709778038 <type name="gint" c:type="gint"/>
7709878039 </parameter>
7709978040 </parameters>
@@ -77103,14 +78044,14 @@ artifact and the argument passed to it should not be `volatile`.</doc>
7710378044 version="2.80">
7710478045 <doc xml:space="preserve"
7710578046 filename="glib/gbitlock.c"
77106- line="649">This is equivalent to g_pointer_bit_unlock() and atomically setting
78047+ line="732">This is equivalent to g_pointer_bit_unlock() and atomically setting
7710778048 the pointer value.
7710878049
7710978050 Note that the lock bit will be cleared from the pointer. If the unlocked
7711078051 pointer that was set is not identical to @ptr, an assertion fails. In other
7711178052 words, @ptr must have @lock_bit unset. This also means, you usually can
7711278053 only use this on the lowest bits.</doc>
77113- <source-position filename="glib/gbitlock.h" line="68"/>
78054+ <source-position filename="glib/gbitlock.h" line="79"/>
7711478055 <return-value transfer-ownership="none">
7711578056 <type name="none" c:type="void"/>
7711678057 </return-value>
@@ -77118,13 +78059,13 @@ only use this on the lowest bits.</doc>
7711878059 <parameter name="address" transfer-ownership="none">
7711978060 <doc xml:space="preserve"
7712078061 filename="glib/gbitlock.c"
77121- line="651">a pointer to a #gpointer-sized value</doc>
78062+ line="734">a pointer to a #gpointer-sized value</doc>
7712278063 <type name="gpointer" c:type="void*"/>
7712378064 </parameter>
7712478065 <parameter name="lock_bit" transfer-ownership="none">
7712578066 <doc xml:space="preserve"
7712678067 filename="glib/gbitlock.c"
77127- line="652">a bit value between 0 and 31</doc>
78068+ line="735">a bit value between 0 and 31</doc>
7712878069 <type name="guint" c:type="guint"/>
7712978070 </parameter>
7713078071 <parameter name="ptr"
@@ -77133,16 +78074,16 @@ only use this on the lowest bits.</doc>
7713378074 allow-none="1">
7713478075 <doc xml:space="preserve"
7713578076 filename="glib/gbitlock.c"
77136- line="653">the new pointer value to set</doc>
78077+ line="736">the new pointer value to set</doc>
7713778078 <type name="gpointer" c:type="gpointer"/>
7713878079 </parameter>
7713978080 <parameter name="preserve_mask" transfer-ownership="none">
7714078081 <doc xml:space="preserve"
7714178082 filename="glib/gbitlock.c"
77142- line="654">if non-zero, those bits of the current pointer in @address
78083+ line="737">if non-zero, those bits of the current pointer in @address
7714378084 are preserved.
77144- Note that the @lock_bit bit will be always set according to @set,
77145- regardless of @preserve_mask and the currently set value in @address.</doc>
78085+ Note that the @lock_bit bit will be always unset regardless of
78086+ @ptr, @preserve_mask and the currently set value in @address.</doc>
7714678087 <type name="guintptr" c:type="guintptr"/>
7714778088 </parameter>
7714878089 </parameters>
@@ -77275,7 +78216,7 @@ error condition) then also do nothing.</doc>
7727578216 <function name="print" c:identifier="g_print" introspectable="0">
7727678217 <doc xml:space="preserve"
7727778218 filename="glib/gmessages.c"
77278- line="3532">Outputs a formatted message via the print handler.
78219+ line="3618">Outputs a formatted message via the print handler.
7727978220
7728078221 The default print handler outputs the encoded message to `stdout`, without
7728178222 appending a trailing new-line character. Typically, @format should end with
@@ -77286,7 +78227,7 @@ messages, since it may be redirected by applications to special
7728678227 purpose message windows or even files. Instead, libraries should
7728778228 use [func@GLib.log], [func@GLib.log_structured], or the convenience macros
7728878229 [func@GLib.message], [func@GLib.warning] and [func@GLib.error].</doc>
77289- <source-position filename="glib/gmessages.h" line="527"/>
78230+ <source-position filename="glib/gmessages.h" line="530"/>
7729078231 <return-value transfer-ownership="none">
7729178232 <type name="none" c:type="void"/>
7729278233 </return-value>
@@ -77294,13 +78235,13 @@ use [func@GLib.log], [func@GLib.log_structured], or the convenience macros
7729478235 <parameter name="format" transfer-ownership="none">
7729578236 <doc xml:space="preserve"
7729678237 filename="glib/gmessages.c"
77297- line="3534">the message format. See the `printf()` documentation</doc>
78238+ line="3620">the message format. See the `printf()` documentation</doc>
7729878239 <type name="utf8" c:type="const gchar*"/>
7729978240 </parameter>
7730078241 <parameter name="..." transfer-ownership="none">
7730178242 <doc xml:space="preserve"
7730278243 filename="glib/gmessages.c"
77303- line="3535">the parameters to insert into the format string</doc>
78244+ line="3621">the parameters to insert into the format string</doc>
7730478245 <varargs/>
7730578246 </parameter>
7730678247 </parameters>
@@ -77308,7 +78249,7 @@ use [func@GLib.log], [func@GLib.log_structured], or the convenience macros
7730878249 <function name="printerr" c:identifier="g_printerr" introspectable="0">
7730978250 <doc xml:space="preserve"
7731078251 filename="glib/gmessages.c"
77311- line="3599">Outputs a formatted message via the error message handler.
78252+ line="3685">Outputs a formatted message via the error message handler.
7731278253
7731378254 The default handler outputs the encoded message to `stderr`, without appending
7731478255 a trailing new-line character. Typically, @format should end with its own
@@ -77317,7 +78258,7 @@ new-line character.
7731778258 This function should not be used from within libraries.
7731878259 Instead [func@GLib.log] or [func@GLib.log_structured] should be used, or the convenience
7731978260 macros [func@GLib.message], [func@GLib.warning] and [func@GLib.error].</doc>
77320- <source-position filename="glib/gmessages.h" line="532"/>
78261+ <source-position filename="glib/gmessages.h" line="535"/>
7732178262 <return-value transfer-ownership="none">
7732278263 <type name="none" c:type="void"/>
7732378264 </return-value>
@@ -77325,13 +78266,13 @@ macros [func@GLib.message], [func@GLib.warning] and [func@GLib.error].</doc>
7732578266 <parameter name="format" transfer-ownership="none">
7732678267 <doc xml:space="preserve"
7732778268 filename="glib/gmessages.c"
77328- line="3601">the message format. See the `printf()` documentation</doc>
78269+ line="3687">the message format. See the `printf()` documentation</doc>
7732978270 <type name="utf8" c:type="const gchar*"/>
7733078271 </parameter>
7733178272 <parameter name="..." transfer-ownership="none">
7733278273 <doc xml:space="preserve"
7733378274 filename="glib/gmessages.c"
77334- line="3602">the parameters to insert into the format string</doc>
78275+ line="3688">the parameters to insert into the format string</doc>
7733578276 <varargs/>
7733678277 </parameter>
7733778278 </parameters>
@@ -77342,7 +78283,7 @@ macros [func@GLib.message], [func@GLib.warning] and [func@GLib.error].</doc>
7734278283 introspectable="0">
7734378284 <doc xml:space="preserve"
7734478285 filename="glib/gprintf.c"
77345- line="31">An implementation of the standard `printf()` function which supports
78286+ line="32">An implementation of the standard `printf()` function which supports
7734678287 positional parameters, as specified in the Single Unix Specification.
7734778288
7734878289 As with the standard `printf()`, this does not automatically append a trailing
@@ -77354,21 +78295,21 @@ own new-line character.
7735478295 <return-value transfer-ownership="none">
7735578296 <doc xml:space="preserve"
7735678297 filename="glib/gprintf.c"
77357- line="46">the number of bytes printed</doc>
78298+ line="47">the number of bytes printed</doc>
7735878299 <type name="gint" c:type="gint"/>
7735978300 </return-value>
7736078301 <parameters>
7736178302 <parameter name="format" transfer-ownership="none">
7736278303 <doc xml:space="preserve"
7736378304 filename="glib/gprintf.c"
77364- line="33">a standard `printf()` format string, but notice
78305+ line="34">a standard `printf()` format string, but notice
7736578306 [string precision pitfalls](string-utils.html#string-precision-pitfalls)</doc>
7736678307 <type name="utf8" c:type="const gchar*"/>
7736778308 </parameter>
7736878309 <parameter name="..." transfer-ownership="none">
7736978310 <doc xml:space="preserve"
7737078311 filename="glib/gprintf.c"
77371- line="35">the arguments to insert in the output</doc>
78312+ line="36">the arguments to insert in the output</doc>
7737278313 <varargs/>
7737378314 </parameter>
7737478315 </parameters>
@@ -77378,7 +78319,7 @@ own new-line character.
7737878319 introspectable="0">
7737978320 <doc xml:space="preserve"
7738078321 filename="glib/gmessages.c"
77381- line="3634">Calculates the maximum space needed to store the output
78322+ line="3720">Calculates the maximum space needed to store the output
7738278323 of the `sprintf()` function.
7738378324
7738478325 If @format or @args are invalid, `0` is returned. This could happen if, for
@@ -77392,20 +78333,20 @@ placeholders in any case, as their behaviour is locale-dependent.</doc>
7739278333 <return-value transfer-ownership="none">
7739378334 <doc xml:space="preserve"
7739478335 filename="glib/gmessages.c"
77395- line="3650">the maximum space needed to store the formatted string, or `0` on error</doc>
78336+ line="3736">the maximum space needed to store the formatted string, or `0` on error</doc>
7739678337 <type name="gsize" c:type="gsize"/>
7739778338 </return-value>
7739878339 <parameters>
7739978340 <parameter name="format" transfer-ownership="none">
7740078341 <doc xml:space="preserve"
7740178342 filename="glib/gmessages.c"
77402- line="3636">the format string. See the `printf()` documentation</doc>
78343+ line="3722">the format string. See the `printf()` documentation</doc>
7740378344 <type name="utf8" c:type="const gchar*"/>
7740478345 </parameter>
7740578346 <parameter name="args" transfer-ownership="none">
7740678347 <doc xml:space="preserve"
7740778348 filename="glib/gmessages.c"
77408- line="3637">the parameters to be inserted into the format string</doc>
78349+ line="3723">the parameters to be inserted into the format string</doc>
7740978350 <type name="va_list" c:type="va_list"/>
7741078351 </parameter>
7741178352 </parameters>
@@ -77520,25 +78461,26 @@ g_prefix_error().</doc>
7752078461 introspectable="0">
7752178462 <doc xml:space="preserve"
7752278463 filename="glib/garray.c"
77523- line="2601">Checks whether @needle exists in @haystack. If the element is found, %TRUE is
77524-returned and the element’s index is returned in @index_ (if non-%NULL).
77525-Otherwise, %FALSE is returned and @index_ is undefined. If @needle exists
78464+ line="2620">Checks whether @needle exists in @haystack. If the element is found, true
78465+is returned and the element’s index is returned in @index_ (if non-`NULL`).
78466+Otherwise, false is returned and @index_ is undefined. If @needle exists
7752678467 multiple times in @haystack, the index of the first instance is returned.
7752778468
7752878469 This does pointer comparisons only. If you want to use more complex equality
77529-checks, such as string comparisons, use g_ptr_array_find_with_equal_func().</doc>
78470+checks, such as string comparisons, use
78471+[func@GLib.PtrArray.find_with_equal_func].</doc>
7753078472 <source-position filename="glib/garray.h" line="257"/>
7753178473 <return-value transfer-ownership="none">
7753278474 <doc xml:space="preserve"
7753378475 filename="glib/garray.c"
77534- line="2616">%TRUE if @needle is one of the elements of @haystack</doc>
78476+ line="2636">true if @needle is one of the elements of @haystack; false otherwise</doc>
7753578477 <type name="gboolean" c:type="gboolean"/>
7753678478 </return-value>
7753778479 <parameters>
7753878480 <parameter name="haystack" transfer-ownership="none">
7753978481 <doc xml:space="preserve"
7754078482 filename="glib/garray.c"
77541- line="2603">pointer array to be searched</doc>
78483+ line="2622">the pointer array to be searched</doc>
7754278484 <array name="GLib.PtrArray" c:type="GPtrArray*">
7754378485 <type name="gpointer" c:type="gpointer"/>
7754478486 </array>
@@ -77549,7 +78491,7 @@ checks, such as string comparisons, use g_ptr_array_find_with_equal_func().</doc
7754978491 allow-none="1">
7755078492 <doc xml:space="preserve"
7755178493 filename="glib/garray.c"
77552- line="2604">pointer to look for</doc>
78494+ line="2623">the pointer to look for</doc>
7755378495 <type name="gpointer" c:type="gconstpointer"/>
7755478496 </parameter>
7755578497 <parameter name="index_"
@@ -77560,7 +78502,7 @@ checks, such as string comparisons, use g_ptr_array_find_with_equal_func().</doc
7756078502 allow-none="1">
7756178503 <doc xml:space="preserve"
7756278504 filename="glib/garray.c"
77563- line="2605">return location for the index of
78505+ line="2624">the return location for the index of
7756478506 the element, if found</doc>
7756578507 <type name="guint" c:type="guint*"/>
7756678508 </parameter>
@@ -77573,27 +78515,27 @@ checks, such as string comparisons, use g_ptr_array_find_with_equal_func().</doc
7757378515 introspectable="0">
7757478516 <doc xml:space="preserve"
7757578517 filename="glib/garray.c"
77576- line="2627">Checks whether @needle exists in @haystack, using the given @equal_func.
77577-If the element is found, %TRUE is returned and the element’s index is
77578-returned in @index_ (if non-%NULL). Otherwise, %FALSE is returned and @index_
78518+ line="2647">Checks whether @needle exists in @haystack, using the given @equal_func.
78519+If the element is found, true is returned and the element’s index is
78520+returned in @index_ (if non-`NULL`). Otherwise, false is returned and @index_
7757978521 is undefined. If @needle exists multiple times in @haystack, the index of
7758078522 the first instance is returned.
7758178523
7758278524 @equal_func is called with the element from the array as its first parameter,
77583-and @needle as its second parameter. If @equal_func is %NULL, pointer
78525+and @needle as its second parameter. If @equal_func is `NULL`, pointer
7758478526 equality is used.</doc>
7758578527 <source-position filename="glib/garray.h" line="261"/>
7758678528 <return-value transfer-ownership="none">
7758778529 <doc xml:space="preserve"
7758878530 filename="glib/garray.c"
77589- line="2647">%TRUE if @needle is one of the elements of @haystack</doc>
78531+ line="2667">true if @needle is one of the elements of @haystack; false otherwise</doc>
7759078532 <type name="gboolean" c:type="gboolean"/>
7759178533 </return-value>
7759278534 <parameters>
7759378535 <parameter name="haystack" transfer-ownership="none">
7759478536 <doc xml:space="preserve"
7759578537 filename="glib/garray.c"
77596- line="2629">pointer array to be searched</doc>
78538+ line="2649">the pointer array to be searched</doc>
7759778539 <array name="GLib.PtrArray" c:type="GPtrArray*">
7759878540 <type name="gpointer" c:type="gpointer"/>
7759978541 </array>
@@ -77604,7 +78546,7 @@ equality is used.</doc>
7760478546 allow-none="1">
7760578547 <doc xml:space="preserve"
7760678548 filename="glib/garray.c"
77607- line="2630">pointer to look for</doc>
78549+ line="2650">the pointer to look for</doc>
7760878550 <type name="gpointer" c:type="gconstpointer"/>
7760978551 </parameter>
7761078552 <parameter name="equal_func"
@@ -77613,8 +78555,8 @@ equality is used.</doc>
7761378555 allow-none="1">
7761478556 <doc xml:space="preserve"
7761578557 filename="glib/garray.c"
77616- line="2631">the function to call for each element, which should
77617- return %TRUE when the desired element is found; or %NULL to use pointer
78558+ line="2651">the function to call for each element, which should
78559+ return true when the desired element is found; or `NULL` to use pointer
7761878560 equality</doc>
7761978561 <type name="EqualFunc" c:type="GEqualFunc"/>
7762078562 </parameter>
@@ -77626,7 +78568,7 @@ equality is used.</doc>
7762678568 allow-none="1">
7762778569 <doc xml:space="preserve"
7762878570 filename="glib/garray.c"
77629- line="2634">return location for the index of
78571+ line="2654">the return location for the index of
7763078572 the element, if found</doc>
7763178573 <type name="guint" c:type="guint*"/>
7763278574 </parameter>
@@ -77637,7 +78579,7 @@ equality is used.</doc>
7763778579 introspectable="0">
7763878580 <doc xml:space="preserve"
7763978581 filename="glib/garray.c"
77640- line="1104">Returns the pointer at the given index of the pointer array.
78582+ line="1116">Returns the pointer at the given index of the pointer array.
7764178583
7764278584 This does not perform bounds checking on the given @index_,
7764378585 so you are responsible for checking it against the array length.</doc>
@@ -77646,12 +78588,12 @@ so you are responsible for checking it against the array length.</doc>
7764678588 <parameter name="array">
7764778589 <doc xml:space="preserve"
7764878590 filename="glib/garray.c"
77649- line="1106">a #GPtrArray</doc>
78591+ line="1118">a pointer array</doc>
7765078592 </parameter>
7765178593 <parameter name="index_">
7765278594 <doc xml:space="preserve"
7765378595 filename="glib/garray.c"
77654- line="1107">the index of the pointer to return</doc>
78596+ line="1119">the index of the pointer to return</doc>
7765578597 </parameter>
7765678598 </parameters>
7765778599 </function-macro>
@@ -77662,27 +78604,28 @@ so you are responsible for checking it against the array length.</doc>
7766278604 introspectable="0">
7766378605 <doc xml:space="preserve"
7766478606 filename="glib/garray.c"
77665- line="1313">Creates a new #GPtrArray, copying @len pointers from @data, and setting
78607+ line="1326">Creates a new `GPtrArray`, copying @len pointers from @data, and setting
7766678608 the array’s reference count to 1.
7766778609
7766878610 This avoids having to manually add each element one by one.
7766978611
7767078612 If @copy_func is provided, then it is used to copy each element before
77671-adding them to the new array. If it is %NULL then the pointers are copied
78613+adding them to the new array. If it is `NULL` then the pointers are copied
7767278614 directly.
7767378615
7767478616 It also sets @element_free_func for freeing each element when the array is
77675-destroyed either via g_ptr_array_unref(), when g_ptr_array_free() is called
77676-with @free_segment set to %TRUE or when removing elements.
78617+destroyed either via [func@GLib.PtrArray.unref], when
78618+[func@GLib.PtrArray.free] is called with @free_segment set to true or when
78619+removing elements.
7767778620
77678-Do not use it if @len is greater than %G_MAXUINT. #GPtrArray
77679-stores the length of its data in #guint, which may be shorter than
77680-#gsize.</doc>
78621+Do not use it if @len is greater than [`G_MAXUINT`](types.html#guint).
78622+`GPtrArray` stores the length of its data in `guint`, which may be shorter
78623+than `gsize`.</doc>
7768178624 <source-position filename="glib/garray.h" line="159"/>
7768278625 <return-value transfer-ownership="full">
7768378626 <doc xml:space="preserve"
7768478627 filename="glib/garray.c"
77685- line="1341">A new #GPtrArray</doc>
78628+ line="1354">The new `GPtrArray`</doc>
7768678629 <array name="GLib.PtrArray" c:type="GPtrArray*">
7768778630 <type name="gpointer" c:type="gpointer"/>
7768878631 </array>
@@ -77694,8 +78637,7 @@ stores the length of its data in #guint, which may be shorter than
7769478637 allow-none="1">
7769578638 <doc xml:space="preserve"
7769678639 filename="glib/garray.c"
77697- line="1315">an array of pointers,
77698-or %NULL for an empty array</doc>
78640+ line="1328">an array of pointers</doc>
7769978641 <array length="1" zero-terminated="0" c:type="gpointer*">
7770078642 <type name="gpointer" c:type="gpointer"/>
7770178643 </array>
@@ -77703,7 +78645,7 @@ or %NULL for an empty array</doc>
7770378645 <parameter name="len" transfer-ownership="none">
7770478646 <doc xml:space="preserve"
7770578647 filename="glib/garray.c"
77706- line="1317">the number of pointers in @data</doc>
78648+ line="1329">the number of pointers in @data</doc>
7770778649 <type name="gsize" c:type="gsize"/>
7770878650 </parameter>
7770978651 <parameter name="copy_func"
@@ -77715,8 +78657,8 @@ or %NULL for an empty array</doc>
7771578657 destroy="4">
7771678658 <doc xml:space="preserve"
7771778659 filename="glib/garray.c"
77718- line="1318">a copy function used to copy every element in the
77719- array or %NULL.</doc>
78660+ line="1330">a copy function used to copy every element in the
78661+ array</doc>
7772078662 <type name="CopyFunc" c:type="GCopyFunc"/>
7772178663 </parameter>
7772278664 <parameter name="copy_func_user_data"
@@ -77725,7 +78667,7 @@ or %NULL for an empty array</doc>
7772578667 allow-none="1">
7772678668 <doc xml:space="preserve"
7772778669 filename="glib/garray.c"
77728- line="1320">user data passed to @copy_func, or %NULL</doc>
78670+ line="1332">the user data passed to @copy_func</doc>
7772978671 <type name="gpointer" c:type="gpointer"/>
7773078672 </parameter>
7773178673 <parameter name="element_free_func"
@@ -77735,8 +78677,8 @@ or %NULL for an empty array</doc>
7773578677 scope="async">
7773678678 <doc xml:space="preserve"
7773778679 filename="glib/garray.c"
77738- line="1321">a function to free elements on @array
77739- destruction or %NULL</doc>
78680+ line="1333">a function to free elements on @array
78681+ destruction</doc>
7774078682 <type name="DestroyNotify" c:type="GDestroyNotify"/>
7774178683 </parameter>
7774278684 </parameters>
@@ -77748,23 +78690,24 @@ or %NULL for an empty array</doc>
7774878690 introspectable="0">
7774978691 <doc xml:space="preserve"
7775078692 filename="glib/garray.c"
77751- line="1359">Creates a new #GPtrArray copying the pointers from @data after having
78693+ line="1372">Creates a new `GPtrArray` copying the pointers from @data after having
7775278694 computed the length of it and with a reference count of 1.
7775378695 This avoids having to manually add each element one by one.
7775478696 If @copy_func is provided, then it is used to copy the data in the new
7775578697 array.
77756-It also set @element_free_func for freeing each element when the array is
77757-destroyed either via g_ptr_array_unref(), when g_ptr_array_free() is called
77758-with @free_segment set to %TRUE or when removing elements.
78698+It also sets @element_free_func for freeing each element when the array is
78699+destroyed either via [func@GLib.PtrArray.unref], when
78700+[func@GLib.PtrArray.free] is called with @free_segment set to true or when
78701+removing elements.
7775978702
77760-Do not use it if the @data has more than %G_MAXUINT elements. #GPtrArray
77761-stores the length of its data in #guint, which may be shorter than
77762-#gsize.</doc>
78703+Do not use it if the @data has more than [`G_MAXUINT`](types.html#guint)
78704+elements. `GPtrArray` stores the length of its data in `guint`, which may be
78705+shorter than `gsize`.</doc>
7776378706 <source-position filename="glib/garray.h" line="184"/>
7776478707 <return-value transfer-ownership="full">
7776578708 <doc xml:space="preserve"
7776678709 filename="glib/garray.c"
77767- line="1382">A new #GPtrArray</doc>
78710+ line="1396">The new `GPtrArray`</doc>
7776878711 <array name="GLib.PtrArray" c:type="GPtrArray*">
7776978712 <type name="gpointer" c:type="gpointer"/>
7777078713 </array>
@@ -77776,8 +78719,8 @@ stores the length of its data in #guint, which may be shorter than
7777678719 allow-none="1">
7777778720 <doc xml:space="preserve"
7777878721 filename="glib/garray.c"
77779- line="1361">an array of
77780- pointers, %NULL terminated; or %NULL for an empty array</doc>
78722+ line="1374">an array of
78723+ pointers, `NULL` terminated</doc>
7778178724 <array c:type="gpointer*">
7778278725 <type name="gpointer" c:type="gpointer"/>
7778378726 </array>
@@ -77791,8 +78734,8 @@ stores the length of its data in #guint, which may be shorter than
7779178734 destroy="3">
7779278735 <doc xml:space="preserve"
7779378736 filename="glib/garray.c"
77794- line="1363">a copy function used to copy every element in the
77795- array or %NULL.</doc>
78737+ line="1376">a copy function used to copy every element in the
78738+ array</doc>
7779678739 <type name="CopyFunc" c:type="GCopyFunc"/>
7779778740 </parameter>
7779878741 <parameter name="copy_func_user_data"
@@ -77801,7 +78744,7 @@ stores the length of its data in #guint, which may be shorter than
7780178744 allow-none="1">
7780278745 <doc xml:space="preserve"
7780378746 filename="glib/garray.c"
77804- line="1365">user data passed to @copy_func, or %NULL</doc>
78747+ line="1378">the user data passed to @copy_func</doc>
7780578748 <type name="gpointer" c:type="gpointer"/>
7780678749 </parameter>
7780778750 <parameter name="element_free_func"
@@ -77811,8 +78754,8 @@ stores the length of its data in #guint, which may be shorter than
7781178754 scope="async">
7781278755 <doc xml:space="preserve"
7781378756 filename="glib/garray.c"
77814- line="1366">a function to free elements on @array
77815- destruction or %NULL</doc>
78757+ line="1379">a function to free elements on @array
78758+ destruction</doc>
7781678759 <type name="DestroyNotify" c:type="GDestroyNotify"/>
7781778760 </parameter>
7781878761 </parameters>
@@ -77824,26 +78767,27 @@ stores the length of its data in #guint, which may be shorter than
7782478767 introspectable="0">
7782578768 <doc xml:space="preserve"
7782678769 filename="glib/garray.c"
77827- line="1178">Creates a new #GPtrArray with @data as pointers, @len as length and a
78770+ line="1186">Creates a new `GPtrArray` with @data as pointers, @len as length and a
7782878771 reference count of 1.
7782978772
7783078773 This avoids having to copy such data manually.
77831-After this call, @data belongs to the #GPtrArray and may no longer be
78774+After this call, @data belongs to the `GPtrArray` and may no longer be
7783278775 modified by the caller. The memory of @data has to be dynamically
77833-allocated and will eventually be freed with g_free().
78776+allocated and will eventually be freed with [func@GLib.free].
7783478777
7783578778 It also sets @element_free_func for freeing each element when the array is
77836-destroyed either via g_ptr_array_unref(), when g_ptr_array_free() is called
77837-with @free_segment set to %TRUE or when removing elements.
78779+destroyed either via [func@GLib.PtrArray.unref], when
78780+[func@GLib.PtrArray.free] is called with @free_segment set to true or when
78781+removing elements.
7783878782
77839-Do not use it if @len is greater than %G_MAXUINT. #GPtrArray
77840-stores the length of its data in #guint, which may be shorter than
77841-#gsize.</doc>
78783+Do not use it if @len is greater than [`G_MAXUINT`](types.html#guint).
78784+`GPtrArray` stores the length of its data in `guint`, which may be shorter
78785+than `gsize`.</doc>
7784278786 <source-position filename="glib/garray.h" line="155"/>
7784378787 <return-value transfer-ownership="full">
7784478788 <doc xml:space="preserve"
7784578789 filename="glib/garray.c"
77846- line="1202">A new #GPtrArray</doc>
78790+ line="1210">The new `GPtrArray`</doc>
7784778791 <array name="GLib.PtrArray" c:type="GPtrArray*">
7784878792 <type name="gpointer" c:type="gpointer"/>
7784978793 </array>
@@ -77855,8 +78799,7 @@ stores the length of its data in #guint, which may be shorter than
7785578799 allow-none="1">
7785678800 <doc xml:space="preserve"
7785778801 filename="glib/garray.c"
77858- line="1180">an array of pointers,
77859- or %NULL for an empty array</doc>
78802+ line="1188">an array of pointers</doc>
7786078803 <array length="1" zero-terminated="0" c:type="gpointer*">
7786178804 <type name="gpointer" c:type="gpointer"/>
7786278805 </array>
@@ -77864,7 +78807,7 @@ stores the length of its data in #guint, which may be shorter than
7786478807 <parameter name="len" transfer-ownership="none">
7786578808 <doc xml:space="preserve"
7786678809 filename="glib/garray.c"
77867- line="1182">the number of pointers in @data</doc>
78810+ line="1189">the number of pointers in @data</doc>
7786878811 <type name="gsize" c:type="gsize"/>
7786978812 </parameter>
7787078813 <parameter name="element_free_func"
@@ -77874,8 +78817,8 @@ stores the length of its data in #guint, which may be shorter than
7787478817 scope="async">
7787578818 <doc xml:space="preserve"
7787678819 filename="glib/garray.c"
77877- line="1183">A function to free elements on @array
77878- destruction or %NULL</doc>
78820+ line="1190">a function to free elements on @array
78821+ destruction</doc>
7787978822 <type name="DestroyNotify" c:type="GDestroyNotify"/>
7788078823 </parameter>
7788178824 </parameters>
@@ -77887,29 +78830,30 @@ stores the length of its data in #guint, which may be shorter than
7788778830 introspectable="0">
7788878831 <doc xml:space="preserve"
7788978832 filename="glib/garray.c"
77890- line="1227">Creates a new #GPtrArray with @data as pointers, computing the length of it
78833+ line="1235">Creates a new `GPtrArray` with @data as pointers, computing the length of it
7789178834 and setting the reference count to 1.
7789278835
7789378836 This avoids having to copy such data manually.
77894-After this call, @data belongs to the #GPtrArray and may no longer be
78837+After this call, @data belongs to the `GPtrArray` and may no longer be
7789578838 modified by the caller. The memory of @data has to be dynamically
77896-allocated and will eventually be freed with g_free().
78839+allocated and will eventually be freed with [func@GLib.free].
7789778840
77898-The length is calculated by iterating through @data until the first %NULL
78841+The length is calculated by iterating through @data until the first `NULL`
7789978842 element is found.
7790078843
7790178844 It also sets @element_free_func for freeing each element when the array is
77902-destroyed either via g_ptr_array_unref(), when g_ptr_array_free() is called
77903-with @free_segment set to %TRUE or when removing elements.
78845+destroyed either via [func@GLib.PtrArray.unref], when
78846+[func@GLib.PtrArray.free] is called with @free_segment set to true or when
78847+removing elements.
7790478848
77905-Do not use it if the @data length is greater than %G_MAXUINT. #GPtrArray
77906-stores the length of its data in #guint, which may be shorter than
77907-#gsize.</doc>
78849+Do not use it if the @data length is greater than
78850+[`G_MAXUINT`](types.html#guint). `GPtrArray` stores the length of its data
78851+in `guint`, which may be shorter than `gsize`.</doc>
7790878852 <source-position filename="glib/garray.h" line="181"/>
7790978853 <return-value transfer-ownership="full">
7791078854 <doc xml:space="preserve"
7791178855 filename="glib/garray.c"
77912- line="1253">A new #GPtrArray</doc>
78856+ line="1262">The new `GPtrArray`</doc>
7791378857 <array name="GLib.PtrArray" c:type="GPtrArray*">
7791478858 <type name="gpointer" c:type="gpointer"/>
7791578859 </array>
@@ -77921,8 +78865,8 @@ stores the length of its data in #guint, which may be shorter than
7792178865 allow-none="1">
7792278866 <doc xml:space="preserve"
7792378867 filename="glib/garray.c"
77924- line="1229">an array
77925- of pointers, %NULL terminated, or %NULL for an empty array</doc>
78868+ line="1237">an array
78869+ of pointers, `NULL` terminated</doc>
7792678870 <array c:type="gpointer*">
7792778871 <type name="gpointer" c:type="gpointer"/>
7792878872 </array>
@@ -77934,8 +78878,8 @@ stores the length of its data in #guint, which may be shorter than
7793478878 scope="async">
7793578879 <doc xml:space="preserve"
7793678880 filename="glib/garray.c"
77937- line="1231">a function to free elements on @array
77938- destruction or %NULL</doc>
78881+ line="1239">a function to free elements on @array
78882+ destruction</doc>
7793978883 <type name="DestroyNotify" c:type="GDestroyNotify"/>
7794078884 </parameter>
7794178885 </parameters>
@@ -78120,14 +79064,14 @@ running.</doc>
7812079064 introspectable="0">
7812179065 <doc xml:space="preserve"
7812279066 filename="glib/grand.c"
78123- line="383">Returns a random #gboolean from @rand_.
79067+ line="384">Returns a random #gboolean from @rand_.
7812479068 This corresponds to an unbiased coin toss.</doc>
7812579069 <source-position filename="glib/grand.h" line="68"/>
7812679070 <parameters>
7812779071 <parameter name="rand_">
7812879072 <doc xml:space="preserve"
7812979073 filename="glib/grand.c"
78130- line="385">a #GRand</doc>
79074+ line="386">a #GRand</doc>
7813179075 </parameter>
7813279076 </parameters>
7813379077 </function-macro>
@@ -78136,45 +79080,45 @@ This corresponds to an unbiased coin toss.</doc>
7813679080 introspectable="0">
7813779081 <doc xml:space="preserve"
7813879082 filename="glib/grand.c"
78139- line="583">Returns a random #gboolean.
79083+ line="584">Returns a random #gboolean.
7814079084 This corresponds to an unbiased coin toss.</doc>
7814179085 <source-position filename="glib/grand.h" line="85"/>
7814279086 </function-macro>
7814379087 <function name="random_double" c:identifier="g_random_double">
7814479088 <doc xml:space="preserve"
7814579089 filename="glib/grand.c"
78146- line="630">Returns a random #gdouble equally distributed over the range [0..1).</doc>
79090+ line="631">Returns a random #gdouble equally distributed over the range [0..1).</doc>
7814779091 <source-position filename="glib/grand.h" line="93"/>
7814879092 <return-value transfer-ownership="none">
7814979093 <doc xml:space="preserve"
7815079094 filename="glib/grand.c"
78151- line="635">a random number</doc>
79095+ line="636">a random number</doc>
7815279096 <type name="gdouble" c:type="gdouble"/>
7815379097 </return-value>
7815479098 </function>
7815579099 <function name="random_double_range" c:identifier="g_random_double_range">
7815679100 <doc xml:space="preserve"
7815779101 filename="glib/grand.c"
78158- line="647">Returns a random #gdouble equally distributed over the range
79102+ line="648">Returns a random #gdouble equally distributed over the range
7815979103 [@begin..@end).</doc>
7816079104 <source-position filename="glib/grand.h" line="95"/>
7816179105 <return-value transfer-ownership="none">
7816279106 <doc xml:space="preserve"
7816379107 filename="glib/grand.c"
78164- line="655">a random number</doc>
79108+ line="656">a random number</doc>
7816579109 <type name="gdouble" c:type="gdouble"/>
7816679110 </return-value>
7816779111 <parameters>
7816879112 <parameter name="begin" transfer-ownership="none">
7816979113 <doc xml:space="preserve"
7817079114 filename="glib/grand.c"
78171- line="649">lower closed bound of the interval</doc>
79115+ line="650">lower closed bound of the interval</doc>
7817279116 <type name="gdouble" c:type="gdouble"/>
7817379117 </parameter>
7817479118 <parameter name="end" transfer-ownership="none">
7817579119 <doc xml:space="preserve"
7817679120 filename="glib/grand.c"
78177- line="650">upper open bound of the interval</doc>
79121+ line="651">upper open bound of the interval</doc>
7817879122 <type name="gdouble" c:type="gdouble"/>
7817979123 </parameter>
7818079124 </parameters>
@@ -78182,39 +79126,39 @@ This corresponds to an unbiased coin toss.</doc>
7818279126 <function name="random_int" c:identifier="g_random_int">
7818379127 <doc xml:space="preserve"
7818479128 filename="glib/grand.c"
78185- line="591">Return a random #guint32 equally distributed over the range
79129+ line="592">Return a random #guint32 equally distributed over the range
7818679130 [0..2^32-1].</doc>
7818779131 <source-position filename="glib/grand.h" line="88"/>
7818879132 <return-value transfer-ownership="none">
7818979133 <doc xml:space="preserve"
7819079134 filename="glib/grand.c"
78191- line="597">a random number</doc>
79135+ line="598">a random number</doc>
7819279136 <type name="guint32" c:type="guint32"/>
7819379137 </return-value>
7819479138 </function>
7819579139 <function name="random_int_range" c:identifier="g_random_int_range">
7819679140 <doc xml:space="preserve"
7819779141 filename="glib/grand.c"
78198- line="609">Returns a random #gint32 equally distributed over the range
79142+ line="610">Returns a random #gint32 equally distributed over the range
7819979143 [@begin..@end-1].</doc>
7820079144 <source-position filename="glib/grand.h" line="90"/>
7820179145 <return-value transfer-ownership="none">
7820279146 <doc xml:space="preserve"
7820379147 filename="glib/grand.c"
78204- line="617">a random number</doc>
79148+ line="618">a random number</doc>
7820579149 <type name="gint32" c:type="gint32"/>
7820679150 </return-value>
7820779151 <parameters>
7820879152 <parameter name="begin" transfer-ownership="none">
7820979153 <doc xml:space="preserve"
7821079154 filename="glib/grand.c"
78211- line="611">lower closed bound of the interval</doc>
79155+ line="612">lower closed bound of the interval</doc>
7821279156 <type name="gint32" c:type="gint32"/>
7821379157 </parameter>
7821479158 <parameter name="end" transfer-ownership="none">
7821579159 <doc xml:space="preserve"
7821679160 filename="glib/grand.c"
78217- line="612">upper open bound of the interval</doc>
79161+ line="613">upper open bound of the interval</doc>
7821879162 <type name="gint32" c:type="gint32"/>
7821979163 </parameter>
7822079164 </parameters>
@@ -78222,7 +79166,7 @@ This corresponds to an unbiased coin toss.</doc>
7822279166 <function name="random_set_seed" c:identifier="g_random_set_seed">
7822379167 <doc xml:space="preserve"
7822479168 filename="glib/grand.c"
78225- line="668">Sets the seed for the global random number generator, which is used
79169+ line="669">Sets the seed for the global random number generator, which is used
7822679170 by the g_random_* functions, to @seed.</doc>
7822779171 <source-position filename="glib/grand.h" line="83"/>
7822879172 <return-value transfer-ownership="none">
@@ -78232,7 +79176,7 @@ by the g_random_* functions, to @seed.</doc>
7823279176 <parameter name="seed" transfer-ownership="none">
7823379177 <doc xml:space="preserve"
7823479178 filename="glib/grand.c"
78235- line="670">a value to reinitialize the global random number generator</doc>
79179+ line="671">a value to reinitialize the global random number generator</doc>
7823679180 <type name="guint32" c:type="guint32"/>
7823779181 </parameter>
7823879182 </parameters>
@@ -78584,7 +79528,10 @@ g_ref_count_init() to be used again.</doc>
7858479528 <type name="gboolean" c:type="gboolean"/>
7858579529 </return-value>
7858679530 <parameters>
78587- <parameter name="rc" transfer-ownership="none">
79531+ <parameter name="rc"
79532+ direction="inout"
79533+ caller-allocates="0"
79534+ transfer-ownership="full">
7858879535 <doc xml:space="preserve"
7858979536 filename="glib/grefcount.c"
7859079537 line="120">the address of a reference count variable</doc>
@@ -78603,7 +79550,10 @@ g_ref_count_init() to be used again.</doc>
7860379550 <type name="none" c:type="void"/>
7860479551 </return-value>
7860579552 <parameters>
78606- <parameter name="rc" transfer-ownership="none">
79553+ <parameter name="rc"
79554+ direction="inout"
79555+ caller-allocates="0"
79556+ transfer-ownership="full">
7860779557 <doc xml:space="preserve"
7860879558 filename="glib/grefcount.c"
7860979559 line="89">the address of a reference count variable</doc>
@@ -78622,7 +79572,10 @@ g_ref_count_init() to be used again.</doc>
7862279572 <type name="none" c:type="void"/>
7862379573 </return-value>
7862479574 <parameters>
78625- <parameter name="rc" transfer-ownership="none">
79575+ <parameter name="rc"
79576+ direction="out"
79577+ caller-allocates="0"
79578+ transfer-ownership="full">
7862679579 <doc xml:space="preserve"
7862779580 filename="glib/grefcount.c"
7862879581 line="64">the address of a reference count variable</doc>
@@ -78817,7 +79770,7 @@ resources allocated by the string are freed as well.</doc>
7881779770 throws="1">
7881879771 <doc xml:space="preserve"
7881979772 filename="glib/gregex.c"
78820- line="3503">Checks whether @replacement is a valid replacement string
79773+ line="3773">Checks whether @replacement is a valid replacement string
7882179774 (see g_regex_replace()), i.e. that all escape sequences in
7882279775 it are valid.
7882379776
@@ -78830,14 +79783,14 @@ subpattern) requires valid #GMatchInfo object.</doc>
7883079783 <return-value transfer-ownership="none">
7883179784 <doc xml:space="preserve"
7883279785 filename="glib/gregex.c"
78833- line="3520">whether @replacement is a valid replacement string</doc>
79786+ line="3790">whether @replacement is a valid replacement string</doc>
7883479787 <type name="gboolean" c:type="gboolean"/>
7883579788 </return-value>
7883679789 <parameters>
7883779790 <parameter name="replacement" transfer-ownership="none">
7883879791 <doc xml:space="preserve"
7883979792 filename="glib/gregex.c"
78840- line="3505">the replacement string</doc>
79793+ line="3775">the replacement string</doc>
7884179794 <type name="utf8" c:type="const gchar*"/>
7884279795 </parameter>
7884379796 <parameter name="has_references"
@@ -78848,7 +79801,7 @@ subpattern) requires valid #GMatchInfo object.</doc>
7884879801 allow-none="1">
7884979802 <doc xml:space="preserve"
7885079803 filename="glib/gregex.c"
78851- line="3506">location to store information about
79804+ line="3776">location to store information about
7885279805 references in @replacement or %NULL</doc>
7885379806 <type name="gboolean" c:type="gboolean*"/>
7885479807 </parameter>
@@ -78867,7 +79820,7 @@ subpattern) requires valid #GMatchInfo object.</doc>
7886779820 version="2.30">
7886879821 <doc xml:space="preserve"
7886979822 filename="glib/gregex.c"
78870- line="3548">Escapes the nul characters in @string to "\x00". It can be used
79823+ line="3818">Escapes the nul characters in @string to "\x00". It can be used
7887179824 to compile a regex with embedded nul characters.
7887279825
7887379826 For completeness, @length can be -1 for a nul-terminated string.
@@ -78876,20 +79829,20 @@ In this case the output string will be of course equal to @string.</doc>
7887679829 <return-value transfer-ownership="full">
7887779830 <doc xml:space="preserve"
7887879831 filename="glib/gregex.c"
78879- line="3559">a newly-allocated escaped string</doc>
79832+ line="3829">a newly-allocated escaped string</doc>
7888079833 <type name="utf8" c:type="gchar*"/>
7888179834 </return-value>
7888279835 <parameters>
7888379836 <parameter name="string" transfer-ownership="none">
7888479837 <doc xml:space="preserve"
7888579838 filename="glib/gregex.c"
78886- line="3550">the string to escape</doc>
79839+ line="3820">the string to escape</doc>
7888779840 <type name="utf8" c:type="const gchar*"/>
7888879841 </parameter>
7888979842 <parameter name="length" transfer-ownership="none">
7889079843 <doc xml:space="preserve"
7889179844 filename="glib/gregex.c"
78892- line="3551">the length of @string</doc>
79845+ line="3821">the length of @string</doc>
7889379846 <type name="gint" c:type="gint"/>
7889479847 </parameter>
7889579848 </parameters>
@@ -78900,7 +79853,7 @@ In this case the output string will be of course equal to @string.</doc>
7890079853 version="2.14">
7890179854 <doc xml:space="preserve"
7890279855 filename="glib/gregex.c"
78903- line="3616">Escapes the special characters used for regular expressions
79856+ line="3886">Escapes the special characters used for regular expressions
7890479857 in @string, for instance "a.b*c" becomes "a\.b\*c". This
7890579858 function is useful to dynamically generate regular expressions.
7890679859
@@ -78911,20 +79864,20 @@ in @length.</doc>
7891179864 <return-value transfer-ownership="full">
7891279865 <doc xml:space="preserve"
7891379866 filename="glib/gregex.c"
78914- line="3629">a newly-allocated escaped string</doc>
79867+ line="3899">a newly-allocated escaped string</doc>
7891579868 <type name="utf8" c:type="gchar*"/>
7891679869 </return-value>
7891779870 <parameters>
7891879871 <parameter name="string" transfer-ownership="none">
7891979872 <doc xml:space="preserve"
7892079873 filename="glib/gregex.c"
78921- line="3618">the string to escape</doc>
79874+ line="3888">the string to escape</doc>
7892279875 <type name="utf8" c:type="const gchar*"/>
7892379876 </parameter>
7892479877 <parameter name="length" transfer-ownership="none">
7892579878 <doc xml:space="preserve"
7892679879 filename="glib/gregex.c"
78927- line="3619">the length of @string, in bytes, or -1 if @string is nul-terminated</doc>
79880+ line="3889">the length of @string, in bytes, or -1 if @string is nul-terminated</doc>
7892879881 <type name="gint" c:type="gint"/>
7892979882 </parameter>
7893079883 </parameters>
@@ -78935,7 +79888,7 @@ in @length.</doc>
7893579888 version="2.14">
7893679889 <doc xml:space="preserve"
7893779890 filename="glib/gregex.c"
78938- line="2105">Scans for a match in @string for @pattern.
79891+ line="2375">Scans for a match in @string for @pattern.
7893979892
7894079893 This function is equivalent to g_regex_match() but it does not
7894179894 require to compile the pattern with g_regex_new(), avoiding some
@@ -78949,32 +79902,32 @@ g_regex_new() and then use g_regex_match().</doc>
7894979902 <return-value transfer-ownership="none">
7895079903 <doc xml:space="preserve"
7895179904 filename="glib/gregex.c"
78952- line="2123">%TRUE if the string matched, %FALSE otherwise</doc>
79905+ line="2393">%TRUE if the string matched, %FALSE otherwise</doc>
7895379906 <type name="gboolean" c:type="gboolean"/>
7895479907 </return-value>
7895579908 <parameters>
7895679909 <parameter name="pattern" transfer-ownership="none">
7895779910 <doc xml:space="preserve"
7895879911 filename="glib/gregex.c"
78959- line="2107">the regular expression</doc>
79912+ line="2377">the regular expression</doc>
7896079913 <type name="utf8" c:type="const gchar*"/>
7896179914 </parameter>
7896279915 <parameter name="string" transfer-ownership="none">
7896379916 <doc xml:space="preserve"
7896479917 filename="glib/gregex.c"
78965- line="2108">the string to scan for matches</doc>
79918+ line="2378">the string to scan for matches</doc>
7896679919 <type name="utf8" c:type="const gchar*"/>
7896779920 </parameter>
7896879921 <parameter name="compile_options" transfer-ownership="none">
7896979922 <doc xml:space="preserve"
7897079923 filename="glib/gregex.c"
78971- line="2109">compile options for the regular expression, or 0</doc>
79924+ line="2379">compile options for the regular expression, or 0</doc>
7897279925 <type name="RegexCompileFlags" c:type="GRegexCompileFlags"/>
7897379926 </parameter>
7897479927 <parameter name="match_options" transfer-ownership="none">
7897579928 <doc xml:space="preserve"
7897679929 filename="glib/gregex.c"
78977- line="2110">match options, or 0</doc>
79930+ line="2380">match options, or 0</doc>
7897879931 <type name="RegexMatchFlags" c:type="GRegexMatchFlags"/>
7897979932 </parameter>
7898079933 </parameters>
@@ -78985,7 +79938,7 @@ g_regex_new() and then use g_regex_match().</doc>
7898579938 version="2.14">
7898679939 <doc xml:space="preserve"
7898779940 filename="glib/gregex.c"
78988- line="2531">Breaks the string on the pattern, and returns an array of
79941+ line="2801">Breaks the string on the pattern, and returns an array of
7898979942 the tokens. If the pattern contains capturing parentheses,
7899079943 then the text for each of the substrings will also be returned.
7899179944 If the pattern does not match anywhere in the string, then the
@@ -79016,7 +79969,7 @@ characters. For example splitting "ab c" using as a separator
7901679969 <return-value transfer-ownership="full">
7901779970 <doc xml:space="preserve"
7901879971 filename="glib/gregex.c"
79019- line="2566">a %NULL-terminated array of strings. Free
79972+ line="2836">a %NULL-terminated array of strings. Free
7902079973 it using g_strfreev()</doc>
7902179974 <array c:type="gchar**">
7902279975 <type name="utf8"/>
@@ -79026,25 +79979,25 @@ it using g_strfreev()</doc>
7902679979 <parameter name="pattern" transfer-ownership="none">
7902779980 <doc xml:space="preserve"
7902879981 filename="glib/gregex.c"
79029- line="2533">the regular expression</doc>
79982+ line="2803">the regular expression</doc>
7903079983 <type name="utf8" c:type="const gchar*"/>
7903179984 </parameter>
7903279985 <parameter name="string" transfer-ownership="none">
7903379986 <doc xml:space="preserve"
7903479987 filename="glib/gregex.c"
79035- line="2534">the string to scan for matches</doc>
79988+ line="2804">the string to scan for matches</doc>
7903679989 <type name="utf8" c:type="const gchar*"/>
7903779990 </parameter>
7903879991 <parameter name="compile_options" transfer-ownership="none">
7903979992 <doc xml:space="preserve"
7904079993 filename="glib/gregex.c"
79041- line="2535">compile options for the regular expression, or 0</doc>
79994+ line="2805">compile options for the regular expression, or 0</doc>
7904279995 <type name="RegexCompileFlags" c:type="GRegexCompileFlags"/>
7904379996 </parameter>
7904479997 <parameter name="match_options" transfer-ownership="none">
7904579998 <doc xml:space="preserve"
7904679999 filename="glib/gregex.c"
79047- line="2536">match options, or 0</doc>
80000+ line="2806">match options, or 0</doc>
7904880001 <type name="RegexMatchFlags" c:type="GRegexMatchFlags"/>
7904980002 </parameter>
7905080003 </parameters>
@@ -79054,7 +80007,7 @@ it using g_strfreev()</doc>
7905480007 version="2.22">
7905580008 <doc xml:space="preserve"
7905680009 filename="glib/gutils.c"
79057- line="2394">Resets the cache used for g_get_user_special_dir(), so
80010+ line="2396">Resets the cache used for g_get_user_special_dir(), so
7905880011 that the latest on-disk version is used. Call this only
7905980012 if you just changed the data on disk yourself.
7906080013
@@ -79070,7 +80023,7 @@ the directories that actually changed value though.</doc>
7907080023 <function name="remove" c:identifier="g_remove" version="2.6">
7907180024 <doc xml:space="preserve"
7907280025 filename="glib/gstdio.c"
79073- line="1445">A wrapper for the POSIX remove() function. The remove() function
80026+ line="1456">A wrapper for the POSIX remove() function. The remove() function
7907480027 deletes a name from the filesystem.
7907580028
7907680029 See your C library manual for more details about how remove() works
@@ -79090,7 +80043,7 @@ set by rmdir().</doc>
7909080043 <return-value transfer-ownership="none">
7909180044 <doc xml:space="preserve"
7909280045 filename="glib/gstdio.c"
79093- line="1467">0 if the file was successfully removed, -1 if an error
80046+ line="1478">0 if the file was successfully removed, -1 if an error
7909480047 occurred</doc>
7909580048 <type name="gint" c:type="int"/>
7909680049 </return-value>
@@ -79098,7 +80051,7 @@ set by rmdir().</doc>
7909880051 <parameter name="filename" transfer-ownership="none">
7909980052 <doc xml:space="preserve"
7910080053 filename="glib/gstdio.c"
79101- line="1447">a pathname in the GLib file name encoding
80054+ line="1458">a pathname in the GLib file name encoding
7910280055 (UTF-8 on Windows)</doc>
7910380056 <type name="filename" c:type="const gchar*"/>
7910480057 </parameter>
@@ -79107,7 +80060,7 @@ set by rmdir().</doc>
7910780060 <function name="rename" c:identifier="g_rename" version="2.6">
7910880061 <doc xml:space="preserve"
7910980062 filename="glib/gstdio.c"
79110- line="1140">A wrapper for the POSIX rename() function. The rename() function
80063+ line="1151">A wrapper for the POSIX rename() function. The rename() function
7911180064 renames a file, moving it between directories if required.
7911280065
7911380066 See your C library manual for more details about how rename() works
@@ -79117,21 +80070,21 @@ a file that is open to some process.</doc>
7911780070 <return-value transfer-ownership="none">
7911880071 <doc xml:space="preserve"
7911980072 filename="glib/gstdio.c"
79120- line="1153">0 if the renaming succeeded, -1 if an error occurred</doc>
80073+ line="1164">0 if the renaming succeeded, -1 if an error occurred</doc>
7912180074 <type name="gint" c:type="int"/>
7912280075 </return-value>
7912380076 <parameters>
7912480077 <parameter name="oldfilename" transfer-ownership="none">
7912580078 <doc xml:space="preserve"
7912680079 filename="glib/gstdio.c"
79127- line="1142">a pathname in the GLib file name encoding
80080+ line="1153">a pathname in the GLib file name encoding
7912880081 (UTF-8 on Windows)</doc>
7912980082 <type name="filename" c:type="const gchar*"/>
7913080083 </parameter>
7913180084 <parameter name="newfilename" transfer-ownership="none">
7913280085 <doc xml:space="preserve"
7913380086 filename="glib/gstdio.c"
79134- line="1144">a pathname in the GLib file name encoding</doc>
80087+ line="1155">a pathname in the GLib file name encoding</doc>
7913580088 <type name="filename" c:type="const gchar*"/>
7913680089 </parameter>
7913780090 </parameters>
@@ -79165,7 +80118,7 @@ Care is taken to avoid overflow when calculating the size of the allocated block
7916580118 <function-macro name="return_if_fail"
7916680119 c:identifier="g_return_if_fail"
7916780120 introspectable="0">
79168- <source-position filename="glib/gmessages.h" line="599"/>
80121+ <source-position filename="glib/gmessages.h" line="602"/>
7916980122 <parameters>
7917080123 <parameter name="expr">
7917180124 </parameter>
@@ -79176,9 +80129,9 @@ Care is taken to avoid overflow when calculating the size of the allocated block
7917680129 introspectable="0">
7917780130 <doc xml:space="preserve"
7917880131 filename="glib/gmessages.c"
79179- line="3062">Internal function used to print messages from the public [func@GLib.return_if_fail]
80132+ line="3148">Internal function used to print messages from the public [func@GLib.return_if_fail]
7918080133 and [func@GLib.return_val_if_fail] macros.</doc>
79181- <source-position filename="glib/gmessages.h" line="293"/>
80134+ <source-position filename="glib/gmessages.h" line="296"/>
7918280135 <return-value transfer-ownership="none">
7918380136 <type name="none" c:type="void"/>
7918480137 </return-value>
@@ -79189,13 +80142,13 @@ and [func@GLib.return_val_if_fail] macros.</doc>
7918980142 allow-none="1">
7919080143 <doc xml:space="preserve"
7919180144 filename="glib/gmessages.c"
79192- line="3064">log domain</doc>
80145+ line="3150">log domain</doc>
7919380146 <type name="utf8" c:type="const char*"/>
7919480147 </parameter>
7919580148 <parameter name="pretty_function" transfer-ownership="none">
7919680149 <doc xml:space="preserve"
7919780150 filename="glib/gmessages.c"
79198- line="3065">function containing the assertion</doc>
80151+ line="3151">function containing the assertion</doc>
7919980152 <type name="utf8" c:type="const char*"/>
7920080153 </parameter>
7920180154 <parameter name="expression"
@@ -79204,7 +80157,7 @@ and [func@GLib.return_val_if_fail] macros.</doc>
7920480157 allow-none="1">
7920580158 <doc xml:space="preserve"
7920680159 filename="glib/gmessages.c"
79207- line="3066">expression which failed</doc>
80160+ line="3152">expression which failed</doc>
7920880161 <type name="utf8" c:type="const char*"/>
7920980162 </parameter>
7921080163 </parameters>
@@ -79212,12 +80165,12 @@ and [func@GLib.return_val_if_fail] macros.</doc>
7921280165 <function-macro name="return_if_reached"
7921380166 c:identifier="g_return_if_reached"
7921480167 introspectable="0">
79215- <source-position filename="glib/gmessages.h" line="635"/>
80168+ <source-position filename="glib/gmessages.h" line="638"/>
7921680169 </function-macro>
7921780170 <function-macro name="return_val_if_fail"
7921880171 c:identifier="g_return_val_if_fail"
7921980172 introspectable="0">
79220- <source-position filename="glib/gmessages.h" line="625"/>
80173+ <source-position filename="glib/gmessages.h" line="628"/>
7922180174 <parameters>
7922280175 <parameter name="expr">
7922380176 </parameter>
@@ -79228,7 +80181,7 @@ and [func@GLib.return_val_if_fail] macros.</doc>
7922880181 <function-macro name="return_val_if_reached"
7922980182 c:identifier="g_return_val_if_reached"
7923080183 introspectable="0">
79231- <source-position filename="glib/gmessages.h" line="645"/>
80184+ <source-position filename="glib/gmessages.h" line="648"/>
7923280185 <parameters>
7923380186 <parameter name="val">
7923480187 </parameter>
@@ -79237,7 +80190,7 @@ and [func@GLib.return_val_if_fail] macros.</doc>
7923780190 <function name="rmdir" c:identifier="g_rmdir" version="2.6">
7923880191 <doc xml:space="preserve"
7923980192 filename="glib/gstdio.c"
79240- line="1500">A wrapper for the POSIX rmdir() function. The rmdir() function
80193+ line="1511">A wrapper for the POSIX rmdir() function. The rmdir() function
7924180194 deletes a directory from the filesystem.
7924280195
7924380196 See your C library manual for more details about how rmdir() works
@@ -79246,7 +80199,7 @@ on your system.</doc>
7924680199 <return-value transfer-ownership="none">
7924780200 <doc xml:space="preserve"
7924880201 filename="glib/gstdio.c"
79249- line="1511">0 if the directory was successfully removed, -1 if an error
80202+ line="1522">0 if the directory was successfully removed, -1 if an error
7925080203 occurred</doc>
7925180204 <type name="gint" c:type="int"/>
7925280205 </return-value>
@@ -79254,7 +80207,7 @@ on your system.</doc>
7925480207 <parameter name="filename" transfer-ownership="none">
7925580208 <doc xml:space="preserve"
7925680209 filename="glib/gstdio.c"
79257- line="1502">a pathname in the GLib file name encoding
80210+ line="1513">a pathname in the GLib file name encoding
7925880211 (UTF-8 on Windows)</doc>
7925980212 <type name="filename" c:type="const gchar*"/>
7926080213 </parameter>
@@ -79943,7 +80896,7 @@ for requirements on integrating g_set_prgname() with GTK applications.</doc>
7994380896 introspectable="0">
7994480897 <doc xml:space="preserve"
7994580898 filename="glib/gmessages.c"
79946- line="3439">Sets the print handler to @func, or resets it to the
80899+ line="3539">Sets the print handler to @func, or resets it to the
7994780900 default GLib handler if `NULL`.
7994880901
7994980902 Any messages passed to [func@GLib.print] will be output via
@@ -79958,11 +80911,11 @@ print handler was set, it will return the GLib
7995880911 default print handler and that can be re-used to
7995980912 decorate its output and/or to write to `stderr`
7996080913 in all platforms. Before GLib 2.76, this was `NULL`.</doc>
79961- <source-position filename="glib/gmessages.h" line="530"/>
80914+ <source-position filename="glib/gmessages.h" line="533"/>
7996280915 <return-value>
7996380916 <doc xml:space="preserve"
7996480917 filename="glib/gmessages.c"
79965- line="3460">the old print handler</doc>
80918+ line="3560">the old print handler</doc>
7996680919 <type name="PrintFunc" c:type="GPrintFunc"/>
7996780920 </return-value>
7996880921 <parameters>
@@ -79972,7 +80925,7 @@ in all platforms. Before GLib 2.76, this was `NULL`.</doc>
7997280925 allow-none="1">
7997380926 <doc xml:space="preserve"
7997480927 filename="glib/gmessages.c"
79975- line="3441">the new print handler or `NULL` to
80928+ line="3541">the new print handler or `NULL` to
7997680929 reset to the default</doc>
7997780930 <type name="PrintFunc" c:type="GPrintFunc"/>
7997880931 </parameter>
@@ -79983,7 +80936,7 @@ in all platforms. Before GLib 2.76, this was `NULL`.</doc>
7998380936 introspectable="0">
7998480937 <doc xml:space="preserve"
7998580938 filename="glib/gmessages.c"
79986- line="3569">Sets the handler for printing error messages to @func,
80939+ line="3655">Sets the handler for printing error messages to @func,
7998780940 or resets it to the default GLib handler if `NULL`.
7998880941
7998980942 Any messages passed to [func@GLib.printerr] will be output via
@@ -79998,11 +80951,11 @@ print handler was set, it will return the GLib default
7999880951 error print handler and that can be re-used to decorate
7999980952 its output and/or to write to `stderr` in all platforms.
8000080953 Before GLib 2.76, this was `NULL`.</doc>
80001- <source-position filename="glib/gmessages.h" line="535"/>
80954+ <source-position filename="glib/gmessages.h" line="538"/>
8000280955 <return-value>
8000380956 <doc xml:space="preserve"
8000480957 filename="glib/gmessages.c"
80005- line="3590">the old error message handler</doc>
80958+ line="3676">the old error message handler</doc>
8000680959 <type name="PrintFunc" c:type="GPrintFunc"/>
8000780960 </return-value>
8000880961 <parameters>
@@ -80012,7 +80965,7 @@ Before GLib 2.76, this was `NULL`.</doc>
8001280965 allow-none="1">
8001380966 <doc xml:space="preserve"
8001480967 filename="glib/gmessages.c"
80015- line="3571">he new error message handler or `NULL`
80968+ line="3657">he new error message handler or `NULL`
8001680969 to reset to the default</doc>
8001780970 <type name="PrintFunc" c:type="GPrintFunc"/>
8001880971 </parameter>
@@ -80136,7 +81089,7 @@ array directly to execvpe(), g_spawn_async(), or the like.</doc>
8013681089 throws="1">
8013781090 <doc xml:space="preserve"
8013881091 filename="glib/gshell.c"
80139- line="617">Parses a command line into an argument vector, in much the same way
81092+ line="622">Parses a command line into an argument vector, in much the same way
8014081093 the shell would, but without many of the expansions the shell would
8014181094 perform (variable expansion, globs, operators, filename expansion,
8014281095 etc. are not supported).
@@ -80158,14 +81111,14 @@ Free the returned vector with g_strfreev().</doc>
8015881111 <return-value transfer-ownership="none">
8015981112 <doc xml:space="preserve"
8016081113 filename="glib/gshell.c"
80161- line="644">%TRUE on success, %FALSE if error set</doc>
81114+ line="649">%TRUE on success, %FALSE if error set</doc>
8016281115 <type name="gboolean" c:type="gboolean"/>
8016381116 </return-value>
8016481117 <parameters>
8016581118 <parameter name="command_line" transfer-ownership="none">
8016681119 <doc xml:space="preserve"
8016781120 filename="glib/gshell.c"
80168- line="619">command line to parse</doc>
81121+ line="624">command line to parse</doc>
8016981122 <type name="filename" c:type="const gchar*"/>
8017081123 </parameter>
8017181124 <parameter name="argcp"
@@ -80176,7 +81129,7 @@ Free the returned vector with g_strfreev().</doc>
8017681129 allow-none="1">
8017781130 <doc xml:space="preserve"
8017881131 filename="glib/gshell.c"
80179- line="620">return location for number of args</doc>
81132+ line="625">return location for number of args</doc>
8018081133 <type name="gint" c:type="gint*"/>
8018181134 </parameter>
8018281135 <parameter name="argvp"
@@ -80187,7 +81140,7 @@ Free the returned vector with g_strfreev().</doc>
8018781140 allow-none="1">
8018881141 <doc xml:space="preserve"
8018981142 filename="glib/gshell.c"
80190- line="621">
81143+ line="626">
8019181144 return location for array of args</doc>
8019281145 <array length="1" zero-terminated="1" c:type="gchar***">
8019381146 <type name="filename"/>
@@ -80718,7 +81671,9 @@ Note that it is considered perfectly acceptable to access
8071881671 </function-macro>
8071981672 <function name="slist_pop_allocator"
8072081673 c:identifier="g_slist_pop_allocator"
80721- moved-to="SList.pop_allocator">
81674+ moved-to="SList.pop_allocator"
81675+ deprecated="1"
81676+ deprecated-version="2.10">
8072281677 <source-position filename="glib/deprecated/gallocator.h" line="80"/>
8072381678 <return-value transfer-ownership="none">
8072481679 <type name="none" c:type="void"/>
@@ -80726,7 +81681,9 @@ Note that it is considered perfectly acceptable to access
8072681681 </function>
8072781682 <function name="slist_push_allocator"
8072881683 c:identifier="g_slist_push_allocator"
80729- moved-to="SList.push_allocator">
81684+ moved-to="SList.push_allocator"
81685+ deprecated="1"
81686+ deprecated-version="2.10">
8073081687 <source-position filename="glib/deprecated/gallocator.h" line="78"/>
8073181688 <return-value transfer-ownership="none">
8073281689 <type name="none" c:type="void"/>
@@ -80740,7 +81697,7 @@ Note that it is considered perfectly acceptable to access
8074081697 <function name="snprintf" c:identifier="g_snprintf" introspectable="0">
8074181698 <doc xml:space="preserve"
8074281699 filename="glib/gprintf.c"
80743- line="133">A safer form of the standard sprintf() function. The output is guaranteed
81700+ line="134">A safer form of the standard sprintf() function. The output is guaranteed
8074481701 to not exceed @n characters (including the terminating nul character), so
8074581702 it is easy to ensure that a buffer overflow cannot occur.
8074681703
@@ -80761,7 +81718,7 @@ the Single Unix Specification.</doc>
8076181718 <return-value transfer-ownership="none">
8076281719 <doc xml:space="preserve"
8076381720 filename="glib/gprintf.c"
80764- line="160">the number of bytes which would be produced if the buffer
81721+ line="161">the number of bytes which would be produced if the buffer
8076581722 was large enough</doc>
8076681723 <type name="gint" c:type="gint"/>
8076781724 </return-value>
@@ -80769,27 +81726,27 @@ the Single Unix Specification.</doc>
8076981726 <parameter name="string" transfer-ownership="none">
8077081727 <doc xml:space="preserve"
8077181728 filename="glib/gprintf.c"
80772- line="135">the buffer to hold the output</doc>
81729+ line="136">the buffer to hold the output</doc>
8077381730 <type name="utf8" c:type="gchar*"/>
8077481731 </parameter>
8077581732 <parameter name="n" transfer-ownership="none">
8077681733 <doc xml:space="preserve"
8077781734 filename="glib/gprintf.c"
80778- line="136">the maximum number of bytes to produce (including the
81735+ line="137">the maximum number of bytes to produce (including the
8077981736 terminating nul character)</doc>
8078081737 <type name="gulong" c:type="gulong"/>
8078181738 </parameter>
8078281739 <parameter name="format" transfer-ownership="none">
8078381740 <doc xml:space="preserve"
8078481741 filename="glib/gprintf.c"
80785- line="138">a standard `printf()` format string, but notice
81742+ line="139">a standard `printf()` format string, but notice
8078681743 [string precision pitfalls](string-utils.html#string-precision-pitfalls)</doc>
8078781744 <type name="utf8" c:type="const gchar*"/>
8078881745 </parameter>
8078981746 <parameter name="..." transfer-ownership="none">
8079081747 <doc xml:space="preserve"
8079181748 filename="glib/gprintf.c"
80792- line="140">the arguments to insert in the output</doc>
81749+ line="141">the arguments to insert in the output</doc>
8079381750 <varargs/>
8079481751 </parameter>
8079581752 </parameters>
@@ -80855,10 +81812,12 @@ Unlike `qsort()`, this is guaranteed to be a stable sort.</doc>
8085581812 moved-to="Source.remove">
8085681813 <doc xml:space="preserve"
8085781814 filename="glib/gmain.c"
80858- line="2521">Removes the source with the given ID from the default main context. You must
81815+ line="2676">Removes the source with the given ID from the default main context.
81816+
81817+You must
8085981818 use [method@GLib.Source.destroy] for sources added to a non-default main context.
8086081819
80861-The ID of a #GSource is given by [method@GLib.Source.get_id], or will be
81820+The ID of a [struct@GLib.Source] is given by [method@GLib.Source.get_id], or will be
8086281821 returned by the functions [method@GLib.Source.attach], [func@GLib.idle_add],
8086381822 [func@GLib.idle_add_full], [func@GLib.timeout_add],
8086481823 [func@GLib.timeout_add_full], [func@GLib.child_watch_add],
@@ -80875,18 +81834,18 @@ idle may already have run and been removed by the time this function
8087581834 is called on its (now invalid) source ID. This source ID may have
8087681835 been reissued, leading to the operation being performed against the
8087781836 wrong source.</doc>
80878- <source-position filename="glib/gmain.h" line="836"/>
81837+ <source-position filename="glib/gmain.h" line="839"/>
8087981838 <return-value transfer-ownership="none">
8088081839 <doc xml:space="preserve"
8088181840 filename="glib/gmain.c"
80882- line="2546">%TRUE if the source was found and removed.</doc>
81841+ line="2703">true if the source was found and removed, false otherwise</doc>
8088381842 <type name="gboolean" c:type="gboolean"/>
8088481843 </return-value>
8088581844 <parameters>
8088681845 <parameter name="tag" transfer-ownership="none">
8088781846 <doc xml:space="preserve"
8088881847 filename="glib/gmain.c"
80889- line="2523">the ID of the source to remove.</doc>
81848+ line="2678">the ID of the source to remove.</doc>
8089081849 <type name="guint" c:type="guint"/>
8089181850 </parameter>
8089281851 </parameters>
@@ -80896,21 +81855,23 @@ wrong source.</doc>
8089681855 moved-to="Source.remove_by_funcs_user_data">
8089781856 <doc xml:space="preserve"
8089881857 filename="glib/gmain.c"
80899- line="2589">Removes a source from the default main loop context given the
80900-source functions and user data. If multiple sources exist with the
80901-same source functions and user data, only one will be destroyed.</doc>
80902- <source-position filename="glib/gmain.h" line="840"/>
81858+ line="2747">Removes a source from the default main loop context given the
81859+source functions and user data.
81860+
81861+If multiple sources exist with the same source functions and user data, only
81862+one will be destroyed.</doc>
81863+ <source-position filename="glib/gmain.h" line="843"/>
8090381864 <return-value transfer-ownership="none">
8090481865 <doc xml:space="preserve"
8090581866 filename="glib/gmain.c"
80906- line="2598">%TRUE if a source was found and removed.</doc>
81867+ line="2758">true if a source was found and removed, false otherwise</doc>
8090781868 <type name="gboolean" c:type="gboolean"/>
8090881869 </return-value>
8090981870 <parameters>
8091081871 <parameter name="funcs" transfer-ownership="none">
8091181872 <doc xml:space="preserve"
8091281873 filename="glib/gmain.c"
80913- line="2591">The @source_funcs passed to [ctor@GLib.Source.new]</doc>
81874+ line="2749">the @source_funcs passed to [ctor@GLib.Source.new]</doc>
8091481875 <type name="SourceFuncs" c:type="GSourceFuncs*"/>
8091581876 </parameter>
8091681877 <parameter name="user_data"
@@ -80919,7 +81880,7 @@ same source functions and user data, only one will be destroyed.</doc>
8091981880 allow-none="1">
8092081881 <doc xml:space="preserve"
8092181882 filename="glib/gmain.c"
80922- line="2592">the user data for the callback</doc>
81883+ line="2750">the user data for the callback</doc>
8092381884 <type name="gpointer" c:type="gpointer"/>
8092481885 </parameter>
8092581886 </parameters>
@@ -80929,14 +81890,15 @@ same source functions and user data, only one will be destroyed.</doc>
8092981890 moved-to="Source.remove_by_user_data">
8093081891 <doc xml:space="preserve"
8093181892 filename="glib/gmain.c"
80932- line="2564">Removes a source from the default main loop context given the user
80933-data for the callback. If multiple sources exist with the same user
80934-data, only one will be destroyed.</doc>
80935- <source-position filename="glib/gmain.h" line="838"/>
81893+ line="2721">Removes a source from the default main loop context given the user
81894+data for the callback.
81895+
81896+If multiple sources exist with the same user data, only one will be destroyed.</doc>
81897+ <source-position filename="glib/gmain.h" line="841"/>
8093681898 <return-value transfer-ownership="none">
8093781899 <doc xml:space="preserve"
8093881900 filename="glib/gmain.c"
80939- line="2572">%TRUE if a source was found and removed.</doc>
81901+ line="2730">true if a source was found and removed, false otherwise</doc>
8094081902 <type name="gboolean" c:type="gboolean"/>
8094181903 </return-value>
8094281904 <parameters>
@@ -80946,7 +81908,7 @@ data, only one will be destroyed.</doc>
8094681908 allow-none="1">
8094781909 <doc xml:space="preserve"
8094881910 filename="glib/gmain.c"
80949- line="2566">the user_data for the callback.</doc>
81911+ line="2723">the user_data for the callback</doc>
8095081912 <type name="gpointer" c:type="gpointer"/>
8095181913 </parameter>
8095281914 </parameters>
@@ -80957,7 +81919,7 @@ data, only one will be destroyed.</doc>
8095781919 version="2.26">
8095881920 <doc xml:space="preserve"
8095981921 filename="glib/gmain.c"
80960- line="2150">Sets the name of a source using its ID.
81922+ line="2293">Sets the name of a source using its ID.
8096181923
8096281924 This is a convenience utility to set source names from the return
8096381925 value of [func@GLib.idle_add], [func@GLib.timeout_add], etc.
@@ -80973,7 +81935,7 @@ idle may already have run and been removed by the time this function
8097381935 is called on its (now invalid) source ID. This source ID may have
8097481936 been reissued, leading to the operation being performed against the
8097581937 wrong source.</doc>
80976- <source-position filename="glib/gmain.h" line="751"/>
81938+ <source-position filename="glib/gmain.h" line="754"/>
8097781939 <return-value transfer-ownership="none">
8097881940 <type name="none" c:type="void"/>
8097981941 </return-value>
@@ -80981,13 +81943,13 @@ wrong source.</doc>
8098181943 <parameter name="tag" transfer-ownership="none">
8098281944 <doc xml:space="preserve"
8098381945 filename="glib/gmain.c"
80984- line="2152">a #GSource ID</doc>
81946+ line="2295">a source ID</doc>
8098581947 <type name="guint" c:type="guint"/>
8098681948 </parameter>
8098781949 <parameter name="name" transfer-ownership="none">
8098881950 <doc xml:space="preserve"
8098981951 filename="glib/gmain.c"
80990- line="2153">debug name for the source</doc>
81952+ line="2296">debug name for the source</doc>
8099181953 <type name="utf8" c:type="const char*"/>
8099281954 </parameter>
8099381955 </parameters>
@@ -81024,8 +81986,9 @@ each prime is approximately 1.5-2 times the previous prime.</doc>
8102481986 filename="glib/gspawn.c"
8102581987 line="35">Executes a child program asynchronously.
8102681988
81027-See g_spawn_async_with_pipes() for a full description; this function
81028-simply calls the g_spawn_async_with_pipes() without any pipes.
81989+See g_spawn_async_with_pipes_and_fds() for a full description; this function
81990+simply calls the g_spawn_async_with_pipes() without any pipes, which in turn
81991+calls g_spawn_async_with_pipes_and_fds().
8102981992
8103081993 You should call g_spawn_close_pid() on the returned child process
8103181994 reference when you don't need it any more.
@@ -81042,7 +82005,7 @@ are different concepts on Windows.</doc>
8104282005 <return-value transfer-ownership="none">
8104382006 <doc xml:space="preserve"
8104482007 filename="glib/gspawn.c"
81045- line="67">%TRUE on success, %FALSE if error is set</doc>
82008+ line="68">%TRUE on success, %FALSE if error is set</doc>
8104682009 <type name="gboolean" c:type="gboolean"/>
8104782010 </return-value>
8104882011 <parameters>
@@ -81123,7 +82086,7 @@ are different concepts on Windows.</doc>
8112382086 throws="1">
8112482087 <doc xml:space="preserve"
8112582088 filename="glib/gspawn.c"
81126- line="474">Executes a child program asynchronously.
82089+ line="475">Executes a child program asynchronously.
8112782090
8112882091 Identical to g_spawn_async_with_pipes_and_fds() but with `n_fds` set to zero,
8112982092 so no FD assignments are used.</doc>
@@ -81131,7 +82094,7 @@ so no FD assignments are used.</doc>
8113182094 <return-value transfer-ownership="none">
8113282095 <doc xml:space="preserve"
8113382096 filename="glib/gspawn.c"
81134- line="495">%TRUE on success, %FALSE if an error was set</doc>
82097+ line="496">%TRUE on success, %FALSE if an error was set</doc>
8113582098 <type name="gboolean" c:type="gboolean"/>
8113682099 </return-value>
8113782100 <parameters>
@@ -81141,13 +82104,13 @@ so no FD assignments are used.</doc>
8114182104 allow-none="1">
8114282105 <doc xml:space="preserve"
8114382106 filename="glib/gspawn.c"
81144- line="476">child's current working directory, or %NULL to inherit parent's, in the GLib file name encoding</doc>
82107+ line="477">child's current working directory, or %NULL to inherit parent's, in the GLib file name encoding</doc>
8114582108 <type name="filename" c:type="const gchar*"/>
8114682109 </parameter>
8114782110 <parameter name="argv" transfer-ownership="none">
8114882111 <doc xml:space="preserve"
8114982112 filename="glib/gspawn.c"
81150- line="477">child's argument vector, in the GLib file name encoding;
82113+ line="478">child's argument vector, in the GLib file name encoding;
8115182114 it must be non-empty and %NULL-terminated</doc>
8115282115 <array c:type="gchar**">
8115382116 <type name="utf8" c:type="gchar*"/>
@@ -81159,7 +82122,7 @@ so no FD assignments are used.</doc>
8115982122 allow-none="1">
8116082123 <doc xml:space="preserve"
8116182124 filename="glib/gspawn.c"
81162- line="479">child's environment, or %NULL to inherit parent's, in the GLib file name encoding</doc>
82125+ line="480">child's environment, or %NULL to inherit parent's, in the GLib file name encoding</doc>
8116382126 <array c:type="gchar**">
8116482127 <type name="utf8" c:type="gchar*"/>
8116582128 </array>
@@ -81167,7 +82130,7 @@ so no FD assignments are used.</doc>
8116782130 <parameter name="flags" transfer-ownership="none">
8116882131 <doc xml:space="preserve"
8116982132 filename="glib/gspawn.c"
81170- line="480">flags from #GSpawnFlags</doc>
82133+ line="481">flags from #GSpawnFlags</doc>
8117182134 <type name="SpawnFlags" c:type="GSpawnFlags"/>
8117282135 </parameter>
8117382136 <parameter name="child_setup"
@@ -81178,7 +82141,7 @@ so no FD assignments are used.</doc>
8117882141 closure="5">
8117982142 <doc xml:space="preserve"
8118082143 filename="glib/gspawn.c"
81181- line="481">function to run
82144+ line="482">function to run
8118282145 in the child just before `exec()`</doc>
8118382146 <type name="SpawnChildSetupFunc" c:type="GSpawnChildSetupFunc"/>
8118482147 </parameter>
@@ -81188,7 +82151,7 @@ so no FD assignments are used.</doc>
8118882151 allow-none="1">
8118982152 <doc xml:space="preserve"
8119082153 filename="glib/gspawn.c"
81191- line="483">user data for @child_setup</doc>
82154+ line="484">user data for @child_setup</doc>
8119282155 <type name="gpointer" c:type="gpointer"/>
8119382156 </parameter>
8119482157 <parameter name="child_pid"
@@ -81199,25 +82162,25 @@ so no FD assignments are used.</doc>
8119982162 allow-none="1">
8120082163 <doc xml:space="preserve"
8120182164 filename="glib/gspawn.c"
81202- line="484">return location for child process ID, or %NULL</doc>
82165+ line="485">return location for child process ID, or %NULL</doc>
8120382166 <type name="Pid" c:type="GPid*"/>
8120482167 </parameter>
8120582168 <parameter name="stdin_fd" transfer-ownership="none">
8120682169 <doc xml:space="preserve"
8120782170 filename="glib/gspawn.c"
81208- line="485">file descriptor to use for child's stdin, or `-1`</doc>
82171+ line="486">file descriptor to use for child's stdin, or `-1`</doc>
8120982172 <type name="gint" c:type="gint"/>
8121082173 </parameter>
8121182174 <parameter name="stdout_fd" transfer-ownership="none">
8121282175 <doc xml:space="preserve"
8121382176 filename="glib/gspawn.c"
81214- line="486">file descriptor to use for child's stdout, or `-1`</doc>
82177+ line="487">file descriptor to use for child's stdout, or `-1`</doc>
8121582178 <type name="gint" c:type="gint"/>
8121682179 </parameter>
8121782180 <parameter name="stderr_fd" transfer-ownership="none">
8121882181 <doc xml:space="preserve"
8121982182 filename="glib/gspawn.c"
81220- line="487">file descriptor to use for child's stderr, or `-1`</doc>
82183+ line="488">file descriptor to use for child's stderr, or `-1`</doc>
8122182184 <type name="gint" c:type="gint"/>
8122282185 </parameter>
8122382186 </parameters>
@@ -81227,13 +82190,13 @@ so no FD assignments are used.</doc>
8122782190 throws="1">
8122882191 <doc xml:space="preserve"
8122982192 filename="glib/gspawn.c"
81230- line="157">Identical to g_spawn_async_with_pipes_and_fds() but with `n_fds` set to zero,
82193+ line="158">Identical to g_spawn_async_with_pipes_and_fds() but with `n_fds` set to zero,
8123182194 so no FD assignments are used.</doc>
8123282195 <source-position filename="glib/gspawn.h" line="239"/>
8123382196 <return-value transfer-ownership="none">
8123482197 <doc xml:space="preserve"
8123582198 filename="glib/gspawn.c"
81236- line="179">%TRUE on success, %FALSE if an error was set</doc>
82199+ line="180">%TRUE on success, %FALSE if an error was set</doc>
8123782200 <type name="gboolean" c:type="gboolean"/>
8123882201 </return-value>
8123982202 <parameters>
@@ -81243,14 +82206,14 @@ so no FD assignments are used.</doc>
8124382206 allow-none="1">
8124482207 <doc xml:space="preserve"
8124582208 filename="glib/gspawn.c"
81246- line="159">child's current working
82209+ line="160">child's current working
8124782210 directory, or %NULL to inherit parent's, in the GLib file name encoding</doc>
8124882211 <type name="filename" c:type="const gchar*"/>
8124982212 </parameter>
8125082213 <parameter name="argv" transfer-ownership="none">
8125182214 <doc xml:space="preserve"
8125282215 filename="glib/gspawn.c"
81253- line="161">child's argument
82216+ line="162">child's argument
8125482217 vector, in the GLib file name encoding; it must be non-empty and %NULL-terminated</doc>
8125582218 <array c:type="gchar**">
8125682219 <type name="filename"/>
@@ -81262,7 +82225,7 @@ so no FD assignments are used.</doc>
8126282225 allow-none="1">
8126382226 <doc xml:space="preserve"
8126482227 filename="glib/gspawn.c"
81265- line="163">
82228+ line="164">
8126682229 child's environment, or %NULL to inherit parent's, in the GLib file
8126782230 name encoding</doc>
8126882231 <array c:type="gchar**">
@@ -81272,7 +82235,7 @@ so no FD assignments are used.</doc>
8127282235 <parameter name="flags" transfer-ownership="none">
8127382236 <doc xml:space="preserve"
8127482237 filename="glib/gspawn.c"
81275- line="166">flags from #GSpawnFlags</doc>
82238+ line="167">flags from #GSpawnFlags</doc>
8127682239 <type name="SpawnFlags" c:type="GSpawnFlags"/>
8127782240 </parameter>
8127882241 <parameter name="child_setup"
@@ -81283,7 +82246,7 @@ so no FD assignments are used.</doc>
8128382246 closure="5">
8128482247 <doc xml:space="preserve"
8128582248 filename="glib/gspawn.c"
81286- line="167">function to run
82249+ line="168">function to run
8128782250 in the child just before `exec()`</doc>
8128882251 <type name="SpawnChildSetupFunc" c:type="GSpawnChildSetupFunc"/>
8128982252 </parameter>
@@ -81293,7 +82256,7 @@ so no FD assignments are used.</doc>
8129382256 allow-none="1">
8129482257 <doc xml:space="preserve"
8129582258 filename="glib/gspawn.c"
81296- line="169">user data for @child_setup</doc>
82259+ line="170">user data for @child_setup</doc>
8129782260 <type name="gpointer" c:type="gpointer"/>
8129882261 </parameter>
8129982262 <parameter name="child_pid"
@@ -81304,7 +82267,7 @@ so no FD assignments are used.</doc>
8130482267 allow-none="1">
8130582268 <doc xml:space="preserve"
8130682269 filename="glib/gspawn.c"
81307- line="170">return location for child process ID, or %NULL</doc>
82270+ line="171">return location for child process ID, or %NULL</doc>
8130882271 <type name="Pid" c:type="GPid*"/>
8130982272 </parameter>
8131082273 <parameter name="standard_input"
@@ -81315,7 +82278,7 @@ so no FD assignments are used.</doc>
8131582278 allow-none="1">
8131682279 <doc xml:space="preserve"
8131782280 filename="glib/gspawn.c"
81318- line="171">return location for file descriptor to write to child's stdin, or %NULL</doc>
82281+ line="172">return location for file descriptor to write to child's stdin, or %NULL</doc>
8131982282 <type name="gint" c:type="gint*"/>
8132082283 </parameter>
8132182284 <parameter name="standard_output"
@@ -81326,7 +82289,7 @@ so no FD assignments are used.</doc>
8132682289 allow-none="1">
8132782290 <doc xml:space="preserve"
8132882291 filename="glib/gspawn.c"
81329- line="172">return location for file descriptor to read child's stdout, or %NULL</doc>
82292+ line="173">return location for file descriptor to read child's stdout, or %NULL</doc>
8133082293 <type name="gint" c:type="gint*"/>
8133182294 </parameter>
8133282295 <parameter name="standard_error"
@@ -81337,7 +82300,7 @@ so no FD assignments are used.</doc>
8133782300 allow-none="1">
8133882301 <doc xml:space="preserve"
8133982302 filename="glib/gspawn.c"
81340- line="173">return location for file descriptor to read child's stderr, or %NULL</doc>
82303+ line="174">return location for file descriptor to read child's stderr, or %NULL</doc>
8134182304 <type name="gint" c:type="gint*"/>
8134282305 </parameter>
8134382306 </parameters>
@@ -81348,7 +82311,7 @@ so no FD assignments are used.</doc>
8134882311 throws="1">
8134982312 <doc xml:space="preserve"
8135082313 filename="glib/gspawn.c"
81351- line="208">Executes a child program asynchronously (your program will not
82314+ line="209">Executes a child program asynchronously (your program will not
8135282315 block waiting for the child to exit).
8135382316
8135482317 The child program is specified by the only argument that must be
@@ -81546,7 +82509,7 @@ windows on the right screen, you may want to use #GdkAppLaunchContext,
8154682509 <return-value transfer-ownership="none">
8154782510 <doc xml:space="preserve"
8154882511 filename="glib/gspawn.c"
81549- line="430">%TRUE on success, %FALSE if an error was set</doc>
82512+ line="431">%TRUE on success, %FALSE if an error was set</doc>
8155082513 <type name="gboolean" c:type="gboolean"/>
8155182514 </return-value>
8155282515 <parameters>
@@ -81556,14 +82519,14 @@ windows on the right screen, you may want to use #GdkAppLaunchContext,
8155682519 allow-none="1">
8155782520 <doc xml:space="preserve"
8155882521 filename="glib/gspawn.c"
81559- line="210">child's current working
82522+ line="211">child's current working
8156082523 directory, or %NULL to inherit parent's, in the GLib file name encoding</doc>
8156182524 <type name="filename" c:type="const gchar*"/>
8156282525 </parameter>
8156382526 <parameter name="argv" transfer-ownership="none">
8156482527 <doc xml:space="preserve"
8156582528 filename="glib/gspawn.c"
81566- line="212">child's argument
82529+ line="213">child's argument
8156782530 vector, in the GLib file name encoding; it must be non-empty and %NULL-terminated</doc>
8156882531 <array c:type="const gchar* const*">
8156982532 <type name="filename"/>
@@ -81575,7 +82538,7 @@ windows on the right screen, you may want to use #GdkAppLaunchContext,
8157582538 allow-none="1">
8157682539 <doc xml:space="preserve"
8157782540 filename="glib/gspawn.c"
81578- line="214">
82541+ line="215">
8157982542 child's environment, or %NULL to inherit parent's, in the GLib file
8158082543 name encoding</doc>
8158182544 <array c:type="const gchar* const*">
@@ -81585,7 +82548,7 @@ windows on the right screen, you may want to use #GdkAppLaunchContext,
8158582548 <parameter name="flags" transfer-ownership="none">
8158682549 <doc xml:space="preserve"
8158782550 filename="glib/gspawn.c"
81588- line="217">flags from #GSpawnFlags</doc>
82551+ line="218">flags from #GSpawnFlags</doc>
8158982552 <type name="SpawnFlags" c:type="GSpawnFlags"/>
8159082553 </parameter>
8159182554 <parameter name="child_setup"
@@ -81596,7 +82559,7 @@ windows on the right screen, you may want to use #GdkAppLaunchContext,
8159682559 closure="5">
8159782560 <doc xml:space="preserve"
8159882561 filename="glib/gspawn.c"
81599- line="218">function to run
82562+ line="219">function to run
8160082563 in the child just before `exec()`</doc>
8160182564 <type name="SpawnChildSetupFunc" c:type="GSpawnChildSetupFunc"/>
8160282565 </parameter>
@@ -81606,25 +82569,25 @@ windows on the right screen, you may want to use #GdkAppLaunchContext,
8160682569 allow-none="1">
8160782570 <doc xml:space="preserve"
8160882571 filename="glib/gspawn.c"
81609- line="220">user data for @child_setup</doc>
82572+ line="221">user data for @child_setup</doc>
8161082573 <type name="gpointer" c:type="gpointer"/>
8161182574 </parameter>
8161282575 <parameter name="stdin_fd" transfer-ownership="none">
8161382576 <doc xml:space="preserve"
8161482577 filename="glib/gspawn.c"
81615- line="221">file descriptor to use for child's stdin, or `-1`</doc>
82578+ line="222">file descriptor to use for child's stdin, or `-1`</doc>
8161682579 <type name="gint" c:type="gint"/>
8161782580 </parameter>
8161882581 <parameter name="stdout_fd" transfer-ownership="none">
8161982582 <doc xml:space="preserve"
8162082583 filename="glib/gspawn.c"
81621- line="222">file descriptor to use for child's stdout, or `-1`</doc>
82584+ line="223">file descriptor to use for child's stdout, or `-1`</doc>
8162282585 <type name="gint" c:type="gint"/>
8162382586 </parameter>
8162482587 <parameter name="stderr_fd" transfer-ownership="none">
8162582588 <doc xml:space="preserve"
8162682589 filename="glib/gspawn.c"
81627- line="223">file descriptor to use for child's stderr, or `-1`</doc>
82590+ line="224">file descriptor to use for child's stderr, or `-1`</doc>
8162882591 <type name="gint" c:type="gint"/>
8162982592 </parameter>
8163082593 <parameter name="source_fds"
@@ -81633,7 +82596,7 @@ windows on the right screen, you may want to use #GdkAppLaunchContext,
8163382596 allow-none="1">
8163482597 <doc xml:space="preserve"
8163582598 filename="glib/gspawn.c"
81636- line="224">array of FDs from the parent
82599+ line="225">array of FDs from the parent
8163782600 process to make available in the child process</doc>
8163882601 <array length="11" zero-terminated="0" c:type="const gint*">
8163982602 <type name="gint" c:type="gint"/>
@@ -81645,7 +82608,7 @@ windows on the right screen, you may want to use #GdkAppLaunchContext,
8164582608 allow-none="1">
8164682609 <doc xml:space="preserve"
8164782610 filename="glib/gspawn.c"
81648- line="226">array of FDs to remap
82611+ line="227">array of FDs to remap
8164982612 @source_fds to in the child process</doc>
8165082613 <array length="11" zero-terminated="0" c:type="const gint*">
8165182614 <type name="gint" c:type="gint"/>
@@ -81654,7 +82617,7 @@ windows on the right screen, you may want to use #GdkAppLaunchContext,
8165482617 <parameter name="n_fds" transfer-ownership="none">
8165582618 <doc xml:space="preserve"
8165682619 filename="glib/gspawn.c"
81657- line="228">number of FDs in @source_fds and @target_fds</doc>
82620+ line="229">number of FDs in @source_fds and @target_fds</doc>
8165882621 <type name="gsize" c:type="gsize"/>
8165982622 </parameter>
8166082623 <parameter name="child_pid_out"
@@ -81665,7 +82628,7 @@ windows on the right screen, you may want to use #GdkAppLaunchContext,
8166582628 allow-none="1">
8166682629 <doc xml:space="preserve"
8166782630 filename="glib/gspawn.c"
81668- line="229">return location for child process ID, or %NULL</doc>
82631+ line="230">return location for child process ID, or %NULL</doc>
8166982632 <type name="Pid" c:type="GPid*"/>
8167082633 </parameter>
8167182634 <parameter name="stdin_pipe_out"
@@ -81676,7 +82639,7 @@ windows on the right screen, you may want to use #GdkAppLaunchContext,
8167682639 allow-none="1">
8167782640 <doc xml:space="preserve"
8167882641 filename="glib/gspawn.c"
81679- line="230">return location for file descriptor to write to child's stdin, or %NULL</doc>
82642+ line="231">return location for file descriptor to write to child's stdin, or %NULL</doc>
8168082643 <type name="gint" c:type="gint*"/>
8168182644 </parameter>
8168282645 <parameter name="stdout_pipe_out"
@@ -81687,7 +82650,7 @@ windows on the right screen, you may want to use #GdkAppLaunchContext,
8168782650 allow-none="1">
8168882651 <doc xml:space="preserve"
8168982652 filename="glib/gspawn.c"
81690- line="231">return location for file descriptor to read child's stdout, or %NULL</doc>
82653+ line="232">return location for file descriptor to read child's stdout, or %NULL</doc>
8169182654 <type name="gint" c:type="gint*"/>
8169282655 </parameter>
8169382656 <parameter name="stderr_pipe_out"
@@ -81698,7 +82661,7 @@ windows on the right screen, you may want to use #GdkAppLaunchContext,
8169882661 allow-none="1">
8169982662 <doc xml:space="preserve"
8170082663 filename="glib/gspawn.c"
81701- line="232">return location for file descriptor to read child's stderr, or %NULL</doc>
82664+ line="233">return location for file descriptor to read child's stderr, or %NULL</doc>
8170282665 <type name="gint" c:type="gint*"/>
8170382666 </parameter>
8170482667 </parameters>
@@ -81711,7 +82674,7 @@ windows on the right screen, you may want to use #GdkAppLaunchContext,
8171182674 throws="1">
8171282675 <doc xml:space="preserve"
8171382676 filename="glib/gspawn.c"
81714- line="707">An old name for g_spawn_check_wait_status(), deprecated because its
82677+ line="708">An old name for g_spawn_check_wait_status(), deprecated because its
8171582678 name is misleading.
8171682679
8171782680 Despite the name of the function, @wait_status must be the wait status
@@ -81724,7 +82687,7 @@ as passed to `exit()` or returned by g_subprocess_get_exit_status() or
8172482687 <return-value transfer-ownership="none">
8172582688 <doc xml:space="preserve"
8172682689 filename="glib/gspawn.c"
81727- line="721">%TRUE if child exited successfully, %FALSE otherwise (and
82690+ line="722">%TRUE if child exited successfully, %FALSE otherwise (and
8172882691 @error will be set)</doc>
8172982692 <type name="gboolean" c:type="gboolean"/>
8173082693 </return-value>
@@ -81732,7 +82695,7 @@ as passed to `exit()` or returned by g_subprocess_get_exit_status() or
8173282695 <parameter name="wait_status" transfer-ownership="none">
8173382696 <doc xml:space="preserve"
8173482697 filename="glib/gspawn.c"
81735- line="709">A status as returned from g_spawn_sync()</doc>
82698+ line="710">A status as returned from g_spawn_sync()</doc>
8173682699 <type name="gint" c:type="gint"/>
8173782700 </parameter>
8173882701 </parameters>
@@ -81743,7 +82706,7 @@ as passed to `exit()` or returned by g_subprocess_get_exit_status() or
8174382706 throws="1">
8174482707 <doc xml:space="preserve"
8174582708 filename="glib/gspawn.c"
81746- line="650">Set @error if @wait_status indicates the child exited abnormally
82709+ line="651">Set @error if @wait_status indicates the child exited abnormally
8174782710 (e.g. with a nonzero exit code, or via a fatal signal).
8174882711
8174982712 The g_spawn_sync() and g_child_watch_add() family of APIs return the
@@ -81786,7 +82749,7 @@ functionality, although under a misleading name.</doc>
8178682749 <return-value transfer-ownership="none">
8178782750 <doc xml:space="preserve"
8178882751 filename="glib/gspawn.c"
81789- line="695">%TRUE if child exited successfully, %FALSE otherwise (and
82752+ line="696">%TRUE if child exited successfully, %FALSE otherwise (and
8179082753 @error will be set)</doc>
8179182754 <type name="gboolean" c:type="gboolean"/>
8179282755 </return-value>
@@ -81794,7 +82757,7 @@ functionality, although under a misleading name.</doc>
8179482757 <parameter name="wait_status" transfer-ownership="none">
8179582758 <doc xml:space="preserve"
8179682759 filename="glib/gspawn.c"
81797- line="652">A platform-specific wait status as returned from g_spawn_sync()</doc>
82760+ line="653">A platform-specific wait status as returned from g_spawn_sync()</doc>
8179882761 <type name="gint" c:type="gint"/>
8179982762 </parameter>
8180082763 </parameters>
@@ -81802,7 +82765,7 @@ functionality, although under a misleading name.</doc>
8180282765 <function name="spawn_close_pid" c:identifier="g_spawn_close_pid">
8180382766 <doc xml:space="preserve"
8180482767 filename="glib/gspawn.c"
81805- line="735">On some platforms, notably Windows, the #GPid type represents a resource
82768+ line="736">On some platforms, notably Windows, the #GPid type represents a resource
8180682769 which must be closed to prevent resource leaking. g_spawn_close_pid()
8180782770 is provided for this purpose. It should be used on all platforms, even
8180882771 though it doesn't do anything under UNIX.</doc>
@@ -81814,7 +82777,7 @@ though it doesn't do anything under UNIX.</doc>
8181482777 <parameter name="pid" transfer-ownership="none">
8181582778 <doc xml:space="preserve"
8181682779 filename="glib/gspawn.c"
81817- line="737">The process reference to close</doc>
82780+ line="738">The process reference to close</doc>
8181882781 <type name="Pid" c:type="GPid"/>
8181982782 </parameter>
8182082783 </parameters>
@@ -81824,7 +82787,7 @@ though it doesn't do anything under UNIX.</doc>
8182482787 throws="1">
8182582788 <doc xml:space="preserve"
8182682789 filename="glib/gspawn.c"
81827- line="604">A simple version of g_spawn_async() that parses a command line with
82790+ line="605">A simple version of g_spawn_async() that parses a command line with
8182882791 g_shell_parse_argv() and passes it to g_spawn_async().
8182982792
8183082793 Runs a command line in the background. Unlike g_spawn_async(), the
@@ -81838,14 +82801,14 @@ The same concerns on Windows apply as for g_spawn_command_line_sync().</doc>
8183882801 <return-value transfer-ownership="none">
8183982802 <doc xml:space="preserve"
8184082803 filename="glib/gspawn.c"
81841- line="620">%TRUE on success, %FALSE if error is set</doc>
82804+ line="621">%TRUE on success, %FALSE if error is set</doc>
8184282805 <type name="gboolean" c:type="gboolean"/>
8184382806 </return-value>
8184482807 <parameters>
8184582808 <parameter name="command_line" transfer-ownership="none">
8184682809 <doc xml:space="preserve"
8184782810 filename="glib/gspawn.c"
81848- line="606">a command line</doc>
82811+ line="607">a command line</doc>
8184982812 <type name="filename" c:type="const gchar*"/>
8185082813 </parameter>
8185182814 </parameters>
@@ -81855,7 +82818,7 @@ The same concerns on Windows apply as for g_spawn_command_line_sync().</doc>
8185582818 throws="1">
8185682819 <doc xml:space="preserve"
8185782820 filename="glib/gspawn.c"
81858- line="531">A simple version of g_spawn_sync() with little-used parameters
82821+ line="532">A simple version of g_spawn_sync() with little-used parameters
8185982822 removed, taking a command line instead of an argument vector.
8186082823
8186182824 See g_spawn_sync() for full details.
@@ -81888,14 +82851,14 @@ separator. You need to enclose such paths with single quotes, like
8188882851 <return-value transfer-ownership="none">
8188982852 <doc xml:space="preserve"
8189082853 filename="glib/gspawn.c"
81891- line="569">%TRUE on success, %FALSE if an error was set</doc>
82854+ line="570">%TRUE on success, %FALSE if an error was set</doc>
8189282855 <type name="gboolean" c:type="gboolean"/>
8189382856 </return-value>
8189482857 <parameters>
8189582858 <parameter name="command_line" transfer-ownership="none">
8189682859 <doc xml:space="preserve"
8189782860 filename="glib/gspawn.c"
81898- line="533">a command line</doc>
82861+ line="534">a command line</doc>
8189982862 <type name="filename" c:type="const gchar*"/>
8190082863 </parameter>
8190182864 <parameter name="standard_output"
@@ -81906,7 +82869,7 @@ separator. You need to enclose such paths with single quotes, like
8190682869 allow-none="1">
8190782870 <doc xml:space="preserve"
8190882871 filename="glib/gspawn.c"
81909- line="534">return location for child output</doc>
82872+ line="535">return location for child output</doc>
8191082873 <array c:type="gchar**">
8191182874 <type name="guint8"/>
8191282875 </array>
@@ -81919,7 +82882,7 @@ separator. You need to enclose such paths with single quotes, like
8191982882 allow-none="1">
8192082883 <doc xml:space="preserve"
8192182884 filename="glib/gspawn.c"
81922- line="535">return location for child errors</doc>
82885+ line="536">return location for child errors</doc>
8192382886 <array c:type="gchar**">
8192482887 <type name="guint8"/>
8192582888 </array>
@@ -81932,7 +82895,7 @@ separator. You need to enclose such paths with single quotes, like
8193282895 allow-none="1">
8193382896 <doc xml:space="preserve"
8193482897 filename="glib/gspawn.c"
81935- line="536">return location for child wait status, as returned by waitpid()</doc>
82898+ line="537">return location for child wait status, as returned by waitpid()</doc>
8193682899 <type name="gint" c:type="gint*"/>
8193782900 </parameter>
8193882901 </parameters>
@@ -81951,7 +82914,7 @@ separator. You need to enclose such paths with single quotes, like
8195182914 <function name="spawn_sync" c:identifier="g_spawn_sync" throws="1">
8195282915 <doc xml:space="preserve"
8195382916 filename="glib/gspawn.c"
81954- line="89">Executes a child synchronously (waits for the child to exit before returning).
82917+ line="90">Executes a child synchronously (waits for the child to exit before returning).
8195582918
8195682919 All output from the child is stored in @standard_output and @standard_error,
8195782920 if those parameters are non-%NULL. Note that you must set the
@@ -81978,7 +82941,7 @@ how these functions work on Windows.</doc>
8197882941 <return-value transfer-ownership="none">
8197982942 <doc xml:space="preserve"
8198082943 filename="glib/gspawn.c"
81981- line="130">%TRUE on success, %FALSE if an error was set</doc>
82944+ line="131">%TRUE on success, %FALSE if an error was set</doc>
8198282945 <type name="gboolean" c:type="gboolean"/>
8198382946 </return-value>
8198482947 <parameters>
@@ -81988,14 +82951,14 @@ how these functions work on Windows.</doc>
8198882951 allow-none="1">
8198982952 <doc xml:space="preserve"
8199082953 filename="glib/gspawn.c"
81991- line="91">child's current working
82954+ line="92">child's current working
8199282955 directory, or %NULL to inherit parent's</doc>
8199382956 <type name="filename" c:type="const gchar*"/>
8199482957 </parameter>
8199582958 <parameter name="argv" transfer-ownership="none">
8199682959 <doc xml:space="preserve"
8199782960 filename="glib/gspawn.c"
81998- line="93">
82961+ line="94">
8199982962 child's argument vector, which must be non-empty and %NULL-terminated</doc>
8200082963 <array c:type="gchar**">
8200182964 <type name="filename"/>
@@ -82007,7 +82970,7 @@ how these functions work on Windows.</doc>
8200782970 allow-none="1">
8200882971 <doc xml:space="preserve"
8200982972 filename="glib/gspawn.c"
82010- line="95">
82973+ line="96">
8201182974 child's environment, or %NULL to inherit parent's</doc>
8201282975 <array c:type="gchar**">
8201382976 <type name="filename"/>
@@ -82016,7 +82979,7 @@ how these functions work on Windows.</doc>
8201682979 <parameter name="flags" transfer-ownership="none">
8201782980 <doc xml:space="preserve"
8201882981 filename="glib/gspawn.c"
82019- line="97">flags from #GSpawnFlags</doc>
82982+ line="98">flags from #GSpawnFlags</doc>
8202082983 <type name="SpawnFlags" c:type="GSpawnFlags"/>
8202182984 </parameter>
8202282985 <parameter name="child_setup"
@@ -82027,7 +82990,7 @@ how these functions work on Windows.</doc>
8202782990 closure="5">
8202882991 <doc xml:space="preserve"
8202982992 filename="glib/gspawn.c"
82030- line="98">function to run
82993+ line="99">function to run
8203182994 in the child just before `exec()`</doc>
8203282995 <type name="SpawnChildSetupFunc" c:type="GSpawnChildSetupFunc"/>
8203382996 </parameter>
@@ -82037,7 +83000,7 @@ how these functions work on Windows.</doc>
8203783000 allow-none="1">
8203883001 <doc xml:space="preserve"
8203983002 filename="glib/gspawn.c"
82040- line="100">user data for @child_setup</doc>
83003+ line="101">user data for @child_setup</doc>
8204183004 <type name="gpointer" c:type="gpointer"/>
8204283005 </parameter>
8204383006 <parameter name="standard_output"
@@ -82048,7 +83011,7 @@ how these functions work on Windows.</doc>
8204883011 allow-none="1">
8204983012 <doc xml:space="preserve"
8205083013 filename="glib/gspawn.c"
82051- line="101">return location for child output, or %NULL</doc>
83014+ line="102">return location for child output, or %NULL</doc>
8205283015 <array c:type="gchar**">
8205383016 <type name="guint8"/>
8205483017 </array>
@@ -82061,7 +83024,7 @@ how these functions work on Windows.</doc>
8206183024 allow-none="1">
8206283025 <doc xml:space="preserve"
8206383026 filename="glib/gspawn.c"
82064- line="102">return location for child error messages, or %NULL</doc>
83027+ line="103">return location for child error messages, or %NULL</doc>
8206583028 <array c:type="gchar**">
8206683029 <type name="guint8"/>
8206783030 </array>
@@ -82074,7 +83037,7 @@ how these functions work on Windows.</doc>
8207483037 allow-none="1">
8207583038 <doc xml:space="preserve"
8207683039 filename="glib/gspawn.c"
82077- line="103">return location for child wait status, as returned by waitpid(), or %NULL</doc>
83040+ line="104">return location for child wait status, as returned by waitpid(), or %NULL</doc>
8207883041 <type name="gint" c:type="gint*"/>
8207983042 </parameter>
8208083043 </parameters>
@@ -82085,7 +83048,7 @@ how these functions work on Windows.</doc>
8208583048 introspectable="0">
8208683049 <doc xml:space="preserve"
8208783050 filename="glib/gprintf.c"
82088- line="95">An implementation of the standard `sprintf()` function which supports
83051+ line="96">An implementation of the standard `sprintf()` function which supports
8208983052 positional parameters, as specified in the Single Unix Specification.
8209083053
8209183054 Note that it is usually better to use [func@GLib.snprintf], to avoid the
@@ -82098,14 +83061,14 @@ See also [func@GLib.strdup_printf].</doc>
8209883061 <return-value transfer-ownership="none">
8209983062 <doc xml:space="preserve"
8210083063 filename="glib/gprintf.c"
82101- line="114">the number of bytes printed</doc>
83064+ line="115">the number of bytes printed</doc>
8210283065 <type name="gint" c:type="gint"/>
8210383066 </return-value>
8210483067 <parameters>
8210583068 <parameter name="string" transfer-ownership="none">
8210683069 <doc xml:space="preserve"
8210783070 filename="glib/gprintf.c"
82108- line="97">A pointer to a memory buffer to contain the resulting string. It
83071+ line="98">A pointer to a memory buffer to contain the resulting string. It
8210983072 is up to the caller to ensure that the allocated buffer is large
8211083073 enough to hold the formatted result.</doc>
8211183074 <type name="utf8" c:type="gchar*"/>
@@ -82113,14 +83076,14 @@ See also [func@GLib.strdup_printf].</doc>
8211383076 <parameter name="format" transfer-ownership="none">
8211483077 <doc xml:space="preserve"
8211583078 filename="glib/gprintf.c"
82116- line="100">a standard `printf()` format string, but notice
83079+ line="101">a standard `printf()` format string, but notice
8211783080 [string precision pitfalls](string-utils.html#string-precision-pitfalls)</doc>
8211883081 <type name="utf8" c:type="const gchar*"/>
8211983082 </parameter>
8212083083 <parameter name="..." transfer-ownership="none">
8212183084 <doc xml:space="preserve"
8212283085 filename="glib/gprintf.c"
82123- line="102">the arguments to insert in the output</doc>
83086+ line="103">the arguments to insert in the output</doc>
8212483087 <varargs/>
8212583088 </parameter>
8212683089 </parameters>
@@ -82128,7 +83091,7 @@ See also [func@GLib.strdup_printf].</doc>
8212883091 <function name="stat" c:identifier="g_stat" version="2.6">
8212983092 <doc xml:space="preserve"
8213083093 filename="glib/gstdio.c"
82131- line="1292">A wrapper for the POSIX stat() function. The stat() function
83094+ line="1303">A wrapper for the POSIX stat() function. The stat() function
8213283095 returns information about a file. On Windows the stat() function in
8213383096 the C library checks only the FAT-style READONLY attribute and does
8213483097 not look at the ACL at all. Thus on Windows the protection bits in
@@ -82152,7 +83115,7 @@ See your C library manual for more details about stat().</doc>
8215283115 <return-value transfer-ownership="none">
8215383116 <doc xml:space="preserve"
8215483117 filename="glib/gstdio.c"
82155- line="1320">0 if the information was successfully retrieved,
83118+ line="1331">0 if the information was successfully retrieved,
8215683119 -1 if an error occurred</doc>
8215783120 <type name="gint" c:type="int"/>
8215883121 </return-value>
@@ -82160,14 +83123,14 @@ See your C library manual for more details about stat().</doc>
8216083123 <parameter name="filename" transfer-ownership="none">
8216183124 <doc xml:space="preserve"
8216283125 filename="glib/gstdio.c"
82163- line="1294">a pathname in the GLib file name encoding
83126+ line="1305">a pathname in the GLib file name encoding
8216483127 (UTF-8 on Windows)</doc>
8216583128 <type name="filename" c:type="const gchar*"/>
8216683129 </parameter>
8216783130 <parameter name="buf" transfer-ownership="none">
8216883131 <doc xml:space="preserve"
8216983132 filename="glib/gstdio.c"
82170- line="1296">a pointer to a stat struct, which will be filled with the file
83133+ line="1307">a pointer to a stat struct, which will be filled with the file
8217183134 information</doc>
8217283135 <type name="StatBuf" c:type="GStatBuf*"/>
8217383136 </parameter>
@@ -82233,7 +83196,7 @@ See your C library manual for more details about stat().</doc>
8223383196 introspectable="0">
8223483197 <doc xml:space="preserve"
8223583198 filename="glib/gmain.h"
82236- line="987">Sets @fd_ptr to `-1`, returning the value that was there before.
83199+ line="990">Sets @fd_ptr to `-1`, returning the value that was there before.
8223783200
8223883201 Conceptually, this transfers the ownership of the file descriptor
8223983202 from the referenced variable to the caller of the function (i.e.
@@ -82246,11 +83209,11 @@ On POSIX platforms, this function is async-signal safe
8224683209 signal handler or a #GSpawnChildSetupFunc.
8224783210
8224883211 This function preserves the value of `errno`.</doc>
82249- <source-position filename="glib/gmain.h" line="1009"/>
83212+ <source-position filename="glib/gmain.h" line="1012"/>
8225083213 <return-value transfer-ownership="none">
8225183214 <doc xml:space="preserve"
8225283215 filename="glib/gmain.h"
82253- line="1005">the value that @fd_ptr previously had</doc>
83216+ line="1008">the value that @fd_ptr previously had</doc>
8225483217 <type name="gint" c:type="int"/>
8225583218 </return-value>
8225683219 <parameters>
@@ -82260,7 +83223,7 @@ This function preserves the value of `errno`.</doc>
8226083223 transfer-ownership="full">
8226183224 <doc xml:space="preserve"
8226283225 filename="glib/gmain.h"
82263- line="989">A pointer to a file descriptor</doc>
83226+ line="992">A pointer to a file descriptor</doc>
8226483227 <type name="gint" c:type="int*"/>
8226583228 </parameter>
8226683229 </parameters>
@@ -82271,7 +83234,7 @@ This function preserves the value of `errno`.</doc>
8227183234 introspectable="0">
8227283235 <doc xml:space="preserve"
8227383236 filename="glib/gmain.h"
82274- line="875">Sets @handle_pointer to `0`, returning the value that was there before.
83237+ line="878">Sets @handle_pointer to `0`, returning the value that was there before.
8227583238
8227683239 Conceptually, this transfers the ownership of the handle ID from the
8227783240 referenced variable to the ‘caller’ of the macro (ie: ‘steals’ the
@@ -82297,7 +83260,7 @@ While [func@GLib.clear_handle_id] can be used in many of the same situations
8229783260 as `g_steal_handle_id()`, this is one situation where it cannot be used, as
8229883261 there is no way to pass the `GDBusConnection` to a
8229983262 [type@GLib.ClearHandleFunc].</doc>
82300- <source-position filename="glib/gmain.h" line="909"/>
83263+ <source-position filename="glib/gmain.h" line="912"/>
8230183264 <return-value transfer-ownership="none">
8230283265 <type name="guint" c:type="unsigned int"/>
8230383266 </return-value>
@@ -82308,7 +83271,7 @@ there is no way to pass the `GDBusConnection` to a
8230883271 transfer-ownership="full">
8230983272 <doc xml:space="preserve"
8231083273 filename="glib/gmain.h"
82311- line="877">a pointer to a handle ID</doc>
83274+ line="880">a pointer to a handle ID</doc>
8231283275 <type name="guint" c:type="unsigned int*"/>
8231383276 </parameter>
8231483277 </parameters>
@@ -82383,7 +83346,7 @@ early error case and also in the case that %NULL was given for
8238383346 <function name="stpcpy" c:identifier="g_stpcpy">
8238483347 <doc xml:space="preserve"
8238583348 filename="glib/gstrfuncs.c"
82386- line="451">Copies a nul-terminated string into the destination buffer, including
83349+ line="455">Copies a nul-terminated string into the destination buffer, including
8238783350 the trailing nul byte, and returns a pointer to the trailing nul byte
8238883351 in `dest`. The return value is useful for concatenating multiple
8238983352 strings without having to repeatedly scan for the end.</doc>
@@ -82391,20 +83354,20 @@ strings without having to repeatedly scan for the end.</doc>
8239183354 <return-value transfer-ownership="full">
8239283355 <doc xml:space="preserve"
8239383356 filename="glib/gstrfuncs.c"
82394- line="461">a pointer to the trailing nul byte in `dest`</doc>
83357+ line="465">a pointer to the trailing nul byte in `dest`</doc>
8239583358 <type name="utf8" c:type="gchar*"/>
8239683359 </return-value>
8239783360 <parameters>
8239883361 <parameter name="dest" transfer-ownership="none">
8239983362 <doc xml:space="preserve"
8240083363 filename="glib/gstrfuncs.c"
82401- line="453">destination buffer</doc>
83364+ line="457">destination buffer</doc>
8240283365 <type name="utf8" c:type="gchar*"/>
8240383366 </parameter>
8240483367 <parameter name="src" transfer-ownership="none">
8240583368 <doc xml:space="preserve"
8240683369 filename="glib/gstrfuncs.c"
82407- line="454">source string</doc>
83370+ line="458">source string</doc>
8240883371 <type name="utf8" c:type="const char*"/>
8240983372 </parameter>
8241083373 </parameters>
@@ -82412,7 +83375,7 @@ strings without having to repeatedly scan for the end.</doc>
8241283375 <function name="str_equal" c:identifier="g_str_equal">
8241383376 <doc xml:space="preserve"
8241483377 filename="glib/ghash.c"
82415- line="2421">Compares two strings for byte-by-byte equality and returns %TRUE
83378+ line="2424">Compares two strings for byte-by-byte equality and returns %TRUE
8241683379 if they are equal. It can be passed to g_hash_table_new() as the
8241783380 @key_equal_func parameter, when using non-%NULL strings as keys in a
8241883381 #GHashTable.
@@ -82424,20 +83387,20 @@ comparison function, see g_strcmp0().</doc>
8242483387 <return-value transfer-ownership="none">
8242583388 <doc xml:space="preserve"
8242683389 filename="glib/ghash.c"
82427- line="2435">%TRUE if the two keys match</doc>
83390+ line="2438">%TRUE if the two keys match</doc>
8242883391 <type name="gboolean" c:type="gboolean"/>
8242983392 </return-value>
8243083393 <parameters>
8243183394 <parameter name="v1" transfer-ownership="none">
8243283395 <doc xml:space="preserve"
8243383396 filename="glib/ghash.c"
82434- line="2423">a key</doc>
83397+ line="2426">a key</doc>
8243583398 <type name="gpointer" c:type="gconstpointer"/>
8243683399 </parameter>
8243783400 <parameter name="v2" transfer-ownership="none">
8243883401 <doc xml:space="preserve"
8243983402 filename="glib/ghash.c"
82440- line="2424">a key to compare with @v1</doc>
83403+ line="2427">a key to compare with @v1</doc>
8244183404 <type name="gpointer" c:type="gconstpointer"/>
8244283405 </parameter>
8244383406 </parameters>
@@ -82447,25 +83410,25 @@ comparison function, see g_strcmp0().</doc>
8244783410 version="2.2">
8244883411 <doc xml:space="preserve"
8244983412 filename="glib/gstrfuncs.c"
82450- line="2930">Looks whether the string @str begins with @prefix.</doc>
83413+ line="2934">Looks whether the string @str begins with @prefix.</doc>
8245183414 <source-position filename="glib/gstrfuncs.h" line="146"/>
8245283415 <return-value transfer-ownership="none">
8245383416 <doc xml:space="preserve"
8245483417 filename="glib/gstrfuncs.c"
82455- line="2937">true if @str begins with @prefix, false otherwise</doc>
83418+ line="2941">true if @str begins with @prefix, false otherwise</doc>
8245683419 <type name="gboolean" c:type="gboolean"/>
8245783420 </return-value>
8245883421 <parameters>
8245983422 <parameter name="str" transfer-ownership="none">
8246083423 <doc xml:space="preserve"
8246183424 filename="glib/gstrfuncs.c"
82462- line="2932">a string to look in</doc>
83425+ line="2936">a string to look in</doc>
8246383426 <type name="utf8" c:type="const gchar*"/>
8246483427 </parameter>
8246583428 <parameter name="prefix" transfer-ownership="none">
8246683429 <doc xml:space="preserve"
8246783430 filename="glib/gstrfuncs.c"
82468- line="2933">the prefix to look for</doc>
83431+ line="2937">the prefix to look for</doc>
8246983432 <type name="utf8" c:type="const gchar*"/>
8247083433 </parameter>
8247183434 </parameters>
@@ -82475,25 +83438,25 @@ comparison function, see g_strcmp0().</doc>
8247583438 version="2.2">
8247683439 <doc xml:space="preserve"
8247783440 filename="glib/gstrfuncs.c"
82478- line="2901">Looks whether a string ends with @suffix.</doc>
83441+ line="2905">Looks whether a string ends with @suffix.</doc>
8247983442 <source-position filename="glib/gstrfuncs.h" line="143"/>
8248083443 <return-value transfer-ownership="none">
8248183444 <doc xml:space="preserve"
8248283445 filename="glib/gstrfuncs.c"
82483- line="2908">true if @str ends with @suffix, false otherwise</doc>
83446+ line="2912">true if @str ends with @suffix, false otherwise</doc>
8248483447 <type name="gboolean" c:type="gboolean"/>
8248583448 </return-value>
8248683449 <parameters>
8248783450 <parameter name="str" transfer-ownership="none">
8248883451 <doc xml:space="preserve"
8248983452 filename="glib/gstrfuncs.c"
82490- line="2903">a string to look in</doc>
83453+ line="2907">a string to look in</doc>
8249183454 <type name="utf8" c:type="const gchar*"/>
8249283455 </parameter>
8249383456 <parameter name="suffix" transfer-ownership="none">
8249483457 <doc xml:space="preserve"
8249583458 filename="glib/gstrfuncs.c"
82496- line="2904">the suffix to look for</doc>
83459+ line="2908">the suffix to look for</doc>
8249783460 <type name="utf8" c:type="const gchar*"/>
8249883461 </parameter>
8249983462 </parameters>
@@ -82501,7 +83464,7 @@ comparison function, see g_strcmp0().</doc>
8250183464 <function name="str_hash" c:identifier="g_str_hash">
8250283465 <doc xml:space="preserve"
8250383466 filename="glib/ghash.c"
82504- line="2447">Converts a string to a hash value.
83467+ line="2450">Converts a string to a hash value.
8250583468
8250683469 This function implements the widely used "djb" hash apparently
8250783470 posted by Daniel Bernstein to comp.lang.c some time ago. The 32
@@ -82519,14 +83482,14 @@ as 2.</doc>
8251983482 <return-value transfer-ownership="none">
8252083483 <doc xml:space="preserve"
8252183484 filename="glib/ghash.c"
82522- line="2466">a hash value corresponding to the key</doc>
83485+ line="2469">a hash value corresponding to the key</doc>
8252383486 <type name="guint" c:type="guint"/>
8252483487 </return-value>
8252583488 <parameters>
8252683489 <parameter name="v" transfer-ownership="none">
8252783490 <doc xml:space="preserve"
8252883491 filename="glib/ghash.c"
82529- line="2449">a string key</doc>
83492+ line="2452">a string key</doc>
8253083493 <type name="gpointer" c:type="gconstpointer"/>
8253183494 </parameter>
8253283495 </parameters>
@@ -82534,20 +83497,20 @@ as 2.</doc>
8253483497 <function name="str_is_ascii" c:identifier="g_str_is_ascii" version="2.40">
8253583498 <doc xml:space="preserve"
8253683499 filename="glib/gutf8.c"
82537- line="1892">Determines if a string is pure ASCII. A string is pure ASCII if it
83500+ line="2289">Determines if a string is pure ASCII. A string is pure ASCII if it
8253883501 contains no bytes with the high bit set.</doc>
8253983502 <source-position filename="glib/gstrfuncs.h" line="265"/>
8254083503 <return-value transfer-ownership="none">
8254183504 <doc xml:space="preserve"
8254283505 filename="glib/gutf8.c"
82543- line="1899">true if @str is ASCII</doc>
83506+ line="2296">true if @str is ASCII</doc>
8254483507 <type name="gboolean" c:type="gboolean"/>
8254583508 </return-value>
8254683509 <parameters>
8254783510 <parameter name="str" transfer-ownership="none">
8254883511 <doc xml:space="preserve"
8254983512 filename="glib/gutf8.c"
82550- line="1894">a string</doc>
83513+ line="2291">a string</doc>
8255183514 <type name="utf8" c:type="const gchar*"/>
8255283515 </parameter>
8255383516 </parameters>
@@ -82557,7 +83520,7 @@ contains no bytes with the high bit set.</doc>
8255783520 version="2.40">
8255883521 <doc xml:space="preserve"
8255983522 filename="glib/gstrfuncs.c"
82560- line="3144">Checks if a search conducted for @search_term should match
83523+ line="3148">Checks if a search conducted for @search_term should match
8256183524 @potential_hit.
8256283525
8256383526 This function calls [func@GLib.str_tokenize_and_fold] on both
@@ -82583,26 +83546,26 @@ Baz’, but not ‘SFO’ (because no word has ‘fo’ as a prefix).</doc>
8258383546 <return-value transfer-ownership="none">
8258483547 <doc xml:space="preserve"
8258583548 filename="glib/gstrfuncs.c"
82586- line="3173">true if @potential_hit is a hit</doc>
83549+ line="3177">true if @potential_hit is a hit</doc>
8258783550 <type name="gboolean" c:type="gboolean"/>
8258883551 </return-value>
8258983552 <parameters>
8259083553 <parameter name="search_term" transfer-ownership="none">
8259183554 <doc xml:space="preserve"
8259283555 filename="glib/gstrfuncs.c"
82593- line="3146">the search term from the user</doc>
83556+ line="3150">the search term from the user</doc>
8259483557 <type name="utf8" c:type="const gchar*"/>
8259583558 </parameter>
8259683559 <parameter name="potential_hit" transfer-ownership="none">
8259783560 <doc xml:space="preserve"
8259883561 filename="glib/gstrfuncs.c"
82599- line="3147">the text that may be a hit</doc>
83562+ line="3151">the text that may be a hit</doc>
8260083563 <type name="utf8" c:type="const gchar*"/>
8260183564 </parameter>
8260283565 <parameter name="accept_alternates" transfer-ownership="none">
8260383566 <doc xml:space="preserve"
8260483567 filename="glib/gstrfuncs.c"
82605- line="3148">if true, ASCII alternates are accepted</doc>
83568+ line="3152">if true, ASCII alternates are accepted</doc>
8260683569 <type name="gboolean" c:type="gboolean"/>
8260783570 </parameter>
8260883571 </parameters>
@@ -82658,7 +83621,7 @@ to be done independently of the currently locale, specify `"C"` for
8265883621 version="2.40">
8265983622 <doc xml:space="preserve"
8266083623 filename="glib/gstrfuncs.c"
82661- line="3058">Tokenizes @string and performs folding on each token.
83624+ line="3062">Tokenizes @string and performs folding on each token.
8266283625
8266383626 A token is a non-empty sequence of alphanumeric characters in the
8266483627 source string, separated by non-alphanumeric characters. An
@@ -82677,7 +83640,7 @@ known.</doc>
8267783640 <return-value transfer-ownership="full">
8267883641 <doc xml:space="preserve"
8267983642 filename="glib/gstrfuncs.c"
82680- line="3082">the folded tokens</doc>
83643+ line="3086">the folded tokens</doc>
8268183644 <array c:type="gchar**">
8268283645 <type name="utf8"/>
8268383646 </array>
@@ -82686,7 +83649,7 @@ known.</doc>
8268683649 <parameter name="string" transfer-ownership="none">
8268783650 <doc xml:space="preserve"
8268883651 filename="glib/gstrfuncs.c"
82689- line="3060">a string to tokenize</doc>
83652+ line="3064">a string to tokenize</doc>
8269083653 <type name="utf8" c:type="const gchar*"/>
8269183654 </parameter>
8269283655 <parameter name="translit_locale"
@@ -82695,7 +83658,7 @@ known.</doc>
8269583658 allow-none="1">
8269683659 <doc xml:space="preserve"
8269783660 filename="glib/gstrfuncs.c"
82698- line="3061">the language code (like 'de' or
83661+ line="3065">the language code (like 'de' or
8269983662 'en_GB') from which @string originates</doc>
8270083663 <type name="utf8" c:type="const gchar*"/>
8270183664 </parameter>
@@ -82707,7 +83670,7 @@ known.</doc>
8270783670 allow-none="1">
8270883671 <doc xml:space="preserve"
8270983672 filename="glib/gstrfuncs.c"
82710- line="3063">
83673+ line="3067">
8271183674 a return location for ASCII alternates</doc>
8271283675 <array c:type="gchar***">
8271383676 <type name="utf8" c:type="gchar**"/>
@@ -82718,7 +83681,7 @@ known.</doc>
8271883681 <function name="strcanon" c:identifier="g_strcanon">
8271983682 <doc xml:space="preserve"
8272083683 filename="glib/gstrfuncs.c"
82721- line="2050">For each character in @string, if the character is not in @valid_chars,
83684+ line="2054">For each character in @string, if the character is not in @valid_chars,
8272283685 replaces the character with @substitutor.
8272383686
8272483687 Modifies @string in place, and return @string itself, not a copy. The
@@ -82737,26 +83700,26 @@ g_free (reformatted);
8273783700 <return-value transfer-ownership="full">
8273883701 <doc xml:space="preserve"
8273983702 filename="glib/gstrfuncs.c"
82740- line="2072">the modified @string</doc>
83703+ line="2076">the modified @string</doc>
8274183704 <type name="utf8" c:type="gchar*"/>
8274283705 </return-value>
8274383706 <parameters>
8274483707 <parameter name="string" transfer-ownership="none">
8274583708 <doc xml:space="preserve"
8274683709 filename="glib/gstrfuncs.c"
82747- line="2052">a nul-terminated array of bytes</doc>
83710+ line="2056">a nul-terminated array of bytes</doc>
8274883711 <type name="utf8" c:type="gchar*"/>
8274983712 </parameter>
8275083713 <parameter name="valid_chars" transfer-ownership="none">
8275183714 <doc xml:space="preserve"
8275283715 filename="glib/gstrfuncs.c"
82753- line="2053">bytes permitted in @string</doc>
83716+ line="2057">bytes permitted in @string</doc>
8275483717 <type name="utf8" c:type="const gchar*"/>
8275583718 </parameter>
8275683719 <parameter name="substitutor" transfer-ownership="none">
8275783720 <doc xml:space="preserve"
8275883721 filename="glib/gstrfuncs.c"
82759- line="2054">replacement character for disallowed bytes</doc>
83722+ line="2058">replacement character for disallowed bytes</doc>
8276083723 <type name="gchar" c:type="gchar"/>
8276183724 </parameter>
8276283725 </parameters>
@@ -82767,7 +83730,7 @@ g_free (reformatted);
8276783730 deprecated-version="2.2">
8276883731 <doc xml:space="preserve"
8276983732 filename="glib/gstrfuncs.c"
82770- line="1895">A case-insensitive string comparison, corresponding to the standard
83733+ line="1899">A case-insensitive string comparison, corresponding to the standard
8277183734 `strcasecmp()` function on platforms which support it.</doc>
8277283735 <doc-deprecated xml:space="preserve">See [func@GLib.strncasecmp] for a discussion of why this
8277383736 function is deprecated and how to replace it.</doc-deprecated>
@@ -82775,7 +83738,7 @@ g_free (reformatted);
8277583738 <return-value transfer-ownership="none">
8277683739 <doc xml:space="preserve"
8277783740 filename="glib/gstrfuncs.c"
82778- line="1903">0 if the strings match, a negative value if @s1 &lt; @s2,
83741+ line="1907">0 if the strings match, a negative value if @s1 &lt; @s2,
8277983742 or a positive value if @s1 &gt; @s2</doc>
8278083743 <type name="gint" c:type="gint"/>
8278183744 </return-value>
@@ -82783,13 +83746,13 @@ g_free (reformatted);
8278383746 <parameter name="s1" transfer-ownership="none">
8278483747 <doc xml:space="preserve"
8278583748 filename="glib/gstrfuncs.c"
82786- line="1897">string to compare with @s2</doc>
83749+ line="1901">string to compare with @s2</doc>
8278783750 <type name="utf8" c:type="const gchar*"/>
8278883751 </parameter>
8278983752 <parameter name="s2" transfer-ownership="none">
8279083753 <doc xml:space="preserve"
8279183754 filename="glib/gstrfuncs.c"
82792- line="1898">string to compare with @s1</doc>
83755+ line="1902">string to compare with @s1</doc>
8279383756 <type name="utf8" c:type="const gchar*"/>
8279483757 </parameter>
8279583758 </parameters>
@@ -82797,7 +83760,7 @@ g_free (reformatted);
8279783760 <function name="strchomp" c:identifier="g_strchomp">
8279883761 <doc xml:space="preserve"
8279983762 filename="glib/gstrfuncs.c"
82800- line="2327">Removes trailing whitespace from a string.
83763+ line="2331">Removes trailing whitespace from a string.
8280183764
8280283765 This function doesn't allocate or reallocate any memory;
8280383766 it modifies @string in place. Therefore, it cannot be used
@@ -82810,14 +83773,14 @@ Also see [func@GLib.strchug] and [func@GLib.strstrip].</doc>
8281083773 <return-value transfer-ownership="full">
8281183774 <doc xml:space="preserve"
8281283775 filename="glib/gstrfuncs.c"
82813- line="2341">the modified @string</doc>
83776+ line="2345">the modified @string</doc>
8281483777 <type name="utf8" c:type="gchar*"/>
8281583778 </return-value>
8281683779 <parameters>
8281783780 <parameter name="string" transfer-ownership="none">
8281883781 <doc xml:space="preserve"
8281983782 filename="glib/gstrfuncs.c"
82820- line="2329">a string to remove the trailing whitespace from</doc>
83783+ line="2333">a string to remove the trailing whitespace from</doc>
8282183784 <type name="utf8" c:type="gchar*"/>
8282283785 </parameter>
8282383786 </parameters>
@@ -82825,7 +83788,7 @@ Also see [func@GLib.strchug] and [func@GLib.strstrip].</doc>
8282583788 <function name="strchug" c:identifier="g_strchug">
8282683789 <doc xml:space="preserve"
8282783790 filename="glib/gstrfuncs.c"
82828- line="2295">Removes leading whitespace from a string, by moving the rest
83791+ line="2299">Removes leading whitespace from a string, by moving the rest
8282983792 of the characters forward.
8283083793
8283183794 This function doesn't allocate or reallocate any memory;
@@ -82839,14 +83802,14 @@ Also see [func@GLib.strchomp] and [func@GLib.strstrip].</doc>
8283983802 <return-value transfer-ownership="full">
8284083803 <doc xml:space="preserve"
8284183804 filename="glib/gstrfuncs.c"
82842- line="2310">the modified @string</doc>
83805+ line="2314">the modified @string</doc>
8284383806 <type name="utf8" c:type="gchar*"/>
8284483807 </return-value>
8284583808 <parameters>
8284683809 <parameter name="string" transfer-ownership="none">
8284783810 <doc xml:space="preserve"
8284883811 filename="glib/gstrfuncs.c"
82849- line="2297">a string to remove the leading whitespace from</doc>
83812+ line="2301">a string to remove the leading whitespace from</doc>
8285083813 <type name="utf8" c:type="gchar*"/>
8285183814 </parameter>
8285283815 </parameters>
@@ -82890,7 +83853,7 @@ Comparing two `NULL` pointers returns 0.</doc>
8289083853 <function name="strcompress" c:identifier="g_strcompress">
8289183854 <doc xml:space="preserve"
8289283855 filename="glib/gstrfuncs.c"
82893- line="2093">Makes a copy of a string replacing C string-style escape
83856+ line="2097">Makes a copy of a string replacing C string-style escape
8289483857 sequences with their one byte equivalent:
8289583858
8289683859 - `\b` → [U+0008 Backspace](https://en.wikipedia.org/wiki/Backspace)
@@ -82908,7 +83871,7 @@ sequences with their one byte equivalent:
8290883871 <return-value transfer-ownership="full">
8290983872 <doc xml:space="preserve"
8291083873 filename="glib/gstrfuncs.c"
82911- line="2112">a newly-allocated copy of @source with all escaped
83874+ line="2116">a newly-allocated copy of @source with all escaped
8291283875 character compressed</doc>
8291383876 <type name="utf8" c:type="gchar*"/>
8291483877 </return-value>
@@ -82916,7 +83879,7 @@ sequences with their one byte equivalent:
8291683879 <parameter name="source" transfer-ownership="none">
8291783880 <doc xml:space="preserve"
8291883881 filename="glib/gstrfuncs.c"
82919- line="2095">a string to compress</doc>
83882+ line="2099">a string to compress</doc>
8292083883 <type name="utf8" c:type="const gchar*"/>
8292183884 </parameter>
8292283885 </parameters>
@@ -82924,7 +83887,7 @@ sequences with their one byte equivalent:
8292483887 <function name="strconcat" c:identifier="g_strconcat" introspectable="0">
8292583888 <doc xml:space="preserve"
8292683889 filename="glib/gstrfuncs.c"
82927- line="547">Concatenates all of the given strings into one long string.
83890+ line="551">Concatenates all of the given strings into one long string.
8292883891
8292983892 The variable argument list must end with `NULL`. If you forget the `NULL`,
8293083893 `g_strconcat()` will start appending random memory junk to your string.
@@ -82936,20 +83899,20 @@ often requires the pieces to be reordered.</doc>
8293683899 <return-value transfer-ownership="full">
8293783900 <doc xml:space="preserve"
8293883901 filename="glib/gstrfuncs.c"
82939- line="561">a newly-allocated string containing all the string arguments</doc>
83902+ line="565">a newly-allocated string containing all the string arguments</doc>
8294083903 <type name="utf8" c:type="gchar*"/>
8294183904 </return-value>
8294283905 <parameters>
8294383906 <parameter name="string1" transfer-ownership="none">
8294483907 <doc xml:space="preserve"
8294583908 filename="glib/gstrfuncs.c"
82946- line="549">the first string to add, which must not be `NULL`</doc>
83909+ line="553">the first string to add, which must not be `NULL`</doc>
8294783910 <type name="utf8" c:type="const gchar*"/>
8294883911 </parameter>
8294983912 <parameter name="..." transfer-ownership="none">
8295083913 <doc xml:space="preserve"
8295183914 filename="glib/gstrfuncs.c"
82952- line="550">a `NULL`-terminated list of strings to append to the string</doc>
83915+ line="554">a `NULL`-terminated list of strings to append to the string</doc>
8295383916 <varargs/>
8295483917 </parameter>
8295583918 </parameters>
@@ -82957,7 +83920,7 @@ often requires the pieces to be reordered.</doc>
8295783920 <function name="strdelimit" c:identifier="g_strdelimit">
8295883921 <doc xml:space="preserve"
8295983922 filename="glib/gstrfuncs.c"
82960- line="2002">Converts any delimiter characters in @string to @new_delimiter.
83923+ line="2006">Converts any delimiter characters in @string to @new_delimiter.
8296183924
8296283925 Any characters in @string which are found in @delimiters are
8296383926 changed to the @new_delimiter character. Modifies @string in place,
@@ -82978,14 +83941,14 @@ g_free (reformatted);
8297883941 <return-value transfer-ownership="full">
8297983942 <doc xml:space="preserve"
8298083943 filename="glib/gstrfuncs.c"
82981- line="2027">the modified @string</doc>
83944+ line="2031">the modified @string</doc>
8298283945 <type name="utf8" c:type="gchar*"/>
8298383946 </return-value>
8298483947 <parameters>
8298583948 <parameter name="string" transfer-ownership="none">
8298683949 <doc xml:space="preserve"
8298783950 filename="glib/gstrfuncs.c"
82988- line="2004">the string to convert</doc>
83951+ line="2008">the string to convert</doc>
8298983952 <type name="utf8" c:type="gchar*"/>
8299083953 </parameter>
8299183954 <parameter name="delimiters"
@@ -82994,14 +83957,14 @@ g_free (reformatted);
8299483957 allow-none="1">
8299583958 <doc xml:space="preserve"
8299683959 filename="glib/gstrfuncs.c"
82997- line="2005">a string containing the current delimiters, or
83960+ line="2009">a string containing the current delimiters, or
8299883961 `NULL` to use the standard delimiters defined in [const@GLib.STR_DELIMITERS]</doc>
8299983962 <type name="utf8" c:type="const gchar*"/>
8300083963 </parameter>
8300183964 <parameter name="new_delimiter" transfer-ownership="none">
8300283965 <doc xml:space="preserve"
8300383966 filename="glib/gstrfuncs.c"
83004- line="2007">the new delimiter character</doc>
83967+ line="2011">the new delimiter character</doc>
8300583968 <type name="gchar" c:type="gchar"/>
8300683969 </parameter>
8300783970 </parameters>
@@ -83012,7 +83975,7 @@ g_free (reformatted);
8301283975 deprecated-version="2.2">
8301383976 <doc xml:space="preserve"
8301483977 filename="glib/gstrfuncs.c"
83015- line="1607">Converts a string to lower case.</doc>
83978+ line="1611">Converts a string to lower case.</doc>
8301683979 <doc-deprecated xml:space="preserve">This function is totally broken for the reasons discussed
8301783980 in the [func@GLib.strncasecmp] docs — use [func@GLib.ascii_strdown] or
8301883981 [func@GLib.utf8_strdown] instead.</doc-deprecated>
@@ -83020,14 +83983,14 @@ g_free (reformatted);
8302083983 <return-value transfer-ownership="full">
8302183984 <doc xml:space="preserve"
8302283985 filename="glib/gstrfuncs.c"
83023- line="1613">the string</doc>
83986+ line="1617">the string</doc>
8302483987 <type name="utf8" c:type="gchar*"/>
8302583988 </return-value>
8302683989 <parameters>
8302783990 <parameter name="string" transfer-ownership="none">
8302883991 <doc xml:space="preserve"
8302983992 filename="glib/gstrfuncs.c"
83030- line="1609">the string to convert</doc>
83993+ line="1613">the string to convert</doc>
8303183994 <type name="utf8" c:type="gchar*"/>
8303283995 </parameter>
8303383996 </parameters>
@@ -83060,7 +84023,7 @@ g_free (reformatted);
8306084023 introspectable="0">
8306184024 <doc xml:space="preserve"
8306284025 filename="glib/gstrfuncs.c"
83063- line="516">Similar to the standard C `sprintf()` function but safer, since it
84026+ line="520">Similar to the standard C `sprintf()` function but safer, since it
8306484027 calculates the maximum space required and allocates memory to hold
8306584028 the result.
8306684029
@@ -83071,7 +84034,7 @@ representation is available for the given character.</doc>
8307184034 <return-value transfer-ownership="full" nullable="1">
8307284035 <doc xml:space="preserve"
8307384036 filename="glib/gstrfuncs.c"
83074- line="530">a newly-allocated string holding the
84037+ line="534">a newly-allocated string holding the
8307584038 result</doc>
8307684039 <type name="utf8" c:type="gchar*"/>
8307784040 </return-value>
@@ -83079,14 +84042,14 @@ representation is available for the given character.</doc>
8307984042 <parameter name="format" transfer-ownership="none">
8308084043 <doc xml:space="preserve"
8308184044 filename="glib/gstrfuncs.c"
83082- line="518">a standard `printf()` format string, but notice
84045+ line="522">a standard `printf()` format string, but notice
8308384046 [string precision pitfalls](string-utils.html#string-precision-pitfalls)</doc>
8308484047 <type name="utf8" c:type="const gchar*"/>
8308584048 </parameter>
8308684049 <parameter name="..." transfer-ownership="none">
8308784050 <doc xml:space="preserve"
8308884051 filename="glib/gstrfuncs.c"
83089- line="520">the parameters to insert into the format string</doc>
84052+ line="524">the parameters to insert into the format string</doc>
8309084053 <varargs/>
8309184054 </parameter>
8309284055 </parameters>
@@ -83096,7 +84059,7 @@ representation is available for the given character.</doc>
8309684059 introspectable="0">
8309784060 <doc xml:space="preserve"
8309884061 filename="glib/gstrfuncs.c"
83099- line="485">Similar to the standard C `vsprintf()` function but safer, since it
84062+ line="489">Similar to the standard C `vsprintf()` function but safer, since it
8310084063 calculates the maximum space required and allocates memory to hold
8310184064 the result.
8310284065
@@ -83110,7 +84073,7 @@ additionally returns the length of the allocated string.</doc>
8311084073 <return-value transfer-ownership="full" nullable="1">
8311184074 <doc xml:space="preserve"
8311284075 filename="glib/gstrfuncs.c"
83113- line="502">a newly-allocated string holding the
84076+ line="506">a newly-allocated string holding the
8311484077 result</doc>
8311584078 <type name="utf8" c:type="gchar*"/>
8311684079 </return-value>
@@ -83118,14 +84081,14 @@ additionally returns the length of the allocated string.</doc>
8311884081 <parameter name="format" transfer-ownership="none">
8311984082 <doc xml:space="preserve"
8312084083 filename="glib/gstrfuncs.c"
83121- line="487">a standard `printf()` format string, but notice
84084+ line="491">a standard `printf()` format string, but notice
8312284085 [string precision pitfalls](string-utils.html#string-precision-pitfalls)</doc>
8312384086 <type name="utf8" c:type="const gchar*"/>
8312484087 </parameter>
8312584088 <parameter name="args" transfer-ownership="none">
8312684089 <doc xml:space="preserve"
8312784090 filename="glib/gstrfuncs.c"
83128- line="489">the list of parameters to insert into the format string</doc>
84091+ line="493">the list of parameters to insert into the format string</doc>
8312984092 <type name="va_list" c:type="va_list"/>
8313084093 </parameter>
8313184094 </parameters>
@@ -83133,7 +84096,7 @@ additionally returns the length of the allocated string.</doc>
8313384096 <function name="strdupv" c:identifier="g_strdupv">
8313484097 <doc xml:space="preserve"
8313584098 filename="glib/gstrfuncs.c"
83136- line="2565">Copies an array of strings. The copy is a deep copy; each string is also
84099+ line="2569">Copies an array of strings. The copy is a deep copy; each string is also
8313784100 copied.
8313884101
8313984102 If called on a `NULL` value, `g_strdupv()` simply returns `NULL`.</doc>
@@ -83141,7 +84104,7 @@ If called on a `NULL` value, `g_strdupv()` simply returns `NULL`.</doc>
8314184104 <return-value transfer-ownership="full" nullable="1">
8314284105 <doc xml:space="preserve"
8314384106 filename="glib/gstrfuncs.c"
83144- line="2574">a
84107+ line="2578">a
8314584108 newly-allocated array of strings. Use [func@GLib.strfreev] to free it.</doc>
8314684109 <array c:type="gchar**">
8314784110 <type name="utf8"/>
@@ -83154,7 +84117,7 @@ If called on a `NULL` value, `g_strdupv()` simply returns `NULL`.</doc>
8315484117 allow-none="1">
8315584118 <doc xml:space="preserve"
8315684119 filename="glib/gstrfuncs.c"
83157- line="2567">an array of strings to copy</doc>
84120+ line="2571">an array of strings to copy</doc>
8315884121 <array c:type="gchar**">
8315984122 <type name="utf8" c:type="gchar*"/>
8316084123 </array>
@@ -83164,7 +84127,7 @@ If called on a `NULL` value, `g_strdupv()` simply returns `NULL`.</doc>
8316484127 <function name="strerror" c:identifier="g_strerror">
8316584128 <doc xml:space="preserve"
8316684129 filename="glib/gstrfuncs.c"
83167- line="1259">Returns a string corresponding to the given error code, e.g. "no
84130+ line="1263">Returns a string corresponding to the given error code, e.g. "no
8316884131 such process".
8316984132
8317084133 Unlike `strerror()`, this always returns a string in
@@ -83189,14 +84152,14 @@ g_strerror (saved_errno);
8318984152 <return-value transfer-ownership="none">
8319084153 <doc xml:space="preserve"
8319184154 filename="glib/gstrfuncs.c"
83192- line="1285">the string describing the error code</doc>
84155+ line="1289">the string describing the error code</doc>
8319384156 <type name="utf8" c:type="const gchar*"/>
8319484157 </return-value>
8319584158 <parameters>
8319684159 <parameter name="errnum" transfer-ownership="none">
8319784160 <doc xml:space="preserve"
8319884161 filename="glib/gstrfuncs.c"
83199- line="1261">the system error number. See the standard C `errno` documentation</doc>
84162+ line="1265">the system error number. See the standard C `errno` documentation</doc>
8320084163 <type name="gint" c:type="gint"/>
8320184164 </parameter>
8320284165 </parameters>
@@ -83204,7 +84167,7 @@ g_strerror (saved_errno);
8320484167 <function name="strescape" c:identifier="g_strescape">
8320584168 <doc xml:space="preserve"
8320684169 filename="glib/gstrfuncs.c"
83207- line="2182">It replaces the following special characters in the string @source
84170+ line="2186">It replaces the following special characters in the string @source
8320884171 with their corresponding C escape sequence:
8320984172
8321084173 | Symbol | Escape |
@@ -83227,14 +84190,14 @@ Characters supplied in @exceptions are not escaped.
8322784190 <return-value transfer-ownership="full">
8322884191 <doc xml:space="preserve"
8322984192 filename="glib/gstrfuncs.c"
83230- line="2207">a newly-allocated copy of @source with special characters escaped</doc>
84193+ line="2211">a newly-allocated copy of @source with special characters escaped</doc>
8323184194 <type name="utf8" c:type="gchar*"/>
8323284195 </return-value>
8323384196 <parameters>
8323484197 <parameter name="source" transfer-ownership="none">
8323584198 <doc xml:space="preserve"
8323684199 filename="glib/gstrfuncs.c"
83237- line="2184">a string to escape</doc>
84200+ line="2188">a string to escape</doc>
8323884201 <type name="utf8" c:type="const gchar*"/>
8323984202 </parameter>
8324084203 <parameter name="exceptions"
@@ -83243,7 +84206,7 @@ Characters supplied in @exceptions are not escaped.
8324384206 allow-none="1">
8324484207 <doc xml:space="preserve"
8324584208 filename="glib/gstrfuncs.c"
83246- line="2185">a string of characters not to escape in @source</doc>
84209+ line="2189">a string of characters not to escape in @source</doc>
8324784210 <type name="utf8" c:type="const gchar*"/>
8324884211 </parameter>
8324984212 </parameters>
@@ -83251,7 +84214,7 @@ Characters supplied in @exceptions are not escaped.
8325184214 <function name="strfreev" c:identifier="g_strfreev">
8325284215 <doc xml:space="preserve"
8325384216 filename="glib/gstrfuncs.c"
83254- line="2542">Frees an array of strings, as well as each string it contains.
84217+ line="2546">Frees an array of strings, as well as each string it contains.
8325584218
8325684219 If @str_array is `NULL`, this function simply returns.</doc>
8325784220 <source-position filename="glib/gstrfuncs.h" line="367"/>
@@ -83265,7 +84228,7 @@ If @str_array is `NULL`, this function simply returns.</doc>
8326584228 allow-none="1">
8326684229 <doc xml:space="preserve"
8326784230 filename="glib/gstrfuncs.c"
83268- line="2544">an
84231+ line="2548">an
8326984232 array of strings to free</doc>
8327084233 <array c:type="gchar**">
8327184234 <type name="utf8" c:type="gchar*"/>
@@ -83306,13 +84269,13 @@ If @str_array is `NULL`, this function simply returns.</doc>
8330684269 <function name="strjoin" c:identifier="g_strjoin" introspectable="0">
8330784270 <doc xml:space="preserve"
8330884271 filename="glib/gstrfuncs.c"
83309- line="2660">Joins a number of strings together to form one long string, with the
84272+ line="2664">Joins a number of strings together to form one long string, with the
8331084273 optional @separator inserted between each of them.</doc>
8331184274 <source-position filename="glib/gstrfuncs.h" line="301"/>
8331284275 <return-value transfer-ownership="full">
8331384276 <doc xml:space="preserve"
8331484277 filename="glib/gstrfuncs.c"
83315- line="2668">a newly-allocated string containing all of the strings joined
84278+ line="2672">a newly-allocated string containing all of the strings joined
8331684279 together, with @separator between them</doc>
8331784280 <type name="utf8" c:type="gchar*"/>
8331884281 </return-value>
@@ -83323,13 +84286,13 @@ optional @separator inserted between each of them.</doc>
8332384286 allow-none="1">
8332484287 <doc xml:space="preserve"
8332584288 filename="glib/gstrfuncs.c"
83326- line="2662">a string to insert between each of the strings</doc>
84289+ line="2666">a string to insert between each of the strings</doc>
8332784290 <type name="utf8" c:type="const gchar*"/>
8332884291 </parameter>
8332984292 <parameter name="..." transfer-ownership="none">
8333084293 <doc xml:space="preserve"
8333184294 filename="glib/gstrfuncs.c"
83332- line="2663">a `NULL`-terminated list of strings to join</doc>
84295+ line="2667">a `NULL`-terminated list of strings to join</doc>
8333384296 <varargs/>
8333484297 </parameter>
8333584298 </parameters>
@@ -83337,7 +84300,7 @@ optional @separator inserted between each of them.</doc>
8333784300 <function name="strjoinv" c:identifier="g_strjoinv">
8333884301 <doc xml:space="preserve"
8333984302 filename="glib/gstrfuncs.c"
83340- line="2605">Joins an array of strings together to form one long string, with the
84303+ line="2609">Joins an array of strings together to form one long string, with the
8334184304 optional @separator inserted between each of them.
8334284305
8334384306 If @str_array has no items, the return value will be an
@@ -83347,7 +84310,7 @@ appear in the resulting string.</doc>
8334784310 <return-value transfer-ownership="full">
8334884311 <doc xml:space="preserve"
8334984312 filename="glib/gstrfuncs.c"
83350- line="2617">a newly-allocated string containing all of the strings joined
84313+ line="2621">a newly-allocated string containing all of the strings joined
8335184314 together, with @separator between them</doc>
8335284315 <type name="utf8" c:type="gchar*"/>
8335384316 </return-value>
@@ -83358,13 +84321,13 @@ appear in the resulting string.</doc>
8335884321 allow-none="1">
8335984322 <doc xml:space="preserve"
8336084323 filename="glib/gstrfuncs.c"
83361- line="2607">a string to insert between each of the strings</doc>
84324+ line="2611">a string to insert between each of the strings</doc>
8336284325 <type name="utf8" c:type="const gchar*"/>
8336384326 </parameter>
8336484327 <parameter name="str_array" transfer-ownership="none">
8336584328 <doc xml:space="preserve"
8336684329 filename="glib/gstrfuncs.c"
83367- line="2608">an array of strings to join</doc>
84330+ line="2612">an array of strings to join</doc>
8336884331 <array c:type="gchar**">
8336984332 <type name="utf8" c:type="gchar*"/>
8337084333 </array>
@@ -83374,7 +84337,7 @@ appear in the resulting string.</doc>
8337484337 <function name="strlcat" c:identifier="g_strlcat">
8337584338 <doc xml:space="preserve"
8337684339 filename="glib/gstrfuncs.c"
83377- line="1483">Portability wrapper that calls `strlcat()` on systems which have it,
84340+ line="1487">Portability wrapper that calls `strlcat()` on systems which have it,
8337884341 and emulates it otherwise. Appends nul-terminated @src string to @dest,
8337984342 guaranteeing nul-termination for @dest. The total size of @dest won't
8338084343 exceed @dest_size.
@@ -83391,7 +84354,7 @@ Caveat: this is supposedly a more secure alternative to `strcat()` or
8339184354 <return-value transfer-ownership="none">
8339284355 <doc xml:space="preserve"
8339384356 filename="glib/gstrfuncs.c"
83394- line="1504">size of attempted result, which is `MIN (dest_size, strlen
84357+ line="1508">size of attempted result, which is `MIN (dest_size, strlen
8339584358 (original dest)) + strlen (src)`, so if @retval &gt;= @dest_size,
8339684359 truncation occurred</doc>
8339784360 <type name="gsize" c:type="gsize"/>
@@ -83400,19 +84363,19 @@ Caveat: this is supposedly a more secure alternative to `strcat()` or
8340084363 <parameter name="dest" transfer-ownership="none">
8340184364 <doc xml:space="preserve"
8340284365 filename="glib/gstrfuncs.c"
83403- line="1485">destination buffer, already containing one nul-terminated string</doc>
84366+ line="1489">destination buffer, already containing one nul-terminated string</doc>
8340484367 <type name="utf8" c:type="gchar*"/>
8340584368 </parameter>
8340684369 <parameter name="src" transfer-ownership="none">
8340784370 <doc xml:space="preserve"
8340884371 filename="glib/gstrfuncs.c"
83409- line="1486">source buffer</doc>
84372+ line="1490">source buffer</doc>
8341084373 <type name="utf8" c:type="const gchar*"/>
8341184374 </parameter>
8341284375 <parameter name="dest_size" transfer-ownership="none">
8341384376 <doc xml:space="preserve"
8341484377 filename="glib/gstrfuncs.c"
83415- line="1487">length of @dest buffer in bytes (not length of existing string
84378+ line="1491">length of @dest buffer in bytes (not length of existing string
8341684379 inside @dest)</doc>
8341784380 <type name="gsize" c:type="gsize"/>
8341884381 </parameter>
@@ -83421,7 +84384,7 @@ Caveat: this is supposedly a more secure alternative to `strcat()` or
8342184384 <function name="strlcpy" c:identifier="g_strlcpy">
8342284385 <doc xml:space="preserve"
8342384386 filename="glib/gstrfuncs.c"
83424- line="1424">Portability wrapper that calls `strlcpy()` on systems which have it,
84387+ line="1428">Portability wrapper that calls `strlcpy()` on systems which have it,
8342584388 and emulates `strlcpy()` otherwise. Copies @src to @dest; @dest is
8342684389 guaranteed to be nul-terminated; @src must be nul-terminated;
8342784390 @dest_size is the buffer size, not the number of bytes to copy.
@@ -83439,26 +84402,26 @@ idea.</doc>
8343984402 <return-value transfer-ownership="none">
8344084403 <doc xml:space="preserve"
8344184404 filename="glib/gstrfuncs.c"
83442- line="1445">length of @src</doc>
84405+ line="1449">length of @src</doc>
8344384406 <type name="gsize" c:type="gsize"/>
8344484407 </return-value>
8344584408 <parameters>
8344684409 <parameter name="dest" transfer-ownership="none">
8344784410 <doc xml:space="preserve"
8344884411 filename="glib/gstrfuncs.c"
83449- line="1426">destination buffer</doc>
84412+ line="1430">destination buffer</doc>
8345084413 <type name="utf8" c:type="gchar*"/>
8345184414 </parameter>
8345284415 <parameter name="src" transfer-ownership="none">
8345384416 <doc xml:space="preserve"
8345484417 filename="glib/gstrfuncs.c"
83455- line="1427">source buffer</doc>
84418+ line="1431">source buffer</doc>
8345684419 <type name="utf8" c:type="const gchar*"/>
8345784420 </parameter>
8345884421 <parameter name="dest_size" transfer-ownership="none">
8345984422 <doc xml:space="preserve"
8346084423 filename="glib/gstrfuncs.c"
83461- line="1428">length of @dest in bytes</doc>
84424+ line="1432">length of @dest in bytes</doc>
8346284425 <type name="gsize" c:type="gsize"/>
8346384426 </parameter>
8346484427 </parameters>
@@ -83469,7 +84432,7 @@ idea.</doc>
8346984432 deprecated-version="2.2">
8347084433 <doc xml:space="preserve"
8347184434 filename="glib/gstrfuncs.c"
83472- line="1940">A case-insensitive string comparison, corresponding to the standard
84435+ line="1944">A case-insensitive string comparison, corresponding to the standard
8347384436 `strncasecmp()` function on platforms which support it. It is similar
8347484437 to [func@GLib.strcasecmp] except it only compares the first @n characters of
8347584438 the strings.</doc>
@@ -83491,7 +84454,7 @@ the strings.</doc>
8349184454 <return-value transfer-ownership="none">
8349284455 <doc xml:space="preserve"
8349384456 filename="glib/gstrfuncs.c"
83494- line="1951">0 if the strings match, a negative value if @s1 &lt; @s2,
84457+ line="1955">0 if the strings match, a negative value if @s1 &lt; @s2,
8349584458 or a positive value if @s1 &gt; @s2</doc>
8349684459 <type name="gint" c:type="gint"/>
8349784460 </return-value>
@@ -83499,19 +84462,19 @@ the strings.</doc>
8349984462 <parameter name="s1" transfer-ownership="none">
8350084463 <doc xml:space="preserve"
8350184464 filename="glib/gstrfuncs.c"
83502- line="1942">string to compare with @s2</doc>
84465+ line="1946">string to compare with @s2</doc>
8350384466 <type name="utf8" c:type="const gchar*"/>
8350484467 </parameter>
8350584468 <parameter name="s2" transfer-ownership="none">
8350684469 <doc xml:space="preserve"
8350784470 filename="glib/gstrfuncs.c"
83508- line="1943">string to compare with @s1</doc>
84471+ line="1947">string to compare with @s1</doc>
8350984472 <type name="utf8" c:type="const gchar*"/>
8351084473 </parameter>
8351184474 <parameter name="n" transfer-ownership="none">
8351284475 <doc xml:space="preserve"
8351384476 filename="glib/gstrfuncs.c"
83514- line="1944">the maximum number of characters to compare</doc>
84477+ line="1948">the maximum number of characters to compare</doc>
8351584478 <type name="guint" c:type="guint"/>
8351684479 </parameter>
8351784480 </parameters>
@@ -83555,25 +84518,25 @@ use [func@GLib.utf8_strncpy] instead.</doc>
8355584518 <function name="strnfill" c:identifier="g_strnfill">
8355684519 <doc xml:space="preserve"
8355784520 filename="glib/gstrfuncs.c"
83558- line="429">Creates a new string @length bytes long filled with @fill_char.</doc>
84521+ line="431">Creates a new string @length bytes long filled with @fill_char.</doc>
8355984522 <source-position filename="glib/gstrfuncs.h" line="295"/>
8356084523 <return-value transfer-ownership="full">
8356184524 <doc xml:space="preserve"
8356284525 filename="glib/gstrfuncs.c"
83563- line="436">a newly-allocated string filled with @fill_char</doc>
84526+ line="438">a newly-allocated string filled with @fill_char</doc>
8356484527 <type name="utf8" c:type="gchar*"/>
8356584528 </return-value>
8356684529 <parameters>
8356784530 <parameter name="length" transfer-ownership="none">
8356884531 <doc xml:space="preserve"
8356984532 filename="glib/gstrfuncs.c"
83570- line="431">the length of the new string</doc>
84533+ line="433">the length of the new string</doc>
8357184534 <type name="gsize" c:type="gsize"/>
8357284535 </parameter>
8357384536 <parameter name="fill_char" transfer-ownership="none">
8357484537 <doc xml:space="preserve"
8357584538 filename="glib/gstrfuncs.c"
83576- line="432">the byte to fill the string with</doc>
84539+ line="434">the byte to fill the string with</doc>
8357784540 <type name="gchar" c:type="gchar"/>
8357884541 </parameter>
8357984542 </parameters>
@@ -83581,7 +84544,7 @@ use [func@GLib.utf8_strncpy] instead.</doc>
8358184544 <function name="strreverse" c:identifier="g_strreverse">
8358284545 <doc xml:space="preserve"
8358384546 filename="glib/gstrfuncs.c"
83584- line="1669">Reverses all of the bytes in a string. For example,
84547+ line="1673">Reverses all of the bytes in a string. For example,
8358584548 `g_strreverse ("abcdef")` will result in "fedcba".
8358684549
8358784550 Note that `g_strreverse()` doesn't work on UTF-8 strings
@@ -83591,14 +84554,14 @@ containing multibyte characters. For that purpose, use
8359184554 <return-value transfer-ownership="full">
8359284555 <doc xml:space="preserve"
8359384556 filename="glib/gstrfuncs.c"
83594- line="1680">the @string, reversed in place</doc>
84557+ line="1684">the @string, reversed in place</doc>
8359584558 <type name="utf8" c:type="gchar*"/>
8359684559 </return-value>
8359784560 <parameters>
8359884561 <parameter name="string" transfer-ownership="none">
8359984562 <doc xml:space="preserve"
8360084563 filename="glib/gstrfuncs.c"
83601- line="1671">the string to reverse</doc>
84564+ line="1675">the string to reverse</doc>
8360284565 <type name="utf8" c:type="gchar*"/>
8360384566 </parameter>
8360484567 </parameters>
@@ -83606,7 +84569,7 @@ containing multibyte characters. For that purpose, use
8360684569 <function name="strrstr" c:identifier="g_strrstr">
8360784570 <doc xml:space="preserve"
8360884571 filename="glib/gstrfuncs.c"
83609- line="2790">Searches the string @haystack for the last occurrence
84572+ line="2794">Searches the string @haystack for the last occurrence
8361084573 of the string @needle.
8361184574
8361284575 The fact that this function returns `gchar *` rather than `const gchar *` is
@@ -83615,7 +84578,7 @@ a historical artifact.</doc>
8361584578 <return-value transfer-ownership="none" nullable="1">
8361684579 <doc xml:space="preserve"
8361784580 filename="glib/gstrfuncs.c"
83618- line="2801">a pointer to the found occurrence, or
84581+ line="2805">a pointer to the found occurrence, or
8361984582 `NULL` if not found</doc>
8362084583 <type name="utf8" c:type="gchar*"/>
8362184584 </return-value>
@@ -83623,13 +84586,13 @@ a historical artifact.</doc>
8362384586 <parameter name="haystack" transfer-ownership="none">
8362484587 <doc xml:space="preserve"
8362584588 filename="glib/gstrfuncs.c"
83626- line="2792">a string to search in</doc>
84589+ line="2796">a string to search in</doc>
8362784590 <type name="utf8" c:type="const gchar*"/>
8362884591 </parameter>
8362984592 <parameter name="needle" transfer-ownership="none">
8363084593 <doc xml:space="preserve"
8363184594 filename="glib/gstrfuncs.c"
83632- line="2793">the string to search for</doc>
84595+ line="2797">the string to search for</doc>
8363384596 <type name="utf8" c:type="const gchar*"/>
8363484597 </parameter>
8363584598 </parameters>
@@ -83637,7 +84600,7 @@ a historical artifact.</doc>
8363784600 <function name="strrstr_len" c:identifier="g_strrstr_len">
8363884601 <doc xml:space="preserve"
8363984602 filename="glib/gstrfuncs.c"
83640- line="2842">Searches the string @haystack for the last occurrence
84603+ line="2846">Searches the string @haystack for the last occurrence
8364184604 of the string @needle, limiting the length of the search
8364284605 to @haystack_len.
8364384606
@@ -83647,7 +84610,7 @@ a historical artifact.</doc>
8364784610 <return-value transfer-ownership="none" nullable="1">
8364884611 <doc xml:space="preserve"
8364984612 filename="glib/gstrfuncs.c"
83650- line="2856">a pointer to the found occurrence, or
84613+ line="2860">a pointer to the found occurrence, or
8365184614 `NULL` if not found</doc>
8365284615 <type name="utf8" c:type="gchar*"/>
8365384616 </return-value>
@@ -83655,20 +84618,20 @@ a historical artifact.</doc>
8365584618 <parameter name="haystack" transfer-ownership="none">
8365684619 <doc xml:space="preserve"
8365784620 filename="glib/gstrfuncs.c"
83658- line="2844">a string to search in</doc>
84621+ line="2848">a string to search in</doc>
8365984622 <type name="utf8" c:type="const gchar*"/>
8366084623 </parameter>
8366184624 <parameter name="haystack_len" transfer-ownership="none">
8366284625 <doc xml:space="preserve"
8366384626 filename="glib/gstrfuncs.c"
83664- line="2845">the maximum length of @haystack in bytes. A length of `-1`
84627+ line="2849">the maximum length of @haystack in bytes. A length of `-1`
8366584628 can be used to mean "search the entire string", like [func@GLib.strrstr]</doc>
8366684629 <type name="gssize" c:type="gssize"/>
8366784630 </parameter>
8366884631 <parameter name="needle" transfer-ownership="none">
8366984632 <doc xml:space="preserve"
8367084633 filename="glib/gstrfuncs.c"
83671- line="2847">the string to search for</doc>
84634+ line="2851">the string to search for</doc>
8367284635 <type name="utf8" c:type="const gchar*"/>
8367384636 </parameter>
8367484637 </parameters>
@@ -83676,7 +84639,7 @@ a historical artifact.</doc>
8367684639 <function name="strsignal" c:identifier="g_strsignal">
8367784640 <doc xml:space="preserve"
8367884641 filename="glib/gstrfuncs.c"
83679- line="1357">Returns a string describing the given signal, e.g. "Segmentation fault".
84642+ line="1361">Returns a string describing the given signal, e.g. "Segmentation fault".
8368084643 If the signal is unknown, it returns “unknown signal (&lt;signum\&gt;)”.
8368184644
8368284645 You should use this function in preference to `strsignal()`, because it
@@ -83686,14 +84649,14 @@ the `strsignal()` function.</doc>
8368684649 <return-value transfer-ownership="none">
8368784650 <doc xml:space="preserve"
8368884651 filename="glib/gstrfuncs.c"
83689- line="1368">the string describing the signal</doc>
84652+ line="1372">the string describing the signal</doc>
8369084653 <type name="utf8" c:type="const gchar*"/>
8369184654 </return-value>
8369284655 <parameters>
8369384656 <parameter name="signum" transfer-ownership="none">
8369484657 <doc xml:space="preserve"
8369584658 filename="glib/gstrfuncs.c"
83696- line="1359">the signal number. See the `signal` documentation</doc>
84659+ line="1363">the signal number. See the `signal` documentation</doc>
8369784660 <type name="gint" c:type="gint"/>
8369884661 </parameter>
8369984662 </parameters>
@@ -83701,7 +84664,7 @@ the `strsignal()` function.</doc>
8370184664 <function name="strsplit" c:identifier="g_strsplit">
8370284665 <doc xml:space="preserve"
8370384666 filename="glib/gstrfuncs.c"
83704- line="2362">Splits a string into a maximum of @max_tokens pieces, using the given
84667+ line="2366">Splits a string into a maximum of @max_tokens pieces, using the given
8370584668 @delimiter. If @max_tokens is reached, the remainder of @string is
8370684669 appended to the last token.
8370784670
@@ -83718,7 +84681,7 @@ before calling `g_strsplit()`.</doc>
8371884681 <return-value transfer-ownership="full">
8371984682 <doc xml:space="preserve"
8372084683 filename="glib/gstrfuncs.c"
83721- line="2385">a newly-allocated array of strings, freed with
84684+ line="2389">a newly-allocated array of strings, freed with
8372284685 [func@GLib.strfreev]</doc>
8372384686 <array c:type="gchar**">
8372484687 <type name="utf8"/>
@@ -83728,13 +84691,13 @@ before calling `g_strsplit()`.</doc>
8372884691 <parameter name="string" transfer-ownership="none">
8372984692 <doc xml:space="preserve"
8373084693 filename="glib/gstrfuncs.c"
83731- line="2364">a string to split</doc>
84694+ line="2368">a string to split</doc>
8373284695 <type name="utf8" c:type="const gchar*"/>
8373384696 </parameter>
8373484697 <parameter name="delimiter" transfer-ownership="none">
8373584698 <doc xml:space="preserve"
8373684699 filename="glib/gstrfuncs.c"
83737- line="2365">a string which specifies the places at which to split
84700+ line="2369">a string which specifies the places at which to split
8373884701 the string. The delimiter is not included in any of the resulting
8373984702 strings, unless @max_tokens is reached.</doc>
8374084703 <type name="utf8" c:type="const gchar*"/>
@@ -83742,7 +84705,7 @@ before calling `g_strsplit()`.</doc>
8374284705 <parameter name="max_tokens" transfer-ownership="none">
8374384706 <doc xml:space="preserve"
8374484707 filename="glib/gstrfuncs.c"
83745- line="2368">the maximum number of pieces to split @string into
84708+ line="2372">the maximum number of pieces to split @string into
8374684709 If this is less than 1, the string is split completely</doc>
8374784710 <type name="gint" c:type="gint"/>
8374884711 </parameter>
@@ -83751,7 +84714,7 @@ before calling `g_strsplit()`.</doc>
8375184714 <function name="strsplit_set" c:identifier="g_strsplit_set" version="2.4">
8375284715 <doc xml:space="preserve"
8375384716 filename="glib/gstrfuncs.c"
83754- line="2435">Splits @string into a number of tokens not containing any of the characters
84717+ line="2439">Splits @string into a number of tokens not containing any of the characters
8375584718 in @delimiters. A token is the (possibly empty) longest string that does not
8375684719 contain any of the characters in @delimiters. If @max_tokens is reached, the
8375784720 remainder is appended to the last token.
@@ -83775,7 +84738,7 @@ to delimit UTF-8 strings for anything but ASCII characters.</doc>
8377584738 <return-value transfer-ownership="full">
8377684739 <doc xml:space="preserve"
8377784740 filename="glib/gstrfuncs.c"
83778- line="2464">a newly-allocated array of strings. Use
84741+ line="2468">a newly-allocated array of strings. Use
8377984742 [func@GLib.strfreev] to free it.</doc>
8378084743 <array c:type="gchar**">
8378184744 <type name="utf8"/>
@@ -83785,20 +84748,20 @@ to delimit UTF-8 strings for anything but ASCII characters.</doc>
8378584748 <parameter name="string" transfer-ownership="none">
8378684749 <doc xml:space="preserve"
8378784750 filename="glib/gstrfuncs.c"
83788- line="2437">a string to split</doc>
84751+ line="2441">a string to split</doc>
8378984752 <type name="utf8" c:type="const gchar*"/>
8379084753 </parameter>
8379184754 <parameter name="delimiters" transfer-ownership="none">
8379284755 <doc xml:space="preserve"
8379384756 filename="glib/gstrfuncs.c"
83794- line="2438">a string containing characters that are used to split the
84757+ line="2442">a string containing characters that are used to split the
8379584758 string. Can be empty, which will result in no string splitting</doc>
8379684759 <type name="utf8" c:type="const gchar*"/>
8379784760 </parameter>
8379884761 <parameter name="max_tokens" transfer-ownership="none">
8379984762 <doc xml:space="preserve"
8380084763 filename="glib/gstrfuncs.c"
83801- line="2440">the maximum number of tokens to split @string into.
84764+ line="2444">the maximum number of tokens to split @string into.
8380284765 If this is less than 1, the string is split completely</doc>
8380384766 <type name="gint" c:type="gint"/>
8380484767 </parameter>
@@ -83807,7 +84770,7 @@ to delimit UTF-8 strings for anything but ASCII characters.</doc>
8380784770 <function name="strstr_len" c:identifier="g_strstr_len">
8380884771 <doc xml:space="preserve"
8380984772 filename="glib/gstrfuncs.c"
83810- line="2728">Searches the string @haystack for the first occurrence
84773+ line="2732">Searches the string @haystack for the first occurrence
8381184774 of the string @needle, limiting the length of the search
8381284775 to @haystack_len or a nul terminator byte (whichever is reached first).
8381384776
@@ -83820,7 +84783,7 @@ a historical artifact.</doc>
8382084783 <return-value transfer-ownership="none" nullable="1">
8382184784 <doc xml:space="preserve"
8382284785 filename="glib/gstrfuncs.c"
83823- line="2745">a pointer to the found occurrence, or
84786+ line="2749">a pointer to the found occurrence, or
8382484787 `NULL` if not found</doc>
8382584788 <type name="utf8" c:type="gchar*"/>
8382684789 </return-value>
@@ -83828,20 +84791,20 @@ a historical artifact.</doc>
8382884791 <parameter name="haystack" transfer-ownership="none">
8382984792 <doc xml:space="preserve"
8383084793 filename="glib/gstrfuncs.c"
83831- line="2730">a string to search in</doc>
84794+ line="2734">a string to search in</doc>
8383284795 <type name="utf8" c:type="const gchar*"/>
8383384796 </parameter>
8383484797 <parameter name="haystack_len" transfer-ownership="none">
8383584798 <doc xml:space="preserve"
8383684799 filename="glib/gstrfuncs.c"
83837- line="2731">the maximum length of @haystack in bytes, or `-1` to
84800+ line="2735">the maximum length of @haystack in bytes, or `-1` to
8383884801 search it entirely</doc>
8383984802 <type name="gssize" c:type="gssize"/>
8384084803 </parameter>
8384184804 <parameter name="needle" transfer-ownership="none">
8384284805 <doc xml:space="preserve"
8384384806 filename="glib/gstrfuncs.c"
83844- line="2733">the string to search for</doc>
84807+ line="2737">the string to search for</doc>
8384584808 <type name="utf8" c:type="const gchar*"/>
8384684809 </parameter>
8384784810 </parameters>
@@ -83866,7 +84829,7 @@ See [func@GLib.strchomp] and [func@GLib.strchug].</doc>
8386684829 <function name="strtod" c:identifier="g_strtod">
8386784830 <doc xml:space="preserve"
8386884831 filename="glib/gstrfuncs.c"
83869- line="601">Converts a string to a floating point value.
84832+ line="605">Converts a string to a floating point value.
8387084833
8387184834 It calls the standard `strtod()` function to handle the conversion, but
8387284835 if the string is not completely converted it attempts the conversion
@@ -83882,14 +84845,14 @@ point in some locales, causing unexpected results.</doc>
8388284845 <return-value transfer-ownership="none">
8388384846 <doc xml:space="preserve"
8388484847 filename="glib/gstrfuncs.c"
83885- line="620">the converted value</doc>
84848+ line="624">the converted value</doc>
8388684849 <type name="gdouble" c:type="gdouble"/>
8388784850 </return-value>
8388884851 <parameters>
8388984852 <parameter name="nptr" transfer-ownership="none">
8389084853 <doc xml:space="preserve"
8389184854 filename="glib/gstrfuncs.c"
83892- line="603">the string to convert to a numeric value</doc>
84855+ line="607">the string to convert to a numeric value</doc>
8389384856 <type name="utf8" c:type="const gchar*"/>
8389484857 </parameter>
8389584858 <parameter name="endptr"
@@ -83900,7 +84863,7 @@ point in some locales, causing unexpected results.</doc>
8390084863 allow-none="1">
8390184864 <doc xml:space="preserve"
8390284865 filename="glib/gstrfuncs.c"
83903- line="604">if non-`NULL`, it returns the
84866+ line="608">if non-`NULL`, it returns the
8390484867 character after the last character used in the conversion</doc>
8390584868 <type name="utf8" c:type="gchar**"/>
8390684869 </parameter>
@@ -83912,7 +84875,7 @@ point in some locales, causing unexpected results.</doc>
8391284875 deprecated-version="2.2">
8391384876 <doc xml:space="preserve"
8391484877 filename="glib/gstrfuncs.c"
83915- line="1638">Converts a string to upper case.</doc>
84878+ line="1642">Converts a string to upper case.</doc>
8391684879 <doc-deprecated xml:space="preserve">This function is totally broken for the reasons discussed
8391784880 in the [func@GLib.strncasecmp] docs — use [func@GLib.ascii_strup] or
8391884881 [func@GLib.utf8_strup] instead.</doc-deprecated>
@@ -83920,14 +84883,14 @@ point in some locales, causing unexpected results.</doc>
8392084883 <return-value transfer-ownership="full">
8392184884 <doc xml:space="preserve"
8392284885 filename="glib/gstrfuncs.c"
83923- line="1644">the string</doc>
84886+ line="1648">the string</doc>
8392484887 <type name="utf8" c:type="gchar*"/>
8392584888 </return-value>
8392684889 <parameters>
8392784890 <parameter name="string" transfer-ownership="none">
8392884891 <doc xml:space="preserve"
8392984892 filename="glib/gstrfuncs.c"
83930- line="1640">the string to convert</doc>
84893+ line="1644">the string to convert</doc>
8393184894 <type name="utf8" c:type="gchar*"/>
8393284895 </parameter>
8393384896 </parameters>
@@ -83937,20 +84900,20 @@ point in some locales, causing unexpected results.</doc>
8393784900 version="2.44">
8393884901 <doc xml:space="preserve"
8393984902 filename="glib/gstrfuncs.c"
83940- line="3221">Checks if an array of strings contains the string @str according to
84903+ line="3225">Checks if an array of strings contains the string @str according to
8394184904 [func@GLib.str_equal]. @strv must not be `NULL`.</doc>
8394284905 <source-position filename="glib/gstrfuncs.h" line="392"/>
8394384906 <return-value transfer-ownership="none">
8394484907 <doc xml:space="preserve"
8394584908 filename="glib/gstrfuncs.c"
83946- line="3229">true if @str is an element of @strv</doc>
84909+ line="3233">true if @str is an element of @strv</doc>
8394784910 <type name="gboolean" c:type="gboolean"/>
8394884911 </return-value>
8394984912 <parameters>
8395084913 <parameter name="strv" transfer-ownership="none">
8395184914 <doc xml:space="preserve"
8395284915 filename="glib/gstrfuncs.c"
83953- line="3223">an array of strings to search in</doc>
84916+ line="3227">an array of strings to search in</doc>
8395484917 <array c:type="const gchar* const*">
8395584918 <type name="utf8" c:type="gchar*"/>
8395684919 </array>
@@ -83958,7 +84921,7 @@ point in some locales, causing unexpected results.</doc>
8395884921 <parameter name="str" transfer-ownership="none">
8395984922 <doc xml:space="preserve"
8396084923 filename="glib/gstrfuncs.c"
83961- line="3224">the string to search for</doc>
84924+ line="3228">the string to search for</doc>
8396284925 <type name="utf8" c:type="const gchar*"/>
8396384926 </parameter>
8396484927 </parameters>
@@ -83966,7 +84929,7 @@ point in some locales, causing unexpected results.</doc>
8396684929 <function name="strv_equal" c:identifier="g_strv_equal" version="2.60">
8396784930 <doc xml:space="preserve"
8396884931 filename="glib/gstrfuncs.c"
83969- line="3249">Checks if two arrays of strings contain exactly the same elements in
84932+ line="3253">Checks if two arrays of strings contain exactly the same elements in
8397084933 exactly the same order.
8397184934
8397284935 Elements are compared using [func@GLib.str_equal]. To match independently
@@ -83979,14 +84942,14 @@ Two empty arrays are considered equal. Neither @strv1 nor @strv2 may be
8397984942 <return-value transfer-ownership="none">
8398084943 <doc xml:space="preserve"
8398184944 filename="glib/gstrfuncs.c"
83982- line="3264">true if @strv1 and @strv2 are equal</doc>
84945+ line="3268">true if @strv1 and @strv2 are equal</doc>
8398384946 <type name="gboolean" c:type="gboolean"/>
8398484947 </return-value>
8398584948 <parameters>
8398684949 <parameter name="strv1" transfer-ownership="none">
8398784950 <doc xml:space="preserve"
8398884951 filename="glib/gstrfuncs.c"
83989- line="3251">an array of strings to compare to @strv2</doc>
84952+ line="3255">an array of strings to compare to @strv2</doc>
8399084953 <array c:type="const gchar* const*">
8399184954 <type name="utf8" c:type="gchar*"/>
8399284955 </array>
@@ -83994,7 +84957,7 @@ Two empty arrays are considered equal. Neither @strv1 nor @strv2 may be
8399484957 <parameter name="strv2" transfer-ownership="none">
8399584958 <doc xml:space="preserve"
8399684959 filename="glib/gstrfuncs.c"
83997- line="3252">an array of strings to compare to @strv1</doc>
84960+ line="3256">an array of strings to compare to @strv1</doc>
8399884961 <array c:type="const gchar* const*">
8399984962 <type name="utf8" c:type="gchar*"/>
8400084963 </array>
@@ -84010,19 +84973,19 @@ Two empty arrays are considered equal. Neither @strv1 nor @strv2 may be
8401084973 <function name="strv_length" c:identifier="g_strv_length" version="2.6">
8401184974 <doc xml:space="preserve"
8401284975 filename="glib/gstrfuncs.c"
84013- line="2950">Returns the length of an array of strings. @str_array must not be `NULL`.</doc>
84976+ line="2954">Returns the length of an array of strings. @str_array must not be `NULL`.</doc>
8401484977 <source-position filename="glib/gstrfuncs.h" line="371"/>
8401584978 <return-value transfer-ownership="none">
8401684979 <doc xml:space="preserve"
8401784980 filename="glib/gstrfuncs.c"
84018- line="2956">length of @str_array</doc>
84981+ line="2960">length of @str_array</doc>
8401984982 <type name="guint" c:type="guint"/>
8402084983 </return-value>
8402184984 <parameters>
8402284985 <parameter name="str_array" transfer-ownership="none">
8402384986 <doc xml:space="preserve"
8402484987 filename="glib/gstrfuncs.c"
84025- line="2952">an array of strings</doc>
84988+ line="2956">an array of strings</doc>
8402684989 <array c:type="gchar**">
8402784990 <type name="utf8" c:type="gchar*"/>
8402884991 </array>
@@ -84135,7 +85098,7 @@ and it is recommended to do so even if it isn’t.</doc>
8413585098 filename="glib/gtestutils.c"
8413685099 line="2868">Creates a new test case.
8413785100
84138-In constract to [func@GLib.test_add_data_func], this function
85101+In contrast to [func@GLib.test_add_data_func], this function
8413985102 is freeing @test_data after the test run is complete.</doc>
8414085103 <source-position filename="glib/gtestutils.h" line="408"/>
8414185104 <return-value transfer-ownership="none">
@@ -84251,7 +85214,7 @@ it is recommended to do so even if it isn’t.</doc>
8425185214 introspectable="0">
8425285215 <doc xml:space="preserve"
8425385216 filename="glib/gmessages.c"
84254- line="3227">Asserts that all messages previously indicated via
85217+ line="3313">Asserts that all messages previously indicated via
8425585218 [func@GLib.test_expect_message] have been seen and suppressed.
8425685219
8425785220 This API may only be used with the old logging API ([func@GLib.log] without
@@ -84515,7 +85478,7 @@ crash collection infrastructure such as systemd-coredump or abrt.</doc>
8451585478 version="2.34">
8451685479 <doc xml:space="preserve"
8451785480 filename="glib/gmessages.c"
84518- line="3141">Indicates that a message with the given @log_domain and @log_level,
85481+ line="3227">Indicates that a message with the given @log_domain and @log_level,
8451985482 with text matching @pattern, is expected to be logged.
8452085483
8452185484 When this message is logged, it will not be printed, and the test case will
@@ -84561,19 +85524,19 @@ expected via [func@GLib.test_expect_message] then they will be ignored.</doc>
8456185524 allow-none="1">
8456285525 <doc xml:space="preserve"
8456385526 filename="glib/gmessages.c"
84564- line="3143">the log domain of the message</doc>
85527+ line="3229">the log domain of the message</doc>
8456585528 <type name="utf8" c:type="const gchar*"/>
8456685529 </parameter>
8456785530 <parameter name="log_level" transfer-ownership="none">
8456885531 <doc xml:space="preserve"
8456985532 filename="glib/gmessages.c"
84570- line="3144">the log level of the message</doc>
85533+ line="3230">the log level of the message</doc>
8457185534 <type name="LogLevelFlags" c:type="GLogLevelFlags"/>
8457285535 </parameter>
8457385536 <parameter name="pattern" transfer-ownership="none">
8457485537 <doc xml:space="preserve"
8457585538 filename="glib/gmessages.c"
84576- line="3145">a glob-style pattern (see [type@GLib.PatternSpec])</doc>
85539+ line="3231">a glob-style pattern (see [type@GLib.PatternSpec])</doc>
8457785540 <type name="utf8" c:type="const gchar*"/>
8457885541 </parameter>
8457985542 </parameters>
@@ -84925,7 +85888,7 @@ when compiled with `G_DISABLE_ASSERT`. Ensure your tests are compiled without
8492585888 introspectable="0">
8492685889 <doc xml:space="preserve"
8492785890 filename="glib/gmessages.c"
84928- line="814">Installs a non-error fatal log handler which can be
85891+ line="867">Installs a non-error fatal log handler which can be
8492985892 used to decide whether log messages which are counted
8493085893 as fatal abort the program.
8493185894
@@ -84954,7 +85917,7 @@ writer function using [func@GLib.log_set_writer_func].See
8495485917 <parameter name="log_func" transfer-ownership="none" closure="1">
8495585918 <doc xml:space="preserve"
8495685919 filename="glib/gmessages.c"
84957- line="816">the log handler function.</doc>
85920+ line="869">the log handler function.</doc>
8495885921 <type name="TestLogFatalFunc" c:type="GTestLogFatalFunc"/>
8495985922 </parameter>
8496085923 <parameter name="user_data"
@@ -84963,7 +85926,7 @@ writer function using [func@GLib.log_set_writer_func].See
8496385926 allow-none="1">
8496485927 <doc xml:space="preserve"
8496585928 filename="glib/gmessages.c"
84966- line="817">data passed to the log handler.</doc>
85929+ line="870">data passed to the log handler.</doc>
8496785930 <type name="gpointer" c:type="gpointer"/>
8496885931 </parameter>
8496985932 </parameters>
@@ -85929,7 +86892,7 @@ abort with an error message.
8592986892 }
8593086893
8593186894 // Reruns this same test in a subprocess
85932- g_autoptr(GStrv) envp = g_get_environ ();
86895+ g_auto(GStrv) envp = g_get_environ ();
8593386896 envp = g_environ_setenv (g_steal_pointer (&amp;envp), "USER", "charlie", TRUE);
8593486897 g_test_trap_subprocess_with_envp (NULL, envp, 0, G_TEST_SUBPROCESS_DEFAULT);
8593586898 g_test_trap_assert_passed ();
@@ -86312,7 +87275,7 @@ anymore and the @vtable parameter is ignored and you should pass %NULL.
8631287275 version="2.10">
8631387276 <doc xml:space="preserve"
8631487277 filename="glib/gthreadpool.c"
86315- line="1191">This function will return the maximum @interval that a
87278+ line="1203">This function will return the maximum @interval that a
8631687279 thread will wait in the thread pool for new tasks before
8631787280 being stopped.
8631887281
@@ -86322,7 +87285,7 @@ pool for new work are not stopped.</doc>
8632287285 <return-value transfer-ownership="none">
8632387286 <doc xml:space="preserve"
8632487287 filename="glib/gthreadpool.c"
86325- line="1201">the maximum @interval (milliseconds) to wait
87288+ line="1213">the maximum @interval (milliseconds) to wait
8632687289 for new tasks in the thread pool before stopping the
8632787290 thread</doc>
8632887291 <type name="guint" c:type="guint"/>
@@ -86333,12 +87296,12 @@ pool for new work are not stopped.</doc>
8633387296 moved-to="ThreadPool.get_max_unused_threads">
8633487297 <doc xml:space="preserve"
8633587298 filename="glib/gthreadpool.c"
86336- line="1028">Returns the maximal allowed number of unused threads.</doc>
87299+ line="1040">Returns the maximal allowed number of unused threads.</doc>
8633787300 <source-position filename="glib/gthreadpool.h" line="93"/>
8633887301 <return-value transfer-ownership="none">
8633987302 <doc xml:space="preserve"
8634087303 filename="glib/gthreadpool.c"
86341- line="1033">the maximal number of unused threads</doc>
87304+ line="1045">the maximal number of unused threads</doc>
8634287305 <type name="gint" c:type="gint"/>
8634387306 </return-value>
8634487307 </function>
@@ -86347,12 +87310,12 @@ pool for new work are not stopped.</doc>
8634787310 moved-to="ThreadPool.get_num_unused_threads">
8634887311 <doc xml:space="preserve"
8634987312 filename="glib/gthreadpool.c"
86350- line="1041">Returns the number of currently unused threads.</doc>
87313+ line="1053">Returns the number of currently unused threads.</doc>
8635187314 <source-position filename="glib/gthreadpool.h" line="95"/>
8635287315 <return-value transfer-ownership="none">
8635387316 <doc xml:space="preserve"
8635487317 filename="glib/gthreadpool.c"
86355- line="1046">the number of currently unused threads</doc>
87318+ line="1058">the number of currently unused threads</doc>
8635687319 <type name="guint" c:type="guint"/>
8635787320 </return-value>
8635887321 </function>
@@ -86362,7 +87325,7 @@ pool for new work are not stopped.</doc>
8636287325 version="2.10">
8636387326 <doc xml:space="preserve"
8636487327 filename="glib/gthreadpool.c"
86365- line="1150">This function will set the maximum @interval that a thread
87328+ line="1162">This function will set the maximum @interval that a thread
8636687329 waiting in the pool for new tasks can be idle for before
8636787330 being stopped. This function is similar to calling
8636887331 g_thread_pool_stop_unused_threads() on a regular timeout,
@@ -86379,7 +87342,7 @@ The default value is 15000 (15 seconds).</doc>
8637987342 <parameter name="interval" transfer-ownership="none">
8638087343 <doc xml:space="preserve"
8638187344 filename="glib/gthreadpool.c"
86382- line="1152">the maximum @interval (in milliseconds)
87345+ line="1164">the maximum @interval (in milliseconds)
8638387346 a thread can be idle</doc>
8638487347 <type name="guint" c:type="guint"/>
8638587348 </parameter>
@@ -86390,7 +87353,7 @@ The default value is 15000 (15 seconds).</doc>
8639087353 moved-to="ThreadPool.set_max_unused_threads">
8639187354 <doc xml:space="preserve"
8639287355 filename="glib/gthreadpool.c"
86393- line="989">Sets the maximal number of unused threads to @max_threads.
87356+ line="1001">Sets the maximal number of unused threads to @max_threads.
8639487357 If @max_threads is -1, no limit is imposed on the number
8639587358 of unused threads.
8639687359
@@ -86403,7 +87366,7 @@ The default value is 8 since GLib 2.84. Previously the default value was 2.</doc
8640387366 <parameter name="max_threads" transfer-ownership="none">
8640487367 <doc xml:space="preserve"
8640587368 filename="glib/gthreadpool.c"
86406- line="991">maximal number of unused threads</doc>
87369+ line="1003">maximal number of unused threads</doc>
8640787370 <type name="gint" c:type="gint"/>
8640887371 </parameter>
8640987372 </parameters>
@@ -86413,7 +87376,7 @@ The default value is 8 since GLib 2.84. Previously the default value was 2.</doc
8641387376 moved-to="ThreadPool.stop_unused_threads">
8641487377 <doc xml:space="preserve"
8641587378 filename="glib/gthreadpool.c"
86416- line="1054">Stops all currently unused threads. This does not change the
87379+ line="1066">Stops all currently unused threads. This does not change the
8641787380 maximal number of unused threads. This function can be used to
8641887381 regularly stop all unused threads e.g. from g_timeout_add().</doc>
8641987382 <source-position filename="glib/gthreadpool.h" line="97"/>
@@ -86527,11 +87490,11 @@ g_date_time_unref (dt);
8652787490 introspectable="0">
8652887491 <doc xml:space="preserve"
8652987492 filename="glib/gmain.c"
86530- line="5264">Sets a function to be called at regular intervals, with the default
87493+ line="5452">Sets a function to be called at regular intervals, with the default
8653187494 priority, [const@GLib.PRIORITY_DEFAULT].
8653287495
8653387496 The given @function is called repeatedly until it returns
86534-[const@GLib.SOURCE_REMOVE] or %FALSE, at which point the timeout is
87497+[const@GLib.SOURCE_REMOVE], at which point the timeout is
8653587498 automatically destroyed and the function will not be called again. The first
8653687499 call to the function will be at the end of the first @interval.
8653787500
@@ -86539,12 +87502,12 @@ Note that timeout functions may be delayed, due to the processing of other
8653987502 event sources. Thus they should not be relied on for precise timing.
8654087503 After each call to the timeout function, the time of the next
8654187504 timeout is recalculated based on the current time and the given interval
86542-(it does not try to 'catch up' time lost in delays).
87505+(it does not try to ‘catch up’ time lost in delays).
8654387506
86544-See [mainloop memory management](main-loop.html#memory-management-of-sources) for details
87507+See [main loop memory management](main-loop.html#memory-management-of-sources) for details
8654587508 on how to handle the return value and memory management of @data.
8654687509
86547-If you want to have a timer in the "seconds" range and do not care
87510+If you want to have a timer in the ‘seconds’ range and do not care
8654887511 about the exact time of the first call of the timer, use the
8654987512 [func@GLib.timeout_add_seconds] function; this function allows for more
8655087513 optimizations and more efficient system power usage.
@@ -86560,25 +87523,24 @@ It is safe to call this function from any thread.
8656087523
8656187524 The interval given is in terms of monotonic time, not wall clock
8656287525 time. See [func@GLib.get_monotonic_time].</doc>
86563- <source-position filename="glib/gmain.h" line="931"/>
87526+ <source-position filename="glib/gmain.h" line="934"/>
8656487527 <return-value transfer-ownership="none">
8656587528 <doc xml:space="preserve"
8656687529 filename="glib/gmain.c"
86567- line="5305">the ID (greater than 0) of the event source.</doc>
87530+ line="5492">the ID (greater than 0) of the event source</doc>
8656887531 <type name="guint" c:type="guint"/>
8656987532 </return-value>
8657087533 <parameters>
8657187534 <parameter name="interval" transfer-ownership="none">
8657287535 <doc xml:space="preserve"
8657387536 filename="glib/gmain.c"
86574- line="5266">the time between calls to the function, in milliseconds
86575- (1/1000ths of a second)</doc>
87537+ line="5454">the time between calls to the function, in milliseconds</doc>
8657687538 <type name="guint" c:type="guint"/>
8657787539 </parameter>
8657887540 <parameter name="function" transfer-ownership="none" closure="2">
8657987541 <doc xml:space="preserve"
8658087542 filename="glib/gmain.c"
86581- line="5268">function to call</doc>
87543+ line="5455">function to call</doc>
8658287544 <type name="SourceFunc" c:type="GSourceFunc"/>
8658387545 </parameter>
8658487546 <parameter name="data"
@@ -86587,7 +87549,7 @@ time. See [func@GLib.get_monotonic_time].</doc>
8658787549 allow-none="1">
8658887550 <doc xml:space="preserve"
8658987551 filename="glib/gmain.c"
86590- line="5269">data to pass to @function</doc>
87552+ line="5456">data to pass to @function</doc>
8659187553 <type name="gpointer" c:type="gpointer"/>
8659287554 </parameter>
8659387555 </parameters>
@@ -86597,9 +87559,12 @@ time. See [func@GLib.get_monotonic_time].</doc>
8659787559 shadows="timeout_add">
8659887560 <doc xml:space="preserve"
8659987561 filename="glib/gmain.c"
86600- line="5215">Sets a function to be called at regular intervals, with the given
86601-priority. The function is called repeatedly until it returns
86602-%FALSE, at which point the timeout is automatically destroyed and
87562+ line="5401">Sets a function to be called at regular intervals, with the given
87563+priority.
87564+
87565+The function is called repeatedly until it returns
87566+[const@GLib.SOURCE_REMOVE], at which point the timeout is automatically
87567+destroyed and
8660387568 the function will not be called again. The @notify function is
8660487569 called when the timeout is destroyed. The first call to the
8660587570 function will be at the end of the first @interval.
@@ -86608,9 +87573,9 @@ Note that timeout functions may be delayed, due to the processing of other
8660887573 event sources. Thus they should not be relied on for precise timing.
8660987574 After each call to the timeout function, the time of the next
8661087575 timeout is recalculated based on the current time and the given interval
86611-(it does not try to 'catch up' time lost in delays).
87576+(it does not try to ‘catch up’ time lost in delays).
8661287577
86613-See [mainloop memory management](main-loop.html#memory-management-of-sources) for details
87578+See [main loop memory management](main-loop.html#memory-management-of-sources) for details
8661487579 on how to handle the return value and memory management of @data.
8661587580
8661687581 This internally creates a main loop source using
@@ -86622,27 +87587,26 @@ context.
8662287587
8662387588 The interval given is in terms of monotonic time, not wall clock time.
8662487589 See [func@GLib.get_monotonic_time].</doc>
86625- <source-position filename="glib/gmain.h" line="925"/>
87590+ <source-position filename="glib/gmain.h" line="928"/>
8662687591 <return-value transfer-ownership="none">
8662787592 <doc xml:space="preserve"
8662887593 filename="glib/gmain.c"
86629- line="5252">the ID (greater than 0) of the event source.</doc>
87594+ line="5440">the ID (greater than 0) of the event source</doc>
8663087595 <type name="guint" c:type="guint"/>
8663187596 </return-value>
8663287597 <parameters>
8663387598 <parameter name="priority" transfer-ownership="none">
8663487599 <doc xml:space="preserve"
8663587600 filename="glib/gmain.c"
86636- line="5217">the priority of the timeout source. Typically this will be in
87601+ line="5403">the priority of the timeout source; typically this will be in
8663787602 the range between [const@GLib.PRIORITY_DEFAULT] and
86638- [const@GLib.PRIORITY_HIGH].</doc>
87603+ [const@GLib.PRIORITY_HIGH]</doc>
8663987604 <type name="gint" c:type="gint"/>
8664087605 </parameter>
8664187606 <parameter name="interval" transfer-ownership="none">
8664287607 <doc xml:space="preserve"
8664387608 filename="glib/gmain.c"
86644- line="5220">the time between calls to the function, in milliseconds
86645- (1/1000ths of a second)</doc>
87609+ line="5406">the time between calls to the function, in milliseconds</doc>
8664687610 <type name="guint" c:type="guint"/>
8664787611 </parameter>
8664887612 <parameter name="function"
@@ -86652,7 +87616,7 @@ See [func@GLib.get_monotonic_time].</doc>
8665287616 destroy="4">
8665387617 <doc xml:space="preserve"
8665487618 filename="glib/gmain.c"
86655- line="5222">function to call</doc>
87619+ line="5407">function to call</doc>
8665687620 <type name="SourceFunc" c:type="GSourceFunc"/>
8665787621 </parameter>
8665887622 <parameter name="data"
@@ -86661,7 +87625,7 @@ See [func@GLib.get_monotonic_time].</doc>
8666187625 allow-none="1">
8666287626 <doc xml:space="preserve"
8666387627 filename="glib/gmain.c"
86664- line="5223">data to pass to @function</doc>
87628+ line="5408">data to pass to @function</doc>
8666587629 <type name="gpointer" c:type="gpointer"/>
8666687630 </parameter>
8666787631 <parameter name="notify"
@@ -86671,7 +87635,7 @@ See [func@GLib.get_monotonic_time].</doc>
8667187635 scope="async">
8667287636 <doc xml:space="preserve"
8667387637 filename="glib/gmain.c"
86674- line="5224">function to call when the timeout is removed, or %NULL</doc>
87638+ line="5409">function to call when the timeout is removed</doc>
8667587639 <type name="DestroyNotify" c:type="GDestroyNotify"/>
8667687640 </parameter>
8667787641 </parameters>
@@ -86682,32 +87646,31 @@ See [func@GLib.get_monotonic_time].</doc>
8668287646 introspectable="0">
8668387647 <doc xml:space="preserve"
8668487648 filename="glib/gmain.c"
86685- line="5316">Sets a function to be called after @interval milliseconds have elapsed,
87649+ line="5503">Sets a function to be called after @interval milliseconds have elapsed,
8668687650 with the default priority, [const@GLib.PRIORITY_DEFAULT].
8668787651
8668887652 The given @function is called once and then the source will be automatically
8668987653 removed from the main context.
8669087654
8669187655 This function otherwise behaves like [func@GLib.timeout_add].</doc>
86692- <source-position filename="glib/gmain.h" line="935"/>
87656+ <source-position filename="glib/gmain.h" line="938"/>
8669387657 <return-value transfer-ownership="none">
8669487658 <doc xml:space="preserve"
8669587659 filename="glib/gmain.c"
86696- line="5331">the ID (greater than 0) of the event source</doc>
87660+ line="5517">the ID (greater than 0) of the event source</doc>
8669787661 <type name="guint" c:type="guint"/>
8669887662 </return-value>
8669987663 <parameters>
8670087664 <parameter name="interval" transfer-ownership="none">
8670187665 <doc xml:space="preserve"
8670287666 filename="glib/gmain.c"
86703- line="5318">the time after which the function will be called, in
86704- milliseconds (1/1000ths of a second)</doc>
87667+ line="5505">the time after which the function will be called, in milliseconds</doc>
8670587668 <type name="guint" c:type="guint"/>
8670687669 </parameter>
8670787670 <parameter name="function" transfer-ownership="none" closure="2">
8670887671 <doc xml:space="preserve"
8670987672 filename="glib/gmain.c"
86710- line="5320">function to call</doc>
87673+ line="5506">function to call</doc>
8671187674 <type name="SourceOnceFunc" c:type="GSourceOnceFunc"/>
8671287675 </parameter>
8671387676 <parameter name="data"
@@ -86716,7 +87679,7 @@ This function otherwise behaves like [func@GLib.timeout_add].</doc>
8671687679 allow-none="1">
8671787680 <doc xml:space="preserve"
8671887681 filename="glib/gmain.c"
86719- line="5321">data to pass to @function</doc>
87682+ line="5507">data to pass to @function</doc>
8672087683 <type name="gpointer" c:type="gpointer"/>
8672187684 </parameter>
8672287685 </parameters>
@@ -86728,11 +87691,11 @@ This function otherwise behaves like [func@GLib.timeout_add].</doc>
8672887691 introspectable="0">
8672987692 <doc xml:space="preserve"
8673087693 filename="glib/gmain.c"
86731- line="5408">Sets a function to be called at regular intervals with the default
87694+ line="5592">Sets a function to be called at regular intervals with the default
8673287695 priority, [const@GLib.PRIORITY_DEFAULT].
8673387696
86734-The function is called repeatedly until it returns [const@GLib.SOURCE_REMOVE]
86735-or %FALSE, at which point the timeout is automatically destroyed
87697+The function is called repeatedly until it returns [const@GLib.SOURCE_REMOVE],
87698+at which point the timeout is automatically destroyed
8673687699 and the function will not be called again.
8673787700
8673887701 This internally creates a main loop source using
@@ -86746,29 +87709,29 @@ Note that the first call of the timer may not be precise for timeouts
8674687709 of one second. If you need finer precision and have such a timeout,
8674787710 you may want to use [func@GLib.timeout_add] instead.
8674887711
86749-See [mainloop memory management](main-loop.html#memory-management-of-sources) for details
87712+See [main loop memory management](main-loop.html#memory-management-of-sources) for details
8675087713 on how to handle the return value and memory management of @data.
8675187714
8675287715 The interval given is in terms of monotonic time, not wall clock
8675387716 time. See [func@GLib.get_monotonic_time].</doc>
86754- <source-position filename="glib/gmain.h" line="945"/>
87717+ <source-position filename="glib/gmain.h" line="948"/>
8675587718 <return-value transfer-ownership="none">
8675687719 <doc xml:space="preserve"
8675787720 filename="glib/gmain.c"
86758- line="5438">the ID (greater than 0) of the event source.</doc>
87721+ line="5622">the ID (greater than 0) of the event source</doc>
8675987722 <type name="guint" c:type="guint"/>
8676087723 </return-value>
8676187724 <parameters>
8676287725 <parameter name="interval" transfer-ownership="none">
8676387726 <doc xml:space="preserve"
8676487727 filename="glib/gmain.c"
86765- line="5410">the time between calls to the function, in seconds</doc>
87728+ line="5594">the time between calls to the function, in seconds</doc>
8676687729 <type name="guint" c:type="guint"/>
8676787730 </parameter>
8676887731 <parameter name="function" transfer-ownership="none" closure="2">
8676987732 <doc xml:space="preserve"
8677087733 filename="glib/gmain.c"
86771- line="5411">function to call</doc>
87734+ line="5595">function to call</doc>
8677287735 <type name="SourceFunc" c:type="GSourceFunc"/>
8677387736 </parameter>
8677487737 <parameter name="data"
@@ -86777,7 +87740,7 @@ time. See [func@GLib.get_monotonic_time].</doc>
8677787740 allow-none="1">
8677887741 <doc xml:space="preserve"
8677987742 filename="glib/gmain.c"
86780- line="5412">data to pass to @function</doc>
87743+ line="5596">data to pass to @function</doc>
8678187744 <type name="gpointer" c:type="gpointer"/>
8678287745 </parameter>
8678387746 </parameters>
@@ -86788,17 +87751,17 @@ time. See [func@GLib.get_monotonic_time].</doc>
8678887751 version="2.14">
8678987752 <doc xml:space="preserve"
8679087753 filename="glib/gmain.c"
86791- line="5343">Sets a function to be called at regular intervals, with @priority.
87754+ line="5528">Sets a function to be called at regular intervals, with @priority.
8679287755
86793-The function is called repeatedly until it returns [const@GLib.SOURCE_REMOVE]
86794-or %FALSE, at which point the timeout is automatically destroyed and
87756+The function is called repeatedly until it returns [const@GLib.SOURCE_REMOVE],
87757+at which point the timeout is automatically destroyed and
8679587758 the function will not be called again.
8679687759
8679787760 Unlike [func@GLib.timeout_add], this function operates at whole second
8679887761 granularity. The initial starting point of the timer is determined by the
8679987762 implementation and the implementation is expected to group multiple timers
86800-together so that they fire all at the same time. To allow this grouping, the
86801-@interval to the first timer is rounded and can deviate up to one second
87763+together so that they fire all at the same time. To allow this grouping,
87764+the @interval to the first timer is rounded and can deviate up to one second
8680287765 from the specified interval. Subsequent timer iterations will generally run
8680387766 at the specified interval.
8680487767
@@ -86807,7 +87770,7 @@ event sources. Thus they should not be relied on for precise timing.
8680787770 After each call to the timeout function, the time of the next
8680887771 timeout is recalculated based on the current time and the given @interval
8680987772
86810-See [mainloop memory management](main-loop.html#memory-management-of-sources) for details
87773+See [main loop memory management](main-loop.html#memory-management-of-sources) for details
8681187774 on how to handle the return value and memory management of @data.
8681287775
8681387776 If you want timing more precise than whole seconds, use
@@ -86815,7 +87778,7 @@ If you want timing more precise than whole seconds, use
8681587778
8681687779 The grouping of timers to fire at the same time results in a more power
8681787780 and CPU efficient behavior so if your timer is in multiples of seconds
86818-and you don't require the first timer exactly one second from now, the
87781+and you don’t require the first timer exactly one second from now, the
8681987782 use of [func@GLib.timeout_add_seconds] is preferred over
8682087783 [func@GLib.timeout_add].
8682187784
@@ -86828,26 +87791,26 @@ It is safe to call this function from any thread.
8682887791
8682987792 The interval given is in terms of monotonic time, not wall clock
8683087793 time. See [func@GLib.get_monotonic_time].</doc>
86831- <source-position filename="glib/gmain.h" line="939"/>
87794+ <source-position filename="glib/gmain.h" line="942"/>
8683287795 <return-value transfer-ownership="none">
8683387796 <doc xml:space="preserve"
8683487797 filename="glib/gmain.c"
86835- line="5394">the ID (greater than 0) of the event source.</doc>
87798+ line="5579">the ID (greater than 0) of the event source</doc>
8683687799 <type name="guint" c:type="guint"/>
8683787800 </return-value>
8683887801 <parameters>
8683987802 <parameter name="priority" transfer-ownership="none">
8684087803 <doc xml:space="preserve"
8684187804 filename="glib/gmain.c"
86842- line="5345">the priority of the timeout source. Typically this will be in
87805+ line="5530">the priority of the timeout source; typically this will be in
8684387806 the range between [const@GLib.PRIORITY_DEFAULT] and
86844- [const@GLib.PRIORITY_HIGH].</doc>
87807+ [const@GLib.PRIORITY_HIGH]</doc>
8684587808 <type name="gint" c:type="gint"/>
8684687809 </parameter>
8684787810 <parameter name="interval" transfer-ownership="none">
8684887811 <doc xml:space="preserve"
8684987812 filename="glib/gmain.c"
86850- line="5348">the time between calls to the function, in seconds</doc>
87813+ line="5533">the time between calls to the function, in seconds</doc>
8685187814 <type name="guint" c:type="guint"/>
8685287815 </parameter>
8685387816 <parameter name="function"
@@ -86857,7 +87820,7 @@ time. See [func@GLib.get_monotonic_time].</doc>
8685787820 destroy="4">
8685887821 <doc xml:space="preserve"
8685987822 filename="glib/gmain.c"
86860- line="5349">function to call</doc>
87823+ line="5534">function to call</doc>
8686187824 <type name="SourceFunc" c:type="GSourceFunc"/>
8686287825 </parameter>
8686387826 <parameter name="data"
@@ -86866,7 +87829,7 @@ time. See [func@GLib.get_monotonic_time].</doc>
8686687829 allow-none="1">
8686787830 <doc xml:space="preserve"
8686887831 filename="glib/gmain.c"
86869- line="5350">data to pass to @function</doc>
87832+ line="5535">data to pass to @function</doc>
8687087833 <type name="gpointer" c:type="gpointer"/>
8687187834 </parameter>
8687287835 <parameter name="notify"
@@ -86876,7 +87839,7 @@ time. See [func@GLib.get_monotonic_time].</doc>
8687687839 scope="async">
8687787840 <doc xml:space="preserve"
8687887841 filename="glib/gmain.c"
86879- line="5351">function to call when the timeout is removed, or %NULL</doc>
87842+ line="5536">function to call when the timeout is removed</doc>
8688087843 <type name="DestroyNotify" c:type="GDestroyNotify"/>
8688187844 </parameter>
8688287845 </parameters>
@@ -86887,26 +87850,26 @@ time. See [func@GLib.get_monotonic_time].</doc>
8688787850 introspectable="0">
8688887851 <doc xml:space="preserve"
8688987852 filename="glib/gmain.c"
86890- line="5452">This function behaves like [func@GLib.timeout_add_once] but with a range in
87853+ line="5635">This function behaves like [func@GLib.timeout_add_once] but with a range in
8689187854 seconds.</doc>
86892- <source-position filename="glib/gmain.h" line="949"/>
87855+ <source-position filename="glib/gmain.h" line="952"/>
8689387856 <return-value transfer-ownership="none">
8689487857 <doc xml:space="preserve"
8689587858 filename="glib/gmain.c"
86896- line="5461">the ID (greater than 0) of the event source</doc>
87859+ line="5644">the ID (greater than 0) of the event source</doc>
8689787860 <type name="guint" c:type="guint"/>
8689887861 </return-value>
8689987862 <parameters>
8690087863 <parameter name="interval" transfer-ownership="none">
8690187864 <doc xml:space="preserve"
8690287865 filename="glib/gmain.c"
86903- line="5454">the time after which the function will be called, in seconds</doc>
87866+ line="5637">the time after which the function will be called, in seconds</doc>
8690487867 <type name="guint" c:type="guint"/>
8690587868 </parameter>
8690687869 <parameter name="function" transfer-ownership="none" closure="2">
8690787870 <doc xml:space="preserve"
8690887871 filename="glib/gmain.c"
86909- line="5455">function to call</doc>
87872+ line="5638">function to call</doc>
8691087873 <type name="SourceOnceFunc" c:type="GSourceOnceFunc"/>
8691187874 </parameter>
8691287875 <parameter name="data"
@@ -86915,7 +87878,7 @@ seconds.</doc>
8691587878 allow-none="1">
8691687879 <doc xml:space="preserve"
8691787880 filename="glib/gmain.c"
86918- line="5456">data to pass to @function</doc>
87881+ line="5639">data to pass to @function</doc>
8691987882 <type name="gpointer" c:type="gpointer"/>
8692087883 </parameter>
8692187884 </parameters>
@@ -86923,7 +87886,7 @@ seconds.</doc>
8692387886 <function name="timeout_source_new" c:identifier="g_timeout_source_new">
8692487887 <doc xml:space="preserve"
8692587888 filename="glib/gmain.c"
86926- line="5139">Creates a new timeout source.
87889+ line="5326">Creates a new timeout source.
8692787890
8692887891 The source will not initially be associated with any [struct@GLib.MainContext]
8692987892 and must be added to one with [method@GLib.Source.attach] before it will be
@@ -86931,18 +87894,18 @@ executed.
8693187894
8693287895 The interval given is in terms of monotonic time, not wall clock
8693387896 time. See [func@GLib.get_monotonic_time].</doc>
86934- <source-position filename="glib/gmain.h" line="817"/>
87897+ <source-position filename="glib/gmain.h" line="820"/>
8693587898 <return-value transfer-ownership="full">
8693687899 <doc xml:space="preserve"
8693787900 filename="glib/gmain.c"
86938- line="5152">the newly-created timeout source</doc>
87901+ line="5339">the newly-created timeout source</doc>
8693987902 <type name="Source" c:type="GSource*"/>
8694087903 </return-value>
8694187904 <parameters>
8694287905 <parameter name="interval" transfer-ownership="none">
8694387906 <doc xml:space="preserve"
8694487907 filename="glib/gmain.c"
86945- line="5141">the timeout interval in milliseconds.</doc>
87908+ line="5328">the timeout interval in milliseconds</doc>
8694687909 <type name="guint" c:type="guint"/>
8694787910 </parameter>
8694887911 </parameters>
@@ -86952,7 +87915,7 @@ time. See [func@GLib.get_monotonic_time].</doc>
8695287915 version="2.14">
8695387916 <doc xml:space="preserve"
8695487917 filename="glib/gmain.c"
86955- line="5160">Creates a new timeout source.
87918+ line="5347">Creates a new timeout source.
8695687919
8695787920 The source will not initially be associated with any
8695887921 [struct@GLib.MainContext] and must be added to one with
@@ -86963,18 +87926,18 @@ in seconds.
8696387926
8696487927 The interval given is in terms of monotonic time, not wall clock time.
8696587928 See [func@GLib.get_monotonic_time].</doc>
86966- <source-position filename="glib/gmain.h" line="819"/>
87929+ <source-position filename="glib/gmain.h" line="822"/>
8696787930 <return-value transfer-ownership="full">
8696887931 <doc xml:space="preserve"
8696987932 filename="glib/gmain.c"
86970- line="5176">the newly-created timeout source</doc>
87933+ line="5363">the newly-created timeout source</doc>
8697187934 <type name="Source" c:type="GSource*"/>
8697287935 </return-value>
8697387936 <parameters>
8697487937 <parameter name="interval" transfer-ownership="none">
8697587938 <doc xml:space="preserve"
8697687939 filename="glib/gmain.c"
86977- line="5162">the timeout interval in seconds</doc>
87940+ line="5349">the timeout interval in seconds</doc>
8697887941 <type name="guint" c:type="guint"/>
8697987942 </parameter>
8698087943 </parameters>
@@ -87346,14 +88309,14 @@ The function returns %NULL if an overflow occurs.</doc>
8734688309 <function name="ucs4_to_utf16" c:identifier="g_ucs4_to_utf16" throws="1">
8734788310 <doc xml:space="preserve"
8734888311 filename="glib/gutf8.c"
87349- line="1484">Convert a string from UCS-4 to UTF-16.
88312+ line="1486">Convert a string from UCS-4 to UTF-16.
8735088313
8735188314 A nul character (U+0000) will be added to the result after the converted text.</doc>
8735288315 <source-position filename="glib/gunicode.h" line="909"/>
8735388316 <return-value transfer-ownership="full">
8735488317 <doc xml:space="preserve"
8735588318 filename="glib/gutf8.c"
87356- line="1503">a pointer to a newly allocated UTF-16 string.
88319+ line="1505">a pointer to a newly allocated UTF-16 string.
8735788320 This value must be freed with [func@GLib.free].</doc>
8735888321 <type name="guint16" c:type="gunichar2*"/>
8735988322 </return-value>
@@ -87361,7 +88324,7 @@ A nul character (U+0000) will be added to the result after the converted text.</
8736188324 <parameter name="str" transfer-ownership="none">
8736288325 <doc xml:space="preserve"
8736388326 filename="glib/gutf8.c"
87364- line="1486">a UCS-4 encoded string</doc>
88327+ line="1488">a UCS-4 encoded string</doc>
8736588328 <array length="1" zero-terminated="0" c:type="const gunichar*">
8736688329 <type name="gunichar"/>
8736788330 </array>
@@ -87369,7 +88332,7 @@ A nul character (U+0000) will be added to the result after the converted text.</
8736988332 <parameter name="len" transfer-ownership="none">
8737088333 <doc xml:space="preserve"
8737188334 filename="glib/gutf8.c"
87372- line="1487">the maximum length (number of characters) of @str to use.
88335+ line="1489">the maximum length (number of characters) of @str to use.
8737388336 If @len is negative, then the string is nul-terminated.</doc>
8737488337 <type name="glong" c:type="glong"/>
8737588338 </parameter>
@@ -87381,7 +88344,7 @@ A nul character (U+0000) will be added to the result after the converted text.</
8738188344 allow-none="1">
8738288345 <doc xml:space="preserve"
8738388346 filename="glib/gutf8.c"
87384- line="1489">location to store number of
88347+ line="1491">location to store number of
8738588348 bytes read, or `NULL`. If an error occurs then the index of the invalid
8738688349 input is stored here.</doc>
8738788350 <type name="glong" c:type="glong*"/>
@@ -87394,7 +88357,7 @@ A nul character (U+0000) will be added to the result after the converted text.</
8739488357 allow-none="1">
8739588358 <doc xml:space="preserve"
8739688359 filename="glib/gutf8.c"
87397- line="1492">location to store number
88360+ line="1494">location to store number
8739888361 of `gunichar2` written, or `NULL`. The value stored here does not include
8739988362 the trailing nul.</doc>
8740088363 <type name="glong" c:type="glong*"/>
@@ -87404,7 +88367,7 @@ A nul character (U+0000) will be added to the result after the converted text.</
8740488367 <function name="ucs4_to_utf8" c:identifier="g_ucs4_to_utf8" throws="1">
8740588368 <doc xml:space="preserve"
8740688369 filename="glib/gutf8.c"
87407- line="997">Convert a string from a 32-bit fixed width representation as UCS-4.
88370+ line="999">Convert a string from a 32-bit fixed width representation as UCS-4.
8740888371 to UTF-8.
8740988372
8741088373 The result will be terminated with a nul byte.</doc>
@@ -87412,7 +88375,7 @@ The result will be terminated with a nul byte.</doc>
8741288375 <return-value transfer-ownership="full">
8741388376 <doc xml:space="preserve"
8741488377 filename="glib/gutf8.c"
87415- line="1016">a pointer to a newly allocated UTF-8 string.
88378+ line="1018">a pointer to a newly allocated UTF-8 string.
8741688379 This value must be freed with [func@GLib.free]. If an error occurs,
8741788380 @items_read will be set to the position of the first invalid input
8741888381 character.</doc>
@@ -87422,7 +88385,7 @@ The result will be terminated with a nul byte.</doc>
8742288385 <parameter name="str" transfer-ownership="none">
8742388386 <doc xml:space="preserve"
8742488387 filename="glib/gutf8.c"
87425- line="999">a UCS-4 encoded string</doc>
88388+ line="1001">a UCS-4 encoded string</doc>
8742688389 <array length="1" zero-terminated="0" c:type="const gunichar*">
8742788390 <type name="gunichar"/>
8742888391 </array>
@@ -87430,7 +88393,7 @@ The result will be terminated with a nul byte.</doc>
8743088393 <parameter name="len" transfer-ownership="none">
8743188394 <doc xml:space="preserve"
8743288395 filename="glib/gutf8.c"
87433- line="1000">the maximum length (number of characters) of @str to use.
88396+ line="1002">the maximum length (number of characters) of @str to use.
8743488397 If @len is negative, then the string is nul-terminated.</doc>
8743588398 <type name="glong" c:type="glong"/>
8743688399 </parameter>
@@ -87442,7 +88405,7 @@ The result will be terminated with a nul byte.</doc>
8744288405 allow-none="1">
8744388406 <doc xml:space="preserve"
8744488407 filename="glib/gutf8.c"
87445- line="1002">location to store number of
88408+ line="1004">location to store number of
8744688409 characters read, or `NULL`.</doc>
8744788410 <type name="glong" c:type="glong*"/>
8744888411 </parameter>
@@ -87454,7 +88417,7 @@ The result will be terminated with a nul byte.</doc>
8745488417 allow-none="1">
8745588418 <doc xml:space="preserve"
8745688419 filename="glib/gutf8.c"
87457- line="1004">location to store number
88420+ line="1006">location to store number
8745888421 of bytes written or `NULL`. The value here stored does not include the
8745988422 trailing nul byte.</doc>
8746088423 <type name="glong" c:type="glong*"/>
@@ -88304,19 +89267,19 @@ terminals support zero-width rendering of zero-width marks.</doc>
8830489267 <function name="unichar_to_utf8" c:identifier="g_unichar_to_utf8">
8830589268 <doc xml:space="preserve"
8830689269 filename="glib/gutf8.c"
88307- line="534">Converts a single character to UTF-8.</doc>
89270+ line="536">Converts a single character to UTF-8.</doc>
8830889271 <source-position filename="glib/gunicode.h" line="922"/>
8830989272 <return-value transfer-ownership="none">
8831089273 <doc xml:space="preserve"
8831189274 filename="glib/gutf8.c"
88312- line="543">number of bytes written</doc>
89275+ line="545">number of bytes written</doc>
8831389276 <type name="gint" c:type="gint"/>
8831489277 </return-value>
8831589278 <parameters>
8831689279 <parameter name="c" transfer-ownership="none">
8831789280 <doc xml:space="preserve"
8831889281 filename="glib/gutf8.c"
88319- line="536">a Unicode character code</doc>
89282+ line="538">a Unicode character code</doc>
8832089283 <type name="gunichar" c:type="gunichar"/>
8832189284 </parameter>
8832289285 <parameter name="outbuf"
@@ -88327,7 +89290,7 @@ terminals support zero-width rendering of zero-width marks.</doc>
8832789290 allow-none="1">
8832889291 <doc xml:space="preserve"
8832989292 filename="glib/gutf8.c"
88330- line="537">output buffer, must have at
89293+ line="539">output buffer, must have at
8833189294 least 6 bytes of space. If `NULL`, the length will be computed and
8833289295 returned and nothing will be written to @outbuf.</doc>
8833389296 <type name="utf8" c:type="gchar*"/>
@@ -88423,7 +89386,7 @@ terminals support zero-width rendering of zero-width marks.</doc>
8842389386 <function name="unichar_validate" c:identifier="g_unichar_validate">
8842489387 <doc xml:space="preserve"
8842589388 filename="glib/gutf8.c"
88426- line="1911">Checks whether @ch is a valid Unicode character.
89389+ line="2308">Checks whether @ch is a valid Unicode character.
8842789390
8842889391 Some possible integer values of @ch will not be valid. U+0000 is considered a
8842989392 valid character, though it’s normally a string terminator.</doc>
@@ -88431,14 +89394,14 @@ valid character, though it’s normally a string terminator.</doc>
8843189394 <return-value transfer-ownership="none">
8843289395 <doc xml:space="preserve"
8843389396 filename="glib/gutf8.c"
88434- line="1920">`TRUE` if @ch is a valid Unicode character</doc>
89397+ line="2317">`TRUE` if @ch is a valid Unicode character</doc>
8843589398 <type name="gboolean" c:type="gboolean"/>
8843689399 </return-value>
8843789400 <parameters>
8843889401 <parameter name="ch" transfer-ownership="none">
8843989402 <doc xml:space="preserve"
8844089403 filename="glib/gutf8.c"
88441- line="1913">a Unicode character</doc>
89404+ line="2310">a Unicode character</doc>
8844289405 <type name="gunichar" c:type="gunichar"/>
8844389406 </parameter>
8844489407 </parameters>
@@ -89011,7 +89974,7 @@ executed.</doc>
8901189974 <function name="unlink" c:identifier="g_unlink" version="2.6">
8901289975 <doc xml:space="preserve"
8901389976 filename="glib/gstdio.c"
89014- line="1400">A wrapper for the POSIX unlink() function. The unlink() function
89977+ line="1411">A wrapper for the POSIX unlink() function. The unlink() function
8901589978 deletes a name from the filesystem. If this was the last link to the
8901689979 file and no processes have it opened, the diskspace occupied by the
8901789980 file is freed.
@@ -89023,7 +89986,7 @@ are open to some process, or mapped into memory.</doc>
8902389986 <return-value transfer-ownership="none">
8902489987 <doc xml:space="preserve"
8902589988 filename="glib/gstdio.c"
89026- line="1414">0 if the name was successfully deleted, -1 if an error
89989+ line="1425">0 if the name was successfully deleted, -1 if an error
8902789990 occurred</doc>
8902889991 <type name="gint" c:type="int"/>
8902989992 </return-value>
@@ -89031,7 +89994,7 @@ are open to some process, or mapped into memory.</doc>
8903189994 <parameter name="filename" transfer-ownership="none">
8903289995 <doc xml:space="preserve"
8903389996 filename="glib/gstdio.c"
89034- line="1402">a pathname in the GLib file name encoding
89997+ line="1413">a pathname in the GLib file name encoding
8903589998 (UTF-8 on Windows)</doc>
8903689999 <type name="filename" c:type="const gchar*"/>
8903790000 </parameter>
@@ -90383,14 +91346,14 @@ length of the sleep.</doc>
9038391346 <function name="utf16_to_ucs4" c:identifier="g_utf16_to_ucs4" throws="1">
9038491347 <doc xml:space="preserve"
9038591348 filename="glib/gutf8.c"
90386- line="1229">Convert a string from UTF-16 to UCS-4.
91349+ line="1231">Convert a string from UTF-16 to UCS-4.
9038791350
9038891351 The result will be nul-terminated.</doc>
9038991352 <source-position filename="glib/gunicode.h" line="897"/>
9039091353 <return-value transfer-ownership="full">
9039191354 <doc xml:space="preserve"
9039291355 filename="glib/gutf8.c"
90393- line="1249">a pointer to a newly allocated UCS-4 string.
91356+ line="1251">a pointer to a newly allocated UCS-4 string.
9039491357 This value must be freed with [func@GLib.free].</doc>
9039591358 <type name="gunichar" c:type="gunichar*"/>
9039691359 </return-value>
@@ -90398,7 +91361,7 @@ The result will be nul-terminated.</doc>
9039891361 <parameter name="str" transfer-ownership="none">
9039991362 <doc xml:space="preserve"
9040091363 filename="glib/gutf8.c"
90401- line="1231">a UTF-16 encoded string</doc>
91364+ line="1233">a UTF-16 encoded string</doc>
9040291365 <array length="1" zero-terminated="0" c:type="const gunichar2*">
9040391366 <type name="guint16"/>
9040491367 </array>
@@ -90406,7 +91369,7 @@ The result will be nul-terminated.</doc>
9040691369 <parameter name="len" transfer-ownership="none">
9040791370 <doc xml:space="preserve"
9040891371 filename="glib/gutf8.c"
90409- line="1232">the maximum length (number of #gunichar2) of @str to use.
91372+ line="1234">the maximum length (number of #gunichar2) of @str to use.
9041091373 If @len is negative, then the string is nul-terminated.</doc>
9041191374 <type name="glong" c:type="glong"/>
9041291375 </parameter>
@@ -90418,7 +91381,7 @@ The result will be nul-terminated.</doc>
9041891381 allow-none="1">
9041991382 <doc xml:space="preserve"
9042091383 filename="glib/gutf8.c"
90421- line="1234">location to store number of words read, or
91384+ line="1236">location to store number of words read, or
9042291385 `NULL`. If `NULL`, then [error@GLib.ConvertError.PARTIAL_INPUT] will be
9042391386 returned in case @str contains a trailing partial character. If
9042491387 an error occurs then the index of the invalid input is stored here.</doc>
@@ -90432,7 +91395,7 @@ The result will be nul-terminated.</doc>
9043291395 allow-none="1">
9043391396 <doc xml:space="preserve"
9043491397 filename="glib/gutf8.c"
90435- line="1238">location to store number
91398+ line="1240">location to store number
9043691399 of characters written, or `NULL`. The value stored here does not include
9043791400 the trailing nul character.</doc>
9043891401 <type name="glong" c:type="glong*"/>
@@ -90442,7 +91405,7 @@ The result will be nul-terminated.</doc>
9044291405 <function name="utf16_to_utf8" c:identifier="g_utf16_to_utf8" throws="1">
9044391406 <doc xml:space="preserve"
9044491407 filename="glib/gutf8.c"
90445- line="1073">Convert a string from UTF-16 to UTF-8.
91408+ line="1075">Convert a string from UTF-16 to UTF-8.
9044691409
9044791410 The result will be terminated with a nul byte.
9044891411
@@ -90460,7 +91423,7 @@ unpaired surrogates or partial character sequences.</doc>
9046091423 <return-value transfer-ownership="full">
9046191424 <doc xml:space="preserve"
9046291425 filename="glib/gutf8.c"
90463- line="1105">a pointer to a newly allocated UTF-8 string.
91426+ line="1107">a pointer to a newly allocated UTF-8 string.
9046491427 This value must be freed with [func@GLib.free].</doc>
9046591428 <type name="utf8" c:type="gchar*"/>
9046691429 </return-value>
@@ -90468,7 +91431,7 @@ unpaired surrogates or partial character sequences.</doc>
9046891431 <parameter name="str" transfer-ownership="none">
9046991432 <doc xml:space="preserve"
9047091433 filename="glib/gutf8.c"
90471- line="1075">a UTF-16 encoded string</doc>
91434+ line="1077">a UTF-16 encoded string</doc>
9047291435 <array length="1" zero-terminated="0" c:type="const gunichar2*">
9047391436 <type name="guint16"/>
9047491437 </array>
@@ -90476,7 +91439,7 @@ unpaired surrogates or partial character sequences.</doc>
9047691439 <parameter name="len" transfer-ownership="none">
9047791440 <doc xml:space="preserve"
9047891441 filename="glib/gutf8.c"
90479- line="1076">the maximum length (number of #gunichar2) of @str to use.
91442+ line="1078">the maximum length (number of #gunichar2) of @str to use.
9048091443 If @len is negative, then the string is nul-terminated.</doc>
9048191444 <type name="glong" c:type="glong"/>
9048291445 </parameter>
@@ -90488,7 +91451,7 @@ unpaired surrogates or partial character sequences.</doc>
9048891451 allow-none="1">
9048991452 <doc xml:space="preserve"
9049091453 filename="glib/gutf8.c"
90491- line="1078">location to store number of words read, or
91454+ line="1080">location to store number of words read, or
9049291455 `NULL`. If `NULL`, then [error@GLib.ConvertError.PARTIAL_INPUT] will
9049391456 be returned in case @str contains a trailing partial character. If
9049491457 an error occurs then the index of the invalid input is stored here.
@@ -90503,7 +91466,7 @@ unpaired surrogates or partial character sequences.</doc>
9050391466 allow-none="1">
9050491467 <doc xml:space="preserve"
9050591468 filename="glib/gutf8.c"
90506- line="1083">location to store number
91469+ line="1085">location to store number
9050791470 of bytes written, or `NULL`. The value stored here does not include the
9050891471 trailing nul byte. It’s guaranteed to be non-negative.</doc>
9050991472 <type name="glong" c:type="glong*"/>
@@ -90670,7 +91633,7 @@ used only for comparisons.</doc>
9067091633 <function name="utf8_find_next_char" c:identifier="g_utf8_find_next_char">
9067191634 <doc xml:space="preserve"
9067291635 filename="glib/gutf8.c"
90673- line="156">Finds the start of the next UTF-8 character in the string after @p.
91636+ line="158">Finds the start of the next UTF-8 character in the string after @p.
9067491637
9067591638 @p does not have to be at the beginning of a UTF-8 character. No check
9067691639 is made to see if the character found is actually valid other than
@@ -90684,7 +91647,7 @@ is reached.</doc>
9068491647 <return-value transfer-ownership="none" nullable="1">
9068591648 <doc xml:space="preserve"
9068691649 filename="glib/gutf8.c"
90687- line="173">a pointer to the found character or `NULL` if @end is
91650+ line="175">a pointer to the found character or `NULL` if @end is
9068891651 set and is reached</doc>
9068991652 <type name="utf8" c:type="gchar*"/>
9069091653 </return-value>
@@ -90692,7 +91655,7 @@ is reached.</doc>
9069291655 <parameter name="p" transfer-ownership="none">
9069391656 <doc xml:space="preserve"
9069491657 filename="glib/gutf8.c"
90695- line="158">a pointer to a position within a UTF-8 encoded string</doc>
91658+ line="160">a pointer to a position within a UTF-8 encoded string</doc>
9069691659 <type name="utf8" c:type="const gchar*"/>
9069791660 </parameter>
9069891661 <parameter name="end"
@@ -90701,7 +91664,7 @@ is reached.</doc>
9070191664 allow-none="1">
9070291665 <doc xml:space="preserve"
9070391666 filename="glib/gutf8.c"
90704- line="159">a pointer to the byte following the end of the string,
91667+ line="161">a pointer to the byte following the end of the string,
9070591668 or `NULL` to indicate that the string is nul-terminated</doc>
9070691669 <type name="utf8" c:type="const gchar*"/>
9070791670 </parameter>
@@ -90710,7 +91673,7 @@ is reached.</doc>
9071091673 <function name="utf8_find_prev_char" c:identifier="g_utf8_find_prev_char">
9071191674 <doc xml:space="preserve"
9071291675 filename="glib/gutf8.c"
90713- line="128">Given a position @p with a UTF-8 encoded string @str, find the start
91676+ line="130">Given a position @p with a UTF-8 encoded string @str, find the start
9071491677 of the previous UTF-8 character starting before @p. Returns `NULL` if no
9071591678 UTF-8 characters are present in @str before @p.
9071691679
@@ -90721,20 +91684,20 @@ it starts with an appropriate byte.</doc>
9072191684 <return-value transfer-ownership="none" nullable="1">
9072291685 <doc xml:space="preserve"
9072391686 filename="glib/gutf8.c"
90724- line="141">a pointer to the found character</doc>
91687+ line="143">a pointer to the found character</doc>
9072591688 <type name="utf8" c:type="gchar*"/>
9072691689 </return-value>
9072791690 <parameters>
9072891691 <parameter name="str" transfer-ownership="none">
9072991692 <doc xml:space="preserve"
9073091693 filename="glib/gutf8.c"
90731- line="130">pointer to the beginning of a UTF-8 encoded string</doc>
91694+ line="132">pointer to the beginning of a UTF-8 encoded string</doc>
9073291695 <type name="utf8" c:type="const gchar*"/>
9073391696 </parameter>
9073491697 <parameter name="p" transfer-ownership="none">
9073591698 <doc xml:space="preserve"
9073691699 filename="glib/gutf8.c"
90737- line="131">pointer to some position within @str</doc>
91700+ line="133">pointer to some position within @str</doc>
9073891701 <type name="utf8" c:type="const gchar*"/>
9073991702 </parameter>
9074091703 </parameters>
@@ -90742,7 +91705,7 @@ it starts with an appropriate byte.</doc>
9074291705 <function name="utf8_get_char" c:identifier="g_utf8_get_char">
9074391706 <doc xml:space="preserve"
9074491707 filename="glib/gutf8.c"
90745- line="319">Converts a sequence of bytes encoded as UTF-8 to a Unicode character.
91708+ line="321">Converts a sequence of bytes encoded as UTF-8 to a Unicode character.
9074691709
9074791710 If @p does not point to a valid UTF-8 encoded character, results
9074891711 are undefined. If you are not sure that the bytes are complete
@@ -90752,14 +91715,14 @@ instead.</doc>
9075291715 <return-value transfer-ownership="none">
9075391716 <doc xml:space="preserve"
9075491717 filename="glib/gutf8.c"
90755- line="330">the resulting character</doc>
91718+ line="332">the resulting character</doc>
9075691719 <type name="gunichar" c:type="gunichar"/>
9075791720 </return-value>
9075891721 <parameters>
9075991722 <parameter name="p" transfer-ownership="none">
9076091723 <doc xml:space="preserve"
9076191724 filename="glib/gutf8.c"
90762- line="321">a pointer to Unicode character encoded as UTF-8</doc>
91725+ line="323">a pointer to Unicode character encoded as UTF-8</doc>
9076391726 <type name="utf8" c:type="const gchar*"/>
9076491727 </parameter>
9076591728 </parameters>
@@ -90768,7 +91731,7 @@ instead.</doc>
9076891731 c:identifier="g_utf8_get_char_validated">
9076991732 <doc xml:space="preserve"
9077091733 filename="glib/gutf8.c"
90771- line="746">Convert a sequence of bytes encoded as UTF-8 to a Unicode character.
91734+ line="748">Convert a sequence of bytes encoded as UTF-8 to a Unicode character.
9077291735
9077391736 This function checks for incomplete characters, for invalid characters
9077491737 such as characters that are out of the range of Unicode, and for
@@ -90781,7 +91744,7 @@ sequence are nul.</doc>
9078191744 <return-value transfer-ownership="none">
9078291745 <doc xml:space="preserve"
9078391746 filename="glib/gutf8.c"
90784- line="761">the resulting character. If @p points to a partial
91747+ line="763">the resulting character. If @p points to a partial
9078591748 sequence at the end of a string that could begin a valid
9078691749 character (or if @max_len is zero), returns `(gunichar)-2`;
9078791750 otherwise, if @p does not point to a valid UTF-8 encoded
@@ -90792,13 +91755,13 @@ sequence are nul.</doc>
9079291755 <parameter name="p" transfer-ownership="none">
9079391756 <doc xml:space="preserve"
9079491757 filename="glib/gutf8.c"
90795- line="748">a pointer to Unicode character encoded as UTF-8</doc>
91758+ line="750">a pointer to Unicode character encoded as UTF-8</doc>
9079691759 <type name="utf8" c:type="const gchar*"/>
9079791760 </parameter>
9079891761 <parameter name="max_len" transfer-ownership="none">
9079991762 <doc xml:space="preserve"
9080091763 filename="glib/gutf8.c"
90801- line="749">the maximum number of bytes to read, or `-1` if @p is nul-terminated</doc>
91764+ line="751">the maximum number of bytes to read, or `-1` if @p is nul-terminated</doc>
9080291765 <type name="gssize" c:type="gssize"/>
9080391766 </parameter>
9080491767 </parameters>
@@ -90808,7 +91771,7 @@ sequence are nul.</doc>
9080891771 version="2.52">
9080991772 <doc xml:space="preserve"
9081091773 filename="glib/gutf8.c"
90811- line="1979">If the provided string is valid UTF-8, return a copy of it. If not,
91774+ line="2376">If the provided string is valid UTF-8, return a copy of it. If not,
9081291775 return a copy in which bytes that could not be interpreted as valid Unicode
9081391776 are replaced with the Unicode replacement character (U+FFFD).
9081491777
@@ -90821,20 +91784,20 @@ readable as-is.</doc>
9082191784 <return-value transfer-ownership="full">
9082291785 <doc xml:space="preserve"
9082391786 filename="glib/gutf8.c"
90824- line="1995">a valid UTF-8 string whose content resembles @str</doc>
91787+ line="2392">a valid UTF-8 string whose content resembles @str</doc>
9082591788 <type name="utf8" c:type="gchar*"/>
9082691789 </return-value>
9082791790 <parameters>
9082891791 <parameter name="str" transfer-ownership="none">
9082991792 <doc xml:space="preserve"
9083091793 filename="glib/gutf8.c"
90831- line="1981">string to coerce into UTF-8</doc>
91794+ line="2378">string to coerce into UTF-8</doc>
9083291795 <type name="utf8" c:type="const gchar*"/>
9083391796 </parameter>
9083491797 <parameter name="len" transfer-ownership="none">
9083591798 <doc xml:space="preserve"
9083691799 filename="glib/gutf8.c"
90837- line="1982">the maximum length of @str to use, in bytes. If @len is negative,
91800+ line="2379">the maximum length of @str to use, in bytes. If @len is negative,
9083891801 then the string is nul-terminated.</doc>
9083991802 <type name="gssize" c:type="gssize"/>
9084091803 </parameter>
@@ -90927,7 +91890,7 @@ less capable Unicode handling.</doc>
9092791890 c:identifier="g_utf8_offset_to_pointer">
9092891891 <doc xml:space="preserve"
9092991892 filename="glib/gutf8.c"
90930- line="347">Converts from an integer character offset to a pointer to a position
91893+ line="349">Converts from an integer character offset to a pointer to a position
9093191894 within the string.
9093291895
9093391896 Since 2.10, this function allows to pass a negative @offset to
@@ -90944,20 +91907,20 @@ text rendering and therefore has to be as fast as possible.</doc>
9094491907 <return-value transfer-ownership="none">
9094591908 <doc xml:space="preserve"
9094691909 filename="glib/gutf8.c"
90947- line="366">the resulting pointer</doc>
91910+ line="368">the resulting pointer</doc>
9094891911 <type name="utf8" c:type="gchar*"/>
9094991912 </return-value>
9095091913 <parameters>
9095191914 <parameter name="str" transfer-ownership="none">
9095291915 <doc xml:space="preserve"
9095391916 filename="glib/gutf8.c"
90954- line="349">a UTF-8 encoded string</doc>
91917+ line="351">a UTF-8 encoded string</doc>
9095591918 <type name="utf8" c:type="const gchar*"/>
9095691919 </parameter>
9095791920 <parameter name="offset" transfer-ownership="none">
9095891921 <doc xml:space="preserve"
9095991922 filename="glib/gutf8.c"
90960- line="350">a character offset within @str</doc>
91923+ line="352">a character offset within @str</doc>
9096191924 <type name="glong" c:type="glong"/>
9096291925 </parameter>
9096391926 </parameters>
@@ -90966,7 +91929,7 @@ text rendering and therefore has to be as fast as possible.</doc>
9096691929 c:identifier="g_utf8_pointer_to_offset">
9096791930 <doc xml:space="preserve"
9096891931 filename="glib/gutf8.c"
90969- line="399">Converts from a pointer to position within a string to an integer
91932+ line="401">Converts from a pointer to position within a string to an integer
9097091933 character offset.
9097191934
9097291935 Since 2.10, this function allows @pos to be before @str, and returns
@@ -90975,20 +91938,20 @@ a negative offset in this case.</doc>
9097591938 <return-value transfer-ownership="none">
9097691939 <doc xml:space="preserve"
9097791940 filename="glib/gutf8.c"
90978- line="410">the resulting character offset</doc>
91941+ line="412">the resulting character offset</doc>
9097991942 <type name="glong" c:type="glong"/>
9098091943 </return-value>
9098191944 <parameters>
9098291945 <parameter name="str" transfer-ownership="none">
9098391946 <doc xml:space="preserve"
9098491947 filename="glib/gutf8.c"
90985- line="401">a UTF-8 encoded string</doc>
91948+ line="403">a UTF-8 encoded string</doc>
9098691949 <type name="utf8" c:type="const gchar*"/>
9098791950 </parameter>
9098891951 <parameter name="pos" transfer-ownership="none">
9098991952 <doc xml:space="preserve"
9099091953 filename="glib/gutf8.c"
90991- line="402">a pointer to a position within @str</doc>
91954+ line="404">a pointer to a position within @str</doc>
9099291955 <type name="utf8" c:type="const gchar*"/>
9099391956 </parameter>
9099491957 </parameters>
@@ -90996,7 +91959,7 @@ a negative offset in this case.</doc>
9099691959 <function name="utf8_prev_char" c:identifier="g_utf8_prev_char">
9099791960 <doc xml:space="preserve"
9099891961 filename="glib/gutf8.c"
90999- line="194">Finds the previous UTF-8 character in the string before @p.
91962+ line="196">Finds the previous UTF-8 character in the string before @p.
9100091963
9100191964 @p does not have to be at the beginning of a UTF-8 character. No check
9100291965 is made to see if the character found is actually valid other than
@@ -91007,14 +91970,14 @@ instead.</doc>
9100791970 <return-value transfer-ownership="none">
9100891971 <doc xml:space="preserve"
9100991972 filename="glib/gutf8.c"
91010- line="206">a pointer to the found character</doc>
91973+ line="208">a pointer to the found character</doc>
9101191974 <type name="utf8" c:type="gchar*"/>
9101291975 </return-value>
9101391976 <parameters>
9101491977 <parameter name="p" transfer-ownership="none">
9101591978 <doc xml:space="preserve"
9101691979 filename="glib/gutf8.c"
91017- line="196">a pointer to a position within a UTF-8 encoded string</doc>
91980+ line="198">a pointer to a position within a UTF-8 encoded string</doc>
9101891981 <type name="utf8" c:type="const gchar*"/>
9101991982 </parameter>
9102091983 </parameters>
@@ -91022,7 +91985,7 @@ instead.</doc>
9102291985 <function name="utf8_strchr" c:identifier="g_utf8_strchr">
9102391986 <doc xml:space="preserve"
9102491987 filename="glib/gutf8.c"
91025- line="598">Finds the leftmost occurrence of the given Unicode character
91988+ line="600">Finds the leftmost occurrence of the given Unicode character
9102691989 in a UTF-8 encoded string, while limiting the search to @len bytes.
9102791990
9102891991 If @len is `-1`, allow unbounded search.</doc>
@@ -91030,7 +91993,7 @@ If @len is `-1`, allow unbounded search.</doc>
9103091993 <return-value transfer-ownership="none" nullable="1">
9103191994 <doc xml:space="preserve"
9103291995 filename="glib/gutf8.c"
91033- line="609">`NULL` if the string does not contain
91996+ line="611">`NULL` if the string does not contain
9103491997 the character, otherwise, a pointer to the start of the leftmost occurrence
9103591998 of the character in the string.</doc>
9103691999 <type name="utf8" c:type="gchar*"/>
@@ -91039,19 +92002,19 @@ If @len is `-1`, allow unbounded search.</doc>
9103992002 <parameter name="p" transfer-ownership="none">
9104092003 <doc xml:space="preserve"
9104192004 filename="glib/gutf8.c"
91042- line="600">a nul-terminated UTF-8 encoded string</doc>
92005+ line="602">a nul-terminated UTF-8 encoded string</doc>
9104392006 <type name="utf8" c:type="const gchar*"/>
9104492007 </parameter>
9104592008 <parameter name="len" transfer-ownership="none">
9104692009 <doc xml:space="preserve"
9104792010 filename="glib/gutf8.c"
91048- line="601">the maximum length of @p</doc>
92011+ line="603">the maximum length of @p</doc>
9104992012 <type name="gssize" c:type="gssize"/>
9105092013 </parameter>
9105192014 <parameter name="c" transfer-ownership="none">
9105292015 <doc xml:space="preserve"
9105392016 filename="glib/gutf8.c"
91054- line="602">a Unicode character</doc>
92017+ line="604">a Unicode character</doc>
9105592018 <type name="gunichar" c:type="gunichar"/>
9105692019 </parameter>
9105792020 </parameters>
@@ -91089,27 +92052,27 @@ characters in the string changing.</doc>
9108992052 <function name="utf8_strlen" c:identifier="g_utf8_strlen">
9109092053 <doc xml:space="preserve"
9109192054 filename="glib/gutf8.c"
91092- line="219">Computes the length of the string in characters, not including
92055+ line="221">Computes the length of the string in characters, not including
9109392056 the terminating nul character. If the @max’th byte falls in the
9109492057 middle of a character, the last (partial) character is not counted.</doc>
9109592058 <source-position filename="glib/gunicode.h" line="849"/>
9109692059 <return-value transfer-ownership="none">
9109792060 <doc xml:space="preserve"
9109892061 filename="glib/gutf8.c"
91099- line="232">the length of the string in characters</doc>
92062+ line="234">the length of the string in characters</doc>
9110092063 <type name="glong" c:type="glong"/>
9110192064 </return-value>
9110292065 <parameters>
9110392066 <parameter name="p" transfer-ownership="none">
9110492067 <doc xml:space="preserve"
9110592068 filename="glib/gutf8.c"
91106- line="221">pointer to the start of a UTF-8 encoded string</doc>
92069+ line="223">pointer to the start of a UTF-8 encoded string</doc>
9110792070 <type name="utf8" c:type="const gchar*"/>
9110892071 </parameter>
9110992072 <parameter name="max" transfer-ownership="none">
9111092073 <doc xml:space="preserve"
9111192074 filename="glib/gutf8.c"
91112- line="222">the maximum number of bytes to examine. If @max
92075+ line="224">the maximum number of bytes to examine. If @max
9111392076 is less than 0, then the string is assumed to be
9111492077 nul-terminated. If @max is 0, @p will not be examined and
9111592078 may be `NULL`. If @max is greater than 0, up to @max
@@ -91121,7 +92084,7 @@ middle of a character, the last (partial) character is not counted.</doc>
9112192084 <function name="utf8_strncpy" c:identifier="g_utf8_strncpy">
9112292085 <doc xml:space="preserve"
9112392086 filename="glib/gutf8.c"
91124- line="432">Like the standard C [`strncpy()`](man:strncpy) function, but copies a given
92087+ line="434">Like the standard C [`strncpy()`](man:strncpy) function, but copies a given
9112592088 number of characters instead of a given number of bytes.
9112692089
9112792090 The @src string must be valid UTF-8 encoded text. (Use
@@ -91134,26 +92097,26 @@ largest possible UTF-8 characters</doc>
9113492097 <return-value transfer-ownership="none">
9113592098 <doc xml:space="preserve"
9113692099 filename="glib/gutf8.c"
91137- line="448">@dest</doc>
92100+ line="450">@dest</doc>
9113892101 <type name="utf8" c:type="gchar*"/>
9113992102 </return-value>
9114092103 <parameters>
9114192104 <parameter name="dest" transfer-ownership="none">
9114292105 <doc xml:space="preserve"
9114392106 filename="glib/gutf8.c"
91144- line="434">buffer to fill with characters from @src</doc>
92107+ line="436">buffer to fill with characters from @src</doc>
9114592108 <type name="utf8" c:type="gchar*"/>
9114692109 </parameter>
9114792110 <parameter name="src" transfer-ownership="none">
9114892111 <doc xml:space="preserve"
9114992112 filename="glib/gutf8.c"
91150- line="435">UTF-8 encoded string</doc>
92113+ line="437">UTF-8 encoded string</doc>
9115192114 <type name="utf8" c:type="const gchar*"/>
9115292115 </parameter>
9115392116 <parameter name="n" transfer-ownership="none">
9115492117 <doc xml:space="preserve"
9115592118 filename="glib/gutf8.c"
91156- line="436">character count</doc>
92119+ line="438">character count</doc>
9115792120 <type name="gsize" c:type="gsize"/>
9115892121 </parameter>
9115992122 </parameters>
@@ -91161,7 +92124,7 @@ largest possible UTF-8 characters</doc>
9116192124 <function name="utf8_strrchr" c:identifier="g_utf8_strrchr">
9116292125 <doc xml:space="preserve"
9116392126 filename="glib/gutf8.c"
91164- line="627">Find the rightmost occurrence of the given Unicode character
92127+ line="629">Find the rightmost occurrence of the given Unicode character
9116592128 in a UTF-8 encoded string, while limiting the search to @len bytes.
9116692129
9116792130 If @len is `-1`, allow unbounded search.</doc>
@@ -91169,7 +92132,7 @@ If @len is `-1`, allow unbounded search.</doc>
9116992132 <return-value transfer-ownership="none" nullable="1">
9117092133 <doc xml:space="preserve"
9117192134 filename="glib/gutf8.c"
91172- line="638">`NULL` if the string does not contain
92135+ line="640">`NULL` if the string does not contain
9117392136 the character, otherwise, a pointer to the start of the rightmost
9117492137 occurrence of the character in the string.</doc>
9117592138 <type name="utf8" c:type="gchar*"/>
@@ -91178,19 +92141,19 @@ If @len is `-1`, allow unbounded search.</doc>
9117892141 <parameter name="p" transfer-ownership="none">
9117992142 <doc xml:space="preserve"
9118092143 filename="glib/gutf8.c"
91181- line="629">a nul-terminated UTF-8 encoded string</doc>
92144+ line="631">a nul-terminated UTF-8 encoded string</doc>
9118292145 <type name="utf8" c:type="const gchar*"/>
9118392146 </parameter>
9118492147 <parameter name="len" transfer-ownership="none">
9118592148 <doc xml:space="preserve"
9118692149 filename="glib/gutf8.c"
91187- line="630">the maximum length of @p</doc>
92150+ line="632">the maximum length of @p</doc>
9118892151 <type name="gssize" c:type="gssize"/>
9118992152 </parameter>
9119092153 <parameter name="c" transfer-ownership="none">
9119192154 <doc xml:space="preserve"
9119292155 filename="glib/gutf8.c"
91193- line="631">a Unicode character</doc>
92156+ line="633">a Unicode character</doc>
9119492157 <type name="gunichar" c:type="gunichar"/>
9119592158 </parameter>
9119692159 </parameters>
@@ -91200,7 +92163,7 @@ If @len is `-1`, allow unbounded search.</doc>
9120092163 version="2.2">
9120192164 <doc xml:space="preserve"
9120292165 filename="glib/gutf8.c"
91203- line="1928">Reverses a UTF-8 string.
92166+ line="2325">Reverses a UTF-8 string.
9120492167
9120592168 @str must be valid UTF-8 encoded text. (Use [func@GLib.utf8_validate] on all
9120692169 text before trying to use UTF-8 utility functions with it.)
@@ -91218,20 +92181,20 @@ no longer needed.</doc>
9121892181 <return-value transfer-ownership="full">
9121992182 <doc xml:space="preserve"
9122092183 filename="glib/gutf8.c"
91221- line="1949">a newly-allocated string which is the reverse of @str</doc>
92184+ line="2346">a newly-allocated string which is the reverse of @str</doc>
9122292185 <type name="utf8" c:type="gchar*"/>
9122392186 </return-value>
9122492187 <parameters>
9122592188 <parameter name="str" transfer-ownership="none">
9122692189 <doc xml:space="preserve"
9122792190 filename="glib/gutf8.c"
91228- line="1930">a UTF-8 encoded string</doc>
92191+ line="2327">a UTF-8 encoded string</doc>
9122992192 <type name="utf8" c:type="const gchar*"/>
9123092193 </parameter>
9123192194 <parameter name="len" transfer-ownership="none">
9123292195 <doc xml:space="preserve"
9123392196 filename="glib/gutf8.c"
91234- line="1931">the maximum length of @str to use, in bytes. If @len is negative,
92197+ line="2328">the maximum length of @str to use, in bytes. If @len is negative,
9123592198 then the string is nul-terminated.</doc>
9123692199 <type name="gssize" c:type="gssize"/>
9123792200 </parameter>
@@ -91273,7 +92236,7 @@ German ess-zet will be changed to SS.)</doc>
9127392236 version="2.30">
9127492237 <doc xml:space="preserve"
9127592238 filename="glib/gutf8.c"
91276- line="273">Copies a substring out of a UTF-8 encoded string.
92239+ line="275">Copies a substring out of a UTF-8 encoded string.
9127792240 The substring will contain @end_pos - @start_pos characters.
9127892241
9127992242 Since GLib 2.72, `-1` can be passed to @end_pos to indicate the
@@ -91282,7 +92245,7 @@ end of the string.</doc>
9128292245 <return-value transfer-ownership="full">
9128392246 <doc xml:space="preserve"
9128492247 filename="glib/gutf8.c"
91285- line="286">a newly allocated copy of the requested
92248+ line="288">a newly allocated copy of the requested
9128692249 substring. Free with [func@GLib.free] when no longer needed.</doc>
9128792250 <type name="utf8" c:type="gchar*"/>
9128892251 </return-value>
@@ -91290,19 +92253,19 @@ end of the string.</doc>
9129092253 <parameter name="str" transfer-ownership="none">
9129192254 <doc xml:space="preserve"
9129292255 filename="glib/gutf8.c"
91293- line="275">a UTF-8 encoded string</doc>
92256+ line="277">a UTF-8 encoded string</doc>
9129492257 <type name="utf8" c:type="const gchar*"/>
9129592258 </parameter>
9129692259 <parameter name="start_pos" transfer-ownership="none">
9129792260 <doc xml:space="preserve"
9129892261 filename="glib/gutf8.c"
91299- line="276">a character offset within @str</doc>
92262+ line="278">a character offset within @str</doc>
9130092263 <type name="glong" c:type="glong"/>
9130192264 </parameter>
9130292265 <parameter name="end_pos" transfer-ownership="none">
9130392266 <doc xml:space="preserve"
9130492267 filename="glib/gutf8.c"
91305- line="277">another character offset within @str,
92268+ line="279">another character offset within @str,
9130692269 or `-1` to indicate the end of the string</doc>
9130792270 <type name="glong" c:type="glong"/>
9130892271 </parameter>
@@ -91311,7 +92274,7 @@ end of the string.</doc>
9131192274 <function name="utf8_to_ucs4" c:identifier="g_utf8_to_ucs4" throws="1">
9131292275 <doc xml:space="preserve"
9131392276 filename="glib/gutf8.c"
91314- line="911">Convert a string from UTF-8 to a 32-bit fixed width representation as UCS-4.
92277+ line="913">Convert a string from UTF-8 to a 32-bit fixed width representation as UCS-4.
9131592278
9131692279 A trailing nul character (U+0000) will be added to the string after the
9131792280 converted text.</doc>
@@ -91319,7 +92282,7 @@ converted text.</doc>
9131992282 <return-value transfer-ownership="full">
9132092283 <doc xml:space="preserve"
9132192284 filename="glib/gutf8.c"
91322- line="934">a pointer to a newly allocated UCS-4 string.
92285+ line="936">a pointer to a newly allocated UCS-4 string.
9132392286 This value must be freed with [func@GLib.free].</doc>
9132492287 <type name="gunichar" c:type="gunichar*"/>
9132592288 </return-value>
@@ -91327,13 +92290,13 @@ converted text.</doc>
9132792290 <parameter name="str" transfer-ownership="none">
9132892291 <doc xml:space="preserve"
9132992292 filename="glib/gutf8.c"
91330- line="913">a UTF-8 encoded string</doc>
92293+ line="915">a UTF-8 encoded string</doc>
9133192294 <type name="utf8" c:type="const gchar*"/>
9133292295 </parameter>
9133392296 <parameter name="len" transfer-ownership="none">
9133492297 <doc xml:space="preserve"
9133592298 filename="glib/gutf8.c"
91336- line="914">the maximum length of @str to use, in bytes. If @len is negative,
92299+ line="916">the maximum length of @str to use, in bytes. If @len is negative,
9133792300 then the string is nul-terminated.</doc>
9133892301 <type name="glong" c:type="glong"/>
9133992302 </parameter>
@@ -91345,7 +92308,7 @@ converted text.</doc>
9134592308 allow-none="1">
9134692309 <doc xml:space="preserve"
9134792310 filename="glib/gutf8.c"
91348- line="916">location to store number of
92311+ line="918">location to store number of
9134992312 bytes read, or `NULL`.
9135092313 If `NULL`, then %G_CONVERT_ERROR_PARTIAL_INPUT will be
9135192314 returned in case @str contains a trailing partial
@@ -91361,7 +92324,7 @@ converted text.</doc>
9136192324 allow-none="1">
9136292325 <doc xml:space="preserve"
9136392326 filename="glib/gutf8.c"
91364- line="922">location to store number
92327+ line="924">location to store number
9136592328 of characters written or `NULL`. The value here stored does not include
9136692329 the trailing nul character.</doc>
9136792330 <type name="glong" c:type="glong*"/>
@@ -91371,7 +92334,7 @@ converted text.</doc>
9137192334 <function name="utf8_to_ucs4_fast" c:identifier="g_utf8_to_ucs4_fast">
9137292335 <doc xml:space="preserve"
9137392336 filename="glib/gutf8.c"
91374- line="793">Convert a string from UTF-8 to a 32-bit fixed width
92337+ line="795">Convert a string from UTF-8 to a 32-bit fixed width
9137592338 representation as UCS-4, assuming valid UTF-8 input.
9137692339
9137792340 This function is roughly twice as fast as [func@GLib.utf8_to_ucs4]
@@ -91381,7 +92344,7 @@ will be added to the string after the converted text.</doc>
9138192344 <return-value transfer-ownership="full">
9138292345 <doc xml:space="preserve"
9138392346 filename="glib/gutf8.c"
91384- line="808">a pointer to a newly allocated UCS-4 string.
92347+ line="810">a pointer to a newly allocated UCS-4 string.
9138592348 This value must be freed with [func@GLib.free].</doc>
9138692349 <type name="gunichar" c:type="gunichar*"/>
9138792350 </return-value>
@@ -91389,13 +92352,13 @@ will be added to the string after the converted text.</doc>
9138992352 <parameter name="str" transfer-ownership="none">
9139092353 <doc xml:space="preserve"
9139192354 filename="glib/gutf8.c"
91392- line="795">a UTF-8 encoded string</doc>
92355+ line="797">a UTF-8 encoded string</doc>
9139392356 <type name="utf8" c:type="const gchar*"/>
9139492357 </parameter>
9139592358 <parameter name="len" transfer-ownership="none">
9139692359 <doc xml:space="preserve"
9139792360 filename="glib/gutf8.c"
91398- line="796">the maximum length of @str to use, in bytes. If @len is negative,
92361+ line="798">the maximum length of @str to use, in bytes. If @len is negative,
9139992362 then the string is nul-terminated.</doc>
9140092363 <type name="glong" c:type="glong"/>
9140192364 </parameter>
@@ -91407,7 +92370,7 @@ will be added to the string after the converted text.</doc>
9140792370 allow-none="1">
9140892371 <doc xml:space="preserve"
9140992372 filename="glib/gutf8.c"
91410- line="798">location to store the
92373+ line="800">location to store the
9141192374 number of characters in the result, or `NULL`.</doc>
9141292375 <type name="glong" c:type="glong*"/>
9141392376 </parameter>
@@ -91416,14 +92379,14 @@ will be added to the string after the converted text.</doc>
9141692379 <function name="utf8_to_utf16" c:identifier="g_utf8_to_utf16" throws="1">
9141792380 <doc xml:space="preserve"
9141892381 filename="glib/gutf8.c"
91419- line="1367">Convert a string from UTF-8 to UTF-16.
92382+ line="1369">Convert a string from UTF-8 to UTF-16.
9142092383
9142192384 A nul character (U+0000) will be added to the result after the converted text.</doc>
9142292385 <source-position filename="glib/gunicode.h" line="881"/>
9142392386 <return-value transfer-ownership="full">
9142492387 <doc xml:space="preserve"
9142592388 filename="glib/gutf8.c"
91426- line="1387">a pointer to a newly allocated UTF-16 string.
92389+ line="1389">a pointer to a newly allocated UTF-16 string.
9142792390 This value must be freed with [func@GLib.free].</doc>
9142892391 <type name="guint16" c:type="gunichar2*"/>
9142992392 </return-value>
@@ -91431,13 +92394,13 @@ A nul character (U+0000) will be added to the result after the converted text.</
9143192394 <parameter name="str" transfer-ownership="none">
9143292395 <doc xml:space="preserve"
9143392396 filename="glib/gutf8.c"
91434- line="1369">a UTF-8 encoded string</doc>
92397+ line="1371">a UTF-8 encoded string</doc>
9143592398 <type name="utf8" c:type="const gchar*"/>
9143692399 </parameter>
9143792400 <parameter name="len" transfer-ownership="none">
9143892401 <doc xml:space="preserve"
9143992402 filename="glib/gutf8.c"
91440- line="1370">the maximum length (number of bytes) of @str to use.
92403+ line="1372">the maximum length (number of bytes) of @str to use.
9144192404 If @len is negative, then the string is nul-terminated.</doc>
9144292405 <type name="glong" c:type="glong"/>
9144392406 </parameter>
@@ -91449,7 +92412,7 @@ A nul character (U+0000) will be added to the result after the converted text.</
9144992412 allow-none="1">
9145092413 <doc xml:space="preserve"
9145192414 filename="glib/gutf8.c"
91452- line="1372">location to store number of bytes read, or
92415+ line="1374">location to store number of bytes read, or
9145392416 `NULL`. If `NULL`, then [error@GLib.ConvertError.PARTIAL_INPUT] will
9145492417 be returned in case @str contains a trailing partial character. If
9145592418 an error occurs then the index of the invalid input is stored here.</doc>
@@ -91463,7 +92426,7 @@ A nul character (U+0000) will be added to the result after the converted text.</
9146392426 allow-none="1">
9146492427 <doc xml:space="preserve"
9146592428 filename="glib/gutf8.c"
91466- line="1376">location to store number
92429+ line="1378">location to store number
9146792430 of `gunichar2` written, or `NULL`. The value stored here does not include
9146892431 the trailing nul.</doc>
9146992432 <type name="glong" c:type="glong*"/>
@@ -91475,7 +92438,7 @@ A nul character (U+0000) will be added to the result after the converted text.</
9147592438 version="2.78">
9147692439 <doc xml:space="preserve"
9147792440 filename="glib/gutf8.c"
91478- line="466">Cuts off the middle of the string, preserving half of @truncate_length
92441+ line="468">Cuts off the middle of the string, preserving half of @truncate_length
9147992442 characters at the beginning and half at the end.
9148092443
9148192444 If @string is already short enough, this returns a copy of @string.
@@ -91484,20 +92447,20 @@ If @truncate_length is `0`, an empty string is returned.</doc>
9148492447 <return-value transfer-ownership="full">
9148592448 <doc xml:space="preserve"
9148692449 filename="glib/gutf8.c"
91487- line="477">a newly-allocated copy of @string ellipsized in the middle</doc>
92450+ line="479">a newly-allocated copy of @string ellipsized in the middle</doc>
9148892451 <type name="utf8" c:type="gchar*"/>
9148992452 </return-value>
9149092453 <parameters>
9149192454 <parameter name="string" transfer-ownership="none">
9149292455 <doc xml:space="preserve"
9149392456 filename="glib/gutf8.c"
91494- line="468">a nul-terminated UTF-8 encoded string</doc>
92457+ line="470">a nul-terminated UTF-8 encoded string</doc>
9149592458 <type name="utf8" c:type="const gchar*"/>
9149692459 </parameter>
9149792460 <parameter name="truncate_length" transfer-ownership="none">
9149892461 <doc xml:space="preserve"
9149992462 filename="glib/gutf8.c"
91500- line="469">the new size of @string, in characters, including the ellipsis character</doc>
92463+ line="471">the new size of @string, in characters, including the ellipsis character</doc>
9150192464 <type name="gsize" c:type="gsize"/>
9150292465 </parameter>
9150392466 </parameters>
@@ -91505,7 +92468,7 @@ If @truncate_length is `0`, an empty string is returned.</doc>
9150592468 <function name="utf8_validate" c:identifier="g_utf8_validate">
9150692469 <doc xml:space="preserve"
9150792470 filename="glib/gutf8.c"
91508- line="1828">Validates UTF-8 encoded text.
92471+ line="2225">Validates UTF-8 encoded text.
9150992472
9151092473 @str is the text to validate; if @str is nul-terminated, then @max_len can be
9151192474 `-1`, otherwise @max_len should be the number of bytes to validate.
@@ -91526,14 +92489,14 @@ doing anything else with it.</doc>
9152692489 <return-value transfer-ownership="none">
9152792490 <doc xml:space="preserve"
9152892491 filename="glib/gutf8.c"
91529- line="1852">`TRUE` if the text was valid UTF-8</doc>
92492+ line="2249">`TRUE` if the text was valid UTF-8</doc>
9153092493 <type name="gboolean" c:type="gboolean"/>
9153192494 </return-value>
9153292495 <parameters>
9153392496 <parameter name="str" transfer-ownership="none">
9153492497 <doc xml:space="preserve"
9153592498 filename="glib/gutf8.c"
91536- line="1830">a pointer to character data</doc>
92499+ line="2227">a pointer to character data</doc>
9153792500 <array length="1" zero-terminated="0" c:type="const gchar*">
9153892501 <type name="guint8"/>
9153992502 </array>
@@ -91541,7 +92504,7 @@ doing anything else with it.</doc>
9154192504 <parameter name="max_len" transfer-ownership="none">
9154292505 <doc xml:space="preserve"
9154392506 filename="glib/gutf8.c"
91544- line="1831">max bytes to validate, or `-1` to go until nul</doc>
92507+ line="2228">max bytes to validate, or `-1` to go until nul</doc>
9154592508 <type name="gssize" c:type="gssize"/>
9154692509 </parameter>
9154792510 <parameter name="end"
@@ -91552,8 +92515,10 @@ doing anything else with it.</doc>
9155292515 allow-none="1">
9155392516 <doc xml:space="preserve"
9155492517 filename="glib/gutf8.c"
91555- line="1832">return location for end of valid data</doc>
91556- <type name="utf8" c:type="const gchar**"/>
92518+ line="2229">return location for end of valid data</doc>
92519+ <array c:type="const gchar**">
92520+ <type name="guint8"/>
92521+ </array>
9155792522 </parameter>
9155892523 </parameters>
9155992524 </function>
@@ -91562,7 +92527,7 @@ doing anything else with it.</doc>
9156292527 version="2.60">
9156392528 <doc xml:space="preserve"
9156492529 filename="glib/gutf8.c"
91565- line="1864">Validates UTF-8 encoded text.
92530+ line="2261">Validates UTF-8 encoded text.
9156692531
9156792532 As with [func@GLib.utf8_validate], but @max_len must be set, and hence this
9156892533 function will always return `FALSE` if any of the bytes of @str are nul.</doc>
@@ -91570,14 +92535,14 @@ function will always return `FALSE` if any of the bytes of @str are nul.</doc>
9157092535 <return-value transfer-ownership="none">
9157192536 <doc xml:space="preserve"
9157292537 filename="glib/gutf8.c"
91573- line="1875">`TRUE` if the text was valid UTF-8</doc>
92538+ line="2272">`TRUE` if the text was valid UTF-8</doc>
9157492539 <type name="gboolean" c:type="gboolean"/>
9157592540 </return-value>
9157692541 <parameters>
9157792542 <parameter name="str" transfer-ownership="none">
9157892543 <doc xml:space="preserve"
9157992544 filename="glib/gutf8.c"
91580- line="1866">a pointer to character data</doc>
92545+ line="2263">a pointer to character data</doc>
9158192546 <array length="1" zero-terminated="0" c:type="const gchar*">
9158292547 <type name="guint8"/>
9158392548 </array>
@@ -91585,7 +92550,7 @@ function will always return `FALSE` if any of the bytes of @str are nul.</doc>
9158592550 <parameter name="max_len" transfer-ownership="none">
9158692551 <doc xml:space="preserve"
9158792552 filename="glib/gutf8.c"
91588- line="1867">max bytes to validate</doc>
92553+ line="2264">max bytes to validate</doc>
9158992554 <type name="gsize" c:type="gsize"/>
9159092555 </parameter>
9159192556 <parameter name="end"
@@ -91596,15 +92561,17 @@ function will always return `FALSE` if any of the bytes of @str are nul.</doc>
9159692561 allow-none="1">
9159792562 <doc xml:space="preserve"
9159892563 filename="glib/gutf8.c"
91599- line="1868">return location for end of valid data</doc>
91600- <type name="utf8" c:type="const gchar**"/>
92564+ line="2265">return location for end of valid data</doc>
92565+ <array c:type="const gchar**">
92566+ <type name="guint8"/>
92567+ </array>
9160192568 </parameter>
9160292569 </parameters>
9160392570 </function>
9160492571 <function name="utime" c:identifier="g_utime" version="2.18">
9160592572 <doc xml:space="preserve"
9160692573 filename="glib/gstdio.c"
91607- line="1704">A wrapper for the POSIX utime() function. The utime() function
92574+ line="1725">A wrapper for the POSIX utime() function. The utime() function
9160892575 sets the access and modification timestamps of a file.
9160992576
9161092577 See your C library manual for more details about how utime() works
@@ -91613,14 +92580,14 @@ on your system.</doc>
9161392580 <return-value transfer-ownership="none">
9161492581 <doc xml:space="preserve"
9161592582 filename="glib/gstdio.c"
91616- line="1716">0 if the operation was successful, -1 if an error occurred</doc>
92583+ line="1737">0 if the operation was successful, -1 if an error occurred</doc>
9161792584 <type name="gint" c:type="int"/>
9161892585 </return-value>
9161992586 <parameters>
9162092587 <parameter name="filename" transfer-ownership="none">
9162192588 <doc xml:space="preserve"
9162292589 filename="glib/gstdio.c"
91623- line="1706">a pathname in the GLib file name encoding
92590+ line="1727">a pathname in the GLib file name encoding
9162492591 (UTF-8 on Windows)</doc>
9162592592 <type name="filename" c:type="const gchar*"/>
9162692593 </parameter>
@@ -91630,7 +92597,7 @@ on your system.</doc>
9163092597 allow-none="1">
9163192598 <doc xml:space="preserve"
9163292599 filename="glib/gstdio.c"
91633- line="1708">a pointer to a struct utimbuf.</doc>
92600+ line="1729">a pointer to a struct utimbuf.</doc>
9163492601 <type name="gpointer" c:type="utimbuf*"/>
9163592602 </parameter>
9163692603 </parameters>
@@ -92020,7 +92987,7 @@ see [func@GLib.VariantType.string_is_valid].</doc>
9202092987 introspectable="0">
9202192988 <doc xml:space="preserve"
9202292989 filename="glib/gprintf.c"
92023- line="298">An implementation of the GNU `vasprintf()` function which supports
92990+ line="299">An implementation of the GNU `vasprintf()` function which supports
9202492991 positional parameters, as specified in the Single Unix Specification.
9202592992 This function is similar to [func@GLib.vsprintf], except that it allocates a
9202692993 string to hold the output, instead of putting the output in a buffer
@@ -92035,7 +93002,7 @@ multibyte representation is available for the given character.
9203593002 <return-value transfer-ownership="none">
9203693003 <doc xml:space="preserve"
9203793004 filename="glib/gprintf.c"
92038- line="319">the number of bytes printed, or -1 on failure</doc>
93005+ line="320">the number of bytes printed, or -1 on failure</doc>
9203993006 <type name="gint" c:type="gint"/>
9204093007 </return-value>
9204193008 <parameters>
@@ -92045,7 +93012,7 @@ multibyte representation is available for the given character.
9204593012 transfer-ownership="full">
9204693013 <doc xml:space="preserve"
9204793014 filename="glib/gprintf.c"
92048- line="300">the return location for the
93015+ line="301">the return location for the
9204993016 newly-allocated string, which will be `NULL` if (and only if)
9205093017 this function fails</doc>
9205193018 <type name="utf8" c:type="gchar**"/>
@@ -92053,14 +93020,14 @@ multibyte representation is available for the given character.
9205393020 <parameter name="format" transfer-ownership="none">
9205493021 <doc xml:space="preserve"
9205593022 filename="glib/gprintf.c"
92056- line="303">a standard `printf()` format string, but notice
93023+ line="304">a standard `printf()` format string, but notice
9205793024 [string precision pitfalls](string-utils.html#string-precision-pitfalls)</doc>
9205893025 <type name="utf8" c:type="const gchar*"/>
9205993026 </parameter>
9206093027 <parameter name="args" transfer-ownership="none">
9206193028 <doc xml:space="preserve"
9206293029 filename="glib/gprintf.c"
92063- line="305">the list of arguments to insert in the output</doc>
93030+ line="306">the list of arguments to insert in the output</doc>
9206493031 <type name="va_list" c:type="va_list"/>
9206593032 </parameter>
9206693033 </parameters>
@@ -92071,7 +93038,7 @@ multibyte representation is available for the given character.
9207193038 introspectable="0">
9207293039 <doc xml:space="preserve"
9207393040 filename="glib/gprintf.c"
92074- line="203">An implementation of the standard `fprintf()` function which supports
93041+ line="204">An implementation of the standard `fprintf()` function which supports
9207593042 positional parameters, as specified in the Single Unix Specification.
9207693043
9207793044 `glib/gprintf.h` must be explicitly included in order to use this function.</doc>
@@ -92079,27 +93046,27 @@ positional parameters, as specified in the Single Unix Specification.
9207993046 <return-value transfer-ownership="none">
9208093047 <doc xml:space="preserve"
9208193048 filename="glib/gprintf.c"
92082- line="215">the number of bytes printed</doc>
93049+ line="216">the number of bytes printed</doc>
9208393050 <type name="gint" c:type="gint"/>
9208493051 </return-value>
9208593052 <parameters>
9208693053 <parameter name="file" transfer-ownership="none">
9208793054 <doc xml:space="preserve"
9208893055 filename="glib/gprintf.c"
92089- line="205">the stream to write to</doc>
93056+ line="206">the stream to write to</doc>
9209093057 <type name="gpointer" c:type="FILE*"/>
9209193058 </parameter>
9209293059 <parameter name="format" transfer-ownership="none">
9209393060 <doc xml:space="preserve"
9209493061 filename="glib/gprintf.c"
92095- line="206">a standard `printf()` format string, but notice
93062+ line="207">a standard `printf()` format string, but notice
9209693063 [string precision pitfalls](string-utils.html#string-precision-pitfalls)</doc>
9209793064 <type name="utf8" c:type="const gchar*"/>
9209893065 </parameter>
9209993066 <parameter name="args" transfer-ownership="none">
9210093067 <doc xml:space="preserve"
9210193068 filename="glib/gprintf.c"
92102- line="208">the list of arguments to insert in the output</doc>
93069+ line="209">the list of arguments to insert in the output</doc>
9210393070 <type name="va_list" c:type="va_list"/>
9210493071 </parameter>
9210593072 </parameters>
@@ -92110,7 +93077,7 @@ positional parameters, as specified in the Single Unix Specification.
9211093077 introspectable="0">
9211193078 <doc xml:space="preserve"
9211293079 filename="glib/gprintf.c"
92113- line="179">An implementation of the standard `vprintf()` function which supports
93080+ line="180">An implementation of the standard `vprintf()` function which supports
9211493081 positional parameters, as specified in the Single Unix Specification.
9211593082
9211693083 `glib/gprintf.h` must be explicitly included in order to use this function.</doc>
@@ -92118,21 +93085,21 @@ positional parameters, as specified in the Single Unix Specification.
9211893085 <return-value transfer-ownership="none">
9211993086 <doc xml:space="preserve"
9212093087 filename="glib/gprintf.c"
92121- line="190">the number of bytes printed</doc>
93088+ line="191">the number of bytes printed</doc>
9212293089 <type name="gint" c:type="gint"/>
9212393090 </return-value>
9212493091 <parameters>
9212593092 <parameter name="format" transfer-ownership="none">
9212693093 <doc xml:space="preserve"
9212793094 filename="glib/gprintf.c"
92128- line="181">a standard `printf()` format string, but notice
93095+ line="182">a standard `printf()` format string, but notice
9212993096 [string precision pitfalls](string-utils.html#string-precision-pitfalls)</doc>
9213093097 <type name="utf8" c:type="const gchar*"/>
9213193098 </parameter>
9213293099 <parameter name="args" transfer-ownership="none">
9213393100 <doc xml:space="preserve"
9213493101 filename="glib/gprintf.c"
92135- line="183">the list of arguments to insert in the output</doc>
93102+ line="184">the list of arguments to insert in the output</doc>
9213693103 <type name="va_list" c:type="va_list"/>
9213793104 </parameter>
9213893105 </parameters>
@@ -92140,7 +93107,7 @@ positional parameters, as specified in the Single Unix Specification.
9214093107 <function name="vsnprintf" c:identifier="g_vsnprintf" introspectable="0">
9214193108 <doc xml:space="preserve"
9214293109 filename="glib/gprintf.c"
92143- line="256">A safer form of the standard `vsprintf()` function. The output is guaranteed
93110+ line="257">A safer form of the standard `vsprintf()` function. The output is guaranteed
9214493111 to not exceed @n characters (including the terminating nul character), so
9214593112 it is easy to ensure that a buffer overflow cannot occur.
9214693113
@@ -92161,7 +93128,7 @@ the Single Unix Specification.</doc>
9216193128 <return-value transfer-ownership="none">
9216293129 <doc xml:space="preserve"
9216393130 filename="glib/gprintf.c"
92164- line="283">the number of bytes which would be produced if the buffer
93131+ line="284">the number of bytes which would be produced if the buffer
9216593132 was large enough</doc>
9216693133 <type name="gint" c:type="gint"/>
9216793134 </return-value>
@@ -92169,27 +93136,27 @@ the Single Unix Specification.</doc>
9216993136 <parameter name="string" transfer-ownership="none">
9217093137 <doc xml:space="preserve"
9217193138 filename="glib/gprintf.c"
92172- line="258">the buffer to hold the output</doc>
93139+ line="259">the buffer to hold the output</doc>
9217393140 <type name="utf8" c:type="gchar*"/>
9217493141 </parameter>
9217593142 <parameter name="n" transfer-ownership="none">
9217693143 <doc xml:space="preserve"
9217793144 filename="glib/gprintf.c"
92178- line="259">the maximum number of bytes to produce (including the
93145+ line="260">the maximum number of bytes to produce (including the
9217993146 terminating nul character)</doc>
9218093147 <type name="gulong" c:type="gulong"/>
9218193148 </parameter>
9218293149 <parameter name="format" transfer-ownership="none">
9218393150 <doc xml:space="preserve"
9218493151 filename="glib/gprintf.c"
92185- line="261">a standard `printf()` format string, but notice
93152+ line="262">a standard `printf()` format string, but notice
9218693153 [string precision pitfalls](string-utils.html#string-precision-pitfalls)</doc>
9218793154 <type name="utf8" c:type="const gchar*"/>
9218893155 </parameter>
9218993156 <parameter name="args" transfer-ownership="none">
9219093157 <doc xml:space="preserve"
9219193158 filename="glib/gprintf.c"
92192- line="263">the list of arguments to insert in the output</doc>
93159+ line="264">the list of arguments to insert in the output</doc>
9219393160 <type name="va_list" c:type="va_list"/>
9219493161 </parameter>
9219593162 </parameters>
@@ -92200,7 +93167,7 @@ the Single Unix Specification.</doc>
9220093167 introspectable="0">
9220193168 <doc xml:space="preserve"
9220293169 filename="glib/gprintf.c"
92203- line="229">An implementation of the standard `vsprintf()` function which supports
93170+ line="230">An implementation of the standard `vsprintf()` function which supports
9220493171 positional parameters, as specified in the Single Unix Specification.
9220593172
9220693173 `glib/gprintf.h` must be explicitly included in order to use this function.</doc>
@@ -92208,27 +93175,27 @@ positional parameters, as specified in the Single Unix Specification.
9220893175 <return-value transfer-ownership="none">
9220993176 <doc xml:space="preserve"
9221093177 filename="glib/gprintf.c"
92211- line="241">the number of bytes printed</doc>
93178+ line="242">the number of bytes printed</doc>
9221293179 <type name="gint" c:type="gint"/>
9221393180 </return-value>
9221493181 <parameters>
9221593182 <parameter name="string" transfer-ownership="none">
9221693183 <doc xml:space="preserve"
9221793184 filename="glib/gprintf.c"
92218- line="231">the buffer to hold the output</doc>
93185+ line="232">the buffer to hold the output</doc>
9221993186 <type name="utf8" c:type="gchar*"/>
9222093187 </parameter>
9222193188 <parameter name="format" transfer-ownership="none">
9222293189 <doc xml:space="preserve"
9222393190 filename="glib/gprintf.c"
92224- line="232">a standard `printf()` format string, but notice
93191+ line="233">a standard `printf()` format string, but notice
9222593192 [string precision pitfalls](string-utils.html#string-precision-pitfalls)</doc>
9222693193 <type name="utf8" c:type="const gchar*"/>
9222793194 </parameter>
9222893195 <parameter name="args" transfer-ownership="none">
9222993196 <doc xml:space="preserve"
9223093197 filename="glib/gprintf.c"
92231- line="234">the list of arguments to insert in the output</doc>
93198+ line="235">the list of arguments to insert in the output</doc>
9223293199 <type name="va_list" c:type="va_list"/>
9223393200 </parameter>
9223493201 </parameters>
@@ -92239,16 +93206,16 @@ positional parameters, as specified in the Single Unix Specification.
9223993206 introspectable="0">
9224093207 <doc xml:space="preserve"
9224193208 filename="glib/gmessages.h"
92242- line="549">Logs a warning if the expression is not true.
93209+ line="552">Logs a warning if the expression is not true.
9224393210
9224493211 Unlike g_return_if_fail(), the expression is always evaluated, even if
9224593212 checks and assertions are disabled.</doc>
92246- <source-position filename="glib/gmessages.h" line="560"/>
93213+ <source-position filename="glib/gmessages.h" line="563"/>
9224793214 <parameters>
9224893215 <parameter name="expr">
9224993216 <doc xml:space="preserve"
9225093217 filename="glib/gmessages.h"
92251- line="551">the expression to check</doc>
93218+ line="554">the expression to check</doc>
9225293219 </parameter>
9225393220 </parameters>
9225493221 </function-macro>
@@ -92258,17 +93225,17 @@ checks and assertions are disabled.</doc>
9225893225 introspectable="0">
9225993226 <doc xml:space="preserve"
9226093227 filename="glib/gmessages.h"
92261- line="537">Logs a warning.</doc>
92262- <source-position filename="glib/gmessages.h" line="544"/>
93228+ line="540">Logs a warning.</doc>
93229+ <source-position filename="glib/gmessages.h" line="547"/>
9226393230 </function-macro>
9226493231 <function name="warn_message"
9226593232 c:identifier="g_warn_message"
9226693233 introspectable="0">
9226793234 <doc xml:space="preserve"
9226893235 filename="glib/gmessages.c"
92269- line="3083">Internal function used to print messages from the public [func@GLib.warn_if_reached]
93236+ line="3169">Internal function used to print messages from the public [func@GLib.warn_if_reached]
9227093237 and [func@GLib.warn_if_fail] macros.</doc>
92271- <source-position filename="glib/gmessages.h" line="297"/>
93238+ <source-position filename="glib/gmessages.h" line="300"/>
9227293239 <return-value transfer-ownership="none">
9227393240 <type name="none" c:type="void"/>
9227493241 </return-value>
@@ -92279,25 +93246,25 @@ and [func@GLib.warn_if_fail] macros.</doc>
9227993246 allow-none="1">
9228093247 <doc xml:space="preserve"
9228193248 filename="glib/gmessages.c"
92282- line="3085">log domain</doc>
93249+ line="3171">log domain</doc>
9228393250 <type name="utf8" c:type="const char*"/>
9228493251 </parameter>
9228593252 <parameter name="file" transfer-ownership="none">
9228693253 <doc xml:space="preserve"
9228793254 filename="glib/gmessages.c"
92288- line="3086">file containing the warning</doc>
93255+ line="3172">file containing the warning</doc>
9228993256 <type name="utf8" c:type="const char*"/>
9229093257 </parameter>
9229193258 <parameter name="line" transfer-ownership="none">
9229293259 <doc xml:space="preserve"
9229393260 filename="glib/gmessages.c"
92294- line="3087">line number of the warning</doc>
93261+ line="3173">line number of the warning</doc>
9229593262 <type name="gint" c:type="int"/>
9229693263 </parameter>
9229793264 <parameter name="func" transfer-ownership="none">
9229893265 <doc xml:space="preserve"
9229993266 filename="glib/gmessages.c"
92300- line="3088">function containing the warning</doc>
93267+ line="3174">function containing the warning</doc>
9230193268 <type name="utf8" c:type="const char*"/>
9230293269 </parameter>
9230393270 <parameter name="warnexpr"
@@ -92306,7 +93273,7 @@ and [func@GLib.warn_if_fail] macros.</doc>
9230693273 allow-none="1">
9230793274 <doc xml:space="preserve"
9230893275 filename="glib/gmessages.c"
92309- line="3089">expression which failed</doc>
93276+ line="3175">expression which failed</doc>
9231093277 <type name="utf8" c:type="const char*"/>
9231193278 </parameter>
9231293279 </parameters>
@@ -92314,7 +93281,7 @@ and [func@GLib.warn_if_fail] macros.</doc>
9231493281 <function-macro name="warning" c:identifier="g_warning" introspectable="0">
9231593282 <doc xml:space="preserve"
9231693283 filename="glib/gmessages.c"
92317- line="197">A convenience function/macro to log a warning message.
93284+ line="196">A convenience function/macro to log a warning message.
9231893285
9231993286 The message should typically *not* be translated to the user’s language.
9232093287
@@ -92334,7 +93301,7 @@ parameters) then you should use [flags@GLib.LogLevelFlags.LEVEL_CRITICAL] instea
9233493301
9233593302 You can make warnings fatal at runtime by setting the `G_DEBUG`
9233693303 environment variable (see
92337-[Running GLib Applications](glib-running.html)):
93304+[Running GLib Applications](running.html)):
9233893305
9233993306 ```
9234093307 G_DEBUG=fatal-warnings gdb ./my-program
@@ -92350,12 +93317,12 @@ need not be entered manually.
9235093317 If structured logging is enabled, this will use [func@GLib.log_structured];
9235193318 otherwise it will use [func@GLib.log]. See
9235293319 [Using Structured Logging](logging.html#using-structured-logging).</doc>
92353- <source-position filename="glib/gmessages.h" line="337"/>
93320+ <source-position filename="glib/gmessages.h" line="340"/>
9235493321 <parameters>
9235593322 <parameter name="...">
9235693323 <doc xml:space="preserve"
9235793324 filename="glib/gmessages.c"
92358- line="199">format string, followed by parameters to insert into the format string
93325+ line="198">format string, followed by parameters to insert into the format string
9235993326 (as with `printf()`)</doc>
9236093327 </parameter>
9236193328 </parameters>
@@ -92366,19 +93333,19 @@ otherwise it will use [func@GLib.log]. See
9236693333 introspectable="0">
9236793334 <doc xml:space="preserve"
9236893335 filename="glib/gmessages.h"
92369- line="481">Logs a warning only once.
93336+ line="484">Logs a warning only once.
9237093337
9237193338 g_warning_once() calls g_warning() with the passed message the first time
9237293339 the statement is executed; subsequent times it is a no-op.
9237393340
9237493341 Note! On platforms where the compiler doesn't support variadic macros, the
9237593342 warning is printed each time instead of only once.</doc>
92376- <source-position filename="glib/gmessages.h" line="497"/>
93343+ <source-position filename="glib/gmessages.h" line="500"/>
9237793344 <parameters>
9237893345 <parameter name="...">
9237993346 <doc xml:space="preserve"
9238093347 filename="glib/gmessages.h"
92381- line="483">format string, followed by parameters to insert
93348+ line="486">format string, followed by parameters to insert
9238293349 into the format string (as with printf())</doc>
9238393350 </parameter>
9238493351 </parameters>
M internal/gir/spec/GModule-2.0.gir +85 -43
@@ -5,10 +5,12 @@ and/or use gtk-doc annotations. -->
55 <repository version="1.2"
66 xmlns="http://www.gtk.org/introspection/core/1.0"
77 xmlns:c="http://www.gtk.org/introspection/c/1.0"
8+ xmlns:doc="http://www.gtk.org/introspection/doc/1.0"
89 xmlns:glib="http://www.gtk.org/introspection/glib/1.0">
910 <include name="GLib" version="2.0"/>
1011 <package name="gmodule-2.0"/>
1112 <c:include name="gmodule.h"/>
13+ <doc:format name="gi-docgen"/>
1214 <namespace name="GModule"
1315 version="2.0"
1416 shared-library="libgmodule-2.0.so.0"
@@ -284,6 +286,15 @@ and/or use gtk-doc annotations. -->
284286 </parameter>
285287 </parameters>
286288 </function-macro>
289+ <function-macro name="DEPRECATED_ENUMERATOR_IN_2_86_FOR"
290+ c:identifier="GMODULE_DEPRECATED_ENUMERATOR_IN_2_86_FOR"
291+ introspectable="0">
292+ <source-position filename="gmodule/gmodule-visibility.h" line="1062"/>
293+ <parameters>
294+ <parameter name="f">
295+ </parameter>
296+ </parameters>
297+ </function-macro>
287298 <function-macro name="DEPRECATED_FOR"
288299 c:identifier="GMODULE_DEPRECATED_FOR"
289300 introspectable="0">
@@ -563,6 +574,15 @@ and/or use gtk-doc annotations. -->
563574 </parameter>
564575 </parameters>
565576 </function-macro>
577+ <function-macro name="DEPRECATED_IN_2_86_FOR"
578+ c:identifier="GMODULE_DEPRECATED_IN_2_86_FOR"
579+ introspectable="0">
580+ <source-position filename="gmodule/gmodule-visibility.h" line="1058"/>
581+ <parameters>
582+ <parameter name="f">
583+ </parameter>
584+ </parameters>
585+ </function-macro>
566586 <function-macro name="DEPRECATED_MACRO_IN_2_26_FOR"
567587 c:identifier="GMODULE_DEPRECATED_MACRO_IN_2_26_FOR"
568588 introspectable="0">
@@ -833,6 +853,15 @@ and/or use gtk-doc annotations. -->
833853 </parameter>
834854 </parameters>
835855 </function-macro>
856+ <function-macro name="DEPRECATED_MACRO_IN_2_86_FOR"
857+ c:identifier="GMODULE_DEPRECATED_MACRO_IN_2_86_FOR"
858+ introspectable="0">
859+ <source-position filename="gmodule/gmodule-visibility.h" line="1060"/>
860+ <parameters>
861+ <parameter name="f">
862+ </parameter>
863+ </parameters>
864+ </function-macro>
836865 <function-macro name="DEPRECATED_TYPE_IN_2_26_FOR"
837866 c:identifier="GMODULE_DEPRECATED_TYPE_IN_2_26_FOR"
838867 introspectable="0">
@@ -1103,6 +1132,15 @@ and/or use gtk-doc annotations. -->
11031132 </parameter>
11041133 </parameters>
11051134 </function-macro>
1135+ <function-macro name="DEPRECATED_TYPE_IN_2_86_FOR"
1136+ c:identifier="GMODULE_DEPRECATED_TYPE_IN_2_86_FOR"
1137+ introspectable="0">
1138+ <source-position filename="gmodule/gmodule-visibility.h" line="1064"/>
1139+ <parameters>
1140+ <parameter name="f">
1141+ </parameter>
1142+ </parameters>
1143+ </function-macro>
11061144 <constant name="MODULE_IMPL_AR" value="7" c:type="G_MODULE_IMPL_AR">
11071145 <source-position filename="gmodule/gmoduleconf.h" line="31"/>
11081146 <type name="gint" c:type="gint"/>
@@ -1124,24 +1162,28 @@ and/or use gtk-doc annotations. -->
11241162 filename="gmodule/gmodule.c"
11251163 line="56">The #GModule struct is an opaque data structure to represent a
11261164 [dynamically-loaded module](modules.html#dynamic-loading-of-modules).
1127-It should only be accessed via the following functions.</doc>
1165+It should only be accessed via the following functions.
1166+
1167+To ensure correct lock ordering, these functions must not be called from
1168+global constructors (for example, those using GCC’s
1169+`__attribute__((constructor))` attribute).</doc>
11281170 <source-position filename="gmodule/gmodule.h" line="70"/>
11291171 <method name="close" c:identifier="g_module_close">
11301172 <doc xml:space="preserve"
11311173 filename="gmodule/gmodule.c"
1132- line="711">Closes a module.</doc>
1174+ line="715">Closes a module.</doc>
11331175 <source-position filename="gmodule/gmodule.h" line="110"/>
11341176 <return-value transfer-ownership="none">
11351177 <doc xml:space="preserve"
11361178 filename="gmodule/gmodule.c"
1137- line="717">%TRUE on success</doc>
1179+ line="721">%TRUE on success</doc>
11381180 <type name="gboolean" c:type="gboolean"/>
11391181 </return-value>
11401182 <parameters>
11411183 <instance-parameter name="module" transfer-ownership="none">
11421184 <doc xml:space="preserve"
11431185 filename="gmodule/gmodule.c"
1144- line="713">a #GModule to close</doc>
1186+ line="717">a #GModule to close</doc>
11451187 <type name="Module" c:type="GModule*"/>
11461188 </instance-parameter>
11471189 </parameters>
@@ -1149,7 +1191,7 @@ It should only be accessed via the following functions.</doc>
11491191 <method name="make_resident" c:identifier="g_module_make_resident">
11501192 <doc xml:space="preserve"
11511193 filename="gmodule/gmodule.c"
1152- line="772">Ensures that a module will never be unloaded.
1194+ line="776">Ensures that a module will never be unloaded.
11531195 Any future g_module_close() calls on the module will be ignored.</doc>
11541196 <source-position filename="gmodule/gmodule.h" line="114"/>
11551197 <return-value transfer-ownership="none">
@@ -1159,7 +1201,7 @@ Any future g_module_close() calls on the module will be ignored.</doc>
11591201 <instance-parameter name="module" transfer-ownership="none">
11601202 <doc xml:space="preserve"
11611203 filename="gmodule/gmodule.c"
1162- line="774">a #GModule to make permanently resident</doc>
1204+ line="778">a #GModule to make permanently resident</doc>
11631205 <type name="Module" c:type="GModule*"/>
11641206 </instance-parameter>
11651207 </parameters>
@@ -1167,21 +1209,21 @@ Any future g_module_close() calls on the module will be ignored.</doc>
11671209 <method name="name" c:identifier="g_module_name">
11681210 <doc xml:space="preserve"
11691211 filename="gmodule/gmodule.c"
1170- line="855">Returns the filename that the module was opened with.
1212+ line="859">Returns the filename that the module was opened with.
11711213
11721214 If @module refers to the application itself, "main" is returned.</doc>
11731215 <source-position filename="gmodule/gmodule.h" line="128"/>
11741216 <return-value transfer-ownership="none">
11751217 <doc xml:space="preserve"
11761218 filename="gmodule/gmodule.c"
1177- line="863">the filename of the module</doc>
1219+ line="867">the filename of the module</doc>
11781220 <type name="utf8" c:type="const gchar*"/>
11791221 </return-value>
11801222 <parameters>
11811223 <instance-parameter name="module" transfer-ownership="none">
11821224 <doc xml:space="preserve"
11831225 filename="gmodule/gmodule.c"
1184- line="857">a #GModule</doc>
1226+ line="861">a #GModule</doc>
11851227 <type name="Module" c:type="GModule*"/>
11861228 </instance-parameter>
11871229 </parameters>
@@ -1189,26 +1231,26 @@ If @module refers to the application itself, "main" is returned.</doc>
11891231 <method name="symbol" c:identifier="g_module_symbol">
11901232 <doc xml:space="preserve"
11911233 filename="gmodule/gmodule.c"
1192- line="800">Gets a symbol pointer from a module, such as one exported
1234+ line="804">Gets a symbol pointer from a module, such as one exported
11931235 by %G_MODULE_EXPORT. Note that a valid symbol can be %NULL.</doc>
11941236 <source-position filename="gmodule/gmodule.h" line="122"/>
11951237 <return-value transfer-ownership="none">
11961238 <doc xml:space="preserve"
11971239 filename="gmodule/gmodule.c"
1198- line="809">%TRUE on success</doc>
1240+ line="813">%TRUE on success</doc>
11991241 <type name="gboolean" c:type="gboolean"/>
12001242 </return-value>
12011243 <parameters>
12021244 <instance-parameter name="module" transfer-ownership="none">
12031245 <doc xml:space="preserve"
12041246 filename="gmodule/gmodule.c"
1205- line="802">a #GModule</doc>
1247+ line="806">a #GModule</doc>
12061248 <type name="Module" c:type="GModule*"/>
12071249 </instance-parameter>
12081250 <parameter name="symbol_name" transfer-ownership="none">
12091251 <doc xml:space="preserve"
12101252 filename="gmodule/gmodule.c"
1211- line="803">the name of the symbol to find</doc>
1253+ line="807">the name of the symbol to find</doc>
12121254 <type name="utf8" c:type="const gchar*"/>
12131255 </parameter>
12141256 <parameter name="symbol"
@@ -1218,7 +1260,7 @@ by %G_MODULE_EXPORT. Note that a valid symbol can be %NULL.</doc>
12181260 nullable="1">
12191261 <doc xml:space="preserve"
12201262 filename="gmodule/gmodule.c"
1221- line="804">returns the pointer to the symbol value</doc>
1263+ line="808">returns the pointer to the symbol value</doc>
12221264 <type name="gpointer" c:type="gpointer*"/>
12231265 </parameter>
12241266 </parameters>
@@ -1229,7 +1271,7 @@ by %G_MODULE_EXPORT. Note that a valid symbol can be %NULL.</doc>
12291271 deprecated-version="2.76">
12301272 <doc xml:space="preserve"
12311273 filename="gmodule/gmodule.c"
1232- line="876">A portable way to build the filename of a module. The platform-specific
1274+ line="880">A portable way to build the filename of a module. The platform-specific
12331275 prefix and suffix are added to the filename, if needed, and the result
12341276 is added to the directory, using the correct separator character.
12351277
@@ -1248,7 +1290,7 @@ basename of the file_name argument. See %G_MODULE_SUFFIX for why.</doc-deprecate
12481290 <return-value transfer-ownership="full">
12491291 <doc xml:space="preserve"
12501292 filename="gmodule/gmodule.c"
1251- line="897">the complete path of the module, including the standard library
1293+ line="901">the complete path of the module, including the standard library
12521294 prefix and suffix. This should be freed when no longer needed</doc>
12531295 <type name="utf8" c:type="gchar*"/>
12541296 </return-value>
@@ -1259,7 +1301,7 @@ basename of the file_name argument. See %G_MODULE_SUFFIX for why.</doc-deprecate
12591301 allow-none="1">
12601302 <doc xml:space="preserve"
12611303 filename="gmodule/gmodule.c"
1262- line="878">the directory where the module is. This can be
1304+ line="882">the directory where the module is. This can be
12631305 %NULL or the empty string to indicate that the standard platform-specific
12641306 directories will be used, though that is not recommended</doc>
12651307 <type name="utf8" c:type="const gchar*"/>
@@ -1267,7 +1309,7 @@ basename of the file_name argument. See %G_MODULE_SUFFIX for why.</doc-deprecate
12671309 <parameter name="module_name" transfer-ownership="none">
12681310 <doc xml:space="preserve"
12691311 filename="gmodule/gmodule.c"
1270- line="881">the name of the module</doc>
1312+ line="885">the name of the module</doc>
12711313 <type name="utf8" c:type="const gchar*"/>
12721314 </parameter>
12731315 </parameters>
@@ -1275,12 +1317,12 @@ basename of the file_name argument. See %G_MODULE_SUFFIX for why.</doc-deprecate
12751317 <function name="error" c:identifier="g_module_error">
12761318 <doc xml:space="preserve"
12771319 filename="gmodule/gmodule.c"
1278- line="787">Gets a string describing the last module error.</doc>
1320+ line="791">Gets a string describing the last module error.</doc>
12791321 <source-position filename="gmodule/gmodule.h" line="118"/>
12801322 <return-value transfer-ownership="none">
12811323 <doc xml:space="preserve"
12821324 filename="gmodule/gmodule.c"
1283- line="792">a string describing the last module error</doc>
1325+ line="796">a string describing the last module error</doc>
12841326 <type name="utf8" c:type="const gchar*"/>
12851327 </return-value>
12861328 </function>
@@ -1292,12 +1334,12 @@ basename of the file_name argument. See %G_MODULE_SUFFIX for why.</doc-deprecate
12921334 <function name="open" c:identifier="g_module_open" introspectable="0">
12931335 <doc xml:space="preserve"
12941336 filename="gmodule/gmodule.c"
1295- line="693">A thin wrapper function around g_module_open_full()</doc>
1337+ line="697">A thin wrapper function around g_module_open_full()</doc>
12961338 <source-position filename="gmodule/gmodule.h" line="100"/>
12971339 <return-value>
12981340 <doc xml:space="preserve"
12991341 filename="gmodule/gmodule.c"
1300- line="702">a #GModule on success, or %NULL on failure</doc>
1342+ line="706">a #GModule on success, or %NULL on failure</doc>
13011343 <type name="Module" c:type="GModule*"/>
13021344 </return-value>
13031345 <parameters>
@@ -1307,14 +1349,14 @@ basename of the file_name argument. See %G_MODULE_SUFFIX for why.</doc-deprecate
13071349 allow-none="1">
13081350 <doc xml:space="preserve"
13091351 filename="gmodule/gmodule.c"
1310- line="695">the name or path to the file containing the module,
1352+ line="699">the name or path to the file containing the module,
13111353 or %NULL to obtain a #GModule representing the main program itself</doc>
13121354 <type name="utf8" c:type="const gchar*"/>
13131355 </parameter>
13141356 <parameter name="flags" transfer-ownership="none">
13151357 <doc xml:space="preserve"
13161358 filename="gmodule/gmodule.c"
1317- line="697">the flags used for opening the module. This can be the
1359+ line="701">the flags used for opening the module. This can be the
13181360 logical OR of any of the #GModuleFlags.</doc>
13191361 <type name="ModuleFlags" c:type="GModuleFlags"/>
13201362 </parameter>
@@ -1327,7 +1369,7 @@ basename of the file_name argument. See %G_MODULE_SUFFIX for why.</doc-deprecate
13271369 throws="1">
13281370 <doc xml:space="preserve"
13291371 filename="gmodule/gmodule.c"
1330- line="429">Opens a module. If the module has already been opened, its reference count
1372+ line="433">Opens a module. If the module has already been opened, its reference count
13311373 is incremented. If not, the module is searched using @file_name.
13321374
13331375 Since 2.76, the search order/behavior is as follows:
@@ -1354,7 +1396,7 @@ of @file_name.</doc>
13541396 <return-value>
13551397 <doc xml:space="preserve"
13561398 filename="gmodule/gmodule.c"
1357- line="461">a #GModule on success, or %NULL on failure</doc>
1399+ line="465">a #GModule on success, or %NULL on failure</doc>
13581400 <type name="Module" c:type="GModule*"/>
13591401 </return-value>
13601402 <parameters>
@@ -1364,14 +1406,14 @@ of @file_name.</doc>
13641406 allow-none="1">
13651407 <doc xml:space="preserve"
13661408 filename="gmodule/gmodule.c"
1367- line="431">the name or path to the file containing the module,
1409+ line="435">the name or path to the file containing the module,
13681410 or %NULL to obtain a #GModule representing the main program itself</doc>
13691411 <type name="utf8" c:type="const gchar*"/>
13701412 </parameter>
13711413 <parameter name="flags" transfer-ownership="none">
13721414 <doc xml:space="preserve"
13731415 filename="gmodule/gmodule.c"
1374- line="433">the flags used for opening the module. This can be the
1416+ line="437">the flags used for opening the module. This can be the
13751417 logical OR of any of the #GModuleFlags</doc>
13761418 <type name="ModuleFlags" c:type="GModuleFlags"/>
13771419 </parameter>
@@ -1380,12 +1422,12 @@ of @file_name.</doc>
13801422 <function name="supported" c:identifier="g_module_supported">
13811423 <doc xml:space="preserve"
13821424 filename="gmodule/gmodule.c"
1383- line="289">Checks if modules are supported on the current platform.</doc>
1425+ line="293">Checks if modules are supported on the current platform.</doc>
13841426 <source-position filename="gmodule/gmodule.h" line="96"/>
13851427 <return-value transfer-ownership="none">
13861428 <doc xml:space="preserve"
13871429 filename="gmodule/gmodule.c"
1388- line="294">%TRUE if modules are supported</doc>
1430+ line="298">%TRUE if modules are supported</doc>
13891431 <type name="gboolean" c:type="gboolean"/>
13901432 </return-value>
13911433 </function>
@@ -1393,7 +1435,7 @@ of @file_name.</doc>
13931435 <callback name="ModuleCheckInit" c:type="GModuleCheckInit">
13941436 <doc xml:space="preserve"
13951437 filename="gmodule/gmodule.c"
1396- line="64">Specifies the type of the module initialization function.
1438+ line="68">Specifies the type of the module initialization function.
13971439 If a module contains a function named g_module_check_init() it is called
13981440 automatically when the module is loaded. It is passed the #GModule structure
13991441 and should return %NULL on success or a string describing the initialization
@@ -1402,14 +1444,14 @@ error.</doc>
14021444 <return-value transfer-ownership="none">
14031445 <doc xml:space="preserve"
14041446 filename="gmodule/gmodule.c"
1405- line="74">%NULL on success, or a string describing the initialization error</doc>
1447+ line="78">%NULL on success, or a string describing the initialization error</doc>
14061448 <type name="utf8" c:type="const gchar*"/>
14071449 </return-value>
14081450 <parameters>
14091451 <parameter name="module" transfer-ownership="none">
14101452 <doc xml:space="preserve"
14111453 filename="gmodule/gmodule.c"
1412- line="66">the #GModule corresponding to the module which has just been loaded</doc>
1454+ line="70">the #GModule corresponding to the module which has just been loaded</doc>
14131455 <type name="Module" c:type="GModule*"/>
14141456 </parameter>
14151457 </parameters>
@@ -1465,7 +1507,7 @@ Note that these flags are not supported on all platforms.</doc>
14651507 <callback name="ModuleUnload" c:type="GModuleUnload">
14661508 <doc xml:space="preserve"
14671509 filename="gmodule/gmodule.c"
1468- line="77">Specifies the type of the module function called when it is unloaded.
1510+ line="81">Specifies the type of the module function called when it is unloaded.
14691511 If a module contains a function named g_module_unload() it is called
14701512 automatically when the module is unloaded.
14711513 It is passed the #GModule structure.</doc>
@@ -1477,7 +1519,7 @@ It is passed the #GModule structure.</doc>
14771519 <parameter name="module" transfer-ownership="none">
14781520 <doc xml:space="preserve"
14791521 filename="gmodule/gmodule.c"
1480- line="79">the #GModule about to be unloaded</doc>
1522+ line="83">the #GModule about to be unloaded</doc>
14811523 <type name="Module" c:type="GModule*"/>
14821524 </parameter>
14831525 </parameters>
@@ -1511,7 +1553,7 @@ It is passed the #GModule structure.</doc>
15111553 deprecated-version="2.76">
15121554 <doc xml:space="preserve"
15131555 filename="gmodule/gmodule.c"
1514- line="876">A portable way to build the filename of a module. The platform-specific
1556+ line="880">A portable way to build the filename of a module. The platform-specific
15151557 prefix and suffix are added to the filename, if needed, and the result
15161558 is added to the directory, using the correct separator character.
15171559
@@ -1530,7 +1572,7 @@ basename of the file_name argument. See %G_MODULE_SUFFIX for why.</doc-deprecate
15301572 <return-value transfer-ownership="full">
15311573 <doc xml:space="preserve"
15321574 filename="gmodule/gmodule.c"
1533- line="897">the complete path of the module, including the standard library
1575+ line="901">the complete path of the module, including the standard library
15341576 prefix and suffix. This should be freed when no longer needed</doc>
15351577 <type name="utf8" c:type="gchar*"/>
15361578 </return-value>
@@ -1541,7 +1583,7 @@ basename of the file_name argument. See %G_MODULE_SUFFIX for why.</doc-deprecate
15411583 allow-none="1">
15421584 <doc xml:space="preserve"
15431585 filename="gmodule/gmodule.c"
1544- line="878">the directory where the module is. This can be
1586+ line="882">the directory where the module is. This can be
15451587 %NULL or the empty string to indicate that the standard platform-specific
15461588 directories will be used, though that is not recommended</doc>
15471589 <type name="utf8" c:type="const gchar*"/>
@@ -1549,7 +1591,7 @@ basename of the file_name argument. See %G_MODULE_SUFFIX for why.</doc-deprecate
15491591 <parameter name="module_name" transfer-ownership="none">
15501592 <doc xml:space="preserve"
15511593 filename="gmodule/gmodule.c"
1552- line="881">the name of the module</doc>
1594+ line="885">the name of the module</doc>
15531595 <type name="utf8" c:type="const gchar*"/>
15541596 </parameter>
15551597 </parameters>
@@ -1559,12 +1601,12 @@ basename of the file_name argument. See %G_MODULE_SUFFIX for why.</doc-deprecate
15591601 moved-to="Module.error">
15601602 <doc xml:space="preserve"
15611603 filename="gmodule/gmodule.c"
1562- line="787">Gets a string describing the last module error.</doc>
1604+ line="791">Gets a string describing the last module error.</doc>
15631605 <source-position filename="gmodule/gmodule.h" line="118"/>
15641606 <return-value transfer-ownership="none">
15651607 <doc xml:space="preserve"
15661608 filename="gmodule/gmodule.c"
1567- line="792">a string describing the last module error</doc>
1609+ line="796">a string describing the last module error</doc>
15681610 <type name="utf8" c:type="const gchar*"/>
15691611 </return-value>
15701612 </function>
@@ -1580,12 +1622,12 @@ basename of the file_name argument. See %G_MODULE_SUFFIX for why.</doc-deprecate
15801622 moved-to="Module.supported">
15811623 <doc xml:space="preserve"
15821624 filename="gmodule/gmodule.c"
1583- line="289">Checks if modules are supported on the current platform.</doc>
1625+ line="293">Checks if modules are supported on the current platform.</doc>
15841626 <source-position filename="gmodule/gmodule.h" line="96"/>
15851627 <return-value transfer-ownership="none">
15861628 <doc xml:space="preserve"
15871629 filename="gmodule/gmodule.c"
1588- line="294">%TRUE if modules are supported</doc>
1630+ line="298">%TRUE if modules are supported</doc>
15891631 <type name="gboolean" c:type="gboolean"/>
15901632 </return-value>
15911633 </function>
M internal/gir/spec/GObject-2.0.gir +1366 -1287 large diff (2653 lines changed): collapsed
load diff
M internal/gir/spec/Gdk-4.0.gir +2452 -1233 large diff (3685 lines changed): collapsed
load diff
M internal/gir/spec/GdkPixbuf-2.0.gir +538 -507
@@ -59,7 +59,7 @@ Currently only RGB is supported.</doc>
5959 c:identifier="GDK_IS_PIXBUF_ANIMATION_CLASS"
6060 introspectable="0">
6161 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
62- line="138"/>
62+ line="135"/>
6363 <parameters>
6464 <parameter name="klass">
6565 </parameter>
@@ -78,7 +78,7 @@ Currently only RGB is supported.</doc>
7878 c:identifier="GDK_IS_PIXBUF_ANIMATION_ITER_CLASS"
7979 introspectable="0">
8080 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
81- line="186"/>
81+ line="183"/>
8282 <parameters>
8383 <parameter name="klass">
8484 </parameter>
@@ -102,6 +102,16 @@ Currently only RGB is supported.</doc>
102102 </parameter>
103103 </parameters>
104104 </function-macro>
105+ <function-macro name="IS_PIXBUF_NON_ANIM"
106+ c:identifier="GDK_IS_PIXBUF_NON_ANIM"
107+ introspectable="0">
108+ <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
109+ line="210"/>
110+ <parameters>
111+ <parameter name="object">
112+ </parameter>
113+ </parameters>
114+ </function-macro>
105115 <function-macro name="IS_PIXBUF_SIMPLE_ANIM"
106116 c:identifier="GDK_IS_PIXBUF_SIMPLE_ANIM"
107117 introspectable="0">
@@ -211,7 +221,7 @@ interpolation is just as fast and results in higher quality.</doc>
211221 c:identifier="GDK_PIXBUF_ANIMATION_CLASS"
212222 introspectable="0">
213223 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
214- line="137"/>
224+ line="134"/>
215225 <parameters>
216226 <parameter name="klass">
217227 </parameter>
@@ -221,7 +231,7 @@ interpolation is just as fast and results in higher quality.</doc>
221231 c:identifier="GDK_PIXBUF_ANIMATION_GET_CLASS"
222232 introspectable="0">
223233 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
224- line="139"/>
234+ line="136"/>
225235 <parameters>
226236 <parameter name="obj">
227237 </parameter>
@@ -240,7 +250,7 @@ interpolation is just as fast and results in higher quality.</doc>
240250 c:identifier="GDK_PIXBUF_ANIMATION_ITER_CLASS"
241251 introspectable="0">
242252 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
243- line="185"/>
253+ line="182"/>
244254 <parameters>
245255 <parameter name="klass">
246256 </parameter>
@@ -250,7 +260,7 @@ interpolation is just as fast and results in higher quality.</doc>
250260 c:identifier="GDK_PIXBUF_ANIMATION_ITER_GET_CLASS"
251261 introspectable="0">
252262 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
253- line="187"/>
263+ line="184"/>
254264 <parameters>
255265 <parameter name="obj">
256266 </parameter>
@@ -285,7 +295,7 @@ interpolation is just as fast and results in higher quality.</doc>
285295 <function-macro name="PIXBUF_DEPRECATED_IN_2_0_FOR"
286296 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_0_FOR"
287297 introspectable="0">
288- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="343"/>
298+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="353"/>
289299 <parameters>
290300 <parameter name="f">
291301 </parameter>
@@ -294,7 +304,7 @@ interpolation is just as fast and results in higher quality.</doc>
294304 <function-macro name="PIXBUF_DEPRECATED_IN_2_10_FOR"
295305 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_10_FOR"
296306 introspectable="0">
297- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="433"/>
307+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="443"/>
298308 <parameters>
299309 <parameter name="f">
300310 </parameter>
@@ -303,7 +313,7 @@ interpolation is just as fast and results in higher quality.</doc>
303313 <function-macro name="PIXBUF_DEPRECATED_IN_2_12_FOR"
304314 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_12_FOR"
305315 introspectable="0">
306- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="451"/>
316+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="461"/>
307317 <parameters>
308318 <parameter name="f">
309319 </parameter>
@@ -312,7 +322,7 @@ interpolation is just as fast and results in higher quality.</doc>
312322 <function-macro name="PIXBUF_DEPRECATED_IN_2_14_FOR"
313323 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_14_FOR"
314324 introspectable="0">
315- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="469"/>
325+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="479"/>
316326 <parameters>
317327 <parameter name="f">
318328 </parameter>
@@ -321,7 +331,7 @@ interpolation is just as fast and results in higher quality.</doc>
321331 <function-macro name="PIXBUF_DEPRECATED_IN_2_16_FOR"
322332 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_16_FOR"
323333 introspectable="0">
324- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="487"/>
334+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="497"/>
325335 <parameters>
326336 <parameter name="f">
327337 </parameter>
@@ -330,7 +340,7 @@ interpolation is just as fast and results in higher quality.</doc>
330340 <function-macro name="PIXBUF_DEPRECATED_IN_2_18_FOR"
331341 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_18_FOR"
332342 introspectable="0">
333- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="505"/>
343+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="515"/>
334344 <parameters>
335345 <parameter name="f">
336346 </parameter>
@@ -339,7 +349,7 @@ interpolation is just as fast and results in higher quality.</doc>
339349 <function-macro name="PIXBUF_DEPRECATED_IN_2_20_FOR"
340350 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_20_FOR"
341351 introspectable="0">
342- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="523"/>
352+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="533"/>
343353 <parameters>
344354 <parameter name="f">
345355 </parameter>
@@ -348,7 +358,7 @@ interpolation is just as fast and results in higher quality.</doc>
348358 <function-macro name="PIXBUF_DEPRECATED_IN_2_22_FOR"
349359 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_22_FOR"
350360 introspectable="0">
351- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="541"/>
361+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="551"/>
352362 <parameters>
353363 <parameter name="f">
354364 </parameter>
@@ -357,7 +367,7 @@ interpolation is just as fast and results in higher quality.</doc>
357367 <function-macro name="PIXBUF_DEPRECATED_IN_2_24_FOR"
358368 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_24_FOR"
359369 introspectable="0">
360- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="559"/>
370+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="569"/>
361371 <parameters>
362372 <parameter name="f">
363373 </parameter>
@@ -366,7 +376,7 @@ interpolation is just as fast and results in higher quality.</doc>
366376 <function-macro name="PIXBUF_DEPRECATED_IN_2_26_FOR"
367377 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_26_FOR"
368378 introspectable="0">
369- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="577"/>
379+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="587"/>
370380 <parameters>
371381 <parameter name="f">
372382 </parameter>
@@ -375,7 +385,7 @@ interpolation is just as fast and results in higher quality.</doc>
375385 <function-macro name="PIXBUF_DEPRECATED_IN_2_28_FOR"
376386 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_28_FOR"
377387 introspectable="0">
378- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="595"/>
388+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="605"/>
379389 <parameters>
380390 <parameter name="f">
381391 </parameter>
@@ -384,7 +394,7 @@ interpolation is just as fast and results in higher quality.</doc>
384394 <function-macro name="PIXBUF_DEPRECATED_IN_2_2_FOR"
385395 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_2_FOR"
386396 introspectable="0">
387- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="361"/>
397+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="371"/>
388398 <parameters>
389399 <parameter name="f">
390400 </parameter>
@@ -393,7 +403,7 @@ interpolation is just as fast and results in higher quality.</doc>
393403 <function-macro name="PIXBUF_DEPRECATED_IN_2_30_FOR"
394404 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_30_FOR"
395405 introspectable="0">
396- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="613"/>
406+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="623"/>
397407 <parameters>
398408 <parameter name="f">
399409 </parameter>
@@ -402,7 +412,7 @@ interpolation is just as fast and results in higher quality.</doc>
402412 <function-macro name="PIXBUF_DEPRECATED_IN_2_32_FOR"
403413 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_32_FOR"
404414 introspectable="0">
405- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="631"/>
415+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="641"/>
406416 <parameters>
407417 <parameter name="f">
408418 </parameter>
@@ -411,7 +421,7 @@ interpolation is just as fast and results in higher quality.</doc>
411421 <function-macro name="PIXBUF_DEPRECATED_IN_2_34_FOR"
412422 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_34_FOR"
413423 introspectable="0">
414- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="649"/>
424+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="659"/>
415425 <parameters>
416426 <parameter name="f">
417427 </parameter>
@@ -420,7 +430,7 @@ interpolation is just as fast and results in higher quality.</doc>
420430 <function-macro name="PIXBUF_DEPRECATED_IN_2_36_FOR"
421431 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_36_FOR"
422432 introspectable="0">
423- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="667"/>
433+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="677"/>
424434 <parameters>
425435 <parameter name="f">
426436 </parameter>
@@ -429,7 +439,7 @@ interpolation is just as fast and results in higher quality.</doc>
429439 <function-macro name="PIXBUF_DEPRECATED_IN_2_38_FOR"
430440 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_38_FOR"
431441 introspectable="0">
432- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="685"/>
442+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="695"/>
433443 <parameters>
434444 <parameter name="f">
435445 </parameter>
@@ -438,7 +448,16 @@ interpolation is just as fast and results in higher quality.</doc>
438448 <function-macro name="PIXBUF_DEPRECATED_IN_2_40_FOR"
439449 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_40_FOR"
440450 introspectable="0">
441- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="703"/>
451+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="713"/>
452+ <parameters>
453+ <parameter name="f">
454+ </parameter>
455+ </parameters>
456+ </function-macro>
457+ <function-macro name="PIXBUF_DEPRECATED_IN_2_44_FOR"
458+ c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_44_FOR"
459+ introspectable="0">
460+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="731"/>
442461 <parameters>
443462 <parameter name="f">
444463 </parameter>
@@ -447,7 +466,7 @@ interpolation is just as fast and results in higher quality.</doc>
447466 <function-macro name="PIXBUF_DEPRECATED_IN_2_4_FOR"
448467 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_4_FOR"
449468 introspectable="0">
450- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="379"/>
469+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="389"/>
451470 <parameters>
452471 <parameter name="f">
453472 </parameter>
@@ -456,7 +475,7 @@ interpolation is just as fast and results in higher quality.</doc>
456475 <function-macro name="PIXBUF_DEPRECATED_IN_2_6_FOR"
457476 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_6_FOR"
458477 introspectable="0">
459- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="397"/>
478+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="407"/>
460479 <parameters>
461480 <parameter name="f">
462481 </parameter>
@@ -465,7 +484,7 @@ interpolation is just as fast and results in higher quality.</doc>
465484 <function-macro name="PIXBUF_DEPRECATED_IN_2_8_FOR"
466485 c:identifier="GDK_PIXBUF_DEPRECATED_IN_2_8_FOR"
467486 introspectable="0">
468- <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="415"/>
487+ <source-position filename="gdk-pixbuf/gdk-pixbuf-macros.h" line="425"/>
469488 <parameters>
470489 <parameter name="f">
471490 </parameter>
@@ -506,7 +525,7 @@ interpolation is just as fast and results in higher quality.</doc>
506525 <source-position filename="gdk-pixbuf/gdk-pixbuf-features.h" line="37"/>
507526 <type name="gint" c:type="gint"/>
508527 </constant>
509- <constant name="PIXBUF_MICRO" value="12" c:type="GDK_PIXBUF_MICRO">
528+ <constant name="PIXBUF_MICRO" value="3" c:type="GDK_PIXBUF_MICRO">
510529 <doc xml:space="preserve"
511530 filename="gdk-pixbuf/gdk-pixbuf-features.h"
512531 line="22">Micro version of gdk-pixbuf library, that is the "2" in
@@ -514,7 +533,7 @@ interpolation is just as fast and results in higher quality.</doc>
514533 <source-position filename="gdk-pixbuf/gdk-pixbuf-features.h" line="39"/>
515534 <type name="gint" c:type="gint"/>
516535 </constant>
517- <constant name="PIXBUF_MINOR" value="42" c:type="GDK_PIXBUF_MINOR">
536+ <constant name="PIXBUF_MINOR" value="44" c:type="GDK_PIXBUF_MINOR">
518537 <doc xml:space="preserve"
519538 filename="gdk-pixbuf/gdk-pixbuf-features.h"
520539 line="16">Minor version of gdk-pixbuf library, that is the "8" in
@@ -522,6 +541,16 @@ interpolation is just as fast and results in higher quality.</doc>
522541 <source-position filename="gdk-pixbuf/gdk-pixbuf-features.h" line="38"/>
523542 <type name="gint" c:type="gint"/>
524543 </constant>
544+ <function-macro name="PIXBUF_NON_ANIM"
545+ c:identifier="GDK_PIXBUF_NON_ANIM"
546+ introspectable="0">
547+ <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
548+ line="209"/>
549+ <parameters>
550+ <parameter name="object">
551+ </parameter>
552+ </parameters>
553+ </function-macro>
525554 <function-macro name="PIXBUF_SIMPLE_ANIM"
526555 c:identifier="GDK_PIXBUF_SIMPLE_ANIM"
527556 introspectable="0">
@@ -552,9 +581,7 @@ interpolation is just as fast and results in higher quality.</doc>
552581 </parameter>
553582 </parameters>
554583 </function-macro>
555- <constant name="PIXBUF_VERSION"
556- value="2.42.12"
557- c:type="GDK_PIXBUF_VERSION">
584+ <constant name="PIXBUF_VERSION" value="2.44.3" c:type="GDK_PIXBUF_VERSION">
558585 <doc xml:space="preserve"
559586 filename="gdk-pixbuf/gdk-pixbuf-features.h"
560587 line="28">Contains the full version of GdkPixbuf as a string.
@@ -600,9 +627,6 @@ wrapping it with `gdk_pixbuf_new_from_data()`. The `gdk_pixbuf_new()`
600627 function will compute an optimal rowstride so that rendering can be
601628 performed with an efficient algorithm.
602629
603-As a special case, you can use the [`ctor@GdkPixbuf.Pixbuf.new_from_xpm_data`]
604-function to create a pixbuf from inline XPM image data.
605-
606630 You can also copy an existing pixbuf with the [method@Pixbuf.copy]
607631 function. This is not the same as just acquiring a reference to
608632 the old pixbuf instance: the copy function will actually duplicate
@@ -718,7 +742,7 @@ If the allocation of the buffer failed, this function will return `NULL`.
718742
719743 The buffer has an optimal rowstride. Note that the buffer is not cleared;
720744 you will have to fill it completely yourself.</doc>
721- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="206"/>
745+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="204"/>
722746 <return-value transfer-ownership="full" nullable="1">
723747 <doc xml:space="preserve"
724748 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -763,60 +787,60 @@ you will have to fill it completely yourself.</doc>
763787 version="2.32">
764788 <doc xml:space="preserve"
765789 filename="gdk-pixbuf/gdk-pixbuf-data.c"
766- line="94">Creates a new #GdkPixbuf out of in-memory readonly image data.
790+ line="96">Creates a new #GdkPixbuf out of in-memory readonly image data.
767791
768792 Currently only RGB images with 8 bits per sample are supported.
769793
770794 This is the `GBytes` variant of gdk_pixbuf_new_from_data(), useful
771795 for language bindings.</doc>
772- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="286"/>
796+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="284"/>
773797 <return-value transfer-ownership="full">
774798 <doc xml:space="preserve"
775799 filename="gdk-pixbuf/gdk-pixbuf-data.c"
776- line="111">A newly-created pixbuf</doc>
800+ line="113">A newly-created pixbuf</doc>
777801 <type name="Pixbuf" c:type="GdkPixbuf*"/>
778802 </return-value>
779803 <parameters>
780804 <parameter name="data" transfer-ownership="none">
781805 <doc xml:space="preserve"
782806 filename="gdk-pixbuf/gdk-pixbuf-data.c"
783- line="96">Image data in 8-bit/sample packed format inside a #GBytes</doc>
807+ line="98">Image data in 8-bit/sample packed format inside a #GBytes</doc>
784808 <type name="GLib.Bytes" c:type="GBytes*"/>
785809 </parameter>
786810 <parameter name="colorspace" transfer-ownership="none">
787811 <doc xml:space="preserve"
788812 filename="gdk-pixbuf/gdk-pixbuf-data.c"
789- line="97">Colorspace for the image data</doc>
813+ line="99">Colorspace for the image data</doc>
790814 <type name="Colorspace" c:type="GdkColorspace"/>
791815 </parameter>
792816 <parameter name="has_alpha" transfer-ownership="none">
793817 <doc xml:space="preserve"
794818 filename="gdk-pixbuf/gdk-pixbuf-data.c"
795- line="98">Whether the data has an opacity channel</doc>
819+ line="100">Whether the data has an opacity channel</doc>
796820 <type name="gboolean" c:type="gboolean"/>
797821 </parameter>
798822 <parameter name="bits_per_sample" transfer-ownership="none">
799823 <doc xml:space="preserve"
800824 filename="gdk-pixbuf/gdk-pixbuf-data.c"
801- line="99">Number of bits per sample</doc>
825+ line="101">Number of bits per sample</doc>
802826 <type name="gint" c:type="int"/>
803827 </parameter>
804828 <parameter name="width" transfer-ownership="none">
805829 <doc xml:space="preserve"
806830 filename="gdk-pixbuf/gdk-pixbuf-data.c"
807- line="100">Width of the image in pixels, must be &gt; 0</doc>
831+ line="102">Width of the image in pixels, must be &gt; 0</doc>
808832 <type name="gint" c:type="int"/>
809833 </parameter>
810834 <parameter name="height" transfer-ownership="none">
811835 <doc xml:space="preserve"
812836 filename="gdk-pixbuf/gdk-pixbuf-data.c"
813- line="101">Height of the image in pixels, must be &gt; 0</doc>
837+ line="103">Height of the image in pixels, must be &gt; 0</doc>
814838 <type name="gint" c:type="int"/>
815839 </parameter>
816840 <parameter name="rowstride" transfer-ownership="none">
817841 <doc xml:space="preserve"
818842 filename="gdk-pixbuf/gdk-pixbuf-data.c"
819- line="102">Distance in bytes between row starts</doc>
843+ line="104">Distance in bytes between row starts</doc>
820844 <type name="gint" c:type="int"/>
821845 </parameter>
822846 </parameters>
@@ -836,11 +860,11 @@ finalized, your destroy notification function will be called, and
836860 it is its responsibility to free the pixel array.
837861
838862 See also: [ctor@GdkPixbuf.Pixbuf.new_from_bytes]</doc>
839- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="276"/>
863+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="274"/>
840864 <return-value transfer-ownership="full">
841865 <doc xml:space="preserve"
842866 filename="gdk-pixbuf/gdk-pixbuf-data.c"
843- line="54">A newly-created pixbuf</doc>
867+ line="56">A newly-created pixbuf</doc>
844868 <type name="Pixbuf" c:type="GdkPixbuf*"/>
845869 </return-value>
846870 <parameters>
@@ -896,8 +920,9 @@ See also: [ctor@GdkPixbuf.Pixbuf.new_from_bytes]</doc>
896920 closure="8">
897921 <doc xml:space="preserve"
898922 filename="gdk-pixbuf/gdk-pixbuf-data.c"
899- line="38">Function used to free the data when the pixbuf's reference count
900-drops to zero, or %NULL if the data should not be freed</doc>
923+ line="38">Function
924+ used to free the data when the pixbuf's reference count
925+ drops to zero, or `NULL` if the data should not be freed</doc>
901926 <type name="PixbufDestroyNotify" c:type="GdkPixbufDestroyNotify"/>
902927 </parameter>
903928 <parameter name="destroy_fn_data"
@@ -906,7 +931,8 @@ drops to zero, or %NULL if the data should not be freed</doc>
906931 allow-none="1">
907932 <doc xml:space="preserve"
908933 filename="gdk-pixbuf/gdk-pixbuf-data.c"
909- line="40">Closure data to pass to the destroy notification function</doc>
934+ line="41">Closure data to pass to the destroy
935+ notification function</doc>
910936 <type name="gpointer" c:type="gpointer"/>
911937 </parameter>
912938 </parameters>
@@ -916,7 +942,7 @@ drops to zero, or %NULL if the data should not be freed</doc>
916942 throws="1">
917943 <doc xml:space="preserve"
918944 filename="gdk-pixbuf/gdk-pixbuf-io.c"
919- line="1089">Creates a new pixbuf by loading an image from a file.
945+ line="1176">Creates a new pixbuf by loading an image from a file.
920946
921947 The file format is detected automatically.
922948
@@ -928,18 +954,18 @@ If `NULL` is returned, then @error will be set. Possible errors are:
928954 - the image buffer contains invalid data
929955
930956 The error domains are `GDK_PIXBUF_ERROR` and `G_FILE_ERROR`.</doc>
931- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="252"/>
957+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="250"/>
932958 <return-value transfer-ownership="full" nullable="1">
933959 <doc xml:space="preserve"
934960 filename="gdk-pixbuf/gdk-pixbuf-io.c"
935- line="1108">A newly-created pixbuf</doc>
961+ line="1195">A newly-created pixbuf</doc>
936962 <type name="Pixbuf" c:type="GdkPixbuf*"/>
937963 </return-value>
938964 <parameters>
939965 <parameter name="filename" transfer-ownership="none">
940966 <doc xml:space="preserve"
941967 filename="gdk-pixbuf/gdk-pixbuf-io.c"
942- line="1091">Name of file to load, in the GLib file
968+ line="1178">Name of file to load, in the GLib file
943969 name encoding</doc>
944970 <type name="filename" c:type="const char*"/>
945971 </parameter>
@@ -951,7 +977,7 @@ The error domains are `GDK_PIXBUF_ERROR` and `G_FILE_ERROR`.</doc>
951977 throws="1">
952978 <doc xml:space="preserve"
953979 filename="gdk-pixbuf/gdk-pixbuf-io.c"
954- line="1337">Creates a new pixbuf by loading an image from a file.
980+ line="1424">Creates a new pixbuf by loading an image from a file.
955981
956982 The file format is detected automatically.
957983
@@ -973,37 +999,37 @@ the image to be scaled to the exact given width. When not preserving
973999 aspect ratio, a `width` or `height` of -1 means to not scale the image
9741000 at all in that dimension. Negative values for `width` and `height` are
9751001 allowed since 2.8.</doc>
976- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="260"/>
1002+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="258"/>
9771003 <return-value transfer-ownership="full" nullable="1">
9781004 <doc xml:space="preserve"
9791005 filename="gdk-pixbuf/gdk-pixbuf-io.c"
980- line="1369">A newly-created pixbuf</doc>
1006+ line="1456">A newly-created pixbuf</doc>
9811007 <type name="Pixbuf" c:type="GdkPixbuf*"/>
9821008 </return-value>
9831009 <parameters>
9841010 <parameter name="filename" transfer-ownership="none">
9851011 <doc xml:space="preserve"
9861012 filename="gdk-pixbuf/gdk-pixbuf-io.c"
987- line="1339">Name of file to load, in the GLib file
1013+ line="1426">Name of file to load, in the GLib file
9881014 name encoding</doc>
9891015 <type name="filename" c:type="const char*"/>
9901016 </parameter>
9911017 <parameter name="width" transfer-ownership="none">
9921018 <doc xml:space="preserve"
9931019 filename="gdk-pixbuf/gdk-pixbuf-io.c"
994- line="1341">The width the image should have or -1 to not constrain the width</doc>
1020+ line="1428">The width the image should have or -1 to not constrain the width</doc>
9951021 <type name="gint" c:type="int"/>
9961022 </parameter>
9971023 <parameter name="height" transfer-ownership="none">
9981024 <doc xml:space="preserve"
9991025 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1000- line="1342">The height the image should have or -1 to not constrain the height</doc>
1026+ line="1429">The height the image should have or -1 to not constrain the height</doc>
10011027 <type name="gint" c:type="int"/>
10021028 </parameter>
10031029 <parameter name="preserve_aspect_ratio" transfer-ownership="none">
10041030 <doc xml:space="preserve"
10051031 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1006- line="1343">`TRUE` to preserve the image's aspect ratio</doc>
1032+ line="1430">`TRUE` to preserve the image's aspect ratio</doc>
10071033 <type name="gboolean" c:type="gboolean"/>
10081034 </parameter>
10091035 </parameters>
@@ -1014,7 +1040,7 @@ allowed since 2.8.</doc>
10141040 throws="1">
10151041 <doc xml:space="preserve"
10161042 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1017- line="1210">Creates a new pixbuf by loading an image from a file.
1043+ line="1297">Creates a new pixbuf by loading an image from a file.
10181044
10191045 The file format is detected automatically.
10201046
@@ -1032,31 +1058,31 @@ the image's aspect ratio. Note that the returned pixbuf may be smaller
10321058 than `width` x `height`, if the aspect ratio requires it. To load
10331059 and image at the requested size, regardless of aspect ratio, use
10341060 [ctor@GdkPixbuf.Pixbuf.new_from_file_at_scale].</doc>
1035- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="255"/>
1061+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="253"/>
10361062 <return-value transfer-ownership="full" nullable="1">
10371063 <doc xml:space="preserve"
10381064 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1039- line="1237">A newly-created pixbuf</doc>
1065+ line="1324">A newly-created pixbuf</doc>
10401066 <type name="Pixbuf" c:type="GdkPixbuf*"/>
10411067 </return-value>
10421068 <parameters>
10431069 <parameter name="filename" transfer-ownership="none">
10441070 <doc xml:space="preserve"
10451071 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1046- line="1212">Name of file to load, in the GLib file
1072+ line="1299">Name of file to load, in the GLib file
10471073 name encoding</doc>
10481074 <type name="filename" c:type="const char*"/>
10491075 </parameter>
10501076 <parameter name="width" transfer-ownership="none">
10511077 <doc xml:space="preserve"
10521078 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1053- line="1214">The width the image should have or -1 to not constrain the width</doc>
1079+ line="1301">The width the image should have or -1 to not constrain the width</doc>
10541080 <type name="gint" c:type="int"/>
10551081 </parameter>
10561082 <parameter name="height" transfer-ownership="none">
10571083 <doc xml:space="preserve"
10581084 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1059- line="1215">The height the image should have or -1 to not constrain the height</doc>
1085+ line="1302">The height the image should have or -1 to not constrain the height</doc>
10601086 <type name="gint" c:type="int"/>
10611087 </parameter>
10621088 </parameters>
@@ -1102,7 +1128,7 @@ For non-const inline data, you could get out of memory. For untrusted
11021128 inline data located at runtime, you could have corrupt inline data in
11031129 addition.</doc>
11041130 <doc-deprecated xml:space="preserve">Use `GResource` instead.</doc-deprecated>
1105- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="298"/>
1131+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="295"/>
11061132 <return-value transfer-ownership="full">
11071133 <doc xml:space="preserve"
11081134 filename="gdk-pixbuf/gdk-pixdata.c"
@@ -1141,22 +1167,22 @@ addition.</doc>
11411167 throws="1">
11421168 <doc xml:space="preserve"
11431169 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1144- line="1793">Creates a new pixbuf by loading an image from an resource.
1170+ line="1883">Creates a new pixbuf by loading an image from an resource.
11451171
11461172 The file format is detected automatically. If `NULL` is returned, then
11471173 @error will be set.</doc>
1148- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="266"/>
1174+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="264"/>
11491175 <return-value transfer-ownership="full" nullable="1">
11501176 <doc xml:space="preserve"
11511177 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1152- line="1803">A newly-created pixbuf</doc>
1178+ line="1893">A newly-created pixbuf</doc>
11531179 <type name="Pixbuf" c:type="GdkPixbuf*"/>
11541180 </return-value>
11551181 <parameters>
11561182 <parameter name="resource_path" transfer-ownership="none">
11571183 <doc xml:space="preserve"
11581184 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1159- line="1795">the path of the resource file</doc>
1185+ line="1885">the path of the resource file</doc>
11601186 <type name="utf8" c:type="const char*"/>
11611187 </parameter>
11621188 </parameters>
@@ -1167,7 +1193,7 @@ The file format is detected automatically. If `NULL` is returned, then
11671193 throws="1">
11681194 <doc xml:space="preserve"
11691195 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1170- line="1827">Creates a new pixbuf by loading an image from an resource.
1196+ line="1917">Creates a new pixbuf by loading an image from an resource.
11711197
11721198 The file format is detected automatically. If `NULL` is returned, then
11731199 @error will be set.
@@ -1180,36 +1206,36 @@ exact given width. When not preserving aspect ratio, a @width or
11801206 @height of -1 means to not scale the image at all in that dimension.
11811207
11821208 The stream is not closed.</doc>
1183- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="269"/>
1209+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="267"/>
11841210 <return-value transfer-ownership="full" nullable="1">
11851211 <doc xml:space="preserve"
11861212 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1187- line="1849">A newly-created pixbuf</doc>
1213+ line="1939">A newly-created pixbuf</doc>
11881214 <type name="Pixbuf" c:type="GdkPixbuf*"/>
11891215 </return-value>
11901216 <parameters>
11911217 <parameter name="resource_path" transfer-ownership="none">
11921218 <doc xml:space="preserve"
11931219 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1194- line="1829">the path of the resource file</doc>
1220+ line="1919">the path of the resource file</doc>
11951221 <type name="utf8" c:type="const char*"/>
11961222 </parameter>
11971223 <parameter name="width" transfer-ownership="none">
11981224 <doc xml:space="preserve"
11991225 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1200- line="1830">The width the image should have or -1 to not constrain the width</doc>
1226+ line="1920">The width the image should have or -1 to not constrain the width</doc>
12011227 <type name="gint" c:type="int"/>
12021228 </parameter>
12031229 <parameter name="height" transfer-ownership="none">
12041230 <doc xml:space="preserve"
12051231 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1206- line="1831">The height the image should have or -1 to not constrain the height</doc>
1232+ line="1921">The height the image should have or -1 to not constrain the height</doc>
12071233 <type name="gint" c:type="int"/>
12081234 </parameter>
12091235 <parameter name="preserve_aspect_ratio" transfer-ownership="none">
12101236 <doc xml:space="preserve"
12111237 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1212- line="1832">`TRUE` to preserve the image's aspect ratio</doc>
1238+ line="1922">`TRUE` to preserve the image's aspect ratio</doc>
12131239 <type name="gboolean" c:type="gboolean"/>
12141240 </parameter>
12151241 </parameters>
@@ -1220,7 +1246,7 @@ The stream is not closed.</doc>
12201246 throws="1">
12211247 <doc xml:space="preserve"
12221248 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1223- line="1717">Creates a new pixbuf by loading an image from an input stream.
1249+ line="1804">Creates a new pixbuf by loading an image from an input stream.
12241250
12251251 The file format is detected automatically.
12261252
@@ -1232,18 +1258,18 @@ returned. Other possible errors are in the `GDK_PIXBUF_ERROR` and
12321258 `G_IO_ERROR` domains.
12331259
12341260 The stream is not closed.</doc>
1235- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="409"/>
1261+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="404"/>
12361262 <return-value transfer-ownership="full" nullable="1">
12371263 <doc xml:space="preserve"
12381264 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1239- line="1736">A newly-created pixbuf</doc>
1265+ line="1823">A newly-created pixbuf</doc>
12401266 <type name="Pixbuf" c:type="GdkPixbuf*"/>
12411267 </return-value>
12421268 <parameters>
12431269 <parameter name="stream" transfer-ownership="none">
12441270 <doc xml:space="preserve"
12451271 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1246- line="1719">a `GInputStream` to load the pixbuf from</doc>
1272+ line="1806">a `GInputStream` to load the pixbuf from</doc>
12471273 <type name="Gio.InputStream" c:type="GInputStream*"/>
12481274 </parameter>
12491275 <parameter name="cancellable"
@@ -1252,7 +1278,7 @@ The stream is not closed.</doc>
12521278 allow-none="1">
12531279 <doc xml:space="preserve"
12541280 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1255- line="1720">optional `GCancellable` object, `NULL` to ignore</doc>
1281+ line="1807">optional `GCancellable` object, `NULL` to ignore</doc>
12561282 <type name="Gio.Cancellable" c:type="GCancellable*"/>
12571283 </parameter>
12581284 </parameters>
@@ -1263,7 +1289,7 @@ The stream is not closed.</doc>
12631289 throws="1">
12641290 <doc xml:space="preserve"
12651291 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1266- line="1543">Creates a new pixbuf by loading an image from an input stream.
1292+ line="1630">Creates a new pixbuf by loading an image from an input stream.
12671293
12681294 The file format is detected automatically. If `NULL` is returned, then
12691295 @error will be set. The @cancellable can be used to abort the operation
@@ -1284,36 +1310,36 @@ When not preserving aspect ratio, a `width` or `height` of -1 means to not
12841310 scale the image at all in that dimension.
12851311
12861312 The stream is not closed.</doc>
1287- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="424"/>
1313+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="419"/>
12881314 <return-value transfer-ownership="full" nullable="1">
12891315 <doc xml:space="preserve"
12901316 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1291- line="1574">A newly-created pixbuf</doc>
1317+ line="1661">A newly-created pixbuf</doc>
12921318 <type name="Pixbuf" c:type="GdkPixbuf*"/>
12931319 </return-value>
12941320 <parameters>
12951321 <parameter name="stream" transfer-ownership="none">
12961322 <doc xml:space="preserve"
12971323 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1298- line="1545">a `GInputStream` to load the pixbuf from</doc>
1324+ line="1632">a `GInputStream` to load the pixbuf from</doc>
12991325 <type name="Gio.InputStream" c:type="GInputStream*"/>
13001326 </parameter>
13011327 <parameter name="width" transfer-ownership="none">
13021328 <doc xml:space="preserve"
13031329 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1304- line="1546">The width the image should have or -1 to not constrain the width</doc>
1330+ line="1633">The width the image should have or -1 to not constrain the width</doc>
13051331 <type name="gint" c:type="gint"/>
13061332 </parameter>
13071333 <parameter name="height" transfer-ownership="none">
13081334 <doc xml:space="preserve"
13091335 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1310- line="1547">The height the image should have or -1 to not constrain the height</doc>
1336+ line="1634">The height the image should have or -1 to not constrain the height</doc>
13111337 <type name="gint" c:type="gint"/>
13121338 </parameter>
13131339 <parameter name="preserve_aspect_ratio" transfer-ownership="none">
13141340 <doc xml:space="preserve"
13151341 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1316- line="1548">`TRUE` to preserve the image's aspect ratio</doc>
1342+ line="1635">`TRUE` to preserve the image's aspect ratio</doc>
13171343 <type name="gboolean" c:type="gboolean"/>
13181344 </parameter>
13191345 <parameter name="cancellable"
@@ -1322,7 +1348,7 @@ The stream is not closed.</doc>
13221348 allow-none="1">
13231349 <doc xml:space="preserve"
13241350 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1325- line="1549">optional `GCancellable` object, `NULL` to ignore</doc>
1351+ line="1636">optional `GCancellable` object, `NULL` to ignore</doc>
13261352 <type name="Gio.Cancellable" c:type="GCancellable*"/>
13271353 </parameter>
13281354 </parameters>
@@ -1333,44 +1359,49 @@ The stream is not closed.</doc>
13331359 throws="1">
13341360 <doc xml:space="preserve"
13351361 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1336- line="1914">Finishes an asynchronous pixbuf creation operation started with
1362+ line="2004">Finishes an asynchronous pixbuf creation operation started with
13371363 gdk_pixbuf_new_from_stream_async().</doc>
1338- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="420"/>
1364+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="415"/>
13391365 <return-value transfer-ownership="full" nullable="1">
13401366 <doc xml:space="preserve"
13411367 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1342- line="1922">the newly created pixbuf</doc>
1368+ line="2012">the newly created pixbuf</doc>
13431369 <type name="Pixbuf" c:type="GdkPixbuf*"/>
13441370 </return-value>
13451371 <parameters>
13461372 <parameter name="async_result" transfer-ownership="none">
13471373 <doc xml:space="preserve"
13481374 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1349- line="1916">a `GAsyncResult`</doc>
1375+ line="2006">a `GAsyncResult`</doc>
13501376 <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
13511377 </parameter>
13521378 </parameters>
13531379 </constructor>
13541380 <constructor name="new_from_xpm_data"
1355- c:identifier="gdk_pixbuf_new_from_xpm_data">
1381+ c:identifier="gdk_pixbuf_new_from_xpm_data"
1382+ deprecated="1"
1383+ deprecated-version="2.44">
13561384 <doc xml:space="preserve"
13571385 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1358- line="2148">Creates a new pixbuf by parsing XPM data in memory.
1386+ line="2238">Creates a new pixbuf by parsing XPM data in memory.
13591387
13601388 This data is commonly the result of including an XPM file into a
13611389 program's C source.</doc>
1362- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="294"/>
1390+ <doc-deprecated xml:space="preserve">Use [ctor@GdkPixbuf.Pixbuf.new_from_stream] with
1391+ a [class@Gio.MemoryInputStream], making sure to handle errors in
1392+ case the XPM format loader is not available</doc-deprecated>
1393+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="292"/>
13631394 <return-value transfer-ownership="full" nullable="1">
13641395 <doc xml:space="preserve"
13651396 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1366- line="2157">A newly-created pixbuf</doc>
1397+ line="2247">A newly-created pixbuf</doc>
13671398 <type name="Pixbuf" c:type="GdkPixbuf*"/>
13681399 </return-value>
13691400 <parameters>
13701401 <parameter name="data" transfer-ownership="none">
13711402 <doc xml:space="preserve"
13721403 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1373- line="2150">Pointer to inline XPM data.</doc>
1404+ line="2240">Pointer to inline XPM data.</doc>
13741405 <array c:type="const char**">
13751406 <type name="utf8" c:type="char*"/>
13761407 </array>
@@ -1387,7 +1418,7 @@ have.
13871418
13881419 This function is useful for front-ends and backends that want to check
13891420 image values without needing to create a `GdkPixbuf`.</doc>
1390- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="210"/>
1421+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="208"/>
13911422 <return-value transfer-ownership="none">
13921423 <doc xml:space="preserve"
13931424 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -1433,12 +1464,12 @@ image values without needing to create a `GdkPixbuf`.</doc>
14331464 glib:async-func="get_file_info_async">
14341465 <doc xml:space="preserve"
14351466 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1436- line="1964">Parses an image file far enough to determine its format and size.</doc>
1467+ line="2054">Parses an image file far enough to determine its format and size.</doc>
14371468 <source-position filename="gdk-pixbuf/gdk-pixbuf-io.h" line="77"/>
14381469 <return-value transfer-ownership="none" nullable="1">
14391470 <doc xml:space="preserve"
14401471 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1441- line="1972">A `GdkPixbufFormat` describing
1472+ line="2062">A `GdkPixbufFormat` describing
14421473 the image format of the file</doc>
14431474 <type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
14441475 </return-value>
@@ -1446,7 +1477,7 @@ image values without needing to create a `GdkPixbuf`.</doc>
14461477 <parameter name="filename" transfer-ownership="none">
14471478 <doc xml:space="preserve"
14481479 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1449- line="1966">The name of the file to identify.</doc>
1480+ line="2056">The name of the file to identify.</doc>
14501481 <type name="filename" c:type="const gchar*"/>
14511482 </parameter>
14521483 <parameter name="width"
@@ -1457,7 +1488,7 @@ image values without needing to create a `GdkPixbuf`.</doc>
14571488 allow-none="1">
14581489 <doc xml:space="preserve"
14591490 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1460- line="1967">Return location for the width of the image</doc>
1491+ line="2057">Return location for the width of the image</doc>
14611492 <type name="gint" c:type="gint*"/>
14621493 </parameter>
14631494 <parameter name="height"
@@ -1468,7 +1499,7 @@ image values without needing to create a `GdkPixbuf`.</doc>
14681499 allow-none="1">
14691500 <doc xml:space="preserve"
14701501 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1471- line="1968">Return location for the height of the image</doc>
1502+ line="2058">Return location for the height of the image</doc>
14721503 <type name="gint" c:type="gint*"/>
14731504 </parameter>
14741505 </parameters>
@@ -1480,7 +1511,7 @@ image values without needing to create a `GdkPixbuf`.</doc>
14801511 glib:sync-func="get_file_info">
14811512 <doc xml:space="preserve"
14821513 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1483- line="2062">Asynchronously parses an image file far enough to determine its
1514+ line="2152">Asynchronously parses an image file far enough to determine its
14841515 format and size.
14851516
14861517 For more details see gdk_pixbuf_get_file_info(), which is the synchronous
@@ -1497,7 +1528,7 @@ get the result of the operation.</doc>
14971528 <parameter name="filename" transfer-ownership="none">
14981529 <doc xml:space="preserve"
14991530 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1500- line="2064">The name of the file to identify</doc>
1531+ line="2154">The name of the file to identify</doc>
15011532 <type name="filename" c:type="const gchar*"/>
15021533 </parameter>
15031534 <parameter name="cancellable"
@@ -1506,7 +1537,7 @@ get the result of the operation.</doc>
15061537 allow-none="1">
15071538 <doc xml:space="preserve"
15081539 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1509- line="2065">optional `GCancellable` object, `NULL` to ignore</doc>
1540+ line="2155">optional `GCancellable` object, `NULL` to ignore</doc>
15101541 <type name="Gio.Cancellable" c:type="GCancellable*"/>
15111542 </parameter>
15121543 <parameter name="callback"
@@ -1517,7 +1548,7 @@ get the result of the operation.</doc>
15171548 closure="3">
15181549 <doc xml:space="preserve"
15191550 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1520- line="2066">a `GAsyncReadyCallback` to call when the file info is available</doc>
1551+ line="2156">a `GAsyncReadyCallback` to call when the file info is available</doc>
15211552 <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
15221553 </parameter>
15231554 <parameter name="user_data"
@@ -1526,7 +1557,7 @@ get the result of the operation.</doc>
15261557 allow-none="1">
15271558 <doc xml:space="preserve"
15281559 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1529- line="2067">the data to pass to the callback function</doc>
1560+ line="2157">the data to pass to the callback function</doc>
15301561 <type name="gpointer" c:type="gpointer"/>
15311562 </parameter>
15321563 </parameters>
@@ -1537,13 +1568,13 @@ get the result of the operation.</doc>
15371568 throws="1">
15381569 <doc xml:space="preserve"
15391570 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1540- line="2105">Finishes an asynchronous pixbuf parsing operation started with
1571+ line="2195">Finishes an asynchronous pixbuf parsing operation started with
15411572 gdk_pixbuf_get_file_info_async().</doc>
15421573 <source-position filename="gdk-pixbuf/gdk-pixbuf-io.h" line="86"/>
15431574 <return-value transfer-ownership="none" nullable="1">
15441575 <doc xml:space="preserve"
15451576 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1546- line="2115">A `GdkPixbufFormat` describing the
1577+ line="2205">A `GdkPixbufFormat` describing the
15471578 image format of the file</doc>
15481579 <type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
15491580 </return-value>
@@ -1551,7 +1582,7 @@ gdk_pixbuf_get_file_info_async().</doc>
15511582 <parameter name="async_result" transfer-ownership="none">
15521583 <doc xml:space="preserve"
15531584 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1554- line="2107">a `GAsyncResult`</doc>
1585+ line="2197">a `GAsyncResult`</doc>
15551586 <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
15561587 </parameter>
15571588 <parameter name="width"
@@ -1560,7 +1591,7 @@ gdk_pixbuf_get_file_info_async().</doc>
15601591 transfer-ownership="full">
15611592 <doc xml:space="preserve"
15621593 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1563- line="2108">Return location for the width of the image, or `NULL`</doc>
1594+ line="2198">Return location for the width of the image, or `NULL`</doc>
15641595 <type name="gint" c:type="gint*"/>
15651596 </parameter>
15661597 <parameter name="height"
@@ -1569,7 +1600,7 @@ gdk_pixbuf_get_file_info_async().</doc>
15691600 transfer-ownership="full">
15701601 <doc xml:space="preserve"
15711602 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1572- line="2109">Return location for the height of the image, or `NULL`</doc>
1603+ line="2199">Return location for the height of the image, or `NULL`</doc>
15731604 <type name="gint" c:type="gint*"/>
15741605 </parameter>
15751606 </parameters>
@@ -1579,13 +1610,13 @@ gdk_pixbuf_get_file_info_async().</doc>
15791610 version="2.2">
15801611 <doc xml:space="preserve"
15811612 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1582- line="3426">Obtains the available information about the image formats supported
1613+ line="3520">Obtains the available information about the image formats supported
15831614 by GdkPixbuf.</doc>
15841615 <source-position filename="gdk-pixbuf/gdk-pixbuf-io.h" line="52"/>
15851616 <return-value transfer-ownership="container">
15861617 <doc xml:space="preserve"
15871618 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1588- line="3432">A list of
1619+ line="3526">A list of
15891620 support image formats.</doc>
15901621 <type name="GLib.SList" c:type="GSList*">
15911622 <type name="PixbufFormat"/>
@@ -1598,7 +1629,7 @@ by GdkPixbuf.</doc>
15981629 throws="1">
15991630 <doc xml:space="preserve"
16001631 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1601- line="561">Initalizes the gdk-pixbuf loader modules referenced by the `loaders.cache`
1632+ line="563">Initalizes the gdk-pixbuf loader modules referenced by the `loaders.cache`
16021633 file present inside that directory.
16031634
16041635 This is to be used by applications that want to ship certain loaders
@@ -1619,7 +1650,7 @@ provided modules.</doc>
16191650 <parameter name="path" transfer-ownership="none">
16201651 <doc xml:space="preserve"
16211652 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1622- line="563">Path to directory where the `loaders.cache` is installed</doc>
1653+ line="565">Path to directory where the `loaders.cache` is installed</doc>
16231654 <type name="utf8" c:type="const char*"/>
16241655 </parameter>
16251656 </parameters>
@@ -1627,10 +1658,10 @@ provided modules.</doc>
16271658 <function name="new_from_stream_async"
16281659 c:identifier="gdk_pixbuf_new_from_stream_async"
16291660 version="2.24"
1630- glib:finish-func="new_from_stream_finish">
1661+ glib:finish-func="gdk_pixbuf_new_from_stream_finish">
16311662 <doc xml:space="preserve"
16321663 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1633- line="1872">Creates a new pixbuf by asynchronously loading an image from an input stream.
1664+ line="1962">Creates a new pixbuf by asynchronously loading an image from an input stream.
16341665
16351666 For more details see gdk_pixbuf_new_from_stream(), which is the synchronous
16361667 version of this function.
@@ -1638,7 +1669,7 @@ version of this function.
16381669 When the operation is finished, @callback will be called in the main thread.
16391670 You can then call gdk_pixbuf_new_from_stream_finish() to get the result of
16401671 the operation.</doc>
1641- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="414"/>
1672+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="409"/>
16421673 <return-value transfer-ownership="none">
16431674 <type name="none" c:type="void"/>
16441675 </return-value>
@@ -1646,7 +1677,7 @@ the operation.</doc>
16461677 <parameter name="stream" transfer-ownership="none">
16471678 <doc xml:space="preserve"
16481679 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1649- line="1874">a `GInputStream` from which to load the pixbuf</doc>
1680+ line="1964">a `GInputStream` from which to load the pixbuf</doc>
16501681 <type name="Gio.InputStream" c:type="GInputStream*"/>
16511682 </parameter>
16521683 <parameter name="cancellable"
@@ -1655,7 +1686,7 @@ the operation.</doc>
16551686 allow-none="1">
16561687 <doc xml:space="preserve"
16571688 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1658- line="1875">optional `GCancellable` object, `NULL` to ignore</doc>
1689+ line="1965">optional `GCancellable` object, `NULL` to ignore</doc>
16591690 <type name="Gio.Cancellable" c:type="GCancellable*"/>
16601691 </parameter>
16611692 <parameter name="callback"
@@ -1666,7 +1697,7 @@ the operation.</doc>
16661697 closure="3">
16671698 <doc xml:space="preserve"
16681699 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1669- line="1876">a `GAsyncReadyCallback` to call when the pixbuf is loaded</doc>
1700+ line="1966">a `GAsyncReadyCallback` to call when the pixbuf is loaded</doc>
16701701 <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
16711702 </parameter>
16721703 <parameter name="user_data"
@@ -1675,24 +1706,25 @@ the operation.</doc>
16751706 allow-none="1">
16761707 <doc xml:space="preserve"
16771708 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1678- line="1877">the data to pass to the callback function</doc>
1709+ line="1967">the data to pass to the callback function</doc>
16791710 <type name="gpointer" c:type="gpointer"/>
16801711 </parameter>
16811712 </parameters>
16821713 </function>
16831714 <function name="new_from_stream_at_scale_async"
16841715 c:identifier="gdk_pixbuf_new_from_stream_at_scale_async"
1685- version="2.24">
1716+ version="2.24"
1717+ glib:finish-func="gdk_pixbuf_new_from_stream_finish">
16861718 <doc xml:space="preserve"
16871719 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1688- line="1655">Creates a new pixbuf by asynchronously loading an image from an input stream.
1720+ line="1742">Creates a new pixbuf by asynchronously loading an image from an input stream.
16891721
16901722 For more details see gdk_pixbuf_new_from_stream_at_scale(), which is the synchronous
16911723 version of this function.
16921724
16931725 When the operation is finished, @callback will be called in the main thread.
16941726 You can then call gdk_pixbuf_new_from_stream_finish() to get the result of the operation.</doc>
1695- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="432"/>
1727+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="427"/>
16961728 <return-value transfer-ownership="none">
16971729 <type name="none" c:type="void"/>
16981730 </return-value>
@@ -1700,25 +1732,25 @@ You can then call gdk_pixbuf_new_from_stream_finish() to get the result of the o
17001732 <parameter name="stream" transfer-ownership="none">
17011733 <doc xml:space="preserve"
17021734 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1703- line="1657">a `GInputStream` from which to load the pixbuf</doc>
1735+ line="1744">a `GInputStream` from which to load the pixbuf</doc>
17041736 <type name="Gio.InputStream" c:type="GInputStream*"/>
17051737 </parameter>
17061738 <parameter name="width" transfer-ownership="none">
17071739 <doc xml:space="preserve"
17081740 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1709- line="1658">the width the image should have or -1 to not constrain the width</doc>
1741+ line="1745">the width the image should have or -1 to not constrain the width</doc>
17101742 <type name="gint" c:type="gint"/>
17111743 </parameter>
17121744 <parameter name="height" transfer-ownership="none">
17131745 <doc xml:space="preserve"
17141746 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1715- line="1659">the height the image should have or -1 to not constrain the height</doc>
1747+ line="1746">the height the image should have or -1 to not constrain the height</doc>
17161748 <type name="gint" c:type="gint"/>
17171749 </parameter>
17181750 <parameter name="preserve_aspect_ratio" transfer-ownership="none">
17191751 <doc xml:space="preserve"
17201752 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1721- line="1660">`TRUE` to preserve the image's aspect ratio</doc>
1753+ line="1747">`TRUE` to preserve the image's aspect ratio</doc>
17221754 <type name="gboolean" c:type="gboolean"/>
17231755 </parameter>
17241756 <parameter name="cancellable"
@@ -1727,7 +1759,7 @@ You can then call gdk_pixbuf_new_from_stream_finish() to get the result of the o
17271759 allow-none="1">
17281760 <doc xml:space="preserve"
17291761 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1730- line="1661">optional `GCancellable` object, `NULL` to ignore</doc>
1762+ line="1748">optional `GCancellable` object, `NULL` to ignore</doc>
17311763 <type name="Gio.Cancellable" c:type="GCancellable*"/>
17321764 </parameter>
17331765 <parameter name="callback"
@@ -1738,7 +1770,7 @@ You can then call gdk_pixbuf_new_from_stream_finish() to get the result of the o
17381770 closure="6">
17391771 <doc xml:space="preserve"
17401772 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1741- line="1662">a `GAsyncReadyCallback` to call when the pixbuf is loaded</doc>
1773+ line="1749">a `GAsyncReadyCallback` to call when the pixbuf is loaded</doc>
17421774 <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
17431775 </parameter>
17441776 <parameter name="user_data"
@@ -1747,7 +1779,7 @@ You can then call gdk_pixbuf_new_from_stream_finish() to get the result of the o
17471779 allow-none="1">
17481780 <doc xml:space="preserve"
17491781 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1750- line="1663">the data to pass to the callback function</doc>
1782+ line="1750">the data to pass to the callback function</doc>
17511783 <type name="gpointer" c:type="gpointer"/>
17521784 </parameter>
17531785 </parameters>
@@ -1758,20 +1790,20 @@ You can then call gdk_pixbuf_new_from_stream_finish() to get the result of the o
17581790 throws="1">
17591791 <doc xml:space="preserve"
17601792 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1761- line="3199">Finishes an asynchronous pixbuf save operation started with
1793+ line="3293">Finishes an asynchronous pixbuf save operation started with
17621794 gdk_pixbuf_save_to_stream_async().</doc>
1763- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="458"/>
1795+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="453"/>
17641796 <return-value transfer-ownership="none">
17651797 <doc xml:space="preserve"
17661798 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1767- line="3207">`TRUE` if the pixbuf was saved successfully, `FALSE` if an error was set.</doc>
1799+ line="3301">`TRUE` if the pixbuf was saved successfully, `FALSE` if an error was set.</doc>
17681800 <type name="gboolean" c:type="gboolean"/>
17691801 </return-value>
17701802 <parameters>
17711803 <parameter name="async_result" transfer-ownership="none">
17721804 <doc xml:space="preserve"
17731805 filename="gdk-pixbuf/gdk-pixbuf-io.c"
1774- line="3201">a `GAsyncResult`</doc>
1806+ line="3295">a `GAsyncResult`</doc>
17751807 <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
17761808 </parameter>
17771809 </parameters>
@@ -1792,7 +1824,7 @@ pixels will become fully transparent.
17921824
17931825 If `substitute_color` is `FALSE`, then the (`r`, `g`, `b`) arguments
17941826 will be ignored.</doc>
1795- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="482"/>
1827+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="477"/>
17961828 <return-value transfer-ownership="full" nullable="1">
17971829 <doc xml:space="preserve"
17981830 filename="gdk-pixbuf/gdk-pixbuf-util.c"
@@ -1847,7 +1879,7 @@ transforms performed by libtiff).
18471879
18481880 If an orientation option/tag is present, the appropriate transform
18491881 will be performed so that the pixbuf is oriented correctly.</doc>
1850- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="502"/>
1882+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="497"/>
18511883 <return-value transfer-ownership="full" nullable="1">
18521884 <doc xml:space="preserve"
18531885 filename="gdk-pixbuf/gdk-pixbuf-util.c"
@@ -2158,7 +2190,7 @@ and `color2`.</doc>
21582190
21592191 Note that this does not copy the options set on the original `GdkPixbuf`,
21602192 use gdk_pixbuf_copy_options() for this.</doc>
2161- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="218"/>
2193+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="216"/>
21622194 <return-value transfer-ownership="full" nullable="1">
21632195 <doc xml:space="preserve"
21642196 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2184,7 +2216,7 @@ Conversion of pixbuf formats is done automatically.
21842216 If the source rectangle overlaps the destination rectangle on the
21852217 same pixbuf, it will be overwritten during the copy operation.
21862218 Therefore, you can not use this function to scroll a pixbuf.</doc>
2187- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="487"/>
2219+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="482"/>
21882220 <return-value transfer-ownership="none">
21892221 <type name="none" c:type="void"/>
21902222 </return-value>
@@ -2250,7 +2282,7 @@ Therefore, you can not use this function to scroll a pixbuf.</doc>
22502282 This is useful to keep original metadata after having manipulated
22512283 a file. However be careful to remove metadata which you've already
22522284 applied, such as the "orientation" option after rotating the image.</doc>
2253- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="518"/>
2285+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="513"/>
22542286 <return-value transfer-ownership="none">
22552287 <doc xml:space="preserve"
22562288 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2280,7 +2312,7 @@ the pixbuf's pixel format.
22802312
22812313 The alpha component will be ignored if the pixbuf doesn't have an alpha
22822314 channel.</doc>
2283- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="306"/>
2315+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="301"/>
22842316 <return-value transfer-ownership="none">
22852317 <type name="none" c:type="void"/>
22862318 </return-value>
@@ -2334,7 +2366,7 @@ result in a new pixbuf.</doc>
23342366 <doc xml:space="preserve"
23352367 filename="gdk-pixbuf/gdk-pixbuf.c"
23362368 line="795">Queries the number of bits per color sample in a pixbuf.</doc>
2337- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="180"/>
2369+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="178"/>
23382370 <return-value transfer-ownership="none">
23392371 <doc xml:space="preserve"
23402372 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2356,7 +2388,7 @@ result in a new pixbuf.</doc>
23562388 <doc xml:space="preserve"
23572389 filename="gdk-pixbuf/gdk-pixbuf.c"
23582390 line="1008">Returns the length of the pixel data, in bytes.</doc>
2359- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="190"/>
2391+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="188"/>
23602392 <return-value transfer-ownership="none">
23612393 <doc xml:space="preserve"
23622394 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2378,7 +2410,7 @@ result in a new pixbuf.</doc>
23782410 <doc xml:space="preserve"
23792411 filename="gdk-pixbuf/gdk-pixbuf.c"
23802412 line="747">Queries the color space of a pixbuf.</doc>
2381- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="174"/>
2413+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="172"/>
23822414 <return-value transfer-ownership="none">
23832415 <doc xml:space="preserve"
23842416 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2400,7 +2432,7 @@ result in a new pixbuf.</doc>
24002432 <doc xml:space="preserve"
24012433 filename="gdk-pixbuf/gdk-pixbuf.c"
24022434 line="779">Queries whether a pixbuf has an alpha channel (opacity information).</doc>
2403- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="178"/>
2435+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="176"/>
24042436 <return-value transfer-ownership="none">
24052437 <doc xml:space="preserve"
24062438 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2422,7 +2454,7 @@ result in a new pixbuf.</doc>
24222454 <doc xml:space="preserve"
24232455 filename="gdk-pixbuf/gdk-pixbuf.c"
24242456 line="975">Queries the height of a pixbuf.</doc>
2425- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="186"/>
2457+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="184"/>
24262458 <return-value transfer-ownership="none">
24272459 <doc xml:space="preserve"
24282460 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2444,7 +2476,7 @@ result in a new pixbuf.</doc>
24442476 <doc xml:space="preserve"
24452477 filename="gdk-pixbuf/gdk-pixbuf.c"
24462478 line="763">Queries the number of channels of a pixbuf.</doc>
2447- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="176"/>
2479+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="174"/>
24482480 <return-value transfer-ownership="none">
24492481 <doc xml:space="preserve"
24502482 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2478,7 +2510,7 @@ Since 2.32 the JPEG and PNG loaders set "x-dpi" and "y-dpi" if the file
24782510 contains image density information in dots per inch.
24792511 Since 2.36.6, the JPEG loader sets the "comment" option with the comment
24802512 EXIF tag.</doc>
2481- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="510"/>
2513+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="505"/>
24822514 <return-value transfer-ownership="none" nullable="1">
24832515 <doc xml:space="preserve"
24842516 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2508,7 +2540,7 @@ EXIF tag.</doc>
25082540 line="1156">Returns a `GHashTable` with a list of all the options that may have been
25092541 attached to the `pixbuf` when it was loaded, or that may have been
25102542 attached by another function using [method@GdkPixbuf.Pixbuf.set_option].</doc>
2511- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="516"/>
2543+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="511"/>
25122544 <return-value transfer-ownership="container">
25132545 <doc xml:space="preserve"
25142546 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2541,7 +2573,7 @@ pixbuf was created from read-only data.
25412573
25422574 Please see the section on [image data](class.Pixbuf.html#image-data) for information
25432575 about how the pixel data is stored in memory.</doc>
2544- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="182"/>
2576+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="180"/>
25452577 <return-value transfer-ownership="none">
25462578 <doc xml:space="preserve"
25472579 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2572,7 +2604,7 @@ pixbuf was created from read-only data.
25722604
25732605 Please see the section on [image data](class.Pixbuf.html#image-data) for information
25742606 about how the pixel data is stored in memory.</doc>
2575- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="193"/>
2607+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="191"/>
25762608 <return-value transfer-ownership="none">
25772609 <doc xml:space="preserve"
25782610 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2607,7 +2639,7 @@ pixel data.</doc>
26072639 filename="gdk-pixbuf/gdk-pixbuf.c"
26082640 line="991">Queries the rowstride of a pixbuf, which is the number of bytes between
26092641 the start of a row and the start of the next row.</doc>
2610- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="188"/>
2642+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="186"/>
26112643 <return-value transfer-ownership="none">
26122644 <doc xml:space="preserve"
26132645 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2629,7 +2661,7 @@ the start of a row and the start of the next row.</doc>
26292661 <doc xml:space="preserve"
26302662 filename="gdk-pixbuf/gdk-pixbuf.c"
26312663 line="959">Queries the width of a pixbuf.</doc>
2632- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="184"/>
2664+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="182"/>
26332665 <return-value transfer-ownership="none">
26342666 <doc xml:space="preserve"
26352667 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2657,7 +2689,7 @@ pixbuf is finalized.
26572689
26582690 Note that if `src_pixbuf` is read-only, this function will force it
26592691 to be mutable.</doc>
2660- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="222"/>
2692+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="220"/>
26612693 <return-value transfer-ownership="full">
26622694 <doc xml:space="preserve"
26632695 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2707,7 +2739,7 @@ must not be modified.
27072739
27082740 This function allows skipping the implicit copy that must be made
27092741 if gdk_pixbuf_get_pixels() is called on a read-only pixbuf.</doc>
2710- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="199"/>
2742+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="197"/>
27112743 <return-value transfer-ownership="full">
27122744 <doc xml:space="preserve"
27132745 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2735,7 +2767,7 @@ if gdk_pixbuf_get_pixels() is called on a read-only pixbuf.</doc>
27352767
27362768 This function allows skipping the implicit copy that must be made
27372769 if gdk_pixbuf_get_pixels() is called on a read-only pixbuf.</doc>
2738- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="197"/>
2770+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="195"/>
27392771 <return-value transfer-ownership="none">
27402772 <doc xml:space="preserve"
27412773 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2760,7 +2792,7 @@ if gdk_pixbuf_get_pixels() is called on a read-only pixbuf.</doc>
27602792 filename="gdk-pixbuf/gdk-pixbuf.c"
27612793 line="414">Adds a reference to a pixbuf.</doc>
27622794 <doc-deprecated xml:space="preserve">Use g_object_ref().</doc-deprecated>
2763- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="166"/>
2795+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="165"/>
27642796 <return-value>
27652797 <doc xml:space="preserve"
27662798 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2782,7 +2814,7 @@ if gdk_pixbuf_get_pixels() is called on a read-only pixbuf.</doc>
27822814 <doc xml:space="preserve"
27832815 filename="gdk-pixbuf/gdk-pixbuf.c"
27842816 line="1191">Removes the key/value pair option attached to a `GdkPixbuf`.</doc>
2785- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="513"/>
2817+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="508"/>
27862818 <return-value transfer-ownership="none">
27872819 <doc xml:space="preserve"
27882820 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -2854,7 +2886,7 @@ saturation is reduced (the image turns toward grayscale); if greater than
28542886
28552887 If `pixelate` is `TRUE`, then pixels are faded in a checkerboard pattern to
28562888 create a pixelated image.</doc>
2857- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="495"/>
2889+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="490"/>
28582890 <return-value transfer-ownership="none">
28592891 <type name="none" c:type="void"/>
28602892 </return-value>
@@ -2888,7 +2920,7 @@ create a pixelated image.</doc>
28882920 <method name="save" c:identifier="gdk_pixbuf_save" introspectable="0">
28892921 <doc xml:space="preserve"
28902922 filename="gdk-pixbuf/gdk-pixbuf-io.c"
2891- line="2416">Saves pixbuf to a file in format @type. By default, "jpeg", "png", "ico"
2923+ line="2510">Saves pixbuf to a file in format @type. By default, "jpeg", "png", "ico"
28922924 and "bmp" are possible file formats to save in, but more formats may be
28932925 installed. The list of all writable formats can be determined in the
28942926 following way:
@@ -2959,30 +2991,30 @@ TIFF images recognize:
29592991 ICO images can be saved in depth 16, 24, or 32, by using the "depth"
29602992 parameter. When the ICO saver is given "x_hot" and "y_hot" parameters,
29612993 it produces a CUR instead of an ICO.</doc>
2962- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="319"/>
2994+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="314"/>
29632995 <return-value transfer-ownership="none">
29642996 <doc xml:space="preserve"
29652997 filename="gdk-pixbuf/gdk-pixbuf-io.c"
2966- line="2496">`TRUE` on success, and `FALSE` otherwise</doc>
2998+ line="2590">`TRUE` on success, and `FALSE` otherwise</doc>
29672999 <type name="gboolean" c:type="gboolean"/>
29683000 </return-value>
29693001 <parameters>
29703002 <instance-parameter name="pixbuf" transfer-ownership="none">
29713003 <doc xml:space="preserve"
29723004 filename="gdk-pixbuf/gdk-pixbuf-io.c"
2973- line="2418">a `GdkPixbuf`.</doc>
3005+ line="2512">a `GdkPixbuf`.</doc>
29743006 <type name="Pixbuf" c:type="GdkPixbuf*"/>
29753007 </instance-parameter>
29763008 <parameter name="filename" transfer-ownership="none">
29773009 <doc xml:space="preserve"
29783010 filename="gdk-pixbuf/gdk-pixbuf-io.c"
2979- line="2419">name of file to save.</doc>
3011+ line="2513">name of file to save.</doc>
29803012 <type name="filename" c:type="const char*"/>
29813013 </parameter>
29823014 <parameter name="type" transfer-ownership="none">
29833015 <doc xml:space="preserve"
29843016 filename="gdk-pixbuf/gdk-pixbuf-io.c"
2985- line="2420">name of file format.</doc>
3017+ line="2514">name of file format.</doc>
29863018 <type name="utf8" c:type="const char*"/>
29873019 </parameter>
29883020 <parameter name="error"
@@ -2991,13 +3023,13 @@ it produces a CUR instead of an ICO.</doc>
29913023 allow-none="1">
29923024 <doc xml:space="preserve"
29933025 filename="gdk-pixbuf/gdk-pixbuf-io.c"
2994- line="2421">return location for error</doc>
3026+ line="2515">return location for error</doc>
29953027 <type name="GLib.Error" c:type="GError**"/>
29963028 </parameter>
29973029 <parameter name="..." transfer-ownership="none">
29983030 <doc xml:space="preserve"
29993031 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3000- line="2422">list of key-value save options, followed by `NULL`</doc>
3032+ line="2516">list of key-value save options, followed by `NULL`</doc>
30013033 <varargs/>
30023034 </parameter>
30033035 </parameters>
@@ -3008,7 +3040,7 @@ it produces a CUR instead of an ICO.</doc>
30083040 introspectable="0">
30093041 <doc xml:space="preserve"
30103042 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3011- line="2753">Saves pixbuf to a new buffer in format `type`, which is currently "jpeg",
3043+ line="2847">Saves pixbuf to a new buffer in format `type`, which is currently "jpeg",
30123044 "png", "tiff", "ico" or "bmp".
30133045
30143046 This is a convenience function that uses `gdk_pixbuf_save_to_callback()`
@@ -3022,18 +3054,18 @@ If @error is set, `FALSE` will be returned and @buffer will be set to
30223054 domain.
30233055
30243056 See `gdk_pixbuf_save()` for more details.</doc>
3025- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="392"/>
3057+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="387"/>
30263058 <return-value transfer-ownership="none">
30273059 <doc xml:space="preserve"
30283060 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3029- line="2778">whether an error was set</doc>
3061+ line="2872">whether an error was set</doc>
30303062 <type name="gboolean" c:type="gboolean"/>
30313063 </return-value>
30323064 <parameters>
30333065 <instance-parameter name="pixbuf" transfer-ownership="none">
30343066 <doc xml:space="preserve"
30353067 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3036- line="2755">a `GdkPixbuf`.</doc>
3068+ line="2849">a `GdkPixbuf`.</doc>
30373069 <type name="Pixbuf" c:type="GdkPixbuf*"/>
30383070 </instance-parameter>
30393071 <parameter name="buffer"
@@ -3042,7 +3074,7 @@ See `gdk_pixbuf_save()` for more details.</doc>
30423074 transfer-ownership="full">
30433075 <doc xml:space="preserve"
30443076 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3045- line="2756">location to receive a pointer
3077+ line="2850">location to receive a pointer
30463078 to the new buffer.</doc>
30473079 <array length="1" zero-terminated="0" c:type="gchar**">
30483080 <type name="guint8"/>
@@ -3054,28 +3086,25 @@ See `gdk_pixbuf_save()` for more details.</doc>
30543086 transfer-ownership="full">
30553087 <doc xml:space="preserve"
30563088 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3057- line="2758">location to receive the size of the new buffer.</doc>
3089+ line="2852">location to receive the size of the new buffer.</doc>
30583090 <type name="gsize" c:type="gsize*"/>
30593091 </parameter>
30603092 <parameter name="type" transfer-ownership="none">
30613093 <doc xml:space="preserve"
30623094 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3063- line="2759">name of file format.</doc>
3095+ line="2853">name of file format.</doc>
30643096 <type name="utf8" c:type="const char*"/>
30653097 </parameter>
3066- <parameter name="error"
3067- transfer-ownership="none"
3068- nullable="1"
3069- allow-none="1">
3098+ <parameter name="error" transfer-ownership="none">
30703099 <doc xml:space="preserve"
30713100 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3072- line="2760">return location for error, or `NULL`</doc>
3101+ line="2854">return location for error, or `NULL`</doc>
30733102 <type name="GLib.Error" c:type="GError**"/>
30743103 </parameter>
30753104 <parameter name="..." transfer-ownership="none">
30763105 <doc xml:space="preserve"
30773106 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3078- line="2761">list of key-value save options</doc>
3107+ line="2855">list of key-value save options</doc>
30793108 <varargs/>
30803109 </parameter>
30813110 </parameters>
@@ -3086,24 +3115,24 @@ See `gdk_pixbuf_save()` for more details.</doc>
30863115 throws="1">
30873116 <doc xml:space="preserve"
30883117 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3089- line="2846">Vector version of `gdk_pixbuf_save_to_buffer()`.
3118+ line="2940">Vector version of `gdk_pixbuf_save_to_buffer()`.
30903119
30913120 Saves pixbuf to a new buffer in format @type, which is currently "jpeg",
30923121 "tiff", "png", "ico" or "bmp".
30933122
30943123 See [method@GdkPixbuf.Pixbuf.save_to_buffer] for more details.</doc>
3095- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="400"/>
3124+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="395"/>
30963125 <return-value transfer-ownership="none">
30973126 <doc xml:space="preserve"
30983127 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3099- line="2864">whether an error was set</doc>
3128+ line="2958">whether an error was set</doc>
31003129 <type name="gboolean" c:type="gboolean"/>
31013130 </return-value>
31023131 <parameters>
31033132 <instance-parameter name="pixbuf" transfer-ownership="none">
31043133 <doc xml:space="preserve"
31053134 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3106- line="2848">a `GdkPixbuf`.</doc>
3135+ line="2942">a `GdkPixbuf`.</doc>
31073136 <type name="Pixbuf" c:type="GdkPixbuf*"/>
31083137 </instance-parameter>
31093138 <parameter name="buffer"
@@ -3112,7 +3141,7 @@ See [method@GdkPixbuf.Pixbuf.save_to_buffer] for more details.</doc>
31123141 transfer-ownership="full">
31133142 <doc xml:space="preserve"
31143143 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3115- line="2849">
3144+ line="2943">
31163145 location to receive a pointer to the new buffer.</doc>
31173146 <array length="1" zero-terminated="0" c:type="gchar**">
31183147 <type name="guint8"/>
@@ -3124,13 +3153,13 @@ See [method@GdkPixbuf.Pixbuf.save_to_buffer] for more details.</doc>
31243153 transfer-ownership="full">
31253154 <doc xml:space="preserve"
31263155 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3127- line="2851">location to receive the size of the new buffer.</doc>
3156+ line="2945">location to receive the size of the new buffer.</doc>
31283157 <type name="gsize" c:type="gsize*"/>
31293158 </parameter>
31303159 <parameter name="type" transfer-ownership="none">
31313160 <doc xml:space="preserve"
31323161 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3133- line="2852">name of file format.</doc>
3162+ line="2946">name of file format.</doc>
31343163 <type name="utf8" c:type="const char*"/>
31353164 </parameter>
31363165 <parameter name="option_keys"
@@ -3139,7 +3168,7 @@ See [method@GdkPixbuf.Pixbuf.save_to_buffer] for more details.</doc>
31393168 allow-none="1">
31403169 <doc xml:space="preserve"
31413170 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3142- line="2853">name of options to set</doc>
3171+ line="2947">name of options to set</doc>
31433172 <array c:type="char**">
31443173 <type name="utf8"/>
31453174 </array>
@@ -3150,7 +3179,7 @@ See [method@GdkPixbuf.Pixbuf.save_to_buffer] for more details.</doc>
31503179 allow-none="1">
31513180 <doc xml:space="preserve"
31523181 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3153- line="2854">values for named options</doc>
3182+ line="2948">values for named options</doc>
31543183 <array c:type="char**">
31553184 <type name="utf8"/>
31563185 </array>
@@ -3163,7 +3192,7 @@ See [method@GdkPixbuf.Pixbuf.save_to_buffer] for more details.</doc>
31633192 introspectable="0">
31643193 <doc xml:space="preserve"
31653194 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3166- line="2640">Saves pixbuf in format `type` by feeding the produced data to a
3195+ line="2734">Saves pixbuf in format `type` by feeding the produced data to a
31673196 callback.
31683197
31693198 This function can be used when you want to store the image to something
@@ -3174,18 +3203,18 @@ include those in the `GDK_PIXBUF_ERROR` domain and whatever the save
31743203 function generates.
31753204
31763205 See [method@GdkPixbuf.Pixbuf.save] for more details.</doc>
3177- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="373"/>
3206+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="368"/>
31783207 <return-value transfer-ownership="none">
31793208 <doc xml:space="preserve"
31803209 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3181- line="2662">whether an error was set</doc>
3210+ line="2756">whether an error was set</doc>
31823211 <type name="gboolean" c:type="gboolean"/>
31833212 </return-value>
31843213 <parameters>
31853214 <instance-parameter name="pixbuf" transfer-ownership="none">
31863215 <doc xml:space="preserve"
31873216 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3188- line="2642">a `GdkPixbuf`.</doc>
3217+ line="2736">a `GdkPixbuf`.</doc>
31893218 <type name="Pixbuf" c:type="GdkPixbuf*"/>
31903219 </instance-parameter>
31913220 <parameter name="save_func"
@@ -3194,7 +3223,7 @@ See [method@GdkPixbuf.Pixbuf.save] for more details.</doc>
31943223 closure="1">
31953224 <doc xml:space="preserve"
31963225 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3197- line="2643">a function that is called to save each block of data that
3226+ line="2737">a function that is called to save each block of data that
31983227 the save routine generates.</doc>
31993228 <type name="PixbufSaveFunc" c:type="GdkPixbufSaveFunc"/>
32003229 </parameter>
@@ -3204,13 +3233,13 @@ See [method@GdkPixbuf.Pixbuf.save] for more details.</doc>
32043233 allow-none="1">
32053234 <doc xml:space="preserve"
32063235 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3207- line="2645">user data to pass to the save function.</doc>
3236+ line="2739">user data to pass to the save function.</doc>
32083237 <type name="gpointer" c:type="gpointer"/>
32093238 </parameter>
32103239 <parameter name="type" transfer-ownership="none">
32113240 <doc xml:space="preserve"
32123241 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3213- line="2646">name of file format.</doc>
3242+ line="2740">name of file format.</doc>
32143243 <type name="utf8" c:type="const char*"/>
32153244 </parameter>
32163245 <parameter name="error"
@@ -3219,13 +3248,13 @@ See [method@GdkPixbuf.Pixbuf.save] for more details.</doc>
32193248 allow-none="1">
32203249 <doc xml:space="preserve"
32213250 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3222- line="2647">return location for error, or `NULL`</doc>
3251+ line="2741">return location for error, or `NULL`</doc>
32233252 <type name="GLib.Error" c:type="GError**"/>
32243253 </parameter>
32253254 <parameter name="..." transfer-ownership="none">
32263255 <doc xml:space="preserve"
32273256 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3228- line="2648">list of key-value save options</doc>
3257+ line="2742">list of key-value save options</doc>
32293258 <varargs/>
32303259 </parameter>
32313260 </parameters>
@@ -3236,7 +3265,7 @@ See [method@GdkPixbuf.Pixbuf.save] for more details.</doc>
32363265 throws="1">
32373266 <doc xml:space="preserve"
32383267 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3239- line="2697">Vector version of `gdk_pixbuf_save_to_callback()`.
3268+ line="2791">Vector version of `gdk_pixbuf_save_to_callback()`.
32403269
32413270 Saves pixbuf to a callback in format @type, which is currently "jpeg",
32423271 "png", "tiff", "ico" or "bmp".
@@ -3244,18 +3273,18 @@ Saves pixbuf to a callback in format @type, which is currently "jpeg",
32443273 If @error is set, `FALSE` will be returned.
32453274
32463275 See [method@GdkPixbuf.Pixbuf.save_to_callback] for more details.</doc>
3247- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="381"/>
3276+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="376"/>
32483277 <return-value transfer-ownership="none">
32493278 <doc xml:space="preserve"
32503279 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3251- line="2717">whether an error was set</doc>
3280+ line="2811">whether an error was set</doc>
32523281 <type name="gboolean" c:type="gboolean"/>
32533282 </return-value>
32543283 <parameters>
32553284 <instance-parameter name="pixbuf" transfer-ownership="none">
32563285 <doc xml:space="preserve"
32573286 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3258- line="2699">a `GdkPixbuf`.</doc>
3287+ line="2793">a `GdkPixbuf`</doc>
32593288 <type name="Pixbuf" c:type="GdkPixbuf*"/>
32603289 </instance-parameter>
32613290 <parameter name="save_func"
@@ -3264,8 +3293,8 @@ See [method@GdkPixbuf.Pixbuf.save_to_callback] for more details.</doc>
32643293 closure="1">
32653294 <doc xml:space="preserve"
32663295 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3267- line="2700">a function that is called to save each block of data that
3268- the save routine generates.</doc>
3296+ line="2794">a function that is called to
3297+ save each block of data that the save routine generates</doc>
32693298 <type name="PixbufSaveFunc" c:type="GdkPixbufSaveFunc"/>
32703299 </parameter>
32713300 <parameter name="user_data"
@@ -3274,13 +3303,13 @@ See [method@GdkPixbuf.Pixbuf.save_to_callback] for more details.</doc>
32743303 allow-none="1">
32753304 <doc xml:space="preserve"
32763305 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3277- line="2702">user data to pass to the save function.</doc>
3306+ line="2796">user data to pass to the save function</doc>
32783307 <type name="gpointer" c:type="gpointer"/>
32793308 </parameter>
32803309 <parameter name="type" transfer-ownership="none">
32813310 <doc xml:space="preserve"
32823311 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3283- line="2703">name of file format.</doc>
3312+ line="2797">name of file format</doc>
32843313 <type name="utf8" c:type="const char*"/>
32853314 </parameter>
32863315 <parameter name="option_keys"
@@ -3289,7 +3318,7 @@ See [method@GdkPixbuf.Pixbuf.save_to_callback] for more details.</doc>
32893318 allow-none="1">
32903319 <doc xml:space="preserve"
32913320 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3292- line="2704">name of options to set</doc>
3321+ line="2798">name of options to set</doc>
32933322 <array c:type="char**">
32943323 <type name="utf8"/>
32953324 </array>
@@ -3300,7 +3329,7 @@ See [method@GdkPixbuf.Pixbuf.save_to_callback] for more details.</doc>
33003329 allow-none="1">
33013330 <doc xml:space="preserve"
33023331 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3303- line="2705">values for named options</doc>
3332+ line="2799">values for named options</doc>
33043333 <array c:type="char**">
33053334 <type name="utf8"/>
33063335 </array>
@@ -3313,7 +3342,7 @@ See [method@GdkPixbuf.Pixbuf.save_to_callback] for more details.</doc>
33133342 introspectable="0">
33143343 <doc xml:space="preserve"
33153344 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3316- line="2990">Saves `pixbuf` to an output stream.
3345+ line="3084">Saves `pixbuf` to an output stream.
33173346
33183347 Supported file formats are currently "jpeg", "tiff", "png", "ico" or
33193348 "bmp". See `gdk_pixbuf_save_to_buffer()` for more details.
@@ -3324,11 +3353,11 @@ will be returned. Other possible errors are in the `GDK_PIXBUF_ERROR`
33243353 and `G_IO_ERROR` domains.
33253354
33263355 The stream is not closed at the end of this call.</doc>
3327- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="441"/>
3356+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="436"/>
33283357 <return-value transfer-ownership="none">
33293358 <doc xml:space="preserve"
33303359 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3331- line="3011">`TRUE` if the pixbuf was saved successfully, `FALSE` if an
3360+ line="3105">`TRUE` if the pixbuf was saved successfully, `FALSE` if an
33323361 error was set.</doc>
33333362 <type name="gboolean" c:type="gboolean"/>
33343363 </return-value>
@@ -3336,19 +3365,19 @@ The stream is not closed at the end of this call.</doc>
33363365 <instance-parameter name="pixbuf" transfer-ownership="none">
33373366 <doc xml:space="preserve"
33383367 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3339- line="2992">a `GdkPixbuf`</doc>
3368+ line="3086">a `GdkPixbuf`</doc>
33403369 <type name="Pixbuf" c:type="GdkPixbuf*"/>
33413370 </instance-parameter>
33423371 <parameter name="stream" transfer-ownership="none">
33433372 <doc xml:space="preserve"
33443373 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3345- line="2993">a `GOutputStream` to save the pixbuf to</doc>
3374+ line="3087">a `GOutputStream` to save the pixbuf to</doc>
33463375 <type name="Gio.OutputStream" c:type="GOutputStream*"/>
33473376 </parameter>
33483377 <parameter name="type" transfer-ownership="none">
33493378 <doc xml:space="preserve"
33503379 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3351- line="2994">name of file format</doc>
3380+ line="3088">name of file format</doc>
33523381 <type name="utf8" c:type="const char*"/>
33533382 </parameter>
33543383 <parameter name="cancellable"
@@ -3357,7 +3386,7 @@ The stream is not closed at the end of this call.</doc>
33573386 allow-none="1">
33583387 <doc xml:space="preserve"
33593388 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3360- line="2995">optional `GCancellable` object, `NULL` to ignore</doc>
3389+ line="3089">optional `GCancellable` object, `NULL` to ignore</doc>
33613390 <type name="Gio.Cancellable" c:type="GCancellable*"/>
33623391 </parameter>
33633392 <parameter name="error"
@@ -3366,13 +3395,13 @@ The stream is not closed at the end of this call.</doc>
33663395 allow-none="1">
33673396 <doc xml:space="preserve"
33683397 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3369- line="2996">return location for error, or `NULL`</doc>
3398+ line="3090">return location for error, or `NULL`</doc>
33703399 <type name="GLib.Error" c:type="GError**"/>
33713400 </parameter>
33723401 <parameter name="..." transfer-ownership="none">
33733402 <doc xml:space="preserve"
33743403 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3375- line="2997">list of key-value save options</doc>
3404+ line="3091">list of key-value save options</doc>
33763405 <varargs/>
33773406 </parameter>
33783407 </parameters>
@@ -3380,10 +3409,11 @@ The stream is not closed at the end of this call.</doc>
33803409 <method name="save_to_stream_async"
33813410 c:identifier="gdk_pixbuf_save_to_stream_async"
33823411 version="2.24"
3383- introspectable="0">
3412+ introspectable="0"
3413+ glib:finish-func="gdk_pixbuf_save_to_stream_finish">
33843414 <doc xml:space="preserve"
33853415 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3386- line="3144">Saves `pixbuf` to an output stream asynchronously.
3416+ line="3238">Saves `pixbuf` to an output stream asynchronously.
33873417
33883418 For more details see gdk_pixbuf_save_to_stream(), which is the synchronous
33893419 version of this function.
@@ -3392,7 +3422,7 @@ When the operation is finished, `callback` will be called in the main thread.
33923422
33933423 You can then call gdk_pixbuf_save_to_stream_finish() to get the result of
33943424 the operation.</doc>
3395- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="449"/>
3425+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="444"/>
33963426 <return-value transfer-ownership="none">
33973427 <type name="none" c:type="void"/>
33983428 </return-value>
@@ -3400,19 +3430,19 @@ the operation.</doc>
34003430 <instance-parameter name="pixbuf" transfer-ownership="none">
34013431 <doc xml:space="preserve"
34023432 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3403- line="3146">a `GdkPixbuf`</doc>
3433+ line="3240">a `GdkPixbuf`</doc>
34043434 <type name="Pixbuf" c:type="GdkPixbuf*"/>
34053435 </instance-parameter>
34063436 <parameter name="stream" transfer-ownership="none">
34073437 <doc xml:space="preserve"
34083438 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3409- line="3147">a `GOutputStream` to which to save the pixbuf</doc>
3439+ line="3241">a `GOutputStream` to which to save the pixbuf</doc>
34103440 <type name="Gio.OutputStream" c:type="GOutputStream*"/>
34113441 </parameter>
34123442 <parameter name="type" transfer-ownership="none">
34133443 <doc xml:space="preserve"
34143444 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3415- line="3148">name of file format</doc>
3445+ line="3242">name of file format</doc>
34163446 <type name="utf8" c:type="const gchar*"/>
34173447 </parameter>
34183448 <parameter name="cancellable"
@@ -3421,7 +3451,7 @@ the operation.</doc>
34213451 allow-none="1">
34223452 <doc xml:space="preserve"
34233453 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3424- line="3149">optional `GCancellable` object, `NULL` to ignore</doc>
3454+ line="3243">optional `GCancellable` object, `NULL` to ignore</doc>
34253455 <type name="Gio.Cancellable" c:type="GCancellable*"/>
34263456 </parameter>
34273457 <parameter name="callback"
@@ -3432,7 +3462,7 @@ the operation.</doc>
34323462 closure="4">
34333463 <doc xml:space="preserve"
34343464 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3435- line="3150">a `GAsyncReadyCallback` to call when the pixbuf is saved</doc>
3465+ line="3244">a `GAsyncReadyCallback` to call when the pixbuf is saved</doc>
34363466 <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
34373467 </parameter>
34383468 <parameter name="user_data"
@@ -3441,13 +3471,13 @@ the operation.</doc>
34413471 allow-none="1">
34423472 <doc xml:space="preserve"
34433473 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3444- line="3151">the data to pass to the callback function</doc>
3474+ line="3245">the data to pass to the callback function</doc>
34453475 <type name="gpointer" c:type="gpointer"/>
34463476 </parameter>
34473477 <parameter name="..." transfer-ownership="none">
34483478 <doc xml:space="preserve"
34493479 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3450- line="3152">list of key-value save options</doc>
3480+ line="3246">list of key-value save options</doc>
34513481 <varargs/>
34523482 </parameter>
34533483 </parameters>
@@ -3458,17 +3488,17 @@ the operation.</doc>
34583488 throws="1">
34593489 <doc xml:space="preserve"
34603490 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3461- line="2948">Saves `pixbuf` to an output stream.
3491+ line="3042">Saves `pixbuf` to an output stream.
34623492
34633493 Supported file formats are currently "jpeg", "tiff", "png", "ico" or
34643494 "bmp".
34653495
34663496 See [method@GdkPixbuf.Pixbuf.save_to_stream] for more details.</doc>
3467- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="472"/>
3497+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="467"/>
34683498 <return-value transfer-ownership="none">
34693499 <doc xml:space="preserve"
34703500 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3471- line="2965">`TRUE` if the pixbuf was saved successfully, `FALSE` if an
3501+ line="3059">`TRUE` if the pixbuf was saved successfully, `FALSE` if an
34723502 error was set.</doc>
34733503 <type name="gboolean" c:type="gboolean"/>
34743504 </return-value>
@@ -3476,19 +3506,19 @@ See [method@GdkPixbuf.Pixbuf.save_to_stream] for more details.</doc>
34763506 <instance-parameter name="pixbuf" transfer-ownership="none">
34773507 <doc xml:space="preserve"
34783508 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3479- line="2950">a `GdkPixbuf`</doc>
3509+ line="3044">a `GdkPixbuf`</doc>
34803510 <type name="Pixbuf" c:type="GdkPixbuf*"/>
34813511 </instance-parameter>
34823512 <parameter name="stream" transfer-ownership="none">
34833513 <doc xml:space="preserve"
34843514 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3485- line="2951">a `GOutputStream` to save the pixbuf to</doc>
3515+ line="3045">a `GOutputStream` to save the pixbuf to</doc>
34863516 <type name="Gio.OutputStream" c:type="GOutputStream*"/>
34873517 </parameter>
34883518 <parameter name="type" transfer-ownership="none">
34893519 <doc xml:space="preserve"
34903520 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3491- line="2952">name of file format</doc>
3521+ line="3046">name of file format</doc>
34923522 <type name="utf8" c:type="const char*"/>
34933523 </parameter>
34943524 <parameter name="option_keys"
@@ -3497,7 +3527,7 @@ See [method@GdkPixbuf.Pixbuf.save_to_stream] for more details.</doc>
34973527 allow-none="1">
34983528 <doc xml:space="preserve"
34993529 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3500- line="2953">name of options to set</doc>
3530+ line="3047">name of options to set</doc>
35013531 <array c:type="char**">
35023532 <type name="utf8"/>
35033533 </array>
@@ -3508,7 +3538,7 @@ See [method@GdkPixbuf.Pixbuf.save_to_stream] for more details.</doc>
35083538 allow-none="1">
35093539 <doc xml:space="preserve"
35103540 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3511- line="2954">values for named options</doc>
3541+ line="3048">values for named options</doc>
35123542 <array c:type="char**">
35133543 <type name="utf8"/>
35143544 </array>
@@ -3519,17 +3549,18 @@ See [method@GdkPixbuf.Pixbuf.save_to_stream] for more details.</doc>
35193549 allow-none="1">
35203550 <doc xml:space="preserve"
35213551 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3522- line="2955">optional `GCancellable` object, `NULL` to ignore</doc>
3552+ line="3049">optional `GCancellable` object, `NULL` to ignore</doc>
35233553 <type name="Gio.Cancellable" c:type="GCancellable*"/>
35243554 </parameter>
35253555 </parameters>
35263556 </method>
35273557 <method name="save_to_streamv_async"
35283558 c:identifier="gdk_pixbuf_save_to_streamv_async"
3529- version="2.36">
3559+ version="2.36"
3560+ glib:finish-func="gdk_pixbuf_save_to_stream_finish">
35303561 <doc xml:space="preserve"
35313562 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3532- line="3086">Saves `pixbuf` to an output stream asynchronously.
3563+ line="3180">Saves `pixbuf` to an output stream asynchronously.
35333564
35343565 For more details see gdk_pixbuf_save_to_streamv(), which is the synchronous
35353566 version of this function.
@@ -3538,7 +3569,7 @@ When the operation is finished, `callback` will be called in the main thread.
35383569
35393570 You can then call gdk_pixbuf_save_to_stream_finish() to get the result of
35403571 the operation.</doc>
3541- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="462"/>
3572+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="457"/>
35423573 <return-value transfer-ownership="none">
35433574 <type name="none" c:type="void"/>
35443575 </return-value>
@@ -3546,19 +3577,19 @@ the operation.</doc>
35463577 <instance-parameter name="pixbuf" transfer-ownership="none">
35473578 <doc xml:space="preserve"
35483579 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3549- line="3088">a `GdkPixbuf`</doc>
3580+ line="3182">a `GdkPixbuf`</doc>
35503581 <type name="Pixbuf" c:type="GdkPixbuf*"/>
35513582 </instance-parameter>
35523583 <parameter name="stream" transfer-ownership="none">
35533584 <doc xml:space="preserve"
35543585 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3555- line="3089">a `GOutputStream` to which to save the pixbuf</doc>
3586+ line="3183">a `GOutputStream` to which to save the pixbuf</doc>
35563587 <type name="Gio.OutputStream" c:type="GOutputStream*"/>
35573588 </parameter>
35583589 <parameter name="type" transfer-ownership="none">
35593590 <doc xml:space="preserve"
35603591 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3561- line="3090">name of file format</doc>
3592+ line="3184">name of file format</doc>
35623593 <type name="utf8" c:type="const gchar*"/>
35633594 </parameter>
35643595 <parameter name="option_keys"
@@ -3567,7 +3598,7 @@ the operation.</doc>
35673598 allow-none="1">
35683599 <doc xml:space="preserve"
35693600 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3570- line="3091">name of options to set</doc>
3601+ line="3185">name of options to set</doc>
35713602 <array c:type="gchar**">
35723603 <type name="utf8"/>
35733604 </array>
@@ -3578,7 +3609,7 @@ the operation.</doc>
35783609 allow-none="1">
35793610 <doc xml:space="preserve"
35803611 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3581- line="3092">values for named options</doc>
3612+ line="3186">values for named options</doc>
35823613 <array c:type="gchar**">
35833614 <type name="utf8"/>
35843615 </array>
@@ -3589,7 +3620,7 @@ the operation.</doc>
35893620 allow-none="1">
35903621 <doc xml:space="preserve"
35913622 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3592- line="3093">optional `GCancellable` object, `NULL` to ignore</doc>
3623+ line="3187">optional `GCancellable` object, `NULL` to ignore</doc>
35933624 <type name="Gio.Cancellable" c:type="GCancellable*"/>
35943625 </parameter>
35953626 <parameter name="callback"
@@ -3600,7 +3631,7 @@ the operation.</doc>
36003631 closure="6">
36013632 <doc xml:space="preserve"
36023633 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3603- line="3094">a `GAsyncReadyCallback` to call when the pixbuf is saved</doc>
3634+ line="3188">a `GAsyncReadyCallback` to call when the pixbuf is saved</doc>
36043635 <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
36053636 </parameter>
36063637 <parameter name="user_data"
@@ -3609,7 +3640,7 @@ the operation.</doc>
36093640 allow-none="1">
36103641 <doc xml:space="preserve"
36113642 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3612- line="3095">the data to pass to the callback function</doc>
3643+ line="3189">the data to pass to the callback function</doc>
36133644 <type name="gpointer" c:type="gpointer"/>
36143645 </parameter>
36153646 </parameters>
@@ -3617,37 +3648,37 @@ the operation.</doc>
36173648 <method name="savev" c:identifier="gdk_pixbuf_savev" throws="1">
36183649 <doc xml:space="preserve"
36193650 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3620- line="2528">Vector version of `gdk_pixbuf_save()`.
3651+ line="2622">Vector version of `gdk_pixbuf_save()`.
36213652
36223653 Saves pixbuf to a file in `type`, which is currently "jpeg", "png", "tiff", "ico" or "bmp".
36233654
36243655 If @error is set, `FALSE` will be returned.
36253656
36263657 See [method@GdkPixbuf.Pixbuf.save] for more details.</doc>
3627- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="326"/>
3658+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="321"/>
36283659 <return-value transfer-ownership="none">
36293660 <doc xml:space="preserve"
36303661 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3631- line="2545">whether an error was set</doc>
3662+ line="2639">whether an error was set</doc>
36323663 <type name="gboolean" c:type="gboolean"/>
36333664 </return-value>
36343665 <parameters>
36353666 <instance-parameter name="pixbuf" transfer-ownership="none">
36363667 <doc xml:space="preserve"
36373668 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3638- line="2530">a `GdkPixbuf`.</doc>
3669+ line="2624">a `GdkPixbuf`.</doc>
36393670 <type name="Pixbuf" c:type="GdkPixbuf*"/>
36403671 </instance-parameter>
36413672 <parameter name="filename" transfer-ownership="none">
36423673 <doc xml:space="preserve"
36433674 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3644- line="2531">name of file to save.</doc>
3675+ line="2625">name of file to save.</doc>
36453676 <type name="filename" c:type="const char*"/>
36463677 </parameter>
36473678 <parameter name="type" transfer-ownership="none">
36483679 <doc xml:space="preserve"
36493680 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3650- line="2532">name of file format.</doc>
3681+ line="2626">name of file format.</doc>
36513682 <type name="utf8" c:type="const char*"/>
36523683 </parameter>
36533684 <parameter name="option_keys"
@@ -3656,7 +3687,7 @@ See [method@GdkPixbuf.Pixbuf.save] for more details.</doc>
36563687 allow-none="1">
36573688 <doc xml:space="preserve"
36583689 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3659- line="2533">name of options to set</doc>
3690+ line="2627">name of options to set</doc>
36603691 <array c:type="char**">
36613692 <type name="utf8"/>
36623693 </array>
@@ -3667,7 +3698,7 @@ See [method@GdkPixbuf.Pixbuf.save] for more details.</doc>
36673698 allow-none="1">
36683699 <doc xml:space="preserve"
36693700 filename="gdk-pixbuf/gdk-pixbuf-io.c"
3670- line="2534">values for named options</doc>
3701+ line="2628">values for named options</doc>
36713702 <array c:type="char**">
36723703 <type name="utf8"/>
36733704 </array>
@@ -3829,7 +3860,7 @@ and [method@GdkPixbuf.Pixbuf.composite].</doc>
38293860
38303861 If `key` already exists in the list of options attached to the `pixbuf`,
38313862 the new value is ignored and `FALSE` is returned.</doc>
3832- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="506"/>
3863+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="501"/>
38333864 <return-value transfer-ownership="none">
38343865 <doc xml:space="preserve"
38353866 filename="gdk-pixbuf/gdk-pixbuf.c"
@@ -3866,7 +3897,7 @@ the new value is ignored and `FALSE` is returned.</doc>
38663897 filename="gdk-pixbuf/gdk-pixbuf.c"
38673898 line="430">Removes a reference from a pixbuf.</doc>
38683899 <doc-deprecated xml:space="preserve">Use g_object_unref().</doc-deprecated>
3869- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="168"/>
3900+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="167"/>
38703901 <return-value transfer-ownership="none">
38713902 <type name="none" c:type="void"/>
38723903 </return-value>
@@ -4038,7 +4069,7 @@ For now both cases fall back to a bilevel clipping mask.</doc>
40384069 glib:type-struct="PixbufAnimationClass">
40394070 <doc xml:space="preserve"
40404071 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4041- line="32">An opaque object representing an animation.
4072+ line="34">An opaque object representing an animation.
40424073
40434074 The GdkPixBuf library provides a simple mechanism to load and
40444075 represent animations. An animation is conceptually a series of
@@ -4052,13 +4083,13 @@ To display an animation you don't need to understand its
40524083 representation, however; you just ask `GdkPixbuf` what should
40534084 be displayed at a given point in time.</doc>
40544085 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4055- line="163"/>
4086+ line="160"/>
40564087 <constructor name="new_from_file"
40574088 c:identifier="gdk_pixbuf_animation_new_from_file"
40584089 throws="1">
40594090 <doc xml:space="preserve"
40604091 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4061- line="147">Creates a new animation by loading it from a file.
4092+ line="146">Creates a new animation by loading it from a file.
40624093
40634094 The file format is detected automatically.
40644095
@@ -4071,14 +4102,14 @@ Possible errors are in the `GDK_PIXBUF_ERROR` and `G_FILE_ERROR` domains.</doc>
40714102 <return-value transfer-ownership="full" nullable="1">
40724103 <doc xml:space="preserve"
40734104 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4074- line="162">A newly-created animation</doc>
4105+ line="161">A newly-created animation</doc>
40754106 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
40764107 </return-value>
40774108 <parameters>
40784109 <parameter name="filename" transfer-ownership="none">
40794110 <doc xml:space="preserve"
40804111 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4081- line="149">Name of file to load, in the GLib file
4112+ line="148">Name of file to load, in the GLib file
40824113 name encoding</doc>
40834114 <type name="filename" c:type="const char*"/>
40844115 </parameter>
@@ -4090,7 +4121,7 @@ Possible errors are in the `GDK_PIXBUF_ERROR` and `G_FILE_ERROR` domains.</doc>
40904121 throws="1">
40914122 <doc xml:space="preserve"
40924123 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4093- line="504">Creates a new pixbuf animation by loading an image from an resource.
4124+ line="503">Creates a new pixbuf animation by loading an image from an resource.
40944125
40954126 The file format is detected automatically. If `NULL` is returned, then
40964127 @error will be set.</doc>
@@ -4099,14 +4130,14 @@ The file format is detected automatically. If `NULL` is returned, then
40994130 <return-value transfer-ownership="full" nullable="1">
41004131 <doc xml:space="preserve"
41014132 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4102- line="514">A newly-created animation</doc>
4133+ line="513">A newly-created animation</doc>
41034134 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
41044135 </return-value>
41054136 <parameters>
41064137 <parameter name="resource_path" transfer-ownership="none">
41074138 <doc xml:space="preserve"
41084139 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4109- line="506">the path of the resource file</doc>
4140+ line="505">the path of the resource file</doc>
41104141 <type name="utf8" c:type="const char*"/>
41114142 </parameter>
41124143 </parameters>
@@ -4117,7 +4148,7 @@ The file format is detected automatically. If `NULL` is returned, then
41174148 throws="1">
41184149 <doc xml:space="preserve"
41194150 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4120- line="346">Creates a new animation by loading it from an input stream.
4151+ line="345">Creates a new animation by loading it from an input stream.
41214152
41224153 The file format is detected automatically.
41234154
@@ -4134,14 +4165,14 @@ The stream is not closed.</doc>
41344165 <return-value transfer-ownership="full" nullable="1">
41354166 <doc xml:space="preserve"
41364167 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4137- line="365">A newly-created animation</doc>
4168+ line="364">A newly-created animation</doc>
41384169 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
41394170 </return-value>
41404171 <parameters>
41414172 <parameter name="stream" transfer-ownership="none">
41424173 <doc xml:space="preserve"
41434174 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4144- line="348">a `GInputStream` to load the pixbuf from</doc>
4175+ line="347">a `GInputStream` to load the pixbuf from</doc>
41454176 <type name="Gio.InputStream" c:type="GInputStream*"/>
41464177 </parameter>
41474178 <parameter name="cancellable"
@@ -4150,7 +4181,7 @@ The stream is not closed.</doc>
41504181 allow-none="1">
41514182 <doc xml:space="preserve"
41524183 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4153- line="349">optional `GCancellable` object</doc>
4184+ line="348">optional `GCancellable` object</doc>
41544185 <type name="Gio.Cancellable" c:type="GCancellable*"/>
41554186 </parameter>
41564187 </parameters>
@@ -4161,21 +4192,21 @@ The stream is not closed.</doc>
41614192 throws="1">
41624193 <doc xml:space="preserve"
41634194 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4164- line="479">Finishes an asynchronous pixbuf animation creation operation started with
4195+ line="478">Finishes an asynchronous pixbuf animation creation operation started with
41654196 [func@GdkPixbuf.PixbufAnimation.new_from_stream_async].</doc>
41664197 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
41674198 line="75"/>
41684199 <return-value transfer-ownership="full" nullable="1">
41694200 <doc xml:space="preserve"
41704201 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4171- line="487">the newly created animation</doc>
4202+ line="486">the newly created animation</doc>
41724203 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
41734204 </return-value>
41744205 <parameters>
41754206 <parameter name="async_result" transfer-ownership="none">
41764207 <doc xml:space="preserve"
41774208 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4178- line="481">a #GAsyncResult</doc>
4209+ line="480">a #GAsyncResult</doc>
41794210 <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
41804211 </parameter>
41814212 </parameters>
@@ -4186,7 +4217,7 @@ The stream is not closed.</doc>
41864217 glib:finish-func="new_from_stream_finish">
41874218 <doc xml:space="preserve"
41884219 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4189- line="443">Creates a new animation by asynchronously loading an image from an input stream.
4220+ line="442">Creates a new animation by asynchronously loading an image from an input stream.
41904221
41914222 For more details see gdk_pixbuf_new_from_stream(), which is the synchronous
41924223 version of this function.
@@ -4203,7 +4234,7 @@ result of the operation.</doc>
42034234 <parameter name="stream" transfer-ownership="none">
42044235 <doc xml:space="preserve"
42054236 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4206- line="445">a #GInputStream from which to load the animation</doc>
4237+ line="444">a #GInputStream from which to load the animation</doc>
42074238 <type name="Gio.InputStream" c:type="GInputStream*"/>
42084239 </parameter>
42094240 <parameter name="cancellable"
@@ -4212,7 +4243,7 @@ result of the operation.</doc>
42124243 allow-none="1">
42134244 <doc xml:space="preserve"
42144245 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4215- line="446">optional #GCancellable object</doc>
4246+ line="445">optional #GCancellable object</doc>
42164247 <type name="Gio.Cancellable" c:type="GCancellable*"/>
42174248 </parameter>
42184249 <parameter name="callback"
@@ -4223,7 +4254,7 @@ result of the operation.</doc>
42234254 closure="3">
42244255 <doc xml:space="preserve"
42254256 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4226- line="447">a `GAsyncReadyCallback` to call when the pixbuf is loaded</doc>
4257+ line="446">a `GAsyncReadyCallback` to call when the pixbuf is loaded</doc>
42274258 <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
42284259 </parameter>
42294260 <parameter name="user_data"
@@ -4232,7 +4263,7 @@ result of the operation.</doc>
42324263 allow-none="1">
42334264 <doc xml:space="preserve"
42344265 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4235- line="448">the data to pass to the callback function</doc>
4266+ line="447">the data to pass to the callback function</doc>
42364267 <type name="gpointer" c:type="gpointer"/>
42374268 </parameter>
42384269 </parameters>
@@ -4240,7 +4271,7 @@ result of the operation.</doc>
42404271 <virtual-method name="get_iter" invoker="get_iter">
42414272 <doc xml:space="preserve"
42424273 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4243- line="664">Get an iterator for displaying an animation.
4274+ line="663">Get an iterator for displaying an animation.
42444275
42454276 The iterator provides the frames that should be displayed at a
42464277 given time.
@@ -4275,18 +4306,18 @@ area_updated signal.
42754306
42764307 A delay time of -1 is possible, indicating "infinite".</doc>
42774308 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4278- line="161"/>
4309+ line="158"/>
42794310 <return-value transfer-ownership="full">
42804311 <doc xml:space="preserve"
42814312 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4282- line="704">an iterator to move over the animation</doc>
4313+ line="703">an iterator to move over the animation</doc>
42834314 <type name="PixbufAnimationIter" c:type="GdkPixbufAnimationIter*"/>
42844315 </return-value>
42854316 <parameters>
42864317 <instance-parameter name="animation" transfer-ownership="none">
42874318 <doc xml:space="preserve"
42884319 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4289- line="666">a #GdkPixbufAnimation</doc>
4320+ line="665">a #GdkPixbufAnimation</doc>
42904321 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
42914322 </instance-parameter>
42924323 <parameter name="start_time"
@@ -4295,7 +4326,7 @@ A delay time of -1 is possible, indicating "infinite".</doc>
42954326 allow-none="1">
42964327 <doc xml:space="preserve"
42974328 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4298- line="667">time when the animation starts playing</doc>
4329+ line="666">time when the animation starts playing</doc>
42994330 <type name="GLib.TimeVal" c:type="const GTimeVal*"/>
43004331 </parameter>
43014332 </parameters>
@@ -4303,9 +4334,9 @@ A delay time of -1 is possible, indicating "infinite".</doc>
43034334 <virtual-method name="get_size">
43044335 <doc xml:space="preserve"
43054336 filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4306- line="128">fills @width and @height with the frame size of the animation.</doc>
4337+ line="125">fills @width and @height with the frame size of the animation.</doc>
43074338 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4308- line="157"/>
4339+ line="154"/>
43094340 <return-value transfer-ownership="none">
43104341 <type name="none" c:type="void"/>
43114342 </return-value>
@@ -4324,7 +4355,7 @@ A delay time of -1 is possible, indicating "infinite".</doc>
43244355 <virtual-method name="get_static_image" invoker="get_static_image">
43254356 <doc xml:space="preserve"
43264357 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4327- line="593">Retrieves a static image for the animation.
4358+ line="592">Retrieves a static image for the animation.
43284359
43294360 If an animation is really just a plain image (has only one frame),
43304361 this function returns that image.
@@ -4336,18 +4367,18 @@ frame, or something more sophisticated depending on the file format.
43364367 If an animation hasn't loaded any frames yet, this function will
43374368 return `NULL`.</doc>
43384369 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4339- line="155"/>
4370+ line="152"/>
43404371 <return-value transfer-ownership="none">
43414372 <doc xml:space="preserve"
43424373 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4343- line="609">unanimated image representing the animation</doc>
4374+ line="608">unanimated image representing the animation</doc>
43444375 <type name="Pixbuf" c:type="GdkPixbuf*"/>
43454376 </return-value>
43464377 <parameters>
43474378 <instance-parameter name="animation" transfer-ownership="none">
43484379 <doc xml:space="preserve"
43494380 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4350- line="595">a #GdkPixbufAnimation</doc>
4381+ line="594">a #GdkPixbufAnimation</doc>
43514382 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
43524383 </instance-parameter>
43534384 </parameters>
@@ -4355,25 +4386,25 @@ return `NULL`.</doc>
43554386 <virtual-method name="is_static_image" invoker="is_static_image">
43564387 <doc xml:space="preserve"
43574388 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4358- line="572">Checks whether the animation is a static image.
4389+ line="571">Checks whether the animation is a static image.
43594390
43604391 If you load a file with gdk_pixbuf_animation_new_from_file() and it
43614392 turns out to be a plain, unanimated image, then this function will
43624393 return `TRUE`. Use gdk_pixbuf_animation_get_static_image() to retrieve
43634394 the image.</doc>
43644395 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4365- line="153"/>
4396+ line="150"/>
43664397 <return-value transfer-ownership="none">
43674398 <doc xml:space="preserve"
43684399 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4369- line="583">`TRUE` if the "animation" was really just an image</doc>
4400+ line="582">`TRUE` if the "animation" was really just an image</doc>
43704401 <type name="gboolean" c:type="gboolean"/>
43714402 </return-value>
43724403 <parameters>
43734404 <instance-parameter name="animation" transfer-ownership="none">
43744405 <doc xml:space="preserve"
43754406 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4376- line="574">a #GdkPixbufAnimation</doc>
4407+ line="573">a #GdkPixbufAnimation</doc>
43774408 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
43784409 </instance-parameter>
43794410 </parameters>
@@ -4381,20 +4412,20 @@ the image.</doc>
43814412 <method name="get_height" c:identifier="gdk_pixbuf_animation_get_height">
43824413 <doc xml:space="preserve"
43834414 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4384- line="641">Queries the height of the bounding box of a pixbuf animation.</doc>
4415+ line="640">Queries the height of the bounding box of a pixbuf animation.</doc>
43854416 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4386- line="92"/>
4417+ line="89"/>
43874418 <return-value transfer-ownership="none">
43884419 <doc xml:space="preserve"
43894420 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4390- line="647">Height of the bounding box of the animation.</doc>
4421+ line="646">Height of the bounding box of the animation.</doc>
43914422 <type name="gint" c:type="int"/>
43924423 </return-value>
43934424 <parameters>
43944425 <instance-parameter name="animation" transfer-ownership="none">
43954426 <doc xml:space="preserve"
43964427 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4397- line="643">An animation.</doc>
4428+ line="642">An animation.</doc>
43984429 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
43994430 </instance-parameter>
44004431 </parameters>
@@ -4402,7 +4433,7 @@ the image.</doc>
44024433 <method name="get_iter" c:identifier="gdk_pixbuf_animation_get_iter">
44034434 <doc xml:space="preserve"
44044435 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4405- line="664">Get an iterator for displaying an animation.
4436+ line="663">Get an iterator for displaying an animation.
44064437
44074438 The iterator provides the frames that should be displayed at a
44084439 given time.
@@ -4437,18 +4468,18 @@ area_updated signal.
44374468
44384469 A delay time of -1 is possible, indicating "infinite".</doc>
44394470 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4440- line="100"/>
4471+ line="97"/>
44414472 <return-value transfer-ownership="full">
44424473 <doc xml:space="preserve"
44434474 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4444- line="704">an iterator to move over the animation</doc>
4475+ line="703">an iterator to move over the animation</doc>
44454476 <type name="PixbufAnimationIter" c:type="GdkPixbufAnimationIter*"/>
44464477 </return-value>
44474478 <parameters>
44484479 <instance-parameter name="animation" transfer-ownership="none">
44494480 <doc xml:space="preserve"
44504481 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4451- line="666">a #GdkPixbufAnimation</doc>
4482+ line="665">a #GdkPixbufAnimation</doc>
44524483 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
44534484 </instance-parameter>
44544485 <parameter name="start_time"
@@ -4457,7 +4488,7 @@ A delay time of -1 is possible, indicating "infinite".</doc>
44574488 allow-none="1">
44584489 <doc xml:space="preserve"
44594490 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4460- line="667">time when the animation starts playing</doc>
4491+ line="666">time when the animation starts playing</doc>
44614492 <type name="GLib.TimeVal" c:type="const GTimeVal*"/>
44624493 </parameter>
44634494 </parameters>
@@ -4466,7 +4497,7 @@ A delay time of -1 is possible, indicating "infinite".</doc>
44664497 c:identifier="gdk_pixbuf_animation_get_static_image">
44674498 <doc xml:space="preserve"
44684499 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4469- line="593">Retrieves a static image for the animation.
4500+ line="592">Retrieves a static image for the animation.
44704501
44714502 If an animation is really just a plain image (has only one frame),
44724503 this function returns that image.
@@ -4478,18 +4509,18 @@ frame, or something more sophisticated depending on the file format.
44784509 If an animation hasn't loaded any frames yet, this function will
44794510 return `NULL`.</doc>
44804511 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4481- line="96"/>
4512+ line="93"/>
44824513 <return-value transfer-ownership="none">
44834514 <doc xml:space="preserve"
44844515 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4485- line="609">unanimated image representing the animation</doc>
4516+ line="608">unanimated image representing the animation</doc>
44864517 <type name="Pixbuf" c:type="GdkPixbuf*"/>
44874518 </return-value>
44884519 <parameters>
44894520 <instance-parameter name="animation" transfer-ownership="none">
44904521 <doc xml:space="preserve"
44914522 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4492- line="595">a #GdkPixbufAnimation</doc>
4523+ line="594">a #GdkPixbufAnimation</doc>
44934524 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
44944525 </instance-parameter>
44954526 </parameters>
@@ -4497,20 +4528,20 @@ return `NULL`.</doc>
44974528 <method name="get_width" c:identifier="gdk_pixbuf_animation_get_width">
44984529 <doc xml:space="preserve"
44994530 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4500- line="619">Queries the width of the bounding box of a pixbuf animation.</doc>
4531+ line="618">Queries the width of the bounding box of a pixbuf animation.</doc>
45014532 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4502- line="90"/>
4533+ line="87"/>
45034534 <return-value transfer-ownership="none">
45044535 <doc xml:space="preserve"
45054536 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4506- line="625">Width of the bounding box of the animation.</doc>
4537+ line="624">Width of the bounding box of the animation.</doc>
45074538 <type name="gint" c:type="int"/>
45084539 </return-value>
45094540 <parameters>
45104541 <instance-parameter name="animation" transfer-ownership="none">
45114542 <doc xml:space="preserve"
45124543 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4513- line="621">An animation.</doc>
4544+ line="620">An animation.</doc>
45144545 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
45154546 </instance-parameter>
45164547 </parameters>
@@ -4519,25 +4550,25 @@ return `NULL`.</doc>
45194550 c:identifier="gdk_pixbuf_animation_is_static_image">
45204551 <doc xml:space="preserve"
45214552 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4522- line="572">Checks whether the animation is a static image.
4553+ line="571">Checks whether the animation is a static image.
45234554
45244555 If you load a file with gdk_pixbuf_animation_new_from_file() and it
45254556 turns out to be a plain, unanimated image, then this function will
45264557 return `TRUE`. Use gdk_pixbuf_animation_get_static_image() to retrieve
45274558 the image.</doc>
45284559 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4529- line="94"/>
4560+ line="91"/>
45304561 <return-value transfer-ownership="none">
45314562 <doc xml:space="preserve"
45324563 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4533- line="583">`TRUE` if the "animation" was really just an image</doc>
4564+ line="582">`TRUE` if the "animation" was really just an image</doc>
45344565 <type name="gboolean" c:type="gboolean"/>
45354566 </return-value>
45364567 <parameters>
45374568 <instance-parameter name="animation" transfer-ownership="none">
45384569 <doc xml:space="preserve"
45394570 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4540- line="574">a #GdkPixbufAnimation</doc>
4571+ line="573">a #GdkPixbufAnimation</doc>
45414572 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
45424573 </instance-parameter>
45434574 </parameters>
@@ -4549,21 +4580,21 @@ the image.</doc>
45494580 deprecated-version="2.0">
45504581 <doc xml:space="preserve"
45514582 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4552- line="542">Adds a reference to an animation.</doc>
4583+ line="541">Adds a reference to an animation.</doc>
45534584 <doc-deprecated xml:space="preserve">Use g_object_ref().</doc-deprecated>
45544585 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4555- line="84"/>
4586+ line="82"/>
45564587 <return-value>
45574588 <doc xml:space="preserve"
45584589 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4559- line="548">The same as the @animation argument.</doc>
4590+ line="547">The same as the @animation argument.</doc>
45604591 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
45614592 </return-value>
45624593 <parameters>
45634594 <instance-parameter name="animation" transfer-ownership="none">
45644595 <doc xml:space="preserve"
45654596 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4566- line="544">An animation.</doc>
4597+ line="543">An animation.</doc>
45674598 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
45684599 </instance-parameter>
45694600 </parameters>
@@ -4575,10 +4606,10 @@ the image.</doc>
45754606 deprecated-version="2.0">
45764607 <doc xml:space="preserve"
45774608 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4578- line="558">Removes a reference from an animation.</doc>
4609+ line="557">Removes a reference from an animation.</doc>
45794610 <doc-deprecated xml:space="preserve">Use g_object_unref().</doc-deprecated>
45804611 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4581- line="86"/>
4612+ line="84"/>
45824613 <return-value transfer-ownership="none">
45834614 <type name="none" c:type="void"/>
45844615 </return-value>
@@ -4586,7 +4617,7 @@ the image.</doc>
45864617 <instance-parameter name="animation" transfer-ownership="none">
45874618 <doc xml:space="preserve"
45884619 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4589- line="560">An animation.</doc>
4620+ line="559">An animation.</doc>
45904621 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
45914622 </instance-parameter>
45924623 </parameters>
@@ -4600,35 +4631,35 @@ the image.</doc>
46004631 glib:is-gtype-struct-for="PixbufAnimation">
46014632 <doc xml:space="preserve"
46024633 filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4603- line="123">Modules supporting animations must derive a type from
4634+ line="120">Modules supporting animations must derive a type from
46044635 #GdkPixbufAnimation, providing suitable implementations of the
46054636 virtual functions.</doc>
46064637 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4607- line="163"/>
4638+ line="160"/>
46084639 <field name="parent_class">
46094640 <doc xml:space="preserve"
46104641 filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4611- line="125">the parent class</doc>
4642+ line="122">the parent class</doc>
46124643 <type name="GObject.ObjectClass" c:type="GObjectClass"/>
46134644 </field>
46144645 <field name="is_static_image">
46154646 <doc xml:space="preserve"
46164647 filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4617- line="126">returns whether the given animation is just a static image.</doc>
4648+ line="123">returns whether the given animation is just a static image.</doc>
46184649 <callback name="is_static_image">
46194650 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4620- line="153"/>
4651+ line="150"/>
46214652 <return-value transfer-ownership="none">
46224653 <doc xml:space="preserve"
46234654 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4624- line="583">`TRUE` if the "animation" was really just an image</doc>
4655+ line="582">`TRUE` if the "animation" was really just an image</doc>
46254656 <type name="gboolean" c:type="gboolean"/>
46264657 </return-value>
46274658 <parameters>
46284659 <parameter name="animation" transfer-ownership="none">
46294660 <doc xml:space="preserve"
46304661 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4631- line="574">a #GdkPixbufAnimation</doc>
4662+ line="573">a #GdkPixbufAnimation</doc>
46324663 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
46334664 </parameter>
46344665 </parameters>
@@ -4637,21 +4668,21 @@ virtual functions.</doc>
46374668 <field name="get_static_image">
46384669 <doc xml:space="preserve"
46394670 filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4640- line="127">returns a static image representing the given animation.</doc>
4671+ line="124">returns a static image representing the given animation.</doc>
46414672 <callback name="get_static_image">
46424673 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4643- line="155"/>
4674+ line="152"/>
46444675 <return-value transfer-ownership="none">
46454676 <doc xml:space="preserve"
46464677 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4647- line="609">unanimated image representing the animation</doc>
4678+ line="608">unanimated image representing the animation</doc>
46484679 <type name="Pixbuf" c:type="GdkPixbuf*"/>
46494680 </return-value>
46504681 <parameters>
46514682 <parameter name="animation" transfer-ownership="none">
46524683 <doc xml:space="preserve"
46534684 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4654- line="595">a #GdkPixbufAnimation</doc>
4685+ line="594">a #GdkPixbufAnimation</doc>
46554686 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
46564687 </parameter>
46574688 </parameters>
@@ -4660,10 +4691,10 @@ virtual functions.</doc>
46604691 <field name="get_size">
46614692 <doc xml:space="preserve"
46624693 filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4663- line="128">fills @width and @height with the frame size of the animation.</doc>
4694+ line="125">fills @width and @height with the frame size of the animation.</doc>
46644695 <callback name="get_size">
46654696 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4666- line="157"/>
4697+ line="154"/>
46674698 <return-value transfer-ownership="none">
46684699 <type name="none" c:type="void"/>
46694700 </return-value>
@@ -4683,21 +4714,21 @@ virtual functions.</doc>
46834714 <field name="get_iter">
46844715 <doc xml:space="preserve"
46854716 filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4686- line="129">returns an iterator for the given animation.</doc>
4717+ line="126">returns an iterator for the given animation.</doc>
46874718 <callback name="get_iter">
46884719 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4689- line="161"/>
4720+ line="158"/>
46904721 <return-value transfer-ownership="full">
46914722 <doc xml:space="preserve"
46924723 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4693- line="704">an iterator to move over the animation</doc>
4724+ line="703">an iterator to move over the animation</doc>
46944725 <type name="PixbufAnimationIter" c:type="GdkPixbufAnimationIter*"/>
46954726 </return-value>
46964727 <parameters>
46974728 <parameter name="animation" transfer-ownership="none">
46984729 <doc xml:space="preserve"
46994730 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4700- line="666">a #GdkPixbufAnimation</doc>
4731+ line="665">a #GdkPixbufAnimation</doc>
47014732 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
47024733 </parameter>
47034734 <parameter name="start_time"
@@ -4706,7 +4737,7 @@ virtual functions.</doc>
47064737 allow-none="1">
47074738 <doc xml:space="preserve"
47084739 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4709- line="667">time when the animation starts playing</doc>
4740+ line="666">time when the animation starts playing</doc>
47104741 <type name="GLib.TimeVal" c:type="const GTimeVal*"/>
47114742 </parameter>
47124743 </parameters>
@@ -4722,14 +4753,14 @@ virtual functions.</doc>
47224753 glib:type-struct="PixbufAnimationIterClass">
47234754 <doc xml:space="preserve"
47244755 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4725- line="50">An opaque object representing an iterator which points to a
4756+ line="52">An opaque object representing an iterator which points to a
47264757 certain position in an animation.</doc>
47274758 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4728- line="208"/>
4759+ line="205"/>
47294760 <virtual-method name="advance" invoker="advance">
47304761 <doc xml:space="preserve"
47314762 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4732- line="813">Possibly advances an animation to a new frame.
4763+ line="812">Possibly advances an animation to a new frame.
47334764
47344765 Chooses the frame based on the start time passed to
47354766 gdk_pixbuf_animation_get_iter().
@@ -4751,18 +4782,18 @@ display, assuming the display had been rendered prior to advancing;
47514782 if `TRUE`, you need to call gdk_pixbuf_animation_iter_get_pixbuf()
47524783 and update the display with the new pixbuf.</doc>
47534784 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4754- line="206"/>
4785+ line="203"/>
47554786 <return-value transfer-ownership="none">
47564787 <doc xml:space="preserve"
47574788 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4758- line="840">`TRUE` if the image may need updating</doc>
4789+ line="839">`TRUE` if the image may need updating</doc>
47594790 <type name="gboolean" c:type="gboolean"/>
47604791 </return-value>
47614792 <parameters>
47624793 <instance-parameter name="iter" transfer-ownership="none">
47634794 <doc xml:space="preserve"
47644795 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4765- line="815">a #GdkPixbufAnimationIter</doc>
4796+ line="814">a #GdkPixbufAnimationIter</doc>
47664797 <type name="PixbufAnimationIter" c:type="GdkPixbufAnimationIter*"/>
47674798 </instance-parameter>
47684799 <parameter name="current_time"
@@ -4771,7 +4802,7 @@ and update the display with the new pixbuf.</doc>
47714802 allow-none="1">
47724803 <doc xml:space="preserve"
47734804 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4774- line="816">current time</doc>
4805+ line="815">current time</doc>
47754806 <type name="GLib.TimeVal" c:type="const GTimeVal*"/>
47764807 </parameter>
47774808 </parameters>
@@ -4779,7 +4810,7 @@ and update the display with the new pixbuf.</doc>
47794810 <virtual-method name="get_delay_time" invoker="get_delay_time">
47804811 <doc xml:space="preserve"
47814812 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4782- line="735">Gets the number of milliseconds the current pixbuf should be displayed,
4813+ line="734">Gets the number of milliseconds the current pixbuf should be displayed,
47834814 or -1 if the current pixbuf should be displayed forever.
47844815
47854816 The `g_timeout_add()` function conveniently takes a timeout in milliseconds,
@@ -4789,18 +4820,18 @@ Note that some formats, like GIF, might clamp the timeout values in the
47894820 image file to avoid updates that are just too quick. The minimum timeout
47904821 for GIF images is currently 20 milliseconds.</doc>
47914822 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4792- line="200"/>
4823+ line="197"/>
47934824 <return-value transfer-ownership="none">
47944825 <doc xml:space="preserve"
47954826 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4796- line="749">delay time in milliseconds (thousandths of a second)</doc>
4827+ line="748">delay time in milliseconds (thousandths of a second)</doc>
47974828 <type name="gint" c:type="int"/>
47984829 </return-value>
47994830 <parameters>
48004831 <instance-parameter name="iter" transfer-ownership="none">
48014832 <doc xml:space="preserve"
48024833 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4803- line="737">an animation iterator</doc>
4834+ line="736">an animation iterator</doc>
48044835 <type name="PixbufAnimationIter" c:type="GdkPixbufAnimationIter*"/>
48054836 </instance-parameter>
48064837 </parameters>
@@ -4808,7 +4839,7 @@ for GIF images is currently 20 milliseconds.</doc>
48084839 <virtual-method name="get_pixbuf" invoker="get_pixbuf">
48094840 <doc xml:space="preserve"
48104841 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4811- line="760">Gets the current pixbuf which should be displayed.
4842+ line="759">Gets the current pixbuf which should be displayed.
48124843
48134844 The pixbuf might not be the same size as the animation itself
48144845 (gdk_pixbuf_animation_get_width(), gdk_pixbuf_animation_get_height()).
@@ -4824,18 +4855,18 @@ gdk_pixbuf_animation_iter_advance().
48244855 Copy the pixbuf to keep it (don't just add a reference), as it may get
48254856 recycled as you advance the iterator.</doc>
48264857 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4827- line="202"/>
4858+ line="199"/>
48284859 <return-value transfer-ownership="none">
48294860 <doc xml:space="preserve"
48304861 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4831- line="780">the pixbuf to be displayed</doc>
4862+ line="779">the pixbuf to be displayed</doc>
48324863 <type name="Pixbuf" c:type="GdkPixbuf*"/>
48334864 </return-value>
48344865 <parameters>
48354866 <instance-parameter name="iter" transfer-ownership="none">
48364867 <doc xml:space="preserve"
48374868 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4838- line="762">an animation iterator</doc>
4869+ line="761">an animation iterator</doc>
48394870 <type name="PixbufAnimationIter" c:type="GdkPixbufAnimationIter*"/>
48404871 </instance-parameter>
48414872 </parameters>
@@ -4844,25 +4875,25 @@ recycled as you advance the iterator.</doc>
48444875 invoker="on_currently_loading_frame">
48454876 <doc xml:space="preserve"
48464877 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4847- line="791">Used to determine how to respond to the area_updated signal on
4878+ line="790">Used to determine how to respond to the area_updated signal on
48484879 #GdkPixbufLoader when loading an animation.
48494880
48504881 The `::area_updated` signal is emitted for an area of the frame currently
48514882 streaming in to the loader. So if you're on the currently loading frame,
48524883 you will need to redraw the screen for the updated area.</doc>
48534884 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4854- line="204"/>
4885+ line="201"/>
48554886 <return-value transfer-ownership="none">
48564887 <doc xml:space="preserve"
48574888 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4858- line="802">`TRUE` if the frame we're on is partially loaded, or the last frame</doc>
4889+ line="801">`TRUE` if the frame we're on is partially loaded, or the last frame</doc>
48594890 <type name="gboolean" c:type="gboolean"/>
48604891 </return-value>
48614892 <parameters>
48624893 <instance-parameter name="iter" transfer-ownership="none">
48634894 <doc xml:space="preserve"
48644895 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4865- line="793">a #GdkPixbufAnimationIter</doc>
4896+ line="792">a #GdkPixbufAnimationIter</doc>
48664897 <type name="PixbufAnimationIter" c:type="GdkPixbufAnimationIter*"/>
48674898 </instance-parameter>
48684899 </parameters>
@@ -4870,7 +4901,7 @@ you will need to redraw the screen for the updated area.</doc>
48704901 <method name="advance" c:identifier="gdk_pixbuf_animation_iter_advance">
48714902 <doc xml:space="preserve"
48724903 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4873- line="813">Possibly advances an animation to a new frame.
4904+ line="812">Possibly advances an animation to a new frame.
48744905
48754906 Chooses the frame based on the start time passed to
48764907 gdk_pixbuf_animation_get_iter().
@@ -4892,18 +4923,18 @@ display, assuming the display had been rendered prior to advancing;
48924923 if `TRUE`, you need to call gdk_pixbuf_animation_iter_get_pixbuf()
48934924 and update the display with the new pixbuf.</doc>
48944925 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4895- line="114"/>
4926+ line="111"/>
48964927 <return-value transfer-ownership="none">
48974928 <doc xml:space="preserve"
48984929 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4899- line="840">`TRUE` if the image may need updating</doc>
4930+ line="839">`TRUE` if the image may need updating</doc>
49004931 <type name="gboolean" c:type="gboolean"/>
49014932 </return-value>
49024933 <parameters>
49034934 <instance-parameter name="iter" transfer-ownership="none">
49044935 <doc xml:space="preserve"
49054936 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4906- line="815">a #GdkPixbufAnimationIter</doc>
4937+ line="814">a #GdkPixbufAnimationIter</doc>
49074938 <type name="PixbufAnimationIter" c:type="GdkPixbufAnimationIter*"/>
49084939 </instance-parameter>
49094940 <parameter name="current_time"
@@ -4912,7 +4943,7 @@ and update the display with the new pixbuf.</doc>
49124943 allow-none="1">
49134944 <doc xml:space="preserve"
49144945 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4915- line="816">current time</doc>
4946+ line="815">current time</doc>
49164947 <type name="GLib.TimeVal" c:type="const GTimeVal*"/>
49174948 </parameter>
49184949 </parameters>
@@ -4921,7 +4952,7 @@ and update the display with the new pixbuf.</doc>
49214952 c:identifier="gdk_pixbuf_animation_iter_get_delay_time">
49224953 <doc xml:space="preserve"
49234954 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4924- line="735">Gets the number of milliseconds the current pixbuf should be displayed,
4955+ line="734">Gets the number of milliseconds the current pixbuf should be displayed,
49254956 or -1 if the current pixbuf should be displayed forever.
49264957
49274958 The `g_timeout_add()` function conveniently takes a timeout in milliseconds,
@@ -4931,18 +4962,18 @@ Note that some formats, like GIF, might clamp the timeout values in the
49314962 image file to avoid updates that are just too quick. The minimum timeout
49324963 for GIF images is currently 20 milliseconds.</doc>
49334964 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4934- line="107"/>
4965+ line="104"/>
49354966 <return-value transfer-ownership="none">
49364967 <doc xml:space="preserve"
49374968 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4938- line="749">delay time in milliseconds (thousandths of a second)</doc>
4969+ line="748">delay time in milliseconds (thousandths of a second)</doc>
49394970 <type name="gint" c:type="int"/>
49404971 </return-value>
49414972 <parameters>
49424973 <instance-parameter name="iter" transfer-ownership="none">
49434974 <doc xml:space="preserve"
49444975 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4945- line="737">an animation iterator</doc>
4976+ line="736">an animation iterator</doc>
49464977 <type name="PixbufAnimationIter" c:type="GdkPixbufAnimationIter*"/>
49474978 </instance-parameter>
49484979 </parameters>
@@ -4951,7 +4982,7 @@ for GIF images is currently 20 milliseconds.</doc>
49514982 c:identifier="gdk_pixbuf_animation_iter_get_pixbuf">
49524983 <doc xml:space="preserve"
49534984 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4954- line="760">Gets the current pixbuf which should be displayed.
4985+ line="759">Gets the current pixbuf which should be displayed.
49554986
49564987 The pixbuf might not be the same size as the animation itself
49574988 (gdk_pixbuf_animation_get_width(), gdk_pixbuf_animation_get_height()).
@@ -4967,18 +4998,18 @@ gdk_pixbuf_animation_iter_advance().
49674998 Copy the pixbuf to keep it (don't just add a reference), as it may get
49684999 recycled as you advance the iterator.</doc>
49695000 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4970- line="109"/>
5001+ line="106"/>
49715002 <return-value transfer-ownership="none">
49725003 <doc xml:space="preserve"
49735004 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4974- line="780">the pixbuf to be displayed</doc>
5005+ line="779">the pixbuf to be displayed</doc>
49755006 <type name="Pixbuf" c:type="GdkPixbuf*"/>
49765007 </return-value>
49775008 <parameters>
49785009 <instance-parameter name="iter" transfer-ownership="none">
49795010 <doc xml:space="preserve"
49805011 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4981- line="762">an animation iterator</doc>
5012+ line="761">an animation iterator</doc>
49825013 <type name="PixbufAnimationIter" c:type="GdkPixbufAnimationIter*"/>
49835014 </instance-parameter>
49845015 </parameters>
@@ -4987,25 +5018,25 @@ recycled as you advance the iterator.</doc>
49875018 c:identifier="gdk_pixbuf_animation_iter_on_currently_loading_frame">
49885019 <doc xml:space="preserve"
49895020 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
4990- line="791">Used to determine how to respond to the area_updated signal on
5021+ line="790">Used to determine how to respond to the area_updated signal on
49915022 #GdkPixbufLoader when loading an animation.
49925023
49935024 The `::area_updated` signal is emitted for an area of the frame currently
49945025 streaming in to the loader. So if you're on the currently loading frame,
49955026 you will need to redraw the screen for the updated area.</doc>
49965027 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
4997- line="111"/>
5028+ line="108"/>
49985029 <return-value transfer-ownership="none">
49995030 <doc xml:space="preserve"
50005031 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
5001- line="802">`TRUE` if the frame we're on is partially loaded, or the last frame</doc>
5032+ line="801">`TRUE` if the frame we're on is partially loaded, or the last frame</doc>
50025033 <type name="gboolean" c:type="gboolean"/>
50035034 </return-value>
50045035 <parameters>
50055036 <instance-parameter name="iter" transfer-ownership="none">
50065037 <doc xml:space="preserve"
50075038 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
5008- line="793">a #GdkPixbufAnimationIter</doc>
5039+ line="792">a #GdkPixbufAnimationIter</doc>
50095040 <type name="PixbufAnimationIter" c:type="GdkPixbufAnimationIter*"/>
50105041 </instance-parameter>
50115042 </parameters>
@@ -5019,36 +5050,36 @@ you will need to redraw the screen for the updated area.</doc>
50195050 glib:is-gtype-struct-for="PixbufAnimationIter">
50205051 <doc xml:space="preserve"
50215052 filename="gdk-pixbuf/gdk-pixbuf-animation.h"
5022- line="168">Modules supporting animations must derive a type from
5053+ line="165">Modules supporting animations must derive a type from
50235054 #GdkPixbufAnimationIter, providing suitable implementations of the
50245055 virtual functions.</doc>
50255056 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
5026- line="208"/>
5057+ line="205"/>
50275058 <field name="parent_class">
50285059 <doc xml:space="preserve"
50295060 filename="gdk-pixbuf/gdk-pixbuf-animation.h"
5030- line="170">the parent class</doc>
5061+ line="167">the parent class</doc>
50315062 <type name="GObject.ObjectClass" c:type="GObjectClass"/>
50325063 </field>
50335064 <field name="get_delay_time">
50345065 <doc xml:space="preserve"
50355066 filename="gdk-pixbuf/gdk-pixbuf-animation.h"
5036- line="171">returns the time in milliseconds that the current frame
5067+ line="168">returns the time in milliseconds that the current frame
50375068 should be shown.</doc>
50385069 <callback name="get_delay_time">
50395070 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
5040- line="200"/>
5071+ line="197"/>
50415072 <return-value transfer-ownership="none">
50425073 <doc xml:space="preserve"
50435074 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
5044- line="749">delay time in milliseconds (thousandths of a second)</doc>
5075+ line="748">delay time in milliseconds (thousandths of a second)</doc>
50455076 <type name="gint" c:type="int"/>
50465077 </return-value>
50475078 <parameters>
50485079 <parameter name="iter" transfer-ownership="none">
50495080 <doc xml:space="preserve"
50505081 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
5051- line="737">an animation iterator</doc>
5082+ line="736">an animation iterator</doc>
50525083 <type name="PixbufAnimationIter"
50535084 c:type="GdkPixbufAnimationIter*"/>
50545085 </parameter>
@@ -5058,21 +5089,21 @@ virtual functions.</doc>
50585089 <field name="get_pixbuf">
50595090 <doc xml:space="preserve"
50605091 filename="gdk-pixbuf/gdk-pixbuf-animation.h"
5061- line="173">returns the current frame.</doc>
5092+ line="170">returns the current frame.</doc>
50625093 <callback name="get_pixbuf">
50635094 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
5064- line="202"/>
5095+ line="199"/>
50655096 <return-value transfer-ownership="none">
50665097 <doc xml:space="preserve"
50675098 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
5068- line="780">the pixbuf to be displayed</doc>
5099+ line="779">the pixbuf to be displayed</doc>
50695100 <type name="Pixbuf" c:type="GdkPixbuf*"/>
50705101 </return-value>
50715102 <parameters>
50725103 <parameter name="iter" transfer-ownership="none">
50735104 <doc xml:space="preserve"
50745105 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
5075- line="762">an animation iterator</doc>
5106+ line="761">an animation iterator</doc>
50765107 <type name="PixbufAnimationIter"
50775108 c:type="GdkPixbufAnimationIter*"/>
50785109 </parameter>
@@ -5082,22 +5113,22 @@ virtual functions.</doc>
50825113 <field name="on_currently_loading_frame">
50835114 <doc xml:space="preserve"
50845115 filename="gdk-pixbuf/gdk-pixbuf-animation.h"
5085- line="174">returns whether the current frame of @iter is
5116+ line="171">returns whether the current frame of @iter is
50865117 being loaded.</doc>
50875118 <callback name="on_currently_loading_frame">
50885119 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
5089- line="204"/>
5120+ line="201"/>
50905121 <return-value transfer-ownership="none">
50915122 <doc xml:space="preserve"
50925123 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
5093- line="802">`TRUE` if the frame we're on is partially loaded, or the last frame</doc>
5124+ line="801">`TRUE` if the frame we're on is partially loaded, or the last frame</doc>
50945125 <type name="gboolean" c:type="gboolean"/>
50955126 </return-value>
50965127 <parameters>
50975128 <parameter name="iter" transfer-ownership="none">
50985129 <doc xml:space="preserve"
50995130 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
5100- line="793">a #GdkPixbufAnimationIter</doc>
5131+ line="792">a #GdkPixbufAnimationIter</doc>
51015132 <type name="PixbufAnimationIter"
51025133 c:type="GdkPixbufAnimationIter*"/>
51035134 </parameter>
@@ -5107,22 +5138,22 @@ virtual functions.</doc>
51075138 <field name="advance">
51085139 <doc xml:space="preserve"
51095140 filename="gdk-pixbuf/gdk-pixbuf-animation.h"
5110- line="176">advances the iterator to @current_time, possibly changing the
5141+ line="173">advances the iterator to @current_time, possibly changing the
51115142 current frame.</doc>
51125143 <callback name="advance">
51135144 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
5114- line="206"/>
5145+ line="203"/>
51155146 <return-value transfer-ownership="none">
51165147 <doc xml:space="preserve"
51175148 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
5118- line="840">`TRUE` if the image may need updating</doc>
5149+ line="839">`TRUE` if the image may need updating</doc>
51195150 <type name="gboolean" c:type="gboolean"/>
51205151 </return-value>
51215152 <parameters>
51225153 <parameter name="iter" transfer-ownership="none">
51235154 <doc xml:space="preserve"
51245155 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
5125- line="815">a #GdkPixbufAnimationIter</doc>
5156+ line="814">a #GdkPixbufAnimationIter</doc>
51265157 <type name="PixbufAnimationIter"
51275158 c:type="GdkPixbufAnimationIter*"/>
51285159 </parameter>
@@ -5132,7 +5163,7 @@ virtual functions.</doc>
51325163 allow-none="1">
51335164 <doc xml:space="preserve"
51345165 filename="gdk-pixbuf/gdk-pixbuf-animation.c"
5135- line="816">current time</doc>
5166+ line="815">current time</doc>
51365167 <type name="GLib.TimeVal" c:type="const GTimeVal*"/>
51375168 </parameter>
51385169 </parameters>
@@ -5333,12 +5364,12 @@ use the `gdk_pixbuf_format_*` family of functions.</doc>
53335364 <method name="copy" c:identifier="gdk_pixbuf_format_copy" version="2.22">
53345365 <doc xml:space="preserve"
53355366 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5336- line="3452">Creates a copy of `format`.</doc>
5367+ line="3546">Creates a copy of `format`.</doc>
53375368 <source-position filename="gdk-pixbuf/gdk-pixbuf-io.h" line="92"/>
53385369 <return-value transfer-ownership="full" nullable="1">
53395370 <doc xml:space="preserve"
53405371 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5341- line="3458">the newly allocated copy of a `GdkPixbufFormat`. Use
5372+ line="3552">the newly allocated copy of a `GdkPixbufFormat`. Use
53425373 gdk_pixbuf_format_free() to free the resources when done</doc>
53435374 <type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
53445375 </return-value>
@@ -5346,7 +5377,7 @@ use the `gdk_pixbuf_format_*` family of functions.</doc>
53465377 <instance-parameter name="format" transfer-ownership="none">
53475378 <doc xml:space="preserve"
53485379 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5349- line="3454">a pixbuf format</doc>
5380+ line="3548">a pixbuf format</doc>
53505381 <type name="PixbufFormat" c:type="const GdkPixbufFormat*"/>
53515382 </instance-parameter>
53525383 </parameters>
@@ -5354,7 +5385,7 @@ use the `gdk_pixbuf_format_*` family of functions.</doc>
53545385 <method name="free" c:identifier="gdk_pixbuf_format_free" version="2.22">
53555386 <doc xml:space="preserve"
53565387 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5357- line="3472">Frees the resources allocated when copying a `GdkPixbufFormat`
5388+ line="3566">Frees the resources allocated when copying a `GdkPixbufFormat`
53585389 using gdk_pixbuf_format_copy()</doc>
53595390 <source-position filename="gdk-pixbuf/gdk-pixbuf-io.h" line="94"/>
53605391 <return-value transfer-ownership="none">
@@ -5364,7 +5395,7 @@ using gdk_pixbuf_format_copy()</doc>
53645395 <instance-parameter name="format" transfer-ownership="none">
53655396 <doc xml:space="preserve"
53665397 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5367- line="3474">a pixbuf format</doc>
5398+ line="3568">a pixbuf format</doc>
53685399 <type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
53695400 </instance-parameter>
53705401 </parameters>
@@ -5374,19 +5405,19 @@ using gdk_pixbuf_format_copy()</doc>
53745405 version="2.2">
53755406 <doc xml:space="preserve"
53765407 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5377- line="3249">Returns a description of the format.</doc>
5408+ line="3343">Returns a description of the format.</doc>
53785409 <source-position filename="gdk-pixbuf/gdk-pixbuf-io.h" line="56"/>
53795410 <return-value transfer-ownership="full" nullable="1">
53805411 <doc xml:space="preserve"
53815412 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5382- line="3255">a description of the format.</doc>
5413+ line="3349">a description of the format.</doc>
53835414 <type name="utf8" c:type="gchar*"/>
53845415 </return-value>
53855416 <parameters>
53865417 <instance-parameter name="format" transfer-ownership="none">
53875418 <doc xml:space="preserve"
53885419 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5389- line="3251">a `GdkPixbufFormat`</doc>
5420+ line="3345">a `GdkPixbufFormat`</doc>
53905421 <type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
53915422 </instance-parameter>
53925423 </parameters>
@@ -5396,13 +5427,13 @@ using gdk_pixbuf_format_copy()</doc>
53965427 version="2.2">
53975428 <doc xml:space="preserve"
53985429 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5399- line="3293">Returns the filename extensions typically used for files in the
5430+ line="3387">Returns the filename extensions typically used for files in the
54005431 given format.</doc>
54015432 <source-position filename="gdk-pixbuf/gdk-pixbuf-io.h" line="60"/>
54025433 <return-value transfer-ownership="full" nullable="1">
54035434 <doc xml:space="preserve"
54045435 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5405- line="3300">an array of
5436+ line="3394">an array of
54065437 filename extensions</doc>
54075438 <array c:type="gchar**">
54085439 <type name="utf8"/>
@@ -5412,7 +5443,7 @@ given format.</doc>
54125443 <instance-parameter name="format" transfer-ownership="none">
54135444 <doc xml:space="preserve"
54145445 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5415- line="3295">a `GdkPixbufFormat`</doc>
5446+ line="3389">a `GdkPixbufFormat`</doc>
54165447 <type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
54175448 </instance-parameter>
54185449 </parameters>
@@ -5422,7 +5453,7 @@ given format.</doc>
54225453 version="2.6">
54235454 <doc xml:space="preserve"
54245455 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5425- line="3397">Returns information about the license of the image loader for the format.
5456+ line="3491">Returns information about the license of the image loader for the format.
54265457
54275458 The returned string should be a shorthand for a well known license, e.g.
54285459 "LGPL", "GPL", "QPL", "GPL/QPL", or "other" to indicate some other license.</doc>
@@ -5430,14 +5461,14 @@ The returned string should be a shorthand for a well known license, e.g.
54305461 <return-value transfer-ownership="full" nullable="1">
54315462 <doc xml:space="preserve"
54325463 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5433- line="3406">a string describing the license of the pixbuf format</doc>
5464+ line="3500">a string describing the license of the pixbuf format</doc>
54345465 <type name="utf8" c:type="gchar*"/>
54355466 </return-value>
54365467 <parameters>
54375468 <instance-parameter name="format" transfer-ownership="none">
54385469 <doc xml:space="preserve"
54395470 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5440- line="3399">a pixbuf format</doc>
5471+ line="3493">a pixbuf format</doc>
54415472 <type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
54425473 </instance-parameter>
54435474 </parameters>
@@ -5447,12 +5478,12 @@ The returned string should be a shorthand for a well known license, e.g.
54475478 version="2.2">
54485479 <doc xml:space="preserve"
54495480 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5450- line="3275">Returns the mime types supported by the format.</doc>
5481+ line="3369">Returns the mime types supported by the format.</doc>
54515482 <source-position filename="gdk-pixbuf/gdk-pixbuf-io.h" line="58"/>
54525483 <return-value transfer-ownership="full" nullable="1">
54535484 <doc xml:space="preserve"
54545485 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5455- line="3281">an array of mime types</doc>
5486+ line="3375">an array of mime types</doc>
54565487 <array c:type="gchar**">
54575488 <type name="utf8"/>
54585489 </array>
@@ -5461,7 +5492,7 @@ The returned string should be a shorthand for a well known license, e.g.
54615492 <instance-parameter name="format" transfer-ownership="none">
54625493 <doc xml:space="preserve"
54635494 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5464- line="3277">a `GdkPixbufFormat`</doc>
5495+ line="3371">a `GdkPixbufFormat`</doc>
54655496 <type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
54665497 </instance-parameter>
54675498 </parameters>
@@ -5471,19 +5502,19 @@ The returned string should be a shorthand for a well known license, e.g.
54715502 version="2.2">
54725503 <doc xml:space="preserve"
54735504 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5474- line="3231">Returns the name of the format.</doc>
5505+ line="3325">Returns the name of the format.</doc>
54755506 <source-position filename="gdk-pixbuf/gdk-pixbuf-io.h" line="54"/>
54765507 <return-value transfer-ownership="full" nullable="1">
54775508 <doc xml:space="preserve"
54785509 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5479- line="3237">the name of the format.</doc>
5510+ line="3331">the name of the format.</doc>
54805511 <type name="utf8" c:type="gchar*"/>
54815512 </return-value>
54825513 <parameters>
54835514 <instance-parameter name="format" transfer-ownership="none">
54845515 <doc xml:space="preserve"
54855516 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5486- line="3233">a `GdkPixbufFormat`</doc>
5517+ line="3327">a `GdkPixbufFormat`</doc>
54875518 <type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
54885519 </instance-parameter>
54895520 </parameters>
@@ -5493,21 +5524,21 @@ The returned string should be a shorthand for a well known license, e.g.
54935524 version="2.6">
54945525 <doc xml:space="preserve"
54955526 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5496- line="3353">Returns whether this image format is disabled.
5527+ line="3447">Returns whether this image format is disabled.
54975528
54985529 See gdk_pixbuf_format_set_disabled().</doc>
54995530 <source-position filename="gdk-pixbuf/gdk-pixbuf-io.h" line="69"/>
55005531 <return-value transfer-ownership="none">
55015532 <doc xml:space="preserve"
55025533 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5503- line="3361">whether this image format is disabled.</doc>
5534+ line="3455">whether this image format is disabled.</doc>
55045535 <type name="gboolean" c:type="gboolean"/>
55055536 </return-value>
55065537 <parameters>
55075538 <instance-parameter name="format" transfer-ownership="none">
55085539 <doc xml:space="preserve"
55095540 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5510- line="3355">a `GdkPixbufFormat`</doc>
5541+ line="3449">a `GdkPixbufFormat`</doc>
55115542 <type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
55125543 </instance-parameter>
55135544 </parameters>
@@ -5517,7 +5548,7 @@ See gdk_pixbuf_format_set_disabled().</doc>
55175548 version="2.36">
55185549 <doc xml:space="preserve"
55195550 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5520- line="3488">Returns `TRUE` if the save option specified by @option_key is supported when
5551+ line="3582">Returns `TRUE` if the save option specified by @option_key is supported when
55215552 saving a pixbuf using the module implementing @format.
55225553
55235554 See gdk_pixbuf_save() for more information about option keys.</doc>
@@ -5525,20 +5556,20 @@ See gdk_pixbuf_save() for more information about option keys.</doc>
55255556 <return-value transfer-ownership="none">
55265557 <doc xml:space="preserve"
55275558 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5528- line="3498">`TRUE` if the specified option is supported</doc>
5559+ line="3592">`TRUE` if the specified option is supported</doc>
55295560 <type name="gboolean" c:type="gboolean"/>
55305561 </return-value>
55315562 <parameters>
55325563 <instance-parameter name="format" transfer-ownership="none">
55335564 <doc xml:space="preserve"
55345565 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5535- line="3490">a pixbuf format</doc>
5566+ line="3584">a pixbuf format</doc>
55365567 <type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
55375568 </instance-parameter>
55385569 <parameter name="option_key" transfer-ownership="none">
55395570 <doc xml:space="preserve"
55405571 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5541- line="3491">the name of an option</doc>
5572+ line="3585">the name of an option</doc>
55425573 <type name="utf8" c:type="const gchar*"/>
55435574 </parameter>
55445575 </parameters>
@@ -5548,7 +5579,7 @@ See gdk_pixbuf_save() for more information about option keys.</doc>
55485579 version="2.6">
55495580 <doc xml:space="preserve"
55505581 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5551- line="3331">Returns whether this image format is scalable.
5582+ line="3425">Returns whether this image format is scalable.
55525583
55535584 If a file is in a scalable format, it is preferable to load it at
55545585 the desired size, rather than loading it at the default size and
@@ -5557,14 +5588,14 @@ scaling the resulting pixbuf to the desired size.</doc>
55575588 <return-value transfer-ownership="none">
55585589 <doc xml:space="preserve"
55595590 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5560- line="3341">whether this image format is scalable.</doc>
5591+ line="3435">whether this image format is scalable.</doc>
55615592 <type name="gboolean" c:type="gboolean"/>
55625593 </return-value>
55635594 <parameters>
55645595 <instance-parameter name="format" transfer-ownership="none">
55655596 <doc xml:space="preserve"
55665597 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5567- line="3333">a `GdkPixbufFormat`</doc>
5598+ line="3427">a `GdkPixbufFormat`</doc>
55685599 <type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
55695600 </instance-parameter>
55705601 </parameters>
@@ -5574,19 +5605,19 @@ scaling the resulting pixbuf to the desired size.</doc>
55745605 version="2.2">
55755606 <doc xml:space="preserve"
55765607 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5577- line="3313">Returns whether pixbufs can be saved in the given format.</doc>
5608+ line="3407">Returns whether pixbufs can be saved in the given format.</doc>
55785609 <source-position filename="gdk-pixbuf/gdk-pixbuf-io.h" line="65"/>
55795610 <return-value transfer-ownership="none">
55805611 <doc xml:space="preserve"
55815612 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5582- line="3319">whether pixbufs can be saved in the given format.</doc>
5613+ line="3413">whether pixbufs can be saved in the given format.</doc>
55835614 <type name="gboolean" c:type="gboolean"/>
55845615 </return-value>
55855616 <parameters>
55865617 <instance-parameter name="format" transfer-ownership="none">
55875618 <doc xml:space="preserve"
55885619 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5589- line="3315">a `GdkPixbufFormat`</doc>
5620+ line="3409">a `GdkPixbufFormat`</doc>
55905621 <type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
55915622 </instance-parameter>
55925623 </parameters>
@@ -5596,7 +5627,7 @@ scaling the resulting pixbuf to the desired size.</doc>
55965627 version="2.6">
55975628 <doc xml:space="preserve"
55985629 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5599- line="3373">Disables or enables an image format.
5630+ line="3467">Disables or enables an image format.
56005631
56015632 If a format is disabled, GdkPixbuf won't use the image loader for
56025633 this format to load images.
@@ -5611,13 +5642,13 @@ inappropriate license, see gdk_pixbuf_format_get_license().</doc>
56115642 <instance-parameter name="format" transfer-ownership="none">
56125643 <doc xml:space="preserve"
56135644 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5614- line="3375">a `GdkPixbufFormat`</doc>
5645+ line="3469">a `GdkPixbufFormat`</doc>
56155646 <type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
56165647 </instance-parameter>
56175648 <parameter name="disabled" transfer-ownership="none">
56185649 <doc xml:space="preserve"
56195650 filename="gdk-pixbuf/gdk-pixbuf-io.c"
5620- line="3376">`TRUE` to disable the format @format</doc>
5651+ line="3470">`TRUE` to disable the format @format</doc>
56215652 <type name="gboolean" c:type="gboolean"/>
56225653 </parameter>
56235654 </parameters>
@@ -5712,12 +5743,12 @@ desired time stamp.</doc>
57125743 <constructor name="new" c:identifier="gdk_pixbuf_loader_new">
57135744 <doc xml:space="preserve"
57145745 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5715- line="596">Creates a new pixbuf loader object.</doc>
5746+ line="606">Creates a new pixbuf loader object.</doc>
57165747 <source-position filename="gdk-pixbuf/gdk-pixbuf-loader.h" line="79"/>
57175748 <return-value transfer-ownership="full">
57185749 <doc xml:space="preserve"
57195750 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5720- line="601">A newly-created pixbuf loader.</doc>
5751+ line="611">A newly-created pixbuf loader.</doc>
57215752 <type name="PixbufLoader" c:type="GdkPixbufLoader*"/>
57225753 </return-value>
57235754 </constructor>
@@ -5727,7 +5758,7 @@ desired time stamp.</doc>
57275758 throws="1">
57285759 <doc xml:space="preserve"
57295760 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5730- line="654">Creates a new pixbuf loader object that always attempts to parse
5761+ line="664">Creates a new pixbuf loader object that always attempts to parse
57315762 image data as if it were an image of MIME type @mime_type, instead of
57325763 identifying the type automatically.
57335764
@@ -5746,14 +5777,14 @@ structs returned by gdk_pixbuf_get_formats().</doc>
57465777 <return-value transfer-ownership="full">
57475778 <doc xml:space="preserve"
57485779 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5749- line="675">A newly-created pixbuf loader.</doc>
5780+ line="685">A newly-created pixbuf loader.</doc>
57505781 <type name="PixbufLoader" c:type="GdkPixbufLoader*"/>
57515782 </return-value>
57525783 <parameters>
57535784 <parameter name="mime_type" transfer-ownership="none">
57545785 <doc xml:space="preserve"
57555786 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5756- line="656">the mime type to be loaded</doc>
5787+ line="666">the mime type to be loaded</doc>
57575788 <type name="utf8" c:type="const char*"/>
57585789 </parameter>
57595790 </parameters>
@@ -5763,7 +5794,7 @@ structs returned by gdk_pixbuf_get_formats().</doc>
57635794 throws="1">
57645795 <doc xml:space="preserve"
57655796 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5766- line="609">Creates a new pixbuf loader object that always attempts to parse
5797+ line="619">Creates a new pixbuf loader object that always attempts to parse
57675798 image data as if it were an image of type @image_type, instead of
57685799 identifying the type automatically.
57695800
@@ -5781,14 +5812,14 @@ of the #GdkPixbufFormat structs returned by gdk_pixbuf_get_formats().</doc>
57815812 <return-value transfer-ownership="full">
57825813 <doc xml:space="preserve"
57835814 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5784- line="629">A newly-created pixbuf loader.</doc>
5815+ line="639">A newly-created pixbuf loader.</doc>
57855816 <type name="PixbufLoader" c:type="GdkPixbufLoader*"/>
57865817 </return-value>
57875818 <parameters>
57885819 <parameter name="image_type" transfer-ownership="none">
57895820 <doc xml:space="preserve"
57905821 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5791- line="611">name of the image format to be loaded with the image</doc>
5822+ line="621">name of the image format to be loaded with the image</doc>
57925823 <type name="utf8" c:type="const char*"/>
57935824 </parameter>
57945825 </parameters>
@@ -5858,7 +5889,7 @@ of the #GdkPixbufFormat structs returned by gdk_pixbuf_get_formats().</doc>
58585889 <method name="close" c:identifier="gdk_pixbuf_loader_close" throws="1">
58595890 <doc xml:space="preserve"
58605891 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5861- line="803">Informs a pixbuf loader that no further writes with
5892+ line="815">Informs a pixbuf loader that no further writes with
58625893 gdk_pixbuf_loader_write() will occur, so that it can free its
58635894 internal loading structures.
58645895
@@ -5877,7 +5908,7 @@ you will need to explicitly release any reference you hold.</doc>
58775908 <return-value transfer-ownership="none">
58785909 <doc xml:space="preserve"
58795910 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5880- line="824">`TRUE` if all image data written so far was successfully
5911+ line="836">`TRUE` if all image data written so far was successfully
58815912 passed out via the update_area signal</doc>
58825913 <type name="gboolean" c:type="gboolean"/>
58835914 </return-value>
@@ -5885,7 +5916,7 @@ you will need to explicitly release any reference you hold.</doc>
58855916 <instance-parameter name="loader" transfer-ownership="none">
58865917 <doc xml:space="preserve"
58875918 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5888- line="805">A pixbuf loader.</doc>
5919+ line="817">A pixbuf loader.</doc>
58895920 <type name="PixbufLoader" c:type="GdkPixbufLoader*"/>
58905921 </instance-parameter>
58915922 </parameters>
@@ -5894,7 +5925,7 @@ you will need to explicitly release any reference you hold.</doc>
58945925 c:identifier="gdk_pixbuf_loader_get_animation">
58955926 <doc xml:space="preserve"
58965927 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5897- line="775">Queries the #GdkPixbufAnimation that a pixbuf loader is currently creating.
5928+ line="787">Queries the #GdkPixbufAnimation that a pixbuf loader is currently creating.
58985929
58995930 In general it only makes sense to call this function after the
59005931 [signal@GdkPixbuf.PixbufLoader::area-prepared] signal has been emitted by
@@ -5906,7 +5937,7 @@ signal, this function will return `NULL`.</doc>
59065937 <return-value transfer-ownership="none" nullable="1">
59075938 <doc xml:space="preserve"
59085939 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5909- line="788">The animation that the loader is
5940+ line="800">The animation that the loader is
59105941 currently loading</doc>
59115942 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
59125943 </return-value>
@@ -5914,7 +5945,7 @@ signal, this function will return `NULL`.</doc>
59145945 <instance-parameter name="loader" transfer-ownership="none">
59155946 <doc xml:space="preserve"
59165947 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5917- line="777">A pixbuf loader</doc>
5948+ line="789">A pixbuf loader</doc>
59185949 <type name="PixbufLoader" c:type="GdkPixbufLoader*"/>
59195950 </instance-parameter>
59205951 </parameters>
@@ -5924,20 +5955,20 @@ signal, this function will return `NULL`.</doc>
59245955 version="2.2">
59255956 <doc xml:space="preserve"
59265957 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5927- line="891">Obtains the available information about the format of the
5958+ line="903">Obtains the available information about the format of the
59285959 currently loading image file.</doc>
59295960 <source-position filename="gdk-pixbuf/gdk-pixbuf-loader.h" line="107"/>
59305961 <return-value transfer-ownership="none" nullable="1">
59315962 <doc xml:space="preserve"
59325963 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5933- line="898">A #GdkPixbufFormat</doc>
5964+ line="910">A #GdkPixbufFormat</doc>
59345965 <type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
59355966 </return-value>
59365967 <parameters>
59375968 <instance-parameter name="loader" transfer-ownership="none">
59385969 <doc xml:space="preserve"
59395970 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5940- line="893">A pixbuf loader.</doc>
5971+ line="905">A pixbuf loader.</doc>
59415972 <type name="PixbufLoader" c:type="GdkPixbufLoader*"/>
59425973 </instance-parameter>
59435974 </parameters>
@@ -5945,7 +5976,7 @@ currently loading image file.</doc>
59455976 <method name="get_pixbuf" c:identifier="gdk_pixbuf_loader_get_pixbuf">
59465977 <doc xml:space="preserve"
59475978 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5948- line="737">Queries the #GdkPixbuf that a pixbuf loader is currently creating.
5979+ line="747">Queries the #GdkPixbuf that a pixbuf loader is currently creating.
59495980
59505981 In general it only makes sense to call this function after the
59515982 [signal@GdkPixbuf.PixbufLoader::area-prepared] signal has been
@@ -5964,7 +5995,7 @@ image" of the animation (see gdk_pixbuf_animation_get_static_image()).</doc>
59645995 <return-value transfer-ownership="none" nullable="1">
59655996 <doc xml:space="preserve"
59665997 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5967- line="757">The pixbuf that the loader is
5998+ line="767">The pixbuf that the loader is
59685999 creating</doc>
59696000 <type name="Pixbuf" c:type="GdkPixbuf*"/>
59706001 </return-value>
@@ -5972,7 +6003,7 @@ image" of the animation (see gdk_pixbuf_animation_get_static_image()).</doc>
59726003 <instance-parameter name="loader" transfer-ownership="none">
59736004 <doc xml:space="preserve"
59746005 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
5975- line="739">A pixbuf loader.</doc>
6006+ line="749">A pixbuf loader.</doc>
59766007 <type name="PixbufLoader" c:type="GdkPixbufLoader*"/>
59776008 </instance-parameter>
59786009 </parameters>
@@ -6018,12 +6049,12 @@ emission of the ::size-prepared signal.</doc>
60186049 <method name="write" c:identifier="gdk_pixbuf_loader_write" throws="1">
60196050 <doc xml:space="preserve"
60206051 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
6021- line="506">Parses the next `count` bytes in the given image buffer.</doc>
6052+ line="516">Parses the next `count` bytes in the given image buffer.</doc>
60226053 <source-position filename="gdk-pixbuf/gdk-pixbuf-loader.h" line="91"/>
60236054 <return-value transfer-ownership="none">
60246055 <doc xml:space="preserve"
60256056 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
6026- line="515">`TRUE` if the write was successful, or
6057+ line="525">`TRUE` if the write was successful, or
60276058 `FALSE` if the loader cannot parse the buffer</doc>
60286059 <type name="gboolean" c:type="gboolean"/>
60296060 </return-value>
@@ -6031,13 +6062,13 @@ emission of the ::size-prepared signal.</doc>
60316062 <instance-parameter name="loader" transfer-ownership="none">
60326063 <doc xml:space="preserve"
60336064 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
6034- line="508">A pixbuf loader.</doc>
6065+ line="518">A pixbuf loader.</doc>
60356066 <type name="PixbufLoader" c:type="GdkPixbufLoader*"/>
60366067 </instance-parameter>
60376068 <parameter name="buf" transfer-ownership="none">
60386069 <doc xml:space="preserve"
60396070 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
6040- line="509">Pointer to image data.</doc>
6071+ line="519">Pointer to image data.</doc>
60416072 <array length="1" zero-terminated="0" c:type="const guchar*">
60426073 <type name="guint8" c:type="guchar"/>
60436074 </array>
@@ -6045,7 +6076,7 @@ emission of the ::size-prepared signal.</doc>
60456076 <parameter name="count" transfer-ownership="none">
60466077 <doc xml:space="preserve"
60476078 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
6048- line="510">Length of the @buf buffer in bytes.</doc>
6079+ line="520">Length of the @buf buffer in bytes.</doc>
60496080 <type name="gsize" c:type="gsize"/>
60506081 </parameter>
60516082 </parameters>
@@ -6056,12 +6087,12 @@ emission of the ::size-prepared signal.</doc>
60566087 throws="1">
60576088 <doc xml:space="preserve"
60586089 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
6059- line="567">Parses the next contents of the given image buffer.</doc>
6090+ line="577">Parses the next contents of the given image buffer.</doc>
60606091 <source-position filename="gdk-pixbuf/gdk-pixbuf-loader.h" line="96"/>
60616092 <return-value transfer-ownership="none">
60626093 <doc xml:space="preserve"
60636094 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
6064- line="575">`TRUE` if the write was successful, or `FALSE` if
6095+ line="585">`TRUE` if the write was successful, or `FALSE` if
60656096 the loader cannot parse the buffer</doc>
60666097 <type name="gboolean" c:type="gboolean"/>
60676098 </return-value>
@@ -6069,13 +6100,13 @@ emission of the ::size-prepared signal.</doc>
60696100 <instance-parameter name="loader" transfer-ownership="none">
60706101 <doc xml:space="preserve"
60716102 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
6072- line="569">A pixbuf loader.</doc>
6103+ line="579">A pixbuf loader.</doc>
60736104 <type name="PixbufLoader" c:type="GdkPixbufLoader*"/>
60746105 </instance-parameter>
60756106 <parameter name="buffer" transfer-ownership="none">
60766107 <doc xml:space="preserve"
60776108 filename="gdk-pixbuf/gdk-pixbuf-loader.c"
6078- line="570">The image data as a `GBytes` buffer.</doc>
6109+ line="580">The image data as a `GBytes` buffer.</doc>
60796110 <type name="GLib.Bytes" c:type="GBytes*"/>
60806111 </parameter>
60816112 </parameters>
@@ -6266,7 +6297,7 @@ should be scaled.</doc>
62666297 <record name="PixbufModule" c:type="GdkPixbufModule">
62676298 <doc xml:space="preserve"
62686299 filename="gdk-pixbuf/gdk-pixbuf-io.c"
6269- line="50">A `GdkPixbufModule` contains the necessary functions to load and save
6300+ line="52">A `GdkPixbufModule` contains the necessary functions to load and save
62706301 images in a certain file format.
62716302
62726303 If `GdkPixbuf` has been compiled with `GModule` support, it can be extended
@@ -6315,86 +6346,86 @@ Installing a module is a two-step process:
63156346 <field name="module_name" writable="1">
63166347 <doc xml:space="preserve"
63176348 filename="gdk-pixbuf/gdk-pixbuf-io.c"
6318- line="52">the name of the module, usually the same as the
6349+ line="54">the name of the module, usually the same as the
63196350 usual file extension for images of this type, eg. "xpm", "jpeg" or "png".</doc>
63206351 <type name="utf8" c:type="char*"/>
63216352 </field>
63226353 <field name="module_path" writable="1">
63236354 <doc xml:space="preserve"
63246355 filename="gdk-pixbuf/gdk-pixbuf-io.c"
6325- line="54">the path from which the module is loaded.</doc>
6356+ line="56">the path from which the module is loaded.</doc>
63266357 <type name="utf8" c:type="char*"/>
63276358 </field>
63286359 <field name="module" writable="1">
63296360 <doc xml:space="preserve"
63306361 filename="gdk-pixbuf/gdk-pixbuf-io.c"
6331- line="55">the loaded `GModule`.</doc>
6362+ line="57">the loaded `GModule`.</doc>
63326363 <type name="GModule.Module" c:type="GModule*"/>
63336364 </field>
63346365 <field name="info" writable="1">
63356366 <doc xml:space="preserve"
63366367 filename="gdk-pixbuf/gdk-pixbuf-io.c"
6337- line="56">a `GdkPixbufFormat` holding information about the module.</doc>
6368+ line="58">a `GdkPixbufFormat` holding information about the module.</doc>
63386369 <type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
63396370 </field>
63406371 <field name="load" writable="1">
63416372 <doc xml:space="preserve"
63426373 filename="gdk-pixbuf/gdk-pixbuf-io.c"
6343- line="57">loads an image from a file.</doc>
6374+ line="59">loads an image from a file.</doc>
63446375 <type name="PixbufModuleLoadFunc" c:type="GdkPixbufModuleLoadFunc"/>
63456376 </field>
63466377 <field name="load_xpm_data" writable="1">
63476378 <doc xml:space="preserve"
63486379 filename="gdk-pixbuf/gdk-pixbuf-io.c"
6349- line="58">loads an image from data in memory.</doc>
6380+ line="60">loads an image from data in memory.</doc>
63506381 <type name="PixbufModuleLoadXpmDataFunc"
63516382 c:type="GdkPixbufModuleLoadXpmDataFunc"/>
63526383 </field>
63536384 <field name="begin_load" introspectable="0" writable="1">
63546385 <doc xml:space="preserve"
63556386 filename="gdk-pixbuf/gdk-pixbuf-io.c"
6356- line="59">begins an incremental load.</doc>
6387+ line="61">begins an incremental load.</doc>
63576388 <type name="PixbufModuleBeginLoadFunc"
63586389 c:type="GdkPixbufModuleBeginLoadFunc"/>
63596390 </field>
63606391 <field name="stop_load" writable="1">
63616392 <doc xml:space="preserve"
63626393 filename="gdk-pixbuf/gdk-pixbuf-io.c"
6363- line="60">stops an incremental load.</doc>
6394+ line="62">stops an incremental load.</doc>
63646395 <type name="PixbufModuleStopLoadFunc"
63656396 c:type="GdkPixbufModuleStopLoadFunc"/>
63666397 </field>
63676398 <field name="load_increment" writable="1">
63686399 <doc xml:space="preserve"
63696400 filename="gdk-pixbuf/gdk-pixbuf-io.c"
6370- line="61">continues an incremental load.</doc>
6401+ line="63">continues an incremental load.</doc>
63716402 <type name="PixbufModuleIncrementLoadFunc"
63726403 c:type="GdkPixbufModuleIncrementLoadFunc"/>
63736404 </field>
63746405 <field name="load_animation" writable="1">
63756406 <doc xml:space="preserve"
63766407 filename="gdk-pixbuf/gdk-pixbuf-io.c"
6377- line="62">loads an animation from a file.</doc>
6408+ line="64">loads an animation from a file.</doc>
63786409 <type name="PixbufModuleLoadAnimationFunc"
63796410 c:type="GdkPixbufModuleLoadAnimationFunc"/>
63806411 </field>
63816412 <field name="save" writable="1">
63826413 <doc xml:space="preserve"
63836414 filename="gdk-pixbuf/gdk-pixbuf-io.c"
6384- line="63">saves a `GdkPixbuf` to a file.</doc>
6415+ line="65">saves a `GdkPixbuf` to a file.</doc>
63856416 <type name="PixbufModuleSaveFunc" c:type="GdkPixbufModuleSaveFunc"/>
63866417 </field>
63876418 <field name="save_to_callback" introspectable="0" writable="1">
63886419 <doc xml:space="preserve"
63896420 filename="gdk-pixbuf/gdk-pixbuf-io.c"
6390- line="64">saves a `GdkPixbuf` by calling the given `GdkPixbufSaveFunc`.</doc>
6421+ line="66">saves a `GdkPixbuf` by calling the given `GdkPixbufSaveFunc`.</doc>
63916422 <type name="PixbufModuleSaveCallbackFunc"
63926423 c:type="GdkPixbufModuleSaveCallbackFunc"/>
63936424 </field>
63946425 <field name="is_save_option_supported" writable="1">
63956426 <doc xml:space="preserve"
63966427 filename="gdk-pixbuf/gdk-pixbuf-io.c"
6397- line="65">returns whether a save option key is supported by the module</doc>
6428+ line="67">returns whether a save option key is supported by the module</doc>
63986429 <type name="PixbufModuleSaveOptionSupportedFunc"
63996430 c:type="GdkPixbufModuleSaveOptionSupportedFunc"/>
64006431 </field>
@@ -7024,7 +7055,7 @@ signal.</doc>
70247055 glib:get-type="gdk_pixbuf_non_anim_get_type">
70257056 <constructor name="new" c:identifier="gdk_pixbuf_non_anim_new">
70267057 <source-position filename="gdk-pixbuf/gdk-pixbuf-animation.h"
7027- line="215"/>
7058+ line="216"/>
70287059 <return-value transfer-ownership="full">
70297060 <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
70307061 </return-value>
@@ -7084,7 +7115,7 @@ To make them easier to use, their numerical values are the actual degrees.</doc>
70847115 <callback name="PixbufSaveFunc" c:type="GdkPixbufSaveFunc" version="2.4">
70857116 <doc xml:space="preserve"
70867117 filename="gdk-pixbuf/gdk-pixbuf-core.h"
7087- line="346">Save functions used by [method@GdkPixbuf.Pixbuf.save_to_callback].
7118+ line="341">Save functions used by [method@GdkPixbuf.Pixbuf.save_to_callback].
70887119
70897120 This function is called once for each block of bytes that is "written"
70907121 by `gdk_pixbuf_save_to_callback()`.
@@ -7092,18 +7123,18 @@ by `gdk_pixbuf_save_to_callback()`.
70927123 If successful it should return `TRUE`; if an error occurs it should set
70937124 `error` and return `FALSE`, in which case `gdk_pixbuf_save_to_callback()`
70947125 will fail with the same error.</doc>
7095- <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="367"/>
7126+ <source-position filename="gdk-pixbuf/gdk-pixbuf-core.h" line="362"/>
70967127 <return-value transfer-ownership="none">
70977128 <doc xml:space="preserve"
70987129 filename="gdk-pixbuf/gdk-pixbuf-core.h"
7099- line="362">`TRUE` if successful, `FALSE` otherwise</doc>
7130+ line="357">`TRUE` if successful, `FALSE` otherwise</doc>
71007131 <type name="gboolean" c:type="gboolean"/>
71017132 </return-value>
71027133 <parameters>
71037134 <parameter name="buf" transfer-ownership="none">
71047135 <doc xml:space="preserve"
71057136 filename="gdk-pixbuf/gdk-pixbuf-core.h"
7106- line="348">bytes to be written.</doc>
7137+ line="343">bytes to be written.</doc>
71077138 <array length="1" zero-terminated="0" c:type="const gchar*">
71087139 <type name="guint8"/>
71097140 </array>
@@ -7111,7 +7142,7 @@ will fail with the same error.</doc>
71117142 <parameter name="count" transfer-ownership="none">
71127143 <doc xml:space="preserve"
71137144 filename="gdk-pixbuf/gdk-pixbuf-core.h"
7114- line="349">number of bytes in @buf.</doc>
7145+ line="344">number of bytes in @buf.</doc>
71157146 <type name="gsize" c:type="gsize"/>
71167147 </parameter>
71177148 <parameter name="error"
@@ -7120,7 +7151,7 @@ will fail with the same error.</doc>
71207151 transfer-ownership="full">
71217152 <doc xml:space="preserve"
71227153 filename="gdk-pixbuf/gdk-pixbuf-core.h"
7123- line="350">A location to return an error.</doc>
7154+ line="345">A location to return an error.</doc>
71247155 <type name="GLib.Error" c:type="GError**"/>
71257156 </parameter>
71267157 <parameter name="data"
@@ -7130,7 +7161,7 @@ will fail with the same error.</doc>
71307161 closure="3">
71317162 <doc xml:space="preserve"
71327163 filename="gdk-pixbuf/gdk-pixbuf-core.h"
7133- line="351">user data passed to gdk_pixbuf_save_to_callback().</doc>
7164+ line="346">user data passed to gdk_pixbuf_save_to_callback().</doc>
71347165 <type name="gpointer" c:type="gpointer"/>
71357166 </parameter>
71367167 </parameters>
@@ -7152,32 +7183,32 @@ will fail with the same error.</doc>
71527183 version="2.8">
71537184 <doc xml:space="preserve"
71547185 filename="gdk-pixbuf/gdk-pixbuf-simple-anim.c"
7155- line="413">Creates a new, empty animation.</doc>
7186+ line="415">Creates a new, empty animation.</doc>
71567187 <source-position filename="gdk-pixbuf/gdk-pixbuf-simple-anim.h"
71577188 line="55"/>
71587189 <return-value transfer-ownership="full">
71597190 <doc xml:space="preserve"
71607191 filename="gdk-pixbuf/gdk-pixbuf-simple-anim.c"
7161- line="421">a newly allocated #GdkPixbufSimpleAnim</doc>
7192+ line="423">a newly allocated #GdkPixbufSimpleAnim</doc>
71627193 <type name="PixbufSimpleAnim" c:type="GdkPixbufSimpleAnim*"/>
71637194 </return-value>
71647195 <parameters>
71657196 <parameter name="width" transfer-ownership="none">
71667197 <doc xml:space="preserve"
71677198 filename="gdk-pixbuf/gdk-pixbuf-simple-anim.c"
7168- line="415">the width of the animation</doc>
7199+ line="417">the width of the animation</doc>
71697200 <type name="gint" c:type="gint"/>
71707201 </parameter>
71717202 <parameter name="height" transfer-ownership="none">
71727203 <doc xml:space="preserve"
71737204 filename="gdk-pixbuf/gdk-pixbuf-simple-anim.c"
7174- line="416">the height of the animation</doc>
7205+ line="418">the height of the animation</doc>
71757206 <type name="gint" c:type="gint"/>
71767207 </parameter>
71777208 <parameter name="rate" transfer-ownership="none">
71787209 <doc xml:space="preserve"
71797210 filename="gdk-pixbuf/gdk-pixbuf-simple-anim.c"
7180- line="417">the speed of the animation, in frames per second</doc>
7211+ line="419">the speed of the animation, in frames per second</doc>
71817212 <type name="gfloat" c:type="gfloat"/>
71827213 </parameter>
71837214 </parameters>
@@ -7187,11 +7218,11 @@ will fail with the same error.</doc>
71877218 version="2.8">
71887219 <doc xml:space="preserve"
71897220 filename="gdk-pixbuf/gdk-pixbuf-simple-anim.c"
7190- line="440">Adds a new frame to @animation. The @pixbuf must
7221+ line="442">Adds a new frame to @animation. The @pixbuf must
71917222 have the dimensions specified when the animation
71927223 was constructed.</doc>
71937224 <source-position filename="gdk-pixbuf/gdk-pixbuf-simple-anim.h"
7194- line="59"/>
7225+ line="60"/>
71957226 <return-value transfer-ownership="none">
71967227 <type name="none" c:type="void"/>
71977228 </return-value>
@@ -7199,13 +7230,13 @@ was constructed.</doc>
71997230 <instance-parameter name="animation" transfer-ownership="none">
72007231 <doc xml:space="preserve"
72017232 filename="gdk-pixbuf/gdk-pixbuf-simple-anim.c"
7202- line="442">a #GdkPixbufSimpleAnim</doc>
7233+ line="444">a #GdkPixbufSimpleAnim</doc>
72037234 <type name="PixbufSimpleAnim" c:type="GdkPixbufSimpleAnim*"/>
72047235 </instance-parameter>
72057236 <parameter name="pixbuf" transfer-ownership="none">
72067237 <doc xml:space="preserve"
72077238 filename="gdk-pixbuf/gdk-pixbuf-simple-anim.c"
7208- line="443">the pixbuf to add</doc>
7239+ line="445">the pixbuf to add</doc>
72097240 <type name="Pixbuf" c:type="GdkPixbuf*"/>
72107241 </parameter>
72117242 </parameters>
@@ -7216,20 +7247,20 @@ was constructed.</doc>
72167247 version="2.18">
72177248 <doc xml:space="preserve"
72187249 filename="gdk-pixbuf/gdk-pixbuf-simple-anim.c"
7219- line="531">Gets whether @animation should loop indefinitely when it reaches the end.</doc>
7250+ line="533">Gets whether @animation should loop indefinitely when it reaches the end.</doc>
72207251 <source-position filename="gdk-pixbuf/gdk-pixbuf-simple-anim.h"
7221- line="65"/>
7252+ line="66"/>
72227253 <return-value transfer-ownership="none">
72237254 <doc xml:space="preserve"
72247255 filename="gdk-pixbuf/gdk-pixbuf-simple-anim.c"
7225- line="537">%TRUE if the animation loops forever, %FALSE otherwise</doc>
7256+ line="539">%TRUE if the animation loops forever, %FALSE otherwise</doc>
72267257 <type name="gboolean" c:type="gboolean"/>
72277258 </return-value>
72287259 <parameters>
72297260 <instance-parameter name="animation" transfer-ownership="none">
72307261 <doc xml:space="preserve"
72317262 filename="gdk-pixbuf/gdk-pixbuf-simple-anim.c"
7232- line="533">a #GdkPixbufSimpleAnim</doc>
7263+ line="535">a #GdkPixbufSimpleAnim</doc>
72337264 <type name="PixbufSimpleAnim" c:type="GdkPixbufSimpleAnim*"/>
72347265 </instance-parameter>
72357266 </parameters>
@@ -7240,9 +7271,9 @@ was constructed.</doc>
72407271 version="2.18">
72417272 <doc xml:space="preserve"
72427273 filename="gdk-pixbuf/gdk-pixbuf-simple-anim.c"
7243- line="510">Sets whether @animation should loop indefinitely when it reaches the end.</doc>
7274+ line="512">Sets whether @animation should loop indefinitely when it reaches the end.</doc>
72447275 <source-position filename="gdk-pixbuf/gdk-pixbuf-simple-anim.h"
7245- line="62"/>
7276+ line="63"/>
72467277 <return-value transfer-ownership="none">
72477278 <type name="none" c:type="void"/>
72487279 </return-value>
@@ -7250,13 +7281,13 @@ was constructed.</doc>
72507281 <instance-parameter name="animation" transfer-ownership="none">
72517282 <doc xml:space="preserve"
72527283 filename="gdk-pixbuf/gdk-pixbuf-simple-anim.c"
7253- line="512">a #GdkPixbufSimpleAnim</doc>
7284+ line="514">a #GdkPixbufSimpleAnim</doc>
72547285 <type name="PixbufSimpleAnim" c:type="GdkPixbufSimpleAnim*"/>
72557286 </instance-parameter>
72567287 <parameter name="loop" transfer-ownership="none">
72577288 <doc xml:space="preserve"
72587289 filename="gdk-pixbuf/gdk-pixbuf-simple-anim.c"
7259- line="513">whether to loop the animation</doc>
7290+ line="515">whether to loop the animation</doc>
72607291 <type name="gboolean" c:type="gboolean"/>
72617292 </parameter>
72627293 </parameters>
@@ -7270,7 +7301,7 @@ was constructed.</doc>
72707301 default-value="FALSE">
72717302 <doc xml:space="preserve"
72727303 filename="gdk-pixbuf/gdk-pixbuf-simple-anim.c"
7273- line="152">Whether the animation should loop when it reaches the end.</doc>
7304+ line="154">Whether the animation should loop when it reaches the end.</doc>
72747305 <type name="gboolean" c:type="gboolean"/>
72757306 </property>
72767307 </class>
M internal/gir/spec/Gio-2.0.gir +3064 -6826 large diff (9890 lines changed): collapsed
load diff
M internal/gir/spec/Graphene-1.0.gir +49 -49
@@ -73,7 +73,7 @@ The contents of the returned structure are undefined.</doc>
7373 <doc xml:space="preserve"
7474 filename="src/graphene-box.c"
7575 line="632">`true` if the box is contained in the given box</doc>
76- <type name="gboolean" c:type="_Bool"/>
76+ <type name="gboolean" c:type="bool"/>
7777 </return-value>
7878 <parameters>
7979 <instance-parameter name="a" transfer-ownership="none">
@@ -101,7 +101,7 @@ The contents of the returned structure are undefined.</doc>
101101 <doc xml:space="preserve"
102102 filename="src/graphene-box.c"
103103 line="601">`true` if the point is contained in the given box</doc>
104- <type name="gboolean" c:type="_Bool"/>
104+ <type name="gboolean" c:type="bool"/>
105105 </return-value>
106106 <parameters>
107107 <instance-parameter name="box" transfer-ownership="none">
@@ -127,7 +127,7 @@ The contents of the returned structure are undefined.</doc>
127127 <doc xml:space="preserve"
128128 filename="src/graphene-box.c"
129129 line="682">`true` if the boxes are equal</doc>
130- <type name="gboolean" c:type="_Bool"/>
130+ <type name="gboolean" c:type="bool"/>
131131 </return-value>
132132 <parameters>
133133 <instance-parameter name="a" transfer-ownership="none">
@@ -711,7 +711,7 @@ initialized with graphene_box_empty().</doc>
711711 <doc xml:space="preserve"
712712 filename="src/graphene-box.c"
713713 line="345">true if the two boxes intersect</doc>
714- <type name="gboolean" c:type="_Bool"/>
714+ <type name="gboolean" c:type="bool"/>
715715 </return-value>
716716 <parameters>
717717 <instance-parameter name="a" transfer-ownership="none">
@@ -1018,7 +1018,7 @@ The contents of the returned structure are undefined.</doc>
10181018 <doc xml:space="preserve"
10191019 filename="src/graphene-euler.c"
10201020 line="688">`true` if the two #graphene_euler_t are equal</doc>
1021- <type name="gboolean" c:type="_Bool"/>
1021+ <type name="gboolean" c:type="bool"/>
10221022 </return-value>
10231023 <parameters>
10241024 <instance-parameter name="a" transfer-ownership="none">
@@ -1868,7 +1868,7 @@ The contents of the returned structure are undefined.</doc>
18681868 <doc xml:space="preserve"
18691869 filename="src/graphene-frustum.c"
18701870 line="220">`true` if the point is inside the frustum</doc>
1871- <type name="gboolean" c:type="_Bool"/>
1871+ <type name="gboolean" c:type="bool"/>
18721872 </return-value>
18731873 <parameters>
18741874 <instance-parameter name="f" transfer-ownership="none">
@@ -1894,7 +1894,7 @@ The contents of the returned structure are undefined.</doc>
18941894 <doc xml:space="preserve"
18951895 filename="src/graphene-frustum.c"
18961896 line="344">`true` if the given frustums are equal</doc>
1897- <type name="gboolean" c:type="_Bool"/>
1897+ <type name="gboolean" c:type="bool"/>
18981898 </return-value>
18991899 <parameters>
19001900 <instance-parameter name="a" transfer-ownership="none">
@@ -2087,7 +2087,7 @@ a #graphene_frustum_t.</doc>
20872087 <doc xml:space="preserve"
20882088 filename="src/graphene-frustum.c"
20892089 line="281">`true` if the box intersects the frustum</doc>
2090- <type name="gboolean" c:type="_Bool"/>
2090+ <type name="gboolean" c:type="bool"/>
20912091 </return-value>
20922092 <parameters>
20932093 <instance-parameter name="f" transfer-ownership="none">
@@ -2116,7 +2116,7 @@ a #graphene_frustum_t.</doc>
21162116 <doc xml:space="preserve"
21172117 filename="src/graphene-frustum.c"
21182118 line="250">`true` if the sphere intersects the frustum</doc>
2119- <type name="gboolean" c:type="_Bool"/>
2119+ <type name="gboolean" c:type="bool"/>
21202120 </return-value>
21212121 <parameters>
21222122 <instance-parameter name="f" transfer-ownership="none">
@@ -2178,7 +2178,7 @@ published in "Graphics Gems II", edited by Jim Arvo, and
21782178 <doc xml:space="preserve"
21792179 filename="src/graphene-matrix.c"
21802180 line="2058">`true` if the matrix could be decomposed</doc>
2181- <type name="gboolean" c:type="_Bool"/>
2181+ <type name="gboolean" c:type="bool"/>
21822182 </return-value>
21832183 <parameters>
21842184 <instance-parameter name="m" transfer-ownership="none">
@@ -2265,7 +2265,7 @@ published in "Graphics Gems II", edited by Jim Arvo, and
22652265 <doc xml:space="preserve"
22662266 filename="src/graphene-matrix.c"
22672267 line="2353">`true` if the two matrices are equal, and `false` otherwise</doc>
2268- <type name="gboolean" c:type="_Bool"/>
2268+ <type name="gboolean" c:type="bool"/>
22692269 </return-value>
22702270 <parameters>
22712271 <instance-parameter name="a" transfer-ownership="none">
@@ -2315,7 +2315,7 @@ graphene_matrix_near(). For instance:
23152315 <doc xml:space="preserve"
23162316 filename="src/graphene-matrix.c"
23172317 line="2393">`true` if the matrices are equal. and `false` otherwise</doc>
2318- <type name="gboolean" c:type="_Bool"/>
2318+ <type name="gboolean" c:type="bool"/>
23192319 </return-value>
23202320 <parameters>
23212321 <instance-parameter name="a" transfer-ownership="none">
@@ -3166,7 +3166,7 @@ will return an identity matrix.</doc>
31663166 <doc xml:space="preserve"
31673167 filename="src/graphene-matrix.c"
31683168 line="1687">`true` if the matrix is invertible</doc>
3169- <type name="gboolean" c:type="_Bool"/>
3169+ <type name="gboolean" c:type="bool"/>
31703170 </return-value>
31713171 <parameters>
31723172 <instance-parameter name="m" transfer-ownership="none">
@@ -3198,7 +3198,7 @@ a 2D affine transformation matrix.</doc>
31983198 filename="src/graphene-matrix.c"
31993199 line="516">`true` if the matrix is compatible with an affine
32003200 transformation matrix</doc>
3201- <type name="gboolean" c:type="_Bool"/>
3201+ <type name="gboolean" c:type="bool"/>
32023202 </return-value>
32033203 <parameters>
32043204 <instance-parameter name="m" transfer-ownership="none">
@@ -3220,7 +3220,7 @@ a 2D affine transformation matrix.</doc>
32203220 <doc xml:space="preserve"
32213221 filename="src/graphene-matrix.c"
32223222 line="561">`true` if the back face of the matrix is visible</doc>
3223- <type name="gboolean" c:type="_Bool"/>
3223+ <type name="gboolean" c:type="bool"/>
32243224 </return-value>
32253225 <parameters>
32263226 <instance-parameter name="m" transfer-ownership="none">
@@ -3242,7 +3242,7 @@ a 2D affine transformation matrix.</doc>
32423242 <doc xml:space="preserve"
32433243 filename="src/graphene-matrix.c"
32443244 line="499">`true` if the matrix is the identity matrix</doc>
3245- <type name="gboolean" c:type="_Bool"/>
3245+ <type name="gboolean" c:type="bool"/>
32463246 </return-value>
32473247 <parameters>
32483248 <instance-parameter name="m" transfer-ownership="none">
@@ -3264,7 +3264,7 @@ a 2D affine transformation matrix.</doc>
32643264 <doc xml:space="preserve"
32653265 filename="src/graphene-matrix.c"
32663266 line="583">`true` if the matrix is singular</doc>
3267- <type name="gboolean" c:type="_Bool"/>
3267+ <type name="gboolean" c:type="bool"/>
32683268 </return-value>
32693269 <parameters>
32703270 <instance-parameter name="m" transfer-ownership="none">
@@ -3325,7 +3325,7 @@ other.</doc>
33253325 filename="src/graphene-matrix.c"
33263326 line="2316">`true` if the two matrices are near each other, and
33273327 `false` otherwise</doc>
3328- <type name="gboolean" c:type="_Bool"/>
3328+ <type name="gboolean" c:type="bool"/>
33293329 </return-value>
33303330 <parameters>
33313331 <instance-parameter name="a" transfer-ownership="none">
@@ -3851,7 +3851,7 @@ and an affine matrix type from other libraries.</doc>
38513851 filename="src/graphene-matrix.c"
38523852 line="666">`true` if the matrix is compatible with an affine
38533853 transformation matrix</doc>
3854- <type name="gboolean" c:type="_Bool"/>
3854+ <type name="gboolean" c:type="bool"/>
38553855 </return-value>
38563856 <parameters>
38573857 <instance-parameter name="m" transfer-ownership="none">
@@ -4449,7 +4449,7 @@ given matrix, within the given axis aligned rectangular @bounds.</doc>
44494449 <doc xml:space="preserve"
44504450 filename="src/graphene-matrix.c"
44514451 line="1294">`true` if the point was successfully untransformed</doc>
4452- <type name="gboolean" c:type="_Bool"/>
4452+ <type name="gboolean" c:type="bool"/>
44534453 </return-value>
44544454 <parameters>
44554455 <instance-parameter name="m" transfer-ownership="none">
@@ -4628,7 +4628,7 @@ The contents of the returned structure are undefined.</doc>
46284628 <doc xml:space="preserve"
46294629 filename="src/graphene-plane.c"
46304630 line="338">`true` if the given planes are equal</doc>
4631- <type name="gboolean" c:type="_Bool"/>
4631+ <type name="gboolean" c:type="bool"/>
46324632 </return-value>
46334633 <parameters>
46344634 <instance-parameter name="a" transfer-ownership="none">
@@ -5119,7 +5119,7 @@ graphene_point_near() instead.</doc>
51195119 <doc xml:space="preserve"
51205120 filename="src/graphene-point.c"
51215121 line="185">`true` if the points have the same coordinates</doc>
5122- <type name="gboolean" c:type="_Bool"/>
5122+ <type name="gboolean" c:type="bool"/>
51235123 </return-value>
51245124 <parameters>
51255125 <instance-parameter name="a" transfer-ownership="none">
@@ -5295,7 +5295,7 @@ the threshold of @epsilon.</doc>
52955295 <doc xml:space="preserve"
52965296 filename="src/graphene-point.c"
52975297 line="240">`true` if the distance is within @epsilon</doc>
5298- <type name="gboolean" c:type="_Bool"/>
5298+ <type name="gboolean" c:type="bool"/>
52995299 </return-value>
53005300 <parameters>
53015301 <instance-parameter name="a" transfer-ownership="none">
@@ -5512,7 +5512,7 @@ the threshold of @epsilon.</doc>
55125512 <doc xml:space="preserve"
55135513 filename="src/graphene-point3d.c"
55145514 line="199">`true` if the points are equal</doc>
5515- <type name="gboolean" c:type="_Bool"/>
5515+ <type name="gboolean" c:type="bool"/>
55165516 </return-value>
55175517 <parameters>
55185518 <instance-parameter name="a" transfer-ownership="none">
@@ -5717,7 +5717,7 @@ an @epsilon factor.</doc>
57175717 <doc xml:space="preserve"
57185718 filename="src/graphene-point3d.c"
57195719 line="219">`true` if the points are near each other</doc>
5720- <type name="gboolean" c:type="_Bool"/>
5720+ <type name="gboolean" c:type="bool"/>
57215721 </return-value>
57225722 <parameters>
57235723 <instance-parameter name="a" transfer-ownership="none">
@@ -5969,7 +5969,7 @@ The contents of the returned instance are undefined.</doc>
59695969 <doc xml:space="preserve"
59705970 filename="src/graphene-quad.c"
59715971 line="155">`true` if the point is inside the #graphene_quad_t</doc>
5972- <type name="gboolean" c:type="_Bool"/>
5972+ <type name="gboolean" c:type="bool"/>
59735973 </return-value>
59745974 <parameters>
59755975 <instance-parameter name="q" transfer-ownership="none">
@@ -6247,7 +6247,7 @@ The contents of the returned value are undefined.</doc>
62476247 <doc xml:space="preserve"
62486248 filename="src/graphene-quaternion.c"
62496249 line="586">`true` if the quaternions are equal</doc>
6250- <type name="gboolean" c:type="_Bool"/>
6250+ <type name="gboolean" c:type="bool"/>
62516251 </return-value>
62526252 <parameters>
62536253 <instance-parameter name="a" transfer-ownership="none">
@@ -7047,7 +7047,7 @@ The contents of the returned structure are undefined.</doc>
70477047 <doc xml:space="preserve"
70487048 filename="src/graphene-ray.c"
70497049 line="327">`true` if the given rays are equal</doc>
7050- <type name="gboolean" c:type="_Bool"/>
7050+ <type name="gboolean" c:type="bool"/>
70517051 </return-value>
70527052 <parameters>
70537053 <instance-parameter name="a" transfer-ownership="none">
@@ -7510,7 +7510,7 @@ See also: graphene_ray_intersect_box()</doc>
75107510 <doc xml:space="preserve"
75117511 filename="src/graphene-ray.c"
75127512 line="582">`true` if the ray intersects the box</doc>
7513- <type name="gboolean" c:type="_Bool"/>
7513+ <type name="gboolean" c:type="bool"/>
75147514 </return-value>
75157515 <parameters>
75167516 <instance-parameter name="r" transfer-ownership="none">
@@ -7541,7 +7541,7 @@ See also: graphene_ray_intersect_sphere()</doc>
75417541 <doc xml:space="preserve"
75427542 filename="src/graphene-ray.c"
75437543 line="454">`true` if the ray intersects the sphere</doc>
7544- <type name="gboolean" c:type="_Bool"/>
7544+ <type name="gboolean" c:type="bool"/>
75457545 </return-value>
75467546 <parameters>
75477547 <instance-parameter name="r" transfer-ownership="none">
@@ -7572,7 +7572,7 @@ See also: graphene_ray_intersect_triangle()</doc>
75727572 <doc xml:space="preserve"
75737573 filename="src/graphene-ray.c"
75747574 line="703">`true` if the ray intersects the triangle</doc>
7575- <type name="gboolean" c:type="_Bool"/>
7575+ <type name="gboolean" c:type="bool"/>
75767576 </return-value>
75777577 <parameters>
75787578 <instance-parameter name="r" transfer-ownership="none">
@@ -7665,7 +7665,7 @@ will internally operate on a normalized copy; all functions returning a
76657665 <doc xml:space="preserve"
76667666 filename="src/graphene-rect.c"
76677667 line="552">`true` if the rectangle contains the point</doc>
7668- <type name="gboolean" c:type="_Bool"/>
7668+ <type name="gboolean" c:type="bool"/>
76697669 </return-value>
76707670 <parameters>
76717671 <instance-parameter name="r" transfer-ownership="none">
@@ -7694,7 +7694,7 @@ rectangle.</doc>
76947694 <doc xml:space="preserve"
76957695 filename="src/graphene-rect.c"
76967696 line="579">`true` if the rectangle @a fully contains @b</doc>
7697- <type name="gboolean" c:type="_Bool"/>
7697+ <type name="gboolean" c:type="bool"/>
76987698 </return-value>
76997699 <parameters>
77007700 <instance-parameter name="a" transfer-ownership="none">
@@ -7720,7 +7720,7 @@ rectangle.</doc>
77207720 <doc xml:space="preserve"
77217721 filename="src/graphene-rect.c"
77227722 line="184">`true` if the rectangles are equal</doc>
7723- <type name="gboolean" c:type="_Bool"/>
7723+ <type name="gboolean" c:type="bool"/>
77247724 </return-value>
77257725 <parameters>
77267726 <instance-parameter name="a" transfer-ownership="none">
@@ -8303,7 +8303,7 @@ a degenerate rectangle with origin in (0, 0) and a size of 0.</doc>
83038303 <doc xml:space="preserve"
83048304 filename="src/graphene-rect.c"
83058305 line="508">`true` if the two rectangles intersect</doc>
8306- <type name="gboolean" c:type="_Bool"/>
8306+ <type name="gboolean" c:type="bool"/>
83078307 </return-value>
83088308 <parameters>
83098309 <instance-parameter name="a" transfer-ownership="none">
@@ -8791,7 +8791,7 @@ The contents of the returned value are undefined.</doc>
87918791 <doc xml:space="preserve"
87928792 filename="src/graphene-size.c"
87938793 line="133">`true` if the sizes are equal</doc>
8794- <type name="gboolean" c:type="_Bool"/>
8794+ <type name="gboolean" c:type="bool"/>
87958795 </return-value>
87968796 <parameters>
87978797 <instance-parameter name="a" transfer-ownership="none">
@@ -9018,7 +9018,7 @@ of a #graphene_sphere_t.</doc>
90189018 <doc xml:space="preserve"
90199019 filename="src/graphene-sphere.c"
90209020 line="269">`true` if the sphere contains the point</doc>
9021- <type name="gboolean" c:type="_Bool"/>
9021+ <type name="gboolean" c:type="bool"/>
90229022 </return-value>
90239023 <parameters>
90249024 <instance-parameter name="s" transfer-ownership="none">
@@ -9073,7 +9073,7 @@ a #graphene_sphere_t.</doc>
90739073 <doc xml:space="preserve"
90749074 filename="src/graphene-sphere.c"
90759075 line="370">`true` if the spheres are equal</doc>
9076- <type name="gboolean" c:type="_Bool"/>
9076+ <type name="gboolean" c:type="bool"/>
90779077 </return-value>
90789078 <parameters>
90799079 <instance-parameter name="a" transfer-ownership="none">
@@ -9333,7 +9333,7 @@ of the 3D volume that encompasses all @vectors.</doc>
93339333 <doc xml:space="preserve"
93349334 filename="src/graphene-sphere.c"
93359335 line="251">`true` if the sphere is empty</doc>
9336- <type name="gboolean" c:type="_Bool"/>
9336+ <type name="gboolean" c:type="bool"/>
93379337 </return-value>
93389338 <parameters>
93399339 <instance-parameter name="s" transfer-ownership="none">
@@ -9428,7 +9428,7 @@ The contents of the returned structure are undefined.</doc>
94289428 <doc xml:space="preserve"
94299429 filename="src/graphene-triangle.c"
94309430 line="497">`true` if the point is inside the triangle</doc>
9431- <type name="gboolean" c:type="_Bool"/>
9431+ <type name="gboolean" c:type="bool"/>
94329432 </return-value>
94339433 <parameters>
94349434 <instance-parameter name="t" transfer-ownership="none">
@@ -9456,7 +9456,7 @@ The contents of the returned structure are undefined.</doc>
94569456 <doc xml:space="preserve"
94579457 filename="src/graphene-triangle.c"
94589458 line="540">`true` if the triangles are equal</doc>
9459- <type name="gboolean" c:type="_Bool"/>
9459+ <type name="gboolean" c:type="bool"/>
94609460 </return-value>
94619461 <parameters>
94629462 <instance-parameter name="a" transfer-ownership="none">
@@ -9538,7 +9538,7 @@ The returned #graphene_vec2_t contains the following values, in order:
95389538 <doc xml:space="preserve"
95399539 filename="src/graphene-triangle.c"
95409540 line="445">`true` if the barycentric coordinates are valid</doc>
9541- <type name="gboolean" c:type="_Bool"/>
9541+ <type name="gboolean" c:type="bool"/>
95429542 </return-value>
95439543 <parameters>
95449544 <instance-parameter name="t" transfer-ownership="none">
@@ -9762,7 +9762,7 @@ See also: graphene_triangle_get_barycoords()</doc>
97629762 <doc xml:space="preserve"
97639763 filename="src/graphene-triangle.c"
97649764 line="378">`true` if the coordinates are valid</doc>
9765- <type name="gboolean" c:type="_Bool"/>
9765+ <type name="gboolean" c:type="bool"/>
97669766 </return-value>
97679767 <parameters>
97689768 <instance-parameter name="t" transfer-ownership="none">
@@ -10229,7 +10229,7 @@ vector @res.</doc>
1022910229 <doc xml:space="preserve"
1023010230 filename="src/graphene-vectors.c"
1023110231 line="428">`true` if the two vectors are equal, and false otherwise</doc>
10232- <type name="gboolean" c:type="_Bool"/>
10232+ <type name="gboolean" c:type="bool"/>
1023310233 </return-value>
1023410234 <parameters>
1023510235 <instance-parameter name="v1" transfer-ownership="none">
@@ -10567,7 +10567,7 @@ whether their values are within the given @epsilon.</doc>
1056710567 <doc xml:space="preserve"
1056810568 filename="src/graphene-vectors.c"
1056910569 line="448">`true` if the two vectors are near each other</doc>
10570- <type name="gboolean" c:type="_Bool"/>
10570+ <type name="gboolean" c:type="bool"/>
1057110571 </return-value>
1057210572 <parameters>
1057310573 <instance-parameter name="v1" transfer-ownership="none">
@@ -10965,7 +10965,7 @@ vector @res.</doc>
1096510965 <doc xml:space="preserve"
1096610966 filename="src/graphene-vectors.c"
1096710967 line="1127">`true` if the two vectors are equal, and false otherwise</doc>
10968- <type name="gboolean" c:type="_Bool"/>
10968+ <type name="gboolean" c:type="bool"/>
1096910969 </return-value>
1097010970 <parameters>
1097110971 <instance-parameter name="v1" transfer-ownership="none">
@@ -11478,7 +11478,7 @@ whether their values are within the given @epsilon.</doc>
1147811478 <doc xml:space="preserve"
1147911479 filename="src/graphene-vectors.c"
1148011480 line="1147">`true` if the two vectors are near each other</doc>
11481- <type name="gboolean" c:type="_Bool"/>
11481+ <type name="gboolean" c:type="bool"/>
1148211482 </return-value>
1148311483 <parameters>
1148411484 <instance-parameter name="v1" transfer-ownership="none">
@@ -11862,7 +11862,7 @@ vector @res.</doc>
1186211862 <doc xml:space="preserve"
1186311863 filename="src/graphene-vectors.c"
1186411864 line="1844">`true` if the two vectors are equal, and false otherwise</doc>
11865- <type name="gboolean" c:type="_Bool"/>
11865+ <type name="gboolean" c:type="bool"/>
1186611866 </return-value>
1186711867 <parameters>
1186811868 <instance-parameter name="v1" transfer-ownership="none">
@@ -12384,7 +12384,7 @@ whether their values are within the given @epsilon.</doc>
1238412384 <doc xml:space="preserve"
1238512385 filename="src/graphene-vectors.c"
1238612386 line="1864">`true` if the two vectors are near each other</doc>
12387- <type name="gboolean" c:type="_Bool"/>
12387+ <type name="gboolean" c:type="bool"/>
1238812388 </return-value>
1238912389 <parameters>
1239012390 <instance-parameter name="v1" transfer-ownership="none">
M internal/gir/spec/Gsk-4.0.gir +1618 -900 large diff (2518 lines changed): collapsed
load diff
M internal/gir/spec/Gtk-4.0.gir +6425 -5494 large diff (11919 lines changed): collapsed
load diff
M internal/gir/spec/Pango-1.0.gir +1040 -921
@@ -13,7 +13,7 @@ and/or use gtk-doc annotations. -->
1313 <include name="cairo" version="1.0"/>
1414 <package name="pango"/>
1515 <c:include name="pango/pango.h"/>
16- <doc:format name="unknown"/>
16+ <doc:format name="gi-docgen"/>
1717 <namespace name="Pango"
1818 version="1.0"
1919 shared-library="libpango-1.0.so.0"
@@ -1941,6 +1941,8 @@ by using [func@Pango.AttrType.get_name].</doc>
19411941 </enumeration>
19421942 <record name="Attribute"
19431943 c:type="PangoAttribute"
1944+ copy-function="pango_attribute_copy"
1945+ free-function="pango_attribute_destroy"
19441946 glib:type-name="PangoAttribute"
19451947 glib:get-type="pango_attribute_get_type"
19461948 c:symbol-prefix="attribute">
@@ -4004,7 +4006,7 @@ with an ellipsis.</doc>
40044006 </member>
40054007 </enumeration>
40064008 <function-macro name="FONT" c:identifier="PANGO_FONT" introspectable="0">
4007- <source-position filename="pango/pango-font.h" line="570"/>
4009+ <source-position filename="pango/pango-font.h" line="600"/>
40084010 <parameters>
40094011 <parameter name="object">
40104012 </parameter>
@@ -4049,7 +4051,7 @@ with an ellipsis.</doc>
40494051 <function-macro name="FONT_CLASS"
40504052 c:identifier="PANGO_FONT_CLASS"
40514053 introspectable="0">
4052- <source-position filename="pango/pango-font.h" line="572"/>
4054+ <source-position filename="pango/pango-font.h" line="602"/>
40534055 <parameters>
40544056 <parameter name="klass">
40554057 </parameter>
@@ -4058,7 +4060,7 @@ with an ellipsis.</doc>
40584060 <function-macro name="FONT_FACE"
40594061 c:identifier="PANGO_FONT_FACE"
40604062 introspectable="0">
4061- <source-position filename="pango/pango-font.h" line="503"/>
4063+ <source-position filename="pango/pango-font.h" line="533"/>
40624064 <parameters>
40634065 <parameter name="object">
40644066 </parameter>
@@ -4067,7 +4069,7 @@ with an ellipsis.</doc>
40674069 <function-macro name="FONT_FACE_CLASS"
40684070 c:identifier="PANGO_FONT_FACE_CLASS"
40694071 introspectable="0">
4070- <source-position filename="pango/pango-font.h" line="505"/>
4072+ <source-position filename="pango/pango-font.h" line="535"/>
40714073 <parameters>
40724074 <parameter name="klass">
40734075 </parameter>
@@ -4076,7 +4078,7 @@ with an ellipsis.</doc>
40764078 <function-macro name="FONT_FACE_GET_CLASS"
40774079 c:identifier="PANGO_FONT_FACE_GET_CLASS"
40784080 introspectable="0">
4079- <source-position filename="pango/pango-font.h" line="507"/>
4081+ <source-position filename="pango/pango-font.h" line="537"/>
40804082 <parameters>
40814083 <parameter name="obj">
40824084 </parameter>
@@ -4085,7 +4087,7 @@ with an ellipsis.</doc>
40854087 <function-macro name="FONT_FAMILY"
40864088 c:identifier="PANGO_FONT_FAMILY"
40874089 introspectable="0">
4088- <source-position filename="pango/pango-font.h" line="428"/>
4090+ <source-position filename="pango/pango-font.h" line="458"/>
40894091 <parameters>
40904092 <parameter name="object">
40914093 </parameter>
@@ -4094,7 +4096,7 @@ with an ellipsis.</doc>
40944096 <function-macro name="FONT_FAMILY_CLASS"
40954097 c:identifier="PANGO_FONT_FAMILY_CLASS"
40964098 introspectable="0">
4097- <source-position filename="pango/pango-font.h" line="430"/>
4099+ <source-position filename="pango/pango-font.h" line="460"/>
40984100 <parameters>
40994101 <parameter name="klass">
41004102 </parameter>
@@ -4103,7 +4105,7 @@ with an ellipsis.</doc>
41034105 <function-macro name="FONT_FAMILY_GET_CLASS"
41044106 c:identifier="PANGO_FONT_FAMILY_GET_CLASS"
41054107 introspectable="0">
4106- <source-position filename="pango/pango-font.h" line="432"/>
4108+ <source-position filename="pango/pango-font.h" line="462"/>
41074109 <parameters>
41084110 <parameter name="obj">
41094111 </parameter>
@@ -4112,7 +4114,7 @@ with an ellipsis.</doc>
41124114 <function-macro name="FONT_GET_CLASS"
41134115 c:identifier="PANGO_FONT_GET_CLASS"
41144116 introspectable="0">
4115- <source-position filename="pango/pango-font.h" line="574"/>
4117+ <source-position filename="pango/pango-font.h" line="604"/>
41164118 <parameters>
41174119 <parameter name="obj">
41184120 </parameter>
@@ -4155,18 +4157,18 @@ with an ellipsis.</doc>
41554157 glib:type-struct="FontClass">
41564158 <doc xml:space="preserve"
41574159 filename="pango/pango-font.h"
4158- line="579">A `PangoFont` is used to represent a font in a
4160+ line="609">A `PangoFont` is used to represent a font in a
41594161 rendering-system-independent manner.</doc>
4160- <source-position filename="pango/pango-font.h" line="613"/>
4162+ <source-position filename="pango/pango-font.h" line="643"/>
41614163 <function name="descriptions_free"
41624164 c:identifier="pango_font_descriptions_free"
41634165 deprecated="1"
41644166 deprecated-version="1.56">
41654167 <doc xml:space="preserve"
41664168 filename="pango/fonts.c"
4167- line="1120">Frees an array of font descriptions.</doc>
4169+ line="1173">Frees an array of font descriptions.</doc>
41684170 <doc-deprecated xml:space="preserve">Just use pango_font_description_free in a loop</doc-deprecated>
4169- <source-position filename="pango/pango-font.h" line="283"/>
4171+ <source-position filename="pango/pango-font.h" line="307"/>
41704172 <return-value transfer-ownership="none">
41714173 <type name="none" c:type="void"/>
41724174 </return-value>
@@ -4177,7 +4179,7 @@ rendering-system-independent manner.</doc>
41774179 allow-none="1">
41784180 <doc xml:space="preserve"
41794181 filename="pango/fonts.c"
4180- line="1122">a pointer
4182+ line="1175">a pointer
41814183 to an array of `PangoFontDescription`, may be %NULL</doc>
41824184 <array length="1"
41834185 zero-terminated="0"
@@ -4188,7 +4190,7 @@ rendering-system-independent manner.</doc>
41884190 <parameter name="n_descs" transfer-ownership="none">
41894191 <doc xml:space="preserve"
41904192 filename="pango/fonts.c"
4191- line="1124">number of font descriptions in @descs</doc>
4193+ line="1177">number of font descriptions in @descs</doc>
41924194 <type name="gint" c:type="int"/>
41934195 </parameter>
41944196 </parameters>
@@ -4206,7 +4208,7 @@ For a discussion of the supported format, see that function.
42064208 Note: to verify that the returned font is identical to
42074209 the one that was serialized, you can compare @bytes to the
42084210 result of serializing the font again.</doc>
4209- <source-position filename="pango/pango-font.h" line="665"/>
4211+ <source-position filename="pango/pango-font.h" line="695"/>
42104212 <return-value transfer-ownership="full" nullable="1">
42114213 <doc xml:space="preserve"
42124214 filename="pango/serializer.c"
@@ -4229,7 +4231,7 @@ result of serializing the font again.</doc>
42294231 </parameters>
42304232 </function>
42314233 <virtual-method name="create_hb_font">
4232- <source-position filename="pango/pango-font.h" line="612"/>
4234+ <source-position filename="pango/pango-font.h" line="642"/>
42334235 <return-value transfer-ownership="full">
42344236 <type name="HarfBuzz.font_t" c:type="hb_font_t*"/>
42354237 </return-value>
@@ -4242,28 +4244,28 @@ result of serializing the font again.</doc>
42424244 <virtual-method name="describe" invoker="describe">
42434245 <doc xml:space="preserve"
42444246 filename="pango/fonts.c"
4245- line="2103">Returns a description of the font, with font size set in points.
4247+ line="2170">Returns a description of the font, with font size set in points.
42464248
42474249 Use [method@Pango.Font.describe_with_absolute_size] if you want
42484250 the font size in device units.</doc>
4249- <source-position filename="pango/pango-font.h" line="597"/>
4251+ <source-position filename="pango/pango-font.h" line="627"/>
42504252 <return-value transfer-ownership="full">
42514253 <doc xml:space="preserve"
42524254 filename="pango/fonts.c"
4253- line="2112">a newly-allocated `PangoFontDescription` object.</doc>
4255+ line="2179">a newly-allocated `PangoFontDescription` object.</doc>
42544256 <type name="FontDescription" c:type="PangoFontDescription*"/>
42554257 </return-value>
42564258 <parameters>
42574259 <instance-parameter name="font" transfer-ownership="none">
42584260 <doc xml:space="preserve"
42594261 filename="pango/fonts.c"
4260- line="2105">a `PangoFont`</doc>
4262+ line="2172">a `PangoFont`</doc>
42614263 <type name="Font" c:type="PangoFont*"/>
42624264 </instance-parameter>
42634265 </parameters>
42644266 </virtual-method>
42654267 <virtual-method name="describe_absolute">
4266- <source-position filename="pango/pango-font.h" line="607"/>
4268+ <source-position filename="pango/pango-font.h" line="637"/>
42674269 <return-value transfer-ownership="full">
42684270 <type name="FontDescription" c:type="PangoFontDescription*"/>
42694271 </return-value>
@@ -4276,12 +4278,12 @@ the font size in device units.</doc>
42764278 <virtual-method name="get_coverage" invoker="get_coverage">
42774279 <doc xml:space="preserve"
42784280 filename="pango/fonts.c"
4279- line="2149">Computes the coverage map for a given font and language tag.</doc>
4280- <source-position filename="pango/pango-font.h" line="598"/>
4281+ line="2216">Computes the coverage map for a given font and language tag.</doc>
4282+ <source-position filename="pango/pango-font.h" line="628"/>
42814283 <return-value transfer-ownership="full">
42824284 <doc xml:space="preserve"
42834285 filename="pango/fonts.c"
4284- line="2156">a newly-allocated `PangoCoverage`
4286+ line="2223">a newly-allocated `PangoCoverage`
42854287 object.</doc>
42864288 <type name="Coverage" c:type="PangoCoverage*"/>
42874289 </return-value>
@@ -4289,13 +4291,13 @@ the font size in device units.</doc>
42894291 <instance-parameter name="font" transfer-ownership="none">
42904292 <doc xml:space="preserve"
42914293 filename="pango/fonts.c"
4292- line="2151">a `PangoFont`</doc>
4294+ line="2218">a `PangoFont`</doc>
42934295 <type name="Font" c:type="PangoFont*"/>
42944296 </instance-parameter>
42954297 <parameter name="language" transfer-ownership="none">
42964298 <doc xml:space="preserve"
42974299 filename="pango/fonts.c"
4298- line="2152">the language tag</doc>
4300+ line="2219">the language tag</doc>
42994301 <type name="Language" c:type="PangoLanguage*"/>
43004302 </parameter>
43014303 </parameters>
@@ -4305,14 +4307,14 @@ the font size in device units.</doc>
43054307 version="1.44">
43064308 <doc xml:space="preserve"
43074309 filename="pango/fonts.c"
4308- line="3127">Obtain the OpenType features that are provided by the font.
4310+ line="3201">Obtain the OpenType features that are provided by the font.
43094311
43104312 These are passed to the rendering system, together with features
43114313 that have been explicitly set via attributes.
43124314
43134315 Note that this does not include OpenType features which the
43144316 rendering system enables by default.</doc>
4315- <source-position filename="pango/pango-font.h" line="608"/>
4317+ <source-position filename="pango/pango-font.h" line="638"/>
43164318 <return-value transfer-ownership="none">
43174319 <type name="none" c:type="void"/>
43184320 </return-value>
@@ -4320,7 +4322,7 @@ rendering system enables by default.</doc>
43204322 <instance-parameter name="font" transfer-ownership="none">
43214323 <doc xml:space="preserve"
43224324 filename="pango/fonts.c"
4323- line="3129">a `PangoFont`</doc>
4325+ line="3203">a `PangoFont`</doc>
43244326 <type name="Font" c:type="PangoFont*"/>
43254327 </instance-parameter>
43264328 <parameter name="features"
@@ -4329,7 +4331,7 @@ rendering system enables by default.</doc>
43294331 transfer-ownership="none">
43304332 <doc xml:space="preserve"
43314333 filename="pango/fonts.c"
4332- line="3130">Array to features in</doc>
4334+ line="3204">Array to features in</doc>
43334335 <array length="1" zero-terminated="0" c:type="hb_feature_t*">
43344336 <type name="HarfBuzz.feature_t" c:type="hb_feature_t"/>
43354337 </array>
@@ -4337,7 +4339,7 @@ rendering system enables by default.</doc>
43374339 <parameter name="len" transfer-ownership="none">
43384340 <doc xml:space="preserve"
43394341 filename="pango/fonts.c"
4340- line="3131">the length of @features</doc>
4342+ line="3205">the length of @features</doc>
43414343 <type name="guint" c:type="guint"/>
43424344 </parameter>
43434345 <parameter name="num_features"
@@ -4346,7 +4348,7 @@ rendering system enables by default.</doc>
43464348 transfer-ownership="full">
43474349 <doc xml:space="preserve"
43484350 filename="pango/fonts.c"
4349- line="3132">the number of used items in @features</doc>
4351+ line="3206">the number of used items in @features</doc>
43504352 <type name="guint" c:type="guint*"/>
43514353 </parameter>
43524354 </parameters>
@@ -4356,7 +4358,7 @@ rendering system enables by default.</doc>
43564358 version="1.10">
43574359 <doc xml:space="preserve"
43584360 filename="pango/fonts.c"
4359- line="2278">Gets the font map for which the font was created.
4361+ line="2345">Gets the font map for which the font was created.
43604362
43614363 Note that the font maintains a *weak* reference to
43624364 the font map, so if all references to font map are
@@ -4367,11 +4369,11 @@ In that case this function will return %NULL.
43674369 It is the responsibility of the user to ensure that the
43684370 font map is kept alive. In most uses this is not an issue
43694371 as a `PangoContext` holds a reference to the font map.</doc>
4370- <source-position filename="pango/pango-font.h" line="606"/>
4372+ <source-position filename="pango/pango-font.h" line="636"/>
43714373 <return-value transfer-ownership="none" nullable="1">
43724374 <doc xml:space="preserve"
43734375 filename="pango/fonts.c"
4374- line="2294">the `PangoFontMap`
4376+ line="2361">the `PangoFontMap`
43754377 for the font</doc>
43764378 <type name="FontMap" c:type="PangoFontMap*"/>
43774379 </return-value>
@@ -4382,7 +4384,7 @@ as a `PangoContext` holds a reference to the font map.</doc>
43824384 allow-none="1">
43834385 <doc xml:space="preserve"
43844386 filename="pango/fonts.c"
4385- line="2280">a `PangoFont`</doc>
4387+ line="2347">a `PangoFont`</doc>
43864388 <type name="Font" c:type="PangoFont*"/>
43874389 </instance-parameter>
43884390 </parameters>
@@ -4390,7 +4392,7 @@ as a `PangoContext` holds a reference to the font map.</doc>
43904392 <virtual-method name="get_glyph_extents" invoker="get_glyph_extents">
43914393 <doc xml:space="preserve"
43924394 filename="pango/fonts.c"
4393- line="2188">Gets the logical and ink extents of a glyph within a font.
4395+ line="2255">Gets the logical and ink extents of a glyph within a font.
43944396
43954397 The coordinate system for each rectangle has its origin at the
43964398 base line and horizontal origin of the character with increasing
@@ -4401,7 +4403,7 @@ of the rectangles are in 1/PANGO_SCALE of a device unit.
44014403
44024404 If @font is %NULL, this function gracefully sets some sane values in the
44034405 output variables and returns.</doc>
4404- <source-position filename="pango/pango-font.h" line="600"/>
4406+ <source-position filename="pango/pango-font.h" line="630"/>
44054407 <return-value transfer-ownership="none">
44064408 <type name="none" c:type="void"/>
44074409 </return-value>
@@ -4412,13 +4414,13 @@ output variables and returns.</doc>
44124414 allow-none="1">
44134415 <doc xml:space="preserve"
44144416 filename="pango/fonts.c"
4415- line="2190">a `PangoFont`</doc>
4417+ line="2257">a `PangoFont`</doc>
44164418 <type name="Font" c:type="PangoFont*"/>
44174419 </instance-parameter>
44184420 <parameter name="glyph" transfer-ownership="none">
44194421 <doc xml:space="preserve"
44204422 filename="pango/fonts.c"
4421- line="2191">the glyph index</doc>
4423+ line="2258">the glyph index</doc>
44224424 <type name="Glyph" c:type="PangoGlyph"/>
44234425 </parameter>
44244426 <parameter name="ink_rect"
@@ -4429,7 +4431,7 @@ output variables and returns.</doc>
44294431 allow-none="1">
44304432 <doc xml:space="preserve"
44314433 filename="pango/fonts.c"
4432- line="2192">rectangle used to store the extents of the glyph as drawn</doc>
4434+ line="2259">rectangle used to store the extents of the glyph as drawn</doc>
44334435 <type name="Rectangle" c:type="PangoRectangle*"/>
44344436 </parameter>
44354437 <parameter name="logical_rect"
@@ -4440,7 +4442,7 @@ output variables and returns.</doc>
44404442 allow-none="1">
44414443 <doc xml:space="preserve"
44424444 filename="pango/fonts.c"
4443- line="2193">rectangle used to store the logical extents of the glyph</doc>
4445+ line="2260">rectangle used to store the logical extents of the glyph</doc>
44444446 <type name="Rectangle" c:type="PangoRectangle*"/>
44454447 </parameter>
44464448 </parameters>
@@ -4448,7 +4450,7 @@ output variables and returns.</doc>
44484450 <virtual-method name="get_metrics" invoker="get_metrics">
44494451 <doc xml:space="preserve"
44504452 filename="pango/fonts.c"
4451- line="2235">Gets overall metric information for a font.
4453+ line="2302">Gets overall metric information for a font.
44524454
44534455 Since the metrics may be substantially different for different scripts,
44544456 a language tag can be provided to indicate that the metrics should be
@@ -4456,11 +4458,11 @@ retrieved that correspond to the script(s) used by that language.
44564458
44574459 If @font is %NULL, this function gracefully sets some sane values in the
44584460 output variables and returns.</doc>
4459- <source-position filename="pango/pango-font.h" line="604"/>
4461+ <source-position filename="pango/pango-font.h" line="634"/>
44604462 <return-value transfer-ownership="full">
44614463 <doc xml:space="preserve"
44624464 filename="pango/fonts.c"
4463- line="2251">a `PangoFontMetrics` object. The caller must call
4465+ line="2318">a `PangoFontMetrics` object. The caller must call
44644466 [method@Pango.FontMetrics.unref] when finished using the object.</doc>
44654467 <type name="FontMetrics" c:type="PangoFontMetrics*"/>
44664468 </return-value>
@@ -4471,7 +4473,7 @@ output variables and returns.</doc>
44714473 allow-none="1">
44724474 <doc xml:space="preserve"
44734475 filename="pango/fonts.c"
4474- line="2237">a `PangoFont`</doc>
4476+ line="2304">a `PangoFont`</doc>
44754477 <type name="Font" c:type="PangoFont*"/>
44764478 </instance-parameter>
44774479 <parameter name="language"
@@ -4480,7 +4482,7 @@ output variables and returns.</doc>
44804482 allow-none="1">
44814483 <doc xml:space="preserve"
44824484 filename="pango/fonts.c"
4483- line="2238">language tag used to determine which script
4485+ line="2305">language tag used to determine which script
44844486 to get the metrics for, or %NULL to indicate to get the metrics for
44854487 the entire font.</doc>
44864488 <type name="Language" c:type="PangoLanguage*"/>
@@ -4490,22 +4492,22 @@ output variables and returns.</doc>
44904492 <method name="describe" c:identifier="pango_font_describe">
44914493 <doc xml:space="preserve"
44924494 filename="pango/fonts.c"
4493- line="2103">Returns a description of the font, with font size set in points.
4495+ line="2170">Returns a description of the font, with font size set in points.
44944496
44954497 Use [method@Pango.Font.describe_with_absolute_size] if you want
44964498 the font size in device units.</doc>
4497- <source-position filename="pango/pango-font.h" line="621"/>
4499+ <source-position filename="pango/pango-font.h" line="651"/>
44984500 <return-value transfer-ownership="full">
44994501 <doc xml:space="preserve"
45004502 filename="pango/fonts.c"
4501- line="2112">a newly-allocated `PangoFontDescription` object.</doc>
4503+ line="2179">a newly-allocated `PangoFontDescription` object.</doc>
45024504 <type name="FontDescription" c:type="PangoFontDescription*"/>
45034505 </return-value>
45044506 <parameters>
45054507 <instance-parameter name="font" transfer-ownership="none">
45064508 <doc xml:space="preserve"
45074509 filename="pango/fonts.c"
4508- line="2105">a `PangoFont`</doc>
4510+ line="2172">a `PangoFont`</doc>
45094511 <type name="Font" c:type="PangoFont*"/>
45104512 </instance-parameter>
45114513 </parameters>
@@ -4515,22 +4517,22 @@ the font size in device units.</doc>
45154517 version="1.14">
45164518 <doc xml:space="preserve"
45174519 filename="pango/fonts.c"
4518- line="2122">Returns a description of the font, with absolute font size set
4520+ line="2189">Returns a description of the font, with absolute font size set
45194521 in device units.
45204522
45214523 Use [method@Pango.Font.describe] if you want the font size in points.</doc>
4522- <source-position filename="pango/pango-font.h" line="623"/>
4524+ <source-position filename="pango/pango-font.h" line="653"/>
45234525 <return-value transfer-ownership="full">
45244526 <doc xml:space="preserve"
45254527 filename="pango/fonts.c"
4526- line="2131">a newly-allocated `PangoFontDescription` object.</doc>
4528+ line="2198">a newly-allocated `PangoFontDescription` object.</doc>
45274529 <type name="FontDescription" c:type="PangoFontDescription*"/>
45284530 </return-value>
45294531 <parameters>
45304532 <instance-parameter name="font" transfer-ownership="none">
45314533 <doc xml:space="preserve"
45324534 filename="pango/fonts.c"
4533- line="2124">a `PangoFont`</doc>
4535+ line="2191">a `PangoFont`</doc>
45344536 <type name="Font" c:type="PangoFont*"/>
45354537 </instance-parameter>
45364538 </parameters>
@@ -4538,12 +4540,12 @@ Use [method@Pango.Font.describe] if you want the font size in points.</doc>
45384540 <method name="get_coverage" c:identifier="pango_font_get_coverage">
45394541 <doc xml:space="preserve"
45404542 filename="pango/fonts.c"
4541- line="2149">Computes the coverage map for a given font and language tag.</doc>
4542- <source-position filename="pango/pango-font.h" line="625"/>
4543+ line="2216">Computes the coverage map for a given font and language tag.</doc>
4544+ <source-position filename="pango/pango-font.h" line="655"/>
45434545 <return-value transfer-ownership="full">
45444546 <doc xml:space="preserve"
45454547 filename="pango/fonts.c"
4546- line="2156">a newly-allocated `PangoCoverage`
4548+ line="2223">a newly-allocated `PangoCoverage`
45474549 object.</doc>
45484550 <type name="Coverage" c:type="PangoCoverage*"/>
45494551 </return-value>
@@ -4551,13 +4553,13 @@ Use [method@Pango.Font.describe] if you want the font size in points.</doc>
45514553 <instance-parameter name="font" transfer-ownership="none">
45524554 <doc xml:space="preserve"
45534555 filename="pango/fonts.c"
4554- line="2151">a `PangoFont`</doc>
4556+ line="2218">a `PangoFont`</doc>
45554557 <type name="Font" c:type="PangoFont*"/>
45564558 </instance-parameter>
45574559 <parameter name="language" transfer-ownership="none">
45584560 <doc xml:space="preserve"
45594561 filename="pango/fonts.c"
4560- line="2152">the language tag</doc>
4562+ line="2219">the language tag</doc>
45614563 <type name="Language" c:type="PangoLanguage*"/>
45624564 </parameter>
45634565 </parameters>
@@ -4567,19 +4569,22 @@ Use [method@Pango.Font.describe] if you want the font size in points.</doc>
45674569 version="1.46">
45684570 <doc xml:space="preserve"
45694571 filename="pango/fonts.c"
4570- line="2311">Gets the `PangoFontFace` to which @font belongs.</doc>
4571- <source-position filename="pango/pango-font.h" line="645"/>
4572- <return-value transfer-ownership="none">
4572+ line="2378">Gets the `PangoFontFace` to which @font belongs.
4573+
4574+Note that this function can return `NULL` in cases
4575+where the font outlives its font map.</doc>
4576+ <source-position filename="pango/pango-font.h" line="675"/>
4577+ <return-value transfer-ownership="none" nullable="1">
45734578 <doc xml:space="preserve"
45744579 filename="pango/fonts.c"
4575- line="2317">the `PangoFontFace`</doc>
4580+ line="2387">the `PangoFontFace`</doc>
45764581 <type name="FontFace" c:type="PangoFontFace*"/>
45774582 </return-value>
45784583 <parameters>
45794584 <instance-parameter name="font" transfer-ownership="none">
45804585 <doc xml:space="preserve"
45814586 filename="pango/fonts.c"
4582- line="2313">a `PangoFont`</doc>
4587+ line="2380">a `PangoFont`</doc>
45834588 <type name="Font" c:type="PangoFont*"/>
45844589 </instance-parameter>
45854590 </parameters>
@@ -4589,14 +4594,14 @@ Use [method@Pango.Font.describe] if you want the font size in points.</doc>
45894594 version="1.44">
45904595 <doc xml:space="preserve"
45914596 filename="pango/fonts.c"
4592- line="3127">Obtain the OpenType features that are provided by the font.
4597+ line="3201">Obtain the OpenType features that are provided by the font.
45934598
45944599 These are passed to the rendering system, together with features
45954600 that have been explicitly set via attributes.
45964601
45974602 Note that this does not include OpenType features which the
45984603 rendering system enables by default.</doc>
4599- <source-position filename="pango/pango-font.h" line="651"/>
4604+ <source-position filename="pango/pango-font.h" line="681"/>
46004605 <return-value transfer-ownership="none">
46014606 <type name="none" c:type="void"/>
46024607 </return-value>
@@ -4604,7 +4609,7 @@ rendering system enables by default.</doc>
46044609 <instance-parameter name="font" transfer-ownership="none">
46054610 <doc xml:space="preserve"
46064611 filename="pango/fonts.c"
4607- line="3129">a `PangoFont`</doc>
4612+ line="3203">a `PangoFont`</doc>
46084613 <type name="Font" c:type="PangoFont*"/>
46094614 </instance-parameter>
46104615 <parameter name="features"
@@ -4613,7 +4618,7 @@ rendering system enables by default.</doc>
46134618 transfer-ownership="none">
46144619 <doc xml:space="preserve"
46154620 filename="pango/fonts.c"
4616- line="3130">Array to features in</doc>
4621+ line="3204">Array to features in</doc>
46174622 <array length="1" zero-terminated="0" c:type="hb_feature_t*">
46184623 <type name="HarfBuzz.feature_t" c:type="hb_feature_t"/>
46194624 </array>
@@ -4621,7 +4626,7 @@ rendering system enables by default.</doc>
46214626 <parameter name="len" transfer-ownership="none">
46224627 <doc xml:space="preserve"
46234628 filename="pango/fonts.c"
4624- line="3131">the length of @features</doc>
4629+ line="3205">the length of @features</doc>
46254630 <type name="guint" c:type="guint"/>
46264631 </parameter>
46274632 <parameter name="num_features"
@@ -4630,7 +4635,7 @@ rendering system enables by default.</doc>
46304635 transfer-ownership="full">
46314636 <doc xml:space="preserve"
46324637 filename="pango/fonts.c"
4633- line="3132">the number of used items in @features</doc>
4638+ line="3206">the number of used items in @features</doc>
46344639 <type name="guint" c:type="guint*"/>
46354640 </parameter>
46364641 </parameters>
@@ -4640,7 +4645,7 @@ rendering system enables by default.</doc>
46404645 version="1.10">
46414646 <doc xml:space="preserve"
46424647 filename="pango/fonts.c"
4643- line="2278">Gets the font map for which the font was created.
4648+ line="2345">Gets the font map for which the font was created.
46444649
46454650 Note that the font maintains a *weak* reference to
46464651 the font map, so if all references to font map are
@@ -4651,11 +4656,11 @@ In that case this function will return %NULL.
46514656 It is the responsibility of the user to ensure that the
46524657 font map is kept alive. In most uses this is not an issue
46534658 as a `PangoContext` holds a reference to the font map.</doc>
4654- <source-position filename="pango/pango-font.h" line="642"/>
4659+ <source-position filename="pango/pango-font.h" line="672"/>
46554660 <return-value transfer-ownership="none" nullable="1">
46564661 <doc xml:space="preserve"
46574662 filename="pango/fonts.c"
4658- line="2294">the `PangoFontMap`
4663+ line="2361">the `PangoFontMap`
46594664 for the font</doc>
46604665 <type name="FontMap" c:type="PangoFontMap*"/>
46614666 </return-value>
@@ -4666,7 +4671,7 @@ as a `PangoContext` holds a reference to the font map.</doc>
46664671 allow-none="1">
46674672 <doc xml:space="preserve"
46684673 filename="pango/fonts.c"
4669- line="2280">a `PangoFont`</doc>
4674+ line="2347">a `PangoFont`</doc>
46704675 <type name="Font" c:type="PangoFont*"/>
46714676 </instance-parameter>
46724677 </parameters>
@@ -4675,7 +4680,7 @@ as a `PangoContext` holds a reference to the font map.</doc>
46754680 c:identifier="pango_font_get_glyph_extents">
46764681 <doc xml:space="preserve"
46774682 filename="pango/fonts.c"
4678- line="2188">Gets the logical and ink extents of a glyph within a font.
4683+ line="2255">Gets the logical and ink extents of a glyph within a font.
46794684
46804685 The coordinate system for each rectangle has its origin at the
46814686 base line and horizontal origin of the character with increasing
@@ -4686,7 +4691,7 @@ of the rectangles are in 1/PANGO_SCALE of a device unit.
46864691
46874692 If @font is %NULL, this function gracefully sets some sane values in the
46884693 output variables and returns.</doc>
4689- <source-position filename="pango/pango-font.h" line="637"/>
4694+ <source-position filename="pango/pango-font.h" line="667"/>
46904695 <return-value transfer-ownership="none">
46914696 <type name="none" c:type="void"/>
46924697 </return-value>
@@ -4697,13 +4702,13 @@ output variables and returns.</doc>
46974702 allow-none="1">
46984703 <doc xml:space="preserve"
46994704 filename="pango/fonts.c"
4700- line="2190">a `PangoFont`</doc>
4705+ line="2257">a `PangoFont`</doc>
47014706 <type name="Font" c:type="PangoFont*"/>
47024707 </instance-parameter>
47034708 <parameter name="glyph" transfer-ownership="none">
47044709 <doc xml:space="preserve"
47054710 filename="pango/fonts.c"
4706- line="2191">the glyph index</doc>
4711+ line="2258">the glyph index</doc>
47074712 <type name="Glyph" c:type="PangoGlyph"/>
47084713 </parameter>
47094714 <parameter name="ink_rect"
@@ -4714,7 +4719,7 @@ output variables and returns.</doc>
47144719 allow-none="1">
47154720 <doc xml:space="preserve"
47164721 filename="pango/fonts.c"
4717- line="2192">rectangle used to store the extents of the glyph as drawn</doc>
4722+ line="2259">rectangle used to store the extents of the glyph as drawn</doc>
47184723 <type name="Rectangle" c:type="PangoRectangle*"/>
47194724 </parameter>
47204725 <parameter name="logical_rect"
@@ -4725,7 +4730,7 @@ output variables and returns.</doc>
47254730 allow-none="1">
47264731 <doc xml:space="preserve"
47274732 filename="pango/fonts.c"
4728- line="2193">rectangle used to store the logical extents of the glyph</doc>
4733+ line="2260">rectangle used to store the logical extents of the glyph</doc>
47294734 <type name="Rectangle" c:type="PangoRectangle*"/>
47304735 </parameter>
47314736 </parameters>
@@ -4736,16 +4741,16 @@ output variables and returns.</doc>
47364741 introspectable="0">
47374742 <doc xml:space="preserve"
47384743 filename="pango/fonts.c"
4739- line="2329">Get a `hb_font_t` object backing this font.
4744+ line="2399">Get a `hb_font_t` object backing this font.
47404745
47414746 Note that the objects returned by this function are cached
47424747 and immutable. If you need to make changes to the `hb_font_t`,
47434748 use [hb_font_create_sub_font()](https://harfbuzz.github.io/harfbuzz-hb-font.html#hb-font-create-sub-font).</doc>
4744- <source-position filename="pango/pango-font.h" line="656"/>
4749+ <source-position filename="pango/pango-font.h" line="686"/>
47454750 <return-value transfer-ownership="none" nullable="1">
47464751 <doc xml:space="preserve"
47474752 filename="pango/fonts.c"
4748- line="2339">the `hb_font_t` object
4753+ line="2409">the `hb_font_t` object
47494754 backing the font</doc>
47504755 <type name="HarfBuzz.font_t" c:type="hb_font_t*"/>
47514756 </return-value>
@@ -4753,7 +4758,7 @@ use [hb_font_create_sub_font()](https://harfbuzz.github.io/harfbuzz-hb-font.html
47534758 <instance-parameter name="font" transfer-ownership="none">
47544759 <doc xml:space="preserve"
47554760 filename="pango/fonts.c"
4756- line="2331">a `PangoFont`</doc>
4761+ line="2401">a `PangoFont`</doc>
47574762 <type name="Font" c:type="PangoFont*"/>
47584763 </instance-parameter>
47594764 </parameters>
@@ -4763,7 +4768,7 @@ use [hb_font_create_sub_font()](https://harfbuzz.github.io/harfbuzz-hb-font.html
47634768 version="1.50">
47644769 <doc xml:space="preserve"
47654770 filename="pango/fonts.c"
4766- line="3154">Returns the languages that are supported by @font.
4771+ line="3228">Returns the languages that are supported by @font.
47674772
47684773 If the font backend does not provide this information,
47694774 %NULL is returned. For the fontconfig backend, this
@@ -4771,11 +4776,11 @@ corresponds to the FC_LANG member of the FcPattern.
47714776
47724777 The returned array is only valid as long as the font
47734778 and its fontmap are valid.</doc>
4774- <source-position filename="pango/pango-font.h" line="659"/>
4779+ <source-position filename="pango/pango-font.h" line="689"/>
47754780 <return-value transfer-ownership="none" nullable="1">
47764781 <doc xml:space="preserve"
47774782 filename="pango/fonts.c"
4778- line="3167">an array of `PangoLanguage`</doc>
4783+ line="3241">an array of `PangoLanguage`</doc>
47794784 <array c:type="PangoLanguage**">
47804785 <type name="Language"/>
47814786 </array>
@@ -4784,7 +4789,7 @@ and its fontmap are valid.</doc>
47844789 <instance-parameter name="font" transfer-ownership="none">
47854790 <doc xml:space="preserve"
47864791 filename="pango/fonts.c"
4787- line="3156">a `PangoFont`</doc>
4792+ line="3230">a `PangoFont`</doc>
47884793 <type name="Font" c:type="PangoFont*"/>
47894794 </instance-parameter>
47904795 </parameters>
@@ -4792,7 +4797,7 @@ and its fontmap are valid.</doc>
47924797 <method name="get_metrics" c:identifier="pango_font_get_metrics">
47934798 <doc xml:space="preserve"
47944799 filename="pango/fonts.c"
4795- line="2235">Gets overall metric information for a font.
4800+ line="2302">Gets overall metric information for a font.
47964801
47974802 Since the metrics may be substantially different for different scripts,
47984803 a language tag can be provided to indicate that the metrics should be
@@ -4800,11 +4805,11 @@ retrieved that correspond to the script(s) used by that language.
48004805
48014806 If @font is %NULL, this function gracefully sets some sane values in the
48024807 output variables and returns.</doc>
4803- <source-position filename="pango/pango-font.h" line="634"/>
4808+ <source-position filename="pango/pango-font.h" line="664"/>
48044809 <return-value transfer-ownership="full">
48054810 <doc xml:space="preserve"
48064811 filename="pango/fonts.c"
4807- line="2251">a `PangoFontMetrics` object. The caller must call
4812+ line="2318">a `PangoFontMetrics` object. The caller must call
48084813 [method@Pango.FontMetrics.unref] when finished using the object.</doc>
48094814 <type name="FontMetrics" c:type="PangoFontMetrics*"/>
48104815 </return-value>
@@ -4815,7 +4820,7 @@ output variables and returns.</doc>
48154820 allow-none="1">
48164821 <doc xml:space="preserve"
48174822 filename="pango/fonts.c"
4818- line="2237">a `PangoFont`</doc>
4823+ line="2304">a `PangoFont`</doc>
48194824 <type name="Font" c:type="PangoFont*"/>
48204825 </instance-parameter>
48214826 <parameter name="language"
@@ -4824,7 +4829,7 @@ output variables and returns.</doc>
48244829 allow-none="1">
48254830 <doc xml:space="preserve"
48264831 filename="pango/fonts.c"
4827- line="2238">language tag used to determine which script
4832+ line="2305">language tag used to determine which script
48284833 to get the metrics for, or %NULL to indicate to get the metrics for
48294834 the entire font.</doc>
48304835 <type name="Language" c:type="PangoLanguage*"/>
@@ -4836,25 +4841,25 @@ output variables and returns.</doc>
48364841 version="1.44">
48374842 <doc xml:space="preserve"
48384843 filename="pango/fonts.c"
4839- line="3107">Returns whether the font provides a glyph for this character.</doc>
4840- <source-position filename="pango/pango-font.h" line="648"/>
4844+ line="3181">Returns whether the font provides a glyph for this character.</doc>
4845+ <source-position filename="pango/pango-font.h" line="678"/>
48414846 <return-value transfer-ownership="none">
48424847 <doc xml:space="preserve"
48434848 filename="pango/fonts.c"
4844- line="3114">`TRUE` if @font can render @wc</doc>
4849+ line="3188">`TRUE` if @font can render @wc</doc>
48454850 <type name="gboolean" c:type="gboolean"/>
48464851 </return-value>
48474852 <parameters>
48484853 <instance-parameter name="font" transfer-ownership="none">
48494854 <doc xml:space="preserve"
48504855 filename="pango/fonts.c"
4851- line="3109">a `PangoFont`</doc>
4856+ line="3183">a `PangoFont`</doc>
48524857 <type name="Font" c:type="PangoFont*"/>
48534858 </instance-parameter>
48544859 <parameter name="wc" transfer-ownership="none">
48554860 <doc xml:space="preserve"
48564861 filename="pango/fonts.c"
4857- line="3110">a Unicode character</doc>
4862+ line="3184">a Unicode character</doc>
48584863 <type name="gunichar" c:type="gunichar"/>
48594864 </parameter>
48604865 </parameters>
@@ -4873,7 +4878,7 @@ The intended use of this function is testing, benchmarking and debugging.
48734878 The format is not meant as a permanent storage format.
48744879
48754880 To recreate a font from its serialized form, use [func@Pango.Font.deserialize].</doc>
4876- <source-position filename="pango/pango-font.h" line="662"/>
4881+ <source-position filename="pango/pango-font.h" line="692"/>
48774882 <return-value transfer-ownership="full">
48784883 <doc xml:space="preserve"
48794884 filename="pango/serializer.c"
@@ -4896,24 +4901,24 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
48964901 <record name="FontClass"
48974902 c:type="PangoFontClass"
48984903 glib:is-gtype-struct-for="Font">
4899- <source-position filename="pango/pango-font.h" line="613"/>
4904+ <source-position filename="pango/pango-font.h" line="643"/>
49004905 <field name="parent_class">
49014906 <type name="GObject.ObjectClass" c:type="GObjectClass"/>
49024907 </field>
49034908 <field name="describe">
49044909 <callback name="describe">
4905- <source-position filename="pango/pango-font.h" line="597"/>
4910+ <source-position filename="pango/pango-font.h" line="627"/>
49064911 <return-value transfer-ownership="full">
49074912 <doc xml:space="preserve"
49084913 filename="pango/fonts.c"
4909- line="2112">a newly-allocated `PangoFontDescription` object.</doc>
4914+ line="2179">a newly-allocated `PangoFontDescription` object.</doc>
49104915 <type name="FontDescription" c:type="PangoFontDescription*"/>
49114916 </return-value>
49124917 <parameters>
49134918 <parameter name="font" transfer-ownership="none">
49144919 <doc xml:space="preserve"
49154920 filename="pango/fonts.c"
4916- line="2105">a `PangoFont`</doc>
4921+ line="2172">a `PangoFont`</doc>
49174922 <type name="Font" c:type="PangoFont*"/>
49184923 </parameter>
49194924 </parameters>
@@ -4921,11 +4926,11 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
49214926 </field>
49224927 <field name="get_coverage">
49234928 <callback name="get_coverage">
4924- <source-position filename="pango/pango-font.h" line="598"/>
4929+ <source-position filename="pango/pango-font.h" line="628"/>
49254930 <return-value transfer-ownership="full">
49264931 <doc xml:space="preserve"
49274932 filename="pango/fonts.c"
4928- line="2156">a newly-allocated `PangoCoverage`
4933+ line="2223">a newly-allocated `PangoCoverage`
49294934 object.</doc>
49304935 <type name="Coverage" c:type="PangoCoverage*"/>
49314936 </return-value>
@@ -4933,13 +4938,13 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
49334938 <parameter name="font" transfer-ownership="none">
49344939 <doc xml:space="preserve"
49354940 filename="pango/fonts.c"
4936- line="2151">a `PangoFont`</doc>
4941+ line="2218">a `PangoFont`</doc>
49374942 <type name="Font" c:type="PangoFont*"/>
49384943 </parameter>
49394944 <parameter name="language" transfer-ownership="none">
49404945 <doc xml:space="preserve"
49414946 filename="pango/fonts.c"
4942- line="2152">the language tag</doc>
4947+ line="2219">the language tag</doc>
49434948 <type name="Language" c:type="PangoLanguage*"/>
49444949 </parameter>
49454950 </parameters>
@@ -4947,7 +4952,7 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
49474952 </field>
49484953 <field name="get_glyph_extents">
49494954 <callback name="get_glyph_extents">
4950- <source-position filename="pango/pango-font.h" line="600"/>
4955+ <source-position filename="pango/pango-font.h" line="630"/>
49514956 <return-value transfer-ownership="none">
49524957 <type name="none" c:type="void"/>
49534958 </return-value>
@@ -4958,13 +4963,13 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
49584963 allow-none="1">
49594964 <doc xml:space="preserve"
49604965 filename="pango/fonts.c"
4961- line="2190">a `PangoFont`</doc>
4966+ line="2257">a `PangoFont`</doc>
49624967 <type name="Font" c:type="PangoFont*"/>
49634968 </parameter>
49644969 <parameter name="glyph" transfer-ownership="none">
49654970 <doc xml:space="preserve"
49664971 filename="pango/fonts.c"
4967- line="2191">the glyph index</doc>
4972+ line="2258">the glyph index</doc>
49684973 <type name="Glyph" c:type="PangoGlyph"/>
49694974 </parameter>
49704975 <parameter name="ink_rect"
@@ -4975,7 +4980,7 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
49754980 allow-none="1">
49764981 <doc xml:space="preserve"
49774982 filename="pango/fonts.c"
4978- line="2192">rectangle used to store the extents of the glyph as drawn</doc>
4983+ line="2259">rectangle used to store the extents of the glyph as drawn</doc>
49794984 <type name="Rectangle" c:type="PangoRectangle*"/>
49804985 </parameter>
49814986 <parameter name="logical_rect"
@@ -4986,7 +4991,7 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
49864991 allow-none="1">
49874992 <doc xml:space="preserve"
49884993 filename="pango/fonts.c"
4989- line="2193">rectangle used to store the logical extents of the glyph</doc>
4994+ line="2260">rectangle used to store the logical extents of the glyph</doc>
49904995 <type name="Rectangle" c:type="PangoRectangle*"/>
49914996 </parameter>
49924997 </parameters>
@@ -4994,11 +4999,11 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
49944999 </field>
49955000 <field name="get_metrics">
49965001 <callback name="get_metrics">
4997- <source-position filename="pango/pango-font.h" line="604"/>
5002+ <source-position filename="pango/pango-font.h" line="634"/>
49985003 <return-value transfer-ownership="full">
49995004 <doc xml:space="preserve"
50005005 filename="pango/fonts.c"
5001- line="2251">a `PangoFontMetrics` object. The caller must call
5006+ line="2318">a `PangoFontMetrics` object. The caller must call
50025007 [method@Pango.FontMetrics.unref] when finished using the object.</doc>
50035008 <type name="FontMetrics" c:type="PangoFontMetrics*"/>
50045009 </return-value>
@@ -5009,7 +5014,7 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
50095014 allow-none="1">
50105015 <doc xml:space="preserve"
50115016 filename="pango/fonts.c"
5012- line="2237">a `PangoFont`</doc>
5017+ line="2304">a `PangoFont`</doc>
50135018 <type name="Font" c:type="PangoFont*"/>
50145019 </parameter>
50155020 <parameter name="language"
@@ -5018,7 +5023,7 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
50185023 allow-none="1">
50195024 <doc xml:space="preserve"
50205025 filename="pango/fonts.c"
5021- line="2238">language tag used to determine which script
5026+ line="2305">language tag used to determine which script
50225027 to get the metrics for, or %NULL to indicate to get the metrics for
50235028 the entire font.</doc>
50245029 <type name="Language" c:type="PangoLanguage*"/>
@@ -5028,11 +5033,11 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
50285033 </field>
50295034 <field name="get_font_map">
50305035 <callback name="get_font_map">
5031- <source-position filename="pango/pango-font.h" line="606"/>
5036+ <source-position filename="pango/pango-font.h" line="636"/>
50325037 <return-value transfer-ownership="none" nullable="1">
50335038 <doc xml:space="preserve"
50345039 filename="pango/fonts.c"
5035- line="2294">the `PangoFontMap`
5040+ line="2361">the `PangoFontMap`
50365041 for the font</doc>
50375042 <type name="FontMap" c:type="PangoFontMap*"/>
50385043 </return-value>
@@ -5043,7 +5048,7 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
50435048 allow-none="1">
50445049 <doc xml:space="preserve"
50455050 filename="pango/fonts.c"
5046- line="2280">a `PangoFont`</doc>
5051+ line="2347">a `PangoFont`</doc>
50475052 <type name="Font" c:type="PangoFont*"/>
50485053 </parameter>
50495054 </parameters>
@@ -5051,7 +5056,7 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
50515056 </field>
50525057 <field name="describe_absolute">
50535058 <callback name="describe_absolute">
5054- <source-position filename="pango/pango-font.h" line="607"/>
5059+ <source-position filename="pango/pango-font.h" line="637"/>
50555060 <return-value transfer-ownership="full">
50565061 <type name="FontDescription" c:type="PangoFontDescription*"/>
50575062 </return-value>
@@ -5064,7 +5069,7 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
50645069 </field>
50655070 <field name="get_features">
50665071 <callback name="get_features">
5067- <source-position filename="pango/pango-font.h" line="608"/>
5072+ <source-position filename="pango/pango-font.h" line="638"/>
50685073 <return-value transfer-ownership="none">
50695074 <type name="none" c:type="void"/>
50705075 </return-value>
@@ -5072,7 +5077,7 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
50725077 <parameter name="font" transfer-ownership="none">
50735078 <doc xml:space="preserve"
50745079 filename="pango/fonts.c"
5075- line="3129">a `PangoFont`</doc>
5080+ line="3203">a `PangoFont`</doc>
50765081 <type name="Font" c:type="PangoFont*"/>
50775082 </parameter>
50785083 <parameter name="features"
@@ -5081,7 +5086,7 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
50815086 transfer-ownership="none">
50825087 <doc xml:space="preserve"
50835088 filename="pango/fonts.c"
5084- line="3130">Array to features in</doc>
5089+ line="3204">Array to features in</doc>
50855090 <array length="2" zero-terminated="0" c:type="hb_feature_t*">
50865091 <type name="HarfBuzz.feature_t" c:type="hb_feature_t"/>
50875092 </array>
@@ -5089,7 +5094,7 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
50895094 <parameter name="len" transfer-ownership="none">
50905095 <doc xml:space="preserve"
50915096 filename="pango/fonts.c"
5092- line="3131">the length of @features</doc>
5097+ line="3205">the length of @features</doc>
50935098 <type name="guint" c:type="guint"/>
50945099 </parameter>
50955100 <parameter name="num_features"
@@ -5098,7 +5103,7 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
50985103 transfer-ownership="full">
50995104 <doc xml:space="preserve"
51005105 filename="pango/fonts.c"
5101- line="3132">the number of used items in @features</doc>
5106+ line="3206">the number of used items in @features</doc>
51025107 <type name="guint" c:type="guint*"/>
51035108 </parameter>
51045109 </parameters>
@@ -5106,7 +5111,7 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
51065111 </field>
51075112 <field name="create_hb_font">
51085113 <callback name="create_hb_font">
5109- <source-position filename="pango/pango-font.h" line="612"/>
5114+ <source-position filename="pango/pango-font.h" line="642"/>
51105115 <return-value transfer-ownership="full">
51115116 <type name="HarfBuzz.font_t" c:type="hb_font_t*"/>
51125117 </return-value>
@@ -5118,6 +5123,42 @@ To recreate a font from its serialized form, use [func@Pango.Font.deserialize].<
51185123 </callback>
51195124 </field>
51205125 </record>
5126+ <enumeration name="FontColor"
5127+ version="1.57"
5128+ glib:type-name="PangoFontColor"
5129+ glib:get-type="pango_font_color_get_type"
5130+ c:type="PangoFontColor">
5131+ <doc xml:space="preserve"
5132+ filename="pango/pango-font.h"
5133+ line="269">Specifies whether a font should or should not have color glyphs.</doc>
5134+ <member name="forbidden"
5135+ value="0"
5136+ c:identifier="PANGO_FONT_COLOR_FORBIDDEN"
5137+ glib:nick="forbidden"
5138+ glib:name="PANGO_FONT_COLOR_FORBIDDEN">
5139+ <doc xml:space="preserve"
5140+ filename="pango/pango-font.h"
5141+ line="271">The font should not have color glyphs</doc>
5142+ </member>
5143+ <member name="required"
5144+ value="1"
5145+ c:identifier="PANGO_FONT_COLOR_REQUIRED"
5146+ glib:nick="required"
5147+ glib:name="PANGO_FONT_COLOR_REQUIRED">
5148+ <doc xml:space="preserve"
5149+ filename="pango/pango-font.h"
5150+ line="272">The font should have color glyphs</doc>
5151+ </member>
5152+ <member name="dont_care"
5153+ value="2"
5154+ c:identifier="PANGO_FONT_COLOR_DONT_CARE"
5155+ glib:nick="dont-care"
5156+ glib:name="PANGO_FONT_COLOR_DONT_CARE">
5157+ <doc xml:space="preserve"
5158+ filename="pango/pango-font.h"
5159+ line="273">The font may or may not use color</doc>
5160+ </member>
5161+ </enumeration>
51215162 <record name="FontDescription"
51225163 c:type="PangoFontDescription"
51235164 opaque="1"
@@ -5136,12 +5177,12 @@ a font to load.</doc>
51365177 <constructor name="new" c:identifier="pango_font_description_new">
51375178 <doc xml:space="preserve"
51385179 filename="pango/fonts.c"
5139- line="81">Creates a new font description structure with all fields unset.</doc>
5140- <source-position filename="pango/pango-font.h" line="270"/>
5180+ line="83">Creates a new font description structure with all fields unset.</doc>
5181+ <source-position filename="pango/pango-font.h" line="294"/>
51415182 <return-value transfer-ownership="full">
51425183 <doc xml:space="preserve"
51435184 filename="pango/fonts.c"
5144- line="86">the newly allocated `PangoFontDescription`,
5185+ line="88">the newly allocated `PangoFontDescription`,
51455186 which should be freed using [method@Pango.FontDescription.free].</doc>
51465187 <type name="FontDescription" c:type="PangoFontDescription*"/>
51475188 </return-value>
@@ -5150,7 +5191,7 @@ a font to load.</doc>
51505191 c:identifier="pango_font_description_better_match">
51515192 <doc xml:space="preserve"
51525193 filename="pango/fonts.c"
5153- line="889">Determines if the style attributes of @new_match are a closer match
5194+ line="938">Determines if the style attributes of @new_match are a closer match
51545195 for @desc than those of @old_match are, or if @old_match is %NULL,
51555196 determines if @new_match is a match at all.
51565197
@@ -5161,18 +5202,18 @@ and size-related attributes. Approximate matching for style considers
51615202 a match as when the styles are equal.
51625203
51635204 Note that @old_match must match @desc.</doc>
5164- <source-position filename="pango/pango-font.h" line="364"/>
5205+ <source-position filename="pango/pango-font.h" line="394"/>
51655206 <return-value transfer-ownership="none">
51665207 <doc xml:space="preserve"
51675208 filename="pango/fonts.c"
5168- line="907">%TRUE if @new_match is a better match</doc>
5209+ line="956">%TRUE if @new_match is a better match</doc>
51695210 <type name="gboolean" c:type="gboolean"/>
51705211 </return-value>
51715212 <parameters>
51725213 <instance-parameter name="desc" transfer-ownership="none">
51735214 <doc xml:space="preserve"
51745215 filename="pango/fonts.c"
5175- line="891">a `PangoFontDescription`</doc>
5216+ line="940">a `PangoFontDescription`</doc>
51765217 <type name="FontDescription" c:type="const PangoFontDescription*"/>
51775218 </instance-parameter>
51785219 <parameter name="old_match"
@@ -5181,13 +5222,13 @@ Note that @old_match must match @desc.</doc>
51815222 allow-none="1">
51825223 <doc xml:space="preserve"
51835224 filename="pango/fonts.c"
5184- line="892">a `PangoFontDescription`, or %NULL</doc>
5225+ line="941">a `PangoFontDescription`, or %NULL</doc>
51855226 <type name="FontDescription" c:type="const PangoFontDescription*"/>
51865227 </parameter>
51875228 <parameter name="new_match" transfer-ownership="none">
51885229 <doc xml:space="preserve"
51895230 filename="pango/fonts.c"
5190- line="893">a `PangoFontDescription`</doc>
5231+ line="942">a `PangoFontDescription`</doc>
51915232 <type name="FontDescription" c:type="const PangoFontDescription*"/>
51925233 </parameter>
51935234 </parameters>
@@ -5195,12 +5236,12 @@ Note that @old_match must match @desc.</doc>
51955236 <method name="copy" c:identifier="pango_font_description_copy">
51965237 <doc xml:space="preserve"
51975238 filename="pango/fonts.c"
5198- line="931">Make a copy of a `PangoFontDescription`.</doc>
5199- <source-position filename="pango/pango-font.h" line="272"/>
5239+ line="982">Make a copy of a `PangoFontDescription`.</doc>
5240+ <source-position filename="pango/pango-font.h" line="296"/>
52005241 <return-value transfer-ownership="full" nullable="1">
52015242 <doc xml:space="preserve"
52025243 filename="pango/fonts.c"
5203- line="937">the newly allocated `PangoFontDescription`,
5244+ line="988">the newly allocated `PangoFontDescription`,
52045245 which should be freed with [method@Pango.FontDescription.free],
52055246 or %NULL if @desc was %NULL.</doc>
52065247 <type name="FontDescription" c:type="PangoFontDescription*"/>
@@ -5212,7 +5253,7 @@ Note that @old_match must match @desc.</doc>
52125253 allow-none="1">
52135254 <doc xml:space="preserve"
52145255 filename="pango/fonts.c"
5215- line="933">a `PangoFontDescription`, may be %NULL</doc>
5256+ line="984">a `PangoFontDescription`, may be %NULL</doc>
52165257 <type name="FontDescription" c:type="const PangoFontDescription*"/>
52175258 </instance-parameter>
52185259 </parameters>
@@ -5221,18 +5262,18 @@ Note that @old_match must match @desc.</doc>
52215262 c:identifier="pango_font_description_copy_static">
52225263 <doc xml:space="preserve"
52235264 filename="pango/fonts.c"
5224- line="968">Make a copy of a `PangoFontDescription`, but don't duplicate
5265+ line="1019">Make a copy of a `PangoFontDescription`, but don't duplicate
52255266 allocated fields.
52265267
52275268 This is like [method@Pango.FontDescription.copy], but only a shallow
52285269 copy is made of the family name and other allocated fields. The result
52295270 can only be used until @desc is modified or freed. This is meant
52305271 to be used when the copy is only needed temporarily.</doc>
5231- <source-position filename="pango/pango-font.h" line="274"/>
5272+ <source-position filename="pango/pango-font.h" line="298"/>
52325273 <return-value transfer-ownership="full" nullable="1">
52335274 <doc xml:space="preserve"
52345275 filename="pango/fonts.c"
5235- line="980">the newly allocated `PangoFontDescription`,
5276+ line="1031">the newly allocated `PangoFontDescription`,
52365277 which should be freed with [method@Pango.FontDescription.free],
52375278 or %NULL if @desc was %NULL.</doc>
52385279 <type name="FontDescription" c:type="PangoFontDescription*"/>
@@ -5244,7 +5285,7 @@ to be used when the copy is only needed temporarily.</doc>
52445285 allow-none="1">
52455286 <doc xml:space="preserve"
52465287 filename="pango/fonts.c"
5247- line="970">a `PangoFontDescription`, may be %NULL</doc>
5288+ line="1021">a `PangoFontDescription`, may be %NULL</doc>
52485289 <type name="FontDescription" c:type="const PangoFontDescription*"/>
52495290 </instance-parameter>
52505291 </parameters>
@@ -5252,17 +5293,17 @@ to be used when the copy is only needed temporarily.</doc>
52525293 <method name="equal" c:identifier="pango_font_description_equal">
52535294 <doc xml:space="preserve"
52545295 filename="pango/fonts.c"
5255- line="1008">Compares two font descriptions for equality.
5296+ line="1059">Compares two font descriptions for equality.
52565297
52575298 Two font descriptions are considered equal if the fonts they describe
52585299 are provably identical. This means that their masks do not have to match,
52595300 as long as other fields are all the same. (Two font descriptions may
52605301 result in identical fonts being loaded, but still compare %FALSE.)</doc>
5261- <source-position filename="pango/pango-font.h" line="278"/>
5302+ <source-position filename="pango/pango-font.h" line="302"/>
52625303 <return-value transfer-ownership="none">
52635304 <doc xml:space="preserve"
52645305 filename="pango/fonts.c"
5265- line="1020">%TRUE if the two font descriptions are identical,
5306+ line="1071">%TRUE if the two font descriptions are identical,
52665307 %FALSE otherwise.</doc>
52675308 <type name="gboolean" c:type="gboolean"/>
52685309 </return-value>
@@ -5270,13 +5311,13 @@ result in identical fonts being loaded, but still compare %FALSE.)</doc>
52705311 <instance-parameter name="desc1" transfer-ownership="none">
52715312 <doc xml:space="preserve"
52725313 filename="pango/fonts.c"
5273- line="1010">a `PangoFontDescription`</doc>
5314+ line="1061">a `PangoFontDescription`</doc>
52745315 <type name="FontDescription" c:type="const PangoFontDescription*"/>
52755316 </instance-parameter>
52765317 <parameter name="desc2" transfer-ownership="none">
52775318 <doc xml:space="preserve"
52785319 filename="pango/fonts.c"
5279- line="1011">another `PangoFontDescription`</doc>
5320+ line="1062">another `PangoFontDescription`</doc>
52805321 <type name="FontDescription" c:type="const PangoFontDescription*"/>
52815322 </parameter>
52825323 </parameters>
@@ -5284,8 +5325,8 @@ result in identical fonts being loaded, but still compare %FALSE.)</doc>
52845325 <method name="free" c:identifier="pango_font_description_free">
52855326 <doc xml:space="preserve"
52865327 filename="pango/fonts.c"
5287- line="1096">Frees a font description.</doc>
5288- <source-position filename="pango/pango-font.h" line="281"/>
5328+ line="1149">Frees a font description.</doc>
5329+ <source-position filename="pango/pango-font.h" line="305"/>
52895330 <return-value transfer-ownership="none">
52905331 <type name="none" c:type="void"/>
52915332 </return-value>
@@ -5296,23 +5337,45 @@ result in identical fonts being loaded, but still compare %FALSE.)</doc>
52965337 allow-none="1">
52975338 <doc xml:space="preserve"
52985339 filename="pango/fonts.c"
5299- line="1098">a `PangoFontDescription`, may be %NULL</doc>
5340+ line="1151">a `PangoFontDescription`, may be %NULL</doc>
53005341 <type name="FontDescription" c:type="PangoFontDescription*"/>
53015342 </instance-parameter>
53025343 </parameters>
53035344 </method>
5345+ <method name="get_color"
5346+ c:identifier="pango_font_description_get_color"
5347+ version="1.57">
5348+ <doc xml:space="preserve"
5349+ filename="pango/fonts.c"
5350+ line="743">Returns the color field of the font description.
5351+
5352+This field determines whether the font description should
5353+match fonts that have color glyphs, or fonts that don't.</doc>
5354+ <source-position filename="pango/pango-font.h" line="376"/>
5355+ <return-value transfer-ownership="none">
5356+ <type name="FontColor" c:type="PangoFontColor"/>
5357+ </return-value>
5358+ <parameters>
5359+ <instance-parameter name="desc" transfer-ownership="none">
5360+ <doc xml:space="preserve"
5361+ filename="pango/fonts.c"
5362+ line="745">a `PangoFontDescription`</doc>
5363+ <type name="FontDescription" c:type="const PangoFontDescription*"/>
5364+ </instance-parameter>
5365+ </parameters>
5366+ </method>
53045367 <method name="get_family"
53055368 c:identifier="pango_font_description_get_family">
53065369 <doc xml:space="preserve"
53075370 filename="pango/fonts.c"
5308- line="162">Gets the family name field of a font description.
5371+ line="164">Gets the family name field of a font description.
53095372
53105373 See [method@Pango.FontDescription.set_family].</doc>
5311- <source-position filename="pango/pango-font.h" line="293"/>
5374+ <source-position filename="pango/pango-font.h" line="317"/>
53125375 <return-value transfer-ownership="none" nullable="1">
53135376 <doc xml:space="preserve"
53145377 filename="pango/fonts.c"
5315- line="170">the family name field for the
5378+ line="172">the family name field for the
53165379 font description, or %NULL if not previously set. This has the same
53175380 life-time as the font description itself and should not be freed.</doc>
53185381 <type name="utf8" c:type="const char*"/>
@@ -5321,7 +5384,7 @@ See [method@Pango.FontDescription.set_family].</doc>
53215384 <instance-parameter name="desc" transfer-ownership="none">
53225385 <doc xml:space="preserve"
53235386 filename="pango/fonts.c"
5324- line="164">a `PangoFontDescription`.</doc>
5387+ line="166">a `PangoFontDescription`.</doc>
53255388 <type name="FontDescription" c:type="const PangoFontDescription*"/>
53265389 </instance-parameter>
53275390 </parameters>
@@ -5331,14 +5394,14 @@ See [method@Pango.FontDescription.set_family].</doc>
53315394 version="1.56">
53325395 <doc xml:space="preserve"
53335396 filename="pango/fonts.c"
5334- line="693">Gets the features field of a font description.
5397+ line="695">Gets the features field of a font description.
53355398
53365399 See [method@Pango.FontDescription.set_features].</doc>
5337- <source-position filename="pango/pango-font.h" line="346"/>
5400+ <source-position filename="pango/pango-font.h" line="370"/>
53385401 <return-value transfer-ownership="none" nullable="1">
53395402 <doc xml:space="preserve"
53405403 filename="pango/fonts.c"
5341- line="701">the features field for the font
5404+ line="703">the features field for the font
53425405 description, or %NULL if not previously set. This has the same
53435406 life-time as the font description itself and should not be freed.</doc>
53445407 <type name="utf8" c:type="const char*"/>
@@ -5347,7 +5410,7 @@ See [method@Pango.FontDescription.set_features].</doc>
53475410 <instance-parameter name="desc" transfer-ownership="none">
53485411 <doc xml:space="preserve"
53495412 filename="pango/fonts.c"
5350- line="695">a `PangoFontDescription`</doc>
5413+ line="697">a `PangoFontDescription`</doc>
53515414 <type name="FontDescription" c:type="const PangoFontDescription*"/>
53525415 </instance-parameter>
53535416 </parameters>
@@ -5357,14 +5420,14 @@ See [method@Pango.FontDescription.set_features].</doc>
53575420 version="1.16">
53585421 <doc xml:space="preserve"
53595422 filename="pango/fonts.c"
5360- line="487">Gets the gravity field of a font description.
5423+ line="489">Gets the gravity field of a font description.
53615424
53625425 See [method@Pango.FontDescription.set_gravity].</doc>
5363- <source-position filename="pango/pango-font.h" line="328"/>
5426+ <source-position filename="pango/pango-font.h" line="352"/>
53645427 <return-value transfer-ownership="none">
53655428 <doc xml:space="preserve"
53665429 filename="pango/fonts.c"
5367- line="495">the gravity field for the font description.
5430+ line="497">the gravity field for the font description.
53685431 Use [method@Pango.FontDescription.get_set_fields] to find out
53695432 if the field was explicitly set or not.</doc>
53705433 <type name="Gravity" c:type="PangoGravity"/>
@@ -5373,7 +5436,7 @@ See [method@Pango.FontDescription.set_gravity].</doc>
53735436 <instance-parameter name="desc" transfer-ownership="none">
53745437 <doc xml:space="preserve"
53755438 filename="pango/fonts.c"
5376- line="489">a `PangoFontDescription`</doc>
5439+ line="491">a `PangoFontDescription`</doc>
53775440 <type name="FontDescription" c:type="const PangoFontDescription*"/>
53785441 </instance-parameter>
53795442 </parameters>
@@ -5382,12 +5445,12 @@ See [method@Pango.FontDescription.set_gravity].</doc>
53825445 c:identifier="pango_font_description_get_set_fields">
53835446 <doc xml:space="preserve"
53845447 filename="pango/fonts.c"
5385- line="715">Determines which fields in a font description have been set.</doc>
5386- <source-position filename="pango/pango-font.h" line="349"/>
5448+ line="762">Determines which fields in a font description have been set.</doc>
5449+ <source-position filename="pango/pango-font.h" line="379"/>
53875450 <return-value transfer-ownership="none">
53885451 <doc xml:space="preserve"
53895452 filename="pango/fonts.c"
5390- line="721">a bitmask with bits set corresponding to the
5453+ line="768">a bitmask with bits set corresponding to the
53915454 fields in @desc that have been set.</doc>
53925455 <type name="FontMask" c:type="PangoFontMask"/>
53935456 </return-value>
@@ -5395,7 +5458,7 @@ See [method@Pango.FontDescription.set_gravity].</doc>
53955458 <instance-parameter name="desc" transfer-ownership="none">
53965459 <doc xml:space="preserve"
53975460 filename="pango/fonts.c"
5398- line="717">a `PangoFontDescription`</doc>
5461+ line="764">a `PangoFontDescription`</doc>
53995462 <type name="FontDescription" c:type="const PangoFontDescription*"/>
54005463 </instance-parameter>
54015464 </parameters>
@@ -5403,14 +5466,14 @@ See [method@Pango.FontDescription.set_gravity].</doc>
54035466 <method name="get_size" c:identifier="pango_font_description_get_size">
54045467 <doc xml:space="preserve"
54055468 filename="pango/fonts.c"
5406- line="379">Gets the size field of a font description.
5469+ line="381">Gets the size field of a font description.
54075470
54085471 See [method@Pango.FontDescription.set_size].</doc>
5409- <source-position filename="pango/pango-font.h" line="318"/>
5472+ <source-position filename="pango/pango-font.h" line="342"/>
54105473 <return-value transfer-ownership="none">
54115474 <doc xml:space="preserve"
54125475 filename="pango/fonts.c"
5413- line="387">the size field for the font description in points
5476+ line="389">the size field for the font description in points
54145477 or device units. You must call
54155478 [method@Pango.FontDescription.get_size_is_absolute] to find out
54165479 which is the case. Returns 0 if the size field has not previously
@@ -5423,7 +5486,7 @@ See [method@Pango.FontDescription.set_size].</doc>
54235486 <instance-parameter name="desc" transfer-ownership="none">
54245487 <doc xml:space="preserve"
54255488 filename="pango/fonts.c"
5426- line="381">a `PangoFontDescription`</doc>
5489+ line="383">a `PangoFontDescription`</doc>
54275490 <type name="FontDescription" c:type="const PangoFontDescription*"/>
54285491 </instance-parameter>
54295492 </parameters>
@@ -5433,16 +5496,16 @@ See [method@Pango.FontDescription.set_size].</doc>
54335496 version="1.8">
54345497 <doc xml:space="preserve"
54355498 filename="pango/fonts.c"
5436- line="429">Determines whether the size of the font is in points (not absolute)
5499+ line="431">Determines whether the size of the font is in points (not absolute)
54375500 or device units (absolute).
54385501
54395502 See [method@Pango.FontDescription.set_size]
54405503 and [method@Pango.FontDescription.set_absolute_size].</doc>
5441- <source-position filename="pango/pango-font.h" line="323"/>
5504+ <source-position filename="pango/pango-font.h" line="347"/>
54425505 <return-value transfer-ownership="none">
54435506 <doc xml:space="preserve"
54445507 filename="pango/fonts.c"
5445- line="439">whether the size for the font description is in
5508+ line="441">whether the size for the font description is in
54465509 points or device units. Use [method@Pango.FontDescription.get_set_fields]
54475510 to find out if the size field of the font description was explicitly
54485511 set or not.</doc>
@@ -5452,7 +5515,7 @@ and [method@Pango.FontDescription.set_absolute_size].</doc>
54525515 <instance-parameter name="desc" transfer-ownership="none">
54535516 <doc xml:space="preserve"
54545517 filename="pango/fonts.c"
5455- line="431">a `PangoFontDescription`</doc>
5518+ line="433">a `PangoFontDescription`</doc>
54565519 <type name="FontDescription" c:type="const PangoFontDescription*"/>
54575520 </instance-parameter>
54585521 </parameters>
@@ -5461,14 +5524,14 @@ and [method@Pango.FontDescription.set_absolute_size].</doc>
54615524 c:identifier="pango_font_description_get_stretch">
54625525 <doc xml:space="preserve"
54635526 filename="pango/fonts.c"
5464- line="330">Gets the stretch field of a font description.
5527+ line="332">Gets the stretch field of a font description.
54655528
54665529 See [method@Pango.FontDescription.set_stretch].</doc>
5467- <source-position filename="pango/pango-font.h" line="313"/>
5530+ <source-position filename="pango/pango-font.h" line="337"/>
54685531 <return-value transfer-ownership="none">
54695532 <doc xml:space="preserve"
54705533 filename="pango/fonts.c"
5471- line="338">the stretch field for the font description.
5534+ line="340">the stretch field for the font description.
54725535 Use [method@Pango.FontDescription.get_set_fields] to find
54735536 out if the field was explicitly set or not.</doc>
54745537 <type name="Stretch" c:type="PangoStretch"/>
@@ -5477,7 +5540,7 @@ See [method@Pango.FontDescription.set_stretch].</doc>
54775540 <instance-parameter name="desc" transfer-ownership="none">
54785541 <doc xml:space="preserve"
54795542 filename="pango/fonts.c"
5480- line="332">a `PangoFontDescription`.</doc>
5543+ line="334">a `PangoFontDescription`.</doc>
54815544 <type name="FontDescription" c:type="const PangoFontDescription*"/>
54825545 </instance-parameter>
54835546 </parameters>
@@ -5485,14 +5548,14 @@ See [method@Pango.FontDescription.set_stretch].</doc>
54855548 <method name="get_style" c:identifier="pango_font_description_get_style">
54865549 <doc xml:space="preserve"
54875550 filename="pango/fonts.c"
5488- line="208">Gets the style field of a `PangoFontDescription`.
5551+ line="210">Gets the style field of a `PangoFontDescription`.
54895552
54905553 See [method@Pango.FontDescription.set_style].</doc>
5491- <source-position filename="pango/pango-font.h" line="298"/>
5554+ <source-position filename="pango/pango-font.h" line="322"/>
54925555 <return-value transfer-ownership="none">
54935556 <doc xml:space="preserve"
54945557 filename="pango/fonts.c"
5495- line="216">the style field for the font description.
5558+ line="218">the style field for the font description.
54965559 Use [method@Pango.FontDescription.get_set_fields] to
54975560 find out if the field was explicitly set or not.</doc>
54985561 <type name="Style" c:type="PangoStyle"/>
@@ -5501,7 +5564,7 @@ See [method@Pango.FontDescription.set_style].</doc>
55015564 <instance-parameter name="desc" transfer-ownership="none">
55025565 <doc xml:space="preserve"
55035566 filename="pango/fonts.c"
5504- line="210">a `PangoFontDescription`</doc>
5567+ line="212">a `PangoFontDescription`</doc>
55055568 <type name="FontDescription" c:type="const PangoFontDescription*"/>
55065569 </instance-parameter>
55075570 </parameters>
@@ -5510,14 +5573,14 @@ See [method@Pango.FontDescription.set_style].</doc>
55105573 c:identifier="pango_font_description_get_variant">
55115574 <doc xml:space="preserve"
55125575 filename="pango/fonts.c"
5513- line="248">Gets the variant field of a `PangoFontDescription`.
5576+ line="250">Gets the variant field of a `PangoFontDescription`.
55145577
55155578 See [method@Pango.FontDescription.set_variant].</doc>
5516- <source-position filename="pango/pango-font.h" line="303"/>
5579+ <source-position filename="pango/pango-font.h" line="327"/>
55175580 <return-value transfer-ownership="none">
55185581 <doc xml:space="preserve"
55195582 filename="pango/fonts.c"
5520- line="256">the variant field for the font description.
5583+ line="258">the variant field for the font description.
55215584 Use [method@Pango.FontDescription.get_set_fields] to find
55225585 out if the field was explicitly set or not.</doc>
55235586 <type name="Variant" c:type="PangoVariant"/>
@@ -5526,7 +5589,7 @@ See [method@Pango.FontDescription.set_variant].</doc>
55265589 <instance-parameter name="desc" transfer-ownership="none">
55275590 <doc xml:space="preserve"
55285591 filename="pango/fonts.c"
5529- line="250">a `PangoFontDescription`.</doc>
5592+ line="252">a `PangoFontDescription`.</doc>
55305593 <type name="FontDescription" c:type="const PangoFontDescription*"/>
55315594 </instance-parameter>
55325595 </parameters>
@@ -5536,14 +5599,14 @@ See [method@Pango.FontDescription.set_variant].</doc>
55365599 version="1.42">
55375600 <doc xml:space="preserve"
55385601 filename="pango/fonts.c"
5539- line="586">Gets the variations field of a font description.
5602+ line="588">Gets the variations field of a font description.
55405603
55415604 See [method@Pango.FontDescription.set_variations].</doc>
5542- <source-position filename="pango/pango-font.h" line="337"/>
5605+ <source-position filename="pango/pango-font.h" line="361"/>
55435606 <return-value transfer-ownership="none" nullable="1">
55445607 <doc xml:space="preserve"
55455608 filename="pango/fonts.c"
5546- line="594">the variations field for the font
5609+ line="596">the variations field for the font
55475610 description, or %NULL if not previously set. This has the same
55485611 life-time as the font description itself and should not be freed.</doc>
55495612 <type name="utf8" c:type="const char*"/>
@@ -5552,7 +5615,7 @@ See [method@Pango.FontDescription.set_variations].</doc>
55525615 <instance-parameter name="desc" transfer-ownership="none">
55535616 <doc xml:space="preserve"
55545617 filename="pango/fonts.c"
5555- line="588">a `PangoFontDescription`</doc>
5618+ line="590">a `PangoFontDescription`</doc>
55565619 <type name="FontDescription" c:type="const PangoFontDescription*"/>
55575620 </instance-parameter>
55585621 </parameters>
@@ -5561,14 +5624,14 @@ See [method@Pango.FontDescription.set_variations].</doc>
55615624 c:identifier="pango_font_description_get_weight">
55625625 <doc xml:space="preserve"
55635626 filename="pango/fonts.c"
5564- line="290">Gets the weight field of a font description.
5627+ line="292">Gets the weight field of a font description.
55655628
55665629 See [method@Pango.FontDescription.set_weight].</doc>
5567- <source-position filename="pango/pango-font.h" line="308"/>
5630+ <source-position filename="pango/pango-font.h" line="332"/>
55685631 <return-value transfer-ownership="none">
55695632 <doc xml:space="preserve"
55705633 filename="pango/fonts.c"
5571- line="298">the weight field for the font description.
5634+ line="300">the weight field for the font description.
55725635 Use [method@Pango.FontDescription.get_set_fields] to find
55735636 out if the field was explicitly set or not.</doc>
55745637 <type name="Weight" c:type="PangoWeight"/>
@@ -5577,7 +5640,7 @@ See [method@Pango.FontDescription.set_weight].</doc>
55775640 <instance-parameter name="desc" transfer-ownership="none">
55785641 <doc xml:space="preserve"
55795642 filename="pango/fonts.c"
5580- line="292">a `PangoFontDescription`</doc>
5643+ line="294">a `PangoFontDescription`</doc>
55815644 <type name="FontDescription" c:type="const PangoFontDescription*"/>
55825645 </instance-parameter>
55835646 </parameters>
@@ -5585,22 +5648,22 @@ See [method@Pango.FontDescription.set_weight].</doc>
55855648 <method name="hash" c:identifier="pango_font_description_hash">
55865649 <doc xml:space="preserve"
55875650 filename="pango/fonts.c"
5588- line="1061">Computes a hash of a `PangoFontDescription` structure.
5651+ line="1113">Computes a hash of a `PangoFontDescription` structure.
55895652
55905653 This is suitable to be used, for example, as an argument
55915654 to g_hash_table_new(). The hash value is independent of @desc-&gt;mask.</doc>
5592- <source-position filename="pango/pango-font.h" line="276"/>
5655+ <source-position filename="pango/pango-font.h" line="300"/>
55935656 <return-value transfer-ownership="none">
55945657 <doc xml:space="preserve"
55955658 filename="pango/fonts.c"
5596- line="1070">the hash value.</doc>
5659+ line="1122">the hash value.</doc>
55975660 <type name="guint" c:type="guint"/>
55985661 </return-value>
55995662 <parameters>
56005663 <instance-parameter name="desc" transfer-ownership="none">
56015664 <doc xml:space="preserve"
56025665 filename="pango/fonts.c"
5603- line="1063">a `PangoFontDescription`</doc>
5666+ line="1115">a `PangoFontDescription`</doc>
56045667 <type name="FontDescription" c:type="const PangoFontDescription*"/>
56055668 </instance-parameter>
56065669 </parameters>
@@ -5608,7 +5671,7 @@ to g_hash_table_new(). The hash value is independent of @desc-&gt;mask.</doc>
56085671 <method name="merge" c:identifier="pango_font_description_merge">
56095672 <doc xml:space="preserve"
56105673 filename="pango/fonts.c"
5611- line="757">Merges the fields that are set in @desc_to_merge into the fields in
5674+ line="804">Merges the fields that are set in @desc_to_merge into the fields in
56125675 @desc.
56135676
56145677 If @replace_existing is %FALSE, only fields in @desc that
@@ -5616,7 +5679,7 @@ are not already set are affected. If %TRUE, then fields that are
56165679 already set will be replaced as well.
56175680
56185681 If @desc_to_merge is %NULL, this function performs nothing.</doc>
5619- <source-position filename="pango/pango-font.h" line="355"/>
5682+ <source-position filename="pango/pango-font.h" line="385"/>
56205683 <return-value transfer-ownership="none">
56215684 <type name="none" c:type="void"/>
56225685 </return-value>
@@ -5624,7 +5687,7 @@ If @desc_to_merge is %NULL, this function performs nothing.</doc>
56245687 <instance-parameter name="desc" transfer-ownership="none">
56255688 <doc xml:space="preserve"
56265689 filename="pango/fonts.c"
5627- line="759">a `PangoFontDescription`</doc>
5690+ line="806">a `PangoFontDescription`</doc>
56285691 <type name="FontDescription" c:type="PangoFontDescription*"/>
56295692 </instance-parameter>
56305693 <parameter name="desc_to_merge"
@@ -5633,14 +5696,14 @@ If @desc_to_merge is %NULL, this function performs nothing.</doc>
56335696 allow-none="1">
56345697 <doc xml:space="preserve"
56355698 filename="pango/fonts.c"
5636- line="760">the `PangoFontDescription` to merge from,
5699+ line="807">the `PangoFontDescription` to merge from,
56375700 or %NULL</doc>
56385701 <type name="FontDescription" c:type="const PangoFontDescription*"/>
56395702 </parameter>
56405703 <parameter name="replace_existing" transfer-ownership="none">
56415704 <doc xml:space="preserve"
56425705 filename="pango/fonts.c"
5643- line="762">if %TRUE, replace fields in @desc with the
5706+ line="809">if %TRUE, replace fields in @desc with the
56445707 corresponding values from @desc_to_merge, even if they
56455708 are already exist.</doc>
56465709 <type name="gboolean" c:type="gboolean"/>
@@ -5651,14 +5714,14 @@ If @desc_to_merge is %NULL, this function performs nothing.</doc>
56515714 c:identifier="pango_font_description_merge_static">
56525715 <doc xml:space="preserve"
56535716 filename="pango/fonts.c"
5654- line="814">Merges the fields that are set in @desc_to_merge into the fields in
5717+ line="861">Merges the fields that are set in @desc_to_merge into the fields in
56555718 @desc, without copying allocated fields.
56565719
56575720 This is like [method@Pango.FontDescription.merge], but only a shallow copy
56585721 is made of the family name and other allocated fields. @desc can only
56595722 be used until @desc_to_merge is modified or freed. This is meant to
56605723 be used when the merged font description is only needed temporarily.</doc>
5661- <source-position filename="pango/pango-font.h" line="359"/>
5724+ <source-position filename="pango/pango-font.h" line="389"/>
56625725 <return-value transfer-ownership="none">
56635726 <type name="none" c:type="void"/>
56645727 </return-value>
@@ -5666,19 +5729,19 @@ be used when the merged font description is only needed temporarily.</doc>
56665729 <instance-parameter name="desc" transfer-ownership="none">
56675730 <doc xml:space="preserve"
56685731 filename="pango/fonts.c"
5669- line="816">a `PangoFontDescription`</doc>
5732+ line="863">a `PangoFontDescription`</doc>
56705733 <type name="FontDescription" c:type="PangoFontDescription*"/>
56715734 </instance-parameter>
56725735 <parameter name="desc_to_merge" transfer-ownership="none">
56735736 <doc xml:space="preserve"
56745737 filename="pango/fonts.c"
5675- line="817">the `PangoFontDescription` to merge from</doc>
5738+ line="864">the `PangoFontDescription` to merge from</doc>
56765739 <type name="FontDescription" c:type="const PangoFontDescription*"/>
56775740 </parameter>
56785741 <parameter name="replace_existing" transfer-ownership="none">
56795742 <doc xml:space="preserve"
56805743 filename="pango/fonts.c"
5681- line="818">if %TRUE, replace fields in @desc with the
5744+ line="865">if %TRUE, replace fields in @desc with the
56825745 corresponding values from @desc_to_merge, even if they
56835746 are already exist.</doc>
56845747 <type name="gboolean" c:type="gboolean"/>
@@ -5690,11 +5753,11 @@ be used when the merged font description is only needed temporarily.</doc>
56905753 version="1.8">
56915754 <doc xml:space="preserve"
56925755 filename="pango/fonts.c"
5693- line="403">Sets the size field of a font description, in device units.
5756+ line="405">Sets the size field of a font description, in device units.
56945757
56955758 This is mutually exclusive with [method@Pango.FontDescription.set_size]
56965759 which sets the font size in points.</doc>
5697- <source-position filename="pango/pango-font.h" line="320"/>
5760+ <source-position filename="pango/pango-font.h" line="344"/>
56985761 <return-value transfer-ownership="none">
56995762 <type name="none" c:type="void"/>
57005763 </return-value>
@@ -5702,31 +5765,59 @@ which sets the font size in points.</doc>
57025765 <instance-parameter name="desc" transfer-ownership="none">
57035766 <doc xml:space="preserve"
57045767 filename="pango/fonts.c"
5705- line="405">a `PangoFontDescription`</doc>
5768+ line="407">a `PangoFontDescription`</doc>
57065769 <type name="FontDescription" c:type="PangoFontDescription*"/>
57075770 </instance-parameter>
57085771 <parameter name="size" transfer-ownership="none">
57095772 <doc xml:space="preserve"
57105773 filename="pango/fonts.c"
5711- line="406">the new size, in Pango units. There are %PANGO_SCALE Pango units
5774+ line="408">the new size, in Pango units. There are %PANGO_SCALE Pango units
57125775 in one device unit. For an output backend where a device unit is a pixel,
57135776 a @size value of 10 * PANGO_SCALE gives a 10 pixel font.</doc>
57145777 <type name="gdouble" c:type="double"/>
57155778 </parameter>
57165779 </parameters>
57175780 </method>
5781+ <method name="set_color"
5782+ c:identifier="pango_font_description_set_color"
5783+ version="1.57">
5784+ <doc xml:space="preserve"
5785+ filename="pango/fonts.c"
5786+ line="717">Sets the color field of a font description.
5787+
5788+This field determines whether the font description should
5789+match fonts that have color glyphs, or fonts that don't.</doc>
5790+ <source-position filename="pango/pango-font.h" line="373"/>
5791+ <return-value transfer-ownership="none">
5792+ <type name="none" c:type="void"/>
5793+ </return-value>
5794+ <parameters>
5795+ <instance-parameter name="desc" transfer-ownership="none">
5796+ <doc xml:space="preserve"
5797+ filename="pango/fonts.c"
5798+ line="719">a `PangoFontDescription`.</doc>
5799+ <type name="FontDescription" c:type="PangoFontDescription*"/>
5800+ </instance-parameter>
5801+ <parameter name="color" transfer-ownership="none">
5802+ <doc xml:space="preserve"
5803+ filename="pango/fonts.c"
5804+ line="720">the `PangoFontColor` value</doc>
5805+ <type name="FontColor" c:type="PangoFontColor"/>
5806+ </parameter>
5807+ </parameters>
5808+ </method>
57185809 <method name="set_family"
57195810 c:identifier="pango_font_description_set_family">
57205811 <doc xml:space="preserve"
57215812 filename="pango/fonts.c"
5722- line="99">Sets the family name field of a font description.
5813+ line="101">Sets the family name field of a font description.
57235814
57245815 The family
57255816 name represents a family of related font styles, and will
57265817 resolve to a particular `PangoFontFamily`. In some uses of
57275818 `PangoFontDescription`, it is also possible to use a comma
57285819 separated list of family names for this field.</doc>
5729- <source-position filename="pango/pango-font.h" line="287"/>
5820+ <source-position filename="pango/pango-font.h" line="311"/>
57305821 <return-value transfer-ownership="none">
57315822 <type name="none" c:type="void"/>
57325823 </return-value>
@@ -5734,13 +5825,13 @@ separated list of family names for this field.</doc>
57345825 <instance-parameter name="desc" transfer-ownership="none">
57355826 <doc xml:space="preserve"
57365827 filename="pango/fonts.c"
5737- line="101">a `PangoFontDescription`.</doc>
5828+ line="103">a `PangoFontDescription`.</doc>
57385829 <type name="FontDescription" c:type="PangoFontDescription*"/>
57395830 </instance-parameter>
57405831 <parameter name="family" transfer-ownership="none">
57415832 <doc xml:space="preserve"
57425833 filename="pango/fonts.c"
5743- line="102">a string representing the family name.</doc>
5834+ line="104">a string representing the family name.</doc>
57445835 <type name="utf8" c:type="const char*"/>
57455836 </parameter>
57465837 </parameters>
@@ -5749,14 +5840,14 @@ separated list of family names for this field.</doc>
57495840 c:identifier="pango_font_description_set_family_static">
57505841 <doc xml:space="preserve"
57515842 filename="pango/fonts.c"
5752- line="123">Sets the family name field of a font description, without copying the string.
5843+ line="125">Sets the family name field of a font description, without copying the string.
57535844
57545845 This is like [method@Pango.FontDescription.set_family], except that no
57555846 copy of @family is made. The caller must make sure that the
57565847 string passed in stays around until @desc has been freed or the
57575848 name is set again. This function can be used if @family is a static
57585849 string such as a C string literal, or if @desc is only needed temporarily.</doc>
5759- <source-position filename="pango/pango-font.h" line="290"/>
5850+ <source-position filename="pango/pango-font.h" line="314"/>
57605851 <return-value transfer-ownership="none">
57615852 <type name="none" c:type="void"/>
57625853 </return-value>
@@ -5764,13 +5855,13 @@ string such as a C string literal, or if @desc is only needed temporarily.</doc>
57645855 <instance-parameter name="desc" transfer-ownership="none">
57655856 <doc xml:space="preserve"
57665857 filename="pango/fonts.c"
5767- line="125">a `PangoFontDescription`</doc>
5858+ line="127">a `PangoFontDescription`</doc>
57685859 <type name="FontDescription" c:type="PangoFontDescription*"/>
57695860 </instance-parameter>
57705861 <parameter name="family" transfer-ownership="none">
57715862 <doc xml:space="preserve"
57725863 filename="pango/fonts.c"
5773- line="126">a string representing the family name</doc>
5864+ line="128">a string representing the family name</doc>
57745865 <type name="utf8" c:type="const char*"/>
57755866 </parameter>
57765867 </parameters>
@@ -5780,7 +5871,7 @@ string such as a C string literal, or if @desc is only needed temporarily.</doc>
57805871 version="1.56">
57815872 <doc xml:space="preserve"
57825873 filename="pango/fonts.c"
5783- line="650">Sets the features field of a font description.
5874+ line="652">Sets the features field of a font description.
57845875
57855876 OpenType font features allow to enable or disable certain optional
57865877 features of a font, such as tabular numbers.
@@ -5804,7 +5895,7 @@ of a font. Both harfbuzz and freetype have API for this. See for example
58045895 [hb_ot_layout_table_get_feature_tags](https://harfbuzz.github.io/harfbuzz-hb-ot-layout.html#hb-ot-layout-table-get-feature-tags).
58055896
58065897 Features that are not supported by the font are silently ignored.</doc>
5807- <source-position filename="pango/pango-font.h" line="343"/>
5898+ <source-position filename="pango/pango-font.h" line="367"/>
58085899 <return-value transfer-ownership="none">
58095900 <type name="none" c:type="void"/>
58105901 </return-value>
@@ -5812,7 +5903,7 @@ Features that are not supported by the font are silently ignored.</doc>
58125903 <instance-parameter name="desc" transfer-ownership="none">
58135904 <doc xml:space="preserve"
58145905 filename="pango/fonts.c"
5815- line="652">a `PangoFontDescription`.</doc>
5906+ line="654">a `PangoFontDescription`.</doc>
58165907 <type name="FontDescription" c:type="PangoFontDescription*"/>
58175908 </instance-parameter>
58185909 <parameter name="features"
@@ -5821,7 +5912,7 @@ Features that are not supported by the font are silently ignored.</doc>
58215912 allow-none="1">
58225913 <doc xml:space="preserve"
58235914 filename="pango/fonts.c"
5824- line="653">a string representing the features</doc>
5915+ line="655">a string representing the features</doc>
58255916 <type name="utf8" c:type="const char*"/>
58265917 </parameter>
58275918 </parameters>
@@ -5831,7 +5922,7 @@ Features that are not supported by the font are silently ignored.</doc>
58315922 version="1.56">
58325923 <doc xml:space="preserve"
58335924 filename="pango/fonts.c"
5834- line="608">Sets the features field of a font description.
5925+ line="610">Sets the features field of a font description.
58355926
58365927 This is like [method@Pango.FontDescription.set_features], except
58375928 that no copy of @featuresis made. The caller must make sure that
@@ -5839,7 +5930,7 @@ the string passed in stays around until @desc has been freed
58395930 or the name is set again. This function can be used if
58405931 @features is a static string such as a C string literal,
58415932 or if @desc is only needed temporarily.</doc>
5842- <source-position filename="pango/pango-font.h" line="340"/>
5933+ <source-position filename="pango/pango-font.h" line="364"/>
58435934 <return-value transfer-ownership="none">
58445935 <type name="none" c:type="void"/>
58455936 </return-value>
@@ -5847,13 +5938,13 @@ or if @desc is only needed temporarily.</doc>
58475938 <instance-parameter name="desc" transfer-ownership="none">
58485939 <doc xml:space="preserve"
58495940 filename="pango/fonts.c"
5850- line="610">a `PangoFontDescription`</doc>
5941+ line="612">a `PangoFontDescription`</doc>
58515942 <type name="FontDescription" c:type="PangoFontDescription*"/>
58525943 </instance-parameter>
58535944 <parameter name="features" transfer-ownership="none">
58545945 <doc xml:space="preserve"
58555946 filename="pango/fonts.c"
5856- line="611">a string representing the features</doc>
5947+ line="613">a string representing the features</doc>
58575948 <type name="utf8" c:type="const char*"/>
58585949 </parameter>
58595950 </parameters>
@@ -5863,7 +5954,7 @@ or if @desc is only needed temporarily.</doc>
58635954 version="1.16">
58645955 <doc xml:space="preserve"
58655956 filename="pango/fonts.c"
5866- line="454">Sets the gravity field of a font description.
5957+ line="456">Sets the gravity field of a font description.
58675958
58685959 The gravity field
58695960 specifies how the glyphs should be rotated. If @gravity is
@@ -5872,7 +5963,7 @@ the font description.
58725963
58735964 This function is seldom useful to the user. Gravity should normally
58745965 be set on a `PangoContext`.</doc>
5875- <source-position filename="pango/pango-font.h" line="325"/>
5966+ <source-position filename="pango/pango-font.h" line="349"/>
58765967 <return-value transfer-ownership="none">
58775968 <type name="none" c:type="void"/>
58785969 </return-value>
@@ -5880,13 +5971,13 @@ be set on a `PangoContext`.</doc>
58805971 <instance-parameter name="desc" transfer-ownership="none">
58815972 <doc xml:space="preserve"
58825973 filename="pango/fonts.c"
5883- line="456">a `PangoFontDescription`</doc>
5974+ line="458">a `PangoFontDescription`</doc>
58845975 <type name="FontDescription" c:type="PangoFontDescription*"/>
58855976 </instance-parameter>
58865977 <parameter name="gravity" transfer-ownership="none">
58875978 <doc xml:space="preserve"
58885979 filename="pango/fonts.c"
5889- line="457">the gravity for the font description.</doc>
5980+ line="459">the gravity for the font description.</doc>
58905981 <type name="Gravity" c:type="PangoGravity"/>
58915982 </parameter>
58925983 </parameters>
@@ -5894,11 +5985,11 @@ be set on a `PangoContext`.</doc>
58945985 <method name="set_size" c:identifier="pango_font_description_set_size">
58955986 <doc xml:space="preserve"
58965987 filename="pango/fonts.c"
5897- line="350">Sets the size field of a font description in fractional points.
5988+ line="352">Sets the size field of a font description in fractional points.
58985989
58995990 This is mutually exclusive with
59005991 [method@Pango.FontDescription.set_absolute_size].</doc>
5901- <source-position filename="pango/pango-font.h" line="315"/>
5992+ <source-position filename="pango/pango-font.h" line="339"/>
59025993 <return-value transfer-ownership="none">
59035994 <type name="none" c:type="void"/>
59045995 </return-value>
@@ -5906,13 +5997,13 @@ This is mutually exclusive with
59065997 <instance-parameter name="desc" transfer-ownership="none">
59075998 <doc xml:space="preserve"
59085999 filename="pango/fonts.c"
5909- line="352">a `PangoFontDescription`</doc>
6000+ line="354">a `PangoFontDescription`</doc>
59106001 <type name="FontDescription" c:type="PangoFontDescription*"/>
59116002 </instance-parameter>
59126003 <parameter name="size" transfer-ownership="none">
59136004 <doc xml:space="preserve"
59146005 filename="pango/fonts.c"
5915- line="353">the size of the font in points, scaled by %PANGO_SCALE.
6006+ line="355">the size of the font in points, scaled by %PANGO_SCALE.
59166007 (That is, a @size value of 10 * PANGO_SCALE is a 10 point font.
59176008 The conversion factor between points and device units depends on
59186009 system configuration and the output device. For screen display, a
@@ -5928,11 +6019,11 @@ This is mutually exclusive with
59286019 c:identifier="pango_font_description_set_stretch">
59296020 <doc xml:space="preserve"
59306021 filename="pango/fonts.c"
5931- line="310">Sets the stretch field of a font description.
6022+ line="312">Sets the stretch field of a font description.
59326023
59336024 The [enum@Pango.Stretch] field specifies how narrow or
59346025 wide the font should be.</doc>
5935- <source-position filename="pango/pango-font.h" line="310"/>
6026+ <source-position filename="pango/pango-font.h" line="334"/>
59366027 <return-value transfer-ownership="none">
59376028 <type name="none" c:type="void"/>
59386029 </return-value>
@@ -5940,13 +6031,13 @@ wide the font should be.</doc>
59406031 <instance-parameter name="desc" transfer-ownership="none">
59416032 <doc xml:space="preserve"
59426033 filename="pango/fonts.c"
5943- line="312">a `PangoFontDescription`</doc>
6034+ line="314">a `PangoFontDescription`</doc>
59446035 <type name="FontDescription" c:type="PangoFontDescription*"/>
59456036 </instance-parameter>
59466037 <parameter name="stretch" transfer-ownership="none">
59476038 <doc xml:space="preserve"
59486039 filename="pango/fonts.c"
5949- line="313">the stretch for the font description</doc>
6040+ line="315">the stretch for the font description</doc>
59506041 <type name="Stretch" c:type="PangoStretch"/>
59516042 </parameter>
59526043 </parameters>
@@ -5954,7 +6045,7 @@ wide the font should be.</doc>
59546045 <method name="set_style" c:identifier="pango_font_description_set_style">
59556046 <doc xml:space="preserve"
59566047 filename="pango/fonts.c"
5957- line="182">Sets the style field of a `PangoFontDescription`.
6048+ line="184">Sets the style field of a `PangoFontDescription`.
59586049
59596050 The [enum@Pango.Style] enumeration describes whether the font is
59606051 slanted and the manner in which it is slanted; it can be either
@@ -5964,7 +6055,7 @@ Most fonts will either have a italic style or an oblique style,
59646055 but not both, and font matching in Pango will match italic
59656056 specifications with oblique fonts and vice-versa if an exact
59666057 match is not found.</doc>
5967- <source-position filename="pango/pango-font.h" line="295"/>
6058+ <source-position filename="pango/pango-font.h" line="319"/>
59686059 <return-value transfer-ownership="none">
59696060 <type name="none" c:type="void"/>
59706061 </return-value>
@@ -5972,13 +6063,13 @@ match is not found.</doc>
59726063 <instance-parameter name="desc" transfer-ownership="none">
59736064 <doc xml:space="preserve"
59746065 filename="pango/fonts.c"
5975- line="184">a `PangoFontDescription`</doc>
6066+ line="186">a `PangoFontDescription`</doc>
59766067 <type name="FontDescription" c:type="PangoFontDescription*"/>
59776068 </instance-parameter>
59786069 <parameter name="style" transfer-ownership="none">
59796070 <doc xml:space="preserve"
59806071 filename="pango/fonts.c"
5981- line="185">the style for the font description</doc>
6072+ line="187">the style for the font description</doc>
59826073 <type name="Style" c:type="PangoStyle"/>
59836074 </parameter>
59846075 </parameters>
@@ -5987,11 +6078,11 @@ match is not found.</doc>
59876078 c:identifier="pango_font_description_set_variant">
59886079 <doc xml:space="preserve"
59896080 filename="pango/fonts.c"
5990- line="228">Sets the variant field of a font description.
6081+ line="230">Sets the variant field of a font description.
59916082
59926083 The [enum@Pango.Variant] can either be %PANGO_VARIANT_NORMAL
59936084 or %PANGO_VARIANT_SMALL_CAPS.</doc>
5994- <source-position filename="pango/pango-font.h" line="300"/>
6085+ <source-position filename="pango/pango-font.h" line="324"/>
59956086 <return-value transfer-ownership="none">
59966087 <type name="none" c:type="void"/>
59976088 </return-value>
@@ -5999,13 +6090,13 @@ or %PANGO_VARIANT_SMALL_CAPS.</doc>
59996090 <instance-parameter name="desc" transfer-ownership="none">
60006091 <doc xml:space="preserve"
60016092 filename="pango/fonts.c"
6002- line="230">a `PangoFontDescription`</doc>
6093+ line="232">a `PangoFontDescription`</doc>
60036094 <type name="FontDescription" c:type="PangoFontDescription*"/>
60046095 </instance-parameter>
60056096 <parameter name="variant" transfer-ownership="none">
60066097 <doc xml:space="preserve"
60076098 filename="pango/fonts.c"
6008- line="231">the variant type for the font description.</doc>
6099+ line="233">the variant type for the font description.</doc>
60096100 <type name="Variant" c:type="PangoVariant"/>
60106101 </parameter>
60116102 </parameters>
@@ -6015,7 +6106,7 @@ or %PANGO_VARIANT_SMALL_CAPS.</doc>
60156106 version="1.42">
60166107 <doc xml:space="preserve"
60176108 filename="pango/fonts.c"
6018- line="551">Sets the variations field of a font description.
6109+ line="553">Sets the variations field of a font description.
60196110
60206111 OpenType font variations allow to select a font instance by
60216112 specifying values for a number of axes, such as width or weight.
@@ -6031,7 +6122,7 @@ and values are clamped to their allowed range.
60316122 Pango does not currently have a way to find supported axes of
60326123 a font. Both harfbuzz and freetype have API for this. See
60336124 for example [hb_ot_var_get_axis_infos](https://harfbuzz.github.io/harfbuzz-hb-ot-var.html#hb-ot-var-get-axis-infos).</doc>
6034- <source-position filename="pango/pango-font.h" line="334"/>
6125+ <source-position filename="pango/pango-font.h" line="358"/>
60356126 <return-value transfer-ownership="none">
60366127 <type name="none" c:type="void"/>
60376128 </return-value>
@@ -6039,7 +6130,7 @@ for example [hb_ot_var_get_axis_infos](https://harfbuzz.github.io/harfbuzz-hb-ot
60396130 <instance-parameter name="desc" transfer-ownership="none">
60406131 <doc xml:space="preserve"
60416132 filename="pango/fonts.c"
6042- line="553">a `PangoFontDescription`.</doc>
6133+ line="555">a `PangoFontDescription`.</doc>
60436134 <type name="FontDescription" c:type="PangoFontDescription*"/>
60446135 </instance-parameter>
60456136 <parameter name="variations"
@@ -6048,7 +6139,7 @@ for example [hb_ot_var_get_axis_infos](https://harfbuzz.github.io/harfbuzz-hb-ot
60486139 allow-none="1">
60496140 <doc xml:space="preserve"
60506141 filename="pango/fonts.c"
6051- line="554">a string representing the variations</doc>
6142+ line="556">a string representing the variations</doc>
60526143 <type name="utf8" c:type="const char*"/>
60536144 </parameter>
60546145 </parameters>
@@ -6058,7 +6149,7 @@ for example [hb_ot_var_get_axis_infos](https://harfbuzz.github.io/harfbuzz-hb-ot
60586149 version="1.42">
60596150 <doc xml:space="preserve"
60606151 filename="pango/fonts.c"
6061- line="509">Sets the variations field of a font description.
6152+ line="511">Sets the variations field of a font description.
60626153
60636154 This is like [method@Pango.FontDescription.set_variations], except
60646155 that no copy of @variations is made. The caller must make sure that
@@ -6066,7 +6157,7 @@ the string passed in stays around until @desc has been freed
60666157 or the name is set again. This function can be used if
60676158 @variations is a static string such as a C string literal,
60686159 or if @desc is only needed temporarily.</doc>
6069- <source-position filename="pango/pango-font.h" line="331"/>
6160+ <source-position filename="pango/pango-font.h" line="355"/>
60706161 <return-value transfer-ownership="none">
60716162 <type name="none" c:type="void"/>
60726163 </return-value>
@@ -6074,13 +6165,13 @@ or if @desc is only needed temporarily.</doc>
60746165 <instance-parameter name="desc" transfer-ownership="none">
60756166 <doc xml:space="preserve"
60766167 filename="pango/fonts.c"
6077- line="511">a `PangoFontDescription`</doc>
6168+ line="513">a `PangoFontDescription`</doc>
60786169 <type name="FontDescription" c:type="PangoFontDescription*"/>
60796170 </instance-parameter>
60806171 <parameter name="variations" transfer-ownership="none">
60816172 <doc xml:space="preserve"
60826173 filename="pango/fonts.c"
6083- line="512">a string representing the variations</doc>
6174+ line="514">a string representing the variations</doc>
60846175 <type name="utf8" c:type="const char*"/>
60856176 </parameter>
60866177 </parameters>
@@ -6089,13 +6180,13 @@ or if @desc is only needed temporarily.</doc>
60896180 c:identifier="pango_font_description_set_weight">
60906181 <doc xml:space="preserve"
60916182 filename="pango/fonts.c"
6092- line="268">Sets the weight field of a font description.
6183+ line="270">Sets the weight field of a font description.
60936184
60946185 The weight field
60956186 specifies how bold or light the font should be. In addition
60966187 to the values of the [enum@Pango.Weight] enumeration, other
60976188 intermediate numeric values are possible.</doc>
6098- <source-position filename="pango/pango-font.h" line="305"/>
6189+ <source-position filename="pango/pango-font.h" line="329"/>
60996190 <return-value transfer-ownership="none">
61006191 <type name="none" c:type="void"/>
61016192 </return-value>
@@ -6103,13 +6194,13 @@ intermediate numeric values are possible.</doc>
61036194 <instance-parameter name="desc" transfer-ownership="none">
61046195 <doc xml:space="preserve"
61056196 filename="pango/fonts.c"
6106- line="270">a `PangoFontDescription`</doc>
6197+ line="272">a `PangoFontDescription`</doc>
61076198 <type name="FontDescription" c:type="PangoFontDescription*"/>
61086199 </instance-parameter>
61096200 <parameter name="weight" transfer-ownership="none">
61106201 <doc xml:space="preserve"
61116202 filename="pango/fonts.c"
6112- line="271">the weight for the font description.</doc>
6203+ line="273">the weight for the font description.</doc>
61136204 <type name="Weight" c:type="PangoWeight"/>
61146205 </parameter>
61156206 </parameters>
@@ -6118,24 +6209,24 @@ intermediate numeric values are possible.</doc>
61186209 c:identifier="pango_font_description_to_filename">
61196210 <doc xml:space="preserve"
61206211 filename="pango/fonts.c"
6121- line="1808">Creates a filename representation of a font description.
6212+ line="1872">Creates a filename representation of a font description.
61226213
61236214 The filename is identical to the result from calling
61246215 [method@Pango.FontDescription.to_string], but with underscores
61256216 instead of characters that are untypical in filenames, and in
61266217 lower case only.</doc>
6127- <source-position filename="pango/pango-font.h" line="373"/>
6218+ <source-position filename="pango/pango-font.h" line="403"/>
61286219 <return-value transfer-ownership="full" nullable="1">
61296220 <doc xml:space="preserve"
61306221 filename="pango/fonts.c"
6131- line="1819">a new string that must be freed with g_free().</doc>
6222+ line="1883">a new string that must be freed with g_free().</doc>
61326223 <type name="utf8" c:type="char*"/>
61336224 </return-value>
61346225 <parameters>
61356226 <instance-parameter name="desc" transfer-ownership="none">
61366227 <doc xml:space="preserve"
61376228 filename="pango/fonts.c"
6138- line="1810">a `PangoFontDescription`</doc>
6229+ line="1874">a `PangoFontDescription`</doc>
61396230 <type name="FontDescription" c:type="const PangoFontDescription*"/>
61406231 </instance-parameter>
61416232 </parameters>
@@ -6143,24 +6234,24 @@ lower case only.</doc>
61436234 <method name="to_string" c:identifier="pango_font_description_to_string">
61446235 <doc xml:space="preserve"
61456236 filename="pango/fonts.c"
6146- line="1715">Creates a string representation of a font description.
6237+ line="1777">Creates a string representation of a font description.
61476238
61486239 See [func@Pango.FontDescription.from_string] for a description
61496240 of the format of the string representation. The family list in
61506241 the string description will only have a terminating comma if
61516242 the last word of the list is a valid style option.</doc>
6152- <source-position filename="pango/pango-font.h" line="371"/>
6243+ <source-position filename="pango/pango-font.h" line="401"/>
61536244 <return-value transfer-ownership="full">
61546245 <doc xml:space="preserve"
61556246 filename="pango/fonts.c"
6156- line="1726">a new string that must be freed with g_free().</doc>
6247+ line="1788">a new string that must be freed with g_free().</doc>
61576248 <type name="utf8" c:type="char*"/>
61586249 </return-value>
61596250 <parameters>
61606251 <instance-parameter name="desc" transfer-ownership="none">
61616252 <doc xml:space="preserve"
61626253 filename="pango/fonts.c"
6163- line="1717">a `PangoFontDescription`</doc>
6254+ line="1779">a `PangoFontDescription`</doc>
61646255 <type name="FontDescription" c:type="const PangoFontDescription*"/>
61656256 </instance-parameter>
61666257 </parameters>
@@ -6169,10 +6260,10 @@ the last word of the list is a valid style option.</doc>
61696260 c:identifier="pango_font_description_unset_fields">
61706261 <doc xml:space="preserve"
61716262 filename="pango/fonts.c"
6172- line="732">Unsets some of the fields in a `PangoFontDescription`.
6263+ line="779">Unsets some of the fields in a `PangoFontDescription`.
61736264
61746265 The unset fields will get back to their default values.</doc>
6175- <source-position filename="pango/pango-font.h" line="351"/>
6266+ <source-position filename="pango/pango-font.h" line="381"/>
61766267 <return-value transfer-ownership="none">
61776268 <type name="none" c:type="void"/>
61786269 </return-value>
@@ -6180,13 +6271,13 @@ The unset fields will get back to their default values.</doc>
61806271 <instance-parameter name="desc" transfer-ownership="none">
61816272 <doc xml:space="preserve"
61826273 filename="pango/fonts.c"
6183- line="734">a `PangoFontDescription`</doc>
6274+ line="781">a `PangoFontDescription`</doc>
61846275 <type name="FontDescription" c:type="PangoFontDescription*"/>
61856276 </instance-parameter>
61866277 <parameter name="to_unset" transfer-ownership="none">
61876278 <doc xml:space="preserve"
61886279 filename="pango/fonts.c"
6189- line="735">bitmask of fields in the @desc to unset.</doc>
6280+ line="782">bitmask of fields in the @desc to unset.</doc>
61906281 <type name="FontMask" c:type="PangoFontMask"/>
61916282 </parameter>
61926283 </parameters>
@@ -6195,7 +6286,7 @@ The unset fields will get back to their default values.</doc>
61956286 c:identifier="pango_font_description_from_string">
61966287 <doc xml:space="preserve"
61976288 filename="pango/fonts.c"
6198- line="1403">Creates a new font description from a string representation.
6289+ line="1462">Creates a new font description from a string representation.
61996290
62006291 The string must have the form
62016292
@@ -6228,6 +6319,9 @@ The following words are understood as gravity values:
62286319 "Not-Rotated", "South", "Upside-Down", "North", "Rotated-Left",
62296320 "East", "Rotated-Right", "West".
62306321
6322+The following words are understood as color values:
6323+"With-Color", "Without-Color".
6324+
62316325 VARIATIONS is a comma-separated list of font variations
62326326 of the form @<U+200D>axis1=value,axis2=value,...
62336327
@@ -6244,18 +6338,18 @@ size in the resulting font description will be set to 0.
62446338 A typical example:
62456339
62466340 Cantarell Italic Light 15 @<U+200D>wght=200 #<U+200D>tnum=1</doc>
6247- <source-position filename="pango/pango-font.h" line="369"/>
6341+ <source-position filename="pango/pango-font.h" line="399"/>
62486342 <return-value transfer-ownership="full">
62496343 <doc xml:space="preserve"
62506344 filename="pango/fonts.c"
6251- line="1457">a new `PangoFontDescription`.</doc>
6345+ line="1519">a new `PangoFontDescription`.</doc>
62526346 <type name="FontDescription" c:type="PangoFontDescription*"/>
62536347 </return-value>
62546348 <parameters>
62556349 <parameter name="str" transfer-ownership="none">
62566350 <doc xml:space="preserve"
62576351 filename="pango/fonts.c"
6258- line="1405">string representation of a font description.</doc>
6352+ line="1464">string representation of a font description.</doc>
62596353 <type name="utf8" c:type="const char*"/>
62606354 </parameter>
62616355 </parameters>
@@ -6271,22 +6365,22 @@ A typical example:
62716365 glib:type-struct="FontFaceClass">
62726366 <doc xml:space="preserve"
62736367 filename="pango/pango-font.h"
6274- line="513">A `PangoFontFace` is used to represent a group of fonts with
6368+ line="543">A `PangoFontFace` is used to represent a group of fonts with
62756369 the same family, slant, weight, and width, but varying sizes.</doc>
6276- <source-position filename="pango/pango-font.h" line="543"/>
6370+ <source-position filename="pango/pango-font.h" line="573"/>
62776371 <virtual-method name="describe" invoker="describe">
62786372 <doc xml:space="preserve"
62796373 filename="pango/fonts.c"
6280- line="2983">Returns a font description that matches the face.
6374+ line="3057">Returns a font description that matches the face.
62816375
62826376 The resulting font description will have the family, style,
62836377 variant, weight and stretch of the face, but its size field
62846378 will be unset.</doc>
6285- <source-position filename="pango/pango-font.h" line="531"/>
6379+ <source-position filename="pango/pango-font.h" line="561"/>
62866380 <return-value transfer-ownership="full">
62876381 <doc xml:space="preserve"
62886382 filename="pango/fonts.c"
6289- line="2993">a newly-created `PangoFontDescription` structure
6383+ line="3067">a newly-created `PangoFontDescription` structure
62906384 holding the description of the face. Use [method@Pango.FontDescription.free]
62916385 to free the result.</doc>
62926386 <type name="FontDescription" c:type="PangoFontDescription*"/>
@@ -6295,7 +6389,7 @@ will be unset.</doc>
62956389 <instance-parameter name="face" transfer-ownership="none">
62966390 <doc xml:space="preserve"
62976391 filename="pango/fonts.c"
6298- line="2985">a `PangoFontFace`</doc>
6392+ line="3059">a `PangoFontFace`</doc>
62996393 <type name="FontFace" c:type="PangoFontFace*"/>
63006394 </instance-parameter>
63016395 </parameters>
@@ -6303,16 +6397,16 @@ will be unset.</doc>
63036397 <virtual-method name="get_face_name" invoker="get_face_name">
63046398 <doc xml:space="preserve"
63056399 filename="pango/fonts.c"
6306- line="3030">Gets a name representing the style of this face.
6400+ line="3104">Gets a name representing the style of this face.
63076401
63086402 Note that a font family may contain multiple faces
63096403 with the same name (e.g. a variable and a non-variable
63106404 face for the same style).</doc>
6311- <source-position filename="pango/pango-font.h" line="530"/>
6405+ <source-position filename="pango/pango-font.h" line="560"/>
63126406 <return-value transfer-ownership="none">
63136407 <doc xml:space="preserve"
63146408 filename="pango/fonts.c"
6315- line="3040">the face name for the face. This string is
6409+ line="3114">the face name for the face. This string is
63166410 owned by the face object and must not be modified or freed.</doc>
63176411 <type name="utf8" c:type="const char*"/>
63186412 </return-value>
@@ -6320,7 +6414,7 @@ face for the same style).</doc>
63206414 <instance-parameter name="face" transfer-ownership="none">
63216415 <doc xml:space="preserve"
63226416 filename="pango/fonts.c"
6323- line="3032">a `PangoFontFace`.</doc>
6417+ line="3106">a `PangoFontFace`.</doc>
63246418 <type name="FontFace" c:type="PangoFontFace*"/>
63256419 </instance-parameter>
63266420 </parameters>
@@ -6328,19 +6422,19 @@ face for the same style).</doc>
63286422 <virtual-method name="get_family" invoker="get_family" version="1.46">
63296423 <doc xml:space="preserve"
63306424 filename="pango/fonts.c"
6331- line="3089">Gets the `PangoFontFamily` that @face belongs to.</doc>
6332- <source-position filename="pango/pango-font.h" line="536"/>
6425+ line="3163">Gets the `PangoFontFamily` that @face belongs to.</doc>
6426+ <source-position filename="pango/pango-font.h" line="566"/>
63336427 <return-value transfer-ownership="none">
63346428 <doc xml:space="preserve"
63356429 filename="pango/fonts.c"
6336- line="3095">the `PangoFontFamily`</doc>
6430+ line="3169">the `PangoFontFamily`</doc>
63376431 <type name="FontFamily" c:type="PangoFontFamily*"/>
63386432 </return-value>
63396433 <parameters>
63406434 <instance-parameter name="face" transfer-ownership="none">
63416435 <doc xml:space="preserve"
63426436 filename="pango/fonts.c"
6343- line="3091">a `PangoFontFace`</doc>
6437+ line="3165">a `PangoFontFace`</doc>
63446438 <type name="FontFace" c:type="PangoFontFace*"/>
63456439 </instance-parameter>
63466440 </parameters>
@@ -6350,23 +6444,23 @@ face for the same style).</doc>
63506444 version="1.18">
63516445 <doc xml:space="preserve"
63526446 filename="pango/fonts.c"
6353- line="3005">Returns whether a `PangoFontFace` is synthesized.
6447+ line="3079">Returns whether a `PangoFontFace` is synthesized.
63546448
63556449 This will be the case if the underlying font rendering engine
63566450 creates this face from another face, by shearing, emboldening,
63576451 lightening or modifying it in some other way.</doc>
6358- <source-position filename="pango/pango-font.h" line="535"/>
6452+ <source-position filename="pango/pango-font.h" line="565"/>
63596453 <return-value transfer-ownership="none">
63606454 <doc xml:space="preserve"
63616455 filename="pango/fonts.c"
6362- line="3015">whether @face is synthesized</doc>
6456+ line="3089">whether @face is synthesized</doc>
63636457 <type name="gboolean" c:type="gboolean"/>
63646458 </return-value>
63656459 <parameters>
63666460 <instance-parameter name="face" transfer-ownership="none">
63676461 <doc xml:space="preserve"
63686462 filename="pango/fonts.c"
6369- line="3007">a `PangoFontFace`</doc>
6463+ line="3081">a `PangoFontFace`</doc>
63706464 <type name="FontFace" c:type="PangoFontFace*"/>
63716465 </instance-parameter>
63726466 </parameters>
@@ -6374,13 +6468,13 @@ lightening or modifying it in some other way.</doc>
63746468 <virtual-method name="list_sizes" invoker="list_sizes" version="1.4">
63756469 <doc xml:space="preserve"
63766470 filename="pango/fonts.c"
6377- line="3051">List the available sizes for a font.
6471+ line="3125">List the available sizes for a font.
63786472
63796473 This is only applicable to bitmap fonts. For scalable fonts, stores
63806474 %NULL at the location pointed to by @sizes and 0 at the location pointed
63816475 to by @n_sizes. The sizes returned are in Pango units and are sorted
63826476 in ascending order.</doc>
6383- <source-position filename="pango/pango-font.h" line="532"/>
6477+ <source-position filename="pango/pango-font.h" line="562"/>
63846478 <return-value transfer-ownership="none">
63856479 <type name="none" c:type="void"/>
63866480 </return-value>
@@ -6388,7 +6482,7 @@ in ascending order.</doc>
63886482 <instance-parameter name="face" transfer-ownership="none">
63896483 <doc xml:space="preserve"
63906484 filename="pango/fonts.c"
6391- line="3053">a `PangoFontFace`.</doc>
6485+ line="3127">a `PangoFontFace`.</doc>
63926486 <type name="FontFace" c:type="PangoFontFace*"/>
63936487 </instance-parameter>
63946488 <parameter name="sizes"
@@ -6400,7 +6494,7 @@ in ascending order.</doc>
64006494 allow-none="1">
64016495 <doc xml:space="preserve"
64026496 filename="pango/fonts.c"
6403- line="3054">
6497+ line="3128">
64046498 location to store a pointer to an array of int. This array
64056499 should be freed with g_free().</doc>
64066500 <array length="1" zero-terminated="0" c:type="int**">
@@ -6413,7 +6507,7 @@ in ascending order.</doc>
64136507 transfer-ownership="full">
64146508 <doc xml:space="preserve"
64156509 filename="pango/fonts.c"
6416- line="3057">location to store the number of elements in @sizes</doc>
6510+ line="3131">location to store the number of elements in @sizes</doc>
64176511 <type name="gint" c:type="int*"/>
64186512 </parameter>
64196513 </parameters>
@@ -6421,16 +6515,16 @@ in ascending order.</doc>
64216515 <method name="describe" c:identifier="pango_font_face_describe">
64226516 <doc xml:space="preserve"
64236517 filename="pango/fonts.c"
6424- line="2983">Returns a font description that matches the face.
6518+ line="3057">Returns a font description that matches the face.
64256519
64266520 The resulting font description will have the family, style,
64276521 variant, weight and stretch of the face, but its size field
64286522 will be unset.</doc>
6429- <source-position filename="pango/pango-font.h" line="551"/>
6523+ <source-position filename="pango/pango-font.h" line="581"/>
64306524 <return-value transfer-ownership="full">
64316525 <doc xml:space="preserve"
64326526 filename="pango/fonts.c"
6433- line="2993">a newly-created `PangoFontDescription` structure
6527+ line="3067">a newly-created `PangoFontDescription` structure
64346528 holding the description of the face. Use [method@Pango.FontDescription.free]
64356529 to free the result.</doc>
64366530 <type name="FontDescription" c:type="PangoFontDescription*"/>
@@ -6439,7 +6533,7 @@ will be unset.</doc>
64396533 <instance-parameter name="face" transfer-ownership="none">
64406534 <doc xml:space="preserve"
64416535 filename="pango/fonts.c"
6442- line="2985">a `PangoFontFace`</doc>
6536+ line="3059">a `PangoFontFace`</doc>
64436537 <type name="FontFace" c:type="PangoFontFace*"/>
64446538 </instance-parameter>
64456539 </parameters>
@@ -6448,16 +6542,16 @@ will be unset.</doc>
64486542 c:identifier="pango_font_face_get_face_name">
64496543 <doc xml:space="preserve"
64506544 filename="pango/fonts.c"
6451- line="3030">Gets a name representing the style of this face.
6545+ line="3104">Gets a name representing the style of this face.
64526546
64536547 Note that a font family may contain multiple faces
64546548 with the same name (e.g. a variable and a non-variable
64556549 face for the same style).</doc>
6456- <source-position filename="pango/pango-font.h" line="553"/>
6550+ <source-position filename="pango/pango-font.h" line="583"/>
64576551 <return-value transfer-ownership="none">
64586552 <doc xml:space="preserve"
64596553 filename="pango/fonts.c"
6460- line="3040">the face name for the face. This string is
6554+ line="3114">the face name for the face. This string is
64616555 owned by the face object and must not be modified or freed.</doc>
64626556 <type name="utf8" c:type="const char*"/>
64636557 </return-value>
@@ -6465,7 +6559,7 @@ face for the same style).</doc>
64656559 <instance-parameter name="face" transfer-ownership="none">
64666560 <doc xml:space="preserve"
64676561 filename="pango/fonts.c"
6468- line="3032">a `PangoFontFace`.</doc>
6562+ line="3106">a `PangoFontFace`.</doc>
64696563 <type name="FontFace" c:type="PangoFontFace*"/>
64706564 </instance-parameter>
64716565 </parameters>
@@ -6475,19 +6569,19 @@ face for the same style).</doc>
64756569 version="1.46">
64766570 <doc xml:space="preserve"
64776571 filename="pango/fonts.c"
6478- line="3089">Gets the `PangoFontFamily` that @face belongs to.</doc>
6479- <source-position filename="pango/pango-font.h" line="562"/>
6572+ line="3163">Gets the `PangoFontFamily` that @face belongs to.</doc>
6573+ <source-position filename="pango/pango-font.h" line="592"/>
64806574 <return-value transfer-ownership="none">
64816575 <doc xml:space="preserve"
64826576 filename="pango/fonts.c"
6483- line="3095">the `PangoFontFamily`</doc>
6577+ line="3169">the `PangoFontFamily`</doc>
64846578 <type name="FontFamily" c:type="PangoFontFamily*"/>
64856579 </return-value>
64866580 <parameters>
64876581 <instance-parameter name="face" transfer-ownership="none">
64886582 <doc xml:space="preserve"
64896583 filename="pango/fonts.c"
6490- line="3091">a `PangoFontFace`</doc>
6584+ line="3165">a `PangoFontFace`</doc>
64916585 <type name="FontFace" c:type="PangoFontFace*"/>
64926586 </instance-parameter>
64936587 </parameters>
@@ -6497,23 +6591,23 @@ face for the same style).</doc>
64976591 version="1.18">
64986592 <doc xml:space="preserve"
64996593 filename="pango/fonts.c"
6500- line="3005">Returns whether a `PangoFontFace` is synthesized.
6594+ line="3079">Returns whether a `PangoFontFace` is synthesized.
65016595
65026596 This will be the case if the underlying font rendering engine
65036597 creates this face from another face, by shearing, emboldening,
65046598 lightening or modifying it in some other way.</doc>
6505- <source-position filename="pango/pango-font.h" line="559"/>
6599+ <source-position filename="pango/pango-font.h" line="589"/>
65066600 <return-value transfer-ownership="none">
65076601 <doc xml:space="preserve"
65086602 filename="pango/fonts.c"
6509- line="3015">whether @face is synthesized</doc>
6603+ line="3089">whether @face is synthesized</doc>
65106604 <type name="gboolean" c:type="gboolean"/>
65116605 </return-value>
65126606 <parameters>
65136607 <instance-parameter name="face" transfer-ownership="none">
65146608 <doc xml:space="preserve"
65156609 filename="pango/fonts.c"
6516- line="3007">a `PangoFontFace`</doc>
6610+ line="3081">a `PangoFontFace`</doc>
65176611 <type name="FontFace" c:type="PangoFontFace*"/>
65186612 </instance-parameter>
65196613 </parameters>
@@ -6523,13 +6617,13 @@ lightening or modifying it in some other way.</doc>
65236617 version="1.4">
65246618 <doc xml:space="preserve"
65256619 filename="pango/fonts.c"
6526- line="3051">List the available sizes for a font.
6620+ line="3125">List the available sizes for a font.
65276621
65286622 This is only applicable to bitmap fonts. For scalable fonts, stores
65296623 %NULL at the location pointed to by @sizes and 0 at the location pointed
65306624 to by @n_sizes. The sizes returned are in Pango units and are sorted
65316625 in ascending order.</doc>
6532- <source-position filename="pango/pango-font.h" line="555"/>
6626+ <source-position filename="pango/pango-font.h" line="585"/>
65336627 <return-value transfer-ownership="none">
65346628 <type name="none" c:type="void"/>
65356629 </return-value>
@@ -6537,7 +6631,7 @@ in ascending order.</doc>
65376631 <instance-parameter name="face" transfer-ownership="none">
65386632 <doc xml:space="preserve"
65396633 filename="pango/fonts.c"
6540- line="3053">a `PangoFontFace`.</doc>
6634+ line="3127">a `PangoFontFace`.</doc>
65416635 <type name="FontFace" c:type="PangoFontFace*"/>
65426636 </instance-parameter>
65436637 <parameter name="sizes"
@@ -6549,7 +6643,7 @@ in ascending order.</doc>
65496643 allow-none="1">
65506644 <doc xml:space="preserve"
65516645 filename="pango/fonts.c"
6552- line="3054">
6646+ line="3128">
65536647 location to store a pointer to an array of int. This array
65546648 should be freed with g_free().</doc>
65556649 <array length="1" zero-terminated="0" c:type="int**">
@@ -6562,7 +6656,7 @@ in ascending order.</doc>
65626656 transfer-ownership="full">
65636657 <doc xml:space="preserve"
65646658 filename="pango/fonts.c"
6565- line="3057">location to store the number of elements in @sizes</doc>
6659+ line="3131">location to store the number of elements in @sizes</doc>
65666660 <type name="gint" c:type="int*"/>
65676661 </parameter>
65686662 </parameters>
@@ -6574,17 +6668,17 @@ in ascending order.</doc>
65746668 <record name="FontFaceClass"
65756669 c:type="PangoFontFaceClass"
65766670 glib:is-gtype-struct-for="FontFace">
6577- <source-position filename="pango/pango-font.h" line="543"/>
6671+ <source-position filename="pango/pango-font.h" line="573"/>
65786672 <field name="parent_class">
65796673 <type name="GObject.ObjectClass" c:type="GObjectClass"/>
65806674 </field>
65816675 <field name="get_face_name">
65826676 <callback name="get_face_name">
6583- <source-position filename="pango/pango-font.h" line="530"/>
6677+ <source-position filename="pango/pango-font.h" line="560"/>
65846678 <return-value transfer-ownership="none">
65856679 <doc xml:space="preserve"
65866680 filename="pango/fonts.c"
6587- line="3040">the face name for the face. This string is
6681+ line="3114">the face name for the face. This string is
65886682 owned by the face object and must not be modified or freed.</doc>
65896683 <type name="utf8" c:type="const char*"/>
65906684 </return-value>
@@ -6592,7 +6686,7 @@ in ascending order.</doc>
65926686 <parameter name="face" transfer-ownership="none">
65936687 <doc xml:space="preserve"
65946688 filename="pango/fonts.c"
6595- line="3032">a `PangoFontFace`.</doc>
6689+ line="3106">a `PangoFontFace`.</doc>
65966690 <type name="FontFace" c:type="PangoFontFace*"/>
65976691 </parameter>
65986692 </parameters>
@@ -6600,11 +6694,11 @@ in ascending order.</doc>
66006694 </field>
66016695 <field name="describe">
66026696 <callback name="describe">
6603- <source-position filename="pango/pango-font.h" line="531"/>
6697+ <source-position filename="pango/pango-font.h" line="561"/>
66046698 <return-value transfer-ownership="full">
66056699 <doc xml:space="preserve"
66066700 filename="pango/fonts.c"
6607- line="2993">a newly-created `PangoFontDescription` structure
6701+ line="3067">a newly-created `PangoFontDescription` structure
66086702 holding the description of the face. Use [method@Pango.FontDescription.free]
66096703 to free the result.</doc>
66106704 <type name="FontDescription" c:type="PangoFontDescription*"/>
@@ -6613,7 +6707,7 @@ in ascending order.</doc>
66136707 <parameter name="face" transfer-ownership="none">
66146708 <doc xml:space="preserve"
66156709 filename="pango/fonts.c"
6616- line="2985">a `PangoFontFace`</doc>
6710+ line="3059">a `PangoFontFace`</doc>
66176711 <type name="FontFace" c:type="PangoFontFace*"/>
66186712 </parameter>
66196713 </parameters>
@@ -6621,7 +6715,7 @@ in ascending order.</doc>
66216715 </field>
66226716 <field name="list_sizes">
66236717 <callback name="list_sizes">
6624- <source-position filename="pango/pango-font.h" line="532"/>
6718+ <source-position filename="pango/pango-font.h" line="562"/>
66256719 <return-value transfer-ownership="none">
66266720 <type name="none" c:type="void"/>
66276721 </return-value>
@@ -6629,7 +6723,7 @@ in ascending order.</doc>
66296723 <parameter name="face" transfer-ownership="none">
66306724 <doc xml:space="preserve"
66316725 filename="pango/fonts.c"
6632- line="3053">a `PangoFontFace`.</doc>
6726+ line="3127">a `PangoFontFace`.</doc>
66336727 <type name="FontFace" c:type="PangoFontFace*"/>
66346728 </parameter>
66356729 <parameter name="sizes"
@@ -6641,7 +6735,7 @@ in ascending order.</doc>
66416735 allow-none="1">
66426736 <doc xml:space="preserve"
66436737 filename="pango/fonts.c"
6644- line="3054">
6738+ line="3128">
66456739 location to store a pointer to an array of int. This array
66466740 should be freed with g_free().</doc>
66476741 <array length="2" zero-terminated="0" c:type="int**">
@@ -6654,7 +6748,7 @@ in ascending order.</doc>
66546748 transfer-ownership="full">
66556749 <doc xml:space="preserve"
66566750 filename="pango/fonts.c"
6657- line="3057">location to store the number of elements in @sizes</doc>
6751+ line="3131">location to store the number of elements in @sizes</doc>
66586752 <type name="gint" c:type="int*"/>
66596753 </parameter>
66606754 </parameters>
@@ -6662,18 +6756,18 @@ in ascending order.</doc>
66626756 </field>
66636757 <field name="is_synthesized">
66646758 <callback name="is_synthesized">
6665- <source-position filename="pango/pango-font.h" line="535"/>
6759+ <source-position filename="pango/pango-font.h" line="565"/>
66666760 <return-value transfer-ownership="none">
66676761 <doc xml:space="preserve"
66686762 filename="pango/fonts.c"
6669- line="3015">whether @face is synthesized</doc>
6763+ line="3089">whether @face is synthesized</doc>
66706764 <type name="gboolean" c:type="gboolean"/>
66716765 </return-value>
66726766 <parameters>
66736767 <parameter name="face" transfer-ownership="none">
66746768 <doc xml:space="preserve"
66756769 filename="pango/fonts.c"
6676- line="3007">a `PangoFontFace`</doc>
6770+ line="3081">a `PangoFontFace`</doc>
66776771 <type name="FontFace" c:type="PangoFontFace*"/>
66786772 </parameter>
66796773 </parameters>
@@ -6681,18 +6775,18 @@ in ascending order.</doc>
66816775 </field>
66826776 <field name="get_family">
66836777 <callback name="get_family">
6684- <source-position filename="pango/pango-font.h" line="536"/>
6778+ <source-position filename="pango/pango-font.h" line="566"/>
66856779 <return-value transfer-ownership="none">
66866780 <doc xml:space="preserve"
66876781 filename="pango/fonts.c"
6688- line="3095">the `PangoFontFamily`</doc>
6782+ line="3169">the `PangoFontFamily`</doc>
66896783 <type name="FontFamily" c:type="PangoFontFamily*"/>
66906784 </return-value>
66916785 <parameters>
66926786 <parameter name="face" transfer-ownership="none">
66936787 <doc xml:space="preserve"
66946788 filename="pango/fonts.c"
6695- line="3091">a `PangoFontFace`</doc>
6789+ line="3165">a `PangoFontFace`</doc>
66966790 <type name="FontFace" c:type="PangoFontFace*"/>
66976791 </parameter>
66986792 </parameters>
@@ -6700,7 +6794,7 @@ in ascending order.</doc>
67006794 </field>
67016795 <field name="_pango_reserved3" introspectable="0">
67026796 <callback name="_pango_reserved3">
6703- <source-position filename="pango/pango-font.h" line="541"/>
6797+ <source-position filename="pango/pango-font.h" line="571"/>
67046798 <return-value transfer-ownership="none">
67056799 <type name="none" c:type="void"/>
67066800 </return-value>
@@ -6708,7 +6802,7 @@ in ascending order.</doc>
67086802 </field>
67096803 <field name="_pango_reserved4" introspectable="0">
67106804 <callback name="_pango_reserved4">
6711- <source-position filename="pango/pango-font.h" line="542"/>
6805+ <source-position filename="pango/pango-font.h" line="572"/>
67126806 <return-value transfer-ownership="none">
67136807 <type name="none" c:type="void"/>
67146808 </return-value>
@@ -6725,22 +6819,22 @@ in ascending order.</doc>
67256819 glib:type-struct="FontFamilyClass">
67266820 <doc xml:space="preserve"
67276821 filename="pango/pango-font.h"
6728- line="440">A `PangoFontFamily` is used to represent a family of related
6822+ line="470">A `PangoFontFamily` is used to represent a family of related
67296823 font faces.
67306824
67316825 The font faces in a family share a common design, but differ in
67326826 slant, weight, width or other aspects.</doc>
6733- <source-position filename="pango/pango-font.h" line="475"/>
6827+ <source-position filename="pango/pango-font.h" line="505"/>
67346828 <implements name="Gio.ListModel"/>
67356829 <virtual-method name="get_face" invoker="get_face" version="1.46">
67366830 <doc xml:space="preserve"
67376831 filename="pango/fonts.c"
6738- line="2891">Gets the `PangoFontFace` of @family with the given name.</doc>
6739- <source-position filename="pango/pango-font.h" line="467"/>
6832+ line="2965">Gets the `PangoFontFace` of @family with the given name.</doc>
6833+ <source-position filename="pango/pango-font.h" line="497"/>
67406834 <return-value transfer-ownership="none" nullable="1">
67416835 <doc xml:space="preserve"
67426836 filename="pango/fonts.c"
6743- line="2900">the `PangoFontFace`,
6837+ line="2974">the `PangoFontFace`,
67446838 or %NULL if no face with the given name exists.</doc>
67456839 <type name="FontFace" c:type="PangoFontFace*"/>
67466840 </return-value>
@@ -6748,7 +6842,7 @@ slant, weight, width or other aspects.</doc>
67486842 <instance-parameter name="family" transfer-ownership="none">
67496843 <doc xml:space="preserve"
67506844 filename="pango/fonts.c"
6751- line="2893">a `PangoFontFamily`</doc>
6845+ line="2967">a `PangoFontFamily`</doc>
67526846 <type name="FontFamily" c:type="PangoFontFamily*"/>
67536847 </instance-parameter>
67546848 <parameter name="name"
@@ -6757,7 +6851,7 @@ slant, weight, width or other aspects.</doc>
67576851 allow-none="1">
67586852 <doc xml:space="preserve"
67596853 filename="pango/fonts.c"
6760- line="2894">the name of a face. If the name is %NULL,
6854+ line="2968">the name of a face. If the name is %NULL,
67616855 the family's default face (fontconfig calls it "Regular")
67626856 will be returned.</doc>
67636857 <type name="utf8" c:type="const char*"/>
@@ -6767,16 +6861,16 @@ slant, weight, width or other aspects.</doc>
67676861 <virtual-method name="get_name" invoker="get_name">
67686862 <doc xml:space="preserve"
67696863 filename="pango/fonts.c"
6770- line="2807">Gets the name of the family.
6864+ line="2881">Gets the name of the family.
67716865
67726866 The name is unique among all fonts for the font backend and can
67736867 be used in a `PangoFontDescription` to specify that a face from
67746868 this family is desired.</doc>
6775- <source-position filename="pango/pango-font.h" line="463"/>
6869+ <source-position filename="pango/pango-font.h" line="493"/>
67766870 <return-value transfer-ownership="none">
67776871 <doc xml:space="preserve"
67786872 filename="pango/fonts.c"
6779- line="2817">the name of the family. This string is owned
6873+ line="2891">the name of the family. This string is owned
67806874 by the family object and must not be modified or freed.</doc>
67816875 <type name="utf8" c:type="const char*"/>
67826876 </return-value>
@@ -6784,7 +6878,7 @@ this family is desired.</doc>
67846878 <instance-parameter name="family" transfer-ownership="none">
67856879 <doc xml:space="preserve"
67866880 filename="pango/fonts.c"
6787- line="2809">a `PangoFontFamily`</doc>
6881+ line="2883">a `PangoFontFamily`</doc>
67886882 <type name="FontFamily" c:type="PangoFontFamily*"/>
67896883 </instance-parameter>
67906884 </parameters>
@@ -6792,7 +6886,7 @@ this family is desired.</doc>
67926886 <virtual-method name="is_monospace" invoker="is_monospace" version="1.4">
67936887 <doc xml:space="preserve"
67946888 filename="pango/fonts.c"
6795- line="2914">A monospace font is a font designed for text display where the the
6889+ line="2988">A monospace font is a font designed for text display where the the
67966890 characters form a regular grid.
67976891
67986892 For Western languages this would
@@ -6806,18 +6900,18 @@ The best way to find out the grid-cell size is to call
68066900 [method@Pango.FontMetrics.get_approximate_digit_width], since the
68076901 results of [method@Pango.FontMetrics.get_approximate_char_width] may
68086902 be affected by double-width characters.</doc>
6809- <source-position filename="pango/pango-font.h" line="464"/>
6903+ <source-position filename="pango/pango-font.h" line="494"/>
68106904 <return-value transfer-ownership="none">
68116905 <doc xml:space="preserve"
68126906 filename="pango/fonts.c"
6813- line="2933">%TRUE if the family is monospace.</doc>
6907+ line="3007">%TRUE if the family is monospace.</doc>
68146908 <type name="gboolean" c:type="gboolean"/>
68156909 </return-value>
68166910 <parameters>
68176911 <instance-parameter name="family" transfer-ownership="none">
68186912 <doc xml:space="preserve"
68196913 filename="pango/fonts.c"
6820- line="2916">a `PangoFontFamily`</doc>
6914+ line="2990">a `PangoFontFamily`</doc>
68216915 <type name="FontFamily" c:type="PangoFontFamily*"/>
68226916 </instance-parameter>
68236917 </parameters>
@@ -6825,23 +6919,23 @@ be affected by double-width characters.</doc>
68256919 <virtual-method name="is_variable" invoker="is_variable" version="1.44">
68266920 <doc xml:space="preserve"
68276921 filename="pango/fonts.c"
6828- line="2945">A variable font is a font which has axes that can be modified to
6922+ line="3019">A variable font is a font which has axes that can be modified to
68296923 produce different faces.
68306924
68316925 Such axes are also known as _variations_; see
68326926 [method@Pango.FontDescription.set_variations] for more information.</doc>
6833- <source-position filename="pango/pango-font.h" line="465"/>
6927+ <source-position filename="pango/pango-font.h" line="495"/>
68346928 <return-value transfer-ownership="none">
68356929 <doc xml:space="preserve"
68366930 filename="pango/fonts.c"
6837- line="2955">%TRUE if the family is variable</doc>
6931+ line="3029">%TRUE if the family is variable</doc>
68386932 <type name="gboolean" c:type="gboolean"/>
68396933 </return-value>
68406934 <parameters>
68416935 <instance-parameter name="family" transfer-ownership="none">
68426936 <doc xml:space="preserve"
68436937 filename="pango/fonts.c"
6844- line="2947">a `PangoFontFamily`</doc>
6938+ line="3021">a `PangoFontFamily`</doc>
68456939 <type name="FontFamily" c:type="PangoFontFamily*"/>
68466940 </instance-parameter>
68476941 </parameters>
@@ -6849,7 +6943,7 @@ Such axes are also known as _variations_; see
68496943 <virtual-method name="list_faces" invoker="list_faces">
68506944 <doc xml:space="preserve"
68516945 filename="pango/fonts.c"
6852- line="2828">Lists the different font faces that make up @family.
6946+ line="2902">Lists the different font faces that make up @family.
68536947
68546948 The faces in a family share a common design, but differ in slant, weight,
68556949 width and other aspects.
@@ -6859,7 +6953,7 @@ multiple faces may have the same name or characteristics.
68596953
68606954 `PangoFontFamily` also implemented the [iface@Gio.ListModel] interface
68616955 for enumerating faces.</doc>
6862- <source-position filename="pango/pango-font.h" line="460"/>
6956+ <source-position filename="pango/pango-font.h" line="490"/>
68636957 <return-value transfer-ownership="none">
68646958 <type name="none" c:type="void"/>
68656959 </return-value>
@@ -6867,7 +6961,7 @@ for enumerating faces.</doc>
68676961 <instance-parameter name="family" transfer-ownership="none">
68686962 <doc xml:space="preserve"
68696963 filename="pango/fonts.c"
6870- line="2830">a `PangoFontFamily`</doc>
6964+ line="2904">a `PangoFontFamily`</doc>
68716965 <type name="FontFamily" c:type="PangoFontFamily*"/>
68726966 </instance-parameter>
68736967 <parameter name="faces"
@@ -6878,7 +6972,7 @@ for enumerating faces.</doc>
68786972 allow-none="1">
68796973 <doc xml:space="preserve"
68806974 filename="pango/fonts.c"
6881- line="2831">
6975+ line="2905">
68826976 location to store an array of pointers to `PangoFontFace` objects,
68836977 or %NULL. This array should be freed with g_free() when it is no
68846978 longer needed.</doc>
@@ -6892,7 +6986,7 @@ for enumerating faces.</doc>
68926986 transfer-ownership="full">
68936987 <doc xml:space="preserve"
68946988 filename="pango/fonts.c"
6895- line="2835">location to store number of elements in @faces.</doc>
6989+ line="2909">location to store number of elements in @faces.</doc>
68966990 <type name="gint" c:type="int*"/>
68976991 </parameter>
68986992 </parameters>
@@ -6902,12 +6996,12 @@ for enumerating faces.</doc>
69026996 version="1.46">
69036997 <doc xml:space="preserve"
69046998 filename="pango/fonts.c"
6905- line="2891">Gets the `PangoFontFace` of @family with the given name.</doc>
6906- <source-position filename="pango/pango-font.h" line="494"/>
6999+ line="2965">Gets the `PangoFontFace` of @family with the given name.</doc>
7000+ <source-position filename="pango/pango-font.h" line="524"/>
69077001 <return-value transfer-ownership="none" nullable="1">
69087002 <doc xml:space="preserve"
69097003 filename="pango/fonts.c"
6910- line="2900">the `PangoFontFace`,
7004+ line="2974">the `PangoFontFace`,
69117005 or %NULL if no face with the given name exists.</doc>
69127006 <type name="FontFace" c:type="PangoFontFace*"/>
69137007 </return-value>
@@ -6915,7 +7009,7 @@ for enumerating faces.</doc>
69157009 <instance-parameter name="family" transfer-ownership="none">
69167010 <doc xml:space="preserve"
69177011 filename="pango/fonts.c"
6918- line="2893">a `PangoFontFamily`</doc>
7012+ line="2967">a `PangoFontFamily`</doc>
69197013 <type name="FontFamily" c:type="PangoFontFamily*"/>
69207014 </instance-parameter>
69217015 <parameter name="name"
@@ -6924,7 +7018,7 @@ for enumerating faces.</doc>
69247018 allow-none="1">
69257019 <doc xml:space="preserve"
69267020 filename="pango/fonts.c"
6927- line="2894">the name of a face. If the name is %NULL,
7021+ line="2968">the name of a face. If the name is %NULL,
69287022 the family's default face (fontconfig calls it "Regular")
69297023 will be returned.</doc>
69307024 <type name="utf8" c:type="const char*"/>
@@ -6936,16 +7030,16 @@ for enumerating faces.</doc>
69367030 glib:get-property="name">
69377031 <doc xml:space="preserve"
69387032 filename="pango/fonts.c"
6939- line="2807">Gets the name of the family.
7033+ line="2881">Gets the name of the family.
69407034
69417035 The name is unique among all fonts for the font backend and can
69427036 be used in a `PangoFontDescription` to specify that a face from
69437037 this family is desired.</doc>
6944- <source-position filename="pango/pango-font.h" line="487"/>
7038+ <source-position filename="pango/pango-font.h" line="517"/>
69457039 <return-value transfer-ownership="none">
69467040 <doc xml:space="preserve"
69477041 filename="pango/fonts.c"
6948- line="2817">the name of the family. This string is owned
7042+ line="2891">the name of the family. This string is owned
69497043 by the family object and must not be modified or freed.</doc>
69507044 <type name="utf8" c:type="const char*"/>
69517045 </return-value>
@@ -6953,7 +7047,7 @@ this family is desired.</doc>
69537047 <instance-parameter name="family" transfer-ownership="none">
69547048 <doc xml:space="preserve"
69557049 filename="pango/fonts.c"
6956- line="2809">a `PangoFontFamily`</doc>
7050+ line="2883">a `PangoFontFamily`</doc>
69577051 <type name="FontFamily" c:type="PangoFontFamily*"/>
69587052 </instance-parameter>
69597053 </parameters>
@@ -6964,7 +7058,7 @@ this family is desired.</doc>
69647058 version="1.4">
69657059 <doc xml:space="preserve"
69667060 filename="pango/fonts.c"
6967- line="2914">A monospace font is a font designed for text display where the the
7061+ line="2988">A monospace font is a font designed for text display where the the
69687062 characters form a regular grid.
69697063
69707064 For Western languages this would
@@ -6978,18 +7072,18 @@ The best way to find out the grid-cell size is to call
69787072 [method@Pango.FontMetrics.get_approximate_digit_width], since the
69797073 results of [method@Pango.FontMetrics.get_approximate_char_width] may
69807074 be affected by double-width characters.</doc>
6981- <source-position filename="pango/pango-font.h" line="489"/>
7075+ <source-position filename="pango/pango-font.h" line="519"/>
69827076 <return-value transfer-ownership="none">
69837077 <doc xml:space="preserve"
69847078 filename="pango/fonts.c"
6985- line="2933">%TRUE if the family is monospace.</doc>
7079+ line="3007">%TRUE if the family is monospace.</doc>
69867080 <type name="gboolean" c:type="gboolean"/>
69877081 </return-value>
69887082 <parameters>
69897083 <instance-parameter name="family" transfer-ownership="none">
69907084 <doc xml:space="preserve"
69917085 filename="pango/fonts.c"
6992- line="2916">a `PangoFontFamily`</doc>
7086+ line="2990">a `PangoFontFamily`</doc>
69937087 <type name="FontFamily" c:type="PangoFontFamily*"/>
69947088 </instance-parameter>
69957089 </parameters>
@@ -7000,23 +7094,23 @@ be affected by double-width characters.</doc>
70007094 version="1.44">
70017095 <doc xml:space="preserve"
70027096 filename="pango/fonts.c"
7003- line="2945">A variable font is a font which has axes that can be modified to
7097+ line="3019">A variable font is a font which has axes that can be modified to
70047098 produce different faces.
70057099
70067100 Such axes are also known as _variations_; see
70077101 [method@Pango.FontDescription.set_variations] for more information.</doc>
7008- <source-position filename="pango/pango-font.h" line="491"/>
7102+ <source-position filename="pango/pango-font.h" line="521"/>
70097103 <return-value transfer-ownership="none">
70107104 <doc xml:space="preserve"
70117105 filename="pango/fonts.c"
7012- line="2955">%TRUE if the family is variable</doc>
7106+ line="3029">%TRUE if the family is variable</doc>
70137107 <type name="gboolean" c:type="gboolean"/>
70147108 </return-value>
70157109 <parameters>
70167110 <instance-parameter name="family" transfer-ownership="none">
70177111 <doc xml:space="preserve"
70187112 filename="pango/fonts.c"
7019- line="2947">a `PangoFontFamily`</doc>
7113+ line="3021">a `PangoFontFamily`</doc>
70207114 <type name="FontFamily" c:type="PangoFontFamily*"/>
70217115 </instance-parameter>
70227116 </parameters>
@@ -7024,7 +7118,7 @@ Such axes are also known as _variations_; see
70247118 <method name="list_faces" c:identifier="pango_font_family_list_faces">
70257119 <doc xml:space="preserve"
70267120 filename="pango/fonts.c"
7027- line="2828">Lists the different font faces that make up @family.
7121+ line="2902">Lists the different font faces that make up @family.
70287122
70297123 The faces in a family share a common design, but differ in slant, weight,
70307124 width and other aspects.
@@ -7034,7 +7128,7 @@ multiple faces may have the same name or characteristics.
70347128
70357129 `PangoFontFamily` also implemented the [iface@Gio.ListModel] interface
70367130 for enumerating faces.</doc>
7037- <source-position filename="pango/pango-font.h" line="483"/>
7131+ <source-position filename="pango/pango-font.h" line="513"/>
70387132 <return-value transfer-ownership="none">
70397133 <type name="none" c:type="void"/>
70407134 </return-value>
@@ -7042,7 +7136,7 @@ for enumerating faces.</doc>
70427136 <instance-parameter name="family" transfer-ownership="none">
70437137 <doc xml:space="preserve"
70447138 filename="pango/fonts.c"
7045- line="2830">a `PangoFontFamily`</doc>
7139+ line="2904">a `PangoFontFamily`</doc>
70467140 <type name="FontFamily" c:type="PangoFontFamily*"/>
70477141 </instance-parameter>
70487142 <parameter name="faces"
@@ -7053,7 +7147,7 @@ for enumerating faces.</doc>
70537147 allow-none="1">
70547148 <doc xml:space="preserve"
70557149 filename="pango/fonts.c"
7056- line="2831">
7150+ line="2905">
70577151 location to store an array of pointers to `PangoFontFace` objects,
70587152 or %NULL. This array should be freed with g_free() when it is no
70597153 longer needed.</doc>
@@ -7067,7 +7161,7 @@ for enumerating faces.</doc>
70677161 transfer-ownership="full">
70687162 <doc xml:space="preserve"
70697163 filename="pango/fonts.c"
7070- line="2835">location to store number of elements in @faces.</doc>
7164+ line="2909">location to store number of elements in @faces.</doc>
70717165 <type name="gint" c:type="int*"/>
70727166 </parameter>
70737167 </parameters>
@@ -7081,7 +7175,7 @@ for enumerating faces.</doc>
70817175 value="pango_font_family_is_monospace"/>
70827176 <doc xml:space="preserve"
70837177 filename="pango/fonts.c"
7084- line="2757">Is this a monospace font</doc>
7178+ line="2827">Is this a monospace font</doc>
70857179 <type name="gboolean" c:type="gboolean"/>
70867180 </property>
70877181 <property name="is-variable"
@@ -7093,19 +7187,22 @@ for enumerating faces.</doc>
70937187 value="pango_font_family_is_variable"/>
70947188 <doc xml:space="preserve"
70957189 filename="pango/fonts.c"
7096- line="2768">Is this a variable font</doc>
7190+ line="2838">Is this a variable font</doc>
70977191 <type name="gboolean" c:type="gboolean"/>
70987192 </property>
7099- <property name="item-type" transfer-ownership="none">
7193+ <property name="item-type" version="1.52" transfer-ownership="none">
71007194 <doc xml:space="preserve"
71017195 filename="pango/fonts.c"
7102- line="2779">The type of items contained in this list.</doc>
7196+ line="2849">The type of items contained in this list.</doc>
71037197 <type name="GType" c:type="GType"/>
71047198 </property>
7105- <property name="n-items" transfer-ownership="none" default-value="0">
7199+ <property name="n-items"
7200+ version="1.52"
7201+ transfer-ownership="none"
7202+ default-value="0">
71067203 <doc xml:space="preserve"
71077204 filename="pango/fonts.c"
7108- line="2788">The number of items contained in this list.</doc>
7205+ line="2860">The number of items contained in this list.</doc>
71097206 <type name="guint" c:type="guint"/>
71107207 </property>
71117208 <property name="name"
@@ -7117,7 +7214,7 @@ for enumerating faces.</doc>
71177214 value="pango_font_family_get_name"/>
71187215 <doc xml:space="preserve"
71197216 filename="pango/fonts.c"
7120- line="2746">The name of the family</doc>
7217+ line="2816">The name of the family</doc>
71217218 <type name="utf8" c:type="gchar*"/>
71227219 </property>
71237220 <field name="parent_instance">
@@ -7127,13 +7224,13 @@ for enumerating faces.</doc>
71277224 <record name="FontFamilyClass"
71287225 c:type="PangoFontFamilyClass"
71297226 glib:is-gtype-struct-for="FontFamily">
7130- <source-position filename="pango/pango-font.h" line="475"/>
7227+ <source-position filename="pango/pango-font.h" line="505"/>
71317228 <field name="parent_class">
71327229 <type name="GObject.ObjectClass" c:type="GObjectClass"/>
71337230 </field>
71347231 <field name="list_faces">
71357232 <callback name="list_faces">
7136- <source-position filename="pango/pango-font.h" line="460"/>
7233+ <source-position filename="pango/pango-font.h" line="490"/>
71377234 <return-value transfer-ownership="none">
71387235 <type name="none" c:type="void"/>
71397236 </return-value>
@@ -7141,7 +7238,7 @@ for enumerating faces.</doc>
71417238 <parameter name="family" transfer-ownership="none">
71427239 <doc xml:space="preserve"
71437240 filename="pango/fonts.c"
7144- line="2830">a `PangoFontFamily`</doc>
7241+ line="2904">a `PangoFontFamily`</doc>
71457242 <type name="FontFamily" c:type="PangoFontFamily*"/>
71467243 </parameter>
71477244 <parameter name="faces"
@@ -7152,7 +7249,7 @@ for enumerating faces.</doc>
71527249 allow-none="1">
71537250 <doc xml:space="preserve"
71547251 filename="pango/fonts.c"
7155- line="2831">
7252+ line="2905">
71567253 location to store an array of pointers to `PangoFontFace` objects,
71577254 or %NULL. This array should be freed with g_free() when it is no
71587255 longer needed.</doc>
@@ -7166,7 +7263,7 @@ for enumerating faces.</doc>
71667263 transfer-ownership="full">
71677264 <doc xml:space="preserve"
71687265 filename="pango/fonts.c"
7169- line="2835">location to store number of elements in @faces.</doc>
7266+ line="2909">location to store number of elements in @faces.</doc>
71707267 <type name="gint" c:type="int*"/>
71717268 </parameter>
71727269 </parameters>
@@ -7174,11 +7271,11 @@ for enumerating faces.</doc>
71747271 </field>
71757272 <field name="get_name">
71767273 <callback name="get_name">
7177- <source-position filename="pango/pango-font.h" line="463"/>
7274+ <source-position filename="pango/pango-font.h" line="493"/>
71787275 <return-value transfer-ownership="none">
71797276 <doc xml:space="preserve"
71807277 filename="pango/fonts.c"
7181- line="2817">the name of the family. This string is owned
7278+ line="2891">the name of the family. This string is owned
71827279 by the family object and must not be modified or freed.</doc>
71837280 <type name="utf8" c:type="const char*"/>
71847281 </return-value>
@@ -7186,7 +7283,7 @@ for enumerating faces.</doc>
71867283 <parameter name="family" transfer-ownership="none">
71877284 <doc xml:space="preserve"
71887285 filename="pango/fonts.c"
7189- line="2809">a `PangoFontFamily`</doc>
7286+ line="2883">a `PangoFontFamily`</doc>
71907287 <type name="FontFamily" c:type="PangoFontFamily*"/>
71917288 </parameter>
71927289 </parameters>
@@ -7194,18 +7291,18 @@ for enumerating faces.</doc>
71947291 </field>
71957292 <field name="is_monospace">
71967293 <callback name="is_monospace">
7197- <source-position filename="pango/pango-font.h" line="464"/>
7294+ <source-position filename="pango/pango-font.h" line="494"/>
71987295 <return-value transfer-ownership="none">
71997296 <doc xml:space="preserve"
72007297 filename="pango/fonts.c"
7201- line="2933">%TRUE if the family is monospace.</doc>
7298+ line="3007">%TRUE if the family is monospace.</doc>
72027299 <type name="gboolean" c:type="gboolean"/>
72037300 </return-value>
72047301 <parameters>
72057302 <parameter name="family" transfer-ownership="none">
72067303 <doc xml:space="preserve"
72077304 filename="pango/fonts.c"
7208- line="2916">a `PangoFontFamily`</doc>
7305+ line="2990">a `PangoFontFamily`</doc>
72097306 <type name="FontFamily" c:type="PangoFontFamily*"/>
72107307 </parameter>
72117308 </parameters>
@@ -7213,18 +7310,18 @@ for enumerating faces.</doc>
72137310 </field>
72147311 <field name="is_variable">
72157312 <callback name="is_variable">
7216- <source-position filename="pango/pango-font.h" line="465"/>
7313+ <source-position filename="pango/pango-font.h" line="495"/>
72177314 <return-value transfer-ownership="none">
72187315 <doc xml:space="preserve"
72197316 filename="pango/fonts.c"
7220- line="2955">%TRUE if the family is variable</doc>
7317+ line="3029">%TRUE if the family is variable</doc>
72217318 <type name="gboolean" c:type="gboolean"/>
72227319 </return-value>
72237320 <parameters>
72247321 <parameter name="family" transfer-ownership="none">
72257322 <doc xml:space="preserve"
72267323 filename="pango/fonts.c"
7227- line="2947">a `PangoFontFamily`</doc>
7324+ line="3021">a `PangoFontFamily`</doc>
72287325 <type name="FontFamily" c:type="PangoFontFamily*"/>
72297326 </parameter>
72307327 </parameters>
@@ -7232,11 +7329,11 @@ for enumerating faces.</doc>
72327329 </field>
72337330 <field name="get_face">
72347331 <callback name="get_face">
7235- <source-position filename="pango/pango-font.h" line="467"/>
7332+ <source-position filename="pango/pango-font.h" line="497"/>
72367333 <return-value transfer-ownership="none" nullable="1">
72377334 <doc xml:space="preserve"
72387335 filename="pango/fonts.c"
7239- line="2900">the `PangoFontFace`,
7336+ line="2974">the `PangoFontFace`,
72407337 or %NULL if no face with the given name exists.</doc>
72417338 <type name="FontFace" c:type="PangoFontFace*"/>
72427339 </return-value>
@@ -7244,7 +7341,7 @@ for enumerating faces.</doc>
72447341 <parameter name="family" transfer-ownership="none">
72457342 <doc xml:space="preserve"
72467343 filename="pango/fonts.c"
7247- line="2893">a `PangoFontFamily`</doc>
7344+ line="2967">a `PangoFontFamily`</doc>
72487345 <type name="FontFamily" c:type="PangoFontFamily*"/>
72497346 </parameter>
72507347 <parameter name="name"
@@ -7253,7 +7350,7 @@ for enumerating faces.</doc>
72537350 allow-none="1">
72547351 <doc xml:space="preserve"
72557352 filename="pango/fonts.c"
7256- line="2894">the name of a face. If the name is %NULL,
7353+ line="2968">the name of a face. If the name is %NULL,
72577354 the family's default face (fontconfig calls it "Regular")
72587355 will be returned.</doc>
72597356 <type name="utf8" c:type="const char*"/>
@@ -7263,7 +7360,7 @@ for enumerating faces.</doc>
72637360 </field>
72647361 <field name="_pango_reserved2" introspectable="0">
72657362 <callback name="_pango_reserved2">
7266- <source-position filename="pango/pango-font.h" line="474"/>
7363+ <source-position filename="pango/pango-font.h" line="504"/>
72677364 <return-value transfer-ownership="none">
72687365 <type name="none" c:type="void"/>
72697366 </return-value>
@@ -7290,13 +7387,13 @@ particular rendering systems.</doc>
72907387 <virtual-method name="changed" invoker="changed" version="1.34">
72917388 <doc xml:space="preserve"
72927389 filename="pango/pango-fontmap.c"
7293- line="437">Forces a change in the context, which will cause any `PangoContext`
7390+ line="441">Forces a change in the fontmap, which will cause any `PangoContext`
72947391 using this fontmap to change.
72957392
72967393 This function is only useful when implementing a new backend
72977394 for Pango, something applications won't do. Backends should
72987395 call this function if they have attached extra data to the
7299-context and such data is changed.</doc>
7396+fontmap and such data is changed.</doc>
73007397 <source-position filename="pango/pango-fontmap.h" line="92"/>
73017398 <return-value transfer-ownership="none">
73027399 <type name="none" c:type="void"/>
@@ -7305,7 +7402,7 @@ context and such data is changed.</doc>
73057402 <instance-parameter name="fontmap" transfer-ownership="none">
73067403 <doc xml:space="preserve"
73077404 filename="pango/pango-fontmap.c"
7308- line="439">a `PangoFontMap`</doc>
7405+ line="443">a `PangoFontMap`</doc>
73097406 <type name="FontMap" c:type="PangoFontMap*"/>
73107407 </instance-parameter>
73117408 </parameters>
@@ -7327,25 +7424,25 @@ context and such data is changed.</doc>
73277424 <virtual-method name="get_family" invoker="get_family" version="1.46">
73287425 <doc xml:space="preserve"
73297426 filename="pango/pango-fontmap.c"
7330- line="487">Gets a font family by name.</doc>
7427+ line="491">Gets a font family by name.</doc>
73317428 <source-position filename="pango/pango-fontmap.h" line="94"/>
73327429 <return-value transfer-ownership="none">
73337430 <doc xml:space="preserve"
73347431 filename="pango/pango-fontmap.c"
7335- line="494">the `PangoFontFamily`</doc>
7432+ line="498">the `PangoFontFamily`</doc>
73367433 <type name="FontFamily" c:type="PangoFontFamily*"/>
73377434 </return-value>
73387435 <parameters>
73397436 <instance-parameter name="fontmap" transfer-ownership="none">
73407437 <doc xml:space="preserve"
73417438 filename="pango/pango-fontmap.c"
7342- line="489">a `PangoFontMap`</doc>
7439+ line="493">a `PangoFontMap`</doc>
73437440 <type name="FontMap" c:type="PangoFontMap*"/>
73447441 </instance-parameter>
73457442 <parameter name="name" transfer-ownership="none">
73467443 <doc xml:space="preserve"
73477444 filename="pango/pango-fontmap.c"
7348- line="490">a family name</doc>
7445+ line="494">a family name</doc>
73497446 <type name="utf8" c:type="const char*"/>
73507447 </parameter>
73517448 </parameters>
@@ -7353,7 +7450,7 @@ context and such data is changed.</doc>
73537450 <virtual-method name="get_serial" invoker="get_serial" version="1.32.4">
73547451 <doc xml:space="preserve"
73557452 filename="pango/pango-fontmap.c"
7356- line="391">Returns the current serial number of @fontmap.
7453+ line="395">Returns the current serial number of @fontmap.
73577454
73587455 The serial number is initialized to an small number larger than zero
73597456 when a new fontmap is created and is increased whenever the fontmap
@@ -7369,14 +7466,14 @@ like in `PangoContext`.</doc>
73697466 <return-value transfer-ownership="none">
73707467 <doc xml:space="preserve"
73717468 filename="pango/pango-fontmap.c"
7372- line="408">The current serial number of @fontmap.</doc>
7469+ line="412">The current serial number of @fontmap.</doc>
73737470 <type name="guint" c:type="guint"/>
73747471 </return-value>
73757472 <parameters>
73767473 <instance-parameter name="fontmap" transfer-ownership="none">
73777474 <doc xml:space="preserve"
73787475 filename="pango/pango-fontmap.c"
7379- line="393">a `PangoFontMap`</doc>
7476+ line="397">a `PangoFontMap`</doc>
73807477 <type name="FontMap" c:type="PangoFontMap*"/>
73817478 </instance-parameter>
73827479 </parameters>
@@ -7384,7 +7481,7 @@ like in `PangoContext`.</doc>
73847481 <virtual-method name="list_families" invoker="list_families">
73857482 <doc xml:space="preserve"
73867483 filename="pango/pango-fontmap.c"
7387- line="193">List all families for a fontmap.
7484+ line="197">List all families for a fontmap.
73887485
73897486 Note that the returned families are not in any particular order.
73907487
@@ -7398,7 +7495,7 @@ for enumerating families.</doc>
73987495 <instance-parameter name="fontmap" transfer-ownership="none">
73997496 <doc xml:space="preserve"
74007497 filename="pango/pango-fontmap.c"
7401- line="195">a `PangoFontMap`</doc>
7498+ line="199">a `PangoFontMap`</doc>
74027499 <type name="FontMap" c:type="PangoFontMap*"/>
74037500 </instance-parameter>
74047501 <parameter name="families"
@@ -7407,7 +7504,7 @@ for enumerating families.</doc>
74077504 transfer-ownership="container">
74087505 <doc xml:space="preserve"
74097506 filename="pango/pango-fontmap.c"
7410- line="196">location to
7507+ line="200">location to
74117508 store a pointer to an array of `PangoFontFamily` *.
74127509 This array should be freed with g_free().</doc>
74137510 <array length="1" zero-terminated="0" c:type="PangoFontFamily***">
@@ -7420,7 +7517,7 @@ for enumerating families.</doc>
74207517 transfer-ownership="full">
74217518 <doc xml:space="preserve"
74227519 filename="pango/pango-fontmap.c"
7423- line="199">location to store the number of elements in @families</doc>
7520+ line="203">location to store the number of elements in @families</doc>
74247521 <type name="gint" c:type="int*"/>
74257522 </parameter>
74267523 </parameters>
@@ -7428,12 +7525,12 @@ for enumerating families.</doc>
74287525 <virtual-method name="load_font" invoker="load_font">
74297526 <doc xml:space="preserve"
74307527 filename="pango/pango-fontmap.c"
7431- line="172">Load the font in the fontmap that is the closest match for @desc.</doc>
7528+ line="176">Load the font in the fontmap that is the closest match for @desc.</doc>
74327529 <source-position filename="pango/pango-fontmap.h" line="78"/>
74337530 <return-value transfer-ownership="full" nullable="1">
74347531 <doc xml:space="preserve"
74357532 filename="pango/pango-fontmap.c"
7436- line="180">the newly allocated `PangoFont`
7533+ line="184">the newly allocated `PangoFont`
74377534 loaded, or %NULL if no font matched.</doc>
74387535 <type name="Font" c:type="PangoFont*"/>
74397536 </return-value>
@@ -7441,19 +7538,19 @@ for enumerating families.</doc>
74417538 <instance-parameter name="fontmap" transfer-ownership="none">
74427539 <doc xml:space="preserve"
74437540 filename="pango/pango-fontmap.c"
7444- line="174">a `PangoFontMap`</doc>
7541+ line="178">a `PangoFontMap`</doc>
74457542 <type name="FontMap" c:type="PangoFontMap*"/>
74467543 </instance-parameter>
74477544 <parameter name="context" transfer-ownership="none">
74487545 <doc xml:space="preserve"
74497546 filename="pango/pango-fontmap.c"
7450- line="175">the `PangoContext` the font will be used with</doc>
7547+ line="179">the `PangoContext` the font will be used with</doc>
74517548 <type name="Context" c:type="PangoContext*"/>
74527549 </parameter>
74537550 <parameter name="desc" transfer-ownership="none">
74547551 <doc xml:space="preserve"
74557552 filename="pango/pango-fontmap.c"
7456- line="176">a `PangoFontDescription` describing the font to load</doc>
7553+ line="180">a `PangoFontDescription` describing the font to load</doc>
74577554 <type name="FontDescription" c:type="const PangoFontDescription*"/>
74587555 </parameter>
74597556 </parameters>
@@ -7461,13 +7558,13 @@ for enumerating families.</doc>
74617558 <virtual-method name="load_fontset" invoker="load_fontset">
74627559 <doc xml:space="preserve"
74637560 filename="pango/pango-fontmap.c"
7464- line="222">Load a set of fonts in the fontmap that can be used to render
7561+ line="226">Load a set of fonts in the fontmap that can be used to render
74657562 a font matching @desc.</doc>
74667563 <source-position filename="pango/pango-fontmap.h" line="84"/>
74677564 <return-value transfer-ownership="full" nullable="1">
74687565 <doc xml:space="preserve"
74697566 filename="pango/pango-fontmap.c"
7470- line="232">the newly allocated
7567+ line="236">the newly allocated
74717568 `PangoFontset` loaded, or %NULL if no font matched.</doc>
74727569 <type name="Fontset" c:type="PangoFontset*"/>
74737570 </return-value>
@@ -7475,25 +7572,25 @@ a font matching @desc.</doc>
74757572 <instance-parameter name="fontmap" transfer-ownership="none">
74767573 <doc xml:space="preserve"
74777574 filename="pango/pango-fontmap.c"
7478- line="224">a `PangoFontMap`</doc>
7575+ line="228">a `PangoFontMap`</doc>
74797576 <type name="FontMap" c:type="PangoFontMap*"/>
74807577 </instance-parameter>
74817578 <parameter name="context" transfer-ownership="none">
74827579 <doc xml:space="preserve"
74837580 filename="pango/pango-fontmap.c"
7484- line="225">the `PangoContext` the font will be used with</doc>
7581+ line="229">the `PangoContext` the font will be used with</doc>
74857582 <type name="Context" c:type="PangoContext*"/>
74867583 </parameter>
74877584 <parameter name="desc" transfer-ownership="none">
74887585 <doc xml:space="preserve"
74897586 filename="pango/pango-fontmap.c"
7490- line="226">a `PangoFontDescription` describing the font to load</doc>
7587+ line="230">a `PangoFontDescription` describing the font to load</doc>
74917588 <type name="FontDescription" c:type="const PangoFontDescription*"/>
74927589 </parameter>
74937590 <parameter name="language" transfer-ownership="none">
74947591 <doc xml:space="preserve"
74957592 filename="pango/pango-fontmap.c"
7496- line="227">a `PangoLanguage` the fonts will be used for</doc>
7593+ line="231">a `PangoLanguage` the fonts will be used for</doc>
74977594 <type name="Language" c:type="PangoLanguage*"/>
74987595 </parameter>
74997596 </parameters>
@@ -7504,7 +7601,7 @@ a font matching @desc.</doc>
75047601 throws="1">
75057602 <doc xml:space="preserve"
75067603 filename="pango/pango-fontmap.c"
7507- line="595">Loads a font file with one or more fonts into the `PangoFontMap`.
7604+ line="599">Loads a font file with one or more fonts into the `PangoFontMap`.
75087605
75097606 The added fonts will take precedence over preexisting
75107607 fonts with the same name.</doc>
@@ -7512,7 +7609,7 @@ fonts with the same name.</doc>
75127609 <return-value transfer-ownership="none">
75137610 <doc xml:space="preserve"
75147611 filename="pango/pango-fontmap.c"
7515- line="606">True if the font file is successfully loaded
7612+ line="610">True if the font file is successfully loaded
75167613 into the fontmap, false if an error occurred.</doc>
75177614 <type name="gboolean" c:type="gboolean"/>
75187615 </return-value>
@@ -7520,13 +7617,13 @@ fonts with the same name.</doc>
75207617 <instance-parameter name="fontmap" transfer-ownership="none">
75217618 <doc xml:space="preserve"
75227619 filename="pango/pango-fontmap.c"
7523- line="597">a `PangoFontMap`</doc>
7620+ line="601">a `PangoFontMap`</doc>
75247621 <type name="FontMap" c:type="PangoFontMap*"/>
75257622 </instance-parameter>
75267623 <parameter name="filename" transfer-ownership="none">
75277624 <doc xml:space="preserve"
75287625 filename="pango/pango-fontmap.c"
7529- line="598">Path to the font file</doc>
7626+ line="602">Path to the font file</doc>
75307627 <type name="filename" c:type="const char*"/>
75317628 </parameter>
75327629 </parameters>
@@ -7536,13 +7633,13 @@ fonts with the same name.</doc>
75367633 version="1.34">
75377634 <doc xml:space="preserve"
75387635 filename="pango/pango-fontmap.c"
7539- line="437">Forces a change in the context, which will cause any `PangoContext`
7636+ line="441">Forces a change in the fontmap, which will cause any `PangoContext`
75407637 using this fontmap to change.
75417638
75427639 This function is only useful when implementing a new backend
75437640 for Pango, something applications won't do. Backends should
75447641 call this function if they have attached extra data to the
7545-context and such data is changed.</doc>
7642+fontmap and such data is changed.</doc>
75467643 <source-position filename="pango/pango-fontmap.h" line="121"/>
75477644 <return-value transfer-ownership="none">
75487645 <type name="none" c:type="void"/>
@@ -7551,7 +7648,7 @@ context and such data is changed.</doc>
75517648 <instance-parameter name="fontmap" transfer-ownership="none">
75527649 <doc xml:space="preserve"
75537650 filename="pango/pango-fontmap.c"
7554- line="439">a `PangoFontMap`</doc>
7651+ line="443">a `PangoFontMap`</doc>
75557652 <type name="FontMap" c:type="PangoFontMap*"/>
75567653 </instance-parameter>
75577654 </parameters>
@@ -7561,7 +7658,7 @@ context and such data is changed.</doc>
75617658 version="1.22">
75627659 <doc xml:space="preserve"
75637660 filename="pango/pango-fontmap.c"
7564- line="140">Creates a `PangoContext` connected to @fontmap.
7661+ line="144">Creates a `PangoContext` connected to @fontmap.
75657662
75667663 This is equivalent to [ctor@Pango.Context.new] followed by
75677664 [method@Pango.Context.set_font_map].
@@ -7574,7 +7671,7 @@ gtk_widget_get_pango_context(). Use those instead.</doc>
75747671 <return-value transfer-ownership="full">
75757672 <doc xml:space="preserve"
75767673 filename="pango/pango-fontmap.c"
7577- line="154">the newly allocated `PangoContext`,
7674+ line="158">the newly allocated `PangoContext`,
75787675 which should be freed with g_object_unref().</doc>
75797676 <type name="Context" c:type="PangoContext*"/>
75807677 </return-value>
@@ -7582,7 +7679,7 @@ gtk_widget_get_pango_context(). Use those instead.</doc>
75827679 <instance-parameter name="fontmap" transfer-ownership="none">
75837680 <doc xml:space="preserve"
75847681 filename="pango/pango-fontmap.c"
7585- line="142">a `PangoFontMap`</doc>
7682+ line="146">a `PangoFontMap`</doc>
75867683 <type name="FontMap" c:type="PangoFontMap*"/>
75877684 </instance-parameter>
75887685 </parameters>
@@ -7592,25 +7689,25 @@ gtk_widget_get_pango_context(). Use those instead.</doc>
75927689 version="1.46">
75937690 <doc xml:space="preserve"
75947691 filename="pango/pango-fontmap.c"
7595- line="487">Gets a font family by name.</doc>
7692+ line="491">Gets a font family by name.</doc>
75967693 <source-position filename="pango/pango-fontmap.h" line="124"/>
75977694 <return-value transfer-ownership="none">
75987695 <doc xml:space="preserve"
75997696 filename="pango/pango-fontmap.c"
7600- line="494">the `PangoFontFamily`</doc>
7697+ line="498">the `PangoFontFamily`</doc>
76017698 <type name="FontFamily" c:type="PangoFontFamily*"/>
76027699 </return-value>
76037700 <parameters>
76047701 <instance-parameter name="fontmap" transfer-ownership="none">
76057702 <doc xml:space="preserve"
76067703 filename="pango/pango-fontmap.c"
7607- line="489">a `PangoFontMap`</doc>
7704+ line="493">a `PangoFontMap`</doc>
76087705 <type name="FontMap" c:type="PangoFontMap*"/>
76097706 </instance-parameter>
76107707 <parameter name="name" transfer-ownership="none">
76117708 <doc xml:space="preserve"
76127709 filename="pango/pango-fontmap.c"
7613- line="490">a family name</doc>
7710+ line="494">a family name</doc>
76147711 <type name="utf8" c:type="const char*"/>
76157712 </parameter>
76167713 </parameters>
@@ -7620,7 +7717,7 @@ gtk_widget_get_pango_context(). Use those instead.</doc>
76207717 version="1.32.4">
76217718 <doc xml:space="preserve"
76227719 filename="pango/pango-fontmap.c"
7623- line="391">Returns the current serial number of @fontmap.
7720+ line="395">Returns the current serial number of @fontmap.
76247721
76257722 The serial number is initialized to an small number larger than zero
76267723 when a new fontmap is created and is increased whenever the fontmap
@@ -7636,14 +7733,14 @@ like in `PangoContext`.</doc>
76367733 <return-value transfer-ownership="none">
76377734 <doc xml:space="preserve"
76387735 filename="pango/pango-fontmap.c"
7639- line="408">The current serial number of @fontmap.</doc>
7736+ line="412">The current serial number of @fontmap.</doc>
76407737 <type name="guint" c:type="guint"/>
76417738 </return-value>
76427739 <parameters>
76437740 <instance-parameter name="fontmap" transfer-ownership="none">
76447741 <doc xml:space="preserve"
76457742 filename="pango/pango-fontmap.c"
7646- line="393">a `PangoFontMap`</doc>
7743+ line="397">a `PangoFontMap`</doc>
76477744 <type name="FontMap" c:type="PangoFontMap*"/>
76487745 </instance-parameter>
76497746 </parameters>
@@ -7651,7 +7748,7 @@ like in `PangoContext`.</doc>
76517748 <method name="list_families" c:identifier="pango_font_map_list_families">
76527749 <doc xml:space="preserve"
76537750 filename="pango/pango-fontmap.c"
7654- line="193">List all families for a fontmap.
7751+ line="197">List all families for a fontmap.
76557752
76567753 Note that the returned families are not in any particular order.
76577754
@@ -7665,7 +7762,7 @@ for enumerating families.</doc>
76657762 <instance-parameter name="fontmap" transfer-ownership="none">
76667763 <doc xml:space="preserve"
76677764 filename="pango/pango-fontmap.c"
7668- line="195">a `PangoFontMap`</doc>
7765+ line="199">a `PangoFontMap`</doc>
76697766 <type name="FontMap" c:type="PangoFontMap*"/>
76707767 </instance-parameter>
76717768 <parameter name="families"
@@ -7674,7 +7771,7 @@ for enumerating families.</doc>
76747771 transfer-ownership="container">
76757772 <doc xml:space="preserve"
76767773 filename="pango/pango-fontmap.c"
7677- line="196">location to
7774+ line="200">location to
76787775 store a pointer to an array of `PangoFontFamily` *.
76797776 This array should be freed with g_free().</doc>
76807777 <array length="1" zero-terminated="0" c:type="PangoFontFamily***">
@@ -7687,7 +7784,7 @@ for enumerating families.</doc>
76877784 transfer-ownership="full">
76887785 <doc xml:space="preserve"
76897786 filename="pango/pango-fontmap.c"
7690- line="199">location to store the number of elements in @families</doc>
7787+ line="203">location to store the number of elements in @families</doc>
76917788 <type name="gint" c:type="int*"/>
76927789 </parameter>
76937790 </parameters>
@@ -7695,12 +7792,12 @@ for enumerating families.</doc>
76957792 <method name="load_font" c:identifier="pango_font_map_load_font">
76967793 <doc xml:space="preserve"
76977794 filename="pango/pango-fontmap.c"
7698- line="172">Load the font in the fontmap that is the closest match for @desc.</doc>
7795+ line="176">Load the font in the fontmap that is the closest match for @desc.</doc>
76997796 <source-position filename="pango/pango-fontmap.h" line="106"/>
77007797 <return-value transfer-ownership="full" nullable="1">
77017798 <doc xml:space="preserve"
77027799 filename="pango/pango-fontmap.c"
7703- line="180">the newly allocated `PangoFont`
7800+ line="184">the newly allocated `PangoFont`
77047801 loaded, or %NULL if no font matched.</doc>
77057802 <type name="Font" c:type="PangoFont*"/>
77067803 </return-value>
@@ -7708,19 +7805,19 @@ for enumerating families.</doc>
77087805 <instance-parameter name="fontmap" transfer-ownership="none">
77097806 <doc xml:space="preserve"
77107807 filename="pango/pango-fontmap.c"
7711- line="174">a `PangoFontMap`</doc>
7808+ line="178">a `PangoFontMap`</doc>
77127809 <type name="FontMap" c:type="PangoFontMap*"/>
77137810 </instance-parameter>
77147811 <parameter name="context" transfer-ownership="none">
77157812 <doc xml:space="preserve"
77167813 filename="pango/pango-fontmap.c"
7717- line="175">the `PangoContext` the font will be used with</doc>
7814+ line="179">the `PangoContext` the font will be used with</doc>
77187815 <type name="Context" c:type="PangoContext*"/>
77197816 </parameter>
77207817 <parameter name="desc" transfer-ownership="none">
77217818 <doc xml:space="preserve"
77227819 filename="pango/pango-fontmap.c"
7723- line="176">a `PangoFontDescription` describing the font to load</doc>
7820+ line="180">a `PangoFontDescription` describing the font to load</doc>
77247821 <type name="FontDescription" c:type="const PangoFontDescription*"/>
77257822 </parameter>
77267823 </parameters>
@@ -7728,13 +7825,13 @@ for enumerating families.</doc>
77287825 <method name="load_fontset" c:identifier="pango_font_map_load_fontset">
77297826 <doc xml:space="preserve"
77307827 filename="pango/pango-fontmap.c"
7731- line="222">Load a set of fonts in the fontmap that can be used to render
7828+ line="226">Load a set of fonts in the fontmap that can be used to render
77327829 a font matching @desc.</doc>
77337830 <source-position filename="pango/pango-fontmap.h" line="110"/>
77347831 <return-value transfer-ownership="full" nullable="1">
77357832 <doc xml:space="preserve"
77367833 filename="pango/pango-fontmap.c"
7737- line="232">the newly allocated
7834+ line="236">the newly allocated
77387835 `PangoFontset` loaded, or %NULL if no font matched.</doc>
77397836 <type name="Fontset" c:type="PangoFontset*"/>
77407837 </return-value>
@@ -7742,25 +7839,25 @@ a font matching @desc.</doc>
77427839 <instance-parameter name="fontmap" transfer-ownership="none">
77437840 <doc xml:space="preserve"
77447841 filename="pango/pango-fontmap.c"
7745- line="224">a `PangoFontMap`</doc>
7842+ line="228">a `PangoFontMap`</doc>
77467843 <type name="FontMap" c:type="PangoFontMap*"/>
77477844 </instance-parameter>
77487845 <parameter name="context" transfer-ownership="none">
77497846 <doc xml:space="preserve"
77507847 filename="pango/pango-fontmap.c"
7751- line="225">the `PangoContext` the font will be used with</doc>
7848+ line="229">the `PangoContext` the font will be used with</doc>
77527849 <type name="Context" c:type="PangoContext*"/>
77537850 </parameter>
77547851 <parameter name="desc" transfer-ownership="none">
77557852 <doc xml:space="preserve"
77567853 filename="pango/pango-fontmap.c"
7757- line="226">a `PangoFontDescription` describing the font to load</doc>
7854+ line="230">a `PangoFontDescription` describing the font to load</doc>
77587855 <type name="FontDescription" c:type="const PangoFontDescription*"/>
77597856 </parameter>
77607857 <parameter name="language" transfer-ownership="none">
77617858 <doc xml:space="preserve"
77627859 filename="pango/pango-fontmap.c"
7763- line="227">a `PangoLanguage` the fonts will be used for</doc>
7860+ line="231">a `PangoLanguage` the fonts will be used for</doc>
77647861 <type name="Language" c:type="PangoLanguage*"/>
77657862 </parameter>
77667863 </parameters>
@@ -7770,7 +7867,7 @@ a font matching @desc.</doc>
77707867 version="1.52">
77717868 <doc xml:space="preserve"
77727869 filename="pango/pango-fontmap.c"
7773- line="542">Returns a new font that is like @font, except that it is scaled
7870+ line="546">Returns a new font that is like @font, except that it is scaled
77747871 by @scale, its backend-dependent configuration (e.g. cairo font options)
77757872 is replaced by the one in @context, and its variations are replaced
77767873 by @variations.
@@ -7782,26 +7879,26 @@ without changing its optical size.</doc>
77827879 <return-value transfer-ownership="full">
77837880 <doc xml:space="preserve"
77847881 filename="pango/pango-fontmap.c"
7785- line="559">the modified font</doc>
7882+ line="563">the modified font</doc>
77867883 <type name="Font" c:type="PangoFont*"/>
77877884 </return-value>
77887885 <parameters>
77897886 <instance-parameter name="fontmap" transfer-ownership="none">
77907887 <doc xml:space="preserve"
77917888 filename="pango/pango-fontmap.c"
7792- line="544">a `PangoFontMap`</doc>
7889+ line="548">a `PangoFontMap`</doc>
77937890 <type name="FontMap" c:type="PangoFontMap*"/>
77947891 </instance-parameter>
77957892 <parameter name="font" transfer-ownership="none">
77967893 <doc xml:space="preserve"
77977894 filename="pango/pango-fontmap.c"
7798- line="545">a font in @fontmap</doc>
7895+ line="549">a font in @fontmap</doc>
77997896 <type name="Font" c:type="PangoFont*"/>
78007897 </parameter>
78017898 <parameter name="scale" transfer-ownership="none">
78027899 <doc xml:space="preserve"
78037900 filename="pango/pango-fontmap.c"
7804- line="546">the scale factor to apply</doc>
7901+ line="550">the scale factor to apply</doc>
78057902 <type name="gdouble" c:type="double"/>
78067903 </parameter>
78077904 <parameter name="context"
@@ -7810,7 +7907,7 @@ without changing its optical size.</doc>
78107907 allow-none="1">
78117908 <doc xml:space="preserve"
78127909 filename="pango/pango-fontmap.c"
7813- line="547">a `PangoContext`</doc>
7910+ line="551">a `PangoContext`</doc>
78147911 <type name="Context" c:type="PangoContext*"/>
78157912 </parameter>
78167913 <parameter name="variations"
@@ -7819,21 +7916,24 @@ without changing its optical size.</doc>
78197916 allow-none="1">
78207917 <doc xml:space="preserve"
78217918 filename="pango/pango-fontmap.c"
7822- line="548">font variations to use</doc>
7919+ line="552">font variations to use</doc>
78237920 <type name="utf8" c:type="const char*"/>
78247921 </parameter>
78257922 </parameters>
78267923 </method>
7827- <property name="item-type" transfer-ownership="none">
7924+ <property name="item-type" version="1.52" transfer-ownership="none">
78287925 <doc xml:space="preserve"
78297926 filename="pango/pango-fontmap.c"
78307927 line="114">The type of items contained in this list.</doc>
78317928 <type name="GType" c:type="GType"/>
78327929 </property>
7833- <property name="n-items" transfer-ownership="none" default-value="0">
7930+ <property name="n-items"
7931+ version="1.52"
7932+ transfer-ownership="none"
7933+ default-value="0">
78347934 <doc xml:space="preserve"
78357935 filename="pango/pango-fontmap.c"
7836- line="123">The number of items contained in this list.</doc>
7936+ line="125">The number of items contained in this list.</doc>
78377937 <type name="guint" c:type="guint"/>
78387938 </property>
78397939 <field name="parent_instance">
@@ -7864,7 +7964,7 @@ pango_font_map_load_font().</doc>
78647964 <return-value transfer-ownership="full" nullable="1">
78657965 <doc xml:space="preserve"
78667966 filename="pango/pango-fontmap.c"
7867- line="180">the newly allocated `PangoFont`
7967+ line="184">the newly allocated `PangoFont`
78687968 loaded, or %NULL if no font matched.</doc>
78697969 <type name="Font" c:type="PangoFont*"/>
78707970 </return-value>
@@ -7872,19 +7972,19 @@ pango_font_map_load_font().</doc>
78727972 <parameter name="fontmap" transfer-ownership="none">
78737973 <doc xml:space="preserve"
78747974 filename="pango/pango-fontmap.c"
7875- line="174">a `PangoFontMap`</doc>
7975+ line="178">a `PangoFontMap`</doc>
78767976 <type name="FontMap" c:type="PangoFontMap*"/>
78777977 </parameter>
78787978 <parameter name="context" transfer-ownership="none">
78797979 <doc xml:space="preserve"
78807980 filename="pango/pango-fontmap.c"
7881- line="175">the `PangoContext` the font will be used with</doc>
7981+ line="179">the `PangoContext` the font will be used with</doc>
78827982 <type name="Context" c:type="PangoContext*"/>
78837983 </parameter>
78847984 <parameter name="desc" transfer-ownership="none">
78857985 <doc xml:space="preserve"
78867986 filename="pango/pango-fontmap.c"
7887- line="176">a `PangoFontDescription` describing the font to load</doc>
7987+ line="180">a `PangoFontDescription` describing the font to load</doc>
78887988 <type name="FontDescription"
78897989 c:type="const PangoFontDescription*"/>
78907990 </parameter>
@@ -7905,7 +8005,7 @@ pango_font_map_list_families().</doc>
79058005 <parameter name="fontmap" transfer-ownership="none">
79068006 <doc xml:space="preserve"
79078007 filename="pango/pango-fontmap.c"
7908- line="195">a `PangoFontMap`</doc>
8008+ line="199">a `PangoFontMap`</doc>
79098009 <type name="FontMap" c:type="PangoFontMap*"/>
79108010 </parameter>
79118011 <parameter name="families"
@@ -7914,7 +8014,7 @@ pango_font_map_list_families().</doc>
79148014 transfer-ownership="container">
79158015 <doc xml:space="preserve"
79168016 filename="pango/pango-fontmap.c"
7917- line="196">location to
8017+ line="200">location to
79188018 store a pointer to an array of `PangoFontFamily` *.
79198019 This array should be freed with g_free().</doc>
79208020 <array length="2"
@@ -7929,7 +8029,7 @@ pango_font_map_list_families().</doc>
79298029 transfer-ownership="full">
79308030 <doc xml:space="preserve"
79318031 filename="pango/pango-fontmap.c"
7932- line="199">location to store the number of elements in @families</doc>
8032+ line="203">location to store the number of elements in @families</doc>
79338033 <type name="gint" c:type="int*"/>
79348034 </parameter>
79358035 </parameters>
@@ -7945,7 +8045,7 @@ suitable for a particular language. See pango_font_map_load_fontset().</doc>
79458045 <return-value transfer-ownership="full" nullable="1">
79468046 <doc xml:space="preserve"
79478047 filename="pango/pango-fontmap.c"
7948- line="232">the newly allocated
8048+ line="236">the newly allocated
79498049 `PangoFontset` loaded, or %NULL if no font matched.</doc>
79508050 <type name="Fontset" c:type="PangoFontset*"/>
79518051 </return-value>
@@ -7953,26 +8053,26 @@ suitable for a particular language. See pango_font_map_load_fontset().</doc>
79538053 <parameter name="fontmap" transfer-ownership="none">
79548054 <doc xml:space="preserve"
79558055 filename="pango/pango-fontmap.c"
7956- line="224">a `PangoFontMap`</doc>
8056+ line="228">a `PangoFontMap`</doc>
79578057 <type name="FontMap" c:type="PangoFontMap*"/>
79588058 </parameter>
79598059 <parameter name="context" transfer-ownership="none">
79608060 <doc xml:space="preserve"
79618061 filename="pango/pango-fontmap.c"
7962- line="225">the `PangoContext` the font will be used with</doc>
8062+ line="229">the `PangoContext` the font will be used with</doc>
79638063 <type name="Context" c:type="PangoContext*"/>
79648064 </parameter>
79658065 <parameter name="desc" transfer-ownership="none">
79668066 <doc xml:space="preserve"
79678067 filename="pango/pango-fontmap.c"
7968- line="226">a `PangoFontDescription` describing the font to load</doc>
8068+ line="230">a `PangoFontDescription` describing the font to load</doc>
79698069 <type name="FontDescription"
79708070 c:type="const PangoFontDescription*"/>
79718071 </parameter>
79728072 <parameter name="language" transfer-ownership="none">
79738073 <doc xml:space="preserve"
79748074 filename="pango/pango-fontmap.c"
7975- line="227">a `PangoLanguage` the fonts will be used for</doc>
8075+ line="231">a `PangoLanguage` the fonts will be used for</doc>
79768076 <type name="Language" c:type="PangoLanguage*"/>
79778077 </parameter>
79788078 </parameters>
@@ -7995,14 +8095,14 @@ See pango_font_map_get_serial().</doc>
79958095 <return-value transfer-ownership="none">
79968096 <doc xml:space="preserve"
79978097 filename="pango/pango-fontmap.c"
7998- line="408">The current serial number of @fontmap.</doc>
8098+ line="412">The current serial number of @fontmap.</doc>
79998099 <type name="guint" c:type="guint"/>
80008100 </return-value>
80018101 <parameters>
80028102 <parameter name="fontmap" transfer-ownership="none">
80038103 <doc xml:space="preserve"
80048104 filename="pango/pango-fontmap.c"
8005- line="393">a `PangoFontMap`</doc>
8105+ line="397">a `PangoFontMap`</doc>
80068106 <type name="FontMap" c:type="PangoFontMap*"/>
80078107 </parameter>
80088108 </parameters>
@@ -8021,7 +8121,7 @@ See pango_font_map_get_serial().</doc>
80218121 <parameter name="fontmap" transfer-ownership="none">
80228122 <doc xml:space="preserve"
80238123 filename="pango/pango-fontmap.c"
8024- line="439">a `PangoFontMap`</doc>
8124+ line="443">a `PangoFontMap`</doc>
80258125 <type name="FontMap" c:type="PangoFontMap*"/>
80268126 </parameter>
80278127 </parameters>
@@ -8033,20 +8133,20 @@ See pango_font_map_get_serial().</doc>
80338133 <return-value transfer-ownership="none">
80348134 <doc xml:space="preserve"
80358135 filename="pango/pango-fontmap.c"
8036- line="494">the `PangoFontFamily`</doc>
8136+ line="498">the `PangoFontFamily`</doc>
80378137 <type name="FontFamily" c:type="PangoFontFamily*"/>
80388138 </return-value>
80398139 <parameters>
80408140 <parameter name="fontmap" transfer-ownership="none">
80418141 <doc xml:space="preserve"
80428142 filename="pango/pango-fontmap.c"
8043- line="489">a `PangoFontMap`</doc>
8143+ line="493">a `PangoFontMap`</doc>
80448144 <type name="FontMap" c:type="PangoFontMap*"/>
80458145 </parameter>
80468146 <parameter name="name" transfer-ownership="none">
80478147 <doc xml:space="preserve"
80488148 filename="pango/pango-fontmap.c"
8049- line="490">a family name</doc>
8149+ line="494">a family name</doc>
80508150 <type name="utf8" c:type="const char*"/>
80518151 </parameter>
80528152 </parameters>
@@ -8161,6 +8261,16 @@ See pango_font_map_get_serial().</doc>
81618261 filename="pango/pango-font.h"
81628262 line="198">OpenType font features are specified.</doc>
81638263 </member>
8264+ <member name="color"
8265+ value="512"
8266+ c:identifier="PANGO_FONT_MASK_COLOR"
8267+ version="1.57"
8268+ glib:nick="color"
8269+ glib:name="PANGO_FONT_MASK_COLOR">
8270+ <doc xml:space="preserve"
8271+ filename="pango/pango-font.h"
8272+ line="205">Font color is specified.</doc>
8273+ </member>
81648274 </bitfield>
81658275 <record name="FontMetrics"
81668276 c:type="PangoFontMetrics"
@@ -8183,7 +8293,7 @@ For an overview of the most important metrics, see:
81838293 &lt;source srcset="fontmetrics-dark.png" media="(prefers-color-scheme: dark)"&gt;
81848294 &lt;img alt="Font metrics" src="fontmetrics-light.png"&gt;
81858295 &lt;/picture&gt;</doc>
8186- <source-position filename="pango/pango-font.h" line="395"/>
8296+ <source-position filename="pango/pango-font.h" line="425"/>
81878297 <field name="ref_count" readable="0" private="1">
81888298 <type name="guint" c:type="guint"/>
81898299 </field>
@@ -8218,23 +8328,23 @@ For an overview of the most important metrics, see:
82188328 c:identifier="pango_font_metrics_get_approximate_char_width">
82198329 <doc xml:space="preserve"
82208330 filename="pango/fonts.c"
8221- line="2489">Gets the approximate character width for a font metrics structure.
8331+ line="2559">Gets the approximate character width for a font metrics structure.
82228332
82238333 This is merely a representative value useful, for example, for
82248334 determining the initial size for a window. Actual characters in
82258335 text will be wider and narrower than this.</doc>
8226- <source-position filename="pango/pango-font.h" line="410"/>
8336+ <source-position filename="pango/pango-font.h" line="440"/>
82278337 <return-value transfer-ownership="none">
82288338 <doc xml:space="preserve"
82298339 filename="pango/fonts.c"
8230- line="2499">the character width, in Pango units.</doc>
8340+ line="2569">the character width, in Pango units.</doc>
82318341 <type name="gint" c:type="int"/>
82328342 </return-value>
82338343 <parameters>
82348344 <instance-parameter name="metrics" transfer-ownership="none">
82358345 <doc xml:space="preserve"
82368346 filename="pango/fonts.c"
8237- line="2491">a `PangoFontMetrics` structure</doc>
8347+ line="2561">a `PangoFontMetrics` structure</doc>
82388348 <type name="FontMetrics" c:type="PangoFontMetrics*"/>
82398349 </instance-parameter>
82408350 </parameters>
@@ -8243,25 +8353,25 @@ text will be wider and narrower than this.</doc>
82438353 c:identifier="pango_font_metrics_get_approximate_digit_width">
82448354 <doc xml:space="preserve"
82458355 filename="pango/fonts.c"
8246- line="2509">Gets the approximate digit width for a font metrics structure.
8356+ line="2579">Gets the approximate digit width for a font metrics structure.
82478357
82488358 This is merely a representative value useful, for example, for
82498359 determining the initial size for a window. Actual digits in
82508360 text can be wider or narrower than this, though this value
82518361 is generally somewhat more accurate than the result of
82528362 pango_font_metrics_get_approximate_char_width() for digits.</doc>
8253- <source-position filename="pango/pango-font.h" line="412"/>
8363+ <source-position filename="pango/pango-font.h" line="442"/>
82548364 <return-value transfer-ownership="none">
82558365 <doc xml:space="preserve"
82568366 filename="pango/fonts.c"
8257- line="2521">the digit width, in Pango units.</doc>
8367+ line="2591">the digit width, in Pango units.</doc>
82588368 <type name="gint" c:type="int"/>
82598369 </return-value>
82608370 <parameters>
82618371 <instance-parameter name="metrics" transfer-ownership="none">
82628372 <doc xml:space="preserve"
82638373 filename="pango/fonts.c"
8264- line="2511">a `PangoFontMetrics` structure</doc>
8374+ line="2581">a `PangoFontMetrics` structure</doc>
82658375 <type name="FontMetrics" c:type="PangoFontMetrics*"/>
82668376 </instance-parameter>
82678377 </parameters>
@@ -8269,24 +8379,24 @@ pango_font_metrics_get_approximate_char_width() for digits.</doc>
82698379 <method name="get_ascent" c:identifier="pango_font_metrics_get_ascent">
82708380 <doc xml:space="preserve"
82718381 filename="pango/fonts.c"
8272- line="2424">Gets the ascent from a font metrics structure.
8382+ line="2494">Gets the ascent from a font metrics structure.
82738383
82748384 The ascent is the distance from the baseline to the logical top
82758385 of a line of text. (The logical top may be above or below the top
82768386 of the actual drawn ink. It is necessary to lay out the text to
82778387 figure where the ink will be.)</doc>
8278- <source-position filename="pango/pango-font.h" line="404"/>
8388+ <source-position filename="pango/pango-font.h" line="434"/>
82798389 <return-value transfer-ownership="none">
82808390 <doc xml:space="preserve"
82818391 filename="pango/fonts.c"
8282- line="2435">the ascent, in Pango units.</doc>
8392+ line="2505">the ascent, in Pango units.</doc>
82838393 <type name="gint" c:type="int"/>
82848394 </return-value>
82858395 <parameters>
82868396 <instance-parameter name="metrics" transfer-ownership="none">
82878397 <doc xml:space="preserve"
82888398 filename="pango/fonts.c"
8289- line="2426">a `PangoFontMetrics` structure</doc>
8399+ line="2496">a `PangoFontMetrics` structure</doc>
82908400 <type name="FontMetrics" c:type="PangoFontMetrics*"/>
82918401 </instance-parameter>
82928402 </parameters>
@@ -8294,24 +8404,24 @@ figure where the ink will be.)</doc>
82948404 <method name="get_descent" c:identifier="pango_font_metrics_get_descent">
82958405 <doc xml:space="preserve"
82968406 filename="pango/fonts.c"
8297- line="2445">Gets the descent from a font metrics structure.
8407+ line="2515">Gets the descent from a font metrics structure.
82988408
82998409 The descent is the distance from the baseline to the logical bottom
83008410 of a line of text. (The logical bottom may be above or below the
83018411 bottom of the actual drawn ink. It is necessary to lay out the text
83028412 to figure where the ink will be.)</doc>
8303- <source-position filename="pango/pango-font.h" line="406"/>
8413+ <source-position filename="pango/pango-font.h" line="436"/>
83048414 <return-value transfer-ownership="none">
83058415 <doc xml:space="preserve"
83068416 filename="pango/fonts.c"
8307- line="2456">the descent, in Pango units.</doc>
8417+ line="2526">the descent, in Pango units.</doc>
83088418 <type name="gint" c:type="int"/>
83098419 </return-value>
83108420 <parameters>
83118421 <instance-parameter name="metrics" transfer-ownership="none">
83128422 <doc xml:space="preserve"
83138423 filename="pango/fonts.c"
8314- line="2447">a `PangoFontMetrics` structure</doc>
8424+ line="2517">a `PangoFontMetrics` structure</doc>
83158425 <type name="FontMetrics" c:type="PangoFontMetrics*"/>
83168426 </instance-parameter>
83178427 </parameters>
@@ -8321,24 +8431,24 @@ to figure where the ink will be.)</doc>
83218431 version="1.44">
83228432 <doc xml:space="preserve"
83238433 filename="pango/fonts.c"
8324- line="2466">Gets the line height from a font metrics structure.
8434+ line="2536">Gets the line height from a font metrics structure.
83258435
83268436 The line height is the recommended distance between successive
83278437 baselines in wrapped text using this font.
83288438
83298439 If the line height is not available, 0 is returned.</doc>
8330- <source-position filename="pango/pango-font.h" line="408"/>
8440+ <source-position filename="pango/pango-font.h" line="438"/>
83318441 <return-value transfer-ownership="none">
83328442 <doc xml:space="preserve"
83338443 filename="pango/fonts.c"
8334- line="2477">the height, in Pango units</doc>
8444+ line="2547">the height, in Pango units</doc>
83358445 <type name="gint" c:type="int"/>
83368446 </return-value>
83378447 <parameters>
83388448 <instance-parameter name="metrics" transfer-ownership="none">
83398449 <doc xml:space="preserve"
83408450 filename="pango/fonts.c"
8341- line="2468">a `PangoFontMetrics` structure</doc>
8451+ line="2538">a `PangoFontMetrics` structure</doc>
83428452 <type name="FontMetrics" c:type="PangoFontMetrics*"/>
83438453 </instance-parameter>
83448454 </parameters>
@@ -8348,22 +8458,22 @@ If the line height is not available, 0 is returned.</doc>
83488458 version="1.6">
83498459 <doc xml:space="preserve"
83508460 filename="pango/fonts.c"
8351- line="2571">Gets the suggested position to draw the strikethrough.
8461+ line="2641">Gets the suggested position to draw the strikethrough.
83528462
83538463 The value returned is the distance *above* the
83548464 baseline of the top of the strikethrough.</doc>
8355- <source-position filename="pango/pango-font.h" line="418"/>
8465+ <source-position filename="pango/pango-font.h" line="448"/>
83568466 <return-value transfer-ownership="none">
83578467 <doc xml:space="preserve"
83588468 filename="pango/fonts.c"
8359- line="2580">the suggested strikethrough position, in Pango units.</doc>
8469+ line="2650">the suggested strikethrough position, in Pango units.</doc>
83608470 <type name="gint" c:type="int"/>
83618471 </return-value>
83628472 <parameters>
83638473 <instance-parameter name="metrics" transfer-ownership="none">
83648474 <doc xml:space="preserve"
83658475 filename="pango/fonts.c"
8366- line="2573">a `PangoFontMetrics` structure</doc>
8476+ line="2643">a `PangoFontMetrics` structure</doc>
83678477 <type name="FontMetrics" c:type="PangoFontMetrics*"/>
83688478 </instance-parameter>
83698479 </parameters>
@@ -8373,19 +8483,19 @@ baseline of the top of the strikethrough.</doc>
83738483 version="1.6">
83748484 <doc xml:space="preserve"
83758485 filename="pango/fonts.c"
8376- line="2592">Gets the suggested thickness to draw for the strikethrough.</doc>
8377- <source-position filename="pango/pango-font.h" line="420"/>
8486+ line="2662">Gets the suggested thickness to draw for the strikethrough.</doc>
8487+ <source-position filename="pango/pango-font.h" line="450"/>
83788488 <return-value transfer-ownership="none">
83798489 <doc xml:space="preserve"
83808490 filename="pango/fonts.c"
8381- line="2598">the suggested strikethrough thickness, in Pango units.</doc>
8491+ line="2668">the suggested strikethrough thickness, in Pango units.</doc>
83828492 <type name="gint" c:type="int"/>
83838493 </return-value>
83848494 <parameters>
83858495 <instance-parameter name="metrics" transfer-ownership="none">
83868496 <doc xml:space="preserve"
83878497 filename="pango/fonts.c"
8388- line="2594">a `PangoFontMetrics` structure</doc>
8498+ line="2664">a `PangoFontMetrics` structure</doc>
83898499 <type name="FontMetrics" c:type="PangoFontMetrics*"/>
83908500 </instance-parameter>
83918501 </parameters>
@@ -8395,23 +8505,23 @@ baseline of the top of the strikethrough.</doc>
83958505 version="1.6">
83968506 <doc xml:space="preserve"
83978507 filename="pango/fonts.c"
8398- line="2531">Gets the suggested position to draw the underline.
8508+ line="2601">Gets the suggested position to draw the underline.
83998509
84008510 The value returned is the distance *above* the baseline of the top
84018511 of the underline. Since most fonts have underline positions beneath
84028512 the baseline, this value is typically negative.</doc>
8403- <source-position filename="pango/pango-font.h" line="414"/>
8513+ <source-position filename="pango/pango-font.h" line="444"/>
84048514 <return-value transfer-ownership="none">
84058515 <doc xml:space="preserve"
84068516 filename="pango/fonts.c"
8407- line="2541">the suggested underline position, in Pango units.</doc>
8517+ line="2611">the suggested underline position, in Pango units.</doc>
84088518 <type name="gint" c:type="int"/>
84098519 </return-value>
84108520 <parameters>
84118521 <instance-parameter name="metrics" transfer-ownership="none">
84128522 <doc xml:space="preserve"
84138523 filename="pango/fonts.c"
8414- line="2533">a `PangoFontMetrics` structure</doc>
8524+ line="2603">a `PangoFontMetrics` structure</doc>
84158525 <type name="FontMetrics" c:type="PangoFontMetrics*"/>
84168526 </instance-parameter>
84178527 </parameters>
@@ -8421,19 +8531,19 @@ the baseline, this value is typically negative.</doc>
84218531 version="1.6">
84228532 <doc xml:space="preserve"
84238533 filename="pango/fonts.c"
8424- line="2553">Gets the suggested thickness to draw for the underline.</doc>
8425- <source-position filename="pango/pango-font.h" line="416"/>
8534+ line="2623">Gets the suggested thickness to draw for the underline.</doc>
8535+ <source-position filename="pango/pango-font.h" line="446"/>
84268536 <return-value transfer-ownership="none">
84278537 <doc xml:space="preserve"
84288538 filename="pango/fonts.c"
8429- line="2559">the suggested underline thickness, in Pango units.</doc>
8539+ line="2629">the suggested underline thickness, in Pango units.</doc>
84308540 <type name="gint" c:type="int"/>
84318541 </return-value>
84328542 <parameters>
84338543 <instance-parameter name="metrics" transfer-ownership="none">
84348544 <doc xml:space="preserve"
84358545 filename="pango/fonts.c"
8436- line="2555">a `PangoFontMetrics` structure</doc>
8546+ line="2625">a `PangoFontMetrics` structure</doc>
84378547 <type name="FontMetrics" c:type="PangoFontMetrics*"/>
84388548 </instance-parameter>
84398549 </parameters>
@@ -8441,12 +8551,12 @@ the baseline, this value is typically negative.</doc>
84418551 <method name="ref" c:identifier="pango_font_metrics_ref">
84428552 <doc xml:space="preserve"
84438553 filename="pango/fonts.c"
8444- line="2385">Increase the reference count of a font metrics structure by one.</doc>
8445- <source-position filename="pango/pango-font.h" line="400"/>
8554+ line="2455">Increase the reference count of a font metrics structure by one.</doc>
8555+ <source-position filename="pango/pango-font.h" line="430"/>
84468556 <return-value transfer-ownership="full" nullable="1">
84478557 <doc xml:space="preserve"
84488558 filename="pango/fonts.c"
8449- line="2391">@metrics</doc>
8559+ line="2461">@metrics</doc>
84508560 <type name="FontMetrics" c:type="PangoFontMetrics*"/>
84518561 </return-value>
84528562 <parameters>
@@ -8456,7 +8566,7 @@ the baseline, this value is typically negative.</doc>
84568566 allow-none="1">
84578567 <doc xml:space="preserve"
84588568 filename="pango/fonts.c"
8459- line="2387">a `PangoFontMetrics` structure, may be %NULL</doc>
8569+ line="2457">a `PangoFontMetrics` structure, may be %NULL</doc>
84608570 <type name="FontMetrics" c:type="PangoFontMetrics*"/>
84618571 </instance-parameter>
84628572 </parameters>
@@ -8464,10 +8574,10 @@ the baseline, this value is typically negative.</doc>
84648574 <method name="unref" c:identifier="pango_font_metrics_unref">
84658575 <doc xml:space="preserve"
84668576 filename="pango/fonts.c"
8467- line="2404">Decrease the reference count of a font metrics structure by one.
8577+ line="2474">Decrease the reference count of a font metrics structure by one.
84688578
84698579 If the result is zero, frees the structure and any associated memory.</doc>
8470- <source-position filename="pango/pango-font.h" line="402"/>
8580+ <source-position filename="pango/pango-font.h" line="432"/>
84718581 <return-value transfer-ownership="none">
84728582 <type name="none" c:type="void"/>
84738583 </return-value>
@@ -8478,7 +8588,7 @@ If the result is zero, frees the structure and any associated memory.</doc>
84788588 allow-none="1">
84798589 <doc xml:space="preserve"
84808590 filename="pango/fonts.c"
8481- line="2406">a `PangoFontMetrics` structure, may be %NULL</doc>
8591+ line="2476">a `PangoFontMetrics` structure, may be %NULL</doc>
84828592 <type name="FontMetrics" c:type="PangoFontMetrics*"/>
84838593 </instance-parameter>
84848594 </parameters>
@@ -9024,26 +9134,26 @@ The fontset takes ownership of @font.</doc>
90249134 introspectable="0">
90259135 <doc xml:space="preserve"
90269136 filename="pango/pango-font.h"
9027- line="699">The way this unknown glyphs are rendered is backend specific. For example,
9137+ line="729">The way this unknown glyphs are rendered is backend specific. For example,
90289138 a box with the hexadecimal Unicode code-point of the character written in it
90299139 is what is done in the most common backends.</doc>
9030- <source-position filename="pango/pango-font.h" line="712"/>
9140+ <source-position filename="pango/pango-font.h" line="742"/>
90319141 <parameters>
90329142 <parameter name="wc">
90339143 <doc xml:space="preserve"
90349144 filename="pango/pango-font.h"
9035- line="701">a Unicode character</doc>
9145+ line="731">a Unicode character</doc>
90369146 </parameter>
90379147 </parameters>
90389148 </function-macro>
90399149 <constant name="GLYPH_EMPTY" value="268435455" c:type="PANGO_GLYPH_EMPTY">
90409150 <doc xml:space="preserve"
90419151 filename="pango/pango-font.h"
9042- line="669">A `PangoGlyph` value that indicates a zero-width empty glpyh.
9152+ line="699">A `PangoGlyph` value that indicates a zero-width empty glpyh.
90439153
90449154 This is useful for example in shaper modules, to use as the glyph for
90459155 various zero-width Unicode characters (those passing [func@is_zero_width]).</doc>
9046- <source-position filename="pango/pango-font.h" line="709"/>
9156+ <source-position filename="pango/pango-font.h" line="739"/>
90479157 <type name="Glyph" c:type="PangoGlyph"/>
90489158 </constant>
90499159 <constant name="GLYPH_INVALID_INPUT"
@@ -9052,14 +9162,14 @@ various zero-width Unicode characters (those passing [func@is_zero_width]).</doc
90529162 version="1.20">
90539163 <doc xml:space="preserve"
90549164 filename="pango/pango-font.h"
9055- line="678">A `PangoGlyph` value for invalid input.
9165+ line="708">A `PangoGlyph` value for invalid input.
90569166
90579167 `PangoLayout` produces one such glyph per invalid input UTF-8 byte and such
90589168 a glyph is rendered as a crossed box.
90599169
90609170 Note that this value is defined such that it has the %PANGO_GLYPH_UNKNOWN_FLAG
90619171 set.</doc>
9062- <source-position filename="pango/pango-font.h" line="710"/>
9172+ <source-position filename="pango/pango-font.h" line="740"/>
90639173 <type name="Glyph" c:type="PangoGlyph"/>
90649174 </constant>
90659175 <constant name="GLYPH_UNKNOWN_FLAG"
@@ -9067,11 +9177,11 @@ set.</doc>
90679177 c:type="PANGO_GLYPH_UNKNOWN_FLAG">
90689178 <doc xml:space="preserve"
90699179 filename="pango/pango-font.h"
9070- line="691">Flag used in `PangoGlyph` to turn a `gunichar` value of a valid Unicode
9180+ line="721">Flag used in `PangoGlyph` to turn a `gunichar` value of a valid Unicode
90719181 character into an unknown-character glyph for that `gunichar`.
90729182
90739183 Such unknown-character glyphs may be rendered as a 'hex box'.</doc>
9074- <source-position filename="pango/pango-font.h" line="711"/>
9184+ <source-position filename="pango/pango-font.h" line="741"/>
90759185 <type name="Glyph" c:type="PangoGlyph"/>
90769186 </constant>
90779187 <function-macro name="GRAVITY_IS_IMPROPER"
@@ -10540,7 +10650,7 @@ See also [enum@Pango.Gravity]</doc>
1054010650 <function-macro name="IS_FONT"
1054110651 c:identifier="PANGO_IS_FONT"
1054210652 introspectable="0">
10543- <source-position filename="pango/pango-font.h" line="571"/>
10653+ <source-position filename="pango/pango-font.h" line="601"/>
1054410654 <parameters>
1054510655 <parameter name="object">
1054610656 </parameter>
@@ -10576,7 +10686,7 @@ See also [enum@Pango.Gravity]</doc>
1057610686 <function-macro name="IS_FONT_CLASS"
1057710687 c:identifier="PANGO_IS_FONT_CLASS"
1057810688 introspectable="0">
10579- <source-position filename="pango/pango-font.h" line="573"/>
10689+ <source-position filename="pango/pango-font.h" line="603"/>
1058010690 <parameters>
1058110691 <parameter name="klass">
1058210692 </parameter>
@@ -10585,7 +10695,7 @@ See also [enum@Pango.Gravity]</doc>
1058510695 <function-macro name="IS_FONT_FACE"
1058610696 c:identifier="PANGO_IS_FONT_FACE"
1058710697 introspectable="0">
10588- <source-position filename="pango/pango-font.h" line="504"/>
10698+ <source-position filename="pango/pango-font.h" line="534"/>
1058910699 <parameters>
1059010700 <parameter name="object">
1059110701 </parameter>
@@ -10594,7 +10704,7 @@ See also [enum@Pango.Gravity]</doc>
1059410704 <function-macro name="IS_FONT_FACE_CLASS"
1059510705 c:identifier="PANGO_IS_FONT_FACE_CLASS"
1059610706 introspectable="0">
10597- <source-position filename="pango/pango-font.h" line="506"/>
10707+ <source-position filename="pango/pango-font.h" line="536"/>
1059810708 <parameters>
1059910709 <parameter name="klass">
1060010710 </parameter>
@@ -10603,7 +10713,7 @@ See also [enum@Pango.Gravity]</doc>
1060310713 <function-macro name="IS_FONT_FAMILY"
1060410714 c:identifier="PANGO_IS_FONT_FAMILY"
1060510715 introspectable="0">
10606- <source-position filename="pango/pango-font.h" line="429"/>
10716+ <source-position filename="pango/pango-font.h" line="459"/>
1060710717 <parameters>
1060810718 <parameter name="object">
1060910719 </parameter>
@@ -10612,7 +10722,7 @@ See also [enum@Pango.Gravity]</doc>
1061210722 <function-macro name="IS_FONT_FAMILY_CLASS"
1061310723 c:identifier="PANGO_IS_FONT_FAMILY_CLASS"
1061410724 introspectable="0">
10615- <source-position filename="pango/pango-font.h" line="431"/>
10725+ <source-position filename="pango/pango-font.h" line="461"/>
1061610726 <parameters>
1061710727 <parameter name="klass">
1061810728 </parameter>
@@ -11845,19 +11955,19 @@ A negative value indicates a hanging indentation.</doc>
1184511955 <method name="get_iter" c:identifier="pango_layout_get_iter">
1184611956 <doc xml:space="preserve"
1184711957 filename="pango/pango-layout.c"
11848- line="7200">Returns an iterator to iterate over the visual extents of the layout.</doc>
11958+ line="7220">Returns an iterator to iterate over the visual extents of the layout.</doc>
1184911959 <source-position filename="pango/pango-layout.h" line="495"/>
1185011960 <return-value transfer-ownership="full">
1185111961 <doc xml:space="preserve"
1185211962 filename="pango/pango-layout.c"
11853- line="7206">the new `PangoLayoutIter`</doc>
11963+ line="7226">the new `PangoLayoutIter`</doc>
1185411964 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1185511965 </return-value>
1185611966 <parameters>
1185711967 <instance-parameter name="layout" transfer-ownership="none">
1185811968 <doc xml:space="preserve"
1185911969 filename="pango/pango-layout.c"
11860- line="7202">a `PangoLayout`</doc>
11970+ line="7222">a `PangoLayout`</doc>
1186111971 <type name="Layout" c:type="PangoLayout*"/>
1186211972 </instance-parameter>
1186311973 </parameters>
@@ -13631,19 +13741,19 @@ The `PangoLayoutIter` structure is opaque, and has no user-visible fields.</doc>
1363113741 c:identifier="pango_layout_iter_at_last_line">
1363213742 <doc xml:space="preserve"
1363313743 filename="pango/pango-layout.c"
13634- line="7441">Determines whether @iter is on the last line of the layout.</doc>
13744+ line="7461">Determines whether @iter is on the last line of the layout.</doc>
1363513745 <source-position filename="pango/pango-layout.h" line="512"/>
1363613746 <return-value transfer-ownership="none">
1363713747 <doc xml:space="preserve"
1363813748 filename="pango/pango-layout.c"
13639- line="7447">%TRUE if @iter is on the last line</doc>
13749+ line="7467">%TRUE if @iter is on the last line</doc>
1364013750 <type name="gboolean" c:type="gboolean"/>
1364113751 </return-value>
1364213752 <parameters>
1364313753 <instance-parameter name="iter" transfer-ownership="none">
1364413754 <doc xml:space="preserve"
1364513755 filename="pango/pango-layout.c"
13646- line="7443">a `PangoLayoutIter`</doc>
13756+ line="7463">a `PangoLayoutIter`</doc>
1364713757 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1364813758 </instance-parameter>
1364913759 </parameters>
@@ -13651,12 +13761,12 @@ The `PangoLayoutIter` structure is opaque, and has no user-visible fields.</doc>
1365113761 <method name="copy" c:identifier="pango_layout_iter_copy" version="1.20">
1365213762 <doc xml:space="preserve"
1365313763 filename="pango/pango-layout.c"
13654- line="7140">Copies a `PangoLayoutIter`.</doc>
13764+ line="7160">Copies a `PangoLayoutIter`.</doc>
1365513765 <source-position filename="pango/pango-layout.h" line="497"/>
1365613766 <return-value transfer-ownership="full" nullable="1">
1365713767 <doc xml:space="preserve"
1365813768 filename="pango/pango-layout.c"
13659- line="7146">the newly allocated `PangoLayoutIter`</doc>
13769+ line="7166">the newly allocated `PangoLayoutIter`</doc>
1366013770 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1366113771 </return-value>
1366213772 <parameters>
@@ -13666,7 +13776,7 @@ The `PangoLayoutIter` structure is opaque, and has no user-visible fields.</doc>
1366613776 allow-none="1">
1366713777 <doc xml:space="preserve"
1366813778 filename="pango/pango-layout.c"
13669- line="7142">a `PangoLayoutIter`</doc>
13779+ line="7162">a `PangoLayoutIter`</doc>
1367013780 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1367113781 </instance-parameter>
1367213782 </parameters>
@@ -13674,7 +13784,7 @@ The `PangoLayoutIter` structure is opaque, and has no user-visible fields.</doc>
1367413784 <method name="free" c:identifier="pango_layout_iter_free">
1367513785 <doc xml:space="preserve"
1367613786 filename="pango/pango-layout.c"
13677- line="7285">Frees an iterator that's no longer in use.</doc>
13787+ line="7305">Frees an iterator that's no longer in use.</doc>
1367813788 <source-position filename="pango/pango-layout.h" line="499"/>
1367913789 <return-value transfer-ownership="none">
1368013790 <type name="none" c:type="void"/>
@@ -13686,7 +13796,7 @@ The `PangoLayoutIter` structure is opaque, and has no user-visible fields.</doc>
1368613796 allow-none="1">
1368713797 <doc xml:space="preserve"
1368813798 filename="pango/pango-layout.c"
13689- line="7287">a `PangoLayoutIter`, may be %NULL</doc>
13799+ line="7307">a `PangoLayoutIter`, may be %NULL</doc>
1369013800 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1369113801 </instance-parameter>
1369213802 </parameters>
@@ -13695,7 +13805,7 @@ The `PangoLayoutIter` structure is opaque, and has no user-visible fields.</doc>
1369513805 c:identifier="pango_layout_iter_get_baseline">
1369613806 <doc xml:space="preserve"
1369713807 filename="pango/pango-layout.c"
13698- line="8004">Gets the Y position of the current line's baseline, in layout
13808+ line="8024">Gets the Y position of the current line's baseline, in layout
1369913809 coordinates.
1370013810
1370113811 Layout coordinates have the origin at the top left of the entire layout.</doc>
@@ -13703,14 +13813,14 @@ Layout coordinates have the origin at the top left of the entire layout.</doc>
1370313813 <return-value transfer-ownership="none">
1370413814 <doc xml:space="preserve"
1370513815 filename="pango/pango-layout.c"
13706- line="8013">baseline of current line</doc>
13816+ line="8033">baseline of current line</doc>
1370713817 <type name="gint" c:type="int"/>
1370813818 </return-value>
1370913819 <parameters>
1371013820 <instance-parameter name="iter" transfer-ownership="none">
1371113821 <doc xml:space="preserve"
1371213822 filename="pango/pango-layout.c"
13713- line="8006">a `PangoLayoutIter`</doc>
13823+ line="8026">a `PangoLayoutIter`</doc>
1371413824 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1371513825 </instance-parameter>
1371613826 </parameters>
@@ -13719,7 +13829,7 @@ Layout coordinates have the origin at the top left of the entire layout.</doc>
1371913829 c:identifier="pango_layout_iter_get_char_extents">
1372013830 <doc xml:space="preserve"
1372113831 filename="pango/pango-layout.c"
13722- line="7731">Gets the extents of the current character, in layout coordinates.
13832+ line="7751">Gets the extents of the current character, in layout coordinates.
1372313833
1372413834 Layout coordinates have the origin at the top left of the entire layout.
1372513835
@@ -13733,7 +13843,7 @@ ink extents make sense only down to the level of clusters.</doc>
1373313843 <instance-parameter name="iter" transfer-ownership="none">
1373413844 <doc xml:space="preserve"
1373513845 filename="pango/pango-layout.c"
13736- line="7733">a `PangoLayoutIter`</doc>
13846+ line="7753">a `PangoLayoutIter`</doc>
1373713847 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1373813848 </instance-parameter>
1373913849 <parameter name="logical_rect"
@@ -13742,7 +13852,7 @@ ink extents make sense only down to the level of clusters.</doc>
1374213852 transfer-ownership="none">
1374313853 <doc xml:space="preserve"
1374413854 filename="pango/pango-layout.c"
13745- line="7734">rectangle to fill with
13855+ line="7754">rectangle to fill with
1374613856 logical extents</doc>
1374713857 <type name="Rectangle" c:type="PangoRectangle*"/>
1374813858 </parameter>
@@ -13752,7 +13862,7 @@ ink extents make sense only down to the level of clusters.</doc>
1375213862 c:identifier="pango_layout_iter_get_cluster_extents">
1375313863 <doc xml:space="preserve"
1375413864 filename="pango/pango-layout.c"
13755- line="7784">Gets the extents of the current cluster, in layout coordinates.
13865+ line="7804">Gets the extents of the current cluster, in layout coordinates.
1375613866
1375713867 Layout coordinates have the origin at the top left of the entire layout.</doc>
1375813868 <source-position filename="pango/pango-layout.h" line="529"/>
@@ -13763,7 +13873,7 @@ Layout coordinates have the origin at the top left of the entire layout.</doc>
1376313873 <instance-parameter name="iter" transfer-ownership="none">
1376413874 <doc xml:space="preserve"
1376513875 filename="pango/pango-layout.c"
13766- line="7786">a `PangoLayoutIter`</doc>
13876+ line="7806">a `PangoLayoutIter`</doc>
1376713877 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1376813878 </instance-parameter>
1376913879 <parameter name="ink_rect"
@@ -13774,7 +13884,7 @@ Layout coordinates have the origin at the top left of the entire layout.</doc>
1377413884 allow-none="1">
1377513885 <doc xml:space="preserve"
1377613886 filename="pango/pango-layout.c"
13777- line="7787">rectangle to fill with ink extents</doc>
13887+ line="7807">rectangle to fill with ink extents</doc>
1377813888 <type name="Rectangle" c:type="PangoRectangle*"/>
1377913889 </parameter>
1378013890 <parameter name="logical_rect"
@@ -13785,7 +13895,7 @@ Layout coordinates have the origin at the top left of the entire layout.</doc>
1378513895 allow-none="1">
1378613896 <doc xml:space="preserve"
1378713897 filename="pango/pango-layout.c"
13788- line="7788">rectangle to fill with logical extents</doc>
13898+ line="7808">rectangle to fill with logical extents</doc>
1378913899 <type name="Rectangle" c:type="PangoRectangle*"/>
1379013900 </parameter>
1379113901 </parameters>
@@ -13793,7 +13903,7 @@ Layout coordinates have the origin at the top left of the entire layout.</doc>
1379313903 <method name="get_index" c:identifier="pango_layout_iter_get_index">
1379413904 <doc xml:space="preserve"
1379513905 filename="pango/pango-layout.c"
13796- line="7301">Gets the current byte index.
13906+ line="7321">Gets the current byte index.
1379713907
1379813908 Note that iterating forward by char moves in visual order,
1379913909 not logical order, so indexes may not be sequential. Also,
@@ -13803,14 +13913,14 @@ layout, if on the %NULL run (see [method@Pango.LayoutIter.get_run]).</doc>
1380313913 <return-value transfer-ownership="none">
1380413914 <doc xml:space="preserve"
1380513915 filename="pango/pango-layout.c"
13806- line="7312">current byte index</doc>
13916+ line="7332">current byte index</doc>
1380713917 <type name="gint" c:type="int"/>
1380813918 </return-value>
1380913919 <parameters>
1381013920 <instance-parameter name="iter" transfer-ownership="none">
1381113921 <doc xml:space="preserve"
1381213922 filename="pango/pango-layout.c"
13813- line="7303">a `PangoLayoutIter`</doc>
13923+ line="7323">a `PangoLayoutIter`</doc>
1381413924 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1381513925 </instance-parameter>
1381613926 </parameters>
@@ -13820,19 +13930,19 @@ layout, if on the %NULL run (see [method@Pango.LayoutIter.get_run]).</doc>
1382013930 version="1.20">
1382113931 <doc xml:space="preserve"
1382213932 filename="pango/pango-layout.c"
13823- line="7458">Gets the layout associated with a `PangoLayoutIter`.</doc>
13933+ line="7478">Gets the layout associated with a `PangoLayoutIter`.</doc>
1382413934 <source-position filename="pango/pango-layout.h" line="514"/>
1382513935 <return-value transfer-ownership="none" nullable="1">
1382613936 <doc xml:space="preserve"
1382713937 filename="pango/pango-layout.c"
13828- line="7464">the layout associated with @iter</doc>
13938+ line="7484">the layout associated with @iter</doc>
1382913939 <type name="Layout" c:type="PangoLayout*"/>
1383013940 </return-value>
1383113941 <parameters>
1383213942 <instance-parameter name="iter" transfer-ownership="none">
1383313943 <doc xml:space="preserve"
1383413944 filename="pango/pango-layout.c"
13835- line="7460">a `PangoLayoutIter`</doc>
13945+ line="7480">a `PangoLayoutIter`</doc>
1383613946 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1383713947 </instance-parameter>
1383813948 </parameters>
@@ -13841,7 +13951,7 @@ layout, if on the %NULL run (see [method@Pango.LayoutIter.get_run]).</doc>
1384113951 c:identifier="pango_layout_iter_get_layout_extents">
1384213952 <doc xml:space="preserve"
1384313953 filename="pango/pango-layout.c"
13844- line="8050">Obtains the extents of the `PangoLayout` being iterated over.</doc>
13954+ line="8070">Obtains the extents of the `PangoLayout` being iterated over.</doc>
1384513955 <source-position filename="pango/pango-layout.h" line="548"/>
1384613956 <return-value transfer-ownership="none">
1384713957 <type name="none" c:type="void"/>
@@ -13850,7 +13960,7 @@ layout, if on the %NULL run (see [method@Pango.LayoutIter.get_run]).</doc>
1385013960 <instance-parameter name="iter" transfer-ownership="none">
1385113961 <doc xml:space="preserve"
1385213962 filename="pango/pango-layout.c"
13853- line="8052">a `PangoLayoutIter`</doc>
13963+ line="8072">a `PangoLayoutIter`</doc>
1385413964 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1385513965 </instance-parameter>
1385613966 <parameter name="ink_rect"
@@ -13861,7 +13971,7 @@ layout, if on the %NULL run (see [method@Pango.LayoutIter.get_run]).</doc>
1386113971 allow-none="1">
1386213972 <doc xml:space="preserve"
1386313973 filename="pango/pango-layout.c"
13864- line="8053">rectangle to fill with ink extents</doc>
13974+ line="8073">rectangle to fill with ink extents</doc>
1386513975 <type name="Rectangle" c:type="PangoRectangle*"/>
1386613976 </parameter>
1386713977 <parameter name="logical_rect"
@@ -13872,7 +13982,7 @@ layout, if on the %NULL run (see [method@Pango.LayoutIter.get_run]).</doc>
1387213982 allow-none="1">
1387313983 <doc xml:space="preserve"
1387413984 filename="pango/pango-layout.c"
13875- line="8054">rectangle to fill with logical extents</doc>
13985+ line="8074">rectangle to fill with logical extents</doc>
1387613986 <type name="Rectangle" c:type="PangoRectangle*"/>
1387713987 </parameter>
1387813988 </parameters>
@@ -13880,7 +13990,7 @@ layout, if on the %NULL run (see [method@Pango.LayoutIter.get_run]).</doc>
1388013990 <method name="get_line" c:identifier="pango_layout_iter_get_line">
1388113991 <doc xml:space="preserve"
1388213992 filename="pango/pango-layout.c"
13883- line="7394">Gets the current line.
13993+ line="7414">Gets the current line.
1388413994
1388513995 Use the faster [method@Pango.LayoutIter.get_line_readonly] if
1388613996 you do not plan to modify the contents of the line (glyphs,
@@ -13889,14 +13999,14 @@ glyph widths, etc.).</doc>
1388913999 <return-value transfer-ownership="none" nullable="1">
1389014000 <doc xml:space="preserve"
1389114001 filename="pango/pango-layout.c"
13892- line="7404">the current line</doc>
14002+ line="7424">the current line</doc>
1389314003 <type name="LayoutLine" c:type="PangoLayoutLine*"/>
1389414004 </return-value>
1389514005 <parameters>
1389614006 <instance-parameter name="iter" transfer-ownership="none">
1389714007 <doc xml:space="preserve"
1389814008 filename="pango/pango-layout.c"
13899- line="7396">a `PangoLayoutIter`</doc>
14009+ line="7416">a `PangoLayoutIter`</doc>
1390014010 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1390114011 </instance-parameter>
1390214012 </parameters>
@@ -13905,7 +14015,7 @@ glyph widths, etc.).</doc>
1390514015 c:identifier="pango_layout_iter_get_line_extents">
1390614016 <doc xml:space="preserve"
1390714017 filename="pango/pango-layout.c"
13908- line="7908">Obtains the extents of the current line.
14018+ line="7928">Obtains the extents of the current line.
1390914019
1391014020 Extents are in layout coordinates (origin is the top-left corner
1391114021 of the entire `PangoLayout`). Thus the extents returned by this
@@ -13919,7 +14029,7 @@ as the extents returned from [method@Pango.LayoutLine.get_extents].</doc>
1391914029 <instance-parameter name="iter" transfer-ownership="none">
1392014030 <doc xml:space="preserve"
1392114031 filename="pango/pango-layout.c"
13922- line="7910">a `PangoLayoutIter`</doc>
14032+ line="7930">a `PangoLayoutIter`</doc>
1392314033 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1392414034 </instance-parameter>
1392514035 <parameter name="ink_rect"
@@ -13930,7 +14040,7 @@ as the extents returned from [method@Pango.LayoutLine.get_extents].</doc>
1393014040 allow-none="1">
1393114041 <doc xml:space="preserve"
1393214042 filename="pango/pango-layout.c"
13933- line="7911">rectangle to fill with ink extents</doc>
14043+ line="7931">rectangle to fill with ink extents</doc>
1393414044 <type name="Rectangle" c:type="PangoRectangle*"/>
1393514045 </parameter>
1393614046 <parameter name="logical_rect"
@@ -13941,7 +14051,7 @@ as the extents returned from [method@Pango.LayoutLine.get_extents].</doc>
1394114051 allow-none="1">
1394214052 <doc xml:space="preserve"
1394314053 filename="pango/pango-layout.c"
13944- line="7912">rectangle to fill with logical extents</doc>
14054+ line="7932">rectangle to fill with logical extents</doc>
1394514055 <type name="Rectangle" c:type="PangoRectangle*"/>
1394614056 </parameter>
1394714057 </parameters>
@@ -13951,7 +14061,7 @@ as the extents returned from [method@Pango.LayoutLine.get_extents].</doc>
1395114061 version="1.16">
1395214062 <doc xml:space="preserve"
1395314063 filename="pango/pango-layout.c"
13954- line="7417">Gets the current line for read-only access.
14064+ line="7437">Gets the current line for read-only access.
1395514065
1395614066 This is a faster alternative to [method@Pango.LayoutIter.get_line],
1395714067 but the user is not expected to modify the contents of the line
@@ -13960,7 +14070,7 @@ but the user is not expected to modify the contents of the line
1396014070 <return-value transfer-ownership="none" nullable="1">
1396114071 <doc xml:space="preserve"
1396214072 filename="pango/pango-layout.c"
13963- line="7427">the current line, that should not be
14073+ line="7447">the current line, that should not be
1396414074 modified</doc>
1396514075 <type name="LayoutLine" c:type="PangoLayoutLine*"/>
1396614076 </return-value>
@@ -13968,7 +14078,7 @@ but the user is not expected to modify the contents of the line
1396814078 <instance-parameter name="iter" transfer-ownership="none">
1396914079 <doc xml:space="preserve"
1397014080 filename="pango/pango-layout.c"
13971- line="7419">a `PangoLayoutIter`</doc>
14081+ line="7439">a `PangoLayoutIter`</doc>
1397214082 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1397314083 </instance-parameter>
1397414084 </parameters>
@@ -13977,7 +14087,7 @@ but the user is not expected to modify the contents of the line
1397714087 c:identifier="pango_layout_iter_get_line_yrange">
1397814088 <doc xml:space="preserve"
1397914089 filename="pango/pango-layout.c"
13980- line="7947">Divides the vertical space in the `PangoLayout` being iterated over
14090+ line="7967">Divides the vertical space in the `PangoLayout` being iterated over
1398114091 between the lines in the layout, and returns the space belonging to
1398214092 the current line.
1398314093
@@ -13996,7 +14106,7 @@ may be gaps between the ranges returned by this function.</doc>
1399614106 <instance-parameter name="iter" transfer-ownership="none">
1399714107 <doc xml:space="preserve"
1399814108 filename="pango/pango-layout.c"
13999- line="7949">a `PangoLayoutIter`</doc>
14109+ line="7969">a `PangoLayoutIter`</doc>
1400014110 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1400114111 </instance-parameter>
1400214112 <parameter name="y0_"
@@ -14007,7 +14117,7 @@ may be gaps between the ranges returned by this function.</doc>
1400714117 allow-none="1">
1400814118 <doc xml:space="preserve"
1400914119 filename="pango/pango-layout.c"
14010- line="7950">start of line</doc>
14120+ line="7970">start of line</doc>
1401114121 <type name="gint" c:type="int*"/>
1401214122 </parameter>
1401314123 <parameter name="y1_"
@@ -14018,7 +14128,7 @@ may be gaps between the ranges returned by this function.</doc>
1401814128 allow-none="1">
1401914129 <doc xml:space="preserve"
1402014130 filename="pango/pango-layout.c"
14021- line="7951">end of line</doc>
14131+ line="7971">end of line</doc>
1402214132 <type name="gint" c:type="int*"/>
1402314133 </parameter>
1402414134 </parameters>
@@ -14026,7 +14136,7 @@ may be gaps between the ranges returned by this function.</doc>
1402614136 <method name="get_run" c:identifier="pango_layout_iter_get_run">
1402714137 <doc xml:space="preserve"
1402814138 filename="pango/pango-layout.c"
14029- line="7323">Gets the current run.
14139+ line="7343">Gets the current run.
1403014140
1403114141 When iterating by run, at the end of each line, there's a position
1403214142 with a %NULL run, so this function can return %NULL. The %NULL run
@@ -14039,14 +14149,14 @@ plan to modify the contents of the run (glyphs, glyph widths, etc.).</doc>
1403914149 <return-value transfer-ownership="none" nullable="1">
1404014150 <doc xml:space="preserve"
1404114151 filename="pango/pango-layout.c"
14042- line="7337">the current run</doc>
14152+ line="7357">the current run</doc>
1404314153 <type name="LayoutRun" c:type="PangoLayoutRun*"/>
1404414154 </return-value>
1404514155 <parameters>
1404614156 <instance-parameter name="iter" transfer-ownership="none">
1404714157 <doc xml:space="preserve"
1404814158 filename="pango/pango-layout.c"
14049- line="7325">a `PangoLayoutIter`</doc>
14159+ line="7345">a `PangoLayoutIter`</doc>
1405014160 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1405114161 </instance-parameter>
1405214162 </parameters>
@@ -14056,7 +14166,7 @@ plan to modify the contents of the run (glyphs, glyph widths, etc.).</doc>
1405614166 version="1.50">
1405714167 <doc xml:space="preserve"
1405814168 filename="pango/pango-layout.c"
14059- line="8024">Gets the Y position of the current run's baseline, in layout
14169+ line="8044">Gets the Y position of the current run's baseline, in layout
1406014170 coordinates.
1406114171
1406214172 Layout coordinates have the origin at the top left of the entire layout.
@@ -14071,7 +14181,7 @@ example due to superscript or subscript positioning.</doc>
1407114181 <instance-parameter name="iter" transfer-ownership="none">
1407214182 <doc xml:space="preserve"
1407314183 filename="pango/pango-layout.c"
14074- line="8026">a `PangoLayoutIter`</doc>
14184+ line="8046">a `PangoLayoutIter`</doc>
1407514185 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1407614186 </instance-parameter>
1407714187 </parameters>
@@ -14080,7 +14190,7 @@ example due to superscript or subscript positioning.</doc>
1408014190 c:identifier="pango_layout_iter_get_run_extents">
1408114191 <doc xml:space="preserve"
1408214192 filename="pango/pango-layout.c"
14083- line="7834">Gets the extents of the current run in layout coordinates.
14193+ line="7854">Gets the extents of the current run in layout coordinates.
1408414194
1408514195 Layout coordinates have the origin at the top left of the entire layout.</doc>
1408614196 <source-position filename="pango/pango-layout.h" line="533"/>
@@ -14091,7 +14201,7 @@ Layout coordinates have the origin at the top left of the entire layout.</doc>
1409114201 <instance-parameter name="iter" transfer-ownership="none">
1409214202 <doc xml:space="preserve"
1409314203 filename="pango/pango-layout.c"
14094- line="7836">a `PangoLayoutIter`</doc>
14204+ line="7856">a `PangoLayoutIter`</doc>
1409514205 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1409614206 </instance-parameter>
1409714207 <parameter name="ink_rect"
@@ -14102,7 +14212,7 @@ Layout coordinates have the origin at the top left of the entire layout.</doc>
1410214212 allow-none="1">
1410314213 <doc xml:space="preserve"
1410414214 filename="pango/pango-layout.c"
14105- line="7837">rectangle to fill with ink extents</doc>
14215+ line="7857">rectangle to fill with ink extents</doc>
1410614216 <type name="Rectangle" c:type="PangoRectangle*"/>
1410714217 </parameter>
1410814218 <parameter name="logical_rect"
@@ -14113,7 +14223,7 @@ Layout coordinates have the origin at the top left of the entire layout.</doc>
1411314223 allow-none="1">
1411414224 <doc xml:space="preserve"
1411514225 filename="pango/pango-layout.c"
14116- line="7838">rectangle to fill with logical extents</doc>
14226+ line="7858">rectangle to fill with logical extents</doc>
1411714227 <type name="Rectangle" c:type="PangoRectangle*"/>
1411814228 </parameter>
1411914229 </parameters>
@@ -14123,7 +14233,7 @@ Layout coordinates have the origin at the top left of the entire layout.</doc>
1412314233 version="1.16">
1412414234 <doc xml:space="preserve"
1412514235 filename="pango/pango-layout.c"
14126- line="7350">Gets the current run for read-only access.
14236+ line="7370">Gets the current run for read-only access.
1412714237
1412814238 When iterating by run, at the end of each line, there's a position
1412914239 with a %NULL run, so this function can return %NULL. The %NULL run
@@ -14137,7 +14247,7 @@ glyph widths, etc.).</doc>
1413714247 <return-value transfer-ownership="none" nullable="1">
1413814248 <doc xml:space="preserve"
1413914249 filename="pango/pango-layout.c"
14140- line="7365">the current run, that
14250+ line="7385">the current run, that
1414114251 should not be modified</doc>
1414214252 <type name="LayoutRun" c:type="PangoLayoutRun*"/>
1414314253 </return-value>
@@ -14145,7 +14255,7 @@ glyph widths, etc.).</doc>
1414514255 <instance-parameter name="iter" transfer-ownership="none">
1414614256 <doc xml:space="preserve"
1414714257 filename="pango/pango-layout.c"
14148- line="7352">a `PangoLayoutIter`</doc>
14258+ line="7372">a `PangoLayoutIter`</doc>
1414914259 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1415014260 </instance-parameter>
1415114261 </parameters>
@@ -14153,21 +14263,21 @@ glyph widths, etc.).</doc>
1415314263 <method name="next_char" c:identifier="pango_layout_iter_next_char">
1415414264 <doc xml:space="preserve"
1415514265 filename="pango/pango-layout.c"
14156- line="7580">Moves @iter forward to the next character in visual order.
14266+ line="7600">Moves @iter forward to the next character in visual order.
1415714267
1415814268 If @iter was already at the end of the layout, returns %FALSE.</doc>
1415914269 <source-position filename="pango/pango-layout.h" line="517"/>
1416014270 <return-value transfer-ownership="none">
1416114271 <doc xml:space="preserve"
1416214272 filename="pango/pango-layout.c"
14163- line="7588">whether motion was possible</doc>
14273+ line="7608">whether motion was possible</doc>
1416414274 <type name="gboolean" c:type="gboolean"/>
1416514275 </return-value>
1416614276 <parameters>
1416714277 <instance-parameter name="iter" transfer-ownership="none">
1416814278 <doc xml:space="preserve"
1416914279 filename="pango/pango-layout.c"
14170- line="7582">a `PangoLayoutIter`</doc>
14280+ line="7602">a `PangoLayoutIter`</doc>
1417114281 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1417214282 </instance-parameter>
1417314283 </parameters>
@@ -14176,21 +14286,21 @@ If @iter was already at the end of the layout, returns %FALSE.</doc>
1417614286 c:identifier="pango_layout_iter_next_cluster">
1417714287 <doc xml:space="preserve"
1417814288 filename="pango/pango-layout.c"
14179- line="7625">Moves @iter forward to the next cluster in visual order.
14289+ line="7645">Moves @iter forward to the next cluster in visual order.
1418014290
1418114291 If @iter was already at the end of the layout, returns %FALSE.</doc>
1418214292 <source-position filename="pango/pango-layout.h" line="519"/>
1418314293 <return-value transfer-ownership="none">
1418414294 <doc xml:space="preserve"
1418514295 filename="pango/pango-layout.c"
14186- line="7633">whether motion was possible</doc>
14296+ line="7653">whether motion was possible</doc>
1418714297 <type name="gboolean" c:type="gboolean"/>
1418814298 </return-value>
1418914299 <parameters>
1419014300 <instance-parameter name="iter" transfer-ownership="none">
1419114301 <doc xml:space="preserve"
1419214302 filename="pango/pango-layout.c"
14193- line="7627">a `PangoLayoutIter`</doc>
14303+ line="7647">a `PangoLayoutIter`</doc>
1419414304 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1419514305 </instance-parameter>
1419614306 </parameters>
@@ -14198,21 +14308,21 @@ If @iter was already at the end of the layout, returns %FALSE.</doc>
1419814308 <method name="next_line" c:identifier="pango_layout_iter_next_line">
1419914309 <doc xml:space="preserve"
1420014310 filename="pango/pango-layout.c"
14201- line="7686">Moves @iter forward to the start of the next line.
14311+ line="7706">Moves @iter forward to the start of the next line.
1420214312
1420314313 If @iter is already on the last line, returns %FALSE.</doc>
1420414314 <source-position filename="pango/pango-layout.h" line="523"/>
1420514315 <return-value transfer-ownership="none">
1420614316 <doc xml:space="preserve"
1420714317 filename="pango/pango-layout.c"
14208- line="7694">whether motion was possible</doc>
14318+ line="7714">whether motion was possible</doc>
1420914319 <type name="gboolean" c:type="gboolean"/>
1421014320 </return-value>
1421114321 <parameters>
1421214322 <instance-parameter name="iter" transfer-ownership="none">
1421314323 <doc xml:space="preserve"
1421414324 filename="pango/pango-layout.c"
14215- line="7688">a `PangoLayoutIter`</doc>
14325+ line="7708">a `PangoLayoutIter`</doc>
1421614326 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1421714327 </instance-parameter>
1421814328 </parameters>
@@ -14220,21 +14330,21 @@ If @iter is already on the last line, returns %FALSE.</doc>
1422014330 <method name="next_run" c:identifier="pango_layout_iter_next_run">
1422114331 <doc xml:space="preserve"
1422214332 filename="pango/pango-layout.c"
14223- line="7641">Moves @iter forward to the next run in visual order.
14333+ line="7661">Moves @iter forward to the next run in visual order.
1422414334
1422514335 If @iter was already at the end of the layout, returns %FALSE.</doc>
1422614336 <source-position filename="pango/pango-layout.h" line="521"/>
1422714337 <return-value transfer-ownership="none">
1422814338 <doc xml:space="preserve"
1422914339 filename="pango/pango-layout.c"
14230- line="7649">whether motion was possible</doc>
14340+ line="7669">whether motion was possible</doc>
1423114341 <type name="gboolean" c:type="gboolean"/>
1423214342 </return-value>
1423314343 <parameters>
1423414344 <instance-parameter name="iter" transfer-ownership="none">
1423514345 <doc xml:space="preserve"
1423614346 filename="pango/pango-layout.c"
14237- line="7643">a `PangoLayoutIter`</doc>
14347+ line="7663">a `PangoLayoutIter`</doc>
1423814348 <type name="LayoutIter" c:type="PangoLayoutIter*"/>
1423914349 </instance-parameter>
1424014350 </parameters>
@@ -14296,7 +14406,7 @@ attributes, or settings of the parent `PangoLayout` are modified.</doc>
1429614406 <method name="get_extents" c:identifier="pango_layout_line_get_extents">
1429714407 <doc xml:space="preserve"
1429814408 filename="pango/pango-layout.c"
14299- line="5914">Computes the logical and ink extents of a layout line.
14409+ line="5934">Computes the logical and ink extents of a layout line.
1430014410
1430114411 See [method@Pango.Font.get_glyph_extents] for details
1430214412 about the interpretation of the rectangles.</doc>
@@ -14308,7 +14418,7 @@ about the interpretation of the rectangles.</doc>
1430814418 <instance-parameter name="line" transfer-ownership="none">
1430914419 <doc xml:space="preserve"
1431014420 filename="pango/pango-layout.c"
14311- line="5916">a `PangoLayoutLine`</doc>
14421+ line="5936">a `PangoLayoutLine`</doc>
1431214422 <type name="LayoutLine" c:type="PangoLayoutLine*"/>
1431314423 </instance-parameter>
1431414424 <parameter name="ink_rect"
@@ -14319,7 +14429,7 @@ about the interpretation of the rectangles.</doc>
1431914429 allow-none="1">
1432014430 <doc xml:space="preserve"
1432114431 filename="pango/pango-layout.c"
14322- line="5917">rectangle used to store the extents of
14432+ line="5937">rectangle used to store the extents of
1432314433 the glyph string as drawn</doc>
1432414434 <type name="Rectangle" c:type="PangoRectangle*"/>
1432514435 </parameter>
@@ -14331,7 +14441,7 @@ about the interpretation of the rectangles.</doc>
1433114441 allow-none="1">
1433214442 <doc xml:space="preserve"
1433314443 filename="pango/pango-layout.c"
14334- line="5919">rectangle used to store the logical
14444+ line="5939">rectangle used to store the logical
1433514445 extents of the glyph string</doc>
1433614446 <type name="Rectangle" c:type="PangoRectangle*"/>
1433714447 </parameter>
@@ -14342,7 +14452,7 @@ about the interpretation of the rectangles.</doc>
1434214452 version="1.44">
1434314453 <doc xml:space="preserve"
1434414454 filename="pango/pango-layout.c"
14345- line="5935">Computes the height of the line, as the maximum of the heights
14455+ line="5955">Computes the height of the line, as the maximum of the heights
1434614456 of fonts used in this line.
1434714457
1434814458 Note that the actual baseline-to-baseline distance between lines
@@ -14357,7 +14467,7 @@ of text is influenced by other factors, such as
1435714467 <instance-parameter name="line" transfer-ownership="none">
1435814468 <doc xml:space="preserve"
1435914469 filename="pango/pango-layout.c"
14360- line="5937">a `PangoLayoutLine`</doc>
14470+ line="5957">a `PangoLayoutLine`</doc>
1436114471 <type name="LayoutLine" c:type="PangoLayoutLine*"/>
1436214472 </instance-parameter>
1436314473 <parameter name="height"
@@ -14368,7 +14478,7 @@ of text is influenced by other factors, such as
1436814478 allow-none="1">
1436914479 <doc xml:space="preserve"
1437014480 filename="pango/pango-layout.c"
14371- line="5938">return location for the line height</doc>
14481+ line="5958">return location for the line height</doc>
1437214482 <type name="gint" c:type="int*"/>
1437314483 </parameter>
1437414484 </parameters>
@@ -14378,19 +14488,19 @@ of text is influenced by other factors, such as
1437814488 version="1.50">
1437914489 <doc xml:space="preserve"
1438014490 filename="pango/pango-layout.c"
14381- line="5071">Returns the length of the line, in bytes.</doc>
14491+ line="5091">Returns the length of the line, in bytes.</doc>
1438214492 <source-position filename="pango/pango-layout.h" line="452"/>
1438314493 <return-value transfer-ownership="none">
1438414494 <doc xml:space="preserve"
1438514495 filename="pango/pango-layout.c"
14386- line="5077">the length of the line</doc>
14496+ line="5097">the length of the line</doc>
1438714497 <type name="gint" c:type="int"/>
1438814498 </return-value>
1438914499 <parameters>
1439014500 <instance-parameter name="line" transfer-ownership="none">
1439114501 <doc xml:space="preserve"
1439214502 filename="pango/pango-layout.c"
14393- line="5073">a `PangoLayoutLine`</doc>
14503+ line="5093">a `PangoLayoutLine`</doc>
1439414504 <type name="LayoutLine" c:type="PangoLayoutLine*"/>
1439514505 </instance-parameter>
1439614506 </parameters>
@@ -14399,7 +14509,7 @@ of text is influenced by other factors, such as
1439914509 c:identifier="pango_layout_line_get_pixel_extents">
1440014510 <doc xml:space="preserve"
1440114511 filename="pango/pango-layout.c"
14402- line="5974">Computes the logical and ink extents of @layout_line in device units.
14512+ line="5994">Computes the logical and ink extents of @layout_line in device units.
1440314513
1440414514 This function just calls [method@Pango.LayoutLine.get_extents] followed by
1440514515 two [func@extents_to_pixels] calls, rounding @ink_rect and @logical_rect
@@ -14413,7 +14523,7 @@ passes them as first argument to [func@extents_to_pixels]).</doc>
1441314523 <instance-parameter name="layout_line" transfer-ownership="none">
1441414524 <doc xml:space="preserve"
1441514525 filename="pango/pango-layout.c"
14416- line="5976">a `PangoLayoutLine`</doc>
14526+ line="5996">a `PangoLayoutLine`</doc>
1441714527 <type name="LayoutLine" c:type="PangoLayoutLine*"/>
1441814528 </instance-parameter>
1441914529 <parameter name="ink_rect"
@@ -14424,7 +14534,7 @@ passes them as first argument to [func@extents_to_pixels]).</doc>
1442414534 allow-none="1">
1442514535 <doc xml:space="preserve"
1442614536 filename="pango/pango-layout.c"
14427- line="5977">rectangle used to store the extents of
14537+ line="5997">rectangle used to store the extents of
1442814538 the glyph string as drawn</doc>
1442914539 <type name="Rectangle" c:type="PangoRectangle*"/>
1443014540 </parameter>
@@ -14436,7 +14546,7 @@ passes them as first argument to [func@extents_to_pixels]).</doc>
1443614546 allow-none="1">
1443714547 <doc xml:space="preserve"
1443814548 filename="pango/pango-layout.c"
14439- line="5979">rectangle used to store the logical
14549+ line="5999">rectangle used to store the logical
1444014550 extents of the glyph string</doc>
1444114551 <type name="Rectangle" c:type="PangoRectangle*"/>
1444214552 </parameter>
@@ -14447,19 +14557,19 @@ passes them as first argument to [func@extents_to_pixels]).</doc>
1444714557 version="1.50">
1444814558 <doc xml:space="preserve"
1444914559 filename="pango/pango-layout.c"
14450- line="5103">Returns the resolved direction of the line.</doc>
14560+ line="5123">Returns the resolved direction of the line.</doc>
1445114561 <source-position filename="pango/pango-layout.h" line="456"/>
1445214562 <return-value transfer-ownership="none">
1445314563 <doc xml:space="preserve"
1445414564 filename="pango/pango-layout.c"
14455- line="5109">the resolved direction of the line</doc>
14565+ line="5129">the resolved direction of the line</doc>
1445614566 <type name="Direction" c:type="PangoDirection"/>
1445714567 </return-value>
1445814568 <parameters>
1445914569 <instance-parameter name="line" transfer-ownership="none">
1446014570 <doc xml:space="preserve"
1446114571 filename="pango/pango-layout.c"
14462- line="5105">a `PangoLayoutLine`</doc>
14572+ line="5125">a `PangoLayoutLine`</doc>
1446314573 <type name="LayoutLine" c:type="PangoLayoutLine*"/>
1446414574 </instance-parameter>
1446514575 </parameters>
@@ -14469,20 +14579,20 @@ passes them as first argument to [func@extents_to_pixels]).</doc>
1446914579 version="1.50">
1447014580 <doc xml:space="preserve"
1447114581 filename="pango/pango-layout.c"
14472- line="5054">Returns the start index of the line, as byte index
14582+ line="5074">Returns the start index of the line, as byte index
1447314583 into the text of the layout.</doc>
1447414584 <source-position filename="pango/pango-layout.h" line="450"/>
1447514585 <return-value transfer-ownership="none">
1447614586 <doc xml:space="preserve"
1447714587 filename="pango/pango-layout.c"
14478- line="5061">the start index of the line</doc>
14588+ line="5081">the start index of the line</doc>
1447914589 <type name="gint" c:type="int"/>
1448014590 </return-value>
1448114591 <parameters>
1448214592 <instance-parameter name="line" transfer-ownership="none">
1448314593 <doc xml:space="preserve"
1448414594 filename="pango/pango-layout.c"
14485- line="5056">a `PangoLayoutLine`</doc>
14595+ line="5076">a `PangoLayoutLine`</doc>
1448614596 <type name="LayoutLine" c:type="PangoLayoutLine*"/>
1448714597 </instance-parameter>
1448814598 </parameters>
@@ -14491,7 +14601,7 @@ into the text of the layout.</doc>
1449114601 c:identifier="pango_layout_line_get_x_ranges">
1449214602 <doc xml:space="preserve"
1449314603 filename="pango/pango-layout.c"
14494- line="5338">Gets a list of visual ranges corresponding to a given logical range.
14604+ line="5358">Gets a list of visual ranges corresponding to a given logical range.
1449514605
1449614606 This list is not necessarily minimal - there may be consecutive
1449714607 ranges which are adjacent. The ranges will be sorted from left to
@@ -14505,13 +14615,13 @@ layout, not with respect to the line.</doc>
1450514615 <instance-parameter name="line" transfer-ownership="none">
1450614616 <doc xml:space="preserve"
1450714617 filename="pango/pango-layout.c"
14508- line="5340">a `PangoLayoutLine`</doc>
14618+ line="5360">a `PangoLayoutLine`</doc>
1450914619 <type name="LayoutLine" c:type="PangoLayoutLine*"/>
1451014620 </instance-parameter>
1451114621 <parameter name="start_index" transfer-ownership="none">
1451214622 <doc xml:space="preserve"
1451314623 filename="pango/pango-layout.c"
14514- line="5341">Start byte index of the logical range. If this value
14624+ line="5361">Start byte index of the logical range. If this value
1451514625 is less than the start index for the line, then the first range
1451614626 will extend all the way to the leading edge of the layout. Otherwise,
1451714627 it will start at the leading edge of the first character.</doc>
@@ -14520,7 +14630,7 @@ layout, not with respect to the line.</doc>
1452014630 <parameter name="end_index" transfer-ownership="none">
1452114631 <doc xml:space="preserve"
1452214632 filename="pango/pango-layout.c"
14523- line="5345">Ending byte index of the logical range. If this value is
14633+ line="5365">Ending byte index of the logical range. If this value is
1452414634 greater than the end index for the line, then the last range will
1452514635 extend all the way to the trailing edge of the layout. Otherwise,
1452614636 it will end at the trailing edge of the last character.</doc>
@@ -14532,7 +14642,7 @@ layout, not with respect to the line.</doc>
1453214642 transfer-ownership="full">
1453314643 <doc xml:space="preserve"
1453414644 filename="pango/pango-layout.c"
14535- line="5349">location to
14645+ line="5369">location to
1453614646 store a pointer to an array of ranges. The array will be of length
1453714647 `2*n_ranges`, with each range starting at `(*ranges)[2*n]` and of
1453814648 width `(*ranges)[2*n + 1] - (*ranges)[2*n]`. This array must be freed
@@ -14548,7 +14658,7 @@ layout, not with respect to the line.</doc>
1454814658 transfer-ownership="full">
1454914659 <doc xml:space="preserve"
1455014660 filename="pango/pango-layout.c"
14551- line="5355">The number of ranges stored in @ranges</doc>
14661+ line="5375">The number of ranges stored in @ranges</doc>
1455214662 <type name="gint" c:type="int*"/>
1455314663 </parameter>
1455414664 </parameters>
@@ -14598,19 +14708,19 @@ layout, not with respect to the line.</doc>
1459814708 version="1.50">
1459914709 <doc xml:space="preserve"
1460014710 filename="pango/pango-layout.c"
14601- line="5087">Returns whether this is the first line of the paragraph.</doc>
14711+ line="5107">Returns whether this is the first line of the paragraph.</doc>
1460214712 <source-position filename="pango/pango-layout.h" line="454"/>
1460314713 <return-value transfer-ownership="none">
1460414714 <doc xml:space="preserve"
1460514715 filename="pango/pango-layout.c"
14606- line="5093">%TRUE if this is the first line</doc>
14716+ line="5113">%TRUE if this is the first line</doc>
1460714717 <type name="gboolean" c:type="gboolean"/>
1460814718 </return-value>
1460914719 <parameters>
1461014720 <instance-parameter name="line" transfer-ownership="none">
1461114721 <doc xml:space="preserve"
1461214722 filename="pango/pango-layout.c"
14613- line="5089">a `PangoLayoutLine`</doc>
14723+ line="5109">a `PangoLayoutLine`</doc>
1461414724 <type name="LayoutLine" c:type="PangoLayoutLine*"/>
1461514725 </instance-parameter>
1461614726 </parameters>
@@ -14618,12 +14728,12 @@ layout, not with respect to the line.</doc>
1461814728 <method name="ref" c:identifier="pango_layout_line_ref" version="1.10">
1461914729 <doc xml:space="preserve"
1462014730 filename="pango/pango-layout.c"
14621- line="5000">Increase the reference count of a `PangoLayoutLine` by one.</doc>
14731+ line="5020">Increase the reference count of a `PangoLayoutLine` by one.</doc>
1462214732 <source-position filename="pango/pango-layout.h" line="445"/>
1462314733 <return-value transfer-ownership="full" nullable="1">
1462414734 <doc xml:space="preserve"
1462514735 filename="pango/pango-layout.c"
14626- line="5006">the line passed in.</doc>
14736+ line="5026">the line passed in.</doc>
1462714737 <type name="LayoutLine" c:type="PangoLayoutLine*"/>
1462814738 </return-value>
1462914739 <parameters>
@@ -14633,7 +14743,7 @@ layout, not with respect to the line.</doc>
1463314743 allow-none="1">
1463414744 <doc xml:space="preserve"
1463514745 filename="pango/pango-layout.c"
14636- line="5002">a `PangoLayoutLine`</doc>
14746+ line="5022">a `PangoLayoutLine`</doc>
1463714747 <type name="LayoutLine" c:type="PangoLayoutLine*"/>
1463814748 </instance-parameter>
1463914749 </parameters>
@@ -14641,7 +14751,7 @@ layout, not with respect to the line.</doc>
1464114751 <method name="unref" c:identifier="pango_layout_line_unref">
1464214752 <doc xml:space="preserve"
1464314753 filename="pango/pango-layout.c"
14644- line="5023">Decrease the reference count of a `PangoLayoutLine` by one.
14754+ line="5043">Decrease the reference count of a `PangoLayoutLine` by one.
1464514755
1464614756 If the result is zero, the line and all associated memory
1464714757 will be freed.</doc>
@@ -14653,7 +14763,7 @@ will be freed.</doc>
1465314763 <instance-parameter name="line" transfer-ownership="none">
1465414764 <doc xml:space="preserve"
1465514765 filename="pango/pango-layout.c"
14656- line="5025">a `PangoLayoutLine`</doc>
14766+ line="5045">a `PangoLayoutLine`</doc>
1465714767 <type name="LayoutLine" c:type="PangoLayoutLine*"/>
1465814768 </instance-parameter>
1465914769 </parameters>
@@ -14661,7 +14771,7 @@ will be freed.</doc>
1466114771 <method name="x_to_index" c:identifier="pango_layout_line_x_to_index">
1466214772 <doc xml:space="preserve"
1466314773 filename="pango/pango-layout.c"
14664- line="5119">Converts from x offset to the byte index of the corresponding character
14774+ line="5139">Converts from x offset to the byte index of the corresponding character
1466514775 within the text of the layout.
1466614776
1466714777 If @x_pos is outside the line, @index_ and @trailing will point to the very
@@ -14676,20 +14786,20 @@ grapheme. The reverse is true for a left-to-right line.</doc>
1467614786 <return-value transfer-ownership="none">
1467714787 <doc xml:space="preserve"
1467814788 filename="pango/pango-layout.c"
14679- line="5141">%FALSE if @x_pos was outside the line, %TRUE if inside</doc>
14789+ line="5161">%FALSE if @x_pos was outside the line, %TRUE if inside</doc>
1468014790 <type name="gboolean" c:type="gboolean"/>
1468114791 </return-value>
1468214792 <parameters>
1468314793 <instance-parameter name="line" transfer-ownership="none">
1468414794 <doc xml:space="preserve"
1468514795 filename="pango/pango-layout.c"
14686- line="5121">a `PangoLayoutLine`</doc>
14796+ line="5141">a `PangoLayoutLine`</doc>
1468714797 <type name="LayoutLine" c:type="PangoLayoutLine*"/>
1468814798 </instance-parameter>
1468914799 <parameter name="x_pos" transfer-ownership="none">
1469014800 <doc xml:space="preserve"
1469114801 filename="pango/pango-layout.c"
14692- line="5122">the X offset (in Pango units) from the left edge of the line.</doc>
14802+ line="5142">the X offset (in Pango units) from the left edge of the line.</doc>
1469314803 <type name="gint" c:type="int"/>
1469414804 </parameter>
1469514805 <parameter name="index_"
@@ -14698,7 +14808,7 @@ grapheme. The reverse is true for a left-to-right line.</doc>
1469814808 transfer-ownership="full">
1469914809 <doc xml:space="preserve"
1470014810 filename="pango/pango-layout.c"
14701- line="5123">location to store calculated byte index for the grapheme
14811+ line="5143">location to store calculated byte index for the grapheme
1470214812 in which the user clicked</doc>
1470314813 <type name="gint" c:type="int*"/>
1470414814 </parameter>
@@ -14708,7 +14818,7 @@ grapheme. The reverse is true for a left-to-right line.</doc>
1470814818 transfer-ownership="full">
1470914819 <doc xml:space="preserve"
1471014820 filename="pango/pango-layout.c"
14711- line="5125">location to store an integer indicating where in the
14821+ line="5145">location to store an integer indicating where in the
1471214822 grapheme the user clicked. It will either be zero, or the number of
1471314823 characters in the grapheme. 0 represents the leading edge of the grapheme.</doc>
1471414824 <type name="gint" c:type="int*"/>
@@ -15639,7 +15749,7 @@ backends and destinations can be created.</doc>
1563915749 version="1.8">
1564015750 <doc xml:space="preserve"
1564115751 filename="pango/pango-renderer.c"
15642- line="1015">Draw a squiggly line that approximately covers the given rectangle
15752+ line="1014">Draw a squiggly line that approximately covers the given rectangle
1564315753 in the style of an underline used to indicate a spelling error.
1564415754
1564515755 The width of the underline is rounded to an integer number
@@ -15656,31 +15766,31 @@ Use [method@Pango.Renderer.activate] to activate a renderer.</doc>
1565615766 <instance-parameter name="renderer" transfer-ownership="none">
1565715767 <doc xml:space="preserve"
1565815768 filename="pango/pango-renderer.c"
15659- line="1017">a `PangoRenderer`</doc>
15769+ line="1016">a `PangoRenderer`</doc>
1566015770 <type name="Renderer" c:type="PangoRenderer*"/>
1566115771 </instance-parameter>
1566215772 <parameter name="x" transfer-ownership="none">
1566315773 <doc xml:space="preserve"
1566415774 filename="pango/pango-renderer.c"
15665- line="1018">X coordinate of underline, in Pango units in user coordinate system</doc>
15775+ line="1017">X coordinate of underline, in Pango units in user coordinate system</doc>
1566615776 <type name="gint" c:type="int"/>
1566715777 </parameter>
1566815778 <parameter name="y" transfer-ownership="none">
1566915779 <doc xml:space="preserve"
1567015780 filename="pango/pango-renderer.c"
15671- line="1019">Y coordinate of underline, in Pango units in user coordinate system</doc>
15781+ line="1018">Y coordinate of underline, in Pango units in user coordinate system</doc>
1567215782 <type name="gint" c:type="int"/>
1567315783 </parameter>
1567415784 <parameter name="width" transfer-ownership="none">
1567515785 <doc xml:space="preserve"
1567615786 filename="pango/pango-renderer.c"
15677- line="1020">width of underline, in Pango units in user coordinate system</doc>
15787+ line="1019">width of underline, in Pango units in user coordinate system</doc>
1567815788 <type name="gint" c:type="int"/>
1567915789 </parameter>
1568015790 <parameter name="height" transfer-ownership="none">
1568115791 <doc xml:space="preserve"
1568215792 filename="pango/pango-renderer.c"
15683- line="1021">height of underline, in Pango units in user coordinate system</doc>
15793+ line="1020">height of underline, in Pango units in user coordinate system</doc>
1568415794 <type name="gint" c:type="int"/>
1568515795 </parameter>
1568615796 </parameters>
@@ -15688,7 +15798,7 @@ Use [method@Pango.Renderer.activate] to activate a renderer.</doc>
1568815798 <virtual-method name="draw_glyph" invoker="draw_glyph" version="1.8">
1568915799 <doc xml:space="preserve"
1569015800 filename="pango/pango-renderer.c"
15691- line="1210">Draws a single glyph with coordinates in device space.</doc>
15801+ line="1209">Draws a single glyph with coordinates in device space.</doc>
1569215802 <source-position filename="pango/pango-renderer.h" line="168"/>
1569315803 <return-value transfer-ownership="none">
1569415804 <type name="none" c:type="void"/>
@@ -15697,31 +15807,31 @@ Use [method@Pango.Renderer.activate] to activate a renderer.</doc>
1569715807 <instance-parameter name="renderer" transfer-ownership="none">
1569815808 <doc xml:space="preserve"
1569915809 filename="pango/pango-renderer.c"
15700- line="1212">a `PangoRenderer`</doc>
15810+ line="1211">a `PangoRenderer`</doc>
1570115811 <type name="Renderer" c:type="PangoRenderer*"/>
1570215812 </instance-parameter>
1570315813 <parameter name="font" transfer-ownership="none">
1570415814 <doc xml:space="preserve"
1570515815 filename="pango/pango-renderer.c"
15706- line="1213">a `PangoFont`</doc>
15816+ line="1212">a `PangoFont`</doc>
1570715817 <type name="Font" c:type="PangoFont*"/>
1570815818 </parameter>
1570915819 <parameter name="glyph" transfer-ownership="none">
1571015820 <doc xml:space="preserve"
1571115821 filename="pango/pango-renderer.c"
15712- line="1214">the glyph index of a single glyph</doc>
15822+ line="1213">the glyph index of a single glyph</doc>
1571315823 <type name="Glyph" c:type="PangoGlyph"/>
1571415824 </parameter>
1571515825 <parameter name="x" transfer-ownership="none">
1571615826 <doc xml:space="preserve"
1571715827 filename="pango/pango-renderer.c"
15718- line="1215">X coordinate of left edge of baseline of glyph</doc>
15828+ line="1214">X coordinate of left edge of baseline of glyph</doc>
1571915829 <type name="gdouble" c:type="double"/>
1572015830 </parameter>
1572115831 <parameter name="y" transfer-ownership="none">
1572215832 <doc xml:space="preserve"
1572315833 filename="pango/pango-renderer.c"
15724- line="1216">Y coordinate of left edge of baseline of glyph</doc>
15834+ line="1215">Y coordinate of left edge of baseline of glyph</doc>
1572515835 <type name="gdouble" c:type="double"/>
1572615836 </parameter>
1572715837 </parameters>
@@ -15731,7 +15841,7 @@ Use [method@Pango.Renderer.activate] to activate a renderer.</doc>
1573115841 version="1.22">
1573215842 <doc xml:space="preserve"
1573315843 filename="pango/pango-renderer.c"
15734- line="805">Draws the glyphs in @glyph_item with the specified `PangoRenderer`,
15844+ line="804">Draws the glyphs in @glyph_item with the specified `PangoRenderer`,
1573515845 embedding the text associated with the glyphs in the output if the
1573615846 output format supports it.
1573715847
@@ -15757,7 +15867,7 @@ The default implementation of this method simply falls back to
1575715867 <instance-parameter name="renderer" transfer-ownership="none">
1575815868 <doc xml:space="preserve"
1575915869 filename="pango/pango-renderer.c"
15760- line="807">a `PangoRenderer`</doc>
15870+ line="806">a `PangoRenderer`</doc>
1576115871 <type name="Renderer" c:type="PangoRenderer*"/>
1576215872 </instance-parameter>
1576315873 <parameter name="text"
@@ -15766,26 +15876,26 @@ The default implementation of this method simply falls back to
1576615876 allow-none="1">
1576715877 <doc xml:space="preserve"
1576815878 filename="pango/pango-renderer.c"
15769- line="808">the UTF-8 text that @glyph_item refers to</doc>
15879+ line="807">the UTF-8 text that @glyph_item refers to</doc>
1577015880 <type name="utf8" c:type="const char*"/>
1577115881 </parameter>
1577215882 <parameter name="glyph_item" transfer-ownership="none">
1577315883 <doc xml:space="preserve"
1577415884 filename="pango/pango-renderer.c"
15775- line="809">a `PangoGlyphItem`</doc>
15885+ line="808">a `PangoGlyphItem`</doc>
1577615886 <type name="GlyphItem" c:type="PangoGlyphItem*"/>
1577715887 </parameter>
1577815888 <parameter name="x" transfer-ownership="none">
1577915889 <doc xml:space="preserve"
1578015890 filename="pango/pango-renderer.c"
15781- line="810">X position of left edge of baseline, in user space coordinates
15891+ line="809">X position of left edge of baseline, in user space coordinates
1578215892 in Pango units</doc>
1578315893 <type name="gint" c:type="int"/>
1578415894 </parameter>
1578515895 <parameter name="y" transfer-ownership="none">
1578615896 <doc xml:space="preserve"
1578715897 filename="pango/pango-renderer.c"
15788- line="812">Y position of left edge of baseline, in user space coordinates
15898+ line="811">Y position of left edge of baseline, in user space coordinates
1578915899 in Pango units</doc>
1579015900 <type name="gint" c:type="int"/>
1579115901 </parameter>
@@ -15794,7 +15904,7 @@ The default implementation of this method simply falls back to
1579415904 <virtual-method name="draw_glyphs" invoker="draw_glyphs" version="1.8">
1579515905 <doc xml:space="preserve"
1579615906 filename="pango/pango-renderer.c"
15797- line="749">Draws the glyphs in @glyphs with the specified `PangoRenderer`.</doc>
15907+ line="748">Draws the glyphs in @glyphs with the specified `PangoRenderer`.</doc>
1579815908 <source-position filename="pango/pango-renderer.h" line="139"/>
1579915909 <return-value transfer-ownership="none">
1580015910 <type name="none" c:type="void"/>
@@ -15803,32 +15913,32 @@ The default implementation of this method simply falls back to
1580315913 <instance-parameter name="renderer" transfer-ownership="none">
1580415914 <doc xml:space="preserve"
1580515915 filename="pango/pango-renderer.c"
15806- line="751">a `PangoRenderer`</doc>
15916+ line="750">a `PangoRenderer`</doc>
1580715917 <type name="Renderer" c:type="PangoRenderer*"/>
1580815918 </instance-parameter>
1580915919 <parameter name="font" transfer-ownership="none">
1581015920 <doc xml:space="preserve"
1581115921 filename="pango/pango-renderer.c"
15812- line="752">a `PangoFont`</doc>
15922+ line="751">a `PangoFont`</doc>
1581315923 <type name="Font" c:type="PangoFont*"/>
1581415924 </parameter>
1581515925 <parameter name="glyphs" transfer-ownership="none">
1581615926 <doc xml:space="preserve"
1581715927 filename="pango/pango-renderer.c"
15818- line="753">a `PangoGlyphString`</doc>
15928+ line="752">a `PangoGlyphString`</doc>
1581915929 <type name="GlyphString" c:type="PangoGlyphString*"/>
1582015930 </parameter>
1582115931 <parameter name="x" transfer-ownership="none">
1582215932 <doc xml:space="preserve"
1582315933 filename="pango/pango-renderer.c"
15824- line="754">X position of left edge of baseline, in user space coordinates
15934+ line="753">X position of left edge of baseline, in user space coordinates
1582515935 in Pango units.</doc>
1582615936 <type name="gint" c:type="int"/>
1582715937 </parameter>
1582815938 <parameter name="y" transfer-ownership="none">
1582915939 <doc xml:space="preserve"
1583015940 filename="pango/pango-renderer.c"
15831- line="756">Y position of left edge of baseline, in user space coordinates
15941+ line="755">Y position of left edge of baseline, in user space coordinates
1583215942 in Pango units.</doc>
1583315943 <type name="gint" c:type="int"/>
1583415944 </parameter>
@@ -15839,7 +15949,7 @@ The default implementation of this method simply falls back to
1583915949 version="1.8">
1584015950 <doc xml:space="preserve"
1584115951 filename="pango/pango-renderer.c"
15842- line="874">Draws an axis-aligned rectangle in user space coordinates with the
15952+ line="873">Draws an axis-aligned rectangle in user space coordinates with the
1584315953 specified `PangoRenderer`.
1584415954
1584515955 This should be called while @renderer is already active.
@@ -15852,39 +15962,39 @@ Use [method@Pango.Renderer.activate] to activate a renderer.</doc>
1585215962 <instance-parameter name="renderer" transfer-ownership="none">
1585315963 <doc xml:space="preserve"
1585415964 filename="pango/pango-renderer.c"
15855- line="876">a `PangoRenderer`</doc>
15965+ line="875">a `PangoRenderer`</doc>
1585615966 <type name="Renderer" c:type="PangoRenderer*"/>
1585715967 </instance-parameter>
1585815968 <parameter name="part" transfer-ownership="none">
1585915969 <doc xml:space="preserve"
1586015970 filename="pango/pango-renderer.c"
15861- line="877">type of object this rectangle is part of</doc>
15971+ line="876">type of object this rectangle is part of</doc>
1586215972 <type name="RenderPart" c:type="PangoRenderPart"/>
1586315973 </parameter>
1586415974 <parameter name="x" transfer-ownership="none">
1586515975 <doc xml:space="preserve"
1586615976 filename="pango/pango-renderer.c"
15867- line="878">X position at which to draw rectangle, in user space coordinates
15977+ line="877">X position at which to draw rectangle, in user space coordinates
1586815978 in Pango units</doc>
1586915979 <type name="gint" c:type="int"/>
1587015980 </parameter>
1587115981 <parameter name="y" transfer-ownership="none">
1587215982 <doc xml:space="preserve"
1587315983 filename="pango/pango-renderer.c"
15874- line="880">Y position at which to draw rectangle, in user space coordinates
15984+ line="879">Y position at which to draw rectangle, in user space coordinates
1587515985 in Pango units</doc>
1587615986 <type name="gint" c:type="int"/>
1587715987 </parameter>
1587815988 <parameter name="width" transfer-ownership="none">
1587915989 <doc xml:space="preserve"
1588015990 filename="pango/pango-renderer.c"
15881- line="882">width of rectangle in Pango units</doc>
15991+ line="881">width of rectangle in Pango units</doc>
1588215992 <type name="gint" c:type="int"/>
1588315993 </parameter>
1588415994 <parameter name="height" transfer-ownership="none">
1588515995 <doc xml:space="preserve"
1588615996 filename="pango/pango-renderer.c"
15887- line="883">height of rectangle in Pango units</doc>
15997+ line="882">height of rectangle in Pango units</doc>
1588815998 <type name="gint" c:type="int"/>
1588915999 </parameter>
1589016000 </parameters>
@@ -15919,7 +16029,7 @@ Use [method@Pango.Renderer.activate] to activate a renderer.</doc>
1591916029 version="1.8">
1592016030 <doc xml:space="preserve"
1592116031 filename="pango/pango-renderer.c"
15922- line="1175">Draws a trapezoid with the parallel sides aligned with the X axis
16032+ line="1174">Draws a trapezoid with the parallel sides aligned with the X axis
1592316033 using the given `PangoRenderer`; coordinates are in device space.</doc>
1592416034 <source-position filename="pango/pango-renderer.h" line="160"/>
1592516035 <return-value transfer-ownership="none">
@@ -15929,49 +16039,49 @@ using the given `PangoRenderer`; coordinates are in device space.</doc>
1592916039 <instance-parameter name="renderer" transfer-ownership="none">
1593016040 <doc xml:space="preserve"
1593116041 filename="pango/pango-renderer.c"
15932- line="1177">a `PangoRenderer`</doc>
16042+ line="1176">a `PangoRenderer`</doc>
1593316043 <type name="Renderer" c:type="PangoRenderer*"/>
1593416044 </instance-parameter>
1593516045 <parameter name="part" transfer-ownership="none">
1593616046 <doc xml:space="preserve"
1593716047 filename="pango/pango-renderer.c"
15938- line="1178">type of object this trapezoid is part of</doc>
16048+ line="1177">type of object this trapezoid is part of</doc>
1593916049 <type name="RenderPart" c:type="PangoRenderPart"/>
1594016050 </parameter>
1594116051 <parameter name="y1_" transfer-ownership="none">
1594216052 <doc xml:space="preserve"
1594316053 filename="pango/pango-renderer.c"
15944- line="1179">Y coordinate of top of trapezoid</doc>
16054+ line="1178">Y coordinate of top of trapezoid</doc>
1594516055 <type name="gdouble" c:type="double"/>
1594616056 </parameter>
1594716057 <parameter name="x11" transfer-ownership="none">
1594816058 <doc xml:space="preserve"
1594916059 filename="pango/pango-renderer.c"
15950- line="1180">X coordinate of left end of top of trapezoid</doc>
16060+ line="1179">X coordinate of left end of top of trapezoid</doc>
1595116061 <type name="gdouble" c:type="double"/>
1595216062 </parameter>
1595316063 <parameter name="x21" transfer-ownership="none">
1595416064 <doc xml:space="preserve"
1595516065 filename="pango/pango-renderer.c"
15956- line="1181">X coordinate of right end of top of trapezoid</doc>
16066+ line="1180">X coordinate of right end of top of trapezoid</doc>
1595716067 <type name="gdouble" c:type="double"/>
1595816068 </parameter>
1595916069 <parameter name="y2" transfer-ownership="none">
1596016070 <doc xml:space="preserve"
1596116071 filename="pango/pango-renderer.c"
15962- line="1182">Y coordinate of bottom of trapezoid</doc>
16072+ line="1181">Y coordinate of bottom of trapezoid</doc>
1596316073 <type name="gdouble" c:type="double"/>
1596416074 </parameter>
1596516075 <parameter name="x12" transfer-ownership="none">
1596616076 <doc xml:space="preserve"
1596716077 filename="pango/pango-renderer.c"
15968- line="1183">X coordinate of left end of bottom of trapezoid</doc>
16078+ line="1182">X coordinate of left end of bottom of trapezoid</doc>
1596916079 <type name="gdouble" c:type="double"/>
1597016080 </parameter>
1597116081 <parameter name="x22" transfer-ownership="none">
1597216082 <doc xml:space="preserve"
1597316083 filename="pango/pango-renderer.c"
15974- line="1184">X coordinate of right end of bottom of trapezoid</doc>
16084+ line="1183">X coordinate of right end of bottom of trapezoid</doc>
1597516085 <type name="gdouble" c:type="double"/>
1597616086 </parameter>
1597716087 </parameters>
@@ -15993,7 +16103,7 @@ using the given `PangoRenderer`; coordinates are in device space.</doc>
1599316103 <virtual-method name="part_changed" invoker="part_changed" version="1.8">
1599416104 <doc xml:space="preserve"
1599516105 filename="pango/pango-renderer.c"
15996- line="1412">Informs Pango that the way that the rendering is done
16106+ line="1411">Informs Pango that the way that the rendering is done
1599716107 for @part has changed.
1599816108
1599916109 This should be called if the rendering changes in a way that would
@@ -16016,13 +16126,13 @@ changes to colors. (See [method@Pango.Renderer.set_color])</doc>
1601616126 <instance-parameter name="renderer" transfer-ownership="none">
1601716127 <doc xml:space="preserve"
1601816128 filename="pango/pango-renderer.c"
16019- line="1414">a `PangoRenderer`</doc>
16129+ line="1413">a `PangoRenderer`</doc>
1602016130 <type name="Renderer" c:type="PangoRenderer*"/>
1602116131 </instance-parameter>
1602216132 <parameter name="part" transfer-ownership="none">
1602316133 <doc xml:space="preserve"
1602416134 filename="pango/pango-renderer.c"
16025- line="1415">the part for which rendering has changed.</doc>
16135+ line="1414">the part for which rendering has changed.</doc>
1602616136 <type name="RenderPart" c:type="PangoRenderPart"/>
1602716137 </parameter>
1602816138 </parameters>
@@ -16049,7 +16159,7 @@ changes to colors. (See [method@Pango.Renderer.set_color])</doc>
1604916159 version="1.8">
1605016160 <doc xml:space="preserve"
1605116161 filename="pango/pango-renderer.c"
16052- line="1239">Does initial setup before rendering operations on @renderer.
16162+ line="1238">Does initial setup before rendering operations on @renderer.
1605316163
1605416164 [method@Pango.Renderer.deactivate] should be called when done drawing.
1605516165 Calls such as [method@Pango.Renderer.draw_layout] automatically
@@ -16066,7 +16176,7 @@ renderer will only be initialized and deinitialized once.</doc>
1606616176 <instance-parameter name="renderer" transfer-ownership="none">
1606716177 <doc xml:space="preserve"
1606816178 filename="pango/pango-renderer.c"
16069- line="1241">a `PangoRenderer`</doc>
16179+ line="1240">a `PangoRenderer`</doc>
1607016180 <type name="Renderer" c:type="PangoRenderer*"/>
1607116181 </instance-parameter>
1607216182 </parameters>
@@ -16076,7 +16186,7 @@ renderer will only be initialized and deinitialized once.</doc>
1607616186 version="1.8">
1607716187 <doc xml:space="preserve"
1607816188 filename="pango/pango-renderer.c"
16079- line="1268">Cleans up after rendering operations on @renderer.
16189+ line="1267">Cleans up after rendering operations on @renderer.
1608016190
1608116191 See docs for [method@Pango.Renderer.activate].</doc>
1608216192 <source-position filename="pango/pango-renderer.h" line="254"/>
@@ -16087,7 +16197,7 @@ See docs for [method@Pango.Renderer.activate].</doc>
1608716197 <instance-parameter name="renderer" transfer-ownership="none">
1608816198 <doc xml:space="preserve"
1608916199 filename="pango/pango-renderer.c"
16090- line="1270">a `PangoRenderer`</doc>
16200+ line="1269">a `PangoRenderer`</doc>
1609116201 <type name="Renderer" c:type="PangoRenderer*"/>
1609216202 </instance-parameter>
1609316203 </parameters>
@@ -16097,7 +16207,7 @@ See docs for [method@Pango.Renderer.activate].</doc>
1609716207 version="1.8">
1609816208 <doc xml:space="preserve"
1609916209 filename="pango/pango-renderer.c"
16100- line="1015">Draw a squiggly line that approximately covers the given rectangle
16210+ line="1014">Draw a squiggly line that approximately covers the given rectangle
1610116211 in the style of an underline used to indicate a spelling error.
1610216212
1610316213 The width of the underline is rounded to an integer number
@@ -16114,31 +16224,31 @@ Use [method@Pango.Renderer.activate] to activate a renderer.</doc>
1611416224 <instance-parameter name="renderer" transfer-ownership="none">
1611516225 <doc xml:space="preserve"
1611616226 filename="pango/pango-renderer.c"
16117- line="1017">a `PangoRenderer`</doc>
16227+ line="1016">a `PangoRenderer`</doc>
1611816228 <type name="Renderer" c:type="PangoRenderer*"/>
1611916229 </instance-parameter>
1612016230 <parameter name="x" transfer-ownership="none">
1612116231 <doc xml:space="preserve"
1612216232 filename="pango/pango-renderer.c"
16123- line="1018">X coordinate of underline, in Pango units in user coordinate system</doc>
16233+ line="1017">X coordinate of underline, in Pango units in user coordinate system</doc>
1612416234 <type name="gint" c:type="int"/>
1612516235 </parameter>
1612616236 <parameter name="y" transfer-ownership="none">
1612716237 <doc xml:space="preserve"
1612816238 filename="pango/pango-renderer.c"
16129- line="1019">Y coordinate of underline, in Pango units in user coordinate system</doc>
16239+ line="1018">Y coordinate of underline, in Pango units in user coordinate system</doc>
1613016240 <type name="gint" c:type="int"/>
1613116241 </parameter>
1613216242 <parameter name="width" transfer-ownership="none">
1613316243 <doc xml:space="preserve"
1613416244 filename="pango/pango-renderer.c"
16135- line="1020">width of underline, in Pango units in user coordinate system</doc>
16245+ line="1019">width of underline, in Pango units in user coordinate system</doc>
1613616246 <type name="gint" c:type="int"/>
1613716247 </parameter>
1613816248 <parameter name="height" transfer-ownership="none">
1613916249 <doc xml:space="preserve"
1614016250 filename="pango/pango-renderer.c"
16141- line="1021">height of underline, in Pango units in user coordinate system</doc>
16251+ line="1020">height of underline, in Pango units in user coordinate system</doc>
1614216252 <type name="gint" c:type="int"/>
1614316253 </parameter>
1614416254 </parameters>
@@ -16148,7 +16258,7 @@ Use [method@Pango.Renderer.activate] to activate a renderer.</doc>
1614816258 version="1.8">
1614916259 <doc xml:space="preserve"
1615016260 filename="pango/pango-renderer.c"
16151- line="1210">Draws a single glyph with coordinates in device space.</doc>
16261+ line="1209">Draws a single glyph with coordinates in device space.</doc>
1615216262 <source-position filename="pango/pango-renderer.h" line="245"/>
1615316263 <return-value transfer-ownership="none">
1615416264 <type name="none" c:type="void"/>
@@ -16157,31 +16267,31 @@ Use [method@Pango.Renderer.activate] to activate a renderer.</doc>
1615716267 <instance-parameter name="renderer" transfer-ownership="none">
1615816268 <doc xml:space="preserve"
1615916269 filename="pango/pango-renderer.c"
16160- line="1212">a `PangoRenderer`</doc>
16270+ line="1211">a `PangoRenderer`</doc>
1616116271 <type name="Renderer" c:type="PangoRenderer*"/>
1616216272 </instance-parameter>
1616316273 <parameter name="font" transfer-ownership="none">
1616416274 <doc xml:space="preserve"
1616516275 filename="pango/pango-renderer.c"
16166- line="1213">a `PangoFont`</doc>
16276+ line="1212">a `PangoFont`</doc>
1616716277 <type name="Font" c:type="PangoFont*"/>
1616816278 </parameter>
1616916279 <parameter name="glyph" transfer-ownership="none">
1617016280 <doc xml:space="preserve"
1617116281 filename="pango/pango-renderer.c"
16172- line="1214">the glyph index of a single glyph</doc>
16282+ line="1213">the glyph index of a single glyph</doc>
1617316283 <type name="Glyph" c:type="PangoGlyph"/>
1617416284 </parameter>
1617516285 <parameter name="x" transfer-ownership="none">
1617616286 <doc xml:space="preserve"
1617716287 filename="pango/pango-renderer.c"
16178- line="1215">X coordinate of left edge of baseline of glyph</doc>
16288+ line="1214">X coordinate of left edge of baseline of glyph</doc>
1617916289 <type name="gdouble" c:type="double"/>
1618016290 </parameter>
1618116291 <parameter name="y" transfer-ownership="none">
1618216292 <doc xml:space="preserve"
1618316293 filename="pango/pango-renderer.c"
16184- line="1216">Y coordinate of left edge of baseline of glyph</doc>
16294+ line="1215">Y coordinate of left edge of baseline of glyph</doc>
1618516295 <type name="gdouble" c:type="double"/>
1618616296 </parameter>
1618716297 </parameters>
@@ -16191,7 +16301,7 @@ Use [method@Pango.Renderer.activate] to activate a renderer.</doc>
1619116301 version="1.22">
1619216302 <doc xml:space="preserve"
1619316303 filename="pango/pango-renderer.c"
16194- line="805">Draws the glyphs in @glyph_item with the specified `PangoRenderer`,
16304+ line="804">Draws the glyphs in @glyph_item with the specified `PangoRenderer`,
1619516305 embedding the text associated with the glyphs in the output if the
1619616306 output format supports it.
1619716307
@@ -16217,7 +16327,7 @@ The default implementation of this method simply falls back to
1621716327 <instance-parameter name="renderer" transfer-ownership="none">
1621816328 <doc xml:space="preserve"
1621916329 filename="pango/pango-renderer.c"
16220- line="807">a `PangoRenderer`</doc>
16330+ line="806">a `PangoRenderer`</doc>
1622116331 <type name="Renderer" c:type="PangoRenderer*"/>
1622216332 </instance-parameter>
1622316333 <parameter name="text"
@@ -16226,26 +16336,26 @@ The default implementation of this method simply falls back to
1622616336 allow-none="1">
1622716337 <doc xml:space="preserve"
1622816338 filename="pango/pango-renderer.c"
16229- line="808">the UTF-8 text that @glyph_item refers to</doc>
16339+ line="807">the UTF-8 text that @glyph_item refers to</doc>
1623016340 <type name="utf8" c:type="const char*"/>
1623116341 </parameter>
1623216342 <parameter name="glyph_item" transfer-ownership="none">
1623316343 <doc xml:space="preserve"
1623416344 filename="pango/pango-renderer.c"
16235- line="809">a `PangoGlyphItem`</doc>
16345+ line="808">a `PangoGlyphItem`</doc>
1623616346 <type name="GlyphItem" c:type="PangoGlyphItem*"/>
1623716347 </parameter>
1623816348 <parameter name="x" transfer-ownership="none">
1623916349 <doc xml:space="preserve"
1624016350 filename="pango/pango-renderer.c"
16241- line="810">X position of left edge of baseline, in user space coordinates
16351+ line="809">X position of left edge of baseline, in user space coordinates
1624216352 in Pango units</doc>
1624316353 <type name="gint" c:type="int"/>
1624416354 </parameter>
1624516355 <parameter name="y" transfer-ownership="none">
1624616356 <doc xml:space="preserve"
1624716357 filename="pango/pango-renderer.c"
16248- line="812">Y position of left edge of baseline, in user space coordinates
16358+ line="811">Y position of left edge of baseline, in user space coordinates
1624916359 in Pango units</doc>
1625016360 <type name="gint" c:type="int"/>
1625116361 </parameter>
@@ -16256,7 +16366,7 @@ The default implementation of this method simply falls back to
1625616366 version="1.8">
1625716367 <doc xml:space="preserve"
1625816368 filename="pango/pango-renderer.c"
16259- line="749">Draws the glyphs in @glyphs with the specified `PangoRenderer`.</doc>
16369+ line="748">Draws the glyphs in @glyphs with the specified `PangoRenderer`.</doc>
1626016370 <source-position filename="pango/pango-renderer.h" line="211"/>
1626116371 <return-value transfer-ownership="none">
1626216372 <type name="none" c:type="void"/>
@@ -16265,32 +16375,32 @@ The default implementation of this method simply falls back to
1626516375 <instance-parameter name="renderer" transfer-ownership="none">
1626616376 <doc xml:space="preserve"
1626716377 filename="pango/pango-renderer.c"
16268- line="751">a `PangoRenderer`</doc>
16378+ line="750">a `PangoRenderer`</doc>
1626916379 <type name="Renderer" c:type="PangoRenderer*"/>
1627016380 </instance-parameter>
1627116381 <parameter name="font" transfer-ownership="none">
1627216382 <doc xml:space="preserve"
1627316383 filename="pango/pango-renderer.c"
16274- line="752">a `PangoFont`</doc>
16384+ line="751">a `PangoFont`</doc>
1627516385 <type name="Font" c:type="PangoFont*"/>
1627616386 </parameter>
1627716387 <parameter name="glyphs" transfer-ownership="none">
1627816388 <doc xml:space="preserve"
1627916389 filename="pango/pango-renderer.c"
16280- line="753">a `PangoGlyphString`</doc>
16390+ line="752">a `PangoGlyphString`</doc>
1628116391 <type name="GlyphString" c:type="PangoGlyphString*"/>
1628216392 </parameter>
1628316393 <parameter name="x" transfer-ownership="none">
1628416394 <doc xml:space="preserve"
1628516395 filename="pango/pango-renderer.c"
16286- line="754">X position of left edge of baseline, in user space coordinates
16396+ line="753">X position of left edge of baseline, in user space coordinates
1628716397 in Pango units.</doc>
1628816398 <type name="gint" c:type="int"/>
1628916399 </parameter>
1629016400 <parameter name="y" transfer-ownership="none">
1629116401 <doc xml:space="preserve"
1629216402 filename="pango/pango-renderer.c"
16293- line="756">Y position of left edge of baseline, in user space coordinates
16403+ line="755">Y position of left edge of baseline, in user space coordinates
1629416404 in Pango units.</doc>
1629516405 <type name="gint" c:type="int"/>
1629616406 </parameter>
@@ -16301,7 +16411,7 @@ The default implementation of this method simply falls back to
1630116411 version="1.8">
1630216412 <doc xml:space="preserve"
1630316413 filename="pango/pango-renderer.c"
16304- line="149">Draws @layout with the specified `PangoRenderer`.
16414+ line="148">Draws @layout with the specified `PangoRenderer`.
1630516415
1630616416 This is equivalent to drawing the lines of the layout, at their
1630716417 respective positions relative to @x, @y.</doc>
@@ -16313,26 +16423,26 @@ respective positions relative to @x, @y.</doc>
1631316423 <instance-parameter name="renderer" transfer-ownership="none">
1631416424 <doc xml:space="preserve"
1631516425 filename="pango/pango-renderer.c"
16316- line="151">a `PangoRenderer`</doc>
16426+ line="150">a `PangoRenderer`</doc>
1631716427 <type name="Renderer" c:type="PangoRenderer*"/>
1631816428 </instance-parameter>
1631916429 <parameter name="layout" transfer-ownership="none">
1632016430 <doc xml:space="preserve"
1632116431 filename="pango/pango-renderer.c"
16322- line="152">a `PangoLayout`</doc>
16432+ line="151">a `PangoLayout`</doc>
1632316433 <type name="Layout" c:type="PangoLayout*"/>
1632416434 </parameter>
1632516435 <parameter name="x" transfer-ownership="none">
1632616436 <doc xml:space="preserve"
1632716437 filename="pango/pango-renderer.c"
16328- line="153">X position of left edge of baseline, in user space coordinates
16438+ line="152">X position of left edge of baseline, in user space coordinates
1632916439 in Pango units.</doc>
1633016440 <type name="gint" c:type="int"/>
1633116441 </parameter>
1633216442 <parameter name="y" transfer-ownership="none">
1633316443 <doc xml:space="preserve"
1633416444 filename="pango/pango-renderer.c"
16335- line="155">Y position of left edge of baseline, in user space coordinates
16445+ line="154">Y position of left edge of baseline, in user space coordinates
1633616446 in Pango units.</doc>
1633716447 <type name="gint" c:type="int"/>
1633816448 </parameter>
@@ -16343,7 +16453,7 @@ respective positions relative to @x, @y.</doc>
1634316453 version="1.8">
1634416454 <doc xml:space="preserve"
1634516455 filename="pango/pango-renderer.c"
16346- line="553">Draws @line with the specified `PangoRenderer`.
16456+ line="552">Draws @line with the specified `PangoRenderer`.
1634716457
1634816458 This draws the glyph items that make up the line, as well as
1634916459 shapes, backgrounds and lines that are specified by the attributes
@@ -16356,26 +16466,26 @@ of those items.</doc>
1635616466 <instance-parameter name="renderer" transfer-ownership="none">
1635716467 <doc xml:space="preserve"
1635816468 filename="pango/pango-renderer.c"
16359- line="555">a `PangoRenderer`</doc>
16469+ line="554">a `PangoRenderer`</doc>
1636016470 <type name="Renderer" c:type="PangoRenderer*"/>
1636116471 </instance-parameter>
1636216472 <parameter name="line" transfer-ownership="none">
1636316473 <doc xml:space="preserve"
1636416474 filename="pango/pango-renderer.c"
16365- line="556">a `PangoLayoutLine`</doc>
16475+ line="555">a `PangoLayoutLine`</doc>
1636616476 <type name="LayoutLine" c:type="PangoLayoutLine*"/>
1636716477 </parameter>
1636816478 <parameter name="x" transfer-ownership="none">
1636916479 <doc xml:space="preserve"
1637016480 filename="pango/pango-renderer.c"
16371- line="557">X position of left edge of baseline, in user space coordinates
16481+ line="556">X position of left edge of baseline, in user space coordinates
1637216482 in Pango units.</doc>
1637316483 <type name="gint" c:type="int"/>
1637416484 </parameter>
1637516485 <parameter name="y" transfer-ownership="none">
1637616486 <doc xml:space="preserve"
1637716487 filename="pango/pango-renderer.c"
16378- line="559">Y position of left edge of baseline, in user space coordinates
16488+ line="558">Y position of left edge of baseline, in user space coordinates
1637916489 in Pango units.</doc>
1638016490 <type name="gint" c:type="int"/>
1638116491 </parameter>
@@ -16386,7 +16496,7 @@ of those items.</doc>
1638616496 version="1.8">
1638716497 <doc xml:space="preserve"
1638816498 filename="pango/pango-renderer.c"
16389- line="874">Draws an axis-aligned rectangle in user space coordinates with the
16499+ line="873">Draws an axis-aligned rectangle in user space coordinates with the
1639016500 specified `PangoRenderer`.
1639116501
1639216502 This should be called while @renderer is already active.
@@ -16399,39 +16509,39 @@ Use [method@Pango.Renderer.activate] to activate a renderer.</doc>
1639916509 <instance-parameter name="renderer" transfer-ownership="none">
1640016510 <doc xml:space="preserve"
1640116511 filename="pango/pango-renderer.c"
16402- line="876">a `PangoRenderer`</doc>
16512+ line="875">a `PangoRenderer`</doc>
1640316513 <type name="Renderer" c:type="PangoRenderer*"/>
1640416514 </instance-parameter>
1640516515 <parameter name="part" transfer-ownership="none">
1640616516 <doc xml:space="preserve"
1640716517 filename="pango/pango-renderer.c"
16408- line="877">type of object this rectangle is part of</doc>
16518+ line="876">type of object this rectangle is part of</doc>
1640916519 <type name="RenderPart" c:type="PangoRenderPart"/>
1641016520 </parameter>
1641116521 <parameter name="x" transfer-ownership="none">
1641216522 <doc xml:space="preserve"
1641316523 filename="pango/pango-renderer.c"
16414- line="878">X position at which to draw rectangle, in user space coordinates
16524+ line="877">X position at which to draw rectangle, in user space coordinates
1641516525 in Pango units</doc>
1641616526 <type name="gint" c:type="int"/>
1641716527 </parameter>
1641816528 <parameter name="y" transfer-ownership="none">
1641916529 <doc xml:space="preserve"
1642016530 filename="pango/pango-renderer.c"
16421- line="880">Y position at which to draw rectangle, in user space coordinates
16531+ line="879">Y position at which to draw rectangle, in user space coordinates
1642216532 in Pango units</doc>
1642316533 <type name="gint" c:type="int"/>
1642416534 </parameter>
1642516535 <parameter name="width" transfer-ownership="none">
1642616536 <doc xml:space="preserve"
1642716537 filename="pango/pango-renderer.c"
16428- line="882">width of rectangle in Pango units</doc>
16538+ line="881">width of rectangle in Pango units</doc>
1642916539 <type name="gint" c:type="int"/>
1643016540 </parameter>
1643116541 <parameter name="height" transfer-ownership="none">
1643216542 <doc xml:space="preserve"
1643316543 filename="pango/pango-renderer.c"
16434- line="883">height of rectangle in Pango units</doc>
16544+ line="882">height of rectangle in Pango units</doc>
1643516545 <type name="gint" c:type="int"/>
1643616546 </parameter>
1643716547 </parameters>
@@ -16441,7 +16551,7 @@ Use [method@Pango.Renderer.activate] to activate a renderer.</doc>
1644116551 version="1.8">
1644216552 <doc xml:space="preserve"
1644316553 filename="pango/pango-renderer.c"
16444- line="1175">Draws a trapezoid with the parallel sides aligned with the X axis
16554+ line="1174">Draws a trapezoid with the parallel sides aligned with the X axis
1644516555 using the given `PangoRenderer`; coordinates are in device space.</doc>
1644616556 <source-position filename="pango/pango-renderer.h" line="236"/>
1644716557 <return-value transfer-ownership="none">
@@ -16451,49 +16561,49 @@ using the given `PangoRenderer`; coordinates are in device space.</doc>
1645116561 <instance-parameter name="renderer" transfer-ownership="none">
1645216562 <doc xml:space="preserve"
1645316563 filename="pango/pango-renderer.c"
16454- line="1177">a `PangoRenderer`</doc>
16564+ line="1176">a `PangoRenderer`</doc>
1645516565 <type name="Renderer" c:type="PangoRenderer*"/>
1645616566 </instance-parameter>
1645716567 <parameter name="part" transfer-ownership="none">
1645816568 <doc xml:space="preserve"
1645916569 filename="pango/pango-renderer.c"
16460- line="1178">type of object this trapezoid is part of</doc>
16570+ line="1177">type of object this trapezoid is part of</doc>
1646116571 <type name="RenderPart" c:type="PangoRenderPart"/>
1646216572 </parameter>
1646316573 <parameter name="y1_" transfer-ownership="none">
1646416574 <doc xml:space="preserve"
1646516575 filename="pango/pango-renderer.c"
16466- line="1179">Y coordinate of top of trapezoid</doc>
16576+ line="1178">Y coordinate of top of trapezoid</doc>
1646716577 <type name="gdouble" c:type="double"/>
1646816578 </parameter>
1646916579 <parameter name="x11" transfer-ownership="none">
1647016580 <doc xml:space="preserve"
1647116581 filename="pango/pango-renderer.c"
16472- line="1180">X coordinate of left end of top of trapezoid</doc>
16582+ line="1179">X coordinate of left end of top of trapezoid</doc>
1647316583 <type name="gdouble" c:type="double"/>
1647416584 </parameter>
1647516585 <parameter name="x21" transfer-ownership="none">
1647616586 <doc xml:space="preserve"
1647716587 filename="pango/pango-renderer.c"
16478- line="1181">X coordinate of right end of top of trapezoid</doc>
16588+ line="1180">X coordinate of right end of top of trapezoid</doc>
1647916589 <type name="gdouble" c:type="double"/>
1648016590 </parameter>
1648116591 <parameter name="y2" transfer-ownership="none">
1648216592 <doc xml:space="preserve"
1648316593 filename="pango/pango-renderer.c"
16484- line="1182">Y coordinate of bottom of trapezoid</doc>
16594+ line="1181">Y coordinate of bottom of trapezoid</doc>
1648516595 <type name="gdouble" c:type="double"/>
1648616596 </parameter>
1648716597 <parameter name="x12" transfer-ownership="none">
1648816598 <doc xml:space="preserve"
1648916599 filename="pango/pango-renderer.c"
16490- line="1183">X coordinate of left end of bottom of trapezoid</doc>
16600+ line="1182">X coordinate of left end of bottom of trapezoid</doc>
1649116601 <type name="gdouble" c:type="double"/>
1649216602 </parameter>
1649316603 <parameter name="x22" transfer-ownership="none">
1649416604 <doc xml:space="preserve"
1649516605 filename="pango/pango-renderer.c"
16496- line="1184">X coordinate of right end of bottom of trapezoid</doc>
16606+ line="1183">X coordinate of right end of bottom of trapezoid</doc>
1649716607 <type name="gdouble" c:type="double"/>
1649816608 </parameter>
1649916609 </parameters>
@@ -16503,12 +16613,12 @@ using the given `PangoRenderer`; coordinates are in device space.</doc>
1650316613 version="1.38">
1650416614 <doc xml:space="preserve"
1650516615 filename="pango/pango-renderer.c"
16506- line="1389">Gets the current alpha for the specified part.</doc>
16616+ line="1388">Gets the current alpha for the specified part.</doc>
1650716617 <source-position filename="pango/pango-renderer.h" line="273"/>
1650816618 <return-value transfer-ownership="none">
1650916619 <doc xml:space="preserve"
1651016620 filename="pango/pango-renderer.c"
16511- line="1396">the alpha for the specified part,
16621+ line="1395">the alpha for the specified part,
1651216622 or 0 if it hasn't been set and should be
1651316623 inherited from the environment.</doc>
1651416624 <type name="guint16" c:type="guint16"/>
@@ -16517,13 +16627,13 @@ using the given `PangoRenderer`; coordinates are in device space.</doc>
1651716627 <instance-parameter name="renderer" transfer-ownership="none">
1651816628 <doc xml:space="preserve"
1651916629 filename="pango/pango-renderer.c"
16520- line="1391">a `PangoRenderer`</doc>
16630+ line="1390">a `PangoRenderer`</doc>
1652116631 <type name="Renderer" c:type="PangoRenderer*"/>
1652216632 </instance-parameter>
1652316633 <parameter name="part" transfer-ownership="none">
1652416634 <doc xml:space="preserve"
1652516635 filename="pango/pango-renderer.c"
16526- line="1392">the part to get the alpha for</doc>
16636+ line="1391">the part to get the alpha for</doc>
1652716637 <type name="RenderPart" c:type="PangoRenderPart"/>
1652816638 </parameter>
1652916639 </parameters>
@@ -16533,12 +16643,12 @@ using the given `PangoRenderer`; coordinates are in device space.</doc>
1653316643 version="1.8">
1653416644 <doc xml:space="preserve"
1653516645 filename="pango/pango-renderer.c"
16536- line="1332">Gets the current rendering color for the specified part.</doc>
16646+ line="1331">Gets the current rendering color for the specified part.</doc>
1653716647 <source-position filename="pango/pango-renderer.h" line="265"/>
1653816648 <return-value transfer-ownership="none" nullable="1">
1653916649 <doc xml:space="preserve"
1654016650 filename="pango/pango-renderer.c"
16541- line="1339">the color for the
16651+ line="1338">the color for the
1654216652 specified part, or %NULL if it hasn't been set and should be
1654316653 inherited from the environment.</doc>
1654416654 <type name="Color" c:type="PangoColor*"/>
@@ -16547,13 +16657,13 @@ using the given `PangoRenderer`; coordinates are in device space.</doc>
1654716657 <instance-parameter name="renderer" transfer-ownership="none">
1654816658 <doc xml:space="preserve"
1654916659 filename="pango/pango-renderer.c"
16550- line="1334">a `PangoRenderer`</doc>
16660+ line="1333">a `PangoRenderer`</doc>
1655116661 <type name="Renderer" c:type="PangoRenderer*"/>
1655216662 </instance-parameter>
1655316663 <parameter name="part" transfer-ownership="none">
1655416664 <doc xml:space="preserve"
1655516665 filename="pango/pango-renderer.c"
16556- line="1335">the part to get the color for</doc>
16666+ line="1334">the part to get the color for</doc>
1655716667 <type name="RenderPart" c:type="PangoRenderPart"/>
1655816668 </parameter>
1655916669 </parameters>
@@ -16563,7 +16673,7 @@ using the given `PangoRenderer`; coordinates are in device space.</doc>
1656316673 version="1.20">
1656416674 <doc xml:space="preserve"
1656516675 filename="pango/pango-renderer.c"
16566- line="1600">Gets the layout currently being rendered using @renderer.
16676+ line="1599">Gets the layout currently being rendered using @renderer.
1656716677
1656816678 Calling this function only makes sense from inside a subclass's
1656916679 methods, like in its draw_shape vfunc, for example.
@@ -16574,7 +16684,7 @@ rendered.</doc>
1657416684 <return-value transfer-ownership="none" nullable="1">
1657516685 <doc xml:space="preserve"
1657616686 filename="pango/pango-renderer.c"
16577- line="1612">the layout, or %NULL if
16687+ line="1611">the layout, or %NULL if
1657816688 no layout is being rendered using @renderer at this time.</doc>
1657916689 <type name="Layout" c:type="PangoLayout*"/>
1658016690 </return-value>
@@ -16582,7 +16692,7 @@ rendered.</doc>
1658216692 <instance-parameter name="renderer" transfer-ownership="none">
1658316693 <doc xml:space="preserve"
1658416694 filename="pango/pango-renderer.c"
16585- line="1602">a `PangoRenderer`</doc>
16695+ line="1601">a `PangoRenderer`</doc>
1658616696 <type name="Renderer" c:type="PangoRenderer*"/>
1658716697 </instance-parameter>
1658816698 </parameters>
@@ -16592,7 +16702,7 @@ rendered.</doc>
1659216702 version="1.20">
1659316703 <doc xml:space="preserve"
1659416704 filename="pango/pango-renderer.c"
16595- line="1626">Gets the layout line currently being rendered using @renderer.
16705+ line="1625">Gets the layout line currently being rendered using @renderer.
1659616706
1659716707 Calling this function only makes sense from inside a subclass's
1659816708 methods, like in its draw_shape vfunc, for example.
@@ -16603,7 +16713,7 @@ rendered.</doc>
1660316713 <return-value transfer-ownership="none" nullable="1">
1660416714 <doc xml:space="preserve"
1660516715 filename="pango/pango-renderer.c"
16606- line="1638">the layout line, or %NULL
16716+ line="1637">the layout line, or %NULL
1660716717 if no layout line is being rendered using @renderer at this time.</doc>
1660816718 <type name="LayoutLine" c:type="PangoLayoutLine*"/>
1660916719 </return-value>
@@ -16611,7 +16721,7 @@ rendered.</doc>
1661116721 <instance-parameter name="renderer" transfer-ownership="none">
1661216722 <doc xml:space="preserve"
1661316723 filename="pango/pango-renderer.c"
16614- line="1628">a `PangoRenderer`</doc>
16724+ line="1627">a `PangoRenderer`</doc>
1661516725 <type name="Renderer" c:type="PangoRenderer*"/>
1661616726 </instance-parameter>
1661716727 </parameters>
@@ -16621,7 +16731,7 @@ rendered.</doc>
1662116731 version="1.8">
1662216732 <doc xml:space="preserve"
1662316733 filename="pango/pango-renderer.c"
16624- line="1577">Gets the transformation matrix that will be applied when
16734+ line="1576">Gets the transformation matrix that will be applied when
1662516735 rendering.
1662616736
1662716737 See [method@Pango.Renderer.set_matrix].</doc>
@@ -16629,7 +16739,7 @@ See [method@Pango.Renderer.set_matrix].</doc>
1662916739 <return-value transfer-ownership="none" nullable="1">
1663016740 <doc xml:space="preserve"
1663116741 filename="pango/pango-renderer.c"
16632- line="1586">the matrix, or %NULL if no matrix has
16742+ line="1585">the matrix, or %NULL if no matrix has
1663316743 been set (which is the same as the identity matrix). The returned
1663416744 matrix is owned by Pango and must not be modified or freed.</doc>
1663516745 <type name="Matrix" c:type="const PangoMatrix*"/>
@@ -16638,7 +16748,7 @@ See [method@Pango.Renderer.set_matrix].</doc>
1663816748 <instance-parameter name="renderer" transfer-ownership="none">
1663916749 <doc xml:space="preserve"
1664016750 filename="pango/pango-renderer.c"
16641- line="1579">a `PangoRenderer`</doc>
16751+ line="1578">a `PangoRenderer`</doc>
1664216752 <type name="Renderer" c:type="PangoRenderer*"/>
1664316753 </instance-parameter>
1664416754 </parameters>
@@ -16648,7 +16758,7 @@ See [method@Pango.Renderer.set_matrix].</doc>
1664816758 version="1.8">
1664916759 <doc xml:space="preserve"
1665016760 filename="pango/pango-renderer.c"
16651- line="1412">Informs Pango that the way that the rendering is done
16761+ line="1411">Informs Pango that the way that the rendering is done
1665216762 for @part has changed.
1665316763
1665416764 This should be called if the rendering changes in a way that would
@@ -16671,13 +16781,13 @@ changes to colors. (See [method@Pango.Renderer.set_color])</doc>
1667116781 <instance-parameter name="renderer" transfer-ownership="none">
1667216782 <doc xml:space="preserve"
1667316783 filename="pango/pango-renderer.c"
16674- line="1414">a `PangoRenderer`</doc>
16784+ line="1413">a `PangoRenderer`</doc>
1667516785 <type name="Renderer" c:type="PangoRenderer*"/>
1667616786 </instance-parameter>
1667716787 <parameter name="part" transfer-ownership="none">
1667816788 <doc xml:space="preserve"
1667916789 filename="pango/pango-renderer.c"
16680- line="1415">the part for which rendering has changed.</doc>
16790+ line="1414">the part for which rendering has changed.</doc>
1668116791 <type name="RenderPart" c:type="PangoRenderPart"/>
1668216792 </parameter>
1668316793 </parameters>
@@ -16687,7 +16797,7 @@ changes to colors. (See [method@Pango.Renderer.set_color])</doc>
1668716797 version="1.38">
1668816798 <doc xml:space="preserve"
1668916799 filename="pango/pango-renderer.c"
16690- line="1358">Sets the alpha for part of the rendering.
16800+ line="1357">Sets the alpha for part of the rendering.
1669116801
1669216802 Note that the alpha may only be used if a color is
1669316803 specified for @part as well.</doc>
@@ -16699,19 +16809,19 @@ specified for @part as well.</doc>
1669916809 <instance-parameter name="renderer" transfer-ownership="none">
1670016810 <doc xml:space="preserve"
1670116811 filename="pango/pango-renderer.c"
16702- line="1360">a `PangoRenderer`</doc>
16812+ line="1359">a `PangoRenderer`</doc>
1670316813 <type name="Renderer" c:type="PangoRenderer*"/>
1670416814 </instance-parameter>
1670516815 <parameter name="part" transfer-ownership="none">
1670616816 <doc xml:space="preserve"
1670716817 filename="pango/pango-renderer.c"
16708- line="1361">the part to set the alpha for</doc>
16818+ line="1360">the part to set the alpha for</doc>
1670916819 <type name="RenderPart" c:type="PangoRenderPart"/>
1671016820 </parameter>
1671116821 <parameter name="alpha" transfer-ownership="none">
1671216822 <doc xml:space="preserve"
1671316823 filename="pango/pango-renderer.c"
16714- line="1362">an alpha value between 1 and 65536, or 0 to unset the alpha</doc>
16824+ line="1361">an alpha value between 1 and 65536, or 0 to unset the alpha</doc>
1671516825 <type name="guint16" c:type="guint16"/>
1671616826 </parameter>
1671716827 </parameters>
@@ -16721,7 +16831,7 @@ specified for @part as well.</doc>
1672116831 version="1.8">
1672216832 <doc xml:space="preserve"
1672316833 filename="pango/pango-renderer.c"
16724- line="1292">Sets the color for part of the rendering.
16834+ line="1291">Sets the color for part of the rendering.
1672516835
1672616836 Also see [method@Pango.Renderer.set_alpha].</doc>
1672716837 <source-position filename="pango/pango-renderer.h" line="261"/>
@@ -16732,13 +16842,13 @@ Also see [method@Pango.Renderer.set_alpha].</doc>
1673216842 <instance-parameter name="renderer" transfer-ownership="none">
1673316843 <doc xml:space="preserve"
1673416844 filename="pango/pango-renderer.c"
16735- line="1294">a `PangoRenderer`</doc>
16845+ line="1293">a `PangoRenderer`</doc>
1673616846 <type name="Renderer" c:type="PangoRenderer*"/>
1673716847 </instance-parameter>
1673816848 <parameter name="part" transfer-ownership="none">
1673916849 <doc xml:space="preserve"
1674016850 filename="pango/pango-renderer.c"
16741- line="1295">the part to change the color of</doc>
16851+ line="1294">the part to change the color of</doc>
1674216852 <type name="RenderPart" c:type="PangoRenderPart"/>
1674316853 </parameter>
1674416854 <parameter name="color"
@@ -16747,7 +16857,7 @@ Also see [method@Pango.Renderer.set_alpha].</doc>
1674716857 allow-none="1">
1674816858 <doc xml:space="preserve"
1674916859 filename="pango/pango-renderer.c"
16750- line="1296">the new color or %NULL to unset the current color</doc>
16860+ line="1295">the new color or %NULL to unset the current color</doc>
1675116861 <type name="Color" c:type="const PangoColor*"/>
1675216862 </parameter>
1675316863 </parameters>
@@ -16757,7 +16867,7 @@ Also see [method@Pango.Renderer.set_alpha].</doc>
1675716867 version="1.8">
1675816868 <doc xml:space="preserve"
1675916869 filename="pango/pango-renderer.c"
16760- line="1557">Sets the transformation matrix that will be applied when rendering.</doc>
16870+ line="1556">Sets the transformation matrix that will be applied when rendering.</doc>
1676116871 <source-position filename="pango/pango-renderer.h" line="277"/>
1676216872 <return-value transfer-ownership="none">
1676316873 <type name="none" c:type="void"/>
@@ -16766,7 +16876,7 @@ Also see [method@Pango.Renderer.set_alpha].</doc>
1676616876 <instance-parameter name="renderer" transfer-ownership="none">
1676716877 <doc xml:space="preserve"
1676816878 filename="pango/pango-renderer.c"
16769- line="1559">a `PangoRenderer`</doc>
16879+ line="1558">a `PangoRenderer`</doc>
1677016880 <type name="Renderer" c:type="PangoRenderer*"/>
1677116881 </instance-parameter>
1677216882 <parameter name="matrix"
@@ -16775,7 +16885,7 @@ Also see [method@Pango.Renderer.set_alpha].</doc>
1677516885 allow-none="1">
1677616886 <doc xml:space="preserve"
1677716887 filename="pango/pango-renderer.c"
16778- line="1560">a `PangoMatrix`, or %NULL to unset any existing matrix
16888+ line="1559">a `PangoMatrix`, or %NULL to unset any existing matrix
1677916889 (No matrix set is the same as setting the identity matrix.)</doc>
1678016890 <type name="Matrix" c:type="const PangoMatrix*"/>
1678116891 </parameter>
@@ -16844,32 +16954,32 @@ and must be implemented:
1684416954 <parameter name="renderer" transfer-ownership="none">
1684516955 <doc xml:space="preserve"
1684616956 filename="pango/pango-renderer.c"
16847- line="751">a `PangoRenderer`</doc>
16957+ line="750">a `PangoRenderer`</doc>
1684816958 <type name="Renderer" c:type="PangoRenderer*"/>
1684916959 </parameter>
1685016960 <parameter name="font" transfer-ownership="none">
1685116961 <doc xml:space="preserve"
1685216962 filename="pango/pango-renderer.c"
16853- line="752">a `PangoFont`</doc>
16963+ line="751">a `PangoFont`</doc>
1685416964 <type name="Font" c:type="PangoFont*"/>
1685516965 </parameter>
1685616966 <parameter name="glyphs" transfer-ownership="none">
1685716967 <doc xml:space="preserve"
1685816968 filename="pango/pango-renderer.c"
16859- line="753">a `PangoGlyphString`</doc>
16969+ line="752">a `PangoGlyphString`</doc>
1686016970 <type name="GlyphString" c:type="PangoGlyphString*"/>
1686116971 </parameter>
1686216972 <parameter name="x" transfer-ownership="none">
1686316973 <doc xml:space="preserve"
1686416974 filename="pango/pango-renderer.c"
16865- line="754">X position of left edge of baseline, in user space coordinates
16975+ line="753">X position of left edge of baseline, in user space coordinates
1686616976 in Pango units.</doc>
1686716977 <type name="gint" c:type="int"/>
1686816978 </parameter>
1686916979 <parameter name="y" transfer-ownership="none">
1687016980 <doc xml:space="preserve"
1687116981 filename="pango/pango-renderer.c"
16872- line="756">Y position of left edge of baseline, in user space coordinates
16982+ line="755">Y position of left edge of baseline, in user space coordinates
1687316983 in Pango units.</doc>
1687416984 <type name="gint" c:type="int"/>
1687516985 </parameter>
@@ -16889,39 +16999,39 @@ and must be implemented:
1688916999 <parameter name="renderer" transfer-ownership="none">
1689017000 <doc xml:space="preserve"
1689117001 filename="pango/pango-renderer.c"
16892- line="876">a `PangoRenderer`</doc>
17002+ line="875">a `PangoRenderer`</doc>
1689317003 <type name="Renderer" c:type="PangoRenderer*"/>
1689417004 </parameter>
1689517005 <parameter name="part" transfer-ownership="none">
1689617006 <doc xml:space="preserve"
1689717007 filename="pango/pango-renderer.c"
16898- line="877">type of object this rectangle is part of</doc>
17008+ line="876">type of object this rectangle is part of</doc>
1689917009 <type name="RenderPart" c:type="PangoRenderPart"/>
1690017010 </parameter>
1690117011 <parameter name="x" transfer-ownership="none">
1690217012 <doc xml:space="preserve"
1690317013 filename="pango/pango-renderer.c"
16904- line="878">X position at which to draw rectangle, in user space coordinates
17014+ line="877">X position at which to draw rectangle, in user space coordinates
1690517015 in Pango units</doc>
1690617016 <type name="gint" c:type="int"/>
1690717017 </parameter>
1690817018 <parameter name="y" transfer-ownership="none">
1690917019 <doc xml:space="preserve"
1691017020 filename="pango/pango-renderer.c"
16911- line="880">Y position at which to draw rectangle, in user space coordinates
17021+ line="879">Y position at which to draw rectangle, in user space coordinates
1691217022 in Pango units</doc>
1691317023 <type name="gint" c:type="int"/>
1691417024 </parameter>
1691517025 <parameter name="width" transfer-ownership="none">
1691617026 <doc xml:space="preserve"
1691717027 filename="pango/pango-renderer.c"
16918- line="882">width of rectangle in Pango units</doc>
17028+ line="881">width of rectangle in Pango units</doc>
1691917029 <type name="gint" c:type="int"/>
1692017030 </parameter>
1692117031 <parameter name="height" transfer-ownership="none">
1692217032 <doc xml:space="preserve"
1692317033 filename="pango/pango-renderer.c"
16924- line="883">height of rectangle in Pango units</doc>
17034+ line="882">height of rectangle in Pango units</doc>
1692517035 <type name="gint" c:type="int"/>
1692617036 </parameter>
1692717037 </parameters>
@@ -16942,31 +17052,31 @@ indicate a spelling error.</doc>
1694217052 <parameter name="renderer" transfer-ownership="none">
1694317053 <doc xml:space="preserve"
1694417054 filename="pango/pango-renderer.c"
16945- line="1017">a `PangoRenderer`</doc>
17055+ line="1016">a `PangoRenderer`</doc>
1694617056 <type name="Renderer" c:type="PangoRenderer*"/>
1694717057 </parameter>
1694817058 <parameter name="x" transfer-ownership="none">
1694917059 <doc xml:space="preserve"
1695017060 filename="pango/pango-renderer.c"
16951- line="1018">X coordinate of underline, in Pango units in user coordinate system</doc>
17061+ line="1017">X coordinate of underline, in Pango units in user coordinate system</doc>
1695217062 <type name="gint" c:type="int"/>
1695317063 </parameter>
1695417064 <parameter name="y" transfer-ownership="none">
1695517065 <doc xml:space="preserve"
1695617066 filename="pango/pango-renderer.c"
16957- line="1019">Y coordinate of underline, in Pango units in user coordinate system</doc>
17067+ line="1018">Y coordinate of underline, in Pango units in user coordinate system</doc>
1695817068 <type name="gint" c:type="int"/>
1695917069 </parameter>
1696017070 <parameter name="width" transfer-ownership="none">
1696117071 <doc xml:space="preserve"
1696217072 filename="pango/pango-renderer.c"
16963- line="1020">width of underline, in Pango units in user coordinate system</doc>
17073+ line="1019">width of underline, in Pango units in user coordinate system</doc>
1696417074 <type name="gint" c:type="int"/>
1696517075 </parameter>
1696617076 <parameter name="height" transfer-ownership="none">
1696717077 <doc xml:space="preserve"
1696817078 filename="pango/pango-renderer.c"
16969- line="1021">height of underline, in Pango units in user coordinate system</doc>
17079+ line="1020">height of underline, in Pango units in user coordinate system</doc>
1697017080 <type name="gint" c:type="int"/>
1697117081 </parameter>
1697217082 </parameters>
@@ -17012,49 +17122,49 @@ indicate a spelling error.</doc>
1701217122 <parameter name="renderer" transfer-ownership="none">
1701317123 <doc xml:space="preserve"
1701417124 filename="pango/pango-renderer.c"
17015- line="1177">a `PangoRenderer`</doc>
17125+ line="1176">a `PangoRenderer`</doc>
1701617126 <type name="Renderer" c:type="PangoRenderer*"/>
1701717127 </parameter>
1701817128 <parameter name="part" transfer-ownership="none">
1701917129 <doc xml:space="preserve"
1702017130 filename="pango/pango-renderer.c"
17021- line="1178">type of object this trapezoid is part of</doc>
17131+ line="1177">type of object this trapezoid is part of</doc>
1702217132 <type name="RenderPart" c:type="PangoRenderPart"/>
1702317133 </parameter>
1702417134 <parameter name="y1_" transfer-ownership="none">
1702517135 <doc xml:space="preserve"
1702617136 filename="pango/pango-renderer.c"
17027- line="1179">Y coordinate of top of trapezoid</doc>
17137+ line="1178">Y coordinate of top of trapezoid</doc>
1702817138 <type name="gdouble" c:type="double"/>
1702917139 </parameter>
1703017140 <parameter name="x11" transfer-ownership="none">
1703117141 <doc xml:space="preserve"
1703217142 filename="pango/pango-renderer.c"
17033- line="1180">X coordinate of left end of top of trapezoid</doc>
17143+ line="1179">X coordinate of left end of top of trapezoid</doc>
1703417144 <type name="gdouble" c:type="double"/>
1703517145 </parameter>
1703617146 <parameter name="x21" transfer-ownership="none">
1703717147 <doc xml:space="preserve"
1703817148 filename="pango/pango-renderer.c"
17039- line="1181">X coordinate of right end of top of trapezoid</doc>
17149+ line="1180">X coordinate of right end of top of trapezoid</doc>
1704017150 <type name="gdouble" c:type="double"/>
1704117151 </parameter>
1704217152 <parameter name="y2" transfer-ownership="none">
1704317153 <doc xml:space="preserve"
1704417154 filename="pango/pango-renderer.c"
17045- line="1182">Y coordinate of bottom of trapezoid</doc>
17155+ line="1181">Y coordinate of bottom of trapezoid</doc>
1704617156 <type name="gdouble" c:type="double"/>
1704717157 </parameter>
1704817158 <parameter name="x12" transfer-ownership="none">
1704917159 <doc xml:space="preserve"
1705017160 filename="pango/pango-renderer.c"
17051- line="1183">X coordinate of left end of bottom of trapezoid</doc>
17161+ line="1182">X coordinate of left end of bottom of trapezoid</doc>
1705217162 <type name="gdouble" c:type="double"/>
1705317163 </parameter>
1705417164 <parameter name="x22" transfer-ownership="none">
1705517165 <doc xml:space="preserve"
1705617166 filename="pango/pango-renderer.c"
17057- line="1184">X coordinate of right end of bottom of trapezoid</doc>
17167+ line="1183">X coordinate of right end of bottom of trapezoid</doc>
1705817168 <type name="gdouble" c:type="double"/>
1705917169 </parameter>
1706017170 </parameters>
@@ -17073,31 +17183,31 @@ indicate a spelling error.</doc>
1707317183 <parameter name="renderer" transfer-ownership="none">
1707417184 <doc xml:space="preserve"
1707517185 filename="pango/pango-renderer.c"
17076- line="1212">a `PangoRenderer`</doc>
17186+ line="1211">a `PangoRenderer`</doc>
1707717187 <type name="Renderer" c:type="PangoRenderer*"/>
1707817188 </parameter>
1707917189 <parameter name="font" transfer-ownership="none">
1708017190 <doc xml:space="preserve"
1708117191 filename="pango/pango-renderer.c"
17082- line="1213">a `PangoFont`</doc>
17192+ line="1212">a `PangoFont`</doc>
1708317193 <type name="Font" c:type="PangoFont*"/>
1708417194 </parameter>
1708517195 <parameter name="glyph" transfer-ownership="none">
1708617196 <doc xml:space="preserve"
1708717197 filename="pango/pango-renderer.c"
17088- line="1214">the glyph index of a single glyph</doc>
17198+ line="1213">the glyph index of a single glyph</doc>
1708917199 <type name="Glyph" c:type="PangoGlyph"/>
1709017200 </parameter>
1709117201 <parameter name="x" transfer-ownership="none">
1709217202 <doc xml:space="preserve"
1709317203 filename="pango/pango-renderer.c"
17094- line="1215">X coordinate of left edge of baseline of glyph</doc>
17204+ line="1214">X coordinate of left edge of baseline of glyph</doc>
1709517205 <type name="gdouble" c:type="double"/>
1709617206 </parameter>
1709717207 <parameter name="y" transfer-ownership="none">
1709817208 <doc xml:space="preserve"
1709917209 filename="pango/pango-renderer.c"
17100- line="1216">Y coordinate of left edge of baseline of glyph</doc>
17210+ line="1215">Y coordinate of left edge of baseline of glyph</doc>
1710117211 <type name="gdouble" c:type="double"/>
1710217212 </parameter>
1710317213 </parameters>
@@ -17117,13 +17227,13 @@ indicate a spelling error.</doc>
1711717227 <parameter name="renderer" transfer-ownership="none">
1711817228 <doc xml:space="preserve"
1711917229 filename="pango/pango-renderer.c"
17120- line="1414">a `PangoRenderer`</doc>
17230+ line="1413">a `PangoRenderer`</doc>
1712117231 <type name="Renderer" c:type="PangoRenderer*"/>
1712217232 </parameter>
1712317233 <parameter name="part" transfer-ownership="none">
1712417234 <doc xml:space="preserve"
1712517235 filename="pango/pango-renderer.c"
17126- line="1415">the part for which rendering has changed.</doc>
17236+ line="1414">the part for which rendering has changed.</doc>
1712717237 <type name="RenderPart" c:type="PangoRenderPart"/>
1712817238 </parameter>
1712917239 </parameters>
@@ -17193,7 +17303,7 @@ indicate a spelling error.</doc>
1719317303 <parameter name="renderer" transfer-ownership="none">
1719417304 <doc xml:space="preserve"
1719517305 filename="pango/pango-renderer.c"
17196- line="807">a `PangoRenderer`</doc>
17306+ line="806">a `PangoRenderer`</doc>
1719717307 <type name="Renderer" c:type="PangoRenderer*"/>
1719817308 </parameter>
1719917309 <parameter name="text"
@@ -17202,26 +17312,26 @@ indicate a spelling error.</doc>
1720217312 allow-none="1">
1720317313 <doc xml:space="preserve"
1720417314 filename="pango/pango-renderer.c"
17205- line="808">the UTF-8 text that @glyph_item refers to</doc>
17315+ line="807">the UTF-8 text that @glyph_item refers to</doc>
1720617316 <type name="utf8" c:type="const char*"/>
1720717317 </parameter>
1720817318 <parameter name="glyph_item" transfer-ownership="none">
1720917319 <doc xml:space="preserve"
1721017320 filename="pango/pango-renderer.c"
17211- line="809">a `PangoGlyphItem`</doc>
17321+ line="808">a `PangoGlyphItem`</doc>
1721217322 <type name="GlyphItem" c:type="PangoGlyphItem*"/>
1721317323 </parameter>
1721417324 <parameter name="x" transfer-ownership="none">
1721517325 <doc xml:space="preserve"
1721617326 filename="pango/pango-renderer.c"
17217- line="810">X position of left edge of baseline, in user space coordinates
17327+ line="809">X position of left edge of baseline, in user space coordinates
1721817328 in Pango units</doc>
1721917329 <type name="gint" c:type="int"/>
1722017330 </parameter>
1722117331 <parameter name="y" transfer-ownership="none">
1722217332 <doc xml:space="preserve"
1722317333 filename="pango/pango-renderer.c"
17224- line="812">Y position of left edge of baseline, in user space coordinates
17334+ line="811">Y position of left edge of baseline, in user space coordinates
1722517335 in Pango units</doc>
1722617336 <type name="gint" c:type="int"/>
1722717337 </parameter>
@@ -19602,14 +19712,14 @@ Two encoded version numbers can be compared as integers.</doc>
1960219712 <source-position filename="pango/pango-features.h" line="4"/>
1960319713 <type name="gint" c:type="gint"/>
1960419714 </constant>
19605- <constant name="VERSION_MICRO" value="3" c:type="PANGO_VERSION_MICRO">
19715+ <constant name="VERSION_MICRO" value="0" c:type="PANGO_VERSION_MICRO">
1960619716 <doc xml:space="preserve"
1960719717 filename="pango/pango-utils.h"
1960819718 line="147">The micro component of the version of Pango available at compile-time.</doc>
1960919719 <source-position filename="pango/pango-features.h" line="6"/>
1961019720 <type name="gint" c:type="gint"/>
1961119721 </constant>
19612- <constant name="VERSION_MINOR" value="56" c:type="PANGO_VERSION_MINOR">
19722+ <constant name="VERSION_MINOR" value="57" c:type="PANGO_VERSION_MINOR">
1961319723 <doc xml:space="preserve"
1961419724 filename="pango/pango-utils.h"
1961519725 line="142">The minor component of the version of Pango available at compile-time.</doc>
@@ -19617,7 +19727,7 @@ Two encoded version numbers can be compared as integers.</doc>
1961719727 <type name="gint" c:type="gint"/>
1961819728 </constant>
1961919729 <constant name="VERSION_STRING"
19620- value="1.56.3"
19730+ value="1.57.0"
1962119731 c:type="PANGO_VERSION_STRING">
1962219732 <doc xml:space="preserve"
1962319733 filename="pango/pango-utils.h"
@@ -19998,7 +20108,7 @@ relative to the run of preceding run.
1999820108 <function name="attr_break" c:identifier="pango_attr_break" version="1.50">
1999920109 <doc xml:space="preserve"
2000020110 filename="pango/break.c"
20001- line="2544">Apply customization from attributes to the breaks in @attrs.
20111+ line="2525">Apply customization from attributes to the breaks in @attrs.
2000220112
2000320113 The line breaks are assumed to have been produced
2000420114 by [func@Pango.default_break] and [func@Pango.tailor_break].</doc>
@@ -20010,25 +20120,25 @@ by [func@Pango.default_break] and [func@Pango.tailor_break].</doc>
2001020120 <parameter name="text" transfer-ownership="none">
2001120121 <doc xml:space="preserve"
2001220122 filename="pango/break.c"
20013- line="2546">text to break. Must be valid UTF-8</doc>
20123+ line="2527">text to break. Must be valid UTF-8</doc>
2001420124 <type name="utf8" c:type="const char*"/>
2001520125 </parameter>
2001620126 <parameter name="length" transfer-ownership="none">
2001720127 <doc xml:space="preserve"
2001820128 filename="pango/break.c"
20019- line="2547">length of text in bytes (may be -1 if @text is nul-terminated)</doc>
20129+ line="2528">length of text in bytes (may be -1 if @text is nul-terminated)</doc>
2002020130 <type name="gint" c:type="int"/>
2002120131 </parameter>
2002220132 <parameter name="attr_list" transfer-ownership="none">
2002320133 <doc xml:space="preserve"
2002420134 filename="pango/break.c"
20025- line="2548">`PangoAttrList` to apply</doc>
20135+ line="2529">`PangoAttrList` to apply</doc>
2002620136 <type name="AttrList" c:type="PangoAttrList*"/>
2002720137 </parameter>
2002820138 <parameter name="offset" transfer-ownership="none">
2002920139 <doc xml:space="preserve"
2003020140 filename="pango/break.c"
20031- line="2549">Byte offset of @text from the beginning of the paragraph</doc>
20141+ line="2530">Byte offset of @text from the beginning of the paragraph</doc>
2003220142 <type name="gint" c:type="int"/>
2003320143 </parameter>
2003420144 <parameter name="attrs"
@@ -20037,7 +20147,7 @@ by [func@Pango.default_break] and [func@Pango.tailor_break].</doc>
2003720147 transfer-ownership="none">
2003820148 <doc xml:space="preserve"
2003920149 filename="pango/break.c"
20040- line="2550">array with one
20150+ line="2531">array with one
2004120151 `PangoLogAttr` per character in @text, plus one extra, to be filled in</doc>
2004220152 <array length="5" zero-terminated="0" c:type="PangoLogAttr*">
2004320153 <type name="LogAttr" c:type="PangoLogAttr"/>
@@ -20046,7 +20156,7 @@ by [func@Pango.default_break] and [func@Pango.tailor_break].</doc>
2004620156 <parameter name="attrs_len" transfer-ownership="none">
2004720157 <doc xml:space="preserve"
2004820158 filename="pango/break.c"
20049- line="2552">length of @attrs array</doc>
20159+ line="2533">length of @attrs array</doc>
2005020160 <type name="gint" c:type="int"/>
2005120161 </parameter>
2005220162 </parameters>
@@ -21099,7 +21209,7 @@ Unicode bidirectional algorithm.</doc>
2109921209 deprecated-version="1.44">
2110021210 <doc xml:space="preserve"
2110121211 filename="pango/break.c"
21102- line="2465">Determines possible line, word, and character breaks
21212+ line="2446">Determines possible line, word, and character breaks
2110321213 for a string of Unicode text with a single analysis.
2110421214
2110521215 For most purposes you may want to use [func@Pango.get_log_attrs].</doc>
@@ -21113,19 +21223,19 @@ For most purposes you may want to use [func@Pango.get_log_attrs].</doc>
2111321223 <parameter name="text" transfer-ownership="none">
2111421224 <doc xml:space="preserve"
2111521225 filename="pango/break.c"
21116- line="2467">the text to process. Must be valid UTF-8</doc>
21226+ line="2448">the text to process. Must be valid UTF-8</doc>
2111721227 <type name="utf8" c:type="const char*"/>
2111821228 </parameter>
2111921229 <parameter name="length" transfer-ownership="none">
2112021230 <doc xml:space="preserve"
2112121231 filename="pango/break.c"
21122- line="2468">length of @text in bytes (may be -1 if @text is nul-terminated)</doc>
21232+ line="2449">length of @text in bytes (may be -1 if @text is nul-terminated)</doc>
2112321233 <type name="gint" c:type="int"/>
2112421234 </parameter>
2112521235 <parameter name="analysis" transfer-ownership="none">
2112621236 <doc xml:space="preserve"
2112721237 filename="pango/break.c"
21128- line="2469">`PangoAnalysis` structure for @text</doc>
21238+ line="2450">`PangoAnalysis` structure for @text</doc>
2112921239 <type name="Analysis" c:type="PangoAnalysis*"/>
2113021240 </parameter>
2113121241 <parameter name="attrs"
@@ -21134,7 +21244,7 @@ For most purposes you may want to use [func@Pango.get_log_attrs].</doc>
2113421244 transfer-ownership="none">
2113521245 <doc xml:space="preserve"
2113621246 filename="pango/break.c"
21137- line="2470">an array to
21247+ line="2451">an array to
2113821248 store character information in</doc>
2113921249 <array length="4" zero-terminated="0" c:type="PangoLogAttr*">
2114021250 <type name="LogAttr" c:type="PangoLogAttr"/>
@@ -21143,7 +21253,7 @@ For most purposes you may want to use [func@Pango.get_log_attrs].</doc>
2114321253 <parameter name="attrs_len" transfer-ownership="none">
2114421254 <doc xml:space="preserve"
2114521255 filename="pango/break.c"
21146- line="2472">size of the array passed as @attrs</doc>
21256+ line="2453">size of the array passed as @attrs</doc>
2114721257 <type name="gint" c:type="int"/>
2114821258 </parameter>
2114921259 </parameters>
@@ -21151,7 +21261,7 @@ For most purposes you may want to use [func@Pango.get_log_attrs].</doc>
2115121261 <function name="default_break" c:identifier="pango_default_break">
2115221262 <doc xml:space="preserve"
2115321263 filename="pango/break.c"
21154- line="2430">This is the default break algorithm.
21264+ line="2411">This is the default break algorithm.
2115521265
2115621266 It applies rules from the [Unicode Line Breaking Algorithm](http://www.unicode.org/unicode/reports/tr14/)
2115721267 without language-specific tailoring, therefore the @analyis argument is unused
@@ -21168,13 +21278,13 @@ See [func@Pango.attr_break] for attribute-based customization.</doc>
2116821278 <parameter name="text" transfer-ownership="none">
2116921279 <doc xml:space="preserve"
2117021280 filename="pango/break.c"
21171- line="2432">text to break. Must be valid UTF-8</doc>
21281+ line="2413">text to break. Must be valid UTF-8</doc>
2117221282 <type name="utf8" c:type="const char*"/>
2117321283 </parameter>
2117421284 <parameter name="length" transfer-ownership="none">
2117521285 <doc xml:space="preserve"
2117621286 filename="pango/break.c"
21177- line="2433">length of text in bytes (may be -1 if @text is nul-terminated)</doc>
21287+ line="2414">length of text in bytes (may be -1 if @text is nul-terminated)</doc>
2117821288 <type name="gint" c:type="int"/>
2117921289 </parameter>
2118021290 <parameter name="analysis"
@@ -21183,7 +21293,7 @@ See [func@Pango.attr_break] for attribute-based customization.</doc>
2118321293 allow-none="1">
2118421294 <doc xml:space="preserve"
2118521295 filename="pango/break.c"
21186- line="2434">a `PangoAnalysis` structure for the @text</doc>
21296+ line="2415">a `PangoAnalysis` structure for the @text</doc>
2118721297 <type name="Analysis" c:type="PangoAnalysis*"/>
2118821298 </parameter>
2118921299 <parameter name="attrs"
@@ -21192,7 +21302,7 @@ See [func@Pango.attr_break] for attribute-based customization.</doc>
2119221302 transfer-ownership="none">
2119321303 <doc xml:space="preserve"
2119421304 filename="pango/break.c"
21195- line="2435">logical
21305+ line="2416">logical
2119621306 attributes to fill in</doc>
2119721307 <array length="4" zero-terminated="0" c:type="PangoLogAttr*">
2119821308 <type name="LogAttr" c:type="PangoLogAttr"/>
@@ -21201,7 +21311,7 @@ See [func@Pango.attr_break] for attribute-based customization.</doc>
2120121311 <parameter name="attrs_len" transfer-ownership="none">
2120221312 <doc xml:space="preserve"
2120321313 filename="pango/break.c"
21204- line="2437">size of the array passed as @attrs</doc>
21314+ line="2418">size of the array passed as @attrs</doc>
2120521315 <type name="gint" c:type="int"/>
2120621316 </parameter>
2120721317 </parameters>
@@ -21234,18 +21344,20 @@ as @nearest.</doc>
2123421344 </return-value>
2123521345 <parameters>
2123621346 <parameter name="inclusive"
21237- transfer-ownership="none"
21238- nullable="1"
21239- allow-none="1">
21347+ direction="inout"
21348+ caller-allocates="0"
21349+ transfer-ownership="full"
21350+ optional="1">
2124021351 <doc xml:space="preserve"
2124121352 filename="pango/pango-utils.c"
2124221353 line="1026">rectangle to round to pixels inclusively</doc>
2124321354 <type name="Rectangle" c:type="PangoRectangle*"/>
2124421355 </parameter>
2124521356 <parameter name="nearest"
21246- transfer-ownership="none"
21247- nullable="1"
21248- allow-none="1">
21357+ direction="inout"
21358+ caller-allocates="0"
21359+ transfer-ownership="full"
21360+ optional="1">
2124921361 <doc xml:space="preserve"
2125021362 filename="pango/pango-utils.c"
2125121363 line="1027">rectangle to round to nearest pixels</doc>
@@ -21321,21 +21433,25 @@ and @next_paragraph_start are filled with the length of @text
2132121433 <parameter name="paragraph_delimiter_index"
2132221434 direction="out"
2132321435 caller-allocates="0"
21324- transfer-ownership="full">
21436+ transfer-ownership="full"
21437+ optional="1"
21438+ allow-none="1">
2132521439 <doc xml:space="preserve"
2132621440 filename="pango/pango-utils.c"
21327- line="1158">return location for index of
21328- delimiter</doc>
21441+ line="1158">return location
21442+ for index of delimiter</doc>
2132921443 <type name="gint" c:type="int*"/>
2133021444 </parameter>
2133121445 <parameter name="next_paragraph_start"
2133221446 direction="out"
2133321447 caller-allocates="0"
21334- transfer-ownership="full">
21448+ transfer-ownership="full"
21449+ optional="1"
21450+ allow-none="1">
2133521451 <doc xml:space="preserve"
2133621452 filename="pango/pango-utils.c"
21337- line="1160">return location for start of next
21338- paragraph</doc>
21453+ line="1160">return location for
21454+ start of next paragraph</doc>
2133921455 <type name="gint" c:type="int*"/>
2134021456 </parameter>
2134121457 </parameters>
@@ -21345,7 +21461,7 @@ and @next_paragraph_start are filled with the length of @text
2134521461 moved-to="FontDescription.from_string">
2134621462 <doc xml:space="preserve"
2134721463 filename="pango/fonts.c"
21348- line="1403">Creates a new font description from a string representation.
21464+ line="1462">Creates a new font description from a string representation.
2134921465
2135021466 The string must have the form
2135121467
@@ -21378,6 +21494,9 @@ The following words are understood as gravity values:
2137821494 "Not-Rotated", "South", "Upside-Down", "North", "Rotated-Left",
2137921495 "East", "Rotated-Right", "West".
2138021496
21497+The following words are understood as color values:
21498+"With-Color", "Without-Color".
21499+
2138121500 VARIATIONS is a comma-separated list of font variations
2138221501 of the form @<U+200D>axis1=value,axis2=value,...
2138321502
@@ -21394,18 +21513,18 @@ size in the resulting font description will be set to 0.
2139421513 A typical example:
2139521514
2139621515 Cantarell Italic Light 15 @<U+200D>wght=200 #<U+200D>tnum=1</doc>
21397- <source-position filename="pango/pango-font.h" line="369"/>
21516+ <source-position filename="pango/pango-font.h" line="399"/>
2139821517 <return-value transfer-ownership="full">
2139921518 <doc xml:space="preserve"
2140021519 filename="pango/fonts.c"
21401- line="1457">a new `PangoFontDescription`.</doc>
21520+ line="1519">a new `PangoFontDescription`.</doc>
2140221521 <type name="FontDescription" c:type="PangoFontDescription*"/>
2140321522 </return-value>
2140421523 <parameters>
2140521524 <parameter name="str" transfer-ownership="none">
2140621525 <doc xml:space="preserve"
2140721526 filename="pango/fonts.c"
21408- line="1405">string representation of a font description.</doc>
21527+ line="1464">string representation of a font description.</doc>
2140921528 <type name="utf8" c:type="const char*"/>
2141021529 </parameter>
2141121530 </parameters>
@@ -21413,7 +21532,7 @@ A typical example:
2141321532 <function name="get_log_attrs" c:identifier="pango_get_log_attrs">
2141421533 <doc xml:space="preserve"
2141521534 filename="pango/break.c"
21416- line="2590">Computes a `PangoLogAttr` for each character in @text.
21535+ line="2571">Computes a `PangoLogAttr` for each character in @text.
2141721536
2141821537 The @attrs array must have one `PangoLogAttr` for
2141921538 each position in @text; if @text contains N characters,
@@ -21430,25 +21549,25 @@ a word to know the word is a word).</doc>
2143021549 <parameter name="text" transfer-ownership="none">
2143121550 <doc xml:space="preserve"
2143221551 filename="pango/break.c"
21433- line="2592">text to process. Must be valid UTF-8</doc>
21552+ line="2573">text to process. Must be valid UTF-8</doc>
2143421553 <type name="utf8" c:type="const char*"/>
2143521554 </parameter>
2143621555 <parameter name="length" transfer-ownership="none">
2143721556 <doc xml:space="preserve"
2143821557 filename="pango/break.c"
21439- line="2593">length in bytes of @text</doc>
21558+ line="2574">length in bytes of @text</doc>
2144021559 <type name="gint" c:type="int"/>
2144121560 </parameter>
2144221561 <parameter name="level" transfer-ownership="none">
2144321562 <doc xml:space="preserve"
2144421563 filename="pango/break.c"
21445- line="2594">embedding level, or -1 if unknown</doc>
21564+ line="2575">embedding level, or -1 if unknown</doc>
2144621565 <type name="gint" c:type="int"/>
2144721566 </parameter>
2144821567 <parameter name="language" transfer-ownership="none">
2144921568 <doc xml:space="preserve"
2145021569 filename="pango/break.c"
21451- line="2595">language tag</doc>
21570+ line="2576">language tag</doc>
2145221571 <type name="Language" c:type="PangoLanguage*"/>
2145321572 </parameter>
2145421573 <parameter name="attrs"
@@ -21457,7 +21576,7 @@ a word to know the word is a word).</doc>
2145721576 transfer-ownership="none">
2145821577 <doc xml:space="preserve"
2145921578 filename="pango/break.c"
21460- line="2596">array with one
21579+ line="2577">array with one
2146121580 `PangoLogAttr` per character in @text, plus one extra, to be filled in</doc>
2146221581 <array length="5" zero-terminated="0" c:type="PangoLogAttr*">
2146321582 <type name="LogAttr" c:type="PangoLogAttr"/>
@@ -21466,7 +21585,7 @@ a word to know the word is a word).</doc>
2146621585 <parameter name="attrs_len" transfer-ownership="none">
2146721586 <doc xml:space="preserve"
2146821587 filename="pango/break.c"
21469- line="2598">length of @attrs array</doc>
21588+ line="2579">length of @attrs array</doc>
2147021589 <type name="gint" c:type="int"/>
2147121590 </parameter>
2147221591 </parameters>
@@ -21693,7 +21812,7 @@ This is totally different from [func@GLib.unichar_iszerowidth] and is at best mi
2169321812 <function name="itemize" c:identifier="pango_itemize">
2169421813 <doc xml:space="preserve"
2169521814 filename="pango/itemize.c"
21696- line="1645">Breaks a piece of text into segments with consistent directional
21815+ line="1662">Breaks a piece of text into segments with consistent directional
2169721816 level and font.
2169821817
2169921818 Each byte of @text will be contained in exactly one of the items in the
@@ -21709,7 +21828,7 @@ in the same @cached_iter).</doc>
2170921828 <return-value transfer-ownership="full">
2171021829 <doc xml:space="preserve"
2171121830 filename="pango/itemize.c"
21712- line="1669">a `GList` of
21831+ line="1686">a `GList` of
2171321832 [struct@Pango.Item] structures. The items should be freed using
2171421833 [method@Pango.Item.free] in combination with [func@GLib.List.free_full].</doc>
2171521834 <type name="GLib.List" c:type="GList*">
@@ -21720,33 +21839,33 @@ in the same @cached_iter).</doc>
2172021839 <parameter name="context" transfer-ownership="none">
2172121840 <doc xml:space="preserve"
2172221841 filename="pango/itemize.c"
21723- line="1647">a structure holding information that affects
21842+ line="1664">a structure holding information that affects
2172421843 the itemization process.</doc>
2172521844 <type name="Context" c:type="PangoContext*"/>
2172621845 </parameter>
2172721846 <parameter name="text" transfer-ownership="none">
2172821847 <doc xml:space="preserve"
2172921848 filename="pango/itemize.c"
21730- line="1649">the text to itemize. Must be valid UTF-8</doc>
21849+ line="1666">the text to itemize. Must be valid UTF-8</doc>
2173121850 <type name="utf8" c:type="const char*"/>
2173221851 </parameter>
2173321852 <parameter name="start_index" transfer-ownership="none">
2173421853 <doc xml:space="preserve"
2173521854 filename="pango/itemize.c"
21736- line="1650">first byte in @text to process</doc>
21855+ line="1667">first byte in @text to process</doc>
2173721856 <type name="gint" c:type="int"/>
2173821857 </parameter>
2173921858 <parameter name="length" transfer-ownership="none">
2174021859 <doc xml:space="preserve"
2174121860 filename="pango/itemize.c"
21742- line="1651">the number of bytes (not characters) to process
21861+ line="1668">the number of bytes (not characters) to process
2174321862 after @start_index. This must be &gt;= 0.</doc>
2174421863 <type name="gint" c:type="int"/>
2174521864 </parameter>
2174621865 <parameter name="attrs" transfer-ownership="none">
2174721866 <doc xml:space="preserve"
2174821867 filename="pango/itemize.c"
21749- line="1653">the set of attributes that apply to @text.</doc>
21868+ line="1670">the set of attributes that apply to @text.</doc>
2175021869 <type name="AttrList" c:type="PangoAttrList*"/>
2175121870 </parameter>
2175221871 <parameter name="cached_iter"
@@ -21755,7 +21874,7 @@ in the same @cached_iter).</doc>
2175521874 allow-none="1">
2175621875 <doc xml:space="preserve"
2175721876 filename="pango/itemize.c"
21758- line="1654">Cached attribute iterator</doc>
21877+ line="1671">Cached attribute iterator</doc>
2175921878 <type name="AttrIterator" c:type="PangoAttrIterator*"/>
2176021879 </parameter>
2176121880 </parameters>
@@ -21765,7 +21884,7 @@ in the same @cached_iter).</doc>
2176521884 version="1.4">
2176621885 <doc xml:space="preserve"
2176721886 filename="pango/itemize.c"
21768- line="1597">Like `pango_itemize()`, but with an explicitly specified base direction.
21887+ line="1614">Like `pango_itemize()`, but with an explicitly specified base direction.
2176921888
2177021889 The base direction is used when computing bidirectional levels.
2177121890 [func@itemize] gets the base direction from the `PangoContext`
@@ -21774,7 +21893,7 @@ The base direction is used when computing bidirectional levels.
2177421893 <return-value transfer-ownership="full">
2177521894 <doc xml:space="preserve"
2177621895 filename="pango/itemize.c"
21777- line="1615">a `GList` of
21896+ line="1632">a `GList` of
2177821897 [struct@Pango.Item] structures. The items should be freed using
2177921898 [method@Pango.Item.free] probably in combination with [func@GLib.List.free_full].</doc>
2178021899 <type name="GLib.List" c:type="GList*">
@@ -21785,39 +21904,39 @@ The base direction is used when computing bidirectional levels.
2178521904 <parameter name="context" transfer-ownership="none">
2178621905 <doc xml:space="preserve"
2178721906 filename="pango/itemize.c"
21788- line="1599">a structure holding information that affects
21907+ line="1616">a structure holding information that affects
2178921908 the itemization process.</doc>
2179021909 <type name="Context" c:type="PangoContext*"/>
2179121910 </parameter>
2179221911 <parameter name="base_dir" transfer-ownership="none">
2179321912 <doc xml:space="preserve"
2179421913 filename="pango/itemize.c"
21795- line="1601">base direction to use for bidirectional processing</doc>
21914+ line="1618">base direction to use for bidirectional processing</doc>
2179621915 <type name="Direction" c:type="PangoDirection"/>
2179721916 </parameter>
2179821917 <parameter name="text" transfer-ownership="none">
2179921918 <doc xml:space="preserve"
2180021919 filename="pango/itemize.c"
21801- line="1602">the text to itemize.</doc>
21920+ line="1619">the text to itemize.</doc>
2180221921 <type name="utf8" c:type="const char*"/>
2180321922 </parameter>
2180421923 <parameter name="start_index" transfer-ownership="none">
2180521924 <doc xml:space="preserve"
2180621925 filename="pango/itemize.c"
21807- line="1603">first byte in @text to process</doc>
21926+ line="1620">first byte in @text to process</doc>
2180821927 <type name="gint" c:type="int"/>
2180921928 </parameter>
2181021929 <parameter name="length" transfer-ownership="none">
2181121930 <doc xml:space="preserve"
2181221931 filename="pango/itemize.c"
21813- line="1604">the number of bytes (not characters) to process
21932+ line="1621">the number of bytes (not characters) to process
2181421933 after @start_index. This must be &gt;= 0.</doc>
2181521934 <type name="gint" c:type="int"/>
2181621935 </parameter>
2181721936 <parameter name="attrs" transfer-ownership="none">
2181821937 <doc xml:space="preserve"
2181921938 filename="pango/itemize.c"
21820- line="1606">the set of attributes that apply to @text.</doc>
21939+ line="1623">the set of attributes that apply to @text.</doc>
2182121940 <type name="AttrList" c:type="PangoAttrList*"/>
2182221941 </parameter>
2182321942 <parameter name="cached_iter"
@@ -21826,7 +21945,7 @@ The base direction is used when computing bidirectional levels.
2182621945 allow-none="1">
2182721946 <doc xml:space="preserve"
2182821947 filename="pango/itemize.c"
21829- line="1607">Cached attribute iterator</doc>
21948+ line="1624">Cached attribute iterator</doc>
2183021949 <type name="AttrIterator" c:type="PangoAttrIterator*"/>
2183121950 </parameter>
2183221951 </parameters>
@@ -22255,7 +22374,7 @@ for @error.</doc>
2225522374 <function name="parse_stretch" c:identifier="pango_parse_stretch">
2225622375 <doc xml:space="preserve"
2225722376 filename="pango/fonts.c"
22258- line="1969">Parses a font stretch.
22377+ line="2033">Parses a font stretch.
2225922378
2226022379 The allowed values are
2226122380 "ultra_condensed", "extra_condensed", "condensed",
@@ -22266,14 +22385,14 @@ ignored and the '_' characters may be omitted.</doc>
2226622385 <return-value transfer-ownership="none">
2226722386 <doc xml:space="preserve"
2226822387 filename="pango/fonts.c"
22269- line="1983">%TRUE if @str was successfully parsed.</doc>
22388+ line="2047">%TRUE if @str was successfully parsed.</doc>
2227022389 <type name="gboolean" c:type="gboolean"/>
2227122390 </return-value>
2227222391 <parameters>
2227322392 <parameter name="str" transfer-ownership="none">
2227422393 <doc xml:space="preserve"
2227522394 filename="pango/fonts.c"
22276- line="1971">a string to parse.</doc>
22395+ line="2035">a string to parse.</doc>
2227722396 <type name="utf8" c:type="const char*"/>
2227822397 </parameter>
2227922398 <parameter name="stretch"
@@ -22282,13 +22401,13 @@ ignored and the '_' characters may be omitted.</doc>
2228222401 transfer-ownership="full">
2228322402 <doc xml:space="preserve"
2228422403 filename="pango/fonts.c"
22285- line="1972">a `PangoStretch` to store the result in.</doc>
22404+ line="2036">a `PangoStretch` to store the result in.</doc>
2228622405 <type name="Stretch" c:type="PangoStretch*"/>
2228722406 </parameter>
2228822407 <parameter name="warn" transfer-ownership="none">
2228922408 <doc xml:space="preserve"
2229022409 filename="pango/fonts.c"
22291- line="1973">if %TRUE, issue a g_warning() on bad input.</doc>
22410+ line="2037">if %TRUE, issue a g_warning() on bad input.</doc>
2229222411 <type name="gboolean" c:type="gboolean"/>
2229322412 </parameter>
2229422413 </parameters>
@@ -22296,7 +22415,7 @@ ignored and the '_' characters may be omitted.</doc>
2229622415 <function name="parse_style" c:identifier="pango_parse_style">
2229722416 <doc xml:space="preserve"
2229822417 filename="pango/fonts.c"
22299- line="1903">Parses a font style.
22418+ line="1967">Parses a font style.
2230022419
2230122420 The allowed values are "normal", "italic" and "oblique", case
2230222421 variations being
@@ -22305,14 +22424,14 @@ ignored.</doc>
2230522424 <return-value transfer-ownership="none">
2230622425 <doc xml:space="preserve"
2230722426 filename="pango/fonts.c"
22308- line="1915">%TRUE if @str was successfully parsed.</doc>
22427+ line="1979">%TRUE if @str was successfully parsed.</doc>
2230922428 <type name="gboolean" c:type="gboolean"/>
2231022429 </return-value>
2231122430 <parameters>
2231222431 <parameter name="str" transfer-ownership="none">
2231322432 <doc xml:space="preserve"
2231422433 filename="pango/fonts.c"
22315- line="1905">a string to parse.</doc>
22434+ line="1969">a string to parse.</doc>
2231622435 <type name="utf8" c:type="const char*"/>
2231722436 </parameter>
2231822437 <parameter name="style"
@@ -22321,13 +22440,13 @@ ignored.</doc>
2232122440 transfer-ownership="full">
2232222441 <doc xml:space="preserve"
2232322442 filename="pango/fonts.c"
22324- line="1906">a `PangoStyle` to store the result in.</doc>
22443+ line="1970">a `PangoStyle` to store the result in.</doc>
2232522444 <type name="Style" c:type="PangoStyle*"/>
2232622445 </parameter>
2232722446 <parameter name="warn" transfer-ownership="none">
2232822447 <doc xml:space="preserve"
2232922448 filename="pango/fonts.c"
22330- line="1907">if %TRUE, issue a g_warning() on bad input.</doc>
22449+ line="1971">if %TRUE, issue a g_warning() on bad input.</doc>
2233122450 <type name="gboolean" c:type="gboolean"/>
2233222451 </parameter>
2233322452 </parameters>
@@ -22335,7 +22454,7 @@ ignored.</doc>
2233522454 <function name="parse_variant" c:identifier="pango_parse_variant">
2233622455 <doc xml:space="preserve"
2233722456 filename="pango/fonts.c"
22338- line="1925">Parses a font variant.
22457+ line="1989">Parses a font variant.
2233922458
2234022459 The allowed values are "normal", "small-caps", "all-small-caps",
2234122460 "petite-caps", "all-petite-caps", "unicase" and "title-caps",
@@ -22344,14 +22463,14 @@ case variations being ignored.</doc>
2234422463 <return-value transfer-ownership="none">
2234522464 <doc xml:space="preserve"
2234622465 filename="pango/fonts.c"
22347- line="1937">%TRUE if @str was successfully parsed.</doc>
22466+ line="2001">%TRUE if @str was successfully parsed.</doc>
2234822467 <type name="gboolean" c:type="gboolean"/>
2234922468 </return-value>
2235022469 <parameters>
2235122470 <parameter name="str" transfer-ownership="none">
2235222471 <doc xml:space="preserve"
2235322472 filename="pango/fonts.c"
22354- line="1927">a string to parse.</doc>
22473+ line="1991">a string to parse.</doc>
2235522474 <type name="utf8" c:type="const char*"/>
2235622475 </parameter>
2235722476 <parameter name="variant"
@@ -22360,13 +22479,13 @@ case variations being ignored.</doc>
2236022479 transfer-ownership="full">
2236122480 <doc xml:space="preserve"
2236222481 filename="pango/fonts.c"
22363- line="1928">a `PangoVariant` to store the result in.</doc>
22482+ line="1992">a `PangoVariant` to store the result in.</doc>
2236422483 <type name="Variant" c:type="PangoVariant*"/>
2236522484 </parameter>
2236622485 <parameter name="warn" transfer-ownership="none">
2236722486 <doc xml:space="preserve"
2236822487 filename="pango/fonts.c"
22369- line="1929">if %TRUE, issue a g_warning() on bad input.</doc>
22488+ line="1993">if %TRUE, issue a g_warning() on bad input.</doc>
2237022489 <type name="gboolean" c:type="gboolean"/>
2237122490 </parameter>
2237222491 </parameters>
@@ -22374,7 +22493,7 @@ case variations being ignored.</doc>
2237422493 <function name="parse_weight" c:identifier="pango_parse_weight">
2237522494 <doc xml:space="preserve"
2237622495 filename="pango/fonts.c"
22377- line="1947">Parses a font weight.
22496+ line="2011">Parses a font weight.
2237822497
2237922498 The allowed values are "heavy",
2238022499 "ultrabold", "bold", "normal", "light", "ultraleight"
@@ -22383,14 +22502,14 @@ and integers. Case variations are ignored.</doc>
2238322502 <return-value transfer-ownership="none">
2238422503 <doc xml:space="preserve"
2238522504 filename="pango/fonts.c"
22386- line="1959">%TRUE if @str was successfully parsed.</doc>
22505+ line="2023">%TRUE if @str was successfully parsed.</doc>
2238722506 <type name="gboolean" c:type="gboolean"/>
2238822507 </return-value>
2238922508 <parameters>
2239022509 <parameter name="str" transfer-ownership="none">
2239122510 <doc xml:space="preserve"
2239222511 filename="pango/fonts.c"
22393- line="1949">a string to parse.</doc>
22512+ line="2013">a string to parse.</doc>
2239422513 <type name="utf8" c:type="const char*"/>
2239522514 </parameter>
2239622515 <parameter name="weight"
@@ -22399,13 +22518,13 @@ and integers. Case variations are ignored.</doc>
2239922518 transfer-ownership="full">
2240022519 <doc xml:space="preserve"
2240122520 filename="pango/fonts.c"
22402- line="1950">a `PangoWeight` to store the result in.</doc>
22521+ line="2014">a `PangoWeight` to store the result in.</doc>
2240322522 <type name="Weight" c:type="PangoWeight*"/>
2240422523 </parameter>
2240522524 <parameter name="warn" transfer-ownership="none">
2240622525 <doc xml:space="preserve"
2240722526 filename="pango/fonts.c"
22408- line="1951">if %TRUE, issue a g_warning() on bad input.</doc>
22527+ line="2015">if %TRUE, issue a g_warning() on bad input.</doc>
2240922528 <type name="gboolean" c:type="gboolean"/>
2241022529 </parameter>
2241122530 </parameters>
@@ -23081,7 +23200,7 @@ See that functions for details about the format.</doc>
2308123200 version="1.44">
2308223201 <doc xml:space="preserve"
2308323202 filename="pango/break.c"
23084- line="2496">Apply language-specific tailoring to the breaks in @attrs.
23203+ line="2477">Apply language-specific tailoring to the breaks in @attrs.
2308523204
2308623205 The line breaks are assumed to have been produced by [func@Pango.default_break].
2308723206
@@ -23098,25 +23217,25 @@ to apply attributes to the whole paragraph.</doc>
2309823217 <parameter name="text" transfer-ownership="none">
2309923218 <doc xml:space="preserve"
2310023219 filename="pango/break.c"
23101- line="2498">text to process. Must be valid UTF-8</doc>
23220+ line="2479">text to process. Must be valid UTF-8</doc>
2310223221 <type name="utf8" c:type="const char*"/>
2310323222 </parameter>
2310423223 <parameter name="length" transfer-ownership="none">
2310523224 <doc xml:space="preserve"
2310623225 filename="pango/break.c"
23107- line="2499">length in bytes of @text</doc>
23226+ line="2480">length in bytes of @text</doc>
2310823227 <type name="gint" c:type="int"/>
2310923228 </parameter>
2311023229 <parameter name="analysis" transfer-ownership="none">
2311123230 <doc xml:space="preserve"
2311223231 filename="pango/break.c"
23113- line="2500">`PangoAnalysis` for @text</doc>
23232+ line="2481">`PangoAnalysis` for @text</doc>
2311423233 <type name="Analysis" c:type="PangoAnalysis*"/>
2311523234 </parameter>
2311623235 <parameter name="offset" transfer-ownership="none">
2311723236 <doc xml:space="preserve"
2311823237 filename="pango/break.c"
23119- line="2501">Byte offset of @text from the beginning of the
23238+ line="2482">Byte offset of @text from the beginning of the
2312023239 paragraph, or -1 to ignore attributes from @analysis</doc>
2312123240 <type name="gint" c:type="int"/>
2312223241 </parameter>
@@ -23126,7 +23245,7 @@ to apply attributes to the whole paragraph.</doc>
2312623245 transfer-ownership="none">
2312723246 <doc xml:space="preserve"
2312823247 filename="pango/break.c"
23129- line="2503">array with one
23248+ line="2484">array with one
2313023249 `PangoLogAttr` per character in @text, plus one extra, to be filled in</doc>
2313123250 <array length="5" zero-terminated="0" c:type="PangoLogAttr*">
2313223251 <type name="LogAttr" c:type="PangoLogAttr"/>
@@ -23135,7 +23254,7 @@ to apply attributes to the whole paragraph.</doc>
2313523254 <parameter name="attrs_len" transfer-ownership="none">
2313623255 <doc xml:space="preserve"
2313723256 filename="pango/break.c"
23138- line="2505">length of @attrs array</doc>
23257+ line="2486">length of @attrs array</doc>
2313923258 <type name="gint" c:type="int"/>
2314023259 </parameter>
2314123260 </parameters>
M internal/gir/spec/PangoCairo-1.0.gir +1 -1
@@ -12,7 +12,7 @@ and/or use gtk-doc annotations. -->
1212 <include name="cairo" version="1.0"/>
1313 <package name="pangocairo"/>
1414 <c:include name="pango/pangocairo.h"/>
15- <doc:format name="unknown"/>
15+ <doc:format name="gi-docgen"/>
1616 <namespace name="PangoCairo"
1717 version="1.0"
1818 shared-library="libpangocairo-1.0.so.0"
M internal/gir/spec/cairo-1.0.gir +24 -0
@@ -3,6 +3,7 @@
33 xmlns="http://www.gtk.org/introspection/core/1.0"
44 xmlns:c="http://www.gtk.org/introspection/c/1.0"
55 xmlns:glib="http://www.gtk.org/introspection/glib/1.0">
6+ <include name="GObject" version="2.0"/>
67 <package name="cairo-gobject"/>
78 <c:include name="cairo-gobject.h"/>
89 <namespace name="cairo" version="1.0"
@@ -677,6 +678,29 @@
677678 <type name="gint" c:type="gint"/>
678679 </field>
679680 </record>
681+ <record name="Glyph" c:type="cairo_glyph_t"
682+ glib:type-name="CairoGlyph"
683+ glib:get-type="cairo_gobject_glyph_get_type">
684+ <field name="index" writable="1">
685+ <type name="gulong" c:type="unsigned long"/>
686+ </field>
687+ <field name="x" writable="1">
688+ <type name="gdouble" c:type="double"/>
689+ </field>
690+ <field name="y" writable="1">
691+ <type name="gdouble" c:type="double"/>
692+ </field>
693+ </record>
694+ <record name="TextCluster" c:type="cairo_text_cluster_t"
695+ glib:type-name="CairoTextCluster"
696+ glib:get-type="cairo_gobject_text_cluster_get_type">
697+ <field name="num_bytes" writable="1">
698+ <type name="gint" c:type="int"/>
699+ </field>
700+ <field name="num_glyphs" writable="1">
701+ <type name="gint" c:type="int"/>
702+ </field>
703+ </record>
680704 <function name="image_surface_create" c:identifier="cairo_image_surface_create">
681705 <return-value transfer-ownership="none">
682706 <type name="none" c:type="void"/>

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 1

Tags 102

↑↓ moveenter openesc close