요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
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. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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에서는 일반 색인도 제공합니다.