Researching for the yesterday's post ("Look, I am playing tennis" or how to document your code), I stumbled on a interesting topic, and that is "funny comments".
While initially the post advised against it, I found some that are really funny so I would like to list some of them here. While they are not useful, they do increase the quality of the code by making the other developers laugh.
But there is a danger that some might not get our humour so when in doubt, better don't add it.
/**
* 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.
*/
// 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
// sometimes I believe compiler ignores all my comments
// I dedicate all this code, all my work, to my wife, Darlene, who will
// have to support me and our three children and the dog once it gets
// released into the public.
// somedev1 - 6/7/02 Adding temporary tracking of Login screen
// somedev2 - 5/22/07 Temporary my ass
// drunk, fix later
// Magic. Do not touch.
#define TRUE FALSE //Happy debugging suckers
Catch (Exception e) {
//who cares?
}
/*
* You may think you know what the following code does.
* But you don't. Trust me.
* Fiddle with it, and you'll spend many a sleepless
* night cursing the moment you thought you'd be clever
* enough to "optimize" the code below.
* Now close this file and go play with something else.
*/
//This code sucks, you know it and I know it.
//Move on and call me an idiot later.
// I am not sure if we need this, but too scared to delete.
// I am not responsible of this code.
// They made me write it, against my will.
// I have to find a better job
// hack for ie browser (assuming that ie is a browser)
// If you’re reading this, that means you have been put in charge of my previous project.
// I am so, so sorry for you. God speed.
// If this code works, it was written by Paul. If not, I don’t know who wrote it
//You are not expected to understand this
// This is crap code but it’s 3 a.m. and I need to get this working.
// Abandon all hope, ye who enter here.
From: here and here
No comments:
Post a Comment
Note: Only a member of this blog may post a comment.