diff options
| author | Kevin McCarthy <kevin@8t8.us> | 2020-11-18 15:49:44 -0800 |
|---|---|---|
| committer | Kevin McCarthy <kevin@8t8.us> | 2020-11-22 13:24:30 -0800 |
| commit | 474d368e859aa86b4adf9e41f1048488ece99c42 (patch) | |
| tree | 725e4a0e6f29fac82115d838a13a2e5614cff49d /doc | |
| parent | 03803e6789fb9a27570b75f3e6510e1881f63673 (diff) | |
Add <view-pager> function to attachment menu.
This uses a copiousoutput mailcap entry, or falls back to raw text.
The existing functions do not provide a way to use copiousoutput
mailcap entries exclusively. The default <view-attach> will use one
for internally supported types if auto_view is configured, but there
is no way to do so for other mime types (such as application/pdf).
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/manual.xml.head | 81 |
1 files changed, 81 insertions, 0 deletions
diff --git a/doc/manual.xml.head b/doc/manual.xml.head index dc3f9550..53c94ed9 100644 --- a/doc/manual.xml.head +++ b/doc/manual.xml.head @@ -7855,6 +7855,87 @@ See table <xref linkend="tab-attachment-bindings"/> for all available functions. </para> +<sect3 id="attach-viewers"> +<title>Viewing Attachments</title> + +<para> +There are four(!) ways of viewing attachments, so the functions +deserve some extra explanation. +</para> + +<variablelist> + <varlistentry> + <term> + <literal><view-mailcap></literal> + (default keybinding: m) + </term> + <listitem> + <para> + This will use the first matching mailcap entry. + </para> + <para> + If no matching mailcap entries are found, it will abort with an + error message. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <literal><view-attach></literal> + (default keybinding: <Enter>) + </term> + <listitem> + <para> + Mutt will display internally supported MIME types (see <xref + linkend="mime-pager"/>) in the pager. This will respect + <link linkend="auto-view">auto_view</link> settings, to determine + whether to use a <literal>copiousoutput</literal> mailcap entry or + just directly display the attachment. + </para> + <para> + Other MIME types will use the first matching mailcap entry. + </para> + <para> + If no matching mailcap entries are found, the attachment will + be displayed in the pager as raw text. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <literal><view-pager></literal> + </term> + <listitem> + <para> + Mutt will use the first matching + <literal>copiousoutput</literal> mailcap entry to display the + attachment in the pager (regardless of <link + linkend="auto-view">auto_view</link> settings). + </para> + <para> + If no matching mailcap entries are found, the attachment will + be displayed in the pager as raw text. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <literal><view-text></literal> + (default keybinding: T) + </term> + <listitem> + <para> + The attachment will always be displayed in the pager as raw + text. + </para> + </listitem> + </varlistentry> +</variablelist> +</sect3> + </sect2> <sect2 id="compose-menu"> |