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

@@ -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