Re: [PATCH v1 1/1] kernel-doc: Issue warnings that were silently discarded

[Randy Dunlap]

On 11/5/25 1:19 PM, Mauro Carvalho Chehab wrote:
> 
> No objection of this one, but this breaks the behavior of the -W
> flags.
> 
> See, the way kernel-doc.pl worked is that:
> 
> 1. Warnings are controlled via several -W flags:
> 
>   -Wreturn, --wreturn   Warns about the lack of a return markup on functions.
>   -Wshort-desc, -Wshort-description, --wshort-desc
>                         Warns if initial short description is missing
> 
>                         This option is kept just for backward-compatibility, but it does nothing,
>                         neither here nor at the original Perl script.

FWIW, it did output warnings once upon a time (the Perl script version).
I don't know what happened to it.

>   -Wall, --wall         Enable all types of warnings
>   -Werror, --werror     Treat warnings as errors.
> 
>   Those affect running kernel-doc manually.
-- 
~Randy