example-tutorial example-tutorial-en.xml,1.23,1.24

[Tommy Reynolds (jtr)]

Author: jtr

Update of /cvs/docs/example-tutorial
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv27328

Modified Files:
	example-tutorial-en.xml 
Log Message:
Oops, too quick to commit the good news; remove the <xi:include>
usage blurb since it doesn't belong here: just the usage is
appropriate.



Index: example-tutorial-en.xml
===================================================================
RCS file: /cvs/docs/example-tutorial/example-tutorial-en.xml,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- example-tutorial-en.xml	30 Jan 2006 19:11:23 -0000	1.23
+++ example-tutorial-en.xml	30 Jan 2006 19:17:05 -0000	1.24
@@ -165,41 +165,6 @@
     </procedure>
   </section>
 
-  <section id="sn-external-files">
-    <title>Including External Files</title>
-
-    <para>
-      An alternative to declaring and using system entities to obtain
-      the content from other files is to use an
-      <firstterm>XInclude</firstterm> reference. These work similarly to
-      include files in familiar programming languages. Using the
-      XInclude feature allows an entire file, or just a part of it, to
-      be copied into the current document. External files are referenced
-      using an <abbrev>URI</abbrev> so they may be located anywhere,
-      even across the Internet.
-    </para>
-
-    <para>
-      The official documentation for the XInclude feature may be found
-      at the <ulink url="http://www.w3.org/TR/XInclude"/> web site. A
-      somewhat dated description at
-      <ulink url="http://www.sagehill.net/docbookxsl/ModularDoc.html"/>
-      may be a more readible starting reference.
-    </para>
-
-    <para>
-      Using the XInclude facility with DocBook requires a special
-      technique to allow the document to pass XML validation. Often
-      examples show adding the phrase
-      <phrase>xmlns:xi="http://www.w3.org/2001/XInclude"</phrase>
-      to a top-level element such as
-      <wordasword><chapter></wordasword>. Unfortunately this
-      causes the DocBook file to fail validation. The solution is to
-      place the namespace declaration directly in the <xi:include>
-      element:
-    </para>
-  </section>
-
   <index id="generated-index"></index>
 </article>