* [PATCH v5] Docs/translations/it_IT: sync changes.rst requirements
@ 2026-07-26 6:39 Doehyun Baek
2026-07-26 13:24 ` Federico Vaga
2026-08-03 18:31 ` Jonathan Corbet
0 siblings, 2 replies; 3+ messages in thread
From: Doehyun Baek @ 2026-07-26 6:39 UTC (permalink / raw)
To: linux-doc; +Cc: Doehyun Baek, Federico Vaga, Jonathan Corbet, Shuah Khan
The Italian current requirements text had fallen behind the English
Documentation/process/changes.rst version.
Sync the current requirements table and add the missing ver_linux note.
Also update directly related text for pahole, Python and GNU AWK, add the
Rust/bindgen source links, and remove the stale cpio source entry.
Signed-off-by: Doehyun Baek <doehyunbaek@gmail.com>
Cc: Federico Vaga <federico.vaga@vaga.pv.it>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Shuah Khan <skhan@linuxfoundation.org>
---
Thanks to Federico Vaga for the review and wording suggestions.
Tested with:
make SPHINXDIRS=translations/it_IT htmldocs
Note: this version focuses on keeping the "Current Minimal Requirements"
section and directly related requirements text in sync with the English file.
If a full-file sync is preferred, I can do that instead.
Changes in v5:
- Incorporate Federico's wording suggestions for pahole, Python and GNU AWK.
Changes in v4:
- Fix the malformed requirements table.
- Run the Italian documentation build.
Changes in v3:
- Sync the full current requirements table with the English version.
- Update directly related requirements text for pahole, Python and GNU AWK.
- Add Rust/bindgen source links and remove the stale cpio source entry.
Changes in v2:
- Rebase on current docs-next.
.../translations/it_IT/process/changes.rst | 118 +++++++++++-------
1 file changed, 73 insertions(+), 45 deletions(-)
diff --git a/Documentation/translations/it_IT/process/changes.rst b/Documentation/translations/it_IT/process/changes.rst
index 7ee54c972418..0be1292a87fc 100644
--- a/Documentation/translations/it_IT/process/changes.rst
+++ b/Documentation/translations/it_IT/process/changes.rst
@@ -23,50 +23,53 @@ Requisiti minimi correnti
Prima di pensare d'avere trovato un baco, aggiornate i seguenti programmi
**almeno** alla versione indicata! Se non siete certi della versione che state
-usando, il comando indicato dovrebbe dirvelo.
+usando, il comando indicato dovrebbe dirvelo. Per avere una lista dei programmi
+sul vostro sistema, incluse le rispettive versioni, eseguite
+./scripts/ver_linux.
Questa lista presume che abbiate già un kernel Linux funzionante. In aggiunta,
non tutti gli strumenti sono necessari ovunque; ovviamente, se non avete una
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
-====================== ================= ========================================
+====================== =============== ========================================
+ Programma Versione minima Comando per verificare la versione
+====================== =============== ========================================
+bash 4.2 bash --version
+bc 1.06.95 bc --version
+bindgen (opzionale) 0.71.1 bindgen --version
+binutils 2.30 ld -v
+bison 2.0 bison --version
+btrfs-progs 0.18 btrfs --version
+Clang/LLVM (opzionale) 17.0.1 clang --version
+e2fsprogs 1.41.4 e2fsck -V
+flex 2.5.35 flex --version
+gdb 7.2 gdb --version
+GNU awk (opzionale) 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 (opzionale) 6.6.5 gtags --version
+iptables 1.4.2 iptables -V
+jfsutils 1.1.3 fsck.jfs -V
+kmod 13 kmod -V
+mcelog 0.6 mcelog --version
+mkimage (opzionale) 2017.01 mkimage --version
+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 (opzionale) 1.85.0 rustc --version
+Sphinx\ [#f1]_ 3.4.3 sphinx-build --version
+squashfs-tools 4.0 mksquashfs -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
@@ -144,7 +147,13 @@ pahole
Dalla versione 5.2, quando viene impostato CONFIG_DEBUG_INFO_BTF, il sistema di
compilazione genera BTF (BPF Type Format) a partire da DWARF per vmlinux. Più
-tardi anche per i moduli. Questo richiede pahole v1.16 o successivo.
+tardi anche per i moduli. Questo richiede pahole v1.22 o successivo.
+
+Dalla versione 7.0, le kfunc annotate con KF_IMPLICIT_ARGS richiedono pahole
+v1.26 o successivo. Senza questa versione, tali kfunc avranno prototipi BTF
+errati in vmlinux, causando il fallimento del caricamento dei programmi BPF con
+l'errore "func_proto incompatible with vmlinux". Molte kfunc in sched_ext sono
+interessate da questo problema.
A seconda della distribuzione, lo si può trovare nei pacchetti 'dwarves' o
'pahole'. Oppure lo si può trovare qui: https://fedorapeople.org/~acme/dwarves/.
@@ -155,6 +164,14 @@ Perl
Per compilare il kernel vi servirà perl 5 e i seguenti moduli ``Getopt::Long``,
``Getopt::Std``, ``File::Basename``, e ``File::Find``.
+Python
+------
+
+Diverse opzioni di configurazione lo richiedono: è necessario per le
+configurazioni predefinite di arm/arm64, CONFIG_LTO_CLANG, alcune opzioni
+configurabili del DRM, lo strumento kernel-doc e la generazione della
+documentazione (Sphinx), e altro ancora.
+
BC
--
@@ -193,6 +210,12 @@ pacchetto ``u-boot-tools`` oppure può essere compilato dal codice sorgente di
U-Boot. Consultate le istruzioni
https://docs.u-boot.org/en/latest/build/tools.html#building-tools-for-linux
+GNU AWK
+-------
+
+GNU AWK è necessario se si vuole che la compilazione del kernel generi dati
+sugli intervalli di indirizzi per i moduli integrati
+(CONFIG_BUILTIN_MODULE_RANGES).
Strumenti di sistema
********************
@@ -405,6 +428,16 @@ Clang/LLVM
- :ref:`Getting LLVM <getting_llvm>`.
+Rust
+----
+
+- Documentation/rust/quick-start.rst.
+
+bindgen
+-------
+
+- Documentation/rust/quick-start.rst.
+
Make
----
@@ -507,11 +540,6 @@ mcelog
- <https://www.mcelog.org/>
-cpio
-----
-
-- <https://www.gnu.org/software/cpio/>
-
Rete
****
--
2.43.0
^ permalink raw reply related [flat|nested] 3+ messages in thread
* Re: [PATCH v5] Docs/translations/it_IT: sync changes.rst requirements
2026-07-26 6:39 [PATCH v5] Docs/translations/it_IT: sync changes.rst requirements Doehyun Baek
@ 2026-07-26 13:24 ` Federico Vaga
2026-08-03 18:31 ` Jonathan Corbet
1 sibling, 0 replies; 3+ messages in thread
From: Federico Vaga @ 2026-07-26 13:24 UTC (permalink / raw)
To: Doehyun Baek; +Cc: linux-doc, Jonathan Corbet, Shuah Khan
Hi Doehyun,
it looks good to me.
Acked-by: Federico Vaga <federico.vaga@vaga.pv.it>
On Sun, Jul 26, 2026 at 06:39:27AM +0000, Doehyun Baek wrote:
>The Italian current requirements text had fallen behind the English
>Documentation/process/changes.rst version.
>
>Sync the current requirements table and add the missing ver_linux note.
>Also update directly related text for pahole, Python and GNU AWK, add the
>Rust/bindgen source links, and remove the stale cpio source entry.
>
>Signed-off-by: Doehyun Baek <doehyunbaek@gmail.com>
>Cc: Federico Vaga <federico.vaga@vaga.pv.it>
>Cc: Jonathan Corbet <corbet@lwn.net>
>Cc: Shuah Khan <skhan@linuxfoundation.org>
>---
>Thanks to Federico Vaga for the review and wording suggestions.
>
>Tested with:
>
> make SPHINXDIRS=translations/it_IT htmldocs
>
>Note: this version focuses on keeping the "Current Minimal Requirements"
>section and directly related requirements text in sync with the English file.
>If a full-file sync is preferred, I can do that instead.
>
>Changes in v5:
>- Incorporate Federico's wording suggestions for pahole, Python and GNU AWK.
>
>Changes in v4:
>- Fix the malformed requirements table.
>- Run the Italian documentation build.
>
>Changes in v3:
>- Sync the full current requirements table with the English version.
>- Update directly related requirements text for pahole, Python and GNU AWK.
>- Add Rust/bindgen source links and remove the stale cpio source entry.
>
>Changes in v2:
>- Rebase on current docs-next.
>
> .../translations/it_IT/process/changes.rst | 118 +++++++++++-------
> 1 file changed, 73 insertions(+), 45 deletions(-)
>
>diff --git a/Documentation/translations/it_IT/process/changes.rst b/Documentation/translations/it_IT/process/changes.rst
>index 7ee54c972418..0be1292a87fc 100644
>--- a/Documentation/translations/it_IT/process/changes.rst
>+++ b/Documentation/translations/it_IT/process/changes.rst
>@@ -23,50 +23,53 @@ Requisiti minimi correnti
>
> Prima di pensare d'avere trovato un baco, aggiornate i seguenti programmi
> **almeno** alla versione indicata! Se non siete certi della versione che state
>-usando, il comando indicato dovrebbe dirvelo.
>+usando, il comando indicato dovrebbe dirvelo. Per avere una lista dei programmi
>+sul vostro sistema, incluse le rispettive versioni, eseguite
>+./scripts/ver_linux.
>
> Questa lista presume che abbiate già un kernel Linux funzionante. In aggiunta,
> non tutti gli strumenti sono necessari ovunque; ovviamente, se non avete una
> 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
>-====================== ================= ========================================
>+====================== =============== ========================================
>+ Programma Versione minima Comando per verificare la versione
>+====================== =============== ========================================
>+bash 4.2 bash --version
>+bc 1.06.95 bc --version
>+bindgen (opzionale) 0.71.1 bindgen --version
>+binutils 2.30 ld -v
>+bison 2.0 bison --version
>+btrfs-progs 0.18 btrfs --version
>+Clang/LLVM (opzionale) 17.0.1 clang --version
>+e2fsprogs 1.41.4 e2fsck -V
>+flex 2.5.35 flex --version
>+gdb 7.2 gdb --version
>+GNU awk (opzionale) 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 (opzionale) 6.6.5 gtags --version
>+iptables 1.4.2 iptables -V
>+jfsutils 1.1.3 fsck.jfs -V
>+kmod 13 kmod -V
>+mcelog 0.6 mcelog --version
>+mkimage (opzionale) 2017.01 mkimage --version
>+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 (opzionale) 1.85.0 rustc --version
>+Sphinx\ [#f1]_ 3.4.3 sphinx-build --version
>+squashfs-tools 4.0 mksquashfs -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
>
>@@ -144,7 +147,13 @@ pahole
>
> Dalla versione 5.2, quando viene impostato CONFIG_DEBUG_INFO_BTF, il sistema di
> compilazione genera BTF (BPF Type Format) a partire da DWARF per vmlinux. Più
>-tardi anche per i moduli. Questo richiede pahole v1.16 o successivo.
>+tardi anche per i moduli. Questo richiede pahole v1.22 o successivo.
>+
>+Dalla versione 7.0, le kfunc annotate con KF_IMPLICIT_ARGS richiedono pahole
>+v1.26 o successivo. Senza questa versione, tali kfunc avranno prototipi BTF
>+errati in vmlinux, causando il fallimento del caricamento dei programmi BPF con
>+l'errore "func_proto incompatible with vmlinux". Molte kfunc in sched_ext sono
>+interessate da questo problema.
>
> A seconda della distribuzione, lo si può trovare nei pacchetti 'dwarves' o
> 'pahole'. Oppure lo si può trovare qui: https://fedorapeople.org/~acme/dwarves/.
>@@ -155,6 +164,14 @@ Perl
> Per compilare il kernel vi servirà perl 5 e i seguenti moduli ``Getopt::Long``,
> ``Getopt::Std``, ``File::Basename``, e ``File::Find``.
>
>+Python
>+------
>+
>+Diverse opzioni di configurazione lo richiedono: è necessario per le
>+configurazioni predefinite di arm/arm64, CONFIG_LTO_CLANG, alcune opzioni
>+configurabili del DRM, lo strumento kernel-doc e la generazione della
>+documentazione (Sphinx), e altro ancora.
>+
> BC
> --
>
>@@ -193,6 +210,12 @@ pacchetto ``u-boot-tools`` oppure può essere compilato dal codice sorgente di
> U-Boot. Consultate le istruzioni
> https://docs.u-boot.org/en/latest/build/tools.html#building-tools-for-linux
>
>+GNU AWK
>+-------
>+
>+GNU AWK è necessario se si vuole che la compilazione del kernel generi dati
>+sugli intervalli di indirizzi per i moduli integrati
>+(CONFIG_BUILTIN_MODULE_RANGES).
>
> Strumenti di sistema
> ********************
>@@ -405,6 +428,16 @@ Clang/LLVM
>
> - :ref:`Getting LLVM <getting_llvm>`.
>
>+Rust
>+----
>+
>+- Documentation/rust/quick-start.rst.
>+
>+bindgen
>+-------
>+
>+- Documentation/rust/quick-start.rst.
>+
> Make
> ----
>
>@@ -507,11 +540,6 @@ mcelog
>
> - <https://www.mcelog.org/>
>
>-cpio
>-----
>-
>-- <https://www.gnu.org/software/cpio/>
>-
> Rete
> ****
>
>--
>2.43.0
>
>
--
Federico Vaga
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [PATCH v5] Docs/translations/it_IT: sync changes.rst requirements
2026-07-26 6:39 [PATCH v5] Docs/translations/it_IT: sync changes.rst requirements Doehyun Baek
2026-07-26 13:24 ` Federico Vaga
@ 2026-08-03 18:31 ` Jonathan Corbet
1 sibling, 0 replies; 3+ messages in thread
From: Jonathan Corbet @ 2026-08-03 18:31 UTC (permalink / raw)
To: Doehyun Baek, linux-doc; +Cc: Doehyun Baek, Federico Vaga, Shuah Khan
Doehyun Baek <doehyunbaek@gmail.com> writes:
> The Italian current requirements text had fallen behind the English
> Documentation/process/changes.rst version.
>
> Sync the current requirements table and add the missing ver_linux note.
> Also update directly related text for pahole, Python and GNU AWK, add the
> Rust/bindgen source links, and remove the stale cpio source entry.
>
> Signed-off-by: Doehyun Baek <doehyunbaek@gmail.com>
> Cc: Federico Vaga <federico.vaga@vaga.pv.it>
> Cc: Jonathan Corbet <corbet@lwn.net>
> Cc: Shuah Khan <skhan@linuxfoundation.org>
> ---
> Thanks to Federico Vaga for the review and wording suggestions.
Applied, thanks.
jon
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2026-08-03 18:31 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-07-26 6:39 [PATCH v5] Docs/translations/it_IT: sync changes.rst requirements Doehyun Baek
2026-07-26 13:24 ` Federico Vaga
2026-08-03 18:31 ` Jonathan Corbet
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox