mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
From: Ryusuke Konishi <konishi.ryusuke@gmail.com>
To: Andrew Morton <akpm@linux-foundation.org>
Cc: linux-nilfs@vger.kernel.org, linux-kernel@vger.kernel.org
Subject: [PATCH 0/8] nilfs2: clean up kernel-doc warnings
Date: Fri, 16 Aug 2024 16:43:11 +0900	[thread overview]
Message-ID: <20240816074319.3253-1-konishi.ryusuke@gmail.com> (raw)

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


             reply	other threads:[~2024-08-16  7:43 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-08-16  7:43 Ryusuke Konishi [this message]
2024-08-16  7:43 ` [PATCH 1/8] nilfs2: add missing argument description for __nilfs_error() Ryusuke Konishi
2024-08-16  7:43 ` [PATCH 2/8] nilfs2: add missing argument descriptions for ioctl-related helpers Ryusuke Konishi
2024-08-16  7:43 ` [PATCH 3/8] nilfs2: improve kernel-doc comments for b-tree node helpers Ryusuke Konishi
2024-08-16  7:43 ` [PATCH 4/8] nilfs2: fix incorrect kernel-doc declaration of nilfs_palloc_req structure Ryusuke Konishi
2024-08-16  7:43 ` [PATCH 5/8] nilfs2: add missing description of nilfs_btree_path structure Ryusuke Konishi
2024-08-16  7:43 ` [PATCH 6/8] nilfs2: describe the members of nilfs_bmap_operations structure Ryusuke Konishi
2024-08-16  7:43 ` [PATCH 7/8] nilfs2: fix inconsistencies in kernel-doc comments in segment.h Ryusuke Konishi
2024-08-16  7:43 ` [PATCH 8/8] nilfs2: fix missing initial short descriptions of kernel-doc comments Ryusuke Konishi

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20240816074319.3253-1-konishi.ryusuke@gmail.com \
    --to=konishi.ryusuke@gmail.com \
    --cc=akpm@linux-foundation.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-nilfs@vger.kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®