@@ -123,7 +123,7 @@ static float gain_tab1[16];

 static float gain_tab2[31];

-/*

+/**

  * Regular 512 points IMDCT without overlapping, with the exception of the

  * swapping of odd bands caused by the reverse spectra of the QMF.

  *

@@ -205,7 +205,7 @@ static av_cold int atrac3_decode_close(AVCodecContext *avctx)

     return 0;

 }

-/*

+/**

  * Mantissa decoding

  *

  * @param selector     which table the output values are coded with

@@ -267,7 +267,7 @@ static void read_quant_spectral_coeffs(GetBitContext *gb, int selector,

     }

 }

-/*

+/**

  * Restore the quantized band spectrum coefficients

  *

  * @return subband count, fix for broken specification/files

@@ -324,7 +324,7 @@ static int decode_spectrum(GetBitContext *gb, float *output)

     return num_subbands;

 }

-/*

+/**

  * Restore the quantized tonal components

  *

  * @param components tonal components

@@ -408,7 +408,7 @@ static int decode_tonal_components(GetBitContext *gb,

     return component_count;

 }

-/*

+/**

  * Decode gain parameters for the coded bands

  *

  * @param block      the gainblock for the current band

@@ -443,7 +443,7 @@ static int decode_gain_control(GetBitContext *gb, GainBlock *block,

     return 0;

 }

-/*

+/**

  * Apply gain parameters and perform the MDCT overlapping part

  *

  * @param input   input buffer

@@ -500,7 +500,7 @@ static void gain_compensate_and_overlap(float *input, float *prev,

     memcpy(prev, &input[256], 256 * sizeof(*prev));

 }

-/*

+/**

  * Combine the tonal band spectrum and regular band spectrum

  *

  * @param spectrum        output spectrum buffer

@@ -627,7 +627,7 @@ static void channel_weighting(float *su1, float *su2, int *p3)

     }

 }

-/*

+/**

  * Decode a Sound Unit

  *

  * @param snd           the channel unit to be used

@@ -54,9 +54,9 @@ typedef struct VideoDSPContext {

     /**

      * Prefetch memory into cache (if supported by hardware).

      *

-     * @buf pointer to buffer to prefetch memory from

-     * @stride distance between two lines of buf (in bytes)

-     * @h number of lines to prefetch

+     * @param buf    pointer to buffer to prefetch memory from

+     * @param stride distance between two lines of buf (in bytes)

+     * @param h      number of lines to prefetch

      */

     void (*prefetch)(uint8_t *buf, ptrdiff_t stride, int h);

 } VideoDSPContext;

@@ -122,7 +122,7 @@ typedef struct AVPixFmtDescriptor{

 #if FF_API_PIX_FMT

 /**

- * @deprecate use the AV_PIX_FMT_FLAG_* flags

+ * @deprecated use the AV_PIX_FMT_FLAG_* flags

  */

 #define PIX_FMT_BE        AV_PIX_FMT_FLAG_BE

 #define PIX_FMT_PAL       AV_PIX_FMT_FLAG_PAL