blocks|key|5169335|text|我对此特别内疚，在我的大多数项目中嵌入了非建设性的评论，代码诗歌和小笑话(尽管我通常有足够的判断力在发布代码之前删除任何直接冒犯的东西)。这里有一个我特别喜欢的，放在一个设计很差的“上帝物件”下面：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|5169336|/**
*+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.
*/|code-block|syntax|javascript|5169337|我很抱歉！我就是情不自禁...！|offset|length|style|BOLD|5169338|还有另一个，我承认我实际上还没有发布，尽管我很想在我的一个不太直观的类中这样做：|5169339|//+
//+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
//+|5169340|entityMap^0|0|0|0|5|0|0|0^^$0|@$1|2|3|4|5|6|7|S|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|T|8|@]|9|@]|A|$E|F]]|$1|G|3|H|5|6|7|U|8|@$I|V|J|W|K|L]]|9|@]|A|$]]|$1|M|3|N|5|6|7|X|8|@]|9|@]|A|$]]|$1|O|3|P|5|D|7|Y|8|@]|9|@]|A|$E|F]]|$1|Q|3|-4|5|6|7|Z|8|@]|9|@]|A|$]]]|R|$]]

I am particularly guilty of this, embedding non-constructive comments, code poetry and little jokes into most of my projects (although I usually have enough sense to remove anything directly offensive before releasing the code). Here's one I'm particulary fond of, placed far, far down a poorly-designed 'God Object':

<pre><code>/**
* 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.
*/
</code></pre>

I'M SORRY!!!! I just couldn't help myself.....!

And another, which I'll admit I haven't actually released into the wild, even though I am very tempted to do so in one of my less intuitive classes:

<pre><code>// 
// 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
// 
</code></pre>

blocks|key|1440048|text|Exception+up+=+new+Exception("Something+is+really+wrong.");
throw+up;++//ha+ha|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1440049|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>Exception up = new Exception("Something is really wrong.");
throw up; //ha ha
</code></pre>

blocks|key|1638446|text|//When+I+wrote+this,+only+God+and+I+understood+what+I+was+doing
//Now,+God+only+knows|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1638447|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>//When I wrote this, only God and I understood what I was doing
//Now, God only knows
</code></pre>

blocks|key|1636570|text|stop();+//+Hammertime!|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1636571|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>stop(); // Hammertime!
</code></pre>

blocks|key|5172090|text|这似乎阻止了笨蛋们弄乱我的代码……|type|unstyled|depth|inlineStyleRanges|entityRanges|data|5172091|//+Autogenerated,+do+not+edit.+All+changes+will+be+undone.|code-block|syntax|javascript|5172092|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

This seems to stop morons from messing my code...

<pre><code>// Autogenerated, do not edit. All changes will be undone.
</code></pre>

blocks|key|3748508|text|//+sometimes+I+believe+compiler+ignores+all+my+comments|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3748509|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>// sometimes I believe compiler ignores all my comments
</code></pre>

blocks|key|5166478|text|//+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.|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|5166479|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>// 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.
</code></pre>

blocks|key|5164564|text|type|unstyled|depth|inlineStyleRanges|entityRanges|data|5164565|+//代码经过净化以保护愚蠢的人。using+System；using+System.Collections.Generic；using+System.Text；using+System.Reflection；using+System.Web.UI；namespace+Mobile.Web.Control+{/类过去解决理查德是个该死的笨蛋的问题/这是为了解决他糟糕的设计，以便在移动控件上/进行分页。主要的问题是BindCompany()方法，/他希望它能做任何事情。我希望他死。/公共抽象类RichardIsAFuckingIdiotControl+:+MobileBaseControl，ICompanyProfileControl+{受保护的抽象寻呼机{+get；}公共空BindCompany(int+companyId)+{}公共RichardIsAFuckingIdiotControl()+{+MakeSureNobodyAccidentallyGetsBittenByRichardsStupidity()；}+private+void+MakeSureNobodyAccidentallyGetsBittenByRichardsStupidity()+{+//确保没有人实际使用那个该死的绑定公司方法MethodInfo+m=+this.GetType().GetMethod("+bindcompany+"，BindingFlags.DeclaredOnly+%7C+BindingFlags.Instance+%7C+BindingFlags.Public+%7C+BindingFlags.NonPublic)；如果(m+!=+null)+{抛出新的RichardIsAFuckingIdiotException("No!！不要使用他妈的BindCompany方法！“)；}+//+P.S.这个方法是个笑话...类的其余部分是他妈的严肃的}/如果这个控件被认为对这个请求做了任何事情，/则返回true。Richard认为在每次请求时加载/整个网站并关闭/是个好主意。他还认为头巾和飞行员太阳镜是“他妈的/讨厌的，伙计。”/受保护的布尔节{+return+IsThisTheRightPageImNotSureBecauseRichardIsDumb()“Request.QueryString”==+this.MenuItemKey；}+protected+override+void+OnLoad(EventArgs+e)+{+if+(IsThisTheRightPageImNotSureBecauseRichardIsDumb())+{+Page.LoadComplete+%2B=+EventHandler(Page_LoadComplete)；Pager.RowCount+=+GetRowCountBecauseRichardIsDumb()；}+base.OnLoad(+e)；}受保护抽象int+GetRowCountBecauseRichardIsDumb()；受保护抽象空BindDataBecauseRichardIsDumb()；空Page_LoadComplete(对象发送者，EventArgs+e){+BindDataBecauseRichardIsDumb()；}+//其剩余的剩余接口成员公共抽象字符串MenuItemName+{+get；设置；}公共抽象字符串MenuItemKey+{+get；set；}公共抽象布尔值(CapabilityCheck+IsCapable，int+companyId)；公共抽象布尔值{+get；}公共虚拟控件CreateHeaderControl()+{CapabilityCheck+null；}|blockquote|5164566|5164567|5164568|更新：，代码has+outed+himself的原始作者，所以我必须在它应该得到的地方给予肯定。Dan+McKinley在我开始工作后不久就离开了我所在的公司，他谈到了更多关于代码的内容，解释了一些背景知识和一些'Richard‘写的"WTF's“。|offset|length|style|BOLD|5164569|entityMap|0|LINK|mutability|MUTABLE|url|http://mcfunley.com/438/from-the-annals-of-dubious-achievement|1|http://mcfunley.com/^0|0|0|0|0|0|3|6|H|0|1C|C|1|0^^$0|@$1|2|3|-4|4|5|6|V|7|@]|8|@]|9|$]]|$1|A|3|B|4|C|6|W|7|@]|8|@]|9|$]]|$1|D|3|-4|4|5|6|X|7|@]|8|@]|9|$]]|$1|E|3|-4|4|5|6|Y|7|@]|8|@]|9|$]]|$1|F|3|G|4|5|6|Z|7|@$H|10|I|11|J|K]]|8|@$H|12|I|13|1|14]|$H|15|I|16|1|17]]|9|$]]|$1|L|3|-4|4|5|6|18|7|@]|8|@]|9|$]]]|M|$N|$4|O|P|Q|9|$R|S]]|T|$4|O|P|Q|9|$R|U]]]]

<blockquote>
<pre><code>//Code sanitized to protect the foolish.
using System;
using System.Collections.Generic;
using System.Text;
using System.Reflection;
using System.Web.UI;

namespace Mobile.Web.Control
{
 /// &lt;summary&gt;
 /// Class used to work around Richard being a fucking idiot
 /// &lt;/summary&gt;
 /// &lt;remarks&gt;
 /// 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.
 /// &lt;/remarks&gt;
 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
 }

 /// &lt;summary&gt;
 /// 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."
 /// &lt;/summary&gt;
 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;
 }
 }
}
</code></pre>
</blockquote>

Update: The original author of the code <a href="http://mcfunley.com/438/from-the-annals-of-dubious-achievement" rel="nofollow noreferrer">has outed himself</a> so I must give credit where it is due. <a href="http://mcfunley.com/" rel="nofollow noreferrer">Dan McKinley</a> left the company I was with shortly after I started, and he talks more about the code, explaining some background and a few more "WTF's" that 'Richard' wrote.

blocks|key|3755380|text|//+somedev1+-++6/7/02+Adding+temporary+tracking+of+Login+screen
//+somedev2+-++5/22/07+Temporary+my+ass|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3755381|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>// somedev1 - 6/7/02 Adding temporary tracking of Login screen
// somedev2 - 5/22/07 Temporary my ass
</code></pre>

blocks|key|1442140|text|//+drunk,+fix+later|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1442141|希望我是在开玩笑。我知道写代码的开发人员，我想他是认真的。|unstyled|1442142|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$B|C]]|$1|D|3|E|5|F|7|J|8|@]|9|@]|A|$]]|$1|G|3|-4|5|F|7|K|8|@]|9|@]|A|$]]]|H|$]]

<pre><code>// drunk, fix later
</code></pre>

Wish I were kidding. And knowing the developer who wrote the code, I think he meant it literally.

blocks|key|3748039|text|//+Magic.+Do+not+touch.|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3748040|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>// Magic. Do not touch.
</code></pre>

blocks|key|1643780|text|#define+TRUE+FALSE+++++//Happy+debugging+suckers|type|unstyled|depth|inlineStyleRanges|offset|length|style|CODE|entityRanges|data|1643781|entityMap^0|0|1C|0^^$0|@$1|2|3|4|5|6|7|H|8|@$9|I|A|J|B|C]]|D|@]|E|$]]|$1|F|3|-4|5|6|7|K|8|@]|D|@]|E|$]]]|G|$]]

<code>
 #define TRUE FALSE
 //Happy debugging suckers
</code>

blocks|key|5164667|text|//+I'm+sorry.|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|5164668|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

blocks|key|1442166|text|return+1;+#+returns+1|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1442167|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>return 1; # returns 1
</code></pre>

blocks|key|3748366|text|/*+This+is+O(scary),+but+seems+quick+enough+in+practice.+*/+|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3748367|后面是四个嵌套的for循环|unstyled|3748368|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$B|C]]|$1|D|3|E|5|F|7|J|8|@]|9|@]|A|$]]|$1|G|3|-4|5|F|7|K|8|@]|9|@]|A|$]]]|H|$]]

<pre><code>/* This is O(scary), but seems quick enough in practice. */ 
</code></pre>

followed by four nested for-loops

blocks|key|3754174|text|//+Replaces+with+spaces+the+braces+in+cases+where+braces+in+places+cause+stasis+
+++$str+=+str_replace(array("\{","\}"),"+",$str);|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3754175|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>// Replaces with spaces the braces in cases where braces in places cause stasis 
 $str = str_replace(array("\{","\}")," ",$str);
</code></pre>

blocks|key|1635617|text|当被问及“最好的评论”时，我们的回答都是我们能找到的最差的评论，这充分说明了我们的职业。|type|unstyled|depth|inlineStyleRanges|entityRanges|data|1635618|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|D|8|@]|9|@]|A|$]]|$1|B|3|-4|5|6|7|E|8|@]|9|@]|A|$]]]|C|$]]

It speaks volumes about our profession that when asked about the "best comment", we all answer with the worst comments we can find...

blocks|key|1442447|text|long+john;+//+silver|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1442448|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>long john; // silver
</code></pre>

blocks|key|1441729|text|Catch+(Exception+e)+{
+//who+cares?
}+|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1441730|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>Catch (Exception e) {
 //who cares?
} 
</code></pre>

blocks|key|3751154|text|/**
+*+Always+returns+true.
+*/
public+boolean+isAvailable()+{
++++return+false;
}|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3751155|永远不要依赖评论...|unstyled|3751156|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$B|C]]|$1|D|3|E|5|F|7|J|8|@]|9|@]|A|$]]|$1|G|3|-4|5|F|7|K|8|@]|9|@]|A|$]]]|H|$]]

