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 <pwithnall@gnome.org>

Helps: #3037
This commit is contained in:
Philip Withnall 2023-11-13 23:43:20 +00:00
parent 84bed2f6ae
commit c7e21d2f59
4 changed files with 25 additions and 14 deletions

View File

@ -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]

View File

@ -44,6 +44,7 @@ content_files = [
"file-attributes.md", "file-attributes.md",
"tls-overview.md", "tls-overview.md",
"dbus-error.md", "dbus-error.md",
"dbus-introspection.md",
"migrating-gdbus.md", "migrating-gdbus.md",
"migrating-gconf.md", "migrating-gconf.md",

View File

@ -226,6 +226,7 @@ endif
# gi-docgen version # gi-docgen version
expand_content_files = [ expand_content_files = [
'dbus-error.md', 'dbus-error.md',
'dbus-introspection.md',
'file-attributes.md', 'file-attributes.md',
'migrating-gconf.md', 'migrating-gconf.md',
'migrating-gdbus.md', 'migrating-gdbus.md',

View File

@ -29,20 +29,6 @@
#include "glibintl.h" #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) \ #define _MY_DEFINE_BOXED_TYPE(TypeName, type_name) \