luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-09-19 16:56:15 +02: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
* to return %TRUE from your local_command_line() implementation to
* 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
* 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
* parameters for use with the #GOptionContext command-line parsing API,
* 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
* 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:
* @initable: a #GAsyncInitable.
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the operation.
* @io_priority: the [I/O priority][io-priority] of the operation
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @callback: a #GAsyncReadyCallback to call when the request is satisfied
* @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:
* @object_type: a #GType supporting #GAsyncInitable.
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the operation.
* @io_priority: the [I/O priority][io-priority] of the operation
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @callback: a #GAsyncReadyCallback to call when the initialization is
* finished
@ -348,8 +346,7 @@ g_async_initable_new_async (GType object_type,
* @object_type: a #GType supporting #GAsyncInitable.
* @n_parameters: the number of parameters in @parameters
* @parameters: the parameters to use to construct the object
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the operation.
* @io_priority: the [I/O priority][io-priority] of the operation
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @callback: a #GAsyncReadyCallback to call when the initialization is
* finished
@ -390,8 +387,7 @@ g_async_initable_newv_async (GType object_type,
* @first_property_name: the name of the first property, followed by
* the value, and other property value pairs, and ended by %NULL.
* @var_args: The var args list generated from @first_property_name.
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the operation.
* @io_priority: the [I/O priority][io-priority] of the operation
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @callback: a #GAsyncReadyCallback to call when the initialization is
* finished

3
gio/gbufferedinputstream.c
View File

@ -454,8 +454,7 @@ async_fill_callback_wrapper (GObject *source_object,
* g_buffered_input_stream_fill_async:
* @stream: a #GBufferedInputStream
* @count: the number of bytes that will be read from the stream
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object
* @callback: (scope async): a #GAsyncReadyCallback
* @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:
* @stream: a given #GDataInputStream.
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request.
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): callback to call when the request is satisfied.
* @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:
* @stream: a given #GDataInputStream.
* @stop_chars: characters to terminate the read.
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request.
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): callback to call when the request is satisfied.
* @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_len: length of @stop_chars. May be -1 if @stop_chars is
* nul-terminated
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request.
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore
* @callback: (scope async): callback to call when the request is satisfied
* @user_data: (closure): the data to pass to callback function

2
gio/gdbusactiongroup.c
View File

@ -31,7 +31,7 @@
* @title: GDBusActionGroup
* @short_description: A D-Bus GActionGroup implementation
* @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
* 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
* 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);

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.
*
* This is an asynchronous method. When the operation is finished,
* @callback will be invoked in the <link
* linkend="g-main-context-push-thread-default">thread-default main
* loop</link> of the thread you are calling this method from. You can
* @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 g_dbus_connection_flush_finish() to get the result of the
* operation. See g_dbus_connection_flush_sync() for the synchronous
* version.
@ -1430,14 +1430,14 @@ schedule_closed_unlocked (GDBusConnection *connection,
* %G_IO_ERROR_CLOSED.
*
* When @connection has been closed, the #GDBusConnection::closed
* signal is emitted in the <link
* linkend="g-main-context-push-thread-default">thread-default main
* loop</link> of the thread that @connection was constructed in.
* signal is emitted in the
* [thread-default main context][g-main-context-push-thread-default]
* of the thread that @connection was constructed in.
*
* This is an asynchronous method. When the operation is finished,
* @callback will be invoked in the <link
* linkend="g-main-context-push-thread-default">thread-default main
* loop</link> of the thread you are calling this method from. You can
* @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 g_dbus_connection_close_finish() to get the result of the
* operation. See g_dbus_connection_close_sync() for the synchronous
* version.
@ -1731,9 +1731,9 @@ g_dbus_connection_send_message_unlocked (GDBusConnection *connection,
* %G_IO_ERROR_CLOSED. If @message is not well-formed,
* the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
*
* See <xref linkend="gdbus-server"/> and <xref
* linkend="gdbus-unix-fd-client"/> for an example of how to use this
* low-level API to send and receive UNIX file descriptors.
* See this [server][gdbus-server] and [client][gdbus-unix-fd-client]
* for an example of how to use this low-level API to send and receive
* UNIX file descriptors.
*
* Note that @message must be unlocked, unless @flags contain the
* %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,
* the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
*
* This is an asynchronous method. When the operation is finished, @callback will be invoked
* in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link>
* This is an asynchronous method. When the operation is finished, @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
* 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.
@ -2059,9 +2060,9 @@ g_dbus_connection_send_message_with_reply_unlocked (GDBusConnection *connect
* Note that @message must be unlocked, unless @flags contain the
* %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
*
* See <xref linkend="gdbus-server"/> and <xref
* linkend="gdbus-unix-fd-client"/> for an example of how to use this
* low-level API to send and receive UNIX file descriptors.
* See this [server][gdbus-server] and [client][gdbus-unix-fd-client]
* for an example of how to use this low-level API to send and receive
* UNIX file descriptors.
*
* 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
* g_dbus_message_to_gerror() to transcode this to a #GError.
*
* See <xref linkend="gdbus-server"/> and <xref
* linkend="gdbus-unix-fd-client"/> for an example of how to use this
* low-level API to send and receive UNIX file descriptors.
* See this [server][gdbus-server] and [client][gdbus-unix-fd-client]
* for an example of how to use this low-level API to send and receive
* UNIX file descriptors.
*
* 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
* g_dbus_message_to_gerror() to transcode this to a #GError.
*
* See <xref linkend="gdbus-server"/> and <xref
* linkend="gdbus-unix-fd-client"/> for an example of how to use this
* low-level API to send and receive UNIX file descriptors.
* See this [server][gdbus-server] and [client][gdbus-unix-fd-client]
* for an example of how to use this low-level API to send and receive
* UNIX file descriptors.
*
* Note that @message must be unlocked, unless @flags contain the
* %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
* subscription is removed or %NULL
*
* Subscribes to signals on @connection and invokes @callback with a
* whenever the signal is received. Note that @callback will be invoked
* in the <link
* linkend="g-main-context-push-thread-default">thread-default main
* loop</link> of the thread you are calling this method from.
* Subscribes to signals on @connection and invokes @callback with a whenever
* the signal is received. Note that @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.
*
* If @connection is not a message bus connection, @sender must be
* %NULL.
@ -5091,9 +5091,10 @@ obj_message_func (GDBusConnection *connection,
* Registers callbacks for exported objects at @object_path with the
* D-Bus interface that is described in @interface_info.
*
* Calls to functions in @vtable (and @user_data_free_func) will
* happen in the <link linkend="g-main-context-push-thread-default">thread-default main
* loop</link> of the thread you are calling this method from.
* Calls to functions in @vtable (and @user_data_free_func) will happen
* in the
* [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
* 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
* 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)
* that can be used with g_dbus_connection_unregister_object()
@ -5811,8 +5812,9 @@ g_dbus_connection_call_sync_internal (GDBusConnection *connection,
* NULL);
* ]|
*
* This is an asynchronous method. When the operation is finished, @callback will be invoked
* in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link>
* This is an asynchronous method. When the operation is finished,
* @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
* g_dbus_connection_call_finish() to get the result of the operation.
* 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
* the request.
*
* All calls into user-provided code will be invoked in the <link
* linkend="g-main-context-push-thread-default">thread-default main
* loop</link> of the thread you are calling this method from.
* All calls into user-provided code will be invoked in the
* [thread-default main context][g-main-context-push-thread-default]
* of the thread you are calling this method from.
*
* If an existing subtree is already registered at @object_path or
* 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
* 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)
* 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_.
*
* 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
*/

2
gio/gdbusintrospection.c
View File

@ -1760,7 +1760,7 @@ parser_error (GMarkupParseContext *context,
* &lt;node&gt; element.
*
* 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.
*
* Returns: A #GDBusNodeInfo structure or %NULL if @error is set. Free

2
gio/gdbusmenumodel.c
View File

@ -30,7 +30,7 @@
* @title: GDBusMenuModel
* @short_description: A D-Bus GMenuModel implementation
* @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
* 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
* #GVariant API.
*
* See <xref linkend="gdbus-server"/> and <xref
* linkend="gdbus-unix-fd-client"/> for an example of how to use this
* low-level API to send and receive UNIX file descriptors.
* See this [server][gdbus-server] and [client][gdbus-unix-fd-client]
* for an example of how to use this low-level API to send and receive
* UNIX file descriptors.
*
* 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
* @name_acquired_handler and @name_lost_handler when the name is
* acquired respectively lost. Callbacks will be invoked in the <link
* linkend="g-main-context-push-thread-default">thread-default main
* loop</link> of the thread you are calling this function from.
* acquired respectively lost. Callbacks will be invoked in the
* [thread-default main context][g-main-context-push-thread-default]
* of the thread you are calling this function from.
*
* 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
@ -607,7 +607,7 @@ g_bus_own_name_on_connection (GDBusConnection *connection,
* before @name is requested from the bus.
*
* 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
* 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
* @name_appeared_handler and @name_vanished_handler when the name is
* known to have a owner respectively known to lose its
* owner. Callbacks will be invoked in the <link
* linkend="g-main-context-push-thread-default">thread-default main
* loop</link> of the thread you are calling this function from.
* owner. Callbacks will be invoked in the
* [thread-default main context][g-main-context-push-thread-default]
* of the thread you are calling this function from.
*
* You are guaranteed that one of the handlers will be invoked after
* 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
* will be @name_vanished_handler. The reverse is also true.
*
* This behavior makes it very simple to write applications that wants
* to take action when a certain name exists, see <xref
* linkend="gdbus-watching-names"/>. Basically, the application
* should create object proxies in @name_appeared_handler and destroy
* them again (if any) in @name_vanished_handler.
* This behavior makes it very simple to write applications that want
* to take action when a certain [name exists][gdbus-watching-names].
* Basically, the application should create object proxies in
* @name_appeared_handler and destroy them again (if any) in
* @name_vanished_handler.
*
* Returns: An identifier (never 0) that an be used with
* g_bus_unwatch_name() to stop watching the name.

10
gio/gdbusobjectmanagerclient.c
View File

@ -112,7 +112,7 @@
* #GDBusObjectManagerClient::interface-proxy-signal.
*
* 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
* in. Additionally, the #GDBusObjectProxy and #GDBusProxy objects
* 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.
*
* 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.
*
* 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.
*
* 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.
*
* 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
* 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
* 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.
@ -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
* 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
* 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.

23
gio/gdbusproxy.c
View File

@ -72,17 +72,16 @@
* %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START is set).
*
* The generic #GDBusProxy::g-properties-changed and
* #GDBusProxy::g-signal signals are not very convenient to work
* with. Therefore, the recommended way of working with proxies is to
* subclass #GDBusProxy, and have more natural properties and signals
* in your derived class. See <xref linkend="gdbus-example-gdbus-codegen"/>
* for how this can easily be done using the
* <link linkend="gdbus-codegen">gdbus-codegen</link> tool.
* #GDBusProxy::g-signal signals are not very convenient to work with.
* Therefore, the recommended way of working with proxies is to subclass
* #GDBusProxy, and have more natural properties and signals in your derived
* class. This [example][gdbus-example-gdbus-codegen] shows how this can
* easily be done using the [gdbus-codegen][gdbus-codegen] tool.
*
* A #GDBusProxy instance can be used from multiple threads but note
* that all signals (e.g. #GDBusProxy::g-signal, #GDBusProxy::g-properties-changed
* 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.
*
* <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 <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
*/
@ -2136,7 +2135,7 @@ g_dbus_proxy_new_finish (GAsyncResult *res,
* This is a synchronous failable constructor. See g_dbus_proxy_new()
* 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().
*
@ -2192,7 +2191,7 @@ g_dbus_proxy_new_sync (GDBusConnection *connection,
*
* 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
*/
@ -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.
*
* 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().
*
@ -2984,7 +2983,7 @@ g_dbus_proxy_call_sync_internal (GDBusProxy *proxy,
*
* This is an asynchronous method. When the operation is finished,
* @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 then call g_dbus_proxy_call_finish() to get the result of
* 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
* then the signal is emitted in a new thread dedicated to the
* connection. Otherwise the signal is emitted in the <link
* linkend="g-main-context-push-thread-default">thread-default main
* loop</link> of the thread that @server was constructed in.
* connection. Otherwise the signal is emitted in the
* [thread-default main context][g-main-context-push-thread-default]
* of the thread that @server was constructed in.
*
* You are guaranteed that signal handlers for this signal runs
* 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
* g_dbus_server_start().
*
* See <xref linkend="gdbus-peer-to-peer"/> for how #GDBusServer can
* be used.
* #GDBusServer is used in this [example][gdbus-peer-to-peer].
*
* This is a synchronous failable constructor. See
* 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>
* <row>
* <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>
* <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>
* <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>
* <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>
* <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>
* <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>
* <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>
* <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>
* <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>
* <entry>#G_TYPE_VARIANT</entry>
@ -557,9 +582,9 @@ g_dbus_gvariant_to_gvalue (GVariant *value,
* </tgroup>
* </table>
* 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
* also fail for any #GType (including e.g. #G_TYPE_OBJECT and
* #G_TYPE_BOXED derived-types) not in the table above.
* is ['i'][G-VARIANT-TYPE-INT32:CAPS]. It will also fail for any #GType
* (including e.g. #G_TYPE_OBJECT and #G_TYPE_BOXED derived-types) not
* in the table above.
*
* Note that if @gvalue is of type #G_TYPE_VARIANT and its value 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
* @attributes: an attribute query string
* @flags: a set of #GFileQueryInfoFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call when the
@ -1209,8 +1208,7 @@ g_file_query_info (GFile *file,
* @file: input #GFile
* @attributes: an attribute query string
* @flags: a set of #GFileQueryInfoFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @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:
* @file: input #GFile
* @attributes: an attribute query string
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call
@ -1470,8 +1467,7 @@ g_file_find_enclosing_mount (GFile *file,
/**
* g_file_find_enclosing_mount_async:
* @file: a #GFile
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call
@ -1699,7 +1695,7 @@ g_file_create (GFile *file,
/**
* g_file_replace:
* @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
* @make_backup: %TRUE if a backup should be created
* @flags: a set of #GFileCreateFlags
@ -1904,7 +1900,7 @@ g_file_create_readwrite (GFile *file,
/**
* g_file_replace_readwrite:
* @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
* @make_backup: %TRUE if a backup should be created
* @flags: a set of #GFileCreateFlags
@ -1959,8 +1955,7 @@ g_file_replace_readwrite (GFile *file,
/**
* g_file_read_async:
* @file: input #GFile
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call
@ -2028,8 +2023,7 @@ g_file_read_finish (GFile *file,
* g_file_append_to_async:
* @file: input #GFile
* @flags: a set of #GFileCreateFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call
@ -2100,8 +2094,7 @@ g_file_append_to_finish (GFile *file,
* g_file_create_async:
* @file: input #GFile
* @flags: a set of #GFileCreateFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call
@ -2171,12 +2164,11 @@ g_file_create_finish (GFile *file,
/**
* g_file_replace_async:
* @file: input #GFile
* @etag: (allow-none): an <link linkend="gfile-etag">entity tag</link>
* for the current #GFile, or NULL to ignore
* @etag: (allow-none): an [entity tag][gfile-etag] for the current #GFile,
* or %NULL to ignore
* @make_backup: %TRUE if a backup should be created
* @flags: a set of #GFileCreateFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call
@ -2250,8 +2242,7 @@ g_file_replace_finish (GFile *file,
/**
* g_file_open_readwrite_async
* @file: input #GFile
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call
@ -2323,8 +2314,7 @@ g_file_open_readwrite_finish (GFile *file,
* g_file_create_readwrite_async:
* @file: input #GFile
* @flags: a set of #GFileCreateFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call
@ -2398,12 +2388,11 @@ g_file_create_readwrite_finish (GFile *file,
/**
* g_file_replace_readwrite_async:
* @file: input #GFile
* @etag: (allow-none): an <link linkend="gfile-etag">entity tag</link>
* for the current #GFile, or NULL to ignore
* @etag: (allow-none): an [entity tag][gfile-etag] for the current #GFile,
* or %NULL to ignore
* @make_backup: %TRUE if a backup should be created
* @flags: a set of #GFileCreateFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call
@ -3404,8 +3393,7 @@ g_file_copy (GFile *source,
* @source: input #GFile
* @destination: destination #GFile
* @flags: set of #GFileCopyFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @progress_callback: (allow-none): function to callback with progress
@ -3665,8 +3653,7 @@ g_file_make_directory (GFile *file,
/**
* g_file_make_directory_async:
* @file: input #GFile
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @callback: a #GAsyncReadyCallback to call
@ -3915,8 +3902,7 @@ g_file_delete (GFile *file,
/**
* g_file_delete_async:
* @file: input #GFile
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @callback: a #GAsyncReadyCallback to call
@ -4025,8 +4011,7 @@ g_file_trash (GFile *file,
/**
* g_file_trash_async:
* @file: input #GFile
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @callback: a #GAsyncReadyCallback to call
@ -4144,8 +4129,7 @@ g_file_set_display_name (GFile *file,
* g_file_set_display_name_async:
* @file: input #GFile
* @display_name: a string
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback to call
@ -4474,8 +4458,7 @@ g_file_real_set_attributes_from_info (GFile *file,
* @file: input #GFile
* @info: a #GFileInfo
* @flags: a #GFileQueryInfoFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object,
* %NULL to ignore
* @callback: (scope async): a #GAsyncReadyCallback
@ -7093,11 +7076,11 @@ g_file_load_contents_finish (GFile *file,
* @file: input #GFile
* @contents: (element-type guint8) (array length=length): a string containing the new contents for @file
* @length: the length of @contents in bytes
* @etag: (allow-none): the old <link linkend="gfile-etag">entity tag</link>
* for the document, or %NULL
* @etag: (allow-none): the old [entity-tag][gfile-etag] for the document,
* or %NULL
* @make_backup: %TRUE if a backup should be created
* @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
* needed, or %NULL
* @cancellable: optional #GCancellable object, %NULL to ignore
@ -7298,7 +7281,7 @@ replace_contents_open_callback (GObject *obj,
* @file: input #GFile
* @contents: (element-type guint8) (array length=length): string of contents to replace the file with
* @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
* @flags: a set of #GFileCreateFlags
* @cancellable: optional #GCancellable object, %NULL to ignore
@ -7348,7 +7331,7 @@ g_file_replace_contents_async (GFile *file,
* g_file_replace_contents_bytes_async:
* @file: input #GFile
* @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
* @flags: a set of #GFileCreateFlags
* @cancellable: optional #GCancellable object, %NULL to ignore
@ -7402,7 +7385,7 @@ g_file_replace_contents_bytes_async (GFile *file,
* g_file_replace_contents_finish:
* @file: input #GFile
* @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
* longer needed, or %NULL
* @error: a #GError, or %NULL
@ -7656,8 +7639,7 @@ g_file_measure_disk_usage (GFile *file,
* g_file_measure_disk_usage_async:
* @file: a #GFile
* @flags: #GFileMeasureFlags
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable
* @progress_callback: (allow-none): a #GFileMeasureProgressCallback
* @progress_data: user_data for @progress_callback
@ -7986,11 +7968,10 @@ g_file_poll_mountable_finish (GFile *file,
* g_file_supports_thread_contexts:
* @file: a #GFile
*
* Checks if @file supports <link
* linkend="g-main-context-push-thread-default-context">thread-default
* contexts</link>. If this returns %FALSE, you cannot perform
* asynchronous operations on @file in a thread that has a
* thread-default context.
* Checks if @file supports
* [thread-default contexts][g-main-context-push-thread-default-context].
* If this returns %FALSE, you cannot perform asynchronous operations on
* @file in a thread that has a thread-default context.
*
* 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
* information that any application may need should be put in this namespace.
* Examples include the file's name, type, and size.</entry></row>
* <row><entry>"etag"</entry><entry>The <link linkend="gfile-etag">"Entity Tag"</link>
* namespace. Currently, the only key in this namespace is "value", which contains
* the value of the current entity tag.</entry></row>
* <row><entry>"etag"</entry><entry>The [Entity Tag][gfile-etag]
* namespace. Currently, the only key in this namespace is "value", which
* contains the value of the current entity tag.</entry></row>
* <row><entry>"id"</entry><entry>The "Identification" namespace. This
* namespace is used by file managers and applications that list directories
* 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:
* @enumerator: a #GFileEnumerator.
* @num_files: the number of file info objects to request
* @io_priority: the <link linkend="io-priority">io priority</link>
* of the request.
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): a #GAsyncReadyCallback to call when the request is satisfied
* @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:
* @enumerator: a #GFileEnumerator.
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request.
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): a #GAsyncReadyCallback to call when the request is satisfied
* @user_data: (closure): the data to pass to callback function

12
gio/gfileinfo.c
View File

@ -22,14 +22,14 @@
* SECTION:gfileinfo
* @short_description: File Information and Attributes
* @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
* implements methods for getting information that all files should
* contain, and allows for manipulation of extended attributes.
*
* See <link linkend="gio-GFileAttribute">GFileAttribute</link> for more
* information on how GIO handles file attributes.
* See [GFileAttribute][gio-GFileAttribute for more information on how
* GIO handles file attributes.
*
* 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
@ -364,7 +364,7 @@ g_file_info_new (void)
* @src_info: source to copy attributes from.
* @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.
**/
void
@ -1795,7 +1795,7 @@ g_file_info_get_symlink_target (GFileInfo *info)
* g_file_info_get_etag:
* @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.
*
* 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:
* @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.
* 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:
* @stream: a #GFileInputStream.
* @attributes: a file attribute query string.
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request.
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): callback to call when the request is satisfied
* @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:
* @stream: a #GFileIOStream.
* @attributes: a file attribute query string.
* @io_priority: the <link linkend="gio-GIOScheduler">I/O priority</link>
* of the request.
* @io_priority: the [I/O priority][gio-GIOScheduler] of the request
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): callback to call when the request is satisfied
* @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
* monitoring, connect to the #GFileMonitor::changed signal. The
* signal will be emitted in the <link
* linkend="g-main-context-push-thread-default">thread-default main
* context</link> of the thread that the monitor was created in
* signal will be emitted in the
* [thread-default main context][g-main-context-push-thread-default]
* of the thread that the monitor was created in
* (though if the global default main context is blocked, this may
* cause notifications to be blocked even if the thread-default
* context is still running).
@ -670,9 +670,8 @@ update_rate_limiter_timeout (GFileMonitor *monitor,
* has taken place. Should be called from file monitor
* implementations only.
*
* The signal will be emitted from an idle handler (in the <link
* linkend="g-main-context-push-thread-default">thread-default main
* context</link>).
* The signal will be emitted from an idle handler (in the
* [thread-default main context][g-main-context-push-thread-default]).
**/
void
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:
* @stream: a #GFileOutputStream.
* @attributes: a file attribute query string.
* @io_priority: the <link linkend="gio-GIOScheduler">I/O priority</link>
* of the request.
* @io_priority: the [I/O priority][gio-GIOScheduler] of the request
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @callback: callback to call when the request is satisfied
* @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
* error, then all operations on the object except g_object_ref() and
* g_object_unref() are considered to be invalid, and have undefined
* behaviour. See the <xref linkend="ginitable"/> section introduction
* for more details.
* behaviour. See the [introduction][ginitable] for more details.
*
* Implementations of this method must be idempotent, i.e. multiple calls
* 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
* read data into (which should be at least count bytes long).
* @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.
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @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:
* @stream: A #GInputStream.
* @count: the number of bytes that will be read from the stream
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request.
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): callback to call when the request is satisfied
* @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:
* @stream: A #GInputStream.
* @count: the number of bytes that will be skipped from the stream
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request.
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
* @callback: (scope async): callback to call when the request is satisfied
* @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:
* @stream: A #GInputStream.
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request.
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): optional cancellable object
* @callback: (scope async): callback to call when the request is satisfied
* @user_data: (closure): the data to pass to callback function

4
gio/giomodule.c
View File

@ -60,7 +60,7 @@
* SECTION:extensionpoints
* @short_description: Extension Points
* @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
* 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
* 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
* GIO module.
*

2
gio/gioscheduler.c
View File

@ -95,7 +95,7 @@ io_job_thread (GTask *task,
* @job_func: a #GIOSchedulerJobFunc.
* @user_data: data to pass to @job_func
* @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.
* @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
* in which it is used).
*
* As an example, consider the visible portions of the menu in
* <xref linkend="menu-example"/>.
* As an example, consider the visible portions of this menu:
*
* ## An example menu # {#menu-example}
*
@ -62,7 +61,7 @@
* - the Sources 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
* smaller blocks within the large block represent items in that menu. Some
* items contain references to other menus.
@ -71,8 +70,8 @@
*
* ![](menu-model.png)
*
* Notice that the separators visible in <xref linkend="menu-example"/>
* appear nowhere in <xref linkend="menu-model"/>. This is because
* Notice that the separators visible in the [example][menu-example]
* appear nowhere in the [menu model][menu-model]. This is because
* separators are not explicitly represented in the menu model. Instead,
* 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,
@ -83,12 +82,10 @@
* outside the application. Examples include global menus, jumplists,
* dash boards, etc. To support such uses, it is necessary to 'export'
* information about actions and their representation in menus, which
* is exactly what the
* <link linkend="gio-GActionGroup-exporter">GActionGroup exporter</link>
* and the
* <link linkend="gio-GMenuModel-exporter">GMenuModel exporter</link>
* do for #GActionGroup and #GMenuModel. The client-side counterparts
* to make use of the exported information are #GDBusActionGroup and
* is exactly what the [GActionGroup exporter][gio-GActionGroup-exporter]
* and the [GMenuModel exporter][gio-GMenuModel-exporter] do for
* #GActionGroup and #GMenuModel. The client-side counterparts to
* make use of the exported information are #GDBusActionGroup and
* #GDBusMenuModel.
*
* 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
* 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
* 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
@ -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
* 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
* 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
* 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
* --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.
*
* 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.
*
* Since: 2.32
@ -980,7 +980,7 @@ g_static_resource_init (GStaticResource *static_resource)
* Finalized a GResource initialized by g_static_resource_init().
*
* 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.
*
* 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().
*
* 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.
*
* Return value: (transfer none): a #GResource

27
gio/gsettings.c
View File

@ -91,14 +91,14 @@
* the &lt;key&gt; element.
*
* 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.
*
* A DTD for the gschema XML format can be found here:
* [gschema.dtd](https://git.gnome.org/browse/glib/tree/gio/gschema.dtd)
*
* The <link linkend="glib-compile-schemas">glib-compile-schemas</link>
* tool expects schema files to have the extension `.gschema.xml`.
* The [glib-compile-schemas][glib-compile-schemas] tool expects schema
* files to have the extension `.gschema.xml`.
*
* At runtime, schemas are identified by their id (as specified in the
* 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
* enumerated types. These can be described by a &lt;choice&gt;,
* &lt;enum&gt; or &lt;flags&gt; element, see
* <xref linkend="schema-enumerated"/>. The underlying type of
* such a key is string, but you can use g_settings_get_enum(),
* g_settings_set_enum(), g_settings_get_flags(), g_settings_set_flags()
* access the numeric values corresponding to the string value of enum
* and flags keys.
* &lt;enum&gt; or &lt;flags&gt; element, as seen in the
* [example][schema-enumerated]. The underlying type of such a key
* is string, but you can use g_settings_get_enum(), g_settings_set_enum(),
* g_settings_get_flags(), g_settings_set_flags() access the numeric values
* corresponding to the string value of enum and flags keys.
*
* An example for default value:
* |[
@ -191,11 +190,11 @@
* an application. Sometimes, it is necessary for a vendor or distributor
* to adjust these defaults. Since patching the XML source for the schema
* is inconvenient and error-prone,
* <link linkend="glib-compile-schemas">glib-compile-schemas</link> reads
* so-called 'vendor override' files. These are keyfiles in the same
* directory as the XML schema sources which can override default values.
* The schema id serves as the group name in the key file, and the values
* are expected in serialized GVariant form, as in the following example:
* [glib-compile-schemas][glib-compile-schemas] reads so-called vendor
* override' files. These are keyfiles in the same directory as the XML
* schema sources which can override default values. The schema id serves
* as the group name in the key file, and the values are expected in
* serialized GVariant form, as in the following example:
* |[
* [org.gtk.Example]
* 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.
*
* The directory should contain a file called `gschemas.compiled` as
* produced by the
* <link linkend="glib-compile-schemas">glib-compile-schemas</link> tool.
* produced by the [glib-compile-schemas][glib-compile-schemas] tool.
*
* If @trusted is %TRUE then `gschemas.compiled` is trusted not to be
* 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.
* 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()
* will finish it from an idle handler in the <link
* linkend="g-main-context-push-thread-default">thread-default main
* context</link>. g_simple_async_result_run_in_thread() will run the
* will finish it from an idle handler in the
* [thread-default main context][g-main-context-push-thread-default]
* . g_simple_async_result_run_in_thread() will run the
* job in a separate thread and then deliver the result to the
* thread-default main context.
*
@ -784,9 +784,9 @@ complete_in_idle_cb (gpointer data)
* g_simple_async_result_complete_in_idle:
* @simple: a #GSimpleAsyncResult.
*
* Completes an asynchronous function in an idle handler in the <link
* linkend="g-main-context-push-thread-default">thread-default main
* loop</link> of the thread that @simple was initially created in
* Completes an asynchronous function in an idle handler in the
* [thread-default main context][g-main-context-push-thread-default]
* of the thread that @simple was initially created in
* (and re-pushes that context around the invocation of the callback).
*
* Calling this function takes a reference to @simple for as long as

6
gio/gsocket.c
View File

@ -68,7 +68,7 @@
* SECTION:gsocket
* @short_description: Low-level socket object
* @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
* 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,
* 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
* standard/portable socket options. For unusual socket protocols or
* 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,
* 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
* standard/portable socket options. For unusual socket protocols or
* 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
* blocking code then see #GThreadedSocketService.
*
* The socket service runs on the main loop of the <link
* linkend="g-main-context-push-thread-default-context">thread-default
* context</link> of the thread it is created in, and is not
* The socket service runs on the main loop of the
* [thread-default context][g-main-context-push-thread-default-context]
* of the thread it is created in, and is not
* threadsafe in general. However, the calls to start and stop the
* service are thread-safe so these can be used from threads that
* handle incoming clients.

36
gio/gtask.c
View File

@ -148,14 +148,13 @@
*
* #GTask also tries to simplify asynchronous operations that
* internally chain together several smaller asynchronous
* operations. g_task_get_cancellable(), g_task_get_context(), and
* g_task_get_priority() allow you to get back the task's
* #GCancellable, #GMainContext, and <link
* linkend="io-priority">I/O priority</link> when starting a new
* subtask, so you don't have to keep track of them yourself.
* g_task_attach_source() simplifies the case of waiting for a
* source to fire (automatically using the correct #GMainContext
* and priority).
* operations. g_task_get_cancellable(), g_task_get_context(),
* and g_task_get_priority() allow you to get back the task's
* #GCancellable, #GMainContext, and [I/O priority][io-priority]
* when starting a new subtask, so you don't have to keep track
* of them yourself. g_task_attach_source() simplifies the case
* of waiting for a source to fire (automatically using the correct
* #GMainContext and priority).
*
* Here is an example for chained asynchronous operations:
* |[<!-- language="C" -->
@ -477,7 +476,7 @@
* abuse of g_simple_async_result_set_op_res_gpointer() for the same
* purpose with #GSimpleAsyncResult.
* - 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
* a chain of simpler asynchronous operations will have easy access
* 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.
*
* Creates a #GTask acting on @source_object, which will eventually be
* used to invoke @callback in the current <link
* linkend="g-main-context-push-thread-default">thread-default main
* context</link>.
* used to invoke @callback in the current
* [thread-default main context][g-main-context-push-thread-default].
*
* Call this in the "start" method of your asynchronous method, and
* pass the #GTask around throughout the asynchronous operation. You
@ -783,8 +781,7 @@ g_task_set_task_data (GTask *task,
/**
* g_task_set_priority:
* @task: the #GTask
* @priority: the <link linkend="io-priority">priority</link>
* of the request.
* @priority: the [priority][io-priority] of the request
*
* Sets @task's priority. If you do not call this, it will default to
* %G_PRIORITY_DEFAULT.
@ -994,9 +991,9 @@ g_task_get_priority (GTask *task)
* @task: a #GTask
*
* Gets the #GMainContext that @task will return its result in (that
* is, the context that was the <link
* linkend="g-main-context-push-thread-default">thread-default main
* context</link> at the point when @task was created).
* is, the context that was the
* [thread-default main context][g-main-context-push-thread-default]
* at the point when @task was created).
*
* This will always return a non-%NULL value, even if the task's
* 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
* to wait for a #GSource to trigger. Attaches @source to @task's
* #GMainContext with @task's <link
* linkend="io-priority">priority</link>, and sets @source's callback
* to @callback, with @task as the callback's `user_data`.
* #GMainContext with @task's [priority][io-priority], and sets @source's
* callback to @callback, with @task as the callback's `user_data`.
*
* 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:
* @conn: a #GTlsConnection
* @io_priority: the <link linkend="io-priority">I/O priority</link>
* of the request.
* @io_priority: the [I/O priority][io-priority] of the request
* @cancellable: (allow-none): a #GCancellable, or %NULL
* @callback: callback to call when the handshake is complete
* @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
*
* Gets the identifier of the given kind for @volume.
* See the <link linkend="volume-identifier">introduction</link>
* for more information about volume identifiers.
* See the [introduction][volume-identifier] for more
* information about volume identifiers.
*
* Returns: a newly allocated string containing the
* requested identfier, or %NULL if the #GVolume
@ -590,9 +590,8 @@ g_volume_get_identifier (GVolume *volume,
* g_volume_enumerate_identifiers:
* @volume: a #GVolume
*
* Gets the kinds of <link linkend="volume-identifier">identifiers</link>
* that @volume has. Use g_volume_get_identifier() to obtain
* the identifiers themselves.
* Gets the kinds of [identifiers][volume-identifier] that @volume has.
* Use g_volume_get_identifier() to obtain the identifiers themselves.
*
* Returns: (array zero-terminated=1) (transfer full): a %NULL-terminated array
* 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
* would show in a sidebar.
*
* #GVolumeMonitor is not <link
* linkend="g-main-context-push-thread-default">thread-default-context
* aware</link>, and so should not be used other than from the main
* thread, with no thread-default-context active.
* #GVolumeMonitor is not
* [thread-default-context aware][g-main-context-push-thread-default],
* and so should not be used other than from the main thread, with no
* thread-default-context active.
**/
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:
* @charset: return location for character set name
*
* Obtains the character set for the <link linkend="setlocale">current
* locale</link>; you might use this character set as an argument to
* g_convert(), to convert from the current locale's encoding to some
* other encoding. (Frequently g_locale_to_utf8() and g_locale_from_utf8()
* are nice shortcuts, though.)
* Obtains the character set for the [current locale][setlocale]; you
* might use this character set as an argument to g_convert(), to convert
* from the current locale's encoding to some other encoding. (Frequently
* g_locale_to_utf8() and g_locale_from_utf8() are nice shortcuts, though.)
*
* On Windows the character set returned by this function is the
* 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
* the file names they create. However, older file systems may
* still contain file names created in "older" encodings, such as
* ISO-8859-1. In this case, for compatibility reasons, you may
* want to instruct Glib to use that particular encoding for file
* names rather than UTF-8. You can do this by specifying the
* encoding for file names in the <link
* linkend="G_FILENAME_ENCODING">`G_FILENAME_ENCODING`</link>
* ISO-8859-1. In this case, for compatibility reasons, you may want
* to instruct Glib to use that particular encoding for file names
* rather than UTF-8. You can do this by specifying the encoding for
* file names in the [`G_FILENAME_ENCODING`][G_FILENAME_ENCODING]
* environment variable. For example, if your installation uses
* ISO-8859-1 for file names, you can put this in your `~/.profile`
* <programlisting>
* |[
* export G_FILENAME_ENCODING=ISO-8859-1
* </programlisting>
* ]|
* Glib provides the functions g_filename_to_utf8() and
* g_filename_from_utf8() to perform the necessary conversions.
* These functions convert file names from the encoding specified
* in `G_FILENAME_ENCODING` to UTF-8 and vice-versa.
* <xref linkend="file-name-encodings-diagram"/> illustrates how
* in `G_FILENAME_ENCODING` to UTF-8 and vice-versa. This
* [diagram][file-name-encodings-diagram] illustrates how
* these functions are used to convert between UTF-8 and the
* 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
* the C runtime (usually the same as that used by the operating
* system) in the <link linkend="setlocale">current locale</link> into a
* UTF-8 string.
* system) in the [current locale][setlocale] into a UTF-8 string.
*
* Return value: A newly-allocated buffer containing the converted string,
* 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
* the C runtime (usually the same as that used by the operating
* system) in the <link linkend="setlocale">current locale</link>. On
* Windows this means the system codepage.
* system) in the [current locale][setlocale]. On Windows this means
* the system codepage.
*
* Return value: A newly-allocated buffer containing the converted string,
* 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
* character set names. The special token "&commat;locale" is taken
* to mean the character set for the <link linkend="setlocale">current
* locale</link>. If `G_FILENAME_ENCODING` is not set, but
* `G_BROKEN_FILENAMES` is, the character set of the current locale
* is taken as the filename encoding. If neither environment variable
* is set, UTF-8 is taken as the filename encoding, but the character
* set of the current locale is also put in the list of encodings.
* to mean the character set for the [current locale][setlocale].
* If `G_FILENAME_ENCODING` is not set, but `G_BROKEN_FILENAMES` is,
* the character set of the current locale is taken as the filename
* encoding. If neither environment variable is set, UTF-8 is taken
* as the filename encoding, but the character set of the current locale
* is also put in the list of encodings.
*
* 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
* filenames into a UTF-8 string. Note that on Windows GLib uses UTF-8
* 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.
**/
@ -1206,7 +1204,7 @@ g_filename_to_utf8 (const gchar *opsysstring,
* Converts a string from UTF-8 to the encoding GLib uses for
* filenames. Note that on Windows GLib uses UTF-8 for filenames;
* 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):
* The converted string, or %NULL on an error.

6
glib/gdataset.c
View File

@ -121,9 +121,9 @@
/**
* GData:
*
* The #GData struct is an opaque data structure to represent a <link
* linkend="glib-Keyed-Data-Lists">Keyed Data List</link>. It should
* only be accessed via the following functions.
* The #GData struct is an opaque data structure to represent a
* [Keyed Data List][glib-Keyed-Data-Lists]. It should only be
* 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
*
* Parses a user-inputted string @str, and try to figure out what date it
* represents, taking the <link linkend="setlocale">current locale</link>
* into account. If the string is successfully parsed, the date will be
* valid after the call. Otherwise, it will be invalid. You should check
* using g_date_valid() to see whether the parsing succeeded.
* represents, taking the [current locale][setlocale] into account. If the
* string is successfully parsed, the date will be valid after the call.
* Otherwise, it will be invalid. You should check using g_date_valid()
* to see whether the parsing succeeded.
*
* This function is not appropriate for file formats and the like; it
* 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
*
* 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,
* but only accepts date-related formats; time-related formats
* give undefined results. Date must be valid. Unlike strftime()

4
glib/ghash.c
View File

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

11
glib/giochannel.c
View File

@ -50,9 +50,9 @@
*
* The #GIOChannel data type aims to provide a portable method for
* using file descriptors, pipes, and sockets, and integrating them
* into the <link linkend="glib-The-Main-Event-Loop">main event
* loop</link>. Currently full support is available on UNIX platforms,
* support for Windows is only partially complete.
* into the [main event loop][glib-The-Main-Event-Loop]. Currently,
* full support is available on UNIX platforms, support for Windows
* is only partially complete.
*
* To create a new #GIOChannel on UNIX systems use
* 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_shutdown().
*
* To add a #GIOChannel to the <link
* linkend="glib-The-Main-Event-Loop">main event loop</link> use
* g_io_add_watch() or g_io_add_watch_full(). Here you specify which
* To add a #GIOChannel to the [main event loop][glib-The-Main-Event-Loop],
* use 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
* 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
* 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
* directions (unlike the singly-linked <link
* linkend="glib-Singly-Linked-Lists">#GSList</link> which
* only allows movement through the list in the forward direction).
* directions (unlike the singly-linked [GSList][glib-Singly-Linked-Lists],
* which only allows movement through the list in the forward direction).
*
* 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
* 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
* <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
* using one of the <link linkend="glib-Type-Conversion-Macros">Type
* Conversion Macros</link>, or simply pointers to any type of data.
* using one of the [Type Conversion Macros][glib-Type-Conversion-Macros],
* 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.
* List elements are allocated from the [slice allocator][glib-Memory-Slices],
* which is more efficient than allocating elements individually.
*
* Note that most of the #GList functions expect to be passed a pointer
* to the first element in the list. The functions which insert
@ -118,9 +116,8 @@
/**
* GList:
* @data: holds the element's data, which can be a pointer to any kind
* of data, or any integer value using the <link
* linkend="glib-Type-Conversion-Macros">Type Conversion
* Macros</link>.
* of data, or any integer value using the
* [Type Conversion Macros][glib-Type-Conversion-Macros]
* @next: contains the link to the next 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
* 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
* results to its main loop, rather than running under the global
* 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:
* @log_domain: (allow-none): the log domain of the message
* @log_level: the log level of the message
* @pattern: a glob-style
* <link linkend="glib-Glob-style-pattern-matching">pattern</link>
* @pattern: a glob-style [pattern][glib-Glob-style-pattern-matching]
*
* Indicates that a message with the given @log_domain and @log_level,
* 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
* child.
*
* The #GNode struct represents one node in a
* <link linkend="glib-N-ary-Trees">N-ary Tree</link>. fields
* The #GNode struct represents one node in a [n-ary tree][glib-N-ary-Trees].
**/
#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>
* </mediaobject>
* </informalfigure>
* @G_LEVEL_ORDER: is not implemented for <link
* linkend="glib-Balanced-Binary-Trees">Balanced Binary
* Trees</link>. For <link
* linkend="glib-N-ary-Trees">N-ary Trees</link>, it
* @G_LEVEL_ORDER: is not implemented for
* [balanced binary trees][glib-Balanced-Binary-Trees].
* For [n-ary trees][glib-N-ary-Trees], it
* vists the root node first, then its children, then
* its grandchildren, and so on. Note that this is less
* 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
* call `exit (0)`.
*
* Note that function depends on the
* <link linkend="setlocale">current locale</link> for
* Note that function depends on the [current locale][setlocale] for
* automatic character set conversion of string and filename
* arguments.
*

18
glib/gprintf.c
View File

@ -28,7 +28,7 @@
/**
* g_printf:
* @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.
*
* An implementation of the standard printf() function which supports
@ -60,7 +60,7 @@ g_printf (gchar const *format,
* g_fprintf:
* @file: the stream to write to.
* @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.
*
* 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
* enough to hold the formatted result
* @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.
*
* 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
* terminating nul character).
* @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.
*
* A safer form of the standard sprintf() function. The output is guaranteed
@ -170,7 +170,7 @@ g_snprintf (gchar *string,
/**
* g_vprintf:
* @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.
*
* An implementation of the standard vprintf() function which supports
@ -193,7 +193,7 @@ g_vprintf (gchar const *format,
* g_vfprintf:
* @file: the stream to write to.
* @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.
*
* An implementation of the standard fprintf() function which supports
@ -217,7 +217,7 @@ g_vfprintf (FILE *file,
* g_vsprintf:
* @string: the buffer to hold the output.
* @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.
*
* 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
* terminating nul character).
* @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.
*
* A safer form of the standard vsprintf() function. The output is guaranteed
@ -284,7 +284,7 @@ g_vsnprintf (gchar *string,
* g_vasprintf:
* @string: the return location for the newly-allocated string.
* @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.
*
* 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
* retrieve the other.
*
* Quarks are used for both <link
* linkend="glib-Datasets">Datasets</link> and <link
* linkend="glib-Keyed-Data-Lists">Keyed Data Lists</link>.
* Quarks are used for both [datasets][glib-Datasets] and
* [keyed data lists][glib-Keyed-Data-Lists].
*
* To create a new quark from a string, use g_quark_from_string() or
* g_quark_from_static_string().

4
glib/gqueue.c
View File

@ -32,8 +32,8 @@
* as #GList to store elements.
*
* 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.
* using one of the [Type Conversion Macros][glib-Type-Conversion-Macros],
* or simply pointers to any type of data.
*
* To create a new GQueue, use g_queue_new().
*

2
glib/gregex.c
View File

@ -42,7 +42,7 @@
* SECTION:gregex
* @title: Perl-compatible 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
* 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
* 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
* log n). The data contained in each element can be either integer
* values, by using of the <link
* linkend="glib-Type-Conversion-Macros">Type Conversion Macros</link>,
* or simply pointers to any type of data.
* it is possible to maintain a sorted list of n elements in time O(n log n).
* The data contained in each element can be either integer values, by using
* of the [Type Conversion Macros][glib-Type-Conversion-Macros], or simply
* pointers to any type of data.
*
* A #GSequence is accessed through "iterators", represented by a
* #GSequenceIter. An iterator represents a position between two
@ -91,7 +90,7 @@ typedef struct _GSequenceNode GSequenceNode;
* GSequence:
*
* 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
{

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
* returned pointer to a pointer of the given type, avoiding a type
* cast in the source code. Note that the underlying slice allocation
* mechanism can be changed with the
* <link linkend="G_SLICE">G_SLICE=always-malloc</link>
* mechanism can be changed with the [`G_SLICE=always-malloc`][G_SLICE]
* environment variable.
*
* 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,
* avoiding a type cast in the source code.
* 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.
*
* 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,
* avoiding a type cast in the source code.
* 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.
*
* 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)`
* as the block size.
* Note that the exact release behaviour can be changed with the
* <link linkend="G_DEBUG">G_DEBUG=gc-friendly</link> environment
* variable, also see <link linkend="G_SLICE">G_SLICE</link> for
* related debugging options.
* [`G_DEBUG=gc-friendly`][G_DEBUG] environment variable, also see
* [`G_SLICE`][G_SLICE] for related debugging options.
*
* Since: 2.10
*/
@ -946,9 +944,8 @@ thread_memory_magazine2_free (ThreadMemory *tmem,
* a @next pointer (similar to #GSList). The name of the
* @next field in @type is passed as third argument.
* Note that the exact release behaviour can be changed with the
* <link linkend="G_DEBUG">G_DEBUG=gc-friendly</link> environment
* variable, also see <link linkend="G_SLICE">G_SLICE</link> for
* related debugging options.
* [`G_DEBUG=gc-friendly`][G_DEBUG] environment variable, also see
* [`G_SLICE`][G_SLICE] for related debugging options.
*
* Since: 2.10
*/
@ -964,7 +961,7 @@ thread_memory_magazine2_free (ThreadMemory *tmem,
* if a malloc() fallback implementation is used instead,
* the alignment may be reduced in a libc dependent fashion.
* 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.
*
* 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
* the returned memory to 0. Note that the underlying slice allocation
* mechanism can be changed with the
* <link linkend="G_SLICE">G_SLICE=always-malloc</link>
* mechanism can be changed with the [`G_SLICE=always-malloc`][G_SLICE]
* environment variable.
*
* 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
* g_slice_alloc0() and the @block_size has to match the size
* specified upon allocation. Note that the exact release behaviour
* can be changed with the
* <link linkend="G_DEBUG">G_DEBUG=gc-friendly</link> environment
* variable, also see <link linkend="G_SLICE">G_SLICE</link> for
* related debugging options.
* can be changed with the [`G_DEBUG=gc-friendly`][G_DEBUG] environment
* variable, also see [`G_SLICE`][G_SLICE] for related debugging options.
*
* Since: 2.10
*/
@ -1133,9 +1127,8 @@ g_slice_free1 (gsize mem_size,
* @next pointer (similar to #GSList). The offset of the @next
* field in each block is passed as third argument.
* Note that the exact release behaviour can be changed with the
* <link linkend="G_DEBUG">G_DEBUG=gc-friendly</link> environment
* variable, also see <link linkend="G_SLICE">G_SLICE</link> for
* related debugging options.
* [`G_DEBUG=gc-friendly`][G_DEBUG] environment variable, also see
* [`G_SLICE`][G_SLICE] for related debugging options.
*
* Since: 2.10
*/

101
glib/gslist.c
View File

@ -1,60 +1,58 @@
/* GLIB - Library of useful routines for C programming
* Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* 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/>.
*/
* Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* 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/>.
*/
/*
* 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
* files for a list of changes. These files are distributed with
* GLib at ftp://ftp.gtk.org/pub/gtk/.
*/
/*
* 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
* files for a list of changes. These files are distributed with
* 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 "gslice.h"
#include "gtestutils.h"
#include "gslice.h"
/**
* SECTION:linked_lists_single
* @title: Singly-Linked Lists
* @short_description: linked lists that can be iterated in one direction
/**
* SECTION:linked_lists_single
* @title: Singly-Linked Lists
* @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
* 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 <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.
* List elements are allocated from the [slice allocator][glib-Memory-Slices],
* which is more efficient than allocating elements individually.
*
* Note that most of the #GSList functions expect to be passed a
* pointer to the first element in the list. The functions which insert
@ -84,9 +82,8 @@
/**
* GSList:
* @data: holds the element's data, which can be a pointer to any kind
* of data, or any integer value using the <link
* linkend="glib-Type-Conversion-Macros">Type Conversion
* Macros</link>.
* of data, or any integer value using the
* [Type Conversion Macros][glib-Type-Conversion-Macros]
* @next: contains the link to the next element in the list.
*
* 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:
* @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
*
* Similar to the standard C vsprintf() function but safer, since it
@ -512,7 +512,7 @@ g_strdup_vprintf (const gchar *format,
/**
* g_strdup_printf:
* @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
*
* Similar to the standard C sprintf() function but safer, since it

15
glib/gtestutils.c
View File

@ -59,8 +59,7 @@
* SECTION:testing
* @title: Testing
* @short_description: a test framework
* @see_also: <link linkend="gtester">gtester</link>,
* <link linkend="gtester-report">gtester-report</link>
* @see_also: [gtester][gtester], [gtester-report][gtester-report]
*
* GLib provides a framework for writing and maintaining unit tests
* in parallel to the code they are testing. The API is designed according
@ -253,8 +252,7 @@
/**
* g_test_trap_assert_stdout:
* @soutpattern: a glob-style
* <link linkend="glib-Glob-style-pattern-matching">pattern</link>
* @soutpattern: a glob-style [pattern][glib-Glob-style-pattern-matching]
*
* Assert that the stdout output of the last test subprocess matches
* @soutpattern. See g_test_trap_subprocess().
@ -264,8 +262,7 @@
/**
* g_test_trap_assert_stdout_unmatched:
* @soutpattern: a glob-style
* <link linkend="glib-Glob-style-pattern-matching">pattern</link>
* @soutpattern: a glob-style [pattern][glib-Glob-style-pattern-matching]
*
* Assert that the stdout output of the last test subprocess
* does not match @soutpattern. See g_test_trap_subprocess().
@ -275,8 +272,7 @@
/**
* g_test_trap_assert_stderr:
* @serrpattern: a glob-style
* <link linkend="glib-Glob-style-pattern-matching">pattern</link>
* @serrpattern: a glob-style [pattern][glib-Glob-style-pattern-matching]
*
* Assert that the stderr output of the last test subprocess
* matches @serrpattern. See g_test_trap_subprocess().
@ -293,8 +289,7 @@
/**
* g_test_trap_assert_stderr_unmatched:
* @serrpattern: a glob-style
* <link linkend="glib-Glob-style-pattern-matching">pattern</link>
* @serrpattern: a glob-style [pattern][glib-Glob-style-pattern-matching]
*
* Assert that the stderr output of the last test 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:
*
* The GTree struct is an opaque data structure representing a <link
* linkend="glib-Balanced-Binary-Trees">Balanced Binary Tree</link>.
* It should be accessed only by using the following functions.
* The GTree struct is an opaque data structure representing a
* [balanced binary tree][glib-Balanced-Binary-Trees]. It should be
* accessed only by using the following functions.
*/
struct _GTree
{
@ -940,8 +940,7 @@ g_tree_foreach (GTree *tree,
* Deprecated:2.2: The order of a balanced tree is somewhat arbitrary.
* If you just want to visit all nodes in sorted order, use
* g_tree_foreach() instead. If you really need to visit nodes in
* a different order, consider using an
* <link linkend="glib-N-ary-Trees">N-ary Tree</link>.
* a different order, consider using an [n-ary tree][glib-N-ary-Trees].
*/
/**
* GTraverseFunc:

8
glib/gunicollate.c
View File

@ -65,7 +65,7 @@ msc_strxfrm_wrapper (char *string1,
* @str2: a UTF-8 encoded string
*
* 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
* faster to obtain collation keys with g_utf8_collate_key() and
* 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
* original keys with g_utf8_collate().
*
* Note that this function depends on the
* <link linkend="setlocale">current locale</link>.
* Note that this function depends on the [current locale][setlocale].
*
* Return value: a newly allocated string. This string should
* 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"
* is sorted as "file1" "file5" "file10".
*
* Note that this function depends on the
* <link linkend="setlocale">current locale</link>.
* Note that this function depends on the [current locale][setlocale].
*
* Return value: a newly allocated string. This string should
* 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.
*
* 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
* 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
* 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
* 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
* 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:
* |[<!-- 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
* 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:
*

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
* the values and also determines if the values are copied or borrowed,
* 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
* 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,
* as given by the section on
* <link linkend='gvariant-serialised-data-memory'>Serialised Data
* Memory</link>.
* [serialized data memory][gvariant-serialised-data-memory].
*
* 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
@ -2577,7 +2576,7 @@ g_variant_print_string (GVariant *value,
*
* 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
* the output.
@ -3844,10 +3843,9 @@ g_variant_dict_init (GVariantDict *dict,
* this function returns %FALSE. Otherwise, it unpacks the returned
* value and returns %TRUE.
*
* @format_string determines the C types that are used for unpacking
* the values and also determines if the values are copied or borrowed,
* see the section on
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
* @format_string determines the C types that are used for unpacking the
* values and also determines if the values are copied or borrowed, see the
* section on [GVariant format strings][gvariant-format-strings-pointers].
*
* 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
* character at @limit were nul.
*
* See the section on <link linkend='gvariant-format-strings'>GVariant
* Format Strings</link>.
* See the section on [GVariant format strings][gvariant-format-strings].
*
* 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().
*
* The type of the created instance and the arguments that are
* expected by this function are determined by @format_string. See the
* section on <link linkend='gvariant-format-strings'>GVariant Format
* Strings</link>. Please note that the syntax of the format string is
* very likely to be extended in the future.
* The type of the created instance and the arguments that are expected
* by this function are determined by @format_string. See the section on
* [GVariant format strings][gvariant-format-strings]. Please note that
* the syntax of the format string is very likely to be extended in the
* future.
*
* The first character of the format string must not be '*' '?' '@' or
* '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
* 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>
* 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
* pointing to the argument following the last.
*
* Note that the arguments in @app must be of the correct width for their types
* specified in @format_string when collected into the #va_list. See
* the <link linkend='gvariant-varargs'>GVariant varargs documentation</link>.
* Note that the arguments in @app must be of the correct width for their
* types specified in @format_string when collected into the #va_list.
* See the [GVariant varargs documentation][gvariant-varargs.
*
* These two generalisations allow mixing of multiple calls to
* 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
* determined by @format_string. @format_string also restricts the
* permissible types of @value. It is an error to give a value with
* an incompatible type. See the section on <link
* linkend='gvariant-format-strings'>GVariant Format Strings</link>.
* an incompatible type. See the section on
* [GVariant format strings][gvariant-format-strings].
* Please note that the syntax of the format string is very likely to be
* extended in the future.
*
* @format_string determines the C types that are used for unpacking
* the values and also determines if the values are copied or borrowed,
* see the section on
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
* [GVariant format strings][gvariant-format-strings-pointers].
*
* Since: 2.24
**/
@ -5347,7 +5344,7 @@ g_variant_get (GVariant *value,
* @format_string determines the C types that are used for unpacking
* the values and also determines if the values are copied or borrowed,
* see the section on
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
* [GVariant format strings][gvariant-format-strings-pointers].
*
* 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
* 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:
*
@ -5442,7 +5439,7 @@ g_variant_builder_add (GVariantBuilder *builder,
* @format_string determines the C types that are used for unpacking
* the values and also determines if the values are copied or borrowed,
* see the section on
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
* [GVariant format strings][gvariant-format-strings-pointers].
*
* 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.
*
* 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
*
@ -5611,7 +5608,7 @@ g_variant_iter_next (GVariantIter *iter,
* the values and also determines if the values are copied or borrowed.
*
* 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
* value

4
gmodule/gmodule.c
View File

@ -129,8 +129,8 @@
* GModule:
*
* The #GModule struct is an opaque data structure to represent a
* <link linkend="glib-Dynamic-Loading-of-Modules">Dynamically-Loaded
* Module</link>. It should only be accessed via the following functions.
* [dynamically-loaded module][glib-Dynamic-Loading-of-Modules].
* 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
* signal. GObject provides a number of C marshallers for this
* purpose, see the g_cclosure_marshal_*() functions. Additional C
* marshallers can be generated with the <link
* linkend="glib-genmarshal">glib-genmarshal</link> utility. Closures
* can be explicitly connected to signals with
* marshallers can be generated with the [glib-genmarshal][glib-genmarshal]
* utility. Closures can be explicitly connected to signals with
* g_signal_connect_closure(), but it usually more convenient to let
* GObject create a closure automatically by using one of the
* 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
* @closure->marshal and modifies the way it is called in some
* fashion. The most common use of this facility is for C callbacks.
* The same marshallers (generated by <link
* linkend="glib-genmarshal">glib-genmarshal</link>) are used
* everywhere, but the way that we get the callback function
* The same marshallers (generated by [glib-genmarshal][glib-genmarshal]),
* are used everywhere, but the way that we get the callback function
* differs. In most cases we want to use @closure->callback, but in
* other cases we want to use some different technique to retrieve the
* callback function.

19
gobject/genums.c
View File

@ -47,9 +47,8 @@
* GLib type system, it can be used as value type for object
* properties, using g_param_spec_enum() or g_param_spec_flags().
*
* GObject ships with a utility called <link
* linkend="glib-mkenums">glib-mkenums</link> that can construct
* suitable type registration functions from C enumeration
* GObject ships with a utility called [glib-mkenums][glib-mkenums],
* that can construct suitable type registration functions from C enumeration
* definitions.
*/
@ -171,10 +170,9 @@ value_flags_enum_lcopy_value (const GValue *value,
*
* Registers a new static enumeration type with the name @name.
*
* It is normally more convenient to let <link
* linkend="glib-mkenums">glib-mkenums</link> generate a
* my_enum_get_type() function from a usual C enumeration definition
* than to write one yourself using g_enum_register_static().
* It is normally more convenient to let [glib-mkenums][glib-mkenums],
* generate a my_enum_get_type() function from a usual C enumeration
* definition than to write one yourself using g_enum_register_static().
*
* 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.
*
* It is normally more convenient to let <link
* linkend="glib-mkenums">glib-mkenums</link> generate a
* my_flags_get_type() function from a usual C enumeration definition
* than to write one yourself using g_flags_register_static().
* It is normally more convenient to let [glib-mkenums][glib-mkenums]
* generate a my_flags_get_type() function from a usual C enumeration
* definition than to write one yourself using g_flags_register_static().
*
* 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
* based on GObject. The GObject class provides methods for object
* construction and destruction, property access methods, and signal
* support. Signals are described in detail in <xref
* linkend="gobject-Signals"/>.
* support. Signals are described in detail [here][gobject-Signals].
*
* ## Floating references # {#floating-ref}
*
@ -479,7 +478,7 @@ g_object_do_class_init (GObjectClass *class)
* text_view)
* ]|
* 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.
*/
gobject_signals[NOTIFY] =
@ -2739,8 +2738,7 @@ object_floating_flag_handler (GObject *object,
* g_object_is_floating:
* @object: (type GObject.Object): a #GObject
*
* Checks whether @object has a <link linkend="floating-ref">floating</link>
* reference.
* Checks whether @object has a [floating][floating-ref] reference.
*
* Since: 2.10
*
@ -2759,8 +2757,7 @@ g_object_is_floating (gpointer _object)
* @object: (type GObject.Object): a #GObject
*
* Increase the reference count of @object, and possibly remove the
* <link linkend="floating-ref">floating</link> reference, if @object
* has a floating reference.
* [floating][floating-ref] reference, if @object has a floating reference.
*
* In other words, if the object is floating, then this call "assumes
* ownership" of the floating reference, converting it to a normal
@ -2790,11 +2787,10 @@ g_object_ref_sink (gpointer _object)
* g_object_force_floating:
* @object: a #GObject
*
* This function is intended for #GObject implementations to re-enforce a
* <link linkend="floating-ref">floating</link> object reference.
* Doing this is seldom required: all
* #GInitiallyUnowneds are created with a floating reference which
* usually just needs to be sunken by calling g_object_ref_sink().
* This function is intended for #GObject implementations to re-enforce
* a [floating][floating-ref] object reference. Doing this is seldom
* required: all #GInitiallyUnowneds are created with a floating reference
* which usually just needs to be sunken by calling g_object_ref_sink().
*
* Since: 2.10
*/

6
gobject/gvalue.c
View File

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