Linux Documentation
 help / color / mirror / Atom feed
* [PATCH 0/4 v2] Docs: changes.rst: rework
@ 2026-08-31 15:16 Manuel Ebner
  2026-08-31 15:22 ` [PATCH 2/4] Docs: changes.rst, ver_linux: add tools Manuel Ebner
                   ` (4 more replies)
  0 siblings, 5 replies; 8+ messages in thread
From: Manuel Ebner @ 2026-08-31 15:16 UTC (permalink / raw)
  To: Manuel Ebner, Jonathan Corbet, Shuah Khan, Federico Vaga,
	Akira Yokosawa, Daniel Pereira, Carlos Bilbao, Avadhut Naik,
	Alex Shi, Yanteng Si, Dongliang Mu, Hu Haowen, Alexei Starovoitov,
	Daniel Borkmann, Andrii Nakryiko, Eduard Zingerman,
	Kumar Kartikeya Dwivedi, Martin KaFai Lau, Song Liu,
	Yonghong Song, Jiri Olsa, Emil Tsalapatis, Miguel Ojeda,
	Boqun Feng, Gary Guo, Björn Roy Baron, Benno Lossin,
	Andreas Hindborg, Alice Ryhl, Trevor Gross, Danilo Krummrich,
	Daniel Almeida, Tamir Duberstein, Alexandre Courbot,
	Onur Özkan, Nathan Chancellor, Nick Desaulniers,
	Bill Wendling, Justin Stitt, workflows, linux-doc, linux-kernel,
	rust-for-linux, llvm

There are a couple things fallacious in changes.rst. Issues are
inaccurate language (patch 1). Patch 2 adds toolsets and patch 3 updates
the list in the translations. Finally patch 4 is a preview for a way to
handle the marking of optional software.

---
->[v2]
Ditch the name change [PATCH 1/5 v1]
Add Acked-by: Randy Dunlap to [PATCH 1/4 v2], [PATCH 2/4 v2]
Add genisoimage, mtools and syslinux to list [PATCH 2/4 v2]
Ditch footnotes in favor of a column [PATCH 4/4 v2]

[v1]
 https://lore.kernel.org/all/20260812120805.1631430-3-manuelebnerli@mailbox.org/
---

^ permalink raw reply	[flat|nested] 8+ messages in thread

* [PATCH 2/4] Docs: changes.rst, ver_linux: add tools
  2026-08-31 15:16 [PATCH 0/4 v2] Docs: changes.rst: rework Manuel Ebner
@ 2026-08-31 15:22 ` Manuel Ebner
  2026-08-31 17:36   ` Randy Dunlap
  2026-08-31 15:24 ` [PATCH 3/4] Docs: pt_BR, it_IT: changes.rst: copy table from english source Manuel Ebner
                   ` (3 subsequent siblings)
  4 siblings, 1 reply; 8+ messages in thread
From: Manuel Ebner @ 2026-08-31 15:22 UTC (permalink / raw)
  To: Jonathan Corbet, Shuah Khan
  Cc: Manuel Ebner, Randy Dunlap, workflows, linux-doc, linux-kernel

lzma is required with HAVE_KERNEL_LZMA set to y
lzop is required with CRYPTO_LZO set to y
iproute2 is mentioned in changes below.
"ip-route2" -> "iproute2"
syslinux is and genisoimage needed for ´make isoimag´
mtools is required for genimage.sh

add tools to
 changes.rst and ver_linux

Signed-off-by: Manuel Ebner <manuelebnerli@mailbox.org>
Acked-by: Randy Dunlap <rdunlap@infradead.org>
---
should edk2/OVMF be added aswell?
it would be for arch/x86/boot/genimage.sh
---
 Documentation/process/changes.rst | 10 ++++++++--
 scripts/ver_linux                 |  6 ++++++
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/Documentation/process/changes.rst b/Documentation/process/changes.rst
index fb5ef7d743ba..b3fa980b63e3 100644
--- a/Documentation/process/changes.rst
+++ b/Documentation/process/changes.rst
@@ -41,17 +41,22 @@ Clang/LLVM (optional)  17.0.1           clang --version
 e2fsprogs              1.41.4           e2fsck -V
 flex                   2.5.35           flex --version
 gdb                    7.2              gdb --version
