Re: [PATCH 12/36] tty: tty_io: Fix some kernel-doc issues

2020-11-05 Thread Jiri Slaby
On 05. 11. 20, 9:53, Lee Jones wrote: For example, alloc_tty_struct is among the ones, I would like to see fixed instead of removed from kernel-doc. There is nothing stopping anyone from providing said descriptions and promoting it back up to kernel-doc. If you have good reasons for it to be p

Re: [PATCH 12/36] tty: tty_io: Fix some kernel-doc issues

2020-11-05 Thread Lee Jones
On Thu, 05 Nov 2020, Jiri Slaby wrote: > On 04. 11. 20, 20:35, Lee Jones wrote: > > Demote non-conformant headers and supply some missing descriptions. > > > > Fixes the following W=1 kernel build warning(s): > > > > drivers/tty/tty_io.c:218: warning: Function parameter or member 'file' > > n

Re: [PATCH 12/36] tty: tty_io: Fix some kernel-doc issues

2020-11-05 Thread Jiri Slaby
On 04. 11. 20, 20:35, Lee Jones wrote: Demote non-conformant headers and supply some missing descriptions. Fixes the following W=1 kernel build warning(s): drivers/tty/tty_io.c:218: warning: Function parameter or member 'file' not described in 'tty_free_file' drivers/tty/tty_io.c:566: warn

[PATCH 12/36] tty: tty_io: Fix some kernel-doc issues

2020-11-04 Thread Lee Jones
Demote non-conformant headers and supply some missing descriptions. Fixes the following W=1 kernel build warning(s): drivers/tty/tty_io.c:218: warning: Function parameter or member 'file' not described in 'tty_free_file' drivers/tty/tty_io.c:566: warning: Function parameter or member 'exit_ses