[FFmpeg-devel] [PATCH] add multiple inclusion guard note to policy

[Diego Biurrun]

On Mon, Oct 15, 2007 at 11:58:56AM +0200, Michael Niedermayer wrote:
> On Mon, Oct 15, 2007 at 11:44:22AM +0200, Michael Niedermayer wrote:
> > 
> > On Mon, Oct 15, 2007 at 10:56:41AM +0200, Diego Biurrun wrote:
> > > On Mon, Oct 15, 2007 at 10:45:36AM +0200, Diego Biurrun wrote:
> > > > All header files should come with multiple inclusion guards.  Here is a
> > > > patch for the policy.
> > > 
> > > .. I guess I have become the undisputed king of forgotten attachments,
> > > what a crown to wear ..
> > > 
> > > Diego AKA scatterbrain #1
> > 
> > iam fine with adding this but i do not think that such rather trivial 
> > rules belong into the policy
> > 
> > rules like, use/keep alphabetical ordering where possible, add multiple
> > inclusion guards on headers, add proper license headers, update the changelog
> > and docs for new codecs would fit much better into the coding rules
> > section where also doxygen comments are mentioned or another section ...
> 
> IMHO the policy should only contain important rules for which ignoring them
> would cause significant problems
> 
> not spliting patches/commits makes their review very hard asking the author 
> to split it might lead to a lot more work compared to him knowing that it
> should be split from the begin ...
> 
> not bumping version numbers could lead to serious API/ABI issues
> 
> not updating changelog (for new codecs) seems rather benign
> 
> not maintaining alphabetical order is rather irrelevant
> 
> forgotton multiple inclusion guards might lead to a bug and 10min time wasted
> and a 3 line fix, this doesnt sound overly significant
> 
> mixing cosmetic and non cosmetic changes would make review on svn log very
> hard, lead to bugs, security issues and in general worse code

Then call the rest guidelines or whatever.  Splitting that off would
however, to quote a certain Mr Niedermayer, belong in a separate patch
;-p  So I think this should be committed as-is, the split can be done
later if deemed necessary/desirable.

Diego