요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
2. 영어 원문 전체
번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0+
3
=======================================
4
Surface System Aggregator Module (SSAM)
5
=======================================
7
.. toctree::
8
:maxdepth: 2
10
overview
11
client
12
clients/index
13
ssh
14
internal
16
.. only:: subproject and html
18
Indices
19
=======
21
* :ref:`genindex`
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.
Surface System Aggregator Module
1-6이 문서는 `GPL-2.0+` SPDX license를 사용하는 Surface System Aggregator Module(SSAM) driver API의 상위 색인입니다.
항목값
Full nameSurface System Aggregator Module
AbbreviationSSAM
LicenseGPL-2.0+
.. SPDX-License-Identifier: GPL-2.0+
=======================================
Surface System Aggregator Module (SSAM)
=======================================
SSAM 문서 목차
7-15최대 깊이 2의 `toctree`는 subsystem overview, client driver 작성 지침, 구체적 client 문서, Surface Serial Hub, internal 구현 문서를 순서대로 연결합니다.
순서문서주제
1overviewSubsystem 개요
2clientClient driver 작성
3clients/indexClient implementation 문서
4sshSurface Serial Hub
5internalInternal implementation
.. toctree::
:maxdepth: 2
overview
client
clients/index
ssh
internal
HTML subproject 색인
16-21`subproject and html` 조건에서만 `Indices` section을 표시하고 Sphinx 일반 색인인 `genindex`를 연결합니다.
조건출력
subproject and htmlIndices
Referencegenindex
.. only:: subproject and html
Indices
=======
* :ref:`genindex`
요약과 해설
index.rst:1-21이 상위 색인은 Surface System Aggregator Module 문서를 overview에서 internal implementation까지 최대 깊이 2로 구성하고 HTML subproject에서 일반 색인을 제공합니다.