Re: [PATCH v2 3/4] scripts/kernel-doc: ensure that comments are using our coding style

From: Jonathan Corbet

Date: Mon Jan 12 2026 - 10:43:35 EST


Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> writes:

> Along kernel-doc libs, we opted to have all comments starting/ending
> with a blank comment line. Use the same style here.
>
> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx>
> ---
> scripts/kernel-doc.py | 16 ++++++++++++++++
> 1 file changed, 16 insertions(+)
>
> diff --git a/scripts/kernel-doc.py b/scripts/kernel-doc.py
> index 5d2f29e90ebe..7ccee4626478 100755
> --- a/scripts/kernel-doc.py
> +++ b/scripts/kernel-doc.py
> @@ -197,7 +197,9 @@ def main():
> parser = argparse.ArgumentParser(formatter_class=argparse.RawTextHelpFormatter,
> description=DESC)
>
> + #
> # Normal arguments
> + #
>
> parser.add_argument("-v", "-verbose", "--verbose", action="store_true",
> help="Verbose output, more warnings and other information.")

[nit] I approve of this kind of change, but I would get rid of the extra
blank lines, just like we do with C code.

(I wouldn't redo the series just for this).

Thanks,

jon