[SCM] libav/experimental: Document avfilter_formats_ref() with some ascii art.

[siretart at users.alioth.debian.org]

The following commit has been merged in the experimental branch:
commit 09b63a42a5b837c241abfec486baf22bfedf3f72
Author: Michael Niedermayer <michaelni at gmx.at>
Date:   Thu Feb 21 22:02:53 2008 +0000

    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
--- 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);
 
 /**

-- 
Libav/FFmpeg packaging