crossley 2003/12/18 00:47:38
Modified: src/documentation/content/xdocs/community committer.xml
Log:
Add section about xml validation.
Revision Changes Path
1.6 +21 -2
cocoon-site/src/documentation/content/xdocs/community/committer.xml
Index: committer.xml
===================================================================
RCS file:
/home/cvs/cocoon-site/src/documentation/content/xdocs/community/committer.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- committer.xml 12 Dec 2003 07:39:20 -0000 1.5
+++ committer.xml 18 Dec 2003 08:47:38 -0000 1.6
@@ -92,8 +92,7 @@
To add the ^M use "Ctrl-v Ctrl-m" at the command-line.
Note that copy-and-paste will not work.
The -w can be omitted, but might then match some extra filenames.
-]]>
- </source>
+]]></source>
<p>
To instead find <em>all</em> files (including images and foreign
@@ -106,6 +105,26 @@
characters:
<code>find . -type f | xargs grep -l '[[:cntrl:]]'</code>
</p>
+ </section>
+
+ <section id="valid-xml">
+ <title>Valid XML instances</title>
+ <p>
+ Many of us have wasted time with a broken build due to xml validation
+ errors. Would all committers please either use a proper xml editor or
+ validate their xdocs with one of the following commands:
+ </p>
+ <source>
+onsgmls -c $COCOON_HOME/src/webapp/WEB-INF/entities/catalog \
+-wall -wxml -s mydoc.xml
+ </source>
+ <source>
+export SGML_CATALOG_FILES=$COCOON_HOME/src/webapp/WEB-INF/entities/catalog
+xmllint --valid --catalogs --noout mydoc.xml
+ </source>
+ <source>
+forrest validate-xdocs
+ </source>
</section>
</body>
