Re: Quick question about Ada code formatting.

[Pascal Obry <pascal@obry.net>]

Jeffrey R. Carter a �crit :
> Pascal Obry wrote:
> 
>> Between subprograms I prefer the "GNAT style" header box:
>>
>>   ----------------------
>>   -- Process_Whatever --
>>   ----------------------
>>
>>   procedure Process_Whatever is
> 
> Comments should add value; these blocks add nothing. You can tell it's
> Process_Whatever from the next non-comment, non-blank line. This is
> about as useful as
> 
> -- Add 1 to X
> X := X + 1;

I just do not agree, it helps a lot browsing and looking for a specific
routine in a source file. It is not a really comment certainly not
something you can compare with "Add 1 to X" ! It is a kind of separator
that clearly stand out. BTW, this is the GNAT style, a style that I use
for AWS... But again this is just one style.

Pascal.

-- 

--|------------------------------------------------------
--| Pascal Obry                           Team-Ada Member
--| 45, rue Gabriel Peri - 78114 Magny Les Hameaux FRANCE
--|------------------------------------------------------
--|              http://www.obry.net
--| "The best way to travel is by means of imagination"
--|
--| gpg --keyserver wwwkeys.pgp.net --recv-key C1082595