* A contradiction of "summary phrase" definition in process/submitting-patches.rst
@ 2025-03-31 13:05 Integral
2025-03-31 13:23 ` Jonathan Corbet
0 siblings, 1 reply; 2+ messages in thread
From: Integral @ 2025-03-31 13:05 UTC (permalink / raw)
To: corbet; +Cc: linux-doc, linux-kernel, ziyao, integral, workflows
Hello,
I found a contradiction in process/submitting-patches.rst:
The canonical patch subject line is::
Subject: [PATCH 001/123] subsystem: summary phrase
The ``summary phrase`` may be prefixed by tags enclosed in square
brackets: "Subject: [PATCH <tag>...] <summary phrase>".
The former means "summary phrase" doesn't include "subsystem", while the
latter means "summary phrase" includes "subsystem".
So, which one is correct?
--
Integral
^ permalink raw reply [flat|nested] 2+ messages in thread
* Re: A contradiction of "summary phrase" definition in process/submitting-patches.rst
2025-03-31 13:05 A contradiction of "summary phrase" definition in process/submitting-patches.rst Integral
@ 2025-03-31 13:23 ` Jonathan Corbet
0 siblings, 0 replies; 2+ messages in thread
From: Jonathan Corbet @ 2025-03-31 13:23 UTC (permalink / raw)
To: Integral; +Cc: linux-doc, linux-kernel, ziyao, integral, workflows
Integral <integral@archlinuxcn.org> writes:
> I found a contradiction in process/submitting-patches.rst:
>
> The canonical patch subject line is::
> Subject: [PATCH 001/123] subsystem: summary phrase
>
> The ``summary phrase`` may be prefixed by tags enclosed in square
> brackets: "Subject: [PATCH <tag>...] <summary phrase>".
>
> The former means "summary phrase" doesn't include "subsystem", while the
> latter means "summary phrase" includes "subsystem".
>
> So, which one is correct?
I honestly don't see the contradiction here; the summary phrase is as
described here; the subsystem indicator is part of it.
When in doubt, look at the commits in the subsystem you are interested
in, and you will see the expected pattern quickly enough.
Thanks,
jon
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2025-03-31 13:30 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2025-03-31 13:05 A contradiction of "summary phrase" definition in process/submitting-patches.rst Integral
2025-03-31 13:23 ` Jonathan Corbet
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox