summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDiego Biurrun <diego@biurrun.de>2008-02-04 12:16:14 +0000
committerDiego Biurrun <diego@biurrun.de>2008-02-04 12:16:14 +0000
commit9908c1a8bf19c5bc40a49114cc42dc2fa7efe455 (patch)
tree44a1c4b78b234c75de8cadeb155a714222163361 /doc
parentcd41a73f89708bcccf8c4d4b9857ea5ef529e1a1 (diff)
Update policy entry about compiler warnings to reflect ml discussions.
Originally committed as revision 11858 to svn://svn.ffmpeg.org/ffmpeg/trunk
Diffstat (limited to 'doc')
-rw-r--r--doc/general.texi9
1 files changed, 7 insertions, 2 deletions
diff --git a/doc/general.texi b/doc/general.texi
index 57223b6e92..d77f4f0577 100644
--- a/doc/general.texi
+++ b/doc/general.texi
@@ -825,8 +825,13 @@ should also be avoided if they don't make the code easier to understand.
it has a fourcc, add it to @file{libavformat/avienc.c}, even if it
is only a decoder.
@item
- Do not change code to hide warnings without ensuring that the underlying
- logic is correct and thus the warning was inappropriate.
+ Compiler warnings indicate bugs or code with bad style. If a type of
+ warning always points to correct and clean code, that warning should
+ be disabled, not the code changed.
+ Thus the remaining warnings can either be bugs or correct code.
+ If it is a bug, it has to be fixed. If it is not, the code should
+ be changed to not generate a warning unless that causes a slowdown
+ or obfuscates the code.
@item
If you add a new file, give it a proper license header. Do not copy and
paste it from a random place, use an existing file as template.