From 83d3fd0981a84cc9c2cbba0f6d41666accd92b20 Mon Sep 17 00:00:00 2001
From: Kevin McCarthy <kevin@8t8.us>
Date: Mon, 29 Jun 2015 14:35:28 -0700
Subject: [PATCH] Add note to manual clarifying push/exec and folder-hook
 order.

Folder-hooks are executed in the order declared.  However, push/exec
commands will simply prepend to the keyboard buffer.  If there are
multiple push/exec commands, each will prepend to the earlier one.  The
result is that they will end up being "run" in reverse order once keyboard
buffer processing starts.
---
 doc/manual.xml.head | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index f8d80324a..109bd2db8 100644
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -2453,6 +2453,15 @@ in the configuration file.
 </para>
 </note>
 
+<note>
+<para>
+The keyboard buffer will not be processed until after all hooks
+are run; multiple <link linkend="push">push</link> or <link
+linkend="exec">exec</link> commands will end up being processed in
+reverse order.
+</para>
+</note>
+
 <para>
 The following example will set the <link linkend="sort">sort</link>
 variable to <literal>date-sent</literal> for all folders but to
@@ -3663,7 +3672,7 @@ e-mail address, or even just a real name.
 </cmdsynopsis>
 
 <para>
-This command adds the named string to the keyboard buffer. The string
+This command adds the named string to the beginning of the keyboard buffer. The string
 may contain control characters, key names and function names like the
 sequence string in the <link linkend="macro">macro</link> command. You
 may use it to automatically run a sequence of commands at startup, or
-- 
2.40.0