manual.xml.head

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

<?xml version="1.0" standalone="no"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<book>

<bookinfo>
  <title>The Mutt E-Mail Client</title>
  <author>
    <firstname>Michael</firstname><surname>Elkins</surname>
    <email>[e-mail]</email>
  </author>
  <releaseinfo>version @VERSION@</releaseinfo>

  <abstract>
    <para>
    ``All mail clients suck.  This one just sucks less.'' -me, circa 1995
    </para>
  </abstract>
</bookinfo>

<chapter id="intro">
<title>Introduction</title>

<para>
<emphasis role="bold">Mutt</emphasis> is a small but very powerful text-based MIME mail client.  Mutt is
highly configurable, and is well suited to the mail power user with advanced
features like key bindings, keyboard macros, mail threading, regular
expression searches and a powerful pattern matching language for selecting
groups of messages.
</para>

<sect1 id="homepage">
<title>Mutt Home Page</title>

<para>
<ulink
url="http://www.mutt.org/"
>http://www.mutt.org/</ulink
>
</para>

</sect1>

<sect1 id="muttlists">
<title>Mailing Lists</title>

<para>
To subscribe to one of the following mailing lists, send a message with the
word <emphasis>subscribe</emphasis> in the body to
<literal>list-name</literal><emphasis>-request</emphasis><literal>@mutt.org</literal>.
</para>

<para>

<itemizedlist>
<listitem>

<para>
<email>[e-mail]</email> -- low traffic list for announcements
</para>
</listitem>
<listitem>

<para>
<email>[e-mail]</email> -- help, bug reports and feature requests
</para>
</listitem>
<listitem>

<para>
<email>[e-mail]</email> -- development mailing list
</para>
</listitem>

</itemizedlist>

</para>

<para>
<emphasis role="bold">Note:</emphasis> all messages posted to <emphasis>mutt-announce</emphasis> are automatically
forwarded to <emphasis>mutt-users</emphasis>, so you do not need to be subscribed to both
lists.
</para>

</sect1>

<sect1 id="distribution">
<title>Software Distribution Sites</title>

<para>

<itemizedlist>
<listitem>

<para>
<ulink
url="ftp://ftp.mutt.org/mutt/"
>ftp://ftp.mutt.org/mutt/</ulink
>
</para>
</listitem>

</itemizedlist>

</para>

<para>
For a list of mirror sites, please refer to <ulink
url="http://www.mutt.org/download.html"
>http://www.mutt.org/download.html</ulink
>.
</para>

</sect1>

<sect1 id="irc">
<title>IRC</title>

<para>
Visit channel <emphasis>&num;mutt</emphasis> on
<ulink url="http://www.freenode.net/">irc.freenode.net</ulink> to chat with
other people interested in Mutt.
</para>

</sect1>

<sect1 id="usenet">
<title>USENET</title>

<para>
See the newsgroup <ulink
url="news:comp.mail.mutt"
>comp.mail.mutt</ulink
>.
</para>

</sect1>

<sect1 id="copyright">
<title>Copyright</title>

<para>
Mutt is Copyright (C) 1996-2005 Michael R. Elkins
<email>[e-mail]</email> and others
</para>

<para>
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
</para>

<para>
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
</para>

<para>
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
</para>

</sect1>

</chapter>

<chapter id="gettingstarted">
<title>Getting Started</title>

<para>
This section is intended as a brief overview of how to use Mutt.  There are
many other features which are described elsewhere in the manual.  There
is even more information available in the Mutt FAQ and various web
pages.  See the <ulink
url="http://www.mutt.org/mutt/"
>Mutt Page</ulink
> for more details.
</para>

<para>
The keybindings described in this section are the defaults as distributed.
Your local system administrator may have altered the defaults for your site.
You can always type ``?'' in any menu to display the current bindings.
</para>

<para>
The first thing you need to do is invoke mutt, simply by typing mutt
at the command line.  There are various command-line options, see 
either the mutt man page or the <link linkend="commandline">reference</link>.
</para>

<sect1 id="menus">
<title>Moving Around in Menus</title>

<para>
Information is presented in menus, very similar to ELM.  Here is a table
showing the common keys used to navigate menus in Mutt.
</para>

<para>

