List:Internals« Previous MessageNext Message »
From:Ingo Strüwing Date:April 8 2009 3:33pm
Subject:Re: [style] inconsistency in Commenting Code section + proposed a new
section "Keep The Code Clean"
View as plain text  
Hi Sergey,

Sergey Vojtovich, 08.04.2009 14:38:

...
> Whereas in the example, which is immediately following this sentence, we
> use three spaces:
> <quot>
> /*
>    This is how a multi-line comment in the middle of code
>    should look.  Note it not Doxygen-style if it's not at the 
>    beginning of a code enclosure (function or class).
> */
> </quot>


I vote for you fix this yourself.

...
> Also I didn't find anything about whether spaces are allowed at the end
> of the line and after function name (before arguments), e.g.:
...
> As I'm seeing this pretty frequently, I think it would be nice to
> documented it either in a new section or in the  "Indentation and
> Spacing" section.

Agree.

Regards
Ingo
-- 
Ingo Strüwing, Database Group
Sun Microsystems GmbH, Sonnenallee 1, D-85551 Kirchheim-Heimstetten
Geschäftsführer: Thomas Schröder, Wolfgang Engels, Dr. Roland Bömer
Vorsitzender des Aufsichtsrates: Martin Häring   HRB München 161028
Thread
[style] inconsistency in Commenting Code section + proposed a newsection "Keep The Code Clean"Sergey Vojtovich8 Apr
  • Re: [style] inconsistency in Commenting Code section + proposed a newsection "Keep The Code Clean"Ingo Strüwing8 Apr
  • Re: [style] inconsistency in Commenting Code section + proposed a newsection "Keep The Code Clean"Konstantin Osipov26 Jun