Skip to content

Commit 1e4656c

Browse files
Update GIR files
1 parent ced5802 commit 1e4656c

File tree

4 files changed

+145
-137
lines changed

4 files changed

+145
-137
lines changed

GLib-2.0.gir

Lines changed: 43 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -4937,7 +4937,7 @@ declared or defined. The functions should be similar to
49374937
respectively, but they should receive the private data type instead
49384938
of #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

62896289
This function is not appropriate for file formats and the like; it
62906290
isn'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.
65576557
Works just like the platform's C library strftime() function,
65586558
but only accepts date-related formats; time-related formats
65596559
give 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
93409340
following 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
1573615736
current 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
1573815738
started in this thread to run under @context and deliver their
1573915739
results to its main loop, rather than running under the global
1574015740
default 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
1878718787
this function will produce help output to stdout and
1878818788
call `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"&gt;
3259632596
&lt;/picture&gt;</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
3262132621
accessed 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.
4548145481
Works just like the platform's C library strftime() function,
4548245482
but only accepts date-related formats; time-related formats
4548345483
give 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
4653446534
filenames. Note that on Windows GLib uses UTF-8 for filenames;
4653546535
on other platforms, this function indirectly depends on the
46536-
[current locale][setlocale].
46536+
[current locale](running.html#locale).
4653746537

4653846538
The input string shall not contain nul characters even if the @len
4653946539
argument 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
4659946599
filenames into a UTF-8 string. Note that on Windows GLib uses UTF-8
4660046600
for filenames; on other platforms, this function indirectly depends on
46601-
the [current locale][setlocale].
46601+
the [current locale](running.html#locale).
4660246602

4660346603
The input string shall not contain nul characters even if the @len
4660446604
argument 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
4691846918
from the current locale's encoding to some other encoding. (Frequently
4691946919
g_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
4704747047
and 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).
4705247052
If `G_FILENAME_ENCODING` is not set, but `G_BROKEN_FILENAMES` is,
4705347053
the character set of the current locale is taken as the filename
4705447054
encoding. 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
4895948959
the 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

4896348963
The input string shall not contain nul characters even if the @len
4896448964
argument 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
4900549005
the 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

4900849008
If the source encoding is not UTF-8 and the conversion output contains a
4900949009
nul character, the error %G_CONVERT_ERROR_EMBEDDED_NUL is set and the
@@ -53910,7 +53910,7 @@ been allocated from the slice allocator.
5391053910
It calls g_slice_free1() using `sizeof (type)`
5391153911
as the block size.
5391253912
Note 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

5391553915
If @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
5393053930
The memory must have been allocated via g_slice_alloc() or
5393153931
g_slice_alloc0() and the @block_size has to match the size
5393253932
specified 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
5393453934
variable.
5393553935

5393653936
If @mem_block is %NULL, this function does nothing.
@@ -53959,7 +53959,7 @@ g_slice_alloc() or g_slice_alloc0() and linked together by
5395953959
a @next pointer (similar to #GSList). The name of the
5396053960
@next field in @type is passed as third argument.
5396153961
Note 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

5396453964
If @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
5398553985
field in each block is passed as third argument.
5398653986
Note 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

5398953989
If @mem_chain is %NULL, this function does nothing.
5399053990

@@ -57535,7 +57535,7 @@ including the call to [[email protected]_trap_subprocess], unless
5753557535
behaviour 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.
5754657546
See [[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>
@@ -57557,7 +57557,7 @@ See [[email protected]_trap_subprocess].</doc>
5755757557
See [[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.
5756857568
See [[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).
6072160721
When sorting a large number of strings, it will be significantly
6072260722
faster to obtain collation keys with g_utf8_collate_key() and
6072360723
compare the keys with strcmp() when sorting instead of sorting
@@ -60751,7 +60751,7 @@ The results of comparing the collation keys of two strings
6075160751
with strcmp() will always be the same as comparing the two
6075260752
original 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

6075660756
Note that the returned string is not guaranteed to be in any
6075760757
encoding, especially UTF-8. The returned value is meant to be
@@ -60784,7 +60784,7 @@ insignificant, thus producing the ordering "event.c" "eventgenerator.c"
6078460784
would like to treat numbers intelligently so that "file1" "file10" "file5"
6078560785
is 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

6078960789
Note that the returned string is not guaranteed to be in any
6079060790
encoding, especially UTF-8. The returned value is meant to be

GModule-2.0.gir

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -747,7 +747,7 @@ and/or use gtk-doc annotations. -->
747747
</constant>
748748
<record name="Module" c:type="GModule" disguised="1" opaque="1">
749749
<doc xml:space="preserve">The #GModule struct is an opaque data structure to represent a
750-
[dynamically-loaded module][glib-Dynamic-Loading-of-Modules].
750+
[dynamically-loaded module](modules.html#dynamic-loading-of-modules).
751751
It should only be accessed via the following functions.</doc>
752752
<method name="close" c:identifier="g_module_close">
753753
<doc xml:space="preserve">Closes a module.</doc>

0 commit comments

Comments
 (0)