[FFmpeg-cvslog] avfilter/internal: Doxygen for ff_fmt_is_in

[Ganesh Ajjanagadde]

ffmpeg | branch: master | Ganesh Ajjanagadde <gajjanagadde at gmail.com> | Wed Oct 14 22:56:54 2015 -0400| [62144b225d077b201a723d843d38c6d15cb087f9] | committer: Ganesh Ajjanagadde

avfilter/internal: Doxygen for ff_fmt_is_in

This clarifies and adds Doxygen for ff_fmt_is_in.

Reviewed-by: Timothy Gu <timothygu99 at gmail.com>
Signed-off-by: Ganesh Ajjanagadde <gajjanagadde at gmail.com>

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=62144b225d077b201a723d843d38c6d15cb087f9
---

 libavfilter/internal.h |   10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/libavfilter/internal.h b/libavfilter/internal.h
index d92e120..1cc6bf3 100644
--- a/libavfilter/internal.h
+++ b/libavfilter/internal.h
@@ -152,7 +152,15 @@ struct AVFilterInternal {
     avfilter_execute_func *execute;
 };
 
-/** Tell is a format is contained in the provided list terminated by -1. */
+/**
+ * Tell if an integer is contained in the provided -1-terminated list of integers.
+ * This is useful for determining (for instance) if an AVPixelFormat is in an
+ * array of supported formats.
+ *
+ * @param fmt provided format
+ * @param fmts -1-terminated list of formats
+ * @return 1 if present, 0 if absent
+ */
 int ff_fmt_is_in(int fmt, const int *fmts);
 
 /* Functions to parse audio format arguments */