1 files changed, 21 insertions, 14 deletions
diff --git a/Documentation/translations/it_IT/process/coding-style.rst b/Documentation/translations/it_IT/process/coding-style.rst
index c0dc786b8474..b0cf138249c2 100644
--- a/Documentation/translations/it_IT/process/coding-style.rst
+++ b/Documentation/translations/it_IT/process/coding-style.rst
@@ -604,8 +604,11 @@ il PERCHÉ.
 
 Per favore, quando commentate una funzione dell'API del kernel usate il
 formato kernel-doc.  Per maggiori dettagli, leggete i file in
-:ref::ref:`Documentation/translations/it_IT/doc-guide/ <it_doc_guide>` e in
-``script/kernel-doc``.
+:ref:`Documentation/translations/it_IT/doc-guide/ <it_doc_guide>` e in
+``tools/docs/kernel-doc``. Da notare che il pericolo di commentare troppo
+si applica anche ai commenti kernel-doc. Non aggiungete kernel-doc
+superfluo che si limita a ripetere quanto già ovvio dalla firma della
+funzione.
 
 Lo stile preferito per i commenti più lunghi (multi-riga) è:
 
@@ -935,7 +938,7 @@ racchiusa in #ifdef, potete usare printk(KERN_DEBUG ...).
 ---------------------
 
 Il kernel fornisce i seguenti assegnatori ad uso generico:
-kmalloc(), kzalloc(), kmalloc_array(), kcalloc(), vmalloc(), e vzalloc().
+kmalloc(), kzalloc(), kmalloc_objs(), kzalloc_objs(), vmalloc(), e vzalloc().
 Per maggiori informazioni, consultate la documentazione dell'API:
 :ref:`Documentation/translations/it_IT/core-api/memory-allocation.rst <it_memory_allocation>`
 
@@ -943,7 +946,7 @@ Il modo preferito per passare la dimensione di una struttura è il seguente:
 
 .. code-block:: c
 
-	p = kmalloc(sizeof(*p), ...);
+	p = kmalloc_obj(*p, ...);
 
 La forma alternativa, dove il nome della struttura viene scritto interamente,
 peggiora la leggibilità e introduce possibili bachi quando il tipo di
@@ -957,13 +960,13 @@ Il modo preferito per assegnare un vettore è il seguente:
 
 .. code-block:: c
 
-	p = kmalloc_array(n, sizeof(...), ...);
+	p = kmalloc_objs(*p, n, ...);
 
 Il modo preferito per assegnare un vettore a zero è il seguente:
 
 .. code-block:: c
 
-	p = kcalloc(n, sizeof(...), ...);
+	p = kzalloc_objs(*p, n, ...);
 
 Entrambe verificano la condizione di overflow per la dimensione
 d'assegnamento n * sizeof(...), se accade ritorneranno NULL.
@@ -1068,15 +1071,17 @@ può migliorare la leggibilità.
 18) Non reinventate le macro del kernel
 ---------------------------------------
 
-Il file di intestazione include/linux/kernel.h contiene un certo numero
-di macro che dovreste usare piuttosto che implementarne una qualche variante.
-Per esempio, se dovete calcolare la lunghezza di un vettore, sfruttate la
-macro:
+Ci sono molti file d'intestazione in include/linux/ che contengono un certo
+numero di macro che dovreste usare piuttosto che implementarne una qualche
+variante. Per esempio, se dovete calcolare la lunghezza di un vettore,
+sfruttate la macro:
 
 .. code-block:: c
 
 	#define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))
 
+che è definita in array_size.h.
+
 Analogamente, se dovete calcolare la dimensione di un qualche campo di una
 struttura, usate
 
@@ -1084,10 +1089,12 @@ struttura, usate
 
 	#define sizeof_field(t, f) (sizeof(((t*)0)->f))
 
-Ci sono anche le macro min() e max() che, se vi serve, effettuano un controllo
-rigido sui tipi.  Sentitevi liberi di leggere attentamente questo file
-d'intestazione per scoprire cos'altro è stato definito che non dovreste
-reinventare nel vostro codice.
+che è definita in stddef.h.
+
+Ci sono anche le macro min() e max(), definite in minmax.h, che, se vi
+serve, effettuano un controllo rigido sui tipi. Sentitevi liberi di
+leggere attentamente questi file d'intestazione per scoprire cos'altro è
+stato definito che non dovreste reinventare nel vostro codice.
 
 19) Linee di configurazione degli editor e altre schifezze
 -----------------------------------------------------------