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

[Michael Niedermayer]

On Mon, Oct 15, 2007 at 11:44:22AM +0200, Michael Niedermayer wrote:
> Hi
> 
> 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

...

[...]
-- 
Michael     GnuPG fingerprint: 9FF2128B147EF6730BADF133611EC787040B0FAB

Observe your enemies, for they first find out your faults. -- Antisthenes
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
URL: <http://lists.mplayerhq.hu/pipermail/ffmpeg-devel/attachments/20071015/60bf19b7/attachment.pgp>