From beb56279ef92fbb114b31b22ac33effc4471bad4 Mon Sep 17 00:00:00 2001 From: Philip Withnall Date: Mon, 13 Nov 2023 23:48:44 +0000 Subject: [PATCH] docs: Move the GDBus name owning SECTION MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Move it to a separate content page as there’s no struct to hang the docs off. Signed-off-by: Philip Withnall Helps: #3037 --- docs/reference/gio/dbus-name-owning.md | 14 ++++++++++++++ docs/reference/gio/gio.toml.in | 1 + docs/reference/gio/meson.build | 1 + gio/gdbusnameowning.c | 12 ------------ 4 files changed, 16 insertions(+), 12 deletions(-) create mode 100644 docs/reference/gio/dbus-name-owning.md diff --git a/docs/reference/gio/dbus-name-owning.md b/docs/reference/gio/dbus-name-owning.md new file mode 100644 index 000000000..a8daaafa3 --- /dev/null +++ b/docs/reference/gio/dbus-name-owning.md @@ -0,0 +1,14 @@ +Title: D-Bus Name Owning +SPDX-License-Identifier: LGPL-2.1-or-later +SPDX-FileCopyrightText: 2010 David Zeuthen + +# D-Bus Name Owning + +Convenience API for owning bus names. + +A simple example for owning a name can be found in +[`gdbus-example-own-name.c`](https://gitlab.gnome.org/GNOME/glib/-/blob/HEAD/gio/tests/gdbus-example-own-name.c). + +The main API for owning names is: + * [func@Gio.bus_own_name] + * [func@Gio.bus_unown_name] diff --git a/docs/reference/gio/gio.toml.in b/docs/reference/gio/gio.toml.in index fe2906f6a..497b57b1b 100644 --- a/docs/reference/gio/gio.toml.in +++ b/docs/reference/gio/gio.toml.in @@ -45,6 +45,7 @@ content_files = [ "tls-overview.md", "dbus-error.md", "dbus-introspection.md", + "dbus-name-owning.md", "migrating-gdbus.md", "migrating-gconf.md", diff --git a/docs/reference/gio/meson.build b/docs/reference/gio/meson.build index 731904be1..af7abbd05 100644 --- a/docs/reference/gio/meson.build +++ b/docs/reference/gio/meson.build @@ -227,6 +227,7 @@ endif expand_content_files = [ 'dbus-error.md', 'dbus-introspection.md', + 'dbus-name-owning.md', 'file-attributes.md', 'migrating-gconf.md', 'migrating-gdbus.md', diff --git a/gio/gdbusnameowning.c b/gio/gdbusnameowning.c index 289ea036a..12b922c79 100644 --- a/gio/gdbusnameowning.c +++ b/gio/gdbusnameowning.c @@ -32,18 +32,6 @@ #include "glibintl.h" -/** - * SECTION:gdbusnameowning - * @title: Owning Bus Names - * @short_description: Simple API for owning bus names - * @include: gio/gio.h - * - * Convenience API for owning bus names. - * - * A simple example for owning a name can be found in - * [gdbus-example-own-name.c](https://gitlab.gnome.org/GNOME/glib/-/blob/HEAD/gio/tests/gdbus-example-own-name.c) - */ - G_LOCK_DEFINE_STATIC (lock); /* ---------------------------------------------------------------------------------------------------- */