All of lore.kernel.org
 help / color / mirror / Atom feed
From: Lee Jones <lee.jones@linaro.org>
To: lee.jones@linaro.org
Cc: linux-kernel@vger.kernel.org,
	Anton Altaparmakov <anton@tuxera.com>,
	linux-ntfs-dev@lists.sourceforge.net
Subject: [PATCH 09/15] fs: ntfs: attrib: File headers are not good candidates for kernel-doc
Date: Thu, 20 May 2021 13:00:37 +0100	[thread overview]
Message-ID: <20210520120043.3462759-10-lee.jones@linaro.org> (raw)
In-Reply-To: <20210520120043.3462759-1-lee.jones@linaro.org>

Fixes the following W=1 kernel build warning(s):

 fs/ntfs/attrib.c:25: warning: Incorrect use of kernel-doc format:  * ntfs_map_runlist_nolock - map (a part of) a runlist of an ntfs inode
 fs/ntfs/attrib.c:71: warning: Function parameter or member 'ni' not described in 'ntfs_map_runlist_nolock'
 fs/ntfs/attrib.c:71: warning: Function parameter or member 'vcn' not described in 'ntfs_map_runlist_nolock'
 fs/ntfs/attrib.c:71: warning: Function parameter or member 'ctx' not described in 'ntfs_map_runlist_nolock'
 fs/ntfs/attrib.c:71: warning: expecting prototype for c(). Prototype was for ntfs_map_runlist_nolock() instead

Cc: Anton Altaparmakov <anton@tuxera.com>
Cc: linux-ntfs-dev@lists.sourceforge.net
Signed-off-by: Lee Jones <lee.jones@linaro.org>
---
 fs/ntfs/attrib.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/fs/ntfs/attrib.c b/fs/ntfs/attrib.c
index d563abc3e1364..2911c04a33e01 100644
--- a/fs/ntfs/attrib.c
+++ b/fs/ntfs/attrib.c
@@ -1,5 +1,5 @@
 // SPDX-License-Identifier: GPL-2.0-or-later
-/**
+/*
  * attrib.c - NTFS attribute operations.  Part of the Linux-NTFS project.
  *
  * Copyright (c) 2001-2012 Anton Altaparmakov and Tuxera Inc.
-- 
2.31.1


  parent reply	other threads:[~2021-05-20 12:41 UTC|newest]

Thread overview: 25+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-05-20 12:00 [PATCH 00/15] Rid W=1 warnings from FS {GFS2,NTFS} Lee Jones
2021-05-20 12:00 ` [Cluster-devel] [PATCH 00/15] Rid W=1 warnings from FS {GFS2, NTFS} Lee Jones
2021-05-20 12:00 ` [PATCH 01/15] fs: gfs2: bmap: Demote half-complete kernel-doc headers fix others Lee Jones
2021-05-20 12:00   ` [Cluster-devel] " Lee Jones
2021-05-20 12:00 ` [PATCH 02/15] fs: gfs2: glock: Fix some deficient kernel-doc headers and demote non-conformant ones Lee Jones
2021-05-20 12:00   ` [Cluster-devel] " Lee Jones
2021-05-21  3:13   ` Andreas Gruenbacher
2021-05-21  3:13     ` [Cluster-devel] " Andreas Gruenbacher
2021-05-21  6:58     ` Lee Jones
2021-05-21  6:58       ` [Cluster-devel] " Lee Jones
2021-05-21  7:01       ` Lee Jones
2021-05-21  7:01         ` [Cluster-devel] " Lee Jones
2021-05-20 12:00 ` [PATCH 03/15] fs: ntfs: namei: Demote non-conformant kernel-doc headers Lee Jones
2021-05-20 12:00 ` [PATCH 04/15] fs: ntfs: unistr: Add missing param descriptions for 'name{1,2}_len' Lee Jones
2021-05-20 12:00 ` [PATCH 05/15] fs: ntfs: compress: Demote a few non-conformant kernel-doc headers Lee Jones
2021-05-20 12:00 ` [PATCH 06/15] fs: ntfs: dir: Supply missing descriptions for 'start' and 'end' and demote other headers Lee Jones
2021-05-20 12:00 ` [PATCH 07/15] fs: ntfs: runlist: Demote non-conformant kernel-doc headers Lee Jones
2021-05-20 12:00 ` [PATCH 08/15] fs: ntfs: inode: Fix incorrect function name and demote file header Lee Jones
2021-05-20 12:00 ` Lee Jones [this message]
2021-05-20 12:00 ` [PATCH 10/15] fs: ntfs: aops: Demote kernel-doc abuses Lee Jones
2021-05-20 12:00 ` [PATCH 11/15] fs: ntfs: super: Provide missing description and demote non-conformant headers Lee Jones
2021-05-20 12:00 ` [PATCH 12/15] fs: ntfs: file: Provide missing descriptions for 'start' and 'end' Lee Jones
2021-05-20 12:00 ` [PATCH 13/15] fs: ntfs: mft: File headers to not make good candidates for kernel-doc Lee Jones
2021-05-20 12:00 ` [PATCH 14/15] fs: ntfs: compress: File headers are not " Lee Jones
2021-05-20 12:00 ` [PATCH 15/15] fs: ntfs: runlist: " Lee Jones

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=20210520120043.3462759-10-lee.jones@linaro.org \
    --to=lee.jones@linaro.org \
    --cc=anton@tuxera.com \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-ntfs-dev@lists.sourceforge.net \
    /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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.