Extend the cppcheck suppression example to show that each suppression
should have a reason describing the intentional suppression of a
cppcheck warning or error.
This reverts commit ec97a94626.
(The commit seems to cause trouble. Furthermore, there's no reference to
either the issue or how it was solved in the original commit message).
cppcheck doesn't understand ASM style comments beginning with '#' and tries to
parse them:
I get this error:
cpu/mips_pic32_common/reset_mod.S:84: error (syntaxError): syntax error
from this line:
beqz s1, init_resources # Branch if this is NOT an NMI exception.
If I place the comment inside C-style comments cppcheck passes, ie
beqz s1, init_resources # /*Branch if this is NOT an NMI exception.*/
Note current in-tree ASM files fail cppcheck (they must have been added before
this check) for example:
cpu/lpc2387/asmfunc.s
When no arguments are given at all, the script would shift when there
is nothing to shift. This results in a failure on debian stable:
```
./dist/tools/cppcheck/check.sh: 20: shift: can't shift that many
```
