Add macro utility bindings. Add named aliases for some mappings.

--HG--
branch : key-processing

common/locale/en-US/repeat.xml

@@ -21,7 +21,7 @@
 <h2 tag="single-repeat">Single repeats</h2>
 
 <item>
-    <tags>.</tags>
+    <tags>&lt;repeat-key> .</tags>
     <strut/>
     <spec><oa>count</oa>.</spec>
     <description>
@@ -45,7 +45,7 @@
 <h2 tag="macros complex-repeat">Macros</h2>
 
 <item>
-    <tags>q</tags>
+    <tags>&lt;record-macro> q</tags>
     <strut/>
     <spec>q<a>0-9a-zA-Z</a></spec>
     <description>
@@ -82,7 +82,7 @@
 </item>
 
 <item>
-    <tags>@</tags>
+    <tags>&lt;play-macro> @</tags>
     <spec><oa>count</oa>@<a>a-z0-9</a></spec>
     <description>
         <p>
@@ -100,6 +100,38 @@
     </description>
 </item>
 
+<h2 tag="macro-utilities">Macro utilities</h2>
+
+<p>
+    The following key bindings facilitate the recording of efficient
+    macros. They have no effect when typed normally, but are
+    recorded and take effect during macro playback.
+</p>
+
+<item>
+    <tags><sleep> <A-m>s</tags>
+    <strut/>
+    <spec><a>count</a>&lt;m>s</spec>
+    <description>
+        <p>
+            Sleep for <a>count</a> milliseconds before resuming playback.
+        </p>
+    </description>
+</item>
+
+<item>
+    <tags><![CDATA[<wait-for-page-load> <A-m>l]]></tags>
+    <strut/>
+    <spec><![CDATA[<A-m>l]]></spec>
+    <description>
+        <p>
+            Wait for the current page to finish loading before resuming
+            playback.
+        </p>
+    </description>
+</item>
+
+
 <h2 tag="using-scripts">Using scripts</h2>
 
 <item>