On Thu, 17 Jul 2008 20:15:51 -0600, Paul Walmsley <[EMAIL PROTECTED]> wrote:
> Several functions use old-style function documentation; convert those to
> use the current kerneldoc style.
>
> Signed-off-by: Paul Walmsley <[EMAIL PROTECTED]>
> ---
>
> drivers/i2c/chips/twl4030-core.c | 54
> ++++++++++++++++++--------------------
> 1 files changed, 26 insertions(+), 28 deletions(-)
>
> diff --git a/drivers/i2c/chips/twl4030-core.c
> b/drivers/i2c/chips/twl4030-core.c
> index 54e392b..4104fd2 100644
> --- a/drivers/i2c/chips/twl4030-core.c
> +++ b/drivers/i2c/chips/twl4030-core.c
> @@ -389,17 +389,18 @@ static struct irq_chip twl4030_irq_chip = {
> };
>
> /* Global Functions */
> -/*
> - * @brief twl4030_i2c_write - Writes a n bit register in TWL4030
> +
> +/**
> + * twl4030_i2c_write - Writes a n bit register in TWL4030
> + * @mod_no: module number
> + * @value: an array of num_bytes+1 containing data to write
> + * @reg: register address (just offset will do)
> + * @num_bytes: number of bytes to transfer
> *
> - * @param mod_no - module number
> - * @param *value - an array of num_bytes+1 containing data to write
> - * IMPORTANT - Allocate value num_bytes+1 and valid data starts at
> - * Offset 1.
> - * @param reg - register address (just offset will do)
> - * @param num_bytes - number of bytes to transfer
> + * IMPORTANT: for 'value' parameter: Allocate value num_bytes+1 and
> + * valid data starts at Offset 1.
> *
> - * @return result of operation - 0 is success
> + * Results the result of operation - 0 is success
I suppose you mean Returns here.
--
Best Regards,
Felipe Balbi
http://blog.felipebalbi.com
[EMAIL PROTECTED]
--
To unsubscribe from this list: send the line "unsubscribe linux-omap" in
the body of a message to [EMAIL PROTECTED]
More majordomo info at http://vger.kernel.org/majordomo-info.html
