From: Jerome Brunet Date: Wed, 23 Oct 2024 08:35:43 +0000 (+0200) Subject: regulator: doc: add missing documentation for init_cb X-Git-Tag: v6.13-rc1~159^2~3 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=e55f45b0cda71ac2e9b4c6dee8852dc8d6f22ef0;p=thirdparty%2Fkernel%2Flinux.git 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 Closes: https://lore.kernel.org/lkml/20241023155120.6c4fea20@canb.auug.org.au/ Signed-off-by: Jerome Brunet Link: https://patch.msgid.link/20241023-regulator-doc-fixup-v1-1-ec018742ad73@baylibre.com Signed-off-by: Mark Brown --- diff --git a/include/linux/regulator/driver.h b/include/linux/regulator/driver.h index d2f4427504f08..5b66caf1695db 100644 --- a/include/linux/regulator/driver.h +++ b/include/linux/regulator/driver.h @@ -269,6 +269,11 @@ enum regulator_type { * config but it cannot store it for later usage. * Callback should return 0 on success or negative ERRNO * indicating failure. + * @init_cb: Optional callback called after the parsing of init_data. + * Allows the regulator to perform runtime init if necessary, + * such as synching the regulator and the parsed constraints. + * Callback should return 0 on success or negative ERRNO + * indicating failure. * @id: Numerical identifier for the regulator. * @ops: Regulator operations table. * @irq: Interrupt number for the regulator.