Каков лучший комментарий в исходном коде, с которым Вы когда-либо встречались? [закрытый]

Я предполагаю, что это стало вирусным, я нашел следующее в демоне (Linux), который препятствует тому, чтобы уничтожитель OOM выбрал его:

/*
 * Don't OOM me, bro!
 */

Это было правильно после mlockall () препятствовать тому, чтобы процесс подкачал, прокомментировал:

/*
 * Don't swap me, bro!
 */

Мне нравятся некоторые комментарии в GNU binutils. Этот от BFD som.c:

/* You'll never believe all this is necessary to handle relocations
   for function calls.  Having to compute and pack the argument
   relocation bits is the real nightmare.

   If you're interested in how this works, just forget it.  You really
   do not want to know about this braindamage.  */

Этот также:

/* Don't ask about these magic sequences.  I took them straight
   from gas-1.36 which took them from the a.out man page.  */

...

/* Keep track of exactly where we are within a particular
   space.  This is necessary as the braindamaged HPUX
   loader will create holes between subspaces *and*
   subspace alignments are *NOT* preserved.  What a crock.  */

Другой:

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

От газа:

/* Yes this is ugly (storing the broken_word pointer
   in the symbol slot).  Still, this whole chunk of
   code is ugly, and I don't feel like doing anything
   about it.  Think of it as stubbornness in action.  */

Не комментарии к коду, но фиксация SVN комментирует тот же файл:

Первая фиксация (после десятков других после результатов, возвращающихся от тестеров):

Squashed some IPR mod bugs. The were big and juicy ones, too.

2-я фиксация:

Squashed some more mod bugs. Those are some nasty bugs, them mod bugs...

3-й:

Squashed some more mod bugs. They are like cockroaches: they'll live through a nuclear war.

4-й:

Squashed some more John bugs. They too are like cockroaches: they appear anywhere John goes. Wait. That doesn't sound right.

И 5-й:

Same John bug. It didn't die, just played 'possum.

Да, я устал от "Исправленной ошибки".

Комментарии Linux

существуют "куча" хороших здесь...

Это все комментарии в linux

http://lwn.net/1998/1015/a/f-word.html

Мои Фавориты:

./arch/sparc/kernel/ptrace.c
/* Fuck me gently with a chainsaw... */

./drivers/scsi/qlogicpti.h
/* Am I fucking pedantic or what? */

Я не помню точно, но идея была чем-то вроде этого:

Person p = new Person("John", "Doe", "male");
Collection women = new ArrayList();
women.insert(p.getTail());

Это - грязный код;)

"Этого никогда не будет происходить".

Известные последние слова мой друг...

Это было на самом деле сделано мной, когда я реализовывал прототип, превратился в реальный код:

// Abandon all hope you who needs to debug this

Да, кто-то более умный, чем я на самом деле осуществил рефакторинг код впоследствии (он должен был иметь хорошее окончание).

// fix for groupid > 9 
// if groupid ever gets to 100 everything will break (again)

if (groupid < 10) {
groupid = "0" + groupid;
}

От парня, который ясно наблюдал за Монти Пайтоном:

> // And now, for something completely
> // different:

класс theLarch {

// Whoever put this here is an idiot...this doesn't work at all !

, Но код все еще там...

Замеченный в исходном коде для компьютерной игры 'The Eidolon' LucasArts (Который был странным и дурацким в своем собственном праве)...

// He's dead, Jim!

// TODO - Comment this function

Найденный в API JUnit:

/**
 * ...as the moon sets over the early morning Merlin, Oregon
 * mountains, our intrepid adventurers type...
 */
public Test createTest(Class theClass, String name) {
    ...
}

int Q13Factor = 8125; // 2^13 for Q13 

В заголовке файла XSLT:

DON'T TOUCH THIS SCRIPT -> XSLT is like arcane, black magic

Мой фаворит (который я должен признать, что много раз использовал):

// Yes...I know this is repulsive and stupid.
// But <%CompanyOwnerOrManagerToken%>, not knowing a thing about code,
// demanded I do it anyways. SO, go crap on their desk, not mine.
// K THX BYE 

/* FIXME This must absolutely be removed before 4.0.7 release
 * TODO really remove this */

мы с тех пор выпустили 4.0.7, 4.0.8, 4.0.9 и 4,1 версии...

Однажды я работал над проектом, где нашел этот комментарий:

// Cabbage fart?

Я понятия не имею, что он должен был жадный. Просто рад, что мой куб не был рядом с тем, кто его написал.

Мой любимый комментарий всех времен использовал мой друг-гей. Он любил отмечать все свои комментарии TODO в VB.NET как

'TODO: Matt Damon

Иногда предоставлялась дополнительная информация, но не всегда.

/* Here I sit, Joe broken hearted, came to do some sh*t, but only just started. */

В отношении некоторой тяжелой проверки правильности ввода регулярного выражения.

// BEGIN HACK
...
// END HACK: I feel dirty.

'Mind boggling, gibberish version of a SQL statement, but it work's, so dont touch it

Обнаружено в make-файле

# ===== Never edit below this line. Ever. Or I'll kick your ass. ====

  rescue
    # silently, we fail
    # many validations fade
    # like tear drops in rain
  end

Это только один из многих ...

public function get state( /* of Palestine back */ ):Boolean

v.bpc     := v.pc;  -- Remember to jump back
v.baccu   := accu;  -- Yo dawg, heard you like runing instructions
                    -- so I took backup of your accu so you can run
                    -- instructions while you run instructions.
v.flags.i := false; -- No more interupts

Хорошо, вот тот, который я только что совершил :

/* Every time I re-visit this function, I feel like
 * I need to take a shower.
 *
 * Don't get too used to this function, its days are
 * numbered.
 */

Кто-то может создать что-то вроде greatcodecomments.com и заработать немного денег. Этот человек, однако, не я.

Посередине файла JScript длиной в несколько тысяч строк после совершенно произвольной строки ...

// The world is a happy place.

// need a coffee to fix this.

// Singleton object. Leave $me alone.
private static $me;