요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0
.. _it_linux_doc:
==================================
La documentazione del kernel Linux
==================================
.. raw:: latex
\kerneldocCJKoff
:manutentore: Federico Vaga <[email protected]>
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.
.. _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.
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
Sincronizzazione nel kernel <locking/index>
subsystem-apis
Strumenti e processi per lo sviluppo
====================================
Di seguito una serie di manuali contenenti informazioni utili a tutti gli
sviluppatori del kernel.
.. toctree::
:maxdepth: 1
Regole sulle licenze <process/license-rules>
Scrivere la documentazione <doc-guide/index>
Strumenti di sviluppo <dev-tools/index>
La guida all'*hacking*<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 *reStructuredText*; altri sono semplicamente troppo vecchi.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
문서 트리의 목적과 유지관리
1-26이 페이지는 `GPL-2.0` 라이선스로 배포되는 Linux 커널 이탈리아어 문서 트리의 최상위 색인입니다. `_it_linux_doc` 앵커는 다른 문서가 이 이탈리아어 최상위 페이지를 참조할 때 사용하는 식별자입니다.
LaTeX 출력에서는 `raw:: latex` 블록의 `\kerneldocCJKoff`를 적용합니다. 이는 빌드 지시문이므로 번역하지 않고 그대로 보존합니다.
유지관리자는 Federico Vaga이며 원문에 연락처가 명시되어 있습니다. 유지관리자 필드는 번역 문서의 책임 위치를 알려 주지만, 기술 내용의 공식성에 관한 뒤의 경고를 대체하지 않습니다.
이 페이지는 이탈리아어 커널 문서의 최상위 수준입니다. 번역은 불완전하며, 번역되지 않은 문서나 문서 그룹이 있으면 별도 경고가 나타날 수 있다고 명시합니다.
커널 자체와 마찬가지로 문서도 계속 개발됩니다. 특히 문서 체계를 더 일관되게 재구성하는 작업이 진행 중이므로, 목차와 분류는 고정된 완성물이 아닙니다.
문서 개선은 언제나 환영하며, 기여하려는 사람은 `vger.kernel.org`의 `linux-doc` 메일링 리스트에 참여할 수 있습니다.
라이선스, 참조 앵커, 출력 지시문, 유지관리 정보를 구분합니다.
문서와 커널이 함께 변하므로 번역도 지속적으로 갱신해야 합니다.
.. SPDX-License-Identifier: GPL-2.0
.. _it_linux_doc:
==================================
La documentazione del kernel Linux
==================================
.. raw:: latex
\kerneldocCJKoff
:manutentore: Federico Vaga <[email protected]>
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.
번역의 목적과 공식 영어 문서 우선 원칙
27-68`_it_disclaimer` 앵커 아래의 경고는 이 번역의 목적과 한계를 설명합니다. 영어를 이해하기 어렵거나 해석에 확신이 없거나 단순히 이탈리아어 읽기를 선호하는 사람에게 접근성을 제공하는 것이 목적입니다.
그러나 유일한 공식 문서는 영어 문서 `linux_doc`입니다. 번역은 이해를 돕는 자료이며, 규범적 기술 기준이나 최종 판정 근거를 영어 원문에서 분리하지 않습니다.
영어 공식 문서의 변경이 모든 번역에 동시에 전파될 가능성은 매우 낮습니다. 번역 유지관리자와 기여자는 가능한 범위에서 공식 문서의 발전을 따라가며 번역을 맞추려고 합니다.
따라서 번역이 가장 최근 변경까지 반영되었다는 보장은 없습니다. 번역에서 읽은 내용이 코드와 일치하지 않으면 번역 유지관리자에게 알리고, 가능하다면 영어 문서도 확인해야 합니다.
번역은 공식 문서의 `fork`가 아닙니다. 사용자는 번역에서 공식 버전과 다른 독자적인 기술 정보를 기대해서는 안 됩니다.
내용의 추가·삭제·수정은 먼저 영어 문서에서 이루어져야 합니다. 이후 가능할 때 같은 변경을 번역에도 적용합니다.
번역 유지관리자는 새 번역, 업데이트, 수정처럼 번역 활동 자체에 관한 기여를 받습니다. 기술 내용을 번역본에만 먼저 추가하는 것은 이 정책에 맞지 않습니다.
새 기술 설명이 필요하다면 먼저 영어 공식 문서에 제안하고 검토를 거쳐야 합니다. 이 순서는 번역마다 서로 다른 사실이 생기는 일을 막고 모든 언어가 같은 기술 기준을 공유하게 합니다.
번역은 가능한 한 정확해야 하지만 언어를 일대일로 직접 대응시킬 수는 없습니다. 언어마다 문법과 문화가 다르므로 영어 문장이 이탈리아어에 맞게 형태가 바뀔 수 있습니다.
형식이 달라도 원래 메시지는 보존해야 합니다. 일상 이탈리아어에 영어식 표현이 널리 쓰이더라도, 가능한 경우 대응하는 이탈리아어 단어로 바꿉니다.
Linux 커뮤니티와 소통해야 하지만 영어 작성이 편하지 않다면 번역 유지관리자에게 도움을 요청할 수 있습니다.
어떤 자료가 최종 기준인지와 변경 순서를 정리합니다.
번역은 공식 문서의 fork가 아니라 후속 반영본입니다.
불일치를 발견하면 번역만 신뢰하지 않고 기준 자료를 교차 확인합니다.
.. _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.
개발 커뮤니티와 내부 API 문서
69-96‘개발 커뮤니티와 함께 일하기’ 섹션은 커널 개발 공동체와 상호작용하고 자신의 작업을 통합시키는 방법을 다루는 기본 가이드를 모읍니다.
깊이 1의 `toctree`는 개발 과정, 패치 제출, 행동 강령, 전체 개발 과정 문서 색인을 연결합니다. 표시 이름이 따로 지정된 항목도 실제 경로와 함께 보존합니다.
`process/development-process`는 개발 절차, `process/submitting-patches`는 패치 제출, `process/code-of-conduct`는 행동 강령, `process/index`는 개발 과정 문서 전체의 진입점입니다.
‘내부 API 매뉴얼’ 섹션은 커널의 나머지 부분과 인터페이스해야 하는 개발자를 위한 문서를 제공합니다.
내부 API `toctree`에는 `core-api/index`, 커널 동기화를 다루는 `locking/index`, 여러 하위 시스템 API를 모은 `subsystem-apis`가 깊이 1로 연결됩니다.
최상위 색인에서 직접 연결하는 개발 과정 문서입니다.
커널 내부 인터페이스를 이해할 때 사용하는 세 진입점입니다.
작업 단계에 따라 기본 과정 또는 세부 API 문서로 이동합니다.
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
Sincronizzazione nel kernel <locking/index>
subsystem-apis
개발 도구와 사용자 문서
97-121‘개발 도구와 과정’ 섹션은 모든 커널 개발자에게 유용한 정보를 담은 매뉴얼을 모읍니다.
이 `toctree`는 라이선스 규칙 `process/license-rules`, 문서 작성 `doc-guide/index`, 개발 도구 `dev-tools/index`, 커널 해킹 가이드 `kernel-hacking/index`를 깊이 1로 연결합니다.
‘사용자 문서’는 특정 시스템에서 커널이 최적으로 동작하도록 구성하려는 사용자와 사용자 공간 API를 활용하는 응용 프로그램 개발자를 대상으로 합니다.
사용자 문서 제목 아래에는 이 원문에서 별도의 `toctree` 경로가 없습니다. 따라서 이 페이지의 전문 번역은 사용자 대상 범위를 설명하되 존재하지 않는 하위 링크를 추가하지 않습니다.
별도로 유지되는 `Linux man pages`도 참조하라고 안내합니다. 링크는 `https://www.kernel.org/doc/man-pages/`이며 Linux 커널 문서 트리와 분리해 관리됩니다.
모든 개발자에게 유용한 네 진입점입니다.
사용자 섹션이 포괄하는 두 독자 유형입니다.
커널 문서와 수동 페이지는 서로 다른 위치에서 유지됩니다.
Strumenti e processi per lo sviluppo
====================================
Di seguito una serie di manuali contenenti informazioni utili a tutti gli
sviluppatori del kernel.
.. toctree::
:maxdepth: 1
Regole sulle licenze <process/license-rules>
Scrivere la documentazione <doc-guide/index>
Strumenti di sviluppo <dev-tools/index>
La guida all'*hacking*<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펌웨어, 아키텍처, 기타 문서
122-137‘펌웨어 관련 문서’ 섹션은 펌웨어에 관해 커널이 기대하는 사항을 다룬다고 설명합니다.
‘아키텍처별 문서’ 섹션은 제목만 있고 이 원문에는 설명 문단이나 `toctree` 항목이 없습니다.
‘기타 문서’는 현재 문서 조직에 넣기 어려운 자료를 위한 분류입니다. 개선하거나 `reStructuredText` 형식으로 변환해야 하는 문서와 지나치게 오래된 문서도 여기에 포함될 수 있습니다.
이 세 섹션에는 현재 직접 연결 경로가 없으므로, 색인의 제목과 설명만 번역합니다. 빈 분류를 번역 완료된 하위 문서 모음으로 계산하지 않습니다.
원문에 실제로 있는 설명과 직접 링크 여부를 구분합니다.
현재 기타 분류의 문서는 상태에 따라 개선하거나 재배치할 수 있습니다.
이 페이지가 구분하는 문서 영역과 현재 직접 연결 여부입니다.
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 *reStructuredText*; altri sono semplicamente troppo vecchi.
요약·해설
index.rst:1-137이탈리아어 문서 트리는 불완전하며 영어 `linux_doc`만 유일한 공식 기준입니다. 번역은 공식 문서의 fork가 아니므로 기술 변경은 영어 문서에 먼저 반영한 뒤 번역으로 전파해야 합니다.
최상위 색인은 개발 과정, 내부 API, 개발 도구의 실제 연결 경로를 제공하지만 사용자·펌웨어·아키텍처·기타 섹션에는 현재 하위 `toctree`가 없습니다. 이 차이를 그대로 보존합니다.