AVDictionary: warn about its shortcommings and mention available replacements.
authorMichael Niedermayer <michaelni@gmx.at>
Tue, 28 Jun 2011 02:10:40 +0000 (04:10 +0200)
committerMichael Niedermayer <michaelni@gmx.at>
Tue, 28 Jun 2011 02:10:40 +0000 (04:10 +0200)
Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
libavutil/dict.h

index 421be32..dc575eb 100644 (file)
 
 /**
  * @file Public dictionary API.
+ * @deprecated
+ *  AVDictionary is provided for compatibility with libav. It is both in
+ *  implementation as well as API inefficient. It doesnt scale and is
+ *  be extreemly slow with large dictionaries.
+ *  It is recommanded that new code uses our tree container from tree.c/h
+ *  where applicable.
+ *  Which uses AVL trees to achive O(log n) performance
  */
 
 #ifndef AVUTIL_DICT_H