[Ltp-cvs] utils/analysis/lcov/man lcovrc.5,1.19,1.20

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

Update of /cvsroot/ltp/utils/analysis/lcov/man
In directory vz-cvs-4.sog:/tmp/cvs-serv9949/man

Modified Files:
	lcovrc.5 
Log Message:
geninfo: implement rc option geninfo_adjust_src_path

Provide a new lcovrc file option geninfo_adjust_src_path that users
can use to change incorrect source paths.

Inspired by patch by amm...@gm....


Index: lcovrc.5
===================================================================
RCS file: /cvsroot/ltp/utils/analysis/lcov/man/lcovrc.5,v
retrieving revision 1.19
retrieving revision 1.20
diff -C2 -d -r1.19 -r1.20
*** lcovrc.5	18 Jul 2012 12:56:21 -0000	1.19
--- lcovrc.5	24 Jul 2012 15:41:38 -0000	1.20
***************
*** 189,192 ****
--- 189,200 ----
  .br
  
+ # Adjust path to source files by removing or changing path
+ .br
+ # components that match the specified pattern (Perl regular
+ .br
+ # expression format)
+ .br
+ #geninfo_adjust_src_path = /tmp/build => /usr/src
+ 
  # Directory containing gcov kernel files
  .br
***************
*** 611,614 ****
--- 619,681 ----
  .PP
  
+ .BR geninfo_adjust_src_path " ="
+ .IR pattern " => " replacement
+ .br
+ .BR geninfo_adjust_src_path " ="
+ .I pattern
+ .IP
+ Adjust source paths when capturing coverage data.
+ 
+ Use this option in situations where geninfo cannot find the correct
+ path to source code files of a project. By providing a
+ .I pattern
+ in Perl regular expression format (see
+ .BR perlre (1))
+ and an optional replacement string, you can instruct geninfo to
+ remove or change parts of the incorrect source path.
+ 
+ .B Example:
+ .br
+ 
+ 1. When geninfo reports that it cannot find source file
+ .br
+ 
+     /path/to/src/.libs/file.c
+ .br
+ 
+ while the file is actually located in
+ .br
+ 
+     /path/to/src/file.c
+ .br
+ 
+ use the following parameter:
+ .br
+ 
+     geninfo_adjust_src_path = /.libs
+ 
+ This will remove all "/.libs" strings from the path.
+ 
+ 2. When geninfo reports that it cannot find source file
+ .br
+ 
+     /tmp/build/file.c
+ .br
+ 
+ while the file is actually located in
+ .br
+ 
+     /usr/src/file.c
+ .br
+ 
+ use the following parameter:
+ .br
+ 
+     geninfo_adjust_src_path = /tmp/build => /usr/src
+ .br
+ 
+ This will change all "/tmp/build" strings in the path to "/usr/src".
+ .PP
+ 
  .BR lcov_gcov_dir " ="
  .I path_to_kernel_coverage_data