[FFmpeg-cvslog] r12172 - trunk/libavfilter/avfilter.h

[michael]

Author: michael
Date: Thu Feb 21 23:02:53 2008
New Revision: 12172

Log:
Document avfilter_formats_ref() with some ascii art.


Modified:
   trunk/libavfilter/avfilter.h

Modified: trunk/libavfilter/avfilter.h
==============================================================================
--- trunk/libavfilter/avfilter.h	(original)
+++ trunk/libavfilter/avfilter.h	Thu Feb 21 23:02:53 2008
@@ -177,7 +177,18 @@ AVFilterFormats *avfilter_all_colorspace
  */
 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);
 
 /**