Man Linux: Main Page and Category List

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.