summaryrefslogtreecommitdiff
path: root/compilerplugins/README
blob: 2344efbf0f76d08309f4c3de5d696db4e8571cb1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
Compiler plugins.

== Overview ==

This directory contains code for compiler plugins. These are used to perform
additional actions during compilation (such as additional warnings) and
also to perform mass code refactoring.

Currently only the Clang compiler is supported (http://clang.llvm.org).

== Usage ==

Compiler plugins are enabled automatically by --enable-dbgutil if Clang headers
are found or explicitly using --enable-compiler-plugins.


== Functionality ==

=== Compile plugin ===

The compile plugin is used during normal compilation to perform additional checks.
All warnings and errors are marked '[loplugin]' in the message.

==== Unused variable check ====

- unused parameter 'foo' [loplugin]
- unused variable 'foo' [loplugin]

Additional check for unused variables.

==== Body of if/while/for not in {} ====

- statement aligned as second statement in if/while/for body but not in a statement block [loplugin]

Warn about the following construct:

    if( a != 0 )
        b = 2;
        c = 3;
        
Here either both statements should be inside {} or the second statement in indented wrong.

==== Sal log areas ====

- unknown log area 'foo' (check or extend sal/inc/sal/log-areas.dox) [loplugin]

Check area used in SAL_INFO/SAL_WARN macros against the list in sal/inc/sal/log-areas.dox and
report if the area is not listed there. The fix is either use a proper area or add it to the list
if appropriate.


== Code documentation / howtos ==

TBD