From 503ecc43c3f89d73c3978e1fa2abb5c7fcfd854c Mon Sep 17 00:00:00 2001
From: Herve Boutemy <hboutemy@apache.org>
Date: Thu, 17 May 2012 11:00:27 +0000
Subject: [PATCH] don't generate code from plugin.mdo model since code is not
 used (nor included in artifact's jar), but javadoc may confuse users

git-svn-id: https://svn.apache.org/repos/asf/maven/maven-3/trunk@1339549 13f79535-47bb-0310-9956-ffa450edef68
---
 maven-plugin-api/pom.xml                 | 20 ++++++++++----------
 maven-plugin-api/src/main/mdo/plugin.mdo |  2 ++
 2 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/maven-plugin-api/pom.xml b/maven-plugin-api/pom.xml
index e2c24a2098..8e3bb144f5 100644
--- a/maven-plugin-api/pom.xml
+++ b/maven-plugin-api/pom.xml
@@ -62,19 +62,19 @@ under the License.
         <configuration>
           <models>
             <model>src/main/mdo/lifecycle.mdo</model>
-            <model>src/main/mdo/plugin.mdo</model>
           </models>
           <version>1.0.0</version>
         </configuration>
-      </plugin>
-      <plugin>
-        <artifactId>maven-jar-plugin</artifactId>
-        <configuration>
-         <excludes>
-           <exclude>org/apache/maven/plugin/descriptor/model</exclude>
-           <exclude>org/apache/maven/plugin/descriptor/model/**/*</exclude>
-         </excludes>
-        </configuration>
+        <executions>
+          <execution>
+            <id>site-docs</id>
+            <configuration>
+              <models combine.children="append">
+                <model>src/main/mdo/plugin.mdo</model><!-- plugin.mdo is only for documentation, not used for code generation -->
+              </models>
+            </configuration>
+          </execution>
+        </executions>
       </plugin>
     </plugins>
   </build>
diff --git a/maven-plugin-api/src/main/mdo/plugin.mdo b/maven-plugin-api/src/main/mdo/plugin.mdo
index 5af6aca4fc..764955777a 100644
--- a/maven-plugin-api/src/main/mdo/plugin.mdo
+++ b/maven-plugin-api/src/main/mdo/plugin.mdo
@@ -27,6 +27,8 @@ under the License.
     Plugin descriptor, stored in <code>META-INF/maven/plugin.xml</code> in a plugin's jar artifact.
     This descriptor is generally generated from plugin sources, using
     <a href="/plugins/maven-plugin-plugin/">maven-plugin-plugin</a>.
+    <i>Notice:</i> this documentation is generated from a Modello model but the code executed is not generated
+    from this descriptor. Please report if you find anything wrong.
   ]]></description>
   <defaults>
     <default>