[PATCH] remove mention of -a and -ax in invoke.texi for 3.2

[PATCH] remove mention of -a and -ax in invoke.texi for 3.2

[Janis Johnson]

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

Re: [PATCH] remove mention of -a and -ax in invoke.texi for 3.2

[Gerald Pfeifer]

On Mon, 28 Oct 2002, Janis Johnson wrote:
> 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.

Given this...

> 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.

...the patch seems to fall under the "obvious rule"?

-This option makes it possible to estimate branch probabilities and to
-calculate basic block execution counts.

Should this part really be removed as well?

Gerald
-- 
Gerald "Jerry" pfeifer@dbai.tuwien.ac.at http://www.dbai.tuwien.ac.at/~pfeifer/

Re: [PATCH] remove mention of -a and -ax in invoke.texi for 3.2

[Janis Johnson]

On Mon, Oct 28, 2002 at 09:01:57PM +0100, Gerald Pfeifer wrote:
> On Mon, 28 Oct 2002, Janis Johnson wrote:
> > 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.
> 
> Given this...
> 
> > 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.
> 
> ...the patch seems to fall under the "obvious rule"?
> 
> -This option makes it possible to estimate branch probabilities and to
> -calculate basic block execution counts.
> 
> Should this part really be removed as well?

It was gone from the mainline so I removed it from the branch.  The
information is implied in the first part of this section, and it would
look out of place to leave this sentence at the end.

Janis

Re: [PATCH] remove mention of -a and -ax in invoke.texi for 3.2

[Gerald Pfeifer]

On Mon, 28 Oct 2002, Janis Johnson wrote:
>> Should this part really be removed as well?
> It was gone from the mainline so I removed it from the branch.  The
> information is implied in the first part of this section, and it would
> look out of place to leave this sentence at the end.

Sorry, apparantely I missed that.  The patch/backport to the 3.2-branch
seems fine, then.

Thanks!
Gerald
-- 
Gerald "Jerry" pfeifer@dbai.tuwien.ac.at http://www.dbai.tuwien.ac.at/~pfeifer/

Re: [PATCH] remove mention of -a and -ax in invoke.texi for 3.2

[Mark Mitchell]

> OK for the 3.2 branch?  This text is already gone in the mainline.

Yes, thanks.

-- 
Mark Mitchell                mark@codesourcery.com
CodeSourcery, LLC            http://www.codesourcery.com