When you remove the comments replacing it with something, it sounds good, but removing comments keeping empty areas, it is very ugly for my eyes and sounds very weird for beginners. Some examples (please see all of them):
good, just a empty form:
type
TForm1 = class(TForm)
end;
good, just hints helping beginners (the comments below is merely for illustrating):
TForm1 = class(TForm)
private
{ Hey dude, put your private things here and keep this formatting. }
public
{ Hey dude, put your public things here and keep this formatting. }
end;
good, my stuff replaced the comments (button1 added through IDE):
TForm1 = class(TForm)
Button1: TButton;
private
FMyProp: Integer;
public
property MyProp: Integer read FMyProp;
end;
good, just a alert:
try
DoSomeNormalExceptionCode;
except
// no problem, silent exception
end;
good, just a convention:
var
GEnv: TEnt;
{ please add G for global variable prefixing. }
weird, empty areas:
TForm1 = class(TForm)
private
public
end;
weird, empty scopes:
var
Form1: TForm1;
implementation
{$R *.lfm}
initialization
finalization
end.
weird, unused units, we just need "uses Forms;":
uses
Classes, SysUtils, FileUtil, Forms, Controls, Graphics, Dialogs;
type
TForm1 = class(TForm)
private
public
end;
weird, useless comments and ifdefs:
uses
{$IFDEF UNIX}{$IFDEF UseCThreads}
cthreads,
{$ENDIF}{$ENDIF}
Interfaces, // this includes the LCL widgetset // OK, but I just open my lpr exactly for removing this comment :-D
Forms, unit1
{ you can add units after this }; // really a big useless comment, the IDE automatically add most units here dude :-p
for the case above it should be:
uses
{$IFDEF UNIX}
CThreads,
{$ENDIF}
Interfaces, Forms, unit1;