[PATCH] Prettify eval.h doxy.

[Stefano Sabatini]

---
 libavcodec/eval.h |   84 ++++++++++++++++++++++++++++++++---------------------
 1 files changed, 51 insertions(+), 33 deletions(-)

diff --git a/libavcodec/eval.h b/libavcodec/eval.h
index e37b11a..41ccf7e 100644
--- a/libavcodec/eval.h
+++ b/libavcodec/eval.h
@@ -32,19 +32,27 @@ 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
+ * @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
+ *         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 +63,25 @@ 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
+ * @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
- * AVERROR code otherwise
+ *         AVERROR code otherwise
  */
 int ff_parse_expr(AVExpr **expr, const char *s,
                   const char * const *const_names,
@@ -78,8 +92,10 @@ 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
+ * @param const_values a zero terminated array of values for the
+ *                     identifiers 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
  */
 double ff_eval_expr(AVExpr *e, const double *const_values, void *opaque);
@@ -98,13 +114,15 @@ 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


--bp/iNruPH9dso1Pn--