linux-kernel - Re: [PATCH] [v2] Documentation: Provide guidelines for tool-generated content

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <CANiq72nEHPhdedCu50A49orzE0sZo6DrfZe+JV+jvf3ToAsYhg@mail.gmail.com>
Date: Sat, 8 Nov 2025 02:52:48 +0100
From: Miguel Ojeda <miguel.ojeda.sandonis@...il.com>
To: Dave Hansen <dave.hansen@...ux.intel.com>
Cc: linux-kernel@...r.kernel.org, Steven Rostedt <rostedt@...dmis.org>, 
	Dan Williams <dan.j.williams@...el.com>, "Theodore Ts'o" <tytso@....edu>, 
	Sasha Levin <sashal@...nel.org>, Jonathan Corbet <corbet@....net>, Kees Cook <kees@...nel.org>, 
	Greg Kroah-Hartman <gregkh@...uxfoundation.org>, Miguel Ojeda <ojeda@...nel.org>, 
	Shuah Khan <shuah@...nel.org>
Subject: Re: [PATCH] [v2] Documentation: Provide guidelines for tool-generated content

Hi Dave,

Some nits below in case you send a new version.

On Thu, Nov 6, 2025 at 12:15 AM Dave Hansen <dave.hansen@...ux.intel.com> wrote:
>
> + - A .c file in the patch was originally generated by a LLM but cleaned

May look better with: ``.c``

> +Documentation/process/submitting-patches.rst . Its rules are simple

Is the space needed? I guess it was meant for the auto-link to still
work, but I see other files out there with a dot after `.rst` and the
links seem to be fine at docs.kernel.org.

> + - The input to the tools you used, like the coccinelle source script.

It seems there are still some bullets with periods and others without,
but no big deal.

Also perhaps Coccinelle, i.e. capitalized, like in the one above.

In any case, this looks fine:

Reviewed-by: Miguel Ojeda <ojeda@...nel.org>

Thanks!

Cheers,
Miguel