</sect1>
-<sect1 id="quasi-delete">
- <title>Quasi-Delete Patch</title>
- <subtitle>Mark emails that should be hidden, but not deleted</subtitle>
+<sect1 id="compress">
+ <title>Compressed Folders Patch</title>
+ <subtitle>Read from/write to compressed mailboxes</subtitle>
- <sect2 id="quasi-delete-patch">
+ <sect2 id="compress-patch">
<title>Patch</title>
<para>
- To check if Mutt supports <quote>Quasi-Delete</quote>, look for
- <quote>patch-quasi-delete</quote> in the mutt version.
- See: <xref linkend="mutt-patches"/>.
+ To check if Mutt supports <quote>Compress Folders</quote>, look for
+ <quote>+USE_COMPRESSED</quote> in the mutt version.
+ See: <xref linkend="compile-time-features"/>.
</para>
<itemizedlist>
<para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
</sect2>
- <sect2 id="quasi-delete-intro">
+ <sect2 id="compress-intro">
<title>Introduction</title>
- <para>
- The <quote>quasi-delete</quote> function marks an email that should be
- hidden from the index, but NOT deleted.
- </para>
+ <para>
+ The Compressed Folder patch allows Mutt to read mailbox files that are
+ compressed. But it isn't limited to compressed files. It works well
+ with encrypted files, too. In fact, if you can create a program/script
+ to convert to and from your format, then Mutt can read it.
+ </para>
+
+ <para>
+ The patch adds three hooks to Mutt: <literal>open-hook</literal>,
+ <literal>close-hook</literal> and <literal>append-hook</literal>. They
+ define commands to: uncompress a file; compress a file; append
+ messages to an already compressed file.
+ </para>
+
+ <para>
+ There are some examples of both compressed and encrypted files,
+ later. For now, the documentation will just concentrate on
+ compressed files.
+ </para>
- <para>
- On its own, this patch isn't very useful. It forms a useful part of
- the notmuch plugin.
- </para>
</sect2>
<!--
- <sect2 id="quasi-delete-variables">
+ <sect2 id="compress-variables">
<title>Variables</title>
<para>None</para>
</sect2>
--->
- <sect2 id="quasi-delete-functions">
+ <sect2 id="compress-functions">
<title>Functions</title>
- <table id="table-quasi-delete-functions">
- <title>Quasi-Delete Functions</title>
- <tgroup cols="4">
+ <para>None</para>
+ </sect2>
+-->
+
+ <sect2 id="compress-commands">
+ <title>Commands</title>
+ <cmdsynopsis>
+ <command>open-hook</command>
+ <arg choice="plain">
+ <replaceable class="parameter">pattern</replaceable>
+ </arg>
+ <arg choice="plain">
+ <replaceable class="parameter">shell-command</replaceable>
+ </arg>
+ <command>close-hook</command>
+ <arg choice="plain">
+ <replaceable class="parameter">pattern</replaceable>
+ </arg>
+ <arg choice="plain">
+ <replaceable class="parameter">shell-command</replaceable>
+ </arg>
+ <command>append-hook</command>
+ <arg choice="plain">
+ <replaceable class="parameter">pattern</replaceable>
+ </arg>
+ <arg choice="plain">
+ <replaceable class="parameter">shell-command</replaceable>
+ </arg>
+ </cmdsynopsis>
+
+ <para>
+ The shell-command must contain two placeholders for filenames:
+ <literal>%f</literal> and <literal>%t</literal>. These represent
+ <quote>from</quote> and <quote>to</quote> filenames. It's a good idea to
+ put quotes around these placeholders.
+ </para>
+
+ <para>
+ If you need the exact string <quote>%f</quote> or <quote>%t</quote> in your
+ command, simply double up the <quote>%</quote> character, e.g.
+ <quote>%%f</quote> or <quote>%%t</quote>.
+ </para>
+
+ <table id="table-compress-optional">
+ <title>Not all Hooks are Required</title>
+ <tgroup cols="5">
<thead>
<row>
- <entry>Menus</entry>
- <entry>Default Key</entry>
- <entry>Function</entry>
- <entry>Description</entry>
+ <entry>Open</entry>
+ <entry>Close</entry>
+ <entry>Append</entry>
+ <entry>Effect</entry>
+ <entry>Useful if</entry>
</row>
</thead>
<tbody>
<row>
- <entry>index,pager</entry>
- <entry>(none)</entry>
- <entry><literal><quasi-delete></literal></entry>
- <entry>delete from mutt, don't touch on disk</entry>
+ <entry>Open</entry>
+ <entry>-</entry>
+ <entry>-</entry>
+ <entry>Folder is readonly</entry>
+ <entry>The folder is just a backup</entry>
+ </row>
+ <row>
+ <entry>Open</entry>
+ <entry>Close</entry>
+ <entry>-</entry>
+ <entry>Folder is read/write, but the entire folder must be
+ written if anything is changed</entry>
+ <entry>Your compression format doesn't support appending</entry>
+ </row>
+ <row>
+ <entry>Open</entry>
+ <entry>Close</entry>
+ <entry>Append</entry>
+ <entry>Folder is read/write and emails can be efficiently added
+ to the end</entry>
+ <entry>Your compression format supports appending</entry>
+ </row>
+ <row>
+ <entry>Open</entry>
+ <entry>-</entry>
+ <entry>Append</entry>
+ <entry>Folder is readonly, but can be appended to</entry>
+ <entry>You want to store emails, but never change them</entry>
</row>
</tbody>
</tgroup>
</table>
- </sect2>
-
-<!--
- <sect2 id="quasi-delete-commands">
- <title>Commands</title>
- <para>None</para>
- </sect2>
- <sect2 id="quasi-delete-colors">
- <title>Colors</title>
- <para>None</para>
- </sect2>
+ <note>
+ The command:
+ <itemizedlist>
+ <listitem><para>should return a non-zero exit status on failure</para></listitem>
+ <listitem><para>should not delete any files</para></listitem>
+ </itemizedlist>
+ </note>
- <sect2 id="quasi-delete-sort">
- <title>Sort</title>
- <para>None</para>
- </sect2>
--->
+ <sect3 id="open-hook">
+ <title>Read from compressed mailbox</title>
- <sect2 id="quasi-delete-muttrc">
- <title>Muttrc</title>
-<screen>
-<emphasis role="comment"># Example Mutt config file for the 'quasi-delete' feature.
-
-# The 'quasi-delete' function marks an email that should be hidden
-# from the index, but NOT deleted.</emphasis>
-bind index,pager Q quasi-delete
-
-<emphasis role="comment"># vim: syntax=muttrc</emphasis>
-</screen>
- </sect2>
+ <screen>open-hook regexp shell-command</screen>
- <sect2 id="quasi-delete-see-also">
- <title>See Also</title>
+ <para>
+ If Mutt is unable to open a file, it then looks for
+ <literal>open-hook</literal> that matches the filename.
+ </para>
- <itemizedlist>
- <listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
- <listitem><para><link linkend="notmuch">notmuch patch</link></para></listitem>
- </itemizedlist>
- </sect2>
+ <para>
+ If your compression program doesn't have a well-defined extension,
+ then you can use <literal>.</literal> as the regexp.
+ </para>
- <sect2 id="quasi-delete-known-bugs">
- <title>Known Bugs</title>
- <para>None</para>
- </sect2>
+ <sect4 id="compress-open-hook-example">
+ <title>Example of open-hook</title>
- <sect2 id="quasi-delete-credits">
- <title>Credits</title>
- <itemizedlist>
- <listitem><para>Karel Zak <email>kzak@redhat.com</email></para></listitem>
- <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
- </itemizedlist>
- </sect2>
-</sect1>
+ <screen>open-hook '\.gz$' "gzip -cd '%f' > '%t'"</screen>
-<sect1 id="progress">
- <title>Progress Bar Patch</title>
- <subtitle>Show a visual progress bar on slow operations</subtitle>
+ <itemizedlist>
+ <listitem><para>Mutt finds a file, <quote>example.gz</quote>,
+ that it can't read</para></listitem>
+ <listitem><para>Mutt has an <literal>open-hook</literal>
+ whose regexp matches the filename:
+ <literal>\.gz$</literal></para></listitem>
+ <listitem><para>Mutt uses the command <literal>gzip -cd</literal>
+ to create a temporary file that it <emphasis>can</emphasis>
+ read</para></listitem>
+ </itemizedlist>
+ </sect4>
+ </sect3>
- <sect2 id="progress-patch">
- <title>Patch</title>
+ <sect3 id="close-hook">
+ <title>Write to a compressed mailbox</title>
- <para>
- To check if Mutt supports <quote>Progress Bar</quote>, look for
- <quote>patch-progress</quote> in the mutt version.
- See: <xref linkend="mutt-patches"/>.
- </para>
+ <screen>close-hook regexp shell-command</screen>
- <itemizedlist>
- <title>Dependencies:</title>
- <listitem><para>mutt-1.6.1</para></listitem>
- </itemizedlist>
+ <para>
+ When Mutt has finished with a compressed mail folder, it will look
+ for a matching <literal>close-hook</literal> to recompress the file.
+ This hook is <link linkend="table-compress-optional">optional</link>.
+ </para>
- <para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
- </sect2>
+ <note>
+ If the folder has not been modifed, the
+ <literal>close-hook</literal> will not be called.
+ </note>
- <sect2 id="progress-intro">
- <title>Introduction</title>
+ <sect4 id="compress-close-hook-example">
+ <title>Example of close-hook</title>
- <para>
- The <quote>progress</quote> patch shows a visual progress bar on slow
- tasks, such as indexing a large folder over the net.
- </para>
- </sect2>
+ <screen>close-hook '\.gz$' "gzip -c '%t' > '%f'"</screen>
-<!--
- <sect2 id="progress-variables">
- <title>Variables</title>
- <para>None</para>
- </sect2>
+ <itemizedlist>
+ <listitem><para>Mutt has finished with a folder, <quote>example.gz</quote>,
+ that it opened with <literal>open-hook</literal></para></listitem>
+ <listitem><para>The folder has been modified</para></listitem>
+ <listitem><para>Mutt has a <literal>close-hook</literal> whose regexp
+ matches the filename: <literal>\.gz$</literal></para></listitem>
+ <listitem><para>Mutt uses the command <literal>gzip -c</literal>
+ to create a new compressed file</para></listitem>
+ </itemizedlist>
+ </sect4>
+ </sect3>
- <sect2 id="progress-functions">
- <title>Functions</title>
- <para>None</para>
- </sect2>
+ <sect3 id="append-hook">
+ <title>Append to a compressed mailbox</title>
- <sect2 id="progress-commands">
- <title>Commands</title>
- <para>None</para>
+ <screen>append-hook regexp shell-command</screen>
+
+ <para>
+ When Mutt wants to append an email to a compressed mail folder, it
+ will look for a matching <literal>append-hook</literal>.
+ This hook is <link linkend="table-compress-optional">optional</link>.
+ </para>
+
+ <para>
+ Using the <literal>append-hook</literal> will save time, but
+ Mutt won't be able to determine the type of the mail folder
+ inside the compressed file.
+ </para>
+
+ <para>
+ Mutt will <emphasis>assume</emphasis> the type to be that of
+ the <literal>$mbox_type</literal> variable. Mutt also uses
+ this type for temporary files.
+ </para>
+
+ <para>
+ Mutt will only use the <literal>append-hook</literal> for existing files.
+ The <literal>close-hook</literal> will be used for empty, or missing files.
+ </para>
+
+ <sect4 id="compress-append-hook-example">
+ <title>Example of append-hook</title>
+
+ <screen>append-hook '\.gz$' "gzip -c '%t' >> '%f'"</screen>
+
+ <itemizedlist>
+ <listitem><para>Mutt wants to append an email to a folder, <quote>example.gz</quote>,
+ that it opened with <literal>open-hook</literal></para></listitem>
+ <listitem><para>Mutt has an <literal>append-hook</literal> whose regexp matches
+ the filename: <literal>\.gz$</literal></para></listitem>
+ <listitem><para>Mutt knows the mailbox type from the <literal>$mbox</literal>
+ variable</para></listitem>
+ <listitem><para>Mutt uses the command <literal>gzip -c</literal>
+ to append to an existing compressed file</para></listitem>
+ </itemizedlist>
+ </sect4>
+
+ </sect3>
+
+ <sect3 id="compress-empty">
+ <title>Empty Files</title>
+
+ <para>
+ Mutt assumes that an empty file is not compressed. In this
+ situation, unset <link linkend="save-empty">$save_empty</link>, so
+ that the compressed file will be removed if you delete all of the
+ messages.
+ </para>
+ </sect3>
+
+ <sect3 id="compress-security">
+ <title>Security</title>
+
+ <para>
+ Encrypted files are decrypted into temporary files which are
+ stored in the <link linkend="tmpdir">$tmpdir</link> directory.
+ This could be a security risk.
+ </para>
+ </sect3>
</sect2>
--->
- <sect2 id="progress-colors">
+<!--
+ <sect2 id="compress-colors">
<title>Colors</title>
- <table id="table-progress-colors">
- <title>Progress Colors</title>
- <tgroup cols="3">
- <thead>
- <row>
- <entry>Name</entry>
- <entry>Default Color</entry>
- <entry>Description</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry><literal>progress</literal></entry>
- <entry>default</entry>
- <entry>Visual progress bar</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
+ <para>None</para>
</sect2>
-<!--
- <sect2 id="progress-sort">
+ <sect2 id="compress-sort">
<title>Sort</title>
<para>None</para>
</sect2>
-->
- <sect2 id="progress-muttrc">
+ <sect2 id="compress-muttrc">
<title>Muttrc</title>
<screen>
-<emphasis role="comment"># Example Mutt config file for the 'progress' patch.
+<emphasis role="comment"># Example Mutt config file for the 'compressed folders' feature.
-# The 'progress' patch provides clear visual feedback for
-# slow tasks, such as indexing a large folder over the net.
+# This feature adds three hooks to Mutt which allow it to
+# work with compressed, or encrypted, mailboxes.
-# Set the color of the progress bar
-# White text on a red background</emphasis>
-color progress white red
+# The hooks are of the form:
+# open-hook regexp "shell-command"
+# close-hook regexp "shell-command"
+# append-hook regexp "shell-command"
+
+# The 'append-hook' is optional.
+
+# Hander for gzip compressed mailboxes</emphasis>
+open-hook '\.gz$' "gzip -cd '%f' > '%t'"
+close-hook '\.gz$' "gzip -c '%t' > '%f'"
+append-hook '\.gz$' "gzip -c '%t' >> '%f'"
+
+<emphasis role="comment"># Hander for bzip2 compressed mailboxes</emphasis>
+open-hook '\.bz2$' "bzip2 -cd '%f' > '%t'"
+close-hook '\.bz2$' "bzip2 -c '%t' > '%f'"
+append-hook '\.bz2$' "bzip2 -c '%t' >> '%f'"
+
+<emphasis role="comment"># Hander for xz compressed mailboxes</emphasis>
+open-hook '\.xz$' "xz -cd '%f' > '%t'"
+close-hook '\.xz$' "xz -c '%t' > '%f'"
+append-hook '\.xz$' "xz -c '%t' >> '%f'"
+
+<emphasis role="comment"># Hander for pgp encrypted mailboxes
+# PGP does not support appending to an encrypted file</emphasis>
+open-hook '\.pgp$' "pgp -f < '%f' > '%t'"
+close-hook '\.pgp$' "pgp -fe YourPgpUserIdOrKeyId < '%t' > '%f'"
+
+<emphasis role="comment"># Hander for gpg encrypted mailboxes
+# gpg does not support appending to an encrypted file</emphasis>
+open-hook '\.gpg$' "gpg --decrypt < '%f' > '%t'"
+close-hook '\.gpg$' "gpg --encrypt --recipient YourGpgUserIdOrKeyId < '%t' > '%f'"
<emphasis role="comment"># vim: syntax=muttrc</emphasis>
</screen>
</sect2>
- <sect2 id="progress-see-also">
+ <sect2 id="compress-see-also">
<title>See Also</title>
<itemizedlist>
- <listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
- <listitem><para><link linkend="color">Color command</link></para></listitem>
+ <listitem><para><ulink url="https://github.com/neomutt/neomutt/wiki">NeoMutt Project</ulink></para></listitem>
+ <listitem><para><link linkend="compile-time-features">Compile-Time Features</link></para></listitem>
+ <listitem><para><link linkend="regexp">Regular Expressions</link></para></listitem>
+ <listitem><para><link linkend="tmpdir">$tmpdir</link></para></listitem>
+ <listitem><para><link linkend="mbox-type">$mbox_type</link></para></listitem>
+ <listitem><para><link linkend="save-empty">$save_empty</link></para></listitem>
+ <listitem><para><link linkend="folder-hook">folder-hook</link></para></listitem>
</itemizedlist>
</sect2>
- <sect2 id="progress-known-bugs">
+ <sect2 id="compress-known-bugs">
<title>Known Bugs</title>
- <para>None</para>
+
+ <itemizedlist>
+ <listitem><para>The Compressed Folder hooks cannot deal with filenames that contains quotes/apostrophes.</para></listitem>
+ </itemizedlist>
</sect2>
- <sect2 id="progress-credits">
+ <sect2 id="compress-credits">
<title>Credits</title>
<itemizedlist>
- <listitem><para>Rocco Rutte <email>pdmef@gmx.net</email></para></listitem>
- <listitem><para>Vincent Lefevre <email>vincent@vinc17.org</email></para></listitem>
- <listitem><para>Stefan Kuhn <email>wuodan@hispeed.ch</email></para></listitem>
- <listitem><para>Karel Zak <email>kzak@redhat.com</email></para></listitem>
+ <listitem><para>Roland Rosenfeld <email>roland@spinnaker.de</email></para></listitem>
+ <listitem><para>Alain Penders <email>Alain@Finale-Dev.com</email></para></listitem>
+ <listitem><para>Christoph <quote>Myon</quote> Berg <email>myon@debian.org</email></para></listitem>
+ <listitem><para>Evgeni Golov <email>evgeni@debian.org</email></para></listitem>
<listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
</itemizedlist>
</sect2>
</sect1>
-<sect1 id="status-color">
- <title>Status Color Patch</title>
- <subtitle>Custom rules for theming the status bar</subtitle>
+<sect1 id="cond-date">
+ <title>Conditional Dates Patch</title>
+ <subtitle>Use rules to choose date format</subtitle>
- <sect2 id="status-color-patch">
+ <sect2 id="cond-date-patch">
<title>Patch</title>
<para>
- To check if Mutt supports <quote>Status Color</quote>, look for
- <quote>patch-status-color</quote> in the mutt version.
+ To check if Mutt supports <quote>Conditional Dates</quote>, look for
+ <quote>patch-cond-date</quote> in the mutt version.
See: <xref linkend="mutt-patches"/>.
</para>
<itemizedlist>
<title>Dependencies:</title>
<listitem><para>mutt-1.6.1</para></listitem>
+ <listitem><para><link linkend="nested-if">nested-if patch</link></para></listitem>
</itemizedlist>
- <para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
+ <para>
+ This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.
+ </para>
</sect2>
- <sect2 id="status-color-intro">
+ <sect2 id="cond-date-intro">
<title>Introduction</title>
- <para>
- The <quote>status-color</quote> patch allows you to theme different
- parts of the status bar (also when it's used by the index).
- </para>
-
- <para>
- Unlike normal color commands, <literal>color status</literal> can now
- take up to 2 extra parameters (regex, num).
- </para>
- </sect2>
+ <para>
+ The <quote>cond-date</quote> patch allows you to construct
+ <link linkend="index-format">$index_format</link> expressions based on the age of the email.
+ </para>
-<!--
- <sect2 id="status-color-variables">
- <title>Variables</title>
- <para>None</para>
- </sect2>
+ <para>
+ Mutt's default <literal>$index_format</literal> displays email dates in the
+ form: abbreviated-month day-of-month — <quote>Jan 14</quote>.
+ </para>
- <sect2 id="status-color-functions">
- <title>Functions</title>
- <para>None</para>
- </sect2>
--->
+ <para>
+ The format is configurable but only per-mailbox. This patch allows you
+ to configure the display depending on the age of the email.
+ </para>
- <sect2 id="status-color-commands">
- <title>Commands</title>
- <cmdsynopsis>
- <command>color</command>
- <arg choice="plain">
- <option>status</option>
- </arg>
- <arg choice="plain">
- <replaceable class="parameter">foreground</replaceable>
- </arg>
- <arg choice="plain">
- <replaceable class="parameter">background</replaceable>
- </arg>
- <group choice="opt">
- <arg choice="plain">
- <replaceable class="parameter">regex</replaceable>
- </arg>
- <group choice="opt">
- <arg choice="plain">
- <replaceable class="parameter">num</replaceable>
- </arg>
- </group>
- </group>
- </cmdsynopsis>
-
- <para>
- With zero parameters, Mutt will set the default color for the entire
- status bar.
- </para>
-
- <para>
- With one parameter, Mutt will only color the parts matching the
- regex.
- </para>
-
- <para>
- With two parameters, Mutt will only color the num'th sub-match of
- the regex.
- </para>
- </sect2>
-
- <sect2 id="status-color-colors">
- <title>Colors</title>
-
- <table id="table-status-color-colors">
- <title>Status Colors</title>
+ <table id="table-cond-date-scheme">
+ <title>Potential Formatting Scheme</title>
<tgroup cols="3">
<thead>
<row>
- <entry>Name</entry>
- <entry>Default Color</entry>
- <entry>Description</entry>
+ <entry>Email Sent</entry>
+ <entry>Format</entry>
+ <entry>Example</entry>
</row>
</thead>
<tbody>
<row>
- <entry>status</entry>
- <entry><literal>reverse</literal></entry>
- <entry>Status bar</entry>
+ <entry>Today</entry>
+ <entry><literal>%H:%M</literal></entry>
+ <entry>13:23</entry>
+ </row>
+ <row>
+ <entry>This Month</entry>
+ <entry><literal>%a %d</literal></entry>
+ <entry>Thu 17</entry>
+ </row>
+ <row>
+ <entry>This Year</entry>
+ <entry><literal>%b %d</literal></entry>
+ <entry>Dec 10</entry>
+ </row>
+ <row>
+ <entry>Older than 1 Year</entry>
+ <entry><literal>%m/%y</literal></entry>
+ <entry>06/14</entry>
</row>
</tbody>
</tgroup>
</table>
- </sect2>
-
-<!--
- <sect2 id="status-color-sort">
- <title>Sort</title>
- <para>None</para>
- </sect2>
--->
-
- <sect2 id="status-color-muttrc">
- <title>Muttrc</title>
-<screen>
-<emphasis role="comment"># Example Mutt config file for the 'status-color' patch.
-
-# The 'status-color' patch allows you to theme different parts of
-# the status bar (also when it's used by the index).
-
-# For the examples below, set some defaults</emphasis>
-set status_format='-%r-Mutt: %f [Msgs:%?M?%M/?%m%?n? New:%n?%?o? Old:%o?%?d? Del:%d?%?F? Flag:%F?%?t? Tag:%t?%?p? Post:%p?%?b? Inc:%b?%?l? %l?]---(%s/%S)-%>-(%P)---'
-set index_format='%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s'
-set sort=threads
-set sort_aux=last-date-received
-
-<emphasis role="comment"># 'status color' can take up to 2 extra parameters
-
-# color status foreground background [ regex [ num ]]
-
-# 0 extra parameters
-# Set the default color for the entire status line</emphasis>
-color status blue white
-
-<emphasis role="comment"># 1 extra parameter
-# Set the color for a matching pattern
-# color status foreground background regexp
-
-# Highlight New, Deleted, or Flagged emails</emphasis>
-color status brightred white '(New|Del|Flag):[0-9]+'
-
-<emphasis role="comment"># Highlight mailbox ordering if it's different from the default
-# First, highlight anything (*/*)</emphasis>
-color status brightred default '\([^)]+/[^)]+\)'
-
-<emphasis role="comment"># Then override the color for one specific case</emphasis>
-color status default default '\(threads/last-date-received\)'
-
-<emphasis role="comment"># 2 extra parameters
-# Set the color for the nth submatch of a pattern
-# color status foreground background regexp num
-
-# Highlight the contents of the []s but not the [] themselves</emphasis>
-color status red default '\[([^]]+)\]' 1
-
-<emphasis role="comment"># The '1' refers to the first regex submatch, which is the inner
-# part in ()s
-
-# Highlight the mailbox</emphasis>
-color status brightwhite default 'Mutt: ([^ ]+)' 1
-
-<emphasis role="comment"># Search for 'Mutt: ' but only highlight what comes after it
-
-# vim: syntax=muttrc</emphasis>
-</screen>
- </sect2>
-
- <sect2 id="status-color-see-also">
- <title>See Also</title>
-
- <itemizedlist>
- <listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
- <listitem><para><link linkend="compile-time-features">Compile-Time Features</link></para></listitem>
- <listitem><para><link linkend="regexp">Regular Expressions</link></para></listitem>
- <listitem><para><link linkend="patterns">Patterns</link></para></listitem>
- <listitem><para><link linkend="index-color">index-color patch</link></para></listitem>
- <listitem><para><link linkend="color">Color command</link></para></listitem>
- </itemizedlist>
- </sect2>
-
- <sect2 id="status-color-known-bugs">
- <title>Known Bugs</title>
- <para>None</para>
- </sect2>
-
- <sect2 id="status-color-credits">
- <title>Credits</title>
- <itemizedlist>
- <listitem><para>David Sterba <email>dsterba@suse.cz</email></para></listitem>
- <listitem><para>Thomas Glanzmann <email>thomas@glanzmann.de</email></para></listitem>
- <listitem><para>Kirill A. Shutemov <email>kirill@shutemov.name</email></para></listitem>
- <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
- </itemizedlist>
- </sect2>
-</sect1>
-
-<sect1 id="index-color">
- <title>Index Color Patch</title>
- <subtitle>Custom rules for theming the email index</subtitle>
-
- <sect2 id="index-color-patch">
- <title>Patch</title>
<para>
- To check if Mutt supports <quote>Index Color</quote>, look for
- <quote>patch-index-color</quote> in the mutt version.
- See: <xref linkend="mutt-patches"/>.
+ For an explanation of the date formatting strings, see
+ <literal>strftime(3).</literal>
</para>
- <itemizedlist>
- <title>Dependencies:</title>
- <listitem><para>mutt-1.6.1</para></listitem>
- <listitem><para><link linkend="status-color">status-color patch</link></para></listitem>
- </itemizedlist>
-
- <para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
- </sect2>
-
- <sect2 id="index-color-intro">
- <title>Introduction</title>
-
- <para>
- The <quote>index-color</quote> patch allows you to specify colors for
- individual parts of the email index. e.g. Subject, Author, Flags.
- </para>
-
- <para>
- First choose which part of the index you'd like to color.
- Then, if needed, pick a pattern to match.
- </para>
-
<para>
- Note: The pattern does not have to refer to the object you wish to
- color. e.g.
+ By carefully picking your formats, the dates can remain
+ unambiguous and compact.
</para>
-<screen>
-color index_author red default "~smutt"
-</screen>
-
- <para>
- The author appears red when the subject (~s) contains <quote>mutt</quote>.
- </para>
- </sect2>
-
-<!--
- <sect2 id="index-color-variables">
- <title>Variables</title>
- <para>None</para>
- </sect2>
-
- <sect2 id="index-color-functions">
- <title>Functions</title>
- <para>None</para>
- </sect2>
+ <para>
+ Mutt's conditional format strings have the form:
+ (whitespace introduced for clarity)
+ </para>
- <sect2 id="index-color-commands">
- <title>Commands</title>
- <para>None</para>
- </sect2>
--->
+ <screen>%? TEST ? TRUE & FALSE ?</screen>
- <sect2 id="index-color-colors">
- <title>Colors</title>
+ <para>
+ The examples below use the test <quote>%[</quote> — the date
+ of the message in the local timezone. They will also work with
+ <quote>%(</quote> — the local time that the message arrived.
+ </para>
- <para>
- All the colors default to <literal>default</literal>, i.e. unset.
- </para>
+ The date tests are of the form:
+ </para>
- <para>
- The index objects can be themed using the <literal>color</literal> command.
- Some objects require a pattern.
- </para>
+ <screen>%[nX? TRUE & FALSE ?</screen>
-<screen>
-color index-object foreground background
-color index-object foreground background pattern
-</screen>
+ <itemizedlist>
+ <listitem><para><quote>n</quote> is an optional count (defaults to 1 if missing)</para></listitem>
+ <listitem><para><quote>X</quote> is the time period</para></listitem>
+ </itemizedlist>
- <table id="table-index-color-colors">
- <title>Index Colors</title>
- <tgroup cols="3">
+ <table id="table-cond-date-format-codes">
+ <title>Date Formatting Codes</title>
+ <tgroup cols="2">
<thead>
<row>
- <entry>Object</entry>
- <entry>Pattern</entry>
- <entry>Highlights</entry>
+ <entry>Letter</entry>
+ <entry>Time Period</entry>
</row>
</thead>
<tbody>
<row>
- <entry><literal>index</literal></entry>
- <entry>yes</entry>
- <entry>Entire index line</entry>
- </row>
+ <entry>y</entry>
+ <entry>Years</entry>
+ </row>
<row>
- <entry><literal>index_author</literal></entry>
- <entry>yes</entry>
- <entry>Author name, %A %a %F %L %n</entry>
+ <entry>m</entry>
+ <entry>Months</entry>
</row>
<row>
- <entry><literal>index_collapsed</literal></entry>
- <entry>no</entry>
- <entry>Number of messages in a collapsed thread, %M</entry>
+ <entry>w</entry>
+ <entry>Weeks</entry>
</row>
<row>
- <entry><literal>index_date</literal></entry>
- <entry>no</entry>
- <entry>Date field</entry>
+ <entry>d</entry>
+ <entry>Days</entry>
</row>
<row>
- <entry><literal>index_flags</literal></entry>
- <entry>yes</entry>
- <entry>Message flags, %S %Z</entry>
+ <entry>H</entry>
+ <entry>Hours</entry>
</row>
<row>
- <entry><literal>index_label</literal></entry>
- <entry>no</entry>
- <entry>Message label, %y %Y</entry>
+ <entry>M</entry>
+ <entry>Minutes</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ <table id="table-cond-date-example-tests">
+ <title>Example Date Tests</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Test</entry>
+ <entry>Meaning</entry>
</row>
+ </thead>
+ <tbody>
<row>
- <entry><literal>index_number</literal></entry>
- <entry>no</entry>
- <entry>Message number, %C</entry>
+ <entry><literal>%[y</literal></entry>
+ <entry>This year</entry>
</row>
<row>
- <entry><literal>index_size</literal></entry>
- <entry>no</entry>
- <entry>Message size, %c %l</entry>
+ <entry><literal>%[1y</literal></entry>
+ <entry>This year</entry>
</row>
<row>
- <entry><literal>index_subject</literal></entry>
- <entry>yes</entry>
- <entry>Subject, %s</entry>
+ <entry><literal>%[6m</literal></entry>
+ <entry>In the last 6 months</entry>
+ </row>
+ <row>
+ <entry><literal>%[w</literal></entry>
+ <entry>This week</entry>
+ </row>
+ <row>
+ <entry><literal>%[d</literal></entry>
+ <entry>Today</entry>
+ </row>
+ <row>
+ <entry><literal>%[4H</literal></entry>
+ <entry>In the last 4 hours</entry>
</row>
</tbody>
</tgroup>
</table>
- </sect2>
-<!--
- <sect2 id="index-color-sort">
- <title>Sort</title>
- <para>None</para>
- </sect2>
--->
+ <sect3 id="cond-date-example1">
+ <title>Example 1</title>
- <sect2 id="index-color-muttrc">
- <title>Muttrc</title>
+ <para>We start with a one-condition test.</para>
+
+ <table id="table-cond-date-example1">
+ <title>Example 1</title>
+ <tgroup cols="4">
+ <thead>
+ <row>
+ <entry>Test</entry>
+ <entry>Date Range</entry>
+ <entry>Format String</entry>
+ <entry>Example</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>%[1m</literal></entry>
+ <entry>This month</entry>
+ <entry><literal>%[%b %d]</literal></entry>
+ <entry>Dec 10</entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry>Older</entry>
+ <entry><literal>%[%Y-%m-%d]</literal></entry>
+ <entry>2015-04-23</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ <para>The $index_format string would contain:</para>
<screen>
-<emphasis role="comment"># Example Mutt config file for the 'index-color' feature.
-
-# Entire index line</emphasis>
-color index white black '.*'
-
-<emphasis role="comment"># Author name, %A %a %F %L %n
-
-# Give the author column a dark grey background</emphasis>
-color index_author default color234 '.*'
-
-<emphasis role="comment"># Highlight a particular from (~f)</emphasis>
-color index_author brightyellow color234 '~fRay Charles'
-
-<emphasis role="comment"># Message flags, %S %Z
-# Highlight the flags for flagged (~F) emails</emphasis>
-color index_flags default red '~F'
-
-<emphasis role="comment"># Subject, %s
-# Look for a particular subject (~s)</emphasis>
-color index_subject brightcyan default '~s\(closes #[0-9]+\)'
-
-<emphasis role="comment"># Number of messages in a collapsed thread, %M</emphasis>
-color index_collapsed default brightblue
-
-<emphasis role="comment"># Date field</emphasis>
-color index_date green default
-
-<emphasis role="comment"># Message label, %y %Y</emphasis>
-color index_label default brightgreen
-
-<emphasis role="comment"># Message number, %C</emphasis>
-color index_number red default
-
-<emphasis role="comment"># Message size, %c %l</emphasis>
-color index_size cyan default
+%?[1m?%[%b %d]&%[%Y-%m-%d]?
+</screen>
-<emphasis role="comment"># vim: syntax=muttrc</emphasis>
+ <para>
+ Reparsed a little, for clarity, you can see the
+ test condition and the two format strings.
+ </para>
+
+<screen>
+%?[1m? & ?
+ %[%b %d] %[%Y-%m-%d]
</screen>
- </sect2>
- <sect2 id="index-color-see-also">
- <title>See Also</title>
+ </sect3>
- <itemizedlist>
- <listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
- <listitem><para><link linkend="regexp">Regular Expressions</link></para></listitem>
- <listitem><para><link linkend="patterns">Patterns</link></para></listitem>
- <listitem><para><link linkend="index-format">$index_format</link></para></listitem>
- <listitem><para><link linkend="color">Color command</link></para></listitem>
- <listitem><para><link linkend="status-color">Status-Color patch</link></para></listitem>
- <listitem><para><link linkend="keywords">Keywords patch</link></para></listitem>
- </itemizedlist>
- </sect2>
+ <sect3 id="cond-date-example2">
+ <title>Example 2</title>
- <sect2 id="index-color-known-bugs">
- <title>Known Bugs</title>
- <para>None</para>
- </sect2>
+ <para>
+ This example contains three test conditions and four date formats.
+ </para>
- <sect2 id="index-color-credits">
- <title>Credits</title>
- <itemizedlist>
- <listitem><para>Christian Aichinger <email>Greek0@gmx.net</email></para></listitem>
- <listitem><para>Christoph <quote>Myon</quote> Berg <email>myon@debian.org</email></para></listitem>
- <listitem><para>Elimar Riesebieter <email>riesebie@lxtec.de</email></para></listitem>
- <listitem><para>Eric Davis <email>edavis@insanum.com</email></para></listitem>
- <listitem><para>Vladimir Marek <email>Vladimir.Marek@oracle.com</email></para></listitem>
- <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
- </itemizedlist>
- </sect2>
-</sect1>
+ <table id="table-cond-date-example2">
+ <title>Example 2</title>
+ <tgroup cols="4">
+ <thead>
+ <row>
+ <entry>Test</entry>
+ <entry>Date Range</entry>
+ <entry>Format String</entry>
+ <entry>Example</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>%[d</literal></entry>
+ <entry>Today</entry>
+ <entry><literal>%[%H:%M ] </literal></entry>
+ <entry>12:34</entry>
+ </row>
+ <row>
+ <entry><literal>%[m</literal></entry>
+ <entry>This month</entry>
+ <entry><literal>%[%a %d]</literal></entry>
+ <entry>Thu 12</entry>
+ </row>
+ <row>
+ <entry><literal>%[y</literal></entry>
+ <entry>This year</entry>
+ <entry><literal>%[%b %d]</literal></entry>
+ <entry>Dec 10</entry>
+ </row>
+ <row>
+ <entry></entry>
+ <entry>Older</entry>
+ <entry><literal>%[%m/%y ]</literal></entry>
+ <entry>06/15</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
-<sect1 id="nested-if">
- <title>Nested If Patch</title>
- <subtitle>Allow complex nested conditions in format strings</subtitle>
+ <para>The $index_format string would contain:</para>
+
+<screen>
+%<[y?%<[m?%<[d?%[%H:%M ]&%[%a %d]>&%[%b %d]>&%[%m/%y ]>
+</screen>
- <sect2 id="nested-if-patch">
- <title>Patch</title>
+ <para>
+ Reparsed a little, for clarity, you can see the
+ test conditions and the four format strings.
+ </para>
- <para>
- To check if Mutt supports <quote>Nested If</quote>, look for
- <quote>patch-nested-if</quote> in the mutt version.
- See: <xref linkend="mutt-patches"/>.
- </para>
+<screen>
+%<[y? &%[%m/%y ]> Older
+ %<[m? &%[%b %d]> This year
+ %<[d? &%[%a %d]> This month
+ %[%H:%M ] Today
+</screen>
- <itemizedlist>
- <title>Dependencies:</title>
- <listitem><para>mutt-1.6.1</para></listitem>
- </itemizedlist>
-
- <para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
- </sect2>
-
- <sect2 id="nested-if-intro">
- <title>Introduction</title>
-
- <para>
- Mutt's format strings can contain embedded if-then-else conditions.
- They are of the form:
- </para>
-
-<screen>
-%?VAR?TRUE&FALSE?
-</screen>
-
- <para>
- If the variable <quote>VAR</quote> has a value greater than zero,
- print the <quote>TRUE</quote> string, otherwise print the
- <quote>FALSE</quote> string.
- </para>
-
- <para>
- e.g. <literal>%?S?Size: %S&Empty?</literal>
- </para>
-
- <para>Which can be read as:</para>
-
- <literallayout>
- if (%S > 0) {
- print "Size: %S"
- } else {
- print "Empty"
- }
- </literallayout>
-
- <para>
- These conditions are useful, but in Mutt they cannot be nested
- within one another. This patch uses the notation
- <literal>%<VAR?TRUE&FALSE></literal> and allows them to be nested.
- </para>
-
- <para>
- The <literal>%<...></literal> notation was used to format the
- current local time. but that's not really very useful since mutt
- has no means of refreshing the screen periodically.
- </para>
-
- <para>
- A simple nested condition might be:
- (Some whitespace has been introduced for clarity)
- </para>
-
- <literallayout>
- %<x? %<y? XY & X > & %<y? Y & NONE > > Conditions
- %<y? XY & X > x>0
- XY x>0,y>0
- X x>0,y=0
- </literallayout>
-
- <literallayout>
- %<x? %<y? XY & X > & %<y? Y & NONE > > Conditions
- %<y? Y & NONE > x=0
- Y x=0,y>0
- NONE x=0,y=0
- </literallayout>
-
- <para>Equivalent to:</para>
-
- <literallayout>
- if (x > 0) {
- if (y > 0) {
- print 'XY'
- } else {
- print 'X'
- }
- } else {
- if (y > 0) {
- print 'Y'
- } else {
- print 'NONE'
- }
- }
- </literallayout>
-
- <para>Examples:</para>
-
-<screen>
-set index_format='%4C %Z %{%b %d} %-25.25n %s%> %<M?%M Msgs &%<l?%l Lines&%c Bytes>>'
-</screen>
-
- <literallayout>
- if a thread is folded
- display the number of messages (%M)
- else if we know how many lines in the message
- display lines in message (%l)
- else
- display the size of the message in bytes (%c)
- </literallayout>
+ <para>
+ This a another view of the same example, with some whitespace
+ for clarity.
+ </para>
<screen>
-set index_format='%4C %Z %{%b %d} %-25.25n %<M?[%M] %s&%s%* %<l?%l&%c>>'
+%<[y? %<[m? %<[d? AAA & BBB > & CCC > & DDD >
</screen>
- <literallayout>
- if a thread is folded
- display the number of messages (%M)
- display the subject (%s)
- else if we know how many lines in the message
- display lines in message (%l)
- else
- display the size of the message in bytes (%c)
- </literallayout>
-
+ <literallayout>
+AAA = %[%H:%M ]
+BBB = %[%a %d]
+CCC = %[%b %d]
+DDD = %[%m/%y ]
+ </literallayout>
+ </sect3>
</sect2>
- <sect2 id="nested-if-variables">
+ <sect2 id="cond-date-variables">
<title>Variables</title>
- The <quote>nested-if</quote> patch doesn't have any config of its own.
+
+ <para>
+ The <quote>cond-date</quote> patch doesn't have any config of its own.
It modifies the behavior of the format strings.
+ </para>
</sect2>
<!--
- <sect2 id="nested-if-functions">
+ <sect2 id="cond-date-functions">
<title>Functions</title>
<para>None</para>
</sect2>
- <sect2 id="nested-if-commands">
+ <sect2 id="cond-date-commands">
<title>Commands</title>
<para>None</para>
</sect2>
- <sect2 id="nested-if-colors">
+ <sect2 id="cond-date-colors">
<title>Colors</title>
<para>None</para>
</sect2>
- <sect2 id="nested-if-sort">
+ <sect2 id="cond-date-sort">
<title>Sort</title>
<para>None</para>
</sect2>
-->
- <sect2 id="nested-if-muttrc">
+ <sect2 id="cond-date-muttrc">
<title>Muttrc</title>
<screen>
-<emphasis role="comment"># Example Mutt config file for the 'nested-if' feature.
-
-# This patch uses the format: '%<VAR?TRUE&FALSE>' for conditional
-# format strings that can be nested.
-
-# Example 1
-# if a thread is folded
-# display the number of messages (%M)
-# else if we know how many lines in the message
-# display lines in message (%l)
-# else display the size of the message in bytes (%c)</emphasis>
-set index_format='%4C %Z %{%b %d} %-25.25n %s%> %<M?%M Msgs &%<l?%l Lines&%c Bytes>>'
+<emphasis role="comment"># Example Mutt config file for the 'index-color' feature.
+#
+# The default index_format is:
+# '%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s'
+#
+# We replace the date field '%{%b %d}', giving:</emphasis>
+set index_format='%4C %Z %<[y?%<[m?%<[d?%[%H:%M ]&%[%a %d]>&%[%b %d]>&%[%m/%y ]> %-15.15L (%?l?%4l&%4c?) %s'
-<emphasis role="comment"># Example 2
-# if a thread is folded
-# display the number of messages (%M)
-# display the subject (%s)
-# else if we know how many lines in the message
-# display lines in message (%l)
-# else
-# display the size of the message in bytes (%c)</emphasis>
-set index_format='%4C %Z %{%b %d} %-25.25n %<M?[%M] %s&%s%* %<l?%l&%c>>'
+<emphasis role="comment"># Test Date Range Format String Example
+# --------------------------------------------
+# %[d Today %[%H:%M ] 12:34
+# %[m This month %[%a %d] Thu 12
+# %[y This year %[%b %d] Dec 10
+# - Older %[%m/%y ] 06/15
-<emphasis role="comment"># vim: syntax=muttrc</emphasis>
+# vim: syntax=muttrc</emphasis>
</screen>
</sect2>
- <sect2 id="nested-if-see-also">
+ <sect2 id="cond-date-see-also">
<title>See Also</title>
<itemizedlist>
<listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
- <listitem><para><link linkend="cond-date">cond-date patch</link></para></listitem>
<listitem><para><link linkend="index-format">$index_format</link></para></listitem>
- <listitem><para><link linkend="status-format">$status_format</link></para></listitem>
+ <listitem><para><link linkend="nested-if">nested-if patch</link></para></listitem>
+ <listitem><para><literal>strftime(3)</literal></para></listitem>
</itemizedlist>
</sect2>
- <sect2 id="nested-if-known-bugs">
+ <sect2 id="cond-date-known-bugs">
<title>Known Bugs</title>
- Patch overwrites $<fmt> handler in <literal>$index_format</literal>
+
+ <para>
+ Date parsing doesn't quite do what you expect.
+ <quote>1w</quote> doesn't mean the <quote>in the last 7 days</quote>, but
+ <quote><emphasis>this</emphasis> week</quote>. This doesn't match
+ the normal Mutt behaviour: for example <literal>~d>1w</literal>
+ means emails dated in the last 7 days.
+ </para>
+
</sect2>
- <sect2 id="nested-if-credits">
+ <sect2 id="cond-date-credits">
<title>Credits</title>
<itemizedlist>
- <listitem><para>David Champion <email>dgc@uchicago.edu</email></para></listitem>
+ <listitem><para>Aaron Schrab <email>aaron@schrab.com</email></para></listitem>
+ <listitem><para>Eric Davis <email>edavis@insanum.com</email></para></listitem>
<listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
</itemizedlist>
</sect2>
</sect1>
-<sect1 id="cond-date">
- <title>Conditional Dates Patch</title>
- <subtitle>Use rules to choose date format</subtitle>
+<sect1 id="fmemopen">
+ <title>Fmemopen Patch</title>
+ <subtitle>Replace some temporary files with memory buffers</subtitle>
- <sect2 id="cond-date-patch">
+ <sect2 id="fmemopen-patch">
<title>Patch</title>
<para>
- To check if Mutt supports <quote>Conditional Dates</quote>, look for
- <quote>patch-cond-date</quote> in the mutt version.
+ To check if Mutt supports <quote>fmemopen</quote>, look for
+ <quote>patch-fmemopen</quote> in the mutt version.
See: <xref linkend="mutt-patches"/>.
</para>
<itemizedlist>
<title>Dependencies:</title>
<listitem><para>mutt-1.6.1</para></listitem>
- <listitem><para><link linkend="nested-if">nested-if patch</link></para></listitem>
+ <listitem><para><literal>open_memstream()</literal>, <literal>fmemopen()</literal> from glibc</para></listitem>
</itemizedlist>
- <para>
- This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.
- </para>
+ <para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
</sect2>
- <sect2 id="cond-date-intro">
+ <sect2 id="fmemopen-intro">
<title>Introduction</title>
- <para>
- The <quote>cond-date</quote> patch allows you to construct
- <link linkend="index-format">$index_format</link> expressions based on the age of the email.
- </para>
+ <para>
+ The <quote>fmemopen</quote> patch speeds up some searches.
+ </para>
- <para>
- Mutt's default <literal>$index_format</literal> displays email dates in the
- form: abbreviated-month day-of-month — <quote>Jan 14</quote>.
- </para>
+ <para>
+ This patch changes a few places where Mutt creates temporary files.
+ It replaces them with in-memory buffers. This should improve the
+ performance when searching the header or body using the
+ <link linkend="thorough-search">$thorough_search</link> option.
+ </para>
- <para>
- The format is configurable but only per-mailbox. This patch allows you
- to configure the display depending on the age of the email.
- </para>
+ <para>
+ There are no user-configurable parts.
+ </para>
- <table id="table-cond-date-scheme">
- <title>Potential Formatting Scheme</title>
- <tgroup cols="3">
- <thead>
- <row>
- <entry>Email Sent</entry>
- <entry>Format</entry>
- <entry>Example</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>Today</entry>
- <entry><literal>%H:%M</literal></entry>
- <entry>13:23</entry>
- </row>
- <row>
- <entry>This Month</entry>
- <entry><literal>%a %d</literal></entry>
- <entry>Thu 17</entry>
- </row>
- <row>
- <entry>This Year</entry>
- <entry><literal>%b %d</literal></entry>
- <entry>Dec 10</entry>
- </row>
- <row>
- <entry>Older than 1 Year</entry>
- <entry><literal>%m/%y</literal></entry>
- <entry>06/14</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
+ <para>
+ This patch depends on <literal>open_memstream()</literal> and
+ <literal>fmemopen()</literal>. They are provided by glibc. Without
+ them, Mutt will simply create temporary files.
+ </para>
+ </sect2>
- <para>
- For an explanation of the date formatting strings, see
- <literal>strftime(3).</literal>
- </para>
+<!--
+ <sect2 id="fmemopen-variables">
+ <title>Variables</title>
+ <para>None</para>
+ </sect2>
- <para>
- By carefully picking your formats, the dates can remain
- unambiguous and compact.
- </para>
+ <sect2 id="fmemopen-functions">
+ <title>Functions</title>
+ <para>None</para>
+ </sect2>
- <para>
- Mutt's conditional format strings have the form:
- (whitespace introduced for clarity)
- </para>
+ <sect2 id="fmemopen-commands">
+ <title>Commands</title>
+ <para>None</para>
+ </sect2>
- <screen>%? TEST ? TRUE & FALSE ?</screen>
+ <sect2 id="fmemopen-colors">
+ <title>Colors</title>
+ <para>None</para>
+ </sect2>
- <para>
- The examples below use the test <quote>%[</quote> — the date
- of the message in the local timezone. They will also work with
- <quote>%(</quote> — the local time that the message arrived.
- </para>
+ <sect2 id="fmemopen-sort">
+ <title>Sort</title>
+ <para>None</para>
+ </sect2>
+-->
- <para>
- The date tests are of the form:
- </para>
+ <sect2 id="fmemopen-muttrc">
+ <title>Muttrc</title>
+ <para>None</para>
+ </sect2>
- <screen>%[nX? TRUE & FALSE ?</screen>
+ <sect2 id="fmemopen-see-also">
+ <title>See Also</title>
<itemizedlist>
- <listitem><para><quote>n</quote> is an optional count (defaults to 1 if missing)</para></listitem>
- <listitem><para><quote>X</quote> is the time period</para></listitem>
+ <listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
+ <listitem><para><link linkend="compile-time-features">Compile-Time Features</link></para></listitem>
+ <listitem><para><literal>fmemopen(3)</literal></para></listitem>
</itemizedlist>
+ </sect2>
- <table id="table-cond-date-format-codes">
- <title>Date Formatting Codes</title>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>Letter</entry>
- <entry>Time Period</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>y</entry>
- <entry>Years</entry>
- </row>
- <row>
- <entry>m</entry>
- <entry>Months</entry>
- </row>
- <row>
- <entry>w</entry>
- <entry>Weeks</entry>
- </row>
- <row>
- <entry>d</entry>
- <entry>Days</entry>
- </row>
- <row>
- <entry>H</entry>
- <entry>Hours</entry>
- </row>
- <row>
- <entry>M</entry>
- <entry>Minutes</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
+ <sect2 id="fmemopen-known-bugs">
+ <title>Known Bugs</title>
+ <para>None</para>
+ </sect2>
- <table id="table-cond-date-example-tests">
- <title>Example Date Tests</title>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>Test</entry>
- <entry>Meaning</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry><literal>%[y</literal></entry>
- <entry>This year</entry>
- </row>
- <row>
- <entry><literal>%[1y</literal></entry>
- <entry>This year</entry>
- </row>
- <row>
- <entry><literal>%[6m</literal></entry>
- <entry>In the last 6 months</entry>
- </row>
- <row>
- <entry><literal>%[w</literal></entry>
- <entry>This week</entry>
- </row>
- <row>
- <entry><literal>%[d</literal></entry>
- <entry>Today</entry>
- </row>
- <row>
- <entry><literal>%[4H</literal></entry>
- <entry>In the last 4 hours</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
+ <sect2 id="fmemopen-credits">
+ <title>Credits</title>
+ <itemizedlist>
+ <listitem><para>Julius Plenz <email>plenz@cis.fu-berlin.de</email></para></listitem>
+ <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
+ </itemizedlist>
+ </sect2>
+</sect1>
- <sect3 id="cond-date-example1">
- <title>Example 1</title>
+<sect1 id="ifdef">
+ <title>Ifdef Patch</title>
+ <subtitle>Conditional config options</subtitle>
- <para>We start with a one-condition test.</para>
+ <sect2 id="ifdef-patch">
+ <title>Patch</title>
- <table id="table-cond-date-example1">
- <title>Example 1</title>
- <tgroup cols="4">
- <thead>
- <row>
- <entry>Test</entry>
- <entry>Date Range</entry>
- <entry>Format String</entry>
- <entry>Example</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry><literal>%[1m</literal></entry>
- <entry>This month</entry>
- <entry><literal>%[%b %d]</literal></entry>
- <entry>Dec 10</entry>
- </row>
- <row>
- <entry></entry>
- <entry>Older</entry>
- <entry><literal>%[%Y-%m-%d]</literal></entry>
- <entry>2015-04-23</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
+ <para>
+ To check if Mutt supports <quote>ifdef</quote>, look for
+ <quote>patch-ifdef</quote> in the mutt version.
+ See: <xref linkend="mutt-patches"/>.
+ </para>
- <para>The $index_format string would contain:</para>
-<screen>
-%?[1m?%[%b %d]&%[%Y-%m-%d]?
-</screen>
-
- <para>
- Reparsed a little, for clarity, you can see the
- test condition and the two format strings.
- </para>
+ <itemizedlist>
+ <title>Dependencies:</title>
+ <listitem><para>mutt-1.6.1</para></listitem>
+ </itemizedlist>
+
+ <para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
+ </sect2>
+
+ <sect2 id="ifdef-intro">
+ <title>Introduction</title>
+
+ <para>
+ The <quote>ifdef</quote> patch introduces three new commands to
+ Mutt and allow you to share one config file between versions of Mutt
+ that may have different features compiled in.
+ </para>
<screen>
-%?[1m? & ?
- %[%b %d] %[%Y-%m-%d]
+ifdef symbol config-command [args...] <emphasis role="comment"># If a symbol is defined</emphasis>
+ifndef symbol config-command [args...] <emphasis role="comment"># If a symbol is not defined</emphasis>
+finish <emphasis role="comment"># Finish reading the current file</emphasis>
</screen>
- </sect3>
+ <para>
+ Here a symbol can be a <link linkend="variables">$variable</link>,
+ <link linkend="functions"><function></link>,
+ <link linkend="commands">command</link> or compile-time symbol, such
+ as <quote>USE_IMAP</quote>.
+ </para>
- <sect3 id="cond-date-example2">
- <title>Example 2</title>
-
- <para>
- This example contains three test conditions and four date formats.
- </para>
-
- <table id="table-cond-date-example2">
- <title>Example 2</title>
- <tgroup cols="4">
- <thead>
- <row>
- <entry>Test</entry>
- <entry>Date Range</entry>
- <entry>Format String</entry>
- <entry>Example</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry><literal>%[d</literal></entry>
- <entry>Today</entry>
- <entry><literal>%[%H:%M ] </literal></entry>
- <entry>12:34</entry>
- </row>
- <row>
- <entry><literal>%[m</literal></entry>
- <entry>This month</entry>
- <entry><literal>%[%a %d]</literal></entry>
- <entry>Thu 12</entry>
- </row>
- <row>
- <entry><literal>%[y</literal></entry>
- <entry>This year</entry>
- <entry><literal>%[%b %d]</literal></entry>
- <entry>Dec 10</entry>
- </row>
- <row>
- <entry></entry>
- <entry>Older</entry>
- <entry><literal>%[%m/%y ]</literal></entry>
- <entry>06/15</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
-
- <para>The $index_format string would contain:</para>
-
-<screen>
-%<[y?%<[m?%<[d?%[%H:%M ]&%[%a %d]>&%[%b %d]>&%[%m/%y ]>
-</screen>
-
- <para>
- Reparsed a little, for clarity, you can see the
- test conditions and the four format strings.
- </para>
-
-<screen>
-%<[y? &%[%m/%y ]> Older
- %<[m? &%[%b %d]> This year
- %<[d? &%[%a %d]> This month
- %[%H:%M ] Today
-</screen>
-
- <para>
- This a another view of the same example, with some whitespace
- for clarity.
- </para>
+ <para>
+ <literal>finish</literal> is particularly useful when combined with
+ <literal>ifndef</literal>. e.g.
+ </para>
<screen>
-%<[y? %<[m? %<[d? AAA & BBB > & CCC > & DDD >
+<emphasis role="comment"># Sidebar config file</emphasis>
+ifndef USE_SIDEBAR finish
</screen>
- <literallayout>
-AAA = %[%H:%M ]
-BBB = %[%a %d]
-CCC = %[%b %d]
-DDD = %[%m/%y ]
- </literallayout>
- </sect3>
</sect2>
- <sect2 id="cond-date-variables">
+<!--
+ <sect2 id="ifdef-variables">
<title>Variables</title>
-
- <para>
- The <quote>cond-date</quote> patch doesn't have any config of its own.
- It modifies the behavior of the format strings.
- </para>
+ <para>None</para>
</sect2>
-<!--
- <sect2 id="cond-date-functions">
+ <sect2 id="ifdef-functions">
<title>Functions</title>
<para>None</para>
</sect2>
+-->
- <sect2 id="cond-date-commands">
+ <sect2 id="ifdef-commands">
<title>Commands</title>
- <para>None</para>
+ <cmdsynopsis>
+ <command>ifdef</command>
+ <arg choice="plain">
+ <replaceable class="parameter">symbol</replaceable>
+ </arg>
+ <arg choice="plain">
+ <replaceable class="parameter">"config-command [args]"</replaceable>
+ </arg>
+ <command>ifndef</command>
+ <arg choice="plain">
+ <replaceable class="parameter">symbol</replaceable>
+ </arg>
+ <arg choice="plain">
+ <replaceable class="parameter">"config-command [args]"</replaceable>
+ </arg>
+ <command>finish</command>
+ </cmdsynopsis>
</sect2>
- <sect2 id="cond-date-colors">
+<!--
+ <sect2 id="ifdef-colors">
<title>Colors</title>
<para>None</para>
</sect2>
- <sect2 id="cond-date-sort">
+ <sect2 id="ifdef-sort">
<title>Sort</title>
<para>None</para>
</sect2>
-->
- <sect2 id="cond-date-muttrc">
+ <sect2 id="ifdef-muttrc">
<title>Muttrc</title>
<screen>
-<emphasis role="comment"># Example Mutt config file for the 'index-color' feature.
-#
-# The default index_format is:
-# '%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s'
-#
-# We replace the date field '%{%b %d}', giving:</emphasis>
-set index_format='%4C %Z %<[y?%<[m?%<[d?%[%H:%M ]&%[%a %d]>&%[%b %d]>&%[%m/%y ]> %-15.15L (%?l?%4l&%4c?) %s'
+<emphasis role="comment"># Example Mutt config file for the 'ifdef' feature.
-<emphasis role="comment"># Test Date Range Format String Example
-# --------------------------------------------
-# %[d Today %[%H:%M ] 12:34
-# %[m This month %[%a %d] Thu 12
-# %[y This year %[%b %d] Dec 10
-# - Older %[%m/%y ] 06/15
+# This feature introduces three useful commands which allow you to share
+# one config file between versions of Mutt that may have different
+# features compiled in.
-# vim: syntax=muttrc</emphasis>
+# ifdef symbol config-command [args...]
+# ifndef symbol config-command [args...]
+# finish
+
+# The 'ifdef' command tests whether Mutt understands the name of
+# a variable, function, command or compile-time symbol.
+# If it does, then it executes a config command.
+
+# The 'ifndef' command tests whether a symbol does NOT exist.
+
+# The 'finish' command tells Mutt to stop reading current config file.
+
+# If the 'trash' variable exists, set it.</emphasis>
+ifdef trash 'set trash=~/Mail/trash'
+
+<emphasis role="comment"># If the 'tag-pattern' function exists, bind a key to it.</emphasis>
+ifdef tag-pattern 'bind index <F6> tag-pattern'
+
+<emphasis role="comment"># If the 'imap-fetch-mail' command exists, read my IMAP config.</emphasis>
+ifdef imap-fetch-mail 'source ~/.mutt/imap.rc'
+
+<emphasis role="comment"># If the compile-time symbol 'USE_SIDEBAR' does not exist, then
+# stop reading the current config file.</emphasis>
+ifndef USE_SIDEBAR finish
+
+<emphasis role="comment"># vim: syntax=muttrc</emphasis>
</screen>
</sect2>
- <sect2 id="cond-date-see-also">
+ <sect2 id="ifdef-see-also">
<title>See Also</title>
<itemizedlist>
<listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
- <listitem><para><link linkend="index-format">$index_format</link></para></listitem>
- <listitem><para><link linkend="nested-if">nested-if patch</link></para></listitem>
- <listitem><para><literal>strftime(3)</literal></para></listitem>
</itemizedlist>
</sect2>
- <sect2 id="cond-date-known-bugs">
+ <sect2 id="ifdef-known-bugs">
<title>Known Bugs</title>
-
- <para>
- Date parsing doesn't quite do what you expect.
- <quote>1w</quote> doesn't mean the <quote>in the last 7 days</quote>, but
- <quote><emphasis>this</emphasis> week</quote>. This doesn't match
- the normal Mutt behaviour: for example <literal>~d>1w</literal>
- means emails dated in the last 7 days.
- </para>
-
+ <para>None</para>
</sect2>
- <sect2 id="cond-date-credits">
+ <sect2 id="ifdef-credits">
<title>Credits</title>
<itemizedlist>
- <listitem><para>Aaron Schrab <email>aaron@schrab.com</email></para></listitem>
- <listitem><para>Eric Davis <email>edavis@insanum.com</email></para></listitem>
+ <listitem><para>Cedric Duval <email>cedricduval@free.fr</email></para></listitem>
+ <listitem><para>Matteo F. Vescovi <email>mfvescovi@gmail.com</email></para></listitem>
<listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
</itemizedlist>
</sect2>
</sect1>
-<sect1 id="tls-sni">
- <title>TLS-SNI Patch</title>
- <subtitle>Negotiate with a server for a TSL/SSL certificate</subtitle>
+<sect1 id="index-color">
+ <title>Index Color Patch</title>
+ <subtitle>Custom rules for theming the email index</subtitle>
- <sect2 id="tls-sni-patch">
+ <sect2 id="index-color-patch">
<title>Patch</title>
<para>
- To check if Mutt supports <quote>TLS-SNI</quote>, look for
- <quote>patch-tls-sni</quote> in the mutt version.
+ To check if Mutt supports <quote>Index Color</quote>, look for
+ <quote>patch-index-color</quote> in the mutt version.
See: <xref linkend="mutt-patches"/>.
</para>
<itemizedlist>
<title>Dependencies:</title>
<listitem><para>mutt-1.6.1</para></listitem>
- <listitem><para>OpenSSL</para></listitem>
+ <listitem><para><link linkend="status-color">status-color patch</link></para></listitem>
</itemizedlist>
<para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
</sect2>
- <sect2 id="tls-sni-intro">
+ <sect2 id="index-color-intro">
<title>Introduction</title>
- <para>
- The <quote>TLS-SNI</quote> patch adds support for TLS virtual hosting.
- If your mail server doesn't support this everything will still work
- normally.
- </para>
+ <para>
+ The <quote>index-color</quote> patch allows you to specify colors for
+ individual parts of the email index. e.g. Subject, Author, Flags.
+ </para>
- <para>
- TLS supports sending the expected server hostname during the
- handshake, via the SNI extension. This can be used to select a
- server certificate to issue to the client, permitting
- virtual-hosting without requiring multiple IP addresses.
- </para>
+ <para>
+ First choose which part of the index you'd like to color.
+ Then, if needed, pick a pattern to match.
+ </para>
<para>
- This has been tested against Exim 4.80, which optionally logs SNI
- and can perform vhosting.
+ Note: The pattern does not have to refer to the object you wish to
+ color. e.g.
</para>
- <para>
- To verify TLS SNI support by a server, you can use:
- </para>
-
<screen>
-openssl s_client -host <imap server> -port <port> -tls1 -servername <imap server>
+color index_author red default "~smutt"
</screen>
+
+ <para>
+ The author appears red when the subject (~s) contains <quote>mutt</quote>.
+ </para>
</sect2>
<!--
- <sect2 id="tls-sni-variables">
+ <sect2 id="index-color-variables">
<title>Variables</title>
<para>None</para>
</sect2>
- <sect2 id="tls-sni-functions">
+ <sect2 id="index-color-functions">
<title>Functions</title>
<para>None</para>
</sect2>
- <sect2 id="tls-sni-commands">
+ <sect2 id="index-color-commands">
<title>Commands</title>
<para>None</para>
</sect2>
+-->
- <sect2 id="tls-sni-colors">
+ <sect2 id="index-color-colors">
<title>Colors</title>
- <para>None</para>
- </sect2>
-
- <sect2 id="tls-sni-sort">
- <title>Sort</title>
- <para>None</para>
- </sect2>
--->
- <sect2 id="tls-sni-muttrc">
- <title>Muttrc</title>
- <para>None</para>
- </sect2>
+ <para>
+ All the colors default to <literal>default</literal>, i.e. unset.
+ </para>
- <sect2 id="tls-sni-see-also">
+ <para>
+ The index objects can be themed using the <literal>color</literal> command.
+ Some objects require a pattern.
+ </para>
+
+<screen>
+color index-object foreground background
+color index-object foreground background pattern
+</screen>
+
+ <table id="table-index-color-colors">
+ <title>Index Colors</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Object</entry>
+ <entry>Pattern</entry>
+ <entry>Highlights</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>index</literal></entry>
+ <entry>yes</entry>
+ <entry>Entire index line</entry>
+ </row>
+ <row>
+ <entry><literal>index_author</literal></entry>
+ <entry>yes</entry>
+ <entry>Author name, %A %a %F %L %n</entry>
+ </row>
+ <row>
+ <entry><literal>index_collapsed</literal></entry>
+ <entry>no</entry>
+ <entry>Number of messages in a collapsed thread, %M</entry>
+ </row>
+ <row>
+ <entry><literal>index_date</literal></entry>
+ <entry>no</entry>
+ <entry>Date field</entry>
+ </row>
+ <row>
+ <entry><literal>index_flags</literal></entry>
+ <entry>yes</entry>
+ <entry>Message flags, %S %Z</entry>
+ </row>
+ <row>
+ <entry><literal>index_label</literal></entry>
+ <entry>no</entry>
+ <entry>Message label, %y %Y</entry>
+ </row>
+ <row>
+ <entry><literal>index_number</literal></entry>
+ <entry>no</entry>
+ <entry>Message number, %C</entry>
+ </row>
+ <row>
+ <entry><literal>index_size</literal></entry>
+ <entry>no</entry>
+ <entry>Message size, %c %l</entry>
+ </row>
+ <row>
+ <entry><literal>index_subject</literal></entry>
+ <entry>yes</entry>
+ <entry>Subject, %s</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect2>
+
+<!--
+ <sect2 id="index-color-sort">
+ <title>Sort</title>
+ <para>None</para>
+ </sect2>
+-->
+
+ <sect2 id="index-color-muttrc">
+ <title>Muttrc</title>
+<screen>
+<emphasis role="comment"># Example Mutt config file for the 'index-color' feature.
+
+# Entire index line</emphasis>
+color index white black '.*'
+
+<emphasis role="comment"># Author name, %A %a %F %L %n
+
+# Give the author column a dark grey background</emphasis>
+color index_author default color234 '.*'
+
+<emphasis role="comment"># Highlight a particular from (~f)</emphasis>
+color index_author brightyellow color234 '~fRay Charles'
+
+<emphasis role="comment"># Message flags, %S %Z
+# Highlight the flags for flagged (~F) emails</emphasis>
+color index_flags default red '~F'
+
+<emphasis role="comment"># Subject, %s
+# Look for a particular subject (~s)</emphasis>
+color index_subject brightcyan default '~s\(closes #[0-9]+\)'
+
+<emphasis role="comment"># Number of messages in a collapsed thread, %M</emphasis>
+color index_collapsed default brightblue
+
+<emphasis role="comment"># Date field</emphasis>
+color index_date green default
+
+<emphasis role="comment"># Message label, %y %Y</emphasis>
+color index_label default brightgreen
+
+<emphasis role="comment"># Message number, %C</emphasis>
+color index_number red default
+
+<emphasis role="comment"># Message size, %c %l</emphasis>
+color index_size cyan default
+
+<emphasis role="comment"># vim: syntax=muttrc</emphasis>
+</screen>
+ </sect2>
+
+ <sect2 id="index-color-see-also">
<title>See Also</title>
<itemizedlist>
<listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
+ <listitem><para><link linkend="regexp">Regular Expressions</link></para></listitem>
+ <listitem><para><link linkend="patterns">Patterns</link></para></listitem>
+ <listitem><para><link linkend="index-format">$index_format</link></para></listitem>
+ <listitem><para><link linkend="color">Color command</link></para></listitem>
+ <listitem><para><link linkend="status-color">Status-Color patch</link></para></listitem>
+ <listitem><para><link linkend="keywords">Keywords patch</link></para></listitem>
</itemizedlist>
</sect2>
- <sect2 id="tls-sni-known-bugs">
+ <sect2 id="index-color-known-bugs">
<title>Known Bugs</title>
<para>None</para>
</sect2>
- <sect2 id="tls-sni-credits">
+ <sect2 id="index-color-credits">
<title>Credits</title>
<itemizedlist>
- <listitem><para>Jeremy Katz <email>katzj@linuxpower.org</email></para></listitem>
- <listitem><para>Phil Pennock <email>mutt-dev@spodhuis.demon.nl</email></para></listitem>
+ <listitem><para>Christian Aichinger <email>Greek0@gmx.net</email></para></listitem>
+ <listitem><para>Christoph <quote>Myon</quote> Berg <email>myon@debian.org</email></para></listitem>
+ <listitem><para>Elimar Riesebieter <email>riesebie@lxtec.de</email></para></listitem>
+ <listitem><para>Eric Davis <email>edavis@insanum.com</email></para></listitem>
+ <listitem><para>Vladimir Marek <email>Vladimir.Marek@oracle.com</email></para></listitem>
<listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
</itemizedlist>
</sect2>
</sect1>
-<sect1 id="sidebar">
- <title>Sidebar Patch</title>
- <subtitle>Overview of mailboxes</subtitle>
+<sect1 id="initials">
+ <title>Initials Expando Patch</title>
+ <subtitle>Expando for author's initials</subtitle>
- <sect2 id="sidebar-patch">
- <title>Patch</title>
+ <sect2 id="initials-patch">
+ <title>Patch</title>
- <para>
- To check if Mutt supports <quote>Sidebar</quote>, look for
- <quote>+USE_SIDEBAR</quote> in the mutt version.
- See: <xref linkend="compile-time-features"/>.
- </para>
+ To check if Mutt supports <quote>Initials</quote>, look for
+ <quote>patch-initials</quote> in the mutt version.
+ See: <xref linkend="mutt-patches"/>.
+ </para>
- <itemizedlist>
- <title>Dependencies:</title>
- <listitem><para>mutt-1.6.1</para></listitem>
- </itemizedlist>
+ <itemizedlist>
+ <title>Dependencies:</title>
+
<listitem><para>mutt-1.6.1</para></listitem>
+ </itemizedlist>
- <para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
- </sect2>
+
<para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
+ </sect2>
- <sect2 id="sidebar-intro">
- <title>Introduction</title>
+ <sect2 id="initials-intro">
+ <title>Introduction</title>
- <para>
- The Sidebar shows a list of all your mailboxes. The list can be
- turned on and off, it can be themed and the list style can be
- configured.
- </para>
+ <para>
+ The <quote>initials</quote> patch adds an expando (%I) for an author's
+ initials.
+ </para>
- <para>
- This part of the manual is a reference guide.
- If you want a simple introduction with examples see the
- <link linkend="intro-sidebar">Sidebar Howto</link>.
- If you just want to get started, you could use the sample
- <link linkend="sidebar-muttrc">Sidebar muttrc</link>.
- </para>
+ The index panel displays a list of emails. Its layout is controlled by
+ the <link linkend="index-format">$index_format</link> variable. Using
+ this expando saves space in the index panel. This can be useful if you
+ are regularly working with a small set of people.
+ </para>
+ </sect2>
- <para>
- This version of Sidebar is based on Terry Chan's
- <ulink url="http://www.lunar-linux.org/mutt-sidebar/">2015-11-11 release</ulink>.
- It contains many
- <emphasis role="bold"><link linkend="intro-sidebar-features">new features</link></emphasis>,
- lots of
- <emphasis role="bold"><link linkend="intro-sidebar-bugfixes">bugfixes</link></emphasis>.
- </para>
- </sect2>
+ <sect2 id="initials-variables">
+ <title>Variables</title>
- <sect2 id="sidebar-variables">
- <title>Variables</title>
+ <para>
+ This patch has no config of its own. It adds an expando which can be
+ used in the <link linkend="index-format">$index_format</link> variable.
+ </para>
+ </sect2>
- <table id="table-sidebar-variables">
- <title>Sidebar Variables</title>
- <tgroup cols="3">
- <thead>
- <row>
- <entry>Name</entry>
- <entry>Type</entry>
- <entry>Default</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry><literal>sidebar_delim_chars</literal></entry>
- <entry>string</entry>
- <entry><literal>/.</literal></entry>
- </row>
- <row>
- <entry><literal>sidebar_divider_char</literal></entry>
- <entry>string</entry>
- <entry><literal>|</literal></entry>
- </row>
- <row>
- <entry><literal>sidebar_folder_indent</literal></entry>
- <entry>boolean</entry>
- <entry><literal>no</literal></entry>
- </row>
- <row>
- <entry><literal>sidebar_format</literal></entry>
- <entry>string</entry>
- <entry><literal>%B%* %n</literal></entry>
- </row>
- <row>
- <entry><literal>sidebar_indent_string</literal></entry>
- <entry>string</entry>
- <entry><literal> </literal> (two spaces)</entry>
- </row>
- <row>
- <entry><literal>sidebar_new_mail_only</literal></entry>
- <entry>boolean</entry>
- <entry><literal>no</literal></entry>
- </row>
- <row>
- <entry><literal>sidebar_next_new_wrap</literal></entry>
- <entry>boolean</entry>
- <entry><literal>no</literal></entry>
- </row>
- <row>
- <entry><literal>sidebar_short_path</literal></entry>
- <entry>boolean</entry>
- <entry><literal>no</literal></entry>
- </row>
- <row>
- <entry><literal>sidebar_sort_method</literal></entry>
- <entry>enum</entry>
- <entry><literal>unsorted</literal></entry>
- </row>
- <row>
- <entry><literal>sidebar_visible</literal></entry>
- <entry>boolean</entry>
- <entry><literal>no</literal></entry>
- </row>
- <row>
- <entry><literal>sidebar_whitelist</literal></entry>
- <entry>list</entry>
- <entry>(empty)</entry>
- </row>
- <row>
- <entry><literal>sidebar_width</literal></entry>
- <entry>number</entry>
- <entry><literal>20</literal></entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </sect2>
-
- <sect2 id="sidebar-functions">
- <title>Functions</title>
-
- <para>
- Sidebar adds the following functions to Mutt.
- By default, none of them are bound to keys.
- </para>
-
- <table id="table-sidebar-functions">
- <title>Sidebar Functions</title>
- <tgroup cols="3">
- <thead>
- <row>
- <entry>Menus</entry>
- <entry>Function</entry>
- <entry>Description</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>index,pager</entry>
- <entry><literal><sidebar-next></literal></entry>
- <entry>Move the highlight to next mailbox</entry>
- </row>
- <row>
- <entry>index,pager</entry>
- <entry><literal><sidebar-next-new></literal></entry>
- <entry>Move the highlight to next mailbox with new mail</entry>
- </row>
- <row>
- <entry>index,pager</entry>
- <entry><literal><sidebar-open></literal></entry>
- <entry>Open highlighted mailbox</entry>
- </row>
- <row>
- <entry>index,pager</entry>
- <entry><literal><sidebar-page-down></literal></entry>
- <entry>Scroll the Sidebar down 1 page</entry>
- </row>
- <row>
- <entry>index,pager</entry>
- <entry><literal><sidebar-page-up></literal></entry>
- <entry>Scroll the Sidebar up 1 page</entry>
- </row>
- <row>
- <entry>index,pager</entry>
- <entry><literal><sidebar-prev></literal></entry>
- <entry>Move the highlight to previous mailbox</entry>
- </row>
- <row>
- <entry>index,pager</entry>
- <entry><literal><sidebar-prev-new></literal></entry>
- <entry>Move the highlight to previous mailbox with new mail</entry>
- </row>
- <row>
- <entry>index,pager</entry>
- <entry><literal><sidebar-toggle-visible></literal></entry>
- <entry>Make the Sidebar (in)visible</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </sect2>
-
- <sect2 id="sidebar-commands">
- <title>Commands</title>
- <cmdsynopsis>
- <command>sidebar_whitelist<anchor id="sidebar-whitelist"/></command>
- <arg choice="plain">
- <replaceable class="parameter">mailbox</replaceable>
- </arg>
- <arg choice="opt" rep="repeat">
- <replaceable class="parameter">mailbox</replaceable>
- </arg>
- </cmdsynopsis>
- </sect2>
-
- <sect2 id="sidebar-colors">
- <title>Colors</title>
-
- <table id="table-sidebar-colors">
- <title>Sidebar Colors</title>
- <tgroup cols="3">
- <thead>
- <row>
- <entry>Name</entry>
- <entry>Default Color</entry>
- <entry>Description</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry><literal>sidebar_divider</literal></entry>
- <entry>default</entry>
- <entry>The dividing line between the Sidebar and the Index/Pager panels</entry>
- </row>
- <row>
- <entry><literal>sidebar_flagged</literal></entry>
- <entry>default</entry>
- <entry>Mailboxes containing flagged mail</entry>
- </row>
- <row>
- <entry><literal>sidebar_highlight</literal></entry>
- <entry>underline</entry>
- <entry>Cursor to select a mailbox</entry>
- </row>
- <row>
- <entry><literal>sidebar_indicator</literal></entry>
- <entry>mutt <literal>indicator</literal></entry>
- <entry>The mailbox open in the Index panel</entry>
- </row>
- <row>
- <entry><literal>sidebar_new</literal></entry>
- <entry>default</entry>
- <entry>Mailboxes containing new mail</entry>
- </row>
- <row>
- <entry><literal>sidebar_spoolfile</literal></entry>
- <entry>default</entry>
- <entry>Mailbox that receives incoming mail</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
+<!--
+ <sect2 id="initials-functions">
+ <title>Functions</title>
+ <para>None</para>
+ </sect2>
- <para>
- If the <literal>sidebar_indicator</literal> color isn't set, then the default Mutt
- indicator color will be used (the color used in the index panel).
- </para>
- </sect2>
+ <sect2 id="initials-commands">
+ <title>Commands</title>
+ <para>None</para>
+ </sect2>
- <sect2 id="sidebar-sort">
- <title>Sort</title>
+ <sect2 id="initials-colors">
+ <title>Colors</title>
+ <para>None</para>
+ </sect2>
- <table id="table-sidebar-sort">
- <title>Sidebar Sort</title>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>Sort</entry>
- <entry>Description</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry><literal>alpha</literal></entry>
- <entry>Alphabetically by path</entry>
- </row>
- <row>
- <entry><literal>count</literal></entry>
- <entry>Total number of messages</entry>
- </row>
- <row>
- <entry><literal>flagged</literal></entry>
- <entry>Number of flagged messages</entry>
- </row>
- <row>
- <entry><literal>name</literal></entry>
- <entry>Alphabetically by path</entry>
- </row>
- <row>
- <entry><literal>new</literal></entry>
- <entry>Number of new messages</entry>
- </row>
- <row>
- <entry><literal>path</literal></entry>
- <entry>Alphabetically by path</entry>
- </row>
- <row>
- <entry><literal>unsorted</literal></entry>
- <entry>Do not resort the paths</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </sect2>
+ <sect2 id="initials-sort">
+ <title>Sort</title>
+ <para>None</para>
+ </sect2>
+-->
- <sect2 id="sidebar-muttrc">
- <title>Muttrc</title>
+ <sect2 id="initials-muttrc">
+ <title>Muttrc</title>
<screen>
-<emphasis role="comment"># This is a complete list of sidebar-related configuration.
+<emphasis role="comment"># Example Mutt config file for the 'initials' patch.
-# --------------------------------------------------------------------------
-# VARIABLES - shown with their default values
-# --------------------------------------------------------------------------
+# The 'initials' patch has no config of its own.
+# It adds an expando for an author's initials,
+# which can be used in the 'index_format' variable.
-# Should the Sidebar be shown?</emphasis>
-set sidebar_visible = no
+# The default 'index_format' is:</emphasis>
+set index_format='%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s'
-<emphasis role="comment"># How wide should the Sidebar be in screen columns?
-# Note: Some characters, e.g. Chinese, take up two columns each.</emphasis>
-set sidebar_width = 20
+<emphasis role="comment"># Where %L represents the author/recipient
-<emphasis role="comment"># Should the mailbox paths be abbreviated?</emphasis>
-set sidebar_short_path = no
+# This might look like:
+# 1 + Nov 17 David Bowie Changesbowie ( 689)
+# 2 ! Nov 17 Stevie Nicks Rumours ( 555)
+# 3 + Nov 16 Jimi Hendrix Voodoo Child ( 263)
+# 4 + Nov 16 Debbie Harry Parallel Lines ( 540)
-<emphasis role="comment"># When abbreviating mailbox path names, use any of these characters as path
-# separators. Only the part after the last separators will be shown.
-# For file folders '/' is good. For IMAP folders, often '.' is useful.</emphasis>
-set sidebar_delim_chars = '/.'
-
-<emphasis role="comment"># If the mailbox path is abbreviated, should it be indented?</emphasis>
-set sidebar_folder_indent = no
-
-<emphasis role="comment"># Indent mailbox paths with this string.</emphasis>
-set sidebar_indent_string = ' '
-
-<emphasis role="comment"># Make the Sidebar only display mailboxes that contain new, or flagged,
-# mail.</emphasis>
-set sidebar_new_mail_only = no
-
-<emphasis role="comment"># Any mailboxes that are whitelisted will always be visible, even if the
-# sidebar_new_mail_only option is enabled.</emphasis>
-sidebar_whitelist '/home/user/mailbox1'
-sidebar_whitelist '/home/user/mailbox2'
-
-<emphasis role="comment"># When searching for mailboxes containing new mail, should the search wrap
-# around when it reaches the end of the list?</emphasis>
-set sidebar_next_new_wrap = no
-
-<emphasis role="comment"># The character to use as the divider between the Sidebar and the other Mutt
-# panels.
-# Note: Only the first character of this string is used.</emphasis>
-set sidebar_divider_char = '|'
-
-<emphasis role="comment"># Display the Sidebar mailboxes using this format string.</emphasis>
-set sidebar_format = '%B%?F? [%F]?%* %?N?%N/?%S'
-
-<emphasis role="comment"># Sidebar will not refresh its list of mailboxes any more frequently than
-# this number of seconds. This will help reduce disk/network traffic.</emphasis>
-set sidebar_refresh_time = 60
-
-<emphasis role="comment"># Sort the mailboxes in the Sidebar using this method:
-# count - total number of messages
-# flagged - number of flagged messages
-# new - number of new messages
-# path - mailbox path
-# unsorted - do not sort the mailboxes</emphasis>
-set sidebar_sort_method = 'unsorted'
-
-<emphasis role="comment"># --------------------------------------------------------------------------
-# FUNCTIONS - shown with an example mapping
-# --------------------------------------------------------------------------
-
-# Move the highlight to the previous mailbox</emphasis>
-bind index,pager \Cp sidebar-prev
-
-<emphasis role="comment"># Move the highlight to the next mailbox</emphasis>
-bind index,pager \Cn sidebar-next
-
-<emphasis role="comment"># Open the highlighted mailbox</emphasis>
-bind index,pager \Co sidebar-open
-
-<emphasis role="comment"># Move the highlight to the previous page
-# This is useful if you have a LOT of mailboxes.</emphasis>
-bind index,pager <F3> sidebar-page-up
-
-<emphasis role="comment"># Move the highlight to the next page
-# This is useful if you have a LOT of mailboxes.</emphasis>
-bind index,pager <F4> sidebar-page-down
-
-<emphasis role="comment"># Move the highlight to the previous mailbox containing new, or flagged,
-# mail.</emphasis>
-bind index,pager <F5> sidebar-prev-new
-
-<emphasis role="comment"># Move the highlight to the next mailbox containing new, or flagged, mail.</emphasis>
-bind index,pager <F6> sidebar-next-new
-
-<emphasis role="comment"># Toggle the visibility of the Sidebar.</emphasis>
-bind index,pager B sidebar-toggle-visible
-
-<emphasis role="comment"># --------------------------------------------------------------------------
-# COLORS - some unpleasant examples are given
-# --------------------------------------------------------------------------
-# Note: All color operations are of the form:
-# color OBJECT FOREGROUND BACKGROUND
-
-# Color of the current, open, mailbox
-# Note: This is a general Mutt option which colors all selected items.</emphasis>
-color indicator cyan black
-
-<emphasis role="comment"># Color of the highlighted, but not open, mailbox.</emphasis>
-color sidebar_highlight black color8
-
-<emphasis role="comment"># Color of the divider separating the Sidebar from Mutt panels</emphasis>
-color sidebar_divider color8 black
-
-<emphasis role="comment"># Color to give mailboxes containing flagged mail</emphasis>
-color sidebar_flagged red black
-
-<emphasis role="comment"># Color to give mailboxes containing new mail</emphasis>
-color sidebar_new green black
+# Using the %I expando:</emphasis>
+set index_format='%4C %Z %{%b %d} %I (%?l?%4l&%4c?) %s'
-<emphasis role="comment"># --------------------------------------------------------------------------
+<emphasis role="comment"># This might look like:
+# 1 + Nov 17 DB Changesbowie ( 689)
+# 2 ! Nov 17 SN Rumours ( 555)
+# 3 + Nov 16 JH Voodoo Child ( 263)
+# 4 + Nov 16 DH Parallel Lines ( 540)
# vim: syntax=muttrc</emphasis>
</screen>
- </sect2>
+ </sect2>
- <sect2 id="sidebar-see-also">
- <title>See Also</title>
+ <sect2 id="initials-see-also">
+ <title>See Also</title>
- <itemizedlist>
- <listitem><para><link linkend="regexp">Regular Expressions</link></para></listitem>
- <listitem><para><link linkend="patterns">Patterns</link></para></listitem>
- <listitem><para><link linkend="color">Color command</link></para></listitem>
- <listitem><para><link linkend="notmuch">notmuch patch</link></para></listitem>
- </itemizedlist>
- </sect2>
+ <itemizedlist>
+ <listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
+ <listitem><para><link linkend="index-format">$index_format</link></para></listitem>
+ <listitem><para><link linkend="index-color">index-color patch</link></para></listitem>
+ <listitem><para><link linkend="folder-hook">folder-hook</link></para></listitem>
+ </itemizedlist>
+ </sect2>
- <sect2 id="sidebar-known-bugs">
- <title>Known Bugs</title>
- Unsorted isn't
- </sect2>
+ <sect2 id="initials-known-bugs">
+ <title>Known Bugs</title>
+ <para>None</para>
+ </sect2>
- <sect2 id="sidebar-credits">
- <title>Credits</title>
- <itemizedlist>
- <listitem><para>Justin Hibbits <email>jrh29@po.cwru.edu</email></para></listitem>
- <listitem><para>Thomer M. Gil <email>mutt@thomer.com</email></para></listitem>
- <listitem><para>David Sterba <email>dsterba@suse.cz</email></para></listitem>
- <listitem><para>Evgeni Golov <email>evgeni@debian.org</email></para></listitem>
- <listitem><para>Fabian Groffen <email>grobian@gentoo.org</email></para></listitem>
- <listitem><para>Jason DeTiberus <email>jdetiber@redhat.com</email></para></listitem>
- <listitem><para>Stefan Assmann <email>sassmann@kpanic.de</email></para></listitem>
- <listitem><para>Steve Kemp <email>steve@steve.org.uk</email></para></listitem>
- <listitem><para>Terry Chan <email>tchan@lunar-linux.org</email></para></listitem>
- <listitem><para>Tyler Earnest <email>tylere@rne.st</email></para></listitem>
- <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
- </itemizedlist>
- </sect2>
+ <sect2 id="initials-credits">
+ <title>Credits</title>
+ <itemizedlist>
+ <listitem><para>Vsevolod Volkov <email>vvv@mutt.org.ua</email></para></listitem>
+ <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
+ </itemizedlist>
+ </sect2>
</sect1>
-<sect1 id="ifdef">
- <title>Ifdef Patch</title>
- <subtitle>Conditional config options</subtitle>
+<sect1 id="keywords">
+ <title>Keywords Patch</title>
+ <subtitle>Labels/Tagging for emails</subtitle>
- <sect2 id="ifdef-patch">
+ <sect2 id="keywords-patch">
<title>Patch</title>
<para>
- To check if Mutt supports <quote>ifdef</quote>, look for
- <quote>patch-ifdef</quote> in the mutt version.
+ To check if Mutt supports <quote>Keywords</quote>, look for
+ <quote>patch-keywords</quote> in the mutt version.
See: <xref linkend="mutt-patches"/>.
</para>
<para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
</sect2>
- <sect2 id="ifdef-intro">
+ <sect2 id="keywords-intro">
<title>Introduction</title>
<para>
- The <quote>ifdef</quote> patch introduces three new commands to
- Mutt and allow you to share one config file between versions of Mutt
- that may have different features compiled in.
+ Unify label/keyword handling.
</para>
-<screen>
-ifdef symbol config-command [args...] <emphasis role="comment"># If a symbol is defined</emphasis>
-ifndef symbol config-command [args...] <emphasis role="comment"># If a symbol is not defined</emphasis>
-finish <emphasis role="comment"># Finish reading the current file</emphasis>
-</screen>
+ <para>
+ Since x-labels were added to mutt in 2000, a number of other approaches
+ to what we now call <quote>tagging</quote> have also emerged.
+ One of them was even made standard in RFC 2822.
+ This update unifies the handling of all these strategies.
+ </para>
<para>
- Here a symbol can be a <link linkend="variables">$variable</link>,
- <link linkend="functions"><function></link>,
- <link linkend="commands">command</link> or compile-time symbol, such
- as <quote>USE_IMAP</quote>.
+ We start by changing mutt's internal keyword storage from a single
+ string which may contain whitespace to a list of discrete keywords.
+ This has advantages for keyword completion as well as for portabilty
+ among varying "standards" for keyword storage. This may represent
+ a significant change for existing mutt users who have set x-labels
+ containing spaces, and should be regarded with suspicion. The
+ advantages are significant, though.
</para>
- <para>
- <literal>finish</literal> is particularly useful when combined with
- <literal>ifndef</literal>. e.g.
- </para>
+ <para>
+ Next we allow mutt to parse keywords into this internal list from
+ any of the following headers: X-Label (freeform), X-Keywords
+ (space-delimited), X-Mozilla-Keys (space-delimited), and Keywords (RFC
+ 2822, comma-space-delimited). Mutt remembers which headers it sourced
+ keywords from, and can rewrite those headers when saving messages for
+ compatibility with the mailer of origin.
+ </para>
-<screen>
-<emphasis role="comment"># Sidebar config file</emphasis>
-ifndef USE_SIDEBAR finish
-</screen>
+ <para>
+ (X-Label was specified as freeform text by mutt, its only known
+ implementation. X-Labels have been used both as a
+ <quote>tagging</quote> device, probably with space delimiting, and as a
+ <quote>memo</quote> field, where space-delimited parsing would ruin the
+ semantics of the memo. By default mutt will not split X-Labels at all.
+ Set $xlabel_delimiter if your needs vary.)
+ </para>
- </sect2>
+ <para>
+ Finally we add two booleans: $keywords_legacy=true and
+ $keywords_standard=FALSE. When $keywords_legacy is true, mutt will
+ always save keyword to whatever original header it came from. When
+ $keywords_standard=true, mutt will save to the Keywords: header. If
+ both are true mutt saves to both; if neither is true, mutt saves only
+ to legacy headers to avoid complete loss of keywords.
+ </para>
-<!--
- <sect2 id="ifdef-variables">
- <title>Variables</title>
- <para>None</para>
- </sect2>
+ <para>
+ Overall this represents convergence path for all competing
+ labelling/tagging/keywording systems toward one that is specified by
+ RFC.
+ </para>
- <sect2 id="ifdef-functions">
- <title>Functions</title>
- <para>None</para>
+ <para>
+ You can change or delete the X-Label: field within
+ Mutt using the edit-label command, bound to the
+ y key by default. This works for tagged messages, too.
+ </para>
</sect2>
--->
- <sect2 id="ifdef-commands">
- <title>Commands</title>
- <cmdsynopsis>
- <command>ifdef</command>
- <arg choice="plain">
- <replaceable class="parameter">symbol</replaceable>
- </arg>
- <arg choice="plain">
- <replaceable class="parameter">"config-command [args]"</replaceable>
- </arg>
- <command>ifndef</command>
- <arg choice="plain">
- <replaceable class="parameter">symbol</replaceable>
- </arg>
- <arg choice="plain">
- <replaceable class="parameter">"config-command [args]"</replaceable>
- </arg>
- <command>finish</command>
- </cmdsynopsis>
+ <sect2 id="keywords-variables">
+ <title>Variables</title>
+
+ <table id="table-keywords-variables">
+ <title>Keywords Variables</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Name</entry>
+ <entry>Type</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>keywords_legacy</literal></entry>
+ <entry>boolean</entry>
+ <entry><literal>yes</literal></entry>
+ </row>
+ <row>
+ <entry><literal>keywords_standard</literal></entry>
+ <entry>boolean</entry>
+ <entry><literal>no</literal></entry>
+ </row>
+ <row>
+ <entry><literal>xlabel_delimiter</literal></entry>
+ <entry>string</entry>
+ <entry>(empty)</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect2>
+
+ <sect2 id="keywords-functions">
+ <title>Functions</title>
+
+ <table id="table-keywords-funcions">
+ <title>Keyword Functions</title>
+ <tgroup cols="4">
+ <thead>
+ <row>
+ <entry>Menus</entry>
+ <entry>Default Key</entry>
+ <entry>Function</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>index,pager</entry>
+ <entry>y</entry>
+ <entry><literal><edit-label></literal></entry>
+ <entry>add, change, or delete a message's label</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
</sect2>
<!--
- <sect2 id="ifdef-colors">
+ <sect2 id="keywords-commands">
+ <title>Commands</title>
+ </sect2>
+
+ <sect2 id="keywords-colors">
<title>Colors</title>
<para>None</para>
</sect2>
+-->
- <sect2 id="ifdef-sort">
+ <sect2 id="keywords-sort">
<title>Sort</title>
- <para>None</para>
+ <table id="table-keywords-sort">
+ <title>Keywords Sort</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Sort</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>label</literal></entry>
+ <entry>Sort by label</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
</sect2>
--->
- <sect2 id="ifdef-muttrc">
+ <sect2 id="keywords-muttrc">
<title>Muttrc</title>
-<screen>
-<emphasis role="comment"># Example Mutt config file for the 'ifdef' feature.
-
-# This feature introduces three useful commands which allow you to share
-# one config file between versions of Mutt that may have different
-# features compiled in.
-
-# ifdef symbol config-command [args...]
-# ifndef symbol config-command [args...]
-# finish
-
-# The 'ifdef' command tests whether Mutt understands the name of
-# a variable, function, command or compile-time symbol.
-# If it does, then it executes a config command.
-
-# The 'ifndef' command tests whether a symbol does NOT exist.
-
-# The 'finish' command tells Mutt to stop reading current config file.
-
-# If the 'trash' variable exists, set it.</emphasis>
-ifdef trash 'set trash=~/Mail/trash'
-
-<emphasis role="comment"># If the 'tag-pattern' function exists, bind a key to it.</emphasis>
-ifdef tag-pattern 'bind index <F6> tag-pattern'
-
-<emphasis role="comment"># If the 'imap-fetch-mail' command exists, read my IMAP config.</emphasis>
-ifdef imap-fetch-mail 'source ~/.mutt/imap.rc'
-
-<emphasis role="comment"># If the compile-time symbol 'USE_SIDEBAR' does not exist, then
-# stop reading the current config file.</emphasis>
-ifndef USE_SIDEBAR finish
-
-<emphasis role="comment"># vim: syntax=muttrc</emphasis>
-</screen>
</sect2>
- <sect2 id="ifdef-see-also">
+ <sect2 id="keywords-see-also">
<title>See Also</title>
<itemizedlist>
- <listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
+ <listitem><para><ulink url="https://github.com/neomutt/neomutt/wiki">NeoMutt Project</ulink></para></listitem>
+ <listitem><para><link linkend="index-format">$index_format</link></para></listitem>
+ <listitem><para><link linkend="index-color">index-color patch</link></para></listitem>
+ <listitem><para><link linkend="folder-hook">folder-hook</link></para></listitem>
</itemizedlist>
</sect2>
- <sect2 id="ifdef-known-bugs">
+ <sect2 id="keywords-known-bugs">
<title>Known Bugs</title>
- <para>None</para>
</sect2>
- <sect2 id="ifdef-credits">
+ <sect2 id="keywords-credits">
<title>Credits</title>
<itemizedlist>
- <listitem><para>Cedric Duval <email>cedricduval@free.fr</email></para></listitem>
- <listitem><para>Matteo F. Vescovi <email>mfvescovi@gmail.com</email></para></listitem>
+ <listitem><para>David Champion <email>dgc@uchicago.edu</email></para></listitem>
<listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
</itemizedlist>
</sect2>
</sect1>
-<sect1 id="fmemopen">
- <title>Fmemopen Patch</title>
- <subtitle>Replace some temporary files with memory buffers</subtitle>
+<sect1 id="limit-current-thread">
+ <title>Limit-Current-Thread Patch</title>
+ <subtitle>Focus on one Email Thread</subtitle>
- <sect2 id="fmemopen-patch">
+ <sect2 id="limit-current-thread-patch">
<title>Patch</title>
<para>
- To check if Mutt supports <quote>fmemopen</quote>, look for
- <quote>patch-fmemopen</quote> in the mutt version.
+ To check if Mutt supports <quote>limit-current-thread</quote>, look for
+ <quote>patch-limit-current-thread</quote> in the mutt version.
See: <xref linkend="mutt-patches"/>.
</para>
<itemizedlist>
<title>Dependencies:</title>
<listitem><para>mutt-1.6.1</para></listitem>
- <listitem><para><literal>open_memstream()</literal>, <literal>fmemopen()</literal> from glibc</para></listitem>
</itemizedlist>
<para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
</sect2>
- <sect2 id="fmemopen-intro">
+ <sect2 id="limit-current-thread-intro">
<title>Introduction</title>
- <para>
- The <quote>fmemopen</quote> patch speeds up some searches.
- </para>
-
- <para>
- This patch changes a few places where Mutt creates temporary files.
- It replaces them with in-memory buffers. This should improve the
- performance when searching the header or body using the
- <link linkend="thorough-search">$thorough_search</link> option.
- </para>
-
- <para>
- There are no user-configurable parts.
- </para>
+ <para>
+ This patch adds a new way of using the
+ <link linkend="tuning-search">Limit Command</link>.
+ The <literal><limit-current-thread></literal>
+ function restricts the view to just the current thread.
+ Setting the limit (the <literal>l</literal> key) to
+ <quote>all</quote> will restore the full email list.
+ </para>
- <para>
- This patch depends on <literal>open_memstream()</literal> and
- <literal>fmemopen()</literal>. They are provided by glibc. Without
- them, Mutt will simply create temporary files.
- </para>
</sect2>
<!--
- <sect2 id="fmemopen-variables">
+ <sect2 id="limit-current-thread-variables">
<title>Variables</title>
<para>None</para>
</sect2>
-
- <sect2 id="fmemopen-functions">
+-->
+ <sect2 id="limit-current-thread-functions">
<title>Functions</title>
- <para>None</para>
- </sect2>
- <sect2 id="fmemopen-commands">
+ <table id="table-limit-current-thread-functions">
+ <title>Limit-Current-Thread Functions</title>
+ <tgroup cols="4">
+ <thead>
+ <row>
+ <entry>Menus</entry>
+ <entry>Default Key</entry>
+ <entry>Function</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>index</entry>
+ <entry><literal><Esc> L</literal></entry>
+ <entry><literal><limit-current-thread></literal></entry>
+ <entry>Limit view to current thread</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ </sect2>
+<!--
+ <sect2 id="limit-current-thread-commands">
<title>Commands</title>
<para>None</para>
</sect2>
- <sect2 id="fmemopen-colors">
+ <sect2 id="limit-current-thread-colors">
<title>Colors</title>
<para>None</para>
</sect2>
- <sect2 id="fmemopen-sort">
+ <sect2 id="limit-current-thread-sort">
<title>Sort</title>
<para>None</para>
</sect2>
-->
- <sect2 id="fmemopen-muttrc">
+ <sect2 id="limit-current-thread-muttrc">
<title>Muttrc</title>
- <para>None</para>
+
+<screen>
+<emphasis role="comment"># Example Mutt config file for the 'limit-current-thread' patch.
+
+# Limit view to current thread</emphasis>
+bind index <esc>L limit-current-thread
+
+<emphasis role="comment"># vim: syntax=muttrc</emphasis>
+</screen>
</sect2>
- <sect2 id="fmemopen-see-also">
+ <sect2 id="limit-current-thread-see-also">
<title>See Also</title>
<itemizedlist>
<listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
- <listitem><para><link linkend="compile-time-features">Compile-Time Features</link></para></listitem>
- <listitem><para><literal>fmemopen(3)</literal></para></listitem>
</itemizedlist>
</sect2>
- <sect2 id="fmemopen-known-bugs">
+ <sect2 id="limit-current-thread-known-bugs">
<title>Known Bugs</title>
<para>None</para>
</sect2>
- <sect2 id="fmemopen-credits">
+ <sect2 id="limit-current-thread-credits">
<title>Credits</title>
<itemizedlist>
- <listitem><para>Julius Plenz <email>plenz@cis.fu-berlin.de</email></para></listitem>
+ <listitem><para>David Sterba <email>dsterba@suse.cz</email></para></listitem>
<listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
</itemizedlist>
</sect2>
</sect1>
-<sect1 id="initials">
- <title>Initials Expando Patch</title>
- <subtitle>Expando for author's initials</subtitle>
+<sect1 id="lmdb">
+ <title>LMDB Patch</title>
+ <subtitle>LMDB backend for the header cache</subtitle>
- <sect2 id="initials-patch">
+ <sect2 id="lmdb-patch">
<title>Patch</title>
<para>
- To check if Mutt supports <quote>Initials</quote>, look for
- <quote>patch-initials</quote> in the mutt version.
+ To check if Mutt supports <quote>lmdb</quote>, look for
+ <quote>patch-lmdb</quote> in the mutt version.
See: <xref linkend="mutt-patches"/>.
</para>
<para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
</sect2>
- <sect2 id="initials-intro">
+ <sect2 id="lmdb-intro">
<title>Introduction</title>
- <para>
- The <quote>initials</quote> patch adds an expando (%I) for an author's
- initials.
- </para>
-
<para>
- The index panel displays a list of emails. Its layout is controlled by
- the <link linkend="index-format">$index_format</link> variable. Using
- this expando saves space in the index panel. This can be useful if you
- are regularly working with a small set of people.
+ This patch adds support for using LMDB as a storage backend for
+ Mutt's header cache (hcache). It is enabled at configure time with
+ the <emphasis>--with-lmdb=<path></emphasis> switch.
</para>
</sect2>
- <sect2 id="initials-variables">
- <title>Variables</title>
-
- <para>
- This patch has no config of its own. It adds an expando which can be
- used in the <link linkend="index-format">$index_format</link> variable.
- </para>
- </sect2>
-
-<!--
- <sect2 id="initials-functions">
- <title>Functions</title>
- <para>None</para>
- </sect2>
-
- <sect2 id="initials-commands">
- <title>Commands</title>
- <para>None</para>
- </sect2>
-
- <sect2 id="initials-colors">
- <title>Colors</title>
- <para>None</para>
- </sect2>
-
- <sect2 id="initials-sort">
- <title>Sort</title>
- <para>None</para>
- </sect2>
--->
-
- <sect2 id="initials-muttrc">
- <title>Muttrc</title>
-<screen>
-<emphasis role="comment"># Example Mutt config file for the 'initials' patch.
-
-# The 'initials' patch has no config of its own.
-# It adds an expando for an author's initials,
-# which can be used in the 'index_format' variable.
-
-# The default 'index_format' is:</emphasis>
-set index_format='%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s'
-
-<emphasis role="comment"># Where %L represents the author/recipient
-
-# This might look like:
-# 1 + Nov 17 David Bowie Changesbowie ( 689)
-# 2 ! Nov 17 Stevie Nicks Rumours ( 555)
-# 3 + Nov 16 Jimi Hendrix Voodoo Child ( 263)
-# 4 + Nov 16 Debbie Harry Parallel Lines ( 540)
-
-# Using the %I expando:</emphasis>
-set index_format='%4C %Z %{%b %d} %I (%?l?%4l&%4c?) %s'
-
-<emphasis role="comment"># This might look like:
-# 1 + Nov 17 DB Changesbowie ( 689)
-# 2 ! Nov 17 SN Rumours ( 555)
-# 3 + Nov 16 JH Voodoo Child ( 263)
-# 4 + Nov 16 DH Parallel Lines ( 540)
-
-# vim: syntax=muttrc</emphasis>
-</screen>
- </sect2>
-
- <sect2 id="initials-see-also">
+ <sect2 id="lmdb-see-also">
<title>See Also</title>
<itemizedlist>
<listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
- <listitem><para><link linkend="index-format">$index_format</link></para></listitem>
- <listitem><para><link linkend="index-color">index-color patch</link></para></listitem>
- <listitem><para><link linkend="folder-hook">folder-hook</link></para></listitem>
+ <listitem><para><link linkend="caching">Local Caching</link></para></listitem>
</itemizedlist>
</sect2>
- <sect2 id="initials-known-bugs">
+ <sect2 id="lmdb-known-bugs">
<title>Known Bugs</title>
<para>None</para>
</sect2>
- <sect2 id="initials-credits">
+ <sect2 id="lmdb-credits">
<title>Credits</title>
<itemizedlist>
- <listitem><para>Vsevolod Volkov <email>vvv@mutt.org.ua</email></para></listitem>
- <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
+ <listitem><para>Pietro Cerutti <email>gahr@gahr.ch</email></para></listitem>
+ <listitem><para>Jan-Piet Mens <email>jp@mens.de</email></para></listitem>
</itemizedlist>
</sect2>
</sect1>
-<sect1 id="trash-folder">
- <title>Trash Folder Patch</title>
- <subtitle>Automatically move "deleted" emails to a trash bin</subtitle>
+<sect1 id="nested-if">
+ <title>Nested If Patch</title>
+ <subtitle>Allow complex nested conditions in format strings</subtitle>
- <sect2 id="trash-folder-patch">
+ <sect2 id="nested-if-patch">
<title>Patch</title>
<para>
- To check if Mutt supports <quote>Trash Folder</quote>, look for
- <quote>patch-trash</quote> in the mutt version.
+ To check if Mutt supports <quote>Nested If</quote>, look for
+ <quote>patch-nested-if</quote> in the mutt version.
See: <xref linkend="mutt-patches"/>.
</para>
- If IMAP is enabled, this patch will use it
-
<itemizedlist>
<title>Dependencies:</title>
<listitem><para>mutt-1.6.1</para></listitem>
- <listitem><para>IMAP support</para></listitem>
</itemizedlist>
<para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
</sect2>
- <sect2 id="trash-folder-intro">
+ <sect2 id="nested-if-intro">
<title>Introduction</title>
<para>
- In Mutt, when you <quote>delete</quote> an email it is first marked
- deleted. The email isn't really gone until
- <link linkend="index-map"><sync-mailbox></link> is called.
- This happens when the user leaves the folder, or the function is called
- manually.
+ Mutt's format strings can contain embedded if-then-else conditions.
+ They are of the form:
</para>
+<screen>
+%?VAR?TRUE&FALSE?
+</screen>
+
<para>
- After <literal><sync-mailbox></literal> has been called the email is gone forever.
+ If the variable <quote>VAR</quote> has a value greater than zero,
+ print the <quote>TRUE</quote> string, otherwise print the
+ <quote>FALSE</quote> string.
</para>
<para>
- The <link linkend="trash">$trash</link> variable defines a folder in
- which to keep old emails. As before, first you mark emails for
- deletion. When <sync-mailbox> is called the emails are moved to
- the trash folder.
+ e.g. <literal>%?S?Size: %S&Empty?</literal>
</para>
+ <para>Which can be read as:</para>
+
+ <literallayout>
+ if (%S > 0) {
+ print "Size: %S"
+ } else {
+ print "Empty"
+ }
+ </literallayout>
+
<para>
- The <literal>$trash</literal> path can be either a full directory,
- or be relative to the <link linkend="folder">$folder</link>
- variable, like the <literal>mailboxes</literal> command.
+ These conditions are useful, but in Mutt they cannot be nested
+ within one another. This patch uses the notation
+ <literal>%<VAR?TRUE&FALSE></literal> and allows them to be nested.
</para>
- <note>
- Emails deleted from the trash folder are gone forever.
- </note>
- </sect2>
+ <para>
+ The <literal>%<...></literal> notation was used to format the
+ current local time. but that's not really very useful since mutt
+ has no means of refreshing the screen periodically.
+ </para>
- <sect2 id="trash-folder-variables">
- <title>Variables</title>
- <table id="table-trash-variables">
- <title>Trash Variables</title>
- <tgroup cols="3">
- <thead>
- <row>
- <entry>Name</entry>
- <entry>Type</entry>
- <entry>Default</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>trash</entry>
- <entry>string</entry>
- <entry>(none)</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </sect2>
+ <para>
+ A simple nested condition might be:
+ (Some whitespace has been introduced for clarity)
+ </para>
- <sect2 id="trash-folder-functions">
- <title>Functions</title>
- <table id="table-trash-functions">
- <title>Trash Functions</title>
- <tgroup cols="4">
- <thead>
- <row>
- <entry>Menus</entry>
- <entry>Default Key</entry>
- <entry>Function</entry>
- <entry>Description</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>index,pager</entry>
- <entry>(none)</entry>
- <entry><literal><purge-message></literal></entry>
- <entry>really delete the current entry, bypassing the trash folder</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </sect2>
+ <literallayout>
+ %<x? %<y? XY & X > & %<y? Y & NONE > > Conditions
+ %<y? XY & X > x>0
+ XY x>0,y>0
+ X x>0,y=0
+ </literallayout>
-<!--
- <sect2 id="trash-folder-commands">
- <title>Commands</title>
- <para>None</para>
- </sect2>
+ <literallayout>
+ %<x? %<y? XY & X > & %<y? Y & NONE > > Conditions
+ %<y? Y & NONE > x=0
+ Y x=0,y>0
+ NONE x=0,y=0
+ </literallayout>
- <sect2 id="trash-folder-colors">
- <title>Colors</title>
- <para>None</para>
- </sect2>
+ <para>Equivalent to:</para>
- <sect2 id="trash-folder-sort">
- <title>Sort</title>
- <para>None</para>
- </sect2>
--->
+ <literallayout>
+ if (x > 0) {
+ if (y > 0) {
+ print 'XY'
+ } else {
+ print 'X'
+ }
+ } else {
+ if (y > 0) {
+ print 'Y'
+ } else {
+ print 'NONE'
+ }
+ }
+ </literallayout>
+
+ <para>Examples:</para>
- <sect2 id="trash-folder-muttrc">
- <title>Muttrc</title>
<screen>
-<emphasis role="comment"># Example Mutt config file for the 'trash' feature.
-
-# This feature defines a new 'trash' folder.
-# When mail is deleted it will be moved to this folder.
-
-# Folder in which to put deleted emails</emphasis>
-set trash='+Trash'
-set trash='/home/flatcap/Mail/Trash'
-
-<emphasis role="comment"># The default delete key 'd' will move an email to the 'trash' folder
-# Bind 'D' to REALLY delete an email</emphasis>
-bind index D purge-message
-
-<emphasis role="comment"># Note: Deleting emails from the 'trash' folder will REALLY delete them.
-
-# vim: syntax=muttrc</emphasis>
+set index_format='%4C %Z %{%b %d} %-25.25n %s%> %<M?%M Msgs &%<l?%l Lines&%c Bytes>>'
</screen>
- </sect2>
-
- <sect2 id="trash-folder-see-also">
- <title>See Also</title>
-
- <itemizedlist>
- <listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
- <listitem><para><link linkend="folder-hook">folder-hook</link></para></listitem>
- </itemizedlist>
- </sect2>
-
- <sect2 id="trash-folder-known-bugs">
- <title>Known Bugs</title>
- <para>None</para>
- </sect2>
-
- <sect2 id="trash-folder-credits">
- <title>Credits</title>
- <itemizedlist>
- <listitem><para>Cedric Duval <email>cedricduval@free.fr</email></para></listitem>
- <listitem><para>Benjamin Kuperman <email>kuperman@acm.org</email></para></listitem>
- <listitem><para>Paul Miller <email>paul@voltar.org</email></para></listitem>
- <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
- </itemizedlist>
- </sect2>
-</sect1>
-
-<sect1 id="limit-current-thread">
- <title>Limit-Current-Thread Patch</title>
- <subtitle>Focus on one Email Thread</subtitle>
- <sect2 id="limit-current-thread-patch">
- <title>Patch</title>
+ <literallayout>
+ if a thread is folded
+ display the number of messages (%M)
+ else if we know how many lines in the message
+ display lines in message (%l)
+ else
+ display the size of the message in bytes (%c)
+ </literallayout>
- <para>
- To check if Mutt supports <quote>limit-current-thread</quote>, look for
- <quote>patch-limit-current-thread</quote> in the mutt version.
- See: <xref linkend="mutt-patches"/>.
- </para>
+<screen>
+set index_format='%4C %Z %{%b %d} %-25.25n %<M?[%M] %s&%s%* %<l?%l&%c>>'
+</screen>
- <itemizedlist>
- <title>Dependencies:</title>
- <listitem><para>mutt-1.6.1</para></listitem>
- </itemizedlist>
+ <literallayout>
+ if a thread is folded
+ display the number of messages (%M)
+ display the subject (%s)
+ else if we know how many lines in the message
+ display lines in message (%l)
+ else
+ display the size of the message in bytes (%c)
+ </literallayout>
- <para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
</sect2>
- <sect2 id="limit-current-thread-intro">
- <title>Introduction</title>
-
- <para>
- This patch adds a new way of using the
- <link linkend="tuning-search">Limit Command</link>.
- The <literal><limit-current-thread></literal>
- function restricts the view to just the current thread.
- Setting the limit (the <literal>l</literal> key) to
- <quote>all</quote> will restore the full email list.
- </para>
-
+ <sect2 id="nested-if-variables">
+ <title>Variables</title>
+ The <quote>nested-if</quote> patch doesn't have any config of its own.
+ It modifies the behavior of the format strings.
</sect2>
<!--
- <sect2 id="limit-current-thread-variables">
- <title>Variables</title>
+ <sect2 id="nested-if-functions">
+ <title>Functions</title>
<para>None</para>
</sect2>
--->
- <sect2 id="limit-current-thread-functions">
- <title>Functions</title>
-
- <table id="table-limit-current-thread-functions">
- <title>Limit-Current-Thread Functions</title>
- <tgroup cols="4">
- <thead>
- <row>
- <entry>Menus</entry>
- <entry>Default Key</entry>
- <entry>Function</entry>
- <entry>Description</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>index</entry>
- <entry><literal><Esc> L</literal></entry>
- <entry><literal><limit-current-thread></literal></entry>
- <entry>Limit view to current thread</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </sect2>
-<!--
- <sect2 id="limit-current-thread-commands">
+ <sect2 id="nested-if-commands">
<title>Commands</title>
<para>None</para>
</sect2>
- <sect2 id="limit-current-thread-colors">
+ <sect2 id="nested-if-colors">
<title>Colors</title>
<para>None</para>
</sect2>
- <sect2 id="limit-current-thread-sort">
+ <sect2 id="nested-if-sort">
<title>Sort</title>
<para>None</para>
</sect2>
-->
- <sect2 id="limit-current-thread-muttrc">
+ <sect2 id="nested-if-muttrc">
<title>Muttrc</title>
-
<screen>
-<emphasis role="comment"># Example Mutt config file for the 'limit-current-thread' patch.
+<emphasis role="comment"># Example Mutt config file for the 'nested-if' feature.
-# Limit view to current thread</emphasis>
-bind index <esc>L limit-current-thread
+# This patch uses the format: '%<VAR?TRUE&FALSE>' for conditional
+# format strings that can be nested.
+
+# Example 1
+# if a thread is folded
+# display the number of messages (%M)
+# else if we know how many lines in the message
+# display lines in message (%l)
+# else display the size of the message in bytes (%c)</emphasis>
+set index_format='%4C %Z %{%b %d} %-25.25n %s%> %<M?%M Msgs &%<l?%l Lines&%c Bytes>>'
+
+<emphasis role="comment"># Example 2
+# if a thread is folded
+# display the number of messages (%M)
+# display the subject (%s)
+# else if we know how many lines in the message
+# display lines in message (%l)
+# else
+# display the size of the message in bytes (%c)</emphasis>
+set index_format='%4C %Z %{%b %d} %-25.25n %<M?[%M] %s&%s%* %<l?%l&%c>>'
<emphasis role="comment"># vim: syntax=muttrc</emphasis>
</screen>
</sect2>
- <sect2 id="limit-current-thread-see-also">
+ <sect2 id="nested-if-see-also">
<title>See Also</title>
<itemizedlist>
<listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
+ <listitem><para><link linkend="cond-date">cond-date patch</link></para></listitem>
+ <listitem><para><link linkend="index-format">$index_format</link></para></listitem>
+ <listitem><para><link linkend="status-format">$status_format</link></para></listitem>
</itemizedlist>
</sect2>
- <sect2 id="limit-current-thread-known-bugs">
+ <sect2 id="nested-if-known-bugs">
<title>Known Bugs</title>
- <para>None</para>
+ Patch overwrites $<fmt> handler in <literal>$index_format</literal>
</sect2>
- <sect2 id="limit-current-thread-credits">
+ <sect2 id="nested-if-credits">
<title>Credits</title>
<itemizedlist>
- <listitem><para>David Sterba <email>dsterba@suse.cz</email></para></listitem>
+ <listitem><para>David Champion <email>dgc@uchicago.edu</email></para></listitem>
<listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
</itemizedlist>
</sect2>
</sect1>
-<sect1 id="skip-quoted-patch">
- <title>Skip-Quoted Patch</title>
- <subtitle>Leave some context visible</subtitle>
+<sect1 id="nntp">
+ <title>NNTP Patch</title>
+ <subtitle>Talk to a Usenet news server</subtitle>
- <sect2 id="skip-quoted-patch2">
+ <sect2 id="nntp-patch">
<title>Patch</title>
<para>
- To check if Mutt supports <quote>skip-quoted</quote>, look for
- <quote>patch-skip-quoted</quote> in the mutt version.
- See: <xref linkend="mutt-patches"/>.
+ To check if Mutt supports <quote>NNTP</quote>, look for
+ <quote>+USE_NNTP</quote> in the mutt version.
+ See: <xref linkend="compile-time-features"/>.
</para>
<itemizedlist>
<para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
</sect2>
- <sect2 id="skip-quoted-intro">
+ <sect2 id="nntp-intro">
<title>Introduction</title>
+ <para>Reading news via NNTP</para>
<para>
- When viewing an email, the
- <literal><skip-to-quoted></literal> function (by default the
- <literal>S</literal> key) will scroll past any quoted text.
- Sometimes, a little context is useful.
- </para>
-
- <para>
- By setting the <literal>$skip_quoted_offset</literal> variable, you
- can select how much of the quoted text is left visible.
+ If compiled with <emphasis>--enable-nntp</emphasis> option, Mutt can
+ read news from news server via NNTP. You can open a newsgroup with
+ function ``change-newsgroup'' (default: ``i''). Default news server
+ can be obtained from <literal>$NNTPSERVER</literal> environment
+ variable or from <literal>/etc/nntpserver</literal> file. Like other
+ news readers, info about subscribed newsgroups is saved in file by
+ <link linkend="newsrc">$newsrc</link> variable. The variable <link
+ linkend="news-cache-dir">$news_cache_dir</link> can be used to point
+ to a directory. Mutt will create a hierarchy of subdirectories named
+ like the account and newsgroup the cache is for. Also the hierarchy
+ is used to store header cache if Mutt was compiled with <link
+ linkend="header-caching">header cache</link> support.
</para>
</sect2>
- <sect2 id="skip-quoted-variables">
+ <sect2 id="nntp-variables">
<title>Variables</title>
- <table id="table-skip-quoted-variables">
- <title>Skip-Quoted Variables</title>
+
+ <table id="table-nntp-variables">
+ <title>NNTP Variables</title>
<tgroup cols="3">
<thead>
<row>
</thead>
<tbody>
<row>
- <entry><literal>skip_quoted_offset</literal></entry>
- <entry>number</entry>
- <entry>0</entry>
+ <entry><literal>ask_follow_up</literal></entry>
+ <entry>boolean</entry>
+ <entry><literal>no</literal></entry>
</row>
- </tbody>
- </tgroup>
- </table>
- </sect2>
-
-<!--
- <sect2 id="skip-quoted-functions">
- <title>Functions</title>
- <para>None</para>
- </sect2>
-
- <sect2 id="skip-quoted-commands">
- <title>Commands</title>
- <para>None</para>
- </sect2>
-
- <sect2 id="skip-quoted-colors">
- <title>Colors</title>
- <para>None</para>
- </sect2>
-
- <sect2 id="skip-quoted-sort">
- <title>Sort</title>
- <para>None</para>
- </sect2>
--->
-
- <sect2 id="skip-quoted-muttrc">
- <title>Muttrc</title>
-
-<screen>
-<emphasis role="comment"># Example Mutt config file for the 'skip-quoted' patch.
-
-# The 'S' (skip-quoted) command scrolls the pager past the quoted text (usually
-# indented with '> '. Setting 'skip_quoted_offset' leaves some lines of quoted
-# text on screen for context.
-
-# Show three quoted lines before the reply</emphasis>
-set skip_quoted_offset = 3
-
-<emphasis role="comment"># vim: syntax=muttrc</emphasis>
-</screen>
- </sect2>
-
- <sect2 id="skip-quoted-see-also">
- <title>See Also</title>
-
- <itemizedlist>
- <listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
- </itemizedlist>
- </sect2>
-
- <sect2 id="skip-quoted-known-bugs">
- <title>Known Bugs</title>
- <para>None</para>
- </sect2>
-
- <sect2 id="skip-quoted-credits">
- <title>Credits</title>
- <itemizedlist>
- <listitem><para>David Sterba <email>dsterba@suse.cz</email></para></listitem>
- <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
- </itemizedlist>
- </sect2>
-</sect1>
-
-<sect1 id="compress">
- <title>Compressed Folders Patch</title>
- <subtitle>Read from/write to compressed mailboxes</subtitle>
-
- <sect2 id="compress-patch">
- <title>Patch</title>
-
- <para>
- To check if Mutt supports <quote>Compress Folders</quote>, look for
- <quote>+USE_COMPRESSED</quote> in the mutt version.
- See: <xref linkend="compile-time-features"/>.
- </para>
-
- <itemizedlist>
- <title>Dependencies:</title>
- <listitem><para>mutt-1.6.1</para></listitem>
- </itemizedlist>
-
- <para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
- </sect2>
-
- <sect2 id="compress-intro">
- <title>Introduction</title>
-
- <para>
- The Compressed Folder patch allows Mutt to read mailbox files that are
- compressed. But it isn't limited to compressed files. It works well
- with encrypted files, too. In fact, if you can create a program/script
- to convert to and from your format, then Mutt can read it.
- </para>
-
- <para>
- The patch adds three hooks to Mutt: <literal>open-hook</literal>,
- <literal>close-hook</literal> and <literal>append-hook</literal>. They
- define commands to: uncompress a file; compress a file; append
- messages to an already compressed file.
- </para>
-
- <para>
- There are some examples of both compressed and encrypted files,
- later. For now, the documentation will just concentrate on
- compressed files.
- </para>
-
- </sect2>
-
-<!--
- <sect2 id="compress-variables">
- <title>Variables</title>
- <para>None</para>
- </sect2>
-
- <sect2 id="compress-functions">
- <title>Functions</title>
- <para>None</para>
- </sect2>
--->
-
- <sect2 id="compress-commands">
- <title>Commands</title>
- <cmdsynopsis>
- <command>open-hook</command>
- <arg choice="plain">
- <replaceable class="parameter">pattern</replaceable>
- </arg>
- <arg choice="plain">
- <replaceable class="parameter">shell-command</replaceable>
- </arg>
- <command>close-hook</command>
- <arg choice="plain">
- <replaceable class="parameter">pattern</replaceable>
- </arg>
- <arg choice="plain">
- <replaceable class="parameter">shell-command</replaceable>
- </arg>
- <command>append-hook</command>
- <arg choice="plain">
- <replaceable class="parameter">pattern</replaceable>
- </arg>
- <arg choice="plain">
- <replaceable class="parameter">shell-command</replaceable>
- </arg>
- </cmdsynopsis>
-
- <para>
- The shell-command must contain two placeholders for filenames:
- <literal>%f</literal> and <literal>%t</literal>. These represent
- <quote>from</quote> and <quote>to</quote> filenames. It's a good idea to
- put quotes around these placeholders.
- </para>
-
- <para>
- If you need the exact string <quote>%f</quote> or <quote>%t</quote> in your
- command, simply double up the <quote>%</quote> character, e.g.
- <quote>%%f</quote> or <quote>%%t</quote>.
- </para>
-
- <table id="table-compress-optional">
- <title>Not all Hooks are Required</title>
- <tgroup cols="5">
- <thead>
<row>
- <entry>Open</entry>
- <entry>Close</entry>
- <entry>Append</entry>
- <entry>Effect</entry>
- <entry>Useful if</entry>
+ <entry><literal>ask_x_comment_to</literal></entry>
+ <entry>boolean</entry>
+ <entry><literal>no</literal></entry>
</row>
- </thead>
- <tbody>
<row>
- <entry>Open</entry>
- <entry>-</entry>
- <entry>-</entry>
- <entry>Folder is readonly</entry>
- <entry>The folder is just a backup</entry>
+ <entry><literal>catchup_newsgroup</literal></entry>
+ <entry>quad</entry>
+ <entry><literal>ask-yes</literal></entry>
</row>
<row>
- <entry>Open</entry>
- <entry>Close</entry>
- <entry>-</entry>
- <entry>Folder is read/write, but the entire folder must be
- written if anything is changed</entry>
- <entry>Your compression format doesn't support appending</entry>
+ <entry><literal>followup_to_poster</literal></entry>
+ <entry>quad</entry>
+ <entry><literal>ask-yes</literal></entry>
</row>
<row>
- <entry>Open</entry>
- <entry>Close</entry>
- <entry>Append</entry>
- <entry>Folder is read/write and emails can be efficiently added
- to the end</entry>
- <entry>Your compression format supports appending</entry>
+ <entry><literal>group_index_format</literal></entry>
+ <entry>string</entry>
+ <entry><literal>%4C %M%N %5s %-45.45f %d</literal></entry>
</row>
<row>
- <entry>Open</entry>
- <entry>-</entry>
- <entry>Append</entry>
- <entry>Folder is readonly, but can be appended to</entry>
- <entry>You want to store emails, but never change them</entry>
+ <entry><literal>inews</literal></entry>
+ <entry>string</entry>
+ <entry>(empty)</entry>
</row>
- </tbody>
- </tgroup>
- </table>
-
- <note>
- The command:
- <itemizedlist>
- <listitem><para>should return a non-zero exit status on failure</para></listitem>
- <listitem><para>should not delete any files</para></listitem>
- </itemizedlist>
- </note>
-
- <sect3 id="open-hook">
- <title>Read from compressed mailbox</title>
-
- <screen>open-hook regexp shell-command</screen>
-
- <para>
- If Mutt is unable to open a file, it then looks for
- <literal>open-hook</literal> that matches the filename.
- </para>
-
- <para>
- If your compression program doesn't have a well-defined extension,
- then you can use <literal>.</literal> as the regexp.
- </para>
-
- <sect4 id="compress-open-hook-example">
- <title>Example of open-hook</title>
-
- <screen>open-hook '\.gz$' "gzip -cd '%f' > '%t'"</screen>
-
- <itemizedlist>
- <listitem><para>Mutt finds a file, <quote>example.gz</quote>,
- that it can't read</para></listitem>
- <listitem><para>Mutt has an <literal>open-hook</literal>
- whose regexp matches the filename:
- <literal>\.gz$</literal></para></listitem>
- <listitem><para>Mutt uses the command <literal>gzip -cd</literal>
- to create a temporary file that it <emphasis>can</emphasis>
- read</para></listitem>
- </itemizedlist>
- </sect4>
- </sect3>
-
- <sect3 id="close-hook">
- <title>Write to a compressed mailbox</title>
-
- <screen>close-hook regexp shell-command</screen>
-
- <para>
- When Mutt has finished with a compressed mail folder, it will look
- for a matching <literal>close-hook</literal> to recompress the file.
- This hook is <link linkend="table-compress-optional">optional</link>.
- </para>
-
- <note>
- If the folder has not been modifed, the
- <literal>close-hook</literal> will not be called.
- </note>
-
- <sect4 id="compress-close-hook-example">
- <title>Example of close-hook</title>
-
- <screen>close-hook '\.gz$' "gzip -c '%t' > '%f'"</screen>
-
- <itemizedlist>
- <listitem><para>Mutt has finished with a folder, <quote>example.gz</quote>,
- that it opened with <literal>open-hook</literal></para></listitem>
- <listitem><para>The folder has been modified</para></listitem>
- <listitem><para>Mutt has a <literal>close-hook</literal> whose regexp
- matches the filename: <literal>\.gz$</literal></para></listitem>
- <listitem><para>Mutt uses the command <literal>gzip -c</literal>
- to create a new compressed file</para></listitem>
- </itemizedlist>
- </sect4>
- </sect3>
-
- <sect3 id="append-hook">
- <title>Append to a compressed mailbox</title>
+ <row>
+ <entry><literal>mime_subject</literal></entry>
+ <entry>boolean</entry>
+ <entry><literal>yes</literal></entry>
+ </row>
+ <row>
+ <entry><literal>newsgroups_charset</literal></entry>
+ <entry>string</entry>
+ <entry><literal>utf-8</literal></entry>
+ </row>
+ <row>
+ <entry><literal>newsrc</literal></entry>
+ <entry>string</entry>
+ <entry><literal>~/.newsrc</literal></entry>
+ </row>
+ <row>
+ <entry><literal>news_cache_dir</literal></entry>
+ <entry>string</entry>
+ <entry><literal>~/.mutt</literal></entry>
+ </row>
+ <row>
+ <entry><literal>news_server</literal></entry>
+ <entry>string</entry>
+ <entry>(empty)</entry>
+ </row>
+ <row>
+ <entry><literal>nntp_authenticators</literal></entry>
+ <entry>string</entry>
+ <entry>(empty)</entry>
+ </row>
+ <row>
+ <entry><literal>nntp_context</literal></entry>
+ <entry>number</entry>
+ <entry><literal>1000</literal></entry>
+ </row>
+ <row>
+ <entry><literal>nntp_listgroup</literal></entry>
+ <entry>boolean</entry>
+ <entry><literal>yes</literal></entry>
+ </row>
+ <row>
+ <entry><literal>nntp_load_description</literal></entry>
+ <entry>boolean</entry>
+ <entry><literal>yes</literal></entry>
+ </row>
+ <row>
+ <entry><literal>nntp_pass</literal></entry>
+ <entry>string</entry>
+ <entry>(empty)</entry>
+ </row>
+ <row>
+ <entry><literal>nntp_poll</literal></entry>
+ <entry>number</entry>
+ <entry><literal>60</literal></entry>
+ </row>
+ <row>
+ <entry><literal>nntp_user</literal></entry>
+ <entry>string</entry>
+ <entry>(empty)</entry>
+ </row>
+ <row>
+ <entry><literal>post_moderated</literal></entry>
+ <entry>quad</entry>
+ <entry><literal>ask-yes</literal></entry>
+ </row>
+ <row>
+ <entry><literal>save_unsubscribed</literal></entry>
+ <entry>boolean</entry>
+ <entry><literal>no</literal></entry>
+ </row>
+ <row>
+ <entry><literal>show_new_news</literal></entry>
+ <entry>boolean</entry>
+ <entry><literal>yes</literal></entry>
+ </row>
+ <row>
+ <entry><literal>show_only_unread</literal></entry>
+ <entry>boolean</entry>
+ <entry><literal>no</literal></entry>
+ </row>
+ <row>
+ <entry><literal>x_comment_to</literal></entry>
+ <entry>boolean</entry>
+ <entry><literal>no</literal></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect2>
+
+ <sect2 id="nntp-functions">
+ <title>Functions</title>
+
+ <table id="table-nntp-functions">
+ <title>NNTP Functions</title>
+ <tgroup cols="4">
+ <thead>
+ <row>
+ <entry>Menus</entry>
+ <entry>Default Key</entry>
+ <entry>Function</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>browser,index</entry>
+ <entry>y</entry>
+ <entry><literal><catchup></literal></entry>
+ <entry>mark all articles in newsgroup as read</entry>
+ </row>
+ <row>
+ <entry>index,pager</entry>
+ <entry>i</entry>
+ <entry><literal><change-newsgroup></literal></entry>
+ <entry>open a different newsgroup</entry>
+ </row>
+ <row>
+ <entry>pager</entry>
+ <entry>X</entry>
+ <entry><literal><change-vfolder></literal></entry>
+ <entry>open a different virtual folder</entry>
+ </row>
+ <row>
+ <entry>compose</entry>
+ <entry>o</entry>
+ <entry><literal><edit-followup-to></literal></entry>
+ <entry>edit the Followup-To field</entry>
+ </row>
+ <row>
+ <entry>compose</entry>
+ <entry>N</entry>
+ <entry><literal><edit-newsgroups></literal></entry>
+ <entry>edit the newsgroups list</entry>
+ </row>
+ <row>
+ <entry>compose</entry>
+ <entry>x</entry>
+ <entry><literal><edit-x-comment-to></literal></entry>
+ <entry>edit the X-Comment-To field</entry>
+ </row>
+ <row>
+ <entry>pager</entry>
+ <entry>+</entry>
+ <entry><literal><entire-thread></literal></entry>
+ <entry>read entire thread of the current message</entry>
+ </row>
+ <row>
+ <entry>attachment,index,pager</entry>
+ <entry>F</entry>
+ <entry><literal><followup-message></literal></entry>
+ <entry>followup to newsgroup</entry>
+ </row>
+ <row>
+ <entry>pager</entry>
+ <entry>`</entry>
+ <entry><literal><modify-labels></literal></entry>
+ <entry>modify (notmuch) tags</entry>
+ </row>
+ <row>
+ <entry>index,pager</entry>
+ <entry>P</entry>
+ <entry><literal><post-message></literal></entry>
+ <entry>post message to newsgroup</entry>
+ </row>
+ <row>
+ <entry>browser</entry>
+ <entry>g</entry>
+ <entry><literal><reload-active></literal></entry>
+ <entry>load list of all newsgroups from NNTP server</entry>
+ </row>
+ <row>
+ <entry>browser</entry>
+ <entry>s</entry>
+ <entry><literal><subscribe></literal></entry>
+ <entry>subscribe to current mbox (IMAP/NNTP only)</entry>
+ </row>
+ <row>
+ <entry>browser</entry>
+ <entry>S</entry>
+ <entry><literal><subscribe-pattern></literal></entry>
+ <entry>subscribe to newsgroups matching a pattern</entry>
+ </row>
+ <row>
+ <entry>browser</entry>
+ <entry>Y</entry>
+ <entry><literal><uncatchup></literal></entry>
+ <entry>mark all articles in newsgroup as unread</entry>
+ </row>
+ <row>
+ <entry>browser</entry>
+ <entry>u</entry>
+ <entry><literal><unsubscribe></literal></entry>
+ <entry>unsubscribe from current mbox (IMAP/NNTP only)</entry>
+ </row>
+ <row>
+ <entry>browser</entry>
+ <entry>U</entry>
+ <entry><literal><unsubscribe-pattern></literal></entry>
+ <entry>unsubscribe from newsgroups matching a pattern</entry>
+ </row>
+ <row>
+ <entry>index,pager</entry>
+ <entry>Alt-i</entry>
+ <entry><literal><change-newsgroup-readonly></literal></entry>
+ <entry>open a different newsgroup in read only mode</entry>
+ </row>
+ <row>
+ <entry>attachment,index,pager</entry>
+ <entry>Alt-F</entry>
+ <entry><literal><forward-to-group></literal></entry>
+ <entry>forward to newsgroup</entry>
+ </row>
+ <row>
+ <entry>index</entry>
+ <entry>(none)</entry>
+ <entry><literal><get-children></literal></entry>
+ <entry>get all children of the current message</entry>
+ </row>
+ <row>
+ <entry>index</entry>
+ <entry>Alt-G</entry>
+ <entry><literal><get-parent></literal></entry>
+ <entry>get parent of the current message</entry>
+ </row>
+ <row>
+ <entry>index,pager</entry>
+ <entry>(none)</entry>
+ <entry><literal><imap-fetch-mail></literal></entry>
+ <entry>force retrieval of mail from IMAP server</entry>
+ </row>
+ <row>
+ <entry>index,pager</entry>
+ <entry>(none)</entry>
+ <entry><literal><imap-logout-all></literal></entry>
+ <entry>logout from all IMAP servers</entry>
+ </row>
+ <row>
+ <entry>pager</entry>
+ <entry>(none)</entry>
+ <entry><literal><modify-labels-then-hide></literal></entry>
+ <entry>modify labeld and then hide message</entry>
+ </row>
+ <row>
+ <entry>index</entry>
+ <entry>(none)</entry>
+ <entry><literal><reconstruct-thread></literal></entry>
+ <entry>reconstruct thread containing current message</entry>
+ </row>
+ <row>
+ <entry>pager</entry>
+ <entry>Alt-X</entry>
+ <entry><literal><vfolder-from-query></literal></entry>
+ <entry>generate virtual folder from query</entry>
+ </row>
+ <row>
+ <entry>index</entry>
+ <entry>Ctrl-G</entry>
+ <entry><literal><get-message></literal></entry>
+ <entry>get message with Message-Id</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect2>
+
+ <sect2 id="nntp-commands">
+ <title>Commands</title>
+ </sect2>
+
+ <sect2 id="nntp-colors">
+ <title>Colors</title>
+ <para>None</para>
+ </sect2>
+
+ <sect2 id="nntp-sort">
+ <title>Sort</title>
+ <para>None</para>
+ </sect2>
+
+ <sect2 id="nntp-muttrc">
+ <title>Muttrc</title>
+ </sect2>
+
+ <sect2 id="nntp-see-also">
+ <title>See Also</title>
+
+ <itemizedlist>
+ <listitem><para><ulink url="https://github.com/neomutt/neomutt/wiki">NeoMutt Project</ulink></para></listitem>
+ <listitem><para><link linkend="compile-time-features">Compile-Time Features</link></para></listitem>
+ </itemizedlist>
+ </sect2>
+
+ <sect2 id="nntp-known-bugs">
+ <title>Known Bugs</title>
+ </sect2>
+
+ <sect2 id="nntp-credits">
+ <title>Credits</title>
+ <itemizedlist>
+ <listitem><para>Vsevolod Volkov <email>vvv@mutt.org.ua</email></para></listitem>
+ <listitem><para>Felix von Leitner <email>leitner@fefe.de</email></para></listitem>
+ <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
+ </itemizedlist>
+ </sect2>
+</sect1>
+
+<sect1 id="progress">
+ <title>Progress Bar Patch</title>
+ <subtitle>Show a visual progress bar on slow operations</subtitle>
+
+ <sect2 id="progress-patch">
+ <title>Patch</title>
+
+ <para>
+ To check if Mutt supports <quote>Progress Bar</quote>, look for
+ <quote>patch-progress</quote> in the mutt version.
+ See: <xref linkend="mutt-patches"/>.
+ </para>
+
+ <itemizedlist>
+ <title>Dependencies:</title>
+ <listitem><para>mutt-1.6.1</para></listitem>
+ </itemizedlist>
+
+ <para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
+ </sect2>
+
+ <sect2 id="progress-intro">
+ <title>Introduction</title>
+
+ <para>
+ The <quote>progress</quote> patch shows a visual progress bar on slow
+ tasks, such as indexing a large folder over the net.
+ </para>
+ </sect2>
+
+<!--
+ <sect2 id="progress-variables">
+ <title>Variables</title>
+ <para>None</para>
+ </sect2>
+
+ <sect2 id="progress-functions">
+ <title>Functions</title>
+ <para>None</para>
+ </sect2>
+
+ <sect2 id="progress-commands">
+ <title>Commands</title>
+ <para>None</para>
+ </sect2>
+-->
+
+ <sect2 id="progress-colors">
+ <title>Colors</title>
+ <table id="table-progress-colors">
+ <title>Progress Colors</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Name</entry>
+ <entry>Default Color</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>progress</literal></entry>
+ <entry>default</entry>
+ <entry>Visual progress bar</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect2>
+
+<!--
+ <sect2 id="progress-sort">
+ <title>Sort</title>
+ <para>None</para>
+ </sect2>
+-->
+
+ <sect2 id="progress-muttrc">
+ <title>Muttrc</title>
+<screen>
+<emphasis role="comment"># Example Mutt config file for the 'progress' patch.
+
+# The 'progress' patch provides clear visual feedback for
+# slow tasks, such as indexing a large folder over the net.
+
+# Set the color of the progress bar
+# White text on a red background</emphasis>
+color progress white red
+
+<emphasis role="comment"># vim: syntax=muttrc</emphasis>
+</screen>
+ </sect2>
+
+ <sect2 id="progress-see-also">
+ <title>See Also</title>
+
+ <itemizedlist>
+ <listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
+ <listitem><para><link linkend="color">Color command</link></para></listitem>
+ </itemizedlist>
+ </sect2>
+
+ <sect2 id="progress-known-bugs">
+ <title>Known Bugs</title>
+ <para>None</para>
+ </sect2>
+
+ <sect2 id="progress-credits">
+ <title>Credits</title>
+ <itemizedlist>
+ <listitem><para>Rocco Rutte <email>pdmef@gmx.net</email></para></listitem>
+ <listitem><para>Vincent Lefevre <email>vincent@vinc17.org</email></para></listitem>
+ <listitem><para>Stefan Kuhn <email>wuodan@hispeed.ch</email></para></listitem>
+ <listitem><para>Karel Zak <email>kzak@redhat.com</email></para></listitem>
+ <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
+ </itemizedlist>
+ </sect2>
+</sect1>
+
+<sect1 id="quasi-delete">
+ <title>Quasi-Delete Patch</title>
+ <subtitle>Mark emails that should be hidden, but not deleted</subtitle>
+
+ <sect2 id="quasi-delete-patch">
+ <title>Patch</title>
+
+ <para>
+ To check if Mutt supports <quote>Quasi-Delete</quote>, look for
+ <quote>patch-quasi-delete</quote> in the mutt version.
+ See: <xref linkend="mutt-patches"/>.
+ </para>
+
+ <itemizedlist>
+ <title>Dependencies:</title>
+ <listitem><para>mutt-1.6.1</para></listitem>
+ </itemizedlist>
+
+ <para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
+ </sect2>
+
+ <sect2 id="quasi-delete-intro">
+ <title>Introduction</title>
+
+ <para>
+ The <quote>quasi-delete</quote> function marks an email that should be
+ hidden from the index, but NOT deleted.
+ </para>
+
+ <para>
+ On its own, this patch isn't very useful. It forms a useful part of
+ the notmuch plugin.
+ </para>
+ </sect2>
- <screen>append-hook regexp shell-command</screen>
+<!--
+ <sect2 id="quasi-delete-variables">
+ <title>Variables</title>
+ <para>None</para>
+ </sect2>
+-->
- <para>
- When Mutt wants to append an email to a compressed mail folder, it
- will look for a matching <literal>append-hook</literal>.
- This hook is <link linkend="table-compress-optional">optional</link>.
- </para>
+ <sect2 id="quasi-delete-functions">
+ <title>Functions</title>
+ <table id="table-quasi-delete-functions">
+ <title>Quasi-Delete Functions</title>
+ <tgroup cols="4">
+ <thead>
+ <row>
+ <entry>Menus</entry>
+ <entry>Default Key</entry>
+ <entry>Function</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>index,pager</entry>
+ <entry>(none)</entry>
+ <entry><literal><quasi-delete></literal></entry>
+ <entry>delete from mutt, don't touch on disk</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect2>
- <para>
- Using the <literal>append-hook</literal> will save time, but
- Mutt won't be able to determine the type of the mail folder
- inside the compressed file.
- </para>
+<!--
+ <sect2 id="quasi-delete-commands">
+ <title>Commands</title>
+ <para>None</para>
+ </sect2>
- <para>
- Mutt will <emphasis>assume</emphasis> the type to be that of
- the <literal>$mbox_type</literal> variable. Mutt also uses
- this type for temporary files.
- </para>
+ <sect2 id="quasi-delete-colors">
+ <title>Colors</title>
+ <para>None</para>
+ </sect2>
- <para>
- Mutt will only use the <literal>append-hook</literal> for existing files.
- The <literal>close-hook</literal> will be used for empty, or missing files.
- </para>
+ <sect2 id="quasi-delete-sort">
+ <title>Sort</title>
+ <para>None</para>
+ </sect2>
+-->
- <sect4 id="compress-append-hook-example">
- <title>Example of append-hook</title>
+ <sect2 id="quasi-delete-muttrc">
+ <title>Muttrc</title>
+<screen>
+<emphasis role="comment"># Example Mutt config file for the 'quasi-delete' feature.
+
+# The 'quasi-delete' function marks an email that should be hidden
+# from the index, but NOT deleted.</emphasis>
+bind index,pager Q quasi-delete
+
+<emphasis role="comment"># vim: syntax=muttrc</emphasis>
+</screen>
+ </sect2>
- <screen>append-hook '\.gz$' "gzip -c '%t' >> '%f'"</screen>
+ <sect2 id="quasi-delete-see-also">
+ <title>See Also</title>
- <itemizedlist>
- <listitem><para>Mutt wants to append an email to a folder, <quote>example.gz</quote>,
- that it opened with <literal>open-hook</literal></para></listitem>
- <listitem><para>Mutt has an <literal>append-hook</literal> whose regexp matches
- the filename: <literal>\.gz$</literal></para></listitem>
- <listitem><para>Mutt knows the mailbox type from the <literal>$mbox</literal>
- variable</para></listitem>
- <listitem><para>Mutt uses the command <literal>gzip -c</literal>
- to append to an existing compressed file</para></listitem>
- </itemizedlist>
- </sect4>
+ <itemizedlist>
+ <listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
+ <listitem><para><link linkend="notmuch">notmuch patch</link></para></listitem>
+ </itemizedlist>
+ </sect2>
- </sect3>
+ <sect2 id="quasi-delete-known-bugs">
+ <title>Known Bugs</title>
+ <para>None</para>
+ </sect2>
+
+ <sect2 id="quasi-delete-credits">
+ <title>Credits</title>
+ <itemizedlist>
+ <listitem><para>Karel Zak <email>kzak@redhat.com</email></para></listitem>
+ <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
+ </itemizedlist>
+ </sect2>
+</sect1>
+
+<sect1 id="sidebar">
+ <title>Sidebar Patch</title>
+ <subtitle>Overview of mailboxes</subtitle>
+
+ <sect2 id="sidebar-patch">
+ <title>Patch</title>
+
+ <para>
+ To check if Mutt supports <quote>Sidebar</quote>, look for
+ <quote>+USE_SIDEBAR</quote> in the mutt version.
+ See: <xref linkend="compile-time-features"/>.
+ </para>
+
+ <itemizedlist>
+ <title>Dependencies:</title>
+ <listitem><para>mutt-1.6.1</para></listitem>
+ </itemizedlist>
+
+ <para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
+ </sect2>
+
+ <sect2 id="sidebar-intro">
+ <title>Introduction</title>
+
+ <para>
+ The Sidebar shows a list of all your mailboxes. The list can be
+ turned on and off, it can be themed and the list style can be
+ configured.
+ </para>
+
+ <para>
+ This part of the manual is a reference guide.
+ If you want a simple introduction with examples see the
+ <link linkend="intro-sidebar">Sidebar Howto</link>.
+ If you just want to get started, you could use the sample
+ <link linkend="sidebar-muttrc">Sidebar muttrc</link>.
+ </para>
+
+ <para>
+ This version of Sidebar is based on Terry Chan's
+ <ulink url="http://www.lunar-linux.org/mutt-sidebar/">2015-11-11 release</ulink>.
+ It contains many
+ <emphasis role="bold"><link linkend="intro-sidebar-features">new features</link></emphasis>,
+ lots of
+ <emphasis role="bold"><link linkend="intro-sidebar-bugfixes">bugfixes</link></emphasis>.
+ </para>
+ </sect2>
+
+ <sect2 id="sidebar-variables">
+ <title>Variables</title>
+
+ <table id="table-sidebar-variables">
+ <title>Sidebar Variables</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Name</entry>
+ <entry>Type</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>sidebar_delim_chars</literal></entry>
+ <entry>string</entry>
+ <entry><literal>/.</literal></entry>
+ </row>
+ <row>
+ <entry><literal>sidebar_divider_char</literal></entry>
+ <entry>string</entry>
+ <entry><literal>|</literal></entry>
+ </row>
+ <row>
+ <entry><literal>sidebar_folder_indent</literal></entry>
+ <entry>boolean</entry>
+ <entry><literal>no</literal></entry>
+ </row>
+ <row>
+ <entry><literal>sidebar_format</literal></entry>
+ <entry>string</entry>
+ <entry><literal>%B%* %n</literal></entry>
+ </row>
+ <row>
+ <entry><literal>sidebar_indent_string</literal></entry>
+ <entry>string</entry>
+ <entry><literal> </literal> (two spaces)</entry>
+ </row>
+ <row>
+ <entry><literal>sidebar_new_mail_only</literal></entry>
+ <entry>boolean</entry>
+ <entry><literal>no</literal></entry>
+ </row>
+ <row>
+ <entry><literal>sidebar_next_new_wrap</literal></entry>
+ <entry>boolean</entry>
+ <entry><literal>no</literal></entry>
+ </row>
+ <row>
+ <entry><literal>sidebar_short_path</literal></entry>
+ <entry>boolean</entry>
+ <entry><literal>no</literal></entry>
+ </row>
+ <row>
+ <entry><literal>sidebar_sort_method</literal></entry>
+ <entry>enum</entry>
+ <entry><literal>unsorted</literal></entry>
+ </row>
+ <row>
+ <entry><literal>sidebar_visible</literal></entry>
+ <entry>boolean</entry>
+ <entry><literal>no</literal></entry>
+ </row>
+ <row>
+ <entry><literal>sidebar_whitelist</literal></entry>
+ <entry>list</entry>
+ <entry>(empty)</entry>
+ </row>
+ <row>
+ <entry><literal>sidebar_width</literal></entry>
+ <entry>number</entry>
+ <entry><literal>20</literal></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect2>
+
+ <sect2 id="sidebar-functions">
+ <title>Functions</title>
+
+ <para>
+ Sidebar adds the following functions to Mutt.
+ By default, none of them are bound to keys.
+ </para>
+
+ <table id="table-sidebar-functions">
+ <title>Sidebar Functions</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Menus</entry>
+ <entry>Function</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>index,pager</entry>
+ <entry><literal><sidebar-next></literal></entry>
+ <entry>Move the highlight to next mailbox</entry>
+ </row>
+ <row>
+ <entry>index,pager</entry>
+ <entry><literal><sidebar-next-new></literal></entry>
+ <entry>Move the highlight to next mailbox with new mail</entry>
+ </row>
+ <row>
+ <entry>index,pager</entry>
+ <entry><literal><sidebar-open></literal></entry>
+ <entry>Open highlighted mailbox</entry>
+ </row>
+ <row>
+ <entry>index,pager</entry>
+ <entry><literal><sidebar-page-down></literal></entry>
+ <entry>Scroll the Sidebar down 1 page</entry>
+ </row>
+ <row>
+ <entry>index,pager</entry>
+ <entry><literal><sidebar-page-up></literal></entry>
+ <entry>Scroll the Sidebar up 1 page</entry>
+ </row>
+ <row>
+ <entry>index,pager</entry>
+ <entry><literal><sidebar-prev></literal></entry>
+ <entry>Move the highlight to previous mailbox</entry>
+ </row>
+ <row>
+ <entry>index,pager</entry>
+ <entry><literal><sidebar-prev-new></literal></entry>
+ <entry>Move the highlight to previous mailbox with new mail</entry>
+ </row>
+ <row>
+ <entry>index,pager</entry>
+ <entry><literal><sidebar-toggle-visible></literal></entry>
+ <entry>Make the Sidebar (in)visible</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect2>
- <sect3 id="compress-empty">
- <title>Empty Files</title>
+ <sect2 id="sidebar-commands">
+ <title>Commands</title>
+ <cmdsynopsis>
+ <command>sidebar_whitelist<anchor id="sidebar-whitelist"/></command>
+ <arg choice="plain">
+ <replaceable class="parameter">mailbox</replaceable>
+ </arg>
+ <arg choice="opt" rep="repeat">
+ <replaceable class="parameter">mailbox</replaceable>
+ </arg>
+ </cmdsynopsis>
+ </sect2>
- <para>
- Mutt assumes that an empty file is not compressed. In this
- situation, unset <link linkend="save-empty">$save_empty</link>, so
- that the compressed file will be removed if you delete all of the
- messages.
- </para>
- </sect3>
+ <sect2 id="sidebar-colors">
+ <title>Colors</title>
- <sect3 id="compress-security">
- <title>Security</title>
+ <table id="table-sidebar-colors">
+ <title>Sidebar Colors</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Name</entry>
+ <entry>Default Color</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>sidebar_divider</literal></entry>
+ <entry>default</entry>
+ <entry>The dividing line between the Sidebar and the Index/Pager panels</entry>
+ </row>
+ <row>
+ <entry><literal>sidebar_flagged</literal></entry>
+ <entry>default</entry>
+ <entry>Mailboxes containing flagged mail</entry>
+ </row>
+ <row>
+ <entry><literal>sidebar_highlight</literal></entry>
+ <entry>underline</entry>
+ <entry>Cursor to select a mailbox</entry>
+ </row>
+ <row>
+ <entry><literal>sidebar_indicator</literal></entry>
+ <entry>mutt <literal>indicator</literal></entry>
+ <entry>The mailbox open in the Index panel</entry>
+ </row>
+ <row>
+ <entry><literal>sidebar_new</literal></entry>
+ <entry>default</entry>
+ <entry>Mailboxes containing new mail</entry>
+ </row>
+ <row>
+ <entry><literal>sidebar_spoolfile</literal></entry>
+ <entry>default</entry>
+ <entry>Mailbox that receives incoming mail</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
- <para>
- Encrypted files are decrypted into temporary files which are
- stored in the <link linkend="tmpdir">$tmpdir</link> directory.
- This could be a security risk.
- </para>
- </sect3>
- </sect2>
+ <para>
+ If the <literal>sidebar_indicator</literal> color isn't set, then the default Mutt
+ indicator color will be used (the color used in the index panel).
+ </para>
+ </sect2>
-<!--
- <sect2 id="compress-colors">
- <title>Colors</title>
- <para>None</para>
- </sect2>
+ <sect2 id="sidebar-sort">
+ <title>Sort</title>
- <sect2 id="compress-sort">
- <title>Sort</title>
- <para>None</para>
- </sect2>
--->
+ <table id="table-sidebar-sort">
+ <title>Sidebar Sort</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Sort</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>alpha</literal></entry>
+ <entry>Alphabetically by path</entry>
+ </row>
+ <row>
+ <entry><literal>count</literal></entry>
+ <entry>Total number of messages</entry>
+ </row>
+ <row>
+ <entry><literal>flagged</literal></entry>
+ <entry>Number of flagged messages</entry>
+ </row>
+ <row>
+ <entry><literal>name</literal></entry>
+ <entry>Alphabetically by path</entry>
+ </row>
+ <row>
+ <entry><literal>new</literal></entry>
+ <entry>Number of new messages</entry>
+ </row>
+ <row>
+ <entry><literal>path</literal></entry>
+ <entry>Alphabetically by path</entry>
+ </row>
+ <row>
+ <entry><literal>unsorted</literal></entry>
+ <entry>Do not resort the paths</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect2>
- <sect2 id="compress-muttrc">
- <title>Muttrc</title>
+ <sect2 id="sidebar-muttrc">
+ <title>Muttrc</title>
<screen>
-<emphasis role="comment"># Example Mutt config file for the 'compressed folders' feature.
+<emphasis role="comment"># This is a complete list of sidebar-related configuration.
+
+# --------------------------------------------------------------------------
+# VARIABLES - shown with their default values
+# --------------------------------------------------------------------------
+
+# Should the Sidebar be shown?</emphasis>
+set sidebar_visible = no
+
+<emphasis role="comment"># How wide should the Sidebar be in screen columns?
+# Note: Some characters, e.g. Chinese, take up two columns each.</emphasis>
+set sidebar_width = 20
+
+<emphasis role="comment"># Should the mailbox paths be abbreviated?</emphasis>
+set sidebar_short_path = no
+
+<emphasis role="comment"># When abbreviating mailbox path names, use any of these characters as path
+# separators. Only the part after the last separators will be shown.
+# For file folders '/' is good. For IMAP folders, often '.' is useful.</emphasis>
+set sidebar_delim_chars = '/.'
+
+<emphasis role="comment"># If the mailbox path is abbreviated, should it be indented?</emphasis>
+set sidebar_folder_indent = no
+
+<emphasis role="comment"># Indent mailbox paths with this string.</emphasis>
+set sidebar_indent_string = ' '
+
+<emphasis role="comment"># Make the Sidebar only display mailboxes that contain new, or flagged,
+# mail.</emphasis>
+set sidebar_new_mail_only = no
+
+<emphasis role="comment"># Any mailboxes that are whitelisted will always be visible, even if the
+# sidebar_new_mail_only option is enabled.</emphasis>
+sidebar_whitelist '/home/user/mailbox1'
+sidebar_whitelist '/home/user/mailbox2'
+
+<emphasis role="comment"># When searching for mailboxes containing new mail, should the search wrap
+# around when it reaches the end of the list?</emphasis>
+set sidebar_next_new_wrap = no
+
+<emphasis role="comment"># The character to use as the divider between the Sidebar and the other Mutt
+# panels.
+# Note: Only the first character of this string is used.</emphasis>
+set sidebar_divider_char = '|'
+
+<emphasis role="comment"># Display the Sidebar mailboxes using this format string.</emphasis>
+set sidebar_format = '%B%?F? [%F]?%* %?N?%N/?%S'
+
+<emphasis role="comment"># Sidebar will not refresh its list of mailboxes any more frequently than
+# this number of seconds. This will help reduce disk/network traffic.</emphasis>
+set sidebar_refresh_time = 60
+
+<emphasis role="comment"># Sort the mailboxes in the Sidebar using this method:
+# count - total number of messages
+# flagged - number of flagged messages
+# new - number of new messages
+# path - mailbox path
+# unsorted - do not sort the mailboxes</emphasis>
+set sidebar_sort_method = 'unsorted'
+
+<emphasis role="comment"># --------------------------------------------------------------------------
+# FUNCTIONS - shown with an example mapping
+# --------------------------------------------------------------------------
+
+# Move the highlight to the previous mailbox</emphasis>
+bind index,pager \Cp sidebar-prev
+
+<emphasis role="comment"># Move the highlight to the next mailbox</emphasis>
+bind index,pager \Cn sidebar-next
-# This feature adds three hooks to Mutt which allow it to
-# work with compressed, or encrypted, mailboxes.
+<emphasis role="comment"># Open the highlighted mailbox</emphasis>
+bind index,pager \Co sidebar-open
-# The hooks are of the form:
-# open-hook regexp "shell-command"
-# close-hook regexp "shell-command"
-# append-hook regexp "shell-command"
+<emphasis role="comment"># Move the highlight to the previous page
+# This is useful if you have a LOT of mailboxes.</emphasis>
+bind index,pager <F3> sidebar-page-up
-# The 'append-hook' is optional.
+<emphasis role="comment"># Move the highlight to the next page
+# This is useful if you have a LOT of mailboxes.</emphasis>
+bind index,pager <F4> sidebar-page-down
-# Hander for gzip compressed mailboxes</emphasis>
-open-hook '\.gz$' "gzip -cd '%f' > '%t'"
-close-hook '\.gz$' "gzip -c '%t' > '%f'"
-append-hook '\.gz$' "gzip -c '%t' >> '%f'"
+<emphasis role="comment"># Move the highlight to the previous mailbox containing new, or flagged,
+# mail.</emphasis>
+bind index,pager <F5> sidebar-prev-new
-<emphasis role="comment"># Hander for bzip2 compressed mailboxes</emphasis>
-open-hook '\.bz2$' "bzip2 -cd '%f' > '%t'"
-close-hook '\.bz2$' "bzip2 -c '%t' > '%f'"
-append-hook '\.bz2$' "bzip2 -c '%t' >> '%f'"
+<emphasis role="comment"># Move the highlight to the next mailbox containing new, or flagged, mail.</emphasis>
+bind index,pager <F6> sidebar-next-new
-<emphasis role="comment"># Hander for xz compressed mailboxes</emphasis>
-open-hook '\.xz$' "xz -cd '%f' > '%t'"
-close-hook '\.xz$' "xz -c '%t' > '%f'"
-append-hook '\.xz$' "xz -c '%t' >> '%f'"
+<emphasis role="comment"># Toggle the visibility of the Sidebar.</emphasis>
+bind index,pager B sidebar-toggle-visible
-<emphasis role="comment"># Hander for pgp encrypted mailboxes
-# PGP does not support appending to an encrypted file</emphasis>
-open-hook '\.pgp$' "pgp -f < '%f' > '%t'"
-close-hook '\.pgp$' "pgp -fe YourPgpUserIdOrKeyId < '%t' > '%f'"
+<emphasis role="comment"># --------------------------------------------------------------------------
+# COLORS - some unpleasant examples are given
+# --------------------------------------------------------------------------
+# Note: All color operations are of the form:
+# color OBJECT FOREGROUND BACKGROUND
-<emphasis role="comment"># Hander for gpg encrypted mailboxes
-# gpg does not support appending to an encrypted file</emphasis>
-open-hook '\.gpg$' "gpg --decrypt < '%f' > '%t'"
-close-hook '\.gpg$' "gpg --encrypt --recipient YourGpgUserIdOrKeyId < '%t' > '%f'"
+# Color of the current, open, mailbox
+# Note: This is a general Mutt option which colors all selected items.</emphasis>
+color indicator cyan black
-<emphasis role="comment"># vim: syntax=muttrc</emphasis>
+<emphasis role="comment"># Color of the highlighted, but not open, mailbox.</emphasis>
+color sidebar_highlight black color8
+
+<emphasis role="comment"># Color of the divider separating the Sidebar from Mutt panels</emphasis>
+color sidebar_divider color8 black
+
+<emphasis role="comment"># Color to give mailboxes containing flagged mail</emphasis>
+color sidebar_flagged red black
+
+<emphasis role="comment"># Color to give mailboxes containing new mail</emphasis>
+color sidebar_new green black
+
+<emphasis role="comment"># --------------------------------------------------------------------------
+
+# vim: syntax=muttrc</emphasis>
</screen>
- </sect2>
-
- <sect2 id="compress-see-also">
- <title>See Also</title>
+ </sect2>
- <itemizedlist>
- <listitem><para><ulink url="https://github.com/neomutt/neomutt/wiki">NeoMutt Project</ulink></para></listitem>
- <listitem><para><link linkend="compile-time-features">Compile-Time Features</link></para></listitem>
- <listitem><para><link linkend="regexp">Regular Expressions</link></para></listitem>
- <listitem><para><link linkend="tmpdir">$tmpdir</link></para></listitem>
- <listitem><para><link linkend="mbox-type">$mbox_type</link></para></listitem>
- <listitem><para><link linkend="save-empty">$save_empty</link></para></listitem>
- <listitem><para><link linkend="folder-hook">folder-hook</link></para></listitem>
- </itemizedlist>
- </sect2>
+ <sect2 id="sidebar-see-also">
+ <title>See Also</title>
- <sect2 id="compress-known-bugs">
- <title>Known Bugs</title>
+ <itemizedlist>
+ <listitem><para><link linkend="regexp">Regular Expressions</link></para></listitem>
+ <listitem><para><link linkend="patterns">Patterns</link></para></listitem>
+ <listitem><para><link linkend="color">Color command</link></para></listitem>
+ <listitem><para><link linkend="notmuch">notmuch patch</link></para></listitem>
+ </itemizedlist>
+ </sect2>
- <itemizedlist>
- <listitem><para>The Compressed Folder hooks cannot deal with filenames that contains quotes/apostrophes.</para></listitem>
- </itemizedlist>
- </sect2>
+ <sect2 id="sidebar-known-bugs">
+ <title>Known Bugs</title>
+ Unsorted isn't
+ </sect2>
- <sect2 id="compress-credits">
- <title>Credits</title>
- <itemizedlist>
- <listitem><para>Roland Rosenfeld <email>roland@spinnaker.de</email></para></listitem>
- <listitem><para>Alain Penders <email>Alain@Finale-Dev.com</email></para></listitem>
- <listitem><para>Christoph <quote>Myon</quote> Berg <email>myon@debian.org</email></para></listitem>
- <listitem><para>Evgeni Golov <email>evgeni@debian.org</email></para></listitem>
- <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
- </itemizedlist>
- </sect2>
+ <sect2 id="sidebar-credits">
+ <title>Credits</title>
+ <itemizedlist>
+ <listitem><para>Justin Hibbits <email>jrh29@po.cwru.edu</email></para></listitem>
+ <listitem><para>Thomer M. Gil <email>mutt@thomer.com</email></para></listitem>
+ <listitem><para>David Sterba <email>dsterba@suse.cz</email></para></listitem>
+ <listitem><para>Evgeni Golov <email>evgeni@debian.org</email></para></listitem>
+ <listitem><para>Fabian Groffen <email>grobian@gentoo.org</email></para></listitem>
+ <listitem><para>Jason DeTiberus <email>jdetiber@redhat.com</email></para></listitem>
+ <listitem><para>Stefan Assmann <email>sassmann@kpanic.de</email></para></listitem>
+ <listitem><para>Steve Kemp <email>steve@steve.org.uk</email></para></listitem>
+ <listitem><para>Terry Chan <email>tchan@lunar-linux.org</email></para></listitem>
+ <listitem><para>Tyler Earnest <email>tylere@rne.st</email></para></listitem>
+ <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
+ </itemizedlist>
+ </sect2>
</sect1>
-<sect1 id="keywords">
- <title>Keywords Patch</title>
- <subtitle>Labels/Tagging for emails</subtitle>
+<sect1 id="skip-quoted-patch">
+ <title>Skip-Quoted Patch</title>
+ <subtitle>Leave some context visible</subtitle>
- <sect2 id="keywords-patch">
+ <sect2 id="skip-quoted-patch2">
<title>Patch</title>
<para>
- To check if Mutt supports <quote>Keywords</quote>, look for
- <quote>patch-keywords</quote> in the mutt version.
+ To check if Mutt supports <quote>skip-quoted</quote>, look for
+ <quote>patch-skip-quoted</quote> in the mutt version.
See: <xref linkend="mutt-patches"/>.
</para>
<para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
</sect2>
- <sect2 id="keywords-intro">
+ <sect2 id="skip-quoted-intro">
<title>Introduction</title>
<para>
- Unify label/keyword handling.
- </para>
-
- <para>
- Since x-labels were added to mutt in 2000, a number of other approaches
- to what we now call <quote>tagging</quote> have also emerged.
- One of them was even made standard in RFC 2822.
- This update unifies the handling of all these strategies.
- </para>
-
- <para>
- We start by changing mutt's internal keyword storage from a single
- string which may contain whitespace to a list of discrete keywords.
- This has advantages for keyword completion as well as for portabilty
- among varying "standards" for keyword storage. This may represent
- a significant change for existing mutt users who have set x-labels
- containing spaces, and should be regarded with suspicion. The
- advantages are significant, though.
- </para>
-
- <para>
- Next we allow mutt to parse keywords into this internal list from
- any of the following headers: X-Label (freeform), X-Keywords
- (space-delimited), X-Mozilla-Keys (space-delimited), and Keywords (RFC
- 2822, comma-space-delimited). Mutt remembers which headers it sourced
- keywords from, and can rewrite those headers when saving messages for
- compatibility with the mailer of origin.
- </para>
-
- <para>
- (X-Label was specified as freeform text by mutt, its only known
- implementation. X-Labels have been used both as a
- <quote>tagging</quote> device, probably with space delimiting, and as a
- <quote>memo</quote> field, where space-delimited parsing would ruin the
- semantics of the memo. By default mutt will not split X-Labels at all.
- Set $xlabel_delimiter if your needs vary.)
- </para>
-
- <para>
- Finally we add two booleans: $keywords_legacy=true and
- $keywords_standard=FALSE. When $keywords_legacy is true, mutt will
- always save keyword to whatever original header it came from. When
- $keywords_standard=true, mutt will save to the Keywords: header. If
- both are true mutt saves to both; if neither is true, mutt saves only
- to legacy headers to avoid complete loss of keywords.
- </para>
-
- <para>
- Overall this represents convergence path for all competing
- labelling/tagging/keywording systems toward one that is specified by
- RFC.
+ When viewing an email, the
+ <literal><skip-to-quoted></literal> function (by default the
+ <literal>S</literal> key) will scroll past any quoted text.
+ Sometimes, a little context is useful.
</para>
<para>
- You can change or delete the X-Label: field within
- Mutt using the edit-label command, bound to the
- y key by default. This works for tagged messages, too.
+ By setting the <literal>$skip_quoted_offset</literal> variable, you
+ can select how much of the quoted text is left visible.
</para>
</sect2>
- <sect2 id="keywords-variables">
+ <sect2 id="skip-quoted-variables">
<title>Variables</title>
-
- <table id="table-keywords-variables">
- <title>Keywords Variables</title>
+ <table id="table-skip-quoted-variables">
+ <title>Skip-Quoted Variables</title>
<tgroup cols="3">
<thead>
<row>
</thead>
<tbody>
<row>
- <entry><literal>keywords_legacy</literal></entry>
- <entry>boolean</entry>
- <entry><literal>yes</literal></entry>
- </row>
- <row>
- <entry><literal>keywords_standard</literal></entry>
- <entry>boolean</entry>
- <entry><literal>no</literal></entry>
- </row>
- <row>
- <entry><literal>xlabel_delimiter</literal></entry>
- <entry>string</entry>
- <entry>(empty)</entry>
+ <entry><literal>skip_quoted_offset</literal></entry>
+ <entry>number</entry>
+ <entry>0</entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>
- <sect2 id="keywords-functions">
+<!--
+ <sect2 id="skip-quoted-functions">
<title>Functions</title>
-
- <table id="table-keywords-funcions">
- <title>Keyword Functions</title>
- <tgroup cols="4">
- <thead>
- <row>
- <entry>Menus</entry>
- <entry>Default Key</entry>
- <entry>Function</entry>
- <entry>Description</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>index,pager</entry>
- <entry>y</entry>
- <entry><literal><edit-label></literal></entry>
- <entry>add, change, or delete a message's label</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
+ <para>None</para>
</sect2>
-<!--
- <sect2 id="keywords-commands">
+ <sect2 id="skip-quoted-commands">
<title>Commands</title>
+ <para>None</para>
</sect2>
- <sect2 id="keywords-colors">
+ <sect2 id="skip-quoted-colors">
<title>Colors</title>
<para>None</para>
</sect2>
--->
- <sect2 id="keywords-sort">
+ <sect2 id="skip-quoted-sort">
<title>Sort</title>
- <table id="table-keywords-sort">
- <title>Keywords Sort</title>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>Sort</entry>
- <entry>Description</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry><literal>label</literal></entry>
- <entry>Sort by label</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
+ <para>None</para>
</sect2>
+-->
- <sect2 id="keywords-muttrc">
+ <sect2 id="skip-quoted-muttrc">
<title>Muttrc</title>
+
+<screen>
+<emphasis role="comment"># Example Mutt config file for the 'skip-quoted' patch.
+
+# The 'S' (skip-quoted) command scrolls the pager past the quoted text (usually
+# indented with '> '. Setting 'skip_quoted_offset' leaves some lines of quoted
+# text on screen for context.
+
+# Show three quoted lines before the reply</emphasis>
+set skip_quoted_offset = 3
+
+<emphasis role="comment"># vim: syntax=muttrc</emphasis>
+</screen>
</sect2>
- <sect2 id="keywords-see-also">
+ <sect2 id="skip-quoted-see-also">
<title>See Also</title>
<itemizedlist>
- <listitem><para><ulink url="https://github.com/neomutt/neomutt/wiki">NeoMutt Project</ulink></para></listitem>
- <listitem><para><link linkend="index-format">$index_format</link></para></listitem>
- <listitem><para><link linkend="index-color">index-color patch</link></para></listitem>
- <listitem><para><link linkend="folder-hook">folder-hook</link></para></listitem>
+ <listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
</itemizedlist>
</sect2>
- <sect2 id="keywords-known-bugs">
+ <sect2 id="skip-quoted-known-bugs">
<title>Known Bugs</title>
+ <para>None</para>
</sect2>
- <sect2 id="keywords-credits">
+ <sect2 id="skip-quoted-credits">
<title>Credits</title>
<itemizedlist>
- <listitem><para>David Champion <email>dgc@uchicago.edu</email></para></listitem>
+ <listitem><para>David Sterba <email>dsterba@suse.cz</email></para></listitem>
<listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
</itemizedlist>
</sect2>
</sect1>
-<sect1 id="nntp">
- <title>NNTP Patch</title>
- <subtitle>Talk to a Usenet news server</subtitle>
+<sect1 id="status-color">
+ <title>Status Color Patch</title>
+ <subtitle>Custom rules for theming the status bar</subtitle>
- <sect2 id="nntp-patch">
+ <sect2 id="status-color-patch">
<title>Patch</title>
<para>
- To check if Mutt supports <quote>NNTP</quote>, look for
- <quote>+USE_NNTP</quote> in the mutt version.
- See: <xref linkend="compile-time-features"/>.
+ To check if Mutt supports <quote>Status Color</quote>, look for
+ <quote>patch-status-color</quote> in the mutt version.
+ See: <xref linkend="mutt-patches"/>.
</para>
<itemizedlist>
<para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
</sect2>
- <sect2 id="nntp-intro">
+ <sect2 id="status-color-intro">
<title>Introduction</title>
- <para>Reading news via NNTP</para>
- <para>
- If compiled with <emphasis>--enable-nntp</emphasis> option, Mutt can
- read news from news server via NNTP. You can open a newsgroup with
- function ``change-newsgroup'' (default: ``i''). Default news server
- can be obtained from <literal>$NNTPSERVER</literal> environment
- variable or from <literal>/etc/nntpserver</literal> file. Like other
- news readers, info about subscribed newsgroups is saved in file by
- <link linkend="newsrc">$newsrc</link> variable. The variable <link
- linkend="news-cache-dir">$news_cache_dir</link> can be used to point
- to a directory. Mutt will create a hierarchy of subdirectories named
- like the account and newsgroup the cache is for. Also the hierarchy
- is used to store header cache if Mutt was compiled with <link
- linkend="header-caching">header cache</link> support.
- </para>
+ <para>
+ The <quote>status-color</quote> patch allows you to theme different
+ parts of the status bar (also when it's used by the index).
+ </para>
+
+ <para>
+ Unlike normal color commands, <literal>color status</literal> can now
+ take up to 2 extra parameters (regex, num).
+ </para>
</sect2>
- <sect2 id="nntp-variables">
+<!--
+ <sect2 id="status-color-variables">
<title>Variables</title>
+ <para>None</para>
+ </sect2>
- <table id="table-nntp-variables">
- <title>NNTP Variables</title>
- <tgroup cols="3">
- <thead>
- <row>
- <entry>Name</entry>
- <entry>Type</entry>
- <entry>Default</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry><literal>ask_follow_up</literal></entry>
- <entry>boolean</entry>
- <entry><literal>no</literal></entry>
- </row>
- <row>
- <entry><literal>ask_x_comment_to</literal></entry>
- <entry>boolean</entry>
- <entry><literal>no</literal></entry>
- </row>
- <row>
- <entry><literal>catchup_newsgroup</literal></entry>
- <entry>quad</entry>
- <entry><literal>ask-yes</literal></entry>
- </row>
- <row>
- <entry><literal>followup_to_poster</literal></entry>
- <entry>quad</entry>
- <entry><literal>ask-yes</literal></entry>
- </row>
- <row>
- <entry><literal>group_index_format</literal></entry>
- <entry>string</entry>
- <entry><literal>%4C %M%N %5s %-45.45f %d</literal></entry>
- </row>
- <row>
- <entry><literal>inews</literal></entry>
- <entry>string</entry>
- <entry>(empty)</entry>
- </row>
- <row>
- <entry><literal>mime_subject</literal></entry>
- <entry>boolean</entry>
- <entry><literal>yes</literal></entry>
- </row>
- <row>
- <entry><literal>newsgroups_charset</literal></entry>
- <entry>string</entry>
- <entry><literal>utf-8</literal></entry>
- </row>
- <row>
- <entry><literal>newsrc</literal></entry>
- <entry>string</entry>
- <entry><literal>~/.newsrc</literal></entry>
- </row>
- <row>
- <entry><literal>news_cache_dir</literal></entry>
- <entry>string</entry>
- <entry><literal>~/.mutt</literal></entry>
- </row>
- <row>
- <entry><literal>news_server</literal></entry>
- <entry>string</entry>
- <entry>(empty)</entry>
- </row>
- <row>
- <entry><literal>nntp_authenticators</literal></entry>
- <entry>string</entry>
- <entry>(empty)</entry>
- </row>
- <row>
- <entry><literal>nntp_context</literal></entry>
- <entry>number</entry>
- <entry><literal>1000</literal></entry>
- </row>
- <row>
- <entry><literal>nntp_listgroup</literal></entry>
- <entry>boolean</entry>
- <entry><literal>yes</literal></entry>
- </row>
- <row>
- <entry><literal>nntp_load_description</literal></entry>
- <entry>boolean</entry>
- <entry><literal>yes</literal></entry>
- </row>
- <row>
- <entry><literal>nntp_pass</literal></entry>
- <entry>string</entry>
- <entry>(empty)</entry>
- </row>
- <row>
- <entry><literal>nntp_poll</literal></entry>
- <entry>number</entry>
- <entry><literal>60</literal></entry>
- </row>
- <row>
- <entry><literal>nntp_user</literal></entry>
- <entry>string</entry>
- <entry>(empty)</entry>
- </row>
- <row>
- <entry><literal>post_moderated</literal></entry>
- <entry>quad</entry>
- <entry><literal>ask-yes</literal></entry>
- </row>
- <row>
- <entry><literal>save_unsubscribed</literal></entry>
- <entry>boolean</entry>
- <entry><literal>no</literal></entry>
- </row>
- <row>
- <entry><literal>show_new_news</literal></entry>
- <entry>boolean</entry>
- <entry><literal>yes</literal></entry>
- </row>
- <row>
- <entry><literal>show_only_unread</literal></entry>
- <entry>boolean</entry>
- <entry><literal>no</literal></entry>
- </row>
- <row>
- <entry><literal>x_comment_to</literal></entry>
- <entry>boolean</entry>
- <entry><literal>no</literal></entry>
- </row>
- </tbody>
- </tgroup>
- </table>
+ <sect2 id="status-color-functions">
+ <title>Functions</title>
+ <para>None</para>
+ </sect2>
+-->
+
+ <sect2 id="status-color-commands">
+ <title>Commands</title>
+ <cmdsynopsis>
+ <command>color</command>
+ <arg choice="plain">
+ <option>status</option>
+ </arg>
+ <arg choice="plain">
+ <replaceable class="parameter">foreground</replaceable>
+ </arg>
+ <arg choice="plain">
+ <replaceable class="parameter">background</replaceable>
+ </arg>
+ <group choice="opt">
+ <arg choice="plain">
+ <replaceable class="parameter">regex</replaceable>
+ </arg>
+ <group choice="opt">
+ <arg choice="plain">
+ <replaceable class="parameter">num</replaceable>
+ </arg>
+ </group>
+ </group>
+ </cmdsynopsis>
+
+ <para>
+ With zero parameters, Mutt will set the default color for the entire
+ status bar.
+ </para>
+
+ <para>
+ With one parameter, Mutt will only color the parts matching the
+ regex.
+ </para>
+
+ <para>
+ With two parameters, Mutt will only color the num'th sub-match of
+ the regex.
+ </para>
</sect2>
- <sect2 id="nntp-functions">
- <title>Functions</title>
+ <sect2 id="status-color-colors">
+ <title>Colors</title>
- <table id="table-nntp-functions">
- <title>NNTP Functions</title>
- <tgroup cols="4">
+ <table id="table-status-color-colors">
+ <title>Status Colors</title>
+ <tgroup cols="3">
<thead>
<row>
- <entry>Menus</entry>
- <entry>Default Key</entry>
- <entry>Function</entry>
+ <entry>Name</entry>
+ <entry>Default Color</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
- <entry>browser,index</entry>
- <entry>y</entry>
- <entry><literal><catchup></literal></entry>
- <entry>mark all articles in newsgroup as read</entry>
- </row>
- <row>
- <entry>index,pager</entry>
- <entry>i</entry>
- <entry><literal><change-newsgroup></literal></entry>
- <entry>open a different newsgroup</entry>
- </row>
- <row>
- <entry>pager</entry>
- <entry>X</entry>
- <entry><literal><change-vfolder></literal></entry>
- <entry>open a different virtual folder</entry>
- </row>
- <row>
- <entry>compose</entry>
- <entry>o</entry>
- <entry><literal><edit-followup-to></literal></entry>
- <entry>edit the Followup-To field</entry>
- </row>
- <row>
- <entry>compose</entry>
- <entry>N</entry>
- <entry><literal><edit-newsgroups></literal></entry>
- <entry>edit the newsgroups list</entry>
- </row>
- <row>
- <entry>compose</entry>
- <entry>x</entry>
- <entry><literal><edit-x-comment-to></literal></entry>
- <entry>edit the X-Comment-To field</entry>
- </row>
- <row>
- <entry>pager</entry>
- <entry>+</entry>
- <entry><literal><entire-thread></literal></entry>
- <entry>read entire thread of the current message</entry>
- </row>
- <row>
- <entry>attachment,index,pager</entry>
- <entry>F</entry>
- <entry><literal><followup-message></literal></entry>
- <entry>followup to newsgroup</entry>
- </row>
- <row>
- <entry>pager</entry>
- <entry>`</entry>
- <entry><literal><modify-labels></literal></entry>
- <entry>modify (notmuch) tags</entry>
- </row>
- <row>
- <entry>index,pager</entry>
- <entry>P</entry>
- <entry><literal><post-message></literal></entry>
- <entry>post message to newsgroup</entry>
- </row>
- <row>
- <entry>browser</entry>
- <entry>g</entry>
- <entry><literal><reload-active></literal></entry>
- <entry>load list of all newsgroups from NNTP server</entry>
- </row>
- <row>
- <entry>browser</entry>
- <entry>s</entry>
- <entry><literal><subscribe></literal></entry>
- <entry>subscribe to current mbox (IMAP/NNTP only)</entry>
- </row>
- <row>
- <entry>browser</entry>
- <entry>S</entry>
- <entry><literal><subscribe-pattern></literal></entry>
- <entry>subscribe to newsgroups matching a pattern</entry>
- </row>
- <row>
- <entry>browser</entry>
- <entry>Y</entry>
- <entry><literal><uncatchup></literal></entry>
- <entry>mark all articles in newsgroup as unread</entry>
- </row>
- <row>
- <entry>browser</entry>
- <entry>u</entry>
- <entry><literal><unsubscribe></literal></entry>
- <entry>unsubscribe from current mbox (IMAP/NNTP only)</entry>
- </row>
- <row>
- <entry>browser</entry>
- <entry>U</entry>
- <entry><literal><unsubscribe-pattern></literal></entry>
- <entry>unsubscribe from newsgroups matching a pattern</entry>
- </row>
- <row>
- <entry>index,pager</entry>
- <entry>Alt-i</entry>
- <entry><literal><change-newsgroup-readonly></literal></entry>
- <entry>open a different newsgroup in read only mode</entry>
- </row>
- <row>
- <entry>attachment,index,pager</entry>
- <entry>Alt-F</entry>
- <entry><literal><forward-to-group></literal></entry>
- <entry>forward to newsgroup</entry>
- </row>
- <row>
- <entry>index</entry>
- <entry>(none)</entry>
- <entry><literal><get-children></literal></entry>
- <entry>get all children of the current message</entry>
- </row>
- <row>
- <entry>index</entry>
- <entry>Alt-G</entry>
- <entry><literal><get-parent></literal></entry>
- <entry>get parent of the current message</entry>
- </row>
- <row>
- <entry>index,pager</entry>
- <entry>(none)</entry>
- <entry><literal><imap-fetch-mail></literal></entry>
- <entry>force retrieval of mail from IMAP server</entry>
- </row>
- <row>
- <entry>index,pager</entry>
- <entry>(none)</entry>
- <entry><literal><imap-logout-all></literal></entry>
- <entry>logout from all IMAP servers</entry>
- </row>
- <row>
- <entry>pager</entry>
- <entry>(none)</entry>
- <entry><literal><modify-labels-then-hide></literal></entry>
- <entry>modify labeld and then hide message</entry>
- </row>
- <row>
- <entry>index</entry>
- <entry>(none)</entry>
- <entry><literal><reconstruct-thread></literal></entry>
- <entry>reconstruct thread containing current message</entry>
- </row>
- <row>
- <entry>pager</entry>
- <entry>Alt-X</entry>
- <entry><literal><vfolder-from-query></literal></entry>
- <entry>generate virtual folder from query</entry>
- </row>
- <row>
- <entry>index</entry>
- <entry>Ctrl-G</entry>
- <entry><literal><get-message></literal></entry>
- <entry>get message with Message-Id</entry>
+ <entry>status</entry>
+ <entry><literal>reverse</literal></entry>
+ <entry>Status bar</entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>
- <sect2 id="nntp-commands">
+<!--
+ <sect2 id="status-color-sort">
+ <title>Sort</title>
+ <para>None</para>
+ </sect2>
+-->
+
+ <sect2 id="status-color-muttrc">
+ <title>Muttrc</title>
+<screen>
+<emphasis role="comment"># Example Mutt config file for the 'status-color' patch.
+
+# The 'status-color' patch allows you to theme different parts of
+# the status bar (also when it's used by the index).
+
+# For the examples below, set some defaults</emphasis>
+set status_format='-%r-Mutt: %f [Msgs:%?M?%M/?%m%?n? New:%n?%?o? Old:%o?%?d? Del:%d?%?F? Flag:%F?%?t? Tag:%t?%?p? Post:%p?%?b? Inc:%b?%?l? %l?]---(%s/%S)-%>-(%P)---'
+set index_format='%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s'
+set sort=threads
+set sort_aux=last-date-received
+
+<emphasis role="comment"># 'status color' can take up to 2 extra parameters
+
+# color status foreground background [ regex [ num ]]
+
+# 0 extra parameters
+# Set the default color for the entire status line</emphasis>
+color status blue white
+
+<emphasis role="comment"># 1 extra parameter
+# Set the color for a matching pattern
+# color status foreground background regexp
+
+# Highlight New, Deleted, or Flagged emails</emphasis>
+color status brightred white '(New|Del|Flag):[0-9]+'
+
+<emphasis role="comment"># Highlight mailbox ordering if it's different from the default
+# First, highlight anything (*/*)</emphasis>
+color status brightred default '\([^)]+/[^)]+\)'
+
+<emphasis role="comment"># Then override the color for one specific case</emphasis>
+color status default default '\(threads/last-date-received\)'
+
+<emphasis role="comment"># 2 extra parameters
+# Set the color for the nth submatch of a pattern
+# color status foreground background regexp num
+
+# Highlight the contents of the []s but not the [] themselves</emphasis>
+color status red default '\[([^]]+)\]' 1
+
+<emphasis role="comment"># The '1' refers to the first regex submatch, which is the inner
+# part in ()s
+
+# Highlight the mailbox</emphasis>
+color status brightwhite default 'Mutt: ([^ ]+)' 1
+
+<emphasis role="comment"># Search for 'Mutt: ' but only highlight what comes after it
+
+# vim: syntax=muttrc</emphasis>
+</screen>
+ </sect2>
+
+ <sect2 id="status-color-see-also">
+ <title>See Also</title>
+
+ <itemizedlist>
+ <listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
+ <listitem><para><link linkend="compile-time-features">Compile-Time Features</link></para></listitem>
+ <listitem><para><link linkend="regexp">Regular Expressions</link></para></listitem>
+ <listitem><para><link linkend="patterns">Patterns</link></para></listitem>
+ <listitem><para><link linkend="index-color">index-color patch</link></para></listitem>
+ <listitem><para><link linkend="color">Color command</link></para></listitem>
+ </itemizedlist>
+ </sect2>
+
+ <sect2 id="status-color-known-bugs">
+ <title>Known Bugs</title>
+ <para>None</para>
+ </sect2>
+
+ <sect2 id="status-color-credits">
+ <title>Credits</title>
+ <itemizedlist>
+ <listitem><para>David Sterba <email>dsterba@suse.cz</email></para></listitem>
+ <listitem><para>Thomas Glanzmann <email>thomas@glanzmann.de</email></para></listitem>
+ <listitem><para>Kirill A. Shutemov <email>kirill@shutemov.name</email></para></listitem>
+ <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
+ </itemizedlist>
+ </sect2>
+</sect1>
+
+<sect1 id="tls-sni">
+ <title>TLS-SNI Patch</title>
+ <subtitle>Negotiate with a server for a TSL/SSL certificate</subtitle>
+
+ <sect2 id="tls-sni-patch">
+ <title>Patch</title>
+
+ <para>
+ To check if Mutt supports <quote>TLS-SNI</quote>, look for
+ <quote>patch-tls-sni</quote> in the mutt version.
+ See: <xref linkend="mutt-patches"/>.
+ </para>
+
+ <itemizedlist>
+ <title>Dependencies:</title>
+ <listitem><para>mutt-1.6.1</para></listitem>
+ <listitem><para>OpenSSL</para></listitem>
+ </itemizedlist>
+
+ <para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
+ </sect2>
+
+ <sect2 id="tls-sni-intro">
+ <title>Introduction</title>
+
+ <para>
+ The <quote>TLS-SNI</quote> patch adds support for TLS virtual hosting.
+ If your mail server doesn't support this everything will still work
+ normally.
+ </para>
+
+ <para>
+ TLS supports sending the expected server hostname during the
+ handshake, via the SNI extension. This can be used to select a
+ server certificate to issue to the client, permitting
+ virtual-hosting without requiring multiple IP addresses.
+ </para>
+
+ <para>
+ This has been tested against Exim 4.80, which optionally logs SNI
+ and can perform vhosting.
+ </para>
+
+ <para>
+ To verify TLS SNI support by a server, you can use:
+ </para>
+
+<screen>
+openssl s_client -host <imap server> -port <port> -tls1 -servername <imap server>
+</screen>
+ </sect2>
+
+<!--
+ <sect2 id="tls-sni-variables">
+ <title>Variables</title>
+ <para>None</para>
+ </sect2>
+
+ <sect2 id="tls-sni-functions">
+ <title>Functions</title>
+ <para>None</para>
+ </sect2>
+
+ <sect2 id="tls-sni-commands">
<title>Commands</title>
+ <para>None</para>
</sect2>
- <sect2 id="nntp-colors">
+ <sect2 id="tls-sni-colors">
<title>Colors</title>
<para>None</para>
</sect2>
- <sect2 id="nntp-sort">
+ <sect2 id="tls-sni-sort">
<title>Sort</title>
<para>None</para>
</sect2>
+-->
- <sect2 id="nntp-muttrc">
+ <sect2 id="tls-sni-muttrc">
<title>Muttrc</title>
+ <para>None</para>
</sect2>
- <sect2 id="nntp-see-also">
+ <sect2 id="tls-sni-see-also">
<title>See Also</title>
<itemizedlist>
- <listitem><para><ulink url="https://github.com/neomutt/neomutt/wiki">NeoMutt Project</ulink></para></listitem>
- <listitem><para><link linkend="compile-time-features">Compile-Time Features</link></para></listitem>
+ <listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
</itemizedlist>
</sect2>
- <sect2 id="nntp-known-bugs">
+ <sect2 id="tls-sni-known-bugs">
<title>Known Bugs</title>
+ <para>None</para>
</sect2>
- <sect2 id="nntp-credits">
+ <sect2 id="tls-sni-credits">
<title>Credits</title>
<itemizedlist>
- <listitem><para>Vsevolod Volkov <email>vvv@mutt.org.ua</email></para></listitem>
- <listitem><para>Felix von Leitner <email>leitner@fefe.de</email></para></listitem>
+ <listitem><para>Jeremy Katz <email>katzj@linuxpower.org</email></para></listitem>
+ <listitem><para>Phil Pennock <email>mutt-dev@spodhuis.demon.nl</email></para></listitem>
<listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
</itemizedlist>
</sect2>
</sect1>
-<sect1 id="lmdb">
- <title>LMDB Patch</title>
- <subtitle>LMDB backend for the header cache</subtitle>
+<sect1 id="trash-folder">
+ <title>Trash Folder Patch</title>
+ <subtitle>Automatically move "deleted" emails to a trash bin</subtitle>
- <sect2 id="lmdb-patch">
+ <sect2 id="trash-folder-patch">
<title>Patch</title>
<para>
- To check if Mutt supports <quote>lmdb</quote>, look for
- <quote>patch-lmdb</quote> in the mutt version.
+ To check if Mutt supports <quote>Trash Folder</quote>, look for
+ <quote>patch-trash</quote> in the mutt version.
See: <xref linkend="mutt-patches"/>.
</para>
+ If IMAP is enabled, this patch will use it
+
<itemizedlist>
<title>Dependencies:</title>
<listitem><para>mutt-1.6.1</para></listitem>
+ <listitem><para>IMAP support</para></listitem>
</itemizedlist>
<para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
</sect2>
- <sect2 id="lmdb-intro">
+ <sect2 id="trash-folder-intro">
<title>Introduction</title>
<para>
- This patch adds support for using LMDB as a storage backend for
- Mutt's header cache (hcache). It is enabled at configure time with
- the <emphasis>--with-lmdb=<path></emphasis> switch.
+ In Mutt, when you <quote>delete</quote> an email it is first marked
+ deleted. The email isn't really gone until
+ <link linkend="index-map"><sync-mailbox></link> is called.
+ This happens when the user leaves the folder, or the function is called
+ manually.
+ </para>
+
+ <para>
+ After <literal><sync-mailbox></literal> has been called the email is gone forever.
+ </para>
+
+ <para>
+ The <link linkend="trash">$trash</link> variable defines a folder in
+ which to keep old emails. As before, first you mark emails for
+ deletion. When <sync-mailbox> is called the emails are moved to
+ the trash folder.
+ </para>
+
+ <para>
+ The <literal>$trash</literal> path can be either a full directory,
+ or be relative to the <link linkend="folder">$folder</link>
+ variable, like the <literal>mailboxes</literal> command.
</para>
+
+ <note>
+ Emails deleted from the trash folder are gone forever.
+ </note>
</sect2>
- <sect2 id="lmdb-see-also">
+ <sect2 id="trash-folder-variables">
+ <title>Variables</title>
+ <table id="table-trash-variables">
+ <title>Trash Variables</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Name</entry>
+ <entry>Type</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>trash</entry>
+ <entry>string</entry>
+ <entry>(none)</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect2>
+
+ <sect2 id="trash-folder-functions">
+ <title>Functions</title>
+ <table id="table-trash-functions">
+ <title>Trash Functions</title>
+ <tgroup cols="4">
+ <thead>
+ <row>
+ <entry>Menus</entry>
+ <entry>Default Key</entry>
+ <entry>Function</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>index,pager</entry>
+ <entry>(none)</entry>
+ <entry><literal><purge-message></literal></entry>
+ <entry>really delete the current entry, bypassing the trash folder</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect2>
+
+<!--
+ <sect2 id="trash-folder-commands">
+ <title>Commands</title>
+ <para>None</para>
+ </sect2>
+
+ <sect2 id="trash-folder-colors">
+ <title>Colors</title>
+ <para>None</para>
+ </sect2>
+
+ <sect2 id="trash-folder-sort">
+ <title>Sort</title>
+ <para>None</para>
+ </sect2>
+-->
+
+ <sect2 id="trash-folder-muttrc">
+ <title>Muttrc</title>
+<screen>
+<emphasis role="comment"># Example Mutt config file for the 'trash' feature.
+
+# This feature defines a new 'trash' folder.
+# When mail is deleted it will be moved to this folder.
+
+# Folder in which to put deleted emails</emphasis>
+set trash='+Trash'
+set trash='/home/flatcap/Mail/Trash'
+
+<emphasis role="comment"># The default delete key 'd' will move an email to the 'trash' folder
+# Bind 'D' to REALLY delete an email</emphasis>
+bind index D purge-message
+
+<emphasis role="comment"># Note: Deleting emails from the 'trash' folder will REALLY delete them.
+
+# vim: syntax=muttrc</emphasis>
+</screen>
+ </sect2>
+
+ <sect2 id="trash-folder-see-also">
<title>See Also</title>
<itemizedlist>
<listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
- <listitem><para><link linkend="caching">Local Caching</link></para></listitem>
+ <listitem><para><link linkend="folder-hook">folder-hook</link></para></listitem>
</itemizedlist>
</sect2>
- <sect2 id="lmdb-known-bugs">
+ <sect2 id="trash-folder-known-bugs">
<title>Known Bugs</title>
<para>None</para>
</sect2>
- <sect2 id="lmdb-credits">
+ <sect2 id="trash-folder-credits">
<title>Credits</title>
<itemizedlist>
- <listitem><para>Pietro Cerutti <email>gahr@gahr.ch</email></para></listitem>
- <listitem><para>Jan-Piet Mens <email>jp@mens.de</email></para></listitem>
+ <listitem><para>Cedric Duval <email>cedricduval@free.fr</email></para></listitem>
+ <listitem><para>Benjamin Kuperman <email>kuperman@acm.org</email></para></listitem>
+ <listitem><para>Paul Miller <email>paul@voltar.org</email></para></listitem>
+ <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
</itemizedlist>
</sect2>
</sect1>
projects / neomutt / commitdiff