summaryrefslogtreecommitdiff
path: root/compilerplugins/README
diff options
context:
space:
mode:
authorLuboš Luňák <l.lunak@suse.cz>2013-02-02 18:34:12 +0100
committerLuboš Luňák <l.lunak@suse.cz>2013-02-02 22:59:44 +0100
commita1c61eb11298d5ed565c06e4b925d51d855fd8ff (patch)
tree1b2c4273cbecbbab41823c45ce36b1d35666215a /compilerplugins/README
parentc6ffe17631cccf11fbe00479d2169116d494a7da (diff)
move documentation of plugins to the .cxx files
It's mostly there already anyway, no need to duplicate it. Change-Id: I5b066f90725a064fb0746e1411900e835e3f66c3
Diffstat (limited to 'compilerplugins/README')
-rw-r--r--compilerplugins/README35
1 files changed, 4 insertions, 31 deletions
diff --git a/compilerplugins/README b/compilerplugins/README
index 857800577e74..9d531db946ea 100644
--- a/compilerplugins/README
+++ b/compilerplugins/README
@@ -18,10 +18,12 @@ are found or explicitly using --enable-compiler-plugins.
== Functionality ==
-There are two kinds of modules:
+There are two kinds of plugin actions:
- compile checks - these are run during normal compilation
- rewriters - these must be run manually and modify source files
+Each source has a comment saying whether it's compile check or a rewriter
+and description of functionality.
=== Compile checks ===
@@ -29,42 +31,13 @@ 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.
-
-
=== Rewriters ===
Rewriters analyse and possibly modify given source files.
Usage: make COMPILER_PLUGIN_TOOL=<rewriter_name>
Modifications will be written directly to the source files.
+
== Code documentation / howtos ==
TBD