CWEB 시스템으로 하는 문학적 프로그래밍은 컴퓨터 프로그래머들로 하여금 마치 자신이 소설이나 수필을 쓰고 있는 듯한 착각을 불러 일으킬 정도로 프로그래밍 작업을 즐겁게하여 줍니다. 뿐만아니라, 그 작업 결과 또한 매우 깔끔하고 훌륭합니다. 특히, 프로그램 도큐먼트 맨 뒤에 자동으로 생성해주는 인덱스는 매우 유용합니다.

한 편의 짧은 에세이 정도 길이의 프로그램이라면 그 인덱스가 매우 유익할텐데, 장편 소설 같은 프로그램이라면 상황이 달라집니다. 오히려 도큐먼트 맨 뒤에 나오는 인덱스는 골칫거리가 될 수도 있습니다. 프로그램 소스를 읽는다는 것은 보통의 소설이나 수필을 읽는 것과는 약간 차이가 있어서, 그 소스에 사용된 변수나 함수등 각종 식별자들의 정의와 쓰임새등을 세세히 자주 파악할 필요가 있습니다. 그럴 때마다, 즉 어떤 변수의 정의나 쓰이는 곳을 찾기 위해서 도큐먼트의 맨 뒤의 인덱스를 찾아서 해당 페이지로 가는 것은 매우 귀찮은 작업입니다.

우리에게 친숙한 TeX: The Program 역시 web 시스템으로 작성된 문학적 프로그램인데, 그 소스의 도큐먼트 페이지가 500 페이지가 훨씬 넘고, 맨 뒤에 나오는 인덱스만도 30 페이지가 넘습니다. 이러한 상황을 해결하기 위한 방법 중의 하나는 인덱스를 맨 뒤에만 두는 것 뿐만 아니라, 도큐먼트 전반에 걸쳐서 매 오른쪽 페이지에 둔다면, 현재 페이지에서 사용된 변수나 함수들을 쉽게 찾아 볼 수 있을 것입니다. 이러한 인덱스를 미니 인덱스(mini-indexes) 라고 하는데, ctwill 시스템은 문학적 프로그래밍 할 때에 미니 인덱스를 생성하도록 도와줍니다.

Knuth는 그의 책 The Stanford GraphBase는 ctwill을 이용해서 미니 인덱스를 갖춘 멋진 책입니다.

CTWILL 시스템은 크게 세 개의 프로그램으로 구성되어 있습니다.

• ctwill
  이 프로그램은 cweave를 변형한 two-pass 프로그램입니다. cweave가 cwebmac.tex 매크로 파일을 사용하는 반면, ctwill 프로그램은 cwebmac.tex 매크로과 거의 동일하지만, 미니 인덱스 생성등 책을 만드는 데에 보다 초점을 맞춘 ctwimac.tex 매크로 파일을 이용합니다.
• refsort
  foo.w라는 cweb 파일에 ctwill 프로그램을 적용하고 나면, foo.ref라는 미니 인덱스 생성에 필요한 reference 파일이 생기는데, 이 foo.ref 파일을 정렬하여, 소트된 버전의 foo.sref를 만들어 냅니다.
• twinx
  ctwill 시스템은 매우 큰 하나의 cweb 프로그램으로 책을 만들거나, 여러 개의 작은 cweb 파일을 묶어서 책을 만드는 경우에 사용됩니다. The Stanford GraphBase는 후자의 경우에 해당합니다. 이러한 경우, 미니 인덱스 뿐만 아니라 여러 cweb 소스들의 major indexes도 필요한데, twinx는 이 경우에 사용됩니다.

소스: ctwill.tar.gz

1. ctwill.tar.gz의 압축을 풀고, cweb 설치 할때와 마찬가지로 한글(utf-8)을 이용하기 위해서 common.w 파일의 buffer_end 정의한 곳에서 buffer_size를 long_buffer_size로 바꿉니다.
2. make ctwill, make refsort, make twinx를 통해서 실행 파일을 만들어 path가 잡혀 있는, 예를들어, /usr/local/bin에 둡니다.
3. ctwimac.tex, twinxmac.tex 등 매크로 파일을 tex이 알 수 있는 디렉토리에 둡니다.

1. foo.w 라는 이름으로 웹파일을 작성한다.
2. 먼저 ctwill 프로그램으로 foo.tex 파일들을 생성한다.

   ctwill foo.w
   

3. 위에서 생성한 foo.tex 으로부터 foo.ref 파일을 생성한다.

   tex foo.tex
   

4. 위 단계에서 생성한 reference 파일, foo.ref를 소트하여 foo.sref를 만든다.

   refsort < foo.ref > foo.sref
   

5. 최종적으로 tex을 한 번 더 실행한다.

   tex foo.tex
   

6. ctwill은 cweave와는 달리 마스터 인덱스를 생성하지 않으므로, twinx를 이용하여 마스터 인덱스를 생성합니다. (여러개의 웹파일로 책을 만들지 않는 이상, 대부분의 경우 이 작업은 필요없다.)

   twinx foo.tex > index.tex
   

이때, twinxmac.tex 파일의 304번째 줄을 아래와 같이 주석처리를 해주어야 한다.

 %\input twinx-startup % custom IDs, \preinx copy, etc.

7. 인덱스 파일, index.tex을 컴파일 합니다.

   tex index.tex
   

8. 위의 6, 8 단계에서 생성한 foo.dvi, index.dvi로 책을 만듭니다.

   dvipdfmx foo
   dvipdfmx index
   

불행히도 ctwill은 cweave와 같은 완전 자동 프로그램이 아닙니다. 일부 수작업이 들어갑니다. 하지만 그럼에도 불구하고, 책을 만들고자 하는 분들께는 인덱스 생성에 들어가는 수고를 많이 줄여줍니다.

생성된 foo.pdf 파일의 미니 인덱스를 보면, ??? 라고 해당 변수명이나 식별자가 제대로 인식되지 못하는 경우가 종종 발생한다. 이런 경우 수작업으로 해당 식별자를 TeX이 알 수 있도록 해주어야 하는데, system.bux와 같은 파일을 참고로 해결할 수 있다.

예를들어, foo.w 에 C의 stdlib.h 에 정의되어있는 calloc 이라는 함수를 이용했다고 하자. 이 경우 CTWILL은 미니 인덱스에 calloc 이라는 함수명을 표시하는데, 이 calloc은 foo.w 에서 작성한 것이 아니라서 calloc에 대한 정보가 없으므로 미니인덱스에 ???라고 나온다. 이경우, calloc은 stdlib.h에 선언되어있다는 것을 TeX에게 다음과 같은 방식으로 알려주어야 한다.

@$calloc "<stdlib.h>" \&{void} $*$(\,)@>

system.bux 파일들은 위와 같은 것들을 미리 정해놓은 파일이다.

• The Stanford GraphBase: A Platform for Combinatorial Computing, Donald E. Knuth 지음
• Knuth의 대표적인 ctwill 사용 예제: ham.bux.gz (2.04 KB) ham.pdf.gz (72.59 KB) Hamiltonian circuits