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.

regulator: pf9453: Fix kernel doc for mux_poll()

The validator is not happy:

Warning: drivers/regulator/pf9453-regulator.c:303 This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

Update the kernel-doc accordingly.

Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
Link: https://patch.msgid.link/20251106114628.2302762-1-andriy.shevchenko@linux.intel.com
Signed-off-by: Mark Brown <broonie@kernel.org>

authored by

Andy Shevchenko and committed by
Mark Brown 6bd1ad97 10448211

+12 -4
+12 -4
drivers/regulator/pf9453-regulator.c
··· 289 289 } 290 290 291 291 /** 292 - * pf9453_regulator_enable_regmap for regmap users 292 + * pf9453_regulator_enable_regmap - enable regulator for regmap users 293 293 * 294 294 * @rdev: regulator to operate on 295 295 * 296 296 * Regulators that use regmap for their register I/O can set the 297 297 * enable_reg and enable_mask fields in their descriptor and then use 298 298 * this as their enable() operation, saving some code. 299 + * 300 + * Return: %0 on success, or negative errno. 299 301 */ 300 302 static int pf9453_regulator_enable_regmap(struct regulator_dev *rdev) 301 303 { ··· 316 314 } 317 315 318 316 /** 319 - * pf9453_regulator_disable_regmap for regmap users 317 + * pf9453_regulator_disable_regmap - disable regulator for regmap users 320 318 * 321 319 * @rdev: regulator to operate on 322 320 * 323 321 * Regulators that use regmap for their register I/O can set the 324 322 * enable_reg and enable_mask fields in their descriptor and then use 325 323 * this as their disable() operation, saving some code. 324 + * 325 + * Return: %0 on success, or negative errno. 326 326 */ 327 327 static int pf9453_regulator_disable_regmap(struct regulator_dev *rdev) 328 328 { ··· 343 339 } 344 340 345 341 /** 346 - * pf9453_regulator_set_voltage_sel_regmap for regmap users 342 + * pf9453_regulator_set_voltage_sel_regmap - set voltage for regmap users 347 343 * 348 344 * @rdev: regulator to operate on 349 345 * @sel: Selector to set ··· 351 347 * Regulators that use regmap for their register I/O can set the 352 348 * vsel_reg and vsel_mask fields in their descriptor and then use this 353 349 * as their set_voltage_vsel operation, saving some code. 350 + * 351 + * Return: %0 on success, or negative errno. 354 352 */ 355 353 static int pf9453_regulator_set_voltage_sel_regmap(struct regulator_dev *rdev, unsigned int sel) 356 354 { ··· 403 397 } 404 398 405 399 /** 406 - * pf9453_regulator_set_ramp_delay_regmap 400 + * pf9453_regulator_set_ramp_delay_regmap - set ramp delay for regmap users 407 401 * 408 402 * @rdev: regulator to operate on 409 403 * @ramp_delay: desired ramp delay value in microseconds ··· 411 405 * Regulators that use regmap for their register I/O can set the ramp_reg 412 406 * and ramp_mask fields in their descriptor and then use this as their 413 407 * set_ramp_delay operation, saving some code. 408 + * 409 + * Return: %0 on success, or negative errno. 414 410 */ 415 411 static int pf9453_regulator_set_ramp_delay_regmap(struct regulator_dev *rdev, int ramp_delay) 416 412 {