Eure besten Quellcode Kommentare...

[EWeiss]

Der beste kommentar ist keinen zu schreiben.

Wie dieser hier .. der keiner sein soll

gruss

[MaBuSE]

Wir hatten mal ein Projekt in dem fand ich folgenden Kommentar:

Delphi-Quellcode:

...
// Datum, Username1: Wer das liesst ist doof.
// Datum, Username2: Wer das geschrieben hat, bekommt eine Abmahnung!
...

Datum weiß ich nicht mehr genau, das war bei meinem ehemaligen Arbeitgeber.
Username1 war der Username eines Programmierers.
Username2 war das Login von unserem Cheff.
Der Quelltext wurde an Kunden ausgeliefert und der Kunde hat die Zeile entdeckt.
-> Der Kunde hat unseren Cheff angerufen.
-> Cheffe hat den 2. Kommentar druntergesetzt.

Ich habe das irgendwann mal im Quellcode gefunden und Cheffe darauf angesprochen.
Er hatte nur gegrinst. Ob der Programmierer wirklich eine Abmahnung bekam weiß ich nicht.

[terence14]

Zitat von MaBuSE:

Wir hatten mal ein Projekt in dem fand ich folgenden Kommentar:

Delphi-Quellcode:

...
// Datum, Username1: Wer das liesst ist doof.
// Datum, Username2: Wer das geschrieben hat, bekommt eine Abmahnung!
...

Datum weiß ich nicht mehr genau, das war bei meinem ehemaligen Arbeitgeber.
Username1 war der Username eines Programmierers.
Username2 war das Login von unserem Cheff.
Der Quelltext wurde an Kunden ausgeliefert und der Kunde hat die Zeile entdeckt.
-> Der Kunde hat unseren Cheff angerufen.
-> Cheffe hat den 2. Kommentar druntergesetzt.

Ich habe das irgendwann mal im Quellcode gefunden und Cheffe darauf angesprochen.
Er hatte nur gegrinst. Ob der Programmierer wirklich eine Abmahnung bekam weiß ich nicht.

Dem Chef kann ich nur Recht geben. Und dem Kunden auch.
Manchen Menschen scheint der Sinn ihrer Arbeit keinen Sinn zu machen.
Da möchte ich mir lieber erst gar nicht vorstellen, wie die Arbeit des besagten
Username1 aussieht, wenn seine Moral dazu Sch**sse ist.
Aber sein Geld am Ende des Monats hat er trotzdem genommen.
Und ob der Kunde an diese Firma nochmals einen Auftrag vergibt?

MfG,
terence

An Username1:
Werde doch Fahrstuhlführer oder Kloputzer.
Da kannst Du Deine lustigen Sprüche loswerden.

[OlafSt]

Code:

  
//STK 26.03.2002 - auskommentiert, man beachte die sache mit den rb_beiWarnng
//ausserdem total oversized true und false wenn activated ??? <- muhahahaha
//OST 09.04.2002 - Aber nur, bis Chef auf die Idee kommt, bei activated=true
//                 noch ein paar andere Dinge umzustellen. Dann mach ich muhahahaha :))))

Ich erinnerte mich beim Lesen dieses Threads an diesen kurzen Disput mit meinem Teamkollegen damals... Inzwischen ist das Programm 7 Jahre alt und beim Compile bleibt der Zeilenzähler nach 68 Sekunden bei 16 Mio. stehen, die ursprüngliche Firma (und ihren Chef) gibts nicht mehr, aber das Programm lebt und wird noch immer von mir betreut und erweitert.

Nur nebenbei erwähnt gebührt meinem Kollegen die Ehre - er hatte Recht, Chef wolle nie was bei "activated=true"

[Tormentor32]

Das hier hab ich mal gesehen:
// Kein Kommentar!

[Andidreas]

war zwar kein quellcode kommentar, sondern nur in meinen notizen zu einer besprechung, aber hab grad trotzdem bisl schmunzeln müssen dadrüber:

// GAP (Programmanforderung) gecancelt --> Whatever *gg*

[FAlter]

Hi,

Ein dynamisch erstelltes SynEdit soll auf einem TabSheet liegen...

SynEdit.Parent := CodeSheet; { Kot-Shit ;-D } Mfg
FAlter

[MaBuSE]

// don't try this at home! Das war die Überschrift zu einem recht abendheuerlich programmierten Workarround.


oder was man auch recht häufig sieht:

Delphi-Quellcode:

...
procedure KlassenName.MethodenName(...);
begin
  // tbd
end;
...

tbd steht für "to be done" -> muß noch gemacht werden.

Ich persönlich hätte ehr folgendes eingefügt:

Delphi-Quellcode:

...
procedure KlassenName.MethodenName(...);
begin
  {$message warn 'KlassenName.MethodenName(...) noch nicht implementiert.'}
end;
...

Damit wird beim kompilieren eine Warnung ausgegeben.

[Phoenix]

Zitat von MaBuSE:

Delphi-Quellcode:

...
procedure KlassenName.MethodenName(...);
begin
  {$message warn 'KlassenName.MethodenName(...) noch nicht implementiert.'}
end;
...

Damit wird beim kompilieren eine Warnung ausgegeben.

Und das sagst Du mir erst jetzt?!?

[MaBuSE]

Zitat von Phoenix:

Und das sagst Du mir erst jetzt?!?

Steht doch in der Hilfe von Delphi

Zitat aus der Delphi 7 Hilfe:

MESSAGE (Direktive)

Syntax{$MESSAGE HINT|WARN|ERROR|FATAL 'Textstring' } Anmerkungen

• Diese Direktive ermöglicht dem Quelltext, wie der Compiler Hinweise, Warnungen und Fehlermeldungen zu generieren. Sie ähnelt den Anweisungen #emit und pragma warn in C/C++.
  Der Meldungstyp (HINT, WARN, ERROR oder FATAL) ist optional. Ohne diese Angabe wird HINT verwendet. Der Textstring muss angegeben und in einfache Anführungszeichen eingeschlossen werden.

Beispiele:

Delphi-Quellcode:

{$MESSAGE 'Boo!'} //Hinweis

{$Message Hint 'Füttere die Katzen'}    // Hinweis
{$messaGe Warn 'Sieht nach Regen aus.'} // Warnung
{$Message Error 'Nicht implementiert'}  // Fehler, die Compilierung wird fortgesetzt
{$Message Fatal 'Bang.  Tot.'} // Fehler, die Compilierung wird abgebrochen