From c7e21d2f5953809c8789ebb567238f2eb7d44157 Mon Sep 17 00:00:00 2001 From: Philip Withnall Date: Mon, 13 Nov 2023 23:43:20 +0000 Subject: [PATCH] docs: Move the GDBusIntrospection SECTION Move it to a separate content page as there is no `GDBusIntrospection` type to hang the rest of the documentation off. Signed-off-by: Philip Withnall Helps: #3037 --- docs/reference/gio/dbus-introspection.md | 23 +++++++++++++++++++++++ docs/reference/gio/gio.toml.in | 1 + docs/reference/gio/meson.build | 1 + gio/gdbusintrospection.c | 14 -------------- 4 files changed, 25 insertions(+), 14 deletions(-) create mode 100644 docs/reference/gio/dbus-introspection.md diff --git a/docs/reference/gio/dbus-introspection.md b/docs/reference/gio/dbus-introspection.md new file mode 100644 index 000000000..2eacc2666 --- /dev/null +++ b/docs/reference/gio/dbus-introspection.md @@ -0,0 +1,23 @@ +Title: D-Bus Introspection Data +SPDX-License-Identifier: LGPL-2.1-or-later +SPDX-FileCopyrightText: 2010 David Zeuthen +SPDX-FileCopyrightText: 2010 Matthias Clasen + +# D-Bus Introspection Data + +Various data structures and convenience routines to parse and +generate D-Bus introspection XML. Introspection information is +used when registering objects with [method@Gio.DBusConnection.register_object]. + +The format of D-Bus introspection XML is specified in the +[D-Bus specification](http://dbus.freedesktop.org/doc/dbus-specification.html#introspection-format). + +The main introspection data structures are: + * [type@Gio.DBusNodeInfo] + * [type@Gio.DBusInterfaceInfo] + * [type@Gio.DBusPropertyInfo] + * [type@Gio.DBusMethodInfo] + * [type@Gio.DBusSignalInfo] + * [type@Gio.DBusArgInfo] + * [type@Gio.DBusAnnotationInfo] + diff --git a/docs/reference/gio/gio.toml.in b/docs/reference/gio/gio.toml.in index e72ed32bb..fe2906f6a 100644 --- a/docs/reference/gio/gio.toml.in +++ b/docs/reference/gio/gio.toml.in @@ -44,6 +44,7 @@ content_files = [ "file-attributes.md", "tls-overview.md", "dbus-error.md", + "dbus-introspection.md", "migrating-gdbus.md", "migrating-gconf.md", diff --git a/docs/reference/gio/meson.build b/docs/reference/gio/meson.build index ad22dd6eb..731904be1 100644 --- a/docs/reference/gio/meson.build +++ b/docs/reference/gio/meson.build @@ -226,6 +226,7 @@ endif # gi-docgen version expand_content_files = [ 'dbus-error.md', + 'dbus-introspection.md', 'file-attributes.md', 'migrating-gconf.md', 'migrating-gdbus.md', diff --git a/gio/gdbusintrospection.c b/gio/gdbusintrospection.c index c7be334ce..7ee3e32b6 100644 --- a/gio/gdbusintrospection.c +++ b/gio/gdbusintrospection.c @@ -29,20 +29,6 @@ #include "glibintl.h" -/** - * SECTION:gdbusintrospection - * @title: D-Bus Introspection Data - * @short_description: Node and interface description data structures - * @include: gio/gio.h - * - * Various data structures and convenience routines to parse and - * generate D-Bus introspection XML. Introspection information is - * used when registering objects with g_dbus_connection_register_object(). - * - * The format of D-Bus introspection XML is specified in the - * [D-Bus specification](http://dbus.freedesktop.org/doc/dbus-specification.html#introspection-format) - */ - /* ---------------------------------------------------------------------------------------------------- */ #define _MY_DEFINE_BOXED_TYPE(TypeName, type_name) \