explanations precision
git-svn-id: https://svn.apache.org/repos/asf/maven/shared/trunk@1598306 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/main/java/org/apache/maven/reporting/exec/MavenReportExecution.java b/src/main/java/org/apache/maven/reporting/exec/MavenReportExecution.java
index 7731755..2c2dfcb 100644
--- a/src/main/java/org/apache/maven/reporting/exec/MavenReportExecution.java
+++ b/src/main/java/org/apache/maven/reporting/exec/MavenReportExecution.java
@@ -24,8 +24,8 @@
/**
* <p>
- * Since Maven 3, reporting plugin {@link MavenReport} are not anymore prepared by Maven core.
- * This class will store all necessary information for {@link MavenReport} generation:
+ * Since Maven 3, reporting plugins (ie {@link MavenReport}s) are not anymore prepared by Maven core.
+ * This class will store all necessary information for later {@link MavenReport} generation/execution:
* <ul>
* <li>a {@link MavenReport},</li>
* <li>the goal name associated to the report,</li>
@@ -34,11 +34,12 @@
* </ul>
* </p>
* <p>
- * With this, it's possible to execute the {@link MavenReport#generate(org.codehaus.doxia.sink.Sink, java.util.Locale)}
- * method, setting the current {@link Thread} classLoader first with {@link #classLoader}
+ * With this bean, a plugin wanting to generate a report (= <i>"execute"</i> the report) has to call the
+ * {@link MavenReport#generate(org.codehaus.doxia.sink.Sink, java.util.Locale)}
+ * method, setting the current {@link Thread} classLoader first with {@link #classLoader}.
* </p>
* <p>
- * This bean will be instantiated by {@link MavenReportExecutor}.
+ * This bean is instantiated by {@link MavenReportExecutor}.
* </p>
*
* @author Olivier Lamy
diff --git a/src/main/java/org/apache/maven/reporting/exec/MavenReportExecutor.java b/src/main/java/org/apache/maven/reporting/exec/MavenReportExecutor.java
index 7289930..c2fdc92 100644
--- a/src/main/java/org/apache/maven/reporting/exec/MavenReportExecutor.java
+++ b/src/main/java/org/apache/maven/reporting/exec/MavenReportExecutor.java
@@ -25,11 +25,11 @@
import org.apache.maven.reporting.MavenReport;
/**
- * This component will execute (prepare) {@link MavenReport}s for later generation.
+ * This component will prepare {@link MavenReport}s for later generation.
* If a {@link MavenReport} needs to fork a goal or a lifecycle phase, this fork is executed.
* <p>Notice that Maven Reports are classical {@link org.apache.maven.plugin.Mojo Mojos} implementing
* the {@link MavenReport} interface: when used as reports, their <code>Mojo.execute()</code> method is
- * not used.</p>
+ * not to be used but <code>MavenReport.generate()</code>.</p>
*
* @author Olivier Lamy
*/
@@ -39,7 +39,7 @@
* Build the {@link MavenReport}s, with associated forked executions if necessary.
*
* @param mavenReportExecutorRequest
- * @return Maven report execution results
+ * @return a list or prepared Maven report executions
* @throws MojoExecutionException
*/
List<MavenReportExecution> buildMavenReports( MavenReportExecutorRequest mavenReportExecutorRequest )
diff --git a/src/site/apt/index.apt.vm b/src/site/apt/index.apt.vm
index 83dafae..48fef7c 100644
--- a/src/site/apt/index.apt.vm
+++ b/src/site/apt/index.apt.vm
@@ -28,7 +28,7 @@
${project.name}
- Classes to manage report plugin executions with Maven 3, through
+ Classes to prepare report plugins execution 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