From 5ebb5748c2a7587c734eeed9c66f2a1fc0635d09 Mon Sep 17 00:00:00 2001
From: Anders Carlsson <andersca@codefactory.se>
Date: Thu, 30 Jan 2003 20:49:11 +0000
Subject: 2003-01-30  Anders Carlsson  <andersca@codefactory.se>

	* dbus/Makefile.am:
	Add dbus-address.[ch]

	* dbus/dbus-address.c: (dbus_address_entry_free),
	(dbus_address_entries_free), (create_entry),
	(dbus_address_entry_get_method), (dbus_address_entry_get_value),
	(dbus_parse_address), (_dbus_address_test):
	* dbus/dbus-address.h:
	New files for dealing with address parsing.

	* dbus/dbus-connection.c:
	Document timeout functions.

	* dbus/dbus-message.c:
	Document dbus_message_new_from_message.

	* dbus/dbus-server-debug.c:
	Document.

	* dbus/dbus-server.c: (dbus_server_listen):
	Parse address and use correct server implementation.

	* dbus/dbus-string.c: (_dbus_string_find_to), (_dbus_string_test):
	* dbus/dbus-string.h:
	New function with test.

	* dbus/dbus-test.c: (dbus_internal_symbol_do_not_use_run_tests):
	* dbus/dbus-test.h:
	Add address tests.

	* dbus/dbus-transport-debug.c:
	Document.

	* dbus/dbus-transport.c: (_dbus_transport_open):
	Parse address and use correct transport implementation.
---
 dbus/dbus-server-debug.c | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

(limited to 'dbus/dbus-server-debug.c')

diff --git a/dbus/dbus-server-debug.c b/dbus/dbus-server-debug.c
index b9305b75..57d68066 100644
--- a/dbus/dbus-server-debug.c
+++ b/dbus/dbus-server-debug.c
@@ -40,8 +40,14 @@
  * @{
  */
 
+/**
+ * Default timeout interval when reading or writing.
+ */
 #define DEFAULT_INTERVAL 10
 
+/**
+ * Opaque object representing a debug server implementation.
+ */
 typedef struct DBusServerDebug DBusServerDebug;
 
 /**
@@ -83,6 +89,12 @@ static DBusServerVTable debug_vtable = {
   debug_disconnect
 };
 
+/**
+ * Looks up a server by its name.
+ *
+ * @param server_name the server name.
+ * @returns the server, or #NULL if none exists.
+ */
 DBusServer*
 _dbus_server_debug_lookup (const char *server_name)
 {
@@ -92,6 +104,13 @@ _dbus_server_debug_lookup (const char *server_name)
   return _dbus_hash_table_lookup_string (server_hash, server_name);
 }
 
+/**
+ * Creates a new debug server.
+ *
+ * @param server_name the name of the server.
+ * @param result address where a result code can be returned.
+ * @returns a new server, or #NULL on failure.
+ */
 DBusServer*
 _dbus_server_debug_new (const char     *server_name,
 			DBusResultCode *result)
@@ -200,6 +219,14 @@ handle_new_client (void *data)
   dbus_connection_unref (connection);
 }
 
+/**
+ * Tells the server to accept a transport so the transport
+ * can send messages to it.
+ *
+ * @param server the server
+ * @param transport the transport
+ * @returns #TRUE on success.
+ */
 dbus_bool_t
 _dbus_server_debug_accept_transport (DBusServer     *server,
 				     DBusTransport  *transport)
-- 
cgit