literate programming

จากความจำเป็นที่ให้เขียนโปรแกรม เลยต้องใช้บริการของ literate programming บ้าง
คนเขียนโปรแกรม มักขี้เกียจเขียน users manual หรือ programme descriptions ต่างๆ ซึ่งความยุ่งยากอันนี้เอง ที่ DEK กับคณะ ได้พบมาแล้ว ทราบดีถึงความยุ่งยากใจของ programmers จึงได้เกิดงาน literate programming ขึ้นมา

ก็ เขียนไป ทั้ง source code และคู่มือพร้อมๆกัน ที่ซึ่งเมื่อเขียนจบ ก็ได้ทั้ง ตัวโปรแกรม และ คู่มือ มาใช้งาน ได้เลย


ใน ports ครับ ในหมวด devel ชื่อ cweb มีคู่มือเป็น pdf สวยสวยให้อ่านด้วย
ข้อจำกัดคือ มีให้จำเพาะภาษา C เท่านั้นเอง

บางส่วน จาก Introduction ของเอกสารคู่มือที่ให้มา

\section Introduction.
The philosophy behind \.{CWEB} is
that programmers who want to provide the best
possible documentation for their programs need two things
simultaneously: a language like \TEX/ for formatting, and a language like
\CEE/ for programming. Neither type of language can provide the
best documentation by itself. But when both are appropriately combined, we
obtain a system that is much more useful than either language separately.

ที่เมื่อทำเป็น .pdf แล้ว ก็ ประมาณนี้ ในรูปที่เห็นนี้แหละ



ลองดูน่ะพี่น้อง