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

regulator: doc: add missing documentation for init_cb

Add comment documenting introduced init_cb.
This solves the following warning when building the kernel documentation:

./include/linux/regulator/driver.h:435: warning: Function parameter or struct member 'init_cb' not described in 'regulator_desc'

Fixes: cfcdf395c21e ("regulator: core: add callback to perform runtime init")
Reported-by: Stephen Rothwell <sfr@canb.auug.org.au>
Closes: https://lore.kernel.org/lkml/20241023155120.6c4fea20@canb.auug.org.au/
Signed-off-by: Jerome Brunet <jbrunet@baylibre.com>
Link: https://patch.msgid.link/20241023-regulator-doc-fixup-v1-1-ec018742ad73@baylibre.com
Signed-off-by: Mark Brown <broonie@kernel.org>

authored by

Jerome Brunet and committed by
Mark Brown
e55f45b0 5ddc236d

+5
+5
include/linux/regulator/driver.h
··· 269 269 * config but it cannot store it for later usage. 270 270 * Callback should return 0 on success or negative ERRNO 271 271 * indicating failure. 272 + * @init_cb: Optional callback called after the parsing of init_data. 273 + * Allows the regulator to perform runtime init if necessary, 274 + * such as synching the regulator and the parsed constraints. 275 + * Callback should return 0 on success or negative ERRNO 276 + * indicating failure. 272 277 * @id: Numerical identifier for the regulator. 273 278 * @ops: Regulator operations table. 274 279 * @irq: Interrupt number for the regulator.