From: Martin Quinson <martin.quinson@loria.fr>
Date: Wed, 19 Jul 2017 22:15:31 +0000 (+0200)
Subject: dont document a deprecated function, and properly mark it so
X-Git-Tag: v3_17~357^2~1
X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/commitdiff_plain/a460df7816cc70842156226878a57bd8aa1f9833?hp=0258e7c7cf1b974a0b6b9544b6e81bae91b67e8e

dont document a deprecated function, and properly mark it so
---

diff --git a/include/xbt/dict.h b/include/xbt/dict.h
index f1eb29e208..ac3917c042 100644
--- a/include/xbt/dict.h
+++ b/include/xbt/dict.h
@@ -55,7 +55,8 @@ typedef struct s_xbt_dictelm {
   xbt_dictelm_t next;
 } s_xbt_dictelm_t;
 
-XBT_PUBLIC(xbt_dict_t) xbt_dict_new();
+XBT_PUBLIC(xbt_dict_t)
+XBT_ATTRIB_DEPRECATED_v319("Use xbt_dict_new_homogeneous(). v3.19 will turn this warning into an error") xbt_dict_new();
 XBT_PUBLIC(xbt_dict_t) xbt_dict_new_homogeneous(void_f_pvoid_t free_ctn);
 XBT_PUBLIC(void) xbt_dict_free(xbt_dict_t * dict);
 XBT_PUBLIC(unsigned int) xbt_dict_size(xbt_dict_t dict);
diff --git a/src/xbt/dict.cpp b/src/xbt/dict.cpp
index 5f53f43d2c..7436c33f31 100644
--- a/src/xbt/dict.cpp
+++ b/src/xbt/dict.cpp
@@ -20,14 +20,6 @@
 
 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(xbt_dict, xbt, "Dictionaries provide the same functionalities as hash tables");
 
-/**
- * \brief Constructor
- * \return pointer to the destination
- * \see xbt_dict_new_homogenous(), xbt_dict_free()
- *
- * Creates and initialize a new dictionary with a default hashtable size.
- * The dictionary is heterogeneous: each element can have a different free function.
- */
 xbt_dict_t xbt_dict_new()
 {
   XBT_WARN("Function xbt_dict_new() will soon be dropped. Please switch to xbt_dict_new_homogeneous()");