From 15ef0ef6fbba7827453b7973e62b6c1853576601 Mon Sep 17 00:00:00 2001 From: Havoc Pennington Date: Fri, 20 Oct 2006 03:05:00 +0000 Subject: 2006-10-19 Havoc Pennington * Fix a pile of Doxygen warnings and missing docs --- dbus/dbus-internals.c | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) (limited to 'dbus/dbus-internals.c') diff --git a/dbus/dbus-internals.c b/dbus/dbus-internals.c index 2233fc68..5268ebdf 100644 --- a/dbus/dbus-internals.c +++ b/dbus/dbus-internals.c @@ -28,8 +28,12 @@ #include #include +/* the blurb for this is "D-Bus secret" so it comes after "D-Bus low-level" + * which is the blurb for the DBus group, which makes Doxygen show + * the public API first on the index page. Yay for lame hacks. + */ /** - * @defgroup DBusInternals D-Bus internal implementation details + * @defgroup DBusInternals D-Bus secret internal implementation details * @brief Documentation useful when developing or debugging D-Bus itself. * */ @@ -288,6 +292,7 @@ _dbus_warn_check_failed(const char *format, static dbus_bool_t verbose_initted = FALSE; static dbus_bool_t verbose = TRUE; +/** Whether to show the current thread in verbose messages */ #define PTHREAD_IN_VERBOSE 0 #if PTHREAD_IN_VERBOSE #include @@ -304,6 +309,11 @@ _dbus_verbose_init (void) } } +/** + * Implementation of dbus_is_verbose() macro if built with verbose logging + * enabled. + * @returns whether verbose logging is active. + */ dbus_bool_t _dbus_is_verbose_real (void) { -- cgit