요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Linux kernel firmware guide
1-13이 절은 firmware 관점에서 Linux의 ACPI subsystem을 설명하는 문서 모음의 최상위 안내 페이지다. 개별 API나 구현 세부를 직접 설명하기보다 ACPI guide로 들어가는 목차 역할을 한다.
Sphinx `toctree`의 `:maxdepth: 1`은 이 페이지에서 하위 목차를 한 단계 깊이까지만 전개하도록 지정한다. 포함 대상 `acpi/index`는 `Documentation/firmware-guide/acpi/index.rst`를 가리키며, ACPI 관련 세부 문서의 진입점이다.
원문의 구조를 유지하기 위해 제목, 한 문장의 범위 설명, `toctree` directive와 option, 상대 source path를 모두 그대로 보존한다. 하위 문서의 완성 여부를 이 index 자체의 번역 상태와 혼동하지 않는다.
이 index가 선언하는 Sphinx 목차 요소를 정리한다.
최상위 firmware guide에서 ACPI 세부 문서로 이어지는 구조다.
.. SPDX-License-Identifier: GPL-2.0
===============================
The Linux kernel firmware guide
===============================
This section describes the ACPI subsystem in Linux from firmware perspective.
.. toctree::
:maxdepth: 1
acpi/index
요약·해설
index.rst:1-13Linux kernel firmware guide의 최상위 index로, firmware 관점의 ACPI subsystem 문서 모음을 소개한다. `toctree`는 `:maxdepth: 1`로 설정되어 있고 `acpi/index` 한 항목을 연결한다.
짧은 목차 문서이지만 영어 원문 13줄과 한국어 전문 번역을 모두 제공하며, Sphinx directive·option·상대 경로는 번역하지 않고 원형을 유지한다.
이 페이지의 유일한 목차 연결을 간단히 나타낸다.