Commit da1d9caf 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 df05c0e9 ("Documentation: Raise the minimum supported version of LLVM to 11.0.0")
commit 333b11e5 ("Documentation: Add minimum pahole version")
commit 6d6a8d6a ("docs: Update Sphinx requirements")
commit 76ae8474 ("Documentation: raise minimum supported version of GCC to 5.1")
commit 59c6a716 ("Documentation/process/maintainer-pgp-guide: Replace broken link to PGP path finder")
commit 85eafc63 ("docs: update file link location")
commit 869f496e ("docs: process: submitting-patches: Clarify the Reported-by usage")
commit 6c5ccd24 ("Remove mentions of the Trivial Patch Monkey")
commit aa9b5e0d ("Documentation/process: fix self reference")
commit b96ff02a ("Documentation/process: fix a cross reference")
commit 1f57bd42 ("docs: submitting-patches: make section about the Link: tag more explicit")
commit a9d85efb ("docs: use the lore redirector everywhere")
commit 31c9d7c8 ("Documentation/process: Add tip tree handbook")
commit 604370e1 ("Documentation/process: Add maintainer handbooks section")
commit bf33a9d4 ("docs: 5.Posting.rst: describe Fixes: and Link: tags")
commit c04639a7 ("coding-style.rst: trivial: fix location of driver model macros")
commit d5b421fe ("docs: Explain the desired position of function attributes")
commit 3577cdb2 ("docs: deprecated.rst: Clarify open-coded arithmetic with literals")
commit db67eb74 ("docs: discourage use of list tables")
commit 0e805b11 ("docs: address some text issues with css/theme support")
commit 135707d3 ("docs: allow to pass extra DOCS_CSS themes via make")
commit fe450eeb ("Documentation: in_irq() cleanup")
commit 10855b45 ("docs: fix typo in Documentation/kernel-hacking/locking.rst")
commit bc67f1c4 ("docs: futex: Fix kernel-doc references")
commit abf36fe0 ("docs: kernel-hacking: Remove inappropriate text")
commit f35cf1a5 ("Documentation: kernel-hacking: minor edits for style")
commit f35cf1a5 ("Documentation: kernel-hacking: minor edits for style")
commit 980c3799 ("Documentation: kernel-doc: Promote two chapter headings to page title")
commit e1be43d9 ("overflow: Implement size_t saturating arithmetic helpers")
commit 615f3eea ("Documentation: add note block surrounding security patch note")
commit 587d39b2 ("Documentation: add link to stable release candidate tree")
commit 555d4493 ("Documentation: update stable tree link")
commit 88d99e87 ("Documentation: update stable review cycle documentation")
commit 0c603a5c ("Documentation/process: mention patch changelog in review process")
commit 6d5aa418 ("docs: submitting-patches: Fix crossref to 'The canonical patch format'")
commit f1a69399 ("Documentation/process: use scripts/get_maintainer.pl on patches")
commit 69ef0920 ("Docs: Add cpio requirement to changes.rst")
commit 5a5866c2 ("Docs: Replace version by 'current' in changes.rst")
commit 9b5a7f4a ("x86/configs: Add x86 debugging Kconfig fragment plus docs")
commit f1a69399 ("Documentation/process: use scripts/get_maintainer.pl on patches")
commit e8c07082 ("Kbuild: move to -std=gnu11")

Signed-off-by: default avatarFederico Vaga <federico.vaga@vaga.pv.it>
Link: https://lore.kernel.org/r/20220702210820.13118-1-federico.vaga@vaga.pv.it


Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent 5a491c97

Documentation/translations/it_IT/devicetree/bindings/submitting-patches.rst

0 → 100644
+11 −0
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: GPL-2.0



.. include:: ../../disclaimer-ita.rst



:Original: Documentation/devicetree/bindings/submitting-patches.rst



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

Sottomettere patch per devicetree (DT) *binding*

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



.. note:: to be translated

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

+2 −0
Original line number Diff line number Diff line
@@ -5,6 +5,7 @@ 


.. _it_kernel_doc:



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

Scrivere i commenti in kernel-doc

