[PATCH] Prettify eval.h doxy.

[Stefano Sabatini]

---
 libavcodec/eval.h |   70 +++++++++++++++++++++++++---------------------------
 1 files changed, 34 insertions(+), 36 deletions(-)

diff --git a/libavcodec/eval.h b/libavcodec/eval.h
index e37b11a..fcfaf64 100644
--- a/libavcodec/eval.h
+++ b/libavcodec/eval.h
@@ -32,19 +32,19 @@ typedef struct AVExpr AVExpr;
  * Parses and evaluates an expression.
  * Note, this is significantly slower than ff_eval_expr().
  *
- * @param res a pointer to a double where is put the result value of
- * the expression, or NAN in case of error
- * @param s expression as a zero terminated string for example "1+2^3+5*5+sin(2/3)"
- * @param const_names NULL terminated array of zero terminated strings of constant identifers for example {"PI", "E", 0}
- * @param const_values a zero terminated array of values for the identifers from const_names
- * @param func1_names NULL terminated array of zero terminated strings of funcs1 identifers
- * @param funcs1 NULL terminated array of function pointers for functions which take 1 argument
- * @param func2_names NULL terminated array of zero terminated strings of funcs2 identifers
- * @param funcs2 NULL terminated array of function pointers for functions which take 2 arguments
- * @param opaque a pointer which will be passed to all functions from funcs1 and funcs2
- * @param log_ctx parent logging context
- * @return 0 in case of success, a negative value corresponding to an
- * AVERROR code otherwise
+ * @param res          a pointer to a double where is put the result value of the expression,
+ *                     or NAN in case of invalid expression
+ * @param s            expression as a zero terminated string, for example "1+2^3+5*5+sin(2/3)"
+ * @param const_names  NULL terminated array of zero terminated strings of constant identifiers,
+ *                     for example {"PI", "E", 0}
+ * @param const_values a zero terminated array of values for the identifiers from const_names
+ * @param func1_names  NULL terminated array of zero terminated strings of funcs1 identifiers
+ * @param funcs1 NULL  terminated array of function pointers for functions which take 1 argument
+ * @param func2_names  NULL terminated array of zero terminated strings of funcs2 identifiers
+ * @param funcs2       NULL terminated array of function pointers for functions which take 2 arguments
+ * @param opaque       a pointer which will be passed to all functions from funcs1 and funcs2
+ * @param log_ctx      parent logging context
+ * @return             0 in case of success, a negative value corresponding to an AVERROR code otherwise
  */
 int ff_parse_and_eval_expr(double *res, const char *s,
                            const char * const *const_names, const double *const_values,
@@ -55,19 +55,19 @@ int ff_parse_and_eval_expr(double *res, const char *s,
 /**
  * Parses an expression.
  *
- * @param expr a pointer where is put an AVExpr containing the parsed
- * value in case of successfull parsing, or NULL otherwise.
- * The pointed to AVExpr must be freed with ff_free_expr() by the user
- * when it is not needed anymore.
- * @param s expression as a zero terminated string for example "1+2^3+5*5+sin(2/3)"
- * @param const_names NULL terminated array of zero terminated strings of constant identifers for example {"PI", "E", 0}
- * @param func1_names NULL terminated array of zero terminated strings of funcs1 identifers
- * @param funcs1 NULL terminated array of function pointers for functions which take 1 argument
- * @param func2_names NULL terminated array of zero terminated strings of funcs2 identifers
- * @param funcs2 NULL terminated array of function pointers for functions which take 2 arguments
- * @param log_ctx parent logging context
- * @return 0 in case of success, a negative value corresponding to an
- * AVERROR code otherwise
+ * @param expr        a pointer where is put an AVExpr containing the parsed
+ *                    value in case of successfull parsing, or NULL otherwise.
+ *                    The pointed to AVExpr must be freed with ff_free_expr()
+ *                    by the user when it is not needed anymore.
+ * @param s           expression as a zero terminated string, for example "1+2^3+5*5+sin(2/3)"
+ * @param const_names NULL terminated array of zero terminated strings of constant identifiers,
+ *                    for example {"PI", "E", 0}
+ * @param func1_names NULL terminated array of zero terminated strings of funcs1 identifiers
+ * @param funcs1      NULL terminated array of function pointers for functions which take 1 argument
+ * @param func2_names NULL terminated array of zero terminated strings of funcs2 identifiers
+ * @param funcs2      NULL terminated array of function pointers for functions which take 2 arguments
+ * @param log_ctx     parent logging context
+ * @return            0 in case of success, a negative value corresponding to an VERROR code otherwise
  */
 int ff_parse_expr(AVExpr **expr, const char *s,
                   const char * const *const_names,
@@ -78,9 +78,9 @@ int ff_parse_expr(AVExpr **expr, const char *s,
 /**
  * Evaluates a previously parsed expression.
  *
- * @param const_values a zero terminated array of values for the identifers from ff_parse() const_names
- * @param opaque a pointer which will be passed to all functions from funcs1 and funcs2
- * @return the value of the expression
+ * @param const_values a zero terminated array of values for the identifiers from ff_parse_expr() const_names
+ * @param opaque       a pointer which will be passed to all functions from funcs1 and funcs2
+ * @return             the value of the expression
  */
 double ff_eval_expr(AVExpr *e, const double *const_values, void *opaque);
 
@@ -98,13 +98,11 @@ void ff_free_expr(AVExpr *e);
  * of numstr.
  *
  * @param numstr a string representing a number, may contain one of
- * the International System number postfixes, for example 'K', 'M',
- * 'G'. If 'i' is appended after the postfix, powers of 2 are used
- * instead of powers of 10. The 'B' postfix multiplies the value for
- * 8, and can be appended after another postfix or used alone. This
- * allows using for example 'KB', 'MiB', 'G' and 'B' as postfix.
- * @param tail if non-NULL puts here the pointer to the char next
- * after the last parsed character
+ *               the International System number postfixes, for example 'K', 'M', 'G'.
+ *               If 'i' is appended after the postfix, powers of 2 are used instead of powers of 10.
+ *               The 'B' postfix multiplies the value for 8, and can be appended after
+ *               another postfix or used alone. This allows using for example 'KB', 'MiB', 'G' and 'B' as postfix.
+ * @param tail   if non-NULL puts here the pointer to the char next after the last parsed character
  */
 double av_strtod(const char *numstr, char **tail);
 
-- 
1.7.1


--IJpNTDwzlM2Ie8A6--