요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
=======================
DMAEngine documentation
=======================
DMAEngine documentation provides documents for various aspects of DMAEngine
framework.
DMAEngine development documentation
-----------------------------------
This book helps with DMAengine internal APIs and guide for DMAEngine device
driver writers.
.. toctree::
:maxdepth: 1
provider
DMAEngine client documentation
------------------------------
This book is a guide to device driver writers on how to use the Slave-DMA
API of the DMAEngine. This is applicable only for slave DMA usage only.
.. toctree::
:maxdepth: 1
client
DMA Test documentation
----------------------
This book introduces how to test DMA drivers using dmatest module.
.. toctree::
:maxdepth: 1
dmatest
PXA DMA documentation
----------------------
This book adds some notes about PXA DMA
.. toctree::
:maxdepth: 1
pxa_dma
.. only:: subproject and html
Indices
=======
* :ref:`genindex`
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
DMAEngine documentation 개요
1-7DMAEngine documentation은 DMAEngine framework의 여러 측면을 다루는 문서를 제공합니다.
DMAEngine 개발 문서
8-18이 문서는 DMAengine internal API를 이해하고 DMAEngine device driver를 작성하는 데 도움을 주는 안내서입니다.
.. toctree::
:maxdepth: 1
provider
DMAEngine client 문서
19-29이 문서는 device driver 작성자가 DMAEngine의 Slave-DMA API를 사용하는 방법을 안내합니다. slave DMA 용도에만 적용됩니다.
.. toctree::
:maxdepth: 1
client
DMA Test 문서
30-39이 문서는 `dmatest` module로 DMA driver를 시험하는 방법을 소개합니다.
.. toctree::
:maxdepth: 1
dmatest
PXA DMA 문서와 색인
40-55이 문서는 PXA DMA에 관한 참고 사항을 추가합니다.
.. toctree::
:maxdepth: 1
pxa_dma
.. only:: subproject and html
Indices
=======
* :ref:`genindex`
개발자, client, test, PXA DMA 안내서를 대상과 하위 문서에 대응시켰습니다.
`subproject`와 `html` 조건이 모두 참일 때 `Indices` 절에서 `genindex` reference를 표시합니다.
요약과 해설
index.rst:1-55이 index는 DMAEngine framework 문서를 provider 개발, Slave-DMA client 사용, dmatest 기반 검증, PXA DMA 참고 사항으로 나눕니다. 각 toctree entry는 해당 전문 안내서로 연결되고 subproject HTML build에서는 전체 색인도 제공합니다.