Received: by 2002:a05:6a10:8c0a:0:0:0:0 with SMTP id go10csp5240883pxb; Mon, 15 Feb 2021 13:45:38 -0800 (PST) X-Google-Smtp-Source: ABdhPJw7lfgUulqJkKe0Dhz1v/xtqT/o9VGjEh96XokwwYcR1NU2iVpXGrqGb16BXpg2mXbW5imV X-Received: by 2002:a17:906:4897:: with SMTP id v23mr16295713ejq.21.1613425538197; Mon, 15 Feb 2021 13:45:38 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1613425538; cv=none; d=google.com; s=arc-20160816; b=htRXH3uq16shZWFii1yRGJZQwgbyuIaINIY1T+/RJ28HrdrOW/WVLfa+VCqR1+Fk3O y6cpK3vbN9L+bzd8XAKJwSWQhwNn2SnY1nO49pv/cLM2yaOpSDWZKvEahUbkz/PDJv3h eKF5jRzAdoOpMReLsJJ+KSTnZRMtf8uZk9iGDfz/LHBNPX2MJWFGzCZw80JQq4xlcW/H fdEbyGC1nTOss7ubD2DUHwTD/OVGY6Svg4lgPsd/ENWjE7RFVp8d4s/dXO4gIZBArKFI jEEj0/+GIlqxhNMN7l9xaMfBgsQFn/gfDwWa7U1mBIlnUXy/GOBnsaymeSafdaHG6jiL j+9w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:in-reply-to:content-disposition:mime-version :references:message-id:subject:cc:to:from:date; bh=1hd4+cHjB/VGp/H5x8gxIpoGgJ92CAnP2iy8ZSV1Dqs=; b=DheY48qsku8BZQ5vsRQftvGfzQ+xmu4zfbPhHEvZyzAWG4YIF8jZ3/dnXYovXRbbC9 2idKdmkTyzZHpsw6EPvzHOJzn/IuvbXPpONfuXYGQqhTWgg3k/mI9lIGbpuZpSRIcbeL RlX+yoo8iVkcK8gWlwHUIOjNZWXTgYunAgFOvoqiyAPlJ6Drh9EiQyVz+RhgguKv1oh4 iJhxNrLvMi7EZFpZrHJzdPgS9JrfIfvc/rAEBu9+kcZo1r8ez5ssVOQ98YCG89EsLb2h jU8xuL8rHPMNVz+j9azk1OUNSU3uWSs7bGhNSMmDxRCGhgTSnxaCs9lAhtBxBEM54anE LPYw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id dk15si12659090edb.468.2021.02.15.13.45.15; Mon, 15 Feb 2021 13:45:38 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229888AbhBOVmO (ORCPT + 99 others); Mon, 15 Feb 2021 16:42:14 -0500 Received: from mail-wr1-f50.google.com ([209.85.221.50]:44945 "EHLO mail-wr1-f50.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229520AbhBOVmK (ORCPT ); Mon, 15 Feb 2021 16:42:10 -0500 Received: by mail-wr1-f50.google.com with SMTP id g6so10750487wrs.11; Mon, 15 Feb 2021 13:41:54 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=1hd4+cHjB/VGp/H5x8gxIpoGgJ92CAnP2iy8ZSV1Dqs=; b=GIhMFWImDJauxCnvYUSC/QJYlW3DkHrkcUXMXrc659fmHYLqjOz7CYT8sivMDyFz60 5VA7Yt1Q0NSFEwc6V63zsOTjIRmyvRqgK4eZs8qVyyYmpvQoQgHFNGfEOIfOf79hH9ba i3e1YIwPkWPyM2tUL0eqpu4Y4hSwj/KoBTWW23v3aCGuuMGFBvi3G+Y3+3xoDDYqK4Rz rDS8BuqxQ6sRhPNFNq5BFUhmKAl8o1NSxh+zBYs+UFCDzriR7rnvnftM9Rb5q4sf3izj tCl633UbvcrAIVTI2ILhPHx9qRGhoRAAiUPjlHdwZ9wofsv5d4B6ElfIgmoTIiYu8DjA u/4A== X-Gm-Message-State: AOAM531LzFmLN8/du9LOPC27o157qtDNiOfUcWsddlNwOOUUmze1g5V+ 3pJ8FtB5JdZcU0eEEYmyTAs= X-Received: by 2002:a5d:5603:: with SMTP id l3mr4697994wrv.381.1613425288469; Mon, 15 Feb 2021 13:41:28 -0800 (PST) Received: from rocinante ([95.155.85.46]) by smtp.gmail.com with ESMTPSA id k11sm24839616wrv.51.2021.02.15.13.41.27 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 15 Feb 2021 13:41:28 -0800 (PST) Date: Mon, 15 Feb 2021 22:41:26 +0100 From: Krzysztof =?utf-8?Q?Wilczy=C5=84ski?= To: Dejin Zheng Cc: corbet@lwn.net, jarkko.nikula@linux.intel.com, andriy.shevchenko@linux.intel.com, mika.westerberg@linux.intel.com, rric@kernel.org, helgaas@kernel.org, wsa@kernel.org, linux-doc@vger.kernel.org, linux-i2c@vger.kernel.org, linux-pci@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH v1 2/4] Documentation: devres: add pcim_alloc_irq_vectors() Message-ID: References: <20210215181550.714101-1-zhengdejin5@gmail.com> <20210215181550.714101-3-zhengdejin5@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: <20210215181550.714101-3-zhengdejin5@gmail.com> Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hello Dejin, [...] > add pcim_alloc_irq_vectors(), a explicit device-managed version of > pci_alloc_irq_vectors(). It would be "Add" at the start of the sentence. You could also drop the "explicit" word or replace it with "an explicit", if you want to keep it. Generally, this commit message could be improved - you could explain that you are updating the documentation to reflect the addition of this new function called pcim_alloc_irq_vectors(), and also briefly explain why it was added, etc. [...] > devm_pci_remap_cfg_resource() : ioremap PCI configuration space resource > + pcim_alloc_irq_vectors() : managed irq vectors allocation [...] It would be "IRQ" here. Krzysztof