¿Cuál es el mejor comentario en el código fuente que hayas encontrado? [cerrado]

Resuelto Robert Harvey asked hace 16 años • 0 respuestas

¿Cuál es el mejor comentario en el código fuente que hayas encontrado?

Robert Harvey avatar Oct 09 '08 03:10 Robert Harvey
Aceptado

Soy particularmente culpable de esto, incrustando comentarios no constructivos, poesía codificada y pequeñas bromas en la mayoría de mis proyectos (aunque generalmente tengo suficiente sentido común para eliminar cualquier cosa directamente ofensiva antes de publicar el código). Aquí hay uno que me gusta especialmente, colocado muy, muy debajo de un 'Objeto Divino' mal diseñado:

/**
* For the brave souls who get this far: You are the chosen ones,
* the valiant knights of programming who toil away, without rest,
* fixing our most awful code. To you, true saviors, kings of men,
* I say this: never gonna give you up, never gonna let you down,
* never gonna run around and desert you. Never gonna make you cry,
* never gonna say goodbye. Never gonna tell a lie and hurt you.
*/

¡¡¡¡LO LAMENTO!!!! ¡Simplemente no pude evitarlo...!

Y otro, que admito que en realidad no he liberado, aunque estoy muy tentado a hacerlo en una de mis clases menos intuitivas:

// 
// Dear maintainer:
// 
// Once you are done trying to 'optimize' this routine,
// and have realized what a terrible mistake that was,
// please increment the following counter as a warning
// to the next guy:
// 
// total_hours_wasted_here = 42
// 
Jens Roland avatar Jan 27 '2009 02:01 Jens Roland
Exception up = new Exception("Something is really wrong.");
throw up;  //ha ha
 avatar Feb 14 '2009 19:02
//When I wrote this, only God and I understood what I was doing
//Now, God only knows
 avatar Nov 25 '2008 02:11