[FFmpeg-devel] [PATCH] lavc/vdpau: Add and fix Doxygen groups

[Timothy Gu]

---
 libavcodec/vdpau.c          |  2 +-
 libavcodec/vdpau_h264.c     | 11 +++++++++++
 libavcodec/vdpau_internal.h | 10 ++++++++++
 libavcodec/vdpau_mpeg12.c   | 11 +++++++++++
 libavcodec/vdpau_mpeg4.c    | 11 +++++++++++
 libavcodec/vdpau_vc1.c      | 11 +++++++++++
 6 files changed, 55 insertions(+), 1 deletion(-)

diff --git a/libavcodec/vdpau.c b/libavcodec/vdpau.c
index 04355b0..394f04f 100644
--- a/libavcodec/vdpau.c
+++ b/libavcodec/vdpau.c
@@ -33,7 +33,7 @@
 #include "vdpau_internal.h"
 
 /**
- * @addtogroup VDPAU_Decoding
+ * @ingroup lavc_codec_hwaccel_vdpau
  *
  * @{
  */
diff --git a/libavcodec/vdpau_h264.c b/libavcodec/vdpau_h264.c
index ad1aff0..a372b31 100644
--- a/libavcodec/vdpau_h264.c
+++ b/libavcodec/vdpau_h264.c
@@ -28,6 +28,15 @@
 #include "vdpau.h"
 #include "vdpau_internal.h"
 
+/**
+ * @file
+ * @ingroup lavc_codec_hwaccel_vdpau
+ * This file implements the glue code between FFmpeg's and VDPAU's
+ * structures for H.264 decoding.
+ *
+ * @{
+ */
+
 static int32_t h264_foc(int foc)
 {
     if (foc == INT_MAX)
@@ -208,3 +217,5 @@ AVHWAccel ff_h264_vdpau_hwaccel = {
     .end_frame      = vdpau_h264_end_frame,
     .decode_slice   = vdpau_h264_decode_slice,
 };
+
+/* @} */
diff --git a/libavcodec/vdpau_internal.h b/libavcodec/vdpau_internal.h
index 790b3ef..9cdacb0 100644
--- a/libavcodec/vdpau_internal.h
+++ b/libavcodec/vdpau_internal.h
@@ -28,6 +28,14 @@
 #include "h264.h"
 #include "mpegvideo.h"
 
+/**
+ * @file
+ * @ingroup lavc_codec_hwaccel_vdpau
+ * Private libavcodec VDPAU header.
+ *
+ * @{
+ */
+
 /** Extract VdpVideoSurface from a Picture */
 static inline uintptr_t ff_vdpau_get_surface_id(Picture *pic)
 {
@@ -58,3 +66,5 @@ void ff_vdpau_mpeg4_decode_picture(MpegEncContext *s, const uint8_t *buf,
                                    int buf_size);
 
 #endif /* AVCODEC_VDPAU_INTERNAL_H */
+
+/* @} */
diff --git a/libavcodec/vdpau_mpeg12.c b/libavcodec/vdpau_mpeg12.c
index 74e3f16..74bf8a4 100644
--- a/libavcodec/vdpau_mpeg12.c
+++ b/libavcodec/vdpau_mpeg12.c
@@ -27,6 +27,15 @@
 #include "vdpau.h"
 #include "vdpau_internal.h"
 
+/**
+ * @file
+ * @ingroup lavc_codec_hwaccel_vdpau
+ * This file implements the glue code between FFmpeg's and VDPAU's
+ * structures for MPEG-1/2 decoding.
+ *
+ * @{
+ */
+
 static int vdpau_mpeg_start_frame(AVCodecContext *avctx,
                                   const uint8_t *buffer, uint32_t size)
 {
@@ -114,3 +123,5 @@ AVHWAccel ff_mpeg2_vdpau_hwaccel = {
     .decode_slice   = vdpau_mpeg_decode_slice,
 };
 #endif
+
+/* @} */
diff --git a/libavcodec/vdpau_mpeg4.c b/libavcodec/vdpau_mpeg4.c
index cb8ee0a..6a47378 100644
--- a/libavcodec/vdpau_mpeg4.c
+++ b/libavcodec/vdpau_mpeg4.c
@@ -27,6 +27,15 @@
 #include "vdpau.h"
 #include "vdpau_internal.h"
 
+/**
+ * @file
+ * @ingroup lavc_codec_hwaccel_vdpau
+ * This file implements the glue code between FFmpeg's and VDPAU's
+ * structures for MPEG-4 ASP decoding.
+ *
+ * @{
+ */
+
 static int vdpau_mpeg4_start_frame(AVCodecContext *avctx,
                                    const uint8_t *buffer, uint32_t size)
 {
@@ -108,3 +117,5 @@ AVHWAccel ff_mpeg4_vdpau_hwaccel = {
     .decode_slice   = vdpau_mpeg4_decode_slice,
 };
 #endif
+
+/* @} */
diff --git a/libavcodec/vdpau_vc1.c b/libavcodec/vdpau_vc1.c
index 993ef26..eb05a4b 100644
--- a/libavcodec/vdpau_vc1.c
+++ b/libavcodec/vdpau_vc1.c
@@ -28,6 +28,15 @@
 #include "vdpau.h"
 #include "vdpau_internal.h"
 
+/**
+ * @file
+ * @ingroup lavc_codec_hwaccel_vdpau
+ * This file implements the glue code between FFmpeg's and VDPAU's
+ * structures for VC-1 decoding.
+ *
+ * @{
+ */
+
 static int vdpau_vc1_start_frame(AVCodecContext *avctx,
                                  const uint8_t *buffer, uint32_t size)
 {
@@ -126,3 +135,5 @@ AVHWAccel ff_vc1_vdpau_hwaccel = {
     .end_frame      = ff_vdpau_mpeg_end_frame,
     .decode_slice   = vdpau_vc1_decode_slice,
 };
+
+/* @} */
-- 
1.8.1.2