[Ltp-cvs] utils/analysis/lcov/man genhtml.1, 1.9, 1.10 geninfo.1, 1.9, 1.10 lcov.1, 1.11, 1.12 lcov

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 454-5900

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

Modified Files:
	genhtml.1 geninfo.1 lcov.1 lcovrc.5 
Log Message:
lcov: integrated function coverage patch by Tom Zoernen + sorting function

Index: genhtml.1
===================================================================
RCS file: /cvsroot/ltp/utils/analysis/lcov/man/genhtml.1,v
retrieving revision 1.9
retrieving revision 1.10
diff -C2 -d -r1.9 -r1.10
*** genhtml.1	5 Feb 2008 09:18:50 -0000	1.9
--- genhtml.1	13 Aug 2008 13:53:50 -0000	1.10
***************
*** 47,50 ****
--- 47,53 ----
  .br
  .RB [ \-\-html-gzip ]
+ .RB [ \-\-no\-sort ]
+ .RB [ \-\-no\-function\-coverage ]
+ .br
  .IR tracefile(s)
  .RE
***************
*** 392,395 ****
--- 395,420 ----

  .RE
+ .B \-\-no\-sort
+ .RS
+ Remove sorted views from output.
+ 
+ Use this switch if you don't want overview pages sorted by coverage rate.
+ 
+ This option can also be configured permanently using the configuration file
+ option
+ .IR genhtml_sort .
+ 
+ .RE
+ .B \-\-no\-function\-coverage
+ .RS
+ Remove function coverage data display from output.
+ 
+ Use this switch if you don't want function coverage data to be displayed.
+ 
+ This option can also be configured permanently using the configuration file
+ option
+ .IR genhtml_function_coverage .
+ 
+ .RE
  .SH FILES

Index: geninfo.1
===================================================================
RCS file: /cvsroot/ltp/utils/analysis/lcov/man/geninfo.1,v
retrieving revision 1.9
retrieving revision 1.10
diff -C2 -d -r1.9 -r1.10
*** geninfo.1	7 May 2008 15:08:12 -0000	1.9
--- geninfo.1	13 Aug 2008 13:53:50 -0000	1.10
***************
*** 270,273 ****
--- 270,283 ----
    FN:<line number of function start>,<function name>

+ Next, there is a list of execution counts for each instrumented function:
+ 
+   FNDA:<execution count>,<function name>
+ 
+ This list is followed by two lines containing the number of functions found
+ and hit:
+ 
+   FNF:<number of functions found>
+   FNH:<number of function hit>
+ 
  Then there is a list of execution counts for each instrumented line
  (i.e. a line which resulted in executable code):

Index: lcov.1
===================================================================
RCS file: /cvsroot/ltp/utils/analysis/lcov/man/lcov.1,v
retrieving revision 1.11
retrieving revision 1.12
diff -C2 -d -r1.11 -r1.12
*** lcov.1	7 May 2008 15:08:12 -0000	1.11
--- lcov.1	13 Aug 2008 13:53:50 -0000	1.12
***************
*** 1,5 ****
  .TH lcov 1 "lcov 1.1" 2003\-12\-19 "User Manuals"
  .SH NAME
! lcov \- GCOV coverage tool extension
  .SH SYNOPSIS
  .B lcov
--- 1,5 ----
  .TH lcov 1 "lcov 1.1" 2003\-12\-19 "User Manuals"
  .SH NAME
! lcov \- a graphical GCOV front-end
  .SH SYNOPSIS
  .B lcov
***************
*** 65,88 ****
  .SH DESCRIPTION
  .B lcov
! is an extension of GCOV, a GNU tool which provides information
! about what parts of a program are actually executed (i.e. "covered")
! during a particular test case. The extension consists of a set
! of PERL scripts which build on the textual GCOV output to implement
! HTML output and support for large projects.

  Use
  .B lcov
! to collect coverage data from either the currently running Linux kernel
! or from a user space application. To do this, you have to complete the
! following preparation steps:

  For Linux kernel coverage:
  .RS
! Download and install the "gcov\-kernel" package from
! .I http://sourceforge.net/projects/ltp
! 
! The resulting kernel module has to be installed either in the system wide
! kernel modules directory or in the same directory as the LCOV tool.
! Note that you will need root privileges to access kernel coverage data.

  .RE
--- 65,85 ----
  .SH DESCRIPTION
  .B lcov
