|
Hweb - Intro to Documentation Programming
|
|
|
Hweb is a software system that facilitates the creation of
readable programs. It was inspired by Donald E. Knuth's WEB system. Users
of Hweb should
-
Write programs of superior quality;
-
Produce state-of-the-art documentation;
-
Greatly reduce debugging time;
-
Maintain programs easily as conditions change.
The main idea is to regard a program as a communication to human beings
rather than as a set of instructions to a computer. Your program is also
viewed as a hypertext document, rather like the World Wide Web.
Hweb is is freely available via anonymous ftp from ftp.superant.com,
in directory
~ftp/pub/hweb. It consists of a program and support
files:
-
htangle
-
converts a html embedded source file foo.c to a compilable program
file free of html.
Documentation for Hweb
example2
example3
Related books
The philosophy of literate programming is explained fully in the book
Literate
Programming, which also contains an extensive bibliography of the
subject.
Literate Programming
Donald E. Knuth
ISBN 0-937073-80-6 OR ISBN 0-937073-81-4
1992