From: David Malcolm Date: Wed, 29 Mar 2023 18:16:48 +0000 (-0400) Subject: doc: add notes about limitations of -fanalyzer X-Git-Tag: releases/gcc-12.3.0~153 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=dbe78fc879a854e6aec92f15a6cc2d7b3a001c8e;p=thirdparty%2Fgcc.git doc: add notes about limitations of -fanalyzer Cherrypicked from r13-5613-ga90316c6ceddfb. 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 eb7e46c8668d..cb83dd8a1cc0 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -9660,6 +9660,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