On Mar 19, 3:14=A0am, Guy Macon <http://www.guymacon.com/> wrote: > Anton Ertl wrote: > > >Guy Macon <http://www.guymacon.com/> writes: > >>A good programmer writes his/her comments in such a way that > >>a far better programmer could, in theory, start with just the > >>comments and end up with a working program that does the same > >>basic job that the original program does. > > >You want the complete specifications in the comments. > > I am not the only one: > > http://www-cs-faculty.stanford.edu/~knuth/lp.html > > http://www.literateprogramming.com/ > > http://en.wikipedia.org/wiki/Literate_programming > > -- > Guy Macon > <http://www.guymacon.com/> There is also a wiki for doing your own literate programming, which has some basic Forth programs. The Forth Word Count program was "literated" by a member of their community, if you want to see what the LP style does to some familiar code. The "Download code" link makes the code illiterate. http://en.literateprograms.org/ http://en.literateprograms.org/Word_count_%28Forth%29 Ian