From 5b5398722ef96510e8f9419c49490c92449075ce Mon Sep 17 00:00:00 2001
From: James Almer <jamrial@gmail.com>
Date: Tue, 4 May 2021 23:10:41 -0300
Subject: [PATCH] avcodec: be more explicit about the buffer size in
 get_encode_buffer documentation

Signed-off-by: James Almer <jamrial@gmail.com>
---
 libavcodec/avcodec.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/libavcodec/avcodec.h b/libavcodec/avcodec.h
index 0ef1676daf..3cf131d0a5 100644
--- a/libavcodec/avcodec.h
+++ b/libavcodec/avcodec.h
@@ -2097,6 +2097,10 @@ typedef struct AVCodecContext {
      * This callback must use the above value to calculate the required buffer size,
      * which must padded by at least AV_INPUT_BUFFER_PADDING_SIZE bytes.
      *
+     * In some specific cases, the encoder may not use the entire buffer allocated by this
+     * callback. This will be reflected in the size value in the packet once returned by
+     * avcodec_receive_packet().
+     *
      * This callback must fill the following fields in the packet:
      * - data: alignment requirements for AVPacket apply, if any. Some architectures and
      *   encoders may benefit from having aligned data.