Messages in this thread | | | Date | Wed, 10 Jan 2018 00:26:19 -0500 | From | Theodore Ts'o <> | Subject | Re: [PATCH v2] jbd2: fix sphinx kerel-doc build warnings |
| |
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
| |