Received: by 2002:a05:7412:b995:b0:f9:9502:5bb8 with SMTP id it21csp480655rdb; Thu, 21 Dec 2023 15:35:47 -0800 (PST) X-Google-Smtp-Source: AGHT+IGZtcw8qLkjqglNTuQl8zkooLA7B7t3L7LPfv8eniXnLvEfPtbq2FUafrsW/2jRWTaaUPqb X-Received: by 2002:a17:902:7c05:b0:1d3:fa1d:28d0 with SMTP id x5-20020a1709027c0500b001d3fa1d28d0mr383604pll.68.1703201747462; Thu, 21 Dec 2023 15:35:47 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1703201747; cv=none; d=google.com; s=arc-20160816; b=FSnaZeBevSdu0aW7YG9h+o0bQuzpz5Sf2jmKBe2dD8SiAZvAVL5YByYOIEaXMHbuMb ubzBQtf+KuelZSRf50kINzrrMllKyHKDlxrj7A+j8pda0awZcsohFyhgEy5yOPebvTXL dKdJJ9CvOr3jt3JJr2qlhGgiVU4qtxJP97NPPzKCchvgi7c7fWFzSZc8si7bWQQnKpRt EuJY5OWR4eldppcFsdo3Vwcgq3NcZZSgZS8+IjPubq/MnewoLAJuwFSobkA9qL5oAkxi jZV6L5wkInjv0f5f1k1E8rUu6aiSMQ78h7jG3Go4jaeyLr4iNOkz0U96+dKAajonvOsN nzDw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:user-agent:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:date:message-id:dkim-signature; bh=PLpFzJBkRIVRbImC6LLkmU60cfDt3U7Bi6p9cnlmj6Q=; fh=OYLNdICi2gaTxTn7A7CULYh3NM5ccrsA7Z2Ow5kt+hQ=; b=VlyA/3/dARQ/EodvfNzUnb3r0SYX7iZrP3NZYlFanoy8FRP9SCV1/hOOBeDoEQXN3V PEz9Z/y8ZswkEuNDy2BJ2JAZD6p5HSqOGLDunlxRT+lsAcg7a6x887nHRpURfOmX4H9f CdiSOoHZ4ErMJRvZGXtBNITviBYg1eGVQoK+lTnhUnNq2nJa1PX7rP9qfJTzCNAY+sHZ hEdtqsVTNDmEgvI6x/QrntuLNYLDTtj0YJhGTAuhiKQw8SfJL7BmjjK/ZvA3VadE5s+v o3syBAbapD7VUwpEJWaUyAmErXF2SGuf63o0CBPq1XXBscz86wnI5nDrSVBC9P8yqAlg PWoA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=2RQevUcQ; spf=pass (google.com: domain of linux-kernel+bounces-9182-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-9182-linux.lists.archive=gmail.com@vger.kernel.org" Return-Path: Received: from sy.mirrors.kernel.org (sy.mirrors.kernel.org. [2604:1380:40f1:3f00::1]) by mx.google.com with ESMTPS id o10-20020a170902d4ca00b001d40906a0d3si1604050plg.297.2023.12.21.15.35.46 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 21 Dec 2023 15:35:47 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-9182-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) client-ip=2604:1380:40f1:3f00::1; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=2RQevUcQ; spf=pass (google.com: domain of linux-kernel+bounces-9182-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-9182-linux.lists.archive=gmail.com@vger.kernel.org" Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sy.mirrors.kernel.org (Postfix) with ESMTPS id E1701B2252F for ; Thu, 21 Dec 2023 23:35:03 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 575DF79490; Thu, 21 Dec 2023 23:34:55 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="2RQevUcQ" X-Original-To: linux-kernel@vger.kernel.org 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 1D21378E72; Thu, 21 Dec 2023 23:34:52 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: Content-Type:In-Reply-To:From:References:Cc:To:Subject:MIME-Version:Date: Message-ID:Sender:Reply-To:Content-ID:Content-Description; bh=PLpFzJBkRIVRbImC6LLkmU60cfDt3U7Bi6p9cnlmj6Q=; b=2RQevUcQbjUPI2JVCGpeo4x++E 9R+a4V/PtRyXUsT77FI45fG2H0u4FUrjQFyFWiiaIKgXEljawZdEc1V2X1ETptA6sChNACCd4nkUh 0Av/T8LiuIK6Fkyx540+WgkU5x7wSn6wo8zCxSelqrMvxd2njXs5QI6GghrSnqOZZcQM1oqT22mRq q9SXqvq0jtkZHbNBZqH2lbjQlatN8Xoj66XMuQhkM38GIoWXhY542sZmt1eUdqTAHo3bEIlKjasod fMrgDoJlJJYIh4kA+KCLWYBp7HbP9aFHp8+H6vVFohxOJ649PzcOPZ8uFtBw31acuW4Apu0Bls9S1 XiCYC5ZA==; Received: from [50.53.46.231] (helo=[192.168.254.15]) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rGSZ2-004RWi-2C; Thu, 21 Dec 2023 23:34:52 +0000 Message-ID: <65d0c378-2126-4746-bb68-99ca97b6e069@infradead.org> Date: Thu, 21 Dec 2023 15:34:52 -0800 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH 2/3] nvdimm/dimm_devs: fix kernel-doc for function params Content-Language: en-US To: Ira Weiny , linux-kernel@vger.kernel.org Cc: Dan Williams , Vishal Verma , Dave Jiang , nvdimm@lists.linux.dev References: <20231207210545.24056-1-rdunlap@infradead.org> <20231207210545.24056-2-rdunlap@infradead.org> <6584bc064ea54_5580229435@iweiny-mobl.notmuch> <6584bd663bd30_576052949c@iweiny-mobl.notmuch> From: Randy Dunlap In-Reply-To: <6584bd663bd30_576052949c@iweiny-mobl.notmuch> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit Hi Ira, On 12/21/23 14:34, Ira Weiny wrote: > Ira Weiny wrote: >> Randy Dunlap wrote: > > [snip] > >>> diff -- a/drivers/nvdimm/dimm_devs.c b/drivers/nvdimm/dimm_devs.c >>> --- a/drivers/nvdimm/dimm_devs.c >>> +++ b/drivers/nvdimm/dimm_devs.c >>> @@ -53,7 +53,10 @@ static int validate_dimm(struct nvdimm_d >>> >>> /** >>> * nvdimm_init_nsarea - determine the geometry of a dimm's namespace area >>> - * @nvdimm: dimm to initialize >>> + * @ndd: dimm to initialize >>> + * >>> + * Returns: %0 if the area is already valid, -errno on error, >> >> This is good... >> >>> ...otherwise an >>> + * ND_CMD_* status code. >> >> I don't see where any of the ->ndctl() calls return an ND_CMD_* status >> code. What am I missing? Probably nothing. Yes, please drop that/fix that when you merge it. Thanks. > If you agree that this should be dropped I can clean it up as I'm trying > to prep the nvdimm tree now and was hoping to take this series. > > Ira > >> >> The rest looks good, >> Ira -- #Randy https://people.kernel.org/tglx/notes-about-netiquette https://subspace.kernel.org/etiquette.html