Literate Programming

Продолжаю тренироваться в переводе. Сразу скажу, это не последний текст с ресурса:

http://www.literateprogramming.com/

Donald Knuth. The CWEB System of Structure Documentation. Addison-Wesley. 1994. pg. 1.

Философия в основе CWEB такова - опытный системный программист, желающий предоставить наилучшее документирование своего продукта, нуждается в двух вещах одновременно: язык типа TeX для форматирования (документирования) и язык типа C для программирования. Ни один из них (языков) не может предоставить лучшее документирование по отдельности, когда же их подходяще сопрячь, мы получаем систему заметно более полезную нежели применяя языки отдельно.



Структура программы может быть представлена как "паутина" сделанная из множества повязанных кусочков. Чтобы описать (документировать) подобную программу нам надо разьяснить каждую индивидуальную часть паутины и то, как она (часть) связана с соседями. Типографские инструменты предоставляемыеTeX дают нам возможность разьяснить локальную структуру каждой части делая ее (структуру) наглядной (видимой), а программерские инструменты предоставляемые языком типа C делают возможным для нас разьяснить алгоритмы формально и недвусмысленно. Обьединяя их оба, мы можем разработать стиль программирования увеличивающий наши возможности постигать структуту комплексных частей софта, и в то же время документированные программы могут быть механически транслированы в работоспособный софт адекватно документированный.



Кроме того, предоставляя документирующие инструменты, CWEB улучшает язык C предоставляя возможности перестановок кусков текста программ, так что большая система может быть понята целиком в терминах маленьких сегментов и их локальных взаимосвязей. CTANGLE программа так названа потому как берет предоставленную паутину и перемещает сегменты из веб структуры в последовательность требуемую C. Преимущество программирования на CWEB в том, что алгоритмы могут быть выражены в "распутанной" форме, где каждый сегмент разьяснен отдельно. CWEAVE программа так названа потому как берет представленную веб и сплетает порции TeX & C содержащиеся в каждом сегменте, увязывая исходный материал в структурированный документ.

Кстати, я и не знал, что то, к чему я при программировании стремлюсь, имеет простое название - LP