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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [thread-next>] [day] [month] [year] [list]

Message-Id: <20240816074319.3253-1-konishi.ryusuke@gmail.com>
Date: Fri, 16 Aug 2024 16:43:11 +0900
From: Ryusuke Konishi <konishi.ryusuke@...il.com>
To: Andrew Morton <akpm@...ux-foundation.org>
Cc: linux-nilfs@...r.kernel.org,
	linux-kernel@...r.kernel.org
Subject: [PATCH 0/8] nilfs2: clean up kernel-doc warnings

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