From d38035b55803d64a739b435a9da8370cf953d9f8 Mon Sep 17 00:00:00 2001
From: Jason van Zyl <jvanzyl@apache.org>
Date: Wed, 19 Oct 2005 18:40:25 +0000
Subject: [PATCH] git-svn-id:
 https://svn.apache.org/repos/asf/maven/components/trunk@326641
 13f79535-47bb-0310-9956-ffa450edef68

---
 maven-site/notes.txt                          |  7 ++
 maven-site/src/site/apt/guides/index.apt      |  2 +
 .../apt/guides/mini/guide-using-modello.apt   | 66 +++++++++++++++++++
 3 files changed, 75 insertions(+)
 create mode 100644 maven-site/src/site/apt/guides/mini/guide-using-modello.apt

diff --git a/maven-site/notes.txt b/maven-site/notes.txt
index aed532556c..7c270448ab 100644
--- a/maven-site/notes.txt
+++ b/maven-site/notes.txt
@@ -29,3 +29,10 @@ Brett Porter wrote:
 - plugin expressions (look at bob allison's work)
 - overriding the central repository (use central)
 - description of what packagings are available and how they work
+- creating upload bundles
+- modello example
+- changing the snapshot policy frequency
+- overriding central repo
+- using POM info in applications: the POM is packaged so there is acccess
+  continuum example to get the version.
+- quick description of scm,wagon,continuum
diff --git a/maven-site/src/site/apt/guides/index.apt b/maven-site/src/site/apt/guides/index.apt
index 6d106dddfd..1377499f08 100644
--- a/maven-site/src/site/apt/guides/index.apt
+++ b/maven-site/src/site/apt/guides/index.apt
@@ -70,6 +70,8 @@ Documentation
 
  * {{{mini/guide-using-extensions.html}Guide to using Extensions}}
 
+ * {{{mini/guide-using-modello.htmlt}Guide to using Modello}}
+
  * {{{mini/guide-webapp.html}Guide to Webapps}}
 
 
diff --git a/maven-site/src/site/apt/guides/mini/guide-using-modello.apt b/maven-site/src/site/apt/guides/mini/guide-using-modello.apt
new file mode 100644
index 0000000000..510f7c39ee
--- /dev/null
+++ b/maven-site/src/site/apt/guides/mini/guide-using-modello.apt
@@ -0,0 +1,66 @@
+ ------
+ Guide to using Modello
+ ------
+ Jason van Zyl
+ ------
+ 12 October 2005
+ ------
+
+Guide to using Modello
+
+ Modello is a tool for generating resources from a simple model. From a simple model you can generate
+ things like:
+
+ * Java sources
+
+ * XML serialization code for the model
+
+ * XML deserialization code for model
+
+ * Model documentation
+
+ * XSD
+
+ * JDO bindings
+
+ []
+
+ A typical modello model looks like the following:
+
+%{snippet|id=modello-model|url=http://svn.apache.org/repos/asf/maven/components/trunk/maven-archetype/maven-archetype-core/src/main/mdo/archetype.mdo}
+
+ To utilize Modello you would configure the <<<maven-modello-plugin>>> something like the following where you want
+ to generate the Java sources for the model, the xpp3 serialization code and the xpp3 deserialization code:
+
++----+
+
+<project>
+  ...
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.codehaus.modello</groupId>
+        <artifactId>modello-maven-plugin</artifactId>
+        <executions>
+          <execution>
+            <goals>
+              <!-- Generate the xpp3 reader code -->
+              <goal>xpp3-reader</goal>
+              <!-- Generate the xpp3 writer code -->
+              <goal>xpp3-writer</goal>
+              <!-- Generate the Java sources for the model itself -->
+              <goal>java</goal>
+            </goals>
+          </execution>
+        </executions>
+        <configuration>
+          <model>src/main/mdo/descriptor.mdo</model>
+          <version>1.0.0</version>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
+  ...
+</project>
+
++----+
\ No newline at end of file