Browse code

doxygen: Prefer member groups over grouping into modules

Before this, almost all module groups have been used for grouping functions
and fields in structures semantically. This causes them to not appear
properly in the file documentation and needlessly clutters up the "Modules"
index.

Additionally, this commit streamlines some spelling and appearances.

Reinhard Tartler authored on 2011/07/01 22:32:21
Showing 19 changed files
... ...
@@ -258,7 +258,7 @@ typedef struct {
258 258
     DynamicRangeControl che_drc;
259 259
 
260 260
     /**
261
-     * @defgroup elements Channel element related data.
261
+     * @name Channel element related data
262 262
      * @{
263 263
      */
264 264
     enum ChannelPosition che_pos[4][MAX_ELEM_ID]; /**< channel element channel mapping with the
... ...
@@ -270,14 +270,15 @@ typedef struct {
270 270
     /** @} */
271 271
 
272 272
     /**
273
-     * @defgroup temporary aligned temporary buffers (We do not want to have these on the stack.)
273
+     * @name temporary aligned temporary buffers
274
+     * (We do not want to have these on the stack.)
274 275
      * @{
275 276
      */
276 277
     DECLARE_ALIGNED(32, float, buf_mdct)[1024];
277 278
     /** @} */
278 279
 
279 280
     /**
280
-     * @defgroup tables   Computed / set up during initialization.
281
+     * @name Computed / set up during initialization
281 282
      * @{
282 283
      */
283 284
     FFTContext mdct;
... ...
@@ -289,7 +290,7 @@ typedef struct {
289 289
     /** @} */
290 290
 
291 291
     /**
292
-     * @defgroup output   Members used for output interleaving.
292
+     * @name Members used for output interleaving
293 293
      * @{
294 294
      */
295 295
     float *output_data[MAX_CHANNELS];                 ///< Points to each element's 'ret' buffer (PCM output).
... ...
@@ -92,7 +92,7 @@ typedef struct AC3BitAllocParameters {
92 92
  * Coded AC-3 header values up to the lfeon element, plus derived values.
93 93
  */
94 94
 typedef struct {
95
-    /** @defgroup coded Coded elements
95
+    /** @name Coded elements
96 96
      * @{
97 97
      */
98 98
     uint16_t sync_word;
... ...
@@ -110,7 +110,7 @@ typedef struct {
110 110
     int num_blocks;                         ///< number of audio blocks
111 111
     /** @} */
112 112
 
113
-    /** @defgroup derived Derived values
113
+    /** @name Derived values
114 114
      * @{
115 115
      */
116 116
     uint8_t sr_shift;
... ...
@@ -67,7 +67,7 @@ typedef struct {
67 67
     GetBitContext gbc;                      ///< bitstream reader
68 68
     uint8_t *input_buffer;                  ///< temp buffer to prevent overread
69 69
 
70
-///@defgroup bsi bit stream information
70
+///@name Bit stream information
71 71
 ///@{
72 72
     int frame_type;                         ///< frame type                             (strmtyp)
73 73
     int substreamid;                        ///< substream identification
... ...
@@ -85,7 +85,7 @@ typedef struct {
85 85
     int eac3;                               ///< indicates if current frame is E-AC-3
86 86
 ///@}
87 87
 
88
-///@defgroup audfrm frame syntax parameters
88
+///@name Frame syntax parameters
89 89
     int snr_offset_strategy;                ///< SNR offset strategy                    (snroffststr)
90 90
     int block_switch_syntax;                ///< block switch syntax enabled            (blkswe)
91 91
     int dither_flag_syntax;                 ///< dither flag syntax enabled             (dithflage)
... ...
@@ -95,7 +95,7 @@ typedef struct {
95 95
     int skip_syntax;                        ///< skip field syntax enabled              (skipflde)
96 96
  ///@}
97 97
 
98
-///@defgroup cpl standard coupling
98
+///@name Standard coupling
99 99
     int cpl_in_use[AC3_MAX_BLOCKS];         ///< coupling in use                        (cplinu)
100 100
     int cpl_strategy_exists[AC3_MAX_BLOCKS];///< coupling strategy exists               (cplstre)
101 101
     int channel_in_cpl[AC3_MAX_CHANNELS];   ///< channel in coupling                    (chincpl)
... ...
@@ -108,7 +108,7 @@ typedef struct {
108 108
     int cpl_coords[AC3_MAX_CHANNELS][AC3_MAX_CPL_BANDS]; ///< coupling coordinates      (cplco)
109 109
 ///@}
110 110
 
111
-///@defgroup spx spectral extension
111
+///@name Spectral extension
112 112
 ///@{
113 113
     int spx_in_use;                             ///< spectral extension in use              (spxinu)
114 114
     uint8_t channel_uses_spx[AC3_MAX_CHANNELS]; ///< channel uses spectral extension        (chinspx)
... ...
@@ -124,12 +124,12 @@ typedef struct {
124 124
     float spx_signal_blend[AC3_MAX_CHANNELS][SPX_MAX_BANDS];///< spx signal blending factor (sblendfact)
125 125
 ///@}
126 126
 
127
-///@defgroup aht adaptive hybrid transform
127
+///@name Adaptive hybrid transform
128 128
     int channel_uses_aht[AC3_MAX_CHANNELS];                         ///< channel AHT in use (chahtinu)
129 129
     int pre_mantissa[AC3_MAX_CHANNELS][AC3_MAX_COEFS][AC3_MAX_BLOCKS];  ///< pre-IDCT mantissas
130 130
 ///@}
131 131
 
132
-///@defgroup channel channel
132
+///@name Channel
133 133
     int fbw_channels;                           ///< number of full-bandwidth channels
134 134
     int channels;                               ///< number of total channels
135 135
     int lfe_ch;                                 ///< index of LFE channel
... ...
@@ -139,27 +139,27 @@ typedef struct {
139 139
     int out_channels;                           ///< number of output channels
140 140
 ///@}
141 141
 
142
-///@defgroup dynrng dynamic range
142
+///@name Dynamic range
143 143
     float dynamic_range[2];                 ///< dynamic range
144 144
 ///@}
145 145
 
146
-///@defgroup bandwidth bandwidth
146
+///@name Bandwidth
147 147
     int start_freq[AC3_MAX_CHANNELS];       ///< start frequency bin                    (strtmant)
148 148
     int end_freq[AC3_MAX_CHANNELS];         ///< end frequency bin                      (endmant)
149 149
 ///@}
150 150
 
151
-///@defgroup rematrixing rematrixing
151
+///@name Rematrixing
152 152
     int num_rematrixing_bands;              ///< number of rematrixing bands            (nrematbnd)
153 153
     int rematrixing_flags[4];               ///< rematrixing flags                      (rematflg)
154 154
 ///@}
155 155
 
156
-///@defgroup exponents exponents
156
+///@name Exponents
157 157
     int num_exp_groups[AC3_MAX_CHANNELS];           ///< Number of exponent groups      (nexpgrp)
158 158
     int8_t dexps[AC3_MAX_CHANNELS][AC3_MAX_COEFS];  ///< decoded exponents
159 159
     int exp_strategy[AC3_MAX_BLOCKS][AC3_MAX_CHANNELS]; ///< exponent strategies        (expstr)
160 160
 ///@}
161 161
 
162
-///@defgroup bitalloc bit allocation
162
+///@name Bit allocation
163 163
     AC3BitAllocParameters bit_alloc_params;         ///< bit allocation parameters
164 164
     int first_cpl_leak;                             ///< first coupling leak state      (firstcplleak)
165 165
     int snr_offset[AC3_MAX_CHANNELS];               ///< signal-to-noise ratio offsets  (snroffst)
... ...
@@ -175,25 +175,25 @@ typedef struct {
175 175
     uint8_t dba_values[AC3_MAX_CHANNELS][8];        ///< delta values for each segment
176 176
 ///@}
177 177
 
178
-///@defgroup dithering zero-mantissa dithering
178
+///@name Zero-mantissa dithering
179 179
     int dither_flag[AC3_MAX_CHANNELS];      ///< dither flags                           (dithflg)
180 180
     AVLFG dith_state;                       ///< for dither generation
181 181
 ///@}
182 182
 
183
-///@defgroup imdct IMDCT
183
+///@name IMDCT
184 184
     int block_switch[AC3_MAX_CHANNELS];     ///< block switch flags                     (blksw)
185 185
     FFTContext imdct_512;                   ///< for 512 sample IMDCT
186 186
     FFTContext imdct_256;                   ///< for 256 sample IMDCT
187 187
 ///@}
188 188
 
189
-///@defgroup opt optimization
189
+///@name Optimization
190 190
     DSPContext dsp;                         ///< for optimization
191 191
     AC3DSPContext ac3dsp;
192 192
     FmtConvertContext fmt_conv;             ///< optimized conversion functions
193 193
     float mul_bias;                         ///< scaling for float_to_int16 conversion
194 194
 ///@}
195 195
 
196
-///@defgroup arrays aligned arrays
196
+///@name Aligned arrays
197 197
     DECLARE_ALIGNED(16, int,   fixed_coeffs)[AC3_MAX_CHANNELS][AC3_MAX_COEFS];       ///< fixed-point transform coefficients
198 198
     DECLARE_ALIGNED(32, float, transform_coeffs)[AC3_MAX_CHANNELS][AC3_MAX_COEFS];   ///< transform coefficients
199 199
     DECLARE_ALIGNED(32, float, delay)[AC3_MAX_CHANNELS][AC3_BLOCK_SIZE];             ///< delay - added to the next block
... ...
@@ -204,7 +204,7 @@ static enum Mode unpack_bitstream(AMRContext *p, const uint8_t *buf,
204 204
 }
205 205
 
206 206
 
207
-/// @defgroup amr_lpc_decoding AMR pitch LPC coefficient decoding functions
207
+/// @name AMR pitch LPC coefficient decoding functions
208 208
 /// @{
209 209
 
210 210
 /**
... ...
@@ -341,7 +341,7 @@ static void lsf2lsp_3(AMRContext *p)
341 341
 /// @}
342 342
 
343 343
 
344
-/// @defgroup amr_pitch_vector_decoding AMR pitch vector decoding functions
344
+/// @name AMR pitch vector decoding functions
345 345
 /// @{
346 346
 
347 347
 /**
... ...
@@ -403,7 +403,7 @@ static void decode_pitch_vector(AMRContext *p,
403 403
 /// @}
404 404
 
405 405
 
406
-/// @defgroup amr_algebraic_code_book AMR algebraic code book (fixed) vector decoding functions
406
+/// @name AMR algebraic code book (fixed) vector decoding functions
407 407
 /// @{
408 408
 
409 409
 /**
... ...
@@ -547,7 +547,7 @@ static void pitch_sharpening(AMRContext *p, int subframe, enum Mode mode,
547 547
 /// @}
548 548
 
549 549
 
550
-/// @defgroup amr_gain_decoding AMR gain decoding functions
550
+/// @name AMR gain decoding functions
551 551
 /// @{
552 552
 
553 553
 /**
... ...
@@ -633,7 +633,7 @@ static void decode_gains(AMRContext *p, const AMRNBSubframe *amr_subframe,
633 633
 /// @}
634 634
 
635 635
 
636
-/// @defgroup amr_pre_processing AMR pre-processing functions
636
+/// @name AMR preprocessing functions
637 637
 /// @{
638 638
 
639 639
 /**
... ...
@@ -751,7 +751,7 @@ static const float *anti_sparseness(AMRContext *p, AMRFixed *fixed_sparse,
751 751
 /// @}
752 752
 
753 753
 
754
-/// @defgroup amr_synthesis AMR synthesis functions
754
+/// @name AMR synthesis functions
755 755
 /// @{
756 756
 
757 757
 /**
... ...
@@ -812,7 +812,7 @@ static int synthesis(AMRContext *p, float *lpc,
812 812
 /// @}
813 813
 
814 814
 
815
-/// @defgroup amr_update AMR update functions
815
+/// @name AMR update functions
816 816
 /// @{
817 817
 
818 818
 /**
... ...
@@ -837,7 +837,7 @@ static void update_state(AMRContext *p)
837 837
 /// @}
838 838
 
839 839
 
840
-/// @defgroup amr_postproc AMR Post processing functions
840
+/// @name AMR Postprocessing functions
841 841
 /// @{
842 842
 
843 843
 /**
... ...
@@ -217,7 +217,7 @@ static av_cold int ape_decode_close(AVCodecContext * avctx)
217 217
 }
218 218
 
219 219
 /**
220
- * @defgroup rangecoder APE range decoder
220
+ * @name APE range decoding functions
221 221
  * @{
222 222
  */
223 223
 
... ...
@@ -25,8 +25,7 @@
25 25
 #include "avcodec.h"
26 26
 
27 27
 /**
28
- * Default values for ASS style.
29
- * @defgroup ass_default
28
+ * @name Default values for ASS style
30 29
  * @{
31 30
  */
32 31
 #define ASS_DEFAULT_FONT        "Arial"
... ...
@@ -2488,7 +2488,7 @@ typedef struct AVCodecContext {
2488 2488
 
2489 2489
 #if FF_API_FLAC_GLOBAL_OPTS
2490 2490
     /**
2491
-     * @defgroup flac_opts FLAC options
2491
+     * @name FLAC options
2492 2492
      * @deprecated Use FLAC encoder private options instead.
2493 2493
      * @{
2494 2494
      */
... ...
@@ -2897,7 +2897,7 @@ typedef struct AVCodec {
2897 2897
     const AVProfile *profiles;              ///< array of recognized profiles, or NULL if unknown, array is terminated by {FF_PROFILE_UNKNOWN}
2898 2898
 
2899 2899
     /**
2900
-     * @defgroup framethreading Frame-level threading support functions.
2900
+     * @name Frame-level threading support functions
2901 2901
      * @{
2902 2902
      */
2903 2903
     /**
... ...
@@ -507,7 +507,7 @@ typedef struct H264Context{
507 507
     int          cabac_init_idc;
508 508
 
509 509
     /**
510
-     * @defgroup multithreading Members for slice based multithreading
510
+     * @name Members for slice based multithreading
511 511
      * @{
512 512
      */
513 513
     struct H264Context *thread_context[MAX_THREADS];
... ...
@@ -38,14 +38,14 @@
38 38
  * QCELP unpacked data frame
39 39
  */
40 40
 typedef struct {
41
-/// @defgroup qcelp_codebook_parameters QCELP excitation codebook parameters
41
+/// @name QCELP excitation codebook parameters
42 42
 /// @{
43 43
     uint8_t cbsign[16]; ///!< sign of the codebook gain for each codebook subframe
44 44
     uint8_t cbgain[16]; ///!< unsigned codebook gain for each codebook subframe
45 45
     uint8_t cindex[16]; ///!< codebook index for each codebook subframe
46 46
 /// @}
47 47
 
48
-/// @defgroup qcelp_pitch_parameters QCELP pitch prediction parameters
48
+/// @name QCELP pitch prediction parameters
49 49
 /// @{
50 50
     uint8_t plag[4];    ///!< pitch lag for each pitch subframe
51 51
     uint8_t pfrac[4];   ///!< fractional pitch lag for each pitch subframe
... ...
@@ -62,8 +62,10 @@ static const int rv34_mb_type_to_lavc[12] = {
62 62
 
63 63
 static RV34VLC intra_vlcs[NUM_INTRA_TABLES], inter_vlcs[NUM_INTER_TABLES];
64 64
 
65
+static int rv34_decode_mv(RV34DecContext *r, int block_type);
66
+
65 67
 /**
66
- * @defgroup vlc RV30/40 VLC generating functions
68
+ * @name RV30/40 VLC generating functions
67 69
  * @{
68 70
  */
69 71
 
... ...
@@ -171,7 +173,7 @@ static av_cold void rv34_init_tables(void)
171 171
 
172 172
 
173 173
 /**
174
- * @defgroup transform RV30/40 inverse transform functions
174
+ * @name RV30/40 inverse transform functions
175 175
  * @{
176 176
  */
177 177
 
... ...
@@ -246,7 +248,7 @@ static void rv34_inv_transform_noround(DCTELEM *block){
246 246
 
247 247
 
248 248
 /**
249
- * @defgroup block RV30/40 4x4 block decoding functions
249
+ * @name RV30/40 4x4 block decoding functions
250 250
  * @{
251 251
  */
252 252
 
... ...
@@ -393,7 +395,7 @@ static inline void rv34_dequant4x4_16x16(DCTELEM *block, int Qdc, int Q)
393 393
 
394 394
 
395 395
 /**
396
- * @defgroup rv3040_bitstream RV30/40 bitstream parsing
396
+ * @name RV30/40 bitstream parsing
397 397
  * @{
398 398
  */
399 399
 
... ...
@@ -432,10 +434,76 @@ static inline int rv34_decode_dquant(GetBitContext *gb, int quant)
432 432
         return get_bits(gb, 5);
433 433
 }
434 434
 
435
+/**
436
+ * Decode macroblock header and return CBP in case of success, -1 otherwise.
437
+ */
438
+static int rv34_decode_mb_header(RV34DecContext *r, int8_t *intra_types)
439
+{
440
+    MpegEncContext *s = &r->s;
441
+    GetBitContext *gb = &s->gb;
442
+    int mb_pos = s->mb_x + s->mb_y * s->mb_stride;
443
+    int i, t;
444
+
445
+    if(!r->si.type){
446
+        r->is16 = get_bits1(gb);
447
+        if(!r->is16 && !r->rv30){
448
+            if(!get_bits1(gb))
449
+                av_log(s->avctx, AV_LOG_ERROR, "Need DQUANT\n");
450
+        }
451
+        s->current_picture_ptr->mb_type[mb_pos] = r->is16 ? MB_TYPE_INTRA16x16 : MB_TYPE_INTRA;
452
+        r->block_type = r->is16 ? RV34_MB_TYPE_INTRA16x16 : RV34_MB_TYPE_INTRA;
453
+    }else{
454
+        r->block_type = r->decode_mb_info(r);
455
+        if(r->block_type == -1)
456
+            return -1;
457
+        s->current_picture_ptr->mb_type[mb_pos] = rv34_mb_type_to_lavc[r->block_type];
458
+        r->mb_type[mb_pos] = r->block_type;
459
+        if(r->block_type == RV34_MB_SKIP){
460
+            if(s->pict_type == AV_PICTURE_TYPE_P)
461
+                r->mb_type[mb_pos] = RV34_MB_P_16x16;
462
+            if(s->pict_type == AV_PICTURE_TYPE_B)
463
+                r->mb_type[mb_pos] = RV34_MB_B_DIRECT;
464
+        }
465
+        r->is16 = !!IS_INTRA16x16(s->current_picture_ptr->mb_type[mb_pos]);
466
+        rv34_decode_mv(r, r->block_type);
467
+        if(r->block_type == RV34_MB_SKIP){
468
+            fill_rectangle(intra_types, 4, 4, r->intra_types_stride, 0, sizeof(intra_types[0]));
469
+            return 0;
470
+        }
471
+        r->chroma_vlc = 1;
472
+        r->luma_vlc   = 0;
473
+    }
474
+    if(IS_INTRA(s->current_picture_ptr->mb_type[mb_pos])){
475
+        if(r->is16){
476
+            t = get_bits(gb, 2);
477
+            fill_rectangle(intra_types, 4, 4, r->intra_types_stride, t, sizeof(intra_types[0]));
478
+            r->luma_vlc   = 2;
479
+        }else{
480
+            if(r->decode_intra_types(r, gb, intra_types) < 0)
481
+                return -1;
482
+            r->luma_vlc   = 1;
483
+        }
484
+        r->chroma_vlc = 0;
485
+        r->cur_vlcs = choose_vlc_set(r->si.quant, r->si.vlc_set, 0);
486
+    }else{
487
+        for(i = 0; i < 16; i++)
488
+            intra_types[(i & 3) + (i>>2) * r->intra_types_stride] = 0;
489
+        r->cur_vlcs = choose_vlc_set(r->si.quant, r->si.vlc_set, 1);
490
+        if(r->mb_type[mb_pos] == RV34_MB_P_MIX16x16){
491
+            r->is16 = 1;
492
+            r->chroma_vlc = 1;
493
+            r->luma_vlc   = 2;
494
+            r->cur_vlcs = choose_vlc_set(r->si.quant, r->si.vlc_set, 0);
495
+        }
496
+    }
497
+
498
+    return rv34_decode_cbp(gb, r->cur_vlcs, r->is16);
499
+}
500
+
435 501
 /** @} */ //bitstream functions
436 502
 
437 503
 /**
438
- * @defgroup mv motion vector related code (prediction, reconstruction, motion compensation)
504
+ * @name motion vector related code (prediction, reconstruction, motion compensation)
439 505
  * @{
440 506
  */
441 507
 
... ...
@@ -885,7 +953,7 @@ static int rv34_decode_mv(RV34DecContext *r, int block_type)
885 885
 /** @} */ // mv group
886 886
 
887 887
 /**
888
- * @defgroup recons Macroblock reconstruction functions
888
+ * @name Macroblock reconstruction functions
889 889
  * @{
890 890
  */
891 891
 /** mapping of RV30/40 intra prediction types to standard H.264 types */
... ...
@@ -1027,79 +1095,6 @@ static void rv34_output_macroblock(RV34DecContext *r, int8_t *intra_types, int c
1027 1027
     }
1028 1028
 }
1029 1029
 
1030
-/** @} */ // recons group
1031
-
1032
-/**
1033
- * @addtogroup bitstream
1034
- * Decode macroblock header and return CBP in case of success, -1 otherwise.
1035
- */
1036
-static int rv34_decode_mb_header(RV34DecContext *r, int8_t *intra_types)
1037
-{
1038
-    MpegEncContext *s = &r->s;
1039
-    GetBitContext *gb = &s->gb;
1040
-    int mb_pos = s->mb_x + s->mb_y * s->mb_stride;
1041
-    int i, t;
1042
-
1043
-    if(!r->si.type){
1044
-        r->is16 = get_bits1(gb);
1045
-        if(!r->is16 && !r->rv30){
1046
-            if(!get_bits1(gb))
1047
-                av_log(s->avctx, AV_LOG_ERROR, "Need DQUANT\n");
1048
-        }
1049
-        s->current_picture_ptr->mb_type[mb_pos] = r->is16 ? MB_TYPE_INTRA16x16 : MB_TYPE_INTRA;
1050
-        r->block_type = r->is16 ? RV34_MB_TYPE_INTRA16x16 : RV34_MB_TYPE_INTRA;
1051
-    }else{
1052
-        r->block_type = r->decode_mb_info(r);
1053
-        if(r->block_type == -1)
1054
-            return -1;
1055
-        s->current_picture_ptr->mb_type[mb_pos] = rv34_mb_type_to_lavc[r->block_type];
1056
-        r->mb_type[mb_pos] = r->block_type;
1057
-        if(r->block_type == RV34_MB_SKIP){
1058
-            if(s->pict_type == AV_PICTURE_TYPE_P)
1059
-                r->mb_type[mb_pos] = RV34_MB_P_16x16;
1060
-            if(s->pict_type == AV_PICTURE_TYPE_B)
1061
-                r->mb_type[mb_pos] = RV34_MB_B_DIRECT;
1062
-        }
1063
-        r->is16 = !!IS_INTRA16x16(s->current_picture_ptr->mb_type[mb_pos]);
1064
-        rv34_decode_mv(r, r->block_type);
1065
-        if(r->block_type == RV34_MB_SKIP){
1066
-            fill_rectangle(intra_types, 4, 4, r->intra_types_stride, 0, sizeof(intra_types[0]));
1067
-            return 0;
1068
-        }
1069
-        r->chroma_vlc = 1;
1070
-        r->luma_vlc   = 0;
1071
-    }
1072
-    if(IS_INTRA(s->current_picture_ptr->mb_type[mb_pos])){
1073
-        if(r->is16){
1074
-            t = get_bits(gb, 2);
1075
-            fill_rectangle(intra_types, 4, 4, r->intra_types_stride, t, sizeof(intra_types[0]));
1076
-            r->luma_vlc   = 2;
1077
-        }else{
1078
-            if(r->decode_intra_types(r, gb, intra_types) < 0)
1079
-                return -1;
1080
-            r->luma_vlc   = 1;
1081
-        }
1082
-        r->chroma_vlc = 0;
1083
-        r->cur_vlcs = choose_vlc_set(r->si.quant, r->si.vlc_set, 0);
1084
-    }else{
1085
-        for(i = 0; i < 16; i++)
1086
-            intra_types[(i & 3) + (i>>2) * r->intra_types_stride] = 0;
1087
-        r->cur_vlcs = choose_vlc_set(r->si.quant, r->si.vlc_set, 1);
1088
-        if(r->mb_type[mb_pos] == RV34_MB_P_MIX16x16){
1089
-            r->is16 = 1;
1090
-            r->chroma_vlc = 1;
1091
-            r->luma_vlc   = 2;
1092
-            r->cur_vlcs = choose_vlc_set(r->si.quant, r->si.vlc_set, 0);
1093
-        }
1094
-    }
1095
-
1096
-    return rv34_decode_cbp(gb, r->cur_vlcs, r->is16);
1097
-}
1098
-
1099
-/**
1100
- * @addtogroup recons
1101
- * @{
1102
- */
1103 1030
 /**
1104 1031
  * mask for retrieving all bits in coded block pattern
1105 1032
  * corresponding to one 8x8 block
... ...
@@ -1109,6 +1104,8 @@ static int rv34_decode_mb_header(RV34DecContext *r, int8_t *intra_types)
1109 1109
 #define U_CBP_MASK 0x0F0000
1110 1110
 #define V_CBP_MASK 0xF00000
1111 1111
 
1112
+/** @} */ // recons group
1113
+
1112 1114
 
1113 1115
 static void rv34_apply_differences(RV34DecContext *r, int cbp)
1114 1116
 {
... ...
@@ -65,7 +65,7 @@ static const uint8_t rv40_luma_dc_quant[2][32] = {
65 65
 };
66 66
 
67 67
 /**
68
- * @defgroup loopfilter coefficients used by the RV40 loop filter
68
+ * @name Coefficients used by the RV40 loop filter
69 69
  * @{
70 70
  */
71 71
 /**
... ...
@@ -42,7 +42,7 @@ typedef struct {
42 42
     uint8_t bs_xover_band;
43 43
 
44 44
     /**
45
-     * @defgroup bs_header_extra_1     Variables associated with bs_header_extra_1
45
+     * @name Variables associated with bs_header_extra_1
46 46
      * @{
47 47
      */
48 48
     uint8_t bs_freq_scale;
... ...
@@ -58,7 +58,7 @@ typedef struct {
58 58
  */
59 59
 typedef struct {
60 60
     /**
61
-     * @defgroup aac_bitstream     Main bitstream data variables
61
+     * @name Main bitstream data variables
62 62
      * @{
63 63
      */
64 64
     unsigned           bs_frame_class;
... ...
@@ -74,7 +74,7 @@ typedef struct {
74 74
     /** @} */
75 75
 
76 76
     /**
77
-     * @defgroup state         State variables
77
+     * @name State variables
78 78
      * @{
79 79
      */
80 80
     DECLARE_ALIGNED(16, float, synthesis_filterbank_samples)[SBR_SYNTHESIS_BUF_SIZE];
... ...
@@ -116,7 +116,7 @@ typedef struct {
116 116
     SpectrumParameters spectrum_params;
117 117
     int                bs_amp_res_header;
118 118
     /**
119
-     * @defgroup bs_header_extra_2     variables associated with bs_header_extra_2
119
+     * @name Variables associated with bs_header_extra_2
120 120
      * @{
121 121
      */
122 122
     unsigned           bs_limiter_bands;
... ...
@@ -56,7 +56,7 @@ void write_##type##_2d_array(const void *arg, int len, int len2)\
56 56
 }
57 57
 
58 58
 /**
59
- * @defgroup printfuncs Predefined functions for printing tables
59
+ * @name Predefined functions for printing tables
60 60
  *
61 61
  * \{
62 62
  */
... ...
@@ -40,7 +40,7 @@
40 40
 
41 41
 /***********************************************************************/
42 42
 /**
43
- * @defgroup vc1bitplane VC-1 Bitplane decoding
43
+ * @name VC-1 Bitplane decoding
44 44
  * @see 8.7, p56
45 45
  * @{
46 46
  */
... ...
@@ -137,7 +137,7 @@ static int vc1_init_common(VC1Context *v)
137 137
 
138 138
 /***********************************************************************/
139 139
 /**
140
- * @defgroup vc1bitplane VC-1 Bitplane decoding
140
+ * @name VC-1 Bitplane decoding
141 141
  * @see 8.7, p56
142 142
  * @{
143 143
  */
... ...
@@ -774,7 +774,7 @@ static void vc1_mc_4mv_chroma(VC1Context *v)
774 774
 
775 775
 /***********************************************************************/
776 776
 /**
777
- * @defgroup vc1block VC-1 Block-level functions
777
+ * @name VC-1 Block-level functions
778 778
  * @see 7.1.4, p91 and 8.1.1.7, p(1)04
779 779
  * @{
780 780
  */
... ...
@@ -1512,7 +1512,7 @@ static inline int vc1_pred_dc(MpegEncContext *s, int overlap, int pq, int n,
1512 1512
 /** @} */ // Block group
1513 1513
 
1514 1514
 /**
1515
- * @defgroup vc1_std_mb VC1 Macroblock-level functions in Simple/Main Profiles
1515
+ * @name VC1 Macroblock-level functions in Simple/Main Profiles
1516 1516
  * @see 7.1.4, p91 and 8.1.1.7, p(1)04
1517 1517
  * @{
1518 1518
  */
... ...
@@ -128,9 +128,7 @@ static const struct frame_type_desc {
128 128
  */
129 129
 typedef struct {
130 130
     /**
131
-     * @defgroup struct_global Global values
132
-     * Global values, specified in the stream header / extradata or used
133
-     * all over.
131
+     * @name Global values specified in the stream header / extradata or used all over.
134 132
      * @{
135 133
      */
136 134
     GetBitContext gb;             ///< packet bitreader. During decoder init,
... ...
@@ -182,8 +180,9 @@ typedef struct {
182 182
 
183 183
     /**
184 184
      * @}
185
-     * @defgroup struct_packet Packet values
186
-     * Packet values, specified in the packet header or related to a packet.
185
+     *
186
+     * @name Packet values specified in the packet header or related to a packet.
187
+     *
187 188
      * A packet is considered to be a single unit of data provided to this
188 189
      * decoder by the demuxer.
189 190
      * @{
... ...
@@ -213,7 +212,8 @@ typedef struct {
213 213
 
214 214
     /**
215 215
      * @}
216
-     * @defgroup struct_frame Frame and superframe values
216
+     *
217
+     * @name Frame and superframe values
217 218
      * Superframe and frame data - these can change from frame to frame,
218 219
      * although some of them do in that case serve as a cache / history for
219 220
      * the next frame or superframe.
... ...
@@ -256,7 +256,9 @@ typedef struct {
256 256
     float synth_history[MAX_LSPS]; ///< see #excitation_history
257 257
     /**
258 258
      * @}
259
-     * @defgroup post_filter Postfilter values
259
+     *
260
+     * @name Postfilter values
261
+     *
260 262
      * Variables used for postfilter implementation, mostly history for
261 263
      * smoothing and so on, and context variables for FFT/iFFT.
262 264
      * @{
... ...
@@ -432,7 +434,7 @@ static av_cold int wmavoice_decode_init(AVCodecContext *ctx)
432 432
 }
433 433
 
434 434
 /**
435
- * @defgroup postfilter Postfilter functions
435
+ * @name Postfilter functions
436 436
  * Postfilter functions (gain control, wiener denoise filter, DC filter,
437 437
  * kalman smoothening, plus surrounding code to wrap it)
438 438
  * @{
... ...
@@ -825,7 +827,7 @@ static void dequant_lsps(double *lsps, int num,
825 825
 }
826 826
 
827 827
 /**
828
- * @defgroup lsp_dequant LSP dequantization routines
828
+ * @name LSP dequantization routines
829 829
  * LSP dequantization routines, for 10/16LSPs and independent/residual coding.
830 830
  * @note we assume enough bits are available, caller should check.
831 831
  * lsp10i() consumes 24 bits; lsp10r() consumes an additional 24 bits;
... ...
@@ -969,7 +971,7 @@ static void dequant_lsp16r(GetBitContext *gb,
969 969
 
970 970
 /**
971 971
  * @}
972
- * @defgroup aw Pitch-adaptive window coding functions
972
+ * @name Pitch-adaptive window coding functions
973 973
  * The next few functions are for pitch-adaptive window coding.
974 974
  * @{
975 975
  */
... ...
@@ -145,7 +145,7 @@ typedef struct URLPollEntry {
145 145
 attribute_deprecated int url_poll(URLPollEntry *poll_table, int n, int timeout);
146 146
 
147 147
 /**
148
- * @defgroup open_modes URL open modes
148
+ * @name URL open modes
149 149
  * The flags argument to url_open and cosins must be one of the following
150 150
  * constants, optionally ORed with other flags.
151 151
  * @{
... ...
@@ -176,7 +176,7 @@ extern URLInterruptCB *url_interrupt_cb;
176 176
 
177 177
 /**
178 178
  * @defgroup old_url_funcs Old url_* functions
179
- * @deprecated use the buffered API based on AVIOContext instead
179
+ * The following functions are deprecated. Use the buffered API based on #AVIOContext instead.
180 180
  * @{
181 181
  */
182 182
 attribute_deprecated int url_open_protocol (URLContext **puc, struct URLProtocol *up,
... ...
@@ -235,7 +235,7 @@ attribute_deprecated AVIOContext *av_alloc_put_byte(
235 235
 
236 236
 /**
237 237
  * @defgroup old_avio_funcs Old put_/get_*() functions
238
- * @deprecated use the avio_ -prefixed functions instead.
238
+ * The following functions are deprecated. Use the "avio_"-prefixed functions instead.
239 239
  * @{
240 240
  */
241 241
 attribute_deprecated int          get_buffer(AVIOContext *s, unsigned char *buf, int size);
... ...
@@ -272,7 +272,7 @@ attribute_deprecated int64_t av_url_read_fseek (AVIOContext *h,    int stream_in
272 272
 
273 273
 /**
274 274
  * @defgroup old_url_f_funcs Old url_f* functions
275
- * @deprecated use the avio_ -prefixed functions instead.
275
+ * The following functions are deprecated, use the "avio_"-prefixed functions instead.
276 276
  * @{
277 277
  */
278 278
 attribute_deprecated int url_fopen( AVIOContext **s, const char *url, int flags);
... ...
@@ -471,7 +471,7 @@ void avio_flush(AVIOContext *s);
471 471
 int avio_read(AVIOContext *s, unsigned char *buf, int size);
472 472
 
473 473
 /**
474
- * @defgroup avio_read Functions for reading from AVIOContext.
474
+ * @name Functions for reading from AVIOContext
475 475
  * @{
476 476
  *
477 477
  * @note return 0 if EOF, so you cannot use it if EOF handling is
... ...
@@ -515,7 +515,7 @@ int avio_get_str16be(AVIOContext *pb, int maxlen, char *buf, int buflen);
515 515
 
516 516
 
517 517
 /**
518
- * @defgroup open_modes URL open modes
518
+ * @name URL open modes
519 519
  * The flags argument to avio_open must be one of the following
520 520
  * constants, optionally ORed with other flags.
521 521
  * @{
... ...
@@ -138,7 +138,7 @@ int ff_rtmp_packet_write(URLContext *h, RTMPPacket *p,
138 138
 void ff_rtmp_packet_dump(void *ctx, RTMPPacket *p);
139 139
 
140 140
 /**
141
- * @defgroup amffuncs functions used to work with AMF format (which is also used in .flv)
141
+ * @name Functions used to work with the AMF format (which is also used in .flv)
142 142
  * @see amf_* funcs in libavformat/flvdec.c
143 143
  * @{
144 144
  */
... ...
@@ -24,7 +24,7 @@
24 24
 
25 25
 #include <stdint.h>
26 26
 
27
-/** @defgroup errflags Error flags returned by av_lzo1x_decode
27
+/** @name Error flags returned by av_lzo1x_decode
28 28
   * \{ */
29 29
 //! end of the input buffer reached before decoding finished
30 30
 #define AV_LZO_INPUT_DEPLETED 1