NAME

       git-history-coverage - summarise test coverage for recent git commits

SYNOPSIS

       git-history-coverage [options] rev-list

DESCRIPTION

       Git-history-coverage  extracts  test coverage data produced by C and C++ programs compiled
       with gcc --coverage, and correlates it to git commits, printing a coverage  summary  which
       shows  how  well  tested recent code changes have been.  This is useful for nightly builds
       and Continuous Integration systems such as Jenkins.

       For the output of git-history-coverage to make  any  sense,  the  coverage  data  must  be
       generated  by  running code which corresponds to the last commit in the range specified by
       rev-list.

       When used without any options, git-history-coverage prints three summaries.

       overall
              A summary of all the commits specified by rev-list.

       by author
              A summary split up by each author represented in the set of  commits  specified  by
              rev-list.

       by commit
              A summary for each individual commit in the set of commits specified by rev-list.

       For each of these summaries, git-history-coverage prints statistics showing how many lines
       of code were in the commits, how many lines  represent  executable  code  (as  opposed  to
       comments,  test  code, or infrastructure like Makefiles), and how many lines were actually
       executed in tests.

OPTIONS

       --summary-overall
              Print the overall summary (with no options, all three summaries are printed).

       --summary-by-author
              Print the by author summary (with no options, all three summaries are printed).

       --summary-by-commit
              Print the by commit summary (with no options, all three summaries are printed).

       --gcda-prefix=dir
              Look for .gcda files underneath the directory dir.  This option  is  used  to  read
              runtime  coverage  information  written  when  a test program is run using the same
              --gcda-prefix option to ggcov-run.

AUTHOR

       Written by Greg Banks <gnb@users.sourceforge.net>.

COPYRIGHT

       ggcov is Copyright © 2001-2011 Greg Banks <gnb@users.sourceforge.net>.
       This is free software; see the COPYING file for copying conditions.  There is NO warranty;
       not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO

       ggcov-run(1).