<pre><code>/**
 * Always returns true.
 */
public boolean isAvailable() {
 return false;
}
</code></pre>

Never rely on a comment...

blocks|key|1637174|text|/*
+*+You+may+think+you+know+what+the+following+code+does.
+*+But+you+dont.+Trust+me.
+*+Fiddle+with+it,+and+youll+spend+many+a+sleepless
+*+night+cursing+the+moment+you+thought+youd+be+clever
+*+enough+to+"optimize"+the+code+below.
+*+Now+close+this+file+and+go+play+with+something+else.
+*/+|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1637175|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>/*
 * You may think you know what the following code does.
 * But you dont. Trust me.
 * Fiddle with it, and youll spend many a sleepless
 * night cursing the moment you thought youd be clever
 * enough to "optimize" the code below.
 * Now close this file and go play with something else.
 */ 
</code></pre>

blocks|key|5167220|text|try+{

}+finally+{+//+should+never+happen+

}|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|5167221|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>try {

} finally { // should never happen 

}
</code></pre>

blocks|key|3754872|text|来自：https://github.com/zepouet/Xee-xCode-4.5/blob/master/XeePhotoshopLoader.m#L108|type|unstyled|depth|inlineStyleRanges|entityRanges|offset|length|data|3754873|//+At+this+point,+I'd+like+to+take+a+moment+to+speak+to+you+about+the+Adobe+PSD
//+format.+PSD+is+not+a+good+format.+PSD+is+not+even+a+bad+format.+Calling+it
//+such+would+be+an+insult+to+other+bad+formats,+such+as+PCX+or+JPEG.+No,+PSD
//+is+an+abysmal+format.+Having+worked+on+this+code+for+several+weeks+now,+my
//+hate+for+PSD+has+grown+to+a+raging+fire+that+burns+with+the+fierce+passion
//+of+a+million+suns.
//
//+If+there+are+two+different+ways+of+doing+something,+PSD+will+do+both,+in
//+different+places.+It+will+then+make+up+three+more+ways+no+sane+human+would
//+think+of,+and+do+those+too.+PSD+makes+inconsistency+an+art+form.+Why,+for
//+instance,+did+it+suddenly+decide+that+*these*+particular+chunks+should+be
//+aligned+to+four+bytes,+and+that+this+alignement+should+*not*+be+included+in
//+the+size?+Other+chunks+in+other+places+are+either+unaligned,+or+aligned+with
//+the+alignment+included+in+the+size.+Here,+though,+it+is+not+included.+Either
//+one+of+these+three+behaviours+would+be+fine.+A+sane+format+would+pick+one.
//+PSD,+of+course,+uses+all+three,+and+more.
//
//+Trying+to+get+data+out+of+a+PSD+file+is+like+trying+to+find+something+in+the
//+attic+of+your+eccentric+old+uncle+who+died+in+a+freak+freshwater+shark
//+attack+on+his+58th+birthday.+That+last+detail+may+not+be+important+for+the
//+purposes+of+the+simile,+but+at+this+point+I+am+spending+a+lot+of+time
//+imagining+amusing+fates+for+the+people+responsible+for+this+Rube+Goldberg+of
//+a+file+format.
//
//+Earlier,+I+tried+to+get+a+hold+of+the+latest+specs+for+the+PSD+file+format.
//+To+do+this,+I+had+to+apply+to+them+for+permission+to+apply+to+them+to+have
//+them+consider+sending+me+this+sacred+tome.+This+would+have+involved+faxing
//+them+a+copy+of+some+document+or+other,+probably+signed+in+blood.+I+can+only
//+imagine+that+they+make+this+process+so+difficult+because+they+are+intensely
//+ashamed+of+having+created+this+abomination.+I+was+naturally+not+gullible
//+enough+to+go+through+with+this+procedure,+but+if+I+had+done+so,+I+would+have
//+printed+out+every+single+page+of+the+spec,+and+set+them+all+on+fire.+Were+it
//+within+my+power,+I+would+gather+every+single+copy+of+those+specs,+and+launch
//+them+on+a+spaceship+directly+into+the+sun.
//
//+PSD+is+not+my+favourite+file+format.|code-block|syntax|javascript|3754874|entityMap|0|LINK|mutability|MUTABLE|url|https://github.com/zepouet/Xee-xCode-4.5/blob/master/XeePhotoshopLoader.m#L108^0|3|26|0|0|0^^$0|@$1|2|3|4|5|6|7|Q|8|@]|9|@$A|R|B|S|1|T]]|C|$]]|$1|D|3|E|5|F|7|U|8|@]|9|@]|C|$G|H]]|$1|I|3|-4|5|6|7|V|8|@]|9|@]|C|$]]]|J|$K|$5|L|M|N|C|$O|P]]]]

From: <a href="https://github.com/zepouet/Xee-xCode-4.5/blob/master/XeePhotoshopLoader.m#L108" rel="nofollow noreferrer">https://github.com/zepouet/Xee-xCode-4.5/blob/master/XeePhotoshopLoader.m#L108</a>

<pre><code>// At this point, I'd like to take a moment to speak to you about the Adobe PSD
// format. PSD is not a good format. PSD is not even a bad format. Calling it
// such would be an insult to other bad formats, such as PCX or JPEG. No, PSD
// is an abysmal format. Having worked on this code for several weeks now, my
// hate for PSD has grown to a raging fire that burns with the fierce passion
// of a million suns.
//
// If there are two different ways of doing something, PSD will do both, in
// different places. It will then make up three more ways no sane human would
// think of, and do those too. PSD makes inconsistency an art form. Why, for
// instance, did it suddenly decide that *these* particular chunks should be
// aligned to four bytes, and that this alignement should *not* be included in
// the size? Other chunks in other places are either unaligned, or aligned with
// the alignment included in the size. Here, though, it is not included. Either
// one of these three behaviours would be fine. A sane format would pick one.
// PSD, of course, uses all three, and more.
//
// Trying to get data out of a PSD file is like trying to find something in the
// attic of your eccentric old uncle who died in a freak freshwater shark
// attack on his 58th birthday. That last detail may not be important for the
// purposes of the simile, but at this point I am spending a lot of time
// imagining amusing fates for the people responsible for this Rube Goldberg of
// a file format.
//
// Earlier, I tried to get a hold of the latest specs for the PSD file format.
// To do this, I had to apply to them for permission to apply to them to have
// them consider sending me this sacred tome. This would have involved faxing
// them a copy of some document or other, probably signed in blood. I can only
// imagine that they make this process so difficult because they are intensely
// ashamed of having created this abomination. I was naturally not gullible
// enough to go through with this procedure, but if I had done so, I would have
// printed out every single page of the spec, and set them all on fire. Were it
// within my power, I would gather every single copy of those specs, and launch
// them on a spaceship directly into the sun.
//
// PSD is not my favourite file format.
</code></pre>

blocks|key|5166034|text|const+int+TEN=10;+//+As+if+the+value+of+10+will+fluctuate...+|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|5166035|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>const int TEN=10; // As if the value of 10 will fluctuate... 
</code></pre>

blocks|key|1441701|text|++++#Christmas+tree+initializer++
++++toConnect+=+[]++
++++toRead+=+++[++]++
++++toWrite+=+[++++]+++
++++primes+=+[++++++]++
++++responses+=+{}++
++++remaining+=+{}++|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1441702|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code> #Christmas tree initializer 
 toConnect = [] 
 toRead = [ ] 
 toWrite = [ ] 
 primes = [ ] 
 responses = {} 
 remaining = {} 
</code></pre>

blocks|key|1437546|text|关于30页xslt的中间部分|type|unstyled|depth|inlineStyleRanges|entityRanges|data|1437547||code-block|syntax|javascript|1437548|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

About the middle of a 30 page xslt

<pre><code>&lt;!-- Here be dragons --&gt;
</code></pre>

blocks|key|3752369|text|long+long+ago;+/*+in+a+galaxy+far+far+away+*/+|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3752370|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>long long ago; /* in a galaxy far far away */ 
</code></pre>

blocks|key|3747588|text|在一个完全没有注释的2000行方法中|type|unstyled|depth|inlineStyleRanges|entityRanges|data|3747589|{+
++{+
++++while+(..+){+
++++++if+(..){
++++++++++}
++++++for+(..+){+
++++++++++}
+++++++++....+(just+putting+in+the+control+flow+here,+imagine+another+few+hundred+ifs)
++++++if(..)+++{
++++++++++++if(..)+++++{
+++++++++++++++++++if(..)+++{
++++++++++++++++...
++++++++++++++++(another+few+hundred+brackets)
+++++++++++++++++++++++}
++++++++++++++++++}
+++++++++}+//endif|code-block|syntax|javascript|3747590|(实际上，有一天我把所有的括号都去掉了，只是为了看看它有多糟糕，没有格式化，我得到了这样的结果：|3747591|{{{{}}{}{}{}{}}{{}{{}{}{}{}{}{}{{}{}}{}{}{{}{}{}{}{}{}{}{}{}{}{}{{}}}{{}{{}}{{{}}}{{}{}{}{}{}{}{}{{}}{}{{{}}{}{{}{}}{{{}}{}{}{}{}}{{}}}{}{{}{}{}{{}{{}}{}}{{}}}{{}}{{}}{{}}{}{{}}{{}}{{}}{{}{}{}}{}{}{{{}}{{}}}{}{}{}{}}{{{}{{}{}{}{{}{}{}{}{}{}}{}}{{}}{{}{}}}{{}}{{}}}{{}}{{}}{}{}{}{}{{}}{{}{}{}{}}}}{}{}}{{}{{{}{}{}{}}}}{{}{{{}}}}{{}{{{}{{}}{}{{}}{}{{}{}}{{}}{}{{}}}{{}}}}{{}{}{}{}{}{{{}++++{{{{}}{}{}{}{}}{{}{{}{}{}{}{}{}{{}{}}{}{}{{}{}{}{}{}{}{}{}{}{}{}{{}}}{{}{{}}{{{}}}{{}{}{}{}{}{}{}{{}}{}{{{}}{}{{}{}}{{{}}{}{}{}{}}{{}}}{}{{}{}{}{{}{{}}{}}{{}}}{{}}{{}}{{}}{}{{}}{{}}{{}}{{}{}{}}{}{}{{{}}{{}}}{}{}{}{}}{{{}{{}{}{}{{}{}{}{}{}{}}{}}{{}}{{}{}}}{{}}{{}}}{{}}{{}}{}{}{}{}{{}}{{}{}{}{}}}}{}{}}{{}{{{}{}{}{}}}}{{}{{{}}}}{{}{{{}{{}}{}{{}}{}{{}{}}{{}}{}{{}}}{{}}}}{{}{}{}{}{}{{{}{}{{}}{}}}{}}{{}}{{}{}}{{}{{}{{}}}}{{{}{{{}}}}}{{{{{}}}}}{}{}{}{{{{}}}{}{}}{{}{{}}}}{}{{}}{}}}{}}{{}}{{}{}}{{}{{}{{}}}}{{{}{{{}}}}}{{{{{}}}}}{}{}{}{{{{}}}{}{}}{{}{{}}}}|3747592|endif出现在第800行附近)|3747593|entityMap^0|0|0|0|0|0^^$0|@$1|2|3|4|5|6|7|O|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|P|8|@]|9|@]|A|$E|F]]|$1|G|3|H|5|6|7|Q|8|@]|9|@]|A|$]]|$1|I|3|J|5|D|7|R|8|@]|9|@]|A|$E|F]]|$1|K|3|L|5|6|7|S|8|@]|9|@]|A|$]]|$1|M|3|-4|5|6|7|T|8|@]|9|@]|A|$]]]|N|$]]

in a completely uncommented 2000 line method 

<pre><code>{ 
 { 
 while (.. ){ 
 if (..){
 }
 for (.. ){ 
 }
 .... (just putting in the control flow here, imagine another few hundred ifs)
 if(..) {
 if(..) {
 if(..) {
 ...
 (another few hundred brackets)
 }
 }
 } //endif
</code></pre>

(I actually grepped out all the brackets one day just to see how bad it was, and, sans formatting, got this:

<pre><code>{{{{}}{}{}{}{}}{{}{{}{}{}{}{}{}{{}{}}{}{}{{}{}{}{}{}{}{}{}{}{}{}{{}}}{{}{{}}{{{}}}{{}{}{}{}{}{}{}{{}}{}{{{}}{}{{}{}}{{{}}{}{}{}{}}{{}}}{}{{}{}{}{{}{{}}{}}{{}}}{{}}{{}}{{}}{}{{}}{{}}{{}}{{}{}{}}{}{}{{{}}{{}}}{}{}{}{}}{{{}{{}{}{}{{}{}{}{}{}{}}{}}{{}}{{}{}}}{{}}{{}}}{{}}{{}}{}{}{}{}{{}}{{}{}{}{}}}}{}{}}{{}{{{}{}{}{}}}}{{}{{{}}}}{{}{{{}{{}}{}{{}}{}{{}{}}{{}}{}{{}}}{{}}}}{{}{}{}{}{}{{{} {{{{}}{}{}{}{}}{{}{{}{}{}{}{}{}{{}{}}{}{}{{}{}{}{}{}{}{}{}{}{}{}{{}}}{{}{{}}{{{}}}{{}{}{}{}{}{}{}{{}}{}{{{}}{}{{}{}}{{{}}{}{}{}{}}{{}}}{}{{}{}{}{{}{{}}{}}{{}}}{{}}{{}}{{}}{}{{}}{{}}{{}}{{}{}{}}{}{}{{{}}{{}}}{}{}{}{}}{{{}{{}{}{}{{}{}{}{}{}{}}{}}{{}}{{}{}}}{{}}{{}}}{{}}{{}}{}{}{}{}{{}}{{}{}{}{}}}}{}{}}{{}{{{}{}{}{}}}}{{}{{{}}}}{{}{{{}{{}}{}{{}}{}{{}{}}{{}}{}{{}}}{{}}}}{{}{}{}{}{}{{{}{}{{}}{}}}{}}{{}}{{}{}}{{}{{}{{}}}}{{{}{{{}}}}}{{{{{}}}}}{}{}{}{{{{}}}{}{}}{{}{{}}}}{}{{}}{}}}{}}{{}}{{}{}}{{}{{}{{}}}}{{{}{{{}}}}}{{{{{}}}}}{}{}{}{{{{}}}{}{}}{{}{{}}}}
</code></pre>

The endif showed up around line 800)

blocks|key|1437650|text|//This+code+sucks,+you+know+it+and+I+know+it.++
//Move+on+and+call+me+an+idiot+later.|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1437651|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>//This code sucks, you know it and I know it. 
//Move on and call me an idiot later.
</code></pre>

blocks|key|3747765|text|//+If+this+comment+is+removed+the+program+will+blow+up+|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3747766|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>// If this comment is removed the program will blow up 
</code></pre>

blocks|key|3754976|text|double+penetration;+//+ouch|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3754977|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>double penetration; // ouch
</code></pre>

blocks|key|5170293|text|///////////////////////////////////////+this+is+a+well+commented+line|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|5170294|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>/////////////////////////////////////// this is a well commented line
</code></pre>

blocks|key|1637432|text|//+I+don't+know+why+I+need+this,+but+it+stops+the+people+being+upside-down

x+=+-x;|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1637433|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>// I don't know why I need this, but it stops the people being upside-down

x = -x;
</code></pre>

blocks|key|1437809|text|其中最经典的是Pierre+de+Fermat对他著名的“最后定理”的评论：“这一页的页边距太小，无法写下证明”。|type|unstyled|depth|inlineStyleRanges|entityRanges|data|1437810|我们花了350多年才找到证据...|1437811|(根据wikipedia的说法，这是原文：)|offset|length|1437812|1437813|+cubos+in+duos+cubos，aut+quadratoquadratum+in+duos+quadratoquadratum，et+generaliter+nullam+in+duos+eiusdem+nominis+fas+dividere+cuius+rei+demonstrationem+mirabilem+sane+detexi.汉克·马基尼是一位不愿接受挑战的人。|blockquote|1437814|1437815|1437816|...and翻译成英文：|1437817|1437818|+(不可能把一个立方体分成两个立方体，或者把一个四次方分成两个四次方，或者一般来说，把高于第二个的任何次方分成两个相同的次方。我发现了一个非常好的证据来证明这一点，这个边界太窄了，无法容纳。)|1437819|1437820|entityMap|0|LINK|mutability|MUTABLE|url|http://en.wikipedia.org/wiki/Fermat's_Last_Theorem^0|0|0|3|9|0|0|0|0|0|0|0|0|0|0^^$0|@$1|2|3|4|5|6|7|11|8|@]|9|@]|A|$]]|$1|B|3|C|5|6|7|12|8|@]|9|@]|A|$]]|$1|D|3|E|5|6|7|13|8|@]|9|@$F|14|G|15|1|16]]|A|$]]|$1|H|3|-4|5|6|7|17|8|@]|9|@]|A|$]]|$1|I|3|J|5|K|7|18|8|@]|9|@]|A|$]]|$1|L|3|-4|5|6|7|19|8|@]|9|@]|A|$]]|$1|M|3|-4|5|6|7|1A|8|@]|9|@]|A|$]]|$1|N|3|O|5|6|7|1B|8|@]|9|@]|A|$]]|$1|P|3|-4|5|6|7|1C|8|@]|9|@]|A|$]]|$1|Q|3|R|5|K|7|1D|8|@]|9|@]|A|$]]|$1|S|3|-4|5|6|7|1E|8|@]|9|@]|A|$]]|$1|T|3|-4|5|6|7|1F|8|@]|9|@]|A|$]]]|U|$V|$5|W|X|Y|A|$Z|10]]]]

One of the most classic ones is the comment made by Pierre de Fermat about his well-known "Last theorem": "The margin of this page is a bit too small to write down the proof".

It took more than 350 years before the proof was found...

(According to <a href="http://en.wikipedia.org/wiki/Fermat&#39;s_Last_Theorem" rel="nofollow noreferrer">wikipedia</a> this is the original text:)

<blockquote>
 Cubum autem in duos cubos, aut
 quadratoquadratum in duos
 quadratoquadratos, et generaliter
 nullam in infinitum ultra quadratum
 potestatem in duos eiusdem nominis fas
 est dividere cuius rei demonstrationem
 mirabilem sane detexi. Hanc marginis
 exiguitas non caperet.
</blockquote>

...and translated into English:

<blockquote>
 (It is impossible to separate a cube
 into two cubes, or a fourth power into
 two fourth powers, or in general, any
 power higher than the second into two
 like powers. I have discovered a truly
 marvellous proof of this, which this
 margin is too narrow to contain.)
</blockquote>

blocks|key|1637196|text|//+I+am+not+sure+if+we+need+this,+but+too+scared+to+delete.+|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1637197|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>// I am not sure if we need this, but too scared to delete. 
</code></pre>

blocks|key|1442851|text|在Java1.2+SwingUtilities中：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|1442852|doRun.run();++//+...+"a+doo+run+run".|code-block|syntax|javascript|1442853|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

From Java 1.2 SwingUtilities:

<pre><code>doRun.run(); // ... "a doo run run".
</code></pre>

blocks|key|1638353|text|#+To+understand+recursion,+see+the+bottom+of+this+file+|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1638354|在文件的底部：|unstyled|1638355|#+To+understand+recursion,+see+the+top+of+this+file|1638356|entityMap^0|0|0|0^^$0|@$1|2|3|4|5|6|7|K|8|@]|9|@]|A|$B|C]]|$1|D|3|E|5|F|7|L|8|@]|9|@]|A|$]]|$1|G|3|H|5|6|7|M|8|@]|9|@]|A|$B|C]]|$1|I|3|-4|5|F|7|N|8|@]|9|@]|A|$]]]|J|$]]

<pre><code># To understand recursion, see the bottom of this file 
</code></pre>

At the bottom of the file:

<pre><code># To understand recursion, see the top of this file
</code></pre>

blocks|key|1437716|text|我经历了一次睡眠不足的编码运行，开始只写一些引用了Fight+Club的评论。|type|unstyled|depth|inlineStyleRanges|entityRanges|data|1437717|多年后，我仍然在代码中翻找，我发现了一个让我发笑的注释。它们中的大多数都是随机的想法。然而，我确实保持了我的评论与行数的比例相当好！|1437718|//+This+shouldn't+happen.+The+only+way+this+can+happen+is+if+the
//+<code>JFileChooser</code>+has+returned+a+<code>File</code>+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.|code-block|syntax|javascript|1437719|1437720|+/**
+++*+This+method+leverages+collective+synergy+to+drive+"outside+of+the+box"
+++*+thinking+and+formulate+key+objectives+into+a+win-win+game+plan+with+a
+++*+quality-driven+approach+that+focuses+on+empowering+key+players+to+drive-up
+++*+their+core+competencies+and+increase+expectations+with+an+all-around
+++*+initiative+to+drive+down+the+bottom-line.+I+really+wanted+to+work+the+word
+++*+"mandrolic"+in+there,+but+that+word+always+makes+me+want+to+punch+myself+in
+++*+the+face.
+++*/
private+void+updateFileCountLabel()+{|1437721|entityMap^0|0|0|0|0|0^^$0|@$1|2|3|4|5|6|7|N|8|@]|9|@]|A|$]]|$1|B|3|C|5|6|7|O|8|@]|9|@]|A|$]]|$1|D|3|E|5|F|7|P|8|@]|9|@]|A|$G|H]]|$1|I|3|-4|5|6|7|Q|8|@]|9|@]|A|$]]|$1|J|3|K|5|F|7|R|8|@]|9|@]|A|$G|H]]|$1|L|3|-4|5|6|7|S|8|@]|9|@]|A|$]]]|M|$]]

I went through a sleep-deprived coding run and started only writing comments that were quotes from Fight Club.

Still trawling through the code years later I find a comment that makes me laugh. Most of them just random thoughts. I did however keep my comments to lines ratio pretty good!

<pre><code>// This shouldn't happen. The only way this can happen is if the
// &lt;code&gt;JFileChooser&lt;/code&gt; has returned a &lt;code&gt;File&lt;/code&gt; 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.
</code></pre>

<hr>

<pre><code> /**
 * This method leverages collective synergy to drive "outside of the box"
 * thinking and formulate key objectives into a win-win game plan with a
 * quality-driven approach that focuses on empowering key players to drive-up
 * their core competencies and increase expectations with an all-around
 * initiative to drive down the bottom-line. I really wanted to work the word
 * "mandrolic" in there, but that word always makes me want to punch myself in
 * the face.
 */
