What is the best comment in source code you have ever encountered?

[KentPhilip]

"Full UK backup"
was abbreviated to: fuk

[NotAllThere]

...'this shouldn't happen'

Now a feature of many languages : ASSERT.

// I have used "HIPPOTAMUS" as the EOF marker, as there is no EOF marker in this sorry excuse for a language.

The language was RPF - ROSCOE Programming Facility.

[SimonMac]

"Full UK backup"
was abbreviated to: fuk

Shouldn't that be FUKUP

[doodab]

// We're going to need some better programmers

[BrilloPad]

1. you will never figure this code out - this is the recipe for a really good cocktail instead <recipe listed>.
2. this is a pdp 11-70 not the starship enterprise.

[MyUserName]

A file in the middle of a hideous 3G telecoms algorithm had not changed for years and the last change was:

// this does not work, will fix it

[DimPrawn]

// TODO
// 1. Post on CUK
// 2. Get phone number of girl in accounts
// 3. Send invoice
// 4. Get contract renewed AND THEN
// 5. Remove this TODO list from source code

[KentPhilip]

Shouldn't that be FUKUP

Good idea. I'll change the job name on our live server right now

[bobspud]

In a unix script for a bank back in the 90's...

## speed this up by replacing /dev/rmt0 with /dev/null

[CourtesyFlush]

In a very long sql stored proc :

//There's a problem somewhere between here

..... 500 lines of code

//and here and I'm buggered if I can find it.

The sproc was around 5000 lines long IIRC. This was at a very large trading floor in London.