From: Stefano Sabatini <stefano.sabatini-lala@poste.it>
Date: Sun, 7 Nov 2010 22:47:33 +0000 (+0000)
Subject: Extend documentation for parse_filter().
X-Git-Tag: v0.7b1~1640
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=55b2a9ba3b8c9d383e67034c601f2163660053c6;p=platform%2Fupstream%2Flibav.git

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)