From 34a50edde100436a1bbb5249b8bbb812c4fde7c2 Mon Sep 17 00:00:00 2001
From: Aleksander Morgado <aleksander@aleksander.es>
Date: Mon, 17 May 2021 22:46:15 +0200
Subject: api,errors: document all DBus error name prefixes

Since ModemManager 1.0 we were publishing symbols to identify all the
possible DBus error name prefixes, but these were never documented,
they were explicitly ignored in gtk-doc.

Let's provide proper documentation for them and make them first-class
API symbols.
---
 include/ModemManager-errors.h | 57 +++++++++++++++++++++++++++++++++++++++----
 1 file changed, 52 insertions(+), 5 deletions(-)

(limited to 'include')

diff --git a/include/ModemManager-errors.h b/include/ModemManager-errors.h
index 3bcacd7b..854e83ac 100644
--- a/include/ModemManager-errors.h
+++ b/include/ModemManager-errors.h
@@ -31,12 +31,59 @@
  * ModemManager interface.
  **/
 
-#define MM_CORE_ERROR_DBUS_PREFIX             MM_DBUS_ERROR_PREFIX ".Core"
+/**
+ * MM_CORE_ERROR_DBUS_PREFIX:
+ *
+ * DBus prefix for #MMCoreError errors.
+ *
+ * Since: 1.0
+ */
+#define MM_CORE_ERROR_DBUS_PREFIX MM_DBUS_ERROR_PREFIX ".Core"
+
+/**
+ * MM_MOBILE_EQUIPMENT_ERROR_DBUS_PREFIX:
+ *
+ * DBus prefix for #MMMobileEquipmentError errors.
+ *
+ * Since: 1.0
+ */
 #define MM_MOBILE_EQUIPMENT_ERROR_DBUS_PREFIX MM_DBUS_ERROR_PREFIX ".MobileEquipment"
-#define MM_CONNECTION_ERROR_DBUS_PREFIX       MM_DBUS_ERROR_PREFIX ".Connection"
-#define MM_SERIAL_ERROR_DBUS_PREFIX           MM_DBUS_ERROR_PREFIX ".Serial"
-#define MM_MESSAGE_ERROR_DBUS_PREFIX          MM_DBUS_ERROR_PREFIX ".Message"
-#define MM_CDMA_ACTIVATION_ERROR_DBUS_PREFIX  MM_DBUS_ERROR_PREFIX ".CdmaActivation"
+
+/**
+ * MM_CONNECTION_ERROR_DBUS_PREFIX:
+ *
+ * DBus prefix for #MMConnectionError errors.
+ *
+ * Since: 1.0
+ */
+#define MM_CONNECTION_ERROR_DBUS_PREFIX MM_DBUS_ERROR_PREFIX ".Connection"
+
+/**
+ * MM_SERIAL_ERROR_DBUS_PREFIX:
+ *
+ * DBus prefix for #MMSerialError errors.
+ *
+ * Since: 1.0
+ */
+#define MM_SERIAL_ERROR_DBUS_PREFIX MM_DBUS_ERROR_PREFIX ".Serial"
+
+/**
+ * MM_MESSAGE_ERROR_DBUS_PREFIX:
+ *
+ * DBus prefix for #MMMessageError errors.
+ *
+ * Since: 1.0
+ */
+#define MM_MESSAGE_ERROR_DBUS_PREFIX MM_DBUS_ERROR_PREFIX ".Message"
+
+/**
+ * MM_CDMA_ACTIVATION_ERROR_DBUS_PREFIX:
+ *
+ * DBus prefix for #MMCdmaActivationError errors.
+ *
+ * Since: 1.0
+ */
+#define MM_CDMA_ACTIVATION_ERROR_DBUS_PREFIX MM_DBUS_ERROR_PREFIX ".CdmaActivation"
 
 /**
  * MMCoreError:
-- 
cgit v1.2.3-70-g09d2