7. Common ANT task and command line options

7.1. Common ANT task attributes and nested elements

All EMMA tasks and subtasks have a set of common attributes and nested elements:

Table 2.3. Common EMMA ANT task attributes

AttributeDescriptionRequired
enabledIf set to false, disables the corresponding EMMA ANT task or subtask. This can be used to effect a simple form of build control flow (default: true).No (everything is enabled by default)
verbositySets the verbosity level for a given task or an entire <emma> group of tasks. Valid values in the order of increasing verbosity are:
  • silent (same as severe): only severe errors are reported;
  • quiet (same as warning): only warnings and severe errors are reported;
  • info: default verbosity level, with EMMA reporting on completion of various activities, warnings, and errors
  • verbose: this setting makes EMMA chattier than normal, with extra progress reporting;
  • trace1, trace2, trace3: these settings enable internal tracing (useful mostly for debugging).
(default: info).
No (defaults to info)
propertiesThis option specifies a pathname for an EMMA property override file, in the standard java.util.Properties format. See Chapter 3, EMMA Property Reference for more information on setting EMMA properties.No

Table 2.4. Common EMMA ANT task nested elements

ElementDescriptionRequired
<property>This nested element sets a single EMMA property. It is the ANT equivalent of -D command line option and is provided mostly for internal testing (EMMA ANT tasks provide proper attributes and nested elements for all public tool settings). See Chapter 3, EMMA Property Reference for more information on setting EMMA properties.No

<property> nested element. This nested element can be used to set a generic EMMA property as a name-value pair using the following attributes:

AttributeDescriptionRequired
nameProperty name (without “emma.” prefix).Yes
valueProperty value.Yes