From f796377f4d5f42f6a8453806094e4afef382541b Mon Sep 17 00:00:00 2001
From: ltheussl <ltheussl@13f79535-47bb-0310-9956-ffa450edef68>
Date: Wed, 30 Nov 2005 21:51:28 +0000
Subject: [PATCH] Update documentation

git-svn-id: https://svn.apache.org/repos/asf/maven/maven-1/plugins/trunk@350059 13f79535-47bb-0310-9956-ffa450edef68
---
 pom/xdocs/index.xml      | 11 -----------
 pom/xdocs/validation.xml | 20 ++++++++++++++++----
 2 files changed, 16 insertions(+), 15 deletions(-)

diff --git a/pom/xdocs/index.xml b/pom/xdocs/index.xml
index 0cc0a7a5..037d495f 100644
--- a/pom/xdocs/index.xml
+++ b/pom/xdocs/index.xml
@@ -30,17 +30,6 @@
         This plug-in provides some basic validation and updating mechanisms
         for your POM.
       </p>
-      <p>
-        <strong>WARNING</strong>: for the <code>pom:validate</code> goal
-        to work, your project descriptor (<code>project.xml</code>) has
-        to be at least parsable and well-formed in the first place
-        (chicken or egg?). If your pom is not well-formed, Maven
-        will fail with a (hopefully useful) error message before any
-        plugin starts to work. If you are having problems getting Maven
-        to run, you should try to validate your pom with an independent
-        validation tool first.
-        See <a href="validation.html">Validation</a> for more details.
-      </p>
     </section>
  </body>
 </document>
diff --git a/pom/xdocs/validation.xml b/pom/xdocs/validation.xml
index ef5eae4f..215fe4d9 100644
--- a/pom/xdocs/validation.xml
+++ b/pom/xdocs/validation.xml
@@ -30,7 +30,17 @@
         project descriptor (<code>project.xml</code>, pom) against an xsd
         schema. The general form of a project descriptor can be found
         on the main Maven
-        <a href="http://maven.apache.org/reference/project-descriptor.html">site</a>.
+        <a href="http://maven.apache.org/maven-1.x/reference/project-descriptor.html">site</a>.
+      </p>
+      <p>
+        <strong>WARNING</strong>: for the <code>pom:validate</code> goal
+        to work, your project descriptor (<code>project.xml</code>) has
+        to be at least parsable and well-formed in the first place
+        (chicken or egg?). If your pom is not well-formed, Maven
+        will fail with a (hopefully useful) error message before any
+        plugin starts to work. If you are having problems getting Maven
+        to run, you should try to validate your pom with an independent
+        xml validation tool first.
       </p>
     <subsection name="Required elements">
       <p>
@@ -178,13 +188,15 @@
     </subsection>
     <subsection name="Namespace">
       <p>
-        It is recommended that you include a namespace declaration in your
-        project root:
+        In order to be valid, your <code>project.xml</code> file needs
+        to include a namespace declaration in the project root element:
       </p>
       <source><![CDATA[<project xmlns="http://maven.apache.org/POM/3.0.0">]]></source>
       <p>
-        but this is currently not enforced by the validation routine.
+        or
       </p>
+      <source><![CDATA[<project xmlns="http://maven.apache.org/POM/3.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/3.0.0 http://maven.apache.org/maven-v3_0_0.xsd">]]></source>
     </subsection>
     </section>
  </body>