From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wr1-f48.google.com (mail-wr1-f48.google.com [209.85.221.48]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id CEE5A3128CC for ; Tue, 28 Oct 2025 11:56:25 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.48 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761652587; cv=none; b=N9SrkuUH36wOHPG8iE6yItmJobodtWyKb65ZdClbpEUXSTjiPadtxCITVG2IN/Bwm9IX/RrktgEg2FnordWMgaRm5nUYQK/5o8JhrtNhA2ZWtH3tyhathj2BuyqrVTlYyTtatEfqCN1+ZmJ9LkLrSu8ZG1P1X3/muVm4q0qUuUc= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761652587; c=relaxed/simple; bh=Ib4FTXEwOtlDTXM2VpO+nl6c+5tWeUf7p5dmbiVpUfs=; h=Message-ID:Subject:From:To:Cc:Date:In-Reply-To:References: Content-Type:MIME-Version; b=CdCAWB9w2J5Mi73C7bn83tbJ0KmUBSEBVl/bK5y2hhmTF6EGETaPoWEy1Dgopuq2FCXZFlvhEGmVvGj4gI+BZAX8zkIMwpCGrQwZLvSQEWRovcLLVTKBfGHSMtZBavpO3wvVtBMzR4c3kwFfjMaaezhjwQ7MhWt9YZMF/DPmMos= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=N0YA64Xw; arc=none smtp.client-ip=209.85.221.48 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="N0YA64Xw" Received: by mail-wr1-f48.google.com with SMTP id ffacd0b85a97d-3ecdf2b1751so4073441f8f.0 for ; Tue, 28 Oct 2025 04:56:25 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761652584; x=1762257384; darn=vger.kernel.org; h=mime-version:user-agent:content-transfer-encoding:references :in-reply-to:date:cc:to:from:subject:message-id:from:to:cc:subject :date:message-id:reply-to; bh=Ib4FTXEwOtlDTXM2VpO+nl6c+5tWeUf7p5dmbiVpUfs=; b=N0YA64XwtWzOvj9H4V8peXzUoAq4NeO8IqQeaF57q5emQdaS7jRffhSfbXmbucKA/x nrGb5808rJ6w2mIfHDYK0sXymb9M72Eoakp9fu2E03eihVgVme39DiulAFmRFyht7LVS f3q4GqEVV1U2F2+ADpRchyc7kAG9JkZ3n2AsZl3fVPY0vC6gzMKW3iTztrUlXBtRXEbR 4EQ2bQiefTgUKiJ7syb6w2g3sceHd+r5pRhiO3zhhnMHW/U8y31WPvS38DvSXApNLvp7 Tb8Hqa5IM0xeOKY/Zltx44hu0biLU6chn1Q09JncWgjD3FYMFcxdOt8u5mOlfqPql8fd 8Huw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761652584; x=1762257384; h=mime-version:user-agent:content-transfer-encoding:references :in-reply-to:date:cc:to:from:subject:message-id:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=Ib4FTXEwOtlDTXM2VpO+nl6c+5tWeUf7p5dmbiVpUfs=; b=EFaPGA3fnsAMDT5/wE0f8sy4Kvqm+egfUDjTsyR2NjRpQ/pyfNj7uvwMpoUtxuXuE8 iQURPwHzyEUa8BFn5pdpiR1qXzlWqTCijnphxmQgljWi7g3aUzuyWfyYbZlEkW1WVQBR TckSIic4y8OFPR04+ulzJS9MhVLRL8j+GqBpPqf+qxGr76GiAq/nOb+WkfTXsxLQTBiy NBfIc19Qi/nI1JxQRlyR2QJ4S3zgtwGMrU0auEKgJjL0CxdQW8kQHSNpFjOl66kgEcRA GCyOBZlqXeFckACR65BOMmBcJsycGbqjtctg8csAh6y/SFAtnDshVolBGuXU4ecDIYTd h5vg== X-Forwarded-Encrypted: i=1; AJvYcCWNSj4BYIbe/Q4P6oFBYUENNY316xSOLj2sizYfQrAxSYEVGhecKpyJzqxQVPla6l27/46TM6pCOiOjcIE=@vger.kernel.org X-Gm-Message-State: AOJu0Yyb6fIEfHBmCYEZqXV7b3mhBEShBA2sLZAmRfFPNkSfEKpMxND0 rckfnugfMeYSZ7EpPjQ0hjCQO44aqfj8OqAVCrn/PpkZWJzPHEnV2Fg4 X-Gm-Gg: ASbGncs2k+vjtZcceFlKpLZtLkuTuxV+M8CK2UGJseN5ji0fx7pBhOkui7z9FjRh+Id QLeUxRMlGbE6GTI/KxPCoXI4aXfiaj/DEpjD4hLkyirvq7FOE3NsUuWc4rrGNPQiqwqeS/2cYlO vw+N8CidX947NZdOHQRmotRnIxGIdTB2yjF7nNYHq7cyN/llCK/Xd9irnkRdGxDD9H0zXab+t8w 8D+sVgz/yRlMZl8sUcNvS9hUvK2t8GSMQqbMP//wCTnk5tN2yBtiFbSXCM63XlvJn2f2zQYwQku rVDYrFG2Z5i6TPTByxZIOI9B4jY7I7QpvRkf0Sl5s9HGHDHZKVIQk1dHRDKjpiXxIfdqja7aPpu UhAQWm4VW1TFMmHY44OOR61u4a+9NPLwbK3rS1y5EdSHB02ZfXcySVsTbrCyqwxd882Oe8pVb8W jB4zJNkta1 X-Google-Smtp-Source: AGHT+IHjYJZTMVZ2J00XT5f9CcLsMMeBwXk/4A4OAn+HKaImvZOZ6U1OX1tYqOecRVXVhSFhsX8FLg== X-Received: by 2002:a05:6000:2005:b0:427:6eb:8499 with SMTP id ffacd0b85a97d-429a7e59e59mr3391922f8f.24.1761652583845; Tue, 28 Oct 2025 04:56:23 -0700 (PDT) Received: from [192.168.1.187] ([161.230.67.253]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-429952de4a1sm20027993f8f.37.2025.10.28.04.56.23 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 28 Oct 2025 04:56:23 -0700 (PDT) Message-ID: <50f7ef82a98b2d2860466b85f172bcec36fd046b.camel@gmail.com> Subject: Re: [PATCH v3] iio: backend: fix kernel-doc to avoid warnings and ensure consistency From: Nuno =?ISO-8859-1?Q?S=E1?= To: Kriish Sharma , nuno.sa@analog.com, olivier.moysan@foss.st.com, jic23@kernel.org, dlechner@baylibre.com, andy@kernel.org Cc: linux-iio@vger.kernel.org, linux-kernel@vger.kernel.org, kernel test robot Date: Tue, 28 Oct 2025 11:56:58 +0000 In-Reply-To: <20251028093326.1087660-1-kriish.sharma2006@gmail.com> References: <20251028093326.1087660-1-kriish.sharma2006@gmail.com> Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable User-Agent: Evolution 3.58.1 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 On Tue, 2025-10-28 at 09:33 +0000, Kriish Sharma wrote: > Fix multiple kernel-doc warnings and make the documentation style > consistent in drivers/iio/industrialio-backend.c. >=20 > Changes include: > =C2=A0- Add missing @chan parameter description in > =C2=A0=C2=A0 iio_backend_oversampling_ratio_set(). > =C2=A0- Add missing RETURNS section in iio_backend_get_priv(). > =C2=A0- Replace Return: with =E2=80=9CRETURNS:=E2=80=9D across the file f= or consistency. >=20 > Reported-by: kernel test robot > Closes: > https://lore.kernel.org/oe-kbuild-all/202506292344.HLJbrrgR-lkp@intel.com > Suggested-by: Andy Shevchenko > Suggested-by: David Lechner > Signed-off-by: Kriish Sharma > --- Thanks for this! Reviewed-by: Nuno S=C3=A1 > v3: > =C2=A0- Changed Return: to RETURNS: for consistency across the file as > =C2=A0=C2=A0 suggested by David >=20 > v2: > https://lore.kernel.org/all/20251027092159.918445-1-kriish.sharma2006@gma= il.com >=20 > v1: > https://lore.kernel.org/all/20251025102008.253566-1-kriish.sharma2006@gma= il.com >=20 > =C2=A0drivers/iio/industrialio-backend.c | 8 ++++++-- > =C2=A01 file changed, 6 insertions(+), 2 deletions(-) >=20 > diff --git a/drivers/iio/industrialio-backend.c b/drivers/iio/industriali= o- > backend.c > index 23760652a046..447b694d6d5f 100644 > --- a/drivers/iio/industrialio-backend.c > +++ b/drivers/iio/industrialio-backend.c > @@ -702,7 +702,7 @@ EXPORT_SYMBOL_NS_GPL(iio_backend_interface_type_get, > "IIO_BACKEND"); > =C2=A0 * interface/data bus. Hence, the backend device needs to be aware = of it so > =C2=A0 * data can be correctly transferred. > =C2=A0 * > - * Return: > + * RETURNS: > =C2=A0 * 0 on success, negative error number on failure. > =C2=A0 */ > =C2=A0int iio_backend_data_size_set(struct iio_backend *back, unsigned in= t size) > @@ -717,9 +717,10 @@ EXPORT_SYMBOL_NS_GPL(iio_backend_data_size_set, > "IIO_BACKEND"); > =C2=A0/** > =C2=A0 * iio_backend_oversampling_ratio_set - set the oversampling ratio > =C2=A0 * @back: Backend device > + * @chan: Channel number > =C2=A0 * @ratio: The oversampling ratio - value 1 corresponds to no overs= ampling. > =C2=A0 * > - * Return: > + * RETURNS: > =C2=A0 * 0 on success, negative error number on failure. > =C2=A0 */ > =C2=A0int iio_backend_oversampling_ratio_set(struct iio_backend *back, > @@ -1064,6 +1065,9 @@ > EXPORT_SYMBOL_NS_GPL(__devm_iio_backend_get_from_fwnode_lookup, > "IIO_BACKEND"); > =C2=A0/** > =C2=A0 * iio_backend_get_priv - Get driver private data > =C2=A0 * @back: Backend device > + * > + * RETURNS: > + * Pointer to the driver private data associated with the backend. > =C2=A0 */ > =C2=A0void *iio_backend_get_priv(const struct iio_backend *back) > =C2=A0{