Commit ac771142 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 0aa78b10 ("Documentation/changes: Raise minimum supported binutils version to 2.23")
commit 7d717887 ("Documentation: include sign off for reverts")
commit 905705a8 ("docs: programming-languages: refresh blurb on clang support")
commit 5ff4aa70 ("docs: submitting-patches: use :doc: for references")
commit 030f066f ("docs: submitting-patches: describe preserving review/test tags")
commit 68e4cd17 ("docs: deprecated.rst: Add zero-length and one-element arrays")
commit 5429ef62 ("compiler/gcc: Raise minimum GCC version for kernel builds to 4.8")
commit 5b5bbb8c ("docs: process: Add an example for creating a fixes tag")
commit 858e6845 ("docs: dt: convert submitting-patches.txt to ReST format")
commit cca73e49 ("docs: Correct the release date of 5.2 stable")
commit c170f2eb ("docs: Document cross-referencing between documentation pages")
commit 7c8b9e30 ("kernel-doc: Update "cross-referencing from rST" section to use automarkup")
commit 27def953 ("docs: deprecated.rst: Expand str*cpy() replacement notes")
commit 17dca050 ("docs: deprecated.rst: Update zero-length/one-element arrays section")
commit 3519c4d6 ("Documentation: add minimum clang/llvm version")
commit 0bddd227 ("Documentation: update for gcc 4.9 requirement")
commit 9f364b60 ("submitting-patches.rst: presume git will be used")
commit 4ebdf7be ("Documentation/maintainer: rehome sign-off process")
commit 7433ff33 ("Documentation/process: expand plain-text advice")
commit eb45fb2f ("docs: process: Add cross-link to security-bugs")
commit bdc48fa1 ("checkpatch/coding-style: deprecate 80-column warning")
commit f67281a7 ("Documentation: process: step 2: Link to email list fixed")

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


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

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

+14 −16
Original line number Diff line number Diff line
@@ -419,26 +419,24 @@ del `dominio Sphinx per il C`_. 
Riferimenti usando reStructuredText

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~



Per fare riferimento a funzioni e tipi di dato definiti nei commenti kernel-doc

all'interno dei documenti reStructuredText, utilizzate i riferimenti dal

`dominio Sphinx per il C`_. Per esempio::

Nei documenti reStructuredText non serve alcuna sintassi speciale per

fare riferimento a funzioni e tipi definiti nei commenti

kernel-doc. Sarà sufficiente terminare i nomi di funzione con ``()``,

e scrivere ``struct``, ``union``, ``enum``, o ``typedef`` prima di un

tipo. Per esempio::



  See function :c:func:`foo` and struct/union/enum/typedef :c:type:`bar`.

  See foo()

  See struct foo.

  See union bar.

  See enum baz.

  See typedef meh.



Nonostante il riferimento ai tipi di dato funzioni col solo nome,

ovvero senza specificare struct/union/enum/typedef, potreste preferire il

seguente::

Tuttavia, la personalizzazione dei collegamenti è possibile solo con

la seguente sintassi::



  See :c:type:`struct foo <foo>`.

  See :c:type:`union bar <bar>`.

  See :c:type:`enum baz <baz>`.

  See :c:type:`typedef meh <meh>`.

  See :c:func:`my custom link text for function foo <foo>`.

  See :c:type:`my custom link text for struct bar <bar>`.



Questo produce dei collegamenti migliori, ed è in linea con il modo in cui

kernel-doc gestisce i riferimenti.



Per maggiori informazioni, siete pregati di consultare la documentazione

del `dominio Sphinx per il C`_.



Commenti per una documentazione generale

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

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

