From dbe78fc879a854e6aec92f15a6cc2d7b3a001c8e Mon Sep 17 00:00:00 2001 From: David Malcolm Date: Wed, 29 Mar 2023 14:16:48 -0400 Subject: [PATCH] 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 --- gcc/doc/invoke.texi | 7 +++++++ 1 file changed, 7 insertions(+) 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 -- 2.47.3