MNG-1997: document xsd support for pom and settings in guides

o added documentation

git-svn-id: https://svn.apache.org/repos/asf/maven/components/trunk@471193 13f79535-47bb-0310-9956-ffa450edef68

maven-settings/settings.mdo

@@ -4,10 +4,15 @@
   <id>settings</id>
   <name>Settings</name>
   <description><![CDATA[
-    User-specific configuration for maven. Includes things that should not 
-    be distributed with the pom.xml file, such as developer identity, along with 
-    local settings, like proxy information. The default location for the
-    settings file is ~/.m2/settings.xml]]></description>
+    <p>This is a reference for the user-specific configuration for Maven.</p>
+    <p>Includes things that should not be distributed with the pom.xml file, such as developer identity, along with
+    local settings, like proxy information.</p>
+    <p>The default location for the settings file is <i>~/.m2/settings.xml</i></p>
+    <p>An XSD is available at:</p>
+    <ul>
+      <li><a href="http://maven.apache.org/xsd/settings-1.0.0.xsd">http://maven.apache.org/xsd/settings-1.0.0.xsd</a>.</li>
+    </ul>
+    ]]></description>
   <defaults>
     <default>
       <key>package</key>

maven-settings/src/site/apt/index.apt

@@ -0,0 +1,19 @@
+ -----
+ Maven Settings
+ -----
+ Vincent Siveton
+ -----
+ 04 November 2006
+ -----
+
+Maven Settings Model
+ 
+ This is strictly the model for Maven settings.
+
+ The following are generated from this model:
+
+   * {{{apidocs/index.html}Java sources}} with Reader and Writers for the Xpp3 XML parser
+
+   * A {{{settings.html}Descriptor Reference}}
+
+   * An {{{ http://maven.apache.org/xsd/settings-1.0.0.xsd}XSD}}