Re: [PATCH] clk: add missing function short descriptions for kernel-doc
From: Brian Masney
Date: Tue May 12 2026 - 19:06:47 EST
On Tue, May 12, 2026 at 02:24:53PM -0700, Randy Dunlap wrote:
> Add short descriptions for 3 functions which are missing it.
> Modify the parameter name in comments to be @core instead of clk.
> Use corrected function names (with leading "__") in a few places.
>
> Warning: drivers/clk/clk.c:1899 missing initial short description on line:
> * __clk_recalc_accuracies
> Warning: drivers/clk/clk.c:1972 missing initial short description on line:
> * __clk_recalc_rates
> Warning: drivers/clk/clk.c:2244 missing initial short description on line:
> * __clk_speculate_rates
>
> This eliminates warnings in this file except for missing return value
> warnings, of which there are around 70.
>
> Signed-off-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
Reviewed-by: Brian Masney <bmasney@xxxxxxxxxx>