Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / jacoco / 3ff8899bdee54f39ab728acf3bd97b5dfee7baad / . / org.jacoco.doc / docroot / doc / changes.html
blob: 683cb6ebf3e57b7497939f292e4cfe047ecdd5af [file] [log] [blame]
Marc R. Hoffmanne571f3f2012-05-13 12:18:02 +0000[diff] [blame]1<?xml version="1.0" encoding="UTF-8" ?>
Evgeny Mandrikov82a92ca2012-01-15 20:25:48 +0000[diff] [blame]2<!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 +0000[diff] [blame]5 <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 +0000[diff] [blame]7 <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
Marc R. Hoffmann871836b2012-05-12 12:28:13 +0000[diff] [blame]21<h2>Trunk Build @qualified.bundle.version@ (@build.date@)</h2>
22
Marc R. Hoffmanncf41fc12012-06-30 00:15:43 +0000[diff] [blame]23<h3>New Features</h3>
24<ul>
25 <li>Support for parallel Maven builds (Trac #191).</li>
26 <li>New agent option <code>classdumpdir</code> to dump all class files seen
27 by the JaCoCo agent to disk. This option is also available for Ant and
28 Maven (Trac #208).</li>
29</ul>
30
Marc R. Hoffmann78309272012-05-02 19:25:44 +0000[diff] [blame]31<h3>Non-functional Changes</h3>
32<ul>
Marc R. Hoffmann871836b2012-05-12 12:28:13 +0000[diff] [blame]33 <li>Documentation now includes Maven example and Maven goal documentation
34 (Trac #201, #202).</li>
Marc R. Hoffmann783aa632012-06-20 20:26:20 +0000[diff] [blame]35 <li>Reworked instrumentation strategy to avoid verifier error "Uninitialized
36 object exists on backward branch" with certain Java 7 class files
37 (Trac #154).</li>
Marc R. Hoffmann78309272012-05-02 19:25:44 +0000[diff] [blame]38</ul>
39
Evgeny Mandrikov976a90f2012-04-19 03:40:42 +0000[diff] [blame]40<h2>Release 0.5.7 (2012/04/19)</h2>
Evgeny Mandrikov022e3af2012-01-23 23:39:12 +0000[diff] [blame]41
Marc R. Hoffmann2a363b82012-03-31 10:00:06 +0000[diff] [blame]42<h3>New Features</h3>
43<ul>
44 <li>Support for class redefinitions by other agents like JMockit (SF #3509409).</li>
Marc R. Hoffmannc17f2b02012-04-07 09:05:00 +0000[diff] [blame]45 <li>Remove class file attributes with invalid code offsets caused by other
Marc R. Hoffmannc32282c2012-04-18 21:04:59 +0000[diff] [blame]46 byte code processing tools to avoid verifier errors (Trac #196).</li>
47 <li>Improved logging for Ant tasks (SF #3518429).</li>
Marc R. Hoffmann2a363b82012-03-31 10:00:06 +0000[diff] [blame]48</ul>
49
Marc R. Hoffmannce117fd2012-03-29 12:55:41 +0000[diff] [blame]50<h3>Fixed Bugs</h3>
51<ul>
52 <li>In case of failures the agent should log the original exception.</li>
53</ul>
54
Evgeny Mandrikov99487a12012-01-23 23:33:12 +0000[diff] [blame]55<h2>Release 0.5.6 (2012/01/23)</h2>
Evgeny Mandrikov82a92ca2012-01-15 20:25:48 +0000[diff] [blame]56
57<h3>New Features</h3>
58<ul>
59 <li>jacoco-maven-plugin can be used together with maven-site-plugin (Trac #181).</li>
Marc R. Hoffmann8b5d6a32012-01-18 20:24:45 +0000[diff] [blame]60 <li>The <code>report</code> Ant task now also supports directory resources to
61 specify source folders. This allows reading source files from multiple
62 directories. Contributed by Dominik Stadler (Trac #119).</li>
Evgeny Mandrikov82a92ca2012-01-15 20:25:48 +0000[diff] [blame]63</ul>
64
65<h3>Fixed Bugs</h3>
66<ul>
67 <li>Don't insert stackmap frames for class files before version 1.6.</li>
68 <li>Regression, which was introduced in 0.5.4 - restored compatibility of jacoco-maven-plugin with Maven 2 (Trac #182).</li>
69</ul>
70
71<h2>Release 0.5.5 (2011/12/15)</h2>
72
73<h3>Fixed Bugs</h3>
74<ul>
75 <li>Correct default value for the <code>append</code> property of the
76 <code>dump</code> Ant task is <code>true</code> (Trac #178).</li>
77 <li>Try/catch blocks must not be counted as instructions (Trac #179).</li>
78</ul>
79
80<h3>Non-functional Changes</h3>
81<ul>
82 <li>Upgrade to ASM 3.3.1.</li>
83</ul>
84
85<h2>Release 0.5.4 (2011/11/11)</h2>
86
87<h3>New Features</h3>
88<ul>
89 <li>Maven plug-in: respect <code>includes</code> and <code>excludes</code>
Evgeny Mandrikov8e7d6992011-11-11 20:26:38 +0000[diff] [blame]90 properties in report Mojo (Trac #160).
91 <p>
92 Also note that:
93<pre class="source lang-xml">
94&lt;configuration&gt;
95 &lt;includes&gt;org.foo.*:org.bar.*&lt;/includes&gt;
96 &lt;excludes&gt;com.foo.*:com.bar.*&lt;/excludes&gt;
97&lt;/configuration&gt;
98</pre>
99 must be replaced on:
100<pre class="source lang-xml">
101&lt;configuration&gt;
102 &lt;includes&gt;
103 &lt;include>org.foo.*&lt;/include&gt;
104 &lt;include>org.bar.*&lt;/include&gt;
105 &lt;/includes&gt;
106 &lt;excludes&gt;
107 &lt;exclude&gt;com.foo.*&lt;/exclude&gt;
108 &lt;exclude&gt;com.bar.*&lt;/exclude&gt;
109 &lt;/excludes&gt;
110&lt;/configuration&gt;
111</pre>
112 </p>
Evgeny Mandrikov82a92ca2012-01-15 20:25:48 +0000[diff] [blame]113 </li>
114</ul>
115
116<h3>API Changes</h3>
117<ul>
118 <li><code>Instrumenter</code> now only requires
119 <code>IExecutionDataAccessorGenerator</code> instead of
120 <code>IRuntime</code> (Trac #174).</li>
121 <li>Removed reference to internal implementation classes from
122 <code>CoverageBuilder</code> API.</li>
123</ul>
124
125<h3>Non-functional Changes</h3>
126<ul>
127 <li>Release bundles from now on signed again.</li>
128 <li>Several documentation updates.</li>
129</ul>
130
131<h2>Release 0.5.3 (2011/07/06)</h2>
132
133<h3>New Features</h3>
134<ul>
135 <li>New Maven plug-in for JaCoCo agent setup and basic reporting (Trac #25).</li>
136 <li>Additional output mode implementation for JaCoCo agent based on JMX.</li>
137</ul>
138
139<h3>Fixed Bugs</h3>
140<ul>
141 <li>Fixed problem with reporting of nested group structures (Trac #157).</li>
142</ul>
143
144<h3>Non-functional Changes</h3>
145<ul>
146 <li>JaCoCo build based on Maven (Trac #136).</li>
147 <li>JaCoCo published to Maven repository (Trac #149).</li>
148</ul>
149
150<h2>Release 0.5.2 (2011/05/19)</h2>
151
152<h3>New Features</h3>
153<ul>
154 <li>JaCoCo reports cyclomatic complexity numbers (Trac #129).</li>
155 <li>For HTML reports the tab width can be specified on the
156 <code>sourcefiles</code> attribute of the <code>report</code> Ant task
157 (Track #152).</li>
158</ul>
159
160<h3>Fixed Bugs</h3>
161<ul>
162 <li>Removed duplicate counters in the root node of XML reports (Trac #155).</li>
163 <li>Avoid <code>StackOverflowException</code> when analyzing methods with very
164 long instruction sequences (Trac #156). Many thanks to Jean-Eric Cuendet
165 for reporting and analyzing this!</li>
166</ul>
167
168<h3>API Changes</h3>
169<ul>
170 <li><code>ICoverageNode</code> API has been extended for cyclomatic
171 complexity (Trac #129).</li>
172 <li>XML and CSV report includes new counter type <code>COMPLEXITY</code>
173 (Trac #129).</li>
174 <li>New method <code>getTabWidth()</code> in callback interface
175 <code>ISourceFileLocator</code> instead of
176 <code>HTMLReportFormatter.setTabWidth()</code> which has been removed.
177 (Trac #152).</li>
178</ul>
179
180<h2>Release 0.5.1 (2011/03/21)</h2>
181
182<h3>New Features</h3>
183<ul>
184 <li>Duplicate classes with identical identifiers are now ignored during
185 analysis.</li>
186 <li>Added support for TestNG to Ant task Coverage (Track #144).</li>
187</ul>
188
189<h3>Fixed Bugs</h3>
190<ul>
191 <li>Calculate correct stackmap frames for Java 1.6 branches (Trac #139).</li>
192 <li>Link source files also for classes in default package (Trac #151).</li>
193</ul>
194
195<h3>Non-functional Changes</h3>
196<ul>
197 <li>API documentation cleanup (Track #140).</li>
198 <li>Removed obsolete examples from documentation (Trac #141).</li>
199 <li>Added reporting API example (Trac #146).</li>
200 <li>Reduced file size of HTML report source pages (Trac #148).</li>
201</ul>
202
203<h3>API Changes</h3>
204<ul>
205 <li>Simplified reporting API (Trac #53).</li>
206 <li>Use colon as separator character in agent parameters (Trac #143).</li>
207 <li>Now also empty files are accepted as <code>*.exec</code> files (Trac #150).</li>
208</ul>
209
210<h2>Release 0.5.0 (2011/01/19)</h2>
211
212<h3>New Features</h3>
213<ul>
214 <li>JaCoCo now reports branch coverage (Track #66).</li>
215</ul>
216
217<h3>Fixed Bugs</h3>
218<ul>
219 <li>Only process actual Java class files during analysis (SF #3106102).</li>
220 <li>Fix broken source links due to sort hash (Track #125).</li>
221 <li>Fixed invalid OSGi headers in MANIFEST.MF files (Track #127).</li>
222 <li>Try to avoid interference with Hibernate (SF #3134190).</li>
223 <li>Provide proper error message in case of duplicate class names in the same
224 group (SF #3110219).</li>
225 <li>Allow any number of probes in static interface initializers (SF #3161106).</li>
226</ul>
227
228<h3>API Changes</h3>
229<ul>
230 <li>All analysis specific APIs have been moved to package
231 <code>org.jacoco.core.analysis</code>.</li>
232 <li>The <code>IStructureVisitor</code> interface has been replaced by a
233 simplified version called <code>ICoverageVisitor</code> (Track #132).</li>
234 <li>All counter creation and update APIs now accept <i>missed items</i> and
235 <i>covered items</i> as parameters (Track #131).</li>
236 <li>Instructions are now counted on a per line basis. Therefore some
237 interfaces in the <code>org.jacoco.core.analysis</code> package have
238 changed as well as the <code>line</code> element in the XML report
239 (Track #130).</li>
240 <li>Several internal implementation classes have removed from the core APIs or
241 have been replaced by new interfaces (Track #133).</li>
242</ul>
243
244<h2>Release 0.4.1 (2010/10/07)</h2>
245
246<h3>New Features</h3>
247<ul>
248 <li>New attribute <code>line</code> for <code>method</code> elements in the
249 XML report containing the first source line number of the method.
250 (Track #120).</li>
251 <li>Optional <code>locale</code> attribute for number rendering HTML reports,
252 also available as an attribute of the <code>html</code> tag of the
253 <code>report</code> Ant task (Track #122).</li>
254 <li>Coverage tables in HTML report are now sortable (Track #98).</li>
255 <li>The <code>report</code> Ant task issues a warning if source files are
256 provided but class files do not contain debug information to collect line
257 numbers (SF #3024486).</li>
258</ul>
259
260<h3>Non-functional Changes</h3>
261<ul>
262 <li>Reduced memory footprint for coverage data by 30% (Track #106).</li>
263 <li>Moved to Eclipse 3.6.x as development environment (Trac #115).</li>
264 <li>All delivered bundles and JAR files are signed (Trac #118).</li>
265</ul>
266
267<h3>Fixed Bugs</h3>
268<ul>
269 <li>Better error message when multiple JaCoCo agents are specified
270 (Track #103).</li>
271 <li>Fixed potential NPE at shutdown when running agent in
272 <code>tcpserver</code> mode (Track #117).</li>
273 <li>Agent now fails at startup when execution data file can't be opened
274 (Track #121).</li>
275</ul>
276
277<h2>Release 0.4.0 (2010/06/04)</h2>
278
279<h3>New Features</h3>
280<ul>
281 <li>Execution data now includes session information: an arbitrary identifier,
282 the start time and dump time (Trac #88).</li>
283 <li>Added session information to XML report (Trac #92).</li>
284 <li>New "Sessions" page in the HTML report shows information about each
285 sessions wherein execution data has been collected for the report
286 (Trac #93). Additionally all classes with execution data available are
287 listed on this page (Trac #94).</li>
288 <li>The agent now supports remote dumps via TCP/IP connections (Trac #82).</li>
289 <li>New Ant task <code>dump</code> to remotely collect coverage data from
290 agents (Trac #100).</li>
291</ul>
292
293<h3>API Changes</h3>
294<ul>
295 <li>Execution data file header is written and read in any case (Trac #72).</li>
296 <li>Added <code>dumponexit</code> to agent options (Trac #82).</li>
297 <li>Added <code>sessionid</code> to agent options (Trac #88).</li>
298 <li>Added <code>output, address and port</code> to agent options (Trac #82).</li>
299 <li>Additional and modified methods in <code>IRuntime</code> to produce
300 session information (Trac #88).</li>
301 <li>Coverage element type <code>SESSION</code> removed (Trac #95).</li>
302 <li>Removed several internal APIs from package
303 <code>org.jacoco.core.instr</code> used for class instrumentation.</li>
304 <li>Renamed class <code>org.jacoco.report.csv.CsvFormatter</code> to
305 <code>CSVFormatter</code> (upper case) for consistency with other
306 formatters.</li>
307</ul>
308
309<h2>Release 0.3.3 (2010/04/19)</h2>
310
311<h3>New Features</h3>
312<ul>
313 <li>Support for different archives (jar, war, ear etc.) and nested archives
314 (Trac #78).</li>
315 <li>XML report with line level coverage information (requested for Sonar).</li>
316</ul>
317
318<h3>Fixed Bugs</h3>
319<ul>
320 <li>Correct stackmap frames for Java 1.6 class files. (Track #81).</li>
321 <li>Avoid usage of <code>LocalVariableSorter</code> due to ASM bug #314563
322 (Track #69).</li>
323 <li>Nested Java/JUnit Ant tasks not being executed when coverage task disabled. (Track #85).</li>
324</ul>
325
326<h2>Release 0.3.2 (2010/04/01)</h2>
327
328<h3>New Features</h3>
329<ul>
330 <li>New HTML report option to directly create a zip file containing the report
331 (Trac #12).</li>
332 <li>Code coverage for static initializers in interfaces (Trac #21).</li>
333 <li>Better error handling for <code>report</code> Ant task (Trac #71).</li>
334 <li>Classes without instructions are excluded from reports (Trac #73).</li>
335</ul>
336
337<h3>Fixed Bugs</h3>
338<ul>
339 <li>XML and CSV report output now also works for structures without groups
340 (Track #76).</li>
341</ul>
342
343<h3>API Changes</h3>
344<ul>
345 <li>Consistent usage of the term "Missed" instead of "NotCovered" in all APIs
346 (Trac #72).</li>
347 <li>To support "off-line" instrumentation scenarios it is not required any
348 more to register instrumented classes with the runtime (Trac #74).</li>
349</ul>
350
351<h2>Release 0.3.1 (2010/02/09)</h2>
352
353<h3>Fixed Bugs</h3>
354<ul>
355 <li>Ant tasks broken on Linux (Trac #68).</li>
356</ul>
357
358<h2>Release 0.3.0 (2010/02/02)</h2>
359
360<h3>New Features</h3>
361<ul>
362 <li>Report renders anonymous classes with type information (Trac #46).</li>
363 <li><code>enabled</code> property added to <code>agent</code> and
364 <code>coverage</code> Ant tasks (Trac #63).</li>
365 <li>Ant task <code>merge</code> added (Trac #52).</li>
366</ul>
367
368<h3>Fixed Bugs</h3>
369<ul>
370 <li>New <code>IRuntime</code> implementation enables JaCoCo usage for J2EE
371 application servers like Glassfish.</li>
372</ul>
373
374<h3>API Changes</h3>
375<ul>
376 <li>Agent option and Ant task parameter <code>file</code> changed to
377 <code>destfile</code> (Trac #59).</li>
378 <li>Agent option and Ant task parameter <code>merge</code> changed to
379 <code>append</code> (Trac #51).</li>
380</ul>
381
382<h2>Release 0.2.0 (2010/01/08)</h2>
383
384<h3>New Features</h3>
385
386<ul>
387 <li>Simplified probe data structure reduces memory usage (Trac #47).</li>
388 <li>Performance test becomes part of the build.</li>
389 <li>New bundle <code>org.jacoco.agent</code> that provides the Java agent
390 as a resource (Trac #50).</li>
391</ul>
392
393<h3>Fixed Bugs</h3>
394
395<ul>
396 <li><code>ArrayIndexOutOfBoundsException</code> due to inconsistent processing
397 while instrumentation and analysis (Trac #44).</li>
398</ul>
399
400
401<h2>Release 0.1.0 (2009/10/28)</h2>
402
403<p>
404 The very first JaCoCo release.
405</p>
406
407</div>
408<div class="footer">
409 <span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span>
410 <a href="license.html">Copyright</a> &copy; @copyright.years@ Mountainminds GmbH &amp; Co. KG and Contributors
411</div>
412
413</body>
414</html>