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

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