Co je dokumentované programování

Dokumentované programování je kombinace dokumentace a zdrojového textu do společné formy vhodné ke čtení lidmi. Stručně řečeno, dokumentované programy sdružují zdrojový text a dokumentaci do jednoho souboru. Nástroje dokumentovaného programování pak zpracováním tohoto souboru vytvoří buď čitelnou dokumentaci nebo kompilovatelný kód. Styl dokumentovaného programování WEB vytvořil D. E. Knuth při vývoji svého sázecího systému TeX.

Diskuse o dokumentovaném programování je soustředěna do usenetové skupiny comp.programming.literate, která je přístupná i jako elektronická konference na adrese litprog@shsu.edu (viz Diskusní skupiny o TeXu a příbuzných programech). FAQy o dokumentovaném programování jsou uloženy v CTAN: LitProg-FAQ

WEB pro C, FORTRAN a další jazyky

TeX je napsán v programovacím jazyku WEB. Jedná se o prostředek, který implementuje koncept ,,dokumentovaného programování``.

CWEB, WEB pro programy v C, který vytvořil Silvio Levy, je dostupný jako CTAN: cweb

Spidery WEB podporuje mnoho jazyků včetně Ada, awk a C. Byl napsán Normanem Ramseyem a ačkoli není volně šiřitelný, lze jej používat bezplatně. Dá se získat v CTAN: spiderweb

FWEB je verze pro Fortran, Ratfor a C napsaná Johnem Krommesem. Je dostupná v CTAN: fweb

SchemeWEB je Unixový filtr, který překládá SchemeWEB do zdrojového kódu LaTeXu nebo Scheme. Napsal ho John Ramsdell a je dostupný v CTAN: schemeweb

APLWEB je verze WEBu pro APL a dá se získat v CTAN: aplweb

FunnelWeb je verze WEBu, která je jazykově nezávislá. Je dostupná v CTAN: funnelweb

Další jazykově nezávislé verze WEBu jsou nuweb (napsaná v ANSI C), dostupná v CTAN: nuweb, a noweb, dostupná na CTAN: noweb