요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
FPGA 문서 목차
1-11이 페이지는 Linux kernel FPGA 문서 영역의 최상위 index다. Sphinx `toctree`를 사용해 DFL framework 문서인 상대 경로 `dfl`을 하위 항목으로 포함한다.
`:maxdepth: 1`은 현재 index에서 목차를 한 단계까지만 전개하도록 제한한다. `dfl`은 `Documentation/fpga/dfl.rst`를 가리키며 Device Feature List의 header 형식, FME·Port·AFU, SRIOV, perf와 사용자 공간 interface를 설명한다.
최상위 FPGA index가 선언하는 목차 요소다.
.. SPDX-License-Identifier: GPL-2.0
====
FPGA
====
.. toctree::
:maxdepth: 1
dfl
HTML subproject의 일반 색인
12-17`only:: subproject and html` 조건은 이 block을 subproject이면서 HTML builder를 사용하는 경우에만 포함한다. 다른 output format이나 build context에는 `Indices` section이 나타나지 않는다.
`* :ref:`genindex``는 Sphinx가 생성하는 일반 색인으로 연결한다. `genindex`는 source path가 아니라 Sphinx 표준 reference target이므로 번역하거나 다른 URL로 바꾸지 않는다.
Build 조건과 결과를 순서대로 나타낸다.
.. only:: subproject and html
Indices
=======
* :ref:`genindex`
요약·해설
index.rst:1-17Linux kernel FPGA 문서의 최상위 목차다. `toctree`는 `dfl` 문서를 한 단계 깊이로 연결하며, subproject HTML build에서는 Sphinx 일반 색인 `genindex`도 표시한다.
Directive, option, relative document path와 reference target은 모두 원문 표기를 유지한다.
목차와 조건부 색인의 두 경로다.