Commit dfce05c8 authored by Federico Vaga's avatar Federico Vaga Committed by Jonathan Corbet
Browse files

doc:it_IT: align Italian documentation 



Translation for the following patches

commit 6e55b1cb ("docs: try to encourage (netdev?) reviewers")
commit e49ad853 ("CREDITS, MAINTAINERS, docs/process/howto: Update man-pages' maintainer")
commit 44ac5aba ("Documentation/security-bugs: move from admin-guide/ to process/")
commit 5a602de9 ("Add .editorconfig file for basic formatting")
commit 129027b7 ("docs: deprecated.rst: Update an example")
commit efc0a7cf ("Docs/process/changes: Consolidate NFS-utils update links")
commit 383f3088 ("Docs/process/changes: Replace http:// with https://")
commit 80fe9e51 ("rust: upgrade to Rust 1.74.1")
commit c584476d ("doc: Add tar requirement to changes.rst")
commit b230235b ("docs: Set minimal gtags / GNU GLOBAL version to 6.6.5")
commit 3e893e16 ("docs: Raise the minimum Sphinx requirement to 2.4.4")
commit 08ab7865 ("rust: bindgen: upgrade to 0.65.1")
commit 185ea767 ("Documentation: coding-style: Update syntax highlighting for code-blocks")
commit 932be49b ("Documentation: coding-style: Fix indentation in code-blocks")
commit 5c7944ca ("coding-style: Add guidance to prefer dev_dbg")
commit c15ec3d1 ("Documentation: doc-guide: use '%' constant indicator in Return: examples")
commit 329ac9af ("docs: submitting-patches: Discuss interleaved replies")
commit 53827745 ("(docs-next) A reworked process/index.rst")

Signed-off-by: default avatarFederico Vaga <federico.vaga@vaga.pv.it>
Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
Link: https://lore.kernel.org/r/20240316225400.22590-1-federico.vaga@vaga.pv.it
parent e171c7ce

Documentation/translations/it_IT/doc-guide/kernel-doc.rst

+5 −5
Original line number Diff line number Diff line
@@ -180,9 +180,9 @@ Il valore di ritorno, se c'è, viene descritto in una sezione dedicata di nome 
     se provate a formattare bene il vostro testo come nel seguente esempio::



	* Return:

	* 0 - OK

	* -EINVAL - invalid argument

	* -ENOMEM - out of memory

	* %0 - OK

	* %-EINVAL - invalid argument

	* %-ENOMEM - out of memory



     le righe verranno unite e il risultato sarà::
@@ -192,8 +192,8 @@ Il valore di ritorno, se c'è, viene descritto in una sezione dedicata di nome 
     utilizzare una lista ReST, ad esempio::



      * Return:

      * * 0		- OK to runtime suspend the device

      * * -EBUSY	- Device should not be runtime suspended

      * * %0		- OK to runtime suspend the device

      * * %-EBUSY	- Device should not be runtime suspended



  #) Se il vostro testo ha delle righe che iniziano con una frase seguita dai

     due punti, allora ognuna di queste frasi verrà considerata come il nome

Documentation/translations/it_IT/process/2.Process.rst

+6 −3
Original line number Diff line number Diff line
@@ -462,9 +462,12 @@ linux-kernel: 
  di far domande.  Molti sviluppatori possono divenire impazienti con le

  persone che chiaramente non hanno svolto i propri compiti a casa.



- Evitate il *top-posting* (cioè la pratica di mettere la vostra risposta sopra

  alla frase alla quale state rispondendo).  Ciò renderebbe la vostra risposta

  difficile da leggere e genera scarsa impressione.

- Rispondete sotto alla porzione di righe citate, così da dare un contesto alle

  vostre risposte, e quindi renderle più leggibili (in altre parole, evitate di

  rispondere in cima, ovvero prima del testo citato). Per maggiori dettagli

  leggete :ref:`Documentation/translations/it_IT/process/submitting-patches.rst

  <it_interleaved_replies>`.





- Chiedete nella lista di discussione corretta.  Linux-kernel può essere un

  punto di incontro generale, ma non è il miglior posto dove trovare

Documentation/translations/it_IT/process/4.Coding.rst

+4 −0
Original line number Diff line number Diff line
@@ -72,6 +72,10 @@ compiti del genere. Consultate il file 
:ref:`Documentation/translations/it_IT/process/clang-format.rst <clangformat>`

per maggiori dettagli



Se utilizzate un programma compatibile con EditorConfig, allora alcune

configurazioni basilari come l'indentazione e la fine delle righe verranno

applicate automaticamente. Per maggiori informazioni consultate la pagina:

https://editorconfig.org/



Livelli di astrazione

*********************

Documentation/translations/it_IT/process/7.AdvancedTopics.rst

+19 −0
Original line number Diff line number Diff line
@@ -160,6 +160,8 @@ preparerà una richiesta nel modo in cui gli altri sviluppatori se l'aspettano, 
e verificherà che vi siate ricordati di pubblicare quelle patch su un

