coding style, continuing education

[Richard Kenner]

    with a thoroughly misleading comment above it (is that what the entire
    conditional does? no, it's what the first clause does), 

That raises an interesting issue: where *does* the comment for what the first
clause does go?  I've been putting it before the entire statement, but,
as you point out, that's not ideal.  Should we be doing something like:

	/* This tells when we need to ....  */

	if (
	    /* We need to if ... */
	    <conditional expression>
	    /* ... or if ... */
            <next conditional expression>