diff --git a/docs/manual/CoreTasks/macrodef.html b/docs/manual/CoreTasks/macrodef.html
index 5470b4071..4257ca40c 100644
--- a/docs/manual/CoreTasks/macrodef.html
+++ b/docs/manual/CoreTasks/macrodef.html
@@ -57,9 +57,11 @@
       task using a notation similar to the ant property notation
       - @{attribute name}. (May be remembered as "put the substitution
       AT this location").
-      The escape sequence @@{x} is used to allow @{x} to be
-      placed in the text without substitution of x.
-      This corresponds to the $${x} escape sequence for properties.
+    </p>
+    <p>
+      The escape sequence @@ is used to escape @. This allows @{x} to be
+      placed in the text without substitution of x by using @@{x}.
+      This corresponds to the $$ escape sequence for properties.
     </p>
     <p>
       The case of the attribute is ignored, so @{myAttribute} is treated the