manual.xml.head

mutt-1.5.12 源代码。linux 下邮件接受的工具。

<para>
In addition, <emphasis>key</emphasis> may consist of:
</para>

<para>

<table>
<title>Symbolic key names</title>
<tgroup cols="2">
<thead>
<row><entry>Symbolic name</entry><entry>Meaning</entry></row>
</thead>
<tbody>
<row><entry>&bsol;t</entry><entry>tab</entry></row>
<row><entry>&lt;tab&gt;</entry><entry>tab</entry></row>
<row><entry>&lt;backtab&gt;</entry><entry>backtab / shift-tab</entry></row>
<row><entry>&bsol;r</entry><entry>carriage return</entry></row>
<row><entry>&bsol;n</entry><entry>newline</entry></row>
<row><entry>&bsol;e</entry><entry>escape</entry></row>
<row><entry>&lt;esc&gt;</entry><entry>escape</entry></row>
<row><entry>&lt;up&gt;</entry><entry>up arrow</entry></row>
<row><entry>&lt;down&gt;</entry><entry>down arrow</entry></row>
<row><entry>&lt;left&gt;</entry><entry>left arrow</entry></row>
<row><entry>&lt;right&gt;</entry><entry>right arrow</entry></row>
<row><entry>&lt;pageup&gt;</entry><entry>Page Up</entry></row>
<row><entry>&lt;pagedown&gt;</entry><entry>Page Down</entry></row>
<row><entry>&lt;backspace&gt;</entry><entry>Backspace</entry></row>
<row><entry>&lt;delete&gt;</entry><entry>Delete</entry></row>
<row><entry>&lt;insert&gt;</entry><entry>Insert</entry></row>
<row><entry>&lt;enter&gt;</entry><entry>Enter</entry></row>
<row><entry>&lt;return&gt;</entry><entry>Return</entry></row>
<row><entry>&lt;home&gt;</entry><entry>Home</entry></row>
<row><entry>&lt;end&gt;</entry><entry>End</entry></row>
<row><entry>&lt;space&gt;</entry><entry>Space bar</entry></row>
<row><entry>&lt;f1&gt;</entry><entry>function key 1</entry></row>
<row><entry>&lt;f10&gt;</entry><entry>function key 10</entry></row>
</tbody>
</tgroup>
</table>

</para>

<para>
<emphasis>key</emphasis> does not need to be enclosed in quotes unless it contains a
space (`` '').
</para>

<para>
<emphasis>function</emphasis> specifies which action to take when <emphasis>key</emphasis> is pressed.
For a complete list of functions, see the <link linkend="functions">reference</link>.  The special function <literal>noop</literal> unbinds the specified key
sequence.
</para>

</sect1>

<sect1 id="charset-hook">
<title>Defining aliases for character sets </title>

<para>
<literallayout>
Usage: <literal>charset-hook</literal> <emphasis>alias</emphasis> <emphasis>charset</emphasis>
Usage: <literal>iconv-hook</literal> <emphasis>charset</emphasis> <emphasis>local-charset</emphasis>
</literallayout>
</para>

<para>
The <literal>charset-hook</literal> command defines an alias for a character set.
This is useful to properly display messages which are tagged with a
character set name not known to mutt.
</para>

<para>
The <literal>iconv-hook</literal> command defines a system-specific name for a
character set.  This is helpful when your systems character
conversion library insists on using strange, system-specific names
for character sets.
</para>

</sect1>

<sect1 id="folder-hook">
<title>Setting variables based upon mailbox</title>

<para>
Usage: <literal>folder-hook</literal> &lsqb;!&rsqb;<emphasis>regexp</emphasis> <emphasis>command</emphasis>
</para>

<para>
It is often desirable to change settings based on which mailbox you are
reading.  The folder-hook command provides a method by which you can execute
any configuration command.  <emphasis>regexp</emphasis> is a regular expression specifying
in which mailboxes to execute <emphasis>command</emphasis> before loading.  If a mailbox
matches multiple folder-hook's, they are executed in the order given in the
muttrc.
</para>

<para>
<emphasis role="bold">Note:</emphasis> if you use the ``!'' shortcut for <link linkend="spoolfile">&dollar;spoolfile</link> at the beginning of the pattern, you must place it
inside of double or single quotes in order to distinguish it from the
logical <emphasis>not</emphasis> operator for the expression.
</para>

<para>
Note that the settings are <emphasis>not</emphasis> restored when you leave the mailbox.
For example, a command action to perform is to change the sorting method
based upon the mailbox being read:
</para>

<para>

<screen>
folder-hook mutt set sort=threads
</screen>

</para>

<para>
However, the sorting method is not restored to its previous value when
reading a different mailbox.  To specify a <emphasis>default</emphasis> command, use the
pattern ``.'':
</para>

<para>

<screen>
folder-hook . set sort=date-sent
</screen>

</para>

</sect1>

<sect1 id="macro">
<title>Keyboard macros</title>

<para>
Usage: <literal>macro</literal> <emphasis>menu</emphasis> <emphasis>key</emphasis> <emphasis>sequence</emphasis> &lsqb; <emphasis>description</emphasis> &rsqb;
</para>

<para>
Macros are useful when you would like a single key to perform a series of
actions.  When you press <emphasis>key</emphasis> in menu <emphasis>menu</emphasis>, Mutt will behave as if
you had typed <emphasis>sequence</emphasis>.  So if you have a common sequence of commands
you type, you can create a macro to execute those commands with a single
key.
</para>

