diff --git a/libavformat/avformat.h b/libavformat/avformat.h
index 55a3cfbd35d300b3e05dd1ecff0eb1b72ee3916a..358ce00f4b2d47be4fe1a2470015dcb43538e646 100644
--- a/libavformat/avformat.h
+++ b/libavformat/avformat.h
@@ -835,6 +835,10 @@ typedef struct AVStream {
 
     /**
      * Average framerate
+     *
+     * - demuxing: May be set by libavformat when creating the stream or in
+     *             avformat_find_stream_info().
+     * - muxing: May be set by the caller before avformat_write_header().
      */
     AVRational avg_frame_rate;