linux-kernel - Re: [PATCH 3/3] s390/cmf: fix kerneldoc

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-Id: <alpine.LFD.2.21.1801231833550.1761@schleppi>
Date:   Tue, 23 Jan 2018 18:37:35 +0100 (CET)
From:   Sebastian Ott <sebott@...ux.vnet.ibm.com>
To:     Cornelia Huck <cohuck@...hat.com>
cc:     Martin Schwidefsky <schwidefsky@...ibm.com>,
        Heiko Carstens <heiko.carstens@...ibm.com>, corbet@....net,
        oberpar@...ux.vnet.ibm.com, linux-s390@...r.kernel.org,
        linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org
Subject: Re: [PATCH 3/3] s390/cmf: fix kerneldoc

On Tue, 23 Jan 2018, Cornelia Huck wrote:
> Make sure we use proper Return sections, and make the output
> for cmf_enable() less odd.
> 
> Signed-off-by: Cornelia Huck <cohuck@...hat.com>
> ---
> +++ b/drivers/s390/cio/cmf.c
> @@ -1118,9 +1118,10 @@ int ccw_set_cmf(struct ccw_device *cdev, int enable)
>   * enable_cmf() - switch on the channel measurement for a specific device
>   *  @cdev:	The ccw device to be enabled
>   *
> - *  Returns %0 for success or a negative error value.
> - *  Note: If this is called on a device for which channel measurement is already
> - *	  enabled a reset of the measurement data is triggered.
> + *  Enable channel measurements for @cdev. If this is called on a device
> + *  for which channel measurement is already enabled a reset of the
> + *  measurement data is triggered.
> + *  Returns: %0 for success or a negative error value
                                                        ^
I took the liberty to do re-add the dot at the end..
Applied. Thanks!