[einhverfr]

Kernigan is absolutely right here btw.

There are so many problems with trying to make up for unclear code in comments, that's a real losing battle. I recognize that it may be worth breaking that rule sometimes, but then it is worth noting that, and flagging it so that other programmers can see and fix it. A comment like "#FIXME: This code is unclear: What it does is...." is perfectly acceptable.

Comments are for collaboration. You do NOT want to make them even appear useful for debugging.