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

From: Jiri Slaby
Date: Thu Nov 05 2020 - 04:14:10 EST


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 properly documented with kernel-doc, then it should also be
referenced from /Documentation using the kernel-doc:: notation.

Also see: scripts/find-unused-docs.sh

Thanks for this. I must admit, I haven't managed to get familiar with this stuff yet.

--
js
suse labs