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 <dmalcolm@redhat.com>

diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index eb7e46c8668dfe51848855956e57c853a2b3ff91..cb83dd8a1cc043aae8637f1acecec9ffd7cade30 100644 (file)
--- 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