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

From: Theodore Ts'o
Date: Wed Jan 10 2018 - 00:26:28 EST


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