diff --git a/libavcodec/dv.c b/libavcodec/dv.c
index bf79caa5b4..c0cdee91e6 100644
--- a/libavcodec/dv.c
+++ b/libavcodec/dv.c
@@ -62,9 +62,11 @@ typedef struct DVVideoContext {
     void (*idct_put[2])(uint8_t *dest, int line_size, DCTELEM *block);
 } DVVideoContext;
 
-/* MultiThreading - dv_anchor applies to entire DV codec, not just the avcontext */
-/* one element is needed for each video segment in a DV frame */
-/* at most there are 4 DIF channels * 12 DIF sequences * 27 video segments (1080i50) */
+/**
+ * MultiThreading - dv_anchor applies to entire DV codec, not just the avcontext
+ * one element is needed for each video segment in a DV frame
+ * at most there are 4 DIF channels * 12 DIF sequences * 27 video segments (1080i50)
+ */
 #define DV_ANCHOR_SIZE (4*12*27)
 
 static void* dv_anchor[DV_ANCHOR_SIZE];
diff --git a/libavcodec/dvdata.h b/libavcodec/dvdata.h
index 40206455f6..362929dafd 100644
--- a/libavcodec/dvdata.h
+++ b/libavcodec/dvdata.h
@@ -6073,7 +6073,9 @@ static const int dv_iweight_248[64] = {
  22017, 25191, 24457, 27962, 22733, 24600, 25971, 29642,
 };
 
-/* the "inverse" DV100 weights are actually just the spec weights (zig-zagged) */
+/**
+ * the "inverse" DV100 weights are actually just the spec weights (zig-zagged)
+ */
 static const int dv_iweight_1080_y[64] = {
     128, 16, 16, 17, 17, 17, 18, 18,
     18, 18, 18, 18, 19, 18, 18, 19,
@@ -6371,10 +6373,14 @@ enum dv_pack_type {
 /* minimum number of bytes to read from a DV stream in order to determine the profile */
 #define DV_PROFILE_BYTES (6*80) /* 6 DIF blocks */
 
-/* largest possible DV frame, in bytes (1080i50) */
+/**
+ * largest possible DV frame, in bytes (1080i50)
+ */
 #define DV_MAX_FRAME_SIZE 576000
 
-/* maximum number of blocks per macroblock in any DV format */
+/**
+ * maximum number of blocks per macroblock in any DV format
+ */
 #define DV_MAX_BPM 8
 
 static inline const DVprofile* dv_frame_profile(const uint8_t* frame)