Skip to content

Commit bbaee49

Browse files
knurdgregkh
authored andcommitted
docs: stable-kernel-rules: mention that regressions must be prevented
Document that changes intended for a specific stable series have to be in all newer series still maintained, as otherwise users would run into regressions. CC: Greg KH <[email protected]> CC: Sasha Levin <[email protected]> CC: Jonathan Corbet <[email protected]> Signed-off-by: Thorsten Leemhuis <[email protected]> Link: https://lore.kernel.org/r/ddb5cb0d6b7aa4ef31642cd9657a0fb53d79cddb.1691219455.git.linux@leemhuis.info Signed-off-by: Greg Kroah-Hartman <[email protected]>
1 parent 6e160d2 commit bbaee49

File tree

1 file changed

+8
-2
lines changed

1 file changed

+8
-2
lines changed

Documentation/process/stable-kernel-rules.rst

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,12 @@ at the time of submission. :ref:`option_3` is an alternative to the two earlier
5656
options for cases where a mainlined patch needs adjustments to apply in older
5757
series (for example due to API changes).
5858

59+
When using option 2 or 3 you can ask for your change to be included in specific
60+
stable series. When doing so, ensure the fix or an equivalent is applicable,
61+
submitted, or already present in all newer stable trees still supported. This is
62+
meant to prevent regressions that users might later encounter on updating, if
63+
e.g. a fix merged for 5.19-rc1 would be backported to 5.10.y, but not to 5.15.y.
64+
5965
.. _option_1:
6066

6167
Option 1
@@ -133,7 +139,7 @@ Option 2
133139

134140
If the patch already has been merged to mainline, send an email to
135141
[email protected] containing the subject of the patch, the commit ID,
136-
why you think it should be applied, and what kernel version you wish it to
142+
why you think it should be applied, and what kernel versions you wish it to
137143
be applied to.
138144

139145
.. _option_3:
@@ -142,7 +148,7 @@ Option 3
142148
********
143149

144150
Send the patch, after verifying that it follows the above rules, to
145-
[email protected] and mention the kernel version you wish it to be applied
151+
[email protected] and mention the kernel versions you wish it to be applied
146152
to. When doing so, you must note the upstream commit ID in the changelog of your
147153
submission with a separate line above the commit text, like this:
148154

0 commit comments

Comments
 (0)