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_intf.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_intf.h:76 duplicate section
name 'Return'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_intf.h:112 Incorrect use of
kernel-doc format: * Disable autorefresh if enabled
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_intf.h:118 struct member
'setup_timing_gen' not described in 'dpu_hw_intf_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_intf.h:118 struct member
'setup_prg_fetch' not described in 'dpu_hw_intf_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_intf.h:118 struct member
'enable_timing' not described in 'dpu_hw_intf_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_intf.h:118 struct member
'get_status' not described in 'dpu_hw_intf_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_intf.h:118 struct member
'get_line_count' not described in 'dpu_hw_intf_ops'
Warning: drivers/gpu/drm/msm/disp/dpu1/dpu_hw_intf.h:118 struct member
'disable_autorefresh' not described in 'dpu_hw_intf_ops'
dpu_hw_intf.h:119: warning: Excess struct member 'get_vsync_info'
description in 'dpu_hw_intf_ops'
dpu_hw_intf.h:119: warning: Excess struct member 'setup_autorefresh'
description in 'dpu_hw_intf_ops'
dpu_hw_intf.h:119: warning: Excess struct member 'get_autorefresh'
description in 'dpu_hw_intf_ops'

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

authored by

Randy Dunlap and committed by
Dmitry Baryshkov f6d75455 399f4345

+7 -13
+7 -13
drivers/gpu/drm/msm/disp/dpu1/dpu_hw_intf.h
··· 57 57 /** 58 58 * struct dpu_hw_intf_ops : Interface to the interface Hw driver functions 59 59 * Assumption is these functions will be called after clocks are enabled 60 - * @ setup_timing_gen : programs the timing engine 61 - * @ setup_prog_fetch : enables/disables the programmable fetch logic 62 - * @ enable_timing: enable/disable timing engine 63 - * @ get_status: returns if timing engine is enabled or not 64 - * @ get_line_count: reads current vertical line counter 60 + * @setup_timing_gen : programs the timing engine 61 + * @setup_prg_fetch : enables/disables the programmable fetch logic 62 + * @enable_timing: enable/disable timing engine 63 + * @get_status: returns if timing engine is enabled or not 64 + * @get_line_count: reads current vertical line counter 65 65 * @bind_pingpong_blk: enable/disable the connection with pingpong which will 66 66 * feed pixels to this interface 67 67 * @setup_misr: enable/disable MISR ··· 70 70 * pointer and programs the tear check configuration 71 71 * @disable_tearcheck: Disables tearcheck block 72 72 * @connect_external_te: Read, modify, write to either set or clear listening to external TE 73 - * Return: 1 if TE was originally connected, 0 if not, or -ERROR 74 - * @get_vsync_info: Provides the programmed and current line_count 75 - * @setup_autorefresh: Configure and enable the autorefresh config 76 - * @get_autorefresh: Retrieve autorefresh config from hardware 77 - * Return: 0 on success, -ETIMEDOUT on timeout 73 + * Returns 1 if TE was originally connected, 0 if not, or -ERROR 78 74 * @vsync_sel: Select vsync signal for tear-effect configuration 75 + * @disable_autorefresh: Disable autorefresh if enabled 79 76 * @program_intf_cmd_cfg: Program the DPU to interface datapath for command mode 80 77 */ 81 78 struct dpu_hw_intf_ops { ··· 106 109 107 110 void (*vsync_sel)(struct dpu_hw_intf *intf, enum dpu_vsync_source vsync_source); 108 111 109 - /** 110 - * Disable autorefresh if enabled 111 - */ 112 112 void (*disable_autorefresh)(struct dpu_hw_intf *intf, uint32_t encoder_id, u16 vdisplay); 113 113 114 114 void (*program_intf_cmd_cfg)(struct dpu_hw_intf *intf,