Document avfilter_formats_ref() with some ascii art.

Originally committed as revision 12172 to svn://svn.ffmpeg.org/ffmpeg/trunk

diff --git a/libavfilter/avfilter.h b/libavfilter/avfilter.h
index 911cdd6..49d90cf 100644 (file)
--- a/libavfilter/avfilter.h
+++ b/libavfilter/avfilter.h
@@ -177,7 +177,18 @@ AVFilterFormats *avfilter_all_colorspaces(void);
  */
 AVFilterFormats *avfilter_merge_formats(AVFilterFormats *a, AVFilterFormats *b);
 
-/** Adds *ref as a new reference to f */
+/**
+ * Adds *ref as a new reference to f.
+ * That is the pointers will point like in the ascii art below:
+ *   ________
+ *  |   f    |<--------.
+ *  |  ____  |         |
+ *  | |refs| |       __|_
+ *  | |* * | |      |  | |
+ *  | |* *--------->|*ref|
+ *  | |____| |      |____|
+ *  |________|
+ */
 void avfilter_formats_ref(AVFilterFormats *f, AVFilterFormats **ref);
 
 /**