private void updateFileCountLabel() {
</code></pre>

blocks|key|1634758|text|许多年前(大约1994年)，我在为一家大型跨国软件公司开发Oracle+PRO*C应用程序，您一定听说过该公司。我正在开发的应用程序是一个大型Oracle应用程序，他们有一个实用程序，可以在夜间运行，整理数据并执行各种聚合计算。每次需要以批处理作业的形式执行任何操作时，它都会被推到这个实用程序中，正如您可以想象的那样，它变成了一个绝对的怪物。值得注意的是，对于如此庞大的程序，它只有很少的评论。|type|unstyled|depth|inlineStyleRanges|entityRanges|data|1634759|它的少数评论之一仍然是我所见过的最好的纯WTF评论……我试图在一个长达数百行的函数中找出一个bug，它的中间是函数中唯一的注释：|1634760|/*+I+did+this+the+other+way+*/|code-block|syntax|javascript|1634761|直到今天，这仍然是我见过的最好的评论。|1634762|entityMap^0|0|0|0|0^^$0|@$1|2|3|4|5|6|7|M|8|@]|9|@]|A|$]]|$1|B|3|C|5|6|7|N|8|@]|9|@]|A|$]]|$1|D|3|E|5|F|7|O|8|@]|9|@]|A|$G|H]]|$1|I|3|J|5|6|7|P|8|@]|9|@]|A|$]]|$1|K|3|-4|5|6|7|Q|8|@]|9|@]|A|$]]]|L|$]]

Many years ago (about 1994) I was working on a Oracle PRO*C application for a large multi-national software company that you will have heard of. The app I was working on was a massive Oracle application and they had a utility that ran overnight tidying up data and doing all sorts of aggregate calculations. Every time anything needed doing as a batch job, it got shoved into this utility and as you can imagine it became an absolute monstrosity. It was also notable for the tiny number of comments that it had for such a massive program.

One of the few comments it did have remains the finest comment I have ever seen for pure WTF'ness... I was trying to find a bug in a function which was hundreds of lines long and right in the middle of it was the only comment in the function:

<pre><code>/* I did this the other way */
</code></pre>

To this day it is still the finest comment I have ever seen.

blocks|key|1634638|text|/*+Please+work+*/|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1634639|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>/* Please work */
</code></pre>

blocks|key|5171703|text|//Dear+future+me.+Please+forgive+me.+
//I+can't+even+begin+to+express+how+sorry+I+am.++|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|5171704|我今天才发现了这个：|unstyled|5171705|//private+instance+variable+for+storing+age
public+static+int+age;|5171706|entityMap^0|0|0|0^^$0|@$1|2|3|4|5|6|7|K|8|@]|9|@]|A|$B|C]]|$1|D|3|E|5|F|7|L|8|@]|9|@]|A|$]]|$1|G|3|H|5|6|7|M|8|@]|9|@]|A|$B|C]]|$1|I|3|-4|5|F|7|N|8|@]|9|@]|A|$]]]|J|$]]

<pre><code>//Dear future me. Please forgive me. 
//I can't even begin to express how sorry I am. 
</code></pre>

And I just found this one today:

<pre><code>//private instance variable for storing age
public static int age;
</code></pre>

blocks|key|3746861|text|/*+You+are+not+meant+to+understand+this+*/+|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3746862|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>/* You are not meant to understand this */ 
</code></pre>

blocks|key|1441580|text|//I+am+not+sure+why+this+works+but+it+fixes+the+problem.+|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1441581|这是在一组代码之前，从技术上讲，它确实解决了这个问题，但破坏了其他三个东西……|unstyled|1441582|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$B|C]]|$1|D|3|E|5|F|7|J|8|@]|9|@]|A|$]]|$1|G|3|-4|5|F|7|K|8|@]|9|@]|A|$]]]|H|$]]

<pre><code>//I am not sure why this works but it fixes the problem. 
</code></pre>

This was before a set of code that technically did fix the problem it was meant to but broke 3 other things....

blocks|key|1645014|text|//+no+comments+for+you
//+it+was+hard+to+write
//+so+it+should+be+hard+to+read|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1645015|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>// no comments for you
// it was hard to write
// so it should be hard to read
</code></pre>

blocks|key|3748605|text|/*+Halley's+comment+*/|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3748606|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>/* Halley's comment */
</code></pre>

blocks|key|1638449|text|options.BatchSize+=+300;+//Madness?+THIS+IS+SPARTA!|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1638450|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>options.BatchSize = 300; //Madness? THIS IS SPARTA!
</code></pre>

blocks|key|5165873|text|//+I+have+to+find+a+better+job|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|5165874|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>// I have to find a better job
</code></pre>

blocks|key|1445491|text|我们的DBA在第三方编写的3000行存储过程中发现了这一点。|type|unstyled|depth|inlineStyleRanges|entityRanges|data|1445492|/*+IF+DOLPHINS+ARE+SO+SMART,+HOW+COME+THEY+LIVE+IN+IGLOOS?+*/|code-block|syntax|javascript|1445493|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

Our DBA found this in the middle of a 3000 line stored procedure written by a third party.

<pre><code>/* IF DOLPHINS ARE SO SMART, HOW COME THEY LIVE IN IGLOOS? */
</code></pre>

blocks|key|3751596|text|在js代码中：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|3751597|//+hack+for+ie+browser+(assuming+that+ie+is+a+browser)|code-block|syntax|javascript|3751598|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

on js code:

<pre><code>// hack for ie browser (assuming that ie is a browser)
</code></pre>

blocks|key|1438257|text|/*+Emits+a+7-Hz+tone+for+10+seconds.
++True+story:+7+Hz+is+the+resonant+frequency+of+a
++chicken's+skull+cavity.+This+was+determined
++empirically+in+Australia,+where+a+new+factory
++generating+7-Hz+tones+was+located+too+close+to+a
++chicken+ranch:+When+the+factory+started+up,+all+the
++chickens+died.
++Your+PC+may+not+be+able+to+emit+a+7-Hz+tone.+*/

main()
{
++++sound(7);
++++delay(10000);
++++nosound();
}|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1438258|(+Turbo+C+2.0版参考指南中的声音函数)|unstyled|1438259|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$B|C]]|$1|D|3|E|5|F|7|J|8|@]|9|@]|A|$]]|$1|G|3|-4|5|F|7|K|8|@]|9|@]|A|$]]]|H|$]]

<pre><code>/* Emits a 7-Hz tone for 10 seconds.
 True story: 7 Hz is the resonant frequency of a
 chicken's skull cavity. This was determined
 empirically in Australia, where a new factory
 generating 7-Hz tones was located too close to a
 chicken ranch: When the factory started up, all the
 chickens died.
 Your PC may not be able to emit a 7-Hz tone. */

main()
{
 sound(7);
 delay(10000);
 nosound();
}
</code></pre>

(the sound function in the Turbo C version 2.0 Reference Guide)

blocks|key|3752655|text|..。或者去死//母狗|type|unstyled|depth|inlineStyleRanges|entityRanges|data|3752656|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|D|8|@]|9|@]|A|$]]|$1|B|3|-4|5|6|7|E|8|@]|9|@]|A|$]]]|C|$]]

blocks|key|1442117|text|试着在google+code+search上输入你最喜欢的脏话，它会打发很多无聊的小时。下面是我最喜欢的一些例子：|type|unstyled|depth|inlineStyleRanges|entityRanges|offset|length|data|1442118|/*+These+magic+numbers+are+fucking+stupid.+*/

/*+Dear+free+software+world,+do+you+NOW+see+we+are+fucking
+++things+up?!+This+is+insane!+*/

/*+We+will+NOT+put+a+fucking+timestamp+in+the+header+here.+Every
+++time+you+put+it+back,+I+will+come+in+and+take+it+out+again.+*/

#+However,+this+only+works+if+there+are+MULTIPLE+checkboxes!
#+The+fucking+JS+DOM+*changes*+based+on+one+or+multiple+boxes!?!?!
#+Damn+damn+damn+I+hate+the+JavaScript+DOM+so+damn+much!!!!!!

/*+TODO:+this+is+obviously+not+right+...+this+whole+fucking+module
+++sucks+anyway+*/

/*+FIXME:+please+god,+when+will+the+hurting+stop?+Thus+function+is+so
+++fucking+broken+it's+not+even+funny.+*/|code-block|syntax|javascript|1442119|也是我个人最喜欢的|1442120|+#+code+below+replaces+code+above+-+any+problems?
+#+yeah,+it+doesn't+fucking+work.|1442121|entityMap|0|LINK|mutability|MUTABLE|url|http://www.google.com/codesearch^0|3|I|0|0|0|0|0^^$0|@$1|2|3|4|5|6|7|U|8|@]|9|@$A|V|B|W|1|X]]|C|$]]|$1|D|3|E|5|F|7|Y|8|@]|9|@]|C|$G|H]]|$1|I|3|J|5|6|7|Z|8|@]|9|@]|C|$]]|$1|K|3|L|5|F|7|10|8|@]|9|@]|C|$G|H]]|$1|M|3|-4|5|6|7|11|8|@]|9|@]|C|$]]]|N|$O|$5|P|Q|R|C|$S|T]]]]

Try typing your favourite profanity into <a href="http://www.google.com/codesearch" rel="nofollow noreferrer">google code search</a>, it whiles away many a dull hour. Some of my favourite examples:

<pre><code>/* These magic numbers are fucking stupid. */

/* Dear free software world, do you NOW see we are fucking
 things up?! This is insane! */

/* We will NOT put a fucking timestamp in the header here. Every
 time you put it back, I will come in and take it out again. */

# However, this only works if there are MULTIPLE checkboxes!
# The fucking JS DOM *changes* based on one or multiple boxes!?!?!
# Damn damn damn I hate the JavaScript DOM so damn much!!!!!!

/* TODO: this is obviously not right ... this whole fucking module
 sucks anyway */

/* FIXME: please god, when will the hurting stop? Thus function is so
 fucking broken it's not even funny. */
</code></pre>

and my personal favourite

<pre><code> # code below replaces code above - any problems?
 # yeah, it doesn't fucking work.
</code></pre>

blocks|key|1443770|text|在初始化链表时：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|1443771|last+=+first;+/*+Biblical+reference+*/|code-block|syntax|javascript|1443772|简洁明了和搞笑。|1443773|entityMap^0|0|0|0^^$0|@$1|2|3|4|5|6|7|K|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|L|8|@]|9|@]|A|$E|F]]|$1|G|3|H|5|6|7|M|8|@]|9|@]|A|$]]|$1|I|3|-4|5|6|7|N|8|@]|9|@]|A|$]]]|J|$]]

On initialization of a linked list:

<pre><code>last = first; /* Biblical reference */
</code></pre>

Succint and hilarious.

