Eure besten Quellcode Kommentare...

[implementation]

In C++-Quellcode:

Code:

// Liegt ein Rechtswinkel vor?
#ifdef THE_FEATURE
bool Snake::angle_left() const {
#else
bool Snake::angle_right() const {
#endif
  ...
}

// Liegt ein Linkswinkel vor?
#ifdef THE_FEATURE
bool Snake::angle_right() const {
#else
bool Snake::angle_left() const {
#endif
  ...
}

"THE_FEATURE" schaltet mal eben einen früheren Bug wieder ein

Code:

// ITERATIV!!!!!!!!!! (die rekursive Version war verbuggt :'( )

[rokli]

einen hab ich noch

Delphi-Quellcode:

   // hier müssen noch diverse Sachen in eine INI Feile umgelenkt werden .. 
   // kommt Zeit-kommt Urlaub-kommt Rad!

man muss nur mal drauf gestoßen werden, sich das anzusehen, was man da früher hingetextet hat!

[Uwe Raabe]

Delphi-Quellcode:

  { Nach unserer Annahme sollten nun SourceParent und TargetParent auf
    denselben Pfad verweisen. }
  { TODO : Mangels besserer Alternativen machen wir es im anderen Fall genauso. }
  if true {SameFileName(SourceParent, TargetParent)} then begin

[Uwe Raabe]

Der ist auch gut:

Delphi-Quellcode:

    { TODO : Was soll denn das hier? }
    if MP.AktToolRec.Kardanik and (MP.AktToolRec.ToolClass = cToolSaege) then
      B := Abs(MP.AktToolRec.Durchmesser)
    else
      B := Abs(MP.AktToolRec.Durchmesser);

[Maya]

Ich hatte bei mir mal 'reingeschrieben "NICHT ANFASSEN" und dann beim end noch mal "NICHT ANFASSEN!", weil ich vor'm Urlaub in der Prozedur was änderte und dachte, falls ich bis nach 'n Urlaub vergesse, dass ich da was änderte, ich mir nicht wieder alles versaue, wenn's nicht gleich richtig funktioniert.

[rokli]

Zitat:

{ TODO : Was soll denn das hier? }

@Uwe: die ganzen TODO´s lasse ich hier lieber weg ...

Viele Grüße nach hintern Berg!
Rolf

[nuclearping]

Lustig ist auch, wenn verschiedene Entwickler im Code miteinander kommunizieren:

Delphi-Quellcode:

function IsEditMode: Boolean;
begin
  //Debug nicht generell im Edit-Modus, sonst kann man die Unterschiede schlecht debuggen...
{$IFNDEF FREQUENCY_THERAPY}
  Result := IsRegistered('EDIT+;');
{$ELSE}
  // Welche Unterschiede?
  {$IFDEF DEBUG}
    Result := TRUE;
    //Result := IsRegistered('EDIT+;');
  {$ELSE}
    Result := IsRegistered('EDIT+;');
  {$ENDIF}
{$ENDIF}
end;

[r2c2]

Ein Kommentar von heute:

Code:

/*
This is a time travel correction routine.
Beware that grammar of time travel is complicated!

[...]
*/

Der Kommentar stammt von mir und ich habs tatsächlich geschafft, das noch halbwegs ernst zu meinen...

mfg

Christian

[Furtbichler]

Zitat von himitsu:

Man entfernt sämltichen Kommentare und vorallem alle Formatierungen (möglichst alles in eine Zeile rein), so daß niemand mehr (vorallem man selber nicht) jemals wieder versucht das Ding zu verstehnen ... fertig. :supid:

Öh, dann nehme ich einen SQL-Formatter.

[himitsu]

Zitat:

Delphi-Quellcode:

var
{$IFDEF VERSION12}
  c: WideChar;
{$ELSE}
  c: AnsiChar;
{$ENDIF}

Selbstkommentierender Code ist auchmanchmal ganz witzig krank.

VERSION12 = Delphi 2009+ aka Unicode


Manchmal fragt man sich schon noch, was sich ob da jemand gedacht hat