2003-09-07 Havoc Pennington <hp@pobox.com>

	* Make Doxygen contented.

1 files changed, 16 insertions, 7 deletions

diff --git a/glib/dbus-glib.h b/glib/dbus-glib.h
index 3a87dec2..4015dd99 100644
--- a/glib/dbus-glib.h
+++ b/glib/dbus-glib.h
@@ -39,19 +39,28 @@ void dbus_server_setup_with_g_main     (DBusServer     *server,
 typedef struct DBusGObjectInfo DBusGObjectInfo;
 typedef struct DBusGMethodInfo DBusGMethodInfo;
 
+/**
+ * Object typically generated by dbus-glib-tool that
+ * stores a mapping from introspection data to a
+ * function pointer for a C method to be invoked.
+ */
 struct DBusGMethodInfo
 {
-  GCallback                 function;
-  DBusHandleMessageFunction marshaller;
-  int                       data_offset;
+  GCallback                 function;    /**< C method to invoke */
+  DBusHandleMessageFunction marshaller;  /**< Marshaller to go DBusMessage to C method */
+  int                       data_offset; /**< Offset into the introspection data */
 };
 
+/**
+ * Introspection data for a GObject, normally autogenerated by
+ * a tool such as dbus-glib-tool.
+ */
 struct DBusGObjectInfo
 {
-  const DBusGMethodInfo *infos;
-  const unsigned char *data;    
-  void *dbus_internal_padding1;
-  void *dbus_internal_padding2;
+  const DBusGMethodInfo *infos; /**< Array of method pointers */
+  const unsigned char *data;    /**< Introspection data */
+  void *dbus_internal_padding1; /**< Reserved for expansion */
+  void *dbus_internal_padding2; /**< Reserved for expansion */
 };
 
 void dbus_gobject_class_install_info  (GObjectClass          *object_class,