Re: [PATCH] scripts: kernel-doc: Bug fixed for erroneous warning

From: Jonathan Corbet
Date: Wed Dec 20 2023 - 10:31:27 EST


Muhammad Muzammil <m.muzzammilashraf@xxxxxxxxx> writes:

> From: Muzammil Ashraf <m.muzzammilashraf@xxxxxxxxx>
>
> kernel-doc: fixed erroneous warning generated by '__counted_by'
>
> Signed-off-by: Muzammil Ashraf <m.muzzammilashraf@xxxxxxxxx>
> ---
> scripts/kernel-doc | 1 +
> 1 file changed, 1 insertion(+)
>
> diff --git a/scripts/kernel-doc b/scripts/kernel-doc
> index 1484127db104..ea9688df0e93 100755
> --- a/scripts/kernel-doc
> +++ b/scripts/kernel-doc
> @@ -1661,6 +1661,7 @@ sub check_sections($$$$$) {
> }
> elsif (($decl_type eq "struct") or
> ($decl_type eq "union")) {
> + next if (index("@_", "__counted_by") != -1);
> emit_warning("${file}:$.",
> "Excess $decl_type member " .
> "'$sects[$sx]' " .

Could you give an example of the warnings that this patch addresses?
I've not seen any caused by __counted_by since f600c77aeaff was applied
to docs-next. What did it miss?

Thanks,

jon