1.. SPDX-License-Identifier: GPL-2.0 2 3.. _it_linux_doc: 4 5================================== 6La documentazione del kernel Linux 7================================== 8 9.. raw:: latex 10 11 \kerneldocCJKoff 12 13:manutentore: Federico Vaga <federico.vaga@vaga.pv.it> 14 15Questo è il livello principale della documentazione del kernel in 16lingua italiana. La traduzione è incompleta, noterete degli avvisi 17che vi segnaleranno la mancanza di una traduzione o di un gruppo di 18traduzioni. 19 20Più in generale, la documentazione, come il kernel stesso, sono in 21costante sviluppo; particolarmente vero in quanto stiamo lavorando 22alla 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 presso 25vger.kernel.org. 26 27.. _it_disclaimer: 28 29Avvertenze 30========== 31 32L'obiettivo di questa traduzione è di rendere più facile la lettura e 33la comprensione per chi non capisce l'inglese o ha dubbi sulla sua 34interpretazione, oppure semplicemente per chi preferisce leggere in lingua 35italiana. Tuttavia, tenete ben presente che l'*unica* documentazione 36ufficiale è quella in lingua inglese: :ref:`linux_doc` 37 38La propagazione simultanea a tutte le traduzioni di una modifica in 39:ref:`linux_doc` è altamente improbabile. I manutentori delle traduzioni - 40e i contributori - seguono l'evolversi della documentazione ufficiale e 41cercano di mantenere le rispettive traduzioni allineate nel limite del 42possibile. Per questo motivo non c'è garanzia che una traduzione sia 43aggiornata all'ultima modifica. Se quello che leggete in una traduzione 44non corrisponde a quello che leggete nel codice, informate il manutentore 45della traduzione e - se potete - verificate anche la documentazione in 46inglese. 47 48Una traduzione non è un *fork* della documentazione ufficiale, perciò gli 49utenti non vi troveranno alcuna informazione diversa rispetto alla versione 50ufficiale. Ogni aggiunta, rimozione o modifica dei contenuti deve essere 51fatta prima nei documenti in inglese. In seguito, e quando è possibile, la 52stessa modifica dovrebbe essere applicata anche alle traduzioni. I manutentori 53delle 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 è possibile 57mappare direttamente una lingua in un'altra. Ogni lingua ha la sua grammatica 58e una sua cultura alle spalle, quindi la traduzione di una frase in inglese 59potrebbe essere modificata per adattarla all'italiano. Per questo motivo, 60quando leggete questa traduzione, potreste trovare alcune differenze di forma 61ma che trasmettono comunque il messaggio originale. Nonostante la grande 62diffusione di inglesismi nella lingua parlata, quando possibile, questi 63verranno sostituiti dalle corrispettive parole italiane 64 65Se avete bisogno d'aiuto per comunicare con la comunità Linux ma non vi sentite 66a vostro agio nello scrivere in inglese, potete chiedere aiuto al manutentore 67della traduzione. 68 69Lavorare con la comunità di sviluppo 70==================================== 71 72Le guide fondamentali per l'interazione con la comunità di sviluppo del kernel e 73su come vedere il proprio lavoro integrato. 74 75.. toctree:: 76 :maxdepth: 1 77 78 process/development-process 79 process/submitting-patches 80 Code of conduct <process/code-of-conduct> 81 All development-process docs <process/index> 82 83 84Manuali sull'API interna 85======================== 86 87Di seguito una serie di manuali per gli sviluppatori che hanno bisogno di 88interfacciarsi con il resto del kernel. 89 90.. toctree:: 91 :maxdepth: 1 92 93 core-api/index 94 Sincronizzazione nel kernel <locking/index> 95 subsystem-apis 96 97Strumenti e processi per lo sviluppo 98==================================== 99 100Di seguito una serie di manuali contenenti informazioni utili a tutti gli 101sviluppatori del kernel. 102 103.. toctree:: 104 :maxdepth: 1 105 106 Regole sulle licenze <process/license-rules> 107 Scrivere la documentazione <doc-guide/index> 108 Strumenti di sviluppo <dev-tools/index> 109 La guida all'*hacking*<kernel-hacking/index> 110 111 112Documentazione per gli utenti 113============================= 114 115Di seguito una serie di manuali per gli *utenti* del kernel - ovvero coloro che 116stanno cercando di farlo funzionare al meglio per un dato sistema, ma anche 117coloro che stanno sviluppando applicazioni che sfruttano l'API verso lo 118spazio-utente. 119 120Consultate anche `Linux man pages <https://www.kernel.org/doc/man-pages/>`_, che 121vengono mantenuti separatamente dalla documentazione del kernel Linux 122 123Documentazione relativa ai firmware 124=================================== 125Di seguito informazioni sulle aspettative del kernel circa i firmware. 126 127 128Documentazione specifica per architettura 129========================================= 130 131 132Documentazione varia 133==================== 134 135Ci sono documenti che sono difficili da inserire nell'attuale organizzazione 136della documentazione; altri hanno bisogno di essere migliorati e/o convertiti 137nel formato *reStructuredText*; altri sono semplicamente troppo vecchi. 138