# HG changeset patch
# User stefano
# Date 1262277501 0
# Node ID 8e76d99591237ae7ac88d3fb67d777793f969cae
# Parent  68c900a2d2035d39f3330b423675f00dc29da059
Document guess_format().

diff -r 68c900a2d203 -r 8e76d9959123 avformat.h
--- a/avformat.h	Thu Dec 31 14:12:58 2009 +0000
+++ b/avformat.h	Thu Dec 31 16:38:21 2009 +0000
@@ -717,6 +717,19 @@
                                     const char *filename,
                                     const char *mime_type);
 #endif
+
+/**
+ * Returns the output format in the list of registered output formats
+ * which best matches the provided parameters, or returns NULL if
+ * there is no match.
+ *
+ * @param short_name if non-NULL checks if short_name matches with the
+ * names of the registered formats
+ * @param filename if non-NULL checks if filename terminates with the
+ * extensions of the registered formats
+ * @param mime_type if non-NULL checks if mime_type matches with the
+ * MIME type of the registered formats
+ */
 AVOutputFormat *guess_format(const char *short_name,
                              const char *filename,
                              const char *mime_type);