diff options
author | Philip Withnall <pwithnall@endlessos.org> | 2021-06-10 12:36:25 +0100 |
---|---|---|
committer | Philip Withnall <pwithnall@endlessos.org> | 2021-06-10 12:36:25 +0100 |
commit | c794261a400278db993842411e764ba435abcc34 (patch) | |
tree | 9c29d5e240d3f2eab93623e3c1e07ac085d1fe9d /gio/gdbusutils.c | |
parent | 71edc3ffe11b27a708500389dbfa3ba3f5aee0ba (diff) | |
download | glib-c794261a400278db993842411e764ba435abcc34.tar.gz |
docs: Expand documentation about D-Bus GUIDs
Clarify that the terms ‘GUID’ and ‘UUID’ are used interchangeably in the
context of D-Bus, and that neither of them are an RFC 4122 UUID.
Signed-off-by: Philip Withnall <pwithnall@endlessos.org>
Diffstat (limited to 'gio/gdbusutils.c')
-rw-r--r-- | gio/gdbusutils.c | 14 |
1 files changed, 10 insertions, 4 deletions
diff --git a/gio/gdbusutils.c b/gio/gdbusutils.c index bb34e2d58..4c6890f79 100644 --- a/gio/gdbusutils.c +++ b/gio/gdbusutils.c @@ -280,8 +280,14 @@ g_dbus_is_interface_name (const gchar *string) * Generate a D-Bus GUID that can be used with * e.g. g_dbus_connection_new(). * - * See the D-Bus specification regarding what strings are valid D-Bus - * GUID (for example, D-Bus GUIDs are not RFC-4122 compliant). + * See the + * [D-Bus specification](https://dbus.freedesktop.org/doc/dbus-specification.html#uuids) + * regarding what strings are valid D-Bus GUIDs. The specification refers to + * these as ‘UUIDs’ whereas GLib (for historical reasons) refers to them as + * ‘GUIDs’. The terms are interchangeable. + * + * Note that D-Bus GUIDs do not follow + * [RFC 4122](https://datatracker.ietf.org/doc/html/rfc4122). * * Returns: A valid D-Bus GUID. Free with g_free(). * @@ -317,8 +323,8 @@ g_dbus_generate_guid (void) * * Checks if @string is a D-Bus GUID. * - * See the D-Bus specification regarding what strings are valid D-Bus - * GUID (for example, D-Bus GUIDs are not RFC-4122 compliant). + * See the documentation for g_dbus_generate_guid() for more information about + * the format of a GUID. * * Returns: %TRUE if @string is a guid, %FALSE otherwise. * |