Literate programming, 우리 말로 하면 `문학적' 혹은 `문서적' 프로그래밍이라고 할 수 있는데, 제 개인적인 견해로는, Knuth가 컴퓨터 프로그래밍을 음악을 작곡하는 것이나 문학 작품을 쓰는 것에 비교하는 것을 보면, 문학적 프로그래밍이 더 어울릴 것 같습니다. 이 글에서는 문학적 프로그래밍이라고 하겠습니다.

노벨상에는 수학과 전산학에 대한 상이 없습니다. 수학에는 수학의 노벨상에 해당하는 필즈상(Fields Medal)이 있고, 전산학에는 전산학의 노벨상이라 불리기에 충분한 튜링상(Turing Award)이 있습니다. 1974년의 튜링상 수상자는 알고리즘의 분석과 프로그래밍 언어의 디자인 그리고, The art of computer programming 이라는 저서로 그 분야에 많은 공헌을 한 Knuth 였습니다. 그리고 관례로써 그해 튜링상을 받은 사람은 ACM Turing Award Lecture라는 이름으로 강의를 하게 되어 있는데, 1974년 그 강의의 제목은 Computer Programming as an Art 였습니다. 컴퓨터 프로그래밍을 단순한 기술이 아닌 음악, 미술, 문학과 같은 종류의 하나의 예술 활동이라고 강조하고 있습니다. 그리고 결론부에는 컴퓨터 프로그래머 자신이 예술가라는 인식을 가지고 프로그래밍 작업에 임하면, 프로그래밍이 더욱 즐겁고, 그 결과 또한 더욱 좋을 것이라고 말합니다.

To summarize: We have seen that computer programming is an art, because it applies accumulated knowledge to the world, because it requires skill and ingenuity, and especially because it produces objects of beauty. A programmer who subconsciously views himself as an artist will enjoy what he does and will do it better. Therefore we can be glad that people who lecture at computer conferences speak about the state of the Art.

Computer Programming as an Art의 전문: knuth-turingaward.pdf (737.8 KB)

문학적 프로그래밍은 이렇게 시작했나봅니다. 프로그래밍을 예술로 보는 대가로 부터 말입니다. 위의 강의를 시작으로 눈에 보이는 본격적인 문학적 프로그래밍의 시작 또한 Knuth의 논문 Literate Programming 에서 시작합니다. 이 논문에서 Knuth는 더이상 컴퓨터를 위해 프로그래밍을 하는 시대는 지났다고 말합니다. 사람을 위한 프로그래밍을 하자고 합니다. 물론 프로그래밍이라는 것이 컴퓨터에 일을 시키기 위한 명령들의 집합이지만, 이것을 너무 컴퓨터에 초점을 맞추지 말고, 사람들에게 눈을 돌리자는 것이지요. 컴퓨터 프로그래밍의 르네상스 시대가 온 것이지요. 이 논문에서 역시 일관되게 컴퓨터 프로그래밍을 문학 작품(works of literature) 보자고 하고 여기서 Literate Programming 이란 말을 만들어 냈습니다. Knuth는 문학적 프로그래밍을 단순한 말장난에 그치는 것을 싫어해서 WEB이라는 언어를 만들어 냈습니다. 우리의 사랑을 독차지하는 TeX이 WEB이라는 시스템, 일종의 컴퓨터 프로그래밍 언어로 만들어 졌습니다.

I believe that the time is ripe for significantly better documentation of programs, and that we can best achieve this by considering programs to be works of literature. Hence, my title: Literate Programming.

Let us change our traditional attitude to the construction of programs: Instead of imagining that our main task is to instruct a computer what to do, let us concentrate rather on explaining to human beings what we want a computer to do.

문학적 프로그래밍의 효시라고 할 수 있는 논문: knuthweb.pdf (257.24 KB)

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로 된 문서의 근본적인 해결책인지, 임시방편적인 방법인지는 모르겠으나, 경고 메시지를 볼 수 없어서 좋기는 합니다.