[Ltp-cvs] utils/analysis/lcov/man geninfo.1, 1.7, 1.8 lcov.1, 1.9, 1.10

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

Update of /cvsroot/ltp/utils/analysis/lcov/man
In directory sc8-pr-cvs6.sourceforge.net:/tmp/cvs-serv1063/man

Modified Files:
	geninfo.1 lcov.1 
Log Message:
lcov:
- add new option --initial to get zero coverage data from graph files


Index: geninfo.1
===================================================================
RCS file: /cvsroot/ltp/utils/analysis/lcov/man/geninfo.1,v
retrieving revision 1.7
retrieving revision 1.8
diff -C2 -d -r1.7 -r1.8
*** geninfo.1	4 Jul 2007 13:13:22 -0000	1.7
--- geninfo.1	6 Jul 2007 07:38:47 -0000	1.8
***************
*** 9,12 ****
--- 9,13 ----
  .br
  .RS 8
+ .RB [ \-i | \-\-initial ]
  .RB [ \-t | \-\-test\-name
  .IR test\-name ]
***************
*** 171,174 ****
--- 172,189 ----
  .RE
  
+ .B \-i
+ .br
+ .B \-\-initial
+ .RS
+ Capture initial zero coverage data.
+ 
+ Run geninfo with this option on the directories containing .bb, .bbg or .gcno
+ files before running any test case. The result is a "baseline" coverage data
+ file that contains zero coverage for every instrumented line. Combine this
+ data file (using lcov \-a) with coverage data files captured after a test
+ run to ensure that the percentage of total lines covered is correct even
+ when not all source code files were loaded during the test.
+ .RE
+ 
  .BI "\-o " output\-filename
  .br

Index: lcov.1
===================================================================
RCS file: /cvsroot/ltp/utils/analysis/lcov/man/lcov.1,v
retrieving revision 1.9
retrieving revision 1.10
diff -C2 -d -r1.9 -r1.10
*** lcov.1	4 Jul 2007 13:13:22 -0000	1.9
--- lcov.1	6 Jul 2007 07:38:47 -0000	1.10
***************
*** 27,30 ****
--- 27,31 ----
  .IR "tracefile diff" ]
  .br
+ .RB [ \-i | \-\-initial ]
  .RB [ \-t | \-\-test\-name
  .IR testname ]
***************
*** 343,346 ****
--- 344,388 ----
  .RE
  
+ .B \-i
+ .br
+ .B \-\-initial
+ .RS
+ Capture initial zero coverage data.
+ 
+ Run lcov with \-c and this option on the directories containing .bb, .bbg
+ or .gcno files before running any test case. The result is a "baseline"
+ coverage data file that contains zero coverage for every instrumented line.
+ Combine this data file (using lcov \-a) with coverage data files captured
+ after a test run to ensure that the percentage of total lines covered is
+ correct even when not all source code files were loaded during the test.
+ 
+ Recommended procedure when capturing data for a test case:
+ 
+ 1. create baseline coverage data file
+ .RS
+ # lcov -c -i -d appdir -o app_base.info
+ .br
+ 
+ .RE
+ 2. perform test
+ .RS
+ # appdir/test
+ .br
+ 
+ .RE
+ 3. create test coverage data file
+ .RS
+ # lcov -c -d appdir -o app_test.info
+ .br
+ 
+ .RE
+ 4. combine baseline and test coverage data
+ .RS
+ # lcov -a app_base.info -a app_test.info -o app_total.info
+ .br
+ 
+ .RE
+ .RE
+ 
  .B \-k
  .I subdirectory