diff --git a/docs/manual/CoreTasks/antcall.html b/docs/manual/CoreTasks/antcall.html
index 70b161c6f..32ee0b599 100644
--- a/docs/manual/CoreTasks/antcall.html
+++ b/docs/manual/CoreTasks/antcall.html
@@ -67,6 +67,10 @@ Of course, any properties defined in the antcall task or inherited from the call
 will be fixed and not overridable in the init task--or indeed in the "doSomethingElse" task.
 </p>
 
+<p>The called target(s) are run in a new project; be aware that this
+means properties, references, etc.  set by called targets will not
+persist back to the calling project.</p>
+
 <p>If the build file changes after you've started the build, the
 behavior of this task is undefined.</p>