[FFmpeg-devel] [PATCH] lavc/vaapi: Fix Doxygen groups and add some file briefings

[Timothy Gu]

---
 libavcodec/vaapi.c          | 8 --------
 libavcodec/vaapi_internal.h | 8 +++-----
 libavcodec/vaapi_mpeg2.c    | 6 ++++++
 libavcodec/vaapi_mpeg4.c    | 6 ++++++
 libavcodec/vaapi_vc1.c      | 6 ++++++
 5 files changed, 21 insertions(+), 13 deletions(-)

diff --git a/libavcodec/vaapi.c b/libavcodec/vaapi.c
index 94959bf..6d916d1 100644
--- a/libavcodec/vaapi.c
+++ b/libavcodec/vaapi.c
@@ -24,12 +24,6 @@
 #include "h264.h"
 #include "vaapi_internal.h"
 
-/**
- * @addtogroup VAAPI_Decoding
- *
- * @{
- */
-
 static void destroy_buffers(VADisplay display, VABufferID *buffers, unsigned int n_buffers)
 {
     unsigned int i;
@@ -218,5 +212,3 @@ finish:
     ff_vaapi_common_end_frame(avctx);
     return ret;
 }
-
-/* @} */
diff --git a/libavcodec/vaapi_internal.h b/libavcodec/vaapi_internal.h
index 1ac0e9f..f94e89e 100644
--- a/libavcodec/vaapi_internal.h
+++ b/libavcodec/vaapi_internal.h
@@ -30,9 +30,9 @@
 #include "mpegvideo.h"
 
 /**
- * @addtogroup VAAPI_Decoding
- *
- * @{
+ * @file
+ * @ingroup lavc_codec_hwaccel_vaapi
+ * Internal libavcodec VA API header.
  */
 
 /** Extract VASurfaceID from a Picture */
@@ -67,6 +67,4 @@ int ff_vaapi_mpeg_end_frame(AVCodecContext *avctx);
 int ff_vaapi_commit_slices(struct vaapi_context *vactx);
 int ff_vaapi_render_picture(struct vaapi_context *vactx, VASurfaceID surface);
 
-/* @} */
-
 #endif /* AVCODEC_VAAPI_INTERNAL_H */
diff --git a/libavcodec/vaapi_mpeg2.c b/libavcodec/vaapi_mpeg2.c
index d626f24..2e9e554 100644
--- a/libavcodec/vaapi_mpeg2.c
+++ b/libavcodec/vaapi_mpeg2.c
@@ -22,6 +22,12 @@
 
 #include "vaapi_internal.h"
 
+/**
+ * @file
+ * This file implements the glue code between FFmpeg's and VA API's
+ * structures for MPEG-2 decoding.
+ */
+
 /** Reconstruct bitstream f_code */
 static inline int mpeg2_get_f_code(MpegEncContext *s)
 {
diff --git a/libavcodec/vaapi_mpeg4.c b/libavcodec/vaapi_mpeg4.c
index bcc0eba..f82cf98 100644
--- a/libavcodec/vaapi_mpeg4.c
+++ b/libavcodec/vaapi_mpeg4.c
@@ -23,6 +23,12 @@
 #include "vaapi_internal.h"
 #include "h263.h"
 
+/**
+ * @file
+ * This file implements the glue code between FFmpeg's and VA API's
+ * structures for MPEG-4 decoding.
+ */
+
 /** Reconstruct bitstream intra_dc_vlc_thr */
 static int mpeg4_get_intra_dc_vlc_thr(MpegEncContext *s)
 {
diff --git a/libavcodec/vaapi_vc1.c b/libavcodec/vaapi_vc1.c
index b8f0530..b551a51 100644
--- a/libavcodec/vaapi_vc1.c
+++ b/libavcodec/vaapi_vc1.c
@@ -24,6 +24,12 @@
 #include "vc1.h"
 #include "vc1data.h"
 
+/**
+ * @file
+ * This file implements the glue code between FFmpeg's and VA API's
+ * structures for VC-1 decoding.
+ */
+
 /** Translate FFmpeg MV modes to VA API */
 static int get_VAMvModeVC1(enum MVModes mv_mode)
 {
-- 
1.8.1.2