요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
extends: relaxed
rules:
quoted-strings:
required: only-when-needed
extra-allowed:
- '[$^[]'
- '^/$'
line-length:
# 80 chars should be enough, but don't fail if a line is longer
max: 110
allow-non-breakable-words: true
level: warning
braces:
min-spaces-inside: 0
max-spaces-inside: 1
min-spaces-inside-empty: 0
max-spaces-inside-empty: 0
brackets:
min-spaces-inside: 0
max-spaces-inside: 1
min-spaces-inside-empty: 0
max-spaces-inside-empty: 0
colons: {max-spaces-before: 0, max-spaces-after: 1}
commas: {min-spaces-after: 1, max-spaces-after: 1}
comments:
require-starting-space: true
min-spaces-from-content: 1
comments-indentation: disable
document-start:
present: true
empty-lines:
max: 3
max-end: 1
empty-values:
forbid-in-block-mappings: true
forbid-in-flow-mappings: true
hyphens:
max-spaces-after: 1
indentation:
spaces: 2
indent-sequences: true
check-multi-line-strings: false
trailing-spaces: false
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Devicetree binding YAML lint 규칙
1-44이 설정은 yamllint의 `relaxed` profile을 확장하고 Devicetree binding YAML에 적용할 구체적인 formatting 규칙을 덮어씁니다.
`quoted-strings`는 필요한 경우에만 quote를 요구하며 `[$^[]`와 `^/$` pattern은 추가 허용 목록에 둡니다.
`line-length`는 최대 110자로 설정합니다. 끊을 수 없는 단어는 허용하고 초과 line은 failure가 아니라 warning으로 처리합니다. 원문 comment는 80자가 충분해야 하지만 더 긴 line 때문에 검사를 실패시키지는 않는다고 설명합니다.
`braces`와 `brackets` 내부 spacing은 일반적으로 0자에서 1자까지 허용하고 empty pair 내부에는 space를 허용하지 않습니다. Colon 앞은 0자, 뒤는 최대 1자이며 comma 뒤에는 정확히 1자의 space가 필요합니다.
Comment는 시작 space가 필요하고 content와 최소 1자 떨어져야 합니다. `comments-indentation` 검사는 비활성화합니다. YAML document start marker는 반드시 있어야 합니다.
연속 empty line은 최대 3개, 문서 끝은 최대 1개입니다. Block mapping과 flow mapping 모두 empty value를 금지하고 hyphen 뒤에는 최대 1자의 space만 허용합니다.
Indentation은 2 spaces이며 sequence도 indent합니다. Multi-line string indentation 검사는 하지 않습니다. `trailing-spaces: false`는 trailing-spaces rule 자체를 비활성화합니다.
extends: relaxed
rules:
quoted-strings:
required: only-when-needed
extra-allowed:
- '[$^[]'
- '^/$'
line-length:
# 80 chars should be enough, but don't fail if a line is longer
max: 110
allow-non-breakable-words: true
level: warning
braces:
min-spaces-inside: 0
max-spaces-inside: 1
min-spaces-inside-empty: 0
max-spaces-inside-empty: 0
brackets:
min-spaces-inside: 0
max-spaces-inside: 1
min-spaces-inside-empty: 0
max-spaces-inside-empty: 0
colons: {max-spaces-before: 0, max-spaces-after: 1}
commas: {min-spaces-after: 1, max-spaces-after: 1}
comments:
require-starting-space: true
min-spaces-from-content: 1
comments-indentation: disable
document-start:
present: true
empty-lines:
max: 3
max-end: 1
empty-values:
forbid-in-block-mappings: true
forbid-in-flow-mappings: true
hyphens:
max-spaces-after: 1
indentation:
spaces: 2
indent-sequences: true
check-multi-line-strings: false
trailing-spaces: false
설정 file의 rule을 formatting 영역별로 묶어 보여 줍니다.
요약과 해설
.yamllint:1-44Relaxed profile을 기반으로 하되 binding schema의 일관성을 위해 flow spacing, document marker, empty value와 2-space indentation을 구체적으로 제한합니다.