Commit 3091c572 authored Dec 19, 2025 by Randy Dunlap Committed by Dmitry Baryshkov Dec 24, 2025

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>

parent 6e945d51

drivers/gpu/drm/msm/disp/dpu1/dpu_hw_vbif.h

+8 −8

Original line number	Diff line number	Diff line
		@@ -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
		*/