@@ -4937,7 +4937,7 @@ declared or defined. The functions should be similar to
49374937respectively, but they should receive the private data type instead
49384938of #GError.
49394939
4940- See [Extended #GError Domains][gerror- extended-domains] for an example.</doc>
4940+ See [Extended #GError Domains](error-reporting.html# extended-gerror- domains) for an example.</doc>
49414941 <parameters>
49424942 <parameter name="ErrorType">
49434943 <doc xml:space="preserve">name to return a #GQuark for</doc>
@@ -6281,10 +6281,10 @@ day-month-year triplet is invalid, the date will be invalid.</doc>
62816281 </method>
62826282 <method name="set_parse" c:identifier="g_date_set_parse">
62836283 <doc xml:space="preserve">Parses a user-inputted string @str, and try to figure out what date it
6284- represents, taking the [current locale][setlocale] into account. If the
6285- string is successfully parsed, the date will be valid after the call.
6286- Otherwise, it will be invalid. You should check using g_date_valid()
6287- to see whether the parsing succeeded.
6284+ represents, taking the [current locale](running.html#locale)
6285+ into account. If the string is successfully parsed, the date will be
6286+ valid after the call. Otherwise, it will be invalid. You should check
6287+ using g_date_valid() to see whether the parsing succeeded.
62886288
62896289This function is not appropriate for file formats and the like; it
62906290isn't very precise, and its exact behavior varies with the locale.
@@ -6553,7 +6553,7 @@ is also divisible by 400.</doc>
65536553 </function>
65546554 <function name="strftime" c:identifier="g_date_strftime">
65556555 <doc xml:space="preserve">Generates a printed representation of the date, in a
6556- [locale][setlocale] -specific way.
6556+ [locale](running.html#locale) -specific way.
65576557Works just like the platform's C library strftime() function,
65586558but only accepts date-related formats; time-related formats
65596559give undefined results. Date must be valid. Unlike strftime()
@@ -9336,7 +9336,7 @@ must be an element of randomness that an attacker is unable to guess.</doc>
93369336 </callback>
93379337 <record name="HashTable" c:type="GHashTable" opaque="1" glib:type-name="GHashTable" glib:get-type="g_hash_table_get_type" c:symbol-prefix="hash_table">
93389338 <doc xml:space="preserve">The #GHashTable struct is an opaque data structure to represent a
9339- [Hash Table][glib-Hash-Tables] . It should only be accessed via the
9339+ [Hash Table](data-structures.html#hash-tables) . It should only be accessed via the
93409340following functions.</doc>
93419341 <function name="add" c:identifier="g_hash_table_add" version="2.32">
93429342 <doc xml:space="preserve">This is a convenience function for using a #GHashTable as a set. It
@@ -14196,7 +14196,7 @@ Higher bits can be used for user-defined log levels.</doc>
1419614196 <field name="data" writable="1">
1419714197 <doc xml:space="preserve">holds the element's data, which can be a pointer to any kind
1419814198 of data, or any integer value using the
14199- [Type Conversion Macros][glib-Type-Conversion-Macros] </doc>
14199+ [Type Conversion Macros](conversion-macros.html#conversion-macros) </doc>
1420014200 <type name="gpointer" c:type="gpointer"/>
1420114201 </field>
1420214202 <field name="next" writable="1">
@@ -15734,7 +15734,7 @@ You must have successfully acquired the context with
1573415734 <method name="push_thread_default" c:identifier="g_main_context_push_thread_default" version="2.22">
1573515735 <doc xml:space="preserve">Acquires @context and sets it as the thread-default context for the
1573615736current thread. This will cause certain asynchronous operations
15737- (such as most [gio][ gio] -based I/O) which are
15737+ (such as most [Gio](../ gio/index.html) -based I/O) which are
1573815738started in this thread to run under @context and deliver their
1573915739results to its main loop, rather than running under the global
1574015740default main context in the main thread. Note that calling this function
@@ -17737,7 +17737,7 @@ arrays or arrays on the stack.</doc>
1773717737 </parameters>
1773817738 </function-macro>
1773917739 <record name="Node" c:type="GNode">
17740- <doc xml:space="preserve">The #GNode struct represents one node in a [n-ary tree][glib-N -ary-Trees] .</doc>
17740+ <doc xml:space="preserve">The #GNode struct represents one node in a [n-ary tree](data-structures.html#n -ary-trees) .</doc>
1774117741 <field name="data" writable="1">
1774217742 <doc xml:space="preserve">contains the actual data of the node.</doc>
1774317743 <type name="gpointer" c:type="gpointer"/>
@@ -18787,9 +18787,9 @@ If automatic `--help` support is enabled
1878718787this function will produce help output to stdout and
1878818788call `exit (0)`.
1878918789
18790- Note that function depends on the [current locale][setlocale] for
18791- automatic character set conversion of string and filename
18792- arguments.</doc>
18790+ Note that function depends on the
18791+ [current locale](running.html#locale) for automatic
18792+ character set conversion of string and filename arguments.</doc>
1879318793 <return-value transfer-ownership="none">
1879418794 <doc xml:space="preserve">%TRUE if the parsing was successful,
1879518795 %FALSE if an error occurred</doc>
@@ -21345,7 +21345,7 @@ is thread-safe and may be called from any thread.</doc>
2134521345 </record>
2134621346 <record name="Queue" c:type="GQueue">
2134721347 <doc xml:space="preserve">Contains the public fields of a
21348- [Queue][glib-Double -ended-Queues] .</doc>
21348+ [Queue](data-structures.html#double -ended-queues) .</doc>
2134921349 <field name="head" writable="1">
2135021350 <doc xml:space="preserve">a pointer to the first element of the queue</doc>
2135121351 <type name="GLib.List" c:type="GList*">
@@ -24480,7 +24480,7 @@ list.</doc>
2448024480 <field name="data" writable="1">
2448124481 <doc xml:space="preserve">holds the element's data, which can be a pointer to any kind
2448224482 of data, or any integer value using the
24483- [Type Conversion Macros][glib-Type-Conversion-Macros] </doc>
24483+ [Type Conversion Macros](conversion-macros.html#conversion-macros) </doc>
2448424484 <type name="gpointer" c:type="gpointer"/>
2448524485 </field>
2448624486 <field name="next" writable="1">
@@ -26096,7 +26096,7 @@ g_io_channel_seek_position() operation.</doc>
2609626096 </enumeration>
2609726097 <record name="Sequence" c:type="GSequence" disguised="1" opaque="1">
2609826098 <doc xml:space="preserve">The #GSequence struct is an opaque data type representing a
26099- [sequence][glib-Sequences] data type.</doc>
26099+ [sequence](data-structures.html#scalable-lists) data type.</doc>
2610026100 <method name="append" c:identifier="g_sequence_append" version="2.14">
2610126101 <doc xml:space="preserve">Adds a new item to the end of @seq.</doc>
2610226102 <return-value transfer-ownership="none">
@@ -32595,7 +32595,7 @@ The different orders are illustrated here:
3259532595 alt="Sorted binary tree, breadth-first level order traversal">
3259632596 </picture></doc>
3259732597 <member name="in_order" value="0" c:identifier="G_IN_ORDER">
32598- <doc xml:space="preserve">vists a node's left child first, then the node itself,
32598+ <doc xml:space="preserve">visits a node's left child first, then the node itself,
3259932599 then its right child. This is the one to use if you
3260032600 want the output sorted according to the compare
3260132601 function.</doc>
@@ -32608,16 +32608,16 @@ The different orders are illustrated here:
3260832608 </member>
3260932609 <member name="level_order" value="3" c:identifier="G_LEVEL_ORDER">
3261032610 <doc xml:space="preserve">is not implemented for
32611- [balanced binary trees][glib-Balanced-Binary-Trees] .
32612- For [n-ary trees][glib-N -ary-Trees] , it
32613- vists the root node first, then its children, then
32611+ [balanced binary trees](data-structures.html#binary-trees) .
32612+ For [n-ary trees](data-structures.html#n -ary-trees) , it
32613+ visits the root node first, then its children, then
3261432614 its grandchildren, and so on. Note that this is less
3261532615 efficient than the other orders.</doc>
3261632616 </member>
3261732617 </enumeration>
3261832618 <record name="Tree" c:type="GTree" opaque="1" glib:type-name="GTree" glib:get-type="g_tree_get_type" c:symbol-prefix="tree">
3261932619 <doc xml:space="preserve">The GTree struct is an opaque data structure representing a
32620- [balanced binary tree][glib-Balanced-Binary-Trees] . It should be
32620+ [balanced binary tree](data-structures.html#binary-trees) . It should be
3262132621accessed only by using the following functions.</doc>
3262232622 <constructor name="new" c:identifier="g_tree_new" introspectable="0">
3262332623 <doc xml:space="preserve">Creates a new #GTree.</doc>
@@ -33162,7 +33162,7 @@ If the key does not exist in the #GTree, the function does nothing.</doc>
3316233162 <doc-deprecated xml:space="preserve">The order of a balanced tree is somewhat arbitrary.
3316333163 If you just want to visit all nodes in sorted order, use
3316433164 g_tree_foreach() instead. If you really need to visit nodes in
33165- a different order, consider using an [n-ary tree][glib-N -ary-Trees] .</doc-deprecated>
33165+ a different order, consider using an [n-ary tree](data-structures.html#n -ary-trees) .</doc-deprecated>
3316633166 <return-value transfer-ownership="none">
3316733167 <type name="none" c:type="void"/>
3316833168 </return-value>
@@ -45477,7 +45477,7 @@ is also divisible by 400.</doc>
4547745477 </function>
4547845478 <function name="date_strftime" c:identifier="g_date_strftime" moved-to="Date.strftime">
4547945479 <doc xml:space="preserve">Generates a printed representation of the date, in a
45480- [locale][setlocale] -specific way.
45480+ [locale](running.html#locale) -specific way.
4548145481Works just like the platform's C library strftime() function,
4548245482but only accepts date-related formats; time-related formats
4548345483give undefined results. Date must be valid. Unlike strftime()
@@ -46533,7 +46533,7 @@ but we don't support the entire standard.</doc>
4653346533 <doc xml:space="preserve">Converts a string from UTF-8 to the encoding GLib uses for
4653446534filenames. Note that on Windows GLib uses UTF-8 for filenames;
4653546535on other platforms, this function indirectly depends on the
46536- [current locale][setlocale] .
46536+ [current locale](running.html#locale) .
4653746537
4653846538The input string shall not contain nul characters even if the @len
4653946539argument is positive. A nul character found inside the string will result
@@ -46598,7 +46598,7 @@ component following Section 3.3. of RFC 2396.</doc>
4659846598 <doc xml:space="preserve">Converts a string which is in the encoding used by GLib for
4659946599filenames into a UTF-8 string. Note that on Windows GLib uses UTF-8
4660046600for filenames; on other platforms, this function indirectly depends on
46601- the [current locale][setlocale] .
46601+ the [current locale](running.html#locale) .
4660246602
4660346603The input string shall not contain nul characters even if the @len
4660446604argument is positive. A nul character found inside the string will result
@@ -46913,8 +46913,8 @@ been called).</doc>
4691346913 </return-value>
4691446914 </function>
4691546915 <function name="get_charset" c:identifier="g_get_charset">
46916- <doc xml:space="preserve">Obtains the character set for the [current locale][setlocale]; you
46917- might use this character set as an argument to g_convert(), to convert
46916+ <doc xml:space="preserve">Obtains the character set for the [current locale](running.html#locale);
46917+ you might use this character set as an argument to g_convert(), to convert
4691846918from the current locale's encoding to some other encoding. (Frequently
4691946919g_locale_to_utf8() and g_locale_from_utf8() are nice shortcuts, though.)
4692046920
@@ -47047,8 +47047,8 @@ On Windows, the character set used in the GLib API is always UTF-8
4704747047and said environment variables have no effect.
4704847048
4704947049`G_FILENAME_ENCODING` may be set to a comma-separated list of
47050- character set names. The special token "\ @locale" is taken
47051- to mean the character set for the [current locale][setlocale] .
47050+ character set names. The special token ` @locale` is taken to mean the
47051+ character set for the [current locale](running.html#locale) .
4705247052If `G_FILENAME_ENCODING` is not set, but `G_BROKEN_FILENAMES` is,
4705347053the character set of the current locale is taken as the filename
4705447054encoding. If neither environment variable is set, UTF-8 is taken
@@ -48957,8 +48957,8 @@ the UTF-8 encoding that this function and g_getenv() provide.</doc>
4895748957 <function name="locale_from_utf8" c:identifier="g_locale_from_utf8" throws="1">
4895848958 <doc xml:space="preserve">Converts a string from UTF-8 to the encoding used for strings by
4895948959the C runtime (usually the same as that used by the operating
48960- system) in the [current locale][setlocale]. On Windows this means
48961- the system codepage.
48960+ system) in the [current locale](running.html#locale).
48961+ On Windows this means the system codepage.
4896248962
4896348963The input string shall not contain nul characters even if the @len
4896448964argument is positive. A nul character found inside the string will result
@@ -49003,7 +49003,7 @@ input that may contain embedded nul characters.</doc>
4900349003 <function name="locale_to_utf8" c:identifier="g_locale_to_utf8" throws="1">
4900449004 <doc xml:space="preserve">Converts a string which is in the encoding used for strings by
4900549005the C runtime (usually the same as that used by the operating
49006- system) in the [current locale][setlocale] into a UTF-8 string.
49006+ system) in the [current locale](running.html#locale) into a UTF-8 string.
4900749007
4900849008If the source encoding is not UTF-8 and the conversion output contains a
4900949009nul character, the error %G_CONVERT_ERROR_EMBEDDED_NUL is set and the
@@ -53910,7 +53910,7 @@ been allocated from the slice allocator.
5391053910It calls g_slice_free1() using `sizeof (type)`
5391153911as the block size.
5391253912Note that the exact release behaviour can be changed with the
53913- [`G_DEBUG=gc-friendly`][G_DEBUG] environment variable.
53913+ [`G_DEBUG=gc-friendly`](running.html#environment-variables) environment variable.
5391453914
5391553915If @mem is %NULL, this macro does nothing.
5391653916
@@ -53930,7 +53930,7 @@ Since GLib 2.76 this always uses the system free() implementation internally.</d
5393053930The memory must have been allocated via g_slice_alloc() or
5393153931g_slice_alloc0() and the @block_size has to match the size
5393253932specified upon allocation. Note that the exact release behaviour
53933- can be changed with the [`G_DEBUG=gc-friendly`][G_DEBUG] environment
53933+ can be changed with the [`G_DEBUG=gc-friendly`](running.html#environment-variables) environment
5393453934variable.
5393553935
5393653936If @mem_block is %NULL, this function does nothing.
@@ -53959,7 +53959,7 @@ g_slice_alloc() or g_slice_alloc0() and linked together by
5395953959a @next pointer (similar to #GSList). The name of the
5396053960@next field in @type is passed as third argument.
5396153961Note that the exact release behaviour can be changed with the
53962- [`G_DEBUG=gc-friendly`][G_DEBUG] environment variable.
53962+ [`G_DEBUG=gc-friendly`](running.html#environment-variables) environment variable.
5396353963
5396453964If @mem_chain is %NULL, this function does nothing.
5396553965
@@ -53984,7 +53984,7 @@ g_slice_alloc() or g_slice_alloc0() and linked together by a
5398453984@next pointer (similar to #GSList). The offset of the @next
5398553985field in each block is passed as third argument.
5398653986Note that the exact release behaviour can be changed with the
53987- [`G_DEBUG=gc-friendly`][G_DEBUG] environment variable.
53987+ [`G_DEBUG=gc-friendly`](running.html#environment-variables) environment variable.
5398853988
5398953989If @mem_chain is %NULL, this function does nothing.
5399053990
@@ -57535,7 +57535,7 @@ including the call to [
[email protected] _trap_subprocess], unless
5753557535behaviour may be tested.</doc>
5753657536 <parameters>
5753757537 <parameter name="serrpattern">
57538- <doc xml:space="preserve">a glob-style [pattern][glib-Glob-style-pattern-matching] </doc>
57538+ <doc xml:space="preserve">a string that follows glob-style [pattern][struct@PatternSpec] rules </doc>
5753957539 </parameter>
5754057540 </parameters>
5754157541 </function-macro>
@@ -57546,7 +57546,7 @@ does not match @serrpattern.
5754657546See [
[email protected] _trap_subprocess].</doc>
5754757547 <parameters>
5754857548 <parameter name="serrpattern">
57549- <doc xml:space="preserve">a glob-style [pattern][glib-Glob-style-pattern-matching] </doc>
57549+ <doc xml:space="preserve">a string that follows glob-style [pattern][struct@PatternSpec] rules </doc>
5755057550 </parameter>
5755157551 </parameters>
5755257552 </function-macro>
5755757557See [
[email protected] _trap_subprocess].</doc>
5755857558 <parameters>
5755957559 <parameter name="soutpattern">
57560- <doc xml:space="preserve">a glob-style [pattern][glib-Glob-style-pattern-matching] </doc>
57560+ <doc xml:space="preserve">a string that follows glob-style [pattern][struct@PatternSpec] rules </doc>
5756157561 </parameter>
5756257562 </parameters>
5756357563 </function-macro>
@@ -57568,7 +57568,7 @@ does not match @soutpattern.
5756857568See [
[email protected] _trap_subprocess].</doc>
5756957569 <parameters>
5757057570 <parameter name="soutpattern">
57571- <doc xml:space="preserve">a glob-style [pattern][glib-Glob-style-pattern-matching] </doc>
57571+ <doc xml:space="preserve">a string that follows glob-style [pattern][struct@PatternSpec] rules </doc>
5757257572 </parameter>
5757357573 </parameters>
5757457574 </function-macro>
@@ -60717,7 +60717,7 @@ provide such a function.</doc>
6071760717 </function>
6071860718 <function name="utf8_collate" c:identifier="g_utf8_collate">
6071960719 <doc xml:space="preserve">Compares two strings for ordering using the linguistically
60720- correct rules for the [current locale][setlocale] .
60720+ correct rules for the [current locale](running.html#locale) .
6072160721When sorting a large number of strings, it will be significantly
6072260722faster to obtain collation keys with g_utf8_collate_key() and
6072360723compare the keys with strcmp() when sorting instead of sorting
@@ -60751,7 +60751,7 @@ The results of comparing the collation keys of two strings
6075160751with strcmp() will always be the same as comparing the two
6075260752original keys with g_utf8_collate().
6075360753
60754- Note that this function depends on the [current locale][setlocale] .
60754+ Note that this function depends on the [current locale](running.html#locale) .
6075560755
6075660756Note that the returned string is not guaranteed to be in any
6075760757encoding, especially UTF-8. The returned value is meant to be
@@ -60784,7 +60784,7 @@ insignificant, thus producing the ordering "event.c" "eventgenerator.c"
6078460784would like to treat numbers intelligently so that "file1" "file10" "file5"
6078560785is sorted as "file1" "file5" "file10".
6078660786
60787- Note that this function depends on the [current locale][setlocale] .
60787+ Note that this function depends on the [current locale](running.html#locale) .
6078860788
6078960789Note that the returned string is not guaranteed to be in any
6079060790encoding, especially UTF-8. The returned value is meant to be
0 commit comments