from 3195 (by 작은나무)

CWEB 이라는 문학적 프로그래밍 시스템을 소개하고자 합니다. 문학적 프로그래밍은 이 곳 위키에 TeX을 소개하는 곳에 문서화 프로그래밍 이란 이름으로 이미 소개가 된 것이기도 합니다.

TeX 프로그램 자체도 문학적 프로그래밍 시스템 중 하나인 WEB으로 작성된 프로그램입니다. CWEB은 기존의 WEB을 보다 강화시킨 것으로 가장 많이 사용하는 프로그래밍 언어인 C 프로그래밍 언어와 TeX의 조합으로 된 시스템입니다.

CWEB 시스템의 설치및 관련 문서들은 http://www.literateprogramming.com 에서 쉽게 찾아 보실 수 있을 것입니다. 이 웹사이트에는 C 프로그래밍 언어 뿐만 아니라 다른 프로그래밍 언어로 할 수 있는 문학적 프로그램도 많이 소개 되어 있습니다.

korean_cwebman.pdf (139.65 KB)

저는 최근 몇년간 CWEB으로 프로그래밍을 해오고 있고, 앞으로도 계속할 것인데, CWEB 프로그래밍은 정말 재미있습니다. 제 말을 못 믿으시겠다면, Knuth 말은 믿으시겠죠? Knuth는 종종 그의 집 연구실에서 나올 때 이렇게 말한다네요. "CWEB programming is such fun!"

• Knuth가 손수 작성한 CWEB의 대표적인 예제: wc.pdf (61.31 KB)
• CWEB 프로그램의 주옥같은 예제들 (http://www.literateprogramming.com/fexamples.html)
• ucsplain.tex을 이용한 한글 CWEB 예제: vrotate.tar.gz (298.65 KB) (매우 엉성합니다. 그저 한글로 작성했다라는 정도로만 봐주세요.)
  
  

UTF-8로된 한글을 포함하는 cweb의 소스 파일인 .w 파일로부터 ctangle과 cweave 명령어를 이용해서 C 프로그램 파일인 .c 파일과 TeX 파일인 .tex을 만들다보면, 입력이 너무 길다는 경고 메시지가 나옵니다. 이는 위명령어들이 파일을 처리하기 위해서 내부적으로 버퍼(char 배열)를 가지고 있고, 그 버퍼의 끝을 나타내는 buffer_end가 작아서 나오는 경고 메시지입니다. 이 경우는 버퍼의 끝을 나타내는 변수 buffer_end를 충분히 크게해주면 발생하지 않는 경고 메시지입니다. 영어의 경우는 알파벳 한문자가 1바이트이기 때문에 그러한 경고 메시지가 없습니다. 물론 영어의 경우도 한 줄을 너무 길게하면 그런 메시지가 나오겠죠.:-)

(저는 utf-8에 대한 지식이 전혀 없습니다.) utf-8로 된 경우는 한 문자를 1바이트에서 최대 4바이트까지 표현한다고 들었습니다. 따라서 utf-8로 작성된 소스의 경우를 위해서 buffer_end를 최대 4배가 되게하면 됩니다.

ctangle과 cweave의 화일 입출력에 대한 부분이나 공통 부분은 common.w(.c)에 있는데, buffer_end에 대한 내용이 바로 이 파일에 있습니다.

common.w의 일부

@d buf_size 100 /* for \.{CWEAVE} and \.{CTANGLE} */
@d longest_name 1000
@d long_buf_size (buf_size+longest_name) /* for \.{CWEAVE} */
...
@<Definitions...@>=
char buffer[long_buf_size]; /* where each line of input goes */
char *buffer_end=buffer+buf_size-2; /* end of |buffer| */
...

따라서 buf_size를 최대 4배 크게하던가, 아니면, buffer_end를 정의하는 부분에 사용한 buf_size 대신에 long_buf_size를 사용하면 됩니다.

저는 cweb을 설치할때, 두번째 방법을 사용해서 설치해서, utf-8로 된 문서를 컴파일할때도 ctangle이나 cweave가 묵묵히 그저 제 할 일을 합니다. 이것이 utf-8로 된 문서의 근본적인 해결책인지, 임시방편적인 방법인지는 모르겠으나, 경고 메시지를 볼 수 없어서 좋기는 합니다.