136 lines · plain
1.. SPDX-License-Identifier: GPL-2.02 3.. _it_linux_doc:4 5==================================6La documentazione del kernel Linux7==================================8 9.. raw:: latex10 11 \kerneldocCJKoff12 13:manutentore: Federico Vaga <federico.vaga@vaga.pv.it>14 15Questo è il livello principale della documentazione del kernel in16lingua italiana. La traduzione è incompleta, noterete degli avvisi17che vi segnaleranno la mancanza di una traduzione o di un gruppo di18traduzioni.19 20Più in generale, la documentazione, come il kernel stesso, sono in21costante sviluppo; particolarmente vero in quanto stiamo lavorando22alla riorganizzazione della documentazione in modo più coerente.23I miglioramenti alla documentazione sono sempre i benvenuti; per cui,24se vuoi aiutare, iscriviti alla lista di discussione linux-doc presso25vger.kernel.org.26 27.. _it_disclaimer:28 29Avvertenze30==========31 32L'obiettivo di questa traduzione è di rendere più facile la lettura e33la comprensione per chi non capisce l'inglese o ha dubbi sulla sua34interpretazione, oppure semplicemente per chi preferisce leggere in lingua35italiana. Tuttavia, tenete ben presente che l'*unica* documentazione36ufficiale è quella in lingua inglese: :ref:`linux_doc`37 38La propagazione simultanea a tutte le traduzioni di una modifica in39:ref:`linux_doc` è altamente improbabile. I manutentori delle traduzioni -40e i contributori - seguono l'evolversi della documentazione ufficiale e41cercano di mantenere le rispettive traduzioni allineate nel limite del42possibile. Per questo motivo non c'è garanzia che una traduzione sia43aggiornata all'ultima modifica. Se quello che leggete in una traduzione44non corrisponde a quello che leggete nel codice, informate il manutentore45della traduzione e - se potete - verificate anche la documentazione in46inglese.47 48Una traduzione non è un *fork* della documentazione ufficiale, perciò gli49utenti non vi troveranno alcuna informazione diversa rispetto alla versione50ufficiale. Ogni aggiunta, rimozione o modifica dei contenuti deve essere51fatta prima nei documenti in inglese. In seguito, e quando è possibile, la52stessa modifica dovrebbe essere applicata anche alle traduzioni. I manutentori53delle traduzioni accettano contributi che interessano prettamente l'attività54di traduzione (per esempio, nuove traduzioni, aggiornamenti, correzioni).55 56Le traduzioni cercano di essere il più possibile accurate ma non è possibile57mappare direttamente una lingua in un'altra. Ogni lingua ha la sua grammatica58e una sua cultura alle spalle, quindi la traduzione di una frase in inglese59potrebbe essere modificata per adattarla all'italiano. Per questo motivo,60quando leggete questa traduzione, potreste trovare alcune differenze di forma61ma che trasmettono comunque il messaggio originale. Nonostante la grande62diffusione di inglesismi nella lingua parlata, quando possibile, questi63verranno sostituiti dalle corrispettive parole italiane64 65Se avete bisogno d'aiuto per comunicare con la comunità Linux ma non vi sentite66a vostro agio nello scrivere in inglese, potete chiedere aiuto al manutentore67della traduzione.68 69Lavorare con la comunità di sviluppo70====================================71 72Le guide fondamentali per l'interazione con la comunità di sviluppo del kernel e73su come vedere il proprio lavoro integrato.74 75.. toctree::76 :maxdepth: 177 78 process/development-process79 process/submitting-patches80 Code of conduct <process/code-of-conduct>81 All development-process docs <process/index>82 83 84Manuali sull'API interna85========================86 87Di seguito una serie di manuali per gli sviluppatori che hanno bisogno di88interfacciarsi con il resto del kernel.89 90.. toctree::91 :maxdepth: 192 93 core-api/index94 Sincronizzazione nel kernel <locking/index>95 subsystem-apis96 97Strumenti e processi per lo sviluppo98====================================99 100Di seguito una serie di manuali contenenti informazioni utili a tutti gli101sviluppatori del kernel.102 103.. toctree::104 :maxdepth: 1105 106 process/license-rules107 doc-guide/index108 kernel-hacking/index109 110Documentazione per gli utenti111=============================112 113Di seguito una serie di manuali per gli *utenti* del kernel - ovvero coloro che114stanno cercando di farlo funzionare al meglio per un dato sistema, ma anche115coloro che stanno sviluppando applicazioni che sfruttano l'API verso lo116spazio-utente.117 118Consultate anche `Linux man pages <https://www.kernel.org/doc/man-pages/>`_, che119vengono mantenuti separatamente dalla documentazione del kernel Linux120 121Documentazione relativa ai firmware122===================================123Di seguito informazioni sulle aspettative del kernel circa i firmware.124 125 126Documentazione specifica per architettura127=========================================128 129 130Documentazione varia131====================132 133Ci sono documenti che sono difficili da inserire nell'attuale organizzazione134della documentazione; altri hanno bisogno di essere migliorati e/o convertiti135nel formato *reStructuredText*; altri sono semplicamente troppo vecchi.136