요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
Driver-specific documentation
2
=============================
4
This section provides information about various devices supported by the
5
Linux kernel, their protocols, and driver details.
7
.. toctree::
8
:maxdepth: 2
9
:numbered:
10
:glob:
12
*
14
.. only:: subproject and html
16
Indices
17
=======
19
* :ref:`genindex`
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
드라이버별 입력 장치 문서 색인
1-19이 페이지는 Linux 커널이 지원하는 여러 입력 장치의 프로토콜과 드라이버별 세부 문서를 모으는 색인입니다. 하위 문서 자체를 설명하는 본문보다, 같은 디렉터리의 모든 문서를 탐색 가능하게 연결하는 역할이 중심입니다.
지시문값의미
`toctree``*`현재 문서군의 모든 하위 항목을 포함
`:maxdepth:``2`목차를 두 단계 깊이까지 표시
`:numbered:`활성문서와 절에 번호 부여
`:glob:`활성와일드카드로 문서 목록 확장
`only``subproject and html`HTML 하위 프로젝트에서만 인덱스 절 생성
`:ref:``genindex`생성된 일반 색인으로 연결
Sphinx가 하위 입력 장치 문서를 수집하고 번호를 붙이는 설정입니다.
`Documentation/input/devices` 아래 문서 검색→`glob` 패턴 `*`로 모든 항목 수집→두 단계 깊이와 번호 매기기 적용→각 장치 프로토콜·드라이버 문서로 연결→HTML 하위 프로젝트에서는 일반 색인도 추가
색인 페이지가 빌드 시 하위 문서를 연결하는 흐름입니다.
Driver-specific documentation
=============================
This section provides information about various devices supported by the
Linux kernel, their protocols, and driver details.
.. toctree::
:maxdepth: 2
:numbered:
:glob:
*
.. only:: subproject and html
Indices
=======
* :ref:`genindex`
요약·해설
index.rst:1-19입력 장치별 문서를 자동 수집해 번호가 붙은 두 단계 목차로 제공하는 짧은 색인입니다. HTML 하위 프로젝트에서는 Sphinx 일반 색인도 함께 노출합니다.
색인 파일의 범위와 빌드 동작입니다.