aboutsummaryrefslogtreecommitdiff
path: root/org.jacoco.doc/docroot
diff options
context:
space:
mode:
authorMirko Friedenhagen <mfriedenhagen@gmail.com>2014-04-17 22:22:47 +0200
committerMirko Friedenhagen <mfriedenhagen@gmail.com>2014-04-17 22:22:47 +0200
commit56afd72d35d6c4b0b150fa6d336f8e0ad215d22a (patch)
tree26f7f17d2ea0889b362679c35838fad660c59a80 /org.jacoco.doc/docroot
parent91e51b560798dd0927a21344b12c1de5a26049f7 (diff)
downloadjacoco-56afd72d35d6c4b0b150fa6d336f8e0ad215d22a.tar.gz
Document that tests *must* be executed in a forked VM with Maven
as otherwise the `javaagent` is not set and no execution data will be recorded.
Diffstat (limited to 'org.jacoco.doc/docroot')
-rw-r--r--org.jacoco.doc/docroot/doc/maven.html10
1 files changed, 10 insertions, 0 deletions
diff --git a/org.jacoco.doc/docroot/doc/maven.html b/org.jacoco.doc/docroot/doc/maven.html
index 99673e38..8e786c5d 100644
--- a/org.jacoco.doc/docroot/doc/maven.html
+++ b/org.jacoco.doc/docroot/doc/maven.html
@@ -31,6 +31,16 @@
be compiled with debug information.
</p>
+<p class="hint">
+ When using the <tt>maven-surefire-plugin</tt> or <tt>maven-failsafe-plugin</tt>
+ you <b>must not</b> use a
+ <a href="http://maven.apache.org/surefire/maven-surefire-plugin/test-mojo.html#forkCount">
+ <tt>forkCount</tt></a> of <tt>0</tt> or set the
+ <a href="http://maven.apache.org/surefire/maven-surefire-plugin/test-mojo.html#forkMode">
+ <tt>forkMode</tt></a> to <tt>never</tt> as this would prevent the execution of
+ the tests with the <tt>javaagent</tt> set and no coverage would be recorded.
+</p>
+
<h2>Example</h2>
<ul>