! is a graphical front-end for GCC's coverage testing tool gcov. It collects
! gcov data for multiple source files and creates HTML pages containing the
! source code annotated with coverage information. It also adds overview pages
! for easy navigation within the file structure.

  Use
  .B lcov
! to collect coverage data and
! .B genhtml
! to create HTML pages. Coverage data can either be collected from the
! currently running Linux kernel or from a user space application. To do this,
! you have to complete the following preparation steps:

  For Linux kernel coverage:
  .RS
! Follow the installation instructions for the gcov-kernel patch:
! .I http://ltp.sourceforge.net/coverage/gcov.php

  .RE

Index: lcovrc.5
===================================================================
RCS file: /cvsroot/ltp/utils/analysis/lcov/man/lcovrc.5,v
retrieving revision 1.4
retrieving revision 1.5
diff -C2 -d -r1.4 -r1.5
*** lcovrc.5	5 Feb 2008 09:18:50 -0000	1.4
--- lcovrc.5	13 Aug 2008 13:53:50 -0000	1.5
***************
*** 48,52 ****
  .br

! # Coverage rate limits
  .br
  genhtml_hi_limit = 50
--- 48,52 ----
  .br

! # Coverage rate limits for line coverage
  .br
  genhtml_hi_limit = 50
***************
*** 55,58 ****
--- 55,65 ----
  .br

+ # Coverage rate limits for function coverage
+ .br
+ genhtml_function_hi_limit = 90
+ .br
+ genhtml_function_med_limit = 75
+ .br
+ 
  # Width of overview image
  .br
***************
*** 120,123 ****
--- 127,140 ----
  .br

+ # Include sorted overview pages
+ .br
+ genhtml_sort = 1
+ .br
+ 
+ # Include function coverage data display
+ .br
+ genhtml_function_coverage = 1
+ .br
+ 
  # Location of the gcov tool
  .br
***************
*** 189,197 ****
  .BR genhtml_med_limit " ="
  .I med_limit
  .IP
  Specify coverage rate limits for classifying file entries. Use this option to
! modify the coverage rates (in percent) at which a result is classified as
! high, medium or low coverage. This classification affects the color of the
! corresponding entries on the overview pages of the HTML output:
  .br

--- 206,221 ----
  .BR genhtml_med_limit " ="
  .I med_limit
+ .br
+ .BR genhtml_function_med_limit " ="
+ .I hi_limit
+ .br
+ .BR genhtml_function_med_limit " ="
+ .I med_limit
  .IP
  Specify coverage rate limits for classifying file entries. Use this option to
! modify the coverage rates (in percent) for line or function coverage at which
! a result is classified as high, medium or low coverage. This classification
! affects the color of the corresponding entries on the overview pages of the
! HTML output:
  .br

***************
*** 203,207 ****
  .br

! Defaults are 50 and 15 respectively.
  .PP

--- 227,232 ----
  .br

! Defaults are 50 and 15 percent for line coverage and 90 and 75 percent for
! function coverage.
  .PP

***************
*** 385,388 ****
--- 410,442 ----
  .PP

+ .BR genhtml_sort " ="
+ .IR 0 | 1
+ .IP
+ If non-zero, create overview pages sorted by coverage rates when generating
+ HTML output using
+ .BR genhtml .
+ .br
+ 
+ This option can be set to 0 by using the \-\-no\-sort option of
+ .BR genhtml .
+ .br
+ 
+ Default is 1.
+ .PP
+ 
+ .BR genhtml_function_coverage " ="
+ .IR 0 | 1
+ .IP
+ If non-zero, include function coverage data when generating HTML output using
+ .BR genhtml .
+ .br
+ 
+ This option can be set to 0 by using the \-\-no\-function\-coverage option of
+ .BR genhtml .
+ .br
+ 
+ Default is 1.
+ .PP
+ 
  .BR geninfo_gcov_tool " ="
  .I path_to_gcov

[Ltp-cvs] utils/analysis/lcov/man genhtml.1, 1.9, 1.10 geninfo.1, 1.9, 1.10 lcov.1, 1.11, 1.12 lcov

Testsuite to validate the reliability, robustness, stability of Linux.

[Ltp-cvs] utils/analysis/lcov/man genhtml.1, 1.9, 1.10 geninfo.1, 1.9, 1.10 lcov.1, 1.11, 1.12 lcovrc.5, 1.4, 1.5