luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-11-12 20:36:15 +01:00
Code Issues Packages Projects Releases Wiki Activity

Eradicate links and xrefs

Browse Source 
These are all replaced by markdown ref links.
This commit is contained in:
Matthias Clasen 2014-02-08 12:26:56 -05:00
parent 1448e619b5
commit e7fd3de86d
70 changed files with 460 additions and 521 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
gio/gapplication.c
View File

@ -2010,7 +2010,8 @@ g_application_open (GApplication *application,
* and override local_command_line(). In this case, you most likely want * and override local_command_line(). In this case, you most likely want
* to return %TRUE from your local_command_line() implementation to * to return %TRUE from your local_command_line() implementation to
* suppress the default handling. See * suppress the default handling. See
* <xref linkend="gapplication-example-cmdline2"/> for an example. * [gapplication-example-cmdline2.c][gapplication-example-cmdline2]
* for an example.
* *
* If, after the above is done, the use count of the application is zero * If, after the above is done, the use count of the application is zero
* then the exit status is returned immediately. If the use count is * then the exit status is returned immediately. If the use count is

3
gio/gapplicationcommandline.c
View File

@ -57,7 +57,8 @@
* The GApplicationCommandLine object can provide the @argc and @argv * The GApplicationCommandLine object can provide the @argc and @argv
* parameters for use with the #GOptionContext command-line parsing API, * parameters for use with the #GOptionContext command-line parsing API,
* with the g_application_command_line_get_arguments() function. See * with the g_application_command_line_get_arguments() function. See
* <xref linkend="gapplication-example-cmdline3"/> for an example. * [gapplication-example-cmdline3.c][gapplication-example-cmdline3]
* for an example.
* *
* The exit status of the originally-invoked process may be set and * The exit status of the originally-invoked process may be set and
* messages can be printed to stdout or stderr of that process. The * messages can be printed to stdout or stderr of that process. The

12
gio/gasyncinitable.c
View File

@ -156,8 +156,7 @@ g_async_initable_default_init (GAsyncInitableInterface *iface)
/** /**
* g_async_initable_init_async: * g_async_initable_init_async:
* @initable: a #GAsyncInitable. * @initable: a #GAsyncInitable.
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the operation
* of the operation.
* @cancellable: optional #GCancellable object, %NULL to ignore. * @cancellable: optional #GCancellable object, %NULL to ignore.
* @callback: a #GAsyncReadyCallback to call when the request is satisfied * @callback: a #GAsyncReadyCallback to call when the request is satisfied
* @user_data: the data to pass to callback function * @user_data: the data to pass to callback function
@ -304,8 +303,7 @@ g_async_initable_real_init_finish (GAsyncInitable *initable,
/** /**
* g_async_initable_new_async: * g_async_initable_new_async:
* @object_type: a #GType supporting #GAsyncInitable. * @object_type: a #GType supporting #GAsyncInitable.
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the operation
* of the operation.
* @cancellable: optional #GCancellable object, %NULL to ignore. * @cancellable: optional #GCancellable object, %NULL to ignore.
* @callback: a #GAsyncReadyCallback to call when the initialization is * @callback: a #GAsyncReadyCallback to call when the initialization is
* finished * finished
@ -348,8 +346,7 @@ g_async_initable_new_async (GType object_type,
* @object_type: a #GType supporting #GAsyncInitable. * @object_type: a #GType supporting #GAsyncInitable.
* @n_parameters: the number of parameters in @parameters * @n_parameters: the number of parameters in @parameters
* @parameters: the parameters to use to construct the object * @parameters: the parameters to use to construct the object
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the operation
* of the operation.
* @cancellable: optional #GCancellable object, %NULL to ignore. * @cancellable: optional #GCancellable object, %NULL to ignore.
* @callback: a #GAsyncReadyCallback to call when the initialization is * @callback: a #GAsyncReadyCallback to call when the initialization is
* finished * finished
@ -390,8 +387,7 @@ g_async_initable_newv_async (GType object_type,
* @first_property_name: the name of the first property, followed by * @first_property_name: the name of the first property, followed by
* the value, and other property value pairs, and ended by %NULL. * the value, and other property value pairs, and ended by %NULL.
* @var_args: The var args list generated from @first_property_name. * @var_args: The var args list generated from @first_property_name.
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the operation
* of the operation.
* @cancellable: optional #GCancellable object, %NULL to ignore. * @cancellable: optional #GCancellable object, %NULL to ignore.
* @callback: a #GAsyncReadyCallback to call when the initialization is * @callback: a #GAsyncReadyCallback to call when the initialization is
* finished * finished

3
gio/gbufferedinputstream.c
View File

@ -454,8 +454,7 @@ async_fill_callback_wrapper (GObject *source_object,
* g_buffered_input_stream_fill_async: * g_buffered_input_stream_fill_async:
* @stream: a #GBufferedInputStream * @stream: a #GBufferedInputStream
* @count: the number of bytes that will be read from the stream * @count: the number of bytes that will be read from the stream
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object * @cancellable: (allow-none): optional #GCancellable object
* @callback: (scope async): a #GAsyncReadyCallback * @callback: (scope async): a #GAsyncReadyCallback
* @user_data: (closure): a #gpointer * @user_data: (closure): a #gpointer

9
gio/gdatainputstream.c
View File

@ -1114,8 +1114,7 @@ g_data_input_stream_read_finish (GDataInputStream *stream,
/** /**
* g_data_input_stream_read_line_async: * g_data_input_stream_read_line_async:
* @stream: a given #GDataInputStream. * @stream: a given #GDataInputStream.
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request.
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): callback to call when the request is satisfied. * @callback: (scope async): callback to call when the request is satisfied.
* @user_data: (closure): the data to pass to callback function. * @user_data: (closure): the data to pass to callback function.
@ -1147,8 +1146,7 @@ g_data_input_stream_read_line_async (GDataInputStream *stream,
* g_data_input_stream_read_until_async: * g_data_input_stream_read_until_async:
* @stream: a given #GDataInputStream. * @stream: a given #GDataInputStream.
* @stop_chars: characters to terminate the read. * @stop_chars: characters to terminate the read.
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request.
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): callback to call when the request is satisfied. * @callback: (scope async): callback to call when the request is satisfied.
* @user_data: (closure): the data to pass to callback function. * @user_data: (closure): the data to pass to callback function.
@ -1387,8 +1385,7 @@ g_data_input_stream_read_upto (GDataInputStream *stream,
* @stop_chars: characters to terminate the read * @stop_chars: characters to terminate the read
* @stop_chars_len: length of @stop_chars. May be -1 if @stop_chars is * @stop_chars_len: length of @stop_chars. May be -1 if @stop_chars is
* nul-terminated * nul-terminated
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request.
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore
* @callback: (scope async): callback to call when the request is satisfied * @callback: (scope async): callback to call when the request is satisfied
* @user_data: (closure): the data to pass to callback function * @user_data: (closure): the data to pass to callback function

2
gio/gdbusactiongroup.c
View File

@ -31,7 +31,7 @@
* @title: GDBusActionGroup * @title: GDBusActionGroup
* @short_description: A D-Bus GActionGroup implementation * @short_description: A D-Bus GActionGroup implementation
* @include: gio/gio.h * @include: gio/gio.h
* @see_also: <link linkend="gio-GActionGroup-exporter">GActionGroup exporter</link> * @see_also: [GActionGroup exporter][gio-GActionGroup-exporter]
* *
* #GDBusActionGroup is an implementation of the #GActionGroup * #GDBusActionGroup is an implementation of the #GActionGroup
* interface that can be used as a proxy for an action group * interface that can be used as a proxy for an action group

2
gio/gdbusaddress.c
View File

@ -60,7 +60,7 @@
* *
* Routines for working with D-Bus addresses. A D-Bus address is a string * Routines for working with D-Bus addresses. A D-Bus address is a string
* like "unix:tmpdir=/tmp/my-app-name". The exact format of addresses * like "unix:tmpdir=/tmp/my-app-name". The exact format of addresses
* is explained in detail in the <link linkend="http://dbus.freedesktop.org/doc/dbus-specification.html&num;addresses">D-Bus specification</link>. * is explained in detail in the [D-Bus specification](http://dbus.freedesktop.org/doc/dbus-specification.html&num;addresses).
*/ */
static gchar *get_session_address_platform_specific (GError **error); static gchar *get_session_address_platform_specific (GError **error);

79
gio/gdbusconnection.c
View File

@ -1226,9 +1226,9 @@ flush_in_thread_func (GSimpleAsyncResult *res,
* been sent to the networking buffers in the OS kernel. * been sent to the networking buffers in the OS kernel.
* *
* This is an asynchronous method. When the operation is finished, * This is an asynchronous method. When the operation is finished,
* @callback will be invoked in the <link * @callback will be invoked in the
* linkend="g-main-context-push-thread-default">thread-default main * [thread-default main context][g-main-context-push-thread-default]
* loop</link> of the thread you are calling this method from. You can * of the thread you are calling this method from. You can
* then call g_dbus_connection_flush_finish() to get the result of the * then call g_dbus_connection_flush_finish() to get the result of the
* operation. See g_dbus_connection_flush_sync() for the synchronous * operation. See g_dbus_connection_flush_sync() for the synchronous
* version. * version.
@ -1430,14 +1430,14 @@ schedule_closed_unlocked (GDBusConnection *connection,
* %G_IO_ERROR_CLOSED. * %G_IO_ERROR_CLOSED.
* *
* When @connection has been closed, the #GDBusConnection::closed * When @connection has been closed, the #GDBusConnection::closed
* signal is emitted in the <link * signal is emitted in the
* linkend="g-main-context-push-thread-default">thread-default main * [thread-default main context][g-main-context-push-thread-default]
* loop</link> of the thread that @connection was constructed in. * of the thread that @connection was constructed in.
* *
* This is an asynchronous method. When the operation is finished, * This is an asynchronous method. When the operation is finished,
* @callback will be invoked in the <link * @callback will be invoked in the
* linkend="g-main-context-push-thread-default">thread-default main * [thread-default main context][g-main-context-push-thread-default]
* loop</link> of the thread you are calling this method from. You can * of the thread you are calling this method from. You can
* then call g_dbus_connection_close_finish() to get the result of the * then call g_dbus_connection_close_finish() to get the result of the
* operation. See g_dbus_connection_close_sync() for the synchronous * operation. See g_dbus_connection_close_sync() for the synchronous
* version. * version.
@ -1731,9 +1731,9 @@ g_dbus_connection_send_message_unlocked (GDBusConnection *connection,
* %G_IO_ERROR_CLOSED. If @message is not well-formed, * %G_IO_ERROR_CLOSED. If @message is not well-formed,
* the operation fails with %G_IO_ERROR_INVALID_ARGUMENT. * the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
* *
* See <xref linkend="gdbus-server"/> and <xref * See this [server][gdbus-server] and [client][gdbus-unix-fd-client]
* linkend="gdbus-unix-fd-client"/> for an example of how to use this * for an example of how to use this low-level API to send and receive
* low-level API to send and receive UNIX file descriptors. * UNIX file descriptors.
* *
* Note that @message must be unlocked, unless @flags contain the * Note that @message must be unlocked, unless @flags contain the
* %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag. * %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
@ -2050,8 +2050,9 @@ g_dbus_connection_send_message_with_reply_unlocked (GDBusConnection *connect
* fail with %G_IO_ERROR_CANCELLED. If @message is not well-formed, * fail with %G_IO_ERROR_CANCELLED. If @message is not well-formed,
* the operation fails with %G_IO_ERROR_INVALID_ARGUMENT. * the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
* *
* This is an asynchronous method. When the operation is finished, @callback will be invoked * This is an asynchronous method. When the operation is finished, @callback
* in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> * will be invoked in the
* [thread-default main context][g-main-context-push-thread-default]
* of the thread you are calling this method from. You can then call * of the thread you are calling this method from. You can then call
* g_dbus_connection_send_message_with_reply_finish() to get the result of the operation. * g_dbus_connection_send_message_with_reply_finish() to get the result of the operation.
* See g_dbus_connection_send_message_with_reply_sync() for the synchronous version. * See g_dbus_connection_send_message_with_reply_sync() for the synchronous version.
@ -2059,9 +2060,9 @@ g_dbus_connection_send_message_with_reply_unlocked (GDBusConnection *connect
* Note that @message must be unlocked, unless @flags contain the * Note that @message must be unlocked, unless @flags contain the
* %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag. * %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
* *
* See <xref linkend="gdbus-server"/> and <xref * See this [server][gdbus-server] and [client][gdbus-unix-fd-client]
* linkend="gdbus-unix-fd-client"/> for an example of how to use this * for an example of how to use this low-level API to send and receive
* low-level API to send and receive UNIX file descriptors. * UNIX file descriptors.
* *
* Since: 2.26 * Since: 2.26
*/ */
@ -2106,9 +2107,9 @@ g_dbus_connection_send_message_with_reply (GDBusConnection *connection,
* be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use * be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use
* g_dbus_message_to_gerror() to transcode this to a #GError. * g_dbus_message_to_gerror() to transcode this to a #GError.
* *
* See <xref linkend="gdbus-server"/> and <xref * See this [server][gdbus-server] and [client][gdbus-unix-fd-client]
* linkend="gdbus-unix-fd-client"/> for an example of how to use this * for an example of how to use this low-level API to send and receive
* low-level API to send and receive UNIX file descriptors. * UNIX file descriptors.
* *
* Returns: (transfer full): a locked #GDBusMessage or %NULL if @error is set * Returns: (transfer full): a locked #GDBusMessage or %NULL if @error is set
* *
@ -2192,9 +2193,9 @@ send_message_with_reply_sync_cb (GDBusConnection *connection,
* be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use * be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use
* g_dbus_message_to_gerror() to transcode this to a #GError. * g_dbus_message_to_gerror() to transcode this to a #GError.
* *
* See <xref linkend="gdbus-server"/> and <xref * See this [server][gdbus-server] and [client][gdbus-unix-fd-client]
* linkend="gdbus-unix-fd-client"/> for an example of how to use this * for an example of how to use this low-level API to send and receive
* low-level API to send and receive UNIX file descriptors. * UNIX file descriptors.
* *
* Note that @message must be unlocked, unless @flags contain the * Note that @message must be unlocked, unless @flags contain the
* %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag. * %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
@ -3416,11 +3417,10 @@ is_signal_data_for_name_lost_or_acquired (SignalData *signal_data)
* @user_data_free_func: (allow-none): function to free @user_data with when * @user_data_free_func: (allow-none): function to free @user_data with when
* subscription is removed or %NULL * subscription is removed or %NULL
* *
* Subscribes to signals on @connection and invokes @callback with a * Subscribes to signals on @connection and invokes @callback with a whenever
* whenever the signal is received. Note that @callback will be invoked * the signal is received. Note that @callback will be invoked in the
* in the <link * [thread-default main context][g-main-context-push-thread-default]
* linkend="g-main-context-push-thread-default">thread-default main * of the thread you are calling this method from.
* loop</link> of the thread you are calling this method from.
* *
* If @connection is not a message bus connection, @sender must be * If @connection is not a message bus connection, @sender must be
* %NULL. * %NULL.
@ -5091,9 +5091,10 @@ obj_message_func (GDBusConnection *connection,
* Registers callbacks for exported objects at @object_path with the * Registers callbacks for exported objects at @object_path with the
* D-Bus interface that is described in @interface_info. * D-Bus interface that is described in @interface_info.
* *
* Calls to functions in @vtable (and @user_data_free_func) will * Calls to functions in @vtable (and @user_data_free_func) will happen
* happen in the <link linkend="g-main-context-push-thread-default">thread-default main * in the
* loop</link> of the thread you are calling this method from. * [thread-default main context][g-main-context-push-thread-default]
* of the thread you are calling this method from.
* *
* Note that all #GVariant values passed to functions in @vtable will match * Note that all #GVariant values passed to functions in @vtable will match
* the signature given in @interface_info - if a remote caller passes * the signature given in @interface_info - if a remote caller passes
@ -5124,7 +5125,7 @@ obj_message_func (GDBusConnection *connection,
* reference count is -1, see g_dbus_interface_info_ref()) for as long * reference count is -1, see g_dbus_interface_info_ref()) for as long
* as the object is exported. Also note that @vtable will be copied. * as the object is exported. Also note that @vtable will be copied.
* *
* See <xref linkend="gdbus-server"/> for an example of how to use this method. * See this [server][gdbus-server] for an example of how to use this method.
* *
* Returns: 0 if @error is set, otherwise a registration id (never 0) * Returns: 0 if @error is set, otherwise a registration id (never 0)
* that can be used with g_dbus_connection_unregister_object() * that can be used with g_dbus_connection_unregister_object()
@ -5811,8 +5812,9 @@ g_dbus_connection_call_sync_internal (GDBusConnection *connection,
* NULL); * NULL);
* ]| * ]|
* *
* This is an asynchronous method. When the operation is finished, @callback will be invoked * This is an asynchronous method. When the operation is finished,
* in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> * @callback will be invoked in the
* [thread-default main context][g-main-context-push-thread-default]
* of the thread you are calling this method from. You can then call * of the thread you are calling this method from. You can then call
* g_dbus_connection_call_finish() to get the result of the operation. * g_dbus_connection_call_finish() to get the result of the operation.
* See g_dbus_connection_call_sync() for the synchronous version of this * See g_dbus_connection_call_sync() for the synchronous version of this
@ -6522,9 +6524,9 @@ subtree_message_func (GDBusConnection *connection,
* #gpointer will be used to call into the interface vtable for processing * #gpointer will be used to call into the interface vtable for processing
* the request. * the request.
* *
* All calls into user-provided code will be invoked in the <link * All calls into user-provided code will be invoked in the
* linkend="g-main-context-push-thread-default">thread-default main * [thread-default main context][g-main-context-push-thread-default]
* loop</link> of the thread you are calling this method from. * of the thread you are calling this method from.
* *
* If an existing subtree is already registered at @object_path or * If an existing subtree is already registered at @object_path or
* then @error is set to #G_IO_ERROR_EXISTS. * then @error is set to #G_IO_ERROR_EXISTS.
@ -6539,7 +6541,8 @@ subtree_message_func (GDBusConnection *connection,
* Note that @vtable will be copied so you cannot change it after * Note that @vtable will be copied so you cannot change it after
* registration. * registration.
* *
* See <xref linkend="gdbus-subtree-server"/> for an example of how to use this method. * See this [server][gdbus-subtree-server] for an example of how to use
* this method.
* *
* Returns: 0 if @error is set, otherwise a subtree registration id (never 0) * Returns: 0 if @error is set, otherwise a subtree registration id (never 0)
* that can be used with g_dbus_connection_unregister_subtree() . * that can be used with g_dbus_connection_unregister_subtree() .

4
gio/gdbusinterfaceskeleton.c
View File

@ -357,7 +357,9 @@ g_dbus_interface_skeleton_get_vtable (GDBusInterfaceSkeleton *interface_)
* *
* Gets all D-Bus properties for @interface_. * Gets all D-Bus properties for @interface_.
* *
* Returns: (transfer full): A #GVariant of type <link linkend="G-VARIANT-TYPE-VARDICT:CAPS">'a{sv}'</link>. Free with g_variant_unref(). * Returns: (transfer full): A #GVariant of type
* ['a{sv}'][G-VARIANT-TYPE-VARDICT:CAPS].
* Free with g_variant_unref().
* *
* Since: 2.30 * Since: 2.30
*/ */

2
gio/gdbusintrospection.c
View File

@ -1760,7 +1760,7 @@ parser_error (GMarkupParseContext *context,
* &lt;node&gt; element. * &lt;node&gt; element.
* *
* Note that this routine is using a * Note that this routine is using a
* <link linkend="glib-Simple-XML-Subset-Parser.description">GMarkup</link>-based * [GMarkup][glib-Simple-XML-Subset-Parser.description]-based
* parser that only accepts a subset of valid XML documents. * parser that only accepts a subset of valid XML documents.
* *
* Returns: A #GDBusNodeInfo structure or %NULL if @error is set. Free * Returns: A #GDBusNodeInfo structure or %NULL if @error is set. Free

2
gio/gdbusmenumodel.c
View File

@ -30,7 +30,7 @@
* @title: GDBusMenuModel * @title: GDBusMenuModel
* @short_description: A D-Bus GMenuModel implementation * @short_description: A D-Bus GMenuModel implementation
* @include: gio/gio.h * @include: gio/gio.h
* @see_also: <link linkend="gio-GMenuModel-exporter">GMenuModel Exporter</link> * @see_also: [GMenuModel Exporter][gio-GMenuModel-exporter]
* *
* #GDBusMenuModel is an implementation of #GMenuModel that can be used * #GDBusMenuModel is an implementation of #GMenuModel that can be used
* as a proxy for a menu model that is exported over D-Bus with * as a proxy for a menu model that is exported over D-Bus with

6
gio/gdbusmethodinvocation.c
View File

@ -272,9 +272,9 @@ g_dbus_method_invocation_get_connection (GDBusMethodInvocation *invocation)
* descriptor passing, that cannot be properly expressed in the * descriptor passing, that cannot be properly expressed in the
* #GVariant API. * #GVariant API.
* *
* See <xref linkend="gdbus-server"/> and <xref * See this [server][gdbus-server] and [client][gdbus-unix-fd-client]
* linkend="gdbus-unix-fd-client"/> for an example of how to use this * for an example of how to use this low-level API to send and receive
* low-level API to send and receive UNIX file descriptors. * UNIX file descriptors.
* *
* Returns: (transfer none): #GDBusMessage. Do not free, it is owned by @invocation. * Returns: (transfer none): #GDBusMessage. Do not free, it is owned by @invocation.
* *

8
gio/gdbusnameowning.c
View File

@ -563,9 +563,9 @@ g_bus_own_name_on_connection (GDBusConnection *connection,
* *
* Starts acquiring @name on the bus specified by @bus_type and calls * Starts acquiring @name on the bus specified by @bus_type and calls
* @name_acquired_handler and @name_lost_handler when the name is * @name_acquired_handler and @name_lost_handler when the name is
* acquired respectively lost. Callbacks will be invoked in the <link * acquired respectively lost. Callbacks will be invoked in the
* linkend="g-main-context-push-thread-default">thread-default main * [thread-default main context][g-main-context-push-thread-default]
* loop</link> of the thread you are calling this function from. * of the thread you are calling this function from.
* *
* You are guaranteed that one of the @name_acquired_handler and @name_lost_handler * You are guaranteed that one of the @name_acquired_handler and @name_lost_handler
* callbacks will be invoked after calling this function - there are three * callbacks will be invoked after calling this function - there are three
@ -607,7 +607,7 @@ g_bus_own_name_on_connection (GDBusConnection *connection,
* before @name is requested from the bus. * before @name is requested from the bus.
* *
* This behavior makes it very simple to write applications that wants * This behavior makes it very simple to write applications that wants
* to own names and export objects, see <xref linkend="gdbus-owning-names"/>. * to [own names][gdbus-owning-names] and export objects.
* Simply register objects to be exported in @bus_acquired_handler and * Simply register objects to be exported in @bus_acquired_handler and
* unregister the objects (if any) in @name_lost_handler. * unregister the objects (if any) in @name_lost_handler.
* *

16
gio/gdbusnamewatching.c
View File

@ -511,9 +511,9 @@ connection_get_cb (GObject *source_object,
* Starts watching @name on the bus specified by @bus_type and calls * Starts watching @name on the bus specified by @bus_type and calls
* @name_appeared_handler and @name_vanished_handler when the name is * @name_appeared_handler and @name_vanished_handler when the name is
* known to have a owner respectively known to lose its * known to have a owner respectively known to lose its
* owner. Callbacks will be invoked in the <link * owner. Callbacks will be invoked in the
* linkend="g-main-context-push-thread-default">thread-default main * [thread-default main context][g-main-context-push-thread-default]
* loop</link> of the thread you are calling this function from. * of the thread you are calling this function from.
* *
* You are guaranteed that one of the handlers will be invoked after * You are guaranteed that one of the handlers will be invoked after
* calling this function. When you are done watching the name, just * calling this function. When you are done watching the name, just
@ -532,11 +532,11 @@ connection_get_cb (GObject *source_object,
* guaranteed that the next time one of the handlers is invoked, it * guaranteed that the next time one of the handlers is invoked, it
* will be @name_vanished_handler. The reverse is also true. * will be @name_vanished_handler. The reverse is also true.
* *
* This behavior makes it very simple to write applications that wants * This behavior makes it very simple to write applications that want
* to take action when a certain name exists, see <xref * to take action when a certain [name exists][gdbus-watching-names].
* linkend="gdbus-watching-names"/>. Basically, the application * Basically, the application should create object proxies in
* should create object proxies in @name_appeared_handler and destroy * @name_appeared_handler and destroy them again (if any) in
* them again (if any) in @name_vanished_handler. * @name_vanished_handler.
* *
* Returns: An identifier (never 0) that an be used with * Returns: An identifier (never 0) that an be used with
* g_bus_unwatch_name() to stop watching the name. * g_bus_unwatch_name() to stop watching the name.

10
gio/gdbusobjectmanagerclient.c
View File

@ -112,7 +112,7 @@
* #GDBusObjectManagerClient::interface-proxy-signal. * #GDBusObjectManagerClient::interface-proxy-signal.
* *
* Note that all callbacks and signals are emitted in the * Note that all callbacks and signals are emitted in the
* <link linkend="g-main-context-push-thread-default">thread-default main loop</link> * [thread-default main context][g-main-context-push-thread-default]
* that the #GDBusObjectManagerClient object was constructed * that the #GDBusObjectManagerClient object was constructed
* in. Additionally, the #GDBusObjectProxy and #GDBusProxy objects * in. Additionally, the #GDBusObjectProxy and #GDBusProxy objects
* originating from the #GDBusObjectManagerClient object will be created in * originating from the #GDBusObjectManagerClient object will be created in
@ -505,7 +505,7 @@ g_dbus_object_manager_client_class_init (GDBusObjectManagerClientClass *klass)
* connect signals to all interface proxies managed by @manager. * connect signals to all interface proxies managed by @manager.
* *
* This signal is emitted in the * This signal is emitted in the
* <link linkend="g-main-context-push-thread-default">thread-default main loop</link> * [thread-default main context][g-main-context-push-thread-default]
* that @manager was constructed in. * that @manager was constructed in.
* *
* Since: 2.30 * Since: 2.30
@ -543,7 +543,7 @@ g_dbus_object_manager_client_class_init (GDBusObjectManagerClientClass *klass)
* connect signals to all interface proxies managed by @manager. * connect signals to all interface proxies managed by @manager.
* *
* This signal is emitted in the * This signal is emitted in the
* <link linkend="g-main-context-push-thread-default">thread-default main loop</link> * [thread-default main context][g-main-context-push-thread-default]
* that @manager was constructed in. * that @manager was constructed in.
* *
* Since: 2.30 * Since: 2.30
@ -654,7 +654,7 @@ g_dbus_object_manager_client_new_sync (GDBusConnection *connection
* *
* This is an asynchronous failable constructor. When the result is * This is an asynchronous failable constructor. When the result is
* ready, @callback will be invoked in the * ready, @callback will be invoked in the
* <link linkend="g-main-context-push-thread-default">thread-default main loop</link> * [thread-default main context][g-main-context-push-thread-default]
* of the thread you are calling this method from. You can * of the thread you are calling this method from. You can
* then call g_dbus_object_manager_client_new_finish() to get the result. See * then call g_dbus_object_manager_client_new_finish() to get the result. See
* g_dbus_object_manager_client_new_sync() for the synchronous version. * g_dbus_object_manager_client_new_sync() for the synchronous version.
@ -807,7 +807,7 @@ g_dbus_object_manager_client_new_for_bus_sync (GBusType bu
* *
* This is an asynchronous failable constructor. When the result is * This is an asynchronous failable constructor. When the result is
* ready, @callback will be invoked in the * ready, @callback will be invoked in the
* <link linkend="g-main-context-push-thread-default">thread-default main loop</link> * [thread-default main loop][g-main-context-push-thread-default]
* of the thread you are calling this method from. You can * of the thread you are calling this method from. You can
* then call g_dbus_object_manager_client_new_for_bus_finish() to get the result. See * then call g_dbus_object_manager_client_new_for_bus_finish() to get the result. See
* g_dbus_object_manager_client_new_for_bus_sync() for the synchronous version. * g_dbus_object_manager_client_new_for_bus_sync() for the synchronous version.

23
gio/gdbusproxy.c
View File

@ -72,17 +72,16 @@
* %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START is set). * %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START is set).
* *
* The generic #GDBusProxy::g-properties-changed and * The generic #GDBusProxy::g-properties-changed and
* #GDBusProxy::g-signal signals are not very convenient to work * #GDBusProxy::g-signal signals are not very convenient to work with.
* with. Therefore, the recommended way of working with proxies is to * Therefore, the recommended way of working with proxies is to subclass
* subclass #GDBusProxy, and have more natural properties and signals * #GDBusProxy, and have more natural properties and signals in your derived
* in your derived class. See <xref linkend="gdbus-example-gdbus-codegen"/> * class. This [example][gdbus-example-gdbus-codegen] shows how this can
* for how this can easily be done using the * easily be done using the [gdbus-codegen][gdbus-codegen] tool.
* <link linkend="gdbus-codegen">gdbus-codegen</link> tool.
* *
* A #GDBusProxy instance can be used from multiple threads but note * A #GDBusProxy instance can be used from multiple threads but note
* that all signals (e.g. #GDBusProxy::g-signal, #GDBusProxy::g-properties-changed * that all signals (e.g. #GDBusProxy::g-signal, #GDBusProxy::g-properties-changed
* and #GObject::notify) are emitted in the * and #GObject::notify) are emitted in the
* <link linkend="g-main-context-push-thread-default">thread-default main loop</link> * [thread-default main context][g-main-context-push-thread-default]
* of the thread where the instance was constructed. * of the thread where the instance was constructed.
* *
* <example id="gdbus-wellknown-proxy"><title>GDBusProxy for a well-known-name</title><programlisting><xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="../../../../gio/tests/gdbus-example-watch-proxy.c"><xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback></xi:include></programlisting></example> * <example id="gdbus-wellknown-proxy"><title>GDBusProxy for a well-known-name</title><programlisting><xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="../../../../gio/tests/gdbus-example-watch-proxy.c"><xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback></xi:include></programlisting></example>
@ -2042,7 +2041,7 @@ initable_iface_init (GInitableIface *initable_iface)
* *
* See g_dbus_proxy_new_sync() and for a synchronous version of this constructor. * See g_dbus_proxy_new_sync() and for a synchronous version of this constructor.
* *
* See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used. * #GDBusProxy is used in this [example][gdbus-wellknown-proxy].
* *
* Since: 2.26 * Since: 2.26
*/ */
@ -2136,7 +2135,7 @@ g_dbus_proxy_new_finish (GAsyncResult *res,
* This is a synchronous failable constructor. See g_dbus_proxy_new() * This is a synchronous failable constructor. See g_dbus_proxy_new()
* and g_dbus_proxy_new_finish() for the asynchronous version. * and g_dbus_proxy_new_finish() for the asynchronous version.
* *
* See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used. * #GDBusProxy is used in this [example][gdbus-wellknown-proxy].
* *
* Returns: A #GDBusProxy or %NULL if error is set. Free with g_object_unref(). * Returns: A #GDBusProxy or %NULL if error is set. Free with g_object_unref().
* *
@ -2192,7 +2191,7 @@ g_dbus_proxy_new_sync (GDBusConnection *connection,
* *
* Like g_dbus_proxy_new() but takes a #GBusType instead of a #GDBusConnection. * Like g_dbus_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
* *
* See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used. * #GDBusProxy is used in this [example][gdbus-wellknown-proxy].
* *
* Since: 2.26 * Since: 2.26
*/ */
@ -2257,7 +2256,7 @@ g_dbus_proxy_new_for_bus_finish (GAsyncResult *res,
* *
* Like g_dbus_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection. * Like g_dbus_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
* *
* See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used. * #GDBusProxy is used in this [example][gdbus-wellknown-proxy].
* *
* Returns: A #GDBusProxy or %NULL if error is set. Free with g_object_unref(). * Returns: A #GDBusProxy or %NULL if error is set. Free with g_object_unref().
* *
@ -2984,7 +2983,7 @@ g_dbus_proxy_call_sync_internal (GDBusProxy *proxy,
* *
* This is an asynchronous method. When the operation is finished, * This is an asynchronous method. When the operation is finished,
* @callback will be invoked in the * @callback will be invoked in the
* <link linkend="g-main-context-push-thread-default">thread-default main loop</link> * [thread-default main context][g-main-context-push-thread-default]
* of the thread you are calling this method from. * of the thread you are calling this method from.
* You can then call g_dbus_proxy_call_finish() to get the result of * You can then call g_dbus_proxy_call_finish() to get the result of
* the operation. See g_dbus_proxy_call_sync() for the synchronous * the operation. See g_dbus_proxy_call_sync() for the synchronous

9
gio/gdbusserver.c
View File

@ -404,9 +404,9 @@ g_dbus_server_class_init (GDBusServerClass *klass)
* *
* If #GDBusServer:flags contains %G_DBUS_SERVER_FLAGS_RUN_IN_THREAD * If #GDBusServer:flags contains %G_DBUS_SERVER_FLAGS_RUN_IN_THREAD
* then the signal is emitted in a new thread dedicated to the * then the signal is emitted in a new thread dedicated to the
* connection. Otherwise the signal is emitted in the <link * connection. Otherwise the signal is emitted in the
* linkend="g-main-context-push-thread-default">thread-default main * [thread-default main context][g-main-context-push-thread-default]
* loop</link> of the thread that @server was constructed in. * of the thread that @server was constructed in.
* *
* You are guaranteed that signal handlers for this signal runs * You are guaranteed that signal handlers for this signal runs
* before incoming messages on @connection are processed. This means * before incoming messages on @connection are processed. This means
@ -463,8 +463,7 @@ on_run (GSocketService *service,
* The returned #GDBusServer isn't active - you have to start it with * The returned #GDBusServer isn't active - you have to start it with
* g_dbus_server_start(). * g_dbus_server_start().
* *
* See <xref linkend="gdbus-peer-to-peer"/> for how #GDBusServer can * #GDBusServer is used in this [example][gdbus-peer-to-peer].
* be used.
* *
* This is a synchronous failable constructor. See * This is a synchronous failable constructor. See
* g_dbus_server_new() for the asynchronous version. * g_dbus_server_new() for the asynchronous version.

49
gio/gdbusutils.c
View File

@ -515,39 +515,64 @@ g_dbus_gvariant_to_gvalue (GVariant *value,
* <tbody> * <tbody>
* <row> * <row>
* <entry>#G_TYPE_STRING</entry> * <entry>#G_TYPE_STRING</entry>
* <entry><link linkend="G-VARIANT-TYPE-STRING:CAPS">'s'</link>, <link linkend="G-VARIANT-TYPE-OBJECT-PATH:CAPS">'o'</link>, <link linkend="G-VARIANT-TYPE-SIGNATURE:CAPS">'g'</link> or <link linkend="G-VARIANT-TYPE-BYTESTRING:CAPS">'ay'</link></entry> * <entry>
* ['s'][G-VARIANT-TYPE-STRING:CAPS],
* ['o'][G-VARIANT-TYPE-OBJECT-PATH:CAPS],
* ['g'][G-VARIANT-TYPE-SIGNATURE:CAPS] or
* ['ay'][G-VARIANT-TYPE-BYTESTRING:CAPS]
* </entry>
* </row> * </row>
* <row> * <row>
* <entry>#G_TYPE_STRV</entry> * <entry>#G_TYPE_STRV</entry>
* <entry><link linkend="G-VARIANT-TYPE-STRING-ARRAY:CAPS">'as'</link>, <link linkend="G-VARIANT-TYPE-OBJECT-PATH-ARRAY:CAPS">'ao'</link> or <link linkend="G-VARIANT-TYPE-BYTESTRING-ARRAY:CAPS">'aay'</link></entry> * <entry>
* ['as'][G-VARIANT-TYPE-STRING-ARRAY:CAPS],
* ['ao'][G-VARIANT-TYPE-OBJECT-PATH-ARRAY:CAPS] or
* ['aay'][G-VARIANT-TYPE-BYTESTRING-ARRAY:CAPS]
* </entry>
* </row> * </row>
* <row> * <row>
* <entry>#G_TYPE_BOOLEAN</entry> * <entry>#G_TYPE_BOOLEAN</entry>
* <entry><link linkend="G-VARIANT-TYPE-BOOLEAN:CAPS">'b'</link></entry> * <entry>
* ['b'][G-VARIANT-TYPE-BOOLEAN:CAPS]
* </entry>
* </row> * </row>
* <row> * <row>
* <entry>#G_TYPE_UCHAR</entry> * <entry>#G_TYPE_UCHAR</entry>
* <entry><link linkend="G-VARIANT-TYPE-BYTE:CAPS">'y'</link></entry> * <entry>
* ['y'][G-VARIANT-TYPE-BYTE:CAPS]
* </entry>
* </row> * </row>
* <row> * <row>
* <entry>#G_TYPE_INT</entry> * <entry>#G_TYPE_INT</entry>
* <entry><link linkend="G-VARIANT-TYPE-INT32:CAPS">'i'</link> or <link linkend="G-VARIANT-TYPE-INT16:CAPS">'n'</link></entry> * <entry>
* ['i'][G-VARIANT-TYPE-INT32:CAPS] or
* ['n'][G-VARIANT-TYPE-INT16:CAPS]
* </entry>
* </row> * </row>
* <row> * <row>
* <entry>#G_TYPE_UINT</entry> * <entry>#G_TYPE_UINT</entry>
* <entry><link linkend="G-VARIANT-TYPE-UINT32:CAPS">'u'</link> or <link linkend="G-VARIANT-TYPE-UINT16:CAPS">'q'</link></entry> * <entry>
* ['u'][G-VARIANT-TYPE-UINT32:CAPS] or
* ['q'][G-VARIANT-TYPE-UINT16:CAPS]
* </entry>
* </row> * </row>
* <row> * <row>
* <entry>#G_TYPE_INT64</entry> * <entry>#G_TYPE_INT64</entry>
* <entry><link linkend="G-VARIANT-TYPE-INT64:CAPS">'x'</link></entry> * <entry>
* ['x'][G-VARIANT-TYPE-INT64:CAPS]
* </entry>
* </row> * </row>
* <row> * <row>
* <entry>#G_TYPE_UINT64</entry> * <entry>#G_TYPE_UINT64</entry>
* <entry><link linkend="G-VARIANT-TYPE-UINT64:CAPS">'t'</link></entry> * <entry>
* ['t'][G-VARIANT-TYPE-UINT64:CAPS]
* </entry>
* </row> * </row>
* <row> * <row>
* <entry>#G_TYPE_DOUBLE</entry> * <entry>#G_TYPE_DOUBLE</entry>
* <entry><link linkend="G-VARIANT-TYPE-DOUBLE:CAPS">'d'</link></entry> * <entry>
* ['d'][G-VARIANT-TYPE-DOUBLE:CAPS]
* </entry>
* </row> * </row>
* <row> * <row>
* <entry>#G_TYPE_VARIANT</entry> * <entry>#G_TYPE_VARIANT</entry>
@ -557,9 +582,9 @@ g_dbus_gvariant_to_gvalue (GVariant *value,
* </tgroup> * </tgroup>
* </table> * </table>
* This can fail if e.g. @gvalue is of type #G_TYPE_STRING and @type * This can fail if e.g. @gvalue is of type #G_TYPE_STRING and @type
* is <link linkend="G-VARIANT-TYPE-INT32:CAPS">'i'</link>. It will * is ['i'][G-VARIANT-TYPE-INT32:CAPS]. It will also fail for any #GType
* also fail for any #GType (including e.g. #G_TYPE_OBJECT and * (including e.g. #G_TYPE_OBJECT and #G_TYPE_BOXED derived-types) not
* #G_TYPE_BOXED derived-types) not in the table above. * in the table above.
* *
* Note that if @gvalue is of type #G_TYPE_VARIANT and its value is * Note that if @gvalue is of type #G_TYPE_VARIANT and its value is
* %NULL, the empty #GVariant instance (never %NULL) for @type is * %NULL, the empty #GVariant instance (never %NULL) for @type is

87
gio/gfile.c
View File

@ -971,8 +971,7 @@ g_file_enumerate_children (GFile *file,
* @file: input #GFile * @file: input #GFile
* @attributes: an attribute query string * @attributes: an attribute query string
* @flags: a set of #GFileQueryInfoFlags * @flags: a set of #GFileQueryInfoFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call when the * @callback: (scope async): a #GAsyncReadyCallback to call when the
@ -1209,8 +1208,7 @@ g_file_query_info (GFile *file,
* @file: input #GFile * @file: input #GFile
* @attributes: an attribute query string * @attributes: an attribute query string
* @flags: a set of #GFileQueryInfoFlags * @flags: a set of #GFileQueryInfoFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call when the * @callback: (scope async): a #GAsyncReadyCallback to call when the
@ -1347,8 +1345,7 @@ g_file_query_filesystem_info (GFile *file,
* g_file_query_filesystem_info_async: * g_file_query_filesystem_info_async:
* @file: input #GFile * @file: input #GFile
* @attributes: an attribute query string * @attributes: an attribute query string
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call * @callback: (scope async): a #GAsyncReadyCallback to call
@ -1470,8 +1467,7 @@ g_file_find_enclosing_mount (GFile *file,
/** /**
* g_file_find_enclosing_mount_async: * g_file_find_enclosing_mount_async:
* @file: a #GFile * @file: a #GFile
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call * @callback: (scope async): a #GAsyncReadyCallback to call
@ -1699,7 +1695,7 @@ g_file_create (GFile *file,
/** /**
* g_file_replace: * g_file_replace:
* @file: input #GFile * @file: input #GFile
* @etag: (allow-none): an optional <link linkend="gfile-etag">entity tag</link> * @etag: (allow-none): an optional [entity tag][gfile-etag]
* for the current #GFile, or #NULL to ignore * for the current #GFile, or #NULL to ignore
* @make_backup: %TRUE if a backup should be created * @make_backup: %TRUE if a backup should be created
* @flags: a set of #GFileCreateFlags * @flags: a set of #GFileCreateFlags
@ -1904,7 +1900,7 @@ g_file_create_readwrite (GFile *file,
/** /**
* g_file_replace_readwrite: * g_file_replace_readwrite:
* @file: a #GFile * @file: a #GFile
* @etag: (allow-none): an optional <link linkend="gfile-etag">entity tag</link> * @etag: (allow-none): an optional [entity tag][gfile-etag]
* for the current #GFile, or #NULL to ignore * for the current #GFile, or #NULL to ignore
* @make_backup: %TRUE if a backup should be created * @make_backup: %TRUE if a backup should be created
* @flags: a set of #GFileCreateFlags * @flags: a set of #GFileCreateFlags
@ -1959,8 +1955,7 @@ g_file_replace_readwrite (GFile *file,
/** /**
* g_file_read_async: * g_file_read_async:
* @file: input #GFile * @file: input #GFile
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call * @callback: (scope async): a #GAsyncReadyCallback to call
@ -2028,8 +2023,7 @@ g_file_read_finish (GFile *file,
* g_file_append_to_async: * g_file_append_to_async:
* @file: input #GFile * @file: input #GFile
* @flags: a set of #GFileCreateFlags * @flags: a set of #GFileCreateFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call * @callback: (scope async): a #GAsyncReadyCallback to call
@ -2100,8 +2094,7 @@ g_file_append_to_finish (GFile *file,
* g_file_create_async: * g_file_create_async:
* @file: input #GFile * @file: input #GFile
* @flags: a set of #GFileCreateFlags * @flags: a set of #GFileCreateFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call * @callback: (scope async): a #GAsyncReadyCallback to call
@ -2171,12 +2164,11 @@ g_file_create_finish (GFile *file,
/** /**
* g_file_replace_async: * g_file_replace_async:
* @file: input #GFile * @file: input #GFile
* @etag: (allow-none): an <link linkend="gfile-etag">entity tag</link> * @etag: (allow-none): an [entity tag][gfile-etag] for the current #GFile,
* for the current #GFile, or NULL to ignore * or %NULL to ignore
* @make_backup: %TRUE if a backup should be created * @make_backup: %TRUE if a backup should be created
* @flags: a set of #GFileCreateFlags * @flags: a set of #GFileCreateFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call * @callback: (scope async): a #GAsyncReadyCallback to call
@ -2250,8 +2242,7 @@ g_file_replace_finish (GFile *file,
/** /**
* g_file_open_readwrite_async * g_file_open_readwrite_async
* @file: input #GFile * @file: input #GFile
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call * @callback: (scope async): a #GAsyncReadyCallback to call
@ -2323,8 +2314,7 @@ g_file_open_readwrite_finish (GFile *file,
* g_file_create_readwrite_async: * g_file_create_readwrite_async:
* @file: input #GFile * @file: input #GFile
* @flags: a set of #GFileCreateFlags * @flags: a set of #GFileCreateFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call * @callback: (scope async): a #GAsyncReadyCallback to call
@ -2398,12 +2388,11 @@ g_file_create_readwrite_finish (GFile *file,
/** /**
* g_file_replace_readwrite_async: * g_file_replace_readwrite_async:
* @file: input #GFile * @file: input #GFile
* @etag: (allow-none): an <link linkend="gfile-etag">entity tag</link> * @etag: (allow-none): an [entity tag][gfile-etag] for the current #GFile,
* for the current #GFile, or NULL to ignore * or %NULL to ignore
* @make_backup: %TRUE if a backup should be created * @make_backup: %TRUE if a backup should be created
* @flags: a set of #GFileCreateFlags * @flags: a set of #GFileCreateFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call * @callback: (scope async): a #GAsyncReadyCallback to call
@ -3404,8 +3393,7 @@ g_file_copy (GFile *source,
* @source: input #GFile * @source: input #GFile
* @destination: destination #GFile * @destination: destination #GFile
* @flags: set of #GFileCopyFlags * @flags: set of #GFileCopyFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @progress_callback: (allow-none): function to callback with progress * @progress_callback: (allow-none): function to callback with progress
@ -3665,8 +3653,7 @@ g_file_make_directory (GFile *file,
/** /**
* g_file_make_directory_async: * g_file_make_directory_async:
* @file: input #GFile * @file: input #GFile
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @callback: a #GAsyncReadyCallback to call * @callback: a #GAsyncReadyCallback to call
@ -3915,8 +3902,7 @@ g_file_delete (GFile *file,
/** /**
* g_file_delete_async: * g_file_delete_async:
* @file: input #GFile * @file: input #GFile
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @callback: a #GAsyncReadyCallback to call * @callback: a #GAsyncReadyCallback to call
@ -4025,8 +4011,7 @@ g_file_trash (GFile *file,
/** /**
* g_file_trash_async: * g_file_trash_async:
* @file: input #GFile * @file: input #GFile
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @callback: a #GAsyncReadyCallback to call * @callback: a #GAsyncReadyCallback to call
@ -4144,8 +4129,7 @@ g_file_set_display_name (GFile *file,
* g_file_set_display_name_async: * g_file_set_display_name_async:
* @file: input #GFile * @file: input #GFile
* @display_name: a string * @display_name: a string
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call * @callback: (scope async): a #GAsyncReadyCallback to call
@ -4474,8 +4458,7 @@ g_file_real_set_attributes_from_info (GFile *file,
* @file: input #GFile * @file: input #GFile
* @info: a #GFileInfo * @info: a #GFileInfo
* @flags: a #GFileQueryInfoFlags * @flags: a #GFileQueryInfoFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable object, * @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore * %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback * @callback: (scope async): a #GAsyncReadyCallback
@ -7093,11 +7076,11 @@ g_file_load_contents_finish (GFile *file,
* @file: input #GFile * @file: input #GFile
* @contents: (element-type guint8) (array length=length): a string containing the new contents for @file * @contents: (element-type guint8) (array length=length): a string containing the new contents for @file
* @length: the length of @contents in bytes * @length: the length of @contents in bytes
* @etag: (allow-none): the old <link linkend="gfile-etag">entity tag</link> * @etag: (allow-none): the old [entity-tag][gfile-etag] for the document,
* for the document, or %NULL * or %NULL
* @make_backup: %TRUE if a backup should be created * @make_backup: %TRUE if a backup should be created
* @flags: a set of #GFileCreateFlags * @flags: a set of #GFileCreateFlags
* @new_etag: (allow-none) (out): a location to a new <link linkend="gfile-etag">entity tag</link> * @new_etag: (allow-none) (out): a location to a new [entity tag][gfile-etag]
* for the document. This should be freed with g_free() when no longer * for the document. This should be freed with g_free() when no longer
* needed, or %NULL * needed, or %NULL
* @cancellable: optional #GCancellable object, %NULL to ignore * @cancellable: optional #GCancellable object, %NULL to ignore
@ -7298,7 +7281,7 @@ replace_contents_open_callback (GObject *obj,
* @file: input #GFile * @file: input #GFile
* @contents: (element-type guint8) (array length=length): string of contents to replace the file with * @contents: (element-type guint8) (array length=length): string of contents to replace the file with
* @length: the length of @contents in bytes * @length: the length of @contents in bytes
* @etag: (allow-none): a new <link linkend="gfile-etag">entity tag</link> for the @file, or %NULL * @etag: (allow-none): a new [entity tag][gfile-etag] for the @file, or %NULL
* @make_backup: %TRUE if a backup should be created * @make_backup: %TRUE if a backup should be created
* @flags: a set of #GFileCreateFlags * @flags: a set of #GFileCreateFlags
* @cancellable: optional #GCancellable object, %NULL to ignore * @cancellable: optional #GCancellable object, %NULL to ignore
@ -7348,7 +7331,7 @@ g_file_replace_contents_async (GFile *file,
* g_file_replace_contents_bytes_async: * g_file_replace_contents_bytes_async:
* @file: input #GFile * @file: input #GFile
* @contents: a #GBytes * @contents: a #GBytes
* @etag: (allow-none): a new <link linkend="gfile-etag">entity tag</link> for the @file, or %NULL * @etag: (allow-none): a new [entity tag][gfile-etag] for the @file, or %NULL
* @make_backup: %TRUE if a backup should be created * @make_backup: %TRUE if a backup should be created
* @flags: a set of #GFileCreateFlags * @flags: a set of #GFileCreateFlags
* @cancellable: optional #GCancellable object, %NULL to ignore * @cancellable: optional #GCancellable object, %NULL to ignore
@ -7402,7 +7385,7 @@ g_file_replace_contents_bytes_async (GFile *file,
* g_file_replace_contents_finish: * g_file_replace_contents_finish:
* @file: input #GFile * @file: input #GFile
* @res: a #GAsyncResult * @res: a #GAsyncResult
* @new_etag: (out) (allow-none): a location of a new <link linkend="gfile-etag">entity tag</link> * @new_etag: (out) (allow-none): a location of a new [entity tag][gfile-etag]
* for the document. This should be freed with g_free() when it is no * for the document. This should be freed with g_free() when it is no
* longer needed, or %NULL * longer needed, or %NULL
* @error: a #GError, or %NULL * @error: a #GError, or %NULL
@ -7656,8 +7639,7 @@ g_file_measure_disk_usage (GFile *file,
* g_file_measure_disk_usage_async: * g_file_measure_disk_usage_async:
* @file: a #GFile * @file: a #GFile
* @flags: #GFileMeasureFlags * @flags: #GFileMeasureFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request
* @cancellable: (allow-none): optional #GCancellable * @cancellable: (allow-none): optional #GCancellable
* @progress_callback: (allow-none): a #GFileMeasureProgressCallback * @progress_callback: (allow-none): a #GFileMeasureProgressCallback
* @progress_data: user_data for @progress_callback * @progress_data: user_data for @progress_callback
@ -7986,11 +7968,10 @@ g_file_poll_mountable_finish (GFile *file,
* g_file_supports_thread_contexts: * g_file_supports_thread_contexts:
* @file: a #GFile * @file: a #GFile
* *
* Checks if @file supports <link * Checks if @file supports
* linkend="g-main-context-push-thread-default-context">thread-default * [thread-default contexts][g-main-context-push-thread-default-context].
* contexts</link>. If this returns %FALSE, you cannot perform * If this returns %FALSE, you cannot perform asynchronous operations on
* asynchronous operations on @file in a thread that has a * @file in a thread that has a thread-default context.
* thread-default context.
* *
* Returns: Whether or not @file supports thread-default contexts. * Returns: Whether or not @file supports thread-default contexts.
* *

6
gio/gfileattribute.c
View File

@ -66,9 +66,9 @@
* <row><entry>"standard"</entry><entry>The "Standard" namespace. General file * <row><entry>"standard"</entry><entry>The "Standard" namespace. General file
* information that any application may need should be put in this namespace. * information that any application may need should be put in this namespace.
* Examples include the file's name, type, and size.</entry></row> * Examples include the file's name, type, and size.</entry></row>
* <row><entry>"etag"</entry><entry>The <link linkend="gfile-etag">"Entity Tag"</link> * <row><entry>"etag"</entry><entry>The [Entity Tag][gfile-etag]
* namespace. Currently, the only key in this namespace is "value", which contains * namespace. Currently, the only key in this namespace is "value", which
* the value of the current entity tag.</entry></row> * contains the value of the current entity tag.</entry></row>
* <row><entry>"id"</entry><entry>The "Identification" namespace. This * <row><entry>"id"</entry><entry>The "Identification" namespace. This
* namespace is used by file managers and applications that list directories * namespace is used by file managers and applications that list directories
* to check for loops and to uniquely identify files.</entry></row> * to check for loops and to uniquely identify files.</entry></row>

6
gio/gfileenumerator.c
View File

@ -309,8 +309,7 @@ next_async_callback_wrapper (GObject *source_object,
* g_file_enumerator_next_files_async: * g_file_enumerator_next_files_async:
* @enumerator: a #GFileEnumerator. * @enumerator: a #GFileEnumerator.
* @num_files: the number of file info objects to request * @num_files: the number of file info objects to request
* @io_priority: the <link linkend="io-priority">io priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request.
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): a #GAsyncReadyCallback to call when the request is satisfied * @callback: (scope async): a #GAsyncReadyCallback to call when the request is satisfied
* @user_data: (closure): the data to pass to callback function * @user_data: (closure): the data to pass to callback function
@ -436,8 +435,7 @@ close_async_callback_wrapper (GObject *source_object,
/** /**
* g_file_enumerator_close_async: * g_file_enumerator_close_async:
* @enumerator: a #GFileEnumerator. * @enumerator: a #GFileEnumerator.
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request.
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): a #GAsyncReadyCallback to call when the request is satisfied * @callback: (scope async): a #GAsyncReadyCallback to call when the request is satisfied
* @user_data: (closure): the data to pass to callback function * @user_data: (closure): the data to pass to callback function

12
gio/gfileinfo.c
View File

@ -22,14 +22,14 @@
* SECTION:gfileinfo * SECTION:gfileinfo
* @short_description: File Information and Attributes * @short_description: File Information and Attributes
* @include: gio/gio.h * @include: gio/gio.h
* @see_also: #GFile, <link linkend="gio-GFileAttribute">GFileAttribute</link> * @see_also: #GFile, [GFileAttribute][gio-GFileAttribute]
* *
* Functionality for manipulating basic metadata for files. #GFileInfo * Functionality for manipulating basic metadata for files. #GFileInfo
* implements methods for getting information that all files should * implements methods for getting information that all files should
* contain, and allows for manipulation of extended attributes. * contain, and allows for manipulation of extended attributes.
* *
* See <link linkend="gio-GFileAttribute">GFileAttribute</link> for more * See [GFileAttribute][gio-GFileAttribute for more information on how
* information on how GIO handles file attributes. * GIO handles file attributes.
* *
* To obtain a #GFileInfo for a #GFile, use g_file_query_info() (or its * To obtain a #GFileInfo for a #GFile, use g_file_query_info() (or its
* async variant). To obtain a #GFileInfo for a file input or output * async variant). To obtain a #GFileInfo for a file input or output
@ -364,7 +364,7 @@ g_file_info_new (void)
* @src_info: source to copy attributes from. * @src_info: source to copy attributes from.
* @dest_info: destination to copy attributes to. * @dest_info: destination to copy attributes to.
* *
* Copies all of the <link linkend="gio-GFileAttribute">GFileAttribute</link>s * Copies all of the [GFileAttribute][gio-GFileAttribute]
* from @src_info to @dest_info. * from @src_info to @dest_info.
**/ **/
void void
@ -1795,7 +1795,7 @@ g_file_info_get_symlink_target (GFileInfo *info)
* g_file_info_get_etag: * g_file_info_get_etag:
* @info: a #GFileInfo. * @info: a #GFileInfo.
* *
* Gets the <link linkend="gfile-etag">entity tag</link> for a given * Gets the [entity tag][gfile-etag] for a given
* #GFileInfo. See %G_FILE_ATTRIBUTE_ETAG_VALUE. * #GFileInfo. See %G_FILE_ATTRIBUTE_ETAG_VALUE.
* *
* Returns: a string containing the value of the "etag:value" attribute. * Returns: a string containing the value of the "etag:value" attribute.
@ -2050,7 +2050,7 @@ g_file_info_set_symbolic_icon (GFileInfo *info,
/** /**
* g_file_info_set_content_type: * g_file_info_set_content_type:
* @info: a #GFileInfo. * @info: a #GFileInfo.
* @content_type: a content type. See <link linkend="gio-GContentType">GContentType</link>. * @content_type: a content type. See [GContentType][gio-GContentType]
* *
* Sets the content type attribute for a given #GFileInfo. * Sets the content type attribute for a given #GFileInfo.
* See %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE. * See %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE.

3
gio/gfileinputstream.c
View File

@ -173,8 +173,7 @@ async_ready_callback_wrapper (GObject *source_object,
* g_file_input_stream_query_info_async: * g_file_input_stream_query_info_async:
* @stream: a #GFileInputStream. * @stream: a #GFileInputStream.
* @attributes: a file attribute query string. * @attributes: a file attribute query string.
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request.
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): callback to call when the request is satisfied * @callback: (scope async): callback to call when the request is satisfied
* @user_data: (closure): the data to pass to callback function * @user_data: (closure): the data to pass to callback function

3
gio/gfileiostream.c
View File

@ -191,8 +191,7 @@ async_ready_callback_wrapper (GObject *source_object,
* g_file_io_stream_query_info_async: * g_file_io_stream_query_info_async:
* @stream: a #GFileIOStream. * @stream: a #GFileIOStream.
* @attributes: a file attribute query string. * @attributes: a file attribute query string.
* @io_priority: the <link linkend="gio-GIOScheduler">I/O priority</link> * @io_priority: the [I/O priority][gio-GIOScheduler] of the request
* of the request.
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): callback to call when the request is satisfied * @callback: (scope async): callback to call when the request is satisfied
* @user_data: (closure): the data to pass to callback function * @user_data: (closure): the data to pass to callback function

11
gio/gfilemonitor.c
View File

@ -45,9 +45,9 @@ static void file_change_free (FileChange *change);
* *
* To get informed about changes to the file or directory you are * To get informed about changes to the file or directory you are
* monitoring, connect to the #GFileMonitor::changed signal. The * monitoring, connect to the #GFileMonitor::changed signal. The
* signal will be emitted in the <link * signal will be emitted in the
* linkend="g-main-context-push-thread-default">thread-default main * [thread-default main context][g-main-context-push-thread-default]
* context</link> of the thread that the monitor was created in * of the thread that the monitor was created in
* (though if the global default main context is blocked, this may * (though if the global default main context is blocked, this may
* cause notifications to be blocked even if the thread-default * cause notifications to be blocked even if the thread-default
* context is still running). * context is still running).
@ -670,9 +670,8 @@ update_rate_limiter_timeout (GFileMonitor *monitor,
* has taken place. Should be called from file monitor * has taken place. Should be called from file monitor
* implementations only. * implementations only.
* *
* The signal will be emitted from an idle handler (in the <link * The signal will be emitted from an idle handler (in the
* linkend="g-main-context-push-thread-default">thread-default main * [thread-default main context][g-main-context-push-thread-default]).
* context</link>).
**/ **/
void void
g_file_monitor_emit_event (GFileMonitor *monitor, g_file_monitor_emit_event (GFileMonitor *monitor,

3
gio/gfileoutputstream.c
View File

@ -188,8 +188,7 @@ async_ready_callback_wrapper (GObject *source_object,
* g_file_output_stream_query_info_async: * g_file_output_stream_query_info_async:
* @stream: a #GFileOutputStream. * @stream: a #GFileOutputStream.
* @attributes: a file attribute query string. * @attributes: a file attribute query string.
* @io_priority: the <link linkend="gio-GIOScheduler">I/O priority</link> * @io_priority: the [I/O priority][gio-GIOScheduler] of the request
* of the request.
* @cancellable: optional #GCancellable object, %NULL to ignore. * @cancellable: optional #GCancellable object, %NULL to ignore.
* @callback: callback to call when the request is satisfied * @callback: callback to call when the request is satisfied
* @user_data: the data to pass to callback function * @user_data: the data to pass to callback function

3
gio/ginitable.c
View File

@ -85,8 +85,7 @@ g_initable_default_init (GInitableInterface *iface)
* If the object is not initialized, or initialization returns with an * If the object is not initialized, or initialization returns with an
* error, then all operations on the object except g_object_ref() and * error, then all operations on the object except g_object_ref() and
* g_object_unref() are considered to be invalid, and have undefined * g_object_unref() are considered to be invalid, and have undefined
* behaviour. See the <xref linkend="ginitable"/> section introduction * behaviour. See the [introduction][ginitable] for more details.
* for more details.
* *
* Implementations of this method must be idempotent, i.e. multiple calls * Implementations of this method must be idempotent, i.e. multiple calls
* to this function with the same argument should return the same results. * to this function with the same argument should return the same results.

11
gio/ginputstream.c
View File

@ -539,7 +539,7 @@ async_ready_close_callback_wrapper (GObject *source_object,
* @buffer: (array length=count) (element-type guint8): a buffer to * @buffer: (array length=count) (element-type guint8): a buffer to
* read data into (which should be at least count bytes long). * read data into (which should be at least count bytes long).
* @count: the number of bytes that will be read from the stream * @count: the number of bytes that will be read from the stream
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority]
* of the request. * of the request.
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): callback to call when the request is satisfied * @callback: (scope async): callback to call when the request is satisfied
@ -686,8 +686,7 @@ read_bytes_callback (GObject *stream,
* g_input_stream_read_bytes_async: * g_input_stream_read_bytes_async:
* @stream: A #GInputStream. * @stream: A #GInputStream.
* @count: the number of bytes that will be read from the stream * @count: the number of bytes that will be read from the stream
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request.
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): callback to call when the request is satisfied * @callback: (scope async): callback to call when the request is satisfied
* @user_data: (closure): the data to pass to callback function * @user_data: (closure): the data to pass to callback function
@ -759,8 +758,7 @@ g_input_stream_read_bytes_finish (GInputStream *stream,
* g_input_stream_skip_async: * g_input_stream_skip_async:
* @stream: A #GInputStream. * @stream: A #GInputStream.
* @count: the number of bytes that will be skipped from the stream * @count: the number of bytes that will be skipped from the stream
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request.
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): callback to call when the request is satisfied * @callback: (scope async): callback to call when the request is satisfied
* @user_data: (closure): the data to pass to callback function * @user_data: (closure): the data to pass to callback function
@ -871,8 +869,7 @@ g_input_stream_skip_finish (GInputStream *stream,
/** /**
* g_input_stream_close_async: * g_input_stream_close_async:
* @stream: A #GInputStream. * @stream: A #GInputStream.
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request.
* @cancellable: (allow-none): optional cancellable object * @cancellable: (allow-none): optional cancellable object
* @callback: (scope async): callback to call when the request is satisfied * @callback: (scope async): callback to call when the request is satisfied
* @user_data: (closure): the data to pass to callback function * @user_data: (closure): the data to pass to callback function

4
gio/giomodule.c
View File

@ -60,7 +60,7 @@
* SECTION:extensionpoints * SECTION:extensionpoints
* @short_description: Extension Points * @short_description: Extension Points
* @include: gio.h * @include: gio.h
* @see_also: <link linkend="extending-gio">Extending GIO</link> * @see_also: [Extending GIO][extending-gio]
* *
* #GIOExtensionPoint provides a mechanism for modules to extend the * #GIOExtensionPoint provides a mechanism for modules to extend the
* functionality of the library or application that loaded it in an * functionality of the library or application that loaded it in an
@ -102,7 +102,7 @@
* *
* To avoid opening all modules just to find out what extension * To avoid opening all modules just to find out what extension
* points they implement, GIO makes use of a caching mechanism, * points they implement, GIO makes use of a caching mechanism,
* see <link linkend="gio-querymodules">gio-querymodules</link>. * see [gio-querymodules][gio-querymodules].
* You are expected to run this command after installing a * You are expected to run this command after installing a
* GIO module. * GIO module.
* *

2
gio/gioscheduler.c
View File

@ -95,7 +95,7 @@ io_job_thread (GTask *task,
* @job_func: a #GIOSchedulerJobFunc. * @job_func: a #GIOSchedulerJobFunc.
* @user_data: data to pass to @job_func * @user_data: data to pass to @job_func
* @notify: (allow-none): a #GDestroyNotify for @user_data, or %NULL * @notify: (allow-none): a #GDestroyNotify for @user_data, or %NULL
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority]
* of the request. * of the request.
* @cancellable: optional #GCancellable object, %NULL to ignore. * @cancellable: optional #GCancellable object, %NULL to ignore.
* *

19
gio/gmenumodel.c
View File

@ -43,8 +43,7 @@
* it (or, in the case of the 'root' menu, is defined by the context * it (or, in the case of the 'root' menu, is defined by the context
* in which it is used). * in which it is used).
* *
* As an example, consider the visible portions of the menu in * As an example, consider the visible portions of this menu:
* <xref linkend="menu-example"/>.
* *
* ## An example menu # {#menu-example} * ## An example menu # {#menu-example}
* *
@ -62,7 +61,7 @@
* - the Sources section (containing 2 items) * - the Sources section (containing 2 items)
* - the Markup section (containing 2 items) * - the Markup section (containing 2 items)
* *
* <xref linkend="menu-model"/> illustrates the conceptual connection between * The [example][menu-model] illustrates the conceptual connection between
* these 8 menus. Each large block in the figure represents a menu and the * these 8 menus. Each large block in the figure represents a menu and the
* smaller blocks within the large block represent items in that menu. Some * smaller blocks within the large block represent items in that menu. Some
* items contain references to other menus. * items contain references to other menus.
@ -71,8 +70,8 @@
* *
* ![](menu-model.png) * ![](menu-model.png)
* *
* Notice that the separators visible in <xref linkend="menu-example"/> * Notice that the separators visible in the [example][menu-example]
* appear nowhere in <xref linkend="menu-model"/>. This is because * appear nowhere in the [menu model][menu-model]. This is because
* separators are not explicitly represented in the menu model. Instead, * separators are not explicitly represented in the menu model. Instead,
* a separator is inserted between any two non-empty sections of a menu. * a separator is inserted between any two non-empty sections of a menu.
* Section items can have labels just like any other item. In that case, * Section items can have labels just like any other item. In that case,
@ -83,12 +82,10 @@
* outside the application. Examples include global menus, jumplists, * outside the application. Examples include global menus, jumplists,
* dash boards, etc. To support such uses, it is necessary to 'export' * dash boards, etc. To support such uses, it is necessary to 'export'
* information about actions and their representation in menus, which * information about actions and their representation in menus, which
* is exactly what the * is exactly what the [GActionGroup exporter][gio-GActionGroup-exporter]
* <link linkend="gio-GActionGroup-exporter">GActionGroup exporter</link> * and the [GMenuModel exporter][gio-GMenuModel-exporter] do for
* and the * #GActionGroup and #GMenuModel. The client-side counterparts to
* <link linkend="gio-GMenuModel-exporter">GMenuModel exporter</link> * make use of the exported information are #GDBusActionGroup and
* do for #GActionGroup and #GMenuModel. The client-side counterparts
* to make use of the exported information are #GDBusActionGroup and
* #GDBusMenuModel. * #GDBusMenuModel.
* *
* The API of #GMenuModel is very generic, with iterators for the * The API of #GMenuModel is very generic, with iterators for the

12
gio/gresource.c
View File

@ -51,7 +51,7 @@ G_DEFINE_BOXED_TYPE (GResource, g_resource, g_resource_ref, g_resource_unref)
* icons, etc. These are often shipped as files in `$datadir/appname`, or * icons, etc. These are often shipped as files in `$datadir/appname`, or
* manually included as literal strings in the code. * manually included as literal strings in the code.
* *
* The #GResource API and the <link linkend="glib-compile-resources">glib-compile-resources</link> program * The #GResource API and the [glib-compile-resources][glib-compile-resources] program
* provide a convenient and efficient alternative to this which has some nice properties. You * provide a convenient and efficient alternative to this which has some nice properties. You
* maintain the files as normal files, so its easy to edit them, but during the build the files * maintain the files as normal files, so its easy to edit them, but during the build the files
* are combined into a binary bundle that is linked into the executable. This means that loading * are combined into a binary bundle that is linked into the executable. This means that loading
@ -80,7 +80,7 @@ G_DEFINE_BOXED_TYPE (GResource, g_resource, g_resource_ref, g_resource_unref)
* set to the full path to the gdk-pixbuf-pixdata executable; otherwise the resource compiler will * set to the full path to the gdk-pixbuf-pixdata executable; otherwise the resource compiler will
* abort. * abort.
* *
* Resource bundles are created by the <link linkend="glib-compile-resources">glib-compile-resources</link> program * Resource bundles are created by the [glib-compile-resources][glib-compile-resources] program
* which takes an xml file that describes the bundle, and a set of files that the xml references. These * which takes an xml file that describes the bundle, and a set of files that the xml references. These
* are combined into a binary resource bundle. * are combined into a binary resource bundle.
* *
@ -106,7 +106,7 @@ G_DEFINE_BOXED_TYPE (GResource, g_resource, g_resource_ref, g_resource_unref)
* Note that all resources in the process share the same namespace, so use java-style * Note that all resources in the process share the same namespace, so use java-style
* path prefixes (like in the above example) to avoid conflicts. * path prefixes (like in the above example) to avoid conflicts.
* *
* You can then use <link linkend="glib-compile-resources">glib-compile-resources</link> to compile the xml to a * You can then use [glib-compile-resources][glib-compile-resources] to compile the xml to a
* binary bundle that you can load with g_resource_load(). However, its more common to use the --generate-source and * binary bundle that you can load with g_resource_load(). However, its more common to use the --generate-source and
* --generate-header arguments to create a source file and header to link directly into your application. * --generate-header arguments to create a source file and header to link directly into your application.
* *
@ -955,7 +955,7 @@ register_lazy_static_resources (void)
* GStaticResource. * GStaticResource.
* *
* This is normally used by code generated by * This is normally used by code generated by
* <link linkend="glib-compile-resources">glib-compile-resources</link> * [glib-compile-resources][glib-compile-resources]
* and is not typically used by other code. * and is not typically used by other code.
* *
* Since: 2.32 * Since: 2.32
@ -980,7 +980,7 @@ g_static_resource_init (GStaticResource *static_resource)
* Finalized a GResource initialized by g_static_resource_init(). * Finalized a GResource initialized by g_static_resource_init().
* *
* This is normally used by code generated by * This is normally used by code generated by
* <link linkend="glib-compile-resources">glib-compile-resources</link> * [glib-compile-resources][glib-compile-resources]
* and is not typically used by other code. * and is not typically used by other code.
* *
* Since: 2.32 * Since: 2.32
@ -1012,7 +1012,7 @@ g_static_resource_fini (GStaticResource *static_resource)
* Gets the GResource that was registered by a call to g_static_resource_init(). * Gets the GResource that was registered by a call to g_static_resource_init().
* *
* This is normally used by code generated by * This is normally used by code generated by
* <link linkend="glib-compile-resources">glib-compile-resources</link> * [glib-compile-resources][glib-compile-resources]
* and is not typically used by other code. * and is not typically used by other code.
* *
* Return value: (transfer none): a #GResource * Return value: (transfer none): a #GResource

27
gio/gsettings.c
View File

@ -91,14 +91,14 @@
* the &lt;key&gt; element. * the &lt;key&gt; element.
* *
* GSettings uses schemas in a compact binary form that is created * GSettings uses schemas in a compact binary form that is created
* by the <link linkend="glib-compile-schemas">glib-compile-schemas</link> * by the [glib-compile-schemas][glib-compile-schemas]
* utility. The input is a schema description in an XML format. * utility. The input is a schema description in an XML format.
* *
* A DTD for the gschema XML format can be found here: * A DTD for the gschema XML format can be found here:
* [gschema.dtd](https://git.gnome.org/browse/glib/tree/gio/gschema.dtd) * [gschema.dtd](https://git.gnome.org/browse/glib/tree/gio/gschema.dtd)
* *
* The <link linkend="glib-compile-schemas">glib-compile-schemas</link> * The [glib-compile-schemas][glib-compile-schemas] tool expects schema
* tool expects schema files to have the extension `.gschema.xml`. * files to have the extension `.gschema.xml`.
* *
* At runtime, schemas are identified by their id (as specified in the * At runtime, schemas are identified by their id (as specified in the
* id attribute of the &lt;schema&gt; element). The convention for schema * id attribute of the &lt;schema&gt; element). The convention for schema
@ -111,12 +111,11 @@
* *
* In addition to #GVariant types, keys can have types that have * In addition to #GVariant types, keys can have types that have
* enumerated types. These can be described by a &lt;choice&gt;, * enumerated types. These can be described by a &lt;choice&gt;,
* &lt;enum&gt; or &lt;flags&gt; element, see * &lt;enum&gt; or &lt;flags&gt; element, as seen in the
* <xref linkend="schema-enumerated"/>. The underlying type of * [example][schema-enumerated]. The underlying type of such a key
* such a key is string, but you can use g_settings_get_enum(), * is string, but you can use g_settings_get_enum(), g_settings_set_enum(),
* g_settings_set_enum(), g_settings_get_flags(), g_settings_set_flags() * g_settings_get_flags(), g_settings_set_flags() access the numeric values
* access the numeric values corresponding to the string value of enum * corresponding to the string value of enum and flags keys.
* and flags keys.
* *
* An example for default value: * An example for default value:
* |[ * |[
@ -191,11 +190,11 @@
* an application. Sometimes, it is necessary for a vendor or distributor * an application. Sometimes, it is necessary for a vendor or distributor
* to adjust these defaults. Since patching the XML source for the schema * to adjust these defaults. Since patching the XML source for the schema
* is inconvenient and error-prone, * is inconvenient and error-prone,
* <link linkend="glib-compile-schemas">glib-compile-schemas</link> reads * [glib-compile-schemas][glib-compile-schemas] reads so-called vendor
* so-called 'vendor override' files. These are keyfiles in the same * override' files. These are keyfiles in the same directory as the XML
* directory as the XML schema sources which can override default values. * schema sources which can override default values. The schema id serves
* The schema id serves as the group name in the key file, and the values * as the group name in the key file, and the values are expected in
* are expected in serialized GVariant form, as in the following example: * serialized GVariant form, as in the following example:
* |[ * |[
* [org.gtk.Example] * [org.gtk.Example]
* key1='string' * key1='string'

3
gio/gsettingsschema.c
View File

@ -251,8 +251,7 @@ g_settings_schema_source_unref (GSettingsSchemaSource *source)
* may be useful to authors of plugin management systems. * may be useful to authors of plugin management systems.
* *
* The directory should contain a file called `gschemas.compiled` as * The directory should contain a file called `gschemas.compiled` as
* produced by the * produced by the [glib-compile-schemas][glib-compile-schemas] tool.
* <link linkend="glib-compile-schemas">glib-compile-schemas</link> tool.
* *
* If @trusted is %TRUE then `gschemas.compiled` is trusted not to be * If @trusted is %TRUE then `gschemas.compiled` is trusted not to be
* corrupted. This assumption has a performance advantage, but can result * corrupted. This assumption has a performance advantage, but can result

12
gio/gsimpleasyncresult.c
View File

@ -82,9 +82,9 @@
* or it can use #GThreads. * or it can use #GThreads.
* g_simple_async_result_complete() will finish an I/O task directly * g_simple_async_result_complete() will finish an I/O task directly
* from the point where it is called. g_simple_async_result_complete_in_idle() * from the point where it is called. g_simple_async_result_complete_in_idle()
* will finish it from an idle handler in the <link * will finish it from an idle handler in the
* linkend="g-main-context-push-thread-default">thread-default main * [thread-default main context][g-main-context-push-thread-default]
* context</link>. g_simple_async_result_run_in_thread() will run the * . g_simple_async_result_run_in_thread() will run the
* job in a separate thread and then deliver the result to the * job in a separate thread and then deliver the result to the
* thread-default main context. * thread-default main context.
* *
@ -784,9 +784,9 @@ complete_in_idle_cb (gpointer data)
* g_simple_async_result_complete_in_idle: * g_simple_async_result_complete_in_idle:
* @simple: a #GSimpleAsyncResult. * @simple: a #GSimpleAsyncResult.
* *
* Completes an asynchronous function in an idle handler in the <link * Completes an asynchronous function in an idle handler in the
* linkend="g-main-context-push-thread-default">thread-default main * [thread-default main context][g-main-context-push-thread-default]
* loop</link> of the thread that @simple was initially created in * of the thread that @simple was initially created in
* (and re-pushes that context around the invocation of the callback). * (and re-pushes that context around the invocation of the callback).
* *
* Calling this function takes a reference to @simple for as long as * Calling this function takes a reference to @simple for as long as

6
gio/gsocket.c
View File

@ -68,7 +68,7 @@
* SECTION:gsocket * SECTION:gsocket
* @short_description: Low-level socket object * @short_description: Low-level socket object
* @include: gio/gio.h * @include: gio/gio.h
* @see_also: #GInitable, <link linkend="gio-gnetworking.h">gnetworking.h</link> * @see_also: #GInitable, [&lt;gnetworking.h&gt;][gio-gnetworking.h]
* *
* A #GSocket is a low-level networking primitive. It is a more or less * A #GSocket is a low-level networking primitive. It is a more or less
* direct mapping of the BSD socket API in a portable GObject based API. * direct mapping of the BSD socket API in a portable GObject based API.
@ -4516,7 +4516,7 @@ g_socket_get_credentials (GSocket *socket,
* getsockopt(). (If you need to fetch a non-integer-valued option, * getsockopt(). (If you need to fetch a non-integer-valued option,
* you will need to call getsockopt() directly.) * you will need to call getsockopt() directly.)
* *
* The <link linkend="gio-gnetworking.h">`&lt;gio/gnetworking.h&gt;`</link> * The [&lt;gio/gnetworking.h&gt;][gio-gnetworking.h]
* header pulls in system headers that will define most of the * header pulls in system headers that will define most of the
* standard/portable socket options. For unusual socket protocols or * standard/portable socket options. For unusual socket protocols or
* platform-dependent options, you may need to include additional * platform-dependent options, you may need to include additional
@ -4583,7 +4583,7 @@ g_socket_get_option (GSocket *socket,
* setsockopt(). (If you need to set a non-integer-valued option, * setsockopt(). (If you need to set a non-integer-valued option,
* you will need to call setsockopt() directly.) * you will need to call setsockopt() directly.)
* *
* The <link linkend="gio-gnetworking.h">`&lt;gio/gnetworking.h&gt;`</link> * The [&lt;gio/gnetworking.h&gt;][gio-gnetworking.h]
* header pulls in system headers that will define most of the * header pulls in system headers that will define most of the
* standard/portable socket options. For unusual socket protocols or * standard/portable socket options. For unusual socket protocols or
* platform-dependent options, you may need to include additional * platform-dependent options, you may need to include additional

6
gio/gsocketservice.c
View File

@ -47,9 +47,9 @@
* If you are interested in writing connection handlers that contain * If you are interested in writing connection handlers that contain
* blocking code then see #GThreadedSocketService. * blocking code then see #GThreadedSocketService.
* *
* The socket service runs on the main loop of the <link * The socket service runs on the main loop of the
* linkend="g-main-context-push-thread-default-context">thread-default * [thread-default context][g-main-context-push-thread-default-context]
* context</link> of the thread it is created in, and is not * of the thread it is created in, and is not
* threadsafe in general. However, the calls to start and stop the * threadsafe in general. However, the calls to start and stop the
* service are thread-safe so these can be used from threads that * service are thread-safe so these can be used from threads that
* handle incoming clients. * handle incoming clients.

36
gio/gtask.c
View File

@ -148,14 +148,13 @@
* *
* #GTask also tries to simplify asynchronous operations that * #GTask also tries to simplify asynchronous operations that
* internally chain together several smaller asynchronous * internally chain together several smaller asynchronous
* operations. g_task_get_cancellable(), g_task_get_context(), and * operations. g_task_get_cancellable(), g_task_get_context(),
* g_task_get_priority() allow you to get back the task's * and g_task_get_priority() allow you to get back the task's
* #GCancellable, #GMainContext, and <link * #GCancellable, #GMainContext, and [I/O priority][io-priority]
* linkend="io-priority">I/O priority</link> when starting a new * when starting a new subtask, so you don't have to keep track
* subtask, so you don't have to keep track of them yourself. * of them yourself. g_task_attach_source() simplifies the case
* g_task_attach_source() simplifies the case of waiting for a * of waiting for a source to fire (automatically using the correct
* source to fire (automatically using the correct #GMainContext * #GMainContext and priority).
* and priority).
* *
* Here is an example for chained asynchronous operations: * Here is an example for chained asynchronous operations:
* |[<!-- language="C" --> * |[<!-- language="C" -->
@ -477,7 +476,7 @@
* abuse of g_simple_async_result_set_op_res_gpointer() for the same * abuse of g_simple_async_result_set_op_res_gpointer() for the same
* purpose with #GSimpleAsyncResult. * purpose with #GSimpleAsyncResult.
* - In addition to the task data, #GTask also keeps track of the * - In addition to the task data, #GTask also keeps track of the
* <link linkend="io-priority">priority</link>, #GCancellable, and * [priority][io-priority], #GCancellable, and
* #GMainContext associated with the task, so tasks that consist of * #GMainContext associated with the task, so tasks that consist of
* a chain of simpler asynchronous operations will have easy access * a chain of simpler asynchronous operations will have easy access
* to those values when starting each sub-task. * to those values when starting each sub-task.
@ -634,9 +633,8 @@ g_task_finalize (GObject *object)
* @callback_data: (closure): user data passed to @callback. * @callback_data: (closure): user data passed to @callback.
* *
* Creates a #GTask acting on @source_object, which will eventually be * Creates a #GTask acting on @source_object, which will eventually be
* used to invoke @callback in the current <link * used to invoke @callback in the current
* linkend="g-main-context-push-thread-default">thread-default main * [thread-default main context][g-main-context-push-thread-default].
* context</link>.
* *
* Call this in the "start" method of your asynchronous method, and * Call this in the "start" method of your asynchronous method, and
* pass the #GTask around throughout the asynchronous operation. You * pass the #GTask around throughout the asynchronous operation. You
@ -783,8 +781,7 @@ g_task_set_task_data (GTask *task,
/** /**
* g_task_set_priority: * g_task_set_priority:
* @task: the #GTask * @task: the #GTask
* @priority: the <link linkend="io-priority">priority</link> * @priority: the [priority][io-priority] of the request
* of the request.
* *
* Sets @task's priority. If you do not call this, it will default to * Sets @task's priority. If you do not call this, it will default to
* %G_PRIORITY_DEFAULT. * %G_PRIORITY_DEFAULT.
@ -994,9 +991,9 @@ g_task_get_priority (GTask *task)
* @task: a #GTask * @task: a #GTask
* *
* Gets the #GMainContext that @task will return its result in (that * Gets the #GMainContext that @task will return its result in (that
* is, the context that was the <link * is, the context that was the
* linkend="g-main-context-push-thread-default">thread-default main * [thread-default main context][g-main-context-push-thread-default]
* context</link> at the point when @task was created). * at the point when @task was created).
* *
* This will always return a non-%NULL value, even if the task's * This will always return a non-%NULL value, even if the task's
* context is the default #GMainContext. * context is the default #GMainContext.
@ -1380,9 +1377,8 @@ g_task_run_in_thread_sync (GTask *task,
* *
* A utility function for dealing with async operations where you need * A utility function for dealing with async operations where you need
* to wait for a #GSource to trigger. Attaches @source to @task's * to wait for a #GSource to trigger. Attaches @source to @task's
* #GMainContext with @task's <link * #GMainContext with @task's [priority][io-priority], and sets @source's
* linkend="io-priority">priority</link>, and sets @source's callback * callback to @callback, with @task as the callback's `user_data`.
* to @callback, with @task as the callback's `user_data`.
* *
* This takes a reference on @task until @source is destroyed. * This takes a reference on @task until @source is destroyed.
* *

3
gio/gtlsconnection.c
View File

@ -771,8 +771,7 @@ g_tls_connection_handshake (GTlsConnection *conn,
/** /**
* g_tls_connection_handshake_async: * g_tls_connection_handshake_async:
* @conn: a #GTlsConnection * @conn: a #GTlsConnection
* @io_priority: the <link linkend="io-priority">I/O priority</link> * @io_priority: the [I/O priority][io-priority] of the request
* of the request.
* @cancellable: (allow-none): a #GCancellable, or %NULL * @cancellable: (allow-none): a #GCancellable, or %NULL
* @callback: callback to call when the handshake is complete * @callback: callback to call when the handshake is complete
* @user_data: the data to pass to the callback function * @user_data: the data to pass to the callback function

9
gio/gvolume.c
View File

@ -562,8 +562,8 @@ g_volume_eject_with_operation_finish (GVolume *volume,
* @kind: the kind of identifier to return * @kind: the kind of identifier to return
* *
* Gets the identifier of the given kind for @volume. * Gets the identifier of the given kind for @volume.
* See the <link linkend="volume-identifier">introduction</link> * See the [introduction][volume-identifier] for more
* for more information about volume identifiers. * information about volume identifiers.
* *
* Returns: a newly allocated string containing the * Returns: a newly allocated string containing the
* requested identfier, or %NULL if the #GVolume * requested identfier, or %NULL if the #GVolume
@ -590,9 +590,8 @@ g_volume_get_identifier (GVolume *volume,
* g_volume_enumerate_identifiers: * g_volume_enumerate_identifiers:
* @volume: a #GVolume * @volume: a #GVolume
* *
* Gets the kinds of <link linkend="volume-identifier">identifiers</link> * Gets the kinds of [identifiers][volume-identifier] that @volume has.
* that @volume has. Use g_volume_get_identifier() to obtain * Use g_volume_get_identifier() to obtain the identifiers themselves.
* the identifiers themselves.
* *
* Returns: (array zero-terminated=1) (transfer full): a %NULL-terminated array * Returns: (array zero-terminated=1) (transfer full): a %NULL-terminated array
* of strings containing kinds of identifiers. Use g_strfreev() to free. * of strings containing kinds of identifiers. Use g_strfreev() to free.

8
gio/gvolumemonitor.c
View File

@ -39,10 +39,10 @@
* on the computer. In other words, what a file selector or file manager * on the computer. In other words, what a file selector or file manager
* would show in a sidebar. * would show in a sidebar.
* *
* #GVolumeMonitor is not <link * #GVolumeMonitor is not
* linkend="g-main-context-push-thread-default">thread-default-context * [thread-default-context aware][g-main-context-push-thread-default],
* aware</link>, and so should not be used other than from the main * and so should not be used other than from the main thread, with no
* thread, with no thread-default-context active. * thread-default-context active.
**/ **/
G_DEFINE_TYPE (GVolumeMonitor, g_volume_monitor, G_TYPE_OBJECT); G_DEFINE_TYPE (GVolumeMonitor, g_volume_monitor, G_TYPE_OBJECT);

9
glib/gcharset.c
View File

@ -154,11 +154,10 @@ charset_cache_free (gpointer data)
* g_get_charset: * g_get_charset:
* @charset: return location for character set name * @charset: return location for character set name
* *
* Obtains the character set for the <link linkend="setlocale">current * Obtains the character set for the [current locale][setlocale]; you
* locale</link>; you might use this character set as an argument to * might use this character set as an argument to g_convert(), to convert
* g_convert(), to convert from the current locale's encoding to some * from the current locale's encoding to some other encoding. (Frequently
* other encoding. (Frequently g_locale_to_utf8() and g_locale_from_utf8() * g_locale_to_utf8() and g_locale_from_utf8() are nice shortcuts, though.)
* are nice shortcuts, though.)
* *
* On Windows the character set returned by this function is the * On Windows the character set returned by this function is the
* so-called system default ANSI code-page. That is the character set * so-called system default ANSI code-page. That is the character set

40
glib/gconvert.c
View File

@ -104,21 +104,20 @@
* encoding for their strings, and that is also what they use for * encoding for their strings, and that is also what they use for
* the file names they create. However, older file systems may * the file names they create. However, older file systems may
* still contain file names created in "older" encodings, such as * still contain file names created in "older" encodings, such as
* ISO-8859-1. In this case, for compatibility reasons, you may * ISO-8859-1. In this case, for compatibility reasons, you may want
* want to instruct Glib to use that particular encoding for file * to instruct Glib to use that particular encoding for file names
* names rather than UTF-8. You can do this by specifying the * rather than UTF-8. You can do this by specifying the encoding for
* encoding for file names in the <link * file names in the [`G_FILENAME_ENCODING`][G_FILENAME_ENCODING]
* linkend="G_FILENAME_ENCODING">`G_FILENAME_ENCODING`</link>
* environment variable. For example, if your installation uses * environment variable. For example, if your installation uses
* ISO-8859-1 for file names, you can put this in your `~/.profile` * ISO-8859-1 for file names, you can put this in your `~/.profile`
* <programlisting> * |[
* export G_FILENAME_ENCODING=ISO-8859-1 * export G_FILENAME_ENCODING=ISO-8859-1
* </programlisting> * ]|
* Glib provides the functions g_filename_to_utf8() and * Glib provides the functions g_filename_to_utf8() and
* g_filename_from_utf8() to perform the necessary conversions. * g_filename_from_utf8() to perform the necessary conversions.
* These functions convert file names from the encoding specified * These functions convert file names from the encoding specified
* in `G_FILENAME_ENCODING` to UTF-8 and vice-versa. * in `G_FILENAME_ENCODING` to UTF-8 and vice-versa. This
* <xref linkend="file-name-encodings-diagram"/> illustrates how * [diagram][file-name-encodings-diagram] illustrates how
* these functions are used to convert between UTF-8 and the * these functions are used to convert between UTF-8 and the
* encoding for file names in the file system. * encoding for file names in the file system.
* *
@ -885,8 +884,7 @@ strdup_len (const gchar *string,
* *
* Converts a string which is in the encoding used for strings by * Converts a string which is in the encoding used for strings by
* the C runtime (usually the same as that used by the operating * the C runtime (usually the same as that used by the operating
* system) in the <link linkend="setlocale">current locale</link> into a * system) in the [current locale][setlocale] into a UTF-8 string.
* UTF-8 string.
* *
* Return value: A newly-allocated buffer containing the converted string, * Return value: A newly-allocated buffer containing the converted string,
* or %NULL on an error, and error will be set. * or %NULL on an error, and error will be set.
@ -929,8 +927,8 @@ g_locale_to_utf8 (const gchar *opsysstring,
* *
* Converts a string from UTF-8 to the encoding used for strings by * Converts a string from UTF-8 to the encoding used for strings by
* the C runtime (usually the same as that used by the operating * the C runtime (usually the same as that used by the operating
* system) in the <link linkend="setlocale">current locale</link>. On * system) in the [current locale][setlocale]. On Windows this means
* Windows this means the system codepage. * the system codepage.
* *
* Return value: A newly-allocated buffer containing the converted string, * Return value: A newly-allocated buffer containing the converted string,
* or %NULL on an error, and error will be set. * or %NULL on an error, and error will be set.
@ -986,12 +984,12 @@ filename_charset_cache_free (gpointer data)
* *
* `G_FILENAME_ENCODING` may be set to a comma-separated list of * `G_FILENAME_ENCODING` may be set to a comma-separated list of
* character set names. The special token "&commat;locale" is taken * character set names. The special token "&commat;locale" is taken
* to mean the character set for the <link linkend="setlocale">current * to mean the character set for the [current locale][setlocale].
* locale</link>. If `G_FILENAME_ENCODING` is not set, but * If `G_FILENAME_ENCODING` is not set, but `G_BROKEN_FILENAMES` is,
* `G_BROKEN_FILENAMES` is, the character set of the current locale * the character set of the current locale is taken as the filename
* is taken as the filename encoding. If neither environment variable * encoding. If neither environment variable is set, UTF-8 is taken
* is set, UTF-8 is taken as the filename encoding, but the character * as the filename encoding, but the character set of the current locale
* set of the current locale is also put in the list of encodings. * is also put in the list of encodings.
* *
* The returned @charsets belong to GLib and must not be freed. * The returned @charsets belong to GLib and must not be freed.
* *
@ -1134,7 +1132,7 @@ get_filename_charset (const gchar **filename_charset)
* Converts a string which is in the encoding used by GLib for * Converts a string which is in the encoding used by GLib for
* filenames into a UTF-8 string. Note that on Windows GLib uses UTF-8 * filenames into a UTF-8 string. Note that on Windows GLib uses UTF-8
* for filenames; on other platforms, this function indirectly depends on * for filenames; on other platforms, this function indirectly depends on
* the <link linkend="setlocale">current locale</link>. * the [current locale][setlocale].
* *
* Return value: The converted string, or %NULL on an error. * Return value: The converted string, or %NULL on an error.
**/ **/
@ -1206,7 +1204,7 @@ g_filename_to_utf8 (const gchar *opsysstring,
* Converts a string from UTF-8 to the encoding GLib uses for * Converts a string from UTF-8 to the encoding GLib uses for
* filenames. Note that on Windows GLib uses UTF-8 for filenames; * filenames. Note that on Windows GLib uses UTF-8 for filenames;
* on other platforms, this function indirectly depends on the * on other platforms, this function indirectly depends on the
* <link linkend="setlocale">current locale</link>. * [current locale][setlocale].
* *
* Return value: (array length=bytes_written) (element-type guint8) (transfer full): * Return value: (array length=bytes_written) (element-type guint8) (transfer full):
* The converted string, or %NULL on an error. * The converted string, or %NULL on an error.

6
glib/gdataset.c
View File

@ -121,9 +121,9 @@
/** /**
* GData: * GData:
* *
* The #GData struct is an opaque data structure to represent a <link * The #GData struct is an opaque data structure to represent a
* linkend="glib-Keyed-Data-Lists">Keyed Data List</link>. It should * [Keyed Data List][glib-Keyed-Data-Lists]. It should only be
* only be accessed via the following functions. * accessed via the following functions.
**/ **/
/** /**

10
glib/gdate.c
View File

@ -1111,10 +1111,10 @@ g_date_prepare_to_parse (const gchar *str,
* @str: string to parse * @str: string to parse
* *
* Parses a user-inputted string @str, and try to figure out what date it * Parses a user-inputted string @str, and try to figure out what date it
* represents, taking the <link linkend="setlocale">current locale</link> * represents, taking the [current locale][setlocale] into account. If the
* into account. If the string is successfully parsed, the date will be * string is successfully parsed, the date will be valid after the call.
* valid after the call. Otherwise, it will be invalid. You should check * Otherwise, it will be invalid. You should check using g_date_valid()
* using g_date_valid() to see whether the parsing succeeded. * to see whether the parsing succeeded.
* *
* This function is not appropriate for file formats and the like; it * This function is not appropriate for file formats and the like; it
* isn't very precise, and its exact behavior varies with the locale. * isn't very precise, and its exact behavior varies with the locale.
@ -2424,7 +2424,7 @@ win32_strftime_helper (const GDate *d,
* @date: valid #GDate * @date: valid #GDate
* *
* Generates a printed representation of the date, in a * Generates a printed representation of the date, in a
* <link linkend="setlocale">locale</link>-specific way. * [locale][setlocale]-specific way.
* Works just like the platform's C library strftime() function, * Works just like the platform's C library strftime() function,
* but only accepts date-related formats; time-related formats * but only accepts date-related formats; time-related formats
* give undefined results. Date must be valid. Unlike strftime() * give undefined results. Date must be valid. Unlike strftime()

4
glib/ghash.c
View File

@ -95,8 +95,8 @@
* GHashTable: * GHashTable:
* *
* The #GHashTable struct is an opaque data structure to represent a * The #GHashTable struct is an opaque data structure to represent a
* <link linkend="glib-Hash-Tables">Hash Table</link>. It should only be * [Hash Table][glib-Hash-Tables]. It should only be accessed via the
* accessed via the following functions. * following functions.
*/ */
/** /**

11
glib/giochannel.c
View File

@ -50,9 +50,9 @@
* *
* The #GIOChannel data type aims to provide a portable method for * The #GIOChannel data type aims to provide a portable method for
* using file descriptors, pipes, and sockets, and integrating them * using file descriptors, pipes, and sockets, and integrating them
* into the <link linkend="glib-The-Main-Event-Loop">main event * into the [main event loop][glib-The-Main-Event-Loop]. Currently,
* loop</link>. Currently full support is available on UNIX platforms, * full support is available on UNIX platforms, support for Windows
* support for Windows is only partially complete. * is only partially complete.
* *
* To create a new #GIOChannel on UNIX systems use * To create a new #GIOChannel on UNIX systems use
* g_io_channel_unix_new(). This works for plain file descriptors, * g_io_channel_unix_new(). This works for plain file descriptors,
@ -64,9 +64,8 @@
* g_io_channel_write_chars(), g_io_channel_seek_position(), and * g_io_channel_write_chars(), g_io_channel_seek_position(), and
* g_io_channel_shutdown(). * g_io_channel_shutdown().
* *
* To add a #GIOChannel to the <link * To add a #GIOChannel to the [main event loop][glib-The-Main-Event-Loop],
* linkend="glib-The-Main-Event-Loop">main event loop</link> use * use g_io_add_watch() or g_io_add_watch_full(). Here you specify which
* g_io_add_watch() or g_io_add_watch_full(). Here you specify which
* events you are interested in on the #GIOChannel, and provide a * events you are interested in on the #GIOChannel, and provide a
* function to be called whenever these events occur. * function to be called whenever these events occur.
* *

21
glib/glist.c
View File

@ -45,23 +45,21 @@
* Each element in the list contains a piece of data, together with * Each element in the list contains a piece of data, together with
* pointers which link to the previous and next elements in the list. * pointers which link to the previous and next elements in the list.
* Using these pointers it is possible to move through the list in both * Using these pointers it is possible to move through the list in both
* directions (unlike the singly-linked <link * directions (unlike the singly-linked [GSList][glib-Singly-Linked-Lists],
* linkend="glib-Singly-Linked-Lists">#GSList</link> which * which only allows movement through the list in the forward direction).
* only allows movement through the list in the forward direction).
* *
* The double linked list does not keep track of the number of items * The double linked list does not keep track of the number of items
* and does not keep track of both the start and end of the list. If * and does not keep track of both the start and end of the list. If
* you want fast access to both the start and the end of the list, * you want fast access to both the start and the end of the list,
* and/or the number of items in the list, use a * and/or the number of items in the list, use a
* <link linkend="glib-Double-ended-Queues">GQueue</link> instead. * [GQueue][glib-Double-ended-Queues] instead.
* *
* The data contained in each element can be either integer values, by * The data contained in each element can be either integer values, by
* using one of the <link linkend="glib-Type-Conversion-Macros">Type * using one of the [Type Conversion Macros][glib-Type-Conversion-Macros],
* Conversion Macros</link>, or simply pointers to any type of data. * or simply pointers to any type of data.
* *
* List elements are allocated from the <link * List elements are allocated from the [slice allocator][glib-Memory-Slices],
* linkend="glib-Memory-Slices">slice allocator</link>, which is more * which is more efficient than allocating elements individually.
* efficient than allocating elements individually.
* *
* Note that most of the #GList functions expect to be passed a pointer * Note that most of the #GList functions expect to be passed a pointer
* to the first element in the list. The functions which insert * to the first element in the list. The functions which insert
@ -118,9 +116,8 @@
/** /**
* GList: * GList:
* @data: holds the element's data, which can be a pointer to any kind * @data: holds the element's data, which can be a pointer to any kind
* of data, or any integer value using the <link * of data, or any integer value using the
* linkend="glib-Type-Conversion-Macros">Type Conversion * [Type Conversion Macros][glib-Type-Conversion-Macros]
* Macros</link>.
* @next: contains the link to the next element in the list * @next: contains the link to the next element in the list
* @prev: contains the link to the previous element in the list * @prev: contains the link to the previous element in the list
* *

2
glib/gmain.c
View File

@ -688,7 +688,7 @@ static GPrivate thread_context_stack = G_PRIVATE_INIT (free_context_stack);
* *
* Acquires @context and sets it as the thread-default context for the * Acquires @context and sets it as the thread-default context for the
* current thread. This will cause certain asynchronous operations * current thread. This will cause certain asynchronous operations
* (such as most <link linkend="gio">gio</link>-based I/O) which are * (such as most [gio][gio]-based I/O) which are
* started in this thread to run under @context and deliver their * started in this thread to run under @context and deliver their
* results to its main loop, rather than running under the global * results to its main loop, rather than running under the global
* default context in the main thread. Note that calling this function * default context in the main thread. Note that calling this function

3
glib/gmessages.c
View File

@ -1129,8 +1129,7 @@ g_assert_warning (const char *log_domain,
* g_test_expect_message: * g_test_expect_message:
* @log_domain: (allow-none): the log domain of the message * @log_domain: (allow-none): the log domain of the message
* @log_level: the log level of the message * @log_level: the log level of the message
* @pattern: a glob-style * @pattern: a glob-style [pattern][glib-Glob-style-pattern-matching]
* <link linkend="glib-Glob-style-pattern-matching">pattern</link>
* *
* Indicates that a message with the given @log_domain and @log_level, * Indicates that a message with the given @log_domain and @log_level,
* with text matching @pattern, is expected to be logged. When this * with text matching @pattern, is expected to be logged. When this

10
glib/gnode.c
View File

@ -86,8 +86,7 @@
* children are accessed by using the @next pointer of each * children are accessed by using the @next pointer of each
* child. * child.
* *
* The #GNode struct represents one node in a * The #GNode struct represents one node in a [n-ary tree][glib-N-ary-Trees].
* <link linkend="glib-N-ary-Trees">N-ary Tree</link>. fields
**/ **/
#define g_node_alloc0() g_slice_new0 (GNode) #define g_node_alloc0() g_slice_new0 (GNode)
@ -851,10 +850,9 @@ g_node_depth_traverse_level (GNode *node,
* <caption>Post order: A, C, E, D, B, H, I, G, F</caption> * <caption>Post order: A, C, E, D, B, H, I, G, F</caption>
* </mediaobject> * </mediaobject>
* </informalfigure> * </informalfigure>
* @G_LEVEL_ORDER: is not implemented for <link * @G_LEVEL_ORDER: is not implemented for
* linkend="glib-Balanced-Binary-Trees">Balanced Binary * [balanced binary trees][glib-Balanced-Binary-Trees].
* Trees</link>. For <link * For [n-ary trees][glib-N-ary-Trees], it
* linkend="glib-N-ary-Trees">N-ary Trees</link>, it
* vists the root node first, then its children, then * vists the root node first, then its children, then
* its grandchildren, and so on. Note that this is less * its grandchildren, and so on. Note that this is less
* efficient than the other orders. * efficient than the other orders.

3
glib/goption.c
View File

@ -1814,8 +1814,7 @@ platform_get_argv0 (void)
* this function will produce help output to stdout and * this function will produce help output to stdout and
* call `exit (0)`. * call `exit (0)`.
* *
* Note that function depends on the * Note that function depends on the [current locale][setlocale] for
* <link linkend="setlocale">current locale</link> for
* automatic character set conversion of string and filename * automatic character set conversion of string and filename
* arguments. * arguments.
* *

18
glib/gprintf.c
View File

@ -28,7 +28,7 @@
/** /**
* g_printf: * g_printf:
* @format: a standard printf() format string, but notice * @format: a standard printf() format string, but notice
* <link linkend="string-precision">string precision pitfalls</link>. * [string precision pitfalls][string-precision]
* @...: the arguments to insert in the output. * @...: the arguments to insert in the output.
* *
* An implementation of the standard printf() function which supports * An implementation of the standard printf() function which supports
@ -60,7 +60,7 @@ g_printf (gchar const *format,
* g_fprintf: * g_fprintf:
* @file: the stream to write to. * @file: the stream to write to.
* @format: a standard printf() format string, but notice * @format: a standard printf() format string, but notice
* <link linkend="string-precision">string precision pitfalls</link>. * [string precision pitfalls][string-precision]
* @...: the arguments to insert in the output. * @...: the arguments to insert in the output.
* *
* An implementation of the standard fprintf() function which supports * An implementation of the standard fprintf() function which supports
@ -91,7 +91,7 @@ g_fprintf (FILE *file,
* is up to the caller to ensure that the allocated buffer is large * is up to the caller to ensure that the allocated buffer is large
* enough to hold the formatted result * enough to hold the formatted result
* @format: a standard printf() format string, but notice * @format: a standard printf() format string, but notice
* <link linkend="string-precision">string precision pitfalls</link>. * [string precision pitfalls][string-precision]
* @...: the arguments to insert in the output. * @...: the arguments to insert in the output.
* *
* An implementation of the standard sprintf() function which supports * An implementation of the standard sprintf() function which supports
@ -127,7 +127,7 @@ g_sprintf (gchar *string,
* @n: the maximum number of bytes to produce (including the * @n: the maximum number of bytes to produce (including the
* terminating nul character). * terminating nul character).
* @format: a standard printf() format string, but notice * @format: a standard printf() format string, but notice
* <link linkend="string-precision">string precision pitfalls</link>. * [string precision pitfalls][string-precision]
* @...: the arguments to insert in the output. * @...: the arguments to insert in the output.
* *
* A safer form of the standard sprintf() function. The output is guaranteed * A safer form of the standard sprintf() function. The output is guaranteed
@ -170,7 +170,7 @@ g_snprintf (gchar *string,
/** /**
* g_vprintf: * g_vprintf:
* @format: a standard printf() format string, but notice * @format: a standard printf() format string, but notice
* <link linkend="string-precision">string precision pitfalls</link>. * [string precision pitfalls][string-precision]
* @args: the list of arguments to insert in the output. * @args: the list of arguments to insert in the output.
* *
* An implementation of the standard vprintf() function which supports * An implementation of the standard vprintf() function which supports
@ -193,7 +193,7 @@ g_vprintf (gchar const *format,
* g_vfprintf: * g_vfprintf:
* @file: the stream to write to. * @file: the stream to write to.
* @format: a standard printf() format string, but notice * @format: a standard printf() format string, but notice
* <link linkend="string-precision">string precision pitfalls</link>. * [string precision pitfalls][string-precision]
* @args: the list of arguments to insert in the output. * @args: the list of arguments to insert in the output.
* *
* An implementation of the standard fprintf() function which supports * An implementation of the standard fprintf() function which supports
@ -217,7 +217,7 @@ g_vfprintf (FILE *file,
* g_vsprintf: * g_vsprintf:
* @string: the buffer to hold the output. * @string: the buffer to hold the output.
* @format: a standard printf() format string, but notice * @format: a standard printf() format string, but notice
* <link linkend="string-precision">string precision pitfalls</link>. * [string precision pitfalls][string-precision]
* @args: the list of arguments to insert in the output. * @args: the list of arguments to insert in the output.
* *
* An implementation of the standard vsprintf() function which supports * An implementation of the standard vsprintf() function which supports
@ -244,7 +244,7 @@ g_vsprintf (gchar *string,
* @n: the maximum number of bytes to produce (including the * @n: the maximum number of bytes to produce (including the
* terminating nul character). * terminating nul character).
* @format: a standard printf() format string, but notice * @format: a standard printf() format string, but notice
* <link linkend="string-precision">string precision pitfalls</link>. * string precision pitfalls][string-precision]
* @args: the list of arguments to insert in the output. * @args: the list of arguments to insert in the output.
* *
* A safer form of the standard vsprintf() function. The output is guaranteed * A safer form of the standard vsprintf() function. The output is guaranteed
@ -284,7 +284,7 @@ g_vsnprintf (gchar *string,
* g_vasprintf: * g_vasprintf:
* @string: the return location for the newly-allocated string. * @string: the return location for the newly-allocated string.
* @format: a standard printf() format string, but notice * @format: a standard printf() format string, but notice
* <link linkend="string-precision">string precision pitfalls</link>. * [string precision pitfalls][string-precision]
* @args: the list of arguments to insert in the output. * @args: the list of arguments to insert in the output.
* *
* An implementation of the GNU vasprintf() function which supports * An implementation of the GNU vasprintf() function which supports

5
glib/gquark.c
View File

@ -63,9 +63,8 @@ static gint quark_block_offset = 0;
* Given either the string or the #GQuark identifier it is possible to * Given either the string or the #GQuark identifier it is possible to
* retrieve the other. * retrieve the other.
* *
* Quarks are used for both <link * Quarks are used for both [datasets][glib-Datasets] and
* linkend="glib-Datasets">Datasets</link> and <link * [keyed data lists][glib-Keyed-Data-Lists].
* linkend="glib-Keyed-Data-Lists">Keyed Data Lists</link>.
* *
* To create a new quark from a string, use g_quark_from_string() or * To create a new quark from a string, use g_quark_from_string() or
* g_quark_from_static_string(). * g_quark_from_static_string().

4
glib/gqueue.c
View File

@ -32,8 +32,8 @@
* as #GList to store elements. * as #GList to store elements.
* *
* The data contained in each element can be either integer values, by * The data contained in each element can be either integer values, by
* using one of the <link linkend="glib-Type-Conversion-Macros">Type * using one of the [Type Conversion Macros][glib-Type-Conversion-Macros],
* Conversion Macros</link>, or simply pointers to any type of data. * or simply pointers to any type of data.
* *
* To create a new GQueue, use g_queue_new(). * To create a new GQueue, use g_queue_new().
* *

2
glib/gregex.c
View File

@ -42,7 +42,7 @@
* SECTION:gregex * SECTION:gregex
* @title: Perl-compatible regular expressions * @title: Perl-compatible regular expressions
* @short_description: matches strings against regular expressions * @short_description: matches strings against regular expressions
* @see_also: <xref linkend="glib-regex-syntax"/> * @see_also: [Regular expression syntax][glib-regex-syntax]
* *
* The g_regex_*() functions implement regular * The g_regex_*() functions implement regular
* expression pattern matching using syntax and semantics similar to * expression pattern matching using syntax and semantics similar to

11
glib/gsequence.c
View File

@ -30,11 +30,10 @@
* *
* The #GSequence data structure has the API of a list, but is * The #GSequence data structure has the API of a list, but is
* implemented internally with a balanced binary tree. This means that * implemented internally with a balanced binary tree. This means that
* it is possible to maintain a sorted list of n elements in time O(n * it is possible to maintain a sorted list of n elements in time O(n log n).
* log n). The data contained in each element can be either integer * The data contained in each element can be either integer values, by using
* values, by using of the <link * of the [Type Conversion Macros][glib-Type-Conversion-Macros], or simply
* linkend="glib-Type-Conversion-Macros">Type Conversion Macros</link>, * pointers to any type of data.
* or simply pointers to any type of data.
* *
* A #GSequence is accessed through "iterators", represented by a * A #GSequence is accessed through "iterators", represented by a
* #GSequenceIter. An iterator represents a position between two * #GSequenceIter. An iterator represents a position between two
@ -91,7 +90,7 @@ typedef struct _GSequenceNode GSequenceNode;
* GSequence: * GSequence:
* *
* The #GSequence struct is an opaque data type representing a * The #GSequence struct is an opaque data type representing a
* <link linkend="glib-Sequences">Sequence</link> data type. * [sequence][glib-Sequences] data type.
*/ */
struct _GSequence struct _GSequence
{ {

33
glib/gslice.c
View File

@ -870,8 +870,7 @@ thread_memory_magazine2_free (ThreadMemory *tmem,
* It calls g_slice_alloc() with `sizeof (@type)` and casts the * It calls g_slice_alloc() with `sizeof (@type)` and casts the
* returned pointer to a pointer of the given type, avoiding a type * returned pointer to a pointer of the given type, avoiding a type
* cast in the source code. Note that the underlying slice allocation * cast in the source code. Note that the underlying slice allocation
* mechanism can be changed with the * mechanism can be changed with the [`G_SLICE=always-malloc`][G_SLICE]
* <link linkend="G_SLICE">G_SLICE=always-malloc</link>
* environment variable. * environment variable.
* *
* Returns: a pointer to the allocated block, cast to a pointer to @type * Returns: a pointer to the allocated block, cast to a pointer to @type
@ -890,7 +889,7 @@ thread_memory_magazine2_free (ThreadMemory *tmem,
* and casts the returned pointer to a pointer of the given type, * and casts the returned pointer to a pointer of the given type,
* avoiding a type cast in the source code. * avoiding a type cast in the source code.
* Note that the underlying slice allocation mechanism can * Note that the underlying slice allocation mechanism can
* be changed with the <link linkend="G_SLICE">G_SLICE=always-malloc</link> * be changed with the [`G_SLICE=always-malloc`][G_SLICE]
* environment variable. * environment variable.
* *
* Since: 2.10 * Since: 2.10
@ -908,7 +907,7 @@ thread_memory_magazine2_free (ThreadMemory *tmem,
* and casts the returned pointer to a pointer of the given type, * and casts the returned pointer to a pointer of the given type,
* avoiding a type cast in the source code. * avoiding a type cast in the source code.
* Note that the underlying slice allocation mechanism can * Note that the underlying slice allocation mechanism can
* be changed with the <link linkend="G_SLICE">G_SLICE=always-malloc</link> * be changed with the [`G_SLICE=always-malloc`][G_SLICE]
* environment variable. * environment variable.
* *
* Returns: a pointer to the allocated block, cast to a pointer to @type * Returns: a pointer to the allocated block, cast to a pointer to @type
@ -927,9 +926,8 @@ thread_memory_magazine2_free (ThreadMemory *tmem,
* It calls g_slice_free1() using `sizeof (type)` * It calls g_slice_free1() using `sizeof (type)`
* as the block size. * as the block size.
* Note that the exact release behaviour can be changed with the * Note that the exact release behaviour can be changed with the
* <link linkend="G_DEBUG">G_DEBUG=gc-friendly</link> environment * [`G_DEBUG=gc-friendly`][G_DEBUG] environment variable, also see
* variable, also see <link linkend="G_SLICE">G_SLICE</link> for * [`G_SLICE`][G_SLICE] for related debugging options.
* related debugging options.
* *
* Since: 2.10 * Since: 2.10
*/ */
@ -946,9 +944,8 @@ thread_memory_magazine2_free (ThreadMemory *tmem,
* a @next pointer (similar to #GSList). The name of the * a @next pointer (similar to #GSList). The name of the
* @next field in @type is passed as third argument. * @next field in @type is passed as third argument.
* Note that the exact release behaviour can be changed with the * Note that the exact release behaviour can be changed with the
* <link linkend="G_DEBUG">G_DEBUG=gc-friendly</link> environment * [`G_DEBUG=gc-friendly`][G_DEBUG] environment variable, also see
* variable, also see <link linkend="G_SLICE">G_SLICE</link> for * [`G_SLICE`][G_SLICE] for related debugging options.
* related debugging options.
* *
* Since: 2.10 * Since: 2.10
*/ */
@ -964,7 +961,7 @@ thread_memory_magazine2_free (ThreadMemory *tmem,
* if a malloc() fallback implementation is used instead, * if a malloc() fallback implementation is used instead,
* the alignment may be reduced in a libc dependent fashion. * the alignment may be reduced in a libc dependent fashion.
* Note that the underlying slice allocation mechanism can * Note that the underlying slice allocation mechanism can
* be changed with the <link linkend="G_SLICE">G_SLICE=always-malloc</link> * be changed with the [`G_SLICE=always-malloc`][G_SLICE]
* environment variable. * environment variable.
* *
* Returns: a pointer to the allocated memory block * Returns: a pointer to the allocated memory block
@ -1022,8 +1019,7 @@ g_slice_alloc (gsize mem_size)
* *
* Allocates a block of memory via g_slice_alloc() and initializes * Allocates a block of memory via g_slice_alloc() and initializes
* the returned memory to 0. Note that the underlying slice allocation * the returned memory to 0. Note that the underlying slice allocation
* mechanism can be changed with the * mechanism can be changed with the [`G_SLICE=always-malloc`][G_SLICE]
* <link linkend="G_SLICE">G_SLICE=always-malloc</link>
* environment variable. * environment variable.
* *
* Returns: a pointer to the allocated block * Returns: a pointer to the allocated block
@ -1071,10 +1067,8 @@ g_slice_copy (gsize mem_size,
* The memory must have been allocated via g_slice_alloc() or * The memory must have been allocated via g_slice_alloc() or
* g_slice_alloc0() and the @block_size has to match the size * g_slice_alloc0() and the @block_size has to match the size
* specified upon allocation. Note that the exact release behaviour * specified upon allocation. Note that the exact release behaviour
* can be changed with the * can be changed with the [`G_DEBUG=gc-friendly`][G_DEBUG] environment
* <link linkend="G_DEBUG">G_DEBUG=gc-friendly</link> environment * variable, also see [`G_SLICE`][G_SLICE] for related debugging options.
* variable, also see <link linkend="G_SLICE">G_SLICE</link> for
* related debugging options.
* *
* Since: 2.10 * Since: 2.10
*/ */
@ -1133,9 +1127,8 @@ g_slice_free1 (gsize mem_size,
* @next pointer (similar to #GSList). The offset of the @next * @next pointer (similar to #GSList). The offset of the @next
* field in each block is passed as third argument. * field in each block is passed as third argument.
* Note that the exact release behaviour can be changed with the * Note that the exact release behaviour can be changed with the
* <link linkend="G_DEBUG">G_DEBUG=gc-friendly</link> environment * [`G_DEBUG=gc-friendly`][G_DEBUG] environment variable, also see
* variable, also see <link linkend="G_SLICE">G_SLICE</link> for * [`G_SLICE`][G_SLICE] for related debugging options.
* related debugging options.
* *
* Since: 2.10 * Since: 2.10
*/ */

101
glib/gslist.c
View File

@ -1,60 +1,58 @@
/* GLIB - Library of useful routines for C programming /* GLIB - Library of useful routines for C programming
* Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public * modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either * License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version. * version 2 of the License, or (at your option) any later version.
* *
* This library is distributed in the hope that it will be useful, * This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of * but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details. * Lesser General Public License for more details.
* *
* You should have received a copy of the GNU Lesser General Public * You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, see <http://www.gnu.org/licenses/>. * License along with this library; if not, see <http://www.gnu.org/licenses/>.
*/ */
/* /*
* Modified by the GLib Team and others 1997-2000. See the AUTHORS * Modified by the GLib Team and others 1997-2000. See the AUTHORS
* file for a list of people on the GLib Team. See the ChangeLog * file for a list of people on the GLib Team. See the ChangeLog
* files for a list of changes. These files are distributed with * files for a list of changes. These files are distributed with
* GLib at ftp://ftp.gtk.org/pub/gtk/. * GLib at ftp://ftp.gtk.org/pub/gtk/.
*/ */
/* /*
* MT safe * MT safe
*/ */
#include "config.h" #include "config.h"
#include "gslist.h" #include "gslist.h"
#include "gtestutils.h" #include "gtestutils.h"
#include "gslice.h" #include "gslice.h"
/** /**
* SECTION:linked_lists_single * SECTION:linked_lists_single
* @title: Singly-Linked Lists * @title: Singly-Linked Lists
* @short_description: linked lists that can be iterated in one direction * @short_description: linked lists that can be iterated in one direction
*
* The #GSList structure and its associated functions provide a
* standard singly-linked list data structure.
*
* Each element in the list contains a piece of data, together with a
* pointer which links to the next element in the list. Using this
* pointer it is possible to move through the list in one direction
* only (unlike the [double-linked lists][glib-Doubly-Linked-Lists],
* which allow movement in both directions).
*
* The data contained in each element can be either integer values, by
* using one of the [Type Conversion Macros][glib-Type-Conversion-Macros],
* or simply pointers to any type of data.
* *
* The #GSList structure and its associated functions provide a * List elements are allocated from the [slice allocator][glib-Memory-Slices],
* standard singly-linked list data structure. * which is more efficient than allocating elements individually.
*
* Each element in the list contains a piece of data, together with a
* pointer which links to the next element in the list. Using this
* pointer it is possible to move through the list in one direction
* only (unlike the <link
* linkend="glib-Doubly-Linked-Lists">Doubly-Linked Lists</link> which
* allow movement in both directions).
*
* The data contained in each element can be either integer values, by
* using one of the <link linkend="glib-Type-Conversion-Macros">Type
* Conversion Macros</link>, or simply pointers to any type of data.
*
* List elements are allocated from the <link
* linkend="glib-Memory-Slices">slice allocator</link>, which is more
* efficient than allocating elements individually.
* *
* Note that most of the #GSList functions expect to be passed a * Note that most of the #GSList functions expect to be passed a
* pointer to the first element in the list. The functions which insert * pointer to the first element in the list. The functions which insert
@ -84,9 +82,8 @@
/** /**
* GSList: * GSList:
* @data: holds the element's data, which can be a pointer to any kind * @data: holds the element's data, which can be a pointer to any kind
* of data, or any integer value using the <link * of data, or any integer value using the
* linkend="glib-Type-Conversion-Macros">Type Conversion * [Type Conversion Macros][glib-Type-Conversion-Macros]
* Macros</link>.
* @next: contains the link to the next element in the list. * @next: contains the link to the next element in the list.
* *
* The #GSList struct is used for each element in the singly-linked * The #GSList struct is used for each element in the singly-linked

4
glib/gstrfuncs.c
View File

@ -485,7 +485,7 @@ g_stpcpy (gchar *dest,
/** /**
* g_strdup_vprintf: * g_strdup_vprintf:
* @format: a standard printf() format string, but notice * @format: a standard printf() format string, but notice
* <link linkend="string-precision">string precision pitfalls</link> * [string precision pitfalls][string-precision]
* @args: the list of parameters to insert into the format string * @args: the list of parameters to insert into the format string
* *
* Similar to the standard C vsprintf() function but safer, since it * Similar to the standard C vsprintf() function but safer, since it
@ -512,7 +512,7 @@ g_strdup_vprintf (const gchar *format,
/** /**
* g_strdup_printf: * g_strdup_printf:
* @format: a standard printf() format string, but notice * @format: a standard printf() format string, but notice
* <link linkend="string-precision">string precision pitfalls</link> * [string precision pitfalls][string-precision]
* @...: the parameters to insert into the format string * @...: the parameters to insert into the format string
* *
* Similar to the standard C sprintf() function but safer, since it * Similar to the standard C sprintf() function but safer, since it

15
glib/gtestutils.c
View File

@ -59,8 +59,7 @@
* SECTION:testing * SECTION:testing
* @title: Testing * @title: Testing
* @short_description: a test framework * @short_description: a test framework
* @see_also: <link linkend="gtester">gtester</link>, * @see_also: [gtester][gtester], [gtester-report][gtester-report]
* <link linkend="gtester-report">gtester-report</link>
* *
* GLib provides a framework for writing and maintaining unit tests * GLib provides a framework for writing and maintaining unit tests
* in parallel to the code they are testing. The API is designed according * in parallel to the code they are testing. The API is designed according
@ -253,8 +252,7 @@
/** /**
* g_test_trap_assert_stdout: * g_test_trap_assert_stdout:
* @soutpattern: a glob-style * @soutpattern: a glob-style [pattern][glib-Glob-style-pattern-matching]
* <link linkend="glib-Glob-style-pattern-matching">pattern</link>
* *
* Assert that the stdout output of the last test subprocess matches * Assert that the stdout output of the last test subprocess matches
* @soutpattern. See g_test_trap_subprocess(). * @soutpattern. See g_test_trap_subprocess().
@ -264,8 +262,7 @@
/** /**
* g_test_trap_assert_stdout_unmatched: * g_test_trap_assert_stdout_unmatched:
* @soutpattern: a glob-style * @soutpattern: a glob-style [pattern][glib-Glob-style-pattern-matching]
* <link linkend="glib-Glob-style-pattern-matching">pattern</link>
* *
* Assert that the stdout output of the last test subprocess * Assert that the stdout output of the last test subprocess
* does not match @soutpattern. See g_test_trap_subprocess(). * does not match @soutpattern. See g_test_trap_subprocess().
@ -275,8 +272,7 @@
/** /**
* g_test_trap_assert_stderr: * g_test_trap_assert_stderr:
* @serrpattern: a glob-style * @serrpattern: a glob-style [pattern][glib-Glob-style-pattern-matching]
* <link linkend="glib-Glob-style-pattern-matching">pattern</link>
* *
* Assert that the stderr output of the last test subprocess * Assert that the stderr output of the last test subprocess
* matches @serrpattern. See g_test_trap_subprocess(). * matches @serrpattern. See g_test_trap_subprocess().
@ -293,8 +289,7 @@
/** /**
* g_test_trap_assert_stderr_unmatched: * g_test_trap_assert_stderr_unmatched:
* @serrpattern: a glob-style * @serrpattern: a glob-style [pattern][glib-Glob-style-pattern-matching]
* <link linkend="glib-Glob-style-pattern-matching">pattern</link>
* *
* Assert that the stderr output of the last test subprocess * Assert that the stderr output of the last test subprocess
* does not match @serrpattern. See g_test_trap_subprocess(). * does not match @serrpattern. See g_test_trap_subprocess().

9
glib/gtree.c
View File

@ -71,9 +71,9 @@ typedef struct _GTreeNode GTreeNode;
/** /**
* GTree: * GTree:
* *
* The GTree struct is an opaque data structure representing a <link * The GTree struct is an opaque data structure representing a
* linkend="glib-Balanced-Binary-Trees">Balanced Binary Tree</link>. * [balanced binary tree][glib-Balanced-Binary-Trees]. It should be
* It should be accessed only by using the following functions. * accessed only by using the following functions.
*/ */
struct _GTree struct _GTree
{ {
@ -940,8 +940,7 @@ g_tree_foreach (GTree *tree,
* Deprecated:2.2: The order of a balanced tree is somewhat arbitrary. * Deprecated:2.2: The order of a balanced tree is somewhat arbitrary.
* If you just want to visit all nodes in sorted order, use * If you just want to visit all nodes in sorted order, use
* g_tree_foreach() instead. If you really need to visit nodes in * g_tree_foreach() instead. If you really need to visit nodes in
* a different order, consider using an * a different order, consider using an [n-ary tree][glib-N-ary-Trees].
* <link linkend="glib-N-ary-Trees">N-ary Tree</link>.
*/ */
/** /**
* GTraverseFunc: * GTraverseFunc:

8
glib/gunicollate.c
View File

@ -65,7 +65,7 @@ msc_strxfrm_wrapper (char *string1,
* @str2: a UTF-8 encoded string * @str2: a UTF-8 encoded string
* *
* Compares two strings for ordering using the linguistically * Compares two strings for ordering using the linguistically
* correct rules for the <link linkend="setlocale">current locale</link>. * correct rules for the [current locale][setlocale].
* When sorting a large number of strings, it will be significantly * When sorting a large number of strings, it will be significantly
* faster to obtain collation keys with g_utf8_collate_key() and * faster to obtain collation keys with g_utf8_collate_key() and
* compare the keys with strcmp() when sorting instead of sorting * compare the keys with strcmp() when sorting instead of sorting
@ -363,8 +363,7 @@ carbon_collate_key_for_filename (const gchar *str,
* with strcmp() will always be the same as comparing the two * with strcmp() will always be the same as comparing the two
* original keys with g_utf8_collate(). * original keys with g_utf8_collate().
* *
* Note that this function depends on the * Note that this function depends on the [current locale][setlocale].
* <link linkend="setlocale">current locale</link>.
* *
* Return value: a newly allocated string. This string should * Return value: a newly allocated string. This string should
* be freed with g_free() when you are done with it. * be freed with g_free() when you are done with it.
@ -491,8 +490,7 @@ g_utf8_collate_key (const gchar *str,
* would like to treat numbers intelligently so that "file1" "file10" "file5" * would like to treat numbers intelligently so that "file1" "file10" "file5"
* is sorted as "file1" "file5" "file10". * is sorted as "file1" "file5" "file10".
* *
* Note that this function depends on the * Note that this function depends on the [current locale][setlocale].
* <link linkend="setlocale">current locale</link>.
* *
* Return value: a newly allocated string. This string should * Return value: a newly allocated string. This string should
* be freed with g_free() when you are done with it. * be freed with g_free() when you are done with it.

8
glib/gvariant-parser.c
View File

@ -2325,7 +2325,7 @@ parse (TokenStream *stream,
* *
* A single #GVariant is parsed from the content of @text. * A single #GVariant is parsed from the content of @text.
* *
* The format is described <link linkend='gvariant-text'>here</link>. * The format is described [here][gvariant-text].
* *
* The memory at @limit will never be accessed and the parser behaves as * The memory at @limit will never be accessed and the parser behaves as
* if the character at @limit is the nul terminator. This has the * if the character at @limit is the nul terminator. This has the
@ -2430,7 +2430,7 @@ g_variant_parse (const GVariantType *type,
* *
* Note that the arguments in @app must be of the correct width for their types * Note that the arguments in @app must be of the correct width for their types
* specified in @format when collected into the #va_list. See * specified in @format when collected into the #va_list. See
* the <link linkend='gvariant-varargs'>GVariant varargs documentation</link>. * the [GVariant varargs documentation][gvariant-varargs].
* *
* In order to behave correctly in all cases it is necessary for the * In order to behave correctly in all cases it is necessary for the
* calling function to g_variant_ref_sink() the return result before * calling function to g_variant_ref_sink() the return result before
@ -2487,7 +2487,7 @@ g_variant_new_parsed_va (const gchar *format,
* *
* Note that the arguments must be of the correct width for their types * Note that the arguments must be of the correct width for their types
* specified in @format. This can be achieved by casting them. See * specified in @format. This can be achieved by casting them. See
* the <link linkend='gvariant-varargs'>GVariant varargs documentation</link>. * the [GVariant varargs documentation][gvariant-varargs].
* *
* Consider this simple example: * Consider this simple example:
* |[<!-- language="C" --> * |[<!-- language="C" -->
@ -2540,7 +2540,7 @@ g_variant_new_parsed (const gchar *format,
* *
* Note that the arguments must be of the correct width for their types * Note that the arguments must be of the correct width for their types
* specified in @format_string. This can be achieved by casting them. See * specified in @format_string. This can be achieved by casting them. See
* the <link linkend='gvariant-varargs'>GVariant varargs documentation</link>. * the [GVariant varargs documentation][gvariant-varargs].
* *
* This function might be used as follows: * This function might be used as follows:
* *

51
glib/gvariant.c
View File

@ -922,7 +922,7 @@ g_variant_new_dict_entry (GVariant *key,
* @format_string determines the C types that are used for unpacking * @format_string determines the C types that are used for unpacking
* the values and also determines if the values are copied or borrowed, * the values and also determines if the values are copied or borrowed,
* see the section on * see the section on
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>. * [GVariant format strings][gvariant-format-strings-pointers].
* *
* This function is currently implemented with a linear scan. If you * This function is currently implemented with a linear scan. If you
* plan to do many lookups then #GVariantDict may be more efficient. * plan to do many lookups then #GVariantDict may be more efficient.
@ -1069,8 +1069,7 @@ g_variant_lookup_value (GVariant *dictionary,
* *
* @element_size must be the size of a single element in the array, * @element_size must be the size of a single element in the array,
* as given by the section on * as given by the section on
* <link linkend='gvariant-serialised-data-memory'>Serialised Data * [serialized data memory][gvariant-serialised-data-memory].
* Memory</link>.
* *
* In particular, arrays of these fixed-sized types can be interpreted * In particular, arrays of these fixed-sized types can be interpreted
* as an array of the given C type, with @element_size set to the size * as an array of the given C type, with @element_size set to the size
@ -2577,7 +2576,7 @@ g_variant_print_string (GVariant *value,
* *
* Pretty-prints @value in the format understood by g_variant_parse(). * Pretty-prints @value in the format understood by g_variant_parse().
* *
* The format is described <link linkend='gvariant-text'>here</link>. * The format is described [here][gvariant-text].
* *
* If @type_annotate is %TRUE, then type information is included in * If @type_annotate is %TRUE, then type information is included in
* the output. * the output.
@ -3844,10 +3843,9 @@ g_variant_dict_init (GVariantDict *dict,
* this function returns %FALSE. Otherwise, it unpacks the returned * this function returns %FALSE. Otherwise, it unpacks the returned
* value and returns %TRUE. * value and returns %TRUE.
* *
* @format_string determines the C types that are used for unpacking * @format_string determines the C types that are used for unpacking the
* the values and also determines if the values are copied or borrowed, * values and also determines if the values are copied or borrowed, see the
* see the section on * section on [GVariant format strings][gvariant-format-strings-pointers].
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
* *
* Returns: %TRUE if a value was unpacked * Returns: %TRUE if a value was unpacked
* *
@ -4158,8 +4156,7 @@ g_variant_dict_unref (GVariantDict *dict)
* not be accessed and the effect is otherwise equivalent to if the * not be accessed and the effect is otherwise equivalent to if the
* character at @limit were nul. * character at @limit were nul.
* *
* See the section on <link linkend='gvariant-format-strings'>GVariant * See the section on [GVariant format strings][gvariant-format-strings].
* Format Strings</link>.
* *
* Returns: %TRUE if there was a valid format string * Returns: %TRUE if there was a valid format string
* *
@ -5158,11 +5155,11 @@ g_variant_valist_get (const gchar **str,
* *
* Think of this function as an analogue to g_strdup_printf(). * Think of this function as an analogue to g_strdup_printf().
* *
* The type of the created instance and the arguments that are * The type of the created instance and the arguments that are expected
* expected by this function are determined by @format_string. See the * by this function are determined by @format_string. See the section on
* section on <link linkend='gvariant-format-strings'>GVariant Format * [GVariant format strings][gvariant-format-strings]. Please note that
* Strings</link>. Please note that the syntax of the format string is * the syntax of the format string is very likely to be extended in the
* very likely to be extended in the future. * future.
* *
* The first character of the format string must not be '*' '?' '@' or * The first character of the format string must not be '*' '?' '@' or
* 'r'; in essence, a new #GVariant must always be constructed by this * 'r'; in essence, a new #GVariant must always be constructed by this
@ -5170,7 +5167,7 @@ g_variant_valist_get (const gchar **str,
* *
* Note that the arguments must be of the correct width for their types * Note that the arguments must be of the correct width for their types
* specified in @format_string. This can be achieved by casting them. See * specified in @format_string. This can be achieved by casting them. See
* the <link linkend='gvariant-varargs'>GVariant varargs documentation</link>. * the [GVariant varargs documentation][gvariant-varargs].
* *
* <programlisting> * <programlisting>
* MyFlags some_flags = FLAG_ONE | FLAG_TWO; * MyFlags some_flags = FLAG_ONE | FLAG_TWO;
@ -5229,9 +5226,9 @@ g_variant_new (const gchar *format_string,
* @format_string, are collected from this #va_list and the list is left * @format_string, are collected from this #va_list and the list is left
* pointing to the argument following the last. * pointing to the argument following the last.
* *
* Note that the arguments in @app must be of the correct width for their types * Note that the arguments in @app must be of the correct width for their
* specified in @format_string when collected into the #va_list. See * types specified in @format_string when collected into the #va_list.
* the <link linkend='gvariant-varargs'>GVariant varargs documentation</link>. * See the [GVariant varargs documentation][gvariant-varargs.
* *
* These two generalisations allow mixing of multiple calls to * These two generalisations allow mixing of multiple calls to
* g_variant_new_va() and g_variant_get_va() within a single actual * g_variant_new_va() and g_variant_get_va() within a single actual
@ -5286,15 +5283,15 @@ g_variant_new_va (const gchar *format_string,
* The arguments that are expected by this function are entirely * The arguments that are expected by this function are entirely
* determined by @format_string. @format_string also restricts the * determined by @format_string. @format_string also restricts the
* permissible types of @value. It is an error to give a value with * permissible types of @value. It is an error to give a value with
* an incompatible type. See the section on <link * an incompatible type. See the section on
* linkend='gvariant-format-strings'>GVariant Format Strings</link>. * [GVariant format strings][gvariant-format-strings].
* Please note that the syntax of the format string is very likely to be * Please note that the syntax of the format string is very likely to be
* extended in the future. * extended in the future.
* *
* @format_string determines the C types that are used for unpacking * @format_string determines the C types that are used for unpacking
* the values and also determines if the values are copied or borrowed, * the values and also determines if the values are copied or borrowed,
* see the section on * see the section on
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>. * [GVariant format strings][gvariant-format-strings-pointers].
* *
* Since: 2.24 * Since: 2.24
**/ **/
@ -5347,7 +5344,7 @@ g_variant_get (GVariant *value,
* @format_string determines the C types that are used for unpacking * @format_string determines the C types that are used for unpacking
* the values and also determines if the values are copied or borrowed, * the values and also determines if the values are copied or borrowed,
* see the section on * see the section on
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>. * [GVariant format strings][gvariant-format-strings-pointers].
* *
* Since: 2.24 * Since: 2.24
**/ **/
@ -5386,7 +5383,7 @@ g_variant_get_va (GVariant *value,
* *
* Note that the arguments must be of the correct width for their types * Note that the arguments must be of the correct width for their types
* specified in @format_string. This can be achieved by casting them. See * specified in @format_string. This can be achieved by casting them. See
* the <link linkend='gvariant-varargs'>GVariant varargs documentation</link>. * the [GVariant varargs documentation][gvariant-varargs].
* *
* This function might be used as follows: * This function might be used as follows:
* *
@ -5442,7 +5439,7 @@ g_variant_builder_add (GVariantBuilder *builder,
* @format_string determines the C types that are used for unpacking * @format_string determines the C types that are used for unpacking
* the values and also determines if the values are copied or borrowed, * the values and also determines if the values are copied or borrowed,
* see the section on * see the section on
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>. * [GVariant format strings][gvariant-format-strings-pointers].
* *
* Since: 2.24 * Since: 2.24
**/ **/
@ -5511,7 +5508,7 @@ g_variant_get_child (GVariant *value,
* the values and also determines if the values are copied or borrowed. * the values and also determines if the values are copied or borrowed.
* *
* See the section on * See the section on
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>. * [GVariant format strings][gvariant-format-strings-pointers].
* *
* Returns: %TRUE if a value was unpacked, or %FALSE if there as no value * Returns: %TRUE if a value was unpacked, or %FALSE if there as no value
* *
@ -5611,7 +5608,7 @@ g_variant_iter_next (GVariantIter *iter,
* the values and also determines if the values are copied or borrowed. * the values and also determines if the values are copied or borrowed.
* *
* See the section on * See the section on
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>. * [GVariant format strings][gvariant-format-strings-pointers].
* *
* Returns: %TRUE if a value was unpacked, or %FALSE if there was no * Returns: %TRUE if a value was unpacked, or %FALSE if there was no
* value * value

4
gmodule/gmodule.c
View File

@ -129,8 +129,8 @@
* GModule: * GModule:
* *
* The #GModule struct is an opaque data structure to represent a * The #GModule struct is an opaque data structure to represent a
* <link linkend="glib-Dynamic-Loading-of-Modules">Dynamically-Loaded * [dynamically-loaded module][glib-Dynamic-Loading-of-Modules].
* Module</link>. It should only be accessed via the following functions. * It should only be accessed via the following functions.
*/ */
/** /**

10
gobject/gclosure.c
View File

@ -61,9 +61,8 @@
* marshaller for any closure which is connected to this * marshaller for any closure which is connected to this
* signal. GObject provides a number of C marshallers for this * signal. GObject provides a number of C marshallers for this
* purpose, see the g_cclosure_marshal_*() functions. Additional C * purpose, see the g_cclosure_marshal_*() functions. Additional C
* marshallers can be generated with the <link * marshallers can be generated with the [glib-genmarshal][glib-genmarshal]
* linkend="glib-genmarshal">glib-genmarshal</link> utility. Closures * utility. Closures can be explicitly connected to signals with
* can be explicitly connected to signals with
* g_signal_connect_closure(), but it usually more convenient to let * g_signal_connect_closure(), but it usually more convenient to let
* GObject create a closure automatically by using one of the * GObject create a closure automatically by using one of the
* g_signal_connect_*() functions which take a callback function/user * g_signal_connect_*() functions which take a callback function/user
@ -308,9 +307,8 @@ g_closure_set_meta_va_marshal (GClosure *closure,
* Sets the meta marshaller of @closure. A meta marshaller wraps * Sets the meta marshaller of @closure. A meta marshaller wraps
* @closure->marshal and modifies the way it is called in some * @closure->marshal and modifies the way it is called in some
* fashion. The most common use of this facility is for C callbacks. * fashion. The most common use of this facility is for C callbacks.
* The same marshallers (generated by <link * The same marshallers (generated by [glib-genmarshal][glib-genmarshal]),
* linkend="glib-genmarshal">glib-genmarshal</link>) are used * are used everywhere, but the way that we get the callback function
* everywhere, but the way that we get the callback function
* differs. In most cases we want to use @closure->callback, but in * differs. In most cases we want to use @closure->callback, but in
* other cases we want to use some different technique to retrieve the * other cases we want to use some different technique to retrieve the
* callback function. * callback function.

19
gobject/genums.c
View File

@ -47,9 +47,8 @@
* GLib type system, it can be used as value type for object * GLib type system, it can be used as value type for object
* properties, using g_param_spec_enum() or g_param_spec_flags(). * properties, using g_param_spec_enum() or g_param_spec_flags().
* *
* GObject ships with a utility called <link * GObject ships with a utility called [glib-mkenums][glib-mkenums],
* linkend="glib-mkenums">glib-mkenums</link> that can construct * that can construct suitable type registration functions from C enumeration
* suitable type registration functions from C enumeration
* definitions. * definitions.
*/ */
@ -171,10 +170,9 @@ value_flags_enum_lcopy_value (const GValue *value,
* *
* Registers a new static enumeration type with the name @name. * Registers a new static enumeration type with the name @name.
* *
* It is normally more convenient to let <link * It is normally more convenient to let [glib-mkenums][glib-mkenums],
* linkend="glib-mkenums">glib-mkenums</link> generate a * generate a my_enum_get_type() function from a usual C enumeration
* my_enum_get_type() function from a usual C enumeration definition * definition than to write one yourself using g_enum_register_static().
* than to write one yourself using g_enum_register_static().
* *
* Returns: The new type identifier. * Returns: The new type identifier.
*/ */
@ -215,10 +213,9 @@ g_enum_register_static (const gchar *name,
* *
* Registers a new static flags type with the name @name. * Registers a new static flags type with the name @name.
* *
* It is normally more convenient to let <link * It is normally more convenient to let [glib-mkenums][glib-mkenums]
* linkend="glib-mkenums">glib-mkenums</link> generate a * generate a my_flags_get_type() function from a usual C enumeration
* my_flags_get_type() function from a usual C enumeration definition * definition than to write one yourself using g_flags_register_static().
* than to write one yourself using g_flags_register_static().
* *
* Returns: The new type identifier. * Returns: The new type identifier.
*/ */

20
gobject/gobject.c
View File

@ -43,8 +43,7 @@
* methods for all object types in GTK+, Pango and other libraries * methods for all object types in GTK+, Pango and other libraries
* based on GObject. The GObject class provides methods for object * based on GObject. The GObject class provides methods for object
* construction and destruction, property access methods, and signal * construction and destruction, property access methods, and signal
* support. Signals are described in detail in <xref * support. Signals are described in detail [here][gobject-Signals].
* linkend="gobject-Signals"/>.
* *
* ## Floating references # {#floating-ref} * ## Floating references # {#floating-ref}
* *
@ -479,7 +478,7 @@ g_object_do_class_init (GObjectClass *class)
* text_view) * text_view)
* ]| * ]|
* It is important to note that you must use * It is important to note that you must use
* <link linkend="canonical-parameter-name">canonical</link> parameter names as * [canonical][canonical-parameter-name] parameter names as
* detail strings for the notify signal. * detail strings for the notify signal.
*/ */
gobject_signals[NOTIFY] = gobject_signals[NOTIFY] =
@ -2739,8 +2738,7 @@ object_floating_flag_handler (GObject *object,
* g_object_is_floating: * g_object_is_floating:
* @object: (type GObject.Object): a #GObject * @object: (type GObject.Object): a #GObject
* *
* Checks whether @object has a <link linkend="floating-ref">floating</link> * Checks whether @object has a [floating][floating-ref] reference.
* reference.
* *
* Since: 2.10 * Since: 2.10
* *
@ -2759,8 +2757,7 @@ g_object_is_floating (gpointer _object)
* @object: (type GObject.Object): a #GObject * @object: (type GObject.Object): a #GObject
* *
* Increase the reference count of @object, and possibly remove the * Increase the reference count of @object, and possibly remove the
* <link linkend="floating-ref">floating</link> reference, if @object * [floating][floating-ref] reference, if @object has a floating reference.
* has a floating reference.
* *
* In other words, if the object is floating, then this call "assumes * In other words, if the object is floating, then this call "assumes
* ownership" of the floating reference, converting it to a normal * ownership" of the floating reference, converting it to a normal
@ -2790,11 +2787,10 @@ g_object_ref_sink (gpointer _object)
* g_object_force_floating: * g_object_force_floating:
* @object: a #GObject * @object: a #GObject
* *
* This function is intended for #GObject implementations to re-enforce a * This function is intended for #GObject implementations to re-enforce
* <link linkend="floating-ref">floating</link> object reference. * a [floating][floating-ref] object reference. Doing this is seldom
* Doing this is seldom required: all * required: all #GInitiallyUnowneds are created with a floating reference
* #GInitiallyUnowneds are created with a floating reference which * which usually just needs to be sunken by calling g_object_ref_sink().
* usually just needs to be sunken by calling g_object_ref_sink().
* *
* Since: 2.10 * Since: 2.10
*/ */

6
gobject/gvalue.c
View File

@ -35,9 +35,9 @@
* other type * other type
* @see_also: The fundamental types which all support #GValue * @see_also: The fundamental types which all support #GValue
* operations and thus can be used as a type initializer for * operations and thus can be used as a type initializer for
* g_value_init() are defined by a separate interface. See the <link * g_value_init() are defined by a separate interface. See the
* linkend="gobject-Standard-Parameter-and-Value-Types">Standard * [standard values API][gobject-Standard-Parameter-and-Value-Types]
* Values API</link> for details. * for details
* @title: Generic values * @title: Generic values
* *
* The #GValue structure is basically a variable container that consists * The #GValue structure is basically a variable container that consists