Part of the job of a programmer is to document the code by writing comments within it, to help the next codemonkey figure out why the code does what it does (or not). Sometimes when you work in a home office, say, the comments become a stream of consciousness, almost like a diary, as you forget that other people might someday read your comments. More often, though, you find yourself cracking jokes to help you and the next programmer pass the time.
SQWORD GetGlobalTime( const TCHAR* Filename )
//return greenwich mean time as expressed in nanoseconds since the
//creation of the universe. time is expressed in meters, so
//divide by the speed of light to obtain seconds. assumes the
//speed of light in a vacuum is constant. the file specified by
//Filename is assumed to be in your reference frame, otherwise you
//must transform the result by the path integral of the minkowski
//metric tensor in order to obtain the correct result.
I though this one would appeal to the space cadets here. Comment lines are introduced by “//”, and there’s only one line of actual code in this function. Which just returns the time.
This example comes from The DailyWTF, which is a blog somehow linked to The Register web site, about the crazy/stupid things programmers do, that cause their colleagues to exclaim “WTF???”. I read it every day, using the “random” button to go back and read old articles. If you ever want to learn what it’s really like to be a programmer or work in IT, check it out.