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/sun4i: fix kernel-doc warnings in sunxi_engine.h

Correct the kernel-doc notation, add a missing struct member comment,
and add a missing "Returns:" function comment to eliminate kernel-doc
warnings:

Warning: drivers/gpu/drm/sun4i/sunxi_engine.h:116 Incorrect use of
kernel-doc format: * @mode_set
Warning: drivers/gpu/drm/sun4i/sunxi_engine.h:125 struct member 'mode_set'
not described in 'sunxi_engine_ops'
Warning: drivers/gpu/drm/sun4i/sunxi_engine.h:144 struct member 'list'
not described in 'sunxi_engine'
Warning: drivers/gpu/drm/sun4i/sunxi_engine.h:168 No description found
for return value of 'sunxi_engine_layers_init'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Chen-Yu Tsai <wens@kernel.org>
Link: https://patch.msgid.link/20260219215524.468142-1-rdunlap@infradead.org
Signed-off-by: Chen-Yu Tsai <wens@kernel.org>

authored by

Randy Dunlap and committed by
Chen-Yu Tsai 645186bf 06277983

+5 -2
+5 -2
drivers/gpu/drm/sun4i/sunxi_engine.h
··· 114 114 void (*vblank_quirk)(struct sunxi_engine *engine); 115 115 116 116 /** 117 - * @mode_set 117 + * @mode_set: 118 118 * 119 119 * This callback is used to set mode related parameters 120 120 * like interlacing, screen size, etc. once per mode set. ··· 131 131 * @node: the of device node of the engine 132 132 * @regs: the regmap of the engine 133 133 * @id: the id of the engine (-1 if not used) 134 + * @list: engine list management 134 135 */ 135 136 struct sunxi_engine { 136 137 const struct sunxi_engine_ops *ops; ··· 141 140 142 141 int id; 143 142 144 - /* Engine list management */ 145 143 struct list_head list; 146 144 }; 147 145 ··· 163 163 * sunxi_engine_layers_init() - Create planes (layers) for the engine 164 164 * @drm: pointer to the drm_device for which planes will be created 165 165 * @engine: pointer to the engine 166 + * 167 + * Returns: The array of struct drm_plane backing the layers, or an 168 + * error pointer on failure. 166 169 */ 167 170 static inline struct drm_plane ** 168 171 sunxi_engine_layers_init(struct drm_device *drm, struct sunxi_engine *engine)