blob: c1338bfeac9c6067a276d8fbd979de9e4d58e742 [file] [log] [blame]
Marc R. Hoffmanne571f3f2012-05-13 12:18:02 +00001<?xml version="1.0" encoding="UTF-8" ?>
Evgeny Mandrikov82a92ca2012-01-15 20:25:48 +00002<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
4<head>
Marc R. Hoffmanne571f3f2012-05-13 12:18:02 +00005 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
6 <link rel="stylesheet" href=".resources/doc.css" charset="UTF-8" type="text/css" />
Evgeny Mandrikov82a92ca2012-01-15 20:25:48 +00007 <link rel="shortcut icon" href=".resources/report.gif" type="image/gif" />
8 <title>JaCoCo - Change History</title>
9</head>
10<body>
11
12<div class="breadcrumb">
13 <a href="../index.html" class="el_report">JaCoCo</a> &gt;
14 <a href="index.html" class="el_group">Documentation</a> &gt;
15 <span class="el_source">Change History</span>
16</div>
17<div id="content">
18
19<h1>Change History</h1>
20
Evgeny Mandrikova6a45e82012-12-23 22:24:47 +010021<h2>Trunk Build @qualified.bundle.version@ (@build.date@)</h2>
22
Evgeny Mandrikov4a77e402012-12-26 12:03:58 +010023<h3>New Features</h3>
Marc R. Hoffmann47990a42012-12-28 13:54:23 +010024<ul>
25 <li>Support for offline instrumentation (GitHub #4).</li>
Marc Hoffmann60147ad2013-01-08 18:57:10 +010026 <li>JaCoCo agent exposes runtime API for direct integration with application
27 under test (GitHub #61).</li>
Marc R. Hoffmann47990a42012-12-28 13:54:23 +010028</ul>
Evgeny Mandrikov4a77e402012-12-26 12:03:58 +010029
30<h3>Fixed Bugs</h3>
31
32<h3>Non-functional Changes</h3>
33<ul>
34 <li>For every build the corresponding Git commit hash is included as
35 <code>Eclipse-SourceReferences</code> manifest headers (GitHub #7, #59).</li>
36</ul>
37
Evgeny Mandrikov0bb8d2d2012-12-23 20:33:58 +010038<h2>Release 0.6.1 (2012/12/23)</h2>
Evgeny Mandrikov7764fe52012-10-06 23:44:26 +040039
Evgeny Mandrikov2ea884b2012-11-10 13:47:51 +010040<h3>New Features</h3>
41<ul>
Evgeny Mandrikovca863832012-11-22 00:12:12 +010042 <li>Add a coverage check Mojo, contributed by Kyle Lieber (GitHub #6).</li>
Evgeny Mandrikov2ea884b2012-11-10 13:47:51 +010043</ul>
44
Evgeny Mandrikoveb0cfdf2012-11-10 18:00:41 +010045<h3>Fixed Bugs</h3>
46<ul>
Marc R. Hoffmannfcc0a0f2012-11-10 20:37:05 +010047 <li>jacocoant.jar should not conflict with ASM 3.x (GitHub #39).</li>
Evgeny Mandrikovca863832012-11-22 00:12:12 +010048 <li>Agent Mojo should set empty property, if execution was skipped
49 (GitHub #44).</li>
Evgeny Mandrikoveb0cfdf2012-11-10 18:00:41 +010050</ul>
51
Marc R. Hoffmann1e1df5b2012-11-02 22:58:50 +010052<h3>Non-functional Changes</h3>
53<ul>
Marc R. Hoffmanncd5deec2012-11-09 14:59:22 +010054 <li>Upgrade to ASM 4.1 (GitHub #37).</li>
Marc R. Hoffmannfcc0a0f2012-11-10 20:37:05 +010055 <li>Log location of merged execution data file in Ant <code>merge</code> task
56 (GitHub #29).</li>
Marc R. Hoffmann1e1df5b2012-11-02 22:58:50 +010057</ul>
58
Evgeny Mandrikov76f62ca2012-10-06 23:01:20 +040059<h2>Release 0.6.0 (2012/10/06)</h2>
Evgeny Mandrikov13d966c2012-08-31 12:39:14 +060060
Marc R. Hoffmannf22657e2012-09-20 21:45:49 +020061<h3>New Features</h3>
62<ul>
63 <li>Full support for Java 7 including INVOKEDYNAMIC as JaCoCo is now based
Marc R. Hoffmann8bcab032012-09-20 22:28:29 +020064 on ASM 4.0 (GitHub #5).</li>
Marc R. Hoffmannf22657e2012-09-20 21:45:49 +020065</ul>
66
Abraham Lin47c3fbb2012-09-13 23:27:32 +060067<h3>Fixed Bugs</h3>
68<ul>
69 <li>Maven plugin should skip creation of report if the execution data file is
Marc R. Hoffmann8bcab032012-09-20 22:28:29 +020070 missing. This avoids appearance of stack traces in case when JVM was not
71 forked, e.g. if there are no tests to run (SF #3563431, GitHub #19).</li>
72 <li>Maven plugin should fail if unable to read execution data file or create
73 report (GitHub #19).</li>
Abraham Lin47c3fbb2012-09-13 23:27:32 +060074</ul>
75
Marc R. Hoffmann8bcab032012-09-20 22:28:29 +020076<h3>API Changes</h3>
77<ul>
78 <li>Only colon as separator character supported in agent parameters. The
79 deprecated pipe character is no longer supported.</li>
80</ul>
81
82
Evgeny Mandrikovd3dd13c2012-08-31 12:32:50 +060083<h2>Release 0.5.10 (2012/08/31)</h2>
Evgeny Mandrikov9e1a22e2012-07-30 07:35:07 +000084
Marc R. Hoffmannababcec2012-08-16 19:07:26 +000085<h3>Fixed Bugs</h3>
86<ul>
Marc R. Hoffmann632e70b2012-08-24 14:49:19 +000087 <li>Correct stackmap frames for new <code>long[]</code> arrays (SF #3553210).</li>
88 <li>Properly resolve the <code>fork</code> variable for tasks wrapped by the
89 <code>coverage</code> Ant task (Trac #213).</li>
Marc R. Hoffmannababcec2012-08-16 19:07:26 +000090</ul>
91
Marc R. Hoffmannbb80b762012-08-29 23:57:58 +020092<h3>Non-functional Changes</h3>
93<ul>
94 <li>Source tree has been migrated to Git and is now hosted on Github at
95 <a href="https://github.com/jacoco/jacoco">https://github.com/jacoco/jacoco</a>.</li>
96</ul>
97
Evgeny Mandrikov7fa63e72012-07-30 07:26:38 +000098<h2>Release 0.5.9 (2012/07/30)</h2>
Evgeny Mandrikov19e5caa2012-07-11 12:29:04 +000099
Marc R. Hoffmann049e6042012-07-21 19:02:27 +0000100<h3>Fixed Bugs</h3>
101<ul>
102 <li>Don't produce invalid class files in case of unexpected stackmap frames
103 (SF #3543758).</li>
104</ul>
105
Evgeny Mandrikov5552b672012-07-11 12:23:15 +0000106<h2>Release 0.5.8 (2012/07/11)</h2>
Marc R. Hoffmann871836b2012-05-12 12:28:13 +0000107
Marc R. Hoffmanncf41fc12012-06-30 00:15:43 +0000108<h3>New Features</h3>
109<ul>
110 <li>Support for parallel Maven builds (Trac #191).</li>
111 <li>New agent option <code>classdumpdir</code> to dump all class files seen
112 by the JaCoCo agent to disk. This option is also available for Ant and
113 Maven (Trac #208).</li>
114</ul>
115
Marc R. Hoffmann9308f8a2012-07-04 19:00:06 +0000116<h3>Fixed Bugs</h3>
117<ul>
118 <li>Allow instrumentation of classes with dead code (SF #3538112).</li>
Marc R. Hoffmann65c17152012-07-09 10:37:23 +0000119 <li>Reworked instrumentation strategy to avoid verifier error "Uninitialized
120 object exists on backward branch" with certain Java 7 class files
121 (Trac #154).</li>
Marc R. Hoffmann9308f8a2012-07-04 19:00:06 +0000122</ul>
123
Marc R. Hoffmann78309272012-05-02 19:25:44 +0000124<h3>Non-functional Changes</h3>
125<ul>
Marc R. Hoffmann871836b2012-05-12 12:28:13 +0000126 <li>Documentation now includes Maven example and Maven goal documentation
127 (Trac #201, #202).</li>
Marc R. Hoffmann78309272012-05-02 19:25:44 +0000128</ul>
129
Evgeny Mandrikov976a90f2012-04-19 03:40:42 +0000130<h2>Release 0.5.7 (2012/04/19)</h2>
Evgeny Mandrikov022e3af2012-01-23 23:39:12 +0000131
Marc R. Hoffmann2a363b82012-03-31 10:00:06 +0000132<h3>New Features</h3>
133<ul>
134 <li>Support for class redefinitions by other agents like JMockit (SF #3509409).</li>
Marc R. Hoffmannc17f2b02012-04-07 09:05:00 +0000135 <li>Remove class file attributes with invalid code offsets caused by other
Marc R. Hoffmannc32282c2012-04-18 21:04:59 +0000136 byte code processing tools to avoid verifier errors (Trac #196).</li>
137 <li>Improved logging for Ant tasks (SF #3518429).</li>
Marc R. Hoffmann2a363b82012-03-31 10:00:06 +0000138</ul>
139
Marc R. Hoffmannce117fd2012-03-29 12:55:41 +0000140<h3>Fixed Bugs</h3>
141<ul>
142 <li>In case of failures the agent should log the original exception.</li>
143</ul>
144
Evgeny Mandrikov99487a12012-01-23 23:33:12 +0000145<h2>Release 0.5.6 (2012/01/23)</h2>
Evgeny Mandrikov82a92ca2012-01-15 20:25:48 +0000146
147<h3>New Features</h3>
148<ul>
149 <li>jacoco-maven-plugin can be used together with maven-site-plugin (Trac #181).</li>
Marc R. Hoffmann8b5d6a32012-01-18 20:24:45 +0000150 <li>The <code>report</code> Ant task now also supports directory resources to
151 specify source folders. This allows reading source files from multiple
152 directories. Contributed by Dominik Stadler (Trac #119).</li>
Evgeny Mandrikov82a92ca2012-01-15 20:25:48 +0000153</ul>
154
155<h3>Fixed Bugs</h3>
156<ul>
157 <li>Don't insert stackmap frames for class files before version 1.6.</li>
158 <li>Regression, which was introduced in 0.5.4 - restored compatibility of jacoco-maven-plugin with Maven 2 (Trac #182).</li>
159</ul>
160
161<h2>Release 0.5.5 (2011/12/15)</h2>
162
163<h3>Fixed Bugs</h3>
164<ul>
165 <li>Correct default value for the <code>append</code> property of the
166 <code>dump</code> Ant task is <code>true</code> (Trac #178).</li>
167 <li>Try/catch blocks must not be counted as instructions (Trac #179).</li>
168</ul>
169
170<h3>Non-functional Changes</h3>
171<ul>
172 <li>Upgrade to ASM 3.3.1.</li>
173</ul>
174
175<h2>Release 0.5.4 (2011/11/11)</h2>
176
177<h3>New Features</h3>
178<ul>
179 <li>Maven plug-in: respect <code>includes</code> and <code>excludes</code>
Evgeny Mandrikov8e7d6992011-11-11 20:26:38 +0000180 properties in report Mojo (Trac #160).
Evgeny Mandrikov8e7d6992011-11-11 20:26:38 +0000181 Also note that:
182<pre class="source lang-xml">
183&lt;configuration&gt;
184 &lt;includes&gt;org.foo.*:org.bar.*&lt;/includes&gt;
185 &lt;excludes&gt;com.foo.*:com.bar.*&lt;/excludes&gt;
186&lt;/configuration&gt;
187</pre>
188 must be replaced on:
189<pre class="source lang-xml">
190&lt;configuration&gt;
191 &lt;includes&gt;
192 &lt;include>org.foo.*&lt;/include&gt;
193 &lt;include>org.bar.*&lt;/include&gt;
194 &lt;/includes&gt;
195 &lt;excludes&gt;
196 &lt;exclude&gt;com.foo.*&lt;/exclude&gt;
197 &lt;exclude&gt;com.bar.*&lt;/exclude&gt;
198 &lt;/excludes&gt;
199&lt;/configuration&gt;
200</pre>
Evgeny Mandrikov82a92ca2012-01-15 20:25:48 +0000201 </li>
202</ul>
203
204<h3>API Changes</h3>
205<ul>
206 <li><code>Instrumenter</code> now only requires
207 <code>IExecutionDataAccessorGenerator</code> instead of
208 <code>IRuntime</code> (Trac #174).</li>
209 <li>Removed reference to internal implementation classes from
210 <code>CoverageBuilder</code> API.</li>
211</ul>
212
213<h3>Non-functional Changes</h3>
214<ul>
215 <li>Release bundles from now on signed again.</li>
216 <li>Several documentation updates.</li>
217</ul>
218
219<h2>Release 0.5.3 (2011/07/06)</h2>
220
221<h3>New Features</h3>
222<ul>
223 <li>New Maven plug-in for JaCoCo agent setup and basic reporting (Trac #25).</li>
224 <li>Additional output mode implementation for JaCoCo agent based on JMX.</li>
225</ul>
226
227<h3>Fixed Bugs</h3>
228<ul>
229 <li>Fixed problem with reporting of nested group structures (Trac #157).</li>
230</ul>
231
232<h3>Non-functional Changes</h3>
233<ul>
234 <li>JaCoCo build based on Maven (Trac #136).</li>
235 <li>JaCoCo published to Maven repository (Trac #149).</li>
236</ul>
237
238<h2>Release 0.5.2 (2011/05/19)</h2>
239
240<h3>New Features</h3>
241<ul>
242 <li>JaCoCo reports cyclomatic complexity numbers (Trac #129).</li>
243 <li>For HTML reports the tab width can be specified on the
244 <code>sourcefiles</code> attribute of the <code>report</code> Ant task
245 (Track #152).</li>
246</ul>
247
248<h3>Fixed Bugs</h3>
249<ul>
250 <li>Removed duplicate counters in the root node of XML reports (Trac #155).</li>
251 <li>Avoid <code>StackOverflowException</code> when analyzing methods with very
252 long instruction sequences (Trac #156). Many thanks to Jean-Eric Cuendet
253 for reporting and analyzing this!</li>
254</ul>
255
256<h3>API Changes</h3>
257<ul>
258 <li><code>ICoverageNode</code> API has been extended for cyclomatic
259 complexity (Trac #129).</li>
260 <li>XML and CSV report includes new counter type <code>COMPLEXITY</code>
261 (Trac #129).</li>
262 <li>New method <code>getTabWidth()</code> in callback interface
263 <code>ISourceFileLocator</code> instead of
264 <code>HTMLReportFormatter.setTabWidth()</code> which has been removed.
265 (Trac #152).</li>
266</ul>
267
268<h2>Release 0.5.1 (2011/03/21)</h2>
269
270<h3>New Features</h3>
271<ul>
272 <li>Duplicate classes with identical identifiers are now ignored during
273 analysis.</li>
274 <li>Added support for TestNG to Ant task Coverage (Track #144).</li>
275</ul>
276
277<h3>Fixed Bugs</h3>
278<ul>
279 <li>Calculate correct stackmap frames for Java 1.6 branches (Trac #139).</li>
280 <li>Link source files also for classes in default package (Trac #151).</li>
281</ul>
282
283<h3>Non-functional Changes</h3>
284<ul>
285 <li>API documentation cleanup (Track #140).</li>
286 <li>Removed obsolete examples from documentation (Trac #141).</li>
287 <li>Added reporting API example (Trac #146).</li>
288 <li>Reduced file size of HTML report source pages (Trac #148).</li>
289</ul>
290
291<h3>API Changes</h3>
292<ul>
293 <li>Simplified reporting API (Trac #53).</li>
294 <li>Use colon as separator character in agent parameters (Trac #143).</li>
295 <li>Now also empty files are accepted as <code>*.exec</code> files (Trac #150).</li>
296</ul>
297
298<h2>Release 0.5.0 (2011/01/19)</h2>
299
300<h3>New Features</h3>
301<ul>
302 <li>JaCoCo now reports branch coverage (Track #66).</li>
303</ul>
304
305<h3>Fixed Bugs</h3>
306<ul>
307 <li>Only process actual Java class files during analysis (SF #3106102).</li>
308 <li>Fix broken source links due to sort hash (Track #125).</li>
309 <li>Fixed invalid OSGi headers in MANIFEST.MF files (Track #127).</li>
310 <li>Try to avoid interference with Hibernate (SF #3134190).</li>
311 <li>Provide proper error message in case of duplicate class names in the same
312 group (SF #3110219).</li>
313 <li>Allow any number of probes in static interface initializers (SF #3161106).</li>
314</ul>
315
316<h3>API Changes</h3>
317<ul>
318 <li>All analysis specific APIs have been moved to package
319 <code>org.jacoco.core.analysis</code>.</li>
320 <li>The <code>IStructureVisitor</code> interface has been replaced by a
321 simplified version called <code>ICoverageVisitor</code> (Track #132).</li>
322 <li>All counter creation and update APIs now accept <i>missed items</i> and
323 <i>covered items</i> as parameters (Track #131).</li>
324 <li>Instructions are now counted on a per line basis. Therefore some
325 interfaces in the <code>org.jacoco.core.analysis</code> package have
326 changed as well as the <code>line</code> element in the XML report
327 (Track #130).</li>
328 <li>Several internal implementation classes have removed from the core APIs or
329 have been replaced by new interfaces (Track #133).</li>
330</ul>
331
332<h2>Release 0.4.1 (2010/10/07)</h2>
333
334<h3>New Features</h3>
335<ul>
336 <li>New attribute <code>line</code> for <code>method</code> elements in the
337 XML report containing the first source line number of the method.
338 (Track #120).</li>
339 <li>Optional <code>locale</code> attribute for number rendering HTML reports,
340 also available as an attribute of the <code>html</code> tag of the
341 <code>report</code> Ant task (Track #122).</li>
342 <li>Coverage tables in HTML report are now sortable (Track #98).</li>
343 <li>The <code>report</code> Ant task issues a warning if source files are
344 provided but class files do not contain debug information to collect line
345 numbers (SF #3024486).</li>
346</ul>
347
348<h3>Non-functional Changes</h3>
349<ul>
350 <li>Reduced memory footprint for coverage data by 30% (Track #106).</li>
351 <li>Moved to Eclipse 3.6.x as development environment (Trac #115).</li>
352 <li>All delivered bundles and JAR files are signed (Trac #118).</li>
353</ul>
354
355<h3>Fixed Bugs</h3>
356<ul>
357 <li>Better error message when multiple JaCoCo agents are specified
358 (Track #103).</li>
359 <li>Fixed potential NPE at shutdown when running agent in
360 <code>tcpserver</code> mode (Track #117).</li>
361 <li>Agent now fails at startup when execution data file can't be opened
362 (Track #121).</li>
363</ul>
364
365<h2>Release 0.4.0 (2010/06/04)</h2>
366
367<h3>New Features</h3>
368<ul>
369 <li>Execution data now includes session information: an arbitrary identifier,
370 the start time and dump time (Trac #88).</li>
371 <li>Added session information to XML report (Trac #92).</li>
372 <li>New "Sessions" page in the HTML report shows information about each
373 sessions wherein execution data has been collected for the report
374 (Trac #93). Additionally all classes with execution data available are
375 listed on this page (Trac #94).</li>
376 <li>The agent now supports remote dumps via TCP/IP connections (Trac #82).</li>
377 <li>New Ant task <code>dump</code> to remotely collect coverage data from
378 agents (Trac #100).</li>
379</ul>
380
381<h3>API Changes</h3>
382<ul>
383 <li>Execution data file header is written and read in any case (Trac #72).</li>
384 <li>Added <code>dumponexit</code> to agent options (Trac #82).</li>
385 <li>Added <code>sessionid</code> to agent options (Trac #88).</li>
386 <li>Added <code>output, address and port</code> to agent options (Trac #82).</li>
387 <li>Additional and modified methods in <code>IRuntime</code> to produce
388 session information (Trac #88).</li>
389 <li>Coverage element type <code>SESSION</code> removed (Trac #95).</li>
390 <li>Removed several internal APIs from package
391 <code>org.jacoco.core.instr</code> used for class instrumentation.</li>
392 <li>Renamed class <code>org.jacoco.report.csv.CsvFormatter</code> to
393 <code>CSVFormatter</code> (upper case) for consistency with other
394 formatters.</li>
395</ul>
396
397<h2>Release 0.3.3 (2010/04/19)</h2>
398
399<h3>New Features</h3>
400<ul>
401 <li>Support for different archives (jar, war, ear etc.) and nested archives
402 (Trac #78).</li>
403 <li>XML report with line level coverage information (requested for Sonar).</li>
404</ul>
405
406<h3>Fixed Bugs</h3>
407<ul>
408 <li>Correct stackmap frames for Java 1.6 class files. (Track #81).</li>
409 <li>Avoid usage of <code>LocalVariableSorter</code> due to ASM bug #314563
410 (Track #69).</li>
411 <li>Nested Java/JUnit Ant tasks not being executed when coverage task disabled. (Track #85).</li>
412</ul>
413
414<h2>Release 0.3.2 (2010/04/01)</h2>
415
416<h3>New Features</h3>
417<ul>
418 <li>New HTML report option to directly create a zip file containing the report
419 (Trac #12).</li>
420 <li>Code coverage for static initializers in interfaces (Trac #21).</li>
421 <li>Better error handling for <code>report</code> Ant task (Trac #71).</li>
422 <li>Classes without instructions are excluded from reports (Trac #73).</li>
423</ul>
424
425<h3>Fixed Bugs</h3>
426<ul>
427 <li>XML and CSV report output now also works for structures without groups
428 (Track #76).</li>
429</ul>
430
431<h3>API Changes</h3>
432<ul>
433 <li>Consistent usage of the term "Missed" instead of "NotCovered" in all APIs
434 (Trac #72).</li>
435 <li>To support "off-line" instrumentation scenarios it is not required any
436 more to register instrumented classes with the runtime (Trac #74).</li>
437</ul>
438
439<h2>Release 0.3.1 (2010/02/09)</h2>
440
441<h3>Fixed Bugs</h3>
442<ul>
443 <li>Ant tasks broken on Linux (Trac #68).</li>
444</ul>
445
446<h2>Release 0.3.0 (2010/02/02)</h2>
447
448<h3>New Features</h3>
449<ul>
450 <li>Report renders anonymous classes with type information (Trac #46).</li>
451 <li><code>enabled</code> property added to <code>agent</code> and
452 <code>coverage</code> Ant tasks (Trac #63).</li>
453 <li>Ant task <code>merge</code> added (Trac #52).</li>
454</ul>
455
456<h3>Fixed Bugs</h3>
457<ul>
458 <li>New <code>IRuntime</code> implementation enables JaCoCo usage for J2EE
459 application servers like Glassfish.</li>
460</ul>
461
462<h3>API Changes</h3>
463<ul>
464 <li>Agent option and Ant task parameter <code>file</code> changed to
465 <code>destfile</code> (Trac #59).</li>
466 <li>Agent option and Ant task parameter <code>merge</code> changed to
467 <code>append</code> (Trac #51).</li>
468</ul>
469
470<h2>Release 0.2.0 (2010/01/08)</h2>
471
472<h3>New Features</h3>
473
474<ul>
475 <li>Simplified probe data structure reduces memory usage (Trac #47).</li>
476 <li>Performance test becomes part of the build.</li>
477 <li>New bundle <code>org.jacoco.agent</code> that provides the Java agent
478 as a resource (Trac #50).</li>
479</ul>
480
481<h3>Fixed Bugs</h3>
482
483<ul>
484 <li><code>ArrayIndexOutOfBoundsException</code> due to inconsistent processing
485 while instrumentation and analysis (Trac #44).</li>
486</ul>
487
488
489<h2>Release 0.1.0 (2009/10/28)</h2>
490
491<p>
492 The very first JaCoCo release.
493</p>
494
495</div>
496<div class="footer">
497 <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span>
498 <a href="license.html">Copyright</a> &copy; @copyright.years@ Mountainminds GmbH &amp; Co. KG and Contributors
499</div>
500
501</body>
502</html>