Divertenti, deliranti, arguti, questi alcuni aggettivi che mi vengono in mente leggendo i commenti estratti dal codice che porponiamo di seguito. Una raccolta di sensazioni, riflessioni e stati d’animo che programmatori sparsi per il mondo hanno affidato ai commenti del loro codice per futura memoria propria o per chi “erediterà”  il loro lavoro.

// Quando ho scritto questo, solo Dio e io sapevamo cosa avevo fatto
// Adesso, solo Dio lo sa

// Sono ubriaco : lo sistemerò dopo

// Magico. Non toccare

double penetration; // ouch

// Non sono sicuro se questo serva davvero ma ho troppa paura 
// ad eliminarlo

// Non sono responsabile di questo codice.
// Me l'hanno fatto scrivere contro la mia volontà.

// Devo trovare un lavoro migliore

// hack per IE (supponendo che IE sia un browser)

try {

}
catch (SQLException ex) {
 // In sostanza, senza dire troppo, sei fregato. Regalmente e totalmente.
}
catch(Exception ex)
{
// Se pensavate di essere fregati prima, 
// ragazzo ho cattive notizie per te!!!
}

// Se stai leggendo questo, significa che sei stato 
// messo a capo del mio progetto precedente.
// Mi dispiace davvero tanto per te!

// Se questo codice funziona è stato scritto da Paul. 
// Se non funziona io non so chi l'ha scritto

// Non ti aspettare di capire questo

// Lasciate ogni speranza voi che arrivate in questo punto

// Se dal futuro leggerò questo, tornerò indietro nel tempo per uccidermi

/* Per favore funziona */

// Nessun commento per questo
// E' stato difficile da scrivere
// quindi deve esere difficile da leggere

last = first  // Citazione biblica

// rimuovere il commento dalla riga seguente se il program manager 
// cambia di nuovo idea questa settimana

// Se non capisci questo codice dovresti seriamente pensare 
// di andare a cuocere hamburger

/* Ah ah ah! Non riuscirai mai a capire perché questo funziona. */

// Questo lavoro sarebbe bello se non fosse per i cazzo di clienti.

// Questo dovrebbe risolvere qualcosa che non dovrebbe mai accadere

/* E ora,  quello che segue serve per visualizzare 
   decemente il tutto nel fratello ritardato della famiglia dei browser, 
   Internet fottuto Explorer */

// Non capisco come funziona il seguente pezzo di codice, 
// ma ha funzionato nel programma da cui l'ho rubato.

// Aggiunto perché il capo ha cambiato idea: 20020111,20020501, ...
// Commentato perché il capo ha cambiato idea: 20020201,20020614, ...

/* ===== Non modificare mai al di sotto di questa linea. 
   Mai. O ti prendo a calci in culo. ==== */

// Questo codice funzionava prima che il mio gatto decidesse 
// di fare una passeggiata sulla mia tastiera ...

// Tenere a portata di mano il Prozac se le cose si mettono male!

Riferimenti

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