요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0+
3
===========================
4
Client Driver Documentation
5
===========================
7
This is the documentation for client drivers themselves. Refer to
8
Documentation/driver-api/surface_aggregator/client.rst for documentation
9
on how to write client drivers.
11
.. toctree::
12
:maxdepth: 1
14
cdev
15
dtx
16
san
18
.. only:: subproject and html
20
Indices
21
=======
23
* :ref:`genindex`
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Client driver 문서 소개
1-10이 페이지는 Surface Aggregator client driver 자체의 문서를 모은 색인입니다.
Client driver를 작성하는 방법은 `Documentation/driver-api/surface_aggregator/client.rst`를 참조합니다.
항목위치
Client implementation 문서현재 clients index
Client driver 작성 지침Documentation/driver-api/surface_aggregator/client.rst
LicenseGPL-2.0+
.. SPDX-License-Identifier: GPL-2.0+
===========================
Client Driver Documentation
===========================
This is the documentation for client drivers themselves. Refer to
Documentation/driver-api/surface_aggregator/client.rst for documentation
on how to write client drivers.
Client driver 문서 목차
11-17최대 깊이 1의 `toctree`는 user-space EC character device인 `cdev`, clipboard detachment interface인 `dtx`, Surface ACPI notification client인 `san` 문서를 이 순서로 포함합니다.
순서문서주제
1cdevUser-space EC misc-device
2dtxClipboard detachment system
3sanSurface ACPI notification
.. toctree::
:maxdepth: 1
cdev
dtx
san
HTML subproject 색인
18-23`subproject and html` 조건에서만 `Indices` section을 표시하고 Sphinx의 `genindex`를 연결합니다.
조건출력
subproject and htmlIndices
Referencegenindex
.. only:: subproject and html
Indices
=======
* :ref:`genindex`
요약과 해설
index.rst:1-23이 색인은 Surface Aggregator client 구현 문서를 cdev, dtx, san 순서로 연결합니다. Client driver 작성 지침은 상위 `client.rst`에 두고, HTML subproject에서는 일반 색인도 제공합니다.