CHANGES 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491
  1. Version 1.10
  2. ============
  3. All:
  4. - Disabled branch coverage processing per default to improve processing
  5. performance (can be re-enabled using a config file setting)
  6. - Added option --rc to override config file settings from the command line
  7. - Added option --config-file to override the config file location
  8. - Fixed handling of '<' in filenames
  9. genhtml:
  10. - Added option --ignore-errors to continue after errors
  11. - Added man page note to further explain branch coverage output
  12. - Fixed man page description of default coverage rates
  13. - Fixed HTML page title for directory pages
  14. - Fixed handling of special characters in file and directory names
  15. - Fixed directory prefix calculation
  16. - Fixed warning when source files are found in root directory
  17. geninfo:
  18. - Added options --external and --no-external to include/exclude external
  19. source files such as standard libary headers
  20. - Added option --compat to specify compatibility modes
  21. - Added missing man page sections for --derive-func-data and --no-markers
  22. - Added support for MinGW output on MSYS. From martin.hopfeld@sse-erfurt.de
  23. - Added support for gcc 4.7 .gcno file format. Based on patch by
  24. berrange@redhat.com
  25. - Added auto-detection of gcc-4.7 function record format. Includes
  26. suggestions by garnold@google.com
  27. - Fixed exclusion markers for --derive-func-data. Reported by bettse@gmail.com
  28. - Fixed processing of pre-3.3 gcov files. Reported by georgysebastian@gmail.com
  29. - Fixed handling of '<built-in>.gcov' files
  30. - Fixed warning about unhandled .gcov files
  31. - Improved --debug output
  32. - Removed help text for obsolete parameter --function-coverage
  33. genpng:
  34. - Fixed handling of empty source files. Reported by: sylvestre@debian.org
  35. lcov:
  36. - Added options --external and --no-external to include/exclude external source
  37. files such as standard libary headers
  38. - Added option --summary to show summary coverage information
  39. - Added option --compat to specify compatibility modes
  40. - Fixed missing Perl version dependency in RPM spec file. Reported by
  41. Martin Hopfeld <martin.hopfeld@sse-erfurt.de>
  42. - Fixed geninfo not recognizing Objective-C functions. Based on patch
  43. by abrahamh@web.de
  44. - Fixed option --no-recursion not being passed to geninfo
  45. - Fixed capitalization of the term 'Perl'
  46. - Improved coverage rate calculation to only show 0%/100% when no/full coverage
  47. is achieved. Based on suggestions by Paul.Zimmermann@loria.fr and
  48. vincent@vinc17.net
  49. lcovrc:
  50. - Added description for geninfo_compat setting
  51. - Added config file setting 'genhtml_charset' to specify HTML charset
  52. - Added config file setting 'geninfo_external' to include/exclude external
  53. source files such as standard libary headers
  54. - Added config file setting 'geninfo_gcov_all_blocks' to modify lcov's use
  55. of gcov's -a option
  56. - Added config file setting 'geninfo_compat' to specify compatibility modes
  57. - Added config file setting 'geninfo_adjust_src_path' to enabled source path
  58. adjustments. Inspired by patch by ammon.riley@gmail.com
  59. - Added config file setting 'geninfo_auto_base' to automatically determine
  60. the base directory when collecting coverage data
  61. - Added config file setting 'lcov_function_coverage' to enable/disable
  62. function coverage processing
  63. - Added config file setting 'lcov_branch_coverage' to enable/disable
  64. branch coverage processing
  65. Version 1.9
  66. ===========
  67. genhtml:
  68. - Improved wording for branch representation tooltip text
  69. - Fixed vertical alignment of HTML branch representation
  70. geninfo:
  71. - Improved warning message about --initial not generating branch coverage data
  72. - Debugging messages are now printed to STDERR instead of STDOUT
  73. - Fixed problem with some .gcno files. Reported by gui@futarque.com.
  74. (file.gcno: reached unexpected end of file)
  75. - Fixed problem with relative build paths. Reported by zhanbiao2000@gmail.com.
  76. (cannot find an entry for ^#src#test.c.gcov in .gcno file, skipping file!)
  77. - Fixed problem where coverage data is missing for some files. Reported by
  78. weston_schmidt@open-roadster.com
  79. - Fixed problem where exclusion markers are ignored when gathering
  80. initial coverage data. Reported by ahmed_osman@mentor.com.
  81. - Fixed large execution counts showing as negative numbers in HTML output.
  82. Reported by kkyriako@yahoo.com.
  83. - Fixed problem that incorrectly associated branches outside of a block with
  84. branches inside the first block
  85. lcov:
  86. - Fixed problem that made lcov ignore --kernel-directory parameters when
  87. specifying --initial. Reported by hjia@redhat.com.
  88. - Added --list-full-path option to prevent lcov from truncating paths in list
  89. output
  90. - Added lcov_list_width and lcov_list_truncate_max directives to the
  91. lcov configuration file to allow for list output customization
  92. - Improved list output
  93. COPYING:
  94. - Added license text to better comply with GPL recommendations
  95. Version 1.8
  96. ===========
  97. gendesc:
  98. - Fixed problem with single word descriptions
  99. genhtml:
  100. - Added support for branch coverage measurements
  101. - Added --demangle-cpp option to convert C++ function names to human readable
  102. format. Based on a patch by slava.semushin@gmail.com.
  103. - Improved color legend: legend display takes up less space in HTML output
  104. - Improved coverage rate limits: all coverage types use the same limits
  105. unless specified otherwise
  106. - Fixed CRLF line breaks in source code when generating html output. Based
  107. on patch by michael.knigge@set-software.de.
  108. - Fixed warning when $HOME is not set
  109. - Fixed problem with --baseline-file option. Reported by sixarm@gmail.com.
  110. (Undefined subroutine &main::add_fnccounts called at genhtml line 4560.)
  111. - Fixed problem with --baseline-file option and files without function
  112. coverage data (Can't use an undefined value as a HASH reference at genhtml
  113. line 4441.)
  114. - Fixed short-name option ambiguities
  115. - Fixed --highlight option not showing line data from converted test data
  116. - Fixed warnings about undefined value used. Reported by nikita@zhuk.fi.
  117. - Fixed error when processing tracefiles without function data. Reported
  118. by richard.corden@gmail.com (Can't use an undefined value as a HASH
  119. reference at genhtml line 1506.)
  120. geninfo:
  121. - Added support for branch coverage measurements
  122. - Added support for exclusion markers: Users can exclude lines of code from
  123. coverage reports by adding keywords to the source code.
  124. - Added --derive-func-data option
  125. - Added --debug option to better debug problems with graph files
  126. - Fixed CRLF line breaks in source code when generating tracefiles. Based on
  127. patch by michael.knigge@set-software.de.
  128. - Fixed problems with unnamed source files
  129. - Fixed warning when $HOME is not set. Reported by acalando@free.fr.
  130. - Fixed errors when processing unnamed source files
  131. - Fixed help text typo
  132. - Fixed errors when processing incomplete function names in .bb files
  133. - Fixed filename prefix detection
  134. - Fixed problem with matching filename
  135. - Fixed problem when LANG is set to non-english locale. Reported by
  136. benoit_belbezet@yahoo.fr.
  137. - Fixed short-name option ambiguities
  138. genpng:
  139. - Fixed runtime-warning
  140. lcov:
  141. - Added support for branch coverage measurements
  142. - Added support for the linux-2.6.31 upstream gcov kernel support
  143. - Added --from-package and --to-package options
  144. - Added --derive-func-data option
  145. - Added overall coverage result output for more operations
  146. - Improved output of lcov --list
  147. - Improved gcov-kernel handling
  148. - Fixed minor problem with --diff
  149. - Fixed double-counting of function data
  150. - Fixed warning when $HOME is not set. Reported by acalando@free.fr.
  151. - Fixed error when combining tracefiles without function data. Reported by
  152. richard.corden@gmail.com. (Can't use an undefined value as a HASH reference
  153. at lcov line 1341.)
  154. - Fixed help text typo
  155. - Fixed filename prefix detection
  156. - Fixed lcov ignoring information about converted test data
  157. README:
  158. - Added note to mention required -lgcov switch during linking
  159. Version 1.7:
  160. ============
  161. gendesc:
  162. - Updated error and warning messages
  163. - Updated man page
  164. genhtml:
  165. - Added function coverage data display patch by tomzo@nefkom.net (default is on)
  166. - Added --function-coverage to enable function coverage display
  167. - Added --no-function-coverage to disable function coverage display
  168. - Added sorting option in HTLM output (default is on)
  169. - Added --sort to enable sorting
  170. - Added --no-sort to disable sorting
  171. - Added --html-gzip to create gzip-compressed HTML output (patch by
  172. dnozay@vmware.com)
  173. - Fixed problem when using --baseline-file on coverage data files that
  174. contain data for files not found in the baseline file
  175. - Updated error and warning messages
  176. - Updated man page
  177. geninfo:
  178. - Added function coverage data collection patch by tomzo@nefkom.net
  179. - Added more verbose output when a "ERROR: reading string" error occurs
  180. (patch by scott.heavner@philips.com)
  181. - Fixed geninfo not working with directory names containing spaces (reported
  182. by jeffconnelly@users.sourceforge.net)
  183. - Fixed "ERROR: reading string" problem with gcc 4.1
  184. - Fixed problem with function names that contain non-alphanumerical characters
  185. - Fixed problem with gcc versions before 3.3
  186. - Updated error and warning messages
  187. - Updated man page
  188. genpng:
  189. - Updated error and warning messages
  190. - Updated man page
  191. lcov:
  192. - Added support for function coverage data for adding/diffing tracefiles
  193. - Added --no-recursion option to disable recursion into sub-directories
  194. while scanning for gcov data files
  195. - Fixed lcov -z not working with directory names containing spaces (reported
  196. by Jeff Connelly)
  197. - Updated error and warning messages
  198. - Updated man page
  199. lcov.spec:
  200. - Updated of description and title information
  201. lcovrc:
  202. - Added genhtml_function_hi_limit
  203. - Added genhtml_function_med_limit
  204. - Added genhtml_function_coverage
  205. - Added genhtml_sort
  206. - Updated man page
  207. Makefile:
  208. - Updated info text
  209. Version 1.6:
  210. ============
  211. geninfo:
  212. - Added libtool compatibility patch by thomas@apestaart.org (default is on)
  213. - Added --compat-libtool option to enable libtool compatibility mode
  214. - Added --no-compat-libtool option to disable libtool compatibility mode
  215. - Changed default for line checksumming to off
  216. - Added --checksum option to enable line checksumming
  217. - Added --gcov-tool option
  218. - Added --ignore-errors option
  219. - Added --initial option to generate zero coverage from graph files
  220. - Removed automatic test name modification on s390
  221. - Added --checksum option
  222. - Updated man page
  223. lcov:
  224. - Added libtool compatibility patch by thomas@apestaart.org
  225. - Added --compat-libtool option to enable libtool compatibility mode
  226. - Added --no-compat-libtool option to disable libtool compatibility mode
  227. - Added --checksum option to enable line checksumming
  228. - Added --gcov-tool option
  229. - Added --ignore-errors option
  230. - Added --initial option to generate zero coverage from graph files
  231. - Updated help text
  232. - Updated man page
  233. - Fixed lcov not working when -k is specified more than once
  234. - Fixed lcov not deleting .gcda files when specifying -z and -d
  235. lcovrc:
  236. - Added geninfo_compat_libtool option
  237. - Added geninfo_checksum option
  238. - Removed geninfo_no_checksum option from example lcovrc
  239. - Updated man page
  240. README:
  241. - Added description of lcovrc file
  242. Version 1.5:
  243. ============
  244. genhtml:
  245. - Added check for invalid characters in test names
  246. - Added --legend option
  247. - Added --html-prolog option
  248. - Added --html-epilog option
  249. - Added --html-extension option
  250. - Added warning when specifying --no-prefix and --prefix
  251. - Reworked help text to make it more readable
  252. geninfo:
  253. - Renamed 'sles9' compatibility mode to 'hammer' compatibility mode
  254. - Added support for mandrake gcc 3.3.2
  255. - Fixed bbg file reading in hammer compatibility mode
  256. - Added check for invalid characters in test names
  257. - Added --base-directory option
  258. lcov:
  259. - Added check for invalid characters in test names
  260. - Added --base-directory option
  261. Version 1.4:
  262. ============
  263. All:
  264. - Added configuration file support
  265. genhtml:
  266. - Fixed help text message
  267. - Fixed handling of special characters in file- and directory names
  268. - Added description of --css-file option to man page
  269. geninfo:
  270. - Added support for GCOV file format as used by GCC 3.3.3 on SUSE SLES9
  271. - Fixed error text message
  272. - Added check to abort processing if no source code file is available
  273. - Added workaround for a problem where geninfo could not find source code
  274. files for a C++ project
  275. - Fixed 'branch'-statement parsing for GCC>=3.3 .gcov files
  276. - Fixed exec count-statement parsing for GCC>=3.3 .gcov files
  277. - Fixed .gcno-file parser (some lines were not counted as being instrumented)
  278. lcov:
  279. - Modified path for temporary files from '.' to '/tmp'
  280. - Fixed comments
  281. - Removed unused function 'escape_shell'
  282. lcovrc:
  283. - Introduced sample configuration file
  284. Makefile:
  285. - Added rule to install configuration file
  286. - Fixed installation path for man pages
  287. Version 1.3:
  288. ============
  289. All:
  290. - Added compatibility for gcc-3.4
  291. lcov:
  292. - Modified --diff function to better cope with ambiguous entries in patch files
  293. - Modified --capture option to use modprobe before insmod (needed for 2.6)
  294. - Added --path option required for --diff function
  295. Version 1.2:
  296. ============
  297. All:
  298. - Added compatibility for gcc-3.3
  299. - Adjusted LCOV-URL (http://ltp.sourceforge.net/coverage/lcov.php)
  300. - Minor changes to whitespaces/line breaks/spelling
  301. - Modified call mechanism so that parameters for external commands are not
  302. parsed by the shell mechanism anymore (no more problems with special
  303. characters in paths/filenames)
  304. - Added checksumming mechanism: each tracefile now contains a checksum for
  305. each instrumented line to detect incompatible data
  306. Makefile:
  307. - Added rule to build source RPM
  308. - Changed install path for executables (/usr/local/bin -> /usr/bin)
  309. lcov.spec:
  310. - Modified to support building source rpms
  311. updateversion.pl:
  312. - Modified to include update of release number in spec file
  313. genhtml:
  314. - Fixed bug which would not correctly associate data sets with an empty
  315. test name (only necessary when using --show-details in genhtml)
  316. - Implemented new command line option '--nochecksum' to suppress generation
  317. of checksums
  318. - Implemented new command line option '--highlight' which highlights lines of
  319. code which were only covered in converted tracefiles (see '--diff' option of
  320. lcov)
  321. geninfo:
  322. - Added workaround for a bug in gcov shipped with gcc-3.2 which aborts when
  323. encountering empty .da files
  324. - Fixed geninfo so that it does not abort after encountering empty .bb files
  325. - Added function to collect branch coverage data
  326. - Added check for gcov tool
  327. - Added check for the '--preserve-paths' option of gcov; if available, this
  328. will prevent losing .gcov files in some special cases (include files with
  329. same name in different subdirectories)
  330. - Implemented new command line option '--follow' to control whether or not
  331. links should be followed while searching for .da files.
  332. - Implemented new command line option '--nochecksum' to suppress generation
  333. of checksums
  334. lcov:
  335. - Fixed bug which would not correctly associate data sets with an empty
  336. test name (only necessary when using --show-details in genhtml)
  337. - Cleaned up internal command line option check
  338. - Files are now processed in alphabetical order
  339. - Added message when reading tracefiles
  340. - Implemented new command line option '--nochecksum' to suppress generation
  341. of checksums
  342. - Implemented new command line option '--diff' which allows converting
  343. coverage data from an older source code version by using a diff file
  344. to map line numbers
  345. - Implemented new command line option '--follow' to control whether or not
  346. links should be followed while searching for .da files.
  347. genpng:
  348. - Added support for the highlighting option of genhtml
  349. - Corrected tab to spaces conversion
  350. - Modified genpng to take number of spaces to use in place of tab as input
  351. instead of replacement string
  352. Version 1.1:
  353. ============
  354. - Added CHANGES file
  355. - Added Makefile implementing the following targets:
  356. * install : install LCOV scripts and man pages
  357. * uninstall : revert previous installation
  358. * dist : create lcov.tar.gz file and lcov.rpm file
  359. * clean : clean up example directory, remove .tar and .rpm files
  360. - Added man pages for all scripts
  361. - Added example program to demonstrate the use of LCOV with a userspace
  362. application
  363. - Implemented RPM build process
  364. - New directory structure:
  365. * bin : contains all executables
  366. * example : contains a userspace example for LCOV
  367. * man : contains man pages
  368. * rpm : contains files required for the RPM build process
  369. - LCOV-scripts are now in bin/
  370. - Removed .pl-extension from LCOV-script files
  371. - Renamed readme.txt to README
  372. README:
  373. - Adjusted mailing list address to ltp-coverage@lists.sourceforge.net
  374. - Fixed incorrect parameter '--output-filename' in example LCOV call
  375. - Removed tool descriptions and turned them into man pages
  376. - Installation instructions now refer to RPM and tarball
  377. descriptions.tests:
  378. - Fixed some spelling errors
  379. genhtml:
  380. - Fixed bug which resulted in an error when trying to combine .info files
  381. containing data without a test name
  382. - Fixed bug which would not correctly handle data files in directories
  383. with names containing some special characters ('+', etc.)
  384. - Added check for empty tracefiles to prevent division-by-zeros
  385. - Implemented new command line option --num-spaces / the number of spaces
  386. which replace a tab in source code view is now user defined
  387. - Fixed tab expansion so that in source code view, a tab doesn't produce a
  388. fixed number of spaces, but as many spaces as are needed to advance to the
  389. next tab position
  390. - Output directory is now created if it doesn't exist
  391. - Renamed "overview page" to "directory view page"
  392. - HTML output pages are now titled "LCOV" instead of "GCOV"
  393. - Information messages are now printed to STDERR instead of STDOUT
  394. geninfo:
  395. - Fixed bug which would not allow .info files to be generated in directories
  396. with names containing some special characters
  397. - Information messages are now printed to STDERR instead of STDOUT
  398. lcov:
  399. - Fixed bug which would cause lcov to fail when the tool is installed in
  400. a path with a name containing some special characters
  401. - Implemented new command line option '--add-tracefile' which allows the
  402. combination of data from several tracefiles
  403. - Implemented new command line option '--list' which lists the contents
  404. of a tracefile
  405. - Implemented new command line option '--extract' which allows extracting
  406. data for a particular set of files from a tracefile
  407. - Implemented new command line option '--remove' which allows removing
  408. data for a particular set of files from a tracefile
  409. - Renamed '--reset' to '--zerocounters' to avoid a naming ambiguity with
  410. '--remove'
  411. - Changed name of gcov kernel directory from /proc/gcov to a global constant
  412. so that it may be changed easily when required in future versions
  413. - Information messages are now printed to STDERR instead of STDOUT
  414. Version 1.0 (2002-09-05):
  415. =========================
  416. - Initial version