Commit bbaee49c authored by Thorsten Leemhuis's avatar Thorsten Leemhuis Committed by Greg Kroah-Hartman

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 <gregkh@linuxfoundation.org>
CC: Sasha Levin <sashal@kernel.org>
CC: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: default avatarThorsten Leemhuis <linux@leemhuis.info>
Link: https://lore.kernel.org/r/ddb5cb0d6b7aa4ef31642cd9657a0fb53d79cddb.1691219455.git.linux@leemhuis.infoSigned-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 6e160d29
...@@ -56,6 +56,12 @@ at the time of submission. :ref:`option_3` is an alternative to the two earlier ...@@ -56,6 +56,12 @@ at the time of submission. :ref:`option_3` is an alternative to the two earlier
options for cases where a mainlined patch needs adjustments to apply in older options for cases where a mainlined patch needs adjustments to apply in older
series (for example due to API changes). series (for example due to API changes).
When using option 2 or 3 you can ask for your change to be included in specific
stable series. When doing so, ensure the fix or an equivalent is applicable,
submitted, or already present in all newer stable trees still supported. This is
meant to prevent regressions that users might later encounter on updating, if
e.g. a fix merged for 5.19-rc1 would be backported to 5.10.y, but not to 5.15.y.
.. _option_1: .. _option_1:
Option 1 Option 1
...@@ -133,7 +139,7 @@ Option 2 ...@@ -133,7 +139,7 @@ Option 2
If the patch already has been merged to mainline, send an email to If the patch already has been merged to mainline, send an email to
stable@vger.kernel.org containing the subject of the patch, the commit ID, stable@vger.kernel.org containing the subject of the patch, the commit ID,
why you think it should be applied, and what kernel version you wish it to why you think it should be applied, and what kernel versions you wish it to
be applied to. be applied to.
.. _option_3: .. _option_3:
...@@ -142,7 +148,7 @@ Option 3 ...@@ -142,7 +148,7 @@ Option 3
******** ********
Send the patch, after verifying that it follows the above rules, to Send the patch, after verifying that it follows the above rules, to
stable@vger.kernel.org and mention the kernel version you wish it to be applied stable@vger.kernel.org and mention the kernel versions you wish it to be applied
to. When doing so, you must note the upstream commit ID in the changelog of your to. When doing so, you must note the upstream commit ID in the changelog of your
submission with a separate line above the commit text, like this: submission with a separate line above the commit text, like this:
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment