lists.openwall.net | lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC | |
Open Source and information security mailing list archives
| ||
|
Message-ID: <20180110062930.GA25272@eros> Date: Wed, 10 Jan 2018 17:29:30 +1100 From: "Tobin C. Harding" <me@...in.cc> To: Theodore Ts'o <tytso@....edu>, Jan Kara <jack@...e.com>, linux-ext4@...r.kernel.org, linux-kernel@...r.kernel.org Subject: Re: [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@...in.cc> > > Thanks, applied. I did fix up a few of your newly added doc strings. > > - Ted Oh cool, thanks. Tobin
Powered by blists - more mailing lists