* [PATCH 0/4 v2] Docs: changes.rst: rework
@ 2026-08-31 15:16 Manuel Ebner
2026-08-31 15:24 ` [PATCH 3/4] Docs: pt_BR, it_IT: changes.rst: copy table from english source Manuel Ebner
` (2 more replies)
0 siblings, 3 replies; 5+ 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] 5+ 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:24 ` Manuel Ebner
2026-08-31 15:25 ` [PATCH] v2 Docs: changes.rst: introduce optional column Manuel Ebner
2026-09-01 10:03 ` [PATCH 0/4 v2] Docs: changes.rst: rework Miguel Ojeda
2 siblings, 0 replies; 5+ 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] 5+ 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: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-09-01 10:03 ` [PATCH 0/4 v2] Docs: changes.rst: rework Miguel Ojeda
2 siblings, 1 reply; 5+ 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] 5+ 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; 5+ 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] 5+ 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
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-09-01 10:03 ` Miguel Ojeda
2 siblings, 0 replies; 5+ 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] 5+ messages in thread
end of thread, other threads:[~2026-09-01 10:03 UTC | newest]
Thread overview: 5+ 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: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-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