<table>
<title>Most common navigation keys</title>
<tgroup cols="3">
<thead>
<row><entry>Key</entry><entry>Function</entry><entry>Description</entry></row>
</thead>
<tbody>
<row><entry>j or Down</entry><entry>next-entry</entry><entry>move to the next entry</entry></row>
<row><entry>k or Up</entry><entry>previous-entry</entry><entry>move to the previous entry</entry></row>
<row><entry>z or PageDn</entry><entry>page-down</entry><entry>go to the next page</entry></row>
<row><entry>Z or PageUp</entry><entry>page-up</entry><entry>go to the previous page</entry></row>
<row><entry>= or Home</entry><entry>first-entry</entry><entry>jump to the first entry</entry></row>
<row><entry>* or End</entry><entry>last-entry</entry><entry>jump to the last entry</entry></row>
<row><entry>q</entry><entry>quit</entry><entry>exit the current menu</entry></row>
<row><entry>?</entry><entry>help</entry><entry>list all keybindings for the current menu</entry></row>
</tbody>
</tgroup>
</table>

</para>

</sect1>

<sect1 id="editing">
<title>Editing Input Fields</title>

<sect2 id="editing-intro">
<title>Introduction</title>

<para>
Mutt has a built-in line editor for inputting text, e.g. email
addresses or filenames. The keys used to manipulate text input are
very similar to those of Emacs. See the following table for a full
reference of available functions, their default key bindings, and
short descriptions.
</para>

<para>

<table>
<title>Most common line editor keys</title>
<tgroup cols="3">
<thead>
<row><entry>Key</entry><entry>Function</entry><entry>Description</entry></row>
</thead>
<tbody>
<row><entry>&circ;A or &lt;Home&gt;</entry><entry>bol</entry><entry>move to the start of the line</entry></row>
<row><entry>&circ;B or &lt;Left&gt;</entry><entry>backward-char</entry><entry>move back one char</entry></row>
<row><entry>Esc B</entry><entry>backward-word</entry><entry>move back one word</entry></row>
<row><entry>&circ;D or &lt;Delete&gt;</entry><entry>delete-char</entry><entry>delete the char under the cursor</entry></row>
<row><entry>&circ;E or &lt;End&gt;</entry><entry>eol</entry><entry>move to the end of the line</entry></row>
<row><entry>&circ;F or &lt;Right&gt;</entry><entry>forward-char</entry><entry>move forward one char</entry></row>
<row><entry>Esc F</entry><entry>forward-word</entry><entry>move forward one word</entry></row>
<row><entry>&lt;Tab&gt;</entry><entry>complete</entry><entry>complete filename or alias</entry></row>
<row><entry>&circ;T</entry><entry>complete-query</entry><entry>complete address with query</entry></row>
<row><entry>&circ;K</entry><entry>kill-eol</entry><entry>delete to the end of the line</entry></row>
<row><entry>ESC d</entry><entry>kill-eow</entry><entry>delete to the end ot the word</entry></row>
<row><entry>&circ;W</entry><entry>kill-word</entry><entry>kill the word in front of the cursor</entry></row>
<row><entry>&circ;U</entry><entry>kill-line</entry><entry>delete entire line</entry></row>
<row><entry>&circ;V</entry><entry>quote-char</entry><entry>quote the next typed key</entry></row>
<row><entry>&lt;Up&gt;</entry><entry>history-up</entry><entry>recall previous string from history</entry></row>
<row><entry>&lt;Down&gt;</entry><entry>history-down</entry><entry>recall next string from history</entry></row>
<row><entry>&lt;BackSpace&gt;</entry><entry>backspace</entry><entry>kill the char in front of the cursor</entry></row>
<row><entry>Esc u</entry><entry>upcase-word</entry><entry>convert word to upper case</entry></row>
<row><entry>Esc l</entry><entry>downcase-word</entry><entry>convert word to lower case</entry></row>
<row><entry>Esc c</entry><entry>capitalize-word</entry><entry>capitalize the word</entry></row>
<row><entry>&circ;G</entry><entry>n/a</entry><entry>abort</entry></row>
<row><entry>&lt;Return&gt;</entry><entry>n/a</entry><entry>finish editing</entry></row>
</tbody>
</tgroup>
</table>

</para>

<para>
You can remap the <emphasis>editor</emphasis> functions using the
<link linkend="bind">bind</link> command.  For example, to make
the <emphasis>Delete</emphasis> key delete the character in front of
the cursor rather than under, you could use
</para>