blocks|key|1639378|text|有人抱怨说，“最好的”评论带来的是最糟糕的评论。我看，他们更有趣，所以“更好”，但这是我在read上看到的最好的评论。|type|unstyled|depth|inlineStyleRanges|entityRanges|offset|length|data|1639379|/*
Major+subtleties+ahead:++Most+hash+schemes+depend+on+having+a+"good"+hash
function,+in+the+sense+of+simulating+randomness.++Python+doesn't:++its+most
important+hash+functions+(for+strings+and+ints)+are+very+regular+in+common
cases:

>>>+map(hash,+(0,+1,+2,+3))
[0,+1,+2,+3]
>>>+map(hash,+("namea",+"nameb",+"namec",+"named"))
[-1658398457,+-1658398460,+-1658398459,+-1658398462]
>>>

This+isn't+necessarily+bad!++To+the+contrary,+in+a+table+of+size+2**i,+taking
the+low-order+i+bits+as+the+initial+table+index+is+extremely+fast,+and+there
are+no+collisions+at+all+for+dicts+indexed+by+a+contiguous+range+of+ints.
The+same+is+approximately+true+when+keys+are+"consecutive"+strings.++So+this
gives+better-than-random+behavior+in+common+cases,+and+that's+very+desirable.

OTOH,+when+collisions+occur,+the+tendency+to+fill+contiguous+slices+of+the
hash+table+makes+a+good+collision+resolution+strategy+crucial.++Taking+only
the+last+i+bits+of+the+hash+code+is+also+vulnerable:++for+example,+consider
[i+<<+16+for+i+in+range(20000)]+as+a+set+of+keys.++Since+ints+are+their+own
hash+codes,+and+this+fits+in+a+dict+of+size+2**15,+the+last+15+bits+of+every
hash+code+are+all+0:++they+*all*+map+to+the+same+table+index.

But+catering+to+unusual+cases+should+not+slow+the+usual+ones,+so+we+just+take
the+last+i+bits+anyway.++It's+up+to+collision+resolution+to+do+the+rest.++If
we+*usually*+find+the+key+we're+looking+for+on+the+first+try+(and,+it+turns
out,+we+usually+do+--+the+table+load+factor+is+kept+under+2/3,+so+the+odds
are+solidly+in+our+favor),+then+it+makes+best+sense+to+keep+the+initial+index
computation+dirt+cheap.

The+first+half+of+collision+resolution+is+to+visit+table+indices+via+this
recurrence:

++++j+=+((5*j)+%2B+1)+mod+2**i

For+any+initial+j+in+range(2**i),+repeating+that+2**i+times+generates+each
int+in+range(2**i)+exactly+once+(see+any+text+on+random-number+generation+for
proof).++By+itself,+this+doesn't+help+much:++like+linear+probing+(setting
j+%2B=+1,+or+j+-=+1,+on+each+loop+trip),+it+scans+the+table+entries+in+a+fixed
order.++This+would+be+bad,+except+that's+not+the+only+thing+we+do,+and+it's
actually+*good*+in+the+common+cases+where+hash+keys+are+consecutive.++In+an
example+that's+really+too+small+to+make+this+entirely+clear,+for+a+table+of
size+2**3+the+order+of+indices+is:

++++0+->+1+->+6+->+7+->+4+->+5+->+2+->+3+->+0+[and+here+it's+repeating]

If+two+things+come+in+at+index+5,+the+first+place+we+look+after+is+index+2,
not+6,+so+if+another+comes+in+at+index+6+the+collision+at+5+didn't+hurt+it.
Linear+probing+is+deadly+in+this+case+because+there+the+fixed+probe+order
is+the+*same*+as+the+order+consecutive+keys+are+likely+to+arrive.++But+it's
extremely+unlikely+hash+codes+will+follow+a+5*j%2B1+recurrence+by+accident,
and+certain+that+consecutive+hash+codes+do+not.

The+other+half+of+the+strategy+is+to+get+the+other+bits+of+the+hash+code
into+play.++This+is+done+by+initializing+a+(unsigned)+vrbl+"perturb"+to+the
full+hash+code,+and+changing+the+recurrence+to:

++++j+=+(5*j)+%2B+1+%2B+perturb;
++++perturb+>>=+PERTURB_SHIFT;
++++use+j+%25+2**i+as+the+next+table+index;

Now+the+probe+sequence+depends+(eventually)+on+every+bit+in+the+hash+code,
and+the+pseudo-scrambling+property+of+recurring+on+5*j%2B1+is+more+valuable,
because+it+quickly+magnifies+small+differences+in+the+bits+that+didn't+affect
the+initial+index.++Note+that+because+perturb+is+unsigned,+if+the+recurrence
is+executed+often+enough+perturb+eventually+becomes+and+remains+0.++At+that
point+(very+rarely+reached)+the+recurrence+is+on+(just)+5*j%2B1+again,+and
that's+certain+to+find+an+empty+slot+eventually+(since+it+generates+every+int
in+range(2**i),+and+we+make+sure+there's+always+at+least+one+empty+slot).

Selecting+a+good+value+for+PERTURB_SHIFT+is+a+balancing+act.++You+want+it
small+so+that+the+high+bits+of+the+hash+code+continue+to+affect+the+probe
sequence+across+iterations;+but+you+want+it+large+so+that+in+really+bad+cases
the+high-order+hash+bits+have+an+effect+on+early+iterations.++5+was+"the
best"+in+minimizing+total+collisions+across+experiments+Tim+Peters+ran+(on
both+normal+and+pathological+cases),+but+4+and+6+weren't+significantly+worse.

Historical:++Reimer+Behrends+contributed+the+idea+of+using+a+polynomial-based
approach,+using+repeated+multiplication+by+x+in+GF(2**n)+where+an+irreducible
polynomial+for+each+table+size+was+chosen+such+that+x+was+a+primitive+root.
Christian+Tismer+later+extended+that+to+use+division+by+x+instead,+as+an
efficient+way+to+get+the+high+bits+of+the+hash+code+into+play.++This+scheme
also+gave+excellent+collision+statistics,+but+was+more+expensive:++two
if-tests+were+required+inside+the+loop;+computing+"the+next"+index+took+about
the+same+number+of+operations+but+without+as+much+potential+parallelism
(e.g.,+computing+5*j+can+go+on+at+the+same+time+as+computing+1%2Bperturb+in+the
above,+and+then+shifting+perturb+can+be+done+while+the+table+index+is+being
masked);+and+the+dictobject+struct+required+a+member+to+hold+the+table's
polynomial.++In+Tim's+experiments+the+current+scheme+ran+faster,+produced
equally+good+collision+statistics,+needed+less+code+&+used+less+memory.

Theoretical+Python+2.5+headache:++hash+codes+are+only+C+"long",+but
sizeof(Py_ssize_t)+>+sizeof(long)+may+be+possible.++In+that+case,+and+if+a
dict+is+genuinely+huge,+then+only+the+slots+directly+reachable+via+indexing
by+a+C+long+can+be+the+first+slot+in+a+probe+sequence.++The+probe+sequence
will+still+eventually+reach+every+slot+in+the+table,+but+the+collision+rate
on+initial+probes+may+be+much+higher+than+this+scheme+was+designed+for.
Getting+a+hash+code+as+fat+as+Py_ssize_t+is+the+only+real+cure.++But+in
practice,+this+probably+won't+make+a+lick+of+difference+for+many+years+(at
which+point+everyone+will+have+terabytes+of+RAM+on+64-bit+boxes).
*/|code-block|syntax|javascript|1639380|entityMap|0|LINK|mutability|MUTABLE|url|http://svn.python.org/view/python/trunk/Objects/dictobject.c?rev=53656&view=markup^0|19|4|0|0|0^^$0|@$1|2|3|4|5|6|7|Q|8|@]|9|@$A|R|B|S|1|T]]|C|$]]|$1|D|3|E|5|F|7|U|8|@]|9|@]|C|$G|H]]|$1|I|3|-4|5|6|7|V|8|@]|9|@]|C|$]]]|J|$K|$5|L|M|N|C|$O|P]]]]

Somebody complained that the "best" comment was bringing up the worst comments. IMHO, they're funnier, and so "better", but here's the honest best comment I've ever <a href="http://svn.python.org/view/python/trunk/Objects/dictobject.c?rev=53656&amp;view=markup" rel="nofollow noreferrer">read</a>:

<pre><code>/*
Major subtleties ahead: Most hash schemes depend on having a "good" hash
function, in the sense of simulating randomness. Python doesn't: its most
important hash functions (for strings and ints) are very regular in common
cases:

&gt;&gt;&gt; map(hash, (0, 1, 2, 3))
[0, 1, 2, 3]
&gt;&gt;&gt; map(hash, ("namea", "nameb", "namec", "named"))
[-1658398457, -1658398460, -1658398459, -1658398462]
&gt;&gt;&gt;

This isn't necessarily bad! To the contrary, in a table of size 2**i, taking
the low-order i bits as the initial table index is extremely fast, and there
are no collisions at all for dicts indexed by a contiguous range of ints.
The same is approximately true when keys are "consecutive" strings. So this
gives better-than-random behavior in common cases, and that's very desirable.

OTOH, when collisions occur, the tendency to fill contiguous slices of the
hash table makes a good collision resolution strategy crucial. Taking only
the last i bits of the hash code is also vulnerable: for example, consider
[i &lt;&lt; 16 for i in range(20000)] as a set of keys. Since ints are their own
hash codes, and this fits in a dict of size 2**15, the last 15 bits of every
hash code are all 0: they *all* map to the same table index.

But catering to unusual cases should not slow the usual ones, so we just take
the last i bits anyway. It's up to collision resolution to do the rest. If
we *usually* find the key we're looking for on the first try (and, it turns
out, we usually do -- the table load factor is kept under 2/3, so the odds
are solidly in our favor), then it makes best sense to keep the initial index
computation dirt cheap.

The first half of collision resolution is to visit table indices via this
recurrence:

 j = ((5*j) + 1) mod 2**i

For any initial j in range(2**i), repeating that 2**i times generates each
int in range(2**i) exactly once (see any text on random-number generation for
proof). By itself, this doesn't help much: like linear probing (setting
j += 1, or j -= 1, on each loop trip), it scans the table entries in a fixed
order. This would be bad, except that's not the only thing we do, and it's
actually *good* in the common cases where hash keys are consecutive. In an
example that's really too small to make this entirely clear, for a table of
size 2**3 the order of indices is:

 0 -&gt; 1 -&gt; 6 -&gt; 7 -&gt; 4 -&gt; 5 -&gt; 2 -&gt; 3 -&gt; 0 [and here it's repeating]

If two things come in at index 5, the first place we look after is index 2,
not 6, so if another comes in at index 6 the collision at 5 didn't hurt it.
Linear probing is deadly in this case because there the fixed probe order
is the *same* as the order consecutive keys are likely to arrive. But it's
extremely unlikely hash codes will follow a 5*j+1 recurrence by accident,
and certain that consecutive hash codes do not.

The other half of the strategy is to get the other bits of the hash code
into play. This is done by initializing a (unsigned) vrbl "perturb" to the
full hash code, and changing the recurrence to:

 j = (5*j) + 1 + perturb;
 perturb &gt;&gt;= PERTURB_SHIFT;
 use j % 2**i as the next table index;

Now the probe sequence depends (eventually) on every bit in the hash code,
and the pseudo-scrambling property of recurring on 5*j+1 is more valuable,
because it quickly magnifies small differences in the bits that didn't affect
the initial index. Note that because perturb is unsigned, if the recurrence
is executed often enough perturb eventually becomes and remains 0. At that
point (very rarely reached) the recurrence is on (just) 5*j+1 again, and
that's certain to find an empty slot eventually (since it generates every int
in range(2**i), and we make sure there's always at least one empty slot).

Selecting a good value for PERTURB_SHIFT is a balancing act. You want it
small so that the high bits of the hash code continue to affect the probe
sequence across iterations; but you want it large so that in really bad cases
the high-order hash bits have an effect on early iterations. 5 was "the
best" in minimizing total collisions across experiments Tim Peters ran (on
both normal and pathological cases), but 4 and 6 weren't significantly worse.

Historical: Reimer Behrends contributed the idea of using a polynomial-based
approach, using repeated multiplication by x in GF(2**n) where an irreducible
polynomial for each table size was chosen such that x was a primitive root.
Christian Tismer later extended that to use division by x instead, as an
efficient way to get the high bits of the hash code into play. This scheme
also gave excellent collision statistics, but was more expensive: two
if-tests were required inside the loop; computing "the next" index took about
the same number of operations but without as much potential parallelism
(e.g., computing 5*j can go on at the same time as computing 1+perturb in the
above, and then shifting perturb can be done while the table index is being
masked); and the dictobject struct required a member to hold the table's
polynomial. In Tim's experiments the current scheme ran faster, produced
equally good collision statistics, needed less code &amp; used less memory.

Theoretical Python 2.5 headache: hash codes are only C "long", but
sizeof(Py_ssize_t) &gt; sizeof(long) may be possible. In that case, and if a
dict is genuinely huge, then only the slots directly reachable via indexing
by a C long can be the first slot in a probe sequence. The probe sequence
will still eventually reach every slot in the table, but the collision rate
on initial probes may be much higher than this scheme was designed for.
Getting a hash code as fat as Py_ssize_t is the only real cure. But in
practice, this probably won't make a lick of difference for many years (at
which point everyone will have terabytes of RAM on 64-bit boxes).
*/
</code></pre>

