Re: [dev] [sbase] style

From: Markus Teich <markus.teich_AT_stusta.mhn.de>
Date: Wed, 19 Nov 2014 15:43:03 +0100

Dimitris Papastamos wrote:
> As long as typedef is used sensible I am ok with the proposed naming
> convention.

Heyho,

for structs I hate to use a typedef since it hides the fact that it is a struct
beeing handled. If you propose that the only names starting with an uppercase
letter are structs, then this is kind of consistent in itself if you know about
this rule, but external people usually don't start digging by reading the style
guidelines.

If we put _too_ fancy stuff in our style guide, I think the goal of writing
clear and easy to understand code for everybody (not only the ones who know the
guide) is slightly undermined. The guide should support the developer checking
his code, but should not assume, that the reader is familiar with the guide.
Nameing conventions (typedeffing a struct is related to this) don't belong in a
style guide, but in a policy guide.

--Markus
Received on Wed Nov 19 2014 - 15:43:03 CET