Lines Matching full:doc
4 :ref:`Documentation/doc-guide/index.rst <doc_guide>`
8 Scrivere i commenti in kernel-doc
12 strutturanti secondo il formato kernel-doc. Essi possono descrivere funzioni,
15 .. note:: Il formato kernel-doc può sembrare simile a gtk-doc o Doxygen ma
17 contengono decine di migliaia di commenti kernel-doc. Siete pregati
20 La struttura kernel-doc è estratta a partire dai commenti; da questi viene
27 .. _`dominio Sphinx per il C`: http://www.sphinx-doc.org/en/stable/domains.html
31 kernel-doc. Quando l'intenzione è di utilizzarle nei moduli, anche le funzioni
33 kernel-doc.
36 secondo kernel-doc per le funzioni che sono visibili da altri file del kernel
38 inoltre, di fornire una documentazione kernel-doc anche per procedure private
45 Sicuramente la documentazione formattata con kernel-doc è necessaria per
49 Cerchiamo anche di fornire una documentazione formattata secondo kernel-doc
53 Raccomandiamo, inoltre, di fornire una documentazione formattata con kernel-doc
59 documentate utilizzando commenti formattati con kernel-doc.
61 Come formattare i commenti kernel-doc
64 I commenti kernel-doc iniziano con il marcatore ``/**``. Il programma
65 ``kernel-doc`` estrarrà i commenti marchiati in questo modo. Il resto
70 I commenti kernel-doc di funzioni e tipi dovrebbero essere posizionati
73 anche la documentazione. I commenti kernel-doc di tipo più generale possono
77 eseguire il programma ``kernel-doc`` con un livello di verbosità alto e senza
80 scripts/kernel-doc -v -none drivers/foo/bar.c
90 Generalmente il formato di un commento kernel-doc per funzioni e
145 dovrebbe essere scritta con la notazione kernel-doc::
202 Generalmente il formato di un commento kernel-doc per struct, union ed enum è::
313 qualsiasi altro commento kernel-doc::
347 Generalmente il formato di un commento kernel-doc per typedef è
373 All'interno dei commenti di tipo kernel-doc vengono riconosciuti i seguenti
378 kernel-doc, e **non** all'interno di documenti reStructuredText.
394 potrebbero assumere un significato diverso in kernel-doc o in reStructuredText
422 Per fare riferimento a funzioni e tipi di dato definiti nei commenti kernel-doc
438 kernel-doc gestisce i riferimenti.
447 dei blocchi di documentazione kernel-doc con un formato libero invece
452 Questo s'ottiene utilizzando la parola chiave ``DOC:`` a cui viene associato
459 * DOC: Theory of Operation
470 Il titolo che segue ``DOC:`` funziona da intestazione all'interno del file
474 Includere i commenti di tipo kernel-doc
479 kernel-doc per Sphinx.
481 Le direttive kernel-doc sono nel formato::
483 .. kernel-doc:: source
495 Il campo *source-patter* è utile quando i commenti kernel-doc sono stati
501 .. kernel-doc:: lib/bitmap.c
504 .. kernel-doc:: include/net/mac80211.h
515 .. kernel-doc:: drivers/gpu/drm/i915/intel_audio.c
525 .. kernel-doc:: lib/bitmap.c
528 .. kernel-doc:: lib/idr.c
534 doc: *title*
535 Include la documentazione del paragrafo ``DOC:`` identificato dal titolo
544 .. kernel-doc:: drivers/gpu/drm/i915/intel_audio.c
545 :doc: High Definition Audio over HDMI and Display Port
547 Senza alcuna opzione, la direttiva kernel-doc include tutti i commenti di
550 L'estensione kernel-doc fa parte dei sorgenti del kernel, la si può trovare
552 lo script ``scripts/kernel-doc`` per estrarre i commenti di documentazione
555 Come utilizzare kernel-doc per generare pagine man
558 Se volete utilizzare kernel-doc solo per generare delle pagine man, potete
561 …$ scripts/kernel-doc -man $(git grep -l '/\*\*' -- :^Documentation :^tools) | scripts/split-man.pl…