literate programming failed

Those who
* know what is literate programming,
* the ideas and the technical implementation behind it, and
* think this metodology doesn't work,
can find this fragment funny (Documented LaTeX sources (.dtx files), emphasis by me):

Another useful way of generating .dtx files is to write the documentation and the code separately, and then to combine them using the makedtx system. This technique has particular value in that the documentation file can be used separately to generate HTML output; it is often quite difficult to make LaTeX to HTML conversion tools deal with .dtx files, since they use an unusual class file.

Categories: