lkml.org 
[lkml]   [2018]   [Jan]   [10]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [PATCH v2] jbd2: fix sphinx kerel-doc build warnings
On Wed, Jan 10, 2018 at 12:26:19AM -0500, Theodore Ts'o wrote:
> On Wed, Jan 10, 2018 at 12:42:29PM +1100, Tobin C. Harding wrote:
> > Sphinx emits various (26) warnings when building make target 'htmldocs'.
> > Currently struct definitions contain duplicate documentation, some as
> > kernel-docs and some as standard c89 comments. We can reduce
> > duplication while cleaning up the kernel docs.
> >
> > Move all kernel-docs to right above each struct member. Use the set of
> > all existing comments (kernel-doc and c89). Add documentation for
> > missing struct members and function arguments.
> >
> > Signed-off-by: Tobin C. Harding <me@tobin.cc>
>
> Thanks, applied. I did fix up a few of your newly added doc strings.
>
> - Ted

Oh cool, thanks.

Tobin

\
 
 \ /
  Last update: 2018-01-14 23:20    [W:0.048 / U:0.316 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site