Commit 511aaf2b 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 7dfbea4c ("scripts: remove namespace.pl")
commit 1a63f9cc ("docs: Remove make headers_check from checklist")
commit 1e013ff7 ("docs: Document cross-referencing using relative path")
commit 0be1511f ("Documentation: doc-guide: fixes to sphinx.rst")
commit 91135840 ("kernel-doc: Fix example in Nested structs/unions")
commit 875f82cb ("Documentation/submitting-patches: Extend commit message layout description")
commit 78f101a1 ("Documentation/submitting-patches: Add blurb about backtraces in commit messages")
commit f0ea149e ("docs: submitting-patches: Emphasise the requirement to Cc: stable when using Fixes: tag")
commit 05a5f51c ("Documentation: Replace lkml.org links with lore")
commit 9bf19b78 ("Documentation/submitting-patches: Document the SoB chain")
commit b7592e5b ("docs: Remove the Microsoft rhetoric")
commit 26606ce0 ("coding-style.rst: Avoid comma statements")
commit dd58e649 ("docs: Make syscalls' helpers naming consistent")
commit 460cd17e ("net: switch to the kernel.org patchwork instance")
commit 163ba35f ("doc: use KCFLAGS instead of EXTRA_CFLAGS to pass flags from command line")
commit 0ef597c3 ("docs: remove mention of ENABLE_MUST_CHECK")
commit f8408264 ("drivers: Remove CONFIG_OPROFILE support")
commit 0653c358 ("scsi: Drop gdth driver")
commit f8ae7bbe ("net: x25_asy: Delete the x25_asy driver")
commit cf6d6fc2 ("docs: process/howto.rst: make sections on bug reporting match practice")
commit da514157 ("docs: make reporting-bugs.rst obsolete")
commit 4f8af077 ("docs: Fix reST markup when linking to sections")
commit 3a4928cf ("Documentation: kernel-hacking: change 'current()' to 'current'")
commit c170f2eb ("docs: Document cross-referencing between documentation pages")

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


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

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

+28 −19
Original line number Diff line number Diff line
@@ -330,17 +330,17 @@ la lista di celle che compongono la *riga* stessa. Fanno eccezione i *commenti* 
        - head col 3

        - head col 4



      * - column 1

      * - row 1

        - field 1.1

        - field 1.2 with autospan



      * - column 2

      * - row 2

        - field 2.1

        - :rspan:`1` :cspan:`1` field 2.2 - 3.3



      * .. _`it last row`:



        - column 3

        - row 3



Che verrà rappresentata nel seguente modo:
@@ -352,37 +352,46 @@ Che verrà rappresentata nel seguente modo: 
        - head col 3

        - head col 4



      * - column 1

      * - row 1

        - field 1.1

        - field 1.2 with autospan



      * - column 2

      * - row 2

        - field 2.1

        - :rspan:`1` :cspan:`1` field 2.2 - 3.3



      * .. _`it last row`:



        - column 3

        - row 3



Riferimenti incrociati

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



Per fare dei riferimenti incrociati da una pagina ad un'altra

specificando il percorso a partire dalla cartella *Documentation*.

Per esempio, se volete aggiungere un riferimento a questa pagina

(l'estensione .rst è opzionale)::

Aggiungere un riferimento incrociato da una pagina della

documentazione ad un'altra può essere fatto scrivendo il percorso al

file corrispondende, non serve alcuna sintassi speciale. Si possono

usare sia percorsi assoluti che relativi. Quelli assoluti iniziano con

"documentation/". Per esempio, potete fare riferimento a questo

documento in uno dei seguenti modi (da notare che l'estensione

``.rst`` è necessaria)::



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

    Vedere Documentation/doc-guide/sphinx.rst. Questo funziona sempre

    Guardate pshinx.rst, che si trova nella stessa cartella.

    Leggete ../sphinx.rst, che si trova nella cartella precedente.



Se preferite usare un percorso relative allora vi serve la direttiva

Sphinx ``doc``.  Per esempio, se volete aggiungere un riferimento a

questa pagina dalla stessa cartella::

Se volete che il collegamento abbia un testo diverso rispetto al

titolo del documento, allora dovrete usare la direttiva Sphinx

``doc``. Per esempio::



    See :doc:`sphinx`.

    Vedere :doc:`il mio testo per il collegamento <sphinx>`.



Per maggiori informazioni su come aggiungere riferimenti incrociati a

commenti kernel-doc di funzioni o tipi, leggete

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

Nella maggioranza dei casi si consiglia il primo metodo perché è più

pulito ed adatto a chi legge dai sorgenti. Se incontrare un ``:doc:``

che non da alcun valore, sentitevi liberi di convertirlo in un

percorso al documento.



Per informazioni riguardo ai riferimenti incrociati ai commenti

kernel-doc per funzioni o tipi, consultate



.. _it_sphinx_kfigure:
@@ -391,7 +400,7 @@ Figure ed immagini 


Se volete aggiungere un'immagine, utilizzate le direttive ``kernel-figure``

e ``kernel-image``. Per esempio, per inserire una figura di un'immagine in

formato SVG::

formato SVG (:ref:`it_svg_image_example`)::



    .. kernel-figure::  ../../../doc-guide/svg_image.svg

       :alt:    una semplice immagine SVG

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

+1 −1
Original line number Diff line number Diff line
@@ -369,7 +369,7 @@ all'inizio dell'avvio del sistema è attraverso la procedura 
Prima di inventare la vostra cache per gli oggetti più usati, considerate

l'uso di una cache slab disponibile in ``include/linux/slab.h``.



:c:func:`current()`

:c:macro:`current`

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



Definita in ``include/asm/current.h``

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

+4 −8
Original line number Diff line number Diff line
@@ -127,11 +127,11 @@ il vostro processo si auto-sospenderà; verrà riattivato quando il mutex 
verrà rilasciato. Questo significa che il processore potrà occuparsi d'altro

mentre il vostro processo è in attesa. Esistono molti casi in cui non potete

permettervi di sospendere un processo (vedere

:ref:`Quali funzioni possono essere chiamate in modo sicuro dalle interruzioni? <it_sleeping-things>`)

`Quali funzioni possono essere chiamate in modo sicuro dalle interruzioni?`_)

