docs: Move the dbusutils SECTION

Move it to a separate page as there’s no struct to hang the
documentation off.

Signed-off-by: Philip Withnall <pwithnall@gnome.org>

Helps: #3037

docs/reference/gio/dbus-utils.md

@@ -0,0 +1,28 @@
+Title: D-Bus Utilities
+SPDX-License-Identifier: LGPL-2.1-or-later
+SPDX-FileCopyrightText: 2010 David Zeuthen
+
+# D-Bus Utilities
+
+Various utility routines related to D-Bus.
+
+GUID support:
+ * [func@Gio.dbus_is_guid]
+ * [func@Gio.dbus_generate_guid]
+
+Name validation:
+ * [func@Gio.dbus_is_name]
+ * [func@Gio.dbus_is_unique_name]
+ * [func@Gio.dbus_is_member_name]
+ * [func@Gio.dbus_is_interface_name]
+ * [func@Gio.dbus_is_error_name]
+
+Conversion between [type@GLib.Variant] and [type@GObject.Value]:
+ * [func@Gio.dbus_gvariant_to_gvalue]
+ * [func@Gio.dbus_gvalue_to_gvariant]
+
+Path escaping:
+ * [func@Gio.dbus_escape_object_path_bytestring]
+ * [func@Gio.dbus_escape_object_path]
+ * [func@Gio.dbus_unescape_object_path]
+

docs/reference/gio/gio.toml.in

@@ -47,6 +47,7 @@ content_files = [
   "dbus-introspection.md",
   "dbus-name-owning.md",
   "dbus-name-watching.md",
+  "dbus-utils.md",
 
   "migrating-gdbus.md",
   "migrating-gconf.md",

docs/reference/gio/meson.build

@@ -229,6 +229,7 @@ expand_content_files = [
   'dbus-introspection.md',
   'dbus-name-owning.md',
   'dbus-name-watching.md',
+  'dbus-utils.md',
   'file-attributes.md',
   'migrating-gconf.md',
   'migrating-gdbus.md',

gio/gdbusutils.c

@@ -29,15 +29,6 @@
 
 #include "glibintl.h"
 
-/**
- * SECTION:gdbusutils
- * @title: D-Bus Utilities
- * @short_description: Various utilities related to D-Bus
- * @include: gio/gio.h
- *
- * Various utility routines related to D-Bus.
- */
-
 static gboolean
 is_valid_bus_name_character (gint c,
                              gboolean allow_hyphen)