Index: ant_in_anger.html
===================================================================
RCS file: /home/cvspublic/jakarta-ant/docs/ant_in_anger.html,v
retrieving revision 1.1
diff -u -r1.1 ant_in_anger.html
--- ant_in_anger.html	2001/01/11 11:56:34	1.1
+++ ant_in_anger.html	2001/01/26 19:45:40
@@ -567,15 +567,37 @@
 #include targets to simplify multi build.xml projects
 </b><dd>
 
-You can import XML files into a build file using &lt;?import?&gt;
-an element of XML syntax which the standard parsers use. This lets
+You can import XML files into a build file using the XML parser itself.
+This lets
 a multi-project development program share code through reference,
 rather than cut and paste re-use. It also lets one build up a file of
 standard tasks which can be reused over time. Because the import
 mechanism is at a level below which ant is aware, treat it as
 equivalent to the #include mechanism of the 'legacy' languages C and
 C++.
-
+<br>
+There are two inclusion mechanisms, an ugly one for all parsers and a
+clean one. For now, the ugly
+method is the most portable:-
+<pre>
+	&lt;!DOCTYPE project [
+	  &lt;!ENTITY IncludeBuildCore SYSTEM &quot;buildCore.xml&quot;&gt;
+	  &lt;!ENTITY IncludeBuildSecondary SYSTEM &quot;buildSecondary.xml&quot;&gt;
+	%IncludeBuildCore;
+	%IncludeBuildSecondary;
+	]&gt;  
+	
+	&lt;target name=&quot;includedBuild&quot;&gt;
+		&amp;IncludeBuildCore;
+		&amp;IncludeBuildSecondary;
+	&lt;/target&gt;
+</pre>
+The clean method using XInclude/Xpath will let you include named 
+targets from one build file or another, using
+<a href="http://www.w3.org/XML/Linking"> 
+the xpointer syntax</a>. You'll need to wait for the W3C proposals
+to finalise and the java XML parsers to implement it before
+using xpointer references.  
 <dt><b>
 Implement complex Ant builds through XSL
 </b><dd>