From 716059087dcf7caeb12313520eee8fc4b554ef54 Mon Sep 17 00:00:00 2001 From: Havoc Pennington Date: Sat, 21 Oct 2006 17:43:30 +0000 Subject: 2006-10-21 Havoc Pennington * dbus/dbus-macros.h: add DBUS_GNUC_DEPRECATED macro * dbus/dbus-message.h: mark dbus_message_iter_get_array_len() as DBUS_GNUC_DEPRECATED --- dbus/dbus-macros.h | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) (limited to 'dbus/dbus-macros.h') 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. + */ /** @} */ -- cgit