요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
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. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 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에서 일반 색인을 제공합니다.