无意间在
Stack Overflow上看到了这个有趣的讨论,标题为
“What is the best comment in source code you have ever encountered?”。发现国外的程序猿原来都是那么逗!原文包含的内容太多,就摘录了一些评价共鸣较多的跟大家分享。开始就读读英文的吧,如果喜欢的人多,我再整理翻译!
/**
* 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.
*/
//I'M SORRY!!!! I just couldn't help myself.....!
// I know the line below is wrong, but it came that way from our IP vendor, and
// the driver won't work if you "fix" it. I've had to revert this change 4 times
// now. Leave it alone, or I will hunt you down and hurt you
if (r = 0) {
/* bunch of code here */
}
else
{
/* even more code here */
}
// this comment included for the benefit of anyone grepping for swearwords: shit.
// This comment is self explanatory.
doRun.run(); // ... "a doo run run".
// 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
//
// sometimes I believe compiler ignores all my comments
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
// 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.
// drunk, fix later
// Magic. Do not touch.
return 1; # returns 1
double penetration; // ouch
/// this is a well commented line
// 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.
/* Please work */
/* You are not meant to understand this */
/* You should feel my soul */
// This shouldn't happen. The only way this can happen is if the
// JFileChooser
has returned a File
that doesn't exist
// on the system. If this happens we can't recover, and there is more than likely
// a rip in the space time continuum that the user is too distracted by to notice
// anything else.
//Dear future me. Please forgive me.
//I can’t even begin to express how sorry I am.
options.BatchSize = 300; //Madness? THIS IS SPARTA!
// I have to find a better job
// hack for ie browser (assuming that ie is a browser)
} catch (PartInitException pie) {
// Mmm… pie
}
// John! If you’ll svn remove this once more,
// I’ll shut you, for God’s sake!
// That piece of code is not “something strange”!
// That is THE AUTH VALIDATION.
try {
}
catch (SQLException ex) {
// Basically, without saying too much, you’re screwed. Royally and totally.
}
catch(Exception ex)
{
//If you thought you were screwed before, boy have I news for you!!!
}
// Catching exceptions is for communists
// 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 i ever see this again i’m going to start bringing guns to work
// The magnitude of this hack compares favorably with that of the national debt.
//ALL YOUR BASE ARE BELONG TO US
// 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
/** If you don’t understand this code, you should be flipping burgers instead.*/
‘NO COMMENT
//Abandon all hope yea who enter beyond this point
//Mr. Compiler, please do not read this.
catch (Ex as Exception)
{
// oh crap, we should do something.
}
// TODO make this work
// If you delete the credits, I will fucking kill you.
// This is crap code but it’s 3 a.m. and I need to get this working.
// For the sins I am about to commit, may James Gosling forgive me
// Houston, we have a problem
// If I from the future read this I’ll back in time and kill myself.
//Code sanitized to protect the foolish.
// somedev1 - 6/7/02 Adding temporary tracking of Login screen
// somedev2 - 5/22/07 Temporary my ass
using System;
namespace Mobile.Web.Control
{
///
/// Class used to work around Richard being a fucking idiot
///
///
/// The point of this is to work around his poor design so that paging will
/// work on a mobile control. The main problem is the BindCompany() method,
/// which he hoped would be able to do everything. I hope he dies.
///
public abstract class RichardIsAFuckingIdiotControl : MobileBaseControl, ICompanyProfileControl
{
protected abstract Pager Pager { get; }
public void BindCompany(int companyId) { }
public RichardIsAFuckingIdiotControl()
{
MakeSureNobodyAccidentallyGetsBittenByRichardsStupidity();
}
private void MakeSureNobodyAccidentallyGetsBittenByRichardsStupidity()
{
// Make sure nobody is actually using that fucking bindcompany method
MethodInfo m = this.GetType().GetMethod("BindCompany", BindingFlags.DeclaredOnly |
BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic);
if (m != null)
{
throw new RichardIsAFuckingIdiotException("No!! Don't use the fucking BindCompany method!!!");
}
// P.S. this method is a joke ... the rest of the class is fucking serious
}
///
/// This returns true if this control is supposed to be doing anything
/// at all for this request. Richard thought it was a good idea to load
/// the entire website during every request and have things turn themselves
/// off. He also thought bandanas and aviator sunglasses were "fuckin'
/// gnarly, dude."
///
protected bool IsThisTheRightPageImNotSureBecauseRichardIsDumb()
{
return Request.QueryString["Section"] == this.MenuItemKey;
}
protected override void OnLoad(EventArgs e)
{
if (IsThisTheRightPageImNotSureBecauseRichardIsDumb())
{
Page.LoadComplete += new EventHandler(Page_LoadComplete);
Pager.RowCount = GetRowCountBecauseRichardIsDumb();
}
base.OnLoad(e);
}
protected abstract int GetRowCountBecauseRichardIsDumb();
protected abstract void BindDataBecauseRichardIsDumb();
void Page_LoadComplete(object sender, EventArgs e)
{
BindDataBecauseRichardIsDumb();
}
// the rest of his reduh-ndant interface members
public abstract string MenuItemName { get; set; }
public abstract string MenuItemKey { get; set; }
public abstract bool IsCapable(CapabilityCheck checker, int companyId);
public abstract bool ShowInMenu { get; }
public virtual Control CreateHeaderControl()
{
return null;
}
}
}
--Collected by Tao