diff --git a/docs/manual/CoreTasks/delete.html b/docs/manual/CoreTasks/delete.html
index a43491139..87236e7e3 100644
--- a/docs/manual/CoreTasks/delete.html
+++ b/docs/manual/CoreTasks/delete.html
@@ -45,6 +45,13 @@ and it doesn't seem to work, read up on the
in Directory-based Tasks, and see the
defaultexcludes
attribute below.
+
For historical reasons <delete dir="x"/>
is
+ different from <delete><fileset
+ dir="x"/></delete>
, it will try to remove everything
+ inside "x" including "x" itself, not taking default excludes into
+ account, blindly following all symbolic links. If you need more
+ control, use a nested <fileset>
.