From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtpout-03.galae.net (smtpout-03.galae.net [185.246.85.4]) (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 EFF9E2DAFAF; Fri, 10 Jul 2026 18:22:25 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=185.246.85.4 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1783707753; cv=none; b=lKqC9JC1Ml4CCGR8F3IjIvDT02D6RuuDANA+YAxPR4JjUO5r+SCcIeCIhRYFCcpV1DwcXVGG6KAjtARer3/EnGjWgfe2vhu5QALemVbLfBZngVygGPUZU4BZ1kNlBx8D1VY837nVEBK1k1kYwouB0qR4LNi9C8e3K3Rq5+ZQHAY= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1783707753; c=relaxed/simple; bh=MKXF36B/N58wgTDVUubwpPnEsfYr+reCs2pY25QG5rc=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=USrCFSt0zGrC/C5FBmQ1Z/e5LrrvtNTjyma4j9B/6aTkrrI5miZWQzy6xeTmmoad+D+vxuiup03zOnFE0FTALLQGPN8kmcQUzXNcLHCyLUHR57j4beTsV/u+331TC5VtrEQADyxH0bpexGrHPJuHuo85T5/TzW3HJ+jwsGRtKnk= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=bootlin.com; spf=pass smtp.mailfrom=bootlin.com; dkim=pass (2048-bit key) header.d=bootlin.com header.i=@bootlin.com header.b=pMWqIQ+c; arc=none smtp.client-ip=185.246.85.4 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=bootlin.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=bootlin.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=bootlin.com header.i=@bootlin.com header.b="pMWqIQ+c" Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-03.galae.net (Postfix) with ESMTPS id 8EF524E40D4A; Fri, 10 Jul 2026 18:22:24 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 62EB060342; Fri, 10 Jul 2026 18:22:24 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 106B911BD2C1D; Fri, 10 Jul 2026 20:22:20 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1783707743; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=nTJU2NJ54O6LZ0hZrhPZm1F5PCgRji3kSdkWz/GfYyE=; b=pMWqIQ+c50m52BAJ/GRQWIaZv2TC4ZRKnxCsWXAgm8gvUNEgzkiNvGzrjKXwl+4W/L2Nxf TMZ3yMLG24PXlbRK/ydtIprFB7VyhQyGkn5AcLzXHWj1yLLgig6hUqfNmkavz78GqIJqqJ e9wd49Jg0stNfo+YOJCbi/JQU2SuZA1Sh+tf/P1EaRPh3cFfYSCp3oKzZl45UQLDMJzkjM FkK3ddsCU7ETXcL1wOv7CC5HgStWrSChM3H/jYWTOy9jGBBkB2Acm22c+rB/2cPExVzTq1 A7/Z+4coJgYRnR2FwHYbFTm3gfx+5n7K35r9F60spODV6NkbW82rpSoUSWo8eg== From: "Miquel Raynal (Schneider Electric)" Date: Fri, 10 Jul 2026 20:21:59 +0200 Subject: [PATCH v2 4/7] clk: Improve a couple of comments Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20260710-schneider-v7-2-rc1-eip201-upstream-v2-4-b4680787377e@bootlin.com> References: <20260710-schneider-v7-2-rc1-eip201-upstream-v2-0-b4680787377e@bootlin.com> In-Reply-To: <20260710-schneider-v7-2-rc1-eip201-upstream-v2-0-b4680787377e@bootlin.com> To: Michael Turquette , Stephen Boyd , Brian Masney , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Brendan Higgins , David Gow , Rae Moar Cc: Thomas Petazzoni , Pascal EBERHARD , Wolfram Sang , linux-clk@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-kselftest@vger.kernel.org, kunit-dev@googlegroups.com, "Miquel Raynal (Schneider Electric)" X-Mailer: b4 0.14.3 X-Last-TLS-Session-Version: TLSv1.3 Avoid mentioning the function names directly in the comments, it makes them easily out of sync with the rest of the code. Use a more generic wording. Suggested-by: Stephen Boyd Signed-off-by: Miquel Raynal (Schneider Electric) Reviewed-by: Brian Masney --- drivers/clk/clk.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/drivers/clk/clk.c b/drivers/clk/clk.c index 08874cf9b561..7d63d81ebc09 100644 --- a/drivers/clk/clk.c +++ b/drivers/clk/clk.c @@ -5202,7 +5202,7 @@ static int of_parse_clkspec(const struct device_node *np, int index, /* * For named clocks, first look up the name in the * "clock-names" property. If it cannot be found, then index - * will be an error code and of_parse_phandle_with_args() will + * will be an error code and the OF phandle parser will * return -EINVAL. */ if (name) @@ -5275,7 +5275,7 @@ of_clk_get_hw_from_clkspec(struct of_phandle_args *clkspec) * * This function looks up a struct clk from the registered list of clock * providers, an input is a clock specifier data structure as returned - * from the of_parse_phandle_with_args() function call. + * from the OF phandle parser. */ struct clk *of_clk_get_from_provider(struct of_phandle_args *clkspec) { -- 2.54.0