maven-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ltheu...@apache.org
Subject svn commit: r350059 - in /maven/maven-1/plugins/trunk/pom/xdocs: index.xml validation.xml
Date Wed, 30 Nov 2005 21:51:31 GMT
Author: ltheussl
Date: Wed Nov 30 13:51:28 2005
New Revision: 350059

URL: http://svn.apache.org/viewcvs?rev=350059&view=rev
Log:
Update documentation

Modified:
    maven/maven-1/plugins/trunk/pom/xdocs/index.xml
    maven/maven-1/plugins/trunk/pom/xdocs/validation.xml

Modified: maven/maven-1/plugins/trunk/pom/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/maven/maven-1/plugins/trunk/pom/xdocs/index.xml?rev=350059&r1=350058&r2=350059&view=diff
==============================================================================
--- maven/maven-1/plugins/trunk/pom/xdocs/index.xml (original)
+++ maven/maven-1/plugins/trunk/pom/xdocs/index.xml Wed Nov 30 13:51:28 2005
@@ -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>

Modified: maven/maven-1/plugins/trunk/pom/xdocs/validation.xml
URL: http://svn.apache.org/viewcvs/maven/maven-1/plugins/trunk/pom/xdocs/validation.xml?rev=350059&r1=350058&r2=350059&view=diff
==============================================================================
--- maven/maven-1/plugins/trunk/pom/xdocs/validation.xml (original)
+++ maven/maven-1/plugins/trunk/pom/xdocs/validation.xml Wed Nov 30 13:51:28 2005
@@ -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>



Mime
View raw message