Kernel Documentation Fantasy
Posted Nov 26, 2003 22:05 UTC (Wed) by iabervon
In reply to: Kernel Documentation Fantasy
Parent article: Review: Linux Kernel Development
Two problems with literate programming: It's generally relatively easy to
understand the bit of the code you're looking at, but hard to understand
the overall implications of it in the context of the system as a whole.
Where would the information be that tells you, for example, the lock
ordering rules? It also tends towards digressions. I've read some of TeX,
and it reads more like a book about the difficulty of writing working and
portable Pascal than anything to do with TeX. E.g.:
The bane of portability is the fact that different operating systems
treat input and output quite differently, perhaps because computer
scientists have not given sufficient attention to this problem.
Absolutely true, but why am I reading about this in this particular
place? Because Knuth had to deal with it there. While interesting, this
doesn't actually advance my knowledge of TeX, however.
to post comments)