←back to thread

Noweb – A Simple, Extensible Tool for Literate Programming

(www.cs.tufts.edu)
140 points Tomte | 1 comments | 27 Feb 21 20:11 UTC | HN request time: 0.001s | source
Show context
smusamashah ◴[28 Feb 21 00:04 UTC] No.26289360[source]▶
Is there a simple intro an ELI5 to get into or learn literate programming?

My current understanding is that if write a paragraph size of comments to explain each and every part of my code with its intent it will be called literate programming.

replies(2): >>26289995 #>>26290671 #
1. mcguire ◴[28 Feb 21 04:28 UTC] No.26290671[source]▶
There's Knuth's TeX Book and METAFONT Book, and his Stanford GraphBase book. There's also his collection of papers, Literate Programming (https://www.amazon.com/gp/product/0937073806/ref=dbs_a_def_r...).

Knuth has an LP web page (https://www-cs-faculty.stanford.edu/~knuth/lp.html), but it looks like the examples are out of date.

Probably more useful is http://www.literateprogramming.com/; the CWEB Tool page has some examples and the PDF Articles page has ... articles.

Here's an intro from Knuth: http://www.literateprogramming.com/knuthweb.pdf

And then there's Physically Based Rendering at http://www.pbr-book.org/.