1 files changed, 26 insertions, 7 deletions
diff --git a/dbus/dbus-message.c b/dbus/dbus-message.c
index 0266ba4e..fdc0c342 100644
--- a/dbus/dbus-message.c
+++ b/dbus/dbus-message.c
@@ -24,26 +24,45 @@
 #include "dbus-message.h"
 
 /**
- * @defgroup DBusMessage DBusMessage
- * @ingroup  DBus
- * @brief DBusMessage object
+ * @defgroup DBusMessageInternals DBusMessage implementation details
+ * @ingroup DBusInternals
+ * @brief DBusMessage private implementation details.
  *
- * Types and functions related to the DBusMessage object.
+ * The guts of DBusMessage and its methods.
  *
  * @{
  */
 
 /**
- * @struct DBusMessage
  * Object representing a message received from or to be sent to
- * another application.
+ * another application. This is an opaque object, all members
+ * are private.
  */
 struct DBusMessage
 {
   int refcount; /**< Reference count */
-
+  
 };
 
+/** @} */
+
+/**
+ * @defgroup DBusMessage DBusMessage
+ * @ingroup  DBus
+ * @brief DBusMessage object
+ *
+ * Types and functions related to the DBusMessage object.
+ *
+ * @{
+ */
+
+/**
+ * @typedef DBusMessage
+ *
+ * Opaque data type representing a message received from or to be
+ * sent to another application.
+ */
+
 /**
  * Constructs a new message.
  * @return a new DBusMessage, free with dbus_message_unref()