aboutsummaryrefslogtreecommitdiff
path: root/gcc/doc/gcov.texi
diff options
context:
space:
mode:
authorMartin Liska <mliska@suse.cz>2017-10-31 12:55:19 +0100
committerMartin Liska <marxin@gcc.gnu.org>2017-10-31 11:55:19 +0000
commit00da60d4def3782039bef86fbdf07fd620d8b57a (patch)
treedb0a5d967d87dd9bb161c77101e1244d059673b7 /gcc/doc/gcov.texi
parent00ca3ed28c98be6485017f835e6c4366f35221ee (diff)
downloadgcc-00da60d4def3782039bef86fbdf07fd620d8b57a.zip
gcc-00da60d4def3782039bef86fbdf07fd620d8b57a.tar.gz
gcc-00da60d4def3782039bef86fbdf07fd620d8b57a.tar.bz2
GCOV: document behavior of -fkeep-{static,inline}-functions (PR gcov-profile/82633).
2017-10-31 Martin Liska <mliska@suse.cz> PR gcov-profile/82633 * doc/gcov.texi: Document -fkeep-{static,inline}-functions and their interaction with GCOV infrastructure. * configure.ac: Add -fkeep-{inline,static}-functions to coverage_flags. * configure: Regenerate. From-SVN: r254257
Diffstat (limited to 'gcc/doc/gcov.texi')
-rw-r--r--gcc/doc/gcov.texi7
1 files changed, 7 insertions, 0 deletions
diff --git a/gcc/doc/gcov.texi b/gcc/doc/gcov.texi
index 706aa6c..88b8d6d 100644
--- a/gcc/doc/gcov.texi
+++ b/gcc/doc/gcov.texi
@@ -328,6 +328,13 @@ handlers, respectively. Given @samp{-a} option, unexecuted blocks are
marked @samp{$$$$$} or @samp{%%%%%}, depending on whether a basic block
is reachable via non-exceptional or exceptional paths.
+Note that GCC can completely remove the bodies of functions that are
+not needed -- for instance if they are inlined everywhere. Such functions
+are marked with @samp{-}, which can be confusing.
+Use the @option{-fkeep-inline-functions} and @option{-fkeep-static-functions}
+options to retain these functions and
+allow gcov to properly show their @var{execution_count}.
+
Some lines of information at the start have @var{line_number} of zero.
These preamble lines are of the form