svn commit: r391856 - /maven/maven-1/plugins/trunk/xdoc/xdocs/reference/xdocs.xml

[ltheussl]

Author: ltheussl
Date: Wed Apr  5 16:54:29 2006
New Revision: 391856

URL: http://svn.apache.org/viewcvs?rev=391856&view=rev
Log:
Document use of DOCTYPE declaration.

Modified:
    maven/maven-1/plugins/trunk/xdoc/xdocs/reference/xdocs.xml

Modified: maven/maven-1/plugins/trunk/xdoc/xdocs/reference/xdocs.xml
URL: 
http://svn.apache.org/viewcvs/maven/maven-1/plugins/trunk/xdoc/xdocs/reference/xdocs.xml?rev=391856&r1=391855&r2=391856&view=diff
==============================================================================
--- maven/maven-1/plugins/trunk/xdoc/xdocs/reference/xdocs.xml (original)
+++ maven/maven-1/plugins/trunk/xdoc/xdocs/reference/xdocs.xml Wed Apr  5 
16:54:29 2006
@@ -142,6 +142,16 @@
         source files are valid xdoc documents. This should ensure that the
         generated html files are valid
         <a href="http://www.w3.org/TR/xhtml1/";>XHTML1-transitional</a>.
+      </p>
+      <p>
+        To support validation of your xdoc source files by an external tool,
+        you should include the following <code>DOCTYPE</code>
+        declaration just after the <code>&lt;xml&gt;</code> element:
+      </p>
+      <source>&lt;!DOCTYPE xdoc PUBLIC
+  "-//Apache Software Foundation//DTD XDOC 1.0//EN"
+  "http://www.apache.org/dtds/xdoc_1_0.dtd"&gt;</source>
+      <p>
         Here is a list of common mistakes to be aware of:
       </p>