[FFmpeg-devel] [PATCH v3 17/54] avutil/display: consolidate group doxy

Marvin Scholz epirat07 at gmail.com
Sun Sep 25 03:10:44 EEST 2022


Make it a bit easier to grasp the grouping when not
unnecessarily splitting comment blocks.

Additionally do not try to add lavu_video_display to itself, resolving
the following doxy warning:
  warning: Refusing to add group lavu_video_display to itself
---
 libavutil/display.h | 13 ++++---------
 1 file changed, 4 insertions(+), 9 deletions(-)

diff --git a/libavutil/display.h b/libavutil/display.h
index 31d8bef361..2d6f335960 100644
--- a/libavutil/display.h
+++ b/libavutil/display.h
@@ -29,15 +29,9 @@
 #include <stdint.h>
 
 /**
- * @addtogroup lavu_video
- * @{
- *
  * @defgroup lavu_video_display Display transformation matrix functions
- * @{
- */
-
-/**
- * @addtogroup lavu_video_display
+ * @ingroup lavu_video
+ *
  * The display transformation matrix specifies an affine transformation that
  * should be applied to video frames for correct presentation. It is compatible
  * with the matrices stored in the ISO/IEC 14496-12 container format.
@@ -71,6 +65,8 @@
  *   q' = (b * p + d * q + y) / z;
  *   z  =  u * p + v * q + w
  * @endcode
+ *
+ * @{
  */
 
 /**
@@ -106,7 +102,6 @@ void av_display_rotation_set(int32_t matrix[9], double angle);
 void av_display_matrix_flip(int32_t matrix[9], int hflip, int vflip);
 
 /**
- * @}
  * @}
  */
 
-- 
2.37.0 (Apple Git-136)



More information about the ffmpeg-devel mailing list