tjh.dev / kernel
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

drm/msm/dpu: dpu_hw_top.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_top.h:93 Incorrect use of
kernel-doc format: * setup_traffic_shaper() : Setup traffic shaper control
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_top.h:101 Incorrect use of
kernel-doc format: * setup_clk_force_ctrl - set clock force control
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_top.h:111 Incorrect use of
kernel-doc format: * get_danger_status - get danger status
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_top.h:119 Incorrect use of
kernel-doc format: * setup_vsync_source - setup vsync source
configuration details
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_top.h:127 Incorrect use of
kernel-doc format: * get_safe_status - get safe status
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_top.h:135 Incorrect use of
kernel-doc format: * dp_phy_intf_sel - configure intf to phy mapping
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_top.h:142 Incorrect use of
kernel-doc format: * intf_audio_select - select the external interface
for audio
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_top.h:146 struct member
'setup_clk_force_ctrl' not described in 'dpu_hw_mdp_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_top.h:146 struct member
'get_danger_status' not described in 'dpu_hw_mdp_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_top.h:146 struct member
'setup_vsync_source' not described in 'dpu_hw_mdp_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_top.h:146 struct member
'get_safe_status' not described in 'dpu_hw_mdp_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_top.h:146 struct member
'dp_phy_intf_sel' not described in 'dpu_hw_mdp_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_top.h:146 struct member
'intf_audio_select' not described in 'dpu_hw_mdp_ops'

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

authored by

Randy Dunlap and committed by
Dmitry Baryshkov 6e945d51 f5a7145d

+10 -11
+10 -11
drivers/gpu/drm/msm/disp/dpu1/dpu_hw_top.h
··· 77 77 /** 78 78 * struct dpu_hw_mdp_ops - interface to the MDP TOP Hw driver functions 79 79 * Assumption is these functions will be called after clocks are enabled. 80 - * @setup_split_pipe : Programs the pipe control registers 81 - * @setup_pp_split : Programs the pp split control registers 82 - * @setup_traffic_shaper : programs traffic shaper control 83 80 */ 84 81 struct dpu_hw_mdp_ops { 85 - /** setup_split_pipe() : Registers are not double buffered, thisk 82 + /** 83 + * @setup_split_pipe : Programs the pipe control registers. 84 + * Registers are not double buffered, this 86 85 * function should be called before timing control enable 87 86 * @mdp : mdp top context driver 88 87 * @cfg : upper and lower part of pipe configuration ··· 90 91 struct split_pipe_cfg *p); 91 92 92 93 /** 93 - * setup_traffic_shaper() : Setup traffic shaper control 94 + * @setup_traffic_shaper : programs traffic shaper control. 94 95 * @mdp : mdp top context driver 95 96 * @cfg : traffic shaper configuration 96 97 */ ··· 98 99 struct traffic_shaper_cfg *cfg); 99 100 100 101 /** 101 - * setup_clk_force_ctrl - set clock force control 102 + * @setup_clk_force_ctrl: set clock force control 102 103 * @mdp: mdp top context driver 103 104 * @clk_ctrl: clock to be controlled 104 105 * @enable: force on enable ··· 108 109 enum dpu_clk_ctrl_type clk_ctrl, bool enable); 109 110 110 111 /** 111 - * get_danger_status - get danger status 112 + * @get_danger_status: get danger status 112 113 * @mdp: mdp top context driver 113 114 * @status: Pointer to danger safe status 114 115 */ ··· 116 117 struct dpu_danger_safe_status *status); 117 118 118 119 /** 119 - * setup_vsync_source - setup vsync source configuration details 120 + * @setup_vsync_source: setup vsync source configuration details 120 121 * @mdp: mdp top context driver 121 122 * @cfg: vsync source selection configuration 122 123 */ ··· 124 125 struct dpu_vsync_source_cfg *cfg); 125 126 126 127 /** 127 - * get_safe_status - get safe status 128 + * @get_safe_status: get safe status 128 129 * @mdp: mdp top context driver 129 130 * @status: Pointer to danger safe status 130 131 */ ··· 132 133 struct dpu_danger_safe_status *status); 133 134 134 135 /** 135 - * dp_phy_intf_sel - configure intf to phy mapping 136 + * @dp_phy_intf_sel: configure intf to phy mapping 136 137 * @mdp: mdp top context driver 137 138 * @phys: list of phys the DP interfaces should be connected to. 0 disables the INTF. 138 139 */ 139 140 void (*dp_phy_intf_sel)(struct dpu_hw_mdp *mdp, enum dpu_dp_phy_sel phys[2]); 140 141 141 142 /** 142 - * intf_audio_select - select the external interface for audio 143 + * @intf_audio_select: select the external interface for audio 143 144 * @mdp: mdp top context driver 144 145 */ 145 146 void (*intf_audio_select)(struct dpu_hw_mdp *mdp);