[FFmpeg-cvslog] avcodec/get_bits: Document skip_bits_long()

[Michael Niedermayer]

ffmpeg | branch: master | Michael Niedermayer <michael at niedermayer.cc> | Fri Mar 23 18:58:33 2018 +0100| [6261ef425128093609af2a0ce7505f72492e45bf] | committer: Michael Niedermayer

avcodec/get_bits: Document skip_bits_long()

Found-by: Kieran
Signed-off-by: Michael Niedermayer <michael at niedermayer.cc>

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

 libavcodec/get_bits.h | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/libavcodec/get_bits.h b/libavcodec/get_bits.h
index d7cf286378..56ef5f0cbe 100644
--- a/libavcodec/get_bits.h
+++ b/libavcodec/get_bits.h
@@ -202,6 +202,13 @@ static inline int get_bits_count(const GetBitContext *s)
     return s->index;
 }
 
+/**
+ * Skips the specified number of bits.
+ * @param n the number of bits to skip,
+ *          For the UNCHECKED_BITSTREAM_READER this must not cause the distance
+ *          from the start to overflow int32_t. Staying within the bitstream + padding
+ *          is sufficient, too.
+ */
 static inline void skip_bits_long(GetBitContext *s, int n)
 {
 #if UNCHECKED_BITSTREAM_READER