diff options
author | nathan <nathan@138bc75d-0d04-0410-961f-82ee72b054a4> | 2002-08-14 20:06:12 +0000 |
---|---|---|
committer | nathan <nathan@138bc75d-0d04-0410-961f-82ee72b054a4> | 2002-08-14 20:06:12 +0000 |
commit | 44b0ffc3f6652b62823cc97047e44ca83cbc6651 (patch) | |
tree | fbebd6cde7d3e300c5f148a728e2f6590e007596 | |
parent | 16f99f45ed03d50ea6fb80e8bd04f4980479bd8a (diff) | |
download | gcc-44b0ffc3f6652b62823cc97047e44ca83cbc6651.tar.gz |
* doc/invoke.texi (-a): Remove documentation.
(-fprofile-arcs): Remove reference to -a, -ax options.
* doc/gcov.texi (Gcov Data Files): Data might be merged.
git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@56331 138bc75d-0d04-0410-961f-82ee72b054a4
-rw-r--r-- | gcc/ChangeLog | 8 | ||||
-rw-r--r-- | gcc/doc/gcov.texi | 10 | ||||
-rw-r--r-- | gcc/doc/invoke.texi | 32 |
3 files changed, 14 insertions, 36 deletions
diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 7143413f998..afd4ac23897 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,9 @@ +2002-08-14 Nathan Sidwell <nathan@codesourcery.com> + + * doc/invoke.texi (-a): Remove documentation. + (-fprofile-arcs): Remove reference to -a, -ax options. + * doc/gcov.texi (Gcov Data Files): Data might be merged. + 2002-08-14 Gabriel Dos Reis <gdr@nerim.net> Fix PR/7566 @@ -606,7 +612,7 @@ Sat Aug 10 19:59:43 CEST 2002 Jan Hubicka <jh@suse.cz> (end_branch_prob): Remove da file. * Makefile.in (stage1_build): Pass empty COVERAGE_FLAGS. - * configure.in (coverage_flags) default to nothing. + * configure.in (coverage_flags): Default to nothing. * configure: Rebuilt. 2002-08-09 Neil Booth <neil@daikokuya.co.uk> diff --git a/gcc/doc/gcov.texi b/gcc/doc/gcov.texi index 070a08cada7..9c0ac11d420 100644 --- a/gcc/doc/gcov.texi +++ b/gcc/doc/gcov.texi @@ -464,10 +464,10 @@ built with the GCC @option{-fprofile-arcs} option is executed. A separate @file{.da} file is created for each source file compiled with this option, and the name of the @file{.da} file is stored as an absolute pathname in the resulting object file. This path name is -derived from the source file name by substituting a @file{.da} suffix. +derived from the object file name by substituting a @file{.da} suffix. -The @file{.da} consists of several blocks (one for each run) with the -following structure: +The @file{.da} consists of one or more blocks with the following +structure: @smallexample "magic" number @minus{}123 (4-byte number) number of functions (4-byte number) @@ -484,7 +484,9 @@ following structure: checksum of function #1 @dots{} @end smallexample -The current structure of the extension block is as follows: +Multiple program runs might merge data into a single block, or might +append a new block. The current structure of the extension block is as +follows: @smallexample number of instrumented arcs in whole program (4-byte number) sum all of instrumented arcs in whole program (8-byte number) diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 79a2149ffb9..f898f907665 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -2795,20 +2795,6 @@ analysis program @code{gprof}. You must use this option when compiling the source files you want data about, and you must also use it when linking. -@cindex @code{tcov} -@item -a -@opindex a -Generate extra code to write profile information for basic blocks, which will -record the number of times each basic block is executed, the basic block start -address, and the function name containing the basic block. If @option{-g} is -used, the line number and filename of the start of the basic block will also be -recorded. If not overridden by the machine description, the default action is -to append to the text file @file{bb.out}. - -This data could be analyzed by a program like @code{tcov}. Note, -however, that the format of the data is not what @code{tcov} expects. -Eventually GNU @code{gprof} should be extended to process this data. - @item -Q @opindex Q Makes the compiler print out each function name as it is compiled, and @@ -2846,18 +2832,7 @@ optimization and code generation options plus Control Optimization}). The other use of @option{-fprofile-arcs} is for use with @code{gcov}, -when it is used with the @option{-ftest-coverage} option. GCC -supports two methods of determining code coverage: the options that -support @code{gcov}, and options @option{-a} and @option{-ax}, which -write information to text files. The options that support @code{gcov} -do not need to instrument every arc in the program, so a program compiled -with them runs faster than a program compiled with @option{-a}, which -adds instrumentation code to every basic block in the program. The -tradeoff: since @code{gcov} does not have execution counts for all -branches, it must start with the execution counts for the instrumented -branches, and then iterate over the program flow graph until the entire -graph has been solved. Hence, @code{gcov} runs a little more slowly than -a program which uses information from @option{-a} and @option{-ax}. +when it is used with the @option{-ftest-coverage} option. With @option{-fprofile-arcs}, for each function of your program GCC creates a program flow graph, then finds a spanning tree for the graph. @@ -2867,11 +2842,6 @@ executed. When an arc is the only exit or only entrance to a block, the instrumentation code can be added to the block; otherwise, a new basic block must be created to hold the instrumentation code. -This option makes it possible to estimate branch probabilities and to -calculate basic block execution counts. In general, basic block -execution counts as provided by @option{-a} do not give enough -information to estimate all branch probabilities. - @need 2000 @item -ftest-coverage @opindex ftest-coverage |