drm/msm/dpu: dpu_hw_vbif.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_vbif.h:19 Incorrect use of
 kernel-doc format: * set_limit_conf - set transaction limit config
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h:29 Incorrect use of
 kernel-doc format: * get_limit_conf - get transaction limit config
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h:39 Incorrect use of
 kernel-doc format: * set_halt_ctrl - set halt control
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h:48 Incorrect use of
 kernel-doc format: * get_halt_ctrl - get halt control
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h:57 Incorrect use of
 kernel-doc format: * set_qos_remap - set QoS priority remap
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h:67 Incorrect use of
 kernel-doc format: * set_mem_type - set memory type
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h:76 Incorrect use of
 kernel-doc format: * clear_errors - clear any vbif errors
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h:88 Incorrect use of
 kernel-doc format: * set_write_gather_en - set write_gather enable
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h:93 struct member
 'limit' not described in 'dpu_hw_vbif_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h:93 struct member
 'set_limit_conf' not described in 'dpu_hw_vbif_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h:93 struct member
 'get_limit_conf' not described in 'dpu_hw_vbif_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h:93 struct member
 'set_halt_ctrl' not described in 'dpu_hw_vbif_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h:93 struct member
 'get_halt_ctrl' not described in 'dpu_hw_vbif_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h:93 struct member
 'set_qos_remap' not described in 'dpu_hw_vbif_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h:93 struct member
 'set_mem_type' not described in 'dpu_hw_vbif_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h:93 struct member
 's' not described in 'dpu_hw_vbif_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h:93 struct member
 'set_write_gather_en' not described in 'dpu_hw_vbif_ops'

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

diff --git a/drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h b/drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h
index 285121ec804cca0b2fa432eca4ce6e563401abf3..9ac49448e43258bebb7d40250e5eeba6571757a8 100644 (file)
--- a/drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h
+++ b/drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h
@@ -17,7 +17,7 @@ struct dpu_hw_vbif;
  */
 struct dpu_hw_vbif_ops {
        /**
-        * set_limit_conf - set transaction limit config
+        * @set_limit_conf: set transaction limit config
         * @vbif: vbif context driver
         * @xin_id: client interface identifier
         * @rd: true for read limit; false for write limit
@@ -27,7 +27,7 @@ struct dpu_hw_vbif_ops {
                        u32 xin_id, bool rd, u32 limit);
 
        /**
-        * get_limit_conf - get transaction limit config
+        * @get_limit_conf: get transaction limit config
         * @vbif: vbif context driver
         * @xin_id: client interface identifier
         * @rd: true for read limit; false for write limit
@@ -37,7 +37,7 @@ struct dpu_hw_vbif_ops {
                        u32 xin_id, bool rd);
 
        /**
-        * set_halt_ctrl - set halt control
+        * @set_halt_ctrl: set halt control
         * @vbif: vbif context driver
         * @xin_id: client interface identifier
         * @enable: halt control enable
@@ -46,7 +46,7 @@ struct dpu_hw_vbif_ops {
                        u32 xin_id, bool enable);
 
        /**
-        * get_halt_ctrl - get halt control
+        * @get_halt_ctrl: get halt control
         * @vbif: vbif context driver
         * @xin_id: client interface identifier
         * @return: halt control enable
@@ -55,7 +55,7 @@ struct dpu_hw_vbif_ops {
                        u32 xin_id);
 
        /**
-        * set_qos_remap - set QoS priority remap
+        * @set_qos_remap: set QoS priority remap
         * @vbif: vbif context driver
         * @xin_id: client interface identifier
         * @level: priority level
@@ -65,7 +65,7 @@ struct dpu_hw_vbif_ops {
                        u32 xin_id, u32 level, u32 remap_level);
 
        /**
-        * set_mem_type - set memory type
+        * @set_mem_type: set memory type
         * @vbif: vbif context driver
         * @xin_id: client interface identifier
         * @value: memory type value
@@ -74,7 +74,7 @@ struct dpu_hw_vbif_ops {
                        u32 xin_id, u32 value);
 
        /**
-        * clear_errors - clear any vbif errors
+        * @clear_errors: clear any vbif errors
         *      This function clears any detected pending/source errors
         *      on the VBIF interface, and optionally returns the detected
         *      error mask(s).
@@ -86,7 +86,7 @@ struct dpu_hw_vbif_ops {
                u32 *pnd_errors, u32 *src_errors);
 
        /**
-        * set_write_gather_en - set write_gather enable
+        * @set_write_gather_en: set write_gather enable
         * @vbif: vbif context driver
         * @xin_id: client interface identifier
         */