drm/msm/dpu: dpu_hw_dsc.h: fix all kernel-doc warnings

Correct or add kernel-doc comments to eliminate all warnings:

Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_dsc.h:23 Incorrect use of
 kernel-doc format: * dsc_disable - disable dsc
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_dsc.h:29 Incorrect use of
 kernel-doc format: * dsc_config - configures dsc encoder
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_dsc.h:41 Incorrect use of
 kernel-doc format: * dsc_config_thresh - programs panel thresholds
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_dsc.h:50 struct member
 'dsc_disable' not described in 'dpu_hw_dsc_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_dsc.h:50 struct member
 'dsc_config' not described in 'dpu_hw_dsc_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_dsc.h:50 struct member
 'dsc_config_thresh' not described in 'dpu_hw_dsc_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_dsc.h:50 struct member
 'dsc_bind_pingpong_blk' not described in 'dpu_hw_dsc_ops'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Dmitry Baryshkov <dmitry.baryshkov@oss.qualcomm.com>
Patchwork: https://patchwork.freedesktop.org/patch/695658/
Link: https://lore.kernel.org/r/20251219184638.1813181-7-rdunlap@infradead.org
Signed-off-by: Dmitry Baryshkov <dmitry.baryshkov@oss.qualcomm.com>

diff --git a/drivers/gpu/drm/msm/disp/dpu1/dpu_hw_dsc.h b/drivers/gpu/drm/msm/disp/dpu1/dpu_hw_dsc.h
index cc7cc6f6f7cda639b30bad7632c6e73aacedfcb8..39d93b9df05150b6b63584605b48443650ab91f2 100644 (file)
--- a/drivers/gpu/drm/msm/disp/dpu1/dpu_hw_dsc.h
+++ b/drivers/gpu/drm/msm/disp/dpu1/dpu_hw_dsc.h
@@ -21,13 +21,13 @@ struct dpu_hw_dsc;
  */
 struct dpu_hw_dsc_ops {
        /**
-        * dsc_disable - disable dsc
+        * @dsc_disable: disable dsc
         * @hw_dsc: Pointer to dsc context
         */
        void (*dsc_disable)(struct dpu_hw_dsc *hw_dsc);
 
        /**
-        * dsc_config - configures dsc encoder
+        * @dsc_config: configures dsc encoder
         * @hw_dsc: Pointer to dsc context
         * @dsc: panel dsc parameters
         * @mode: dsc topology mode to be set
@@ -39,13 +39,17 @@ struct dpu_hw_dsc_ops {
                           u32 initial_lines);
 
        /**
-        * dsc_config_thresh - programs panel thresholds
+        * @dsc_config_thresh: programs panel thresholds
         * @hw_dsc: Pointer to dsc context
         * @dsc: panel dsc parameters
         */
        void (*dsc_config_thresh)(struct dpu_hw_dsc *hw_dsc,
                                  struct drm_dsc_config *dsc);
 
+       /**
+        * @dsc_bind_pingpong_blk: binds pixel output from a DSC block
+        * to a pingpong block
+        */
        void (*dsc_bind_pingpong_blk)(struct dpu_hw_dsc *hw_dsc,
                                  enum dpu_pingpong pp);
 };