[gcc r13-5613] doc: add notes about limitations of -fanalyzer

[gcc r13-5613] doc: add notes about limitations of -fanalyzer

[David Malcolm]

https://gcc.gnu.org/g:a90316c6ceddfbb47b3c2161baf446ccb87df5ff

commit r13-5613-ga90316c6ceddfbb47b3c2161baf446ccb87df5ff
Author: David Malcolm <dmalcolm@redhat.com>
Date:   Tue Jan 31 21:18:00 2023 -0500

    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:
---
 gcc/doc/invoke.texi | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index d12f318adfd..b45b629069b 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