2003-04-05 Havoc Pennington <hp@pobox.com>

* dbus/dbus-string.c: docs warning

	* dbus/dbus-spawn.c: missing docs

	* dbus/dbus-memory.c (struct ShutdownClosure): missing docs

ChangeLog

@@ -1,3 +1,11 @@
+2003-04-05  Havoc Pennington  <hp@pobox.com>
+
+	* dbus/dbus-string.c: docs warning
+	
+	* dbus/dbus-spawn.c: missing docs
+
+	* dbus/dbus-memory.c (struct ShutdownClosure): missing docs
+
 2003-04-05  Havoc Pennington  <hp@pobox.com>
 
 	* bus/loop.c (bus_loop_iterate): fix the timeout code, using 

dbus/dbus-memory.c

@@ -633,13 +633,19 @@ dbus_free_string_array (char **str_array)
  */
 int _dbus_current_generation = 1;
 
+/**
+ * Represents a function to be called on shutdown.
+ */
 typedef struct ShutdownClosure ShutdownClosure;
 
+/**
+ * This struct represents a function to be called on shutdown.
+ */
 struct ShutdownClosure
 {
-  ShutdownClosure *next;
-  DBusShutdownFunction func;
-  void *data;
+  ShutdownClosure *next;     /**< Next ShutdownClosure */
+  DBusShutdownFunction func; /**< Function to call */
+  void *data;                /**< Data for function */
 };
 
 _DBUS_DEFINE_GLOBAL_LOCK (shutdown_funcs);

dbus/dbus-spawn.c

@@ -42,11 +42,14 @@
  * if you thought about it a bit.
  */
 
+/**
+ * Enumeration for status of a read()
+ */
 typedef enum
 {
-  READ_STATUS_OK,
-  READ_STATUS_ERROR,
-  READ_STATUS_EOF
+  READ_STATUS_OK,    /**< Read succeeded */
+  READ_STATUS_ERROR, /**< Some kind of error */
+  READ_STATUS_EOF    /**< EOF returned */
 } ReadStatus;
 
 static ReadStatus
@@ -709,7 +712,9 @@ _dbus_babysitter_handle_watch (DBusBabysitter  *sitter,
   return TRUE;
 }
 
+/** Helps remember which end of the pipe is which */
 #define READ_END 0
+/** Helps remember which end of the pipe is which */
 #define WRITE_END 1
 
 

dbus/dbus-string.c

@@ -1462,6 +1462,7 @@ _dbus_string_find_to (const DBusString *str,
  * Sets *found to -1 if the byte is not found.
  *
  * @param str the string
+ * @param start the place to start scanning (will not find the byte at this point)
  * @param byte the byte to find
  * @param found return location for where it was found
  * @returns #TRUE if found