summaryrefslogtreecommitdiffstats
path: root/dbus/dbus-macros.h
diff options
context:
space:
mode:
Diffstat (limited to 'dbus/dbus-macros.h')
-rw-r--r--dbus/dbus-macros.h26
1 files changed, 26 insertions, 0 deletions
diff --git a/dbus/dbus-macros.h b/dbus/dbus-macros.h
index abcb12a3..5d9524e1 100644
--- a/dbus/dbus-macros.h
+++ b/dbus/dbus-macros.h
@@ -50,6 +50,12 @@
# endif /* !__cplusplus */
#endif
+#if __GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 1)
+#define DBUS_GNUC_DEPRECATED __attribute__((__deprecated__))
+#else
+#define DBUS_GNUC_DEPRECATED
+#endif
+
/* Normally docs are in .c files, but there isn't a .c file for this. */
/**
* @defgroup DBusMacros Utility macros
@@ -67,6 +73,9 @@
* Macro used prior to declaring functions in the D-Bus header
* files. Expands to "extern "C"" when using a C++ compiler,
* and expands to nothing when using a C compiler.
+ *
+ * Please don't use this in your own code, consider it
+ * D-Bus internal.
*/
/**
* @def DBUS_END_DECLS
@@ -74,6 +83,9 @@
* Macro used after declaring functions in the D-Bus header
* files. Expands to "}" when using a C++ compiler,
* and expands to nothing when using a C compiler.
+ *
+ * Please don't use this in your own code, consider it
+ * D-Bus internal.
*/
/**
* @def TRUE
@@ -90,6 +102,20 @@
*
* A null pointer, defined appropriately for C or C++.
*/
+/**
+ * @def DBUS_GNUC_DEPRECATED
+ *
+ * Tells gcc to warn about a function or type if it's used.
+ * Code marked in this way should also be enclosed in
+ * @code
+ * #ifndef DBUS_DISABLE_DEPRECATED
+ * deprecated stuff here
+ * #endif
+ * @endcode
+ *
+ * Please don't use this in your own code, consider it
+ * D-Bus internal.
+ */
/** @} */