[FFmpeg-cvslog] avutil/tree: Document the guaranteed ordering of compare arguments for av_tree_find()

[Michael Niedermayer]

ffmpeg | branch: master | Michael Niedermayer <michael at niedermayer.cc> | Sun Oct 25 17:13:42 2015 +0100| [65ffca9f803a65057ac6391459b70aa0fa066d80] | committer: Michael Niedermayer

avutil/tree: Document the guaranteed ordering of compare arguments for av_tree_find()

Signed-off-by: Michael Niedermayer <michael at niedermayer.cc>

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=65ffca9f803a65057ac6391459b70aa0fa066d80
---

 libavutil/tree.h |    3 +++
 1 file changed, 3 insertions(+)

diff --git a/libavutil/tree.h b/libavutil/tree.h
index 337a44c..e1aefaa 100644
--- a/libavutil/tree.h
+++ b/libavutil/tree.h
@@ -58,6 +58,9 @@ struct AVTreeNode *av_tree_node_alloc(void);
  *             then the corresponding entry in next is unchanged.
  * @param cmp compare function used to compare elements in the tree,
  *            API identical to that of Standard C's qsort
+ *            It is guranteed that the first and only the first argument to cmp()
+ *            will be the key parameter to av_tree_find(), thus it could if the
+ *            user wants, be a different type (like an opaque context).
  * @return An element with cmp(key, elem) == 0 or NULL if no such element
  *         exists in the tree.
  */