server pubblico.



.. _development_advancedtopics_reviews_it:



Revisionare le patch

--------------------
@@ -180,6 +182,13 @@ i commenti come domande e non come critiche. Chiedere "Come viene rilasciato 
il *lock* in questo percorso?" funziona sempre molto meglio che

"qui la sincronizzazione è sbagliata".



In caso di disaccordi, può essere utile chiedere una terza opinione. Se dopo

pochi scambi la discussione raggiunge un punto morto, allora chiedete ai

manutentori o altri revisori di partecipare esprimendo la loro opinione. Spesso

vige un silenzio assenso per cui gli altri revisori non intervengono se non gli

viene richiesto esplicitamente. L'opinione di più persone avrà sicuramente un

peso maggiore.



Diversi sviluppatori revisioneranno il codice con diversi punti di vista.

Alcuni potrebbero concentrarsi principalmente sullo stile del codice e se

alcune linee hanno degli spazio bianchi di troppo.  Altri si chiederanno
@@ -189,3 +198,13 @@ l'uso eccessivo di *stack*, problemi di sicurezza, duplicazione del codice 
in altri contesti, documentazione, effetti negativi sulle prestazioni, cambi

all'ABI dello spazio utente, eccetera.  Qualunque tipo di revisione è ben

accetta e di valore, se porta ad avere un codice migliore nel kernel.



Non esistono requisiti particolarmente stringenti per l'uso di etichette come

``Reviewd-by``. Tuttavia, perché la revisione sia efficace ci si aspetta un

qualche tipo di messaggio che dica "ho verificato A, B e C nel codice che è

appena stato inviato e mi sembra tutto in ordine". Inoltre, questo permette ai

manutentori di prendere conoscenza circa una revisione avvenuta per davvero.



Per finire, la revisione delle patch può diventare un processo negativo, troppo

focalizzato sulla ricerca dei problemi. Provate a fare qualche complimento di

tanto in tanto, specialmente con i nuovi arrivati.

Documentation/translations/it_IT/process/changes.rst

+24 −12
Original line number Diff line number Diff line
@@ -34,13 +34,15 @@ PC Card, per esempio, probabilmente non dovreste preoccuparvi di pcmciautils. 
====================== =================  ========================================

GNU C                  5.1                gcc --version

Clang/LLVM (optional)  11.0.0             clang --version

Rust (opzionale)       1.74.1             rustc --version

bindgen (opzionale)    0.65.1             bindgen --version

GNU make               3.81               make --version

bash                   4.2                bash --version

binutils               2.25               ld -v

flex                   2.5.35             flex --version

bison                  2.0                bison --version

pahole                 1.16               pahole --version

util-linux             2.10o              fdformat --version

util-linux             2.10o              mount --version

kmod                   13                 depmod -V

e2fsprogs              1.41.4             e2fsck -V

jfsutils               1.1.3              fsck.jfs -V
@@ -59,8 +61,10 @@ 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]_         1.7                sphinx-build --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

====================== =================  ========================================



.. [#f1] Sphinx è necessario solo per produrre la documentazione del Kernel
@@ -151,6 +155,18 @@ Se la firma dei moduli è abilitata, allora vi servirà openssl per compilare il 
kernel 3.7 e successivi.  Vi serviranno anche i pacchetti di sviluppo di

openssl per compilare il kernel 4.3 o successivi.



Tar

---



GNU Tar è necessario per accedere ai file d'intestazione del kernel usando sysfs

(CONFIG_IKHEADERS)



gtags / GNU GLOBAL (opzionale)

------------------------------



Il programma GNU GLOBAL versione 6.6.5, o successiva, è necessario quando si

vuole eseguire ``make gtags`` e generare i relativi indici. Internamente si fa

uso del parametro gtags ``-C (--directory)`` che compare in questa versione.



Strumenti di sistema

********************
@@ -434,7 +450,7 @@ E2fsprogs 
JFSutils

--------



- <http://jfs.sourceforge.net/>

- <https://jfs.sourceforge.net/>



Reiserfsprogs

-------------
@@ -455,7 +471,7 @@ Pcmciautils 
Quota-tools

-----------



- <http://sourceforge.net/projects/linuxquota/>

- <https://sourceforge.net/projects/linuxquota/>





Microcodice Intel P6
@@ -476,7 +492,7 @@ FUSE 
mcelog

------



- <http://www.mcelog.org/>

- <https://www.mcelog.org/>



cpio

----
@@ -497,7 +513,8 @@ PPP 
NFS-utils

---------



- <http://sourceforge.net/project/showfiles.php?group_id=14>

- <https://sourceforge.net/project/showfiles.php?group_id=14>

- <https://nfs.sourceforge.net/>



Iptables

--------
@@ -512,12 +529,7 @@ Ip-route2 
OProfile

--------



- <http://oprofile.sf.net/download/>



NFS-Utils

---------



- <http://nfs.sourceforge.net/>

- <https://oprofile.sf.net/download/>



Documentazione del kernel

*************************