요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
2
This is a simple wrapper to bring memory-barriers.txt into the RST world
3
until such a time as that file can be converted directly.
5
============================
6
Linux kernel memory barriers
7
============================
9
.. raw:: latex
11
\footnotesize
13
.. include:: ../../memory-barriers.txt
14
:literal:
16
.. raw:: latex
18
\normalsize
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
문서 형식과 전환 목적
1-3.. SPDX-License-Identifier: GPL-2.0이 파일은 `../../memory-barriers.txt`의 내용을 직접 RST로 변환할 수 있을 때까지 해당 문서를 RST 문서 체계로 가져오기 위한 단순 wrapper입니다.
Linux 커널 메모리 배리어
4-8이 wrapper가 제공하는 문서 제목은 "Linux kernel memory barriers"입니다.
============================
Linux kernel memory barriers
============================포함 본문의 글자 크기 설정
9-12LaTeX 출력에서는 포함할 literal 본문에 들어가기 전에 글자 크기를 `\footnotesize`로 설정합니다.
.. raw:: latex
\footnotesize원문 파일 포함
13-15`../../memory-barriers.txt`를 `:literal:` 옵션으로 포함하므로, Linux 커널의 메모리 배리어와 ordering 모델을 설명하는 원문을 RST 명령으로 재해석하지 않고 형식 그대로 렌더링합니다.
.. include:: ../../memory-barriers.txt
:literal:기본 글자 크기 복원
16-18포함 본문이 끝나면 LaTeX 출력의 글자 크기를 `\normalsize`로 되돌립니다.
.. raw:: latex
\normalsize
요약과 해설
memory-barriers.rst:1-18이 페이지 자체는 Linux 커널의 메모리 배리어와 ordering 모델의 본문이 아니라 기존 text 문서를 커널 RST 문서 빌드에 연결하는 호환 wrapper입니다.
핵심 동작은 `../../memory-barriers.txt`를 `:literal:`로 포함하고, LaTeX 출력에서 포함 구간의 글자 크기를 `\footnotesize`로 낮춘 뒤 `\normalsize`로 복원하는 것입니다.