Return-Path: 
 <commits-return-46702-apmail-maven-commits-archive=maven.apache.org@maven.apache.org>
X-Original-To: apmail-maven-commits-archive@www.apache.org
Delivered-To: apmail-maven-commits-archive@www.apache.org
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by minotaur.apache.org (Postfix) with SMTP id 982E21066F
	for <apmail-maven-commits-archive@www.apache.org>;
 Sat, 13 Apr 2013 20:18:45 +0000 (UTC)
Received: (qmail 83729 invoked by uid 500); 13 Apr 2013 20:18:45 -0000
Delivered-To: apmail-maven-commits-archive@maven.apache.org
Received: (qmail 83688 invoked by uid 500); 13 Apr 2013 20:18:45 -0000
Mailing-List: contact commits-help@maven.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:commits-help@maven.apache.org>
List-Unsubscribe: <mailto:commits-unsubscribe@maven.apache.org>
List-Post: <mailto:commits@maven.apache.org>
List-Id: <commits.maven.apache.org>
Reply-To: dev@maven.apache.org
Delivered-To: mailing list commits@maven.apache.org
Received: (qmail 83681 invoked by uid 99); 13 Apr 2013 20:18:45 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 13 Apr 2013 20:18:45 +0000
X-ASF-Spam-Status: No, hits=-2000.0 required=5.0
	tests=ALL_TRUSTED
X-Spam-Check-By: apache.org
Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4)
    by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 13 Apr 2013 20:18:44 +0000
Received: from eris.apache.org (localhost [127.0.0.1])
	by eris.apache.org (Postfix) with ESMTP id 9B74023888E4;
	Sat, 13 Apr 2013 20:18:24 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Subject: svn commit: r1467693 -
 /maven/shared/trunk/maven-reporting-exec/src/site/apt/index.apt
Date: Sat, 13 Apr 2013 20:18:24 -0000
To: commits@maven.apache.org
From: hboutemy@apache.org
X-Mailer: svnmailer-1.0.8-patched
Message-Id: <20130413201824.9B74023888E4@eris.apache.org>
X-Virus-Checked: Checked by ClamAV on apache.org

Author: hboutemy
Date: Sat Apr 13 20:18:24 2013
New Revision: 1467693

URL: http://svn.apache.org/r1467693
Log:
improved documentation

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

Modified: maven/shared/trunk/maven-reporting-exec/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/maven/shared/trunk/maven-reporting-exec/src/site/apt/index.apt?rev=1467693&r1=1467692&r2=1467693&view=diff
==============================================================================
--- maven/shared/trunk/maven-reporting-exec/src/site/apt/index.apt (original)
+++ maven/shared/trunk/maven-reporting-exec/src/site/apt/index.apt Sat Apr 13 20:18:24 2013
@@ -3,17 +3,18 @@
  -----
  Hervé Boutemy
  -----
- 2011-07-06
+ 2013-04-13
  -----
 
 Maven Reporting Executor
 
-  Classes to manage report plugin executions with Maven 3.
-
-  Report plugins can be configured in <<<\<configuration\>>>> element of <<<maven-site-plugin>>> or any other
+  Classes to manage report plugin executions with Maven 3, through
+  {{{./apidocs/org/apache/maven/reporting/exec/MavenReportExecutor.html}MavenReportExecutor}}
+  ({{{./apidocs/org/apache/maven/reporting/exec/DefaultMavenReportExecutor.html}implementation}}):
+  report plugins can be configured in <<<\<configuration\>>>> element of <<<maven-site-plugin>>> or any other
   report building plugin with following XML model:
 
-+----
++----+
 <reportPlugins>
   <plugin>
     <groupId/>
@@ -30,10 +31,29 @@ Maven Reporting Executor
     </reportSets>
   </plugin>
 </reportPlugins>
-+----
++----+
+
+  Notice this is the model from plugins in
+  {{{/ref/current/maven-model/maven.html#class_reporting}<<<\<reporting\>>>> section of POM}}:
+
+  [[a]] without <<<\<inherited\>>>> element,
+  
+  [[b]] without support for reporting plugins configuration inheritance (see {{{http://jira.codehaus.org/browse/MSITE-484}MSITE-484}}),
+
+  [[c]] with additional <<<\<reports\>>>> list outside <<<\<reportSet\>>>> that simplifies reports configuration in usual cases,
+
+  [[d]] with support for report plugins without explicit version: version is determed by
+
+    [[1]] searching similar (same groupId and artifactId) mojo in the build/plugins section of the pom,
+ 
+    [[2]] searching similar (same groupId and artifactId) mojo in the build/pluginManagement section of the pom,
+
+    [[3]] asking {{{/ref/current/maven-core/apidocs/org/apache/maven/plugin/version/PluginVersionResolver.html}PluginVersionResolver}}
+    to get a fallback version and display a warning as it's not a recommended use.
+
+    []
 
-  Notice: this is the model from plugins in <<<\<reporting\>>>> section of POM without <<<\<inherited\>>>> element
-  and with immediate <<<\<reports\>>>> list (ie not in <<<\<reportSet\>>>>) that simplifies reports configuration in usual cases.
+  []
 
   Maven 3 core makes an automatic transformation of <<<\<reporting\>>>> POM section to <<<maven-site-plugin>>>
   configuration through the