[PATCH 0/2] Docs: Update information at changes.rst

[PATCH 0/2] Docs: Update information at changes.rst

[Bruno Moreira-Guedes]

[-- Attachment #1: Type: text/plain, Size: 629 bytes --]

Add and update information at 'Documentation/process/changes.rst'. The
text has outdated kernel version and misses the 'cpio' build
requirement, necessary for the `kernel/gen_kheaders.sh` script called by
the install target.

The PATCH 1/2 fixes the missing cpio requirement, while PATCH 2/2 fixes
the kernel version.

Signed-off-by: Bruno Moreira-Guedes <codeagain@codeagain.dev>
---
Bruno Moreira-Guedes (2):
  Docs: Add cpio requirement to changes.rst
  Docs: Update kernel series in changes.rst

 Documentation/process/changes.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

-- 
2.35.3


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]

[PATCH 1/2] Docs: Add cpio requirement to changes.rst

[Bruno Moreira-Guedes]

[-- Attachment #1: Type: text/plain, Size: 1182 bytes --]

The install target requires cpio to run the `kernel/gen_kheaders.sh`
script, but it's missing in the requirements list at
'Documentation/process/changes.rst'. This patch adds it to the list.

Signed-off-by: Bruno Moreira-Guedes <codeagain@codeagain.dev>
---
 Documentation/process/changes.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/Documentation/process/changes.rst b/Documentation/process/changes.rst
index a337e8eabfe1..41a44e5f47e6 100644
--- a/Documentation/process/changes.rst
+++ b/Documentation/process/changes.rst
@@ -56,6 +56,7 @@ iptables               1.4.2            iptables -V
 openssl & libcrypto    1.0.0            openssl version
 bc                     1.06.95          bc --version
 Sphinx\ [#f1]_         1.7              sphinx-build --version
+cpio                   any              cpio --version
 ====================== ===============  ========================================
 
 .. [#f1] Sphinx is needed only to build the Kernel documentation
@@ -458,6 +459,11 @@ mcelog
 
 - <http://www.mcelog.org/>
 
+cpio
+----
+
+- <https://www.gnu.org/software/cpio/>
+
 Networking
 **********
 
-- 
2.35.3


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]

[PATCH 2/2] Docs: Update kernel series in changes.rst

[Bruno Moreira-Guedes]

[-- Attachment #1: Type: text/plain, Size: 967 bytes --]

The file 'Documentation/process/changes.rst' states the listed
requirements are for the 4.x kernel version. However, there are
requirements updated for the 5.x version, so this patch updates it to
match the current kernel version.

Signed-off-by: Bruno Moreira-Guedes <codeagain@codeagain.dev>
---
 Documentation/process/changes.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/process/changes.rst b/Documentation/process/changes.rst
index 41a44e5f47e6..08515b11cf92 100644
--- a/Documentation/process/changes.rst
+++ b/Documentation/process/changes.rst
@@ -7,7 +7,7 @@ Intro
 =====
 
 This document is designed to provide a list of the minimum levels of
-software necessary to run the 4.x kernels.
+software necessary to run the 5.x kernels.
 
 This document is originally based on my "Changes" file for 2.0.x kernels
 and therefore owes credit to the same people as that file (Jared Mauch,
-- 
2.35.3


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]

Re: [PATCH 2/2] Docs: Update kernel series in changes.rst

[Matthew Wilcox]

On Mon, Apr 18, 2022 at 11:58:35PM -0300, Bruno Moreira-Guedes wrote:
> @@ -7,7 +7,7 @@ Intro
>  =====
>  
>  This document is designed to provide a list of the minimum levels of
> -software necessary to run the 4.x kernels.
> +software necessary to run the 5.x kernels.

We don't change the major version when we update the minimum required
tooling ... why not change this once and for all to say:

+software necessary to build the current kernel.

Re: [PATCH 2/2] Docs: Update kernel series in changes.rst

[Bruno Moreira-Guedes]

[-- Attachment #1: Type: text/plain, Size: 562 bytes --]

On Tue, Apr 19, 2022 at 04:06:32AM +0100, Matthew Wilcox wrote:
> On Mon, Apr 18, 2022 at 11:58:35PM -0300, Bruno Moreira-Guedes wrote:
> >  This document is designed to provide a list of the minimum levels of
> > -software necessary to run the 4.x kernels.
> > +software necessary to run the 5.x kernels.
> 
> We don't change the major version when we update the minimum required
> tooling ... why not change this once and for all to say:
> 
> +software necessary to build the current kernel.

Indeed it makes much more sense, I'm making a v2 soon!

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]