[FFmpeg-cvslog] avcodec/ivi: make comments more Doxygen-friendly

Andrew Sayers git at videolan.org
Mon Mar 4 18:48:22 EET 2024


ffmpeg | branch: master | Andrew Sayers <ffmpeg-devel at pileofstuff.org> | Wed Feb 28 17:09:40 2024 +0000| [899e022cd7b2eff352198d79cbd73a8707660ea3] | committer: Stefano Sabatini

avcodec/ivi: make comments more Doxygen-friendly

Doxygen eats the newline in the first comment, making it harder to read.
Join the lines and add a comma, so source and documentation are equally readable.

Doxygen only associates the second comment with cust_dec.
The comments for cust_dec and cust_tab make perfect sense without it,
so downgrade it to a non-doxygen "//" comment.

The third comment was missed by the command in the previous commit,
because it (correctly but uniquely) doesn't have a trailing comma.

Signed-off-by: Andrew Sayers <ffmpeg-devel at pileofstuff.org>

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

 libavcodec/ivi.h | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/libavcodec/ivi.h b/libavcodec/ivi.h
index ec54f65f30..afc3ec2a75 100644
--- a/libavcodec/ivi.h
+++ b/libavcodec/ivi.h
@@ -61,18 +61,17 @@ typedef struct IVIHuffDesc {
  *  macroblock/block huffman table descriptor
  */
 typedef struct IVIHuffTab {
-    int32_t     tab_sel;    ///< index of one of the predefined tables
-                            /// or "7" for custom one
+    int32_t     tab_sel;    ///< index of one of the predefined tables, or "7" for custom one
     VLC         *tab;       ///< pointer to the table associated with tab_sel
 
-    /// the following are used only when tab_sel == 7
+    // the following are used only when tab_sel == 7
     IVIHuffDesc cust_desc;  ///< custom Huffman codebook descriptor
     VLC         cust_tab;   ///< vlc table for custom codebook
 } IVIHuffTab;
 
 enum {
     IVI_MB_HUFF   = 0,      ///< Huffman table is used for coding macroblocks
-    IVI_BLK_HUFF  = 1       /// Huffman table is used for coding blocks
+    IVI_BLK_HUFF  = 1       ///< Huffman table is used for coding blocks
 };
 
 



More information about the ffmpeg-cvslog mailing list