svn commit: r1643694 - /maven/shared/trunk/maven-reporting-impl/src/site/apt/index.apt.vm

[hb...@apache.org]

Author: hboutemy
Date: Sun Dec  7 16:30:47 2014
New Revision: 1643694

URL: http://svn.apache.org/r1643694
Log:
updated explanations on Doxia dependency

Modified:
    maven/shared/trunk/maven-reporting-impl/src/site/apt/index.apt.vm

Modified: maven/shared/trunk/maven-reporting-impl/src/site/apt/index.apt.vm
URL: http://svn.apache.org/viewvc/maven/shared/trunk/maven-reporting-impl/src/site/apt/index.apt.vm?rev=1643694&r1=1643693&r2=1643694&view=diff
==============================================================================
--- maven/shared/trunk/maven-reporting-impl/src/site/apt/index.apt.vm (original)
+++ maven/shared/trunk/maven-reporting-impl/src/site/apt/index.apt.vm Sun Dec  7 16:30:47 2014
@@ -56,9 +56,15 @@ ${project.name}
 
 ** Doxia dependency
 
-  <<<maven-reporting-impl 2.0.x>>> use Doxia 1.0, then is used for reporting plugins wanting Maven 2.0.x compatibility.
+  When used as report during site generation, Doxia implementation is provided by <<<maven-site-plugin>>>, independently
+  from Doxia version used during plugin compilation.
+
+  When used as a direct standalone goal invocation, Doxia implementation used is the version used during plugin compilation.
 
-  <<<maven-reporting-impl 2.1.x>>> use Doxia 1.1: using this version implies for a reporting plugin that it has Maven 2.1
-  as prerequisite.
+  <<<maven-reporting-impl 2.0.x>>> use Doxia 1.0, then is used for reporting plugins wanting Maven 2.0.x compatibility.
 
-  <<<maven-reporting-impl 2.2.x>>> use Doxia 1.2.
+  Starting with <<<maven-reporting-impl 2.1>>>, Doxia version used is 1.1 or more. When creating a reporting plugin,
+  take care to use corresponding <<<doxia-sink-api>>>, and avoid <<<doxia-sink-api>>> version 1.0 that can be
+  imported by <<<{{{../maven-reporting-api/}maven-reporting-api}}>>> 3.0: this would lead to
+  <<<"java.lang.ClassNotFoundException: org.apache.maven.doxia.sink.SinkEventAttributes">>> when used as direct standalone
+  goal.