+genisoimage            1.1.11           genisoimage --version
 GNU awk (optional)     5.1.0            gawk --version
 GNU C                  8.1              gcc --version
 GNU make               4.0              make --version
 GNU tar                1.28             tar --version
 GRUB                   0.93             grub --version || grub-install --version
 gtags (optional)       6.6.5            gtags --version
+iproute2               6.14.0           ip -V
 iptables               1.4.2            iptables -V
 jfsutils               1.1.3            fsck.jfs -V
 kmod                   13               kmod -V
+liblzma                5.8.1            lzma -V
+lzop                   1.04             lzop -V
 mcelog                 0.6              mcelog --version
 mkimage (optional)     2017.01          mkimage --version
+mtools                 4.0.49           mtools -V
 nfs-utils              1.0.5            showmount --version
 openssl & libcrypto    1.0.0            openssl version
 pahole                 1.26             pahole --version
@@ -63,6 +68,7 @@ quota-tools            3.09             quota -V
 Rust (optional)        1.85.0           rustc --version
 Sphinx\ [#f1]_         3.4.3            sphinx-build --version
 squashfs-tools         4.0              mksquashfs -version
+syslinux               6.04             syslinux --version
 udev                   081              udevadm --version
 util-linux             2.10o            mount --version
 xfsprogs               2.6.0            xfs_db -V
@@ -336,7 +342,7 @@ General changes
 ---------------
 
 If you have advanced network configuration needs, you should probably
-consider using the network tools from ip-route2.
+consider using the network tools from iproute2.
 
 Packet Filter / NAT
 -------------------
@@ -557,7 +563,7 @@ Iptables
 
 - <https://netfilter.org/projects/iptables/index.html>
 
-Ip-route2
+Iproute2
 ---------
 
 - <https://www.kernel.org/pub/linux/utils/net/iproute2/>
diff --git a/scripts/ver_linux b/scripts/ver_linux
index 00bdaf30d590..7495177843e5 100755
--- a/scripts/ver_linux
+++ b/scripts/ver_linux
@@ -29,6 +29,7 @@ BEGIN {
 	printversion("e2fsprogs", version("e2fsck -V"))
 	printversion("flex", version("flex --version"))
 	printversion("gdb", version("gdb -version"))
+	printversion("genisoimage", version("genisoimage --version"))
 	printversion("GNU awk", version("gawk --version"))
 	printversion("GNU C", version("gcc -dumpversion"))
 	printversion("GNU make", version("make --version"))
@@ -36,19 +37,23 @@ BEGIN {
 	printversion("GRUB2", version("grub2-install --version"))
 	printversion("GRUB", version("grub-install --version"))
 	printversion("gtags", version("gtags --version"))
+	printversion("iptroute2", version("ip -V"))
 	printversion("iptables", version("iptables -V"))
 	printversion("Isdn4k-utils", version("isdnctrl"))
 	printversion("jfsutils", version("fsck.jfs -V"))
 	printversion("Kbd", version("loadkeys -V"))
 	printversion("kmod", version("kmod -V"))
+	printversion("liblzma", version("lzma -V"))
 
 	while ("ldconfig -p 2>/dev/null" | getline > 0)
 		if ($NF ~ libc || $NF ~ libcpp)
 			if (!seen[ver = version("readlink " $NF)]++)
 				printversion("Linux C" ($NF ~ libcpp? "++" : "") " Library", ver)
 
+	printversion("lzop", version("lzop -V"))
 	printversion("mcelog", version("mcelog --version"))
 	printversion("mkimage", version("mkimage --version"))
+	printversion("mtools", version("mtools -V"))
 	printversion("Module-init-tools", version("depmod -V"))
 	printversion("Mount", version("mount --version"))
 	printversion("Net-tools", version("ifconfig --version"))
@@ -65,6 +70,7 @@ BEGIN {
 	printversion("Sh-utils", version("expr --v"))
 	printversion("Sphinx", version("sphinx-build --version"))
 	printversion("squashfs-tools", version("mksquashfs -version"))
+	printversion("systlinux", version("syslinux --version"))
 	printversion("udev", version("udevadm --version"))
 	printversion("util-linux", version("mount --version"))
 	printversion("Wireless-tools", version("iwconfig --version"))
-- 
2.54.0


^ permalink raw reply related	[flat|nested] 8+ messages in thread

* [PATCH 3/4] Docs: pt_BR, it_IT: changes.rst: copy table from english source
  2026-08-31 15:16 [PATCH 0/4 v2] Docs: changes.rst: rework Manuel Ebner
  2026-08-31 15:22 ` [PATCH 2/4] Docs: changes.rst, ver_linux: add tools Manuel Ebner
@ 2026-08-31 15:24 ` Manuel Ebner
  2026-08-31 15:25 ` [PATCH] v2 Docs: changes.rst: introduce optional column Manuel Ebner
                   ` (2 subsequent siblings)
  4 siblings, 0 replies; 8+ messages in thread
From: Manuel Ebner @ 2026-08-31 15:24 UTC (permalink / raw)
  To: Federico Vaga, Jonathan Corbet, Shuah Khan, Daniel Pereira,
	Miguel Ojeda, Boqun Feng, Gary Guo, Björn Roy Baron,
	Benno Lossin, Andreas Hindborg, Alice Ryhl, Trevor Gross,
	Danilo Krummrich, Daniel Almeida, Tamir Duberstein,
	Alexandre Courbot, Onur Özkan, Nathan Chancellor,
	Nick Desaulniers, Bill Wendling, Justin Stitt
  Cc: Manuel Ebner, linux-doc, linux-kernel, rust-for-linux, llvm

Copy the list from Documentation/process/changes.rst to /it_IT/
and /pt_BR/ with the purpose to update and sort the lists in the translations.

Signed-off-by: Manuel Ebner <manuelebnerli@mailbox.org>
---
 .../translations/it_IT/process/changes.rst    | 75 ++++++++++---------
 .../translations/pt_BR/process/changes.rst    | 58 +++++++-------
 2 files changed, 73 insertions(+), 60 deletions(-)

diff --git a/Documentation/translations/it_IT/process/changes.rst b/Documentation/translations/it_IT/process/changes.rst
index 7ee54c972418..2f813bfebde8 100644
--- a/Documentation/translations/it_IT/process/changes.rst
+++ b/Documentation/translations/it_IT/process/changes.rst
@@ -32,40 +32,47 @@ PC Card, per esempio, probabilmente non dovreste preoccuparvi di pcmciautils.
 ====================== =================  ========================================
         Programma       Versione minima       Comando per verificare la versione
 ====================== =================  ========================================
-GNU C                  8.1                gcc --version
-Clang/LLVM (optional)  17.0.1             clang --version
-Rust (opzionale)       1.78.0             rustc --version
-bindgen (opzionale)    0.65.1             bindgen --version
-GNU make               4.0                make --version
-bash                   4.2                bash --version
-binutils               2.30               ld -v
-flex                   2.5.35             flex --version
-bison                  2.0                bison --version
-pahole                 1.16               pahole --version
-util-linux             2.10o              mount --version
-kmod                   13                 depmod -V
-e2fsprogs              1.41.4             e2fsck -V
-jfsutils               1.1.3              fsck.jfs -V
-xfsprogs               2.6.0              xfs_db -V
-squashfs-tools         4.0                mksquashfs -version
-btrfs-progs            0.18               btrfsck
-pcmciautils            004                pccardctl -V
-quota-tools            3.09               quota -V
-PPP                    2.4.0              pppd --version
-nfs-utils              1.0.5              showmount --version
-procps                 3.2.0              ps --version
-udev                   081                udevd --version
-grub                   0.93               grub --version || grub-install --version
-mcelog                 0.6                mcelog --version
-iptables               1.4.2              iptables -V
-openssl & libcrypto    1.0.0              openssl version
-bc                     1.06.95            bc --version
-Sphinx\ [#f1]_         2.4.4              sphinx-build --version
-cpio                   any                cpio --version
-GNU tar                1.28               tar --version
-gtags (opzionale)      6.6.5              gtags --version
-mkimage (opzionale)    2017.01            mkimage --version
-Python (opzionale)     3.5.x              python3 --version
+bash                   4.2              bash --version
+bc                     1.06.95          bc --version
+bindgen (optional)     0.71.1           bindgen --version
+binutils               2.30             ld -v
+bison                  2.0              bison --version
+btrfs-progs            0.18             btrfs --version
+Clang/LLVM (optional)  17.0.1           clang --version
+e2fsprogs              1.41.4           e2fsck -V
+flex                   2.5.35           flex --version
+gdb                    7.2              gdb --version
+genisoimage            1.1.11           genisoimage --version
+GNU awk (optional)     5.1.0            gawk --version
+GNU C                  8.1              gcc --version
+GNU make               4.0              make --version
+GNU tar                1.28             tar --version
+GRUB                   0.93             grub --version || grub-install --version
+gtags (optional)       6.6.5            gtags --version
+iproute2               6.14.0           ip -V
+iptables               1.4.2            iptables -V
+jfsutils               1.1.3            fsck.jfs -V
+kmod                   13               kmod -V
+liblzma                5.8.1            lzma -V
+lzop                   1.04             lzop -V
+mcelog                 0.6              mcelog --version
+mkimage (optional)     2017.01          mkimage --version
+mtools                 4.0.49           mtools -V
+nfs-utils              1.0.5            showmount --version
+openssl & libcrypto    1.0.0            openssl version
+pahole                 1.26             pahole --version
+pcmciautils            004              pccardctl -V
+PPP                    2.4.0            pppd --version
+procps                 3.2.0            ps --version
+Python                 3.9.x            python3 --version
+quota-tools            3.09             quota -V
+Rust (optional)        1.85.0           rustc --version
+Sphinx\ [#f1]_         3.4.3            sphinx-build --version
+squashfs-tools         4.0              mksquashfs -version
+syslinux               6.04             syslinux --version
+udev                   081              udevadm --version
+util-linux             2.10o            mount --version
+xfsprogs               2.6.0            xfs_db -V
 ====================== =================  ========================================
 
 .. [#f1] Sphinx è necessario solo per produrre la documentazione del Kernel
diff --git a/Documentation/translations/pt_BR/process/changes.rst b/Documentation/translations/pt_BR/process/changes.rst
index 51c7fe41663e..86eb7375abe2 100644
--- a/Documentation/translations/pt_BR/process/changes.rst
+++ b/Documentation/translations/pt_BR/process/changes.rst
@@ -31,41 +31,47 @@ PC Card por exemplo, provavelmente não precisará se preocupar com o pcmciautil
 ====================== ===============  ========================================
 Programa               Versão mínima    Comando para verificar a versão
 ====================== ===============  ========================================
-GNU C                  8.1              gcc --version
-Clang/LLVM (optional)  17.0.1           clang --version
-Rust (optional)        1.85.0           rustc --version
-bindgen (optional)     0.71.1           bindgen --version
-GNU make               4.0              make --version
 bash                   4.2              bash --version
+bc                     1.06.95          bc --version
+bindgen (optional)     0.71.1           bindgen --version
 binutils               2.30             ld -v
-flex                   2.5.35           flex --version
-gdb                    7.2              gdb --version
 bison                  2.0              bison --version
-pahole                 1.22             pahole --version
-util-linux             2.10o            mount --version
-kmod                   13               kmod -V
+btrfs-progs            0.18             btrfs --version
+Clang/LLVM (optional)  17.0.1           clang --version
 e2fsprogs              1.41.4           e2fsck -V
+flex                   2.5.35           flex --version
+gdb                    7.2              gdb --version
+genisoimage            1.1.11           genisoimage --version
+GNU awk (optional)     5.1.0            gawk --version
+GNU C                  8.1              gcc --version
+GNU make               4.0              make --version
+GNU tar                1.28             tar --version
+GRUB                   0.93             grub --version || grub-install --version
+gtags (optional)       6.6.5            gtags --version
+iproute2               6.14.0           ip -V
+iptables               1.4.2            iptables -V
 jfsutils               1.1.3            fsck.jfs -V
-xfsprogs               2.6.0            xfs_db -V
-squashfs-tools         4.0              mksquashfs -version
-btrfs-progs            0.18             btrfs --version
+kmod                   13               kmod -V
+liblzma                5.8.1            lzma -V
+lzop                   1.04             lzop -V
+mcelog                 0.6              mcelog --version
+mkimage (optional)     2017.01          mkimage --version
+mtools                 4.0.49           mtools -V
+nfs-utils              1.0.5            showmount --version
+openssl & libcrypto    1.0.0            openssl version
+pahole                 1.26             pahole --version
 pcmciautils            004              pccardctl -V
-quota-tools            3.09             quota -V
 PPP                    2.4.0            pppd --version
-nfs-utils              1.0.5            showmount --version
 procps                 3.2.0            ps --version
-udev                   081              udevadm --version
-grub                   0.93             grub --version || grub-install --version
-mcelog                 0.6              mcelog --version
-iptables               1.4.2            iptables -V
-openssl & libcrypto    1.0.0            openssl version
-bc                     1.06.95          bc --version
-Sphinx [#f1]_          3.4.3            sphinx-build --version
-GNU tar                1.28             tar --version
-gtags (opcional)       6.6.5            gtags --version
-mkimage (opcional)     2017.01          mkimage --version
 Python                 3.9.x            python3 --version
-GNU AWK (opcional)     5.1.0            gawk --version
+quota-tools            3.09             quota -V
+Rust (optional)        1.85.0           rustc --version
+Sphinx\ [#f1]_         3.4.3            sphinx-build --version
+squashfs-tools         4.0              mksquashfs -version
+syslinux               6.04             syslinux --version
+udev                   081              udevadm --version
+util-linux             2.10o            mount --version
+xfsprogs               2.6.0            xfs_db -V
 ====================== ===============  ========================================
 
 .. [#f1] O Sphinx é necessário apenas para gerar a documentação do Kernel.
-- 
2.54.0


^ permalink raw reply related	[flat|nested] 8+ messages in thread

* [PATCH] v2 Docs: changes.rst: introduce optional column
  2026-08-31 15:16 [PATCH 0/4 v2] Docs: changes.rst: rework Manuel Ebner
  2026-08-31 15:22 ` [PATCH 2/4] Docs: changes.rst, ver_linux: add tools Manuel Ebner
  2026-08-31 15:24 ` [PATCH 3/4] Docs: pt_BR, it_IT: changes.rst: copy table from english source Manuel Ebner
@ 2026-08-31 15:25 ` Manuel Ebner
  2026-08-31 16:32   ` Miguel Ojeda
  2026-08-31 15:26 ` [PATCH 1/4] Docs: changes.rst: Refine language Manuel Ebner
  2026-09-01 10:03 ` [PATCH 0/4 v2] Docs: changes.rst: rework Miguel Ojeda
  4 siblings, 1 reply; 8+ messages in thread
From: Manuel Ebner @ 2026-08-31 15:25 UTC (permalink / raw)
  To: Jonathan Corbet, Shuah Khan, Miguel Ojeda, Boqun Feng, Gary Guo,
	Björn Roy Baron, Benno Lossin, Andreas Hindborg, Alice Ryhl,
	Trevor Gross, Danilo Krummrich, Daniel Almeida, Tamir Duberstein,
	Alexandre Courbot, Onur Özkan, Nathan Chancellor,
	Nick Desaulniers, Bill Wendling, Justin Stitt
  Cc: Manuel Ebner, workflows, linux-doc, linux-kernel, rust-for-linux,
	llvm

The optional tag isn't obvious nor defined. Therefore replace with column.

Signed-off-by: Manuel Ebner <manuelebnerli@mailbox.org>
---
 Documentation/process/changes.rst | 84 +++++++++++++++----------------
 1 file changed, 42 insertions(+), 42 deletions(-)

diff --git a/Documentation/process/changes.rst b/Documentation/process/changes.rst
index b3fa980b63e3..905ac0f6cdc5 100644
--- a/Documentation/process/changes.rst
+++ b/Documentation/process/changes.rst
@@ -29,49 +29,49 @@ systems; obviously, if you don't have any PC Card hardware, for example,
 you probably do not need to concern yourself with pcmciautils.
 
 ====================== ===============  ========================================
-        Program        Minimal version       Command to check the version
+        Program        Minimal version  Required for 
 ====================== ===============  ========================================
-bash                   4.2              bash --version
-bc                     1.06.95          bc --version
-bindgen (optional)     0.71.1           bindgen --version
-binutils               2.30             ld -v
-bison                  2.0              bison --version
-btrfs-progs            0.18             btrfs --version
-Clang/LLVM (optional)  17.0.1           clang --version
-e2fsprogs              1.41.4           e2fsck -V
-flex                   2.5.35           flex --version
-gdb                    7.2              gdb --version
-genisoimage            1.1.11           genisoimage --version
-GNU awk (optional)     5.1.0            gawk --version
-GNU C                  8.1              gcc --version
-GNU make               4.0              make --version
-GNU tar                1.28             tar --version
-GRUB                   0.93             grub --version || grub-install --version
-gtags (optional)       6.6.5            gtags --version
-iproute2               6.14.0           ip -V
-iptables               1.4.2            iptables -V
-jfsutils               1.1.3            fsck.jfs -V
-kmod                   13               kmod -V
-liblzma                5.8.1            lzma -V
-lzop                   1.04             lzop -V
-mcelog                 0.6              mcelog --version
-mkimage (optional)     2017.01          mkimage --version
-mtools                 4.0.49           mtools -V
-nfs-utils              1.0.5            showmount --version
-openssl & libcrypto    1.0.0            openssl version
-pahole                 1.26             pahole --version
-pcmciautils            004              pccardctl -V
-PPP                    2.4.0            pppd --version
-procps                 3.2.0            ps --version
-Python                 3.9.x            python3 --version
-quota-tools            3.09             quota -V
-Rust (optional)        1.85.0           rustc --version
-Sphinx\ [#f1]_         3.4.3            sphinx-build --version
-squashfs-tools         4.0              mksquashfs -version
-syslinux               6.04             syslinux --version
-udev                   081              udevadm --version
-util-linux             2.10o            mount --version
-xfsprogs               2.6.0            xfs_db -V
+bash                   4.2              
+bc                     1.06.95          
+bindgen                0.71.1           generate Rust bindings
+binutils               2.30             
+bison                  2.0              
+btrfs-progs            0.18             
+Clang/LLVM             17.0.1           alternative to GNU C (gcc)
+e2fsprogs              1.41.4           ext4
+flex                   2.5.35           
+gdb                    7.2              
+genisoimage            1.1.11           
+GNU awk                5.1.0            objtool
+GNU C                  8.1              
+GNU make               4.0              
+GNU tar                1.28             
+GRUB                   0.93             
+gtags (optional)       6.6.5            
+iproute2               6.14.0           
+iptables               1.4.2            
+jfsutils               1.1.3            
+kmod                   13               
+liblzma                5.8.1            
+lzop                   1.04             
+mcelog                 0.6              
+mkimage                2017.01          ARCH=arc, arm, or powerpc
+mtools                 4.0.49           
+nfs-utils              1.0.5            
+openssl & libcrypto    1.0.0            
+pahole                 1.26             
+pcmciautils            004              
+PPP                    2.4.0            
+procps                 3.2.0            
+Python                 3.9.x            
+quota-tools            3.09             
+Rust                   1.85.0           CONFIG_RUST=y
+Sphinx\ [#f1]_         3.4.3            
+squashfs-tools         4.0              
+syslinux               6.04             
+udev                   081              
+util-linux             2.10o            
+xfsprogs               2.6.0            
 ====================== ===============  ========================================
 
 .. [#f1] Sphinx is needed only to build the Kernel documentation
-- 
2.54.0


^ permalink raw reply related	[flat|nested] 8+ messages in thread

* [PATCH 1/4] Docs: changes.rst: Refine language
  2026-08-31 15:16 [PATCH 0/4 v2] Docs: changes.rst: rework Manuel Ebner
                   ` (2 preceding siblings ...)
  2026-08-31 15:25 ` [PATCH] v2 Docs: changes.rst: introduce optional column Manuel Ebner
@ 2026-08-31 15:26 ` Manuel Ebner
  2026-09-01 10:03 ` [PATCH 0/4 v2] Docs: changes.rst: rework Miguel Ojeda
  4 siblings, 0 replies; 8+ messages in thread
From: Manuel Ebner @ 2026-08-31 15:26 UTC (permalink / raw)
  To: Jonathan Corbet, Shuah Khan
  Cc: Manuel Ebner, Randy Dunlap, workflows, linux-doc, linux-kernel

This document grew over the years and isn't limited to compilling or running
the kernel anymore.

compile -> interact
levels -> versions
run the current kernel version -> change code, compile, install and boot the current kernel version.
ip-route2 -> iproute2

Signed-off-by: Manuel Ebner <manuelebnerli@mailbox.org>
Acked-by: Randy Dunlap <rdunlap@infradead.org>
---
I messed the order up.
---
 Documentation/process/changes.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/Documentation/process/changes.rst b/Documentation/process/changes.rst
index 1ca8c5f73ad0..fb5ef7d743ba 100644
--- a/Documentation/process/changes.rst
+++ b/Documentation/process/changes.rst
@@ -1,13 +1,14 @@
 .. _changes:
 
-Minimal requirements to compile the Kernel
-++++++++++++++++++++++++++++++++++++++++++
+Minimal requirements to interact with the Kernel
+++++++++++++++++++++++++++++++++++++++++++++++++
 
 Intro
 =====
 
-This document is designed to provide a list of the minimum levels of
-software necessary to run the current kernel version.
+This document is designed to provide a list of the minimum versions of
+software necessary to change code, compile, install and boot the current
+kernel version.
 
 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.54.0


^ permalink raw reply related	[flat|nested] 8+ messages in thread

* Re: [PATCH] v2 Docs: changes.rst: introduce optional column
  2026-08-31 15:25 ` [PATCH] v2 Docs: changes.rst: introduce optional column Manuel Ebner
@ 2026-08-31 16:32   ` Miguel Ojeda
  0 siblings, 0 replies; 8+ messages in thread
From: Miguel Ojeda @ 2026-08-31 16:32 UTC (permalink / raw)
  To: Manuel Ebner
  Cc: Jonathan Corbet, Shuah Khan, Miguel Ojeda, Boqun Feng, Gary Guo,
	Björn Roy Baron, Benno Lossin, Andreas Hindborg, Alice Ryhl,
	Trevor Gross, Danilo Krummrich, Daniel Almeida, Tamir Duberstein,
	Alexandre Courbot, Onur Özkan, Nathan Chancellor,
	Nick Desaulniers, Bill Wendling, Justin Stitt, workflows,
	linux-doc, linux-kernel, rust-for-linux, llvm, Guillaume Tucker,
	Nicolas Schier

On Mon, Aug 31, 2026 at 5:25 PM Manuel Ebner <manuelebnerli@mailbox.org> wrote:
>
> +bindgen                0.71.1           generate Rust bindings

Should this simply say `CONFIG_RUST=y` too?

> +Clang/LLVM             17.0.1           alternative to GNU C (gcc)

Should we add an equivalent one to GNU C?

> +gtags (optional)       6.6.5

It seems the patch missed this one?

> +Sphinx\ [#f1]_         3.4.3

Should the footnote be moved into the new column?

> xfsprogs               2.6.0

Is this always required? There may be others that are actually optional too.

Cc'ing Guillaume and Nicolas -- we were discussing Python in this thread:

  https://lore.kernel.org/all/apG3hwaPA8f7SJeI@levanger/

Thanks!

Cheers,
Miguel

^ permalink raw reply	[flat|nested] 8+ messages in thread

* Re: [PATCH 2/4] Docs: changes.rst, ver_linux: add tools
  2026-08-31 15:22 ` [PATCH 2/4] Docs: changes.rst, ver_linux: add tools Manuel Ebner
@ 2026-08-31 17:36   ` Randy Dunlap
  0 siblings, 0 replies; 8+ messages in thread
From: Randy Dunlap @ 2026-08-31 17:36 UTC (permalink / raw)
  To: Manuel Ebner, Jonathan Corbet, Shuah Khan
  Cc: workflows, linux-doc, linux-kernel



On 8/31/26 8:22 AM, Manuel Ebner wrote:
> lzma is required with HAVE_KERNEL_LZMA set to y
> lzop is required with CRYPTO_LZO set to y
> iproute2 is mentioned in changes below.
> "ip-route2" -> "iproute2"
> syslinux is and genisoimage needed for ´make isoimag´
> mtools is required for genimage.sh
> 
> add tools to
>  changes.rst and ver_linux
> 
> Signed-off-by: Manuel Ebner <manuelebnerli@mailbox.org>
> Acked-by: Randy Dunlap <rdunlap@infradead.org>
> ---
> should edk2/OVMF be added aswell?

                            as well?

> it would be for arch/x86/boot/genimage.sh

  when building an hdimage
  if the kernel is compiled with the EFI stub.

How many qualifiers do you want to include? :)

I don't know the answer...

> ---
>  Documentation/process/changes.rst | 10 ++++++++--
>  scripts/ver_linux                 |  6 ++++++
>  2 files changed, 14 insertions(+), 2 deletions(-)

-- 
~Randy


^ permalink raw reply	[flat|nested] 8+ messages in thread

* Re: [PATCH 0/4 v2] Docs: changes.rst: rework
  2026-08-31 15:16 [PATCH 0/4 v2] Docs: changes.rst: rework Manuel Ebner
                   ` (3 preceding siblings ...)
  2026-08-31 15:26 ` [PATCH 1/4] Docs: changes.rst: Refine language Manuel Ebner
@ 2026-09-01 10:03 ` Miguel Ojeda
  4 siblings, 0 replies; 8+ messages in thread
From: Miguel Ojeda @ 2026-09-01 10:03 UTC (permalink / raw)
  To: Manuel Ebner
  Cc: Jonathan Corbet, Shuah Khan, Federico Vaga, Akira Yokosawa,
	Daniel Pereira, Carlos Bilbao, Avadhut Naik, Alex Shi, Yanteng Si,
	Dongliang Mu, Hu Haowen, Alexei Starovoitov, Daniel Borkmann,
	Andrii Nakryiko, Eduard Zingerman, Kumar Kartikeya Dwivedi,
	Martin KaFai Lau, Song Liu, Yonghong Song, Jiri Olsa,
	Emil Tsalapatis, Miguel Ojeda, Boqun Feng, Gary Guo,
	Björn Roy Baron, Benno Lossin, Andreas Hindborg, Alice Ryhl,
	Trevor Gross, Danilo Krummrich, Daniel Almeida, Tamir Duberstein,
	Alexandre Courbot, Onur Özkan, Nathan Chancellor,
	Nick Desaulniers, Bill Wendling, Justin Stitt, workflows,
	linux-doc, linux-kernel, rust-for-linux, llvm

On Mon, Aug 31, 2026 at 5:17 PM Manuel Ebner <manuelebnerli@mailbox.org> wrote:
>
> ->[v2]
> Ditch the name change [PATCH 1/5 v1]
> Add Acked-by: Randy Dunlap to [PATCH 1/4 v2], [PATCH 2/4 v2]
> Add genisoimage, mtools and syslinux to list [PATCH 2/4 v2]
> Ditch footnotes in favor of a column [PATCH 4/4 v2]
>
> [v1]
>  https://lore.kernel.org/all/20260812120805.1631430-3-manuelebnerli@mailbox.org/

In my usual go-through-the-ML exercise, I noticed that the subjects of
these emails look a bit strange: one is missing the version, the
version is at the end, and they seem to be out of order:

  https://lore.kernel.org/all/20260831151605.638172-2-manuelebnerli@mailbox.org/

I would suggest using `-vN` in `git-format-patch` or `b4` to handle
this instead.

In addition, if the changes on a given version are local to each
patch, you may add them per patch instead, after the `---` line, if
that makes it easier to track.

I hope that helps.

Cheers,
Miguel

^ permalink raw reply	[flat|nested] 8+ messages in thread

end of thread, other threads:[~2026-09-01 10:03 UTC | newest]

Thread overview: 8+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-08-31 15:16 [PATCH 0/4 v2] Docs: changes.rst: rework Manuel Ebner
2026-08-31 15:22 ` [PATCH 2/4] Docs: changes.rst, ver_linux: add tools Manuel Ebner
2026-08-31 17:36   ` Randy Dunlap
2026-08-31 15:24 ` [PATCH 3/4] Docs: pt_BR, it_IT: changes.rst: copy table from english source Manuel Ebner
2026-08-31 15:25 ` [PATCH] v2 Docs: changes.rst: introduce optional column Manuel Ebner
2026-08-31 16:32   ` Miguel Ojeda
2026-08-31 15:26 ` [PATCH 1/4] Docs: changes.rst: Refine language Manuel Ebner
2026-09-01 10:03 ` [PATCH 0/4 v2] Docs: changes.rst: rework Miguel Ojeda

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox