From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="KgF5wg0F" Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 0DB2A129 for ; Tue, 5 Dec 2023 18:43:19 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:In-Reply-To:References; bh=26A3YHjICnDcH88vC6VbljrhakN/zxAeim86TOcMSOg=; b=KgF5wg0FnDsCqDGbCUNgGZs6SX yZKFNzk19SoRM9ixr3ky9W0fsmAe9DxsQ0nqIJe8AQfFqOLvt8Vpgh7tNakMSDleIfX+f0PV3hKDZ Nq5W34mmHtTQNl/4ygs2GEGHQBwwvAXfykBVwFnDJgTYFc/OAtUVcOTTrVPPqAHvkTN15HRXjT0+x 8JT42T5YytjXLvOB0UnZlhzlwRRXu8nPYx5HjO0mCdeE6LoVjwO7zcHFZI2RnBL34AT+s9JMhsIgX J5HjJgy5dsytPfgDViXHJQIjNIQQyrfNcq57KNY3hGh7grNe8hVXMh9tARCVfm+Vi9VrluwYoffw5 AvbcPGqg==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rAhsc-008uHC-1P; Wed, 06 Dec 2023 02:43:18 +0000 From: Randy Dunlap To: linux-fsdevel@vger.kernel.org Cc: Randy Dunlap , Alexander Viro , Christian Brauner , Jens Axboe Subject: [PATCH] fs/hfsplus: wrapper.c: fix kernel-doc warnings Date: Tue, 5 Dec 2023 18:43:17 -0800 Message-ID: <20231206024317.31020-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 Precedence: bulk X-Mailing-List: linux-fsdevel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Fix kernel-doc warnings found when using "W=1". wrapper.c:48: warning: No description found for return value of 'hfsplus_submit_bio' wrapper.c:49: warning: Function parameter or member 'opf' not described in 'hfsplus_submit_bio' wrapper.c:49: warning: Excess function parameter 'op' description in 'hfsplus_submit_bio' wrapper.c:49: warning: Excess function parameter 'op_flags' description in 'hfsplus_submit_bio' Signed-off-by: Randy Dunlap Cc: linux-fsdevel@vger.kernel.org Cc: Alexander Viro Cc: Christian Brauner Cc: Jens Axboe --- fs/hfsplus/wrapper.c | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff -- a/fs/hfsplus/wrapper.c b/fs/hfsplus/wrapper.c --- a/fs/hfsplus/wrapper.c +++ b/fs/hfsplus/wrapper.c @@ -30,8 +30,7 @@ struct hfsplus_wd { * @sector: block to read or write, for blocks of HFSPLUS_SECTOR_SIZE bytes * @buf: buffer for I/O * @data: output pointer for location of requested data - * @op: direction of I/O - * @op_flags: request op flags + * @opf: request op flags * * The unit of I/O is hfsplus_min_io_size(sb), which may be bigger than * HFSPLUS_SECTOR_SIZE, and @buf must be sized accordingly. On reads @@ -43,6 +42,8 @@ struct hfsplus_wd { * that starts at the rounded-down address. As long as the data was * read using hfsplus_submit_bio() and the same buffer is used things * will work correctly. + * + * Returns: %0 on success else -errno code */ int hfsplus_submit_bio(struct super_block *sb, sector_t sector, void *buf, void **data, blk_opf_t opf)