lkml.org 
[lkml]   [2018]   [Feb]   [18]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [PATCH] scripts: kernel_doc: fixup reporting of function identifiers
On Fri, 16 Feb 2018 17:36:07 +0100
Markus Heiser <markus.heiser@darmarit.de> wrote:

> > So let me channel akpm here and ask: what are the user-visible effects of
> > this problem? I ask because applying it doesn't make any difference in
> > the "make htmldocs" output here. So I don't understand why you're
> > wanting to make this change.
>
> Use kernel-doc -v and take a look on the info-messages.
>
> In Documentation/doc-guide/kernel-doc we recommend to use
>
> /**
> * foo() - lorem ipsum
>
> to tag functions, but if you do so, the info message is broken,
> the function name is missed at the end of the message:
>
> ../test123.c:2: info: Scanning doc for

OK, so I guess that message is the only effect of this bug. Oh well,
I'll go ahead and apply the patch, thanks.

jon

\
 
 \ /
  Last update: 2018-02-19 00:49    [W:0.061 / U:1.116 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site