From 577ba25bbfcf9d496737908d2d5203faeee5bbfc Mon Sep 17 00:00:00 2001 From: Simon McVittie Date: Thu, 6 Sep 2007 18:36:29 +0000 Subject: Document gtypes.c 20070906183629-53eee-73aff929a324c2d861b6478873f6d2b883cfa043.gz --- telepathy-glib/gtypes.c | 14 ++++++++++++++ 1 file changed, 14 insertions(+) (limited to 'telepathy-glib/gtypes.c') diff --git a/telepathy-glib/gtypes.c b/telepathy-glib/gtypes.c index 95e634fa6..c40380956 100644 --- a/telepathy-glib/gtypes.c +++ b/telepathy-glib/gtypes.c @@ -21,6 +21,20 @@ #include +/** + * SECTION:gtypes + * @title: GType factory functions + * @short_description: Macros using caching factory functions to get + * dbus-glib specialized GTypes + * + * dbus-glib's built-in factory functions for specialized GTypes need to do + * a fair amount of parsing on their arguments, so these macros are provided + * to avoid that. Each macro expands to a call to a function which caches + * the GType, so it only ever has to call into dbus-glib once. + * + * tp_dbus_specialized_value_slice_new() is also provided. + */ + /** * tp_dbus_specialized_value_slice_new: * @type: A D-Bus specialized type (i.e. probably a specialized GValueArray -- cgit v1.2.1