[FFmpeg-cvslog] lavf: clarify probesize/format_probesize doxy

[Anton Khirnov]

ffmpeg | branch: master | Anton Khirnov <anton at khirnov.net> | Sat Apr 24 14:56:10 2021 +0200| [71c0ef882e37091b22bae2175efb2d5cc4225d8d] | committer: Anton Khirnov

lavf: clarify probesize/format_probesize doxy

probesize is not used for probing the input format, but its
documentation claims it does.

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

 libavformat/avformat.h | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/libavformat/avformat.h b/libavformat/avformat.h
index 043baeea1f..cd7b0d941c 100644
--- a/libavformat/avformat.h
+++ b/libavformat/avformat.h
@@ -1241,9 +1241,15 @@ typedef struct AVFormatContext {
 #define AVFMT_FLAG_AUTO_BSF   0x200000 ///< Add bitstream filters as requested by the muxer
 
     /**
-     * Maximum size of the data read from input for determining
-     * the input container format.
+     * Maximum number of bytes read from input in order to determine stream
+     * properties. Used when reading the global header and in
+     * avformat_find_stream_info().
+     *
      * Demuxing only, set by the caller before avformat_open_input().
+     *
+     * @note this is \e not  used for determining the \ref AVInputFormat
+     *       "input format"
+     * @sa format_probesize
      */
     int64_t probesize;
 
@@ -1518,9 +1524,13 @@ typedef struct AVFormatContext {
     int probe_score;
 
     /**
-     * number of bytes to read maximally to identify format.
-     * - encoding: unused
-     * - decoding: set by user
+     * Maximum number of bytes read from input in order to identify the
+     * \ref AVInputFormat "input format". Only used when the format is not set
+     * explicitly by the caller.
+     *
+     * Demuxing only, set by the caller before avformat_open_input().
+     *
+     * @sa probesize
      */
     int format_probesize;