<para>
<emphasis>menu</emphasis> is the <link linkend="maps">map</link> which the macro will be bound.
Multiple maps may be specified by separating multiple menu arguments by
commas. Whitespace may not be used in between the menu arguments and the
commas separating them.
</para>

<para>
<emphasis>key</emphasis> and <emphasis>sequence</emphasis> are expanded by the same rules as the <link linkend="bind">key bindings</link>.  There are some additions however.  The
first is that control characters in <emphasis>sequence</emphasis> can also be specified
as <emphasis>&circ;x</emphasis>.  In order to get a caret (`&circ;'') you need to use
<emphasis>&circ;&circ;</emphasis>.  Secondly, to specify a certain key such as <emphasis>up</emphasis>
or to invoke a function directly, you can use the format
<emphasis>&lt;key name&gt;</emphasis> and <emphasis>&lt;function name&gt;</emphasis>.  For a listing of key
names see the section on <link linkend="bind">key bindings</link>.  Functions
are listed in the <link linkend="functions">reference</link>.
</para>

<para>
The advantage with using function names directly is that the macros will
work regardless of the current key bindings, so they are not dependent on
the user having particular key definitions.  This makes them more robust
and portable, and also facilitates defining of macros in files used by more
than one user (eg. the system Muttrc).
</para>

<para>
Optionally you can specify a descriptive text after <emphasis>sequence</emphasis>,
which is shown in the help screens.
</para>

<para>
<emphasis role="bold">Note:</emphasis> Macro definitions (if any) listed in the help screen(s), are
silently truncated at the screen width, and are not wrapped.
</para>

</sect1>

<sect1 id="color">
<title>Using color and mono video attributes</title>

<para>
<literallayout>
Usage: <literal>color</literal> <emphasis>object</emphasis> <emphasis>foreground</emphasis> <emphasis>background</emphasis> &lsqb; <emphasis>regexp</emphasis> &rsqb;
Usage: <literal>color</literal> index <emphasis>foreground</emphasis> <emphasis>background</emphasis> <emphasis>pattern</emphasis>
Usage: <literal>uncolor</literal> index <emphasis>pattern</emphasis> &lsqb; <emphasis>pattern</emphasis> ...  &rsqb;
</literallayout>
</para>

<para>
If your terminal supports color, you can spice up Mutt by creating your own
color scheme.  To define the color of an object (type of information), you
must specify both a foreground color <emphasis role="bold">and</emphasis> a background color (it is not
possible to only specify one or the other).
</para>

<para>
<emphasis>object</emphasis> can be one of:
</para>

<para>

<itemizedlist>
<listitem>

<para>
attachment
</para>
</listitem>
<listitem>

<para>
body (match <emphasis>regexp</emphasis> in the body of messages)
</para>
</listitem>
<listitem>

<para>
bold (hiliting bold patterns in the body of messages)
</para>
</listitem>
<listitem>

<para>
error (error messages printed by Mutt)
</para>
</listitem>
<listitem>

<para>
header (match <emphasis>regexp</emphasis> in the message header)
</para>
</listitem>
<listitem>

<para>
hdrdefault (default color of the message header in the pager)
</para>
</listitem>
<listitem>

<para>
index (match <emphasis>pattern</emphasis> in the message index)
</para>
</listitem>
<listitem>

<para>
indicator (arrow or bar used to indicate the current item in a menu)
</para>
</listitem>
<listitem>

<para>
markers (the ``+'' markers at the beginning of wrapped lines in the pager)
</para>
</listitem>
<listitem>

<para>
message (informational messages)
</para>
</listitem>
<listitem>

<para>
normal
</para>
</listitem>
<listitem>

<para>
quoted (text matching <link linkend="quote-regexp">&dollar;quote&lowbar;regexp</link> in the body of a message)
</para>
</listitem>
<listitem>

<para>
quoted1, quoted2, ..., quoted<emphasis role="bold">N</emphasis> (higher levels of quoting)
</para>
</listitem>
<listitem>

<para>
search (hiliting of words in the pager)
</para>
</listitem>
<listitem>

<para>
signature
</para>
</listitem>
<listitem>

<para>
status (mode lines used to display info about the mailbox or message)
</para>
</listitem>
<listitem>

<para>
tilde (the ``&tilde;'' used to pad blank lines in the pager)
</para>
</listitem>
<listitem>

<para>
tree (thread tree drawn in the message index and attachment menu)
</para>
</listitem>
<listitem>

<para>
underline (hiliting underlined patterns in the body of messages)
</para>
</listitem>

</itemizedlist>

</para>

<para>
<emphasis>foreground</emphasis> and <emphasis>background</emphasis> can be one of the following:
</para>

<para>

<itemizedlist>
<listitem>

<para>
white
</para>
</listitem>
<listitem>

<para>
black
</para>
</listitem>
<listitem>

<para>
green
</para>
</listitem>
<listitem>

<para>
magenta
</para>
</listitem>
<listitem>

<para>
blue
</para>
</listitem>
<listitem>

<para>
cyan
</para>
</listitem>
<listitem>

<para>
yellow
</para>
</listitem>
<listitem>

<para>
red
</para>
</listitem>
<listitem>

<para>
default
</para>
</listitem>
<listitem>

<para>
color<emphasis>x</emphasis>
</para>
</listitem>

</itemizedlist>

</para>

<para>
<emphasis>foreground</emphasis> can optionally be prefixed with the keyword <literal>bright</literal> to make
the foreground color boldfaced (e.g., <literal>brightred</literal>).
</para>

<para>
If your terminal supports it, the special keyword <emphasis>default</emphasis> can be
used as a transparent color.  The value <emphasis>brightdefault</emphasis> is al