Re: [PATCH v2] jbd2: fix sphinx kerel-doc build warnings

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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@xxxxxxxx>
> 
> Thanks, applied.  I did fix up a few of your newly added doc strings.
> 
> 		    	       - Ted

Oh cool, thanks.

	Tobin



[Index of Archives]     [Reiser Filesystem Development]     [Ceph FS]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite National Park]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Device Mapper]     [Linux Media]

  Powered by Linux