Commit 7cb5f692 authored by Lee Jones's avatar Lee Jones Committed by Mark Brown

regulator: qcom-rpmh-regulator: Repair dodgy kerneldoc header formatting

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

This change fixes the following warnings:

 drivers/regulator/qcom-rpmh-regulator.c:33: warning: Enum value 'VRM' not described in enum 'rpmh_regulator_type'
 drivers/regulator/qcom-rpmh-regulator.c:33: warning: Enum value 'XOB' not described in enum 'rpmh_regulator_type'
 drivers/regulator/qcom-rpmh-regulator.c:416: warning: Function parameter or member 'vreg' not described in 'rpmh_regulator_init_vreg'
 drivers/regulator/qcom-rpmh-regulator.c:416: warning: Function parameter or member 'dev' not described in 'rpmh_regulator_init_vreg'
 drivers/regulator/qcom-rpmh-regulator.c:416: warning: Function parameter or member 'node' not described in 'rpmh_regulator_init_vreg'
 drivers/regulator/qcom-rpmh-regulator.c:416: warning: Function parameter or member 'pmic_id' not described in 'rpmh_regulator_init_vreg'
 drivers/regulator/qcom-rpmh-regulator.c:416: warning: Function parameter or member 'pmic_rpmh_data' not described in 'rpmh_regulator_init_vreg'
Signed-off-by: default avatarLee Jones <lee.jones@linaro.org>
Reviewed-by: default avatarBjorn Andersson <bjorn.andersson@linaro.org>
Cc: Andy Gross <agross@kernel.org>
Cc: Bjorn Andersson <bjorn.andersson@linaro.org>
Cc: linux-arm-msm@vger.kernel.org
Link: https://lore.kernel.org/r/20200626065738.93412-3-lee.jones@linaro.orgSigned-off-by: default avatarMark Brown <broonie@kernel.org>
parent 36f69fa9
...@@ -22,9 +22,9 @@ ...@@ -22,9 +22,9 @@
/** /**
* enum rpmh_regulator_type - supported RPMh accelerator types * enum rpmh_regulator_type - supported RPMh accelerator types
* %VRM: RPMh VRM accelerator which supports voting on enable, voltage, * @VRM: RPMh VRM accelerator which supports voting on enable, voltage,
* and mode of LDO, SMPS, and BOB type PMIC regulators. * and mode of LDO, SMPS, and BOB type PMIC regulators.
* %XOB: RPMh XOB accelerator which supports voting on the enable state * @XOB: RPMh XOB accelerator which supports voting on the enable state
* of PMIC regulators. * of PMIC regulators.
*/ */
enum rpmh_regulator_type { enum rpmh_regulator_type {
...@@ -399,13 +399,13 @@ static const struct regulator_ops rpmh_regulator_xob_ops = { ...@@ -399,13 +399,13 @@ static const struct regulator_ops rpmh_regulator_xob_ops = {
/** /**
* rpmh_regulator_init_vreg() - initialize all attributes of an rpmh-regulator * rpmh_regulator_init_vreg() - initialize all attributes of an rpmh-regulator
* vreg: Pointer to the individual rpmh-regulator resource * @vreg: Pointer to the individual rpmh-regulator resource
* dev: Pointer to the top level rpmh-regulator PMIC device * @dev: Pointer to the top level rpmh-regulator PMIC device
* node: Pointer to the individual rpmh-regulator resource * @node: Pointer to the individual rpmh-regulator resource
* device node * device node
* pmic_id: String used to identify the top level rpmh-regulator * @pmic_id: String used to identify the top level rpmh-regulator
* PMIC device on the board * PMIC device on the board
* pmic_rpmh_data: Pointer to a null-terminated array of rpmh-regulator * @pmic_rpmh_data: Pointer to a null-terminated array of rpmh-regulator
* resources defined for the top level PMIC device * resources defined for the top level PMIC device
* *
* Return: 0 on success, errno on failure * Return: 0 on success, errno on failure
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment