[doc] Extend Cppcheck documentation
@@ -207,6 +207,7 @@ As of CodeChecker 6.20, the following options are supported:
* `cppcheck:addons` A list of Cppcheck addon files.
* `cppcheck:libraries` A list of Cppcheck library definiton files.
* `cppcheck:platform` The platform configuration .xml file.
+* `cppcheck:inconclusive` Enable inconclusive reports.
Please note that for addons and libraries, multiple items can be specified in the following format: `--analyzer-config cppcheck:addons <addon.py> --analyzer-config cppcheck:addons <addon2.py>`.
@@ -244,6 +245,7 @@ The following limitations need to be considered when using Cppcheck:
* The severity categorizations are only provided for the built in checkers. Addon checkers can be used, but their reports severity will be displayed as `Unspecified`.
* The Cppcheck categorization of checkers is not yet introduced into the Cppcheck label [file](../../config/labels/analyzers/cppcheck.json). To enable a whole category, each individual checker needs to be enabled with the `--enable` flag.
* All Cppcheck Errors and Warnings are enabled by default.
+* Cppcheck addon support is limited in terms of configuration. Checkers residing in Cppcheck addons cannot be listed through the Cppcheck commandline interface. Because of this limitation, these checkers cannot be disabled. Right now the only way to silence a report is to suppress them after the analysis. These addon checkers also cannot be listed with the `CodeChecker checkers` command.
* If not configured, `Native` platform will be assumed for the analyzed compilation database (i.e. the type sizes of the host system are used). No platform translation will occur by CodeChecker. If another one is needed, please provide a platform file with the correct bit lengths.
* To reach maximum compatibility with the existing CodeChecker invocation, Cppcheck is invoked with the `--enable=all` parameter, and all non-needed checkers are passed in as `--suppress=<checker>`.
* Due to legal reasons, no MISRA rule texts are supplied.
@@ -259,5 +261,6 @@ CodeChecker check -l ./compile_commands.json \
--analyzer-config cppcheck:addons=../cppcheck/addons/cert.py \ # enable cert cheks
--analyzer-config cppcheck:libraries=../cppcheck/cfg/zlib.cfg \ # add zlib definitons
--analyzer-config cppcheck:libraries=../cppcheck/cfg/gnu.cfg \ # add gnu definitions
+ --analyzer-config cppcheck:inconclusive=true \ # allow inconclusive reports
-o ./reports
```
