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

regulator: wm8400-regulator: Repair dodgy kerneldoc header formatting

W=1 kernel builds report a lack of descriptions for various
function arguments. In reality they are documented, but the
formatting was not as expected '@.*:'. Instead, some weird
arg identifiers were used.

This change fixes the following warnings:

drivers/regulator/wm8400-regulator.c:243: warning: Function parameter or member 'dev' not described in 'wm8400_register_regulator'
drivers/regulator/wm8400-regulator.c:243: warning: Function parameter or member 'reg' not described in 'wm8400_register_regulator'
drivers/regulator/wm8400-regulator.c:243: warning: Function parameter or member 'initdata' not described in 'wm8400_register_regulator'

Signed-off-by: Lee Jones <lee.jones@linaro.org>
Acked-by: Charles Keepax <ckeepax@opensource.cirrus.com>
Cc: patches@opensource.cirrus.com
Link: https://lore.kernel.org/r/20200626065738.93412-9-lee.jones@linaro.org
Signed-off-by: Mark Brown <broonie@kernel.org>

authored by

Lee Jones and committed by
Mark Brown
0c526166 02d88863

+3 -3
+3 -3
drivers/regulator/wm8400-regulator.c
··· 234 234 * the regulator API. It is intended to be called from the 235 235 * platform_init() callback of the WM8400 MFD driver. 236 236 * 237 - * @param dev The WM8400 device to operate on. 238 - * @param reg The regulator to control. 239 - * @param initdata Regulator initdata for the regulator. 237 + * @dev: The WM8400 device to operate on. 238 + * @reg: The regulator to control. 239 + * @initdata: Regulator initdata for the regulator. 240 240 */ 241 241 int wm8400_register_regulator(struct device *dev, int reg, 242 242 struct regulator_init_data *initdata)