COBERTURA-INSTRUMENT(1) 				      General Commands Manual					   COBERTURA-INSTRUMENT(1)

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)