linux-kernel - Re: [PATCH] comedi: comedi_8254: correct kernel-doc warnings

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] [day] [month] [year] [list]

Message-ID: <115556ba-711b-4a43-bccb-44200dfa9ddb@mev.co.uk>
Date: Mon, 15 Dec 2025 10:45:51 +0000
From: Ian Abbott <abbotti@....co.uk>
To: Randy Dunlap <rdunlap@...radead.org>, linux-kernel@...r.kernel.org
Cc: H Hartley Sweeten <hsweeten@...ionengravers.com>,
 Greg Kroah-Hartman <gregkh@...uxfoundation.org>
Subject: Re: [PATCH] comedi: comedi_8254: correct kernel-doc warnings

On 2025-12-14 20:27, Randy Dunlap wrote:
> Correct typos in 3 struct member descriptions to eliminate all
> kernel-doc warnings in comedi_8254.h:
> 
> Warning: include/linux/comedi/comedi_8254.h:112 struct member 'next_div'
>   not described in 'comedi_8254'
> Warning: include/linux/comedi/comedi_8254.h:112 struct member 'clock_src'
>   not described in 'comedi_8254'
> Warning: include/linux/comedi/comedi_8254.h:112 struct member 'gate_src'
>   not described in 'comedi_8254'
> 
> Signed-off-by: Randy Dunlap <rdunlap@...radead.org>
> ---
> Cc: Ian Abbott <abbotti@....co.uk>
> Cc: H Hartley Sweeten <hsweeten@...ionengravers.com>
> Cc: Greg Kroah-Hartman <gregkh@...uxfoundation.org>
> ---
>   include/linux/comedi/comedi_8254.h |    6 +++---
>   1 file changed, 3 insertions(+), 3 deletions(-)
> 
> --- linux-next-20251201.orig/include/linux/comedi/comedi_8254.h
> +++ linux-next-20251201/include/linux/comedi/comedi_8254.h
> @@ -83,11 +83,11 @@ typedef unsigned int comedi_8254_iocb_fn
>    * @divisor:		divisor for single counter
>    * @divisor1:		divisor loaded into first cascaded counter
>    * @divisor2:		divisor loaded into second cascaded counter
> - * #next_div:		next divisor for single counter
> + * @next_div:		next divisor for single counter
>    * @next_div1:		next divisor to use for first cascaded counter
>    * @next_div2:		next divisor to use for second cascaded counter
> - * @clock_src;		current clock source for each counter (driver specific)
> - * @gate_src;		current gate source  for each counter (driver specific)
> + * @clock_src:		current clock source for each counter (driver specific)
> + * @gate_src:		current gate source  for each counter (driver specific)
>    * @busy:		flags used to indicate that a counter is "busy"
>    * @insn_config:	driver specific (*insn_config) callback
>    */

Thanks for the correction!

Reviewed-by: Ian Abbott <abbotti@....co.uk>

-- 
-=( Ian Abbott <abbotti@....co.uk> || MEV Ltd. is a company  )=-
-=( registered in England & Wales.  Regd. number: 02862268.  )=-
-=( Regd. addr.: S11 & 12 Building 67, Europa Business Park, )=-
-=( Bird Hall Lane, STOCKPORT, SK3 0XA, UK. || www.mev.co.uk )=-