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.
Showing the changes to libavcodec (1 of 1 file). Show all
Unified · Split
| @@ -61,18 +61,17 @@ typedef struct IVIHuffDesc { · 60 unmodified lines | |||
| 61 | * macroblock/block huffman table descriptor | 61 | * macroblock/block huffman table descriptor |
| 62 | */ | 62 | */ |
| 63 | typedef struct IVIHuffTab { | 63 | typedef struct IVIHuffTab { |
| 64 | int32_t tab_sel; ///< index of one of the predefined tables | 64 | int32_t tab_sel; ///< index of one of the predefined tables, or "7" for custom one |
| 65 | /// or "7" for custom one | ||
| 66 | VLC *tab; ///< pointer to the table associated with tab_sel | 65 | VLC *tab; ///< pointer to the table associated with tab_sel |
| 67 | 66 | ||
| 68 | /// the following are used only when tab_sel == 7 | 67 | // the following are used only when tab_sel == 7 |
| 69 | IVIHuffDesc cust_desc; ///< custom Huffman codebook descriptor | 68 | IVIHuffDesc cust_desc; ///< custom Huffman codebook descriptor |
| 70 | VLC cust_tab; ///< vlc table for custom codebook | 69 | VLC cust_tab; ///< vlc table for custom codebook |
| 71 | } IVIHuffTab; | 70 | } IVIHuffTab; |
| 72 | 71 | ||
| 73 | enum { | 72 | enum { |
| 74 | IVI_MB_HUFF = 0, ///< Huffman table is used for coding macroblocks | 73 | IVI_MB_HUFF = 0, ///< Huffman table is used for coding macroblocks |
| 75 | IVI_BLK_HUFF = 1 /// Huffman table is used for coding blocks | 74 | IVI_BLK_HUFF = 1 ///< Huffman table is used for coding blocks |
| 76 | }; | 75 | }; |
| 77 | 76 | ||
| 78 | 77 | ||