A colleague at work forwarded this link on our Dev chat channel and led me to a good session of unproductive hilarity. Code comments, when they are present, are a reflection of the personality of the programmers and it is great to see that as a community, we have quite a good sense of humor. I’ve compiled in the following list the 1o comments I found were the most hilarious or relevant. Of course this is my Top 10 and thus highly subjective:
// 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 = 39/** * 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. */Exception up = new Exception("Something is really wrong."); throw up;// somedev1 - 6/7/02 Adding temporary tracking of Login screen // somedev2 - 5/22/07 Temporary my ass#define TRUE FALSE //Happy debugging suckersif (/*you*/ $_GET['action']) { //celebrate// If this code works, it was written by Paul DiLascia. If not, I don't know who //wrote it.//When I wrote this, only God and I understood what I was doing //Now, God only knows// drunk, fix later// Magic. Do not touch.
Visit the link for more nuggets and context on some the comments listed above. What is the “best” code comment you ever saw?