Re: [PATCH] Split protos.h into component-specific header files

From: Kinkie <gkinkie_at_gmail.com>
Date: Thu, 23 Aug 2012 16:50:21 +0200

> I've just taken a quick look through and can find nothing terribly
> objectionable.
>
> Please do not add new sets of multiple empty lines.
> * all the new headers are there with 2,3,4+ needless whitespace lines
> around the #ifdef/#endif lines.

We have a script for that (which I submit for inclusion). Please see
attached remove-duplicate-empty-lines.pl

> * please do not use double empty lines to mark special significance of a
> block of code. If you need to emphasize anything like that it would be
> better to add a comment in place of the second empty line and explain to
> other dev why the block is separate.

There is no such special meaning. One empty line will do, but also a
comment would get the same effect.

> Also, on the styling I'm an advocate of placing the copyright disclaimers
> inside the pre-compiler .h #ifdef protection clause. That can greatly reduce
> the size of precompiled temp files and saves the actual compiler from a
> little bit of duplicate work skipping them. We have no consistency in the
> code right now, so this is just a comment to keep in mind (or debate) not a
> change request.

As far as I can tell, GNU cpp removes comments during precompiling.
But other compilers may act differently, so you may have a valid
argument.
Fortunately, we have a script for that (which I also submit for
inclusion). Please see attached headers-copyright-adjust.pl .
It can be piped with the whitespace-removal tool.

-- 
    /kinkie


Received on Thu Aug 23 2012 - 14:50:30 MDT

This archive was generated by hypermail 2.2.0 : Fri Aug 24 2012 - 12:00:12 MDT