Thread (4 messages) 4 messages, 2 authors, 2023-08-21

Re: [PATCH] tracefs: Fix kernel-doc warnings

flat view

From: Matthew Wilcox <willy@infradead.org>
Date: 2023-08-21 14:04:45

On Mon, Aug 21, 2023 at 10:01:46AM -0400, Steven Rostedt wrote:
This is one of the cases I disagree with kerneldoc. I mean, this isn't a
public structure (it's only in this file) so I don't expect it to be
parsed. These three fields act as one. Having them in the kerneldoc format
above makes them look as three distinct fields. Perhaps the solution is to
get rid of the starting /** so that it's no longer in kerneldoc format.
Yes, take it out of kernel-doc's purview by removing that second *.
I don't think you need me to send a v2 patch to do that ;-)
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help