diff --git a/libavcodec/atrac3.c b/libavcodec/atrac3.c
index 18562a6b85..46aee65f10 100644
--- a/libavcodec/atrac3.c
+++ b/libavcodec/atrac3.c
@@ -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
diff --git a/libavcodec/videodsp.h b/libavcodec/videodsp.h
index 7d785939f3..bd2f7635b4 100644
--- a/libavcodec/videodsp.h
+++ b/libavcodec/videodsp.h
@@ -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;
diff --git a/libavutil/pixdesc.h b/libavutil/pixdesc.h
index b1ba03f089..e5a16f418b 100644
--- a/libavutil/pixdesc.h
+++ b/libavutil/pixdesc.h
@@ -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