The Unix Heritage Society mailing list
 help / color / mirror / Atom feed
* [TUHS]  daemons are not to be exorcised/Comments in code
       [not found] <mailman.68.1521732132.3788.tuhs@minnie.tuhs.org>
@ 2018-03-22 19:01 ` David
  0 siblings, 0 replies; only message in thread
From: David @ 2018-03-22 19:01 UTC (permalink / raw)


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 1069 bytes --]


> From: Dave Horsfall <dave at horsfall.org>
> Yep, and I'm glad that I had bosses to whom I didn't have to explain why 
> my comments were so voluminous.
> 
> And who first said "Write your code as though the next person to maintain 
> it is a psychotic axe-wielding murderer who knows where you live"?  I've 
> often thought that way (as the murderer I mean, not the murderee).
> 
> I'd name names, but he might be on this list...
> 
I’ve always said that the person was a ‘reformed’ axe-wielding murderer
who knows where you live.

Please, a little decorum.

W.R.T. comments in code, and a bit of Unix, when I taught Unix Systems
programming at UCSD one of my students wanted to use his personal
computer for the programming. I didn’t care as long as it would pass the
tests I ran after the fact.

After his second homework was turned in, I stopped looking at his code
or even running it, as the comment blocks were just so well done. Nary
a comment in the function itself, just a block before each one very clearly
explaining what was happening.

	David



^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2018-03-22 19:01 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
     [not found] <mailman.68.1521732132.3788.tuhs@minnie.tuhs.org>
2018-03-22 19:01 ` [TUHS] daemons are not to be exorcised/Comments in code David

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).