Received-SPF: pass (google.com: domain of linux-kernel+bounces-9121-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223;
Date: Thu, 21 Dec 2023 14:14:29 -0800
From: Ira Weiny <ira.weiny@intel.com>
To: Randy Dunlap <rdunlap@infradead.org>, <linux-kernel@vger.kernel.org>
CC: Randy Dunlap <rdunlap@infradead.org>, Vishal Verma
	<vishal.l.verma@intel.com>, Dan Williams <dan.j.williams@intel.com>, "Dave
 Jiang" <dave.jiang@intel.com>, Ira Weiny <ira.weiny@intel.com>,
	<nvdimm@lists.linux.dev>
Subject: Re: [PATCH 1/3] nvdimm/btt: fix btt_blk_cleanup() kernel-doc
Message-ID: <6584b8c5999cb_55802294ef@iweiny-mobl.notmuch>
References: <20231207210545.24056-1-rdunlap@infradead.org>
Content-Type: text/plain; charset="us-ascii"
Content-Disposition: inline
In-Reply-To: <20231207210545.24056-1-rdunlap@infradead.org>
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?TnwOuH0YRpto8d1CVSKdjNjN3tcfh9NAByovXGwIkM8kL8R8Ptlliz/5rDSE?=
 =?us-ascii?Q?MeMlvgFPPR/XCGBKqL6csLuvFkvxLtCsuB0PawREe8glyBeX8lCnzjhxJf8l?=
 =?us-ascii?Q?e9qvM9Ts6RzpKcMdAl5kVODsY0kN2xhBpFc+VCXwMGkjcXDDCfDLLfOTVjmM?=
 =?us-ascii?Q?Z53e2GDVRsGEHkUai1KjC65etuQsF8GWs56JHfTWQY3fKjBt6MOZdj0aq0kh?=
 =?us-ascii?Q?3UdKo9wycFruhRBzdgfHBSXyBmKVa1JnHnUK2ej/kV06qUY5e0Ea+bTVfD9G?=
 =?us-ascii?Q?ADbklSqUY8jDOwaa808HGC3CJx/aYNV3yvk0RhTo8RMO9XSlHN0VCFICBg8R?=
 =?us-ascii?Q?GMElHjGl+IYWOAYweVIiM5IaNrVfmY865GR5V3KVhWRn6/qsVxDyBkxa+Uha?=
 =?us-ascii?Q?pVXp/xTb8wSeY7RH30YN8gybq0TRI/lt/cauCdtScnSqZt02HPVXY1WTfFTV?=
 =?us-ascii?Q?f04SpFpdrIzPB8IIFw3iueqoQajkjNb4bL+evVTid0vSCmjkx4io53i0IKMw?=
 =?us-ascii?Q?J58pt/5+TFHnvK8ZMIE+4uobz/RlPwR54/oSeIoz5ZqWAfvXkG3rdFjqbHb3?=
 =?us-ascii?Q?B6DNFr3hqA7f1qwERArjbQwtaOId5hJ37VAF+715c1vDc65r5qWkJBVgHSLb?=
 =?us-ascii?Q?PYmcuK51Sm1jgGxDl/8xwBe0GqkIjE7zqTIFe2ns/GKhOjkm+1qh2e4PgK3f?=
 =?us-ascii?Q?iP1ISkbg84e/6jOrIN8fW81qbbKPZ9rdc8vgv+YmJBEz0xEB92KKDd3Z6vXW?=
 =?us-ascii?Q?3B5/M+MSJVu8s5f2thNJaFAqAUFo2Dd6u75v4uzCK17GGLs8QW+++Pz1pi7E?=
 =?us-ascii?Q?KqZ5pbJEaPT0+NCxxoq8EzOWoJ9ZDJRWN9bb5qsUzJjqShNOtJclTZNnpf19?=
 =?us-ascii?Q?A5CbYNG0gfhd2pfD87k9YImHmJG4xC32/VrNlm7ktk+qPUbGHTMdfme5giH0?=
 =?us-ascii?Q?namn7reJfb/7bF0m0aEHYXvPSRN9K4NJuaUcMsJrNGf6IS3nPjpbDLJaLzBE?=
 =?us-ascii?Q?VFUMld5crnIe54IGC48d29YFhLf46QKN0wb1V8qPJl2if3ngxCC3oidLhRJV?=
 =?us-ascii?Q?2qh0mPfQstWJ554sE6wueel1TiUshjKkng8h40L7gJSnAD41qMn8q/7CvsqM?=
 =?us-ascii?Q?YV5rspYn8bhiTuXsHxotLCj0a8qbLuaDsySuvBEj67OpnWWfzyNjAZJRJpDX?=
 =?us-ascii?Q?EdVF7/FSEWyDWrWycjzy1fgUvAO8OJQL+OBGbJJMh3X1csqJwjKHlZ2Up/kF?=
 =?us-ascii?Q?xTbMPDcirBbnR1yTGxZzcIGxZJ2Uavz8dA6W4z3oE6tDObzyV/ssrOAG79x+?=
 =?us-ascii?Q?OTFkFDkCllCZGnVNKSnLyUtUxjHLjbyqSTpYTQ0wO2F4UaKoHHmqA60Gl067?=
 =?us-ascii?Q?85RXHUegw0iiUx7unOfiQK7Lz/UwWBtxBpm4zoKjgy+aMJKVQlxFDunv+pT2?=
 =?us-ascii?Q?lQUp/8k2TnHmwsNEEF8K6cPpDIGnm41ihZX/bfnM4JOb3ihhTl9ItUpUZJxZ?=
 =?us-ascii?Q?S19d++4loaIkcVE6BpGLSpJptZEUZImJSrjPZAk60Ttx5QYZWxNu44Zran2f?=
 =?us-ascii?Q?ZKp18LyxVwks1UN3vwnZLPWvQFvdrWb+5eAdr67a?=
X-MS-Exchange-CrossTenant-Network-Message-Id: cdc8b4e5-6b95-42b3-fde4-08dc027235b8
X-MS-Exchange-CrossTenant-AuthSource: SA1PR11MB6733.namprd11.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 21 Dec 2023 22:14:33.2246
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 46c98d88-e344-4ed4-8496-4ed7712e255d
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: OQLKGfQmYh/LLtOlyOSaov9t/uSDupLfXeui3tqJoE/Tt7AXozXHxg2xROsIfd0uW0V4ylzAVnCHtaB+CsSs1Q==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH3PR11MB8494
X-OriginatorOrg: intel.com

Randy Dunlap wrote:
> Correct the function parameters to prevent kernel-doc warnings:
> 
> btt.c:1567: warning: Function parameter or member 'nd_region' not described in 'btt_init'
> btt.c:1567: warning: Excess function parameter 'maxlane' description in 'btt_init'
> 
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
> Cc: Vishal Verma <vishal.l.verma@intel.com>
> Cc: Dan Williams <dan.j.williams@intel.com>
> Cc: Dave Jiang <dave.jiang@intel.com>
> Cc: Ira Weiny <ira.weiny@intel.com>

Reviewed-by: Ira Weiny <ira.weiny@intel.com>

> Cc: nvdimm@lists.linux.dev
> ---
>  drivers/nvdimm/btt.c |    2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff -- a/drivers/nvdimm/btt.c b/drivers/nvdimm/btt.c
> --- a/drivers/nvdimm/btt.c
> +++ b/drivers/nvdimm/btt.c
> @@ -1550,7 +1550,7 @@ static void btt_blk_cleanup(struct btt *
>   * @rawsize:	raw size in bytes of the backing device
>   * @lbasize:	lba size of the backing device
>   * @uuid:	A uuid for the backing device - this is stored on media
> - * @maxlane:	maximum number of parallel requests the device can handle
> + * @nd_region:	&struct nd_region for the REGION device
>   *
>   * Initialize a Block Translation Table on a backing device to provide
>   * single sector power fail atomicity.