aboutsummaryrefslogtreecommitdiff
path: root/gcc/doc/gcov.texi
diff options
context:
space:
mode:
authorSteven Bosscher <steven@gcc.gnu.org>2012-07-23 11:59:15 +0000
committerSteven Bosscher <steven@gcc.gnu.org>2012-07-23 11:59:15 +0000
commitefbb59b21bcb70426f49e39b01c3aa0021f6a32c (patch)
tree6f165840c56b203cb68dd725d9235cd67b425d70 /gcc/doc/gcov.texi
parentfa0f4017753805e73898a46abdf8ffb72a9977c0 (diff)
downloadgcc-efbb59b21bcb70426f49e39b01c3aa0021f6a32c.zip
gcc-efbb59b21bcb70426f49e39b01c3aa0021f6a32c.tar.gz
gcc-efbb59b21bcb70426f49e39b01c3aa0021f6a32c.tar.bz2
coverage.c: Refer to "notes file" instead of "graph file" in all comments.
gcc/ * coverage.c: Refer to "notes file" instead of "graph file" in all comments. Explain history of bbg prefix. * gcov-io.h: Likewise. * gcov.c: Likewise. (find_source): Likewise in fnotice. (read_graph_file): Likewise. (read_count_file): Likewise. * doc/gcov.texi: Document -fprofile-dir flag. Add "notes file" and "data file" explicitly in the explanation of the files. libgcc/ * libgcov.c (__gcov_ior_profiler): Benign comment fix. From-SVN: r189781
Diffstat (limited to 'gcc/doc/gcov.texi')
-rw-r--r--gcc/doc/gcov.texi25
1 files changed, 14 insertions, 11 deletions
diff --git a/gcc/doc/gcov.texi b/gcc/doc/gcov.texi
index 7256664..307137a 100644
--- a/gcc/doc/gcov.texi
+++ b/gcc/doc/gcov.texi
@@ -551,20 +551,23 @@ collected at that point to be dumped to @file{.gcda} output files.
@command{gcov} uses two files for profiling. The names of these files
are derived from the original @emph{object} file by substituting the
-file suffix with either @file{.gcno}, or @file{.gcda}. All of these files
-are placed in the same directory as the object file, and contain data
-stored in a platform-independent format.
-
-The @file{.gcno} file is generated when the source file is compiled with
-the GCC @option{-ftest-coverage} option. It contains information to
+file suffix with either @file{.gcno}, or @file{.gcda}. The files
+contain coverage and profile data stored in a platform-independent format.
+The @file{.gcno} files are placed in the same directory as the object
+file. By default, the @file{.gcda} files are also stored in the same
+directory as the object file, but the GCC @option{-profile-dir} option
+may be used to store the @file{.gcda} files in a separate directory.
+
+The @file{.gcno} notes file is generated when the source file is compiled
+with the GCC @option{-ftest-coverage} option. It contains information to
reconstruct the basic block graphs and assign source line numbers to
blocks.
-The @file{.gcda} file is generated when a program containing object files
-built with the GCC @option{-fprofile-arcs} option is executed. A
-separate @file{.gcda} file is created for each object file compiled with
-this option. It contains arc transition counts, and some summary
-information.
+The @file{.gcda} count data file is generated when a program containing
+object files built with the GCC @option{-fprofile-arcs} option is executed.
+A separate @file{.gcda} file is created for each object file compiled with
+this option. It contains arc transition counts, value profile counts, and
+some summary information.
The full details of the file format is specified in @file{gcov-io.h},
and functions provided in that header file should be used to access the