From: David Malcolm Date: Wed, 1 Feb 2023 02:18:00 +0000 (-0500) Subject: doc: add notes about limitations of -fanalyzer X-Git-Tag: basepoints/gcc-14~1594 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a90316c6ceddfbb47b3c2161baf446ccb87df5ff;p=thirdparty%2Fgcc.git doc: add notes about limitations of -fanalyzer gcc/ChangeLog: * doc/invoke.texi (Static Analyzer Options): Add notes about limitations of -fanalyzer. Signed-off-by: David Malcolm --- diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index d12f318adfdc..b45b629069b5 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -10064,6 +10064,13 @@ code, and issues warnings for problems found on them. This analysis is much more expensive than other GCC warnings. +In technical terms, it performs coverage-guided symbolic execution of +the code being compiled. It is neither sound nor complete: it can +have false positives and false negatives. It is a bug-finding tool, +rather than a tool for proving program correctness. + +The analyzer is only suitable for use on C code in this release. + Enabling this option effectively enables the following warnings: @gccoptlist{ @gol