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.
Unified · Split
| @@ -61,18 +61,17 @@ typedef struct IVIHuffDesc { · 60 unmodified lines | ||
| 61 | 61 | * macroblock/block huffman table descriptor |
| 62 | 62 | */ |
| 63 | 63 | typedef struct IVIHuffTab { |
| 64 | − int32_t tab_sel; ///< index of one of the predefined tables | |
| 65 | − /// or "7" for custom one | |
| 64 | + int32_t tab_sel; ///< index of one of the predefined tables, or "7" for custom one | |
| 66 | 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 | 68 | IVIHuffDesc cust_desc; ///< custom Huffman codebook descriptor |
| 70 | 69 | VLC cust_tab; ///< vlc table for custom codebook |
| 71 | 70 | } IVIHuffTab; |
| 72 | 71 | |
| 73 | 72 | enum { |
| 74 | 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 | |