Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

clk: sunxi: Demote non-conformant kernel-doc headers

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'
drivers/clk/sunxi/clk-usb.c:22: warning: cannot understand function prototype: 'struct usb_reset_data '
drivers/clk/sunxi/clk-sun6i-ar100.c:26: warning: Function parameter or member 'req' not described in 'sun6i_get_ar100_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: Boris BREZILLON <boris.brezillon@free-electrons.com>
Cc: linux-clk@vger.kernel.org
Cc: linux-arm-kernel@lists.infradead.org
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Acked-by: Stephen Boyd <sboyd@kernel.org>
Signed-off-by: Maxime Ripard <maxime@cerno.tech>
Link: https://lore.kernel.org/r/20210303142430.3168703-1-lee.jones@linaro.org

authored by

Lee Jones and committed by
Maxime Ripard
dcc35457 46060be6

+6 -6
+1 -1
drivers/clk/sunxi/clk-sun6i-ar100.c
··· 16 16 17 17 #include "clk-factors.h" 18 18 19 - /** 19 + /* 20 20 * sun6i_get_ar100_factors - Calculates factors p, m for AR100 21 21 * 22 22 * AR100 rate is calculated as follows
+4 -4
drivers/clk/sunxi/clk-sun9i-core.c
··· 14 14 #include "clk-factors.h" 15 15 16 16 17 - /** 17 + /* 18 18 * sun9i_a80_get_pll4_factors() - calculates n, p, m factors for PLL4 19 19 * PLL4 rate is calculated as follows 20 20 * rate = (parent_rate * n >> p) / (m + 1); ··· 90 90 CLK_OF_DECLARE(sun9i_a80_pll4, "allwinner,sun9i-a80-pll4-clk", sun9i_a80_pll4_setup); 91 91 92 92 93 - /** 93 + /* 94 94 * sun9i_a80_get_gt_factors() - calculates m factor for GT 95 95 * GT rate is calculated as follows 96 96 * rate = parent_rate / (m + 1); ··· 145 145 CLK_OF_DECLARE(sun9i_a80_gt, "allwinner,sun9i-a80-gt-clk", sun9i_a80_gt_setup); 146 146 147 147 148 - /** 148 + /* 149 149 * sun9i_a80_get_ahb_factors() - calculates p factor for AHB0/1/2 150 150 * AHB rate is calculated as follows 151 151 * rate = parent_rate >> p; ··· 225 225 CLK_OF_DECLARE(sun9i_a80_apb0, "allwinner,sun9i-a80-apb0-clk", sun9i_a80_apb0_setup); 226 226 227 227 228 - /** 228 + /* 229 229 * sun9i_a80_get_apb1_factors() - calculates m, p factors for APB1 230 230 * APB1 rate is calculated as follows 231 231 * rate = (parent_rate >> p) / (m + 1);
+1 -1
drivers/clk/sunxi/clk-usb.c
··· 15 15 #include <linux/spinlock.h> 16 16 17 17 18 - /** 18 + /* 19 19 * sunxi_usb_reset... - reset bits in usb clk registers handling 20 20 */ 21 21