media: hantro: fix kernel-doc warnings and style
Subsystems (2)
PATCH 1/1 media: hantro: fix kernel-doc warnings and style
Add a description for enum values in hantro_enc_fmt, in order to fix these warnings:
drivers/staging/media/hantro/hantro_hw.h:149: warning: Enum value 'RK3288_VPU_ENC_FMT_YUV420P' not described in enum 'hantro_enc_fmt' drivers/staging/media/hantro/hantro_hw.h:149: warning: Enum value 'RK3288_VPU_ENC_FMT_YUV420SP' not described in enum 'hantro_enc_fmt' drivers/staging/media/hantro/hantro_hw.h:149: warning: Enum value 'RK3288_VPU_ENC_FMT_YUYV422' not described in enum 'hantro_enc_fmt' drivers/staging/media/hantro/hantro_hw.h:149: warning: Enum value 'RK3288_VPU_ENC_FMT_UYVY422' not described in enum 'hantro_enc_fmt'
While here, improve the kernel-doc style, adding an empty line before the fields of the structs.
--- drivers/staging/media/hantro/hantro_hw.h | 12 ++++++++++++ 1 file changed, 12 insertions(+)
drivers/staging/media/hantro/hantro_hw.h +12 -0
@@ -27,6 +27,7 @@ struct hantro_variant;/** * struct hantro_aux_buf - auxiliary DMA buffer for hardware data +* * @cpu: CPU pointer to the buffer. * @dma: DMA address of the buffer. * @size: Size of the buffer.
@@ -41,6 +42,7 @@ struct hantro_aux_buf {/** * struct hantro_jpeg_enc_hw_ctx +* * @bounce_buffer: Bounce buffer */ struct hantro_jpeg_enc_hw_ctx {
@@ -52,6 +54,7 @@ struct hantro_jpeg_enc_hw_ctx {/** * struct hantro_h264_dec_ctrls +* * @decode: Decode params * @scaling: Scaling info * @sps: SPS info
@@ -66,6 +69,7 @@ struct hantro_h264_dec_ctrls {/** * struct hantro_h264_dec_reflists +* * @p: P reflist * @b0: B0 reflist * @b1: B1 reflist
@@ -78,6 +82,7 @@ struct hantro_h264_dec_reflists {/** * struct hantro_h264_dec_hw_ctx +* * @priv: Private auxiliary buffer for hardware. * @dpb: DPB * @reflists: P/B0/B1 reflists
@@ -92,6 +97,7 @@ struct hantro_h264_dec_hw_ctx {/** * struct hantro_mpeg2_dec_hw_ctx +* * @qtable: Quantization table */ struct hantro_mpeg2_dec_hw_ctx {
@@ -100,6 +106,7 @@ struct hantro_mpeg2_dec_hw_ctx {/** * struct hantro_vp8_dec_hw_ctx +* * @segment_map: Segment map buffer. * @prob_tbl: Probability table buffer. */
@@ -140,6 +147,11 @@ struct hantro_codec_ops {/** * enum hantro_enc_fmt - source format ID for hardware registers. +* +* @RK3288_VPU_ENC_FMT_YUV420P: Y/CbCr 4:2:0 planar format +* @RK3288_VPU_ENC_FMT_YUV420SP: Y/CbCr 4:2:0 semi-planar format +* @RK3288_VPU_ENC_FMT_YUYV422: YUV 4:2:2 packed format (YUYV) +* @RK3288_VPU_ENC_FMT_UYVY422: YUV 4:2:2 packed format (UYVY) */ enum hantro_enc_fmt {RK3288_VPU_ENC_FMT_YUV420P =0 ,
Signature · 1 line
2.30.0