Programm richtig kommentieren

[St.Pauli]

Luckie hat vollkommen recht. Nicht kommentieren was man macht, sondern warum und immer abwägen, ob ein Kommentar an dieser oder jener Stelle erforderlich ist oder nicht. Durch einen übersichtlichen Code und eine gute Namensgebung kann man sich aber schon ein paar Kommentare ersparen.

@Luckie:

Zitat von Luckie:

Ich kommentiere immer so wenig wie möglich, so viel wie nötig. Und das:

Delphi-Quellcode:

//x incrementieren 
x := x + 1;

würde ich nicht kommentieren. Wozu? Was bringt e, Leser der Kommentar an zusätzlichen Informationen? Nichts. Man sollte nicht kommentieren wa sman macht, das sehe ich selber am Code, sondern warum man etwas macht.

Delphi-Quellcode:

// Speicher wieder freigeben
FreeMem(Buffer);