Unusual Code Comments

[Bod]

    /// The point of this is to work around his poor design so that paging will 
    /// work on a mobile control. The main problem is the BindCompany() method, 
    /// which he hoped would be able to do everything. I hope he dies.

	 *
	 * You are not expected to understand this.

and my personal favourite.....

	 * The value returned here has many subtle implications.

[ControlG]

Seen many years ago in a BASIC program

i = 10
REM Just to make sure
i = 10

[ASB]

Not a comment but I always liked a line of code:-

perform buggery until cock is sore.

[malvolio]

Not a coding issue as such but many years back a piece of software (called Dracula, would you believe) was used to verify circuit designs on chips - may still be, for all I know. One design failed regularly and it took the experts some time to work out that the designer had drawn a picture of a duck in the middle of the circuit...

[rootsnall]

I left some witty (?) stuff in some ropey code I left behind while working overseas years ago. I'd forgot all about it until quite a number of years later somebody tapped me on the shoulder at a totally unrelated contract and informed me they were the poor soul who inherited it.

[moorfield]

I've seen

Bond jamesBond = new Bond()

a few times on the last two gigs.

It's not funny and it's not clever, whoever you are.

[RSoles]

I once came across

PUSH B ;save B&C on stack
PUSH H ;save H&L on stack
LXI B,0 ;load 0 into B&C registers
LXI H,0 ;load 0 into H&L registers

Classic case of commenting what the code does rather than WHY it does it.



Also, on a different contract I had a situation where under a certain set of circumstances the system failed to respond correctly.
looking at the code (nested about five 'if' levels down)

else
{
// really must put some code here
}

[VectraMan]

Classic case of commenting what the code does rather than WHY it does it.

I've often seen:

// increment x
x++;

It's from people who believe that writing comments are what makes good code.

[Zippy]

/// Author: PreviousContractor
/// MadeToWorkBy: Zip's colleague

[Muttley08]

Saw this once...

# need another screen refresh, don't know why

this meant another complete set of queries to the database across the WAN - >10 Mb (10 yrs ago), when that was a chunk of WAN and latency with crap queries anyway.