[PATCH] remove mention of -a and -ax in invoke.texi for 3.2
Janis Johnson
janis187@us.ibm.com
Mon Oct 28 11:29:00 GMT 2002
The message http://gcc.gnu.org/ml/gcc/2002-10/msg01615.html reported
that the 3.2 documentation references the -a and -ax options. The
documentation for those options was removed, but they were still
mentioned in the entry for -profile-arcs.
OK for the 3.2 branch? This text is already gone in the mainline.
2002-10-28 Janis Johnson <janis187@us.ibm.com>
* doc/invoke.texi (-profile-arcs): Remove references to -a and -ax.
Index: doc/invoke.texi
===================================================================
RCS file: /cvs/gcc/gcc/gcc/doc/invoke.texi,v
retrieving revision 1.119.2.12.4.7
diff -u -r1.119.2.12.4.7 invoke.texi
--- doc/invoke.texi 23 Oct 2002 13:38:28 -0000 1.119.2.12.4.7
+++ doc/invoke.texi 28 Oct 2002 19:23:23 -0000
@@ -2933,18 +2933,7 @@
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.
@@ -2953,11 +2942,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
More information about the Gcc-patches
mailing list