From nobody Tue May 13 06:45:31 2025
Received: from mx.kolabnow.com (mx.kolabnow.com [212.103.80.153])
(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
(No client certificate requested)
by smtp.subspace.kernel.org (Postfix) with ESMTPS id 3E8841A0B0E;
Mon, 30 Sep 2024 20:25:00 +0000 (UTC)
Authentication-Results: smtp.subspace.kernel.org;
arc=none smtp.client-ip=212.103.80.153
ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;
t=1727727906; cv=none;
b=Rx6gwrN4/51qkZg4qPnwGhYj++oB4FI1MorVLYANH6wW1a4meNkrPdnVEnjQx9Ok7pGQ/OFKvKIlkJRFL3g4SpB5kKYuCarY4tKsXXNFm52W9zrZmwCTYGPc5AFNrSdyz50wr8vLV0Jd5Qd+ZzsbWBNsO/cQXae5O2+T7tDfMyc=
ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org;
s=arc-20240116; t=1727727906; c=relaxed/simple;
bh=4KvG/pvm8KV2DmsLZNSHUjxpibx3aeV/AHRIka868HY=;
h=From:To:Cc:Subject:Date:Message-Id:MIME-Version:Content-Type;
b=L6of8CaLF+lqMGuT4jVHnyn87fDqmBp40IOYKtlxd9Mjr3pb9My4yfBbHK604jO6Q17PdY9/EwnDHUDb1RrLjfnEWp2WoTgMdgcCqd7bedEU40Q9pnxjzENRPYGbbXmltBsmqqEVoU0rOk414iWZGme3Lu75XxN+FCdrydBuEaM=
ARC-Authentication-Results: i=1; smtp.subspace.kernel.org;
dmarc=none (p=none dis=none) header.from=vaga.pv.it;
spf=pass smtp.mailfrom=vaga.pv.it;
dkim=pass (2048-bit key) header.d=kolabnow.com header.i=@kolabnow.com
header.b=c5Qb1KN7; arc=none smtp.client-ip=212.103.80.153
Authentication-Results: smtp.subspace.kernel.org;
dmarc=none (p=none dis=none) header.from=vaga.pv.it
Authentication-Results: smtp.subspace.kernel.org;
spf=pass smtp.mailfrom=vaga.pv.it
Authentication-Results: smtp.subspace.kernel.org;
dkim=pass (2048-bit key) header.d=kolabnow.com header.i=@kolabnow.com
header.b="c5Qb1KN7"
Received: from localhost (unknown [127.0.0.1])
by mx.kolabnow.com (Postfix) with ESMTP id 0608B2E6000;
Mon, 30 Sep 2024 22:24:59 +0200 (CEST)
Authentication-Results: ext-mx-out013.mykolab.com (amavis);
dkim=pass (2048-bit key) reason="pass (just generated, assumed good)"
header.d=kolabnow.com
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kolabnow.com; h=
content-transfer-encoding:content-type:content-type:mime-version
:message-id:date:date:subject:subject:from:from:received
:received:received; s=dkim20240523; t=1727727893; x=1729542294;
bh=x6DIfVqsks6U3HyB0X3ZyFHWxI9nGPgPYR0FTKViOWo=; b=c5Qb1KN7/yeU
Le45TJivG/z9VfpN1QRCugR0vM/cbt4nQw3LO3mAYTQPJ8BTdEW1uxuu4sGESl7F
nPfdhil/D685djiROmF22h+S9bfqSfIPfBGz8Q86kKAD5nNB+VMjSsBqUPmCrkqa
LNtyUqnwJlFWm+3UwrN0oYgbYYZu7R3WIKd434JQkE2FWEe/N78cw8pUoawxowoM
vpPhdvGXWnv20oMp99L58sucRLmOy8kMdweu3lJbyWIE5oceRi31XA37HgETM0TI
zuJy51Hd6wu2espoHKVSvieiYs6Qj2YuN3HTiM/kGckY7DIGQeCUn21Ub6s/zQlt
Jghnttwq/w==
X-Virus-Scanned: amavis at mykolab.com
X-Spam-Flag: NO
X-Spam-Score: -1
X-Spam-Level:
Received: from mx.kolabnow.com ([127.0.0.1])
by localhost (ext-mx-out013.mykolab.com [127.0.0.1]) (amavis, port 10024)
with ESMTP id rYCn2UfQw2D5; Mon, 30 Sep 2024 22:24:53 +0200 (CEST)
Received: from int-mx009.mykolab.com (unknown [10.9.13.9])
by mx.kolabnow.com (Postfix) with ESMTPS id 8B57B348AD0;
Mon, 30 Sep 2024 22:24:52 +0200 (CEST)
Received: from ext-subm010.mykolab.com (unknown [10.9.6.10])
by int-mx009.mykolab.com (Postfix) with ESMTPS id B271120AA551;
Mon, 30 Sep 2024 22:24:52 +0200 (CEST)
From: Federico Vaga <federico.vaga@vaga.pv.it>
To: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org,
linux-kernel@vger.kernel.org,
Federico Vaga <federico.vaga@vaga.pv.it>
Subject: [PATCH v3] doc:it_IT: update documents in process/
Date: Mon, 30 Sep 2024 22:24:33 +0200
Message-Id: <20240930202433.37110-1-federico.vaga@vaga.pv.it>
Precedence: bulk
X-Mailing-List: linux-kernel@vger.kernel.org
List-Id: <linux-kernel.vger.kernel.org>
List-Subscribe: <mailto:linux-kernel+subscribe@vger.kernel.org>
List-Unsubscribe: <mailto:linux-kernel+unsubscribe@vger.kernel.org>
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
Update Italian translation following these changes under Documentation/proc=
ess
commit eb5ed2fae197 ("docs: submitting-patches: Advertise b4")
commit 413e775efaec ("Documentation: fix links to mailing list services")
commit 47c67ec1e8ef ("docs: submit-checklist: use subheadings")
commit 5969fbf30274 ("docs: submit-checklist: structure by category")
commit 5f99665ee8f4 ("kbuild: raise the minimum GNU Make requirement to 4.0=
")
commit 627395716cc3 ("docs: document python version used for compilation")
commit 7a23b027ec17 ("arm64: boot: Support Flat Image Tree")
commit 56f64b370612 ("rust: upgrade to Rust 1.78.0")
commit 82b8000c28b5 ("net: drop special comment style")
commit 6813216bbdba ("Documentation: coding-style: ask function-like macros=
to evaluate parameters")
commit 91031ca349ee ("docs: improve comment consistency in .muttrc example =
configuration")
commit 7fe7de7be828 ("Docs/process/email-clients: Document HacKerMaiL")
commit 9c03bc90c065 ("Documentation: process: Revert "Document suitability =
of Proton Mail for kernel development"")
commit f9a4f4a0e1f5 ("Docs: Move magic-number from process to staging")
commit 7400d25a0a5c ("Docs/process/index: Remove riscv/patch-acceptance fro=
m 'Other materi
al' section")
Signed-off-by: Federico Vaga <federico.vaga@vaga.pv.it>
---
.../{process =3D> dev-tools}/clang-format.rst | 0
.../translations/it_IT/dev-tools/index.rst | 17 ++
Documentation/translations/it_IT/index.rst | 8 +-
.../translations/it_IT/process/2.Process.rst | 6 +-
.../translations/it_IT/process/4.Coding.rst | 2 +-
.../translations/it_IT/process/changes.rst | 33 +++-
.../it_IT/process/coding-style.rst | 37 ++--
.../it_IT/process/email-clients.rst | 33 +---
.../translations/it_IT/process/howto.rst | 10 +-
.../translations/it_IT/process/index.rst | 10 --
.../it_IT/process/submit-checklist.rst | 167 +++++++++---------
.../it_IT/process/submitting-patches.rst | 23 +--
.../translations/it_IT/staging/index.rst | 13 ++
.../{process =3D> staging}/magic-number.rst | 0
14 files changed, 208 insertions(+), 151 deletions(-)
rename Documentation/translations/it_IT/{process =3D> dev-tools}/clang-for=
mat.rst (100%)
create mode 100644 Documentation/translations/it_IT/dev-tools/index.rst
create mode 100644 Documentation/translations/it_IT/staging/index.rst
rename Documentation/translations/it_IT/{process =3D> staging}/magic-numbe=
r.rst (100%)
diff --git a/Documentation/translations/it_IT/process/clang-format.rst b/Do=
cumentation/translations/it_IT/dev-tools/clang-format.rst
similarity index 100%
rename from Documentation/translations/it_IT/process/clang-format.rst
rename to Documentation/translations/it_IT/dev-tools/clang-format.rst
diff --git a/Documentation/translations/it_IT/dev-tools/index.rst b/Documen=
tation/translations/it_IT/dev-tools/index.rst
new file mode 100644
index 000000000000..3d3ed9d15ea1
--- /dev/null
+++ b/Documentation/translations/it_IT/dev-tools/index.rst
@@ -0,0 +1,17 @@
+.. include:: ../disclaimer-ita.rst
+
+:Original: Documentation/dev-tools/index.rst
+
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+Strumenti di sviluppo per il kernel
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+
+Qui raccogliamo i vari documenti riguardanti gli strumenti di sviluppo che
+possono essere usati per lavorare col kernel . Per ora, questa =C3=A8 una =
raccolta
+senza un particolare struttura; si accettano patch!
+
+.. toctree::
+ :caption: Tabella dei contenuti
+ :maxdepth: 2
+
+ clang-format
diff --git a/Documentation/translations/it_IT/index.rst b/Documentation/tra=
nslations/it_IT/index.rst
index 9220f65e30d1..afa680607750 100644
--- a/Documentation/translations/it_IT/index.rst
+++ b/Documentation/translations/it_IT/index.rst
@@ -103,9 +103,11 @@ sviluppatori del kernel.
.. toctree::
:maxdepth: 1
=20
- process/license-rules
- doc-guide/index
- kernel-hacking/index
+ Regole sulle licenze <process/license-rules>
+ Scrivere la documentazione <doc-guide/index>
+ Strumenti di sviluppo <dev-tools/index>
+ La guida all'*hacking*<kernel-hacking/index>
+
=20
Documentazione per gli utenti
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D
diff --git a/Documentation/translations/it_IT/process/2.Process.rst b/Docum=
entation/translations/it_IT/process/2.Process.rst
index 0a62c0f33faf..6262c3908665 100644
--- a/Documentation/translations/it_IT/process/2.Process.rst
+++ b/Documentation/translations/it_IT/process/2.Process.rst
@@ -424,10 +424,10 @@ o entrambi.
Molte delle liste di discussione del Kernel girano su vger.kernel.org;
l'elenco principale lo si trova sul sito:
=20
- http://vger.kernel.org/vger-lists.html
+ https://subspace.kernel.org
=20
-Esistono liste gestite altrove; un certo numero di queste sono in
-redhat.com/mailman/listinfo.
+Tuttavia, esistono liste gestite altrove; controllare il file MAINTAINERS =
per
+trovare la lista relativa ad un sottosistema specifico.
=20
La lista di discussione principale per lo sviluppo del kernel =C3=A8, ovvi=
amente,
linux-kernel. Questa lista =C3=A8 un luogo ostile dove trovarsi; i volumi=
possono
diff --git a/Documentation/translations/it_IT/process/4.Coding.rst b/Docume=
ntation/translations/it_IT/process/4.Coding.rst
index b7b9ab6df103..4ce61db34563 100644
--- a/Documentation/translations/it_IT/process/4.Coding.rst
+++ b/Documentation/translations/it_IT/process/4.Coding.rst
@@ -69,7 +69,7 @@ e per revisionare interi file per individuare errori nell=
o stile di codifica,
refusi e possibili miglioramenti. Inoltre =C3=A8 utile anche per classifi=
care gli
``#includes``, per allineare variabili/macro, per testi derivati ed altri
compiti del genere. Consultate il file
-:ref:`Documentation/translations/it_IT/process/clang-format.rst <clangform=
at>`
+:ref:`Documentation/translations/it_IT/dev-tools/clang-format.rst <clangfo=
rmat>`
per maggiori dettagli
=20
Se utilizzate un programma compatibile con EditorConfig, allora alcune
diff --git a/Documentation/translations/it_IT/process/changes.rst b/Documen=
tation/translations/it_IT/process/changes.rst
index 0bcf8423cc80..c7d05e2fff15 100644
--- a/Documentation/translations/it_IT/process/changes.rst
+++ b/Documentation/translations/it_IT/process/changes.rst
@@ -34,9 +34,9 @@ PC Card, per esempio, probabilmente non dovreste preoccup=
arvi di pcmciautils.
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D
GNU C 5.1 gcc --version
Clang/LLVM (optional) 13.0.0 clang --version
-Rust (opzionale) 1.76.0 rustc --version
+Rust (opzionale) 1.78.0 rustc --version
bindgen (opzionale) 0.65.1 bindgen --version
-GNU make 3.81 make --version
+GNU make 4.0 make --version
bash 4.2 bash --version
binutils 2.25 ld -v
flex 2.5.35 flex --version
@@ -65,6 +65,8 @@ 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
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D
=20
.. [#f1] Sphinx =C3=A8 necessario solo per produrre la documentazione del =
Kernel
@@ -88,10 +90,25 @@ potremmo rimuovere gli espedienti che abbiamo implement=
ato per farli
funzionare. Per maggiori informazioni
:ref:`Building Linux with Clang/LLVM <kbuild_llvm>`.
=20
+Rust (opzionale)
+----------------
+
+=C3=88 necessaria una versione recente del compilatore Rust.
+
+Verificate le istruzioni Documentation/rust/quick-start.rst su come soddis=
fare i
+requisiti per compilare code Rust. In particolare, la regola ``rustavailab=
le``
+nel ``Makefile`` =C3=A8 utile per verificare perch=C3=A9 gli strumenti di =
compilazione non
+vengono trovati.
+
+bindgen (opzionale)
+-------------------
+
+``bindgen`` viene usato per generare il collegamento (binding) da Rust al =
lato C del kernel. Dipende da ``libclang``.
+
Make
----
=20
-Per compilare il kernel vi servir=C3=A0 GNU make 3.81 o successivo.
+Per compilare il kernel vi servir=C3=A0 GNU make 4.0 o successivo.
=20
Bash
----
@@ -168,6 +185,16 @@ Il programma GNU GLOBAL versione 6.6.5, o successiva, =
=C3=A8 necessario quando si
vuole eseguire ``make gtags`` e generare i relativi indici. Internamente s=
i fa
uso del parametro gtags ``-C (--directory)`` che compare in questa version=
e.
=20
+mkimage
+-------
+
+Questo strumento viene usato per produrre un *Flat Image Tree* (FIT),
+tipicamente usato su sistemi ARM. Questo strumento =C3=A8 disponibile tram=
ite il
+pacchetto ``u-boot-tools`` oppure pu=C3=B2 essere compilato dal codice sor=
gente di
+U-Boot. Consultate le istruzioni
+https://docs.u-boot.org/en/latest/build/tools.html#building-tools-for-linux
+
+
Strumenti di sistema
********************
=20
diff --git a/Documentation/translations/it_IT/process/coding-style.rst b/Do=
cumentation/translations/it_IT/process/coding-style.rst
index a4b9f44081da..c0dc786b8474 100644
--- a/Documentation/translations/it_IT/process/coding-style.rst
+++ b/Documentation/translations/it_IT/process/coding-style.rst
@@ -620,18 +620,6 @@ Lo stile preferito per i commenti pi=C3=B9 lunghi (mul=
ti-riga) =C3=A8:
* with beginning and ending almost-blank lines.
*/
=20
-Per i file in net/ e in drivers/net/ lo stile preferito per i commenti
-pi=C3=B9 lunghi (multi-riga) =C3=A8 leggermente diverso.
-
-.. code-block:: c
-
- /* The preferred comment style for files in net/ and drivers/net
- * looks like this.
- *
- * It is nearly the same as the generally preferred comment style,
- * but there is no initial almost-blank line.
- */
-
=C3=88 anche importante commentare i dati, sia per i tipi base che per tipi
derivati. A questo scopo, dichiarate un dato per riga (niente virgole
per una dichiarazione multipla). Questo vi lascer=C3=A0 spazio per un pic=
colo
@@ -726,7 +714,7 @@ di stile, refusi e possibilmente anche delle migliorie.=
=C3=88 anche utile per
ordinare gli ``#include``, per allineare variabili/macro, per ridistribuire
il testo e altre cose simili.
Per maggiori dettagli, consultate il file
-:ref:`Documentation/translations/it_IT/process/clang-format.rst <it_clangf=
ormat>`.
+:ref:`Documentation/translations/it_IT/dev-tools/clang-format.rst <it_clan=
gformat>`.
=20
Se utilizzate un programma compatibile con EditorConfig, allora alcune
configurazioni basilari come l'indentazione e la fine delle righe verranno
@@ -827,6 +815,29 @@ blocco do - while:
do_this(b, c); \
} while (0)
=20
+Le macro che sembrano funzioni con parametri non usati dovrebbero essere
+sostituite da funzioni inline per evitare il problema.
+
+.. code-block:: c
+
+ static inline void fun(struct foo *foo)
+ {
+ }
+
+Per motivi storici, molti file usano ancora l'approccio "cast a (void)" per
+valutare i parametri. Tuttavia, non =C3=A8 raccomandato. Le funzioni inlin=
e risolvono
+i problemi di "espressioni con effetti avversi valutate pi=C3=B9 di una vo=
lta",
+variabili non utilizzate, e in genere per qualche motivo sono documentate
+meglio.
+
+.. code-block:: c
+
+ /*
+ * Avoid doing this whenever possible and instead opt for static
+ * inline functions
+ */
+ #define macrofun(foo) do { (void) (foo); } while (0)
+
Cose da evitare quando si usano le macro:
=20
1) le macro che hanno effetti sul flusso del codice:
diff --git a/Documentation/translations/it_IT/process/email-clients.rst b/D=
ocumentation/translations/it_IT/process/email-clients.rst
index 76ca3226c8cd..97173746d8c9 100644
--- a/Documentation/translations/it_IT/process/email-clients.rst
+++ b/Documentation/translations/it_IT/process/email-clients.rst
@@ -228,7 +228,7 @@ Mutt =C3=A8 molto personalizzabile. Qui di seguito trov=
ate la configurazione minima
per iniziare ad usare Mutt per inviare patch usando Gmail::
=20
# .muttrc
- # =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D IMAP =3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+ # =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D IMAP =3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
set imap_user =3D 'yourusername@gmail.com'
set imap_pass =3D 'yourpassword'
set spoolfile =3D imaps://imap.gmail.com/INBOX
@@ -365,27 +365,12 @@ un editor esterno.
Un altro problema =C3=A8 che Gmail usa la codifica base64 per tutti quei m=
essaggi
che contengono caratteri non ASCII. Questo include cose tipo i nomi europe=
i.
=20
-Proton Mail
-***********
+HacKerMaiL (TUI)
+****************
=20
-Il servizio Proton Mail ha una funzionalit=C3=A0 che cripta tutti i messag=
gi verso
-ogni destinatario per cui =C3=A8 possibile trovare una chiave usando il *W=
eb Key
-Directory* (WKD). Il servizio kernel.org pubblica il WKD per ogni sviluppa=
tore
-in possesso di un conto kernel.org. Di conseguenza, tutti i messaggi invia=
ti
-usando Proton Mail verso indirizzi kernel.org verranno criptati.
-
-Proton Mail non fornisce alcun meccanismo per disabilitare questa funziona=
lit=C3=A0
-perch=C3=A9 verrebbe considerato un problema per la riservatezza. Questa f=
unzionalit=C3=A0
-=C3=A8 attiva anche quando si inviano messaggi usando il Proton Mail Bridg=
e. Dunque
-tutta la posta in uscita verr=C3=A0 criptata, incluse le patch inviate con=
``git
-send-email``.
-
-I messaggi criptati sono una fonte di problemi; altri sviluppatori potrebb=
ero
-non aver configurato i loro programmi, o strumenti, per gestire messaggi
-criptati; inoltre, alcuni programmi di posta elettronica potrebbero cripta=
re le
-risposte a messaggi criptati per tutti i partecipanti alla discussione, in=
clusa
-la lista di discussione stessa.
-
-A meno che non venga introdotta una maniera per disabilitare questa
-funzionalit=C3=A0, non =C3=A8 consigliato usare Proton Mail per contribuir=
e allo sviluppo
-del kernel.
+HacKerMaiL (hkml) =C3=A8 una semplice casella pubblica per la gestione dei=
messaggi
+di posta che non richiede alcuna sottoscrizione ad una lista di discussion=
e.
+Viene sviluppato e mantenuto dal manutentore di DAMON e si pone come obiet=
tivo
+quello di gestire il processo di sviluppo semplice come quello di DAMON e =
pi=C3=B9 in
+generale i sottosistemi del kernel. Per maggiori dettagli, fate riferiment=
o al
+documento README (https://github.com/sjp38/hackermail/blob/master/README.m=
d).
diff --git a/Documentation/translations/it_IT/process/howto.rst b/Documenta=
tion/translations/it_IT/process/howto.rst
index 090941a0a898..f51288602ee3 100644
--- a/Documentation/translations/it_IT/process/howto.rst
+++ b/Documentation/translations/it_IT/process/howto.rst
@@ -344,7 +344,7 @@ principale 4.x, sar=C3=A0 necessario un test d'integraz=
ione.
A tale scopo, esiste un repositorio speciale di test nel quale virtualmente
tutti i rami dei sottosistemi vengono inclusi su base quotidiana:
=20
- https://git.kernel.org/?p=3Dlinux/kernel/git/next/linux-next.git
+ https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git
=20
In questo modo, i kernel -next offrono uno sguardo riassuntivo su quello c=
he
ci si aspetter=C3=A0 essere nel kernel principale nel successivo periodo
@@ -389,12 +389,12 @@ sviluppatori del kernel partecipano alla lista di dis=
cussione Linux Kernel.
I dettagli su come iscriversi e disiscriversi dalla lista possono essere
trovati al sito:
=20
- http://vger.kernel.org/vger-lists.html#linux-kernel
+ https://subspace.kernel.org/subscribing.html
=20
Ci sono diversi archivi della lista di discussione. Usate un qualsiasi mot=
ore
di ricerca per trovarli. Per esempio:
=20
- https://lore.kernel.org/lkml/
+ https://lore.kernel.org/linux-kernel/
=20
=C3=89 caldamente consigliata una ricerca in questi archivi sul tema che v=
olete
sollevare, prima di pubblicarlo sulla lista. Molte cose sono gi=C3=A0 state
@@ -407,13 +407,13 @@ discussione e il loro uso.
Molte di queste liste sono gestite su kernel.org. Per informazioni consult=
ate
la seguente pagina:
=20
- http://vger.kernel.org/vger-lists.html
+ https://subspace.kernel.org
=20
Per favore ricordatevi della buona educazione quando utilizzate queste lis=
te.
Sebbene sia un p=C3=B2 dozzinale, il seguente URL contiene alcune semplici=
linee
guida per interagire con la lista (o con qualsiasi altra lista):
=20
- http://www.albion.com/netiquette/
+ https://subspace.kernel.org/etiquette.html
=20
Se diverse persone rispondo alla vostra mail, la lista dei riceventi (copia
conoscenza) potrebbe diventare abbastanza lunga. Non cancellate nessuno da=
lla
diff --git a/Documentation/translations/it_IT/process/index.rst b/Documenta=
tion/translations/it_IT/process/index.rst
index c24500f74660..5a5214f5fd72 100644
--- a/Documentation/translations/it_IT/process/index.rst
+++ b/Documentation/translations/it_IT/process/index.rst
@@ -99,16 +99,6 @@ degli sviluppatori:
=20
kernel-docs
=20
-Ed infine, qui ci sono alcune guide pi=C3=B9 tecniche che son state messe =
qua solo
-perch=C3=A9 non si =C3=A8 trovato un posto migliore.
-
-.. toctree::
- :maxdepth: 1
-
- magic-number
- clang-format
- ../arch/riscv/patch-acceptance
-
.. only:: subproject and html
=20
Indices
diff --git a/Documentation/translations/it_IT/process/submit-checklist.rst =
b/Documentation/translations/it_IT/process/submit-checklist.rst
index 60ec660702fa..37bb28e8d57e 100644
--- a/Documentation/translations/it_IT/process/submit-checklist.rst
+++ b/Documentation/translations/it_IT/process/submit-checklist.rst
@@ -5,8 +5,9 @@
=20
.. _it_submitchecklist:
=20
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D
Lista delle verifiche da fare prima di inviare una patch per il kernel Lin=
ux
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~=
~~
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D
=20
Qui troverete una lista di cose che uno sviluppatore dovrebbe fare per
vedere le proprie patch accettate pi=C3=B9 rapidamente.
@@ -15,118 +16,126 @@ Tutti questi punti integrano la documentazione fornit=
a riguardo alla
sottomissione delle patch, in particolare
:ref:`Documentation/translations/it_IT/process/submitting-patches.rst <it_=
submittingpatches>`.
=20
+Revisiona il tuo codice
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+
1) Se state usando delle funzionalit=C3=A0 del kernel allora includete (#i=
nclude)
i file che le dichiarano/definiscono. Non dipendente dal fatto che un =
file
d'intestazione include anche quelli usati da voi.
=20
-2) Compilazione pulita:
-
- a) con le opzioni ``CONFIG`` negli stati ``=3Dy``, ``=3Dm`` e ``=3Dn``. =
Nessun
- avviso/errore di ``gcc`` e nessun avviso/errore dal linker.
-
- b) con ``allnoconfig``, ``allmodconfig``
-
- c) quando si usa ``O=3Dbuilddir``
-
- d) Qualsiasi modifica in Documentation/ deve compilare con successo senza
- avvisi o errori. Usare ``make htmldocs`` o ``make pdfdocs`` per verif=
icare
- e correggere i problemi
-
-3) Compilare per diverse architetture di processore usando strumenti per
- la cross-compilazione o altri.
+2) Controllate lo stile del codice della vostra patch secondo le direttive
+ scritte in :ref:`Documentation/translations/it_IT/process/coding-style.=
rst <it_codingstyle>`.
=20
-4) Una buona architettura per la verifica della cross-compilazione =C3=A8 =
la ppc64
- perch=C3=A9 tende ad usare ``unsigned long`` per le quantit=C3=A0 a 64-=
bit.
+3) Tutte le barriere di sincronizzazione {per esempio, ``barrier()``,
+ ``rmb()``, ``wmb()``} devono essere accompagnate da un commento nei
+ sorgenti che ne spieghi la logica: cosa fanno e perch=C3=A9.
=20
-5) Controllate lo stile del codice della vostra patch secondo le direttive
- scritte in :ref:`Documentation/translations/it_IT/process/coding-style.=
rst <it_codingstyle>`.
- Prima dell'invio della patch, usate il verificatore di stile
- (``script/checkpatch.pl``) per scovare le violazioni pi=C3=B9 semplici.
- Dovreste essere in grado di giustificare tutte le violazioni rimanenti =
nella
- vostra patch.
+Revisionate i cambiamenti a Kconfig
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
=20
-6) Le opzioni ``CONFIG``, nuove o modificate, non scombussolano il menu
+1) Le opzioni ``CONFIG``, nuove o modificate, non scombussolano il menu
di configurazione e sono preimpostate come disabilitate a meno che non
soddisfino i criteri descritti in ``Documentation/kbuild/kconfig-langua=
ge.rst``
alla punto "Voci di menu: valori predefiniti".
=20
-7) Tutte le nuove opzioni ``Kconfig`` hanno un messaggio di aiuto.
+2) Tutte le nuove opzioni ``Kconfig`` hanno un messaggio di aiuto.
=20
-8) La patch =C3=A8 stata accuratamente revisionata rispetto alle pi=C3=B9 =
importanti
+3) La patch =C3=A8 stata accuratamente revisionata rispetto alle pi=C3=B9 =
importanti
configurazioni ``Kconfig``. Questo =C3=A8 molto difficile da fare
correttamente - un buono lavoro di testa sar=C3=A0 utile.
=20
-9) Verificare con sparse.
+Fornite documentazione
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
=20
-10) Usare ``make checkstack`` e correggere tutti i problemi rilevati.
+1) Includete :ref:`kernel-doc <kernel_doc>` per documentare API globali del
+ kernel.
=20
- .. note::
+2) Tutti i nuovi elementi in ``/proc`` sono documentati in ``Documentation=
/``.
=20
- ``checkstack`` non evidenzia esplicitamente i problemi, ma una funz=
ione
- che usa pi=C3=B9 di 512 byte sullo stack =C3=A8 una buona candidata=
per una
- correzione.
+3) Tutti i nuovi parametri d'avvio del kernel sono documentati in
+ ``Documentation/admin-guide/kernel-parameters.rst``.
=20
-11) Includete commenti :ref:`kernel-doc <kernel_doc>` per documentare API
- globali del kernel. Usate ``make htmldocs`` o ``make pdfdocs`` per
- verificare i commenti :ref:`kernel-doc <kernel_doc>` ed eventualmente
- correggerli.
+4) Tutti i nuovi parametri dei moduli sono documentati con ``MODULE_PARM_D=
ESC()``.
=20
-12) La patch =C3=A8 stata verificata con le seguenti opzioni abilitate
- contemporaneamente: ``CONFIG_PREEMPT``, ``CONFIG_DEBUG_PREEMPT``,
- ``CONFIG_DEBUG_SLAB``, ``CONFIG_DEBUG_PAGEALLOC``, ``CONFIG_DEBUG_MUTE=
XES``,
- ``CONFIG_DEBUG_SPINLOCK``, ``CONFIG_DEBUG_ATOMIC_SLEEP``,
- ``CONFIG_PROVE_RCU`` e ``CONFIG_DEBUG_OBJECTS_RCU_HEAD``.
+5) Tutte le nuove interfacce verso lo spazio utente sono documentate in
+ ``Documentation/ABI/``. Leggete ``Documentation/ABI/README`` per magg=
iori
+ informazioni. Le patch che modificano le interfacce utente dovrebbero
+ essere inviate in copia anche a linux-api@vger.kernel.org.
=20
-13) La patch =C3=A8 stata compilata e verificata in esecuzione con, e senz=
a,
- le opzioni ``CONFIG_SMP`` e ``CONFIG_PREEMPT``.
+6) Se la patch aggiunge nuove chiamate ioctl, allora aggiornate
+ ``Documentation/userspace-api/ioctl/ioctl-number.rst``.
=20
-14) Se la patch ha effetti sull'IO dei dischi, eccetera: allora dev'essere
- verificata con, e senza, l'opzione ``CONFIG_LBDAF``.
+Verificate il vostro codice con gli strumenti
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
=20
-15) Tutti i percorsi del codice sono stati verificati con tutte le funzion=
alit=C3=A0
- di lockdep abilitate.
+1) Prima dell'invio della patch, usate il verificatore di stile
+ (``script/checkpatch.pl``) per scovare le violazioni pi=C3=B9 semplici.
+ Dovreste essere in grado di giustificare tutte le violazioni rimanenti =
nella
+ vostra patch.
=20
-16) Tutti i nuovi elementi in ``/proc`` sono documentati in ``Documentatio=
n/``.
+2) Verificare il codice con sparse.
=20
-17) Tutti i nuovi parametri d'avvio del kernel sono documentati in
- ``Documentation/admin-guide/kernel-parameters.rst``.
=20
-18) Tutti i nuovi parametri dei moduli sono documentati con ``MODULE_PARM_=
DESC()``.
+3) Usare ``make checkstack`` e correggere tutti i problemi rilevati. Da no=
tare
+ che ``checkstack`` non evidenzia esplicitamente i problemi, ma una funz=
ione
+ che usa pi=C3=B9 di 512 byte sullo stack =C3=A8 una buona candidata per=
una correzione.
=20
-19) Tutte le nuove interfacce verso lo spazio utente sono documentate in
- ``Documentation/ABI/``. Leggete ``Documentation/ABI/README`` per magg=
iori
- informazioni. Le patch che modificano le interfacce utente dovrebbero
- essere inviate in copia anche a linux-api@vger.kernel.org.
+Compilare il codice
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+
+1) Compilazione pulita:
+
+ a) con le opzioni ``CONFIG`` negli stati ``=3Dy``, ``=3Dm`` e ``=3Dn``. =
Nessun
+ avviso/errore di ``gcc`` e nessun avviso/errore dal linker.
=20
-20) La patch =C3=A8 stata verificata con l'iniezione di fallimenti in slab=
e
- nell'allocazione di pagine. Vedere ``Documentation/dev-tools/fault-in=
jection/``.
+ b) con ``allnoconfig``, ``allmodconfig``
+
+ c) quando si usa ``O=3Dbuilddir``
=20
- Se il nuovo codice =C3=A8 corposo, potrebbe essere opportuno aggiungere
- l'iniezione di fallimenti specifici per il sottosistema.
+ d) Qualsiasi modifica in Documentation/ deve compilare con successo senza
+ avvisi o errori. Usare ``make htmldocs`` o ``make pdfdocs`` per verif=
icare
+ e correggere i problemi
=20
-21) Il nuovo codice =C3=A8 stato compilato con ``gcc -W`` (usate
+2) Compilare per diverse architetture di processore usando strumenti per la
+ cross-compilazione o altri. Una buona architettura per la verifica della
+ cross-compilazione =C3=A8 la ppc64 perch=C3=A9 tende ad usare ``unsigne=
d long`` per le
+ quantit=C3=A0 a 64-bit.
+
+3) Il nuovo codice =C3=A8 stato compilato con ``gcc -W`` (usate
``make KCFLAGS=3D-W``). Questo generer=C3=A0 molti avvisi, ma =C3=A8 =
ottimo
per scovare bachi come "warning: comparison between signed and unsign=
ed".
=20
-22) La patch =C3=A8 stata verificata dopo essere stata inclusa nella serie=
di patch
- -mm; questo al fine di assicurarsi che continui a funzionare assieme a
- tutte le altre patch in coda e i vari cambiamenti nei sottosistemi VM,=
VFS
- e altri.
+4) Se il codice che avete modificato dipende o usa una qualsiasi interfacc=
ia o
+ funzionalit=C3=A0 del kernel che =C3=A8 associata a uno dei seguenti si=
mboli
+ ``Kconfig``, allora verificate che il kernel compili con diverse
+ configurazioni dove i simboli sono disabilitati e/o ``=3Dm`` (se c'=C3=
=A8 la
+ possibilit=C3=A0) [non tutti contemporaneamente, solo diverse combinazi=
oni
+ casuali]:
=20
-23) Tutte le barriere di sincronizzazione {per esempio, ``barrier()``,
- ``rmb()``, ``wmb()``} devono essere accompagnate da un commento nei
- sorgenti che ne spieghi la logica: cosa fanno e perch=C3=A9.
+ ``CONFIG_SMP``, ``CONFIG_SYSFS``, ``CONFIG_PROC_FS``, ``CONFIG_INPUT``,
+ ``CONFIG_PCI``, ``CONFIG_BLOCK``, ``CONFIG_PM``, ``CONFIG_MAGIC_SYSRQ``,
+ ``CONFIG_NET``, ``CONFIG_INET=3Dn`` (ma l'ultimo con ``CONFIG_NET=3Dy``=
).
=20
-24) Se la patch aggiunge nuove chiamate ioctl, allora aggiornate
- ``Documentation/userspace-api/ioctl/ioctl-number.rst``.
+Verificate il vostro codice
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D
+
+1) La patch =C3=A8 stata verificata con le seguenti opzioni abilitate
+ contemporaneamente: ``CONFIG_PREEMPT``, ``CONFIG_DEBUG_PREEMPT``,
+ ``CONFIG_DEBUG_SLAB``, ``CONFIG_DEBUG_PAGEALLOC``, ``CONFIG_DEBUG_MUTEX=
ES``,
+ ``CONFIG_DEBUG_SPINLOCK``, ``CONFIG_DEBUG_ATOMIC_SLEEP``,
+ ``CONFIG_PROVE_RCU`` e ``CONFIG_DEBUG_OBJECTS_RCU_HEAD``.
+
+2) La patch =C3=A8 stata compilata e verificata in esecuzione con, e senza,
+ le opzioni ``CONFIG_SMP`` e ``CONFIG_PREEMPT``.
+
+3) Tutti i percorsi del codice sono stati verificati con tutte le funziona=
lit=C3=A0
+ di lockdep abilitate.
=20
-25) Se il codice che avete modificato dipende o usa una qualsiasi interfac=
cia o
- funzionalit=C3=A0 del kernel che =C3=A8 associata a uno dei seguenti s=
imboli
- ``Kconfig``, allora verificate che il kernel compili con diverse
- configurazioni dove i simboli sono disabilitati e/o ``=3Dm`` (se c'=C3=
=A8 la
- possibilit=C3=A0) [non tutti contemporaneamente, solo diverse combinaz=
ioni
- casuali]:
+4) La patch =C3=A8 stata verificata con l'iniezione di fallimenti in slab e
+ nell'allocazione di pagine. Vedere ``Documentation/dev-tools/fault-inje=
ction/``.
+ Se il nuovo codice =C3=A8 corposo, potrebbe essere opportuno aggiungere
+ l'iniezione di fallimenti specifici per il sottosistema.
=20
- ``CONFIG_SMP``, ``CONFIG_SYSFS``, ``CONFIG_PROC_FS``, ``CONFIG_INPUT``,
- ``CONFIG_PCI``, ``CONFIG_BLOCK``, ``CONFIG_PM``, ``CONFIG_MAGIC_SYSRQ`=
`,
- ``CONFIG_NET``, ``CONFIG_INET=3Dn`` (ma l'ultimo con ``CONFIG_NET=3Dy`=
`).
+5) La patch =C3=A8 stata verificata sul tag pi=C3=B9 recente di linux-next=
per assicurarsi
+ che funzioni assieme a tutte le altre patch in coda, assieme ai vari
+ cambiamenti nei sottosistemi VM, VFS e altri.
diff --git a/Documentation/translations/it_IT/process/submitting-patches.rs=
t b/Documentation/translations/it_IT/process/submitting-patches.rst
index a7252e73937a..1cc4808139ce 100644
--- a/Documentation/translations/it_IT/process/submitting-patches.rst
+++ b/Documentation/translations/it_IT/process/submitting-patches.rst
@@ -137,10 +137,10 @@ questione.
=20
Quando volete fare riferimento ad una lista di discussione, preferite il
servizio d'archiviazione lore.kernel.org. Per create un collegamento URL =
=C3=A8
-sufficiente usare il campo ``Message-Id``, presente nell'intestazione del
+sufficiente usare il campo ``Message-ID``, presente nell'intestazione del
messaggio, senza parentesi angolari. Per esempio::
=20
- Link: https://lore.kernel.org/r/30th.anniversary.repost@klaava.Helsin=
ki.FI/
+ Link: https://lore.kernel.org/30th.anniversary.repost@klaava.Helsinki=
.FI
=20
Prima d'inviare il messaggio ricordatevi di verificare che il collegamento=
cos=C3=AC
creato funzioni e che indirizzi verso il messaggio desiderato.
@@ -275,11 +275,9 @@ patch ricever=C3=A0 molta pi=C3=B9 attenzione. Tuttavi=
a, per favore, non spammate le lis
di discussione che non sono interessate al vostro lavoro.
=20
Molte delle liste di discussione relative al kernel vengono ospitate su
-vger.kernel.org; potete trovare un loro elenco alla pagina
-http://vger.kernel.org/vger-lists.html. Tuttavia, ci sono altre liste di
-discussione ospitate altrove.
-
-Non inviate pi=C3=B9 di 15 patch alla volta sulle liste di discussione vge=
r!!!
+kernel.org; potete trovare un loro elenco alla pagina
+https://subspace.kernel.org. Tuttavia, ci sono altre liste di discussione
+ospitate altrove.
=20
L'ultimo giudizio sull'integrazione delle modifiche accettate spetta a
Linux Torvalds. Il suo indirizzo e-mail =C3=A8 <torvalds@linux-foundation=
.org>.
@@ -891,6 +889,14 @@ Assicuratevi che il commit si basi su sorgenti ufficia=
li del
manutentore/mainline e non su sorgenti interni, accessibile solo a voi,
altrimenti sarebbe inutile.
=20
+Strumenti
+---------
+
+Molti degli aspetti pi=C3=B9 tecnici di questo processo possono essere aut=
omatizzati
+usando b4, la cui documentazione =C3=A8 disponibile all'indirizzo
+<https://b4.docs.kernel.org/en/latest/>. Pu=C3=B2 aiutare a tracciare la d=
ipendenze,
+eseguire checkpatch e con la formattazione e l'invio di messaggi di posta.
+
Riferimenti
-----------
=20
@@ -913,9 +919,6 @@ Greg Kroah-Hartman, "Come scocciare un manutentore di u=
n sottosistema"
=20
<http://www.kroah.com/log/linux/maintainer-06.html>
=20
-No!!!! Basta gigantesche bombe patch alle persone sulla lista linux-kernel=
@vger.kernel.org!
- <https://lore.kernel.org/r/20050711.125305.08322243.davem@davemloft.net>
-
Kernel Documentation/translations/it_IT/process/coding-style.rst.
=20
E-mail di Linus Torvalds sul formato canonico di una patch:
diff --git a/Documentation/translations/it_IT/staging/index.rst b/Documenta=
tion/translations/it_IT/staging/index.rst
new file mode 100644
index 000000000000..6b56707f3a3a
--- /dev/null
+++ b/Documentation/translations/it_IT/staging/index.rst
@@ -0,0 +1,13 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-ita.rst
+
+:Original: :ref:`Documentation/staging/index.rst <process_index>`
+
+Documenti in ordine sparso
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D
+
+.. toctree::
+ :maxdepth: 2
+
+ magic-number
diff --git a/Documentation/translations/it_IT/process/magic-number.rst b/Do=
cumentation/translations/it_IT/staging/magic-number.rst
similarity index 100%
rename from Documentation/translations/it_IT/process/magic-number.rst
rename to Documentation/translations/it_IT/staging/magic-number.rst
--=20
2.39.5