[SCM] libav/experimental: Extend documentation for parse_filter().

[siretart at users.alioth.debian.org]

The following commit has been merged in the experimental branch:
commit 55b2a9ba3b8c9d383e67034c601f2163660053c6
Author: Stefano Sabatini <stefano.sabatini-lala at poste.it>
Date:   Sun Nov 7 22:47:33 2010 +0000

    Extend documentation for parse_filter().
    
    Originally committed as revision 25703 to svn://svn.ffmpeg.org/ffmpeg/trunk

diff --git a/libavfilter/graphparser.c b/libavfilter/graphparser.c
index fe53351..076b22a 100644
--- a/libavfilter/graphparser.c
+++ b/libavfilter/graphparser.c
@@ -139,7 +139,18 @@ static int create_filter(AVFilterContext **filt_ctx, AVFilterGraph *ctx, int ind
 }
 
 /**
- * Parse "filter=params"
+ * Parse a string of the form FILTER_NAME[=PARAMS], and create a
+ * corresponding filter instance which is added to graph with
+ * create_filter().
+ *
+ * @param filt_ctx put here a pointer to the created filter context on
+ * success, NULL otherwise
+ * @param buf pointer to the buffer to parse, *buf will be updated to
+ * point to the char next after the parsed string
+ * @param index an index which is assigned to the created filter
+ * instance, and which is supposed to be unique for each filter
+ * instance added to the filtergraph
+ * @return 0 in case of success, a negative AVERROR code otherwise
  */
 static int parse_filter(AVFilterContext **filt_ctx, const char **buf, AVFilterGraph *graph,
                         int index, AVClass *log_ctx)

-- 
Libav/FFmpeg packaging