forked from ~ljy/RK356X_SDK_RELEASE

hc
2023-12-08 01573e231f18eb2d99162747186f59511f56b64d
kernel/Documentation/translations/it_IT/doc-guide/kernel-doc.rst
....@@ -107,7 +107,7 @@
107107 * Context: Describes whether the function can sleep, what locks it takes,
108108 * releases, or expects to be held. It can extend over multiple
109109 * lines.
110
- * Return: Describe the return value of foobar.
110
+ * Return: Describe the return value of function_name.
111111 *
112112 * The return value description can also have multiple paragraphs, and should
113113 * be placed at the end of the comment block.
....@@ -515,6 +515,22 @@
515515 .. kernel-doc:: drivers/gpu/drm/i915/intel_audio.c
516516 :internal:
517517
518
+identifiers: *[ function/type ...]*
519
+ Include la documentazione per ogni *function* e *type* in *source*.
520
+ Se non vengono esplicitamente specificate le funzioni da includere, allora
521
+ verranno incluse tutte quelle disponibili in *source*.
522
+
523
+ Esempi::
524
+
525
+ .. kernel-doc:: lib/bitmap.c
526
+ :identifiers: bitmap_parselist bitmap_parselist_user
527
+
528
+ .. kernel-doc:: lib/idr.c
529
+ :identifiers:
530
+
531
+functions: *[ function ...]*
532
+ Questo è uno pseudonimo, deprecato, per la direttiva 'identifiers'.
533
+
518534 doc: *title*
519535 Include la documentazione del paragrafo ``DOC:`` identificato dal titolo
520536 (*title*) all'interno del file sorgente (*source*). Gli spazi in *title* sono
....@@ -527,15 +543,6 @@
527543
528544 .. kernel-doc:: drivers/gpu/drm/i915/intel_audio.c
529545 :doc: High Definition Audio over HDMI and Display Port
530
-
531
-functions: *function* *[...]*
532
- Dal file sorgente (*source*) include la documentazione per le funzioni
533
- elencate (*function*).
534
-
535
- Esempio::
536
-
537
- .. kernel-doc:: lib/bitmap.c
538
- :functions: bitmap_parselist bitmap_parselist_user
539546
540547 Senza alcuna opzione, la direttiva kernel-doc include tutti i commenti di
541548 documentazione presenti nel file sorgente (*source*).