lkml.org 
[lkml]   [2020]   [Jun]   [26]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    From
    Subject[PATCH 8/9] regulator: wm8400-regulator: Repair dodgy kerneldoc header formatting
    Date
    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'

    Cc: patches@opensource.cirrus.com
    Signed-off-by: Lee Jones <lee.jones@linaro.org>
    ---
    drivers/regulator/wm8400-regulator.c | 6 +++---
    1 file changed, 3 insertions(+), 3 deletions(-)

    diff --git a/drivers/regulator/wm8400-regulator.c b/drivers/regulator/wm8400-regulator.c
    index 4cb1fbb597227..e9fd137077213 100644
    --- a/drivers/regulator/wm8400-regulator.c
    +++ b/drivers/regulator/wm8400-regulator.c
    @@ -234,9 +234,9 @@ static struct platform_driver wm8400_regulator_driver = {
    * the regulator API. It is intended to be called from the
    * platform_init() callback of the WM8400 MFD driver.
    *
    - * @param dev The WM8400 device to operate on.
    - * @param reg The regulator to control.
    - * @param initdata Regulator initdata for the regulator.
    + * @dev: The WM8400 device to operate on.
    + * @reg: The regulator to control.
    + * @initdata: Regulator initdata for the regulator.
    */
    int wm8400_register_regulator(struct device *dev, int reg,
    struct regulator_init_data *initdata)
    --
    2.25.1
    \
     
     \ /
      Last update: 2020-06-26 08:58    [W:4.156 / U:1.000 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site