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_lm.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_lm.h:27 Cannot find
identifier on line: *
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_lm.h:52 Incorrect use of
kernel-doc format: * Clear layer mixer to pipe configuration
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_lm.h:59 Incorrect use of
kernel-doc format: * Configure layer mixer to pipe configuration
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_lm.h:69 Incorrect use of
kernel-doc format: * setup_border_color : enable/disable border color
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_lm.h:76 Incorrect use of
kernel-doc format: * setup_misr: Enable/disable MISR
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_lm.h:81 Incorrect use of
kernel-doc format: * collect_misr: Read MISR signature

Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_lm.h:84 struct member
'setup_mixer_out' not described in 'dpu_hw_lm_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_lm.h:84 struct member
'setup_blend_config' not described in 'dpu_hw_lm_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_lm.h:84 struct member
'setup_alpha_out' not described in 'dpu_hw_lm_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_lm.h:84 struct member
'clear_all_blendstages' not described in 'dpu_hw_lm_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_lm.h:84 struct member
'setup_blendstage' not described in 'dpu_hw_lm_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_lm.h:84 struct member
'setup_border_color' not described in 'dpu_hw_lm_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_lm.h:84 struct member
'setup_misr' not described in 'dpu_hw_lm_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_lm.h:84 struct member
'collect_misr' not described in 'dpu_hw_lm_ops'

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

authored by

Randy Dunlap and committed by
Dmitry Baryshkov 7ce9dd5e f6d75455

+11 -12
+11 -12
drivers/gpu/drm/msm/disp/dpu1/dpu_hw_lm.h
··· 25 25 }; 26 26 27 27 /** 28 - * 29 28 * struct dpu_hw_lm_ops : Interface to the mixer Hw driver functions 30 29 * Assumption is these functions will be called after clocks are enabled 31 30 */ 32 31 struct dpu_hw_lm_ops { 33 - /* 34 - * Sets up mixer output width and height 32 + /** 33 + * @setup_mixer_out: Sets up mixer output width and height 35 34 * and border color if enabled 36 35 */ 37 36 void (*setup_mixer_out)(struct dpu_hw_mixer *ctx, 38 37 struct dpu_hw_mixer_cfg *cfg); 39 38 40 - /* 41 - * Alpha blending configuration 39 + /** 40 + * @setup_blend_config: Alpha blending configuration 42 41 * for the specified stage 43 42 */ 44 43 void (*setup_blend_config)(struct dpu_hw_mixer *ctx, uint32_t stage, 45 44 uint32_t fg_alpha, uint32_t bg_alpha, uint32_t blend_op); 46 45 47 - /* 48 - * Alpha color component selection from either fg or bg 46 + /** 47 + * @setup_alpha_out: Alpha color component selection from either fg or bg 49 48 */ 50 49 void (*setup_alpha_out)(struct dpu_hw_mixer *ctx, uint32_t mixer_op); 51 50 52 51 /** 53 - * Clear layer mixer to pipe configuration 52 + * @clear_all_blendstages: Clear layer mixer to pipe configuration 54 53 * @ctx : mixer ctx pointer 55 54 * Returns: 0 on success or -error 56 55 */ 57 56 int (*clear_all_blendstages)(struct dpu_hw_mixer *ctx); 58 57 59 58 /** 60 - * Configure layer mixer to pipe configuration 59 + * @setup_blendstage: Configure layer mixer to pipe configuration 61 60 * @ctx : mixer ctx pointer 62 61 * @lm : layer mixer enumeration 63 62 * @stage_cfg : blend stage configuration ··· 66 67 struct dpu_hw_stage_cfg *stage_cfg); 67 68 68 69 /** 69 - * setup_border_color : enable/disable border color 70 + * @setup_border_color : enable/disable border color 70 71 */ 71 72 void (*setup_border_color)(struct dpu_hw_mixer *ctx, 72 73 struct dpu_mdss_color *color, 73 74 u8 border_en); 74 75 75 76 /** 76 - * setup_misr: Enable/disable MISR 77 + * @setup_misr: Enable/disable MISR 77 78 */ 78 79 void (*setup_misr)(struct dpu_hw_mixer *ctx); 79 80 80 81 /** 81 - * collect_misr: Read MISR signature 82 + * @collect_misr: Read MISR signature 82 83 */ 83 84 int (*collect_misr)(struct dpu_hw_mixer *ctx, u32 *misr_value); 84 85 };