blocks|key|3749293|text|if(m_measures+=/*=*/+--index)
{
++++....|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3749294|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>if(m_measures =/*=*/ --index)
{
 ....
</code></pre>

blocks|key|1439035|text|int+MyFunction()
{
++++//+There+once+was+a+man+named+Dave
++++int+Result+=+0;

++++//+Whose+code+just+wouldn't+behave
++++MyObject+*Ptr+=+new+MyObject();

++++//+He+left+to+go+to+a+meetin'
++++Result+=+Ptr->DoSomething();

++++//+And+left+his+memory+a+leakin'
++++return+Result;
}|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1439036|C%2B%2B评论|unstyled|1439037|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$B|C]]|$1|D|3|E|5|F|7|J|8|@]|9|@]|A|$]]|$1|G|3|-4|5|F|7|K|8|@]|9|@]|A|$]]]|H|$]]

<pre><code>int MyFunction()
{
 // There once was a man named Dave
 int Result = 0;

 // Whose code just wouldn't behave
 MyObject *Ptr = new MyObject();

 // He left to go to a meetin'
 Result = Ptr-&gt;DoSomething();

 // And left his memory a leakin'
 return Result;
}
</code></pre>

C++ Comment

blocks|key|5172064|text|/*
This+isn't+the+right+way+to+deal+with+this,+but+today+is+my+last+day,+Ron
just+spilled+coffee+on+my+desk,+and+I'm+hungry,+so+this+will+have+to+do...
*/

return+12;+//+12+is+my+lucky+number|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|5172065|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>/*
This isn't the right way to deal with this, but today is my last day, Ron
just spilled coffee on my desk, and I'm hungry, so this will have to do...
*/

return 12; // 12 is my lucky number
</code></pre>

blocks|key|1442901|text|++mov+si,+pCard++++++;+captain?|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1442902|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code> mov si, pCard ; captain?
</code></pre>

blocks|key|1637110|text|//+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+*/
}|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1637111|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>// 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 */
}
</code></pre>

blocks|key|1642754|text|从2004年的Windows漏洞，|type|unstyled|depth|inlineStyleRanges|entityRanges|data|1642755|__inline+BOOL
SearchOneDirectory(
++++++++++++++++++IN++LPSTR+Directory,
++++++++++++++++++IN++LPSTR+FileToFind,
++++++++++++++++++IN++LPSTR+SourceFullName,
++++++++++++++++++IN++LPSTR+SourceFilePart,
++++++++++++++++++OUT+PBOOL+FoundInTree
++++++++++++++++++)
{
++++//
++++//+This+was+way+too+slow.+Just+say+we+didn't+find+the+file.
++++//
++++*FoundInTree+=+FALSE;
++++return(TRUE);
}|code-block|syntax|javascript|1642756|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

From the 2004 Windows leak,

<pre><code>__inline BOOL
SearchOneDirectory(
 IN LPSTR Directory,
 IN LPSTR FileToFind,
 IN LPSTR SourceFullName,
 IN LPSTR SourceFilePart,
 OUT PBOOL FoundInTree
 )
{
 //
 // This was way too slow. Just say we didn't find the file.
 //
 *FoundInTree = FALSE;
 return(TRUE);
}
</code></pre>

blocks|key|1643371|text|//+this+comment+included+for+the+benefit+of+anyone+grepping+for+swearwords:+shit.|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1643372|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>// this comment included for the benefit of anyone grepping for swearwords: shit.
</code></pre>

blocks|key|1639774|text|我在某人的代码上看到了这样的评论：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|1639775|//+This+comment+is+self+explanatory.|code-block|syntax|javascript|1639776|我猜他的意思是“变量”，但这个错误引起了一个有趣的评论……想想这里的循环逻辑，以及编写它的徒劳之处。|1639777|entityMap^0|0|0|0^^$0|@$1|2|3|4|5|6|7|K|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|L|8|@]|9|@]|A|$E|F]]|$1|G|3|H|5|6|7|M|8|@]|9|@]|A|$]]|$1|I|3|-4|5|6|7|N|8|@]|9|@]|A|$]]]|J|$]]

I saw this comment on someone's code:

<pre><code>// This comment is self explanatory.
</code></pre>

I guess he meant to say 'variable' but the mistake made one funny comment... Think of the circular logic here, and the futility of writing it.

blocks|key|5170928|text|}+catch+(PartInitException+pie)+{
++++//+Mmm...+pie|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|5170929|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>} catch (PartInitException pie) {
 // Mmm... pie
</code></pre>

blocks|key|1439236|text|不完全是一个评论，而是一个goto标签|type|unstyled|depth|inlineStyleRanges|entityRanges|data|1439237|ICantBelieveImUsingAGoto:|code-block|syntax|javascript|1439238|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

Not quite a comment but a goto label

<pre><code>ICantBelieveImUsingAGoto:
</code></pre>

blocks|key|1641455|text|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!!!
}|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1641456|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>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!!!
}
</code></pre>

blocks|key|1440206|text|class+Act+//That's+me!!!
{

}|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1440207|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>class Act //That's me!!!
{

}
</code></pre>

blocks|key|3746774|text|在必须声明才能将常量传递给库函数的局部变量后面：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|3746775|//+This+only+exists+because+Scott+doesn't+know+how+to+use+const+correctly|code-block|syntax|javascript|3746776|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

Next to a local variable that had to be declared just to pass a constant to a library function:

<pre><code>// This only exists because Scott doesn't know how to use const correctly
</code></pre>

blocks|key|3749015|text|virgin+=+0;+++++/*+you're+not+a+virgin+anymore,+sweety+*/|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3749016|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>virgin = 0; /* you're not a virgin anymore, sweety */
</code></pre>

blocks|key|1441928|text|public+boolean+isDirty()+{
++++//Why+do+you+always+go+out+and
++++return+dirty;
}|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1441929|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>public boolean isDirty() {
 //Why do you always go out and
 return dirty;
}
</code></pre>

blocks|key|1438027|text|+*+...and+don't+just+declare+it+volatile+and+think+you've+solved
+*+the+problem.+You+young+punks+think+you+know+what+volatile
+*+means...+why+in+my+day+we+had+to+cast+it+volatile+uphill
+*+both+ways,+and+the+code+still+didn't+work!+Whippersnappers...|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1438028|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code> * ...and don't just declare it volatile and think you've solved
 * the problem. You young punks think you know what volatile
 * means... why in my day we had to cast it volatile uphill
 * both ways, and the code still didn't work! Whippersnappers...
</code></pre>

blocks|key|1437520|text|最初的末日有一个引擎，它的静态墙不能移动；结果是所有的门都垂直打开；任何东西都不能水平移动。在源代码发布后，当我翻阅代码并在处理门的源文件中看到这一点时，我突然大笑起来，这是一大块注释掉的代码的开头：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|1437521|//+UNUSED
//+Separate+into+p_slidoor.c?

#if+0+++++++++++//+ABANDONED+TO+THE+MISTS+OF+TIME!!!
//
//+EV_SlidingDoor+:+slide+a+door+horizontally
//+(animate+midtexture,+then+set+noblocking+line)
//|code-block|syntax|javascript|1437522|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

The original Doom had an engine with static walls that could not move; the result was that all doors opened vertically; nothing could ever move horizontally. I burst out laughing when, after the source code was released, I was looking through the code and saw this in the source file for handling doors, at the start of a big block of commented-out code:

<pre><code>// UNUSED
// Separate into p_slidoor.c?

#if 0 // ABANDONED TO THE MISTS OF TIME!!!
//
// EV_SlidingDoor : slide a door horizontally
// (animate midtexture, then set noblocking line)
//
</code></pre>

blocks|key|3750456|text|取自Quake+III的源代码，我在一些随机的slashdot帖子中偶然发现了这一点。该文件的完整源代码可以在here中找到。这是一种计算平方根反比的特别快的方法。至于最好的评论是什么？可以肯定的是，这是一个很常见的问题，但考虑到它是附加在做魔法的线上的，这就是它的伟大之处。|type|unstyled|depth|inlineStyleRanges|entityRanges|offset|length|data|3750457|float+Q_rsqrt(+float+number+)
{
++long+i;
++float+x2,+y;
++const+float+threehalfs+=+1.5F;

++x2+=+number+*+0.5F;
++y++=+number;
++i++=+*+(+long+*+)+&y;++//+evil+floating+point+bit+level+hacking
++i++=+0x5f3759df+-+(+i+>>+1+);+//+what+the+fuck?
++y++=+*+(+float+*+)+&i;
++y++=+y+*+(+threehalfs+-+(+x2+*+y+*+y+)+);+//+1st+iteration
++//+y++=+y+*+(+threehalfs+-+(+x2+*+y+*+y+)+);+//+2nd+iteration,+this+can+be+removed

++#ifndef+Q3_VM
++#ifdef+__linux__
++++assert(+!isnan(y)+);+//+bk010122+-+FPE?
++#endif
++#endif
++return+y;
}|code-block|syntax|javascript|3750458|entityMap|0|LINK|mutability|MUTABLE|url|http://www.google.com/codesearch?hl=en&q=quake%2B3%2B%2522what%2Bthe%2Bfuck%2522%2Bshow:1s7s4Tr0knk:uJtln_6bKE0:1s7s4Tr0knk&sa=N&cd=2&ct=rc&cs_p=git://github.com/TTimo/iourt.git&cs_f=code/qcommon/q_math.c^0|1J|4|0|0|0^^$0|@$1|2|3|4|5|6|7|Q|8|@]|9|@$A|R|B|S|1|T]]|C|$]]|$1|D|3|E|5|F|7|U|8|@]|9|@]|C|$G|H]]|$1|I|3|-4|5|6|7|V|8|@]|9|@]|C|$]]]|J|$K|$5|L|M|N|C|$O|P]]]]

Taken from the Quake III source, I stumbled across this in some random slashdot posting. Full source of the file can be found <a href="http://www.google.com/codesearch?hl=en&amp;q=quake+3+%22what+the+fuck%22+show:1s7s4Tr0knk:uJtln_6bKE0:1s7s4Tr0knk&amp;sa=N&amp;cd=2&amp;ct=rc&amp;cs_p=git://github.com/TTimo/iourt.git&amp;cs_f=code/qcommon/q_math.c" rel="nofollow noreferrer">here</a>. It's a particularly fast method of calculating an inverse square root. As for the best comment? It's a common one to be sure, but given that it's attached to the line that does the magic is what makes it great. 

<pre><code>float Q_rsqrt( float number )
{
 long i;
 float x2, y;
 const float threehalfs = 1.5F;

 x2 = number * 0.5F;
 y = number;
 i = * ( long * ) &amp;y; // evil floating point bit level hacking
 i = 0x5f3759df - ( i &gt;&gt; 1 ); // what the fuck?
 y = * ( float * ) &amp;i;
 y = y * ( threehalfs - ( x2 * y * y ) ); // 1st iteration
 // y = y * ( threehalfs - ( x2 * y * y ) ); // 2nd iteration, this can be removed

 #ifndef Q3_VM
 #ifdef __linux__
 assert( !isnan(y) ); // bk010122 - FPE?
 #endif
 #endif
 return y;
}
</code></pre>

