Use --coverage instead of -fprofile-arcs -ftest-coverage in documentation (PR gcov-profile/89577).

2019-03-06  Martin Liska  <mliska@suse.cz>

	PR gcov-profile/89577
	* doc/gcov.texi: Prefer to use --coverage.
	* doc/sourcebuild.texi: Likewise.

From-SVN: r269415
This commit is contained in:
Martin Liska 2019-03-06 11:01:16 +01:00 committed by Martin Liska
parent 08bc73f09c
commit bb7c147fc8
3 changed files with 12 additions and 6 deletions

View File

@ -1,3 +1,9 @@
2019-03-06 Martin Liska <mliska@suse.cz>
PR gcov-profile/89577
* doc/gcov.texi: Prefer to use --coverage.
* doc/sourcebuild.texi: Likewise.
2019-03-02 Jason Merrill <jason@redhat.com> 2019-03-02 Jason Merrill <jason@redhat.com>
PR c++/86485 - -Wmaybe-unused with empty class ?: PR c++/86485 - -Wmaybe-unused with empty class ?:

View File

@ -486,8 +486,8 @@ are @emph{exactly} 0% and 100% respectively. Other values which would
conventionally be rounded to 0% or 100% are instead printed as the conventionally be rounded to 0% or 100% are instead printed as the
nearest non-boundary value. nearest non-boundary value.
When using @command{gcov}, you must first compile your program with two When using @command{gcov}, you must first compile your program
special GCC options: @samp{-fprofile-arcs -ftest-coverage}. with a special GCC option @samp{--coverage}.
This tells the compiler to generate additional information needed by This tells the compiler to generate additional information needed by
gcov (basically a flow graph of the program) and also includes gcov (basically a flow graph of the program) and also includes
additional code in the object files for generating the extra profiling additional code in the object files for generating the extra profiling
@ -504,7 +504,7 @@ for each line. For example, if your program is called @file{tmp.cpp}, this
is what you see when you use the basic @command{gcov} facility: is what you see when you use the basic @command{gcov} facility:
@smallexample @smallexample
$ g++ -fprofile-arcs -ftest-coverage tmp.cpp $ g++ --coverage tmp.cpp
$ a.out $ a.out
$ gcov tmp.cpp -m $ gcov tmp.cpp -m
File 'tmp.cpp' File 'tmp.cpp'
@ -802,8 +802,8 @@ new execution counts and finally writes the data to the file.
@section Using @command{gcov} with GCC Optimization @section Using @command{gcov} with GCC Optimization
If you plan to use @command{gcov} to help optimize your code, you must If you plan to use @command{gcov} to help optimize your code, you must
first compile your program with two special GCC options: first compile your program with a special GCC option
@samp{-fprofile-arcs -ftest-coverage}. Aside from that, you can use any @samp{--coverage}. Aside from that, you can use any
other GCC options; but if you want to prove that every single line other GCC options; but if you want to prove that every single line
in your program was executed, you should not compile with optimization in your program was executed, you should not compile with optimization
at the same time. On some machines the optimizer can eliminate some at the same time. On some machines the optimizer can eliminate some

View File

@ -2967,7 +2967,7 @@ in @file{lib/gcc-dg.exp} to compile and run the test program. A typical
@command{gcov} test contains the following DejaGnu commands within comments: @command{gcov} test contains the following DejaGnu commands within comments:
@smallexample @smallexample
@{ dg-options "-fprofile-arcs -ftest-coverage" @} @{ dg-options "--coverage" @}
@{ dg-do run @{ target native @} @} @{ dg-do run @{ target native @} @}
@{ dg-final @{ run-gcov sourcefile @} @} @{ dg-final @{ run-gcov sourcefile @} @}
@end smallexample @end smallexample