deprecated plist_dict_insert_item in favor of plist_dict_set_item

1 files changed, 11 insertions, 1 deletions

diff --git a/include/plist/plist.h b/include/plist/plist.h
index b482199..4dd76a6 100644
--- a/include/plist/plist.h
+++ b/include/plist/plist.h
@@ -44,9 +44,17 @@ extern "C"
 #else
 #define PLIST_API  __declspec( dllimport )
 #endif
+#define DEPRECATED(x) __declspec(deprecated(x))
 #else
 #include <stdint.h>
 #define PLIST_API
+#ifdef __GNUC__
+#define DEPRECATED(x) __attribute__((deprecated(x)))
+#elif defined(_MSC_VER)
+#else
+#define DEPRECATED(x)
+#pragma message("WARNING: You need to implement DEPRECATED for this compiler")
+#endif
 #endif
 
 #include <sys/types.h>
@@ -322,11 +330,13 @@ extern "C"
     /**
      * Insert a new item into a #PLIST_DICT node.
      *
+     * @deprecated Deprecated. Use plist_dict_set_item instead.
+     *
      * @param node the node of type #PLIST_DICT
      * @param item the new item to insert
      * @param key The identifier of the item to insert.
      */
-    PLIST_API void plist_dict_insert_item(plist_t node, const char* key, plist_t item);
+    DEPRECATED("use plist_dict_set_item instead") PLIST_API void plist_dict_insert_item(plist_t node, const char* key, plist_t item);
 
     /**
      * Remove an existing position in a #PLIST_DICT node.