¿Cuál es el mejor comentario en el código fuente que hayas encontrado? [cerrado]
¿Cuál es el mejor comentario en el código fuente que hayas encontrado?
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
//
Exception up = new Exception("Something is really wrong.");
throw up; //ha ha
//When I wrote this, only God and I understood what I was doing
//Now, God only knows