2003-01-28 Havoc Pennington <hp@pobox.com>

	* dbus/dbus-server-debug.c: Add doc section comments

	* dbus/dbus-transport-debug.c: add doc section comments

diff --git a/ChangeLog b/ChangeLog
index d592167..04709c6 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2003-01-28  Havoc Pennington  <hp@pobox.com>
+
+       * dbus/dbus-server-debug.c: Add doc section comments
+       
+       * dbus/dbus-transport-debug.c: add doc section comments
+       
 2003-01-28  Havoc Pennington  <hp@redhat.com>
 
        * dbus/dbus-string.c (_dbus_string_base64_decode): append bytes in

diff --git a/dbus/dbus-server-debug.c b/dbus/dbus-server-debug.c
index b2e8c00..b9305b7 100644 (file)
--- a/dbus/dbus-server-debug.c
+++ b/dbus/dbus-server-debug.c
@@ -29,6 +29,17 @@
 
 #ifdef DBUS_BUILD_TESTS
 
+/**
+ * @defgroup DBusServerDebug DBusServerDebug
+ * @ingroup  DBusInternals
+ * @brief In-process debug server used in unit tests.
+ *
+ * Types and functions related to DBusServerDebug.
+ * This is used for unit testing.
+ *
+ * @{
+ */
+
 #define DEFAULT_INTERVAL 10
 
 typedef struct DBusServerDebug DBusServerDebug;
@@ -44,6 +55,9 @@ struct DBusServerDebug
   char *name; /**< Server name. */
 };
 
+/* Not thread safe, but OK since we don't use
+ * threads in the bus
+ */
 static DBusHashTable *server_hash;
 
 static void
@@ -210,13 +224,14 @@ _dbus_server_debug_accept_transport (DBusServer     *server,
 
   if (!_dbus_server_add_timeout (server, timeout))
     {
-      _dbus_timeout_unref (timeout);
-      
+      _dbus_timeout_unref (timeout);      
       return FALSE;
     }
 
   return TRUE;
 }
 
+/** @} */
+
 #endif /* DBUS_BUILD_TESTS */
 

diff --git a/dbus/dbus-transport-debug.c b/dbus/dbus-transport-debug.c
index 7e92564..7a2250a 100644 (file)
--- a/dbus/dbus-transport-debug.c
+++ b/dbus/dbus-transport-debug.c
@@ -30,6 +30,16 @@
 
 #ifdef DBUS_BUILD_TESTS
 
+/**
+ * @defgroup DBusTransportDebug DBusTransportDebug
+ * @ingroup  DBusInternals
+ * @brief In-process debug transport used in unit tests.
+ *
+ * Types and functions related to DBusTransportDebug.
+ * This is used for unit testing.
+ *
+ * @{
+ */
 
 #define DEFAULT_INTERVAL 10
 
@@ -304,4 +314,6 @@ _dbus_transport_debug_client_new (const char     *server_name,
   return (DBusTransport *)debug_transport;
 }
 
+/** @} */
+
 #endif /* DBUS_BUILD_TESTS */