blocks|key|3754129|text|def+format_ticket_content(text,+recursive+=+true)
++if+text.is_a?(TicketNote)
++++note+=+text
++++text+=+note.content
++else
++++note+=+nil
++end

++##+Safety+pig+has+arrived!
++text+=+h(text)
++##+++++++++++++++++++++++++++++++_
++##++_._+_..._+.-',+++++_.._(`))
++##+'-.+`+++++'++/-._.-'++++',/
++##++++)+++++++++\++++++++++++'.
++##+++/+_++++_++++%7C+++++++++++++\
++##++%7C++a++++a++++/++++++++++++++%7C
++##++\+++.-.+++++++++++++++++++++;++
++##+++'-(''+).-'+++++++,'+++++++;
++##++++++'-;+++++++++++%7C++++++.'
++##+++++++++\+++++++++++\++++/
++##+++++++++%7C+7++.__++_.-\+++\
++##+++++++++%7C+%7C++%7C++``/++/`++/
++##++++++++/,_%7C++%7C+++/,_/+++/
++##+++++++++++/,_/++++++'`-'
++##+|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3754130|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>def format_ticket_content(text, recursive = true)
 if text.is_a?(TicketNote)
 note = text
 text = note.content
 else
 note = nil
 end

 ## Safety pig has arrived!
 text = h(text)
 ## _
 ## _._ _..._ .-', _.._(`))
 ## '-. ` ' /-._.-' ',/
 ## ) \ '.
 ## / _ _ | \
 ## | a a / |
 ## \ .-. ; 
 ## '-('' ).-' ,' ;
 ## '-; | .'
 ## \ \ /
 ## | 7 .__ _.-\ \
 ## | | | ``/ /` /
 ## /,_| | /,_/ /
 ## /,_/ '`-'
 ## 
</code></pre>

blocks|key|1444508|text|//+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.|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1444509|你觉得呢？下面的代码是安全的“svn删除”。|unstyled|1444510|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$B|C]]|$1|D|3|E|5|F|7|J|8|@]|9|@]|A|$]]|$1|G|3|-4|5|F|7|K|8|@]|9|@]|A|$]]]|H|$]]

<pre><code>// 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.
</code></pre>

And what do you think? The code below was safely ‘svn removed’.

blocks|key|5170967|text|这在我自己的代码中出现过几次。显然我碰过它不止一次：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|5170968|//+TODO:+Fix+this.++Fix+what?|code-block|syntax|javascript|5170969|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

this has turned up in my own code a few times. obviously I touched it more than once:

<pre><code>// TODO: Fix this. Fix what?
</code></pre>

blocks|key|1640713|text|//MailBody+builders+for+two+outgoing+messages
StringBuilder+hanz+=+new+StringBuilder();
StringBuilder+franz+=+new+StringBuilder();|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1640714|当我读到那本书的时候，我仍然会咯咯地笑。|unstyled|1640715|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$B|C]]|$1|D|3|E|5|F|7|J|8|@]|9|@]|A|$]]|$1|G|3|-4|5|F|7|K|8|@]|9|@]|A|$]]]|H|$]]

<pre><code>//MailBody builders for two outgoing messages
StringBuilder hanz = new StringBuilder();
StringBuilder franz = new StringBuilder();
</code></pre>

I still chuckle a little when I read that one...

blocks|key|1437889|text|Repeat
++++...
Until+(JesusChristsReturn)+'+Not+sure|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1437890|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>Repeat
 ...
Until (JesusChristsReturn) ' Not sure
</code></pre>

blocks|key|5173511|text|/*
after+hours+of+consulting+the+tome+of+google
i+have+discovered+that+by+the+will+of+unknown+forces
without+the+below+line,+IE7+believes+that+6px+=+12px
*/
font-size:+0px;|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|5173512|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>/*
after hours of consulting the tome of google
i have discovered that by the will of unknown forces
without the below line, IE7 believes that 6px = 12px
*/
font-size: 0px;
</code></pre>

blocks|key|5172503|text|不记得我在哪里见过这些：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|5172504|long+time;+/*+know+C+*/|code-block|syntax|javascript|5172505|和(在创建某种UNIX守护进程的代码中)：|5172506|/*+Be+a+real+daemon:+fork+myself+and+kill+my+parent+*/|5172507|entityMap^0|0|0|0|0^^$0|@$1|2|3|4|5|6|7|M|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|N|8|@]|9|@]|A|$E|F]]|$1|G|3|H|5|6|7|O|8|@]|9|@]|A|$]]|$1|I|3|J|5|D|7|P|8|@]|9|@]|A|$E|F]]|$1|K|3|-4|5|6|7|Q|8|@]|9|@]|A|$]]]|L|$]]

Don't recall where I've seen these:

<pre><code>long time; /* know C */
</code></pre>

and (in code to create some sort of UNIX daemon):

<pre><code>/* Be a real daemon: fork myself and kill my parent */
</code></pre>

blocks|key|3747095|text|在头文件的顶部：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|3747096|/*+Project+:+XYZ+(Please+somebody+shoot+me!)
+*
+*+File+:+$Id:+defs.h,v+1.1+$
+*
+*+Purpose+:+Create+havoc+rather+than+peace+among+many+nations
+*
+*+History+:+Back-ported+changes+that+were+not+in+CVS.++Please+somebody,
+*++shoot+us+and+put+us+all+out+of+our+misery.
+*/|code-block|syntax|javascript|3747097|"XYZ项目“(更名)是一个长达七年的磨难。最后一条评论是由一个坚定的灵魂写的，他从头到尾都参与其中。|3747098|entityMap^0|0|0|0^^$0|@$1|2|3|4|5|6|7|K|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|L|8|@]|9|@]|A|$E|F]]|$1|G|3|H|5|6|7|M|8|@]|9|@]|A|$]]|$1|I|3|-4|5|6|7|N|8|@]|9|@]|A|$]]]|J|$]]

At the top of a header file:

<pre><code>/* Project : XYZ (Please somebody shoot me!)
 *
 * File : $Id: defs.h,v 1.1 $
 *
 * Purpose : Create havoc rather than peace among many nations
 *
 * History : Back-ported changes that were not in CVS. Please somebody,
 * shoot us and put us all out of our misery.
 */
</code></pre>

The "XYZ project" (name changed) was a seven-year ordeal. That last comment was written by the one stalwart soul who was involved from the very beginning through to the end.

blocks|key|1636962|text|//+Catching+exceptions+is+for+communists|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1636963|来自Mike+Duncan's+page+on+SQLite。|unstyled|offset|length|1636964|entityMap|0|LINK|mutability|MUTABLE|url|http://www.mikeduncan.com/sqlite-on-dotnet-in-3-mins^0|0|2|S|0|0^^$0|@$1|2|3|4|5|6|7|Q|8|@]|9|@]|A|$B|C]]|$1|D|3|E|5|F|7|R|8|@]|9|@$G|S|H|T|1|U]]|A|$]]|$1|I|3|-4|5|F|7|V|8|@]|9|@]|A|$]]]|J|$K|$5|L|M|N|A|$O|P]]]]

<pre><code>// Catching exceptions is for communists
</code></pre>

From <a href="http://www.mikeduncan.com/sqlite-on-dotnet-in-3-mins" rel="nofollow noreferrer">Mike Duncan's page on SQLite</a>.

blocks|key|3753659|text|在drivers/net/sunhme.c+(Linux内核)中：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|3753660|/*+Welcome+to+Sun+Microsystems,+can+I+take+your+order+please?+*/
if(!hp->happy_flags+&+HFLAG_FENABLE)
++++++++return+happy_meal_bb_write(hp,+tregs,+reg,+value);

/*+Would+you+like+fries+with+that?+*/
hme_write32(hp,+&tregs->frame,
++++++++++++(FRAME_WRITE+%7C+(hp->paddr+<<+23)+%7C
+++++++++++++((reg+&+0xff)+<<+18)+%7C+(value+&+0xffff)));
while(!(hme_read32(hp,+&tregs->frame)+&+0x10000)+&&+--tries)
++++++++udelay(20);

/*+Anything+else?+*/
if(!tries)
++++++++printk(KERN_ERR+"happy+meal:+Aieee,+transceiver+MIF+write+bolixed\n");

/*+Fifty-two+cents+is+your+change,+have+a+nice+day.+*/|code-block|syntax|javascript|3753661|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

In drivers/net/sunhme.c (Linux kernel):

<pre><code>/* Welcome to Sun Microsystems, can I take your order please? */
if(!hp-&gt;happy_flags &amp; HFLAG_FENABLE)
 return happy_meal_bb_write(hp, tregs, reg, value);

/* Would you like fries with that? */
hme_write32(hp, &amp;tregs-&gt;frame,
 (FRAME_WRITE | (hp-&gt;paddr &lt;&lt; 23) |
 ((reg &amp; 0xff) &lt;&lt; 18) | (value &amp; 0xffff)));
while(!(hme_read32(hp, &amp;tregs-&gt;frame) &amp; 0x10000) &amp;&amp; --tries)
 udelay(20);

/* Anything else? */
if(!tries)
 printk(KERN_ERR "happy meal: Aieee, transceiver MIF write bolixed\n");

/* Fifty-two cents is your change, have a nice day. */
</code></pre>

blocks|key|5174104|text|//
//3.4++JeK++My+manager+promised+me+a+lap+dance+if+I+can+fix+this+release
//3.5++JeK++Still+waiting+for+that+dance+from+my+manager
//3.6++JeK++My+manager+got+changed,+the+new+manager+is+hairy,+dont+want+the+dance+anymore
//3.7++Jek++Got+that+dance,+yuck!
//|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|5174105|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>//
//3.4 JeK My manager promised me a lap dance if I can fix this release
//3.5 JeK Still waiting for that dance from my manager
//3.6 JeK My manager got changed, the new manager is hairy, dont want the dance anymore
//3.7 Jek Got that dance, yuck!
//
</code></pre>

blocks|key|1438506|text|++++/*+Mark:+If+there's+one+thing+you+learn+from+this+code,+it+is+this...
+++Never,+ever+fly+Air+France.++Their+customer+service+is+absolutely
+++the+worst.++I've+never+heard+the+words+"That's+not+my+problem"+as+
+++many+times+as+I+have+from+their+staff+--+It+should,+without+doubt
+++be+their+corporate+motto+if+it+isn't+already.++Don't+bother+giving+
+++them+business+because+you're+just+a+pain+in+their+side+and+they
+++will+be+sure+to+let+you+know+the+first+time+you+speak+to+them.

+++If+you+ever+want+to+make+me+happy+just+tell+me+that+you,+too,+will
+++never+fly+Air+France+again+either+(in+spite+of+their+excellent
+++cuisine).+

+++Update+by+oej:+The+merger+with+KLM+has+transferred+this
+++behaviour+to+KLM+as+well.+
+++Don't+bother+giving+them+business+either...

+++Only+if+you+want+to+travel+randomly+without+luggage,+you
+++might+pick+either+of+them.
+++*/|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1438507|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code> /* Mark: If there's one thing you learn from this code, it is this...
 Never, ever fly Air France. Their customer service is absolutely
 the worst. I've never heard the words "That's not my problem" as 
 many times as I have from their staff -- It should, without doubt
 be their corporate motto if it isn't already. Don't bother giving 
 them business because you're just a pain in their side and they
 will be sure to let you know the first time you speak to them.

 If you ever want to make me happy just tell me that you, too, will
 never fly Air France again either (in spite of their excellent
 cuisine). 

 Update by oej: The merger with KLM has transferred this
 behaviour to KLM as well. 
 Don't bother giving them business either...

 Only if you want to travel randomly without luggage, you
 might pick either of them.
 */
