[glib/gdbus-merge] Add "Since: 2.26" to all new GDBus API
- From: David Zeuthen <davidz src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glib/gdbus-merge] Add "Since: 2.26" to all new GDBus API
- Date: Thu, 6 May 2010 20:02:52 +0000 (UTC)
commit 0fd6498cd89888023fb2161bfdde9339a4346986
Author: David Zeuthen <davidz redhat com>
Date: Thu May 6 16:02:08 2010 -0400
Add "Since: 2.26" to all new GDBus API
docs/reference/gio/gio-docs.xml | 2 +-
gio/gcredentials.c | 32 +++++++++++++
gio/gcredentials.h | 4 ++
gio/gdbusaddress.c | 12 +++++
gio/gdbusauthobserver.c | 6 +++
gio/gdbusauthobserver.h | 4 ++
gio/gdbusconnection.c | 94 ++++++++++++++++++++++++++++++++++++--
gio/gdbusconnection.h | 24 ++++++++++
gio/gdbuserror.c | 20 ++++++++
gio/gdbuserror.h | 4 ++
gio/gdbusintrospection.c | 52 ++++++++++++++++++++--
gio/gdbusintrospection.h | 28 ++++++++++++
gio/gdbusmessage.c | 88 ++++++++++++++++++++++++++++++++++++
gio/gdbusmessage.h | 4 ++
gio/gdbusmethodinvocation.c | 50 +++++++++++++++++++++
gio/gdbusmethodinvocation.h | 4 ++
gio/gdbusnameowning.c | 10 +++-
gio/gdbusnameowning.h | 6 +++
gio/gdbusnamewatching.c | 8 +++-
gio/gdbusnamewatching.h | 4 ++
gio/gdbusprivate.c | 2 +-
gio/gdbusproxy.c | 70 +++++++++++++++++++++++++----
gio/gdbusproxy.h | 4 ++
gio/gdbusproxywatching.c | 6 ++-
gio/gdbusproxywatching.h | 4 ++
gio/gdbusserver.c | 28 ++++++++++++
gio/gdbusserver.h | 4 ++
gio/gdbusutils.c | 15 ++++++-
gio/gioenums.h | 30 ++++++++++++-
gio/gunixcredentialsmessage.c | 4 ++
gio/gunixcredentialsmessage.h | 15 ++++++
31 files changed, 611 insertions(+), 27 deletions(-)
---
diff --git a/docs/reference/gio/gio-docs.xml b/docs/reference/gio/gio-docs.xml
index 305dc7a..748955b 100644
--- a/docs/reference/gio/gio-docs.xml
+++ b/docs/reference/gio/gio-docs.xml
@@ -135,7 +135,6 @@
<xi:include href="xml/gdbusmessage.xml"/>
<xi:include href="xml/gdbusconnection.xml"/>
<xi:include href="xml/gdbusmethodinvocation.xml"/>
- <xi:include href="xml/gdbusproxy.xml"/>
<xi:include href="xml/gdbusserver.xml"/>
<xi:include href="xml/gdbusauthobserver.xml"/>
</chapter>
@@ -144,6 +143,7 @@
<xi:include href="xml/gdbusnameowning.xml"/>
<xi:include href="xml/gdbusnamewatching.xml"/>
<xi:include href="xml/gdbusproxywatching.xml"/>
+ <xi:include href="xml/gdbusproxy.xml"/>
</chapter>
<chapter id="utils">
<title>Utilities</title>
diff --git a/gio/gcredentials.c b/gio/gcredentials.c
index 1ca2543..2f3c7ce 100644
--- a/gio/gcredentials.c
+++ b/gio/gcredentials.c
@@ -100,6 +100,8 @@ g_credentials_init (GCredentials *credentials)
* Creates a new empty credentials object.
*
* Returns: A #GCredentials. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GCredentials *
g_credentials_new (void)
@@ -132,6 +134,8 @@ g_credentials_new_for_unix_process (void)
* platform.
*
* Returns: A #GCredentials. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GCredentials *
g_credentials_new_for_process (void)
@@ -157,6 +161,8 @@ g_credentials_new_for_process (void)
*
* Returns: A #GCredentials or %NULL if @error is set. The return
* object must be freed with g_object_unref().
+ *
+ * Since: 2.26
*/
GCredentials *
g_credentials_new_for_string (const gchar *str,
@@ -212,6 +218,8 @@ g_credentials_new_for_string (const gchar *str,
* g_credentials_new_for_string().
*
* Returns: A string that should be freed with g_free().
+ *
+ * Since: 2.26
*/
gchar *
g_credentials_to_string (GCredentials *credentials)
@@ -244,6 +252,8 @@ g_credentials_to_string (GCredentials *credentials)
* Checks if @credentials has a UNIX user credential.
*
* Returns: %TRUE if @credentials has this type of credential, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_credentials_has_unix_user (GCredentials *credentials)
@@ -259,6 +269,8 @@ g_credentials_has_unix_user (GCredentials *credentials)
* Gets the UNIX user identifier from @credentials.
*
* Returns: The identifier or -1 if unset.
+ *
+ * Since: 2.26
*/
gint64
g_credentials_get_unix_user (GCredentials *credentials)
@@ -273,6 +285,8 @@ g_credentials_get_unix_user (GCredentials *credentials)
* @user_id: A UNIX user identifier (typically type #uid_t) or -1 to unset it.
*
* Sets the UNIX user identifier.
+ *
+ * Since: 2.26
*/
void
g_credentials_set_unix_user (GCredentials *credentials,
@@ -291,6 +305,8 @@ g_credentials_set_unix_user (GCredentials *credentials,
* Checks if @credentials has a UNIX group credential.
*
* Returns: %TRUE if @credentials has this type of credential, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_credentials_has_unix_group (GCredentials *credentials)
@@ -306,6 +322,8 @@ g_credentials_has_unix_group (GCredentials *credentials)
* Gets the UNIX group identifier from @credentials.
*
* Returns: The identifier or -1 if unset.
+ *
+ * Since: 2.26
*/
gint64
g_credentials_get_unix_group (GCredentials *credentials)
@@ -320,6 +338,8 @@ g_credentials_get_unix_group (GCredentials *credentials)
* @group_id: A UNIX group identifier (typically type #gid_t) or -1 to unset.
*
* Sets the UNIX group identifier.
+ *
+ * Since: 2.26
*/
void
g_credentials_set_unix_group (GCredentials *credentials,
@@ -338,6 +358,8 @@ g_credentials_set_unix_group (GCredentials *credentials,
* Checks if @credentials has a UNIX process credential.
*
* Returns: %TRUE if @credentials has this type of credential, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_credentials_has_unix_process (GCredentials *credentials)
@@ -353,6 +375,8 @@ g_credentials_has_unix_process (GCredentials *credentials)
* Gets the UNIX process identifier from @credentials.
*
* Returns: The identifier or -1 if unset.
+ *
+ * Since: 2.26
*/
gint64
g_credentials_get_unix_process (GCredentials *credentials)
@@ -367,6 +391,8 @@ g_credentials_get_unix_process (GCredentials *credentials)
* @process_id: A UNIX process identifier (typically type #pid_t/#GPid) or -1 to unset.
*
* Sets the UNIX process identifier.
+ *
+ * Since: 2.26
*/
void
g_credentials_set_unix_process (GCredentials *credentials,
@@ -385,6 +411,8 @@ g_credentials_set_unix_process (GCredentials *credentials,
* Checks if @credentials has a Windows user SID (Security Identifier).
*
* Returns: %TRUE if @credentials has this type of credential, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_credentials_has_windows_user (GCredentials *credentials)
@@ -400,6 +428,8 @@ g_credentials_has_windows_user (GCredentials *credentials)
* Gets the Windows User SID from @credentials.
*
* Returns: A string or %NULL if unset. Do not free, the string is owned by @credentials.
+ *
+ * Since: 2.26
*/
const gchar *
g_credentials_get_windows_user (GCredentials *credentials)
@@ -414,6 +444,8 @@ g_credentials_get_windows_user (GCredentials *credentials)
* @user_sid: The Windows User SID or %NULL to unset.
*
* Sets the Windows User SID.
+ *
+ * Since: 2.26
*/
void
g_credentials_set_windows_user (GCredentials *credentials,
diff --git a/gio/gcredentials.h b/gio/gcredentials.h
index a5bab7b..e26b018 100644
--- a/gio/gcredentials.h
+++ b/gio/gcredentials.h
@@ -42,6 +42,8 @@ typedef struct _GCredentialsPrivate GCredentialsPrivate;
*
* The #GCredentials structure contains only private data and
* should only be accessed using the provided API.
+ *
+ * Since: 2.26
*/
struct _GCredentials
{
@@ -54,6 +56,8 @@ struct _GCredentials
* GCredentialsClass:
*
* Class structure for #GCredentials.
+ *
+ * Since: 2.26
*/
struct _GCredentialsClass
{
diff --git a/gio/gdbusaddress.c b/gio/gdbusaddress.c
index 6cfa5f9..2c1041e 100644
--- a/gio/gdbusaddress.c
+++ b/gio/gdbusaddress.c
@@ -58,6 +58,8 @@
* checks.
*
* Returns: %TRUE if @string is a valid D-Bus address, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_is_address (const gchar *string)
@@ -335,6 +337,8 @@ is_valid_tcp (const gchar *address_entry,
*
* Returns: %TRUE if @string is a valid D-Bus address that is
* supported by this library, %FALSE if @error is set.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_is_supported_address (const gchar *string,
@@ -759,6 +763,8 @@ get_stream_thread_func (GSimpleAsyncResult *res,
*
* This is an asynchronous failable function. See
* g_dbus_address_get_stream_sync() for the synchronous version.
+ *
+ * Since: 2.26
*/
void
g_dbus_address_get_stream (const gchar *address,
@@ -796,6 +802,8 @@ g_dbus_address_get_stream (const gchar *address,
* Finishes an operation started with g_dbus_address_get_stream().
*
* Returns: A #GIOStream or %NULL if @error is set.
+ *
+ * Since: 2.26
*/
GIOStream *
g_dbus_address_get_stream_finish (GAsyncResult *res,
@@ -840,6 +848,8 @@ g_dbus_address_get_stream_finish (GAsyncResult *res,
* g_dbus_address_get_stream() for the asynchronous version.
*
* Returns: A #GIOStream or %NULL if @error is set.
+ *
+ * Since: 2.26
*/
GIOStream *
g_dbus_address_get_stream_sync (const gchar *address,
@@ -918,6 +928,8 @@ get_session_address_platform_specific (void)
* platform specific mechanisms.
*
* Returns: A valid D-Bus address string for @bus_type or %NULL if @error is set.
+ *
+ * Since: 2.26
*/
gchar *
g_dbus_address_get_for_bus_sync (GBusType bus_type,
diff --git a/gio/gdbusauthobserver.c b/gio/gdbusauthobserver.c
index 4de6722..b114da9 100644
--- a/gio/gdbusauthobserver.c
+++ b/gio/gdbusauthobserver.c
@@ -146,6 +146,8 @@ g_dbus_auth_observer_class_init (GDBusAuthObserverClass *klass)
* should be denied.
*
* Returns: %TRUE if the peer should be denied, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
signals[DENY_AUTHENTICATED_PEER_SIGNAL] =
g_signal_new ("deny-authenticated-peer",
@@ -179,6 +181,8 @@ g_dbus_auth_observer_init (GDBusAuthObserver *observer)
* Creates a new #GDBusAuthObserver object.
*
* Returns: A #GDBusAuthObserver. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusAuthObserver *
g_dbus_auth_observer_new (void)
@@ -197,6 +201,8 @@ g_dbus_auth_observer_new (void)
* Emits the #GDBusAuthObserver::deny-authenticated-peer signal on @observer.
*
* Returns: %TRUE if the peer should be denied, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_auth_observer_deny_authenticated_peer (GDBusAuthObserver *observer,
diff --git a/gio/gdbusauthobserver.h b/gio/gdbusauthobserver.h
index 6ed52e8..f3c88d0 100644
--- a/gio/gdbusauthobserver.h
+++ b/gio/gdbusauthobserver.h
@@ -43,6 +43,8 @@ typedef struct _GDBusAuthObserverPrivate GDBusAuthObserverPrivate;
* @deny_authenticated_peer: Signal class handler for the #GDBusAuthObserver::deny-authenticated-peer signal.
*
* Class structure for #GDBusAuthObserverClass.
+ *
+ * Since: 2.26
*/
struct _GDBusAuthObserverClass
{
@@ -82,6 +84,8 @@ struct _GDBusAuthObserverClass
*
* The #GDBusAuthObserver structure contains only private data and
* should only be accessed using the provided API.
+ *
+ * Since: 2.26
*/
struct _GDBusAuthObserver
{
diff --git a/gio/gdbusconnection.c b/gio/gdbusconnection.c
index fdcb6ed..77c3690 100644
--- a/gio/gdbusconnection.c
+++ b/gio/gdbusconnection.c
@@ -483,6 +483,8 @@ g_dbus_connection_class_init (GDBusConnectionClass *klass)
* GDBusConnection:stream:
*
* The underlying #GIOStream used for I/O.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_STREAM,
@@ -502,6 +504,8 @@ g_dbus_connection_class_init (GDBusConnectionClass *klass)
*
* A D-Bus address specifying potential endpoints that can be used
* when establishing the connection.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_ADDRESS,
@@ -519,6 +523,8 @@ g_dbus_connection_class_init (GDBusConnectionClass *klass)
* GDBusConnection:flags:
*
* Flags from the #GDBusConnectionFlags enumeration.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_FLAGS,
@@ -549,6 +555,8 @@ g_dbus_connection_class_init (GDBusConnectionClass *klass)
* #GDBusConnection:flags property you will be able to read the GUID
* of the other peer here after the connection has been succesfully
* initialized.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_GUID,
@@ -568,6 +576,8 @@ g_dbus_connection_class_init (GDBusConnectionClass *klass)
*
* The unique name as assigned by the message bus or %NULL if the
* connection is not open or not a message bus connection.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_UNIQUE_NAME,
@@ -584,6 +594,8 @@ g_dbus_connection_class_init (GDBusConnectionClass *klass)
* GDBusConnection:closed:
*
* A boolean specifying whether the connection has been closed.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_CLOSED,
@@ -602,6 +614,8 @@ g_dbus_connection_class_init (GDBusConnectionClass *klass)
* A boolean specifying whether the process will be terminated (by
* calling <literal>raise(SIGTERM)</literal>) if the connection
* is closed by the remote peer.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_EXIT_ON_CLOSE,
@@ -620,6 +634,8 @@ g_dbus_connection_class_init (GDBusConnectionClass *klass)
*
* Flags from the #GDBusCapabilityFlags enumeration
* representing connection features negotiated with the other peer.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_CAPABILITY_FLAGS,
@@ -637,6 +653,8 @@ g_dbus_connection_class_init (GDBusConnectionClass *klass)
* GDBusConnection:authentication-observer:
*
* A #GDBusAuthObserver object to assist in the authentication process or %NULL.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_AUTHENTICATION_OBSERVER,
@@ -679,6 +697,8 @@ g_dbus_connection_class_init (GDBusConnectionClass *klass)
* Upon receiving this signal, you should give up your reference to
* @connection. You are guaranteed that this signal is emitted only
* once.
+ *
+ * Since: 2.26
*/
signals[CLOSED_SIGNAL] = g_signal_new ("closed",
G_TYPE_DBUS_CONNECTION,
@@ -750,7 +770,9 @@ g_dbus_connection_get_stream (GDBusConnection *connection)
* Gets whether @connection is closed.
*
* Returns: %TRUE if the connection is closed, %FALSE otherwise.
- **/
+ *
+ * Since: 2.26
+ */
gboolean
g_dbus_connection_is_closed (GDBusConnection *connection)
{
@@ -765,6 +787,8 @@ g_dbus_connection_is_closed (GDBusConnection *connection)
* Gets the capabilities negotiated with the remote peer
*
* Returns: One or more flags from the #GDBusCapabilityFlags enumeration.
+ *
+ * Since: 2.26
*/
GDBusCapabilityFlags
g_dbus_connection_get_capabilities (GDBusConnection *connection)
@@ -849,6 +873,8 @@ set_closed_unlocked (GDBusConnection *connection,
* bus connection disconnects).
*
* If @connection is already closed, this method does nothing.
+ *
+ * Since: 2.26
*/
void
g_dbus_connection_close (GDBusConnection *connection)
@@ -983,6 +1009,8 @@ g_dbus_connection_send_message_unlocked (GDBusConnection *connection,
*
* Returns: %TRUE if the message was well-formed and queued for
* transmission, %FALSE if @error is set.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_connection_send_message (GDBusConnection *connection,
@@ -1297,6 +1325,8 @@ g_dbus_connection_send_message_with_reply_unlocked (GDBusConnection *connect
* 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.
+ *
+ * Since: 2.26
*/
void
g_dbus_connection_send_message_with_reply (GDBusConnection *connection,
@@ -1339,6 +1369,8 @@ g_dbus_connection_send_message_with_reply (GDBusConnection *connection,
* low-level API to send and receive UNIX file descriptors.
*
* Returns: A #GDBusMessage or %NULL if @error is set.
+ *
+ * Since: 2.26
*/
GDBusMessage *
g_dbus_connection_send_message_with_reply_finish (GDBusConnection *connection,
@@ -1426,6 +1458,8 @@ send_message_with_reply_sync_cb (GDBusConnection *connection,
* low-level API to send and receive UNIX file descriptors.
*
* Returns: A #GDBusMessage that is the reply to @message or %NULL if @error is set.
+ *
+ * Since: 2.26
*/
GDBusMessage *
g_dbus_connection_send_message_with_reply_sync (GDBusConnection *connection,
@@ -1856,6 +1890,8 @@ async_initable_iface_init (GAsyncInitableIface *async_initable_iface)
* This is a asynchronous failable constructor. See
* g_dbus_connection_new_sync() for the synchronous
* version.
+ *
+ * Since: 2.26
*/
void
g_dbus_connection_new (GIOStream *stream,
@@ -1887,6 +1923,8 @@ g_dbus_connection_new (GIOStream *stream,
* Finishes an operation started with g_dbus_connection_new().
*
* Returns: A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusConnection *
g_dbus_connection_new_finish (GAsyncResult *res,
@@ -1930,6 +1968,8 @@ g_dbus_connection_new_finish (GAsyncResult *res,
* g_dbus_connection_new() for the asynchronous version.
*
* Returns: A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusConnection *
g_dbus_connection_new_sync (GIOStream *stream,
@@ -1978,6 +2018,8 @@ g_dbus_connection_new_sync (GIOStream *stream,
* This is a asynchronous failable constructor. See
* g_dbus_connection_new_for_address_sync() for the synchronous
* version.
+ *
+ * Since: 2.26
*/
void
g_dbus_connection_new_for_address (const gchar *address,
@@ -2005,6 +2047,8 @@ g_dbus_connection_new_for_address (const gchar *address,
* Finishes an operation started with g_dbus_connection_new_for_address().
*
* Returns: A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusConnection *
g_dbus_connection_new_for_address_finish (GAsyncResult *res,
@@ -2049,6 +2093,8 @@ g_dbus_connection_new_for_address_finish (GAsyncResult *res,
* g_dbus_connection_new_for_address() for the asynchronous version.
*
* Returns: A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusConnection *
g_dbus_connection_new_for_address_sync (const gchar *address,
@@ -2077,6 +2123,8 @@ g_dbus_connection_new_for_address_sync (const gchar *address,
* Sets whether the process should be terminated when @connection is
* closed by the remote peer. See #GDBusConnection:exit-on-close for
* more details.
+ *
+ * Since: 2.26
*/
void
g_dbus_connection_set_exit_on_close (GDBusConnection *connection,
@@ -2096,6 +2144,8 @@ g_dbus_connection_set_exit_on_close (GDBusConnection *connection,
*
* Returns: Whether the process is terminated when @connection is
* closed by the remote peer.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_connection_get_exit_on_close (GDBusConnection *connection)
@@ -2113,7 +2163,9 @@ g_dbus_connection_get_exit_on_close (GDBusConnection *connection)
*
* Returns: The GUID. Do not free this string, it is owned by
* @connection.
- **/
+ *
+ * Since: 2.26
+ */
const gchar *
g_dbus_connection_get_guid (GDBusConnection *connection)
{
@@ -2132,7 +2184,9 @@ g_dbus_connection_get_guid (GDBusConnection *connection)
* Returns: The unique name or %NULL if @connection is not a message
* bus connection. Do not free this string, it is owned by
* @connection.
- **/
+ *
+ * Since: 2.26
+ */
const gchar *
g_dbus_connection_get_unique_name (GDBusConnection *connection)
{
@@ -2156,6 +2210,8 @@ g_dbus_connection_get_unique_name (GDBusConnection *connection)
*
* Returns: A #GCredentials or %NULL if not available. Do not free
* this object, it is owned by @connection.
+ *
+ * Since: 2.26
*/
GCredentials *
g_dbus_connection_get_peer_credentials (GDBusConnection *connection)
@@ -2192,6 +2248,8 @@ static guint _global_filter_id = 1;
*
* Returns: A filter identifier that can be used with
* g_dbus_connection_remove_filter().
+ *
+ * Since: 2.26
*/
guint
g_dbus_connection_add_filter (GDBusConnection *connection,
@@ -2427,7 +2485,9 @@ is_signal_data_for_name_lost_or_acquired (SignalData *signal_data)
* call g_dbus_connection_signal_unsubscribe() to remove a subscription.
*
* Returns: A subscription identifier that can be used with g_dbus_connection_signal_unsubscribe().
- **/
+ *
+ * Since: 2.26
+ */
guint
g_dbus_connection_signal_subscribe (GDBusConnection *connection,
const gchar *sender,
@@ -2607,7 +2667,9 @@ unsubscribe_id_internal (GDBusConnection *connection,
* @subscription_id: A subscription id obtained from g_dbus_connection_signal_subscribe().
*
* Unsubscribes from signals.
- **/
+ *
+ * Since: 2.26
+ */
void
g_dbus_connection_signal_unsubscribe (GDBusConnection *connection,
guint subscription_id)
@@ -3803,6 +3865,8 @@ obj_message_func (GDBusConnection *connection,
*
* Returns: 0 if @error is set, otherwise a registration id (never 0)
* that can be used with g_dbus_connection_unregister_object() .
+ *
+ * Since: 2.26
*/
guint
g_dbus_connection_register_object (GDBusConnection *connection,
@@ -3889,6 +3953,8 @@ g_dbus_connection_register_object (GDBusConnection *connection,
* Unregisters an object.
*
* Returns: %TRUE if the object was unregistered, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_connection_unregister_object (GDBusConnection *connection,
@@ -3947,6 +4013,8 @@ g_dbus_connection_unregister_object (GDBusConnection *connection,
* This can only fail if @parameters is not compatible with the D-Bus protocol.
*
* Returns: %TRUE unless @error is set.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_connection_emit_signal (GDBusConnection *connection,
@@ -4029,6 +4097,8 @@ add_invoke_method_flags (GDBusMessage *message,
* g_dbus_connection_invoke_method_finish() to get the result of the operation.
* See g_dbus_connection_invoke_method_sync() for the synchronous version of this
* function.
+ *
+ * Since: 2.26
*/
void
g_dbus_connection_invoke_method (GDBusConnection *connection,
@@ -4115,6 +4185,8 @@ decode_method_reply (GDBusMessage *reply, GError **error)
*
* Returns: %NULL if @error is set. Otherwise a #GVariant tuple with
* return values. Free with g_variant_unref().
+ *
+ * Since: 2.26
*/
GVariant *
g_dbus_connection_invoke_method_finish (GDBusConnection *connection,
@@ -4173,6 +4245,8 @@ g_dbus_connection_invoke_method_finish (GDBusConnection *connection,
*
* Returns: %NULL if @error is set. Otherwise a #GVariant tuple with
* return values. Free with g_variant_unref().
+ *
+ * Since: 2.26
*/
GVariant *
g_dbus_connection_invoke_method_sync (GDBusConnection *connection,
@@ -4695,6 +4769,8 @@ subtree_message_func (GDBusConnection *connection,
*
* Returns: 0 if @error is set, otherwise a subtree registration id (never 0)
* that can be used with g_dbus_connection_unregister_subtree() .
+ *
+ * Since: 2.26
*/
guint
g_dbus_connection_register_subtree (GDBusConnection *connection,
@@ -4764,6 +4840,8 @@ g_dbus_connection_register_subtree (GDBusConnection *connection,
* Unregisters a subtree.
*
* Returns: %TRUE if the subtree was unregistered, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_connection_unregister_subtree (GDBusConnection *connection,
@@ -5132,6 +5210,8 @@ get_uninitialized_connection (GBusType bus_type,
* the #GDBusConnection:exit-on-close property set to %TRUE.
*
* Returns: A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusConnection *
g_bus_get_sync (GBusType bus_type,
@@ -5198,6 +5278,8 @@ bus_get_async_initable_cb (GObject *source_object,
*
* This is a asynchronous failable function. See g_bus_get_sync() for
* the synchronous version.
+ *
+ * Since: 2.26
*/
void
g_bus_get (GBusType bus_type,
@@ -5251,6 +5333,8 @@ g_bus_get (GBusType bus_type,
* the #GDBusConnection:exit-on-close property set to %TRUE.
*
* Returns: A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusConnection *
g_bus_get_finish (GAsyncResult *res,
diff --git a/gio/gdbusconnection.h b/gio/gdbusconnection.h
index 4eeed48..5a2b278 100644
--- a/gio/gdbusconnection.h
+++ b/gio/gdbusconnection.h
@@ -42,6 +42,8 @@ typedef struct _GDBusConnectionPrivate GDBusConnectionPrivate;
*
* The #GDBusConnection structure contains only private data and
* should only be accessed using the provided API.
+ *
+ * Since: 2.26
*/
struct _GDBusConnection
{
@@ -55,6 +57,8 @@ struct _GDBusConnection
* @closed: Signal class handler for the #GDBusConnection::closed signal.
*
* Class structure for #GDBusConnection.
+ *
+ * Since: 2.26
*/
struct _GDBusConnectionClass
{
@@ -207,6 +211,8 @@ GVariant *g_dbus_connection_invoke_method_sync (GDBusConnection
* @user_data: The @user_data #gpointer passed to g_dbus_connection_register_object().
*
* The type of the @method_call function in #GDBusInterfaceVTable.
+ *
+ * Since: 2.26
*/
typedef void (*GDBusInterfaceMethodCallFunc) (GDBusConnection *connection,
const gchar *sender,
@@ -230,6 +236,8 @@ typedef void (*GDBusInterfaceMethodCallFunc) (GDBusConnection *connection,
* The type of the @get_property function in #GDBusInterfaceVTable.
*
* Returns: A newly-allocated #GVariant with the value for @property_name or %NULL if @error is set.
+ *
+ * Since: 2.26
*/
typedef GVariant *(*GDBusInterfaceGetPropertyFunc) (GDBusConnection *connection,
const gchar *sender,
@@ -253,6 +261,8 @@ typedef GVariant *(*GDBusInterfaceGetPropertyFunc) (GDBusConnection *conne
* The type of the @set_property function in #GDBusInterfaceVTable.
*
* Returns: %TRUE if the property was set to @value, %FALSE if @error is set.
+ *
+ * Since: 2.26
*/
typedef gboolean (*GDBusInterfaceSetPropertyFunc) (GDBusConnection *connection,
const gchar *sender,
@@ -275,6 +285,8 @@ typedef gboolean (*GDBusInterfaceSetPropertyFunc) (GDBusConnection *conne
* If you want to handle getting/setting D-Bus properties asynchronously, simply
* register an object with the <literal>org.freedesktop.DBus.Properties</literal>
* D-Bus interface using g_dbus_connection_register_object().
+ *
+ * Since: 2.26
*/
struct _GDBusInterfaceVTable
{
@@ -317,6 +329,8 @@ gboolean g_dbus_connection_unregister_object (GDBusConnection
* The type of the @enumerate function in #GDBusSubtreeVTable.
*
* Returns: A newly allocated array of strings for node names that are children of @object_path.
+ *
+ * Since: 2.26
*/
typedef gchar** (*GDBusSubtreeEnumerateFunc) (GDBusConnection *connection,
const gchar *sender,
@@ -335,6 +349,8 @@ typedef gchar** (*GDBusSubtreeEnumerateFunc) (GDBusConnection *connection,
*
* Returns: A newly-allocated #GPtrArray with pointers to #GDBusInterfaceInfo describing
* the interfaces implemented by @node.
+ *
+ * Since: 2.26
*/
typedef GPtrArray *(*GDBusSubtreeIntrospectFunc) (GDBusConnection *connection,
const gchar *sender,
@@ -355,6 +371,8 @@ typedef GPtrArray *(*GDBusSubtreeIntrospectFunc) (GDBusConnection *connect
* The type of the @dispatch function in #GDBusSubtreeVTable.
*
* Returns: A #GDBusInterfaceVTable or %NULL if you don't want to handle the methods.
+ *
+ * Since: 2.26
*/
typedef const GDBusInterfaceVTable * (*GDBusSubtreeDispatchFunc) (GDBusConnection *connection,
const gchar *sender,
@@ -371,6 +389,8 @@ typedef const GDBusInterfaceVTable * (*GDBusSubtreeDispatchFunc) (GDBusConnectio
* @dispatch: Function for dispatching a remote call on a child node.
*
* Virtual table for handling subtrees registered with g_dbus_connection_register_subtree().
+ *
+ * Since: 2.26
*/
struct _GDBusSubtreeVTable
{
@@ -413,6 +433,8 @@ gboolean g_dbus_connection_unregister_subtree (GDBusConnection
* @user_data: User data passed when subscribing to the signal.
*
* Signature for callback function used in g_dbus_connection_signal_subscribe().
+ *
+ * Since: 2.26
*/
typedef void (*GDBusSignalCallback) (GDBusConnection *connection,
const gchar *sender_name,
@@ -446,6 +468,8 @@ void g_dbus_connection_signal_unsubscribe (GDBusConnection
*
* Returns: %TRUE if the filter handled @message, %FALSE to let other
* handlers run.
+ *
+ * Since: 2.26
*/
typedef gboolean (*GDBusMessageFilterFunction) (GDBusConnection *connection,
GDBusMessage *message,
diff --git a/gio/gdbuserror.c b/gio/gdbuserror.c
index 5bc9c69..5a372ff 100644
--- a/gio/gdbuserror.c
+++ b/gio/gdbuserror.c
@@ -167,6 +167,8 @@ g_dbus_error_quark (void)
* @num_entries: Number of items to register.
*
* Helper function for associating a #GError error domain with D-Bus error names.
+ *
+ * Since: 2.26
*/
void
g_dbus_error_register_error_domain (const gchar *error_domain_quark_name,
@@ -336,6 +338,8 @@ static GHashTable *dbus_error_name_to_re = NULL;
*
* Returns: %TRUE if the association was created, %FALSE if it already
* exists.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_error_register_error (GQuark error_domain,
@@ -395,6 +399,8 @@ g_dbus_error_register_error (GQuark error_domain,
* Destroys an association previously set up with g_dbus_error_register_error().
*
* Returns: %TRUE if the association was destroyed, %FALSE if it wasn't found.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_error_unregister_error (GQuark error_domain,
@@ -463,6 +469,8 @@ g_dbus_error_unregister_error (GQuark error_domain,
*
* Returns: %TRUE if @error represents an error from a remote peer,
* %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_error_is_remote_error (const GError *error)
@@ -483,6 +491,8 @@ g_dbus_error_is_remote_error (const GError *error)
* unless g_dbus_error_strip_remote_error() has been used on @error.
*
* Returns: An allocated string or %NULL if the D-Bus error name could not be found. Free with g_free().
+ *
+ * Since: 2.26
*/
gchar *
g_dbus_error_get_remote_error (const GError *error)
@@ -568,6 +578,8 @@ g_dbus_error_get_remote_error (const GError *error)
* it.
*
* Returns: An allocated #GError. Free with g_error_free().
+ *
+ * Since: 2.26
*/
GError *
g_dbus_error_new_for_dbus_error (const gchar *dbus_error_name,
@@ -639,6 +651,8 @@ g_dbus_error_new_for_dbus_error (const gchar *dbus_error_name,
* Does nothing if @error is %NULL. Otherwise sets * error to
* a new #GError created with g_dbus_error_new_for_dbus_error()
* with @dbus_error_message prepend with @format (unless %NULL).
+ *
+ * Since: 2.26
*/
void
g_dbus_error_set_dbus_error (GError **error,
@@ -680,6 +694,8 @@ g_dbus_error_set_dbus_error (GError **error,
* @var_args: Arguments for @format.
*
* Like g_dbus_error_set_dbus_error() but intended for language bindings.
+ *
+ * Since: 2.26
*/
void
g_dbus_error_set_dbus_error_valist (GError **error,
@@ -723,6 +739,8 @@ g_dbus_error_set_dbus_error_valist (GError **error,
* This is typically used when presenting errors to the end user.
*
* Returns: %TRUE if information was stripped, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_error_strip_remote_error (GError *error)
@@ -770,6 +788,8 @@ g_dbus_error_strip_remote_error (GError *error)
* #GError on the wire. Regular applications should not use it.
*
* Returns: A D-Bus error name (never %NULL). Free with g_free().
+ *
+ * Since: 2.26
*/
gchar *
g_dbus_error_encode_gerror (const GError *error)
diff --git a/gio/gdbuserror.h b/gio/gdbuserror.h
index d15724c..73c97aa 100644
--- a/gio/gdbuserror.h
+++ b/gio/gdbuserror.h
@@ -38,6 +38,8 @@ G_BEGIN_DECLS
* returning errors from a remote message bus process. Errors
* generated locally in-process by e.g. #GDBusConnection is from the
* %G_IO_ERROR domain.
+ *
+ * Since: 2.26
*/
#define G_DBUS_ERROR g_dbus_error_quark()
@@ -54,6 +56,8 @@ gboolean g_dbus_error_strip_remote_error (GError *error);
* @dbus_error_name: The D-Bus error name to associate with @error_code.
*
* Struct used in g_dbus_error_register_error_domain().
+ *
+ * Since: 2.26
*/
struct _GDBusErrorEntry
{
diff --git a/gio/gdbusintrospection.c b/gio/gdbusintrospection.c
index c76af4e..fd26d40 100644
--- a/gio/gdbusintrospection.c
+++ b/gio/gdbusintrospection.c
@@ -106,6 +106,8 @@ typedef struct
* the reference count.
*
* Returns: The same @info.
+ *
+ * Since: 2.26
*/
GDBusNodeInfo *
g_dbus_node_info_ref (GDBusNodeInfo *info)
@@ -124,6 +126,8 @@ g_dbus_node_info_ref (GDBusNodeInfo *info)
* the reference count.
*
* Returns: The same @info.
+ *
+ * Since: 2.26
*/
GDBusInterfaceInfo *
g_dbus_interface_info_ref (GDBusInterfaceInfo *info)
@@ -142,6 +146,8 @@ g_dbus_interface_info_ref (GDBusInterfaceInfo *info)
* the reference count.
*
* Returns: The same @info.
+ *
+ * Since: 2.26
*/
GDBusMethodInfo *
g_dbus_method_info_ref (GDBusMethodInfo *info)
@@ -160,6 +166,8 @@ g_dbus_method_info_ref (GDBusMethodInfo *info)
* the reference count.
*
* Returns: The same @info.
+ *
+ * Since: 2.26
*/
GDBusSignalInfo *
g_dbus_signal_info_ref (GDBusSignalInfo *info)
@@ -178,6 +186,8 @@ g_dbus_signal_info_ref (GDBusSignalInfo *info)
* the reference count.
*
* Returns: The same @info.
+ *
+ * Since: 2.26
*/
GDBusPropertyInfo *
g_dbus_property_info_ref (GDBusPropertyInfo *info)
@@ -196,6 +206,8 @@ g_dbus_property_info_ref (GDBusPropertyInfo *info)
* the reference count.
*
* Returns: The same @info.
+ *
+ * Since: 2.26
*/
GDBusArgInfo *
g_dbus_arg_info_ref (GDBusArgInfo *info)
@@ -214,6 +226,8 @@ g_dbus_arg_info_ref (GDBusArgInfo *info)
* the reference count.
*
* Returns: The same @info.
+ *
+ * Since: 2.26
*/
GDBusAnnotationInfo *
g_dbus_annotation_info_ref (GDBusAnnotationInfo *info)
@@ -245,6 +259,8 @@ free_null_terminated_array (gpointer array, GDestroyNotify unref_func)
* If @info is statically allocated, does nothing. Otherwise decreases
* the reference count of @info. When its reference count drops to 0,
* the memory used is freed.
+ *
+ * Since: 2.26
*/
void
g_dbus_annotation_info_unref (GDBusAnnotationInfo *info)
@@ -267,6 +283,8 @@ g_dbus_annotation_info_unref (GDBusAnnotationInfo *info)
* If @info is statically allocated, does nothing. Otherwise decreases
* the reference count of @info. When its reference count drops to 0,
* the memory used is freed.
+ *
+ * Since: 2.26
*/
void
g_dbus_arg_info_unref (GDBusArgInfo *info)
@@ -289,6 +307,8 @@ g_dbus_arg_info_unref (GDBusArgInfo *info)
* If @info is statically allocated, does nothing. Otherwise decreases
* the reference count of @info. When its reference count drops to 0,
* the memory used is freed.
+ *
+ * Since: 2.26
*/
void
g_dbus_method_info_unref (GDBusMethodInfo *info)
@@ -312,6 +332,8 @@ g_dbus_method_info_unref (GDBusMethodInfo *info)
* If @info is statically allocated, does nothing. Otherwise decreases
* the reference count of @info. When its reference count drops to 0,
* the memory used is freed.
+ *
+ * Since: 2.26
*/
void
g_dbus_signal_info_unref (GDBusSignalInfo *info)
@@ -334,6 +356,8 @@ g_dbus_signal_info_unref (GDBusSignalInfo *info)
* If @info is statically allocated, does nothing. Otherwise decreases
* the reference count of @info. When its reference count drops to 0,
* the memory used is freed.
+ *
+ * Since: 2.26
*/
void
g_dbus_property_info_unref (GDBusPropertyInfo *info)
@@ -356,6 +380,8 @@ g_dbus_property_info_unref (GDBusPropertyInfo *info)
* If @info is statically allocated, does nothing. Otherwise decreases
* the reference count of @info. When its reference count drops to 0,
* the memory used is freed.
+ *
+ * Since: 2.26
*/
void
g_dbus_interface_info_unref (GDBusInterfaceInfo *info)
@@ -380,6 +406,8 @@ g_dbus_interface_info_unref (GDBusInterfaceInfo *info)
* If @info is statically allocated, does nothing. Otherwise decreases
* the reference count of @info. When its reference count drops to 0,
* the memory used is freed.
+ *
+ * Since: 2.26
*/
void
g_dbus_node_info_unref (GDBusNodeInfo *info)
@@ -805,6 +833,8 @@ g_dbus_property_info_generate_xml (const GDBusPropertyInfo *info,
* documents at run-time for handling the
* <literal>org.freedesktop.DBus.Introspectable.Introspect</literal>
* method.
+ *
+ * Since: 2.26
*/
void
g_dbus_interface_info_generate_xml (const GDBusInterfaceInfo *info,
@@ -850,6 +880,8 @@ g_dbus_interface_info_generate_xml (const GDBusInterfaceInfo *info,
*
* This function is typically used for generating introspection XML documents at run-time for
* handling the <literal>org.freedesktop.DBus.Introspectable.Introspect</literal> method.
+ *
+ * Since: 2.26
*/
void
g_dbus_node_info_generate_xml (const GDBusNodeInfo *node_info,
@@ -1759,6 +1791,8 @@ parser_error (GMarkupParseContext *context,
*
* Returns: A #GDBusNodeInfo structure or %NULL if @error is set. Free
* with g_dbus_node_info_unref().
+ *
+ * Since: 2.26
*/
GDBusNodeInfo *
g_dbus_node_info_new_for_xml (const gchar *xml_data,
@@ -1838,6 +1872,8 @@ g_dbus_node_info_new_for_xml (const gchar *xml_data,
* This cost of this function is O(n) in number of annotations.
*
* Returns: The value or %NULL if not found. Do not free, it is owned by @annotations.
+ *
+ * Since: 2.26
*/
const gchar *
g_dbus_annotation_info_lookup (const GDBusAnnotationInfo **annotations,
@@ -1872,7 +1908,9 @@ g_dbus_annotation_info_lookup (const GDBusAnnotationInfo **annotations,
* This cost of this function is O(n) in number of methods.
*
* Returns: A #GDBusMethodInfo or %NULL if not found. Do not free, it is owned by @info.
- **/
+ *
+ * Since: 2.26
+ */
const GDBusMethodInfo *
g_dbus_interface_info_lookup_method (const GDBusInterfaceInfo *info,
const gchar *name)
@@ -1909,7 +1947,9 @@ g_dbus_interface_info_lookup_method (const GDBusInterfaceInfo *info,
* This cost of this function is O(n) in number of signals.
*
* Returns: A #GDBusSignalInfo or %NULL if not found. Do not free, it is owned by @info.
- **/
+ *
+ * Since: 2.26
+ */
const GDBusSignalInfo *
g_dbus_interface_info_lookup_signal (const GDBusInterfaceInfo *info,
const gchar *name)
@@ -1946,7 +1986,9 @@ g_dbus_interface_info_lookup_signal (const GDBusInterfaceInfo *info,
* This cost of this function is O(n) in number of properties.
*
* Returns: A #GDBusPropertyInfo or %NULL if not found. Do not free, it is owned by @info.
- **/
+ *
+ * Since: 2.26
+ */
const GDBusPropertyInfo *
g_dbus_interface_info_lookup_property (const GDBusInterfaceInfo *info,
const gchar *name)
@@ -1983,7 +2025,9 @@ g_dbus_interface_info_lookup_property (const GDBusInterfaceInfo *info,
* This cost of this function is O(n) in number of interfaces.
*
* Returns: A #GDBusInterfaceInfo or %NULL if not found. Do not free, it is owned by @node_info.
- **/
+ *
+ * Since: 2.26
+ */
const GDBusInterfaceInfo *
g_dbus_node_info_lookup_interface (const GDBusNodeInfo *node_info,
const gchar *name)
diff --git a/gio/gdbusintrospection.h b/gio/gdbusintrospection.h
index 7aea8d9..897041f 100644
--- a/gio/gdbusintrospection.h
+++ b/gio/gdbusintrospection.h
@@ -35,6 +35,8 @@ G_BEGIN_DECLS
* @annotations: A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
*
* Information about an annotation.
+ *
+ * Since: 2.26
*/
struct _GDBusAnnotationInfo
{
@@ -52,6 +54,8 @@ struct _GDBusAnnotationInfo
* @annotations: A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
*
* Information about an argument for a method or a signal.
+ *
+ * Since: 2.26
*/
struct _GDBusArgInfo
{
@@ -70,6 +74,8 @@ struct _GDBusArgInfo
* @annotations: A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
*
* Information about a method on an D-Bus interface.
+ *
+ * Since: 2.26
*/
struct _GDBusMethodInfo
{
@@ -88,6 +94,8 @@ struct _GDBusMethodInfo
* @annotations: A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
*
* Information about a signal on a D-Bus interface.
+ *
+ * Since: 2.26
*/
struct _GDBusSignalInfo
{
@@ -106,6 +114,8 @@ struct _GDBusSignalInfo
* @annotations: A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
*
* Information about a D-Bus property on a D-Bus interface.
+ *
+ * Since: 2.26
*/
struct _GDBusPropertyInfo
{
@@ -126,6 +136,8 @@ struct _GDBusPropertyInfo
* @annotations: A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
*
* Information about a D-Bus interface.
+ *
+ * Since: 2.26
*/
struct _GDBusInterfaceInfo
{
@@ -146,6 +158,8 @@ struct _GDBusInterfaceInfo
* @annotations: A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
*
* Information about nodes in a remote object hierarchy.
+ *
+ * Since: 2.26
*/
struct _GDBusNodeInfo
{
@@ -197,6 +211,8 @@ void g_dbus_annotation_info_unref (GDBusAnnotatio
* G_TYPE_DBUS_NODE_INFO:
*
* The #GType for a boxed type holding a #GDBusNodeInfo.
+ *
+ * Since: 2.26
*/
#define G_TYPE_DBUS_NODE_INFO (g_dbus_node_info_get_type ())
@@ -204,6 +220,8 @@ void g_dbus_annotation_info_unref (GDBusAnnotatio
* G_TYPE_DBUS_INTERFACE_INFO:
*
* The #GType for a boxed type holding a #GDBusInterfaceInfo.
+ *
+ * Since: 2.26
*/
#define G_TYPE_DBUS_INTERFACE_INFO (g_dbus_interface_info_get_type ())
@@ -211,6 +229,8 @@ void g_dbus_annotation_info_unref (GDBusAnnotatio
* G_TYPE_DBUS_METHOD_INFO:
*
* The #GType for a boxed type holding a #GDBusMethodInfo.
+ *
+ * Since: 2.26
*/
#define G_TYPE_DBUS_METHOD_INFO (g_dbus_method_info_get_type ())
@@ -218,6 +238,8 @@ void g_dbus_annotation_info_unref (GDBusAnnotatio
* G_TYPE_DBUS_SIGNAL_INFO:
*
* The #GType for a boxed type holding a #GDBusSignalInfo.
+ *
+ * Since: 2.26
*/
#define G_TYPE_DBUS_SIGNAL_INFO (g_dbus_signal_info_get_type ())
@@ -225,6 +247,8 @@ void g_dbus_annotation_info_unref (GDBusAnnotatio
* G_TYPE_DBUS_PROPERTY_INFO:
*
* The #GType for a boxed type holding a #GDBusPropertyInfo.
+ *
+ * Since: 2.26
*/
#define G_TYPE_DBUS_PROPERTY_INFO (g_dbus_property_info_get_type ())
@@ -232,6 +256,8 @@ void g_dbus_annotation_info_unref (GDBusAnnotatio
* G_TYPE_DBUS_ARG_INFO:
*
* The #GType for a boxed type holding a #GDBusArgInfo.
+ *
+ * Since: 2.26
*/
#define G_TYPE_DBUS_ARG_INFO (g_dbus_arg_info_get_type ())
@@ -239,6 +265,8 @@ void g_dbus_annotation_info_unref (GDBusAnnotatio
* G_TYPE_DBUS_ANNOTATION_INFO:
*
* The #GType for a boxed type holding a #GDBusAnnotationInfo.
+ *
+ * Since: 2.26
*/
#define G_TYPE_DBUS_ANNOTATION_INFO (g_dbus_annotation_info_get_type ())
diff --git a/gio/gdbusmessage.c b/gio/gdbusmessage.c
index d1929ae..9eff732 100644
--- a/gio/gdbusmessage.c
+++ b/gio/gdbusmessage.c
@@ -118,6 +118,8 @@ g_dbus_message_init (GDBusMessage *message)
* Creates a new empty #GDBusMessage.
*
* Returns: A #GDBusMessage. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusMessage *
g_dbus_message_new (void)
@@ -135,6 +137,8 @@ g_dbus_message_new (void)
* Creates a new #GDBusMessage for a method call.
*
* Returns: A #GDBusMessage. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusMessage *
g_dbus_message_new_method_call (const gchar *name,
@@ -171,6 +175,8 @@ g_dbus_message_new_method_call (const gchar *name,
* Creates a new #GDBusMessage for a signal emission.
*
* Returns: A #GDBusMessage. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusMessage *
g_dbus_message_new_signal (const gchar *path,
@@ -205,6 +211,8 @@ g_dbus_message_new_signal (const gchar *path,
* Creates a new #GDBusMessage that is a reply to @method_call_message.
*
* Returns: A #GDBusMessage. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusMessage *
g_dbus_message_new_method_reply (GDBusMessage *method_call_message)
@@ -239,6 +247,8 @@ g_dbus_message_new_method_reply (GDBusMessage *method_call_message)
* Creates a new #GDBusMessage that is an error reply to @method_call_message.
*
* Returns: A #GDBusMessage. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusMessage *
g_dbus_message_new_method_error (GDBusMessage *method_call_message,
@@ -269,6 +279,8 @@ g_dbus_message_new_method_error (GDBusMessage *method_call_message,
* Creates a new #GDBusMessage that is an error reply to @method_call_message.
*
* Returns: A #GDBusMessage. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusMessage *
g_dbus_message_new_method_error_literal (GDBusMessage *method_call_message,
@@ -310,6 +322,8 @@ g_dbus_message_new_method_error_literal (GDBusMessage *method_call_message,
* Like g_dbus_message_new_method_error() but intended for language bindings.
*
* Returns: A #GDBusMessage. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusMessage *
g_dbus_message_new_method_error_valist (GDBusMessage *method_call_message,
@@ -338,6 +352,8 @@ g_dbus_message_new_method_error_valist (GDBusMessage *method_call_me
* Gets the type of @message.
*
* Returns: A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration).
+ *
+ * Since: 2.26
*/
GDBusMessageType
g_dbus_message_get_type (GDBusMessage *message)
@@ -352,6 +368,8 @@ g_dbus_message_get_type (GDBusMessage *message)
* @type: A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration).
*
* Sets @message to be of @type.
+ *
+ * Since: 2.26
*/
void
g_dbus_message_set_type (GDBusMessage *message,
@@ -373,6 +391,8 @@ g_dbus_message_set_type (GDBusMessage *message,
* Gets the flags for @message.
*
* Returns: Flags that are set (typically values from the #GDBusMessageFlags enumeration bitwise ORed together).
+ *
+ * Since: 2.26
*/
GDBusMessageFlags
g_dbus_message_get_flags (GDBusMessage *message)
@@ -388,6 +408,8 @@ g_dbus_message_get_flags (GDBusMessage *message)
* enumeration bitwise ORed together).
*
* Sets the flags to set on @message.
+ *
+ * Since: 2.26
*/
void
g_dbus_message_set_flags (GDBusMessage *message,
@@ -407,6 +429,8 @@ g_dbus_message_set_flags (GDBusMessage *message,
* Gets the serial for @message.
*
* Returns: A #guint32.
+ *
+ * Since: 2.26
*/
guint32
g_dbus_message_get_serial (GDBusMessage *message)
@@ -421,6 +445,8 @@ g_dbus_message_get_serial (GDBusMessage *message)
* @serial: A #guint32.
*
* Sets the serial for @message.
+ *
+ * Since: 2.26
*/
void
g_dbus_message_set_serial (GDBusMessage *message,
@@ -443,6 +469,8 @@ g_dbus_message_set_serial (GDBusMessage *message,
*
* Returns: A #GVariant with the value if the header was found, %NULL
* otherwise. Do not free, it is owned by @message.
+ *
+ * Since: 2.26
*/
GVariant *
g_dbus_message_get_header (GDBusMessage *message,
@@ -462,6 +490,8 @@ g_dbus_message_get_header (GDBusMessage *message,
* Sets a header field on @message.
*
* If @value is floating, @message assumes ownership of @value.
+ *
+ * Since: 2.26
*/
void
g_dbus_message_set_header (GDBusMessage *message,
@@ -489,6 +519,8 @@ g_dbus_message_set_header (GDBusMessage *message,
* Returns: An array of header fields terminated by
* %G_DBUS_MESSAGE_HEADER_FIELD_INVALID. Each element is a
* #guchar. Free with g_free().
+ *
+ * Since: 2.26
*/
guchar *
g_dbus_message_get_header_fields (GDBusMessage *message)
@@ -522,6 +554,8 @@ g_dbus_message_get_header_fields (GDBusMessage *message)
* Gets the body of a message.
*
* Returns: A #GVariant or %NULL if the body is empty. Do not free, it is owned by @message.
+ *
+ * Since: 2.26
*/
GVariant *
g_dbus_message_get_body (GDBusMessage *message)
@@ -540,6 +574,8 @@ g_dbus_message_get_body (GDBusMessage *message)
* type string of @body (or cleared if @body is %NULL).
*
* If @body is floating, @message assumes ownership of @body.
+ *
+ * Since: 2.26
*/
void
g_dbus_message_set_body (GDBusMessage *message,
@@ -585,6 +621,8 @@ g_dbus_message_set_body (GDBusMessage *message,
*
* Returns: A #GUnixFDList or %NULL if no file descriptors are
* associated. Do not free, this object is owned by @message.
+ *
+ * Since: 2.26
*/
GUnixFDList *
g_dbus_message_get_unix_fd_list (GDBusMessage *message)
@@ -604,6 +642,8 @@ g_dbus_message_get_unix_fd_list (GDBusMessage *message)
* @fd_list is %NULL).
*
* This method is only available on UNIX.
+ *
+ * Since: 2.26
*/
void
g_dbus_message_set_unix_fd_list (GDBusMessage *message,
@@ -1026,6 +1066,8 @@ parse_value_from_blob (GMemoryInputStream *mis,
* Returns: Number of bytes needed or -1 if @error is set (e.g. if
* @blob contains invalid data or not enough data is available to
* determine the size).
+ *
+ * Since: 2.26
*/
gssize
g_dbus_message_bytes_needed (guchar *blob,
@@ -1086,6 +1128,8 @@ g_dbus_message_bytes_needed (guchar *blob,
*
* Returns: A new #GDBusMessage or %NULL if @error is set. Free with
* g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusMessage *
g_dbus_message_new_from_blob (guchar *blob,
@@ -1527,6 +1571,8 @@ append_body_to_blob (GVariant *value,
*
* Returns: A pointer to a valid binary D-Bus message of @out_size bytes
* generated by @message or %NULL if @error is set. Free with g_free().
+ *
+ * Since: 2.26
*/
guchar *
g_dbus_message_to_blob (GDBusMessage *message,
@@ -1792,6 +1838,8 @@ set_signature_header (GDBusMessage *message,
* Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field.
*
* Returns: The value.
+ *
+ * Since: 2.26
*/
guint32
g_dbus_message_get_reply_serial (GDBusMessage *message)
@@ -1806,6 +1854,8 @@ g_dbus_message_get_reply_serial (GDBusMessage *message)
* @value: The value to set.
*
* Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field.
+ *
+ * Since: 2.26
*/
void
g_dbus_message_set_reply_serial (GDBusMessage *message,
@@ -1824,6 +1874,8 @@ g_dbus_message_set_reply_serial (GDBusMessage *message,
* Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field.
*
* Returns: The value.
+ *
+ * Since: 2.26
*/
const gchar *
g_dbus_message_get_interface (GDBusMessage *message)
@@ -1838,6 +1890,8 @@ g_dbus_message_get_interface (GDBusMessage *message)
* @value: The value to set.
*
* Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field.
+ *
+ * Since: 2.26
*/
void
g_dbus_message_set_interface (GDBusMessage *message,
@@ -1857,6 +1911,8 @@ g_dbus_message_set_interface (GDBusMessage *message,
* Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field.
*
* Returns: The value.
+ *
+ * Since: 2.26
*/
const gchar *
g_dbus_message_get_member (GDBusMessage *message)
@@ -1871,6 +1927,8 @@ g_dbus_message_get_member (GDBusMessage *message)
* @value: The value to set.
*
* Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field.
+ *
+ * Since: 2.26
*/
void
g_dbus_message_set_member (GDBusMessage *message,
@@ -1890,6 +1948,8 @@ g_dbus_message_set_member (GDBusMessage *message,
* Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field.
*
* Returns: The value.
+ *
+ * Since: 2.26
*/
const gchar *
g_dbus_message_get_path (GDBusMessage *message)
@@ -1904,6 +1964,8 @@ g_dbus_message_get_path (GDBusMessage *message)
* @value: The value to set.
*
* Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field.
+ *
+ * Since: 2.26
*/
void
g_dbus_message_set_path (GDBusMessage *message,
@@ -1923,6 +1985,8 @@ g_dbus_message_set_path (GDBusMessage *message,
* Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field.
*
* Returns: The value.
+ *
+ * Since: 2.26
*/
const gchar *
g_dbus_message_get_sender (GDBusMessage *message)
@@ -1937,6 +2001,8 @@ g_dbus_message_get_sender (GDBusMessage *message)
* @value: The value to set.
*
* Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field.
+ *
+ * Since: 2.26
*/
void
g_dbus_message_set_sender (GDBusMessage *message,
@@ -1956,6 +2022,8 @@ g_dbus_message_set_sender (GDBusMessage *message,
* Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field.
*
* Returns: The value.
+ *
+ * Since: 2.26
*/
const gchar *
g_dbus_message_get_destination (GDBusMessage *message)
@@ -1970,6 +2038,8 @@ g_dbus_message_get_destination (GDBusMessage *message)
* @value: The value to set.
*
* Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field.
+ *
+ * Since: 2.26
*/
void
g_dbus_message_set_destination (GDBusMessage *message,
@@ -1989,6 +2059,8 @@ g_dbus_message_set_destination (GDBusMessage *message,
* Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field.
*
* Returns: The value.
+ *
+ * Since: 2.26
*/
const gchar *
g_dbus_message_get_error_name (GDBusMessage *message)
@@ -2003,6 +2075,8 @@ g_dbus_message_get_error_name (GDBusMessage *message)
* @value: The value to set.
*
* Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field.
+ *
+ * Since: 2.26
*/
void
g_dbus_message_set_error_name (GDBusMessage *message,
@@ -2022,6 +2096,8 @@ g_dbus_message_set_error_name (GDBusMessage *message,
* Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field.
*
* Returns: The value.
+ *
+ * Since: 2.26
*/
const gchar *
g_dbus_message_get_signature (GDBusMessage *message)
@@ -2040,6 +2116,8 @@ g_dbus_message_get_signature (GDBusMessage *message)
* @value: The value to set.
*
* Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field.
+ *
+ * Since: 2.26
*/
void
g_dbus_message_set_signature (GDBusMessage *message,
@@ -2060,6 +2138,8 @@ g_dbus_message_set_signature (GDBusMessage *message,
*
* Returns: The string item or %NULL if the first item in the body of
* @message is not a string.
+ *
+ * Since: 2.26
*/
const gchar *
g_dbus_message_get_arg0 (GDBusMessage *message)
@@ -2090,6 +2170,8 @@ g_dbus_message_get_arg0 (GDBusMessage *message)
* Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field.
*
* Returns: The value.
+ *
+ * Since: 2.26
*/
guint32
g_dbus_message_get_num_unix_fds (GDBusMessage *message)
@@ -2104,6 +2186,8 @@ g_dbus_message_get_num_unix_fds (GDBusMessage *message)
* @value: The value to set.
*
* Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field.
+ *
+ * Since: 2.26
*/
void
g_dbus_message_set_num_unix_fds (GDBusMessage *message,
@@ -2129,6 +2213,8 @@ g_dbus_message_set_num_unix_fds (GDBusMessage *message,
* well as the first string item in @message's body.
*
* Returns: %TRUE if @error was set, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_message_to_gerror (GDBusMessage *message,
@@ -2298,6 +2384,8 @@ _sort_keys_func (gconstpointer a,
* </programlisting>
*
* Returns: A string that should be freed with g_free().
+ *
+ * Since: 2.26
*/
gchar *
g_dbus_message_print (GDBusMessage *message,
diff --git a/gio/gdbusmessage.h b/gio/gdbusmessage.h
index 4fb1873..747345d 100644
--- a/gio/gdbusmessage.h
+++ b/gio/gdbusmessage.h
@@ -45,6 +45,8 @@ typedef struct _GDBusMessagePrivate GDBusMessagePrivate;
* GDBusMessageClass:
*
* Class structure for #GDBusMessage.
+ *
+ * Since: 2.26
*/
struct _GDBusMessageClass
{
@@ -57,6 +59,8 @@ struct _GDBusMessageClass
*
* The #GDBusMessage structure contains only private data and should
* only be accessed using the provided API.
+ *
+ * Since: 2.26
*/
struct _GDBusMessage
{
diff --git a/gio/gdbusmethodinvocation.c b/gio/gdbusmethodinvocation.c
index 5885abc..1dfb315 100644
--- a/gio/gdbusmethodinvocation.c
+++ b/gio/gdbusmethodinvocation.c
@@ -208,6 +208,8 @@ g_dbus_method_invocation_class_init (GDBusMethodInvocationClass *klass)
* GDBusMethodInvocation:sender:
*
* The bus name that invoked the method or %NULL if the connection is not a bus connection.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_SENDER,
@@ -226,6 +228,8 @@ g_dbus_method_invocation_class_init (GDBusMethodInvocationClass *klass)
* GDBusMethodInvocation:object-path:
*
* The object path the method was invoked on.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_OBJECT_PATH,
@@ -244,6 +248,8 @@ g_dbus_method_invocation_class_init (GDBusMethodInvocationClass *klass)
* GDBusMethodInvocation:interface-name:
*
* The name of the D-Bus interface the method was invoked on.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_INTERFACE_NAME,
@@ -262,6 +268,8 @@ g_dbus_method_invocation_class_init (GDBusMethodInvocationClass *klass)
* GDBusMethodInvocation:method-name:
*
* The name of the method that was invoked.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_METHOD_NAME,
@@ -280,6 +288,8 @@ g_dbus_method_invocation_class_init (GDBusMethodInvocationClass *klass)
* GDBusMethodInvocation:method-info:
*
* Information about the method that was invoked, if any.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_METHOD_INFO,
@@ -298,6 +308,8 @@ g_dbus_method_invocation_class_init (GDBusMethodInvocationClass *klass)
* GDBusMethodInvocation:connection:
*
* The #GDBusConnection the method was invoked on.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_CONNECTION,
@@ -316,6 +328,8 @@ g_dbus_method_invocation_class_init (GDBusMethodInvocationClass *klass)
* GDBusMethodInvocation:message:
*
* The D-Bus message.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_MESSAGE,
@@ -334,6 +348,8 @@ g_dbus_method_invocation_class_init (GDBusMethodInvocationClass *klass)
* GDBusMethodInvocation:parameters:
*
* The parameters as a #GVariant tuple.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_PARAMETERS,
@@ -352,6 +368,8 @@ g_dbus_method_invocation_class_init (GDBusMethodInvocationClass *klass)
* GDBusMethodInvocation:user-data:
*
* The @user_data #gpointer passed to g_dbus_connection_register_object().
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_USER_DATA,
@@ -383,6 +401,8 @@ g_dbus_method_invocation_init (GDBusMethodInvocation *invocation)
* Gets the bus name that invoked the method.
*
* Returns: A string. Do not free, it is owned by @invocation.
+ *
+ * Since: 2.26
*/
const gchar *
g_dbus_method_invocation_get_sender (GDBusMethodInvocation *invocation)
@@ -398,6 +418,8 @@ g_dbus_method_invocation_get_sender (GDBusMethodInvocation *invocation)
* Gets the object path the method was invoked on.
*
* Returns: A string. Do not free, it is owned by @invocation.
+ *
+ * Since: 2.26
*/
const gchar *
g_dbus_method_invocation_get_object_path (GDBusMethodInvocation *invocation)
@@ -413,6 +435,8 @@ g_dbus_method_invocation_get_object_path (GDBusMethodInvocation *invocation)
* Gets the name of the D-Bus interface the method was invoked on.
*
* Returns: A string. Do not free, it is owned by @invocation.
+ *
+ * Since: 2.26
*/
const gchar *
g_dbus_method_invocation_get_interface_name (GDBusMethodInvocation *invocation)
@@ -428,6 +452,8 @@ g_dbus_method_invocation_get_interface_name (GDBusMethodInvocation *invocation)
* Gets information about the method call, if any.
*
* Returns: A #GDBusMethodInfo or %NULL. Do not free, it is owned by @invocation.
+ *
+ * Since: 2.26
*/
const GDBusMethodInfo *
g_dbus_method_invocation_get_method_info (GDBusMethodInvocation *invocation)
@@ -443,6 +469,8 @@ g_dbus_method_invocation_get_method_info (GDBusMethodInvocation *invocation)
* Gets the name of the method that was invoked.
*
* Returns: A string. Do not free, it is owned by @invocation.
+ *
+ * Since: 2.26
*/
const gchar *
g_dbus_method_invocation_get_method_name (GDBusMethodInvocation *invocation)
@@ -458,6 +486,8 @@ g_dbus_method_invocation_get_method_name (GDBusMethodInvocation *invocation)
* Gets the #GDBusConnection the method was invoked on.
*
* Returns: A #GDBusConnection. Do not free, it is owned by @invocation.
+ *
+ * Since: 2.26
*/
GDBusConnection *
g_dbus_method_invocation_get_connection (GDBusMethodInvocation *invocation)
@@ -480,6 +510,8 @@ g_dbus_method_invocation_get_connection (GDBusMethodInvocation *invocation)
* low-level API to send and receive UNIX file descriptors.
*
* Returns: A #GDBusMessage. Do not free, it is owned by @invocation.
+ *
+ * Since: 2.26
*/
GDBusMessage *
g_dbus_method_invocation_get_message (GDBusMethodInvocation *invocation)
@@ -495,6 +527,8 @@ g_dbus_method_invocation_get_message (GDBusMethodInvocation *invocation)
* Gets the parameters of the method invocation.
*
* Returns: A #GVariant. Do not free, it is owned by @invocation.
+ *
+ * Since: 2.26
*/
GVariant *
g_dbus_method_invocation_get_parameters (GDBusMethodInvocation *invocation)
@@ -510,6 +544,8 @@ g_dbus_method_invocation_get_parameters (GDBusMethodInvocation *invocation)
* Gets the @user_data #gpointer passed to g_dbus_connection_register_object().
*
* Returns: A #gpointer.
+ *
+ * Since: 2.26
*/
gpointer
g_dbus_method_invocation_get_user_data (GDBusMethodInvocation *invocation)
@@ -533,6 +569,8 @@ g_dbus_method_invocation_get_user_data (GDBusMethodInvocation *invocation)
* Creates a new #GDBusMethodInvocation object.
*
* Returns: A #GDBusMethodInvocation. Free with g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusMethodInvocation *
g_dbus_method_invocation_new (const gchar *sender,
@@ -578,6 +616,8 @@ g_dbus_method_invocation_new (const gchar *sender,
* It is an error if @parameters is not of the right format.
*
* This method will free @invocation, you cannot use it afterwards.
+ *
+ * Since: 2.26
*/
void
g_dbus_method_invocation_return_value (GDBusMethodInvocation *invocation,
@@ -655,6 +695,8 @@ g_dbus_method_invocation_return_value (GDBusMethodInvocation *invocation,
* or use g_dbus_method_invocation_return_dbus_error().
*
* This method will free @invocation, you cannot use it afterwards.
+ *
+ * Since: 2.26
*/
void
g_dbus_method_invocation_return_error (GDBusMethodInvocation *invocation,
@@ -689,6 +731,8 @@ g_dbus_method_invocation_return_error (GDBusMethodInvocation *invocation,
* language bindings.
*
* This method will free @invocation, you cannot use it afterwards.
+ *
+ * Since: 2.26
*/
void
g_dbus_method_invocation_return_error_valist (GDBusMethodInvocation *invocation,
@@ -720,6 +764,8 @@ g_dbus_method_invocation_return_error_valist (GDBusMethodInvocation *invocation,
* Like g_dbus_method_invocation_return_error() but without printf()-style formatting.
*
* This method will free @invocation, you cannot use it afterwards.
+ *
+ * Since: 2.26
*/
void
g_dbus_method_invocation_return_error_literal (GDBusMethodInvocation *invocation,
@@ -746,6 +792,8 @@ g_dbus_method_invocation_return_error_literal (GDBusMethodInvocation *invocation
* instead of the error domain, error code and message.
*
* This method will free @invocation, you cannot use it afterwards.
+ *
+ * Since: 2.26
*/
void
g_dbus_method_invocation_return_gerror (GDBusMethodInvocation *invocation,
@@ -773,6 +821,8 @@ g_dbus_method_invocation_return_gerror (GDBusMethodInvocation *invocation,
* Finishes handling a D-Bus method call by returning an error.
*
* This method will free @invocation, you cannot use it afterwards.
+ *
+ * Since: 2.26
*/
void
g_dbus_method_invocation_return_dbus_error (GDBusMethodInvocation *invocation,
diff --git a/gio/gdbusmethodinvocation.h b/gio/gdbusmethodinvocation.h
index 65d0f99..2c6563c 100644
--- a/gio/gdbusmethodinvocation.h
+++ b/gio/gdbusmethodinvocation.h
@@ -42,6 +42,8 @@ typedef struct _GDBusMethodInvocationPrivate GDBusMethodInvocationPrivate;
*
* The #GDBusMethodInvocation structure contains only private data and
* should only be accessed using the provided API.
+ *
+ * Since: 2.26
*/
struct _GDBusMethodInvocation
{
@@ -54,6 +56,8 @@ struct _GDBusMethodInvocation
* GDBusMethodInvocationClass:
*
* Class structure for #GDBusMethodInvocation.
+ *
+ * Since: 2.26
*/
struct _GDBusMethodInvocationClass
{
diff --git a/gio/gdbusnameowning.c b/gio/gdbusnameowning.c
index e840353..dab4801 100644
--- a/gio/gdbusnameowning.c
+++ b/gio/gdbusnameowning.c
@@ -461,7 +461,9 @@ connection_get_cb (GObject *source_object,
*
* Returns: An identifier (never 0) that an be used with
* g_bus_unown_name() to stop owning the name.
- **/
+ *
+ * Since: 2.26
+ */
guint
g_bus_own_name_on_connection (GDBusConnection *connection,
const gchar *name,
@@ -571,7 +573,9 @@ g_bus_own_name_on_connection (GDBusConnection *connection,
*
* Returns: An identifier (never 0) that an be used with
* g_bus_unown_name() to stop owning the name.
- **/
+ *
+ * Since: 2.26
+ */
guint
g_bus_own_name (GBusType bus_type,
const gchar *name,
@@ -626,6 +630,8 @@ g_bus_own_name (GBusType bus_type,
* @owner_id: An identifier obtained from g_bus_own_name()
*
* Stops owning a name.
+ *
+ * Since: 2.26
*/
void
g_bus_unown_name (guint owner_id)
diff --git a/gio/gdbusnameowning.h b/gio/gdbusnameowning.h
index fc063e0..3a7518c 100644
--- a/gio/gdbusnameowning.h
+++ b/gio/gdbusnameowning.h
@@ -34,6 +34,8 @@ G_BEGIN_DECLS
* @user_data: User data passed to g_bus_own_name().
*
* Invoked when a connection to a message bus has been obtained.
+ *
+ * Since: 2.26
*/
typedef void (*GBusAcquiredCallback) (GDBusConnection *connection,
const gchar *name,
@@ -46,6 +48,8 @@ typedef void (*GBusAcquiredCallback) (GDBusConnection *connection,
* @user_data: User data passed to g_bus_own_name() or g_bus_own_name_on_connection().
*
* Invoked when the name is acquired.
+ *
+ * Since: 2.26
*/
typedef void (*GBusNameAcquiredCallback) (GDBusConnection *connection,
const gchar *name,
@@ -59,6 +63,8 @@ typedef void (*GBusNameAcquiredCallback) (GDBusConnection *connection,
* @user_data: User data passed to g_bus_own_name() or g_bus_own_name_on_connection().
*
* Invoked when the name is lost or @connection has been closed.
+ *
+ * Since: 2.26
*/
typedef void (*GBusNameLostCallback) (GDBusConnection *connection,
const gchar *name,
diff --git a/gio/gdbusnamewatching.c b/gio/gdbusnamewatching.c
index 6ae4754..f6126e5 100644
--- a/gio/gdbusnamewatching.c
+++ b/gio/gdbusnamewatching.c
@@ -534,7 +534,9 @@ connection_get_cb (GObject *source_object,
*
* Returns: An identifier (never 0) that an be used with
* g_bus_unwatch_name() to stop watching the name.
- **/
+ *
+ * Since: 2.26
+ */
guint
g_bus_watch_name (GBusType bus_type,
const gchar *name,
@@ -587,7 +589,9 @@ g_bus_watch_name (GBusType bus_type,
* @watcher_id: An identifier obtained from g_bus_watch_name()
*
* Stops watching a name.
- **/
+ *
+ * Since: 2.26
+ */
void
g_bus_unwatch_name (guint watcher_id)
{
diff --git a/gio/gdbusnamewatching.h b/gio/gdbusnamewatching.h
index a724d42..28805ce 100644
--- a/gio/gdbusnamewatching.h
+++ b/gio/gdbusnamewatching.h
@@ -35,6 +35,8 @@ G_BEGIN_DECLS
* @user_data: User data passed to g_bus_watch_name().
*
* Invoked when the name being watched is known to have to have a owner.
+ *
+ * Since: 2.26
*/
typedef void (*GBusNameAppearedCallback) (GDBusConnection *connection,
const gchar *name,
@@ -48,6 +50,8 @@ typedef void (*GBusNameAppearedCallback) (GDBusConnection *connection,
* @user_data: User data passed to g_bus_watch_name().
*
* Invoked when the name being watched is known not to have to have a owner.
+ *
+ * Since: 2.26
*/
typedef void (*GBusNameVanishedCallback) (GDBusConnection *connection,
const gchar *name,
diff --git a/gio/gdbusprivate.c b/gio/gdbusprivate.c
index adc6e12..8f7ac8d 100644
--- a/gio/gdbusprivate.c
+++ b/gio/gdbusprivate.c
@@ -974,7 +974,7 @@ _g_dbus_debug_message (void)
return (_gdbus_debug_flags & G_DBUS_DEBUG_MESSAGE) != 0;
}
-/**
+/*
* _g_dbus_initialize:
*
* Does various one-time init things such as
diff --git a/gio/gdbusproxy.c b/gio/gdbusproxy.c
index 89aced9..204aa74 100644
--- a/gio/gdbusproxy.c
+++ b/gio/gdbusproxy.c
@@ -240,6 +240,8 @@ g_dbus_proxy_class_init (GDBusProxyClass *klass)
* type signature of the message isn't what's expected, the given
* #GError is set. Signals that have a type signature mismatch are
* simply dropped.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_G_INTERFACE_INFO,
@@ -257,6 +259,8 @@ g_dbus_proxy_class_init (GDBusProxyClass *klass)
* GDBusProxy:g-connection:
*
* The #GDBusConnection the proxy is for.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_G_CONNECTION,
@@ -275,6 +279,8 @@ g_dbus_proxy_class_init (GDBusProxyClass *klass)
* GDBusProxy:g-flags:
*
* Flags from the #GDBusProxyFlags enumeration.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_G_FLAGS,
@@ -294,6 +300,8 @@ g_dbus_proxy_class_init (GDBusProxyClass *klass)
* GDBusProxy:g-unique-bus-name:
*
* The unique bus name the proxy is for.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_G_UNIQUE_BUS_NAME,
@@ -312,6 +320,8 @@ g_dbus_proxy_class_init (GDBusProxyClass *klass)
* GDBusProxy:g-object-path:
*
* The object path the proxy is for.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_G_OBJECT_PATH,
@@ -330,6 +340,8 @@ g_dbus_proxy_class_init (GDBusProxyClass *klass)
* GDBusProxy:g-interface-name:
*
* The D-Bus interface name the proxy is for.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_G_INTERFACE_NAME,
@@ -355,6 +367,8 @@ g_dbus_proxy_class_init (GDBusProxyClass *klass)
* remote method invocations on the proxy. If this property is -1,
* the default timeout (typically 25 seconds) is used. If set to
* %G_MAXINT, then no timeout is used.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_G_DEFAULT_TIMEOUT,
@@ -378,6 +392,8 @@ g_dbus_proxy_class_init (GDBusProxyClass *klass)
*
* Emitted when one or more D-Bus properties on @proxy changes. The cached properties
* are already replaced when this signal fires.
+ *
+ * Since: 2.26
*/
signals[PROPERTIES_CHANGED_SIGNAL] = g_signal_new ("g-properties-changed",
G_TYPE_DBUS_PROXY,
@@ -398,7 +414,9 @@ g_dbus_proxy_class_init (GDBusProxyClass *klass)
* @parameters: A #GVariant tuple with parameters for the signal.
*
* Emitted when a signal from the remote object and interface that @proxy is for, has been received.
- **/
+ *
+ * Since: 2.26
+ */
signals[SIGNAL_SIGNAL] = g_signal_new ("g-signal",
G_TYPE_DBUS_PROXY,
G_SIGNAL_RUN_LAST,
@@ -433,6 +451,8 @@ g_dbus_proxy_init (GDBusProxy *proxy)
*
* Returns: A %NULL-terminated array of strings or %NULL if @error is set. Free with
* g_strfreev().
+ *
+ * Since: 2.26
*/
gchar **
g_dbus_proxy_get_cached_property_names (GDBusProxy *proxy,
@@ -491,6 +511,8 @@ g_dbus_proxy_get_cached_property_names (GDBusProxy *proxy,
*
* Returns: A reference to the #GVariant instance that holds the value for @property_name or
* %NULL if @error is set. Free the reference with g_variant_unref().
+ *
+ * Since: 2.26
*/
GVariant *
g_dbus_proxy_get_cached_property (GDBusProxy *proxy,
@@ -903,7 +925,9 @@ async_initable_iface_init (GAsyncInitableIface *async_initable_iface)
* g_dbus_proxy_new_finish() to get the result.
*
* See g_dbus_proxy_new_sync() and for a synchronous version of this constructor.
- **/
+ *
+ * Since: 2.26
+ */
void
g_dbus_proxy_new (GDBusConnection *connection,
GType object_type,
@@ -945,7 +969,9 @@ g_dbus_proxy_new (GDBusConnection *connection,
* Finishes creating a #GDBusProxy.
*
* Returns: A #GDBusProxy or %NULL if @error is set. Free with g_object_unref().
- **/
+ *
+ * Since: 2.26
+ */
GDBusProxy *
g_dbus_proxy_new_finish (GAsyncResult *res,
GError **error)
@@ -994,7 +1020,9 @@ g_dbus_proxy_new_finish (GAsyncResult *res,
* and g_dbus_proxy_new_finish() for the asynchronous version.
*
* Returns: A #GDBusProxy or %NULL if error is set. Free with g_object_unref().
- **/
+ *
+ * Since: 2.26
+ */
GDBusProxy *
g_dbus_proxy_new_sync (GDBusConnection *connection,
GType object_type,
@@ -1040,7 +1068,9 @@ g_dbus_proxy_new_sync (GDBusConnection *connection,
* Gets the connection @proxy is for.
*
* Returns: A #GDBusConnection owned by @proxy. Do not free.
- **/
+ *
+ * Since: 2.26
+ */
GDBusConnection *
g_dbus_proxy_get_connection (GDBusProxy *proxy)
{
@@ -1055,7 +1085,9 @@ g_dbus_proxy_get_connection (GDBusProxy *proxy)
* Gets the flags that @proxy was constructed with.
*
* Returns: Flags from the #GDBusProxyFlags enumeration.
- **/
+ *
+ * Since: 2.26
+ */
GDBusProxyFlags
g_dbus_proxy_get_flags (GDBusProxy *proxy)
{
@@ -1070,7 +1102,9 @@ g_dbus_proxy_get_flags (GDBusProxy *proxy)
* Gets the unique bus name @proxy is for.
*
* Returns: A string owned by @proxy. Do not free.
- **/
+ *
+ * Since: 2.26
+ */
const gchar *
g_dbus_proxy_get_unique_bus_name (GDBusProxy *proxy)
{
@@ -1085,7 +1119,9 @@ g_dbus_proxy_get_unique_bus_name (GDBusProxy *proxy)
* Gets the object path @proxy is for.
*
* Returns: A string owned by @proxy. Do not free.
- **/
+ *
+ * Since: 2.26
+ */
const gchar *
g_dbus_proxy_get_object_path (GDBusProxy *proxy)
{
@@ -1100,7 +1136,9 @@ g_dbus_proxy_get_object_path (GDBusProxy *proxy)
* Gets the D-Bus interface name @proxy is for.
*
* Returns: A string owned by @proxy. Do not free.
- **/
+ *
+ * Since: 2.26
+ */
const gchar *
g_dbus_proxy_get_interface_name (GDBusProxy *proxy)
{
@@ -1119,6 +1157,8 @@ g_dbus_proxy_get_interface_name (GDBusProxy *proxy)
* See the #GDBusProxy:g-default-timeout property for more details.
*
* Returns: Timeout to use for @proxy.
+ *
+ * Since: 2.26
*/
gint
g_dbus_proxy_get_default_timeout (GDBusProxy *proxy)
@@ -1137,6 +1177,8 @@ g_dbus_proxy_get_default_timeout (GDBusProxy *proxy)
* g_dbus_proxy_invoke_method_sync() functions.
*
* See the #GDBusProxy:g-default-timeout property for more details.
+ *
+ * Since: 2.26
*/
void
g_dbus_proxy_set_default_timeout (GDBusProxy *proxy,
@@ -1164,6 +1206,8 @@ g_dbus_proxy_set_default_timeout (GDBusProxy *proxy,
*
* Returns: A #GDBusInterfaceInfo or %NULL. Do not unref the returned
* object, it is owned by @proxy.
+ *
+ * Since: 2.26
*/
GDBusInterfaceInfo *
g_dbus_proxy_get_interface_info (GDBusProxy *proxy)
@@ -1184,6 +1228,8 @@ g_dbus_proxy_get_interface_info (GDBusProxy *proxy)
* dropped.
*
* See the #GDBusProxy:g-interface-info property for more details.
+ *
+ * Since: 2.26
*/
void
g_dbus_proxy_set_interface_info (GDBusProxy *proxy,
@@ -1346,6 +1392,8 @@ validate_method_return (const char *method_name,
* g_dbus_proxy_invoke_method_finish() to get the result of the operation.
* See g_dbus_proxy_invoke_method_sync() for the
* synchronous version of this method.
+ *
+ * Since: 2.26
*/
void
g_dbus_proxy_invoke_method (GDBusProxy *proxy,
@@ -1409,6 +1457,8 @@ g_dbus_proxy_invoke_method (GDBusProxy *proxy,
*
* Returns: %NULL if @error is set. Otherwise a #GVariant tuple with
* return values. Free with g_variant_unref().
+ *
+ * Since: 2.26
*/
GVariant *
g_dbus_proxy_invoke_method_finish (GDBusProxy *proxy,
@@ -1478,6 +1528,8 @@ g_dbus_proxy_invoke_method_finish (GDBusProxy *proxy,
*
* Returns: %NULL if @error is set. Otherwise a #GVariant tuple with
* return values. Free with g_variant_unref().
+ *
+ * Since: 2.26
*/
GVariant *
g_dbus_proxy_invoke_method_sync (GDBusProxy *proxy,
diff --git a/gio/gdbusproxy.h b/gio/gdbusproxy.h
index 1bc9902..560d106 100644
--- a/gio/gdbusproxy.h
+++ b/gio/gdbusproxy.h
@@ -43,6 +43,8 @@ typedef struct _GDBusProxyPrivate GDBusProxyPrivate;
*
* The #GDBusProxy structure contains only private data and
* should only be accessed using the provided API.
+ *
+ * Since: 2.26
*/
struct _GDBusProxy
{
@@ -57,6 +59,8 @@ struct _GDBusProxy
* @g_signal: Signal class handler for the #GDBusProxy::g-signal signal.
*
* Class structure for #GDBusProxy.
+ *
+ * Since: 2.26
*/
struct _GDBusProxyClass
{
diff --git a/gio/gdbusproxywatching.c b/gio/gdbusproxywatching.c
index 4025e1f..9ac7da8 100644
--- a/gio/gdbusproxywatching.c
+++ b/gio/gdbusproxywatching.c
@@ -298,7 +298,9 @@ on_name_vanished (GDBusConnection *connection,
*
* Returns: An identifier (never 0) that can be used with
* g_bus_unwatch_proxy() to stop watching the remote object.
- **/
+ *
+ * Since: 2.26
+ */
guint
g_bus_watch_proxy (GBusType bus_type,
const gchar *name,
@@ -364,6 +366,8 @@ g_bus_watch_proxy (GBusType bus_type,
* @watcher_id: An identifier obtained from g_bus_watch_proxy()
*
* Stops watching proxy.
+ *
+ * Since: 2.26
*/
void
g_bus_unwatch_proxy (guint watcher_id)
diff --git a/gio/gdbusproxywatching.h b/gio/gdbusproxywatching.h
index 3544269..119311b 100644
--- a/gio/gdbusproxywatching.h
+++ b/gio/gdbusproxywatching.h
@@ -38,6 +38,8 @@ G_BEGIN_DECLS
* Invoked when the proxy being watched is ready for use - the passed
* @proxy object is valid until the #GBusProxyVanishedCallback
* callback is invoked.
+ *
+ * Since: 2.26
*/
typedef void (*GBusProxyAppearedCallback) (GDBusConnection *connection,
const gchar *name,
@@ -54,6 +56,8 @@ typedef void (*GBusProxyAppearedCallback) (GDBusConnection *connection,
* Invoked when the proxy being watched has vanished. The #GDBusProxy
* object passed in the #GBusProxyAppearedCallback callback is no
* longer valid.
+ *
+ * Since: 2.26
*/
typedef void (*GBusProxyVanishedCallback) (GDBusConnection *connection,
const gchar *name,
diff --git a/gio/gdbusserver.c b/gio/gdbusserver.c
index 99e7701..bee5c90 100644
--- a/gio/gdbusserver.c
+++ b/gio/gdbusserver.c
@@ -218,6 +218,8 @@ g_dbus_server_class_init (GDBusServerClass *klass)
* GDBusServer:flags:
*
* Flags from the #GDBusServerFlags enumeration.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_FLAGS,
@@ -237,6 +239,8 @@ g_dbus_server_class_init (GDBusServerClass *klass)
* GDBusServer:guid:
*
* The guid of the server.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_GUID,
@@ -255,6 +259,8 @@ g_dbus_server_class_init (GDBusServerClass *klass)
* GDBusServer:address:
*
* The D-Bus address to listen on.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_ADDRESS,
@@ -273,6 +279,8 @@ g_dbus_server_class_init (GDBusServerClass *klass)
* GDBusServer:client-address:
*
* The D-Bus address that clients can use.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_CLIENT_ADDRESS,
@@ -289,6 +297,8 @@ g_dbus_server_class_init (GDBusServerClass *klass)
* GDBusServer:active:
*
* Whether the server is currently active.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_ACTIVE,
@@ -305,6 +315,8 @@ g_dbus_server_class_init (GDBusServerClass *klass)
* GDBusServer:authentication-observer:
*
* A #GDBusAuthObserver object to assist in the authentication process or %NULL.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_AUTHENTICATION_OBSERVER,
@@ -338,6 +350,8 @@ g_dbus_server_class_init (GDBusServerClass *klass)
* 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.
+ *
+ * Since: 2.26
*/
_signals[NEW_CONNECTION_SIGNAL] = g_signal_new ("new-connection",
G_TYPE_DBUS_SERVER,
@@ -399,6 +413,8 @@ on_run (GSocketService *service,
*
* Returns: A #GDBusServer or %NULL if @error is set. Free with
* g_object_unref().
+ *
+ * Since: 2.26
*/
GDBusServer *
g_dbus_server_new_sync (const gchar *address,
@@ -444,6 +460,8 @@ g_dbus_server_new_sync (const gchar *address,
*
* Returns: A D-Bus address string. Do not free, the string is owned
* by @server.
+ *
+ * Since: 2.26
*/
const gchar *
g_dbus_server_get_client_address (GDBusServer *server)
@@ -459,6 +477,8 @@ g_dbus_server_get_client_address (GDBusServer *server)
* Gets the GUID for @server.
*
* Returns: A D-Bus GUID. Do not free this string, it is owned by @server.
+ *
+ * Since: 2.26
*/
const gchar *
g_dbus_server_get_guid (GDBusServer *server)
@@ -474,6 +494,8 @@ g_dbus_server_get_guid (GDBusServer *server)
* Gets the flags for @server.
*
* Returns: A set of flags from the #GDBusServerFlags enumeration.
+ *
+ * Since: 2.26
*/
GDBusServerFlags
g_dbus_server_get_flags (GDBusServer *server)
@@ -489,6 +511,8 @@ g_dbus_server_get_flags (GDBusServer *server)
* Gets whether @server is active.
*
* Returns: %TRUE if server is active, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_server_is_active (GDBusServer *server)
@@ -502,6 +526,8 @@ g_dbus_server_is_active (GDBusServer *server)
* @server: A #GDBusServer.
*
* Starts @server.
+ *
+ * Since: 2.26
*/
void
g_dbus_server_start (GDBusServer *server)
@@ -521,6 +547,8 @@ g_dbus_server_start (GDBusServer *server)
* @server: A #GDBusServer.
*
* Stops @server.
+ *
+ * Since: 2.26
*/
void
g_dbus_server_stop (GDBusServer *server)
diff --git a/gio/gdbusserver.h b/gio/gdbusserver.h
index 4043854..dd1333f 100644
--- a/gio/gdbusserver.h
+++ b/gio/gdbusserver.h
@@ -42,6 +42,8 @@ typedef struct _GDBusServerPrivate GDBusServerPrivate;
*
* The #GDBusServer structure contains only private data and
* should only be accessed using the provided API.
+ *
+ * Since: 2.26
*/
struct _GDBusServer
{
@@ -55,6 +57,8 @@ struct _GDBusServer
* @new_connection: Signal class handler for the #GDBusServer::new-connection signal.
*
* Class structure for #GDBusServer.
+ *
+ * Since: 2.26
*/
struct _GDBusServerClass
{
diff --git a/gio/gdbusutils.c b/gio/gdbusutils.c
index 0052916..08770c6 100644
--- a/gio/gdbusutils.c
+++ b/gio/gdbusutils.c
@@ -116,6 +116,8 @@ is_valid_name (const gchar *start,
* Checks if @string is a valid D-Bus bus name (either unique or well-known).
*
* Returns: %TRUE if valid, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_is_name (const gchar *string)
@@ -164,6 +166,8 @@ g_dbus_is_name (const gchar *string)
* Checks if @string is a valid D-Bus unique bus name.
*
* Returns: %TRUE if valid, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_is_unique_name (const gchar *string)
@@ -198,6 +202,8 @@ g_dbus_is_unique_name (const gchar *string)
* Checks if @string is a valid D-Bus member (e.g. signal or method) name.
*
* Returns: %TRUE if valid, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_is_member_name (const gchar *string)
@@ -233,6 +239,8 @@ g_dbus_is_member_name (const gchar *string)
* Checks if @string is a valid D-Bus interface name.
*
* Returns: %TRUE if valid, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_is_interface_name (const gchar *string)
@@ -282,6 +290,8 @@ g_dbus_is_interface_name (const gchar *string)
* GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).
*
* Returns: A valid D-Bus GUID. Free with g_free().
+ *
+ * Since: 2.26
*/
gchar *
g_dbus_generate_guid (void)
@@ -317,6 +327,8 @@ g_dbus_generate_guid (void)
* GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).
*
* Returns: %TRUE if @string is a guid, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_is_guid (const gchar *string)
@@ -344,13 +356,14 @@ g_dbus_is_guid (const gchar *string)
/* ---------------------------------------------------------------------------------------------------- */
-
/**
* g_dbus_is_activated:
*
* Determine if the process has been activated by a message bus.
*
* Returns: %TRUE if this process has been started by a message bus, %FALSE otherwise.
+ *
+ * Since: 2.26
*/
gboolean
g_dbus_is_activated (void)
diff --git a/gio/gioenums.h b/gio/gioenums.h
index c1d2e9f..f7b222f 100644
--- a/gio/gioenums.h
+++ b/gio/gioenums.h
@@ -746,6 +746,8 @@ typedef enum {
* @G_BUS_TYPE_STARTER: Connect to the bus that activated the program.
*
* An enumeration to specify the type of a #GDBusConnection.
+ *
+ * Since: 2.26
*/
typedef enum
{
@@ -763,6 +765,8 @@ typedef enum
* specified #G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT, then take the name from the other connection.
*
* Flags used in g_bus_own_name().
+ *
+ * Since: 2.26
*/
typedef enum
{
@@ -779,6 +783,8 @@ typedef enum
* name.
*
* Flags used in g_bus_watch_name().
+ *
+ * Since: 2.26
*/
typedef enum
{
@@ -793,6 +799,8 @@ typedef enum
* @G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS: Don't connect to signals on the remote object.
*
* Flags used when constructing an instance of a #GDBusProxy derived class.
+ *
+ * Since: 2.26
*/
typedef enum
{
@@ -897,6 +905,8 @@ typedef enum
* There's already an object with the requested object path.
*
* Error codes for the %G_DBUS_ERROR error domain.
+ *
+ * Since: 2.26
*/
typedef enum
{
@@ -943,7 +953,7 @@ typedef enum
G_DBUS_ERROR_ADT_AUDIT_DATA_UNKNOWN, /* org.freedesktop.DBus.Error.AdtAuditDataUnknown */
G_DBUS_ERROR_OBJECT_PATH_IN_USE, /* org.freedesktop.DBus.Error.ObjectPathInUse */
} GDBusError;
-/* TODO: remember to update g_dbus_error_quark() in gdbuserror.c if you extend this enumeration */
+/* Remember to update g_dbus_error_quark() in gdbuserror.c if you extend this enumeration */
/**
* GDBusConnectionFlags:
@@ -957,6 +967,8 @@ typedef enum
* message bus. This means that the Hello() method will be invoked as part of the connection setup.
*
* Flags used when creating a new #GDBusConnection.
+ *
+ * Since: 2.26
*/
typedef enum {
G_DBUS_CONNECTION_FLAGS_NONE = 0,
@@ -973,6 +985,8 @@ typedef enum {
* supports exchanging UNIX file descriptors with the remote peer.
*
* Capabilities negotiated with the remote peer.
+ *
+ * Since: 2.26
*/
typedef enum {
G_DBUS_CAPABILITY_FLAGS_NONE = 0,
@@ -987,6 +1001,8 @@ typedef enum {
* invocation.
*
* Flags used in g_dbus_connection_invoke_method() and similar APIs.
+ *
+ * Since: 2.26
*/
typedef enum {
G_DBUS_INVOKE_METHOD_FLAGS_NONE = 0,
@@ -1002,6 +1018,8 @@ typedef enum {
* @G_DBUS_MESSAGE_TYPE_SIGNAL: Signal emission.
*
* Message types used in #GDBusMessage.
+ *
+ * Since: 2.26
*/
typedef enum {
G_DBUS_MESSAGE_TYPE_INVALID,
@@ -1019,6 +1037,8 @@ typedef enum {
* owner for the destination name in response to this message.
*
* Message flags used in #GDBusMessage.
+ *
+ * Since: 2.26
*/
typedef enum {
G_DBUS_MESSAGE_FLAGS_NONE = 0,
@@ -1040,6 +1060,8 @@ typedef enum {
* @G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS: The number of UNIX file descriptors that accompany the message.
*
* Header fields used in #GDBusMessage.
+ *
+ * Since: 2.26
*/
typedef enum {
G_DBUS_MESSAGE_HEADER_FIELD_INVALID,
@@ -1061,6 +1083,8 @@ typedef enum {
* @G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE: Property is writable.
*
* Flags describing the access control of a D-Bus property.
+ *
+ * Since: 2.26
*/
typedef enum
{
@@ -1077,6 +1101,8 @@ typedef enum
* to dynamically spawn objects in the subtree.
*
* Flags passed to g_dbus_connection_register_subtree().
+ *
+ * Since: 2.26
*/
typedef enum
{
@@ -1094,6 +1120,8 @@ typedef enum
* authentication method.
*
* Flags used when creating a #GDBusServer.
+ *
+ * Since: 2.26
*/
typedef enum
{
diff --git a/gio/gunixcredentialsmessage.c b/gio/gunixcredentialsmessage.c
index 6af8c29..156a124 100644
--- a/gio/gunixcredentialsmessage.c
+++ b/gio/gunixcredentialsmessage.c
@@ -252,6 +252,8 @@ g_unix_credentials_message_class_init (GUnixCredentialsMessageClass *class)
* GUnixCredentialsMessage:credentials:
*
* The credentials stored in the message.
+ *
+ * Since: 2.26
*/
g_object_class_install_property (gobject_class,
PROP_CREDENTIALS,
@@ -331,6 +333,8 @@ g_unix_credentials_message_new_with_credentials (GCredentials *credentials)
* Gets the credentials stored in @message.
*
* Returns: A #GCredentials instance. Do not free, it is owned by @message.
+ *
+ * Since: 2.26
*/
GCredentials *
g_unix_credentials_message_get_credentials (GUnixCredentialsMessage *message)
diff --git a/gio/gunixcredentialsmessage.h b/gio/gunixcredentialsmessage.h
index 1db0146..7f444d5 100644
--- a/gio/gunixcredentialsmessage.h
+++ b/gio/gunixcredentialsmessage.h
@@ -39,6 +39,13 @@ G_BEGIN_DECLS
typedef struct _GUnixCredentialsMessagePrivate GUnixCredentialsMessagePrivate;
typedef struct _GUnixCredentialsMessageClass GUnixCredentialsMessageClass;
+/**
+ * GUnixCredentialsMessageClass:
+ *
+ * Class structure for #GUnixCredentialsMessage.
+ *
+ * Since: 2.26
+ */
struct _GUnixCredentialsMessageClass
{
GSocketControlMessageClass parent_class;
@@ -50,6 +57,14 @@ struct _GUnixCredentialsMessageClass
void (*_g_reserved2) (void);
};
+/**
+ * GUnixCredentialsMessage:
+ *
+ * The #GUnixCredentialsMessage structure contains only private data
+ * and should only be accessed using the provided API.
+ *
+ * Since: 2.26
+ */
struct _GUnixCredentialsMessage
{
GSocketControlMessage parent_instance;
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
