summaryrefslogtreecommitdiffstats
path: root/dbus/dbus-errors.c
diff options
context:
space:
mode:
authorSimon McVittie <simon.mcvittie@collabora.co.uk>2007-10-09 17:34:09 +0100
committerSimon McVittie <simon.mcvittie@collabora.co.uk>2007-10-11 10:35:25 +0100
commit262c02a9facebc8592fa60406d8971b1837725f5 (patch)
tree872cf23811677ae84a1d6a9ba22ac5e27d7d8fd5 /dbus/dbus-errors.c
parent559de12aac424aa726007abb5cf6a7ac12d39db4 (diff)
Add DBUS_ERROR_INITIALIZER macro
Diffstat (limited to 'dbus/dbus-errors.c')
-rw-r--r--dbus/dbus-errors.c24
1 files changed, 23 insertions, 1 deletions
diff --git a/dbus/dbus-errors.c b/dbus/dbus-errors.c
index d0a80b02..30bf6a1f 100644
--- a/dbus/dbus-errors.c
+++ b/dbus/dbus-errors.c
@@ -34,7 +34,29 @@
* @brief Error reporting internals
* @{
*/
-
+
+/**
+ * @def DBUS_ERROR_INITIALIZER
+ *
+ * Expands to a suitable initializer for a DBusError on the stack.
+ * Declaring a DBusError with:
+ *
+ * @code
+ * DBusError error = DBUS_ERROR_INITIALIZER;
+ *
+ * do_things_with (&error);
+ * @endcode
+ *
+ * is a more concise form of:
+ *
+ * @code
+ * DBusError error;
+ *
+ * dbus_error_init (&error);
+ * do_things_with (&error);
+ * @endcode
+ */
+
/**
* Internals of DBusError
*/