From nobody Fri Jul 24 04:50:44 2026 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id BD8B337F317 for ; Thu, 23 Jul 2026 18:12:18 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784830347; cv=none; b=YLBDVlwJMRSA6ybG9CM+eeea+d+Cab2zdIe1b2iNQ+2aC5kItCn9dliAV3os5q7LkR9vGcQs+TzHF4gZACYesZNqx7GekoKvCRgxhpEzhdgIasSzq4m2lS4TD+09ik7UO3rSUDM/HlruSv/K7qA7MefptBxjumF1XJT8QSNhoP8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784830347; c=relaxed/simple; bh=s2OeYmsakMOzvenpTPAhdmFWDtMdlvqER2pXZLD70fI=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=rBLtpqphv6VtAHUkkOw9TQ6N3r5kd6ARN5GJzQ7+b0OX6LYi/DH1gq9aMvJ59uz3oWKNY6HfRlUPfB8TObVAR2wfOPV5fP6WUXWDJvNaBYrxR0TWQd4xC/Pi5/2qJ9uwNrvPrvk6syikFOjxY+aSmOkoUC/IuV6C6LG6QV5qNwM= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org; spf=pass smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=RM2TQxdB; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=infradead.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="RM2TQxdB" 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=U/PAgPe4T6/FAbOlT6ZIgNOCrl/ykmU/Z2EEaX6i6N4=; b=RM2TQxdBberAK/9kK+a6B9eigY 3IFRZZvDMEOt5lbpav1MNawhjvK7kI8MNYn1HbMlwgA/4iRnZURLir6scDOZmPP/1S5Nt9bPXBRjb FCTxXNbZQVw/GQ18qvUsPkWLU2DpXMzLnYh5STXtsKmU6B2pa6vVdjPUih1tZtTAUOv+J1t2+mIPF qPU0nwu8o7vksIm4YrTN/8QAZa8pe5M9MsYeV3uDZt6ga/n3VHRCjOndbSbCLy7G6mJakLjkmuxV7 46A85d7daZCGpD71Rfh0VAFtJIaRVzs/fRVqNLxbxGGIs5OfNJYdCLvpbZRuZtBI0LxpSgGjPm6lD waOLwuvg==; Received: from [50.53.43.113] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.99.1 #2 (Red Hat Linux)) id 1wmxu4-0000000ErsN-24f6; Thu, 23 Jul 2026 18:12:16 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Mark Brown , Andy Shevchenko , Linus Walleij , Matti Vaittinen Subject: [PATCH] regmap: clean up kernel-doc comments Date: Thu, 23 Jul 2026 11:12:15 -0700 Message-ID: <20260723181215.419984-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.55.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" - add/correct missing struct members in struct regmap_bus - add a missing function parameter @dev - add missing struct member in struct regmap_irq_type - add missing struct members in struct regmap_irq_chip to prevent kernel-doc warnings: Warning: include/linux/regmap.h:630 struct member 'reg_noinc_write' not described in 'regmap_bus' Warning: include/linux/regmap.h:630 struct member 'reg_noinc_read' not described in 'regmap_bus' Warning: include/linux/regmap.h:630 Excess struct member 'reg_write_noinc' description in 'regmap_bus' Warning: include/linux/regmap.h:1001 function parameter 'dev' not described in 'regmap_init_sdw_mbq_cfg' Warning: include/linux/regmap.h:1600 struct member 'type_reg_mask' not described in 'regmap_irq_type' Warning: include/linux/regmap.h:1775 struct member 'irq_reqres' not described in 'regmap_irq_chip' Warning: include/linux/regmap.h:1775 struct member 'irq_relres' not described in 'regmap_irq_chip' Signed-off-by: Randy Dunlap --- Cc: Mark Brown Cc: Andy Shevchenko Cc: Linus Walleij Cc: Matti Vaittinen include/linux/regmap.h | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) --- linux-next-20260722.orig/include/linux/regmap.h +++ linux-next-20260722/include/linux/regmap.h @@ -587,7 +587,7 @@ typedef void (*regmap_hw_free_context)(v * must serialise with respect to non-async I/O. * @reg_write: Write a single register value to the given register address= . This * write operation has to complete when returning from the fun= ction. - * @reg_write_noinc: Write multiple register value to the same register. T= his + * @reg_noinc_write: Write multiple register values to the same register. = This * write operation has to complete when returning from the fun= ction. * @reg_update_bits: Update bits operation to be used against volatile * registers, intended for devices supporting some mecha= nism @@ -596,6 +596,8 @@ typedef void (*regmap_hw_free_context)(v * @read: Read operation. Data is returned in the buffer used to transmit * data. * @reg_read: Read a single register value from a given register address. + * @reg_noinc_read: Read multiple register values from the same register. = This + * read operation has to complete when returning from the func= tion. * @free_context: Free context. * @async_alloc: Allocate a regmap_async() structure. * @read_flag_mask: Mask to be set in the top byte of the register when do= ing @@ -991,7 +993,8 @@ bool regmap_ac97_default_volatile(struct /** * regmap_init_sdw_mbq_cfg() - Initialise MBQ SDW register map with config * - * @sdw: Device that will be interacted with + * @dev: &struct device that will be interacted with + * @sdw: Soundwire device that will be interacted with * @config: Configuration for register map * @mbq_config: Properties for the MBQ registers * @@ -1584,6 +1587,7 @@ regmap_fields_force_update_bits(struct r * struct regmap_irq_type - IRQ type definitions. * * @type_reg_offset: Offset register for the irq type setting. + * @type_reg_mask: Device interrupt mask * @type_rising_val: Register value to configure RISING type irq. * @type_falling_val: Register value to configure FALLING type irq. * @type_level_low_val: Register value to configure LEVEL_LOW type irq. @@ -1717,6 +1721,8 @@ struct regmap_irq_chip_data; * main status base, [0, num_config_regs[ for any config * register base, and [0, num_regs[ for any other base. * If unspecified then regmap_irq_get_irq_reg_linear() is used. + * @irq_reqres: Callback function to request IRQ resources (may be %NULL) + * @irq_relres: Callback function to release IRQ resources (may be %NULL) * @irq_drv_data: Driver specific IRQ data which is passed as parameter= when * driver specific pre/post interrupt handler is called. *