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 14646C8C2; Thu, 28 Dec 2023 14:47:01 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id B9CA2C433C7; Thu, 28 Dec 2023 14:47:00 +0000 (UTC) Date: Thu, 28 Dec 2023 09:46:57 -0500 From: William Breathitt Gray To: Randy Dunlap Cc: linux-kernel@vger.kernel.org, linux-iio@vger.kernel.org Subject: Re: [PATCH] counter: linux/counter.h: fix Excess kernel-doc description warning Message-ID: References: <20231223050511.13849-1-rdunlap@infradead.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="Cv3hjeTS7H5THrLU" Content-Disposition: inline In-Reply-To: --Cv3hjeTS7H5THrLU Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Dec 27, 2023 at 01:40:01PM -0800, Randy Dunlap wrote: >=20 >=20 > On 12/27/23 06:35, William Breathitt Gray wrote: > > On Fri, Dec 22, 2023 at 09:05:11PM -0800, Randy Dunlap wrote: > >> Remove the @priv: line to prevent the kernel-doc warning: > >> > >> include/linux/counter.h:400: warning: Excess struct member 'priv' desc= ription in 'counter_device' > >> > >> Signed-off-by: Randy Dunlap > >> Cc: William Breathitt Gray > >> Cc: linux-iio@vger.kernel.org > >> --- > >> include/linux/counter.h | 1 - > >> 1 file changed, 1 deletion(-) > >> > >> diff -- a/include/linux/counter.h b/include/linux/counter.h > >> --- a/include/linux/counter.h > >> +++ b/include/linux/counter.h > >> @@ -359,7 +359,6 @@ struct counter_ops { > >> * @num_counts: number of Counts specified in @counts > >> * @ext: optional array of Counter device extensions > >> * @num_ext: number of Counter device extensions specified in @ext > >> - * @priv: optional private data supplied by driver > >> * @dev: internal device structure > >> * @chrdev: internal character device structure > >> * @events_list: list of current watching Counter events > >=20 > > Hi Randy, > >=20 > > Would you provide a Fixes tag for the commit that removed the 'priv' > > member so we can track when this warning appeared? You can respond with > > it to this thread and I'll add it in when I merge your patch. >=20 > Fixes: f2ee4759fb70 ("counter: remove old and now unused registration API= ") >=20 > Thank you. >=20 > --=20 > #Randy Applied, thanks! [1/1] counter: linux/counter.h: fix Excess kernel-doc description warning commit: 49ca40f8d6ceb76bff83713f79215d8e6252f045 William Breathitt Gray --Cv3hjeTS7H5THrLU Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iHUEARYKAB0WIQSNN83d4NIlKPjon7a1SFbKvhIjKwUCZY2KYQAKCRC1SFbKvhIj K8I3AP4mGbr+wtyRDo1GphV/Mqi26l7KwWRm5pnhhSCdo19tTQEAtJ8TKXYmZ4a8 erikOulmMaHyp3q5WHk9hw9MJmKWlQ0= =kQuO -----END PGP SIGNATURE----- --Cv3hjeTS7H5THrLU--