Skip to content
GitLab
Projects
Groups
Snippets
Help
Loading...
Help
What's new
7
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
Open sidebar
GNOME
GLib
Commits
e7fd3de8
Commit
e7fd3de8
authored
Feb 08, 2014
by
Matthias Clasen
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Eradicate links and xrefs
These are all replaced by markdown ref links.
parent
1448e619
Changes
70
Hide whitespace changes
Inline
Side-by-side
Showing
70 changed files
with
467 additions
and
528 deletions
+467
-528
gio/gapplication.c
gio/gapplication.c
+2
-1
gio/gapplicationcommandline.c
gio/gapplicationcommandline.c
+2
-1
gio/gasyncinitable.c
gio/gasyncinitable.c
+4
-8
gio/gbufferedinputstream.c
gio/gbufferedinputstream.c
+1
-2
gio/gdatainputstream.c
gio/gdatainputstream.c
+3
-6
gio/gdbusactiongroup.c
gio/gdbusactiongroup.c
+1
-1
gio/gdbusaddress.c
gio/gdbusaddress.c
+1
-1
gio/gdbusconnection.c
gio/gdbusconnection.c
+41
-38
gio/gdbusinterfaceskeleton.c
gio/gdbusinterfaceskeleton.c
+3
-1
gio/gdbusintrospection.c
gio/gdbusintrospection.c
+1
-1
gio/gdbusmenumodel.c
gio/gdbusmenumodel.c
+1
-1
gio/gdbusmethodinvocation.c
gio/gdbusmethodinvocation.c
+3
-3
gio/gdbusnameowning.c
gio/gdbusnameowning.c
+4
-4
gio/gdbusnamewatching.c
gio/gdbusnamewatching.c
+8
-8
gio/gdbusobjectmanagerclient.c
gio/gdbusobjectmanagerclient.c
+5
-5
gio/gdbusproxy.c
gio/gdbusproxy.c
+11
-12
gio/gdbusserver.c
gio/gdbusserver.c
+4
-5
gio/gdbusutils.c
gio/gdbusutils.c
+37
-12
gio/gfile.c
gio/gfile.c
+34
-53
gio/gfileattribute.c
gio/gfileattribute.c
+3
-3
gio/gfileenumerator.c
gio/gfileenumerator.c
+2
-4
gio/gfileinfo.c
gio/gfileinfo.c
+6
-6
gio/gfileinputstream.c
gio/gfileinputstream.c
+1
-2
gio/gfileiostream.c
gio/gfileiostream.c
+1
-2
gio/gfilemonitor.c
gio/gfilemonitor.c
+5
-6
gio/gfileoutputstream.c
gio/gfileoutputstream.c
+1
-2
gio/ginitable.c
gio/ginitable.c
+1
-2
gio/ginputstream.c
gio/ginputstream.c
+4
-7
gio/giomodule.c
gio/giomodule.c
+2
-2
gio/gioscheduler.c
gio/gioscheduler.c
+1
-1
gio/gmenumodel.c
gio/gmenumodel.c
+8
-11
gio/gresource.c
gio/gresource.c
+6
-6
gio/gsettings.c
gio/gsettings.c
+13
-14
gio/gsettingsschema.c
gio/gsettingsschema.c
+1
-2
gio/gsimpleasyncresult.c
gio/gsimpleasyncresult.c
+6
-6
gio/gsocket.c
gio/gsocket.c
+3
-3
gio/gsocketservice.c
gio/gsocketservice.c
+3
-3
gio/gtask.c
gio/gtask.c
+16
-20
gio/gtlsconnection.c
gio/gtlsconnection.c
+1
-2
gio/gvolume.c
gio/gvolume.c
+4
-5
gio/gvolumemonitor.c
gio/gvolumemonitor.c
+4
-4
glib/gcharset.c
glib/gcharset.c
+4
-5
glib/gconvert.c
glib/gconvert.c
+19
-21
glib/gdataset.c
glib/gdataset.c
+3
-3
glib/gdate.c
glib/gdate.c
+5
-5
glib/ghash.c
glib/ghash.c
+2
-2
glib/giochannel.c
glib/giochannel.c
+5
-6
glib/glist.c
glib/glist.c
+9
-12
glib/gmain.c
glib/gmain.c
+1
-1
glib/gmessages.c
glib/gmessages.c
+1
-2
glib/gnode.c
glib/gnode.c
+4
-6
glib/goption.c
glib/goption.c
+1
-2
glib/gprintf.c
glib/gprintf.c
+9
-9
glib/gquark.c
glib/gquark.c
+2
-3
glib/gqueue.c
glib/gqueue.c
+2
-2
glib/gregex.c
glib/gregex.c
+1
-1
glib/gsequence.c
glib/gsequence.c
+5
-6
glib/gslice.c
glib/gslice.c
+13
-20
glib/gslist.c
glib/gslist.c
+56
-59
glib/gstrfuncs.c
glib/gstrfuncs.c
+2
-2
glib/gtestutils.c
glib/gtestutils.c
+5
-10
glib/gtree.c
glib/gtree.c
+4
-5
glib/gunicollate.c
glib/gunicollate.c
+3
-5
glib/gvariant-parser.c
glib/gvariant-parser.c
+4
-4
glib/gvariant.c
glib/gvariant.c
+24
-27
gmodule/gmodule.c
gmodule/gmodule.c
+2
-2
gobject/gclosure.c
gobject/gclosure.c
+4
-6
gobject/genums.c
gobject/genums.c
+8
-11
gobject/gobject.c
gobject/gobject.c
+8
-12
gobject/gvalue.c
gobject/gvalue.c
+3
-3
No files found.
gio/gapplication.c
View file @
e7fd3de8
...
...
@@ -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
...
...
gio/gapplicationcommandline.c
View file @
e7fd3de8
...
...
@@ -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
...
...
gio/gasyncinitable.c
View file @
e7fd3de8
...
...
@@ -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
...
...
gio/gbufferedinputstream.c
View file @
e7fd3de8
...
...
@@ -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
...
...
gio/gdatainputstream.c
View file @
e7fd3de8
...
...
@@ -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
...
...
gio/gdbusactiongroup.c
View file @
e7fd3de8
...
...
@@ -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
...
...
gio/gdbusaddress.c
View file @
e7fd3de8
...
...
@@ -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#addresses
">D-Bus specification</link>
.
* is explained in detail in the
[D-Bus specification](
http://dbus.freedesktop.org/doc/dbus-specification.html#addresses
)
.
*/
static
gchar
*
get_session_address_platform_specific
(
GError
**
error
);
...
...
gio/gdbusconnection.c
View file @
e7fd3de8
...
...
@@ -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() .
...
...
gio/gdbusinterfaceskeleton.c
View file @
e7fd3de8
...
...
@@ -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
*/
...
...
gio/gdbusintrospection.c
View file @
e7fd3de8
...
...
@@ -1760,7 +1760,7 @@ parser_error (GMarkupParseContext *context,
* <node> 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
...
...
gio/gdbusmenumodel.c
View file @
e7fd3de8
...
...
@@ -30,7 +30,7 @@
* @title: GDBusMenuModel
* @short_description: A D-Bus GMenuModel implementation
* @include: gio/gio.h
* @see_also:
<link linkend="gio-
GMenuModel
-e
xporter
">
GMenuModel
E
xporter
</link>
* @see_also:
[
GMenuModel
E
xporter
][gio-
GMenuModel
-e
xporter
]
*
* #GDBusMenuModel is an implementation of #GMenuModel that can be used
* as a proxy for a menu model that is exported over D-Bus with
...
...
gio/gdbusmethodinvocation.c
View file @
e7fd3de8
...
...
@@ -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.
*
...
...
gio/gdbusnameowning.c
View file @
e7fd3de8
...
...
@@ -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.
*
...
...
gio/gdbusnamewatching.c
View file @
e7fd3de8
...
...
@@ -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 want
s
* to take action when a certain name exists
, see <xref
*
linkend="gdbus-watching-names"/>. Basically, the applicatio
n
*
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 i
n
* @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.
...
...
gio/gdbusobjectmanagerclient.c
View file @
e7fd3de8
...
...
@@ -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
*
<l
in
k
l
inkend="
g-main-context-push-thread-default
">thread-default main loop</link>
*
[thread-default ma
in l
oop][
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.
...
...
gio/gdbusproxy.c
View file @
e7fd3de8
...
...
@@ -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
...
...
gio/gdbusserver.c
View file @
e7fd3de8
...
...
@@ -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.
...
...
gio/gdbusutils.c
View file @
e7fd3de8
...
...
@@ -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
...
...
gio/gfile.c
View file @
e7fd3de8
...
...
@@ -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