Ich denke mal jeder kennt es bereits von StackOverflow. Das hier soll auch kein Copy->Translate->Paste() Post sein, sondern eure eigenen Erfahrungen im beruflichen oder privaten Alltag widerspiegeln. Natürlich soll es auch der Unterhaltung dienen und die Beteiligung anregen.

Gesucht sind die besten, lustigsten und merkwürdigsten Kommentare und Code-Schnipsel die euch bisher begegnet sind. Ich bitte euch dabei keine Antworten von StackOverflow zu kopieren, da diese hinreichend bekannt sind (leider ist der Thread dort so langsam ausgelutscht).

Anmerkung: Codekicker könnte eine Meta-Sektion für solche Fragen gebrauchen ;-)

Hallo,

hier: What is the best comment in source code you ahve ever encountered
oder hier: Coding Styles Horror

Und besonders schön finde ich den hier:

// 
// 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 = 39
//

oder der da

//If you don't understand this code, you should be flipping burgers instead.

Schon etwas länger her:

poRequest.HitMeBabyOneMoreTime = true; //Oh baby, baby
return this.SendRequest(poRequest);

// Dear fellow programmer. You can be shure I tried my very best to make this look nicer.
// However there is no better solution to this. 
// SO MOTHERFUCKER KEEP YOUR HANDS OFF.

catch(DivideByZeroException ex){ //Only Cuck Norris can divide by zero
  ...
}

Hab auch noch einen gefunden:

set
{
    Debug.Assert(value != null);
    if(value != null)
    {
        bnController = null; // darf nicht null sein
    }
}

Auch sehr schön:

// Magic! Do not touch!!!

oder generell

// Nicht anfassen!! Muß so ein!

ohne eine genaue Erklärung.

i++; // Increment i by one.

Als ich studiert habe, habe ich nebenher als Übungsleiter gearbeitet. Das war eine Zeile einer Abgabe, bei der ich aufgefordert hatte, die Abgabe bitte zu kommentieren ...

Es gibt Kommentare, von denen man nicht glaubt, dass es sie gibt, wenn man sie nicht sieht.

Hintergrund: Im einem kommerziellen .NET-Programm wurde in einer Klasse die Schnittstelle IEquatable<T> implementiert. Allerdings wurde in Equals() nicht auf null geprüft, so dass ein Vergleich häufger mal eine NullReferenceException verursachte. Der Entwickler hat dass dann so gelöst, dass die Equals-Methode in diesen Fällen bei Vergleichen jeweils umgangen wurde. Die Equals()-Methode selbst hat er so kommentiert:

// TODO: remove me if possible

Das beziehe ich natürlich direkt auf den Verursacher ;-)

Auch ein eigenes Verbrechen:

// TODO: Kommentar ändern wenn alles erledigt
// WW_Erzeugung - hat zwar keine Orientations, ist aber wurscht!
foreach (var v in this.ElementContainer.SelectedElements["WW_Erzeugung"].Orientations)
{ ...

Auch ein Klassiker der mir häufiger vor die Augen tritt:

if( IrgendEtwasKomplexesMitMehrerenAndsUndOrsUndVielleichtSogarKlammern ){
  //nix
}
else{
  doSomething();
}

Die Leute vergessen das ein einfaches

if( !(IrgendEtwasKomplexesMitMehrerenAndsUndOrsUndVielleichtSogarKlammern) )

den selben Effekt hat.

nicht gerade ein Kommentar, aber ein (leider von mir) produziertes Snippet:

//Anmerkung: bei iEinStr handelt es sich um einen String :D
iEinStr = iEinStr.Trim(" ".ToCharArray())

nett, eine unnötige Umwandlung eines Leerzeichens in ein Char-Array zum Trim() ... mal ehrlich, ein einfaches iEinStr.Trim() hätts auch getan ^^ aber sowas bemerkt man ja eh erst wenns zu spät ist.

Hier ein Klassiker (der schon viele Probleme gemacht hat)
Mit Kommentar fühlt man sich einfach besser.

catch
{
  //Macht hier nix
}

Eine Methode mit dem Namen SuchsKatzi() fand ich mal recht amüsant.

Ich schreib in Perlmodulen immer gerne hinter bless ein "# Bless my pointy litte ...." :) Hat schon für den einen oder anderen Lacher gesorgt.

Auch lustig ist ein "grep -iR fuck *" in so manchem Projektbaum :-)

Oder ein Kommentar aus dem Linuxkernel

printk(KERN_WARNING "GSCD: DMA kann ich noch nicht!\n");
 linux-2.6.19/drivers/cdrom/gscd.c
 (Do we have i18n'ed messages now? -- Ed.)