[PATCH] reset: Fix and extend kerneldoc

[PATCH] reset: Fix and extend kerneldoc

[Krzysztof Kozlowski]

Fix W=1 compile warnings (invalid kerneldoc):

    drivers/reset/core.c:50: warning: Function parameter or member 'array' not described in 'reset_control'
    drivers/reset/core.c:50: warning: Function parameter or member 'deassert_count' not described in 'reset_control'

Signed-off-by: Krzysztof Kozlowski <krzk@kernel.org>
---
 drivers/reset/core.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/drivers/reset/core.c b/drivers/reset/core.c
index 01c0c7aa835c..a2df88e90011 100644
--- a/drivers/reset/core.c
+++ b/drivers/reset/core.c
@@ -32,7 +32,8 @@ static LIST_HEAD(reset_lookup_list);
  * @refcnt: Number of gets of this reset_control
  * @acquired: Only one reset_control may be acquired for a given rcdev and id.
  * @shared: Is this a shared (1), or an exclusive (0) reset_control?
- * @deassert_cnt: Number of times this reset line has been deasserted
+ * @array: Is this an array of reset controls (1)?
+ * @deassert_count: Number of times this reset line has been deasserted
  * @triggered_count: Number of times this reset line has been reset. Currently
  *                   only used for shared resets, which means that the value
  *                   will be either 0 or 1.
-- 
2.17.1

Re: [PATCH] reset: Fix and extend kerneldoc

[Philipp Zabel]

Hi Krzysztof,

On Tue, 2020-07-28 at 19:10 +0200, Krzysztof Kozlowski wrote:
> Fix W=1 compile warnings (invalid kerneldoc):
> 
>     drivers/reset/core.c:50: warning: Function parameter or member 'array' not described in 'reset_control'
>     drivers/reset/core.c:50: warning: Function parameter or member 'deassert_count' not described in 'reset_control'
> 
> Signed-off-by: Krzysztof Kozlowski <krzk@kernel.org>
> ---
>  drivers/reset/core.c | 3 ++-
>  1 file changed, 2 insertions(+), 1 deletion(-)
> 
> diff --git a/drivers/reset/core.c b/drivers/reset/core.c
> index 01c0c7aa835c..a2df88e90011 100644
> --- a/drivers/reset/core.c
> +++ b/drivers/reset/core.c
> @@ -32,7 +32,8 @@ static LIST_HEAD(reset_lookup_list);
>   * @refcnt: Number of gets of this reset_control
>   * @acquired: Only one reset_control may be acquired for a given rcdev and id.
>   * @shared: Is this a shared (1), or an exclusive (0) reset_control?
> - * @deassert_cnt: Number of times this reset line has been deasserted
> + * @array: Is this an array of reset controls (1)?
> + * @deassert_count: Number of times this reset line has been deasserted
>   * @triggered_count: Number of times this reset line has been reset. Currently
>   *                   only used for shared resets, which means that the value
>   *                   will be either 0 or 1.

Thank you for the fix, applied to reset/next.

regards
Philipp