• Tobin C. Harding's avatar
    jbd2: fix sphinx kernel-doc build warnings · f69120ce
    Tobin C. Harding authored
    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's avatarTobin C. Harding <me@tobin.cc>
    Signed-off-by: Theodore Ts'o's avatarTheodore Ts'o <tytso@mit.edu>
    Cc: stable@vger.kernel.org
    f69120ce
jbd2.h 45.7 KB