요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Backlight 지원 개요의 문서 연결
1-6제목은 “Backlight 지원”입니다. 이 RST 파일은 backlight subsystem의 설명을 직접 반복하지 않고, `drivers/video/backlight/backlight.c`에 있는 kernel-doc 문서 블록을 Sphinx 페이지로 가져오는 짧은 진입점입니다.
`.. kernel-doc:: drivers/video/backlight/backlight.c`는 지정한 C source에서 kernel-doc 주석을 읽으라는 지시문입니다. 이어지는 `:doc: overview`는 일반 함수 목록이 아니라 source에 `DOC: overview`로 작성된 개요 블록을 이 위치에 삽입하도록 범위를 지정합니다.
RST 줄과 문서 빌드 결과의 관계를 구분합니다.
=================
Backlight support
=================
.. kernel-doc:: drivers/video/backlight/backlight.c
:doc: overview내부 선언과 외부 공개 함수 문서
7-12두 번째 지시문은 `include/linux/backlight.h`를 대상으로 `:internal:`을 사용합니다. 따라서 이 header에 kernel-doc 형식으로 기록된 내부 선언과 interface 설명을 생성 문서에 포함합니다. Struct, enum, callback, 함수명 같은 C symbol은 번역하지 않고 원래 식별자를 유지해야 source 검색과 교차 참조가 성립합니다.
세 번째 지시문은 다시 `drivers/video/backlight/backlight.c`를 읽되 `:export:`을 지정합니다. 이는 구현 source에서 외부에 export된 API의 kernel-doc 설명을 이 절에 모으라는 뜻입니다. `:internal:`은 header 내부 문서 범위이고 `:export:`은 구현에서 공개된 symbol 범위이므로, 두 지시문은 서로 다른 관점에서 backlight API를 구성합니다.
세 kernel-doc 호출이 가져오는 문서 조각을 정리합니다.
이 RST의 지시문 순서가 최종 페이지의 읽기 순서를 결정합니다.
.. kernel-doc:: include/linux/backlight.h
:internal:
.. kernel-doc:: drivers/video/backlight/backlight.c
:export:
요약·해설
backlight.rst:1-12Linux backlight subsystem의 kernel-doc를 조립하는 12줄짜리 진입 문서입니다. 구현의 overview, header의 internal interface, 구현의 exported API를 차례로 불러오며, 실제 상세 설명의 기준은 두 source path에 기록된 kernel-doc 주석입니다.
찾으려는 정보에 따라 RST가 가리키는 source와 option을 선택합니다.