From: Richard Russon <rich@flatcap.org>
Date: Sat, 1 Jul 2017 22:14:59 +0000 (+0100)
Subject: doc: limitations of new-mail %f expando
X-Git-Tag: neomutt-20170707~15
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=dcd9ab0cbd48800f91dffb1ceea2dc781d334a0f;p=neomutt

doc: limitations of new-mail %f expando
---

diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index de235777c..8df4118a2 100644
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -12103,16 +12103,20 @@ set index_format='%4C %Z %{%b %d} %-25.25n %&lt;M?[%M] %s&amp;%s%* %&lt;l?%l&amp
         used to execute a custom script (e.g., a notification handler) upon
         receiving a new mail.</para>
         <para>The command string can contain expandos, such as
-        <literal>%f</literal> for the folder name. For a complete list, see:
+        <literal>%n</literal> for the number of new messages. For a complete list, see:
         <link linkend="status-format">$status_format</link>.</para>
+        <note>
+        <para>When the notification is sent, the folder of the new mail is no longer known.
+          This is a limitation of Mutt.  The `%f` expando will show the open folder.</para>
+        </note>
         <para>For example in Linux you can use (most distributions already
         provide notify-send):</para>
-        <screen>set new_mail_command="notify-send --icon='/home/santiago/Pictures/mutt.png' 'New Email in %f' '%n new messages, %u unread.' &amp;"</screen>
+        <screen>set new_mail_command="notify-send --icon='/home/santiago/Pictures/mutt.png' 'New Email' '%n new messages, %u unread.' &amp;"</screen>
         <para>And in OS X you will need to install a command line interface for
         Notification Center, for example
         <ulink url="https://github.com/julienXX/terminal-notifier">
         terminal-notifier</ulink>:</para>
-        <screen>set new_mail_command="terminal-notifier -title '%v' -subtitle 'New Mail in %f' -message '%n new messages, %u unread.' -activate 'com.apple.Terminal'"</screen>
+        <screen>set new_mail_command="terminal-notifier -title '%v' -subtitle 'New Mail' -message '%n new messages, %u unread.' -activate 'com.apple.Terminal'"</screen>
       </sect2>
 
       <sect2 id="new-mail-variables">