[Ltp-cvs] utils/analysis/lcov/man lcovrc.5,1.17,1.18

[Peter O. <obe...@us...>]

Update of /cvsroot/ltp/utils/analysis/lcov/man
In directory sfp-cvsdas-2.v30.ch3.sourceforge.com:/tmp/cvs-serv7537/man

Modified Files:
	lcovrc.5 
Log Message:
gcov: add configuration file option to not use gcov's -a option

lcov calls gcov while specifying its --all-blocks option to get more
detailed branch coverage data per line. It turns out that this option
is broken on many versions of gcov, resulting in an endless loop while
processing some gcov data files. There's also a slight performance
penalty when specifying -a.

lcov users can opt to not use the -a option by setting configuration
option geninfo_gcov_all_blocks to 0 in the lcovrc file.


Index: lcovrc.5
===================================================================
RCS file: /cvsroot/ltp/utils/analysis/lcov/man/lcovrc.5,v
retrieving revision 1.17
retrieving revision 1.18
diff -C2 -d -r1.17 -r1.18
*** lcovrc.5	23 Aug 2010 14:47:43 -0000	1.17
--- lcovrc.5	31 Aug 2010 08:17:23 -0000	1.18
***************
*** 170,173 ****
--- 170,185 ----
  .br
  
+ # Specify whether to capture coverage data for external source
+ .br
+ # files
+ .br
+ #geninfo_external = 1
+ .br
+ 
+ # Use gcov's --all-blocks option if non-zero
+ .br
+ #geninfo_gcov_all_blocks = 1
+ .br
+ 
  # Directory containing gcov kernel files
  .br
***************
*** 200,209 ****
  lcov_list_truncate_max = 20
  
- # Specify whether to capture coverage data for external source
- .br
- # files
- .br
- geninfo_external = 1
- .br
  .PP
  
--- 212,215 ----
***************
*** 572,575 ****
--- 578,594 ----
  .PP
  
+ .BR geninfo_gcov_all_blocks " ="
+ .IR 0 | 1
+ .IP
+ If non\-zero, call the gcov tool with option --all-blocks.
+ 
+ Using --all-blocks will produce more detailed branch coverage information for
+ each line. Set this option to zero if you do not need detailed branch coverage
+ information to speed up the process of capturing code coverage or to work
+ around a bug in some versions of gcov which will cause it to endlessly loop
+ when analysing some files.
+ 
+ Default is 1.
+ .PP
  
  .BR lcov_gcov_dir " ="