NAME

       cobertura-instrument — add coverage instrumentation to existing classes

SYNOPSIS

       cobertura-instrument  [--basedir  dir]   [--datafile file]  [--destination dir]  [--ignore
       regex]  classes [...]

DESCRIPTION

       cobertura-instrument inserts instrumentation instructions directly into your compiled Java
       classes. When these instructions are encountered by the Java Virtual Machine, the inserted
       code increments various counters so that it is possible to tell  which  instructions  have
       been encountered and which have not.

OPTIONS

       Classes may be specified individually, or as a directory tree containing multiple classes.

       --basedir dir
                 Specify  the  base directory containing the classes you want to instrument. This
                 command  line  parameter  should  appear  before  any  classes.   If   you   are
                 instrumenting  classes  in  different  directories,  you should specify multiple
                 basedirs.

       --datafile file
                 Specify the name of the file to use for storing the metadata about your classes.
                 This  is  a  single  file  containing  serialized  Java  classes.   It  contains
                 information about the names of classes in your project, their method names, line
                 numbers,  etc.  It will be updated as your tests are run, and will be referenced
                 by the Cobertura reporting command. Default value: "./cobertura.ser".

       --destination dir
                 Specify the output directory for the instrumented classes.   If  no  destination
                 directory is specified, then the uninstrumented classes will be overwritten with
                 their instrumented counterparts.

       --ignore regex
                 Specify a regular expression to filter out certain lines of  your  source  code.
                 This  is  useful  for ignoring logging statements, for example.  You can have as
                 many <ignore/> statements as you want. By default no files are ignored.

SEE ALSO

       junit(1), cobertura-check(1), cobertura-report(1), cobertura-merge(1).

AUTHOR

       This manual page was written by Miguel Landaeta <miguel@miguel.cc> for the  Debian  system
       (but may be used by others).  Permission is granted to copy, distribute and/or modify this
       document under the terms of the terms of GNU General Public  License,  Version  2  or  any
       later version published by the Free Software Foundation.

       On  Debian  systems,  the  complete text of the GNU General Public License can be found in
       /usr/share/common-licenses/GPL.

                                                                          COBERTURA-INSTRUMENT(1)