diff --git a/libavcodec/bitstream.h b/libavcodec/bitstream.h
index e586637e9d..6a12a64cd1 100644
--- a/libavcodec/bitstream.h
+++ b/libavcodec/bitstream.h
@@ -116,7 +116,9 @@ static inline void init_put_bits(PutBitContext *s, uint8_t *buffer, int buffer_s
 #endif
 }
 
-/* return the number of bits output */
+/**
+ * Returns the number of bits output.
+ */
 static inline int put_bits_count(PutBitContext *s)
 {
 #ifdef ALT_BITSTREAM_WRITER