mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2025-08-11 11:44:03 +02:00
doc builds.
This commit is contained in:
@@ -276,5 +276,6 @@ If @free_segment is %TRUE it frees the actual element data as well.
|
||||
|
||||
@array: a #GArray.
|
||||
@free_segment: if %TRUE the actual element data is freed as well.
|
||||
@Returns:
|
||||
|
||||
|
||||
|
@@ -164,5 +164,6 @@ If free_segment is %TRUE it frees the actual byte data.
|
||||
|
||||
@array: a #GByteArray.
|
||||
@free_segment: if %TRUE the actual byte data is freed as well.
|
||||
@Returns:
|
||||
|
||||
|
||||
|
@@ -207,5 +207,6 @@ Frees all of the memory allocated for the pointer array.
|
||||
|
||||
@array: a #GPtrArray.
|
||||
@free_seg: if %TRUE the actual element data is freed as well.
|
||||
@Returns:
|
||||
|
||||
|
||||
|
@@ -556,7 +556,6 @@ Returns %TRUE if the date is the last day of the month. The date must be valid.
|
||||
@Returns: %TRUE if the date is the last day of the month.
|
||||
|
||||
|
||||
|
||||
<!-- ##### FUNCTION g_date_is_leap_year ##### -->
|
||||
<para>
|
||||
Returns %TRUE if the year is a leap year.
|
||||
|
@@ -131,6 +131,14 @@ not work.
|
||||
</para>
|
||||
|
||||
|
||||
<!-- ##### MACRO NAME_MAX ##### -->
|
||||
<para>
|
||||
Provided for UNIX emulation on Windows; equivalent to UNIX macro
|
||||
%NAME_MAX, which is the maximum length of a single path component.
|
||||
i.e. just the <filename>foo</filename> in <filename>/usr/bin/foo</filename>.
|
||||
</para>
|
||||
|
||||
|
||||
<!-- ##### MACRO access ##### -->
|
||||
<para>
|
||||
|
||||
@@ -171,6 +179,13 @@ not work.
|
||||
|
||||
@Returns:
|
||||
|
||||
<!-- ##### FUNCTION g_io_channel_error_quark ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@Returns:
|
||||
|
||||
<!-- ##### FUNCTION g_main_add_poll ##### -->
|
||||
<para>
|
||||
Adds a file descriptor to be polled.
|
||||
@@ -378,6 +393,13 @@ Turns the argument into a string literal by using the '#' stringizing operator.
|
||||
</para>
|
||||
|
||||
|
||||
<!-- ##### MACRO readdir ##### -->
|
||||
<para>
|
||||
Provided for UNIX emulation on Windows; see documentation for <function>readdir()</function>
|
||||
in any UNIX manual.
|
||||
</para>
|
||||
|
||||
|
||||
<!-- ##### MACRO write ##### -->
|
||||
<para>
|
||||
|
||||
|
@@ -67,7 +67,6 @@ function.</entry>
|
||||
@hook_memchunk:
|
||||
@finalize_hook:
|
||||
|
||||
|
||||
<!-- ##### USER_FUNCTION GHookFinalizeFunc ##### -->
|
||||
<para>
|
||||
Defines the type of function to be called when a hook in a
|
||||
|
@@ -308,14 +308,6 @@ error domains.
|
||||
|
||||
|
||||
|
||||
<!-- ##### FUNCTION g_io_channel_error_quark ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION g_io_channel_error_from_errno ##### -->
|
||||
<para>
|
||||
|
||||
|
@@ -77,6 +77,7 @@ yourself, because this macro may use <function>memmove()</function> and GLib
|
||||
does not include <function>string.h</function> for you.
|
||||
</para>
|
||||
|
||||
<!-- # Unused Parameters # -->
|
||||
@ap1: the <type>va_list</type> variable to place a copy of @ap2 in.
|
||||
@ap2: a <type>va_list</type>.
|
||||
|
||||
@@ -98,6 +99,23 @@ when compiling with the <literal>-pedantic</literal> option.
|
||||
|
||||
|
||||
|
||||
<!-- ##### MACRO G_GNUC_CONST ##### -->
|
||||
<para>
|
||||
Expands to the GNU C const function attribute if the compiler is GNU C.
|
||||
Declaring a function as const enables better optimization of the function.
|
||||
A const function doesn't examine any values except its parameters,
|
||||
and has no effects except its return value.
|
||||
See the GNU C documentation for details.
|
||||
</para>
|
||||
<note><para>
|
||||
A function that has pointer arguments and examines the data pointed to
|
||||
must <emphasis>not</emphasis> be declared const. Likewise, a function that
|
||||
calls a non-const function usually must not be const. It doesn't make sense
|
||||
for a const function to return void.
|
||||
</para></note>
|
||||
|
||||
|
||||
|
||||
<!-- ##### MACRO G_GNUC_NORETURN ##### -->
|
||||
<para>
|
||||
Expands to the GNU C noreturn function attribute if the compiler is GNU C.
|
||||
@@ -127,21 +145,6 @@ See the GNU C documentation for details.
|
||||
</para>
|
||||
|
||||
|
||||
<!-- ##### MACRO G_GNUC_CONST ##### -->
|
||||
<para>
|
||||
Expands to the GNU C const function attribute if the compiler is GNU C.
|
||||
Declaring a function as const enables better optimization of the function.
|
||||
A const function doesn't examine any values except its parameters,
|
||||
and has no effects except its return value.
|
||||
See the GNU C documentation for details.
|
||||
</para>
|
||||
<note><para>
|
||||
A function that has pointer arguments and examines the data pointed to
|
||||
must <emphasis>not</emphasis> be declared const. Likewise, a function that
|
||||
calls a non-const function usually must not be const. It doesn't make sense
|
||||
for a const function to return void.
|
||||
</para></note>
|
||||
|
||||
|
||||
<!-- ##### MACRO G_GNUC_PRINTF ##### -->
|
||||
<para>
|
||||
|
@@ -220,3 +220,4 @@ previously installed the #glib_mem_profiler_table with g_mem_set_vtable().
|
||||
</para>
|
||||
|
||||
|
||||
|
||||
|
@@ -24,6 +24,7 @@ g_pattern_spec_new() and use g_pattern_match_string() instead of
|
||||
g_pattern_match_simple(). This avoids the overhead of repeated
|
||||
pattern compilation.
|
||||
</para>
|
||||
|
||||
<!-- ##### SECTION See_Also ##### -->
|
||||
<para>
|
||||
|
||||
@@ -102,3 +103,5 @@ Matches a string against a pattern.
|
||||
@pattern: the pattern.
|
||||
@string: the string to match.
|
||||
@Returns: %TRUE if @string matches @pspec.
|
||||
|
||||
|
||||
|
@@ -356,7 +356,6 @@ value of each pair, and the given @user_data parameter.
|
||||
@user_data: user data to pass to the function.
|
||||
|
||||
|
||||
|
||||
<!-- ##### FUNCTION g_scanner_scope_lookup_symbol ##### -->
|
||||
<para>
|
||||
Looks up a symbol in a scope and return its value. If the
|
||||
@@ -478,30 +477,8 @@ The possible types of token returned from each g_scanner_get_next_token() call.
|
||||
|
||||
@G_TOKEN_EOF: the end of the file.
|
||||
@G_TOKEN_LEFT_PAREN: a '(' character.
|
||||
@G_TOKEN_RIGHT_PAREN: a ')' character.
|
||||
@G_TOKEN_LEFT_CURLY: a '{' character.
|
||||
@G_TOKEN_RIGHT_CURLY: a '}' character.
|
||||
@G_TOKEN_LEFT_BRACE: a '[' character.
|
||||
@G_TOKEN_RIGHT_BRACE: a ']' character.
|
||||
@G_TOKEN_EQUAL_SIGN: a '=' character.
|
||||
@G_TOKEN_COMMA: a ',' character.
|
||||
@G_TOKEN_NONE: no token.
|
||||
@G_TOKEN_ERROR: an error. See #GErrorType for a list of possible errors.
|
||||
@G_TOKEN_CHAR: a character without special meaning.
|
||||
@G_TOKEN_BINARY: an integer, specified in binary notation with a '0b' prefix.
|
||||
@G_TOKEN_OCTAL: an integer, specified in octal notation with a '0' prefix.
|
||||
@G_TOKEN_INT: an integer, specified in the usual decimal notation.
|
||||
@G_TOKEN_HEX: an integer, specified in hexadecimal notation with a '0x' or '$' prefix.
|
||||
@G_TOKEN_FLOAT: a floating point number.
|
||||
@G_TOKEN_STRING: a string enclosed in single or double quotes.
|
||||
@G_TOKEN_SYMBOL: a symbol which has been defined before.
|
||||
@G_TOKEN_IDENTIFIER: an identifier.
|
||||
@G_TOKEN_IDENTIFIER_NULL: the special identifier <literal>NULL</literal>.
|
||||
@G_TOKEN_COMMENT_SINGLE: a single-line comment enclosed in the delimiters
|
||||
specified by <structfield>cpair_comment_single</structfield>.
|
||||
@G_TOKEN_COMMENT_MULTI: a multi-line comment enclosed in '/*' and '*/'.
|
||||
@G_TOKEN_LAST:
|
||||
|
||||
|
||||
<!-- ##### UNION GTokenValue ##### -->
|
||||
<para>
|
||||
|
@@ -1619,3 +1619,4 @@ you should also free the #GStaticPrivate.
|
||||
|
||||
@private_key: a #GStaticPrivate to be freed.
|
||||
|
||||
|
||||
|
@@ -31,9 +31,8 @@ Unicode Manipulation
|
||||
|
||||
</para>
|
||||
|
||||
@Returns:
|
||||
<!-- # Unused Parameters # -->
|
||||
@charset:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION g_unichar_validate ##### -->
|
||||
|
@@ -23,15 +23,6 @@ macro %MAXPATHLEN, which is the maximum length of a filename
|
||||
|
||||
|
||||
|
||||
<!-- ##### MACRO NAME_MAX ##### -->
|
||||
<para>
|
||||
Provided for UNIX emulation on Windows; equivalent to UNIX macro
|
||||
%NAME_MAX, which is the maximum length of a single path component.
|
||||
i.e. just the <filename>foo</filename> in <filename>/usr/bin/foo</filename>.
|
||||
</para>
|
||||
|
||||
|
||||
|
||||
<!-- ##### TYPEDEF pid_t ##### -->
|
||||
<para>
|
||||
Provided for UNIX emulation on Windows; process ID type.
|
||||
@@ -57,36 +48,33 @@ in any UNIX manual.
|
||||
@size:
|
||||
|
||||
|
||||
<!-- ##### MACRO opendir ##### -->
|
||||
<!-- ##### FUNCTION opendir ##### -->
|
||||
<para>
|
||||
Provided for UNIX emulation on Windows; see documentation for <function>opendir()</function>
|
||||
in any UNIX manual.
|
||||
</para>
|
||||
|
||||
@Param1:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### MACRO readdir ##### -->
|
||||
<para>
|
||||
Provided for UNIX emulation on Windows; see documentation for <function>readdir()</function>
|
||||
in any UNIX manual.
|
||||
</para>
|
||||
|
||||
|
||||
|
||||
<!-- ##### MACRO rewinddir ##### -->
|
||||
<!-- ##### FUNCTION rewinddir ##### -->
|
||||
<para>
|
||||
Provided for UNIX emulation on Windows; see documentation for <function>rewinddir()</function>
|
||||
in any UNIX manual.
|
||||
</para>
|
||||
|
||||
@Param1:
|
||||
|
||||
|
||||
<!-- ##### MACRO closedir ##### -->
|
||||
<!-- ##### FUNCTION closedir ##### -->
|
||||
<para>
|
||||
Provided for UNIX emulation on Windows; see documentation for <function>closedir()</function>
|
||||
in any UNIX manual.
|
||||
</para>
|
||||
|
||||
@Param1:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION g_win32_error_message ##### -->
|
||||
|
@@ -188,6 +188,8 @@ The predefined identifiers of the reserved fundamental types.
|
||||
@G_TYPE_UINT: Identifier for the built-in type "guint".
|
||||
@G_TYPE_LONG: Identifier for the built-in type "glong".
|
||||
@G_TYPE_ULONG: Identifier for the built-in type "gulong".
|
||||
@G_TYPE_INT64:
|
||||
@G_TYPE_UINT64:
|
||||
@G_TYPE_ENUM: Identifier for the "#GEnum" type.
|
||||
@G_TYPE_FLAGS: Identifier for the "#GFlags" type.
|
||||
@G_TYPE_FLOAT: Identifier for the built-in type "gfloat".
|
||||
@@ -223,6 +225,8 @@ The predefined identifiers of the reserved fundamental types.
|
||||
@G_TYPE_PARAM_VALUE_ARRAY: Identifier for the "#GParamSpecValueArray" type.
|
||||
@G_TYPE_PARAM_CLOSURE: Identifier for the "#GParamClosure" type.
|
||||
@G_TYPE_PARAM_OBJECT: Identifier for the "#GParamSpecObject" type.
|
||||
@G_TYPE_PARAM_INT64:
|
||||
@G_TYPE_PARAM_UINT64:
|
||||
|
||||
<!-- ##### STRUCT GTypeInterface ##### -->
|
||||
<para>
|
||||
|
Reference in New Issue
Block a user