요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
=================
Kernel clients
=================
.. kernel-doc:: drivers/gpu/drm/drm_client.c
:doc: overview
.. kernel-doc:: include/drm/drm_client.h
:internal:
.. kernel-doc:: drivers/gpu/drm/drm_client.c
:export:
.. kernel-doc:: drivers/gpu/drm/drm_client_modeset.c
:export:
.. kernel-doc:: drivers/gpu/drm/drm_client_event.c
:export:
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Kernel client 개요
1-7이 페이지는 DRM subsystem 안에서 동작하는 kernel client API 문서를 모읍니다. Kernel client는 userspace process가 아니라 kernel 내부 구성 요소가 DRM device, display mode 설정, hotplug 같은 event 처리 기능을 이용할 때 쓰는 client abstraction입니다.
첫 `.. kernel-doc::` 지시어는 `drivers/gpu/drm/drm_client.c`에서 이름이 `overview`인 문서 블록을 가져옵니다. `:doc: overview`는 함수 하나가 아니라 source의 `DOC: overview` 설명을 페이지의 개요로 삽입하라는 kernel-doc 선택 조건입니다.
원문 5–6줄이 선택하는 kernel-doc 블록입니다.
=================
Kernel clients
=================
.. kernel-doc:: drivers/gpu/drm/drm_client.c
:doc: overview
내부 client API 선언
8-10`include/drm/drm_client.h`의 kernel-doc을 `:internal:` option으로 포함합니다. 이 option은 public export 목록만 고르는 대신 header에 기록된 내부 interface와 data structure 문서를 이 절에 노출합니다.
따라서 DRM client 구현을 수정하거나 다른 DRM 구성 요소에서 client object를 다룰 때 필요한 type, field, helper declaration의 설명은 이 header 문서에서 확인합니다. 실제 symbol 이름과 prototype은 build 시 해당 source의 kernel-doc에서 추출됩니다.
Header와 kernel-doc 포함 범위를 구분합니다.
.. kernel-doc:: include/drm/drm_client.h
:internal:
Client core·modeset·event의 exported API
11-18마지막 세 `.. kernel-doc::` 블록은 각각 client core, modeset, event 구현 파일에서 `:export:` 대상으로 표시된 kernel-doc symbol만 포함합니다. 이 선택자는 source file의 모든 내부 helper가 아니라 외부에서 사용할 수 있도록 문서화된 exported interface에 초점을 맞춥니다.
`drm_client.c`는 client framework의 core 동작, `drm_client_modeset.c`는 client가 display mode와 connector 구성을 다루는 기능, `drm_client_event.c`는 client event 처리를 담당하는 API 문서를 제공합니다. 각 함수의 정확한 prototype, 인자, 반환값은 이 페이지가 생성될 때 source의 kernel-doc 주석에서 결합됩니다.
원문 11–18줄에 나열된 구현 파일과 담당 영역입니다.
집계 페이지가 제시하는 source 순서를 따라 API의 층위를 파악합니다.
.. kernel-doc:: drivers/gpu/drm/drm_client.c
:export:
.. kernel-doc:: drivers/gpu/drm/drm_client_modeset.c
:export:
.. kernel-doc:: drivers/gpu/drm/drm_client_event.c
:export:
요약·해설
drm-client.rst:1-18DRM kernel client framework의 overview, 내부 header 문서, core·modeset·event 구현의 exported API를 하나의 페이지로 조합하는 kernel-doc 색인입니다. 네 source path와 `:doc: overview`, `:internal:`, `:export:` 선택 조건을 보존해 어떤 설명이 어디서 생성되는지 명확히 보여 줍니다.
페이지에 결합되는 다섯 kernel-doc 블록의 역할입니다.