The conversion to HTML creates proper XHTML.

[xmldoc.git] / doc / multifiles.xml

diff --git a/doc/multifiles.xml b/doc/multifiles.xml
index ea9c715..bfb1598 100644 (file)
--- a/doc/multifiles.xml
+++ b/doc/multifiles.xml
@@ -5,7 +5,7 @@
 <!--
       XML documentation system
       Original author :  Arjen Baart - arjen@andromeda.nl
-      Version         : $Revision: 1.2 $
+      Version         : $Revision: 1.3 $
 -->
 
 <chapter>
@@ -29,19 +29,30 @@ As a matter of fact, this XMLDoc guide is organized in such a way.
 </para>
 <para>
 To include another XML file in your root document, use the
-<strong>include</strong> element with a single attribute to specify
+standard XML <strong>XInclude</strong> system with a single attribute to specify
 the name of the file to be included.
+Other attributes, as well as the <strong>fallback</strong> element,
+are of course supported as well.
+Refer to the <reference href='http://www.w3.org/TR/2006/REC-xinclude-20061115/'>
+XML Inclusions</reference> standard for more information.
 For example, this chapter is in a file called "multifiles.xml", which
 is included in the main document with:
+</para>
+
 <verbatim>
-&lt;include href="multifiles.xml"/&gt;
+&lt;xi:include href="multifiles.xml"
+    xmlns:xi="http://www.w3.org/2001/XInclude"/&gt;
 </verbatim>
-There is one restriction to including other files: The included files
-must be valid XML files as well.
-It is not possible to include other kinds of files, such as raw text
-or source code.
-So, the included XML file starts with the usual XML declaration, but has
+
+<para>
+Remember to put the <strong>xi:include</strong> in the proper namespace.
+Normally, the included files must be valid XML files as well.
+To include other kinds of files, such as raw text or source code, the attribute
+<strong>parse='text'</strong> must be added to the <strong>include</strong> element.
+When including another XML document, the included XML file starts with the
+usual XML declaration, but has
 a different root element declared in the &lt;!DOCTYPE...&gt; declaration:
+</para>
 
 <verbatim>
 &lt;?xml version="1.0"?&gt;
@@ -51,7 +62,6 @@ a different root element declared in the &lt;!DOCTYPE...&gt; declaration:
 &lt;/chapter&gt;
 </verbatim>
 
-</para>
 </section>
 <section>
 <heading>Multiple output files</heading>