Commit fa04150b authored by Bagas Sanjaya's avatar Bagas Sanjaya Committed by Jonathan Corbet
Browse files

Documentation: describe how to apply incremental stable patches 



The applying patches document
(Documentation/process/applying-patches.rst) mentions incremental stable
patches, but there is no example of how to apply them. Describe the
process.

While at it, remove note about incremental patches and move the external
link of 5.x.y incremental patches to "Where can I download patches?"
section.

Signed-off-by: default avatarBagas Sanjaya <bagasdotme@gmail.com>
Link: https://lore.kernel.org/r/20220307063340.256671-1-bagasdotme@gmail.com


Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent 78cebdb7

Documentation/process/applying-patches.rst

+23 −5
Original line number Diff line number Diff line
@@ -249,6 +249,10 @@ The 5.x.y (-stable) and 5.x patches live at 


	https://www.kernel.org/pub/linux/kernel/v5.x/



The 5.x.y incremental patches live at



	https://www.kernel.org/pub/linux/kernel/v5.x/incr/



The -rc patches are not stored on the webserver but are generated on

demand from git tags such as
@@ -308,12 +312,11 @@ versions. 
If no 5.x.y kernel is available, then the highest numbered 5.x kernel is

the current stable kernel.



.. note::

The -stable team provides normal as well as incremental patches. Below is

how to apply these patches.



 The -stable team usually do make incremental patches available as well

 as patches against the latest mainline release, but I only cover the

 non-incremental ones below. The incremental ones can be found at

 https://www.kernel.org/pub/linux/kernel/v5.x/incr/

Normal patches

~~~~~~~~~~~~~~



These patches are not incremental, meaning that for example the 5.7.3

patch does not apply on top of the 5.7.2 kernel source, but rather on top
@@ -331,6 +334,21 @@ Here's a small example:: 
	$ cd ..

	$ mv linux-5.7.2 linux-5.7.3	# rename the kernel source dir



Incremental patches

~~~~~~~~~~~~~~~~~~~



Incremental patches are different: instead of being applied on top

of base 5.x kernel, they are applied on top of previous stable kernel

(5.x.y-1).



Here's the example to apply these::



	$ cd ~/linux-5.7.2		# change to the kernel source dir

	$ patch -p1 < ../patch-5.7.2-3	# apply the new 5.7.3 patch

	$ cd ..

	$ mv linux-5.7.2 linux-5.7.3	# rename the kernel source dir





The -rc kernels

===============