21 Nov
2011
21 Nov
'11
3:02 p.m.
----- Original Message -----
From: "Chuck Guzis" <cclist at sydex.com>
To: "General Discussion: On-Topic and Off-Topic Posts"
<cctalk at classiccmp.org>
Sent: Monday, November 21, 2011 6:27 PM
Subject: Re: Literate programming is too much work! - Re: TeX - Knuth -
Software quality - Re: Bug-Free Software,
One more observation. I've read a lot of other people's code in my
lifetime and one thing that stands out in sharp contrast from the run-
of-the-mill awuful stuff is that the narrative commentary to good,
inspired code is always well-formed, grammatically correct and often
witty.
I agree. There's nothing like skimming through source code and finding
comments that reference a TV programme (or something else popular) from the
time the code was written, especially if it's funny.
On a relevant note, last week I added code to my first amiga demo (that I
hope to release next month) that added double-buffering for a particular
screen (the onscreen object would flicker every few seconds without it). One
of the parts to the double-buffering referenced a label called
".not_logical_jim" (clearly a Star Trek reference, incase someone here
doesn't get it).
Regards,
Andrew B
aliensrcooluk at yahoo.co.uk