[PATCH 0/8] nilfs2: clean up kernel-doc warnings

From: Ryusuke Konishi
Date: Fri Aug 16 2024 - 03:48:17 EST


Hi Andrew, please add this series to the queue for the next cycle.

This series fixes a number of formatting issues in kernel doc comments
that were detected as warnings by the kernel-doc script, making
violations more noticeable when adding or modifying kernel doc.

There are still warnings output by "kernel-doc -Wall", but they are
widespread, so I plan to fix them at another time while considering
priorities.

Thanks,
Ryusuke Konishi

Ryusuke Konishi (8):
nilfs2: add missing argument description for __nilfs_error()
nilfs2: add missing argument descriptions for ioctl-related helpers
nilfs2: improve kernel-doc comments for b-tree node helpers
nilfs2: fix incorrect kernel-doc declaration of nilfs_palloc_req
structure
nilfs2: add missing description of nilfs_btree_path structure
nilfs2: describe the members of nilfs_bmap_operations structure
nilfs2: fix inconsistencies in kernel-doc comments in segment.h
nilfs2: fix missing initial short descriptions of kernel-doc comments

fs/nilfs2/alloc.h | 2 +-
fs/nilfs2/bmap.c | 2 +-
fs/nilfs2/bmap.h | 15 ++++++++++-
fs/nilfs2/btnode.c | 63 ++++++++++++++++++++++++++++++++++++++-------
fs/nilfs2/btree.h | 1 +
fs/nilfs2/cpfile.c | 32 +++++++++++------------
fs/nilfs2/dat.c | 17 +++++-------
fs/nilfs2/ioctl.c | 17 ++++++++++--
fs/nilfs2/segment.h | 7 ++---
fs/nilfs2/sufile.c | 20 ++++++--------
fs/nilfs2/super.c | 4 +++
11 files changed, 125 insertions(+), 55 deletions(-)

--
2.34.1