요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
2. 영어 원문 전체
번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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은 모두 원문 표기를 유지한다.
목차와 조건부 색인의 두 경로다.