[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-Id: <20250925134814.1f68d84a951572245893abbe@linux-foundation.org>
Date: Thu, 25 Sep 2025 13:48:14 -0700
From: Andrew Morton <akpm@...ux-foundation.org>
To: Alejandro Colomar <alx@...nel.org>
Cc: linux-kernel@...r.kernel.org, Kees Cook <kees@...nel.org>, Christopher
Bazley <chris.bazley.wg14@...il.com>, Rasmus Villemoes
<linux@...musvillemoes.dk>, Marco Elver <elver@...gle.com>, Michal Hocko
<mhocko@...e.com>, Linus Torvalds <torvalds@...ux-foundation.org>, Al Viro
<viro@...iv.linux.org.uk>, Alexander Potapenko <glider@...gle.com>, Dmitry
Vyukov <dvyukov@...gle.com>, Jann Horn <jannh@...gle.com>
Subject: Re: [PATCH v1 0/3] Add ENDOF(), and use it to fix off-by-one bugs
On Thu, 25 Sep 2025 15:20:28 +0200 Alejandro Colomar <alx@...nel.org> wrote:
> I've split some of the patches from the string patch set, as these are
> obvious bug fixes that are trivial to accept.
>
> I've reset the version number of the patch set to 1, to not conflict
> with the version numbering of the string series.
fyi, there's nothing here which is usable in an introductory [0/N]
cover letter.
Documentation/process/submitting-patches.rst should explain the
conventions here, but it is presently silent.
The [0/N] is an overview of the whole patchset - why it was created,
what value it provides to our users and perhaps to kernel developers
themselves. It discusses alternative approaches, possible drawbacks,
prior work, all that stuff. And it provides a high-level description
of the proposed implementation,
Potentially lots of words, and it's quite important. In the case of
your patchset, it's one short sentence (sorry).
The words you did include are short-term development things, unsuitable
for inclusion in the permanent kernel record. Such material *is*
important and useful, but should be added after the "^---$" separator,
to tell everyone that this material isn't for permanent inclusion.
Patchset seems reasonable, I guess. But I'm not loving "ENDOF". End
of what - is that like __etext? "ARRAY_END" matches "ARRAY_SIZE" quite
nicely, no? And it much better describes what the thing does.
Powered by blists - more mailing lists