</code></pre>

blocks|key|5167705|text|这是我之前在PHP+CMS中添加的一条评论。|type|unstyled|depth|inlineStyleRanges|entityRanges|data|5167706|if+(/*you*/+$_GET['action'])+{+//celebrate|code-block|syntax|javascript|5167707|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

A comment I added to a PHP CMS I was working on a while back.

<pre><code>if (/*you*/ $_GET['action']) { //celebrate
</code></pre>

blocks|key|1444663|text|有一次，我在另一次讨论中看到了类似这样的内容：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|1444664|//+I+can't+divide+with+zero,+so+I+have+to+divide+with+something+very+similar
result+=+number+/+0.00000000000001;|code-block|syntax|javascript|1444665|聪明的解决方案，不是吗:)？(如果有人不确定，这是一个笑话)|1444666|entityMap^0|0|0|0^^$0|@$1|2|3|4|5|6|7|K|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|L|8|@]|9|@]|A|$E|F]]|$1|G|3|H|5|6|7|M|8|@]|9|@]|A|$]]|$1|I|3|-4|5|6|7|N|8|@]|9|@]|A|$]]]|J|$]]

Once I saw in another discussion something like this:

<pre><code>// I can't divide with zero, so I have to divide with something very similar
result = number / 0.00000000000001;
</code></pre>

Clever solution, isn't it :) ? (It's a joke if someone's not sure)

blocks|key|5166542|text|为什么你不应该离岸你的软件开发的一个经典案例：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|5166543|public+class+Contact
{
++++//...++++

++++///+<summary>
++++///+Gets+or+sets+the+name+of+the+first.
++++///+</summary>
++++///+<value>The+name+of+the+first.</value>
++++public+string+FirstName
++++{
++++++++get+{+return+_firstName;+}
++++++++set+{+_firstName+=+value;+}
++++}
}|code-block|syntax|javascript|5166544|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

A classic case of why you shouldn't off shore your software development:

<pre><code>public class Contact
{
 //... 

 /// &lt;summary&gt;
 /// Gets or sets the name of the first.
 /// &lt;/summary&gt;
 /// &lt;value&gt;The name of the first.&lt;/value&gt;
 public string FirstName
 {
 get { return _firstName; }
 set { _firstName = value; }
 }
}
</code></pre>

blocks|key|5170587|text|在大学的一次家庭作业中，一位老师特别坚持我们应该对代码进行注释：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|5170588|//I+wonder+if+she+actually+reads+these.|code-block|syntax|javascript|5170589|当作业被退回时，用红色钢笔写在“是的，我愿意”的旁边。|5170590|entityMap^0|0|0|0^^$0|@$1|2|3|4|5|6|7|K|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|L|8|@]|9|@]|A|$E|F]]|$1|G|3|H|5|6|7|M|8|@]|9|@]|A|$]]|$1|I|3|-4|5|6|7|N|8|@]|9|@]|A|$]]]|J|$]]

in a homework assignment in college for a teacher who was particularly adamant that we comment our code:

<pre><code>//I wonder if she actually reads these.
</code></pre>

When the assignment was returned, in red pen next to that comment "Yes, I do"

blocks|key|1638462|text|泄露的Windows2000源代码中的一个很好的例子：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|1638463|1638464|！如果您将制表符改为空格，您将被杀死！*|blockquote|1638465|1638466|！|1638467|!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!！!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!！|1638468|1638469|http://www.kuro5hin.org/story/2004/2/15/71552/7795|offset|length|1638470|entityMap|0|LINK|mutability|MUTABLE|url^0|0|0|0|0|0|0|0|0|1E|0|0^^$0|@$1|2|3|4|5|6|7|W|8|@]|9|@]|A|$]]|$1|B|3|-4|5|6|7|X|8|@]|9|@]|A|$]]|$1|C|3|D|5|E|7|Y|8|@]|9|@]|A|$]]|$1|F|3|-4|5|6|7|Z|8|@]|9|@]|A|$]]|$1|G|3|H|5|6|7|10|8|@]|9|@]|A|$]]|$1|I|3|J|5|6|7|11|8|@]|9|@]|A|$]]|$1|K|3|-4|5|6|7|12|8|@]|9|@]|A|$]]|$1|L|3|M|5|6|7|13|8|@]|9|@$N|14|O|15|1|16]]|A|$]]|$1|P|3|-4|5|6|7|17|8|@]|9|@]|A|$]]]|Q|$R|$5|S|T|U|A|$V|M]]]]

Great one from leaked Windows 2000 source code :

<blockquote>
 !!!!!!!IF YOU CHANGE TABS TO SPACES, YOU WILL BE KILLED!!!!!!! * 
 !!!!!!!!!!!!!!DOING SO FUCKS THE BUILD
 PROCESS!!!!!!!!!!!!!!!! * 
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
</blockquote>

<a href="http://www.kuro5hin.org/story/2004/2/15/71552/7795" rel="nofollow noreferrer">http://www.kuro5hin.org/story/2004/2/15/71552/7795</a>

blocks|key|3751341|text|//+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.|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3751342|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>// 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.
</code></pre>

blocks|key|3751030|text|//+The+ratio+of+a+circle's+circumference+to+its+diameter.++Remember+to+change
//+this+to+3.0+if+you+move+to+a+site+in+Indiana.

#define+Pi++++++++++++++++++++++++++++++++++++++3.1415927|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3751031|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>// The ratio of a circle's circumference to its diameter. Remember to change
// this to 3.0 if you move to a site in Indiana.

#define Pi 3.1415927
</code></pre>

blocks|key|1438054|text|//+human+madable+inconvenient.+Way+too+sucks.|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1438055|我仍然不完全理解它的含义，但我发现它在很多代码中是非常正确的。|unstyled|1438056|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$B|C]]|$1|D|3|E|5|F|7|J|8|@]|9|@]|A|$]]|$1|G|3|-4|5|F|7|K|8|@]|9|@]|A|$]]]|H|$]]

<pre><code>// human madable inconvenient. Way too sucks.
</code></pre>

I still don't fully understand what it means, but I have found it to be very true about a lot of code.

blocks|key|3753960|text|//+error+codes
#define+ERROR_SUCESS+0
#define+ERROR_SUCCESS_IS_MISSPELLED+1|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3753961|未定义其他错误代码。|unstyled|3753962|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$B|C]]|$1|D|3|E|5|F|7|J|8|@]|9|@]|A|$]]|$1|G|3|-4|5|F|7|K|8|@]|9|@]|A|$]]]|H|$]]

<pre><code>// error codes
#define ERROR_SUCESS 0
#define ERROR_SUCCESS_IS_MISSPELLED 1
</code></pre>

No other error codes defined.

blocks|key|3754062|text|我一直很喜欢Paul+DiLascia在他的文件标题中写的东西：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|3754063|//+If+this+code+works,+it+was+written+by+Paul+DiLascia.+If+not,+I+don't+know
//+who+wrote+it|code-block|syntax|javascript|3754064|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

I always liked what Paul DiLascia wrote in his file headers: 

<pre><code>// If this code works, it was written by Paul DiLascia. If not, I don't know
// who wrote it
</code></pre>

blocks|key|1644973|text|从嵌入式系统中的电池监视器模块：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|1644974|//+batmon.c+drives+the+rastamobile|code-block|syntax|javascript|1644975|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|J|8|@]|9|@]|A|$E|F]]|$1|G|3|-4|5|6|7|K|8|@]|9|@]|A|$]]]|H|$]]

From a battery monitor module in an embedded system:

<pre><code>// batmon.c drives the rastamobile
</code></pre>

blocks|key|5172987|text|从泄露的Win2K源代码中：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|5172988|//+The+magnitude+of+this+hack+compares+favorably+with+that+of+the+national+debt.|offset|length|style|CODE|5172989|entityMap^0|0|0|28|0^^$0|@$1|2|3|4|5|6|7|J|8|@]|9|@]|A|$]]|$1|B|3|C|5|6|7|K|8|@$D|L|E|M|F|G]]|9|@]|A|$]]|$1|H|3|-4|5|6|7|N|8|@]|9|@]|A|$]]]|I|$]]

From the leaked Win2K source code:

<code>
// The magnitude of this hack compares favorably with that of the national debt.
</code>

blocks|key|1637170|text|唐纳德·努斯的另一部经典作品：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|1637171|注意上面代码中的bug；我只是证明了它是正确的，并没有尝试它。|1637172|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|F|8|@]|9|@]|A|$]]|$1|B|3|C|5|6|7|G|8|@]|9|@]|A|$]]|$1|D|3|-4|5|6|7|H|8|@]|9|@]|A|$]]]|E|$]]

Another classic, by Donald Knuth no less:

Beware of bugs in the above code;
I have only proved it correct, not tried it.

blocks|key|1437909|text|//There+can+Only+Be+one+HIGHLAN....err..Singleton
public+class+SomeSingleton
{
...
}|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1437910|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>//There can Only Be one HIGHLAN....err..Singleton
public class SomeSingleton
{
...
}
</code></pre>

blocks|key|1438291|text|//+Any+maintenance+developer+who+can't+quote+entire+Monty+Python
//+movies+from+memory+has+no+business+being+a+developer.+
const+string+LancelotsFavoriteColor+=+"$0204FB"|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1438292|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>// Any maintenance developer who can't quote entire Monty Python
// movies from memory has no business being a developer. 
const string LancelotsFavoriteColor = "$0204FB"</code></pre>

blocks|key|5172727|text|//+if+i+ever+see+this+again+i'm+going+to+start+bringing+guns+to+work|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|5172728|unstyled|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|G|8|@]|9|@]|A|$B|C]]|$1|D|3|-4|5|E|7|H|8|@]|9|@]|A|$]]]|F|$]]

<pre><code>// if i ever see this again i'm going to start bringing guns to work
</code></pre>

<pre><code>//ALL YOUR BASE ARE BELONG TO US
</code></pre>

...it made my boss think someone had hacked in. He didn't know the joke.

blocks|key|1634436|text|//ALL+YOUR+BASE+ARE+BELONG+TO+US|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|1634437|...it让我老板以为有人黑进去了他不知道这个笑话。|unstyled|1634438|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$B|C]]|$1|D|3|E|5|F|7|J|8|@]|9|@]|A|$]]|$1|G|3|-4|5|F|7|K|8|@]|9|@]|A|$]]]|H|$]]

<pre><code>Get This hack!
</code></pre>

On a line of assembler code, after pages of uncommented code.

blocks|key|3746590|text|Get+This+hack!|type|code-block|depth|inlineStyleRanges|entityRanges|data|syntax|javascript|3746591|在汇编代码行上，在未注释的代码页之后。|unstyled|3746592|entityMap^0|0|0^^$0|@$1|2|3|4|5|6|7|I|8|@]|9|@]|A|$B|C]]|$1|D|3|E|5|F|7|J|8|@]|9|@]|A|$]]|$1|G|3|-4|5|F|7|K|8|@]|9|@]|A|$]]]|H|$]]

What is the best comment in source code you have ever encountered?

问你遇到过的源代码中最好的注释是什么？
EN

回答 505

Stack Overflow用户

Stack Overflow用户

Stack Overflow用户

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问你遇到过的源代码中最好的注释是什么？EN

回答 505

Stack Overflow用户

Stack Overflow用户

Stack Overflow用户

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问你遇到过的源代码中最好的注释是什么？
EN