diff --git a/libavformat/avformat.h b/libavformat/avformat.h
index 62cb68086fc4c0ad2626d170a4f9afe26985e1e1..7e57d8899b7f01006da164419415c1def702a1ed 100644
--- a/libavformat/avformat.h
+++ b/libavformat/avformat.h
@@ -317,7 +317,11 @@ typedef struct AVStream {
      * demuxer must NOT set this
      */
     int64_t start_time;
-    /** decoding: duration of the stream, in stream time base. */
+    /**
+     * decoding: duration of the stream, in stream time base.
+     * If a source file does not specify a duration, but does specify
+     * a bitrate, this value will be estimates from bit rate and file size.
+     */
     int64_t duration;
 
     char language[4]; /** ISO 639 3-letter language code (empty string if undefined) */