[PATCH 0/6] nilfs2: fix kernel-doc comments for function return values

Ryusuke Konishi posted 6 patches 11 months, 2 weeks ago
There is a newer version of this series
fs/nilfs2/alloc.c     |  64 +++++++++++-
fs/nilfs2/alloc.h     |   2 +
fs/nilfs2/bmap.c      | 113 +++++++++-------------
fs/nilfs2/btree.c     |   7 +-
fs/nilfs2/cpfile.c    |  49 ++++------
fs/nilfs2/dat.c       |  39 +++-----
fs/nilfs2/gcinode.c   |  22 ++---
fs/nilfs2/ifile.c     |  32 +++---
fs/nilfs2/inode.c     |  16 ++-
fs/nilfs2/ioctl.c     | 220 ++++++++++++++++--------------------------
fs/nilfs2/mdt.c       |  59 ++++++-----
fs/nilfs2/page.c      |   8 +-
fs/nilfs2/recovery.c  |  57 +++++++----
fs/nilfs2/segbuf.c    |  12 +--
fs/nilfs2/segment.c   |  53 +++++-----
fs/nilfs2/sufile.c    | 104 ++++++++------------
fs/nilfs2/sufile.h    |  21 ++--
fs/nilfs2/super.c     |  10 +-
fs/nilfs2/the_nilfs.c |  25 +++--
19 files changed, 428 insertions(+), 485 deletions(-)
[PATCH 0/6] nilfs2: fix kernel-doc comments for function return values
Posted by Ryusuke Konishi 11 months, 2 weeks ago
Hi Andrew,

please add this series to the queue for the next merge window.

This series fixes the inadequacies in the return value descriptions in
nilfs2's kernel-doc comments (mainly incorrect formatting), as well as
the lack of return value descriptions themselves, and fixes most of
the remaining warnings that are output when the kernel-doc script is
run with the "-Wall" option.

Thanks,
Ryusuke Konishi

Ryusuke Konishi (6):
  nilfs2: correct return value kernel-doc descriptions for ioctl
    functions
  nilfs2: correct return value kernel-doc descriptions for bmap
    functions
  nilfs2: correct return value kernel-doc descriptions for sufile
  nilfs2: correct return value kernel-doc descriptions for metadata
    files
  nilfs2: correct return value kernel-doc descriptions for the rest
  nilfs2: add missing return value kernel-doc descriptions

 fs/nilfs2/alloc.c     |  64 +++++++++++-
 fs/nilfs2/alloc.h     |   2 +
 fs/nilfs2/bmap.c      | 113 +++++++++-------------
 fs/nilfs2/btree.c     |   7 +-
 fs/nilfs2/cpfile.c    |  49 ++++------
 fs/nilfs2/dat.c       |  39 +++-----
 fs/nilfs2/gcinode.c   |  22 ++---
 fs/nilfs2/ifile.c     |  32 +++---
 fs/nilfs2/inode.c     |  16 ++-
 fs/nilfs2/ioctl.c     | 220 ++++++++++++++++--------------------------
 fs/nilfs2/mdt.c       |  59 ++++++-----
 fs/nilfs2/page.c      |   8 +-
 fs/nilfs2/recovery.c  |  57 +++++++----
 fs/nilfs2/segbuf.c    |  12 +--
 fs/nilfs2/segment.c   |  53 +++++-----
 fs/nilfs2/sufile.c    | 104 ++++++++------------
 fs/nilfs2/sufile.h    |  21 ++--
 fs/nilfs2/super.c     |  10 +-
 fs/nilfs2/the_nilfs.c |  25 +++--
 19 files changed, 428 insertions(+), 485 deletions(-)

-- 
2.43.0