137 lines
4.8 KiB
ReStructuredText
137 lines
4.8 KiB
ReStructuredText
|
.. SPDX-License-Identifier: GPL-2.0
|
||
|
|
|
||
|
|
.. _it_linux_doc:
|
||
|
|
|
||
|
|
===================
|
||
|
|
Traduzione italiana
|
||
|
|
===================
|
||
|
|
|
||
|
|
.. raw:: latex
|
||
|
|
|
||
|
|
\kerneldocCJKoff
|
||
|
|
|
||
|
|
:manutentore: Federico Vaga <federico.vaga@vaga.pv.it>
|
||
|
|
|
||
|
|
.. _it_disclaimer:
|
||
|
|
|
||
|
|
Avvertenze
|
||
|
|
==========
|
||
|
|
|
||
|
|
L'obiettivo di questa traduzione è di rendere più facile la lettura e
|
||
|
|
la comprensione per chi non capisce l'inglese o ha dubbi sulla sua
|
||
|
|
interpretazione, oppure semplicemente per chi preferisce leggere in lingua
|
||
|
|
italiana. Tuttavia, tenete ben presente che l'*unica* documentazione
|
||
|
|
ufficiale è quella in lingua inglese: :ref:`linux_doc`
|
||
|
|
|
||
|
|
La propagazione simultanea a tutte le traduzioni di una modifica in
|
||
|
|
:ref:`linux_doc` è altamente improbabile. I manutentori delle traduzioni -
|
||
|
|
e i contributori - seguono l'evolversi della documentazione ufficiale e
|
||
|
|
cercano di mantenere le rispettive traduzioni allineate nel limite del
|
||
|
|
possibile. Per questo motivo non c'è garanzia che una traduzione sia
|
||
|
|
aggiornata all'ultima modifica. Se quello che leggete in una traduzione
|
||
|
|
non corrisponde a quello che leggete nel codice, informate il manutentore
|
||
|
|
della traduzione e - se potete - verificate anche la documentazione in
|
||
|
|
inglese.
|
||
|
|
|
||
|
|
Una traduzione non è un *fork* della documentazione ufficiale, perciò gli
|
||
|
|
utenti non vi troveranno alcuna informazione diversa rispetto alla versione
|
||
|
|
ufficiale. Ogni aggiunta, rimozione o modifica dei contenuti deve essere
|
||
|
|
fatta prima nei documenti in inglese. In seguito, e quando è possibile, la
|
||
|
|
stessa modifica dovrebbe essere applicata anche alle traduzioni. I manutentori
|
||
|
|
delle traduzioni accettano contributi che interessano prettamente l'attività
|
||
|
|
di traduzione (per esempio, nuove traduzioni, aggiornamenti, correzioni).
|
||
|
|
|
||
|
|
Le traduzioni cercano di essere il più possibile accurate ma non è possibile
|
||
|
|
mappare direttamente una lingua in un'altra. Ogni lingua ha la sua grammatica
|
||
|
|
e una sua cultura alle spalle, quindi la traduzione di una frase in inglese
|
||
|
|
potrebbe essere modificata per adattarla all'italiano. Per questo motivo,
|
||
|
|
quando leggete questa traduzione, potreste trovare alcune differenze di forma
|
||
|
|
ma che trasmettono comunque il messaggio originale. Nonostante la grande
|
||
|
|
diffusione di inglesismi nella lingua parlata, quando possibile, questi
|
||
|
|
verranno sostituiti dalle corrispettive parole italiane
|
||
|
|
|
||
|
|
Se avete bisogno d'aiuto per comunicare con la comunità Linux ma non vi sentite
|
||
|
|
a vostro agio nello scrivere in inglese, potete chiedere aiuto al manutentore
|
||
|
|
della traduzione.
|
||
|
|
|
||
|
|
La documentazione del kernel Linux
|
||
|
|
==================================
|
||
|
|
|
||
|
|
Questo è il livello principale della documentazione del kernel in
|
||
|
|
lingua italiana. La traduzione è incompleta, noterete degli avvisi
|
||
|
|
che vi segnaleranno la mancanza di una traduzione o di un gruppo di
|
||
|
|
traduzioni.
|
||
|
|
|
||
|
|
Più in generale, la documentazione, come il kernel stesso, sono in
|
||
|
|
costante sviluppo; particolarmente vero in quanto stiamo lavorando
|
||
|
|
alla riorganizzazione della documentazione in modo più coerente.
|
||
|
|
I miglioramenti alla documentazione sono sempre i benvenuti; per cui,
|
||
|
|
se vuoi aiutare, iscriviti alla lista di discussione linux-doc presso
|
||
|
|
vger.kernel.org.
|
||
|
|
|
||
|
|
Lavorare con la comunità di sviluppo
|
||
|
|
------------------------------------
|
||
|
|
|
||
|
|
Le guide fondamentali per l'interazione con la comunità di sviluppo del kernel e
|
||
|
|
su come vedere il proprio lavoro integrato.
|
||
|
|
|
||
|
|
.. toctree::
|
||
|
|
:maxdepth: 1
|
||
|
|
|
||
|
|
process/development-process
|
||
|
|
process/submitting-patches
|
||
|
|
Code of conduct <process/code-of-conduct>
|
||
|
|
All development-process docs <process/index>
|
||
|
|
|
||
|
|
|
||
|
|
Manuali sull'API interna
|
||
|
|
------------------------
|
||
|
|
|
||
|
|
Di seguito una serie di manuali per gli sviluppatori che hanno bisogno di
|
||
|
|
interfacciarsi con il resto del kernel.
|
||
|
|
|
||
|
|
.. toctree::
|
||
|
|
:maxdepth: 1
|
||
|
|
|
||
|
|
core-api/index
|
||
|
|
|
||
|
|
Strumenti e processi per lo sviluppo
|
||
|
|
------------------------------------
|
||
|
|
|
||
|
|
Di seguito una serie di manuali contenenti informazioni utili a tutti gli
|
||
|
|
sviluppatori del kernel.
|
||
|
|
|
||
|
|
.. toctree::
|
||
|
|
:maxdepth: 1
|
||
|
|
|
||
|
|
process/license-rules
|
||
|
|
doc-guide/index
|
||
|
|
kernel-hacking/index
|
||
|
|
|
||
|
|
Documentazione per gli utenti
|
||
|
|
-----------------------------
|
||
|
|
|
||
|
|
Di seguito una serie di manuali per gli *utenti* del kernel - ovvero coloro che
|
||
|
|
stanno cercando di farlo funzionare al meglio per un dato sistema, ma anche
|
||
|
|
coloro che stanno sviluppando applicazioni che sfruttano l'API verso lo
|
||
|
|
spazio-utente.
|
||
|
|
|
||
|
|
Consultate anche `Linux man pages <https://www.kernel.org/doc/man-pages/>`_, che
|
||
|
|
vengono mantenuti separatamente dalla documentazione del kernel Linux
|
||
|
|
|
||
|
|
Documentazione relativa ai firmware
|
||
|
|
-----------------------------------
|
||
|
|
Di seguito informazioni sulle aspettative del kernel circa i firmware.
|
||
|
|
|
||
|
|
|
||
|
|
Documentazione specifica per architettura
|
||
|
|
-----------------------------------------
|
||
|
|
|
||
|
|
|
||
|
|
Documentazione varia
|
||
|
|
--------------------
|
||
|
|
|
||
|
|
Ci sono documenti che sono difficili da inserire nell'attuale organizzazione
|
||
|
|
della documentazione; altri hanno bisogno di essere migliorati e/o convertiti
|
||
|
|
nel formato *ReStructured Text*; altri sono semplicamente troppo vecchi.
|