+20 −0
Original line number Diff line number Diff line
@@ -364,6 +364,26 @@ Che verrà rappresentata nel seguente modo: 


        - column 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)::



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



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::



    See :doc:`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.



.. _it_sphinx_kfigure:



Figure ed immagini

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

+2 −2
Original line number Diff line number Diff line
@@ -123,7 +123,7 @@ iniziale, i kernel ricevono aggiornamenti per più di un ciclo di sviluppo. 
Quindi, per esempio, la storia del kernel 5.2 appare così (anno 2019):



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

	15 settembre	5.2 rilascio stabile FIXME settembre è sbagliato

	 7 luglio	5.2 rilascio stabile

	14 luglio	5.2.1

	21 luglio	5.2.2

	26 luglio	5.2.3
@@ -434,7 +434,7 @@ l'elenco principale lo si trova sul sito: 
	http://vger.kernel.org/vger-lists.html



Esistono liste gestite altrove; un certo numero di queste sono in

lists.redhat.com.

redhat.com/mailman/listinfo.



La lista di discussione principale per lo sviluppo del kernel è, ovviamente,

linux-kernel.  Questa lista è un luogo ostile dove trovarsi; i volumi possono

Documentation/translations/it_IT/process/changes.rst

+19 −3
Original line number Diff line number Diff line
@@ -32,9 +32,10 @@ PC Card, per esempio, probabilmente non dovreste preoccuparvi di pcmciautils. 
====================== =================  ========================================

        Programma       Versione minima       Comando per verificare la versione

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

GNU C                  4.6                gcc --version

GNU C                  4.9                gcc --version

Clang/LLVM (optional)  10.0.1             clang --version

GNU make               3.81               make --version

binutils               2.21               ld -v

binutils               2.23               ld -v

flex                   2.5.35             flex --version

bison                  2.0                bison --version

util-linux             2.10o              fdformat --version
@@ -71,6 +72,16 @@ GCC 
La versione necessaria di gcc potrebbe variare a seconda del tipo di CPU nel

vostro calcolatore.



Clang/LLVM (opzionale)

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



L'ultima versione di clang e *LLVM utils* (secondo `releases.llvm.org

<https://releases.llvm.org>`_) sono supportati per la generazione del

kernel. Non garantiamo che anche i rilasci più vecchi funzionino, inoltre

potremmo rimuovere gli espedienti che abbiamo implementato per farli

funzionare. Per maggiori informazioni

:ref:`Building Linux with Clang/LLVM <kbuild_llvm>`.



Make

----
@@ -79,7 +90,7 @@ Per compilare il kernel vi servirà GNU make 3.81 o successivo. 
Binutils

--------



Per generare il kernel è necessario avere Binutils 2.21 o superiore.

Per generare il kernel è necessario avere Binutils 2.23 o superiore.



pkg-config

----------
@@ -338,6 +349,11 @@ gcc 


- <ftp://ftp.gnu.org/gnu/gcc/>



Clang/LLVM

----------



- :ref:`Getting LLVM <getting_llvm>`.



Make

----

Documentation/translations/it_IT/process/coding-style.rst

+16 −10
Original line number Diff line number Diff line
@@ -92,16 +92,22 @@ delle righe. 
Lo stile del codice riguarda la leggibilità e la manutenibilità utilizzando

strumenti comuni.



Il limite delle righe è di 80 colonne e questo e un limite fortemente

desiderato.



Espressioni più lunghe di 80 colonne saranno spezzettate in pezzi più piccoli,

a meno che eccedere le 80 colonne non aiuti ad aumentare la leggibilità senza

nascondere informazioni.  I pezzi derivati sono sostanzialmente più corti degli

originali e vengono posizionati più a destra.  Lo stesso si applica, nei file

d'intestazione, alle funzioni con una lista di argomenti molto lunga. Tuttavia,

non spezzettate mai le stringhe visibili agli utenti come i messaggi di

printk, questo perché inibireste la possibilità d'utilizzare grep per cercarle.

Come limite di riga si preferiscono le 80 colonne.



Espressioni più lunghe di 80 colonne dovrebbero essere spezzettate in

pezzi più piccoli, a meno che eccedere le 80 colonne non aiuti ad

aumentare la leggibilità senza nascondere informazioni.



I nuovi pezzi derivati sono sostanzialmente più corti degli originali

e vengono posizionati più a destra. Uno stile molto comune è quello di

allineare i nuovi pezzi alla parentesi aperta di una funzione.



Lo stesso si applica, nei file d'intestazione, alle funzioni con una

lista di argomenti molto lunga.



Tuttavia, non spezzettate mai le stringhe visibili agli utenti come i

messaggi di printk, questo perché inibireste la possibilità

d'utilizzare grep per cercarle.



3) Posizionamento di parentesi graffe e spazi

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