<screen>
bind editor &lt;delete&gt; backspace
</screen>

</sect2>

<sect2 id="editing-history">
<title>History</title>

<para>
The number of items in the built-in editor's history is controlled by
the <link linkend="history">&dollar;history</link> variable. You may
cycle through them at an editor prompt by using the
<literal>history-up</literal> and/or <literal>history-down</literal>
commands.
</para>

<para>
Mutt maintains several distinct history lists, one for each of the
following categories:
</para>

<para>
<itemizedlist>
<listitem>muttrc commands</listitem>
<listitem>addresses and aliases</listitem>
<listitem>shell commands</listitem>
<listitem>filenames</listitem>
<listitem>patterns</listitem>
<listitem>everything else</listitem>
</itemizedlist>
</para>

<para>
Mutt automatically filters out repeated items from the history.  It
also mimics the behaviour of some shells by ignoring items starting
with a space.
</para>

<para>
The latter feature can be useful in macros to not clobber the history's
valuable entries with unwanted entries.
</para>

</sect2>

</sect1>

<sect1 id="reading">
<title>Reading Mail - The Index and Pager</title>

<para>
Similar to many other mail clients, there are two modes in which mail is
read in Mutt.  The first is the index of messages in the mailbox, which is
called the ``index'' in Mutt.  The second mode is the display of the
message contents.  This is called the ``pager.''
</para>

<para>
The next few sections describe the functions provided in each of these
modes.
</para>

<sect2>
<title>The Message Index</title>

<para>

<table>
<title>Most common message index keys</title>
<tgroup cols="2">
<thead>
<row><entry>Key</entry><entry>Description</entry></row>
</thead>
<tbody>
<row><entry>c</entry><entry>change to a different mailbox</entry></row>
<row><entry>ESC c</entry><entry>change to a folder in read-only mode</entry></row>
<row><entry>C</entry><entry>copy the current message to another mailbox</entry></row>
<row><entry>ESC C</entry><entry>decode a message and copy it to a folder</entry></row>
<row><entry>ESC s</entry><entry>decode a message and save it to a folder</entry></row>
<row><entry>D</entry><entry>delete messages matching a pattern</entry></row>
<row><entry>d</entry><entry>delete the current message</entry></row>
<row><entry>F</entry><entry>mark as important</entry></row>
<row><entry>l</entry><entry>show messages matching a pattern</entry></row>
<row><entry>N</entry><entry>mark message as new</entry></row>
<row><entry>o</entry><entry>change the current sort method</entry></row>
<row><entry>O</entry><entry>reverse sort the mailbox</entry></row>
<row><entry>q</entry><entry>save changes and exit</entry></row>
<row><entry>s</entry><entry>save-message</entry></row>
<row><entry>T</entry><entry>tag messages matching a pattern</entry></row>
<row><entry>t</entry><entry>toggle the tag on a message</entry></row>
<row><entry>ESC t</entry><entry>toggle tag on entire message thread</entry></row>
<row><entry>U</entry><entry>undelete messages matching a pattern</entry></row>
<row><entry>u</entry><entry>undelete-message</entry></row>
<row><entry>v</entry><entry>view-attachments</entry></row>
<row><entry>x</entry><entry>abort changes and exit</entry></row>
<row><entry>&lt;Return&gt;</entry><entry>display-message</entry></row>
<row><entry>&lt;Tab&gt;</entry><entry>jump to the next new or unread message</entry></row>
<row><entry>@</entry><entry>show the author's full e-mail address</entry></row>
<row><entry>$</entry><entry>save changes to mailbox</entry></row>
<row><entry>/</entry><entry>search</entry></row>
<row><entry>ESC /</entry><entry>search-reverse</entry></row>
<row><entry>&circ;L</entry><entry>clear and redraw the screen</entry></row>
<row><entry>&circ;T</entry><entry>untag messages matching a pattern</entry></row>
</tbody>
</tgroup>
</table>

</para>

<sect3>
<title>Status Flags</title>

<para>
In addition to who sent the message and the subject, a short summary of
the disposition of each message is printed beside the message number.
Zero or more of the following ``flags'' may appear, which mean:
</para>

<para>
<variablelist>

<varlistentry>
<term>D</term>
<listitem>
<para>