summaryrefslogtreecommitdiffstats
path: root/dbus/dbus-marshal-validate.h
diff options
context:
space:
mode:
authorHavoc Pennington <hp@redhat.com>2006-10-21 18:17:02 +0000
committerHavoc Pennington <hp@redhat.com>2006-10-21 18:17:02 +0000
commite19ebac55d671ecd92877af182300311afa7641a (patch)
tree7068a2c521a2d27d086f9f958f8d018d0d0a83e8 /dbus/dbus-marshal-validate.h
parent716059087dcf7caeb12313520eee8fc4b554ef54 (diff)
2006-10-21 Havoc Pennington <hp@redhat.com>
* Clean up Doxygen group markers for public API so Doxygen finds everything (not comprehensively fixed for private API). Means all remaining Doxygen warnings are just about missing docs and thus pretty simple to resolve.
Diffstat (limited to 'dbus/dbus-marshal-validate.h')
-rw-r--r--dbus/dbus-marshal-validate.h14
1 files changed, 11 insertions, 3 deletions
diff --git a/dbus/dbus-marshal-validate.h b/dbus/dbus-marshal-validate.h
index 0074c437..3436b6ce 100644
--- a/dbus/dbus-marshal-validate.h
+++ b/dbus/dbus-marshal-validate.h
@@ -31,6 +31,12 @@
#endif
/**
+ * @addtogroup DBusMarshal
+ *
+ * @{
+ */
+
+/**
* This is used rather than a bool for high visibility
*/
typedef enum
@@ -49,11 +55,11 @@ typedef enum
typedef enum
{
#define _DBUS_NEGATIVE_VALIDITY_COUNT 4
- DBUS_VALIDITY_UNKNOWN_OOM_ERROR = -4,
+ DBUS_VALIDITY_UNKNOWN_OOM_ERROR = -4, /**< can't determine validity due to OOM */
DBUS_INVALID_FOR_UNKNOWN_REASON = -3,
DBUS_VALID_BUT_INCOMPLETE = -2,
DBUS_VALIDITY_UNKNOWN = -1,
- DBUS_VALID = 0,
+ DBUS_VALID = 0, /**< the data is valid */
DBUS_INVALID_UNKNOWN_TYPECODE = 1,
DBUS_INVALID_MISSING_ARRAY_ELEMENT_TYPE = 2,
DBUS_INVALID_SIGNATURE_TOO_LONG = 3, /* this one is impossible right now since
@@ -67,7 +73,7 @@ typedef enum
DBUS_INVALID_ALIGNMENT_PADDING_NOT_NUL = 9,
DBUS_INVALID_BOOLEAN_NOT_ZERO_OR_ONE = 10,
DBUS_INVALID_NOT_ENOUGH_DATA = 11,
- DBUS_INVALID_TOO_MUCH_DATA = 12,
+ DBUS_INVALID_TOO_MUCH_DATA = 12, /**< trailing junk makes it invalid */
DBUS_INVALID_BAD_BYTE_ORDER = 13,
DBUS_INVALID_BAD_PROTOCOL_VERSION = 14,
DBUS_INVALID_BAD_MESSAGE_TYPE = 15,
@@ -184,4 +190,6 @@ DECLARE_DBUS_NAME_CHECK(error_name);
DECLARE_DBUS_NAME_CHECK(bus_name);
DECLARE_DBUS_NAME_CHECK(signature);
+/** @} */
+
#endif /* DBUS_MARSHAL_VALIDATE_H */