== CWEB == $$\hbox{CWEB}=\hbox{\TeX}+\hbox{C programming language}$$ from KTUGContrib:3195 (by 작은나무) CWEB 이라는 문학적 프로그래밍 시스템을 소개하고자 합니다. 문학적 프로그래밍은 이 곳 위키에 TeX을 소개하는 곳에 ''문서화 프로그래밍'' 이란 이름으로 이미 소개가 된 것이기도 합니다. TeX 프로그램 자체도 문학적 프로그래밍 시스템 중 하나인 WEB으로 작성된 프로그램입니다. CWEB은 기존의 WEB을 보다 강화시킨 것으로 가장 많이 사용하는 프로그래밍 언어인 C 프로그래밍 언어와 TeX의 조합으로 된 시스템입니다. attachment:korean_cwebman.pdf === CWEB 예제 === 첨부파일은 CWEB 프로그래밍을 소개하고자 간단한 프로그램을 작성한 것입니다. 여러분이 CWEB으로 프로그래밍을 한다면, 현재 보다 나은 프로그램을 작성할 수 있을 것이란 확신이 있기에 감히 이렇게 소개하는 것입니다. 무엇보다도 CWEB 프로그래밍은 참 재미있습니다. CWEB 시스템의 설치및 관련 문서들은 http://www.literateprogramming.com 에서 쉽게 찾아 보실 수 있을 것입니다. 위 웹사이트에는 C 프로그래밍 언어 뿐만 아니라 다른 프로그래밍 언어로 할 수 있는 문학적 프로그램도 많이 소개 되어 있습니다. 첨부 파일은 엉성한 프로그램이지만, 여러분이 CWEB을 접하는 데 도움이 되었으면 좋겠습니다. attachment:vrotate.tar.gz attachment:wc.pdf (Knuth가 작성한 CWEB 예제) === CWEB 설치시 한글 고려사항 === 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} */ ... @= 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로 된 문서의 근본적인 해결책인지, 임시방편적인 방법인지는 모르겠으나, 경고 메시지를 볼 수 없어서 좋기는 합니다. 이 점 말고도, 한글로 cweb 프로그램을 온전히 하기 위해서는 cweave.w, cwebmac.tex 파일 등 몇가지를 더 수정해야합니다. 이를 위해서는 충분한 TeX의 지식이 필요한데, 그렇지 못한 제 자신이 안타까울뿐입니다. -- 작은나무