NAME
gen_html -- generate html pages describing test coverage
SYNOPSIS
gen_html merged.db
DESCRIPTION
This script generates html pages given the name of a merged.db
file. This file should have been created after running all
your project's tests with instrumented executables. Here is a
general overview of the process:
replace your calls to g++ with calls to cov++
make clean, then make, then run all your tests
merge your coverage files like this:
covmerge.exe `find * -name '*.covexp'` >merged.db
use gen_html to build html pages:
gen_html merged.db
Once gen_html has done its job, you will have a new directory
named 'coverage_html'. This directory will contain a variety
of numbered .html files. There will also be an 'index.html'
file. Point your browser at that and you will see a
collection of html files describing the test coverage
information and more importantly, you will see annotated copies
of your source code.
An annotated sourcefile will look like this:
#include <stdio.h>
int main()
+{
+ printf("hello world");
+ exit(0);
}
Where the lines beginning with '-' have been instrumented but
not executed. Lines beginning with '+' were executed. Lines
with never were not executed. Global variables are never
shown as instrumented due to the limitations of the
instrumentation technique.
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gen_html&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>