commit b0c293e6b32f5ef31f98c1faaa09a6c5da6bbaa8
author Evgeny Mandrikov <Godin@users.noreply.github.com> Sun Jun 05 18:47:35 2016 +0200
committer Marc R. Hoffmann <hoffmann@mountainminds.com> Sun Jun 05 18:47:35 2016 +0200
tree 6041a3252fd1828f1f81339ea76303fc9cdc95cb
parent 8e73ea6aa7ba38a596f60e2180c8c4406c658dc5

Add note about explicit selection of non-aggregate reports (#420)

org.jacoco.doc/docroot/doc/maven.html

diff --git a/org.jacoco.doc/docroot/doc/maven.html b/org.jacoco.doc/docroot/doc/maven.html
index 52fee00..af7d126 100644
--- a/org.jacoco.doc/docroot/doc/maven.html
+++ b/org.jacoco.doc/docroot/doc/maven.html
@@ -103,6 +103,33 @@
 mvn help:describe -Dplugin=org.jacoco:jacoco-maven-plugin -Ddetail
 </pre>
 
+<p>
+  Usage of plugin together with <tt>maven-site-plugin</tt> without
+  <a href="https://maven.apache.org/plugins/maven-site-plugin/examples/configuring-reports.html#Selecting_Reports_from_a_Plugin:_Configuring_Report_Sets">explicit selection of reports</a>
+  might lead to generation of redundant aggregate reports.
+  Specify <tt>reportSets</tt> explicitly to avoid this:
+</p>
+<pre class="source lang-xml linenums">
+&lt;project&gt;
+  &lt;reporting&gt;
+    &lt;plugins&gt;
+      &lt;plugin&gt;
+        &lt;groupId&gt;org.jacoco&lt;/groupId&gt;
+        &lt;artifactId&gt;jacoco-maven-plugin&lt;/artifactId&gt;
+        &lt;reportSets&gt;
+          &lt;reportSet&gt;
+            &lt;reports&gt;
+              &lt;!-- select non-aggregate reports --&gt;
+              &lt;report&gt;report&lt;/report&gt;
+            &lt;/reports&gt;
+          &lt;/reportSet&gt;
+        &lt;/reportSets&gt;
+      &lt;/plugin&gt;
+    &lt;/plugins&gt;
+  &lt;/reporting&gt;
+&lt;/project&gt;
+</pre>
+
 <h2>Goals</h2>
 
 <p>