함수 문서화의 명료함: Haskell과 에바리스트의 만남

초록

본 논문은 Haskell 라이브러리 함수들의 문서가 다른 언어와 비교해 얼마나 모호한지를 분석하고, “easy‑hard‑split”이라는 형식적 전략을 통해 명확하고 재사용 가능한 사양을 제시한다. takeWhile 예제를 중심으로 부분 순서와 갈루아 연결을 활용한 정형화 과정을 보여주며, 이러한 접근이 구현 코드와 사양을 일치시켜 ‘correct‑by‑construction’을 가능하게 함을 증명한다.

상세 분석

논문은 먼저 프로그래밍 교육 현장에서 문서 품질이 저하되는 원인을 지적한다. 학생들의 수학·읽기 능력 저하와 문서의 비형식적 서술이 결합되면, 라이브러리 함수를 올바르게 이해하기 어려워진다. 이를 해결하기 위해 저자들은 “go formal informally”라는 원칙을 차용해, 텍스트 설명을 가능한 한 간결하면서도 정형화 가능한 형태로 변환한다. 핵심 전략은 “easy‑hard‑split”이다. ‘easy’ 부분은 함수가 만족해야 할 기본적인 관계(예: 입력 리스트의 전위(pre‑fix) 관계와 모든 원소가 조건을 만족한다는 전제)를 제시하고, ‘hard’ 부분은 그 관계들 중에서 최적(가장 긴 전위 등)을 선택하는 추가 제약을 명시한다.

takeWhile 함수를 사례로 삼아, Haskell Data.List의 설명을 “전위(pre‑fix)와 가장 긴 전위”라는 두 단계로 분해한다. 이를 기호화하면
 ys ≼ xs ∧ all p ys ⇔ ys ≼ takeWhile p xs
이라는 동등식이 도출된다. 여기서 ≼는 리스트 전위 관계이며, 이는 부분 순서(partial order)로서 반사성·전이성·반대칭성을 만족한다. 논문은 이 부분 순서를 이용해 리스트 동등성의 간접 원리(∀ zs : zs ≼ xs ⇔ zs ≼ ys) 를 제시하고, 이를 통해 takeWhile의 합성 법칙
 takeWhile p ∘ takeWhile q = takeWhile (p ∧ q)
을 정형적으로 증명한다.

또한, 저자들은 이러한 사양이 실제 구현과 일치함을 보인다. 전위 관계와 전제(all p ys)를 이용해 재귀적 정의를 유도하면, Haskell 표준 구현
 takeWhile