e quindi dovrete utilizzare gli spinlock.



Nessuno di questi *lock* è ricorsivo: vedere

:ref:`Stallo: semplice ed avanzato <it_deadlock>`

`Stallo: semplice ed avanzato`_



I *lock* e i kernel per sistemi monoprocessore

----------------------------------------------
@@ -190,7 +190,7 @@ perfetto questa funzione si chiamerebbe 'spin_lock_softirq()'). 


Da notare che in questo caso potete utilizzare anche spin_lock_irq()

o spin_lock_irqsave(), queste fermano anche le interruzioni hardware:

vedere :ref:`Contesto di interruzione hardware <it_hardirq-context>`.

vedere `Contesto di interruzione hardware`_.



Questo funziona alla perfezione anche sui sistemi monoprocessore: gli spinlock

svaniscono e questa macro diventa semplicemente local_bh_disable()
@@ -241,7 +241,7 @@ Lo stesso softirq 


Lo stesso softirq può essere eseguito su un diverso processore: allo scopo

di migliorare le prestazioni potete utilizzare dati riservati ad ogni

processore (vedere :ref:`Dati per processore <it_per-cpu>`). Se siete arrivati

processore (vedere `Dati per processore`_). Se siete arrivati

fino a questo punto nell'uso dei softirq, probabilmente tenete alla scalabilità

delle prestazioni abbastanza da giustificarne la complessità aggiuntiva.
@@ -896,8 +896,6 @@ leggendo solamente il codice. E come dice Alan Cox: “Lock data, not code”. 
Problemi comuni

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



.. _`it_deadlock`:



Stallo: semplice ed avanzato

----------------------------
@@ -1282,7 +1280,6 @@ Il beneficio qui sta nel fatto che il contatore di riferimenti no 
viene scritto: l'oggetto non viene alterato in alcun modo e quindi diventa

molto più veloce su sistemi molti-processore grazie alla loro memoria cache.



.. _`it_per-cpu`:



Dati per processore

-------------------
@@ -1333,7 +1330,6 @@ Naturalmente, questo è più lento della semplice chiamata 
spin_lock_irq(), quindi ha senso solo se questo genere di accesso

è estremamente raro.



.. _`it_sleeping-things`:



Quali funzioni possono essere chiamate in modo sicuro dalle interruzioni?

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

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

+4 −5
Original line number Diff line number Diff line
@@ -264,11 +264,10 @@ La maggior parte di queste opzioni possono essere attivate per qualsiasi 
kernel utilizzato per lo sviluppo o a scopo di test.  In particolare dovreste

attivare:



 - ENABLE_MUST_CHECK e FRAME_WARN per ottenere degli

   avvertimenti dedicati a problemi come l'uso di interfacce deprecate o

   l'ignorare un importante valore di ritorno di una funzione.  Il risultato

   generato da questi avvertimenti può risultare verboso, ma non bisogna

   preoccuparsi per gli avvertimenti provenienti da altre parti del kernel.

 - FRAME_WARN per ottenere degli avvertimenti su stack frame più

   grandi di un dato valore.  Il risultato generato da questi

   avvertimenti può risultare verboso, ma non bisogna preoccuparsi per

   gli avvertimenti provenienti da altre parti del kernel.



 - DEBUG_OBJECTS aggiungerà un codice per tracciare il ciclo di vita di

   diversi oggetti creati dal kernel e avvisa quando qualcosa viene eseguito

Documentation/translations/it_IT/process/adding-syscalls.rst

+1 −1
Original line number Diff line number Diff line
@@ -562,7 +562,7 @@ kernel. Se la nuova funzionalità è utile all'interno del kernel, per esempio 
dev'essere condivisa fra una vecchia e una nuova chiamata di sistema o

dev'essere utilizzata da una chiamata di sistema e la sua variante compatibile,

allora dev'essere implementata come una funzione di supporto

(*helper function*) (per esempio ``kern_xyzzy()``).  Questa funzione potrà

(*helper function*) (per esempio ``ksys_xyzzy()``).  Questa funzione potrà

essere chiamata dallo *stub* (``sys_xyzzy()``), dalla variante compatibile

(``compat_sys_xyzzy()``), e/o da altri parti del kernel.