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

On Mon, 21 Aug 2023 15:04:27 +0100
Matthew Wilcox [off-list ref] wrote:

On Mon, Aug 21, 2023 at 10:01:46AM -0400, Steven Rostedt wrote:

quoted

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 ;-)

Yep, I'll do it.

Thanks!

-- Steve