=================================
@@ -469,6 +470,7 @@ Il titolo che segue ``DOC:`` funziona da intestazione all'interno del file 
sorgente, ma anche come identificatore per l'estrazione di questi commenti di

documentazione. Quindi, il titolo dev'essere unico all'interno del file.



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

Includere i commenti di tipo kernel-doc

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

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

+11 −7
Original line number Diff line number Diff line
@@ -5,8 +5,9 @@ 


.. _it_sphinxdoc:



Introduzione

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

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

Usare Sphinx per la documentazione del kernel

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



Il kernel Linux usa `Sphinx`_ per la generazione della documentazione a partire

dai file `reStructuredText`_ che si trovano nella cartella ``Documentation``.
@@ -158,6 +159,9 @@ Per poter passare ulteriori opzioni a Sphinx potete utilizzare la variabile 
make ``SPHINXOPTS``. Per esempio, se volete che Sphinx sia più verboso durante

la generazione potete usare il seguente comando ``make SPHINXOPTS=-v htmldocs``.



Potete anche personalizzare l'ouptut html passando un livello aggiuntivo

DOCS_CSS usando la rispettiva variabile d'ambiente ``DOCS_CSS``.



Potete eliminare la documentazione generata tramite il comando

``make cleandocs``.
@@ -276,11 +280,11 @@ incrociato quando questa ha una voce nell'indice. Se trovate degli usi di 
Tabelle a liste

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



Raccomandiamo l'uso delle tabelle in formato lista (*list table*). Le tabelle

in formato lista sono liste di liste. In confronto all'ASCII-art potrebbero

non apparire di facile lettura nei file in formato testo. Il loro vantaggio è

che sono facili da creare o modificare e che la differenza di una modifica è

molto più significativa perché limitata alle modifiche del contenuto.

Il formato ``list-table`` può essere utile per tutte quelle tabelle che non

possono essere facilmente scritte usando il formato ASCII-art di Sphinx. Però,

questo genere di tabelle sono illeggibili per chi legge direttamente i file di

testo. Dunque, questo formato dovrebbe essere evitato senza forti argomenti che

ne giustifichino l'uso.



La ``flat-table`` è anch'essa una lista di liste simile alle ``list-table``

ma con delle funzionalità aggiuntive:

Documentation/translations/it_IT/kernel-hacking/hacking.rst

+11 −13
Original line number Diff line number Diff line
@@ -129,8 +129,7 @@ eseguiti simultaneamente. 
.. warning::



    Il nome 'tasklet' è ingannevole: non hanno niente a che fare

    con i 'processi' ('tasks'), e probabilmente hanno più a che vedere

    con qualche pessima vodka che Alexey Kuznetsov si fece a quel tempo.

    con i 'processi' ('tasks').



Potete determinate se siete in un softirq (o tasklet) utilizzando la

macro :c:func:`in_softirq()` (``include/linux/preempt.h``).
@@ -308,7 +307,7 @@ esse copiano una quantità arbitraria di dati da e verso lo spazio utente. 
    Al contrario di:c:func:`put_user()` e :c:func:`get_user()`, queste

    funzioni ritornano la quantità di dati copiati (0 è comunque un successo).



