diff options
Diffstat (limited to 'org.jacoco.doc/docroot/doc')
25 files changed, 802 insertions, 759 deletions
diff --git a/org.jacoco.doc/docroot/doc/agent.html b/org.jacoco.doc/docroot/doc/agent.html index 59f0cdd3..719a843a 100644 --- a/org.jacoco.doc/docroot/doc/agent.html +++ b/org.jacoco.doc/docroot/doc/agent.html @@ -14,7 +14,7 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">Java Agent</span> </div> -<div id="content"> +<div id="content"> <h1>Java Agent</h1> @@ -51,7 +51,7 @@ <p> The agent <code>jacocoagent.jar</code> is part of the JaCoCo distribution and includes all required dependencies. A Java agent can be activated with the - following JVM option: + following JVM option: </p> <pre> @@ -59,7 +59,7 @@ </pre> <p> - The JaCoCo agent accepts the following options: + The JaCoCo agent accepts the following options: </p> <table class="coverage"> @@ -83,14 +83,14 @@ <code>false</code>, an existing execution data file will be replaced. </td> <td><code>true</code></td> - </tr> + </tr> <tr> <td><code>includes</code></td> <td>A list of class names that should be included in execution analysis. The list entries are separated by a colon (<code>:</code>) and may use wildcard characters (<code>*</code> and <code>?</code>). Except for performance optimization or technical corner cases this - option is normally not required. + option is normally not required. </td> <td><code>*</code> (all classes)</td> </tr> @@ -100,7 +100,9 @@ The list entries are separated by a colon (<code>:</code>) and may use wildcard characters (<code>*</code> and <code>?</code>). Except for performance optimization or technical corner cases this - option is normally not required. + option is normally not required. If you want to exclude classes from + the report please configure the respective report generation tool + accordingly. </td> <td><i>empty</i> (no excluded classes)</td> </tr> @@ -112,7 +114,7 @@ <code>?</code>). This option might be required in case of special frameworks that conflict with JaCoCo code instrumentation, in particular class loaders that do not have access to the Java runtime - classes. + classes. </td> <td><code>sun.reflect.DelegatingClassLoader</code></td> </tr> @@ -120,7 +122,7 @@ <td><code>inclbootstrapclasses</code></td> <td>Specifies whether also classes from the bootstrap classloader should be instrumented. Use this feature with caution, it needs heavy - includes/excludes tuning. + includes/excludes tuning. </td> <td><code>false</code></td> </tr> @@ -128,7 +130,7 @@ <td><code>inclnolocationclasses</code></td> <td>Specifies whether also classes without a source location should be instrumented. Normally such classes are generated at runtime e.g. by - mocking frameworks and are therefore excluded by default. + mocking frameworks and are therefore excluded by default. </td> <td><code>false</code></td> </tr> @@ -138,7 +140,7 @@ this parameter a random identifier is created by the agent. </td> <td><i>auto-generated</i></td> - </tr> + </tr> <tr> <td><code>dumponexit</code></td> <td>If set to <code>true</code> coverage data will be written on VM @@ -163,7 +165,7 @@ attribute. Execution data is written to this TCP connection.</li> <li><code>none</code>: Do not produce any output.</li> </ul> - Please see the security considerations below. + Please see the security considerations below. </td> <td><code>file</code></td> </tr> @@ -201,7 +203,7 @@ <td>If set to <code>true</code> the agent exposes <a href="./api/org/jacoco/agent/rt/IAgent.html">functionality</a> via JMX under the name <code>org.jacoco:type=Runtime</code>. Please see - the security considerations below. + the security considerations below. </td> <td><code>false</code></td> </tr> @@ -216,13 +218,13 @@ authentication mechanism. If you run JaCoCo on production systems make sure that no untrusted sources have access to the TCP server port, or JaCoCo TCP clients only connect to trusted targets. Otherwise internal information of the - application might be revealed or DOS attacks are possible. + application might be revealed or DOS attacks are possible. </p> </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/ant.html b/org.jacoco.doc/docroot/doc/ant.html index af070680..f0ddfd58 100644 --- a/org.jacoco.doc/docroot/doc/ant.html +++ b/org.jacoco.doc/docroot/doc/ant.html @@ -16,7 +16,7 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">Ant Tasks</span> </div> -<div id="content"> +<div id="content"> <h1>Ant Tasks</h1> @@ -28,16 +28,16 @@ <a href="#agent"><code>agent</code></a>, <a href="#dump"><code>dump</code></a> and <a href="#merge"><code>merge</code></a>. Reports in different formats are - created with the <a href="#report"><code>report</code></a> task. For + created with the <a href="#report"><code>report</code></a> task. For <a href="offline.html">offline instrumentation</a> the task <a href="#instrument"><code>instrument</code></a> can be used to prepare class - files. + files. </p> <p class="hint"> If you want to have line number information included in the coverage reports or you want source code highlighting the class files of the test target must - be compiled with debug information. + be compiled with debug information. </p> <h2>Example</h2> @@ -63,10 +63,10 @@ <li>Java 1.5 or higher (for both, the Ant runner and the test executor).</li> </ul> - + <p>All tasks are defined in <code>jacocoant.jar</code> (which is part of the distribution) and can be included in your Ant scripts with the usual - <code>taskdef</code> declaration: + <code>taskdef</code> declaration: </p> <pre class="source lang-xml linenums"> @@ -75,9 +75,9 @@ <taskdef uri="antlib:org.jacoco.ant" resource="org/jacoco/ant/antlib.xml"> <classpath path="<i>path_to_jacoco</i>/lib/jacocoant.jar"/> </taskdef> - + ... - + </project> </pre> @@ -102,7 +102,7 @@ The standard Ant tasks to launch Java programs are <code>java</code>, <code>junit</code> and <code>testng</code>. To add code coverage recording to these tasks they can simply be wrapped with the <code>coverage</code> task as shown in the - following examples: + following examples: </p> <pre class="source lang-xml linenums"> @@ -128,7 +128,7 @@ <p> Resulting coverage information is collected during execution and written to a file when the process terminates. Note the <code>fork</code> attribute - above in the wrapped <code>java</code> task. + above in the wrapped <code>java</code> task. </p> <p class="hint"> @@ -145,7 +145,7 @@ <p> The coverage task must wrap exactly one task. While it typically works without - any configuration, the behavior can be adjusted with some optional attributes: + any configuration, the behavior can be adjusted with some optional attributes: </p> <table class="coverage"> @@ -174,14 +174,14 @@ <code>false</code>, an existing execution data file will be replaced. </td> <td><code>true</code></td> - </tr> + </tr> <tr> <td><code>includes</code></td> <td>A list of class names that should be included in execution analysis. The list entries are separated by a colon (<code>:</code>) and may use wildcard characters (<code>*</code> and <code>?</code>). Except for performance optimization or technical corner cases this - option is normally not required. + option is normally not required. </td> <td><code>*</code> (all classes)</td> </tr> @@ -191,7 +191,8 @@ The list entries are separated by a colon (<code>:</code>) and may use wildcard characters (<code>*</code> and <code>?</code>). Except for performance optimization or technical corner cases this - option is normally not required. + option is normally not required. If you want to exclude classes from + the report please configure the <code>report</code> task accordingly. </td> <td><i>empty</i> (no excluded classes)</td> </tr> @@ -203,7 +204,7 @@ <code>?</code>). This option might be required in case of special frameworks that conflict with JaCoCo code instrumentation, in particular class loaders that do not have access to the Java runtime - classes. + classes. </td> <td><code>sun.reflect.DelegatingClassLoader</code></td> </tr> @@ -211,7 +212,7 @@ <td><code>inclbootstrapclasses</code></td> <td>Specifies whether also classes from the bootstrap classloader should be instrumented. Use this feature with caution, it needs heavy - includes/excludes tuning. + includes/excludes tuning. </td> <td><code>false</code></td> </tr> @@ -219,7 +220,7 @@ <td><code>inclnolocationclasses</code></td> <td>Specifies whether also classes without a source location should be instrumented. Normally such classes are generated at runtime e.g. by - mocking frameworks and are therefore excluded by default. + mocking frameworks and are therefore excluded by default. </td> <td><code>false</code></td> </tr> @@ -229,7 +230,7 @@ this parameter a random identifier is created by the agent. </td> <td><i>auto-generated</i></td> - </tr> + </tr> <tr> <td><code>dumponexit</code></td> <td>If set to <code>true</code> coverage data will be written on VM @@ -366,7 +367,7 @@ </p> <p> - The <code>dump</code> task has the following attributes: + The <code>dump</code> task has the following attributes: </p> <table class="coverage"> @@ -427,7 +428,7 @@ <p> This task can be used to merge the execution data from multiple test runs - into a single data store. + into a single data store. </p> <pre class="source lang-xml linenums"> @@ -438,7 +439,7 @@ <p> The task definition can contain any number of resource collection types and - has the following mandatory attribute: + has the following mandatory attribute: </p> <table class="coverage"> @@ -464,16 +465,16 @@ <p> Finally different reports can be created with the <code>report</code> task. A report task declaration consists of different sections, two specify the - input data, additional ones specify the output formats: + input data, additional ones specify the output formats: </p> <pre class="source lang-xml linenums"> <jacoco:report> - + <executiondata> <file file="jacoco.exec"/> </executiondata> - + <structure name="Example Project"> <classfiles> <fileset dir="classes"/> @@ -482,9 +483,9 @@ <fileset dir="src"/> </sourcefiles> </structure> - + <html destdir="report"/> - + </jacoco:report> </pre> @@ -557,7 +558,7 @@ accept any <a href="http://ant.apache.org/manual/Types/resources.html#collection">Ant resource collection</a>. Therefore also filtering the class file set is - possible and allows to narrow the scope of the report, for example: + possible and allows to narrow the scope of the report, for example: </p> <pre class="source lang-xml linenums"> @@ -579,7 +580,7 @@ The structure can be refined with a hierarchy of <code>group</code> elements. This way the coverage report can reflect different modules of a software project. For each group element the corresponding class and source files can - be specified separately. For example: + be specified separately. For example: </p> <pre class="source lang-xml linenums"> @@ -600,9 +601,9 @@ <fileset dir="${workspace.dir}/org.jacoco.example.client/src"/> </sourcefiles> </group> - + ... - + </structure> </pre> @@ -679,7 +680,7 @@ <h3>Element <code>xml</code></h3> <p> - Create a single-file report in XML format. + Create a single-file report in XML format. </p> <table class="coverage"> @@ -707,7 +708,7 @@ <h3>Element <code>csv</code></h3> <p> - Create single-file report in CSV format. + Create single-file report in CSV format. </p> <table class="coverage"> @@ -856,11 +857,11 @@ </tr> <tr> <td><code>minimum</code></td> - <td>Expected minimum value. If the minimum refers to a ratio the range is - from 0.0 to 1.0 where the number of decimal places will also determine - the precision in error messages. A limit ratio may optionally be - declared as a percentage where 0.80 and 80% represent the same value, - the value must end with %.</td> + <td>Expected minimum value. If the minimum refers to a ratio it must be + in the range from 0.0 to 1.0 where the number of decimal places will + also determine the precision in error messages. A limit ratio may + optionally be declared as a percentage where 0.80 and 80% represent + the same value.</td> <td><i>none</i></td> </tr> <tr> @@ -898,7 +899,7 @@ <p> The task definition can contain any number of resource collection types and - has the following mandatory attribute: + has the following mandatory attribute: </p> <table class="coverage"> @@ -917,7 +918,7 @@ </tr> <tr> <td><code>removesignatures</code></td> - <td>If set to <code>true</code> all signature related information is + <td>If set to <code>true</code> all signature related information is stripped from JARs. This is typically necessary as instrumentation breaks the signatures of the original class files.</td> <td><code>true</code></td> @@ -927,8 +928,8 @@ </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/api.html b/org.jacoco.doc/docroot/doc/api.html index 1cdec7a5..77ce8a95 100644 --- a/org.jacoco.doc/docroot/doc/api.html +++ b/org.jacoco.doc/docroot/doc/api.html @@ -14,7 +14,7 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">API Usage Examples</span> </div> -<div id="content"> +<div id="content"> <h1>API Usage Examples</h1> @@ -26,7 +26,7 @@ <p> To compile and run these example you need - <a href="http://asm.ow2.org/">ASM</a> @asm.version@ in addition to the JaCoCo + <a href="http://asm.ow2.org/">ASM</a> ${asm.version} in addition to the JaCoCo libraries. </p> @@ -42,18 +42,18 @@ <td><a class="el_source" href="examples/java/CoreTutorial.java">CoreTutorial.java</a></td> <td>This tutorial-like example instruments, executes and analyzes a single target class. Finally line coverage information is printed to the - console. + console. </td> </tr> <tr> <td><a class="el_source" href="examples/java/ClassInfo.java">ClassInfo.java</a></td> <td>This example writes JaCoCo specific information for given Java class - files. + files. </td> </tr> <tr> <td><a class="el_source" href="examples/java/ExecDump.java">ExecDump.java</a></td> - <td>Utility to dump the content of execution data files in readable form. + <td>Utility to dump the content of execution data files in readable form. </td> </tr> <tr> @@ -85,8 +85,8 @@ </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/build.html b/org.jacoco.doc/docroot/doc/build.html index 5764a3c9..5cd0aef3 100644 --- a/org.jacoco.doc/docroot/doc/build.html +++ b/org.jacoco.doc/docroot/doc/build.html @@ -6,24 +6,6 @@ <link rel="stylesheet" href="resources/doc.css" charset="UTF-8" type="text/css" /> <link rel="stylesheet" href="../coverage/jacoco-resources/prettify.css" charset="UTF-8" type="text/css" /> <link rel="shortcut icon" href="resources/report.gif" type="image/gif" /> - <style> - table, th, td { - border-collapse: collapse; - padding: 3px; - } - table tbody tr td { - border-left: #b0b0b0 3px solid; - } - table tbody tr td:nth-child(2) { - border-left: none; - } - th { - background-color:#e0e0e0; - } - table tbody td:hover { - background: #f0f0d0; - } - </style> <script type="text/javascript" src="../coverage/jacoco-resources/prettify.js"></script> <title>JaCoCo - Build</title> </head> @@ -34,7 +16,7 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">Build</span> </div> -<div id="content"> +<div id="content"> <h1>Build</h1> @@ -56,7 +38,7 @@ </p> <pre> - mvn clean install + mvn clean verify </pre> <p> @@ -77,7 +59,7 @@ </p> <pre> - mvn clean install -DskipTests + mvn clean verify -DskipTests </pre> @@ -91,48 +73,118 @@ </p> <p> - Following table shows how modules will be compiled depending on version of JDK: + Following table shows in which classfile version modules will be compiled to + depending on version of JDK (empty cells = no compilation possible): </p> -<table> +<table class="coverage"> <thead> <tr> - <th></th> - <th>JDK 5</th> - <th>JDK 6</th> - <th>JDK 7</th> - <th>JDK 8</th> - <th>JDK 9</th> - <th>JDK 10</th> - <th>JDK 11</th> - <th>JDK 12</th> + <td>Modules</td> + <td>JDK 5</td> + <td>JDK 6</td> + <td>JDK 7</td> + <td>JDK 8</td> + <td>JDK 9</td> + <td>JDK 10</td> + <td>JDK 11</td> + <td>JDK 12</td> + <td>JDK 13</td> + <td>JDK 14</td> + <td>JDK 15</td> + <td>JDK 16</td> </tr> </thead> <tbody> <tr> - <th>org.jacoco.core.test.validation.java8</th> - <td colspan="3">excluded from build</td> - <td colspan="5">compiled into bytecode version 52 (Java 8)</td> + <td>org.jacoco.core.test.validation.java14</td> + <td></td> + <td></td> + <td></td> + <td></td> + <td></td> + <td></td> + <td></td> + <td></td> + <td></td> + <td>14</td> + <td>14</td> + <td>14</td> </tr> <tr> - <th>org.jacoco.core.test.validation.java7</th> - <td colspan="2">excluded from build</td> - <td colspan="6" rowspan="2">compiled into bytecode version 51 (Java 7)</td> + <td>org.jacoco.core.test.validation.java8</td> + <td></td> + <td></td> + <td></td> + <td>8</td> + <td>8</td> + <td>8</td> + <td>8</td> + <td>8</td> + <td>8</td> + <td>8</td> + <td>8</td> + <td>8</td> </tr> <tr> - <th>org.jacoco.core.test.validation.groovy</th> - <td colspan="2">excluded from build</td> + <td>org.jacoco.core.test.validation.java7</td> + <td></td> + <td></td> + <td>7</td> + <td>7</td> + <td>7</td> + <td>7</td> + <td>7</td> + <td>7</td> + <td>7</td> + <td>7</td> + <td>7</td> + <td>7</td> </tr> <tr> - <th>org.jacoco.core.test.validation.kotlin</th> - <td colspan="1">excluded from build</td> - <td colspan="6">compiled into bytecode version 50 (Java 6)</td> - <td rowspan="2">compiled into bytecode version 51 (Java 7)</td> + <td>org.jacoco.core.test.validation.groovy</td> + <td></td> + <td></td> + <td></td> + <td>8</td> + <td>8</td> + <td>8</td> + <td>8</td> + <td>8</td> + <td>8</td> + <td>8</td> + <td>8</td> + <td>8</td> </tr> <tr> - <th>all other modules</th> - <td colspan="4">compiled into bytecode version 49 (Java 5)</td> - <td colspan="3">compiled into bytecode version 50 (Java 6)</td> + <td>org.jacoco.core.test.validation.kotlin</td> + <td></td> + <td>6</td> + <td>6</td> + <td>6</td> + <td>6</td> + <td>6</td> + <td>6</td> + <td>6</td> + <td>6</td> + <td>6</td> + <td>6</td> + <td>6</td> + </tr> + <tr> + <td>all other modules</td> + <td>5</td> + <td>5</td> + <td>5</td> + <td>5</td> + <td>6</td> + <td>6</td> + <td>6</td> + <td>7</td> + <td>7</td> + <td>7</td> + <td>7</td> + <td>7</td> </tr> </tbody> </table> @@ -148,7 +200,7 @@ </p> <pre> - mvn clean install -Djdk.version=10 -Dbytecode.version=9 + mvn clean verify -Djdk.version=10 -Dbytecode.version=9 </pre> <p> @@ -156,7 +208,7 @@ </p> <pre> - mvn clean install -Decj + mvn clean verify -Decj </pre> <p> @@ -164,22 +216,26 @@ </p> <ul> - <li><code>mvn clean install -Djdk.version=5 -Dbytecode.version=5</code></li> - <li><code>mvn clean install -Djdk.version=6 -Dbytecode.version=6</code></li> - <li><code>mvn clean install -Djdk.version=7 -Dbytecode.version=7</code></li> - <li><code>mvn clean install -Djdk.version=8 -Dbytecode.version=8</code></li> - <li><code>mvn clean install -Djdk.version=8 -Dbytecode.version=8 -Decj</code></li> - <li><code>mvn clean install -Djdk.version=9 -Dbytecode.version=9</code></li> - <li><code>mvn clean install -Djdk.version=10 -Dbytecode.version=10</code></li> - <li><code>mvn clean install -Djdk.version=11 -Dbytecode.version=11</code></li> - <li><code>mvn clean install -Djdk.version=12 -Dbytecode.version=12</code></li> + <li><code>mvn clean verify -Djdk.version=5 -Dbytecode.version=5</code></li> + <li><code>mvn clean verify -Djdk.version=6 -Dbytecode.version=6</code></li> + <li><code>mvn clean verify -Djdk.version=7 -Dbytecode.version=7</code></li> + <li><code>mvn clean verify -Djdk.version=8 -Dbytecode.version=8</code></li> + <li><code>mvn clean verify -Djdk.version=8 -Dbytecode.version=8 -Decj</code></li> + <li><code>mvn clean verify -Djdk.version=9 -Dbytecode.version=9</code></li> + <li><code>mvn clean verify -Djdk.version=10 -Dbytecode.version=10</code></li> + <li><code>mvn clean verify -Djdk.version=11 -Dbytecode.version=11</code></li> + <li><code>mvn clean verify -Djdk.version=12 -Dbytecode.version=12</code></li> + <li><code>mvn clean verify -Djdk.version=13 -Dbytecode.version=13</code></li> + <li><code>mvn clean verify -Djdk.version=14 -Dbytecode.version=14</code></li> + <li><code>mvn clean verify -Djdk.version=15 -Dbytecode.version=15</code></li> + <li><code>mvn clean verify -Djdk.version=16 -Dbytecode.version=16</code></li> </ul> </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/changes.html b/org.jacoco.doc/docroot/doc/changes.html index 1dfa98d9..730fd303 100644 --- a/org.jacoco.doc/docroot/doc/changes.html +++ b/org.jacoco.doc/docroot/doc/changes.html @@ -18,6 +18,163 @@ <h1>Change History</h1> +<h2>Release 0.8.7 (2020/05/04)</h2> + +<h3>New Features</h3> +<ul> + <li>JaCoCo now officially supports Java 15 and 16 + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1094">#1094</a>, + <a href="https://github.com/jacoco/jacoco/issues/1097">#1097</a>, + <a href="https://github.com/jacoco/jacoco/issues/1176">#1176</a>).</li> + <li>Experimental support for Java 17 class files + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1132">#1132</a>).</li> + <li>New <code>formats</code> parameter for Maven report goals to specify the + generated report formats. Contributed by troosan. + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1175">#1175</a>).</li> + <li>Branch added by the Kotlin compiler version 1.4.0 and above for "unsafe" cast + operator is filtered out during generation of report + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1143">#1143</a>, + <a href="https://github.com/jacoco/jacoco/issues/1178">#1178</a>).</li> + <li><code>synthetic</code> methods added by the Kotlin compiler version 1.5.0 and + above for <code>private</code> suspending functions are filtered out + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1174">#1174</a>).</li> + <li>Branches added by the Kotlin compiler version 1.4.20 and above for suspending + lambdas are filtered out during generation of report + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1149">#1149</a>).</li> + <li>Branches added by the Kotlin compiler version 1.5.0 and above for functions + with default arguments are filtered out during generation of report + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1162">#1162</a>).</li> + <li>Branch added by the Kotlin compiler version 1.5.0 and above for reading from + <code>lateinit</code> property is filtered out during generation of report + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1166">#1166</a>).</li> + <li>Additional bytecode generated by the Kotlin compiler version 1.5.0 and above + for <code>when</code> expressions on <code>kotlin.String</code> values + is filtered out during generation of report + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1172">#1172</a>).</li> + <li>Improved filtering of bytecode generated by Kotlin compiler versions below + 1.5.0 for <code>when</code> expressions on <code>kotlin.String</code> values + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1156">#1156</a>).</li> +</ul> + +<h3>Fixed bugs</h3> +<ul> + <li>Fixed parsing of SMAP generated by Kotlin compiler version 1.5.0 and above + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1164">#1164</a>).</li> +</ul> + +<h3>Non-functional Changes</h3> +<ul> + <li>JaCoCo now depends on ASM 9.1 + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1094">#1094</a>, + <a href="https://github.com/jacoco/jacoco/issues/1097">#1097</a>, + <a href="https://github.com/jacoco/jacoco/issues/1153">#1153</a>).</li> + <li>Maven plug-in has no dependency on <code>maven-reporting-impl</code> any more + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1121">#1121</a>).</li> +</ul> + +<h2>Release 0.8.6 (2020/09/15)</h2> + +<h3>New Features</h3> +<ul> + <li>JaCoCo now officially supports Java 14.</li> + <li>Experimental support for Java 15 class files + (GitHub <a href="https://github.com/jacoco/jacoco/issues/992">#992</a>).</li> + <li>Experimental support for Java 16 class files + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1059">#1059</a>).</li> + <li>Methods <code>toString</code>, <code>hashCode</code> and <code>equals</code> + generated by compiler for records are filtered out during generation of report + (GitHub <a href="https://github.com/jacoco/jacoco/issues/990">#990</a>).</li> + <li>Bridge methods are filtered out during generation of report + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1010">#1010</a>).</li> + <li>Methods generated by Kotlin compiler for non-overridden non-abstract methods + of interfaces are filtered out during generation of report + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1012">#1012</a>).</li> + <li>Branches added by the Kotlin compiler version 1.3.60 for suspending functions + with tail call optimization are filtered out during generation of report + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1016">#1016</a>).</li> +</ul> + +<h3>Fixed bugs</h3> +<ul> + <li>Compression method of zip entries is now preserved when instrumenting archives. + This allows to use JaCoCo with frameworks that expect uncompressed entries + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1018">#1018</a>).</li> +</ul> + +<h3>Non-functional Changes</h3> +<ul> + <li>Support for Pack200 was removed in JDK 14. JaCoCo will now throw a detailed + exception when Pack200 archives are processed with the latest JDKs + (GitHub <a href="https://github.com/jacoco/jacoco/issues/984">#984</a>).</li> + <li>JaCoCo now depends on ASM 8.0.1 + (GitHub <a href="https://github.com/jacoco/jacoco/issues/1032">#1032</a>, + <a href="https://github.com/jacoco/jacoco/issues/1043">#1043</a>).</li> +</ul> + +<h3>API Changes</h3> +<ul> + <li><code>URLStreamHandlerRuntime</code> removed + (GitHub <a href="https://github.com/jacoco/jacoco/issues/471">#471</a>).</li> +</ul> + +<h2>Release 0.8.5 (2019/10/11)</h2> + +<h3>New Features</h3> +<ul> + <li>JaCoCo now officially supports Java 13</li> + <li>Experimental support for Java 14 class files + (GitHub <a href="https://github.com/jacoco/jacoco/issues/897">#897</a>).</li> + <li>Branches added by the Kotlin compiler for <code>open</code> functions with + default arguments are filtered out during generation of report + (GitHub <a href="https://github.com/jacoco/jacoco/issues/887">#887</a>).</li> +</ul> + +<h3>Fixed bugs</h3> +<ul> + <li><code>synthetic</code> constructors that contain values of default arguments + in Kotlin should not be ignored + (GitHub <a href="https://github.com/jacoco/jacoco/issues/888">#888</a>).</li> + <li>Instrumentation should update indexes of local variables in annotations + (GitHub <a href="https://github.com/jacoco/jacoco/issues/894">#894</a>).</li> + <li>Branches added by the Kotlin compiler for functions with default arguments + and containing arguments of type <code>long</code> or <code>double</code> + should be filtered out during generation of report + (GitHub <a href="https://github.com/jacoco/jacoco/issues/908">#908</a>).</li> + <li><code>synthetic</code> methods that contain bodies of anonymous functions + in Scala should not be ignored + (GitHub <a href="https://github.com/jacoco/jacoco/issues/912">#912</a>).</li> + <li>To avoid failures with invalid class files report generation now checks + that source references are actually files + (GitHub <a href="https://github.com/jacoco/jacoco/issues/941">#941</a>).</li> + <li><code>NullPointerException</code> during filtering + (GitHub <a href="https://github.com/jacoco/jacoco/issues/942">#942</a>, + <a href="https://github.com/jacoco/jacoco/issues/944">#944</a>).</li> +</ul> + +<h3>Non-functional Changes</h3> +<ul> + <li>JaCoCo now distributed under the terms and conditions of the + Eclipse Public License Version 2.0 + (GitHub <a href="https://github.com/jacoco/jacoco/issues/943">#943</a>).</li> + <li>Prevent startup when JaCoCo runtime cannot be initialized to avoid + subsequent faults + (GitHub <a href="https://github.com/jacoco/jacoco/issues/910">#910</a>).</li> + <li>JaCoCo now depends on ASM 7.2 + (GitHub <a href="https://github.com/jacoco/jacoco/issues/947">#947</a>).</li> +</ul> + +<h3>API Changes</h3> +<ul> + <li>The coverage check API and tools (Ant, Maven) now report an error, when + a coverage ratio limit is configured outside the range [0,1] to avoid + common configuration mistakes + (GitHub <a href="https://github.com/jacoco/jacoco/issues/783">#783</a>).</li> + <li>Unsupported class file versions are now consistently reported as exceptions + by all methods of <code>Analyzer</code> and <code>Instrumenter</code> and + thus also during report generation and offline instrumentation + (GitHub <a href="https://github.com/jacoco/jacoco/issues/952">#952</a>).</li> +</ul> + <h2>Release 0.8.4 (2019/05/08)</h2> <h3>New Features</h3> @@ -222,7 +379,7 @@ <li>JaCoCo now comes with a simple command line interface (GitHub <a href="https://github.com/jacoco/jacoco/issues/525">#525</a>).</li> <li>Limit configuration of Maven <code>check</code> goal and Ant - <code>check</code> element now also supports percentage values + <code>check</code> element now also supports percentage values (GitHub <a href="https://github.com/jacoco/jacoco/issues/534">#534</a>).</li> <li>Manifests of JAR files now have <code>Automatic-Module-Name</code> for Java 9 (GitHub <a href="https://github.com/jacoco/jacoco/issues/565">#565</a>).</li> @@ -438,7 +595,7 @@ <h3>API Changes</h3> <ul> <li>In case of incompatible execution data formats read from another JaCoCo - version <code>ExecutionDataReader.read()</code> now throws a + version <code>ExecutionDataReader.read()</code> now throws a <code>IncompatibleExecDataVersionException</code>.</li> </ul> @@ -570,7 +727,7 @@ includes removal of the specific skip condition for packages e.g. POMs and instead checks existence of <tt>target/classes</tt> in appropriate goals (GitHub <a href="https://github.com/jacoco/jacoco/issues/171">#171</a>).</li> - <li>GitHub #44: (Regression) Agent Mojo should set empty property, if execution was skipped + <li>GitHub #44: (Regression) Agent Mojo should set empty property, if execution was skipped (GitHub <a href="https://github.com/jacoco/jacoco/issues/192">#192</a>).</li> </ul> @@ -896,7 +1053,7 @@ complexity (Trac #129).</li> <li>XML and CSV report includes new counter type <code>COMPLEXITY</code> (Trac #129).</li> - <li>New method <code>getTabWidth()</code> in callback interface + <li>New method <code>getTabWidth()</code> in callback interface <code>ISourceFileLocator</code> instead of <code>HTMLReportFormatter.setTabWidth()</code> which has been removed. (Trac #152).</li> @@ -991,7 +1148,7 @@ <h3>Fixed Bugs</h3> <ul> - <li>Better error message when multiple JaCoCo agents are specified + <li>Better error message when multiple JaCoCo agents are specified (Track #103).</li> <li>Fixed potential NPE at shutdown when running agent in <code>tcpserver</code> mode (Track #117).</li> @@ -1024,7 +1181,7 @@ <li>Additional and modified methods in <code>IRuntime</code> to produce session information (Trac #88).</li> <li>Coverage element type <code>SESSION</code> removed (Trac #95).</li> - <li>Removed several internal APIs from package + <li>Removed several internal APIs from package <code>org.jacoco.core.instr</code> used for class instrumentation.</li> <li>Renamed class <code>org.jacoco.report.csv.CsvFormatter</code> to <code>CSVFormatter</code> (upper case) for consistency with other @@ -1130,8 +1287,8 @@ </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/classids.html b/org.jacoco.doc/docroot/doc/classids.html index 10394eea..6086327b 100644 --- a/org.jacoco.doc/docroot/doc/classids.html +++ b/org.jacoco.doc/docroot/doc/classids.html @@ -14,7 +14,7 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">Class Ids</span> </div> -<div id="content"> +<div id="content"> <h1>Class Ids</h1> @@ -175,8 +175,8 @@ </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/conventions.html b/org.jacoco.doc/docroot/doc/conventions.html index a3e71904..e449e283 100644 --- a/org.jacoco.doc/docroot/doc/conventions.html +++ b/org.jacoco.doc/docroot/doc/conventions.html @@ -14,13 +14,13 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">Development Conventions</span> </div> -<div id="content"> +<div id="content"> <h1>Development Conventions</h1> <p> Efficient team work that produces high-quality software requires a common set - of rules. + of rules. </p> <h2>Consistent Source Tree</h2> @@ -40,7 +40,7 @@ Documentation is part of the product. Whenever you implement a new feature or change existing behavior make sure to update all corresponding JavaDoc as well as other documentation with the same change set. The product should always be - in a consistent state. For every change the following items should be checked: + in a consistent state. For every change the following items should be checked: </p> <ul> @@ -57,12 +57,12 @@ <p> The primary focus of the JaCoCo project is to provide a code coverage library. Integrators may want to embed JaCoCo in different tools and environments with - very different usage scenarios. Therefore following aspects should be considered: + very different usage scenarios. Therefore following aspects should be considered: </p> <p> <b>Documentation:</b> All APIs should be properly documented on different - levels of granularity: + levels of granularity: </p> <ul> @@ -107,7 +107,7 @@ <h2>Keep an Eye on License Issues</h2> <p> - All code included with JaCoCo must conform to the EPL license. + All code included with JaCoCo must conform to the EPL license. </p> <ul> @@ -115,7 +115,7 @@ Every committer and contributor must agree that all code will be published under EPL. He or she must be the original author and must have the permission to contribute code to JaCoCo, for example if such a permission - is required by the employer. + is required by the employer. </li> <li> Every third party content must be enlisted in the corresponding @@ -131,7 +131,7 @@ <a href="http://www.eclipse.org/legal/copyrightandlicensenotice.php">EPL license notice</a>. The initial contributor should be listed. In case of significant changes or additions additional contributors should also - be listed. + be listed. </li> </ul> @@ -172,8 +172,8 @@ </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/counters.html b/org.jacoco.doc/docroot/doc/counters.html index 8e2e219e..cc77cd71 100644 --- a/org.jacoco.doc/docroot/doc/counters.html +++ b/org.jacoco.doc/docroot/doc/counters.html @@ -14,14 +14,14 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">Coverage Counters</span> </div> -<div id="content"> +<div id="content"> <h1>Coverage Counters</h1> <p> JaCoCo uses a set of different counters to calculate coverage metrics. All these counters are derived from information contained in Java class files - which basically are Java byte code instructions and debug information + which basically are Java byte code instructions and debug information optionally embedded in class files. This approach allows efficient on-the-fly instrumentation and analysis of applications even when no source code is available. In most cases the collected information can be mapped back to @@ -30,7 +30,7 @@ information to calculate line level coverage and provide source highlighting. Not all Java language constructs can be directly compiled to corresponding byte code. In such cases the Java compiler creates so called <i>synthetic</i> - code which sometimes results in unexpected code coverage results. + code which sometimes results in unexpected code coverage results. </p> <h2>Instructions (C0 Coverage)</h2> @@ -82,7 +82,7 @@ <p> The formal definition of the cyclomatic complexity v(G) is based on the - representation of a method's control flow graph as a directed graph: + representation of a method's control flow graph as a directed graph: </p> <blockquote> @@ -123,7 +123,7 @@ <p> Due to the fact that a single line typically compiles to multiple byte code instructions the source code highlighting shows three different status for - each line containing source code: + each line containing source code: </p> <ul> @@ -164,10 +164,10 @@ initializers such interfaces are also considered as executable classes. </p> -</div> +</div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/empty.html b/org.jacoco.doc/docroot/doc/empty.html index ad73399e..fbad8caf 100644 --- a/org.jacoco.doc/docroot/doc/empty.html +++ b/org.jacoco.doc/docroot/doc/empty.html @@ -13,7 +13,7 @@ <a href="../index.html" class="el_report">JaCoCo</a> > <span class="el_source">Title</span> </div> -<div id="content"> +<div id="content"> <h1>Title</h1> @@ -23,8 +23,8 @@ </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/environment.html b/org.jacoco.doc/docroot/doc/environment.html index 77c06a0c..d0788d72 100644 --- a/org.jacoco.doc/docroot/doc/environment.html +++ b/org.jacoco.doc/docroot/doc/environment.html @@ -14,7 +14,7 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">Development Environment</span> </div> -<div id="content"> +<div id="content"> <h1>Development Environment</h1> @@ -48,7 +48,7 @@ Eclipse projects that can be imported in a Eclipse workspace. </p> -<p> +<p> Project specific Eclipse settings only exist for the following projects. All other projects and test projects link to these settings: </p> @@ -68,7 +68,7 @@ <p> The minimum supported JRE version for JaCoCo is Java 5. To guarantee compatibility JaCoCo release builds should always be executed using JDK 5. - In addition we run builds with 6, 7, 8, 9, 10, 11 and 12 JDKs. + In addition we run builds with 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 and 16 JDKs. </p> <h3>Build</h3> @@ -86,7 +86,7 @@ </p> <ul> - <li><a href="https://travis-ci.org/jacoco/jacoco/">Travis CI</a></li> + <li><a href="https://dev.azure.com/JaCoCo-org/JaCoCo/_build">Azure Pipelines</a></li> <li><a href="https://ci.appveyor.com/project/JaCoCo/jacoco">AppVeyor</a></li> </ul> @@ -131,8 +131,8 @@ </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/epl-2.0.html b/org.jacoco.doc/docroot/doc/epl-2.0.html new file mode 100644 index 00000000..d4715f24 --- /dev/null +++ b/org.jacoco.doc/docroot/doc/epl-2.0.html @@ -0,0 +1,295 @@ +<?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="en"> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + <link rel="stylesheet" href="resources/doc.css" charset="UTF-8" type="text/css" /> + <link rel="shortcut icon" href="resources/report.gif" type="image/gif" /> + <title>JaCoCo - Eclipse Public License - Version 2.0</title> +<style type="text/css"> + p.list { + margin-left: 0.5in; + margin-top: 0.05em; + margin-bottom: 0.05em; + } +</style> +</head> +<body> + +<div class="breadcrumb"> + <a href="../index.html" class="el_report">JaCoCo</a> > + <span class="el_source">Eclipse Public License - Version 2.0</span> +</div> +<div id="content"> + +<h1>Eclipse Public License - v 2.0</h1> + +<pre> + THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE + PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION + OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT. + +1. DEFINITIONS + +"Contribution" means: + + a) in the case of the initial Contributor, the initial content + Distributed under this Agreement, and + + b) in the case of each subsequent Contributor: + i) changes to the Program, and + ii) additions to the Program; + where such changes and/or additions to the Program originate from + and are Distributed by that particular Contributor. A Contribution + "originates" from a Contributor if it was added to the Program by + such Contributor itself or anyone acting on such Contributor's behalf. + Contributions do not include changes or additions to the Program that + are not Modified Works. + +"Contributor" means any person or entity that Distributes the Program. + +"Licensed Patents" mean patent claims licensable by a Contributor which +are necessarily infringed by the use or sale of its Contribution alone +or when combined with the Program. + +"Program" means the Contributions Distributed in accordance with this +Agreement. + +"Recipient" means anyone who receives the Program under this Agreement +or any Secondary License (as applicable), including Contributors. + +"Derivative Works" shall mean any work, whether in Source Code or other +form, that is based on (or derived from) the Program and for which the +editorial revisions, annotations, elaborations, or other modifications +represent, as a whole, an original work of authorship. + +"Modified Works" shall mean any work in Source Code or other form that +results from an addition to, deletion from, or modification of the +contents of the Program, including, for purposes of clarity any new file +in Source Code form that contains any contents of the Program. Modified +Works shall not include works that contain only declarations, +interfaces, types, classes, structures, or files of the Program solely +in each case in order to link to, bind by name, or subclass the Program +or Modified Works thereof. + +"Distribute" means the acts of a) distributing or b) making available +in any manner that enables the transfer of a copy. + +"Source Code" means the form of a Program preferred for making +modifications, including but not limited to software source code, +documentation source, and configuration files. + +"Secondary License" means either the GNU General Public License, +Version 2.0, or any later versions of that license, including any +exceptions or additional permissions as identified by the initial +Contributor. + +2. GRANT OF RIGHTS + + a) Subject to the terms of this Agreement, each Contributor hereby + grants Recipient a non-exclusive, worldwide, royalty-free copyright + license to reproduce, prepare Derivative Works of, publicly display, + publicly perform, Distribute and sublicense the Contribution of such + Contributor, if any, and such Derivative Works. + + b) Subject to the terms of this Agreement, each Contributor hereby + grants Recipient a non-exclusive, worldwide, royalty-free patent + license under Licensed Patents to make, use, sell, offer to sell, + import and otherwise transfer the Contribution of such Contributor, + if any, in Source Code or other form. This patent license shall + apply to the combination of the Contribution and the Program if, at + the time the Contribution is added by the Contributor, such addition + of the Contribution causes such combination to be covered by the + Licensed Patents. The patent license shall not apply to any other + combinations which include the Contribution. No hardware per se is + licensed hereunder. + + c) Recipient understands that although each Contributor grants the + licenses to its Contributions set forth herein, no assurances are + provided by any Contributor that the Program does not infringe the + patent or other intellectual property rights of any other entity. + Each Contributor disclaims any liability to Recipient for claims + brought by any other entity based on infringement of intellectual + property rights or otherwise. As a condition to exercising the + rights and licenses granted hereunder, each Recipient hereby + assumes sole responsibility to secure any other intellectual + property rights needed, if any. For example, if a third party + patent license is required to allow Recipient to Distribute the + Program, it is Recipient's responsibility to acquire that license + before distributing the Program. + + d) Each Contributor represents that to its knowledge it has + sufficient copyright rights in its Contribution, if any, to grant + the copyright license set forth in this Agreement. + + e) Notwithstanding the terms of any Secondary License, no + Contributor makes additional grants to any Recipient (other than + those set forth in this Agreement) as a result of such Recipient's + receipt of the Program under the terms of a Secondary License + (if permitted under the terms of Section 3). + +3. REQUIREMENTS + +3.1 If a Contributor Distributes the Program in any form, then: + + a) the Program must also be made available as Source Code, in + accordance with section 3.2, and the Contributor must accompany + the Program with a statement that the Source Code for the Program + is available under this Agreement, and informs Recipients how to + obtain it in a reasonable manner on or through a medium customarily + used for software exchange; and + + b) the Contributor may Distribute the Program under a license + different than this Agreement, provided that such license: + i) effectively disclaims on behalf of all other Contributors all + warranties and conditions, express and implied, including + warranties or conditions of title and non-infringement, and + implied warranties or conditions of merchantability and fitness + for a particular purpose; + + ii) effectively excludes on behalf of all other Contributors all + liability for damages, including direct, indirect, special, + incidental and consequential damages, such as lost profits; + + iii) does not attempt to limit or alter the recipients' rights + in the Source Code under section 3.2; and + + iv) requires any subsequent distribution of the Program by any + party to be under a license that satisfies the requirements + of this section 3. + +3.2 When the Program is Distributed as Source Code: + + a) it must be made available under this Agreement, or if the + Program (i) is combined with other material in a separate file or + files made available under a Secondary License, and (ii) the initial + Contributor attached to the Source Code the notice described in + Exhibit A of this Agreement, then the Program may be made available + under the terms of such Secondary Licenses, and + + b) a copy of this Agreement must be included with each copy of + the Program. + +3.3 Contributors may not remove or alter any copyright, patent, +trademark, attribution notices, disclaimers of warranty, or limitations +of liability ("notices") contained within the Program from any copy of +the Program which they Distribute, provided that Contributors may add +their own appropriate notices. + +4. COMMERCIAL DISTRIBUTION + +Commercial distributors of software may accept certain responsibilities +with respect to end users, business partners and the like. While this +license is intended to facilitate the commercial use of the Program, +the Contributor who includes the Program in a commercial product +offering should do so in a manner which does not create potential +liability for other Contributors. Therefore, if a Contributor includes +the Program in a commercial product offering, such Contributor +("Commercial Contributor") hereby agrees to defend and indemnify every +other Contributor ("Indemnified Contributor") against any losses, +damages and costs (collectively "Losses") arising from claims, lawsuits +and other legal actions brought by a third party against the Indemnified +Contributor to the extent caused by the acts or omissions of such +Commercial Contributor in connection with its distribution of the Program +in a commercial product offering. The obligations in this section do not +apply to any claims or Losses relating to any actual or alleged +intellectual property infringement. In order to qualify, an Indemnified +Contributor must: a) promptly notify the Commercial Contributor in +writing of such claim, and b) allow the Commercial Contributor to control, +and cooperate with the Commercial Contributor in, the defense and any +related settlement negotiations. The Indemnified Contributor may +participate in any such claim at its own expense. + +For example, a Contributor might include the Program in a commercial +product offering, Product X. That Contributor is then a Commercial +Contributor. If that Commercial Contributor then makes performance +claims, or offers warranties related to Product X, those performance +claims and warranties are such Commercial Contributor's responsibility +alone. Under this section, the Commercial Contributor would have to +defend claims against the other Contributors related to those performance +claims and warranties, and if a court requires any other Contributor to +pay any damages as a result, the Commercial Contributor must pay +those damages. + +5. NO WARRANTY + +EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT +PERMITTED BY APPLICABLE LAW, THE PROGRAM IS PROVIDED ON AN "AS IS" +BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR +IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF +TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR +PURPOSE. Each Recipient is solely responsible for determining the +appropriateness of using and distributing the Program and assumes all +risks associated with its exercise of rights under this Agreement, +including but not limited to the risks and costs of program errors, +compliance with applicable laws, damage to or loss of data, programs +or equipment, and unavailability or interruption of operations. + +6. DISCLAIMER OF LIABILITY + +EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT +PERMITTED BY APPLICABLE LAW, NEITHER RECIPIENT NOR ANY CONTRIBUTORS +SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, +EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST +PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE +EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + +7. GENERAL + +If any provision of this Agreement is invalid or unenforceable under +applicable law, it shall not affect the validity or enforceability of +the remainder of the terms of this Agreement, and without further +action by the parties hereto, such provision shall be reformed to the +minimum extent necessary to make such provision valid and enforceable. + +If Recipient institutes patent litigation against any entity +(including a cross-claim or counterclaim in a lawsuit) alleging that the +Program itself (excluding combinations of the Program with other software +or hardware) infringes such Recipient's patent(s), then such Recipient's +rights granted under Section 2(b) shall terminate as of the date such +litigation is filed. + +All Recipient's rights under this Agreement shall terminate if it +fails to comply with any of the material terms or conditions of this +Agreement and does not cure such failure in a reasonable period of +time after becoming aware of such noncompliance. If all Recipient's +rights under this Agreement terminate, Recipient agrees to cease use +and distribution of the Program as soon as reasonably practicable. +However, Recipient's obligations under this Agreement and any licenses +granted by Recipient relating to the Program shall continue and survive. + +Everyone is permitted to copy and distribute copies of this Agreement, +but in order to avoid inconsistency the Agreement is copyrighted and +may only be modified in the following manner. The Agreement Steward +reserves the right to publish new versions (including revisions) of +this Agreement from time to time. No one other than the Agreement +Steward has the right to modify this Agreement. The Eclipse Foundation +is the initial Agreement Steward. The Eclipse Foundation may assign the +responsibility to serve as the Agreement Steward to a suitable separate +entity. Each new version of the Agreement will be given a distinguishing +version number. The Program (including Contributions) may always be +Distributed subject to the version of the Agreement under which it was +received. In addition, after a new version of the Agreement is published, +Contributor may elect to Distribute the Program (including its +Contributions) under the new version. + +Except as expressly stated in Sections 2(a) and 2(b) above, Recipient +receives no rights or licenses to the intellectual property of any +Contributor under this Agreement, whether expressly, by implication, +estoppel or otherwise. All rights in the Program not expressly granted +under this Agreement are reserved. Nothing in this Agreement is intended +to be enforceable by any entity that is not a Contributor or Recipient. +No third-party beneficiary rights are created under this Agreement. +</pre> + +</div> +<div class="footer"> + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors +</div> + +</body> +</html> diff --git a/org.jacoco.doc/docroot/doc/epl-v10.html b/org.jacoco.doc/docroot/doc/epl-v10.html deleted file mode 100644 index c6a49b53..00000000 --- a/org.jacoco.doc/docroot/doc/epl-v10.html +++ /dev/null @@ -1,262 +0,0 @@ -<?xml version="1.0" encoding="UTF-8" ?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" lang="en"> -<head> - <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <link rel="stylesheet" href="resources/doc.css" charset="UTF-8" type="text/css" /> - <link rel="shortcut icon" href="resources/report.gif" type="image/gif" /> - <title>JaCoCo - Eclipse Public License - Version 1.0</title> -<style type="text/css"> - p.list { - margin-left: 0.5in; - margin-top: 0.05em; - margin-bottom: 0.05em; - } -</style> -</head> -<body> - -<div class="breadcrumb"> - <a href="../index.html" class="el_report">JaCoCo</a> > - <span class="el_source">Eclipse Public License - Version 1.0</span> -</div> -<div id="content"> - -<h1>Eclipse Public License - v 1.0</h1> - -<p>THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE -PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR -DISTRIBUTION OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS -AGREEMENT.</p> - -<h3>1. DEFINITIONS</h3> - -<p>"Contribution" means:</p> - -<p class="list">a) in the case of the initial Contributor, the initial -code and documentation distributed under this Agreement, and</p> -<p class="list">b) in the case of each subsequent Contributor:</p> - -<p class="list">i) changes to the Program, and</p> -<p class="list">ii) additions to the Program;</p> -<p class="list">where such changes and/or additions to the Program -originate from and are distributed by that particular Contributor. A -Contribution 'originates' from a Contributor if it was added to the -Program by such Contributor itself or anyone acting on such -Contributor's behalf. Contributions do not include additions to the -Program which: (i) are separate modules of software distributed in -conjunction with the Program under their own license agreement, and (ii) -are not derivative works of the Program.</p> - -<p>"Contributor" means any person or entity that distributes -the Program.</p> - -<p>"Licensed Patents" mean patent claims licensable by a -Contributor which are necessarily infringed by the use or sale of its -Contribution alone or when combined with the Program.</p> - -<p>"Program" means the Contributions distributed in accordance -with this Agreement.</p> - -<p>"Recipient" means anyone who receives the Program under -this Agreement, including all Contributors.</p> - -<h3>2. GRANT OF RIGHTS</h3> - -<p class="list">a) Subject to the terms of this Agreement, each -Contributor hereby grants Recipient a non-exclusive, worldwide, -royalty-free copyright license to reproduce, prepare derivative works -of, publicly display, publicly perform, distribute and sublicense the -Contribution of such Contributor, if any, and such derivative works, in -source code and object code form.</p> - -<p class="list">b) Subject to the terms of this Agreement, each -Contributor hereby grants Recipient a non-exclusive, worldwide, -royalty-free patent license under Licensed Patents to make, use, sell, -offer to sell, import and otherwise transfer the Contribution of such -Contributor, if any, in source code and object code form. This patent -license shall apply to the combination of the Contribution and the -Program if, at the time the Contribution is added by the Contributor, -such addition of the Contribution causes such combination to be covered -by the Licensed Patents. The patent license shall not apply to any other -combinations which include the Contribution. No hardware per se is -licensed hereunder.</p> - -<p class="list">c) Recipient understands that although each Contributor -grants the licenses to its Contributions set forth herein, no assurances -are provided by any Contributor that the Program does not infringe the -patent or other intellectual property rights of any other entity. Each -Contributor disclaims any liability to Recipient for claims brought by -any other entity based on infringement of intellectual property rights -or otherwise. As a condition to exercising the rights and licenses -granted hereunder, each Recipient hereby assumes sole responsibility to -secure any other intellectual property rights needed, if any. For -example, if a third party patent license is required to allow Recipient -to distribute the Program, it is Recipient's responsibility to acquire -that license before distributing the Program.</p> - -<p class="list">d) Each Contributor represents that to its knowledge it -has sufficient copyright rights in its Contribution, if any, to grant -the copyright license set forth in this Agreement.</p> - -<h3>3. REQUIREMENTS</h3> - -<p>A Contributor may choose to distribute the Program in object code -form under its own license agreement, provided that:</p> - -<p class="list">a) it complies with the terms and conditions of this -Agreement; and</p> - -<p class="list">b) its license agreement:</p> - -<p class="list">i) effectively disclaims on behalf of all Contributors -all warranties and conditions, express and implied, including warranties -or conditions of title and non-infringement, and implied warranties or -conditions of merchantability and fitness for a particular purpose;</p> - -<p class="list">ii) effectively excludes on behalf of all Contributors -all liability for damages, including direct, indirect, special, -incidental and consequential damages, such as lost profits;</p> - -<p class="list">iii) states that any provisions which differ from this -Agreement are offered by that Contributor alone and not by any other -party; and</p> - -<p class="list">iv) states that source code for the Program is available -from such Contributor, and informs licensees how to obtain it in a -reasonable manner on or through a medium customarily used for software -exchange.</p> - -<p>When the Program is made available in source code form:</p> - -<p class="list">a) it must be made available under this Agreement; and</p> - -<p class="list">b) a copy of this Agreement must be included with each -copy of the Program.</p> - -<p>Contributors may not remove or alter any copyright notices contained -within the Program.</p> - -<p>Each Contributor must identify itself as the originator of its -Contribution, if any, in a manner that reasonably allows subsequent -Recipients to identify the originator of the Contribution.</p> - -<h3>4. COMMERCIAL DISTRIBUTION</h3> - -<p>Commercial distributors of software may accept certain -responsibilities with respect to end users, business partners and the -like. While this license is intended to facilitate the commercial use of -the Program, the Contributor who includes the Program in a commercial -product offering should do so in a manner which does not create -potential liability for other Contributors. Therefore, if a Contributor -includes the Program in a commercial product offering, such Contributor -("Commercial Contributor") hereby agrees to defend and -indemnify every other Contributor ("Indemnified Contributor") -against any losses, damages and costs (collectively "Losses") -arising from claims, lawsuits and other legal actions brought by a third -party against the Indemnified Contributor to the extent caused by the -acts or omissions of such Commercial Contributor in connection with its -distribution of the Program in a commercial product offering. The -obligations in this section do not apply to any claims or Losses -relating to any actual or alleged intellectual property infringement. In -order to qualify, an Indemnified Contributor must: a) promptly notify -the Commercial Contributor in writing of such claim, and b) allow the -Commercial Contributor to control, and cooperate with the Commercial -Contributor in, the defense and any related settlement negotiations. The -Indemnified Contributor may participate in any such claim at its own -expense.</p> - -<p>For example, a Contributor might include the Program in a commercial -product offering, Product X. That Contributor is then a Commercial -Contributor. If that Commercial Contributor then makes performance -claims, or offers warranties related to Product X, those performance -claims and warranties are such Commercial Contributor's responsibility -alone. Under this section, the Commercial Contributor would have to -defend claims against the other Contributors related to those -performance claims and warranties, and if a court requires any other -Contributor to pay any damages as a result, the Commercial Contributor -must pay those damages.</p> - -<h3>5. NO WARRANTY</h3> - -<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS -PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS -OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, -ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY -OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is solely -responsible for determining the appropriateness of using and -distributing the Program and assumes all risks associated with its -exercise of rights under this Agreement , including but not limited to -the risks and costs of program errors, compliance with applicable laws, -damage to or loss of data, programs or equipment, and unavailability or -interruption of operations.</p> - -<h3>6. DISCLAIMER OF LIABILITY</h3> - -<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT -NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, -INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING -WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF -LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING -NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR -DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED -HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.</p> - -<h3>7. GENERAL</h3> - -<p>If any provision of this Agreement is invalid or unenforceable under -applicable law, it shall not affect the validity or enforceability of -the remainder of the terms of this Agreement, and without further action -by the parties hereto, such provision shall be reformed to the minimum -extent necessary to make such provision valid and enforceable.</p> - -<p>If Recipient institutes patent litigation against any entity -(including a cross-claim or counterclaim in a lawsuit) alleging that the -Program itself (excluding combinations of the Program with other -software or hardware) infringes such Recipient's patent(s), then such -Recipient's rights granted under Section 2(b) shall terminate as of the -date such litigation is filed.</p> - -<p>All Recipient's rights under this Agreement shall terminate if it -fails to comply with any of the material terms or conditions of this -Agreement and does not cure such failure in a reasonable period of time -after becoming aware of such noncompliance. If all Recipient's rights -under this Agreement terminate, Recipient agrees to cease use and -distribution of the Program as soon as reasonably practicable. However, -Recipient's obligations under this Agreement and any licenses granted by -Recipient relating to the Program shall continue and survive.</p> - -<p>Everyone is permitted to copy and distribute copies of this -Agreement, but in order to avoid inconsistency the Agreement is -copyrighted and may only be modified in the following manner. The -Agreement Steward reserves the right to publish new versions (including -revisions) of this Agreement from time to time. No one other than the -Agreement Steward has the right to modify this Agreement. The Eclipse -Foundation is the initial Agreement Steward. The Eclipse Foundation may -assign the responsibility to serve as the Agreement Steward to a -suitable separate entity. Each new version of the Agreement will be -given a distinguishing version number. The Program (including -Contributions) may always be distributed subject to the version of the -Agreement under which it was received. In addition, after a new version -of the Agreement is published, Contributor may elect to distribute the -Program (including its Contributions) under the new version. Except as -expressly stated in Sections 2(a) and 2(b) above, Recipient receives no -rights or licenses to the intellectual property of any Contributor under -this Agreement, whether expressly, by implication, estoppel or -otherwise. All rights in the Program not expressly granted under this -Agreement are reserved.</p> - -<p>This Agreement is governed by the laws of the State of New York and -the intellectual property laws of the United States of America. No party -to this Agreement will bring a legal action under this Agreement more -than one year after the cause of action arose. Each party waives its -rights to a jury trial in any resulting litigation.</p> - -</div> -<div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors -</div> - -</body> -</html> diff --git a/org.jacoco.doc/docroot/doc/faq.html b/org.jacoco.doc/docroot/doc/faq.html index 2e48734e..b24177d7 100644 --- a/org.jacoco.doc/docroot/doc/faq.html +++ b/org.jacoco.doc/docroot/doc/faq.html @@ -14,7 +14,7 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">FAQ</span> </div> -<div id="content"> +<div id="content"> <h1>FAQ</h1> @@ -29,10 +29,10 @@ guarantee free capacity, we do not commit to particular release dates. Typically, you can expect a couple of releases every year. </p> -<p> +<p> In the <a href="changes.html">change log</a>, you can see all features - that have been been implemented in master branch and will be available - with the next release. And in the meantime you can test latest build of + that have been implemented in master branch and will be available + with the next release. And in the meantime you can test latest build of master branch (<a href="repo.html">Maven SNAPSHOT</a>) and provide <a href="support.html">feedback</a> to us. </p> @@ -45,7 +45,7 @@ <h3>What Java versions are supported by JaCoCo?</h3> <p> - JaCoCo supports Java class files from version 1.0 to 12. However the minimum + JaCoCo supports Java class files from version 1.0 to 16. However the minimum JRE version required by the JaCoCo runtime (e.g. the agent) and the JaCoCo tools is 1.5. Also note that class files under test from version 1.6 and above have to contain valid stackmap frames. @@ -166,7 +166,7 @@ If you use <a href="offline.html">offline instrumentation</a> the instrumented classes get a direct dependency on the JaCoCo runtime. Therefore <code>jacocoagent.jar</code> of the same JaCoCo version must be on the - classpath and accessible from by the instrumented classes. + classpath and accessible from by the instrumented classes. </p> <h3>Why do I get a <code>StackOverflowError</code> during code coverage analysis?</h3> @@ -184,10 +184,31 @@ the <code>-Xss</code> JVM option.</li> </ul> +<h3>Why do I see classes in the coverage report although I excluded them in the JaCoCo agent configuration?</h3> +<p> + The <code>includes</code> and <code>excludes</code> options of the + <a href="agent.html">JaCoCo agent</a> determine for which classes execution + data is collected. Except for technical corner cases these options are + normally not required. If you exclude classes, no execution data is collected + for them. +</p> +<p> + Report creation is a separate step where all class files which should show up + in the report are explicitly provided. Coverage is determined from the + provided execution data. If execution data is missing for a particular class, + this class is shown as not covered because the report generator cannot + distinguish whether the class was excluded from instrumentation or not executed. +</p> + +<p> + If you want to exclude classes from the report please configure the + respective report generation tool accordingly. +</p> + </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/flow.html b/org.jacoco.doc/docroot/doc/flow.html index b73c070a..59bbd6f7 100644 --- a/org.jacoco.doc/docroot/doc/flow.html +++ b/org.jacoco.doc/docroot/doc/flow.html @@ -16,7 +16,7 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">Control Flow Analysis</span> </div> -<div id="content"> +<div id="content"> <h1>Control Flow Analysis for Java Methods</h1> @@ -31,7 +31,7 @@ <h2>Control Flow Graphs for Java Bytecode</h2> -<p> +<p> As an starting point we take the following example method that contains a single branching point: </p> @@ -55,7 +55,7 @@ public static void example() { <code>IFEQ</code> or the unconditional <code>GOTO</code> opcode. The jump targets are technically relative offsets to the target instruction. For better readability we use symbolic labels (<code>L1</code>, <code>L2</code>) instead - (also the ASM API uses such symbolic labels): + (also the ASM API uses such symbolic labels): </p> <pre class="source linenums"> @@ -87,7 +87,7 @@ public static example()V the following Edges. Each edge connects a source instruction with a target instruction. In some cases the source instruction or the target instruction does not exist (virtual edges for method entry and exit) or cannot be - exactly specified (exception handlers). + exactly specified (exception handlers). </p> <table class="coverage"> @@ -108,7 +108,7 @@ public static example()V </tr> <tr> <td>SEQUENCE</td> - <td>Instruction, except <code>GOTO</code>, <code>xRETURN</code>, + <td>Instruction, except <code>GOTO</code>, <code>xRETURN</code>, <code>THROW</code>, <code>TABLESWITCH</code> and <code>LOOKUPSWITCH</code></td> <td>Subsequent instruction</td> <td></td> @@ -167,7 +167,7 @@ public static example()V <p> If a probe has been executed we know that the corresponding edge has been - visited. From this edge we can conclude to other preceding nodes and edges: + visited. From this edge we can conclude to other preceding nodes and edges: </p> <ul> @@ -180,7 +180,7 @@ public static example()V <p> Recursively applying these rules allows to determine the execution status of all instructions of a method – given that we have probes at the right - positions. Therefore JaCoCo inserts probes + positions. Therefore JaCoCo inserts probes </p> <ul> @@ -212,7 +212,7 @@ public static example()V <td><img src="resources/flow-sequence-probe.png" alt="Sequence with Probe"/></td> <td> In case of a simple sequence the probe is simply inserted between the - two instructions. + two instructions. </td> </tr> <tr> @@ -335,9 +335,9 @@ BASTORE </pre> <p> - Note that this probe code is thread safe, does not modify the operand stack - or modify local variables and is also thread safe. It does also not leave the - method though an external call. The only prerequisite is that the probe array + Note that this probe code is thread safe and does not modify the operand stack + or modify local variables. It does also not leave the + method through an external call. The only prerequisite is that the probe array is available as a local variable. For this at the beginning of each method additional instrumentation code needs to be added to obtain the array instance associated with the belonging class. To avoid code duplication the @@ -349,7 +349,7 @@ BASTORE The size of the probe code above depends on the position of the probe array variable and the value of the probe identifier as different opcodes can be used. As calculated in the table below the overhead per probe ranges between 4 - and 7 bytes of additional bytecode: + and 7 bytes of additional bytecode: </p> <table class="coverage"> @@ -409,7 +409,7 @@ BASTORE total classes instrumented with JaCoCo increase their size by about 30%. Due to the fact that probe execution does not require any method calls, only local instructions, the observed execution time overhead for instrumented - applications typically is less than 10%. + applications typically is less than 10%. </p> <h2>References</h2> @@ -422,8 +422,8 @@ BASTORE </div> <div class="footer"> - <div class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</div> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <div class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</div> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/implementation.html b/org.jacoco.doc/docroot/doc/implementation.html index 668b7dd4..fda79e6f 100644 --- a/org.jacoco.doc/docroot/doc/implementation.html +++ b/org.jacoco.doc/docroot/doc/implementation.html @@ -16,7 +16,7 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">Implementation Design</span> </div> -<div id="content"> +<div id="content"> <h1>Implementation Design</h1> @@ -38,7 +38,7 @@ Coverage information has to be collected at runtime. For this purpose JaCoCo creates instrumented versions of the original class definitions. The instrumentation process happens on-the-fly during class loading using so - called Java agents. + called Java agents. </p> <p> @@ -71,12 +71,12 @@ The Java agent is loaded by the application class loader. Therefore the classes of the agent live in the same name space like the application classes which can result in clashes especially with the third party library ASM. The - JoCoCo build therefore moves all agent classes into a unique package. + JoCoCo build therefore moves all agent classes into a unique package. </p> <p> The JaCoCo build renames all classes contained in the - <code>jacocoagent.jar</code> into classes with a + <code>jacocoagent.jar</code> into classes with a <code>org.jacoco.agent.rt_<randomid></code> prefix, including the required ASM library classes. The identifier is created from a random number. As the agent does not provide any API, no one should be affected by this @@ -131,7 +131,7 @@ the presented figures are extracted from a valid test target. A hash code of the class definitions allows to differentiate between classes and versions of classes. The CRC64 hash computation is simple and fast resulting in a small 64 - bit identifier. + bit identifier. </p> <p> @@ -144,7 +144,7 @@ results. The CRC64 code might produce so called <i>collisions</i>, i.e. creating the same hash code for two different classes. Although CRC64 is not cryptographically strong and collision examples can be easily computed, for - regular class files the collision probability is very low. + regular class files the collision probability is very low. </p> <h2>Coverage Runtime Dependency</h2> @@ -152,19 +152,19 @@ <p class="intro"> Instrumented code typically gets a dependency to a coverage runtime which is responsible for collecting and storing execution data. JaCoCo uses JRE types - only in generated instrumentation code. + only in generated instrumentation code. </p> <p> Making a runtime library available to all instrumented classes can be a painful or impossible task in frameworks that use their own class loading mechanisms. Since Java 1.6 <code>java.lang.instrument.Instrumentation</code> - has an API to extends the bootsstrap loader. As our minimum target is Java 1.5 + has an API to extends the bootsstrap loader. As our minimum target is Java 1.5 JaCoCo decouples the instrumented classes and the coverage runtime through official JRE API types only. The instrumented classes communicate through the <code>Object.equals(Object)</code> method with the runtime. A instrumented class can retrieve its probe array instance with the following code. Note - that only JRE APIs are used: + that only JRE APIs are used: </p> @@ -172,7 +172,7 @@ Object access = ... // Retrieve instance Object[] args = new Object[3]; -args[0] = Long.valueOf(8060044182221863588); // class id +args[0] = Long.valueOf(8060044182221863588); // class id args[1] = "com/example/MyClass"; // class name args[2] = Integer.valueOf(24); // probe count @@ -199,17 +199,11 @@ boolean[] probes = (boolean[]) args[0]; parameter array instead of a <code>equals()</code> method. The coverage runtime registers a custom <code>Handler</code> to receive the parameter array. This approach might break environments that install their own log - managers (e.g. Glassfish).</li> - <li><b><code>URLStreamHandlerRuntime</code></b>: This runtime registers a - <code>URLStreamHandler</code> for a "jacoco-xxxxx" protocol. Instrumented - classes open a connection on this protocol. The returned connection object - is the one that provides access to the coverage runtime through its - <code>equals()</code> method. However to register the protocol the runtime - needs to access internal members of the <code>java.net.URL</code> class.</li> + managers (e.g. Glassfish).</li> <li><b><code>ModifiedSystemClassRuntime</code></b>: This approach adds a public static field to an existing JRE class through instrumentation. Unlike the other methods above this is only possible for environments where a Java - agent is active.</li> + agent is active.</li> <li><b><code>InjectedClassRuntime</code></b>: This approach defines a new class using <code>java.lang.invoke.MethodHandles.Lookup.defineClass</code> introduced in Java 9.</li> @@ -233,14 +227,14 @@ boolean[] probes = (boolean[]) args[0]; Coverage analysis for huge projects with several thousand classes or hundred thousand lines of code should be possible. To allow this with reasonable memory usage the coverage analysis is based on streaming patterns and - "depth first" traversals. + "depth first" traversals. </p> <p> The complete data tree of a huge coverage report is too big to fit into a reasonable heap memory configuration. Therefore the coverage analysis and report generation is implemented as "depth first" traversals. Which means that - at any point in time only the following data has to be held in working memory: + at any point in time only the following data has to be held in working memory: </p> <ul> @@ -252,7 +246,7 @@ boolean[] probes = (boolean[]) args[0]; <p class="intro"> The Java language and the Java VM use different String representation formats - for Java elements. For example while a type reference in Java reads like + for Java elements. For example while a type reference in Java reads like <code>java.lang.Object</code>, the VM references the same type as <code>Ljava/lang/Object;</code>. The JaCoCo API is based on VM identifiers only. </p> @@ -275,13 +269,13 @@ boolean[] probes = (boolean[]) args[0]; <p> Using OSGi bundles allows well defined dependencies at development time and at runtime in OSGi containers. As there are no dependencies on OSGi, the - bundles can also be used like regular JAR files. + bundles can also be used like regular JAR files. </p> </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/index.html b/org.jacoco.doc/docroot/doc/index.html index e17a3491..10129346 100644 --- a/org.jacoco.doc/docroot/doc/index.html +++ b/org.jacoco.doc/docroot/doc/index.html @@ -13,7 +13,7 @@ <a href="../index.html" class="el_report">JaCoCo</a> > <span class="el_group">Documentation</span> </div> -<div id="content"> +<div id="content"> <h1>Documentation</h1> @@ -88,8 +88,8 @@ </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/integrations.html b/org.jacoco.doc/docroot/doc/integrations.html index 60188915..56ed9cb7 100644 --- a/org.jacoco.doc/docroot/doc/integrations.html +++ b/org.jacoco.doc/docroot/doc/integrations.html @@ -14,7 +14,7 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">Integration Matrix</span> </div> -<div id="content"> +<div id="content"> <h1>Integration Matrix</h1> @@ -65,7 +65,7 @@ </tr> </tbody> </table> - + <h3>Third-Party Integrations</h3> <table class="coverage"> @@ -81,6 +81,14 @@ <td>Java EE testing framework, <a href="http://arquillian.org/modules/jacoco-extension/">JaCoCo extension</a></td> </tr> <tr> + <td><a href="https://azure.microsoft.com/services/devops/">Azure DevOps</a></td> + <td>Cloud-powered collaboration tools by Microsoft, see <a href="https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/test/publish-code-coverage-results">documentation</a></td> + </tr> + <tr> + <td><a href="https://www.codacy.com/">Codacy</a></td> + <td>Platform to track code coverage and code quality, see <a href="https://support.codacy.com/hc/en-us/articles/207279819-Coverage">documentation</a></td> + </tr> + <tr> <td><a href="https://codecov.io/">Codecov</a></td> <td>Web service to track code coverage, see <a href="https://github.com/codecov/example-java">example</a></td> </tr> @@ -89,12 +97,12 @@ <td>Web service to track code coverage, see <a href="https://github.com/trautonen/coveralls-maven-plugin">coveralls-maven-plugin</a></td> </tr> <tr> - <td><a href="http://www.gradle.org/">Gradle</a></td> - <td>Build System with JaCoCo plug-in, see <a href="http://www.gradle.org/docs/current/userguide/jacoco_plugin.html">documentation</a></td> + <td><a href="https://www.stamp-project.eu/">STAMP</a></td> + <td>EU research project with test generation tool for JUnit, see <a href="https://github.com/STAMP-project/dspot">DSpot project page</a></td> </tr> <tr> - <td><a href="http://www.bredex.de/web/index.php/guidancer_jubula_en.html">GUIdancer</a></td> - <td>Commercial GUI testing tool by BREDEX GmbH</td> + <td><a href="http://www.gradle.org/">Gradle</a></td> + <td>Build System with JaCoCo plug-in, see <a href="http://www.gradle.org/docs/current/userguide/jacoco_plugin.html">documentation</a></td> </tr> <tr> <td><a href="http://www.jetbrains.com/idea/">IntelliJ IDEA</a></td> @@ -109,8 +117,8 @@ <td>GSoC project of Ognjen Bubalo, see <a href="https://wiki.jenkins-ci.org/display/JENKINS/JaCoCo+Plugin">documentation</a></td> </tr> <tr> - <td><a href="http://java.visualstudio.com/">Visual Studio Team Services</a></td> - <td>Cloud-powered collaboration tools by Microsoft, see <a href="https://blogs.msdn.microsoft.com/visualstudioalm/2015/11/24/testing-java-applications-with-visual-studio-team-services/">blog entry</a></td> + <td><a href="https://www.eclipse.org/jubula/">Jubula</a></td> + <td>Functional GUI testing tool</td> </tr> <tr> <td><a href="http://netbeans.org/">NetBeans</a></td> @@ -118,8 +126,8 @@ <a href="http://plugins.netbeans.org/plugin/48570/tikione-jacocoverage">plug-in</a> for Ant based projects</td> </tr> <tr> - <td><a href="https://github.com/harrah/xsbt/wiki">sbt</a></td> - <td>Simple Build Tool, <a href="https://bitbucket.org/jmhofer/jacoco4sbt">jacoco4sbt</a> by Joachim Hofer</td> + <td><a href="https://www.scala-sbt.org/">sbt</a></td> + <td>Scala Build Tool, see <a href="https://www.scala-sbt.org/sbt-jacoco/">JaCoCo plug-in</a></td> </tr> <tr> <td><a href="http://www.shippable.com/">Shippable</a></td> @@ -127,11 +135,11 @@ </tr> <tr> <td><a href="http://www.sonarqube.org/">SonarQube</a></td> - <td>Continuous inspection platform with JaCoCo support, see <a href="http://docs.sonarqube.org/display/PLUG/Code+Coverage+by+Unit+Tests+for+Java+Project">documentation</a></td> + <td>Continuous inspection platform with JaCoCo support, see <a href="https://docs.sonarqube.org/latest/analysis/coverage/">documentation</a></td> </tr> <tr> <td><a href="http://www.jetbrains.com/teamcity/">TeamCity</a></td> - <td>Continuous integration server with JaCoCo support since version 8.1, see <a href="http://confluence.jetbrains.com/display/TCD8/JaCoCo">documentation</a></td> + <td>Continuous integration server with JaCoCo support since version 8.1, see <a href="https://www.jetbrains.com/help/teamcity/jacoco.html">documentation</a></td> </tr> <tr> <td><a href="https://developer.ibm.com/urbancode/">Urban Code</a></td> @@ -147,8 +155,8 @@ </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/license.html b/org.jacoco.doc/docroot/doc/license.html index d7a5e8f0..4159b442 100644 --- a/org.jacoco.doc/docroot/doc/license.html +++ b/org.jacoco.doc/docroot/doc/license.html @@ -13,21 +13,21 @@ <a href="../index.html" class="el_report">JaCoCo</a> > <span class="el_source">License</span> </div> -<div id="content"> +<div id="content"> <h1>License</h1> <p> - Copyright © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors -</p> + Copyright © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors +</p> <p> The JaCoCo Java Code Coverage Library and all included documentation is made available by Mountainminds GmbH & Co. KG, Munich. Except indicated below, the Content is provided to you under the terms and conditions of the Eclipse - Public License Version 1.0 ("EPL"). A copy of the EPL is - <a href="epl-v10.html">provided</a> with this Content and is also available at - <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>. + Public License Version 2.0 ("EPL"). A copy of the EPL is + <a href="epl-2.0.html">provided</a> with this Content and is also available at + <a href="https://www.eclipse.org/legal/epl-2.0/">https://www.eclipse.org/legal/epl-2.0/</a>. </p> <h2>Trademarks</h2> @@ -39,7 +39,7 @@ trademark, registered trademark, or service mark of The OSGi Alliance in the US and other countries. Apache Ant and Apache Maven are trademarks of the Apache Software Foundation. Android and Dalvik are trademarks of Google Inc. - All other trademarks are the property of their respective owners. + All other trademarks are the property of their respective owners. </p> @@ -50,243 +50,14 @@ out below. </p> - -<h3>ASM</h3> - -<p> - <a href="http://asm.objectweb.org/">ASM</a> is subject to the terms and - conditions of the following license: -</p> - -<pre> -Copyright (c) 2012 France Télécom -All rights reserved. - -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions -are met: - -1. Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. - -2. Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. - -3. Neither the name of the copyright holders nor the names of its - contributors may be used to endorse or promote products derived from - this software without specific prior written permission. - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE -LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF -THE POSSIBILITY OF SUCH DAMAGE. -</pre> - - -<h3>Google Code Prettify</h3> - -<p> - <a href="http://code.google.com/p/google-code-prettify/">Google Code Prettify</a> - is subject to the terms and conditions of the following license: -</p> - -<pre> - Apache License - Version 2.0, January 2004 - http://www.apache.org/licenses/ - - TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION - - 1. Definitions. - - "License" shall mean the terms and conditions for use, reproduction, - and distribution as defined by Sections 1 through 9 of this document. - - "Licensor" shall mean the copyright owner or entity authorized by - the copyright owner that is granting the License. - - "Legal Entity" shall mean the union of the acting entity and all - other entities that control, are controlled by, or are under common - control with that entity. For the purposes of this definition, - "control" means (i) the power, direct or indirect, to cause the - direction or management of such entity, whether by contract or - otherwise, or (ii) ownership of fifty percent (50%) or more of the - outstanding shares, or (iii) beneficial ownership of such entity. - - "You" (or "Your") shall mean an individual or Legal Entity - exercising permissions granted by this License. - - "Source" form shall mean the preferred form for making modifications, - including but not limited to software source code, documentation - source, and configuration files. - - "Object" form shall mean any form resulting from mechanical - transformation or translation of a Source form, including but - not limited to compiled object code, generated documentation, - and conversions to other media types. - - "Work" shall mean the work of authorship, whether in Source or - Object form, made available under the License, as indicated by a - copyright notice that is included in or attached to the work - (an example is provided in the Appendix below). - - "Derivative Works" shall mean any work, whether in Source or Object - form, that is based on (or derived from) the Work and for which the - editorial revisions, annotations, elaborations, or other modifications - represent, as a whole, an original work of authorship. For the purposes - of this License, Derivative Works shall not include works that remain - separable from, or merely link (or bind by name) to the interfaces of, - the Work and Derivative Works thereof. - - "Contribution" shall mean any work of authorship, including - the original version of the Work and any modifications or additions - to that Work or Derivative Works thereof, that is intentionally - submitted to Licensor for inclusion in the Work by the copyright owner - or by an individual or Legal Entity authorized to submit on behalf of - the copyright owner. For the purposes of this definition, "submitted" - means any form of electronic, verbal, or written communication sent - to the Licensor or its representatives, including but not limited to - communication on electronic mailing lists, source code control systems, - and issue tracking systems that are managed by, or on behalf of, the - Licensor for the purpose of discussing and improving the Work, but - excluding communication that is conspicuously marked or otherwise - designated in writing by the copyright owner as "Not a Contribution." - - "Contributor" shall mean Licensor and any individual or Legal Entity - on behalf of whom a Contribution has been received by Licensor and - subsequently incorporated within the Work. - - 2. Grant of Copyright License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - copyright license to reproduce, prepare Derivative Works of, - publicly display, publicly perform, sublicense, and distribute the - Work and such Derivative Works in Source or Object form. - - 3. Grant of Patent License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - (except as stated in this section) patent license to make, have made, - use, offer to sell, sell, import, and otherwise transfer the Work, - where such license applies only to those patent claims licensable - by such Contributor that are necessarily infringed by their - Contribution(s) alone or by combination of their Contribution(s) - with the Work to which such Contribution(s) was submitted. If You - institute patent litigation against any entity (including a - cross-claim or counterclaim in a lawsuit) alleging that the Work - or a Contribution incorporated within the Work constitutes direct - or contributory patent infringement, then any patent licenses - granted to You under this License for that Work shall terminate - as of the date such litigation is filed. - - 4. Redistribution. You may reproduce and distribute copies of the - Work or Derivative Works thereof in any medium, with or without - modifications, and in Source or Object form, provided that You - meet the following conditions: - - (a) You must give any other recipients of the Work or - Derivative Works a copy of this License; and - - (b) You must cause any modified files to carry prominent notices - stating that You changed the files; and - - (c) You must retain, in the Source form of any Derivative Works - that You distribute, all copyright, patent, trademark, and - attribution notices from the Source form of the Work, - excluding those notices that do not pertain to any part of - the Derivative Works; and - - (d) If the Work includes a "NOTICE" text file as part of its - distribution, then any Derivative Works that You distribute must - include a readable copy of the attribution notices contained - within such NOTICE file, excluding those notices that do not - pertain to any part of the Derivative Works, in at least one - of the following places: within a NOTICE text file distributed - as part of the Derivative Works; within the Source form or - documentation, if provided along with the Derivative Works; or, - within a display generated by the Derivative Works, if and - wherever such third-party notices normally appear. The contents - of the NOTICE file are for informational purposes only and - do not modify the License. You may add Your own attribution - notices within Derivative Works that You distribute, alongside - or as an addendum to the NOTICE text from the Work, provided - that such additional attribution notices cannot be construed - as modifying the License. - - You may add Your own copyright statement to Your modifications and - may provide additional or different license terms and conditions - for use, reproduction, or distribution of Your modifications, or - for any such Derivative Works as a whole, provided Your use, - reproduction, and distribution of the Work otherwise complies with - the conditions stated in this License. - - 5. Submission of Contributions. Unless You explicitly state otherwise, - any Contribution intentionally submitted for inclusion in the Work - by You to the Licensor shall be under the terms and conditions of - this License, without any additional terms or conditions. - Notwithstanding the above, nothing herein shall supersede or modify - the terms of any separate license agreement you may have executed - with Licensor regarding such Contributions. - - 6. Trademarks. This License does not grant permission to use the trade - names, trademarks, service marks, or product names of the Licensor, - except as required for reasonable and customary use in describing the - origin of the Work and reproducing the content of the NOTICE file. - - 7. Disclaimer of Warranty. Unless required by applicable law or - agreed to in writing, Licensor provides the Work (and each - Contributor provides its Contributions) on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or - implied, including, without limitation, any warranties or conditions - of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A - PARTICULAR PURPOSE. You are solely responsible for determining the - appropriateness of using or redistributing the Work and assume any - risks associated with Your exercise of permissions under this License. - - 8. Limitation of Liability. In no event and under no legal theory, - whether in tort (including negligence), contract, or otherwise, - unless required by applicable law (such as deliberate and grossly - negligent acts) or agreed to in writing, shall any Contributor be - liable to You for damages, including any direct, indirect, special, - incidental, or consequential damages of any character arising as a - result of this License or out of the use or inability to use the - Work (including but not limited to damages for loss of goodwill, - work stoppage, computer failure or malfunction, or any and all - other commercial damages or losses), even if such Contributor - has been advised of the possibility of such damages. - - 9. Accepting Warranty or Additional Liability. While redistributing - the Work or Derivative Works thereof, You may choose to offer, - and charge a fee for, acceptance of support, warranty, indemnity, - or other liability obligations and/or rights consistent with this - License. However, in accepting such obligations, You may act only - on Your own behalf and on Your sole responsibility, not on behalf - of any other Contributor, and only if You agree to indemnify, - defend, and hold each Contributor harmless for any liability - incurred by, or claims asserted against, such Contributor by reason - of your accepting any such warranty or additional liability. -</pre> - -<h3>args4j</h3> - -<p> - <a href="http://args4j.kohsuke.org/">args4j</a> is subject to the terms and - conditions of - <a href="http://www.opensource.org/licenses/mit-license.php">the MIT license</a>. -</p> +${args4j.license} +${asm.license} +${googlecodeprettify.license} </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/maven.html b/org.jacoco.doc/docroot/doc/maven.html index 5284978e..4e41e4d4 100644 --- a/org.jacoco.doc/docroot/doc/maven.html +++ b/org.jacoco.doc/docroot/doc/maven.html @@ -16,7 +16,7 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">Maven Plug-in</span> </div> -<div id="content"> +<div id="content"> <h1>Maven Plug-in</h1> @@ -45,7 +45,7 @@ <ul> <li> - The JaCoCo distribution contains a simple example how code coverage + The JaCoCo distribution contains a simple example how code coverage can be added to a Maven project.</li> <li> This <a href="examples/build/pom.xml">POM file</a> @@ -91,7 +91,7 @@ <plugin> <groupId>org.jacoco</groupId> <artifactId>jacoco-maven-plugin</artifactId> - <version>@project.version@</version> + <version>${project.version}</version> </plugin> </pre> @@ -152,8 +152,8 @@ mvn help:describe -Dplugin=org.jacoco:jacoco-maven-plugin -Ddetail </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/mission.html b/org.jacoco.doc/docroot/doc/mission.html index d4ce1469..f5098ec1 100644 --- a/org.jacoco.doc/docroot/doc/mission.html +++ b/org.jacoco.doc/docroot/doc/mission.html @@ -14,7 +14,7 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">Mission</span> </div> -<div id="content"> +<div id="content"> <h1>Mission</h1> @@ -22,7 +22,7 @@ JaCoCo should provide the standard technology for code coverage analysis in Java VM based environments. The focus is providing a lightweight, flexible and well documented library for integration with various build and development - tools. + tools. </p> <p> @@ -43,7 +43,7 @@ Therefore we started the JaCoCo project to provide a new standard technology for code coverage analysis in Java VM based environments. The focus is providing a lightweight, flexible and well documented library for integration - with various build and development tools. <a href="ant.html">Ant tasks</a>, a + with various build and development tools. <a href="ant.html">Ant tasks</a>, a <a href="maven.html">Maven plug-in</a> and the <a href="http://www.eclemma.org/">EclEmma Eclipse plug-in</a> are provided as reference usage scenarios. Also many other tool vendors and Open Source @@ -93,8 +93,8 @@ </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/offline.html b/org.jacoco.doc/docroot/doc/offline.html index 16211375..b1f184bd 100644 --- a/org.jacoco.doc/docroot/doc/offline.html +++ b/org.jacoco.doc/docroot/doc/offline.html @@ -14,7 +14,7 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">Offline Instrumentation</span> </div> -<div id="content"> +<div id="content"> <h1>Offline Instrumentation</h1> @@ -64,7 +64,7 @@ <p> In both cases configuration values may contain variables in the format <code>${<i>name</i>}</code> which are resolved with system property values - at runtime. For example: + at runtime. For example: </p> <pre class="source"> @@ -79,7 +79,7 @@ destfile=${user.home}/jacoco.exec instrumented classes. The proper location for <code>jacocoagent.jar</code> might depend on your deployment scenario. The first instrumented class loaded will trigger the initialization of the JaCoCo runtime. If no instrumented - class is loaded the JaCoCo runtime will not get started at all. + class is loaded the JaCoCo runtime will not get started at all. </p> <h2>Using Pre-Instrumented Classes With the Java Agent</h2> @@ -88,7 +88,7 @@ destfile=${user.home}/jacoco.exec agent. In this case the configuration is taken from the agent options. The agent must be configured in a way that pre-instrumented classes are excluded, e.g. with "<code>excludes=*</code>". Otherwise it will result in error - messages on the console if the agent instruments such classes again. + messages on the console if the agent instruments such classes again. </p> <h2>Execution Data Collection</h2> @@ -111,8 +111,8 @@ destfile=${user.home}/jacoco.exec </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/repo.html b/org.jacoco.doc/docroot/doc/repo.html index 3fa16e57..be517de1 100644 --- a/org.jacoco.doc/docroot/doc/repo.html +++ b/org.jacoco.doc/docroot/doc/repo.html @@ -16,14 +16,14 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">Maven Repository</span> </div> -<div id="content"> +<div id="content"> <h1>Maven Repository</h1> <p> If you want to integrate JaCoCo within your tools you might directly retrieve it from the Maven repository. There are two repositories, one for JaCoCo - releases, one for regular snapshot builds. + releases, one for regular snapshot builds. </p> <table class="coverage"> @@ -126,8 +126,8 @@ </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/resources/doc.css b/org.jacoco.doc/docroot/doc/resources/doc.css index ec89c32a..592be8ab 100644 --- a/org.jacoco.doc/docroot/doc/resources/doc.css +++ b/org.jacoco.doc/docroot/doc/resources/doc.css @@ -43,7 +43,7 @@ div#content a[href^='http://'], a[href^='https://'] { background:transparent url(extern.gif) center left no-repeat; } -/* === Definitions from report.css start here: === */ +/* === Definitions from report.css start here: === */ body, td { font-family:sans-serif; @@ -148,7 +148,7 @@ pre.source span.pc { table.coverage { empty-cells:show; - border-collapse:collapse; + border-collapse:collapse; } table.coverage thead { @@ -178,7 +178,7 @@ table.coverage tbody td { border-bottom:#d6d3ce 1px solid; } -table.coverage tbody tr:hover { +table.coverage tbody tr:hover { background: #f0f0d0 !important; } diff --git a/org.jacoco.doc/docroot/doc/support.html b/org.jacoco.doc/docroot/doc/support.html index 4655c010..f705250f 100644 --- a/org.jacoco.doc/docroot/doc/support.html +++ b/org.jacoco.doc/docroot/doc/support.html @@ -14,7 +14,7 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">Support and Feedback</span> </div> -<div id="content"> +<div id="content"> <h1>Support and Feedback</h1> @@ -36,8 +36,8 @@ </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> diff --git a/org.jacoco.doc/docroot/doc/team.html b/org.jacoco.doc/docroot/doc/team.html index 8edc3ce8..6f3d5e76 100644 --- a/org.jacoco.doc/docroot/doc/team.html +++ b/org.jacoco.doc/docroot/doc/team.html @@ -14,7 +14,7 @@ <a href="index.html" class="el_group">Documentation</a> > <span class="el_source">Team</span> </div> -<div id="content"> +<div id="content"> <h1>Team</h1> @@ -29,9 +29,9 @@ </ul> <p> - To keep the development process open please use the + To keep the development process open please use the <a href="support.html">public communication channels</a> and do not contact - individual team members. + individual team members. </p> <h2>Former Developers</h2> @@ -49,8 +49,8 @@ </div> <div class="footer"> - <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span> - <a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors + <span class="right"><a href="${jacoco.home.url}">JaCoCo</a> ${qualified.bundle.version}</span> + <a href="license.html">Copyright</a> © ${copyright.years} Mountainminds GmbH & Co. KG and Contributors </div> </body> |