Document --check-level better

man/manual.md

@@ -957,7 +957,26 @@ Example usage:
     ./cppcheck gui/test.cpp --xml 2> err.xml
     htmlreport/cppcheck-htmlreport --file=err.xml --report-dir=test1 --source-dir=.
 
-# Performance - Limit analysis
+# Check Level
+
+## Normal
+
+The "normal" check level is chosen by default. Our aim is that this checking level will provide an effective checking in "reasonable" time.
+
+The "normal" check level should be useful during active development:
+ * checking files while you edit them.
+ * block changes to the repo
+ * etc
+
+## Exhaustive
+
+When you can wait longer for the results you can enable the "exhaustive" checking, by using the option `--check-level=exhaustive`.
+
+Exhaustive checking level should be useful for scenarios where you can wait for results. For instance:
+ * nightly builds
+ * etc
+
+# Speeding up analysis
 
 ## Limit preprocessor configurations
 

releasenotes.txt

@@ -1,5 +1,6 @@
 release notes for cppcheck-2.11
 
+- The new option --check-level=<level> has been added that controls how much checking is made by Cppcheck. The default checking level is "normal". If you feel that you can wait longer on results you can use --check-level=exhaustive.
 - The platform type 'Unspecified' within .cppcheck projects has been deprecated and will be removed in Cppcheck 2.14. Please use 'unspecified' instead.
 - It is no longer necessary to run "--check-config" to get detailed "missingInclude" and "missingIncludeSystem" messages. They will always be issued in the regular analysis if "missingInclude" is enabled.
 - "missingInclude" and "missingIncludeSystem" are reported with "-j" is > 1 and processes are used in the backend (default in non-Windows binaries)
@@ -12,5 +13,4 @@ release notes for cppcheck-2.11
     - `constVariable`
     - `constVariableReference`
     - `constVariablePointer`
-- Limit valueflow analysis in function if the "if" count is high. By default max limit is 100. Limit can be tweaked with --performance-valueflow-max-if-count
 - More command-line parameters will now check if the given integer argument is actually valid. Several other internal string-to-integer conversions will not be error checked.