[Sì, questa stupida interfaccia mi imbarazza. La battaglia torna in auge anno

[Sì, questa interfaccia mi imbarazza. La battaglia torna in auge anno

dopo anno. --RR]



Le funzioni potrebbero dormire implicitamente. Queste non dovrebbero mai essere
@@ -679,9 +678,8 @@ tutti sulle spine: questo riflette cambiamenti fondamentati (eg. la funzione 
non può più essere chiamata con le funzioni attive, o fa controlli aggiuntivi,

o non fa più controlli che venivano fatti in precedenza). Solitamente a questo

s'accompagna un'adeguata e completa nota sulla lista di discussone

linux-kernel; cercate negli archivi.

Solitamente eseguire una semplice sostituzione su tutto un file rendere

le cose **peggiori**.

più adatta; cercate negli archivi. Solitamente eseguire una semplice

sostituzione su tutto un file rendere le cose **peggiori**.



Inizializzazione dei campi d'una struttura

------------------------------------------
@@ -759,14 +757,14 @@ Mettere le vostre cose nel kernel 
Al fine d'avere le vostre cose in ordine per l'inclusione ufficiale, o

anche per avere patch pulite, c'è del lavoro amministrativo da fare:



-  Trovare di chi è lo stagno in cui state pisciando. Guardare in cima

-  Trovare chi è responsabile del codice che state modificando. Guardare in cima

   ai file sorgenti, all'interno del file ``MAINTAINERS``, ed alla fine

   di tutti nel file ``CREDITS``. Dovreste coordinarvi con queste persone

   per evitare di duplicare gli sforzi, o provare qualcosa che è già stato

   rigettato.



   Assicuratevi di mettere il vostro nome ed indirizzo email in cima a

   tutti i file che create o che mangeggiate significativamente. Questo è

   tutti i file che create o che maneggiate significativamente. Questo è

   il primo posto dove le persone guarderanno quando troveranno un baco,

   o quando **loro** vorranno fare una modifica.
@@ -787,12 +785,12 @@ anche per avere patch pulite, c'è del lavoro amministrativo da fare: 
   "obj-$(CONFIG_xxx) += xxx.o". La sintassi è documentata nel file

   ``Documentation/kbuild/makefiles.rst``.



-  Aggiungete voi stessi in ``CREDITS`` se avete fatto qualcosa di notevole,

   solitamente qualcosa che supera il singolo file (comunque il vostro nome

   dovrebbe essere all'inizio dei file sorgenti). ``MAINTAINERS`` significa

-  Aggiungete voi stessi in ``CREDITS`` se credete di aver fatto qualcosa di

   notevole, solitamente qualcosa che supera il singolo file (comunque il vostro

   nome dovrebbe essere all'inizio dei file sorgenti). ``MAINTAINERS`` significa

   che volete essere consultati quando vengono fatte delle modifiche ad un

   sottosistema, e quando ci sono dei bachi; questo implica molto di più

   di un semplice impegno su una parte del codice.

   sottosistema, e quando ci sono dei bachi; questo implica molto di più di un

   semplice impegno su una parte del codice.



-  Infine, non dimenticatevi di leggere

   ``Documentation/process/submitting-patches.rst``.

Documentation/translations/it_IT/kernel-hacking/locking.rst

+3 −11
Original line number Diff line number Diff line
@@ -102,16 +102,11 @@ che non esistano. 
Sincronizzazione nel kernel Linux

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



Se posso darvi un suggerimento: non dormite mai con qualcuno più pazzo di

voi. Ma se dovessi darvi un suggerimento sulla sincronizzazione:

**mantenetela semplice**.

Se dovessi darvi un suggerimento sulla sincronizzazione: **mantenetela

semplice**.



Siate riluttanti nell'introduzione di nuovi *lock*.



Abbastanza strano, quest'ultimo è l'esatto opposto del mio suggerimento

su quando **avete** dormito con qualcuno più pazzo di voi. E dovreste

pensare a prendervi un cane bello grande.



I due principali tipi di *lock* nel kernel: spinlock e mutex

------------------------------------------------------------
@@ -316,7 +311,7 @@ Pete Zaitcev ci offre il seguente riassunto: 


-  Se siete in un contesto utente (una qualsiasi chiamata di sistema)

   e volete sincronizzarvi con altri processi, usate i mutex. Potete trattenere

   il mutex e dormire (``copy_from_user*(`` o ``kmalloc(x,GFP_KERNEL)``).

   il mutex e dormire (``copy_from_user(`` o ``kmalloc(x,GFP_KERNEL)``).



-  Altrimenti (== i dati possono essere manipolati da un'interruzione) usate

   spin_lock_irqsave() e spin_unlock_irqrestore().
@@ -979,9 +974,6 @@ fallisce nel trovare quello che vuole, quindi rilascia il *lock* di lettura, 
trattiene un *lock* di scrittura ed inserisce un oggetto; questo genere di

codice presenta una corsa critica.



Se non riuscite a capire il perché, per favore state alla larga dal mio

codice.



corsa fra temporizzatori: un passatempo del kernel

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