lkml.org 
[lkml]   [2017]   [Jul]   [24]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [PATCH] kthread: Fix documentation build warning
On Mon, 24 Jul 2017 14:24:44 -0700
Randy Dunlap <rdunlap@infradead.org> wrote:

> > + * @arg...: arguments for @namefmt.
> > *
>
> Hm, Documentation/doc-guide/kernel-doc.rst says:
> If a function parameter is ``...`` (varargs), it should be listed
> in kernel-doc notation as: ``@...:``.
>
> but the patch here is for a macro, not a function.
> Does that make a difference?

Macros are a little different. I've tried a couple of times to figure out
and rationalize the "..." handling, should maybe do so again. Meanwhile,
this makes the warning go away, enough for one day :)

Thanks,

jon

\
 
 \ /
  Last update: 2017-07-24 23:32    [W:1.083 / U:0.048 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site