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)
Check Out this Related Man Page
CFLOW(1) cflow manual CFLOW(1)NAME
cflow - analyze control flow in C source files
SYNOPSIS
cflow [option...] file...
cflow {--help | --usage | --version | -V}
DESCRIPTION
This manual page documents briefly the cflow command.
This manual page was written for the Debian distribution because the original program does not have a manual page. Instead, it has
documentation in the GNU info(1) format.
GNU cflow analyzes a collection of C source files and prints a graph, charting control flow within the program.
GNU cflow is able to produce both direct and inverted flowgraphs for C sources. Optionally a cross-reference listing can be generated. Two
output formats are implemented: POSIX and GNU (extended).
Input files can optionally be preprocessed before analyzing.
OPTIONS
A summary of options is included below. For a complete description, see the info(1) files.
The program follows the usual GNU command line syntax, with long options starting with two dashes (-). Mandatory or optional arguments to
long options are also mandatory or optional for any corresponding short options.
The effect of each option marked with an asterisk is reversed if the option's long name is prefixed with 'no-'. For example, '--no-cpp'
cancels '--cpp'.
General options
-d, --depth=number
Set the depth at which the flowgraph is cut off.
-f, --format=name
Use given output format name. Valid names are 'gnu' (default) and 'posix'.
-i, --include=classes
Include specified classes of symbols (see below). Prepend classes with ^ or - to exclude them from the output.
Symbols classes:
_
symbols whose names begin with an underscore
s
static symbols
t
typedefs (for cross-references only)
x
all data symbols, both external and static
-o, --output=file
Set output file name. Default is -, meaning standard output.
-r, --reverse
* Print reverse call graph.
-x, --xref
Produce cross-reference listing only.
Parser control
-a, --ansi
* Accept only sources in ANSI C.
-D, --define=name[=defn]
Predefine name as a macro.
-I, --include-dir=dir
Add the directory dir to the list of directories to be searched for header files.
-m, --main=name
Assume main function to be called name.
-p, --pushdown=number
Set initial token stack size to number.
--preprocess[=command], --cpp[=command]
* Run the specified preprocessor command.
-s, --symbol=symbol:type
Register symbol with given type. Valid types are: 'keyword' (or 'kw'), 'modifier', 'identifier', 'type', 'wrapper'. Any unambiguous
abbreviation of the above is also accepted.
-S, --use-indentation
* Use source file indentation as a hint.
-U, --undefine=name
Cancel any previous definition of name.
Output control
-b, --brief
* Use brief output.
--emacs
* Additionally format output for use with GNU Emacs.
-l, --print-level
* Print nesting level along with the call graph.
--level-indent=string
Use string when indenting to each new level.
-n, --number
* Print line numbers.
--omit-arguments
* Do not print argument lists in function declarations.
--omit-symbol-names
* Do not print symbol names in declaration strings.
-T, --tree
* Draw ASCII art tree.
Informational options
--debug[=number]
Set debugging level.
-v, --verbose
* Verbosely list any any errors encountered in the input files.
-?, --help
Display help and exit.
--usage
Display short usage message and exit.
-V, --version
Display version information and exit.
AUTHOR
Jakub Wilk <jwilk@debian.org>
Wrote this manpage for the Debian system.
COPYRIGHT
Copyright (C) 1997, 2005, 2007 Sergey Poznyakoff
Copyright (C) 2009 Jakub Wilk
This manual page was written for the Debian system (and may be used by others).
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License Version 3, as
published by the Free Software Foundation.
On Debian systems, the complete text of the GNU General Public License Version 3 can be found in /usr/share/common-licenses/GPL-3.
cflow 1.2 12/14/2012 CFLOW(1)