linux-kernel.vger.kernel.org archive mirror
 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 05/15] fs: ntfs: compress: Demote a few non-conformant kernel-doc headers
Date: Thu, 20 May 2021 13:00:33 +0100	[thread overview]
Message-ID: <20210520120043.3462759-6-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/compress.c:22: warning: Incorrect use of kernel-doc format:  * ntfs_compression_constants - enum of constants used in the compression code
 fs/ntfs/compress.c:24: warning: cannot understand function prototype: 'typedef enum '
 fs/ntfs/compress.c:47: warning: cannot understand function prototype: 'u8 *ntfs_compression_buffer; '
 fs/ntfs/compress.c:52: warning: Function parameter or member 'ntfs_cb_lock' not described in 'DEFINE_SPINLOCK'
 fs/ntfs/compress.c:52: warning: expecting prototype for ntfs_cb_lock(). Prototype was for DEFINE_SPINLOCK() instead
 fs/ntfs/compress.c:88: warning: Function parameter or member 'page' not described in 'zero_partial_compressed_page'
 fs/ntfs/compress.c:88: warning: Function parameter or member 'initialized_size' not described in 'zero_partial_compressed_page'
 fs/ntfs/compress.c:107: warning: Function parameter or member 'page' not described in 'handle_bounds_compressed_page'
 fs/ntfs/compress.c:107: warning: Function parameter or member 'i_size' not described in 'handle_bounds_compressed_page'
 fs/ntfs/compress.c:107: warning: Function parameter or member 'initialized_size' not described in 'handle_bounds_compressed_page'

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

diff --git a/fs/ntfs/compress.c b/fs/ntfs/compress.c
index d2f9d6a0ee323..12444ac8f8ec5 100644
--- a/fs/ntfs/compress.c
+++ b/fs/ntfs/compress.c
@@ -18,7 +18,7 @@
 #include "debug.h"
 #include "ntfs.h"
 
-/**
+/*
  * ntfs_compression_constants - enum of constants used in the compression code
  */
 typedef enum {
@@ -41,12 +41,12 @@ typedef enum {
 	NTFS_MAX_CB_SIZE	= 64 * 1024,
 } ntfs_compression_constants;
 
-/**
+/*
  * ntfs_compression_buffer - one buffer for the decompression engine
  */
 static u8 *ntfs_compression_buffer;
 
-/**
+/*
  * ntfs_cb_lock - spinlock which protects ntfs_compression_buffer
  */
 static DEFINE_SPINLOCK(ntfs_cb_lock);
@@ -80,7 +80,7 @@ void free_compression_buffers(void)
 	ntfs_compression_buffer = NULL;
 }
 
-/**
+/*
  * zero_partial_compressed_page - zero out of bounds compressed page region
  */
 static void zero_partial_compressed_page(struct page *page,
@@ -99,7 +99,7 @@ static void zero_partial_compressed_page(struct page *page,
 	return;
 }
 
-/**
+/*
  * handle_bounds_compressed_page - test for&handle out of bounds compressed page
  */
 static inline void handle_bounds_compressed_page(struct page *page,
-- 
2.31.1


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

Thread overview: 19+ 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 ` [PATCH 01/15] fs: gfs2: bmap: Demote half-complete kernel-doc headers fix others 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-21  3:13   ` Andreas Gruenbacher
2021-05-21  6:58     ` Lee Jones
2021-05-21  7:01       ` 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 ` Lee Jones [this message]
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 ` [PATCH 09/15] fs: ntfs: attrib: File headers are not good candidates for kernel-doc Lee Jones
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-6-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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).