Skip to content

문서: 컨트롤 문자 스펙 인용 정비 — ctrl_char 상수별 §3.2.3 표 6 주석 + 코드 8 title mark 정정#21

Merged
YeolHanMyeong merged 1 commit into
mainfrom
docs/ctrl-char-spec-annotation
Jul 24, 2026
Merged

문서: 컨트롤 문자 스펙 인용 정비 — ctrl_char 상수별 §3.2.3 표 6 주석 + 코드 8 title mark 정정#21
YeolHanMyeong merged 1 commit into
mainfrom
docs/ctrl-char-spec-annotation

Conversation

@YeolHanMyeong

Copy link
Copy Markdown
Collaborator

요약

한글문서파일형식 5.0 §3.2.3 표 6 「제어 문자」 전수 대조 결과를 코드 주석·설계 문서에 반영한다. 동작 변경 없음(주석·문서만).

  • hwp-model ctrl_char 상수 17개에 표 6 행별 doc 주석 추가/// 탭 — inline (§3.2.3 표 6 코드 9) 형식으로 설명·컨트롤 형식·코드 번호를 상수마다 자체 완결 인용(IDE 호버로 바로 확인 가능). 모듈 헤더에 전체 출처와 미정의 코드 사유(예약 1·57·12·14·1920·25~29, unusable 0, title mark 8 미사용) 명시.
  • 10-hwp5-structure-map.md 코드 8 의미 정정 — 기존 "예약(제목 표시 등)" → 스펙대로 "title mark(제목 표시)". 표 6에서 코드 8은 예약이 아니다.
  • 줄 번호 인용 동기화 — 주석 추가로 pub mod ctrl_char가 37→41행으로 밀려 설계 문서의 인용 갱신.

검토 배경

표 6 ↔ ctrl_char/char_kind 전수 대조: 상수 값·의미·char_kind 분류(char/inline/extended) 모두 스펙과 일치 확인. 유일한 불일치가 설계 문서의 코드 8 표기였다.

데이터 정책 준수

스펙은 섹션 번호로만 인용 — 로컬 스펙 파일 경로(docs/spec/…, gitignore)는 주석에 넣지 않았다.

게이트

scripts/check.sh 통과 (fmt / clippy -D warnings / test 전체).

🤖 Generated with Claude Code

- hwp-model ctrl_char 상수 17개에 표 6 행별 doc 주석(설명·컨트롤 형식·코드 번호) 추가,
  모듈 헤더에 전체 출처와 미정의 코드(예약·unusable·title mark 8) 사유 명시
- 10-hwp5-structure-map.md 코드 8 의미를 스펙대로 "title mark(제목 표시)"로 정정
  (기존 "예약(제목 표시 등)"은 표 6과 불일치)
- 주석 추가로 밀린 ctrl_char 모듈 줄 번호 인용(paragraph.rs:37→41) 동기화

데이터 정책에 따라 스펙은 섹션 번호로만 인용(로컬 스펙 파일 경로 미포함). 동작 변경 없음.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@YeolHanMyeong
YeolHanMyeong merged commit 8e32624 into main Jul 24, 2026
3 checks passed
@YeolHanMyeong
YeolHanMyeong deleted the docs/ctrl-char-spec-annotation branch July 24, 2026 15:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant