changeset: 6458:9802a6172edf
user:      Kevin McCarthy <[email protected]>
date:      Mon Jun 29 14:35:28 2015 -0700
link:      http://dev.mutt.org/hg/mutt/rev/9802a6172edf

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.

diffs (28 lines):

diff -r 3bbb1f569eb1 -r 9802a6172edf doc/manual.xml.head
--- a/doc/manual.xml.head       Fri Jun 26 12:23:26 2015 -0700
+++ b/doc/manual.xml.head       Mon Jun 29 14:35:28 2015 -0700
@@ -2453,6 +2453,15 @@
 </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 @@
 </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

Reply via email to