From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (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 818C437BE7A; Tue, 28 Apr 2026 17:02:19 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777395739; cv=none; b=jqYhX14po4QV9SjIgu9/kS1sL1uj1loi+rkdax0QQEqoI5Fyyuzp17u+0G1/yU08EoFlyQfvgVRfr/i2arhbx2HIkZdyZeML6FMxLJ8nAWiYhCjXFYLHuzgLAVOAU8ifwZlv4wyBQUd+7zkhHJS9bIB7VBKslgKr5YDxoIK4IC8= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777395739; c=relaxed/simple; bh=V6CuhK8550wHphiPFsN/M/PZ433ya4x50SU0y3UZ/BY=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=leRFyPeh4yakvyCRUuTCJtSQTNjPKbaI1d+XdkIbbW8VupIczoEXSkP6nQ6CVktyxAiO939kAHuVrMZOWOWxjGcE+9Fg+FFiuGYw0dDW4tDye96MdW77NzF7VehF14P3FOsP21dPHsk/1CXNnNYaqkM8JnasVOwpPxDWG0qYfbA= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=kS4WEWWf; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="kS4WEWWf" Received: by smtp.kernel.org (Postfix) with ESMTPS id 62D3EC2BCAF; Tue, 28 Apr 2026 17:02:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1777395739; bh=V6CuhK8550wHphiPFsN/M/PZ433ya4x50SU0y3UZ/BY=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=kS4WEWWfmEPJK1A2cZp06Qq2x/8S2MYTCsNKmd6Xh+0ckvdDYp+tYouhurlT8yRtq LEAVs2QHRsEMtMHB3WpTmZUA9G8f21Xey9O0yoCIzfrzTEpdOjwTbKWmzXVY1UuF1w 8KFqguNpCBphdo87XEoH0wEyuT5D3ZePYgxVJoISdadh5Hp5kS3T2Rx6iUBu10jkLX vfNUvCIKorBes+i5YXx/S/WDsEpNsnQTWBeNyLJdfY6zjhTyFPgGDcrAGHEK38tHp4 VEH8nfKv5zKnmX7LZicMXK0cgB2VcdxhnoJfxpvloO/byWj9ppZ8QrPzM40Ik2fzo/ UlyeWXDKk/jKQ== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 5A790FF886D; Tue, 28 Apr 2026 17:02:19 +0000 (UTC) From: Rodrigo Alencar via B4 Relay Date: Tue, 28 Apr 2026 18:02:25 +0100 Subject: [PATCH v3 10/11] iio: dac: ad5686: cleanup doc header of local structs Precedence: bulk X-Mailing-List: linux-iio@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20260428-ad5686-fixes-v3-10-9cff7bd67a15@analog.com> References: <20260428-ad5686-fixes-v3-0-9cff7bd67a15@analog.com> In-Reply-To: <20260428-ad5686-fixes-v3-0-9cff7bd67a15@analog.com> To: linux-iio@vger.kernel.org, linux-kernel@vger.kernel.org, Stefan Popa , Jonathan Cameron , Greg Kroah-Hartman , Michael Auchter , Jonathan Cameron Cc: Lars-Peter Clausen , Michael Hennerich , Jonathan Cameron , David Lechner , Andy Shevchenko , Rodrigo Alencar X-Mailer: b4 0.14.3 X-Developer-Signature: v=1; a=ed25519-sha256; t=1777395737; l=1834; i=rodrigo.alencar@analog.com; s=default; h=from:subject:message-id; bh=NQb3AgGGQZ59yKcVrlDP4JkvUat0ii8BBIGlKfXjgXQ=; b=dznFO1UTA8q8kEGQr+xs5PB5JG31tevNm6X0SgD3uXlujb/oxl3mPEmErOFlkcSrCH89bs4fU 5mIayNeYr5dBMrO2zZEvrITqUeMk+hpqatfjzyAUZW/NlXIm+l1lUgV X-Developer-Key: i=rodrigo.alencar@analog.com; a=ed25519; pk=ULeHbgU/OYh/PG/4anHDfLgldFItQHAhOktYRVLMFRo= X-Endpoint-Received: by B4 Relay for rodrigo.alencar@analog.com/default with auth_id=561 X-Original-From: Rodrigo Alencar Reply-To: rodrigo.alencar@analog.com From: Rodrigo Alencar Review documentation comment header for ad5686_chip_info and ad5686_state. Update variable names and description and remove unnecessary blank line between comment and struct declaration. Signed-off-by: Rodrigo Alencar --- drivers/iio/dac/ad5686.h | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/drivers/iio/dac/ad5686.h b/drivers/iio/dac/ad5686.h index 09c87e15c37e..48b2b60001b0 100644 --- a/drivers/iio/dac/ad5686.h +++ b/drivers/iio/dac/ad5686.h @@ -67,12 +67,11 @@ typedef int (*ad5686_read_func)(struct ad5686_state *st, u8 addr); /** * struct ad5686_chip_info - chip specific information - * @int_vref_mv: AD5620/40/60: the internal reference voltage + * @int_vref_mv: the internal reference voltage * @num_channels: number of channels * @channel: channel specification * @regmap_type: register map layout variant */ - struct ad5686_chip_info { u16 int_vref_mv; unsigned int num_channels; @@ -110,16 +109,16 @@ extern const struct ad5686_chip_info ad5679r_chip_info; /** * struct ad5686_state - driver instance specific data - * @spi: spi_device + * @dev: device instance * @chip_info: chip model specific constants, available modes etc * @vref_mv: actual reference voltage used * @pwr_down_mask: power down mask * @pwr_down_mode: current power down mode * @use_internal_vref: set to true if the internal reference voltage is used - * @lock lock to protect the data buffer during regmap ops - * @data: spi transfer buffers + * @lock: lock to protect access to state fields, which includes + * the data buffer during regmap ops + * @data: transfer buffers */ - struct ad5686_state { struct device *dev; const struct ad5686_chip_info *chip_info; -- 2.43.0