From adde2729f285dea008bd1013dffeaf6d24d70cfc Mon Sep 17 00:00:00 2001
From: Stefan Bodewig <bodewig@apache.org>
Date: Tue, 6 Apr 2004 13:48:22 +0000
Subject: [PATCH] Clarify that antstructure isn't really that useful, PR: 27735

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@276280 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/CoreTasks/antstructure.html | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/docs/manual/CoreTasks/antstructure.html b/docs/manual/CoreTasks/antstructure.html
index a7cdce2da..6b31a04f2 100644
--- a/docs/manual/CoreTasks/antstructure.html
+++ b/docs/manual/CoreTasks/antstructure.html
@@ -9,9 +9,19 @@
 
 <h2><a name="antstructure">AntStructure</a></h2>
 <h3>Description</h3> 
-<p>Generates a DTD for Ant buildfiles which contains information
-about all tasks currently known to Ant.</p> 
-<p>Note that the DTD generated by this task is incomplete, you can
+
+<p>Generates an DTD for Ant buildfiles which contains information
+about all tasks currently known to Ant.</p>
+
+<p>Actually the DTD will not be a real DTD for buildfiles since Ant's
+usage of XML cannot be captured with a DTD.  Several elements in Ant
+can have different attribute lists depending on the element that
+contains them.  &quot;fail&quot; for example can be <a
+href="fail.html">the task</a> or the nested child element of the <a
+href="../OptionalTasks/sound.html">sound</a> task.  Don't consider the
+generated DTD something to rely upon.</p>
+
+<p>Also note that the DTD generated by this task is incomplete, you can
 always add XML entities using <a
 href="taskdef.html"><code>&lt;taskdef&gt;</code></a> or <a
 href="typedef.html"><code>&lt;typedef&gt;</code></a>. See <a