From: Lee Jones <lee.jones@linaro.org> To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, "Emilio López" <emilio@elopez.com.ar>, "Michael Turquette" <mturquette@baylibre.com>, "Stephen Boyd" <sboyd@kernel.org>, "Maxime Ripard" <mripard@kernel.org>, "Chen-Yu Tsai" <wens@csie.org>, "Jernej Skrabec" <jernej.skrabec@siol.net>, linux-clk@vger.kernel.org, linux-arm-kernel@lists.infradead.org Subject: [PATCH 05/21] clk: sunxi: clk-sun9i-core: Demote non-conformant kernel-doc headers Date: Tue, 26 Jan 2021 12:45:24 +0000 [thread overview] Message-ID: <20210126124540.3320214-6-lee.jones@linaro.org> (raw) In-Reply-To: <20210126124540.3320214-1-lee.jones@linaro.org> Headers must describe their parameters. Fixes the following W=1 kernel build warning(s): drivers/clk/sunxi/clk-sun9i-core.c:27: warning: Function parameter or member 'req' not described in 'sun9i_a80_get_pll4_factors' drivers/clk/sunxi/clk-sun9i-core.c:100: warning: Function parameter or member 'req' not described in 'sun9i_a80_get_gt_factors' drivers/clk/sunxi/clk-sun9i-core.c:155: warning: Function parameter or member 'req' not described in 'sun9i_a80_get_ahb_factors' drivers/clk/sunxi/clk-sun9i-core.c:235: warning: Function parameter or member 'req' not described in 'sun9i_a80_get_apb1_factors' Cc: "Emilio López" <emilio@elopez.com.ar> Cc: Michael Turquette <mturquette@baylibre.com> Cc: Stephen Boyd <sboyd@kernel.org> Cc: Maxime Ripard <mripard@kernel.org> Cc: Chen-Yu Tsai <wens@csie.org> Cc: Jernej Skrabec <jernej.skrabec@siol.net> Cc: linux-clk@vger.kernel.org Cc: linux-arm-kernel@lists.infradead.org Signed-off-by: Lee Jones <lee.jones@linaro.org> --- drivers/clk/sunxi/clk-sun9i-core.c | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/drivers/clk/sunxi/clk-sun9i-core.c b/drivers/clk/sunxi/clk-sun9i-core.c index 305ad78d5fb4f..d93c7a53c6c02 100644 --- a/drivers/clk/sunxi/clk-sun9i-core.c +++ b/drivers/clk/sunxi/clk-sun9i-core.c @@ -14,7 +14,7 @@ #include "clk-factors.h" -/** +/* * sun9i_a80_get_pll4_factors() - calculates n, p, m factors for PLL4 * PLL4 rate is calculated as follows * rate = (parent_rate * n >> p) / (m + 1); @@ -90,7 +90,7 @@ static void __init sun9i_a80_pll4_setup(struct device_node *node) CLK_OF_DECLARE(sun9i_a80_pll4, "allwinner,sun9i-a80-pll4-clk", sun9i_a80_pll4_setup); -/** +/* * sun9i_a80_get_gt_factors() - calculates m factor for GT * GT rate is calculated as follows * rate = parent_rate / (m + 1); @@ -145,7 +145,7 @@ static void __init sun9i_a80_gt_setup(struct device_node *node) CLK_OF_DECLARE(sun9i_a80_gt, "allwinner,sun9i-a80-gt-clk", sun9i_a80_gt_setup); -/** +/* * sun9i_a80_get_ahb_factors() - calculates p factor for AHB0/1/2 * AHB rate is calculated as follows * rate = parent_rate >> p; @@ -225,7 +225,7 @@ static void __init sun9i_a80_apb0_setup(struct device_node *node) CLK_OF_DECLARE(sun9i_a80_apb0, "allwinner,sun9i-a80-apb0-clk", sun9i_a80_apb0_setup); -/** +/* * sun9i_a80_get_apb1_factors() - calculates m, p factors for APB1 * APB1 rate is calculated as follows * rate = (parent_rate >> p) / (m + 1); -- 2.25.1
WARNING: multiple messages have this Message-ID (diff)
From: Lee Jones <lee.jones@linaro.org> To: lee.jones@linaro.org Cc: "Jernej Skrabec" <jernej.skrabec@siol.net>, "Emilio López" <emilio@elopez.com.ar>, "Michael Turquette" <mturquette@baylibre.com>, linux-kernel@vger.kernel.org, "Maxime Ripard" <mripard@kernel.org>, "Stephen Boyd" <sboyd@kernel.org>, "Chen-Yu Tsai" <wens@csie.org>, linux-clk@vger.kernel.org, linux-arm-kernel@lists.infradead.org Subject: [PATCH 05/21] clk: sunxi: clk-sun9i-core: Demote non-conformant kernel-doc headers Date: Tue, 26 Jan 2021 12:45:24 +0000 [thread overview] Message-ID: <20210126124540.3320214-6-lee.jones@linaro.org> (raw) In-Reply-To: <20210126124540.3320214-1-lee.jones@linaro.org> Headers must describe their parameters. Fixes the following W=1 kernel build warning(s): drivers/clk/sunxi/clk-sun9i-core.c:27: warning: Function parameter or member 'req' not described in 'sun9i_a80_get_pll4_factors' drivers/clk/sunxi/clk-sun9i-core.c:100: warning: Function parameter or member 'req' not described in 'sun9i_a80_get_gt_factors' drivers/clk/sunxi/clk-sun9i-core.c:155: warning: Function parameter or member 'req' not described in 'sun9i_a80_get_ahb_factors' drivers/clk/sunxi/clk-sun9i-core.c:235: warning: Function parameter or member 'req' not described in 'sun9i_a80_get_apb1_factors' Cc: "Emilio López" <emilio@elopez.com.ar> Cc: Michael Turquette <mturquette@baylibre.com> Cc: Stephen Boyd <sboyd@kernel.org> Cc: Maxime Ripard <mripard@kernel.org> Cc: Chen-Yu Tsai <wens@csie.org> Cc: Jernej Skrabec <jernej.skrabec@siol.net> Cc: linux-clk@vger.kernel.org Cc: linux-arm-kernel@lists.infradead.org Signed-off-by: Lee Jones <lee.jones@linaro.org> --- drivers/clk/sunxi/clk-sun9i-core.c | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/drivers/clk/sunxi/clk-sun9i-core.c b/drivers/clk/sunxi/clk-sun9i-core.c index 305ad78d5fb4f..d93c7a53c6c02 100644 --- a/drivers/clk/sunxi/clk-sun9i-core.c +++ b/drivers/clk/sunxi/clk-sun9i-core.c @@ -14,7 +14,7 @@ #include "clk-factors.h" -/** +/* * sun9i_a80_get_pll4_factors() - calculates n, p, m factors for PLL4 * PLL4 rate is calculated as follows * rate = (parent_rate * n >> p) / (m + 1); @@ -90,7 +90,7 @@ static void __init sun9i_a80_pll4_setup(struct device_node *node) CLK_OF_DECLARE(sun9i_a80_pll4, "allwinner,sun9i-a80-pll4-clk", sun9i_a80_pll4_setup); -/** +/* * sun9i_a80_get_gt_factors() - calculates m factor for GT * GT rate is calculated as follows * rate = parent_rate / (m + 1); @@ -145,7 +145,7 @@ static void __init sun9i_a80_gt_setup(struct device_node *node) CLK_OF_DECLARE(sun9i_a80_gt, "allwinner,sun9i-a80-gt-clk", sun9i_a80_gt_setup); -/** +/* * sun9i_a80_get_ahb_factors() - calculates p factor for AHB0/1/2 * AHB rate is calculated as follows * rate = parent_rate >> p; @@ -225,7 +225,7 @@ static void __init sun9i_a80_apb0_setup(struct device_node *node) CLK_OF_DECLARE(sun9i_a80_apb0, "allwinner,sun9i-a80-apb0-clk", sun9i_a80_apb0_setup); -/** +/* * sun9i_a80_get_apb1_factors() - calculates m, p factors for APB1 * APB1 rate is calculated as follows * rate = (parent_rate >> p) / (m + 1); -- 2.25.1 _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
next prev parent reply other threads:[~2021-01-26 13:13 UTC|newest] Thread overview: 147+ messages / expand[flat|nested] mbox.gz Atom feed top 2021-01-26 12:45 [PATCH 00/21] [Set 2] Rid W=1 warnings from Clock Lee Jones 2021-01-26 12:45 ` Lee Jones 2021-01-26 12:45 ` Lee Jones 2021-01-26 12:45 ` [PATCH 01/21] clk: zynq: pll: Fix kernel-doc formatting in 'clk_register_zynq_pll's header Lee Jones 2021-01-26 12:45 ` Lee Jones 2021-01-26 12:58 ` Michal Simek 2021-01-26 12:58 ` Michal Simek 2021-02-11 19:54 ` Stephen Boyd 2021-02-11 19:54 ` Stephen Boyd 2021-01-26 12:45 ` [PATCH 02/21] clk: ti: clkt_dpll: Fix some kernel-doc misdemeanours Lee Jones 2021-02-11 19:54 ` Stephen Boyd 2021-01-26 12:45 ` [PATCH 03/21] clk: ti: dpll3xxx: Fix some kernel-doc headers and promote other worthy ones Lee Jones 2021-02-11 19:54 ` Stephen Boyd 2021-01-26 12:45 ` [PATCH 04/21] clk: qcom: clk-regmap: Provide missing description for 'devm_clk_register_regmap()'s dev param Lee Jones 2021-01-26 13:59 ` Bjorn Andersson 2021-02-11 19:54 ` Stephen Boyd 2021-01-26 12:45 ` Lee Jones [this message] 2021-01-26 12:45 ` [PATCH 05/21] clk: sunxi: clk-sun9i-core: Demote non-conformant kernel-doc headers Lee Jones 2021-01-26 12:45 ` [PATCH 06/21] clk: sunxi: clk-usb: Demote obvious kernel-doc abuse Lee Jones 2021-01-26 12:45 ` Lee Jones 2021-01-26 12:45 ` [PATCH 07/21] clk: tegra: clk-tegra30: Remove unused variable 'reg' Lee Jones 2021-02-11 19:55 ` Stephen Boyd 2021-01-26 12:45 ` [PATCH 08/21] clk: clkdev: Ignore suggestion to use gnu_printf() as it's not appropriate here Lee Jones 2021-01-26 12:45 ` Lee Jones 2021-02-11 19:23 ` Stephen Boyd 2021-02-11 19:23 ` Stephen Boyd 2021-02-12 9:36 ` Lee Jones 2021-02-12 9:36 ` Lee Jones 2021-03-10 8:59 ` Lee Jones 2021-03-10 8:59 ` Lee Jones 2021-01-26 12:45 ` [PATCH 09/21] clk: tegra: cvb: Provide missing description for 'tegra_cvb_add_opp_table()'s align param Lee Jones 2021-02-11 19:56 ` Stephen Boyd 2021-01-26 12:45 ` [PATCH 10/21] clk: ti: dpll44xx: Fix some potential doc-rot Lee Jones 2021-02-11 19:56 ` Stephen Boyd 2021-01-26 12:45 ` [PATCH 11/21] clk: renesas: renesas-cpg-mssr: Fix formatting issues for 'smstpcr_saved's documentation Lee Jones 2021-01-26 15:49 ` Geert Uytterhoeven 2021-01-26 12:45 ` [PATCH 12/21] clk: sunxi: clk-sun6i-ar100: Demote non-conformant kernel-doc header Lee Jones 2021-01-26 12:45 ` Lee Jones 2021-01-26 15:54 ` Maxime Ripard 2021-01-26 15:54 ` Maxime Ripard 2021-01-26 16:54 ` Lee Jones 2021-01-26 16:54 ` Lee Jones 2021-02-03 9:27 ` Maxime Ripard 2021-02-03 9:27 ` Maxime Ripard 2021-02-03 10:09 ` Lee Jones 2021-02-03 10:09 ` Lee Jones 2021-01-26 12:45 ` [PATCH 13/21] clk: qcom: gcc-ipq4019: Remove unused variable 'ret' Lee Jones 2021-01-26 14:01 ` Bjorn Andersson 2021-02-11 19:56 ` Stephen Boyd 2021-01-26 12:45 ` [PATCH 14/21] clk: clk-fixed-mmio: Demote obvious kernel-doc abuse Lee Jones 2021-02-11 19:56 ` Stephen Boyd 2021-01-26 12:45 ` [PATCH 15/21] clk: clk-npcm7xx: Remove unused static const tables 'npcm7xx_gates' and 'npcm7xx_divs_fx' Lee Jones 2021-01-26 12:45 ` Lee Jones 2021-02-03 8:08 ` Tali Perry 2021-02-03 9:52 ` Tali Perry 2021-02-03 9:52 ` Tali Perry 2021-02-11 19:56 ` Stephen Boyd 2021-02-11 19:56 ` Stephen Boyd 2021-01-26 12:45 ` [PATCH 16/21] clk: qcom: mmcc-msm8974: Remove unused static const tables 'mmcc_xo_mmpll0_1_2_gpll0{map}' Lee Jones 2021-01-26 14:02 ` Bjorn Andersson 2021-02-11 19:57 ` Stephen Boyd 2021-01-26 12:45 ` [PATCH 17/21] clk: clk-xgene: Add description for 'mask' and fix formatting for 'flags' Lee Jones 2021-02-11 19:57 ` Stephen Boyd 2021-01-26 12:45 ` [PATCH 18/21] clk: qcom: clk-rpm: Remove a bunch of superfluous code Lee Jones 2021-01-26 14:04 ` Bjorn Andersson 2021-02-11 19:57 ` Stephen Boyd 2021-01-26 12:45 ` [PATCH 19/21] clk: spear: Move prototype to accessible header Lee Jones 2021-01-26 12:45 ` Lee Jones 2021-01-27 4:36 ` Viresh Kumar 2021-01-27 4:36 ` Viresh Kumar 2021-02-11 19:58 ` Stephen Boyd 2021-02-11 19:58 ` Stephen Boyd 2021-01-26 12:45 ` [PATCH 20/21] clk: imx: Move 'imx6sl_set_wait_clk()'s prototype out " Lee Jones 2021-01-26 12:45 ` Lee Jones 2021-01-30 14:13 ` Shawn Guo 2021-01-30 14:13 ` Shawn Guo 2021-01-26 12:45 ` [PATCH 21/21] clk: zynqmp: divider: Add missing description for 'max_div' Lee Jones 2021-01-26 12:45 ` Lee Jones 2021-01-26 12:51 ` Michal Simek 2021-01-26 12:51 ` Michal Simek 2021-02-11 19:58 ` Stephen Boyd 2021-02-11 19:58 ` Stephen Boyd 2021-02-03 8:31 ` [PATCH 00/21] [Set 2] Rid W=1 warnings from Clock Lee Jones 2021-02-03 8:31 ` Lee Jones 2021-02-05 18:55 ` Stephen Boyd 2021-02-05 18:55 ` Stephen Boyd 2021-02-05 19:19 ` Lee Jones 2021-02-05 19:19 ` Lee Jones 2021-02-05 19:19 ` Lee Jones 2021-02-08 6:45 ` Tero Kristo 2021-02-08 6:45 ` Tero Kristo 2021-02-08 6:45 ` Tero Kristo 2021-02-11 20:47 ` Stephen Boyd 2021-02-11 20:47 ` Stephen Boyd 2021-02-11 20:47 ` Stephen Boyd 2021-02-11 21:10 ` Lee Jones 2021-02-11 21:10 ` Lee Jones 2021-02-11 21:10 ` Lee Jones 2021-02-12 3:07 ` Stephen Boyd 2021-02-12 3:07 ` Stephen Boyd 2021-02-12 3:07 ` Stephen Boyd 2021-02-12 9:20 ` Lee Jones 2021-02-12 9:20 ` Lee Jones 2021-02-12 9:20 ` Lee Jones 2021-02-12 21:02 ` Stephen Boyd 2021-02-12 21:02 ` Stephen Boyd 2021-02-12 21:02 ` Stephen Boyd 2021-02-12 21:25 ` Lee Jones 2021-02-12 21:25 ` Lee Jones 2021-02-12 21:25 ` Lee Jones 2021-02-12 21:26 ` Lee Jones 2021-02-12 21:26 ` Lee Jones 2021-02-12 21:26 ` Lee Jones 2021-02-12 22:05 ` Stephen Boyd 2021-02-12 22:05 ` Stephen Boyd 2021-02-12 22:05 ` Stephen Boyd 2021-02-12 22:37 ` Lee Jones 2021-02-12 22:37 ` Lee Jones 2021-02-12 22:37 ` Lee Jones 2021-02-13 0:06 ` Stephen Boyd 2021-02-13 0:06 ` Stephen Boyd 2021-02-13 0:06 ` Stephen Boyd 2021-02-13 16:04 ` Andrew Lunn 2021-02-13 16:04 ` Andrew Lunn 2021-02-13 16:04 ` Andrew Lunn 2021-02-14 21:00 ` Stephen Boyd 2021-02-14 21:20 ` Andrew Lunn 2021-02-14 21:20 ` Andrew Lunn 2021-02-14 21:20 ` Andrew Lunn 2021-02-15 8:49 ` Lee Jones 2021-02-15 8:49 ` Lee Jones 2021-02-15 8:49 ` Lee Jones 2021-02-15 17:45 ` Jakub Kicinski 2021-02-15 17:45 ` Jakub Kicinski 2021-02-15 17:45 ` Jakub Kicinski 2021-02-16 8:20 ` Lee Jones 2021-02-16 8:20 ` Lee Jones 2021-02-16 8:20 ` Lee Jones 2021-02-17 18:08 ` Jakub Kicinski 2021-02-17 18:08 ` Jakub Kicinski 2021-02-17 18:08 ` Jakub Kicinski 2021-02-18 9:31 ` Lee Jones 2021-02-18 9:31 ` Lee Jones 2021-02-18 9:31 ` Lee Jones 2021-02-13 15:58 ` Andrew Lunn 2021-02-13 15:58 ` Andrew Lunn 2021-02-13 15:58 ` Andrew Lunn
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to=20210126124540.3320214-6-lee.jones@linaro.org \ --to=lee.jones@linaro.org \ --cc=emilio@elopez.com.ar \ --cc=jernej.skrabec@siol.net \ --cc=linux-arm-kernel@lists.infradead.org \ --cc=linux-clk@vger.kernel.org \ --cc=linux-kernel@vger.kernel.org \ --cc=mripard@kernel.org \ --cc=mturquette@baylibre.com \ --cc=sboyd@kernel.org \ --cc=wens@csie.org \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.