home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 7 / AACD07.ISO / AACD / Online / Mutt / mutt.doc < prev    next >
Text File  |  2000-02-14  |  180KB  |  4,871 lines

  1.   The Mutt E-Mail Client
  2.   by Michael Elkins <me@cs.hmc.edu>
  3.   version 1.1.3  ``All mail clients suck.  This one just sucks less.''
  4.   -me, circa 1995
  5.  
  6.   1.  Introduction
  7.  
  8.   Mutt is a small but very powerful text-based MIME mail client.  Mutt
  9.   is highly configurable, and is well suited to the mail power user with
  10.   advanced features like key bindings, keyboard macros, mail threading,
  11.   regular expression searches and a powerful pattern matching language
  12.   for selecting groups of messages.
  13.  
  14.   1.1.  Mutt Home Page
  15.  
  16.   http://www.mutt.org/
  17.  
  18.   1.2.  Mailing Lists
  19.  
  20.   To subscribe to one of the following mailing lists, send a message
  21.   with the word subscribe in the subject to list-name-request@mutt.org.
  22.  
  23.   ·  mutt-announce@mutt.org -- low traffic list for announcements
  24.  
  25.   ·  mutt-users@mutt.org -- help, bug reports and feature requests
  26.  
  27.   ·  mutt-dev@mutt.org -- development mailing list
  28.  
  29.   Note: all messages posted to mutt-announce are automatically forwarded
  30.   to mutt-users, so you do not need to be subscribed to both lists.
  31.  
  32.   1.3.  Software Distribution Sites
  33.  
  34.   ·  ftp://ftp.guug.de/pub/mutt/
  35.  
  36.   1.4.  IRC
  37.  
  38.   Visit channel #mutt on DALnet (www.dal.net) to chat with other people
  39.   interested in Mutt.
  40.  
  41.   1.5.  USENET
  42.  
  43.   See the newsgroup comp.mail.mutt.
  44.  
  45.   1.6.  Copyright
  46.  
  47.   Mutt is Copyright (C) 1996-8 Michael R. Elkins <me@cs.hmc.edu>
  48.  
  49.   This program is free software; you can redistribute it and/or modify
  50.   it under the terms of the GNU General Public License as published by
  51.   the Free Software Foundation; either version 2 of the License, or (at
  52.   your option) any later version.
  53.  
  54.   This program is distributed in the hope that it will be useful, but
  55.   WITHOUT ANY WARRANTY; without even the implied warranty of
  56.   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  57.   General Public License for more details.
  58.   You should have received a copy of the GNU General Public License
  59.   along with this program; if not, write to the Free Software
  60.   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  61.  
  62.   2.  Getting Started
  63.  
  64.   This section is intended as a brief overview of how to use Mutt.
  65.   There are many other features which are described elsewhere in the
  66.   manual.  There is even more information available in the Mutt FAQ and
  67.   various web pages.  See the Mutt Page for more details.
  68.  
  69.   The keybindings described in this section are the defaults as
  70.   distributed.  Your local system administrator may have altered the
  71.   defaults for your site.  You can always type ``?'' in any menu to
  72.   display the current bindings.
  73.  
  74.   The first thing you need to do is invoke mutt, simply by typing mutt
  75.   at the command line.  There are various command-line options, see
  76.   either the mutt man page or the ``reference''.
  77.  
  78.   2.1.  Moving Around in Menus
  79.  
  80.   Information is presented in menus, very similar to ELM.  Here is a
  81.   table showing the common keys used to navigate menus in Mutt.
  82.  
  83.        j or Down       next-entry      move to the next entry
  84.        k or Up         previous-entry  move to the previous entry
  85.        z or PageDn     page-down       go to the next page
  86.        Z or PageUp     page-up         go to the previous page
  87.        = or Home       first-entry     jump to the first entry
  88.        * or End        last-entry      jump to the last entry
  89.        q               quit            exit the current menu
  90.        ?               help            list all keybindings for the current menu
  91.  
  92.   2.2.  Editing Input Fields
  93.  
  94.   Mutt has a builtin line editor which is used as the primary way to
  95.   input textual data such as email addresses or filenames.  The keys
  96.   used to move around while editing are very similar to those of Emacs.
  97.  
  98.   ^A or <Home>    bol             move to the start of the line
  99.   ^B or <Left>    backward-char   move back one char
  100.   ^D or <Delete>  delete-char     delete the char under the cursor
  101.   ^E or <End>     eol             move to the end of the line
  102.   ^F or <Right>   forward-char    move forward one char
  103.   ^K              kill-eol        delete to the end of the line
  104.   ^U              kill-line       delete entire line
  105.   ^W              kill-word       kill the word in front of the cursor
  106.   <Up>            history-up      recall previous string from history
  107.   <Down>          history-down    recall next string from history
  108.   <BackSpace>     backspace       kill the char in front of the cursor
  109.   ^G              n/a             abort
  110.   <Tab>           n/a             complete filename (only when prompting for a file)
  111.   <Return>        n/a             finish editing
  112.  
  113.   You can remap the editor functions using the ``bind'' command.  For
  114.   example, to make the Delete key delete the character in front of the
  115.   cursor rather than under, you could use
  116.  
  117.   bind editor <delete> backspace
  118.  
  119.   2.3.  Reading Mail - The Index and Pager
  120.  
  121.   Similar to many other mail clients, there are two modes in which mail
  122.   is read in Mutt.  The first is the index of messages in the mailbox,
  123.   which is called the ``index'' in Mutt.  The second mode is the display
  124.   of the message contents.  This is called the ``pager.''
  125.  
  126.   The next few sections describe the functions provided in each of these
  127.   modes.
  128.  
  129.   2.3.1.  The Message Index
  130.  
  131.   c               change to a different mailbox
  132.   ESC c           change to a folder in read-only mode
  133.   C               copy the current message to another mailbox
  134.   ESC C           decode a message and copy it to a folder
  135.   ESC s           decode a message and save it to a folder
  136.   D               delete messages matching a pattern
  137.   d               delete the current message
  138.   F               mark as important
  139.   l               show messages matching a pattern
  140.   N               mark message as new
  141.   o               change the current sort method
  142.   O               reverse sort the mailbox
  143.   q               save changes and exit
  144.   s               save-message
  145.   t               toggle the tag on a message
  146.   ESC t           toggle tag on entire message thread
  147.   u               undelete-message
  148.   v               view-attachments
  149.   x               abort changes and exit
  150.   <Return>        display-message
  151.   <Tab>           jump to the next new message
  152.   @               show the author's full e-mail address
  153.   $               save changes to mailbox
  154.   /               search
  155.   ESC /           search-reverse
  156.   ^L              clear and redraw the screen
  157.   ^T              tag messages matching a pattern
  158.   ^U              undelete messages matching a pattern
  159.  
  160.   2.3.1.1.  Status Flags
  161.  
  162.   In addition to who sent the message and the subject, a short summary
  163.   of the disposition of each message is printed beside the message
  164.   number.  Zero or more of the following ``flags'' may appear, which
  165.   mean:
  166.  
  167.        D       message is deleted
  168.        K       contains a PGP public key
  169.        M       requires mailcap to view
  170.        N       message is new
  171.        O       message is old
  172.        P       message is PGP encrypted
  173.        r       message has been replied to
  174.        S       message is PGP signed
  175.        !       message is flagged
  176.        *       message is tagged
  177.  
  178.   Some of the status flags can be turned on or off using
  179.  
  180.   ·  set-flag (default: w)
  181.  
  182.   ·  clear-flag (default: W)
  183.  
  184.   Furthermore, the following flags reflect who the message is addressed
  185.   to.  They can be customized with the ``$to_chars'' variable.
  186.  
  187.        +       message is to you and you only
  188.        T       message is to you, but also to or cc'ed to others
  189.        C       message is cc'ed to you
  190.        F       message is from you
  191.  
  192.   2.3.2.  The Pager
  193.  
  194.   By default, Mutt uses its builtin pager to display the body of
  195.   messages.  The pager is very similar to the Unix program less though
  196.   not nearly as featureful.
  197.  
  198.        <Return>        go down one line
  199.        <Space>         display the next page (or next message if at the end of a message)
  200.        -               go back to the previous page
  201.        n               display the next message
  202.        ?               show keybindings
  203.        /               search for a regular expression (pattern)
  204.        \               toggle search pattern coloring
  205.  
  206.   In addition, many of the functions from the index are available in the
  207.   pager, such as delete-message or copy-message (this is one advantage
  208.   over using an external pager to view messages).
  209.  
  210.   Also, the internal pager supports a couple other advanced features.
  211.   For one, it will accept and translate the ``standard'' nroff sequences
  212.   for bold and underline. These sequences are a series of either the
  213.   letter, backspace (^H), the letter again for bold or the letter,
  214.   backspace, ``_'' for denoting underline. Mutt will attempt to display
  215.   these in bold and underline respectively if your terminal supports
  216.   them. If not, you can use the bold and underline ``color'' objects to
  217.   specify a color or mono attribute for them.
  218.  
  219.   Additionally, the internal pager supports the ANSI escape sequences
  220.   for character attributes.  Mutt translates them into the correct color
  221.   and character settings.  The sequences Mutt supports are:
  222.  
  223.   ESC [ Ps;Ps;Ps;...;Ps m
  224.   where Ps =
  225.   0    All Attributes Off
  226.   1    Bold on
  227.   4    Underline on
  228.   5    Blink on
  229.   7    Reverse video on
  230.   3x   Foreground color is x
  231.   4x   Background color is x
  232.  
  233.   Colors are
  234.   0    black
  235.   1    red
  236.   2    green
  237.   3    yellow
  238.   4    blue
  239.   5    magenta
  240.   6    cyan
  241.   7    white
  242.  
  243.   Mutt uses these attributes for handling text/enriched messages, and
  244.   they can also be used by an external ``autoview'' script for
  245.   highlighting purposes.  Note: If you change the colors for your
  246.   display, for example by changing the color associated with color2 for
  247.   your xterm, then that color will be used instead of green.
  248.  
  249.   2.3.3.  Threaded Mode
  250.  
  251.   When the mailbox is ``sorted'' by threads, there are a few additional
  252.   functions available in the index and pager modes.
  253.  
  254.        ^D      delete-thread           delete all messages in the current thread
  255.        ^U      undelete-thread         undelete all messages in the current thread
  256.        ^N      next-thread             jump to the start of the next thread
  257.        ^P      previous-thread         jump to the start of the previous thread
  258.        ^R      read-thread             mark the current thread as read
  259.        ESC d   delete-subthread        delete all messages in the current subthread
  260.        ESC u   undelete-subthread      undelete all messages in the current subthread
  261.        ESC n   next-subthread          jump to the start of the next subthread
  262.        ESC p   previous-subthread      jump to the start of the previous subthread
  263.        ESC r   read-subthread          mark the current subthread as read
  264.        ESC t   tag-thread              toggle the tag on the current thread
  265.        ESC v   collapse-thread         toggle collapse for the current thread
  266.        ESC V   collapse-all            toggle collapse for all threads
  267.        P       parent-message          jump to parent message in thread
  268.  
  269.   Note: Collapsing a thread displays only the first message in the
  270.   thread and hides the others. This is useful when threads contain so
  271.   many messages that you can only see a handful of threads on the
  272.   screen. See %M in ``$index_format''.  For example, you could use
  273.   "%?M?(#%03M)&(%4l)?" in ``$index_format'' to optionally display the
  274.   number of hidden messages if the thread is collapsed.
  275.  
  276.   See also: ``$strict_threads''.
  277.  
  278.   2.3.4.  Miscellaneous Functions
  279.  
  280.   create-alias (default: a)
  281.  
  282.   Creates a new alias based upon the current message (or prompts for a
  283.   new one).  Once editing is complete, an ``alias'' command is added to
  284.   the file specified by the ``$alias_file'' variable for future use.
  285.   Note: Specifying an ``$alias_file'' does not add the aliases specified
  286.   there-in, you must also ``source'' the file.
  287.  
  288.   display-headers (default: h)
  289.  
  290.   Toggles the weeding of message header fields specified by ``ignore''
  291.   commands.
  292.  
  293.   edit (default: e)
  294.  
  295.   This command (available in the ``index'' and ``pager'') allows you to
  296.   edit the raw current message as it's present in the mail folder.
  297.   After you have finished editing, the changed message will be appended
  298.   to the current folder, and the original message will be marked for
  299.   deletion.
  300.  
  301.   enter-command (default: ``:'')
  302.  
  303.   This command is used to execute any command you would normally put in
  304.   a configuration file.  A common use is to check the settings of
  305.   variables, or in conjunction with ``macros'' to change settings on the
  306.   fly.
  307.  
  308.   extract-keys (default: ^K)
  309.  
  310.   This command extracts PGP public keys from the current or tagged
  311.   message(s) and adds them to your PGP public key ring.
  312.  
  313.   forget-passphrase (default: ^F)
  314.  
  315.   This command wipes the PGP passphrase from memory. It is useful, if
  316.   you misspelled the passphrase.
  317.  
  318.   list-reply (default: L)
  319.  
  320.   Reply to the current or tagged message(s) by extracting any addresses
  321.   which match the addresses given by the ``lists'' command.  Using this
  322.   when replying to messages posted to mailing lists help avoid duplicate
  323.   copies being sent to the author of the message you are replying to.
  324.  
  325.   pipe-message (default: |)
  326.  
  327.   Asks for an external Unix command and pipes the current or tagged
  328.   message(s) to it.  The variables ``$pipe_decode'', ``$pipe_split'',
  329.   ``$pipe_sep'' and ``$wait_key'' control the exact behaviour of this
  330.   function.
  331.  
  332.   shell-escape (default: !)
  333.  
  334.   Asks for an external Unix command and executes it.  The ``$wait_key''
  335.   can be used to control whether Mutt will wait for a key to be pressed
  336.   when the command returns (presumably to let the user read the output
  337.   of the command), based on the return status of the named command.
  338.   toggle-quoted (default: T)
  339.  
  340.   The pager uses the ``$quote_regexp'' variable to detect quoted text
  341.   when displaying the body of the message.  This function toggles the
  342.   display of the quoted material in the message.  It is particularly
  343.   useful when are interested in just the response and there is a large
  344.   amount of quoted text in the way.
  345.  
  346.   skip-quoted (default: S)
  347.  
  348.   This function will go to the next line of non-quoted text which come
  349.   after a line of quoted text in the internal pager.
  350.  
  351.   2.4.  Sending Mail
  352.  
  353.   The following bindings are available in the index for sending
  354.   messages.
  355.  
  356.        m       compose         compose a new message
  357.        r       reply           reply to sender
  358.        g       group-reply     reply to all recipients
  359.        L       list-reply      reply to mailing list address
  360.        f       forward         forward message
  361.        b       bounce          bounce (remail) message
  362.        ESC k   mail-key        mail a PGP public key to someone
  363.  
  364.   Bouncing a message sends the message as is to the recipient you
  365.   specify.  Forwarding a message allows you to add comments or modify
  366.   the message you are forwarding.  These items are discussed in greater
  367.   detail in the next chapter ````Forwarding and Bouncing Mail''''.
  368.  
  369.   Mutt will then enter the compose menu and prompt you for the
  370.   recipients to place on the ``To:'' header field.  Next, it will ask
  371.   you for the ``Subject:'' field for the message, providing a default if
  372.   you are replying to or forwarding a message.  See also ``$askcc'',
  373.   ``$askbcc'', ``$autoedit'', and ``$fast_reply'' for changing how Mutt
  374.   asks these questions.
  375.  
  376.   Mutt will then automatically start your ``$editor'' on the message
  377.   body.  If the ``$edit_headers'' variable is set, the headers will be
  378.   at the top of the message in your editor.  Any messages you are
  379.   replying to will be added in sort order to the message, with
  380.   appropriate ``$attribution'', ``$indent_string'' and
  381.   ``$post_indent_string''.  When forwarding a message, if the
  382.   ``$mime_forward'' variable is unset, a copy of the forwarded message
  383.   will be included.  If you have specified a ``$signature'', it will be
  384.   appended to the message.
  385.  
  386.   Once you have finished editing the body of your mail message, you are
  387.   returned to the compose menu.  The following options are available:
  388.  
  389.   a       attach-file             attach a file
  390.   A       attach-message          attach message(s) to the message
  391.   ESC k   attach-key              attach a PGP public key
  392.   d       edit-description        edit description on attachment
  393.   D       detach-file             detach a file
  394.   T       edit-to                 edit the To field
  395.   c       edit-cc                 edit the Cc field
  396.   b       edit-bcc                edit the Bcc field
  397.   y       send-message            send the message
  398.   s       edit-subject            edit the Subject
  399.   f       edit-fcc                specify an ``Fcc'' mailbox
  400.   p       pgp-menu                select PGP options (``i'' version only)
  401.   P       postpone-message        postpone this message until later
  402.   q       quit                    quit (abort) sending the message
  403.   w       write-fcc               write the message to a folder
  404.   i       ispell                  check spelling (if available on your system)
  405.   ^F      forget-passphrase       whipe PGP passphrase from memory
  406.  
  407.   Note: The attach-message function will prompt you for a folder to
  408.   attach messages from. You can now tag messages in that folder and they
  409.   will be attached to the message you are sending. Note that certain
  410.   operations like composing a new mail, replying, forwarding, etc. are
  411.   not permitted when you are in that folder. The %r in
  412.   ``$status_format'' will change to a 'A' to indicate that you are in
  413.   attach-message mode.
  414.  
  415.   2.4.1.  Editing the message header
  416.  
  417.   When editing the header of your outgoing message, there are a couple
  418.   of special features available.
  419.  
  420.   If you specify
  421.   Fcc: filename
  422.   Mutt will pick up filename just as if you had used the edit-fcc
  423.   function in the compose menu.
  424.  
  425.   You can also attach files to your message by specifying
  426.   Attach: filename  [ description ]
  427.   where filename is the file to attach and description is an optional
  428.   string to use as the description of the attached file.
  429.  
  430.   When replying to messages, if you remove the In-Reply-To: field from
  431.   the header field, Mutt will not generate a References: field, which
  432.   allows you to create a new message thread.
  433.  
  434.   Also see ``edit_headers''.
  435.  
  436.   2.4.2.  Using Mutt with PGP
  437.  
  438.   If you want to use PGP, you can specify
  439.  
  440.   Pgp: [ E | S | S<id> ]
  441.  
  442.   ``E'' encrypts, ``S'' signs and ``S<id>'' signs with the given key,
  443.   setting ``$pgp_sign_as'' permanently.
  444.  
  445.   If you have told mutt to PGP encrypt a message, it will guide you
  446.   through a key selection process when you try to send the message.
  447.   Mutt will not ask you any questions about keys which have a certified
  448.   user ID matching one of the message recipients' mail addresses.
  449.   However, there may be situations in which there are several keys,
  450.   weakly certified user ID fields, or where no matching keys can be
  451.   found.
  452.  
  453.   In these cases, you are dropped into a menu with a list of keys from
  454.   which you can select one.  When you quit this menu, or mutt can't find
  455.   any matching keys, you are prompted for a user ID.  You can, as
  456.   usually, abort this prompt using ^G.  When you do so, mutt will return
  457.   to the compose screen.
  458.  
  459.   Once you have successfully finished the key selection, the message
  460.   will be encrypted using the selected public keys, and sent out.
  461.  
  462.   Most fields of the entries in the key selection menu (see also
  463.   ``$pgp_entry_format'') have obvious meanings.  But some explanations
  464.   on the capabilities, flags, and validity fields are in order.
  465.  
  466.   The flags sequence (%f) will expand to one of the following flags:
  467.  
  468.        R            The key has been revoked and can't be used.
  469.        X            The key is expired and can't be used.
  470.        d            You have marked the key as disabled.
  471.        c            There are unknown critical self-signature
  472.                     packets.
  473.  
  474.   The capabilities field (%c) expands to a two-character sequence
  475.   representing a key's capabilities.  The first character gives the
  476.   key's encryption capabilities: A minus sign (-) means that the key
  477.   cannot be used for encryption.  A dot (.) means that it's marked as a
  478.   signature key in one of the user IDs, but may also be used for
  479.   encryption.  The letter e indicates that this key can be used for
  480.   encryption.
  481.  
  482.   The second character indicates the key's signing capabilities.  Once
  483.   again, a ``-'' implies ``not for signing'', ``.'' implies that the key
  484.   is marked as an encryption key in one of the user-ids, and ``s''
  485.   denotes a key which can be used for signing.
  486.  
  487.   Finally, the validity field (%t) indicates how well-certified a user-
  488.   id is.  A question mark (?) indicates undefined validity, a minus
  489.   character (-) marks an untrusted association, a space character means
  490.   a partially trusted association, and a plus character (+) indicates
  491.   complete validity.
  492.  
  493.   2.4.3.  Sending anonymous messages via mixmaster.
  494.  
  495.   You may also have configured mutt to co-operate with Mixmaster, an
  496.   anonymous remailer.  Mixmaster permits you to send your messages
  497.   anonymously using a chain of remailers.
  498.  
  499.   To use it, you'll have to obey certain restrictions.  Most important,
  500.   you cannot ues the Cc and Bcc headers.  To tell Mutt to use mixmaster,
  501.   you have to select a remailer chain, using the mix function on the
  502.   compose menu.
  503.  
  504.   The chain selection screen is divided into two parts.  In the (larger)
  505.   upper part, you get a list of remailers you may use.  In the lower
  506.   part, you see the currently selected chain of remailers.
  507.  
  508.   You can navigate in the chain using the chain-prev and chain-next
  509.   functions, which are by default bound to the left and right arrows and
  510.   to the h and l keys (think vi keyboard bindings).  To insert a
  511.   remailer at the current chain position, use the insert function.  To
  512.   append a remailer behind the current chain position, use select-entry
  513.   or append.  You can also delete entries from the chain, using the
  514.   corresponding function.  Finally, to abandon your changes, leave the
  515.   menu, or accept them pressing (by default) the Return key.
  516.  
  517.   Note that different remailers do have different capabilities,
  518.   indicated in the %c entry of the remailer menu lines (see
  519.   ``$mix_etry_format'').  Most important is the ``middleman''
  520.   capability, indicated by a capital ``M'': This means that the remailer
  521.   in question cannot be used as the final element of a chain, but will
  522.   only forward messages to other mixmaster remailers.  For details on
  523.   the other capabilities, please have a look at the mixmaster
  524.   documentation.
  525.  
  526.   2.5.  Forwarding and Bouncing Mail
  527.  
  528.   Bouncing and forwarding let you send an existing message to recipients
  529.   that you specify.  Bouncing a message uses the ``sendmail'' command to
  530.   send a copy to alternative addresses as if they were the message's
  531.   original recipients.  Forwarding a message, on the other hand, allows
  532.   you to modify the message before it is resent (for example, by adding
  533.   your own comments).
  534.  
  535.   The following keys are bound by default:
  536.  
  537.        f       forward         forward message
  538.        b       bounce          bounce (remail) message
  539.  
  540.   Forwarding can be done by including the original message in the new
  541.   message's body (surrounded by indicating lines) or including it as a
  542.   MIME attachment, depending on the value of the ``$mime_forward''
  543.   variable.  Decoding of attachments, like in the pager, can be
  544.   controlled by the ``$forward_decode'' and ``$mime_forward_decode''
  545.   variables, respectively.  The desired forwarding format may depend on
  546.   the content, therefore $mime_forward is a quadoption which, for
  547.   example, can be set to ``ask-no''.
  548.  
  549.   The inclusion of headers is controlled by the current setting of the
  550.   ``$weed'' variable, unless ``mime_forward'' is set.
  551.  
  552.   Editing the message to forward follows the same procedure as sending
  553.   or replying to a message does.
  554.  
  555.   2.6.  Postponing Mail
  556.  
  557.   At times it is desirable to delay sending a message that you have
  558.   already begun to compose.  When the postpone-message function is used
  559.   in the compose menu, the body of your message and attachments are
  560.   stored in the mailbox specified by the ``$postponed'' variable.  This
  561.   means that you can recall the message even if you exit Mutt and then
  562.   restart it at a later time.
  563.  
  564.   Once a message is postponed, there are several ways to resume it.
  565.   From the command line you can use the ``-p'' option, or if you compose
  566.   a new message from the index or pager you will be prompted if
  567.   postponed messages exist.  If multiple messages are currently
  568.   postponed, the postponed menu will pop up and you can select which
  569.   message you would like to resume.
  570.  
  571.   Note: If you postpone a reply to a message, the reply setting of the
  572.   message is only updated when you actually finish the message and send
  573.   it.  Also, you must be in the same folder with the message you replied
  574.   to for the status of the message to be updated.
  575.  
  576.   See also the ``$postpone'' quad-option.
  577.  
  578.   3.  Configuration
  579.  
  580.   While the default configuration (or ``preferences'') make Mutt usable
  581.   right out of the box, it is often desirable to tailor Mutt to suit
  582.   your own tastes. When Mutt is first invoked, it will attempt to read
  583.   the ``system'' configuration file (defaults set by your local system
  584.   administrator), unless the ``-n'' ``command line'' option is
  585.   specified.  This file is typically /usr/local/share/mutt/Muttrc or
  586.   /etc/Muttrc. Mutt will next look for a file named .muttrc in your home
  587.   directory.  If this file does not exist and your home directory has a
  588.   subdirectory named .mutt, mutt try to load a file named .mutt/muttrc.
  589.  
  590.   .muttrc is the file where you will usually place your ``commands'' to
  591.   configure Mutt.
  592.  
  593.   In addition, mutt supports version specific configuration files that
  594.   are parsed instead of the default files as explained above.  For
  595.   instance, if your system has a Muttrc-0.88 file in the system
  596.   configuration directory, and you are running version 0.88 of mutt,
  597.   this file will be sourced instead of the Muttrc file.  The same is
  598.   true of the user configuration file, if you have a file .muttrc-0.88.6
  599.   in your home directory, when you run mutt version 0.88.6, it will
  600.   source this file instead of the default .muttrc file.  The version
  601.   number is the same which is visible using the ``-v'' ``command line''
  602.   switch or using the show-version key (default: V) from the index menu.
  603.  
  604.   3.1.  Syntax of Initialization Files
  605.  
  606.   An initialization file consists of a series of ``commands''.  Each
  607.   line of the file may contain one or more commands.  When multiple
  608.   commands are used, they must be separated by a semicolon (;).
  609.  
  610.        set realname='Mutt user' ; ignore x-
  611.  
  612.   The hash mark, or pound sign (``#''), is used as a ``comment'' charac­
  613.   ter. You can use it to annotate your initialization file. All text
  614.   after the comment character to the end of the line is ignored. For
  615.   example,
  616.  
  617.        my_hdr X-Disclaimer: Why are you listening to me? # This is a comment
  618.  
  619.   Single quotes (') and double quotes (") can be used to quote strings
  620.   which contain spaces or other special characters.  The difference
  621.   between the two types of quotes is similar to that of many popular
  622.   shell programs, namely that a single quote is used to specify a
  623.   literal string (one that is not interpreted for shell variables or
  624.   quoting with a backslash [see next paragraph]), while double quotes
  625.   indicate a string for which should be evaluated.  For example,
  626.   backtics are evaluated inside of double quotes, but not for single
  627.   quotes.
  628.  
  629.   \ quotes the next character, just as in shells such as bash and zsh.
  630.   For example, if want to put quotes ``"'' inside of a string, you can
  631.   use ``\'' to force the next character to be a literal instead of
  632.   interpreted character.
  633.  
  634.        set realname="Michael \"MuttDude\" Elkins"
  635.  
  636.   ``\\'' means to insert a literal ``\'' into the line.  ``\n'' and
  637.   ``\r'' have their usual C meanings of linefeed and carriage-return,
  638.   respectively.
  639.  
  640.   A \ at the end of a line can be used to split commands over multiple
  641.   lines, provided that the split points don't appear in the middle of
  642.   command names.
  643.  
  644.   It is also possible to substitute the output of a Unix command in an
  645.   initialization file.  This is accomplished by enclosing the command in
  646.   backquotes (``).  For example,
  647.  
  648.        my_hdr X-Operating-System: `uname -a`
  649.  
  650.   The output of the Unix command ``uname -a'' will be substituted before
  651.   the line is parsed.  Note that since initialization files are line
  652.   oriented, only the first line of output from the Unix command will be
  653.   substituted.
  654.  
  655.   UNIX environments can be accessed like the way it is done in shells
  656.   like sh and bash: Prepend the name of the environment by a
  657.   ``$dollar;''.  For example,
  658.  
  659.        set record=+sent_on_$HOSTNAME
  660.  
  661.   The commands understood by mutt are explained in the next paragraphs.
  662.   For a complete list, see the ``command reference''.
  663.  
  664.   3.2.  Defining/Using aliases
  665.  
  666.   Usage: alias key address [ , address, ... ]
  667.  
  668.   It's usually very cumbersome to remember or type out the address of
  669.   someone you are communicating with.  Mutt allows you to create
  670.   ``aliases'' which map a short string to a full address.
  671.  
  672.   Note: if you want to create an alias for a group (by specifying more
  673.   than one address), you must separate the addresses with a comma
  674.   (``,'').
  675.  
  676.   To remove an alias or aliases:
  677.  
  678.   unalias addr [ addr ... ]
  679.  
  680.        alias muttdude me@cs.hmc.edu (Michael Elkins)
  681.        alias theguys manny, moe, jack
  682.  
  683.   Unlike other mailers, Mutt doesn't require aliases to be defined in a
  684.   special file.  The alias command can appear anywhere in a
  685.   configuration file, as long as this file is ``sourced''.
  686.   Consequently, you can have multiple alias files, or you can have all
  687.   aliases defined in your muttrc.
  688.  
  689.   On the other hand, the ``create-alias'' function can use only one
  690.   file, the one pointed to by the ``$alias_file'' variable (which is
  691.   ~/.muttrc by default). This file is not special either, in the sense
  692.   that Mutt will happily append aliases to any file, but in order for
  693.   the new aliases to take effect you need to explicitly ``source'' this
  694.   file too.
  695.  
  696.   For example:
  697.  
  698.        source /usr/local/share/Mutt.aliases
  699.        source ~/.mail_aliases
  700.        set alias_file=~/.mail_aliases
  701.  
  702.   To use aliases, you merely use the alias at any place in mutt where
  703.   mutt prompts for addresses, such as the To: or Cc: prompt.  You can
  704.   also enter aliases in your editor at the appropriate headers if you
  705.   have the ``$edit_headers'' variable set.
  706.  
  707.   In addition, at the various address prompts, you can use the tab
  708.   character to expand a partial alias to the full alias.  If there are
  709.   multiple matches, mutt will bring up a menu with the matching aliases.
  710.   In order to be presented with the full list of aliases, you must hit
  711.   tab with out a partial alias, such as at the beginning of the prompt
  712.   or after a comma denoting multiple addresses.
  713.  
  714.   In the alias menu, you can select as many aliases as you want with the
  715.   select-entry key (default: RET), and use the exit key (default: q) to
  716.   return to the address prompt.
  717.  
  718.   3.3.  Changing the default key bindings
  719.  
  720.   Usage: bind map key function
  721.  
  722.   This command allows you to change the default key bindings (operation
  723.   invoked when pressing a key).
  724.  
  725.   map specifies in which menu the binding belongs.  The currently
  726.   defined maps are:
  727.   ·  generic
  728.  
  729.   ·  alias
  730.  
  731.   ·  attach
  732.  
  733.   ·  browser
  734.  
  735.   ·  editor
  736.  
  737.   ·  index
  738.  
  739.   ·  compose
  740.  
  741.   ·  pager
  742.  
  743.   ·  pgp
  744.  
  745.   ·  postpone
  746.  
  747.   key is the key (or key sequence) you wish to bind.  To specify a
  748.   control character, use the sequence \Cx, where x is the letter of the
  749.   control character (for example, to specify control-A use ``\Ca'').
  750.   Note that the case of x as well as \C is ignored, so that \CA, \Ca,
  751.   \cA and \ca are all equivalent.  An alternative form is to specify the
  752.   key as a three digit octal number prefixed with a ``\'' (for example
  753.   \177 is equivalent to \c?).
  754.  
  755.   In addition, key may consist of:
  756.  
  757.        \t              tab
  758.        <Tab>           tab
  759.        \r              carriage return
  760.        \n              newline
  761.        \e              escape
  762.        <esc>           escape
  763.        <up>            up arrow
  764.        <down>          down arrow
  765.        <left>          left arrow
  766.        <right>         right arrow
  767.        <pageup>        Page Up
  768.        <pagedown>      Page Down
  769.        <backspace>     Backspace
  770.        <delete>        Delete
  771.        <insert>        Insert
  772.        <enter>         Enter
  773.        <home>          Home
  774.        <end>           End
  775.        <Space>         Space bar
  776.        <f1>            function key 1
  777.        <f10>           function key 10
  778.  
  779.   key does not need to be enclosed in quotes unless it contains a space
  780.   (`` '').
  781.  
  782.   function specifies which action to take when key is pressed.  For a
  783.   complete list of functions, see the ``reference''.  The special
  784.   function noop unbinds the specify key sequence.
  785.  
  786.   3.4.  Defining aliases for character sets
  787.  
  788.   Usage: charset-hook alias charset
  789.  
  790.   This command defines an alias for a character set.  This is useful to
  791.   properly display messages which are tagged with a character set name
  792.   not known to mutt.
  793.  
  794.   3.5.  Setting variables based upon mailbox
  795.  
  796.   Usage: folder-hook [!]regexp command
  797.  
  798.   It is often desirable to change settings based on which mailbox you
  799.   are reading.  The folder-hook command provides a method by which you
  800.   can execute any configuration command.  pattern is a regular
  801.   expression specifying in which mailboxes to execute command before
  802.   loading.  If a mailbox matches multiple folder-hook's, they are
  803.   executed in the order given in the muttrc.
  804.  
  805.   Note: if you use the ``!'' shortcut for ``$spoolfile'' at the
  806.   beginning of the pattern, you must place it inside of double or single
  807.   quotes in order to distinguish it from the logical not operator for
  808.   the expression.
  809.  
  810.   Note that the settings are not restored when you leave the mailbox.
  811.   For example, a command action to perform is to change the sorting
  812.   method based upon the mailbox being read:
  813.  
  814.        folder-hook mutt set sort=threads
  815.  
  816.   However, the sorting method is not restored to its previous value when
  817.   reading a different mailbox.  To specify a default command, use the
  818.   pattern ``.'':
  819.  
  820.        folder-hook . set sort=date-sent
  821.  
  822.   3.6.  Keyboard macros
  823.  
  824.   Usage: macro menu key sequence [ description ]
  825.  
  826.   Macros are useful when you would like a single key to perform a series
  827.   of actions.  When you press key in menu menu, Mutt will behave as if
  828.   you had typed sequence.  So if you have a common sequence of commands
  829.   you type, you can create a macro to execute those commands with a
  830.   single key.
  831.  
  832.   key and sequence are expanded by the same rules as the ``key
  833.   bindings'', with the addition that control characters in sequence can
  834.   also be specified as ^x.  In order to get a caret (``^'') you need to
  835.   use ^^.
  836.  
  837.   Optionally you can specify a descriptive text, which is shown in the
  838.   help screens.
  839.   Note: Macro definitions (if any) listed in the help screen(s), are
  840.   silently truncated at the screen width, and are not wrapped.
  841.  
  842.   3.7.  Using color and mono video attributes
  843.  
  844.   Usage: color object foreground background [ regexp ]
  845.   Usage: color index foreground background [ pattern ]
  846.   Usage: uncolor index pattern [ pattern ...  ]
  847.  
  848.   If your terminal supports color, you can spice up Mutt by creating
  849.   your own color scheme.  To define the color of an object (type of
  850.   information), you must specify both a foreground color and a
  851.   background color (it is not possible to only specify one or the
  852.   other).
  853.  
  854.   object can be one of:
  855.  
  856.   ·  attachment
  857.  
  858.   ·  body (match regexp in the body of messages)
  859.  
  860.   ·  bold (hiliting bold patterns in the body of messages)
  861.  
  862.   ·  error (error messages printed by Mutt)
  863.  
  864.   ·  header (match regexp in the message header)
  865.  
  866.   ·  hdrdefault (default color of the message header in the pager)
  867.  
  868.   ·  index (match pattern in the message index)
  869.  
  870.   ·  indicator (arrow or bar used to indicate the current item in a
  871.      menu)
  872.  
  873.   ·  markers (the ``+'' markers at the beginning of wrapped lines in the
  874.      pager)
  875.  
  876.   ·  message (informational messages)
  877.  
  878.   ·  normal
  879.  
  880.   ·  quoted (text matching ``$quote_regexp'' in the body of a message)
  881.  
  882.   ·  quoted1, quoted2, ..., quotedN (higher levels of quoting)
  883.  
  884.   ·  search (hiliting of words in the pager)
  885.  
  886.   ·  signature
  887.  
  888.   ·  status (mode lines used to display info about the mailbox or
  889.      message)
  890.  
  891.   ·  tilde (the ``~'' used to pad blank lines in the pager)
  892.  
  893.   ·  tree (thread tree drawn in the message index and attachment menu)
  894.  
  895.   ·  underline (hiliting underlined patterns in the body of messages)
  896.  
  897.   foreground and background can be one of the following:
  898.  
  899.   ·  white
  900.  
  901.   ·  black
  902.  
  903.   ·  green
  904.  
  905.   ·  magenta
  906.  
  907.   ·  blue
  908.  
  909.   ·  cyan
  910.  
  911.   ·  yellow
  912.  
  913.   ·  red
  914.  
  915.   ·  default
  916.  
  917.   ·  colorx
  918.  
  919.   foreground can optionally be prefixed with the keyword bright to make
  920.   the foreground color boldfaced (e.g., brightred).
  921.  
  922.   If your terminal supports it, the special keyword default can be used
  923.   as a transparent color.  The value brightdefault is also valid.  If
  924.   Mutt is linked against the S-Lang library, you also need to set the
  925.   COLORFGBG environment variable to the default colors of your terminal
  926.   for this to work; for example (for Bourne-like shells):
  927.  
  928.        set COLORFGBG="green;black"
  929.        export COLORFGBG
  930.  
  931.   Note: The S-Lang library requires you to use the lightgray and brown
  932.   keywords instead of white and yellow when setting this variable.
  933.  
  934.   Note: The uncolor command can be applied to the index object only.  It
  935.   removes entries from the list. You must specify the same pattern
  936.   specified in the color command for it to be removed.  The pattern
  937.   ``*'' is a special token which means to clear the color index list of
  938.   all entries.
  939.  
  940.   Mutt also recognizes the keywords color0, color1, ..., colorN-1 (N
  941.   being the number of colors supported by your terminal).  This is
  942.   useful when you remap the colors for your display (for example by
  943.   changing the color associated with color2 for your xterm), since color
  944.   names may then lose their normal meaning.
  945.  
  946.   If your terminal does not support color, it is still possible change
  947.   the video attributes through the use of the ``mono'' command:
  948.  
  949.   Usage: mono <object> <attribute> [ regexp ]
  950.  
  951.   where attribute is one of the following:
  952.  
  953.   ·  none
  954.  
  955.   ·  bold
  956.  
  957.   ·  underline
  958.  
  959.   ·  reverse
  960.  
  961.   ·  standout
  962.  
  963.   3.8.  Ignoring (weeding) unwanted message headers
  964.  
  965.   Usage: [un]ignore pattern [ pattern ... ]
  966.  
  967.   Messages often have many header fields added by automatic processing
  968.   systems, or which may not seem useful to display on the screen.  This
  969.   command allows you to specify header fields which you don't normally
  970.   want to see.
  971.  
  972.   You do not need to specify the full header field name.  For example,
  973.   ``ignore content-'' will ignore all header fields that begin with the
  974.   pattern ``content-''.
  975.  
  976.   To remove a previously added token from the list, use the ``unignore''
  977.   command.  Note that if you do ``ignore x-'' it is not possible to
  978.   ``unignore x-mailer,'' for example.  The ``unignore'' command does not
  979.   make Mutt display headers with the given pattern.
  980.  
  981.   ``unignore *'' will remove all tokens from the ignore list.
  982.  
  983.   For example:
  984.  
  985.        # Sven's draconian header weeding
  986.        ignore *
  987.        unignore from date subject to cc
  988.        unignore organization organisation x-mailer: x-newsreader: x-mailing-list:
  989.        unignore posted-to:
  990.  
  991.   3.9.  Mailing lists
  992.  
  993.   Usage: [un]lists address [ address ... ]
  994.   Usage: [un]subscribe address [ address ... ]
  995.  
  996.   Mutt has a few nice features for ``handling mailing lists''.  In order
  997.   to take advantage of them, you must specify which addresses belong to
  998.   mailing lists, and which mailing lists you are subscribed to.
  999.  
  1000.   More precisely, Mutt maintains lists of known and subscribed mailing
  1001.   lists.  Obviously, every subscribed mailing list is known.  To mark a
  1002.   mailing list as known, use the ``lists'' command.  To mark it as
  1003.   subscribed, use ``subscribe''.
  1004.  
  1005.   Specify as much of the address as you need to to remove ambiguity.
  1006.   For example, if you've subscribed to the Mutt mailing list, you will
  1007.   receive mail addresssed to mutt-users@mutt.org.  So, to tell Mutt that
  1008.   this is a mailing list, you could add ``lists mutt-users'' to your
  1009.   initialization file.  To tell mutt that you are subscribed to it, add
  1010.   ``subscribe mutt-users'' to your initialization file.  If you also
  1011.   happen to get mail from someone whose address is mutt-users@example.com,
  1012.   you could use ``lists mutt-users@mutt.org'' to match only mail from the
  1013.   actual list.
  1014.  
  1015.   The ``unlists'' command is used to remove a token from the list of known
  1016.   and subscribed mailing-lists. Use ``unlists *'' to remove all tokens.
  1017.   
  1018.   To remove a mailing list from the list of subscribed mailing lists,
  1019.   but keep it on the list of known mailing lists, use ``unsubscribe''.
  1020.  
  1021.   3.10.  Using Multiple spool mailboxes
  1022.  
  1023.   Usage: mbox-hook [!]pattern mailbox
  1024.  
  1025.   This command is used to move read messages from a specified mailbox to
  1026.   a different mailbox automatically when you quit or change folders.
  1027.   pattern is a regular expression specifying the mailbox to treat as a
  1028.   ``spool'' mailbox and mailbox specifies where mail should be saved
  1029.   when read.
  1030.  
  1031.   Unlike some of the other hook commands, only the first matching
  1032.   pattern is used (it is not possible to save read mail in more than a
  1033.   single mailbox).
  1034.  
  1035.   3.11.  Defining mailboxes which receive mail
  1036.  
  1037.   Usage: mailboxes [!]filename [ filename ... ]
  1038.  
  1039.   This command specifies folders which can receive mail and which will
  1040.   be checked for new messages.  By default, the main menu status bar
  1041.   displays how many of these folders have new messages.
  1042.  
  1043.   When changing folders, pressing space will cycle through folders with
  1044.   new mail.
  1045.  
  1046.   Pressing TAB in the directory browser will bring up a menu showing the
  1047.   files specified by the mailboxes command, and indicate which contain
  1048.   new messages.  Mutt will automatically enter this mode when invoked
  1049.   from the command line with the -y option.
  1050.  
  1051.   Note: new mail is detected by comparing the last modification time to
  1052.   the last access time.  Utilities like biff or frm or any other program
  1053.   which accesses the mailbox might cause Mutt to never detect new mail
  1054.   for that mailbox if they do not properly reset the access time.
  1055.  
  1056.   Note: the filenames in the mailboxes command are resolved when the
  1057.   command is executed, so if these names contain ``shortcut characters''
  1058.   (such as ``='' and ``!''), any variable definition that affect these
  1059.   characters (like ``$folder'' and ``$spool'') should be executed before
  1060.   the mailboxes command.
  1061.  
  1062.   3.12.  User defined headers
  1063.  
  1064.   Usage:
  1065.   my_hdr string
  1066.   unmy_hdr field [ field ... ]
  1067.  
  1068.   The ``my_hdr'' command allows you to create your own header fields
  1069.   which will be added to every message you send.
  1070.  
  1071.   For example, if you would like to add an ``Organization:'' header
  1072.   field to all of your outgoing messages, you can put the command
  1073.  
  1074.        my_hdr Organization: A Really Big Company, Anytown, USA
  1075.  
  1076.   in your .muttrc.
  1077.  
  1078.   Note:  space characters are not allowed between the keyword and the
  1079.   colon (``:'').  The standard for electronic mail (RFC822) says that
  1080.   space is illegal there, so Mutt enforces the rule.
  1081.  
  1082.   If you would like to add a header field to a single message, you
  1083.   should either set the ``edit_headers'' variable, or use the edit-
  1084.   headers function (default: ``E'') in the send-menu so that you can
  1085.   edit the header of your message along with the body.
  1086.  
  1087.   To remove user defined header fields, use the ``unmy_hdr'' command.
  1088.   You may specify an asterisk (``*'') to remove all header fields, or
  1089.   the fields to remove.  For example, to remove all ``To'' and ``Cc''
  1090.   header fields, you could use:
  1091.  
  1092.        unmy_hdr to cc
  1093.  
  1094.   3.13.  Defining the order of headers when viewing messages
  1095.  
  1096.   Usage: hdr_order header1 header2 header3
  1097.  
  1098.   With this command, you can specify an order in which mutt will attempt
  1099.   to present headers to you when viewing messages.
  1100.  
  1101.   ``unhdr_order *'' will clear all previous headers from the order list,
  1102.   thus removing the header order effects set by the system-wide startup
  1103.   file.
  1104.  
  1105.        hdr_order From Date: From: To: Cc: Subject:
  1106.  
  1107.   3.14.  Specify default save filename
  1108.  
  1109.   Usage: save-hook [!]pattern filename
  1110.  
  1111.   This command is used to override the default filename used when saving
  1112.   messages.  filename will be used as the default filename if the
  1113.   message is From: an address matching regexp or if you are the author
  1114.   and the message is addressed to: something matching regexp.
  1115.  
  1116.   See ``matching messages'' for information on the exact format of
  1117.   pattern.
  1118.  
  1119.   Examples:
  1120.  
  1121.        save-hook me@(turing\\.)?cs\\.hmc\\.edu$ +elkins
  1122.        save-hook aol\\.com$ +spam
  1123.  
  1124.   Also see the ``fcc-save-hook'' command.
  1125.  
  1126.   3.15.  Specify default Fcc: mailbox when composing
  1127.  
  1128.   Usage: fcc-hook [!]pattern mailbox
  1129.  
  1130.   This command is used to save outgoing mail in a mailbox other than
  1131.   ``$record''.  Mutt searches the initial list of message recipients for
  1132.   the first matching regexp and uses mailbox as the default Fcc:
  1133.   mailbox.  If no match is found the message will be saved to
  1134.   ``$record'' mailbox.
  1135.  
  1136.   See ``matching messages'' for information on the exact format of
  1137.   pattern.
  1138.  
  1139.   Example: fcc-hook aol.com$ +spammers
  1140.  
  1141.   The above will save a copy of all messages going to the aol.com domain
  1142.   to the `+spammers' mailbox by default.  Also see the ``fcc-save-hook''
  1143.   command.
  1144.  
  1145.   3.16.  Specify default save filename and default Fcc: mailbox at once
  1146.  
  1147.   Usage: fcc-save-hook [!]pattern mailbox
  1148.  
  1149.   This command is a shortcut, equivalent to doing both a ``fcc-hook''
  1150.   and a ``save-hook'' with its arguments.
  1151.  
  1152.   3.17.  Change settings based upon message recipients
  1153.  
  1154.   Usage: send-hook [!]pattern command
  1155.  
  1156.   This command can be used to execute arbitrary configuration commands
  1157.   based upon recipients of the message.  pattern is a regular expression
  1158.   matching the desired address.  command is executed when regexp matches
  1159.   recipients of the message.  When multiple matches occur, commands are
  1160.   executed in the order they are specified in the muttrc.
  1161.  
  1162.   See ``matching messages'' for information on the exact format of
  1163.   pattern.
  1164.  
  1165.   Example: send-hook mutt "set mime_forward signature=''"
  1166.  
  1167.   Another typical use for this command is to change the values of the
  1168.   ``$attribution'', ``$signature'' and ``$locale'' variables in order to
  1169.   change the language of the attributions and signatures based upon the
  1170.   recipients.
  1171.  
  1172.   Note: the send-hook's are only executed ONCE after getting the initial
  1173.   list of recipients.  Adding a recipient after replying or editing the
  1174.   message will NOT cause any send-hook to be executed.
  1175.  
  1176.   3.18.  Choosing the PGP key of the recipient
  1177.  
  1178.   Usage: pgp-hook pattern keyid
  1179.  
  1180.   When encrypting messages with PGP, you may want to associate a certain
  1181.   PGP key with a given e-mail address automatically, either because the
  1182.   recipient's public key can't be deduced from the destination address,
  1183.   or because, for some reasons, you need to override the key Mutt would
  1184.   normally use.  The pgp-hook command provides a method by which you can
  1185.   specify the ID of the public key to be used when encrypting messages
  1186.   to a certain recipient.
  1187.  
  1188.   3.19.  Adding key sequences to the keyboard buffer
  1189.  
  1190.   Usage: push string
  1191.  
  1192.   This command adds the named string to the keyboard buffer.  You may
  1193.   use it to automatically run a sequence of commands at startup, or when
  1194.   entering certain folders.
  1195.   3.20.  Message Scoring
  1196.  
  1197.   Usage: score pattern value
  1198.   Usage: unscore pattern [ pattern ... ]
  1199.  
  1200.   The score commands adds value to a message's score if pattern matches
  1201.   it.  pattern is a string in the format described in the ``patterns''
  1202.   section.  value is a positive or negative integer.  A message's final
  1203.   score is the sum total of all matching score entries.  However, you
  1204.   may optionally prefix value with an equal sign (=) to cause evaluation
  1205.   to stop at a particular entry if there is a match.  Negative final
  1206.   scores are rounded up to 0.
  1207.  
  1208.   The unscore command removes score entries from the list.  You must
  1209.   specify the same pattern specified in the score command for it to be
  1210.   removed.  The pattern ``*'' is a special token which means to clear
  1211.   the list of all score entries.
  1212.  
  1213.   3.21.  Setting variables
  1214.  
  1215.   Usage: set [no|inv]variable[=value] [ variable ... ]
  1216.   Usage: toggle variable [variable ... ]
  1217.   Usage: unset variable [variable ... ]
  1218.   Usage: reset variable [variable ... ]
  1219.  
  1220.   This command is used to set (and unset) ``configuration variables''.
  1221.   There are four basic types of variables: boolean, number, string and
  1222.   quadoption.  boolean variables can be set (true) or unset (false).
  1223.   number variables can be assigned a positive integer value.
  1224.  
  1225.   string variables consist of any number of printable characters.
  1226.   strings must be enclosed in quotes if they contain spaces or tabs.
  1227.   You may also use the ``C'' escape sequences \n and \t for newline and
  1228.   tab, respectively.
  1229.  
  1230.   quadoption variables are used to control whether or not to be prompted
  1231.   for certain actions, or to specify a default action.  A value of yes
  1232.   will cause the action to be carried out automatically as if you had
  1233.   answered yes to the question.  Similarly, a value of no will cause the
  1234.   the action to be carried out as if you had answered ``no.''  A value
  1235.   of ask-yes will cause a prompt with a default answer of ``yes'' and
  1236.   ask-no will provide a default answer of ``no.''
  1237.  
  1238.   Prefixing a variable with ``no'' will unset it.  Example: set
  1239.   noaskbcc.
  1240.  
  1241.   For boolean variables, you may optionally prefix the variable name
  1242.   with inv to toggle the value (on or off).  This is useful when writing
  1243.   macros.  Example: set invsmart_wrap.
  1244.  
  1245.   The toggle command automatically prepends the inv prefix to all
  1246.   specified variables.
  1247.  
  1248.   The unset command automatically prepends the no prefix to all
  1249.   specified variables.
  1250.  
  1251.   Using the enter-command function in the index menu, you can query the
  1252.   value of a variable by prefixing the name of the variable with a
  1253.   question mark:
  1254.  
  1255.        set ?allow_8bit
  1256.  
  1257.   The question mark is actually only required for boolean and quadoption
  1258.   variables.
  1259.  
  1260.   The reset command resets all given variables to the compile time
  1261.   defaults (hopefully mentioned in this manual). If you use the command
  1262.   set and prefix the variable with ``&'' this has the same behavior as
  1263.   the reset command.
  1264.  
  1265.   With the reset command there exists the special variable ``all'',
  1266.   which allows you to reset all variables to their system defaults.
  1267.  
  1268.   3.22.  Reading initialization commands from another file
  1269.  
  1270.   Usage: source filename
  1271.  
  1272.   This command allows the inclusion of initialization commands from
  1273.   other files.  For example, I place all of my aliases in
  1274.   ~/.mail_aliases so that I can make my ~/.muttrc readable and keep my
  1275.   aliases private.
  1276.  
  1277.   If the filename begins with a tilde (``~''), it will be expanded to
  1278.   the path of your home directory.
  1279.  
  1280.   If the filename ends with a vertical bar (|), then filename is
  1281.   considered to be an executable program from which to read input (eg.
  1282.   source ~bin/myscript|/).
  1283.  
  1284.   4.  Advanced Usage
  1285.  
  1286.   4.1.  Regular Expressions
  1287.  
  1288.   All string patterns in Mutt including those in more complex
  1289.   ``patterns'' must be specified using regular expressions (regexp) in
  1290.   the ``POSIX extended'' syntax (which is more or less the syntax used
  1291.   by egrep and GNU awk).  For your convenience, we have included below a
  1292.   brief description of this syntax.
  1293.  
  1294.   The search is case sensitive if the pattern contains at least one
  1295.   upper case letter, and case insensitive otherwise. Note that ``\''
  1296.   must be quoted if used for a regular expression in an initialization
  1297.   command: ``\\''.
  1298.  
  1299.   A regular expression is a pattern that describes a set of strings.
  1300.   Regular expressions are constructed analogously to arithmetic
  1301.   expressions, by using various operators to combine smaller
  1302.   expressions.
  1303.  
  1304.   The fundamental building blocks are the regular expressions that match
  1305.   a single character.  Most characters, including all letters and
  1306.   digits, are regular expressions that match themselves.  Any
  1307.   metacharacter with special meaning may be quoted by preceding it with
  1308.   a backslash.
  1309.  
  1310.   The period ``.'' matches any single character.  The caret ``^'' and
  1311.   the dollar sign ``$'' are metacharacters that respectively match the
  1312.   empty string at the beginning and end of a line.
  1313.  
  1314.   A list of characters enclosed by ``['' and ``]'' matches any single
  1315.   character in that list; if the first character of the list is a caret
  1316.   ``^'' then it matches any character not in the list.  For example, the
  1317.   regular expression [0123456789] matches any single digit.  A range of
  1318.   ASCII characters may be specified by giving the first and last
  1319.   characters, separated by a hyphen ``-''.  Most metacharacters lose
  1320.   their special meaning inside lists.  To include a literal ``]'' place
  1321.   it first in the list.  Similarly, to include a literal ``^'' place it
  1322.   anywhere but first.  Finally, to include a literal hyphen ``-'' place
  1323.   it last.
  1324.  
  1325.   Certain named classes of characters are predefined.  Character classes
  1326.   consist of ``[:'', a keyword denoting the class, and ``:]''.  The
  1327.   following classes are defined by the POSIX standard:
  1328.  
  1329.      [:alnum:]
  1330.         Alphanumeric characters.
  1331.  
  1332.      [:alpha:]
  1333.         Alphabetic characters.
  1334.  
  1335.      [:blank:]
  1336.         Space or tab characters.
  1337.  
  1338.      [:cntrl:]
  1339.         Control characters.
  1340.  
  1341.      [:digit:]
  1342.         Numeric characters.
  1343.  
  1344.      [:graph:]
  1345.         Characters that are both printable and visible.  (A space is
  1346.         printable, but not visible, while an ``a'' is both.)
  1347.  
  1348.      [:lower:]
  1349.         Lower-case alphabetic characters.
  1350.  
  1351.      [:print:]
  1352.         Printable characters (characters that are not control
  1353.         characters.)
  1354.  
  1355.      [:punct:]
  1356.         Punctuation characters (characters that are not letter, digits,
  1357.         control characters, or space characters).
  1358.  
  1359.      [:space:]
  1360.         Space characters (such as space, tab and formfeed, to name a
  1361.         few).
  1362.  
  1363.      [:upper:]
  1364.         Upper-case alphabetic characters.
  1365.  
  1366.      [:xdigit:]
  1367.         Characters that are hexadecimal digits.
  1368.  
  1369.   A character class is only valid in a regular expression inside the
  1370.   brackets of a character list.  Note that the brackets in these class
  1371.   names are part of the symbolic names, and must be included in addition
  1372.   to the brackets delimiting the bracket list.  For example, [[:digit:]]
  1373.   is equivalent to [0-9].
  1374.  
  1375.   Two additional special sequences can appear in character lists.  These
  1376.   apply to non-ASCII character sets, which can have single symbols
  1377.   (called collating elements) that are represented with more than one
  1378.   character, as well as several characters that are equivalent for
  1379.   collating or sorting purposes:
  1380.  
  1381.      Collating Symbols
  1382.         A collating symbols is a multi-character collating element
  1383.         enclosed in ``[.'' and ``.]''.  For example, if ``ch'' is a
  1384.         collating element, then [[.ch.]] is a regexp that matches this
  1385.         collating element, while [ch] is a regexp that matches either
  1386.         ``c'' or ``h''.
  1387.  
  1388.      Equivalence Classes
  1389.         An equivalence class is a locale-specific name for a list of
  1390.         characters that are equivalent. The name is enclosed in ``[=''
  1391.         and ``=]''.  For example, the name ``e'' might be used to
  1392.         represent all of ``è'' ``é'' and ``e''.  In this case, [[=e=]]
  1393.         is a regexp that matches any of ``è'', ``é'' and ``e''.
  1394.  
  1395.   A regular expression matching a single character may be followed by
  1396.   one of several repetition operators:
  1397.  
  1398.      ?  The preceding item is optional and matched at most once.
  1399.  
  1400.      *  The preceding item will be matched zero or more times.
  1401.  
  1402.      +  The preceding item will be matched one or more times.
  1403.  
  1404.      {n}
  1405.         The preceding item is matched exactly n times.
  1406.  
  1407.      {n,}
  1408.         The preceding item is matched n or more times.
  1409.  
  1410.      {,m}
  1411.         The preceding item is matched at most m times.
  1412.  
  1413.      {n,m}
  1414.         The preceding item is matched at least n times, but no more than
  1415.         m times.
  1416.  
  1417.   Two regular expressions may be concatenated; the resulting regular
  1418.   expression matches any string formed by concatenating two substrings
  1419.   that respectively match the concatenated subexpressions.
  1420.  
  1421.   Two regular expressions may be joined by the infix operator ``|''; the
  1422.   resulting regular expression matches any string matching either
  1423.   subexpression.
  1424.  
  1425.   Repetition takes precedence over concatenation, which in turn takes
  1426.   precedence over alternation.  A whole subexpression may be enclosed in
  1427.   parentheses to override these precedence rules.
  1428.  
  1429.   Note: If you compile Mutt with the GNU rx package, the following
  1430.   operators may also be used in regular expressions:
  1431.  
  1432.      \\y
  1433.         Matches the empty string at either the beginning or the end of a
  1434.         word.
  1435.  
  1436.      \\B
  1437.         Matches the empty string within a word.
  1438.  
  1439.      \\<
  1440.         Matches the empty string at the beginning of a word.
  1441.  
  1442.      \\>
  1443.         Matches the empty string at the end of a word.
  1444.  
  1445.      \\w
  1446.         Matches any word-constituent character (letter, digit, or
  1447.         underscore).
  1448.  
  1449.      \\W
  1450.         Matches any character that is not word-constituent.
  1451.  
  1452.      \\`
  1453.         Matches the empty string at the beginning of a buffer (string).
  1454.  
  1455.      \\'
  1456.         Matches the empty string at the end of a buffer.
  1457.  
  1458.   Please note however that these operators are not defined by POSIX, so
  1459.   they may or may not be available in stock libraries on various
  1460.   systems.
  1461.  
  1462.   4.2.  Patterns
  1463.  
  1464.   Many of Mutt's commands allow you to specify a pattern to match
  1465.   (limit, tag-pattern, delete-pattern, etc.).  There are several ways to
  1466.   select messages:
  1467.  
  1468.        ~A              all messages
  1469.        ~b EXPR         messages which contain EXPR in the message body
  1470.        ~B EXPR         messages which contain EXPR in the whole message
  1471.        ~c USER         messages carbon-copied to USER
  1472.        ~C EXPR         message is either to: or cc: EXPR
  1473.        ~D              deleted messages
  1474.        ~d [MIN]-[MAX]  messages with ``date-sent'' in a Date range
  1475.        ~E              expired messages
  1476.        ~e EXPR         message which contains EXPR in the ``Sender'' field
  1477.        ~F              flagged messages
  1478.        ~f USER         messages originating from USER
  1479.        ~g              PGP signed messages
  1480.        ~G              PGP encrypted messages
  1481.        ~h EXPR         messages which contain EXPR in the message header
  1482.        ~k              message contains PGP key material
  1483.        ~i ID           message which match ID in the ``Message-ID'' field
  1484.        ~L EXPR         message is either originated or received by EXPR
  1485.        ~l              message is addressed to a known mailing list
  1486.        ~m [MIN]-[MAX]  message in the range MIN to MAX *)
  1487.        ~n [MIN]-[MAX]  messages with a score in the range MIN to MAX *)
  1488.        ~N              new messages
  1489.        ~O              old messages
  1490.        ~p              message is addressed to you (consults $alternates)
  1491.        ~P              message is from you (consults $alternates)
  1492.        ~Q              messages which have been replied to
  1493.        ~R              read messages
  1494.        ~r [MIN]-[MAX]  messages with ``date-received'' in a Date range
  1495.        ~S              superseded messages
  1496.        ~s SUBJECT      messages having SUBJECT in the ``Subject'' field.
  1497.        ~T              tagged messages
  1498.        ~t USER         messages addressed to USER
  1499.        ~U              unread messages
  1500.        ~v              message is part of a collapsed thread.
  1501.        ~x EXPR         messages which contain EXPR in the `References' field
  1502.        ~z [MIN]-[MAX]  messages with a size in the range MIN to MAX *)
  1503.  
  1504.   Where EXPR, USER, ID, and SUBJECT are ``regular expressions''.
  1505.  
  1506.   *) The forms <[MAX], >[MIN], [MIN]- and -[MAX] are allowed, too.
  1507.  
  1508.   4.2.1.  Pattern Modifier
  1509.  
  1510.   Note that patterns matching 'lists' of addresses (notably c,C,p,P and
  1511.   t) match if there is at least one match in the whole list. If you want
  1512.   to make sure that all elements of that list match, you need to prefix
  1513.   your pattern with ^.  This example matches all mails which only has
  1514.   recipients from Germany.
  1515.  
  1516.        ^~C \.de$
  1517.  
  1518.   4.2.2.  Complex Patterns
  1519.  
  1520.   Logical AND is performed by specifying more than one criterion.  For
  1521.   example:
  1522.  
  1523.        ~t mutt ~f elkins
  1524.  
  1525.   would select messages which contain the word ``mutt'' in the list of
  1526.   recipients and that have the word ``elkins'' in the ``From'' header
  1527.   field.
  1528.  
  1529.   Mutt also recognizes the following operators to create more complex
  1530.   search patterns:
  1531.  
  1532.   ·  ! -- logical NOT operator
  1533.  
  1534.   ·  | -- logical OR operator
  1535.  
  1536.   ·  () -- logical grouping operator
  1537.  
  1538.   Here is an example illustrating a complex search pattern.  This
  1539.   pattern will select all messages which do not contain ``mutt'' in the
  1540.   ``To'' or ``Cc'' field and which are from ``elkins''.
  1541.  
  1542.        !(~t mutt|~c mutt) ~f elkins
  1543.  
  1544.   4.2.3.  Searching by Date
  1545.  
  1546.   Mutt supports two types of dates, absolute and relative.
  1547.  
  1548.   Absolute.  Dates must be in DD/MM/YY format (month and year are
  1549.   optional, defaulting to the current month and year).  An example of a
  1550.   valid range of dates is:
  1551.  
  1552.   Limit to messages matching: ~d 20/1/95-31/10
  1553.  
  1554.   If you omit the minimum (first) date, and just specify ``-DD/MM/YY'',
  1555.   all messages before the given date will be selected.  If you omit the
  1556.   maximum (second) date, and specify ``DD/MM/YY-'', all messages after
  1557.   the given date will be selected.  If you specify a single date with no
  1558.   dash (``-''), only messages sent on the given date will be selected.
  1559.  
  1560.   Relative.  This type of date is relative to the current date, and may
  1561.   be specified as:
  1562.  
  1563.   ·  >offset (messages older than offset units)
  1564.  
  1565.   ·  <offset (messages newer than offset units)
  1566.  
  1567.   ·  =offset (messages exactly offset units old)
  1568.  
  1569.   offset is specified as a positive number with one of the following
  1570.   units:
  1571.  
  1572.   y       years
  1573.   m       months
  1574.   w       weeks
  1575.   d       days
  1576.  
  1577.   Example: to select messages less than 1 month old, you would use
  1578.  
  1579.        Limit to messages matching: ~d <1m
  1580.  
  1581.   Note: all dates used when searching are relative to the local time
  1582.   zone, so unless you change the setting of your ``$index_format'' to
  1583.   include a %[...] format, these are not the dates shown in the main
  1584.   index.
  1585.  
  1586.   4.3.  Using Tags
  1587.  
  1588.   Sometimes it is desirable to perform an operation on a group of
  1589.   messages all at once rather than one at a time.  An example might be
  1590.   to save messages to a mailing list to a separate folder, or to delete
  1591.   all messages with a given subject.  To tag all messages matching a
  1592.   pattern, use the tag-pattern function, which is bound to ``control-T''
  1593.   by default.  Or you can select individual messages by hand using the
  1594.   ``tag-message'' function, which is bound to ``t'' by default.  See
  1595.   ``patterns'' for Mutt's pattern matching syntax.
  1596.  
  1597.   Once you have tagged the desired messages, you can use the ``tag-
  1598.   prefix'' operator, which is the ``;'' (semicolon) key by default.
  1599.   When the ``tag-prefix'' operator is used, the next operation will be
  1600.   applied to all tagged messages if that operation can be used in that
  1601.   manner.  If the ``$auto_tag'' variable is set, the next operation
  1602.   applies to the tagged messages automatically, without requiring the
  1603.   ``tag-prefix''.
  1604.  
  1605.   4.4.  Using Hooks
  1606.  
  1607.   A hook is a concept borrowed from the EMACS editor which allows you to
  1608.   execute arbitrary commands before performing some operation.  For
  1609.   example, you may wish to tailor your configuration based upon which
  1610.   mailbox you are reading, or to whom you are sending mail.  In the Mutt
  1611.   world, a hook consists of a ``regular expression'' or ``pattern''
  1612.   along with a configuration option/command.  See
  1613.  
  1614.   ·  ``folder-hook''
  1615.  
  1616.   ·  ``send-hook''
  1617.  
  1618.   ·  ``save-hook''
  1619.  
  1620.   ·  ``mbox-hook''
  1621.  
  1622.   ·  ``fcc-hook''
  1623.  
  1624.   ·  ``fcc-save-hook''
  1625.  
  1626.      for specific details on each type of hook available.
  1627.  
  1628.   4.4.1.  Message Matching in Hooks
  1629.  
  1630.   Hooks that act upon messages (send-hook, save-hook, fcc-hook) are
  1631.   evaluated in a slightly different manner.  For the other types of
  1632.   hooks, a ``regular expression'' is sufficient.  But in dealing with
  1633.   messages a finer grain of control is needed for matching since for
  1634.   different purposes you want to match different criteria.
  1635.  
  1636.   Mutt allows the use of the ``search pattern'' language for matching
  1637.   messages in hook commands.  This works in exactly the same way as it
  1638.   would when limiting or searching the mailbox, except that you are
  1639.   restricted to those operators which match information from the
  1640.   envelope of the message (i.e.  from, to, cc, date, subject, etc.).
  1641.  
  1642.   For example, if you wanted to set your return address based upon
  1643.   sending mail to a specific address, you could do something like:
  1644.  
  1645.        send-hook '~t ^me@cs\.hmc\.edu$' 'my_hdr From: Mutt User <user@host>'
  1646.  
  1647.   which would execute the given command when sending mail to
  1648.   me@cs.hmc.edu.
  1649.  
  1650.   However, it is not required that you write the pattern to match using
  1651.   the full searching language.  You can still specify a simple regular
  1652.   expression like the other hooks, in which case Mutt will translate
  1653.   your pattern into the full language, using the translation specified
  1654.   by the ``$default_hook'' variable.  The pattern is translated at the
  1655.   time the hook is declared, so the value of ``$dfault_hook'' that is in
  1656.   effect at that time will be used.
  1657.  
  1658.   4.5.  External Address Queries
  1659.  
  1660.   Mutt supports connecting to external directory databases such as LDAP,
  1661.   ph/qi, bbdb, or NIS through a wrapper script which connects to mutt
  1662.   using a simple interface.  Using the ``$query_command'' variable, you
  1663.   specify the wrapper command to use.  For example:
  1664.  
  1665.        set query_command = "mutt_ldap_query.pl '%s'"
  1666.  
  1667.   The wrapper script should accept the query on the command-line.  It
  1668.   should return a one line message, then each matching response on a
  1669.   single line, each line containing a tab separated address then name
  1670.   then some other optional information.  On error, or if there are no
  1671.   matching addresses, return a non-zero exit code and a one line error
  1672.   message.
  1673.  
  1674.   An example multiple response output:
  1675.  
  1676.        Searching database ... 20 entries ... 3 matching:
  1677.        me@cs.hmc.edu           Michael Elkins  mutt dude
  1678.        blong@fiction.net       Brandon Long    mutt and more
  1679.        roessler@guug.de        Thomas Roessler mutt pgp
  1680.  
  1681.   There are two mechanisms for accessing the query function of mutt.
  1682.   One is to do a query from the index menu using the query function
  1683.   (default: Q).  This will prompt for a query, then bring up the query
  1684.   menu which will list the matching responses.  From the query menu, you
  1685.   can select addresses to create aliases, or to mail.  You can tag
  1686.   multiple messages to mail, start a new query, or have a new query
  1687.   appended to the current responses.
  1688.  
  1689.   The other mechanism for accessing the query function is for address
  1690.   completion, similar to the alias completion.  In any prompt for
  1691.   address entry, you can use the complete-query function (default: ^T)
  1692.   to run a query based on the current address you have typed.  Like
  1693.   aliases, mutt will look for what you have typed back to the last space
  1694.   or comma.  If there is a single response for that query, mutt will
  1695.   expand the address in place.  If there are multiple responses, mutt
  1696.   will activate the query menu.  At the query menu, you can select one
  1697.   or more addresses to be added to the prompt.
  1698.  
  1699.   4.6.  Mailbox Formats
  1700.  
  1701.   Mutt supports reading and writing of four different mailbox formats:
  1702.   mbox, MMDF, MH and Maildir.  The mailbox type is autodetected, so
  1703.   there is no need to use a flag for different mailbox types.  When
  1704.   creating new mailboxes, Mutt uses the default specified with the
  1705.   ``$mbox_type'' variable.
  1706.  
  1707.   mbox.  This is the most widely used mailbox format for UNIX.  All
  1708.   messages are stored in a single file.  Each message has a line of the
  1709.   form:
  1710.  
  1711.        From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
  1712.  
  1713.   to denote the start of a new message (this is often referred to as the
  1714.   ``From_'' line).
  1715.  
  1716.   MMDF.  This is a variant of the mbox format.  Each message is
  1717.   surrounded by lines containing ``^A^A^A^A'' (four control-A's).
  1718.   MH. A radical departure from mbox and MMDF, a mailbox consists of a
  1719.   directory and each message is stored in a separate file.  The filename
  1720.   indicates the message number (however, this is may not correspond to
  1721.   the message number Mutt displays). Deleted messages are renamed with a
  1722.   comma (,) prepended to the filename. Note: Mutt detects this type of
  1723.   mailbox by looking for either .mh_sequences or .xmhcache (needed to
  1724.   distinguish normal directories from MH mailboxes). Mutt does not
  1725.   update these files, yet.
  1726.  
  1727.   Maildir.  The newest of the mailbox formats, used by the Qmail MTA (a
  1728.   replacement for sendmail).  Similar to MH, except that it adds three
  1729.   subdirectories of the mailbox: tmp, new and cur.  Filenames for the
  1730.   messages are chosen in such a way they are unique, even when two
  1731.   programs are writing the mailbox over NFS, which means that no file
  1732.   locking is needed.
  1733.  
  1734.   4.7.  Mailbox Shortcuts
  1735.  
  1736.   There are a number of built in shortcuts which refer to specific
  1737.   mailboxes.  These shortcuts can be used anywhere you are prompted for
  1738.   a file or mailbox path.
  1739.  
  1740.   ·  ! -- refers to your ``$spool'' (incoming) mailbox
  1741.  
  1742.   ·  > -- refers to your ``$mbox'' file
  1743.  
  1744.   ·  < -- refers to your ``$record'' file
  1745.  
  1746.   ·  - -- refers to the file you've last visited
  1747.  
  1748.   ·  ~ -- refers to your home directory
  1749.  
  1750.   ·  = or + -- refers to your ``$folder'' directory
  1751.  
  1752.   ·  @alias -- refers to the ``default save folder'' as determined by
  1753.      the address of the alias
  1754.  
  1755.   4.8.  Handling Mailing Lists
  1756.  
  1757.   Mutt has a few configuration options that make dealing with large
  1758.   amounts of mail easier.  The first thing you must do is to let Mutt
  1759.   know what addresses you consider to be mailing lists (technically this
  1760.   does not have to be a mailing list, but that is what it is most often
  1761.   used for), and what lists you are subscribed to.  This is accomplished
  1762.   through the use of the ``lists'' and ``subscribe'' commands in your
  1763.   muttrc.
  1764.  
  1765.   Now that Mutt knows what your mailing lists are, it can do several
  1766.   things, the first of which is the ability to show the name of a list
  1767.   through which you received a message (i.e., of a subscribed list) in
  1768.   the index menu display.  This is useful to distinguish between
  1769.   personal and list mail in the same mailbox.  In the ``$index_format''
  1770.   variable, the escape ``%L'' will return the string ``To <list>'' when
  1771.   ``list'' appears in the ``To'' field, and ``Cc <list>'' when it
  1772.   appears in the ``Cc'' field (otherwise it returns the name of the
  1773.   author).
  1774.  
  1775.   Often times the ``To'' and ``Cc'' fields in mailing list messages tend
  1776.   to get quite large. Most people do not bother to remove the author of
  1777.   the message they are reply to from the list, resulting in two or more
  1778.   copies being sent to that person.  The ``list-reply'' function, which
  1779.   by default is bound to ``L'' in the index menu and pager, helps reduce
  1780.   the clutter by only replying to the known mailing list addresses
  1781.   instead of all recipients.
  1782.  
  1783.   As an alternative, mutt supports the Mail-Followup-To header.  When
  1784.   you send a message to a list of recipients which includes one or
  1785.   several subscribed mailing lists, and if the ``$followup_to'' option
  1786.   is set, mutt will generate a Mail-Followup-To header which contains
  1787.   all the recipients to whom you send this message, but not your
  1788.   address. This indicates that group-replies to this message should only
  1789.   be sent to the original recipients of the message, and not separately
  1790.   to you - you'll receive your copy through one of the mailing lists you
  1791.   are subscribed to.
  1792.  
  1793.   Conversely, when group-replying to a message which has a Mail-
  1794.   Followup-To header, mutt will respect this header if the
  1795.   ``$honor_followup_to'' configuration variable is set.
  1796.  
  1797.   The other method some mailing list admins use is to generate a
  1798.   ``Reply-To'' field which points back to the mailing list address
  1799.   rather than the author of the message.  This can create problems when
  1800.   trying to reply directly to the author in private, since most mail
  1801.   clients will automatically reply to the address given in the ``Reply-
  1802.   To'' field.  Mutt uses the ``$reply_to'' variable to help decide which
  1803.   address to use.  If set, you will be prompted as to whether or not you
  1804.   would like to use the address given in the ``Reply-To'' field, or
  1805.   reply directly to the address given in the ``From'' field.  When
  1806.   unset, the ``Reply-To'' field will be used when present.
  1807.  
  1808.   Lastly, Mutt has the ability to ``sort'' the mailbox into ``threads''.
  1809.   A thread is a group of messages which all relate to the same subject.
  1810.   This is usually organized into a tree-like structure where a message
  1811.   and all of its replies are represented graphically.  If you've ever
  1812.   used a threaded news client, this is the same concept.  It makes
  1813.   dealing with large volume mailing lists easier because you can easily
  1814.   delete uninteresting threads and quickly find topics of value.
  1815.  
  1816.   4.9.  Delivery Status Notification (DSN) Support
  1817.  
  1818.   RFC1894 defines a set of MIME content types for relaying information
  1819.   about the status of electronic mail messages.  These can be thought of
  1820.   as ``return receipts.'' Berkeley sendmail 8.8.x currently has some
  1821.   command line options in which the mail client can make requests as to
  1822.   what type of status messages should be returned.
  1823.  
  1824.   To support this, there are two variables. ``$dsn_notify'' is used to
  1825.   request receipts for different results (such as failed message,
  1826.   message delivered, etc.).  ``$dsn_return'' requests how much of your
  1827.   message should be returned with the receipt (headers or full message).
  1828.   Refer to the man page on sendmail for more details on DSN.
  1829.  
  1830.   4.10.  POP3 Support (OPTIONAL)
  1831.  
  1832.   If Mutt was compiled with POP3 support (by running the configure
  1833.   script with the --enable-pop flag), it has the ability to fetch your
  1834.   mail from a remote server for local browsing.  When you invoke the
  1835.   fetch-mail function (default: G), Mutt attempts to connect to
  1836.   ``pop_host'' and authenticate by logging in as ``pop_user''.  After
  1837.   the connection is established, you will be prompted for your password
  1838.   on the remote system.
  1839.  
  1840.   Once you have been authenticated, Mutt will fetch all your new mail
  1841.   and place it in the local ``spoolfile''.  After this point, Mutt runs
  1842.   exactly as if the mail had always been local.
  1843.   Note: The POP3 support is there only for convenience, and it's rather
  1844.   limited.  If you need more functionality you should consider using a
  1845.   specialized program, such as fetchmail
  1846.  
  1847.   4.12.  Start a WWW Browser on URLs (EXTERNAL)
  1848.  
  1849.   If a message contains URLs (unified ressource locator = address in the
  1850.   WWW space like http://www.mutt.org/), it is efficient to get a menu
  1851.   with all the URLs and start a WWW browser on one of them.  This
  1852.   functionality is provided by the external urlview program which can be
  1853.   retrieved at ftp://ftp.guug.de/pub/mutt/contrib/ and the configuration
  1854.   commands:
  1855.  
  1856.        macro index \cb |urlview\n
  1857.        macro pager \cb |urlview\n
  1858.  
  1859.   5.  Mutt's MIME Support
  1860.  
  1861.   Quite a bit of effort has been made to make Mutt the premier text-mode
  1862.   MIME MUA.  Every effort has been made to provide the functionality
  1863.   that the discerning MIME user requires, and the conformance to the
  1864.   standards wherever possible.  When configuring Mutt for MIME, there
  1865.   are two extra types of configuration files which Mutt uses.  One is
  1866.   the mime.types file, which contains the mapping of file extensions to
  1867.   IANA MIME types.  The other is the mailcap file, which specifies the
  1868.   external commands to use for handling specific MIME types.
  1869.  
  1870.   5.1.  Using MIME in Mutt
  1871.  
  1872.   There are three areas/menus in Mutt which deal with MIME, they are the
  1873.   pager (while viewing a message), the attachment menu and the compose
  1874.   menu.
  1875.  
  1876.   5.1.1.  Viewing MIME messages in the pager
  1877.  
  1878.   When you select a message from the index and view it in the pager,
  1879.   Mutt decodes the message to a text representation.  Mutt internally
  1880.   supports a number of MIME types, including text/plain, text/enriched,
  1881.   message/rfc822, and message/news.  In addition, the export controlled
  1882.   version of Mutt recognizes a variety of PGP MIME types, including
  1883.   PGP/MIME and application/pgp.
  1884.  
  1885.   Mutt will denote attachments with a couple lines describing them.
  1886.   These lines are of the form:
  1887.  
  1888.   [-- Attachment #1: Description --]
  1889.   [-- Type: text/plain, Encoding: 7bit, Size: 10000 --]
  1890.  
  1891.   Where the Description is the description or filename given for the
  1892.   attachment, and the Encoding is one of 7bit/8bit/quoted-print­
  1893.   able/base64/binary.
  1894.  
  1895.   If Mutt cannot deal with a MIME type, it will display a message like:
  1896.  
  1897.        [-- image/gif is unsupported (use 'v' to view this part) --]
  1898.  
  1899.   5.1.2.  The Attachment Menu
  1900.  
  1901.   The default binding for view-attachments is `v', which displays the
  1902.   attachment menu for a message.  The attachment menu displays a list of
  1903.   the attachments in a message.  From the attachment menu, you can save,
  1904.   print, pipe, delete, and view attachments.  You can apply these
  1905.   operations to a group of attachments at once, by tagging the
  1906.   attachments and by using the ``tag-prefix'' operator.  You can also
  1907.   reply to the current message from this menu, and only the current
  1908.   attachment (or the attachments tagged) will be quoted in your reply.
  1909.   You can view attachments as text, or view them using the mailcap
  1910.   viewer definition.  See the help on the attachment menu for more
  1911.   information.
  1912.  
  1913.   5.1.3.  The Compose Menu
  1914.  
  1915.   The compose menu is the menu you see before you send a message.  It
  1916.   allows you to edit the recipient list, the subject, and other aspects
  1917.   of your message.  It also contains a list of the attachments of your
  1918.   message, including the main body.  From this menu, you can print,
  1919.   copy, filter, pipe, edit, compose, review, and rename an attachment or
  1920.   a list of tagged attachments.  You can also modifying the attachment
  1921.   information, notably the type, encoding and description.
  1922.  
  1923.   Attachments appear as follows:
  1924.  
  1925.   -   1 [text/plain, 7bit, 1K]             /tmp/mutt-euler-8082-0 <no description>
  1926.       2 [applica/x-gunzip, base64, 422K]   ~/src/mutt-0.85.tar.gz <no description>
  1927.  
  1928.   The '-' denotes that Mutt will delete the file after sending the
  1929.   message.  It can be toggled with the toggle-unlink command (default:
  1930.   u).  The next field is the MIME content-type, and can be changed with
  1931.   the edit-type command (default: ^T).  The next field is the encoding
  1932.   for the attachment, which allows a binary message to be encoded for
  1933.   transmission on 7bit links.  It can be changed with the edit-encoding
  1934.   command (default: ^E).  The next field is the size of the attachment,
  1935.   rounded to kilobytes or megabytes.  The next field is the filename,
  1936.   which can be changed with the rename-file command (default: R).  The
  1937.   final field is the description of the attachment, and can be changed
  1938.   with the edit-description command (default: d).
  1939.  
  1940.   5.2.  MIME Type configuration with mime.types
  1941.  
  1942.   When you add an attachment to your mail message, Mutt searches your
  1943.   personal mime.types file at ${HOME}/.mime.types, and then the system
  1944.   mime.types file at /usr/local/share/mutt/mime.types or /etc/mime.types
  1945.  
  1946.   The mime.types file consist of lines containing a MIME type and a
  1947.   space separated list of extensions.  For example:
  1948.  
  1949.        application/postscript          ps eps
  1950.        application/pgp                 pgp
  1951.        audio/x-aiff                    aif aifc aiff
  1952.  
  1953.   A sample mime.types file comes with the Mutt distribution, and should
  1954.   contain most of the MIME types you are likely to use.
  1955.  
  1956.   If Mutt can not determine the mime type by the extension of the file
  1957.   you attach, it will look at the file.  If the file is free of binary
  1958.   information, Mutt will assume that the file is plain text, and mark it
  1959.   as text/plain.  If the file contains binary information, then Mutt
  1960.   will mark it as application/octect-stream.  You can change the MIME
  1961.   type that Mutt assigns to an attachment by using the edit-type command
  1962.   from the compose menu (default: ^T).  When typing in the MIME type,
  1963.   Mutt requires that major type be one of the 5 types: application,
  1964.   text, image, video, or audio.  If you attempt to use a different major
  1965.   type, Mutt will abort the change.
  1966.  
  1967.   5.3.  MIME Viewer configuration with mailcap
  1968.  
  1969.   Mutt supports RFC 1524 MIME Configuration, in particular the Unix
  1970.   specific format specified in Appendix A of RFC 1524.  This file format
  1971.   is commonly referred to as the mailcap format.  Many MIME compliant
  1972.   programs utilize the mailcap format, allowing you to specify handling
  1973.   for all MIME types in one place for all programs.  Programs known to
  1974.   use this format include Netscape, XMosaic, lynx and metamail.
  1975.  
  1976.   In order to handle various MIME types that Mutt can not handle
  1977.   internally, Mutt parses a series of external configuration files to
  1978.   find an external handler.  The default search string for these files
  1979.   is a colon delimited list set to
  1980.  
  1981.        ${HOME}/.mailcap:/usr/local/share/mutt/mailcap:/etc/mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
  1982.  
  1983.   where $HOME is your home directory.
  1984.  
  1985.   In particular, the metamail distribution will install a mailcap file,
  1986.   usually as /usr/local/etc/mailcap, which contains some baseline
  1987.   entries.
  1988.  
  1989.   5.3.1.  The Basics of the mailcap file
  1990.  
  1991.   A mailcap file consists of a series of lines which are comments,
  1992.   blank, or definitions.
  1993.  
  1994.   A comment line consists of a # character followed by anything you
  1995.   want.
  1996.   A blank line is blank.
  1997.  
  1998.   A definition line consists of a content type, a view command, and any
  1999.   number of optional fields.  Each field of a definition line is divided
  2000.   by a semicolon ';' character.
  2001.  
  2002.   The content type is specified in the MIME standard type/subtype
  2003.   method.  For example, text/plain, text/html, image/gif, etc.  In
  2004.   addition, the mailcap format includes two formats for wildcards, one
  2005.   using the special '*' subtype, the other is the implicit wild, where
  2006.   you only include the major type.  For example, image/*, or video, will
  2007.   match all image types and video types, respectively.
  2008.  
  2009.   The view command is a Unix command for viewing the type specified.
  2010.   There are two different types of commands supported. The default is to
  2011.   send the body of the MIME message to the command on stdin. You can
  2012.   change this behaviour by using %s as a parameter to your view command.
  2013.   This will cause Mutt to save the body of the MIME message to a
  2014.   temporary file, and then call the view command with the %s replaced by
  2015.   the name of the temporary file. In both cases, Mutt will turn over the
  2016.   terminal to the view program until the program quits, at which time
  2017.   Mutt will remove the temporary file if it exists.
  2018.  
  2019.   So, in the simplest form, you can send a text/plain message to the
  2020.   external pager more on stdin:
  2021.  
  2022.        text/plain; more
  2023.  
  2024.   Or, you could send the message as a file:
  2025.  
  2026.        text/plain; more %s
  2027.  
  2028.   Perhaps you would like to use lynx to interactively view a text/html
  2029.   message:
  2030.  
  2031.        text/html; lynx %s
  2032.  
  2033.   In this case, lynx does not support viewing a file from stdin, so you
  2034.   must use the %s syntax.  Note: Some older versions of lynx contain a
  2035.   bug where they will check the mailcap file for a viewer for text/html.
  2036.   They will find the line which calls lynx, and run it.  This causes
  2037.   lynx to continuously spawn itself to view the object.
  2038.  
  2039.   On the other hand, maybe you don't want to use lynx interactively, you
  2040.   just want to have it convert the text/html to text/plain, then you can
  2041.   use:
  2042.  
  2043.        text/html; lynx -dump %s | more
  2044.  
  2045.   Perhaps you wish to use lynx to view text/html files, and a pager on
  2046.   all other text formats, then you would use the following:
  2047.  
  2048.        text/html; lynx %s
  2049.        text/*; more
  2050.  
  2051.   This is the simplest form of a mailcap file.
  2052.  
  2053.   5.3.2.  Secure use of mailcap
  2054.  
  2055.   The interpretion of shell meta-characters embedded in MIME parameters
  2056.   can lead to security problems in general.  Mutt tries to quote
  2057.   parameters in expansion of %s syntaxes properly, and avoids risky
  2058.   characters by substituting them, see the ``mailcap_sanitize''
  2059.   variable.
  2060.  
  2061.   Although mutt's procedures to invoke programs with mailcap seem to be
  2062.   safe, there are other applications parsing mailcap, maybe taking less
  2063.   care of it.  Therefore you should pay attention to the following
  2064.   rules:
  2065.  
  2066.   Keep the %-expandos away from shell quoting.  Don't quote them with
  2067.   single or double quotes.  Mutt does this for you, the right way, as
  2068.   should any other program which interprets mailcap.  Don't put them
  2069.   into backtick expansions.  Be highly careful with eval statements, and
  2070.   avoid them if possible at all.  Trying to fix broken behaviour with
  2071.   quotes introduces new leaks - there is no alternative to correct
  2072.   quoting in the first place.
  2073.  
  2074.   If you have to use the %-expandos' values in context where you need
  2075.   quoting or backtick expansions, put that value into a shell variable
  2076.   and reference the shell variable where necessary, as in the following
  2077.   example (using $charset inside the backtick expansion is safe, since
  2078.   it is not itself subject to any further expansion):
  2079.  
  2080.        text/test-mailcap-bug; cat %s; copiousoutput; test=charset=%{charset} \
  2081.                && test "`echo $charset | tr '[A-Z]' '[a-z]'`" != iso-8859-1
  2082.  
  2083.   5.3.3.  Advanced mailcap Usage
  2084.  
  2085.   5.3.3.1.  Optional Fields
  2086.  
  2087.   In addition to the required content-type and view command fields, you
  2088.   can add semi-colon ';' separated fields to set flags and other
  2089.   options.  Mutt recognizes the following optional fields:
  2090.  
  2091.      copiousoutput
  2092.         This flag tells Mutt that the command passes possibly large
  2093.         amounts of text on stdout.  This causes Mutt to invoke a pager
  2094.         (either the internal pager or the external pager defined by the
  2095.         pager variable) on the output of the view command.  Without this
  2096.         flag, Mutt assumes that the command is interactive.  One could
  2097.         use this to replace the pipe to more in the lynx -dump example
  2098.         in the Basic section:
  2099.  
  2100.           text/html; lynx -dump %s ; copiousoutput
  2101.  
  2102.      This will cause lynx to format the text/html output as text/plain
  2103.      and Mutt will use your standard pager to display the results.
  2104.  
  2105.      needsterminal
  2106.         Mutt uses this flag when viewing attachments with ``autoview'',
  2107.         in order to decide whether it should honor the setting of the
  2108.         ``$wait_key'' variable or not.  When an attachment is viewed
  2109.         using an interactive program, and the corresponding mailcap
  2110.         entry has a needsterminal flag, Mutt will use ``$wait_key'' and
  2111.         the exit status of the program to decide if it will ask you to
  2112.         press a key after the external program has exited.  In all other
  2113.         situations it will not prompt you for a key.
  2114.  
  2115.      compose=<command>
  2116.         This flag specifies the command to use to create a new
  2117.         attachment of a specific MIME type.  Mutt supports this from the
  2118.         compose menu.
  2119.  
  2120.      composetyped=<command>
  2121.         This flag specifies the command to use to create a new
  2122.         attachment of a specific MIME type.  This command differs from
  2123.         the compose command in that mutt will expect standard MIME
  2124.         headers on the data.  This can be used to specify parameters,
  2125.         filename, description, etc. for a new attachment.   Mutt
  2126.         supports this from the compose menu.
  2127.  
  2128.      print=<command>
  2129.         This flag specifies the command to use to print a specific MIME
  2130.         type.  Mutt supports this from the attachment and compose menus.
  2131.  
  2132.      edit=<command>
  2133.         This flag specifies the command to use to edit a specific MIME
  2134.         type.  Mutt supports this from the compose menu, and also uses
  2135.         it to compose new attachments.  Mutt will default to the defined
  2136.         editor for text attachments.
  2137.  
  2138.      nametemplate=<template>
  2139.         This field specifies the format for the file denoted by %s in
  2140.         the command fields.  Certain programs will require a certain
  2141.         file extension, for instance, to correctly view a file.  For
  2142.         instance, lynx will only interpret a file as text/html if the
  2143.         file ends in .html.  So, you would specify lynx as a text/html
  2144.         viewer with a line in the mailcap file like:
  2145.  
  2146.           text/html; lynx %s; nametemplate=%s.html
  2147.  
  2148.      test=<command>
  2149.         This field specifies a command to run to test whether this
  2150.         mailcap entry should be used.  The command is defined with the
  2151.         command expansion rules defined in the next section.  If the
  2152.         command returns 0, then the test passed, and Mutt uses this
  2153.         entry.  If the command returns non-zero, then the test failed,
  2154.         and Mutt continues searching for the right entry.  Note: the
  2155.         content-type must match before Mutt performs the test.  For
  2156.         example:
  2157.  
  2158.           text/html; netscape -remote 'openURL(%s)' ; test=RunningX
  2159.           text/html; lynx %s
  2160.  
  2161.      In this example, Mutt will run the program RunningX which will
  2162.      return 0 if the X Window manager is running, and non-zero if it
  2163.      isn't.  If RunningX returns 0, then Mutt will call netscape to dis­
  2164.      play the text/html object.  If RunningX doesn't return 0, then Mutt
  2165.      will go on to the next entry and use lynx to display the text/html
  2166.      object.
  2167.  
  2168.   5.3.3.2.  Search Order
  2169.  
  2170.   When searching for an entry in the mailcap file, Mutt will search for
  2171.   the most useful entry for its purpose.  For instance, if you are
  2172.   attempting to print an image/gif, and you have the following entries
  2173.   in your mailcap file, Mutt will search for an entry with the print
  2174.   command:
  2175.  
  2176.        image/*;        xv %s
  2177.        image/gif;      ; print= anytopnm %s | pnmtops | lpr; \
  2178.                        nametemplate=%s.gif
  2179.  
  2180.   Mutt will skip the image/* entry and use the image/gif entry with the
  2181.   print command.
  2182.  
  2183.   In addition, you can use this with ``Autoview'' to denote two commands
  2184.   for viewing an attachment, one to be viewed automatically, the other
  2185.   to be viewed interactively from the attachment menu.  In addition, you
  2186.   can then use the test feature to determine which viewer to use
  2187.   interactively depending on your environment.
  2188.  
  2189.        text/html;      netscape -remote 'openURL(%s)' ; test=RunningX
  2190.        text/html;      lynx %s; nametemplate=%s.html
  2191.        text/html;      lynx -dump %s; nametemplate=%s.html; copiousoutput
  2192.  
  2193.   For ``Autoview'', Mutt will choose the third entry because of the
  2194.   copiousoutput tag.  For interactive viewing, Mutt will run the program
  2195.   RunningX to determine if it should use the first entry.  If the pro­
  2196.   gram returns non-zero, Mutt will use the second entry for interactive
  2197.   viewing.
  2198.  
  2199.   5.3.3.3.  Command Expansion
  2200.  
  2201.   The various commands defined in the mailcap files are passed to the
  2202.   /bin/sh shell using the system() function.  Before the command is
  2203.   passed to /bin/sh -c, it is parsed to expand various special
  2204.   parameters with information from Mutt.  The keywords Mutt expands are:
  2205.  
  2206.      %s As seen in the basic mailcap section, this variable is expanded
  2207.         to a filename specified by the calling program.  This file
  2208.         contains the body of the message to view/print/edit or where the
  2209.         composing program should place the results of composition.  In
  2210.         addition, the use of this keyword causes Mutt to not pass the
  2211.         body of the message to the view/print/edit program on stdin.
  2212.  
  2213.      %t Mutt will expand %t to the text representation of the content
  2214.         type of the message in the same form as the first parameter of
  2215.         the mailcap definition line, ie text/html or image/gif.
  2216.  
  2217.      %{<parameter>}
  2218.         Mutt will expand this to the value of the specified parameter
  2219.         from the Content-Type: line of the mail message.  For instance,
  2220.         if Your mail message contains:
  2221.  
  2222.           Content-Type: text/plain; charset=iso-8859-1
  2223.  
  2224.      then Mutt will expand %{charset} to iso-8859-1.  The default meta­
  2225.      mail mailcap file uses this feature to test the charset to spawn an
  2226.      xterm using the right charset to view the message.
  2227.  
  2228.      \% This will be replaced by a %
  2229.  
  2230.   Mutt does not currently support the %F and %n keywords specified in
  2231.   RFC 1524.  The main purpose of these parameters is for multipart mes­
  2232.   sages, which is handled internally by Mutt.
  2233.  
  2234.   5.3.4.  Example mailcap files
  2235.  
  2236.   This mailcap file is fairly simple and standard:
  2237.  
  2238.   ______________________________________________________________________
  2239.   # I'm always running X :)
  2240.   video/*;        xanim %s > /dev/null
  2241.   image/*;        xv %s > /dev/null
  2242.  
  2243.   # I'm always running netscape (if my computer had more memory, maybe)
  2244.   text/html;      netscape -remote 'openURL(%s)'
  2245.   ______________________________________________________________________
  2246.  
  2247.   This mailcap file shows quite a number of examples:
  2248.  
  2249.   ______________________________________________________________________
  2250.   # Use xanim to view all videos   Xanim produces a header on startup,
  2251.   # send that to /dev/null so I don't see it
  2252.   video/*;        xanim %s > /dev/null
  2253.  
  2254.   # Send html to a running netscape by remote
  2255.   text/html;      netscape -remote 'openURL(%s)'; test=RunningNetscape
  2256.  
  2257.   # If I'm not running netscape but I am running X, start netscape on the
  2258.   # object
  2259.   text/html;      netscape %s; test=RunningX
  2260.  
  2261.   # Else use lynx to view it as text
  2262.   text/html;      lynx %s
  2263.  
  2264.   # This version would convert the text/html to text/plain
  2265.   text/html;      lynx -dump %s; copiousoutput
  2266.  
  2267.   # enriched.sh converts text/enriched to text/html and then uses
  2268.   # lynx -dump to convert it to text/plain
  2269.   text/enriched;  enriched.sh ; copiousoutput
  2270.  
  2271.   # I use enscript to print text in two columns to a page
  2272.   text/*;         more %s; print=enscript -2Gr %s
  2273.  
  2274.   # Netscape adds a flag to tell itself to view jpegs internally
  2275.   image/jpeg;xv %s; x-mozilla-flags=internal
  2276.  
  2277.   # Use xv to view images if I'm running X
  2278.   # In addition, this uses the \ to extend the line and set my editor
  2279.   # for images
  2280.   image/*;xv %s; test=RunningX; \
  2281.           edit=xpaint %s
  2282.  
  2283.   # Convert images to text using the netpbm tools
  2284.   image/*;  (anytopnm %s | pnmscale -xysize 80 46 | ppmtopgm | pgmtopbm |
  2285.   pbmtoascii -1x2 ) 2>&1 ; copiousoutput
  2286.  
  2287.   # Send excel spreadsheets to my NT box
  2288.   application/ms-excel; open.pl %s
  2289.   ______________________________________________________________________
  2290.  
  2291.   5.4.  MIME Autoview
  2292.  
  2293.   In addition to explicitly telling Mutt to view an attachment with the
  2294.   MIME viewer defined in the mailcap file, Mutt has support for
  2295.   automatically viewing MIME attachments while in the pager.
  2296.  
  2297.   To work, you must define a viewer in the mailcap file which uses the
  2298.   copiousoutput option to denote that it is non-interactive.  Usually,
  2299.   you also use the entry to convert the attachment to a text
  2300.   representation which you can view in the pager.
  2301.  
  2302.   You then use the auto_view muttrc command to list the content-types
  2303.   that you wish to view automatically.
  2304.  
  2305.   For instance, if you set auto_view to:
  2306.  
  2307.        auto_view text/html text/enriched application/x-gunzip application/postscript image/gif application/x-tar-gz
  2308.  
  2309.   Mutt could use the following mailcap entries to automatically view
  2310.   attachments of these types.
  2311.  
  2312.        text/html;      lynx -dump %s; copiousoutput; nametemplate=%s.html
  2313.        text/enriched;  enriched.sh  ; copiousoutput
  2314.        image/*;        anytopnm %s | pnmscale -xsize 80 -ysize 50 | ppmtopgm | pgmtopbm | pbmtoascii ; copiousoutput
  2315.        application/x-gunzip;   gzcat; copiousoutput
  2316.        application/x-tar-gz; gunzip -c %s | tar -tf - ; copiousoutput
  2317.        application/postscript; ps2ascii %s; copiousoutput
  2318.  
  2319.   5.5.  MIME Multipart/Alternative
  2320.  
  2321.   Mutt has some heuristics for determining which attachment of a
  2322.   multipart/alternative type to display.  First, mutt will check the
  2323.   alternative_order list to determine if one of the available types is
  2324.   preferred.  The alternative_order list consists of a number of
  2325.   mimetypes in order, including support for implicit and explicit
  2326.   wildcards, for example:
  2327.  
  2328.        alternative_order text/enriched text/plain text application/postscript image/*
  2329.  
  2330.   Next, mutt will check if any of the types have a defined
  2331.   ``auto_view'', and use that.  Failing that, Mutt will look for any
  2332.   text type.  As a last attempt, mutt will look for any type it knows
  2333.   how to handle.
  2334.  
  2335.   6.  Reference
  2336.  
  2337.   6.1.  Command line options
  2338.  
  2339.   Running mutt with no arguments will make Mutt attempt to read your
  2340.   spool mailbox.  However, it is possible to read other mailboxes and to
  2341.   send messages from the command line as well.
  2342.  
  2343.        -a      attach a file to a message
  2344.        -c      specify a carbon-copy (Cc) address
  2345.        -e      specify a config command to be run after initilization files are read
  2346.        -F      specify an alternate file to read initialization commands
  2347.        -f      specify a mailbox to load
  2348.        -h      print help on command line options
  2349.        -H      specify a draft file from which to read a header and body
  2350.        -i      specify a file to include in a message composition
  2351.        -n      do not read the system Muttrc
  2352.        -m      specify a default mailbox type
  2353.        -p      recall a postponed message
  2354.        -R      open mailbox in read-only mode
  2355.        -s      specify a subject (enclose in quotes if it contains spaces)
  2356.        -v      show version number and compile-time definitions
  2357.        -x      simulate the mailx(1) compose mode
  2358.        -y      show a menu containing the files specified by the mailboxes command
  2359.        -z      exit immediately if there are no messages in the mailbox
  2360.        -Z      open the first folder with new message,exit immediately if none
  2361.  
  2362.   To read messages in a mailbox
  2363.  
  2364.   mutt [ -nz ] [ -F muttrc ] [ -m type ] [ -f mailbox ]
  2365.  
  2366.   To compose a new message
  2367.  
  2368.   mutt [ -n ] [ -F muttrc ] [ -a file ] [ -c address ] [ -i filename ] [
  2369.   -s subject ] address [ address ... ]
  2370.  
  2371.   Mutt also supports a ``batch'' mode to send prepared messages.  Simply
  2372.   redirect input from the file you wish to send.  For example,
  2373.  
  2374.   mutt -s "data set for run #2" professor@bigschool.edu < ~/run2.dat
  2375.  
  2376.   This command will send a message to ``professor@bigschool.edu'' with a
  2377.   subject of ``data set for run #2''.  In the body of the message will
  2378.   be the contents of the file ``~/run2.dat''.
  2379.  
  2380.   6.2.  Configuration Commands
  2381.  
  2382.   The following are the commands understood by mutt.
  2383.  
  2384.   ·  ``alias'' key address [ , address, ... ]
  2385.  
  2386.   ·  ``unalias'' key address [ , address, ... ]
  2387.  
  2388.   ·  ``alternative_order'' mimetype [ mimetype ... ]
  2389.  
  2390.   ·  ``auto_view'' mimetype [ mimetype ... ]
  2391.  
  2392.   ·  ``bind'' map key function
  2393.  
  2394.   ·  ``color'' object foreground background [ regexp ]
  2395.  
  2396.   ·  ``folder-hook'' pattern command
  2397.  
  2398.   ·  ``ignore'' pattern [ pattern ... ]
  2399.  
  2400.   ·  ``unignore'' pattern [ pattern ... ]
  2401.  
  2402.   ·  ``hdr_order'' header [ header ... ]
  2403.  
  2404.   ·  ``unhdr_order'' header [ header ... ]
  2405.  
  2406.   ·  ``lists'' address [ address ... ]
  2407.  
  2408.   ·  ``unlists'' address [ address ... ]
  2409.  
  2410.   ·  ``macro'' menu key sequence
  2411.  
  2412.   ·  ``mailboxes'' filename [ filename ... ]
  2413.  
  2414.   ·  ``mono'' object attribute [ regexp ]
  2415.  
  2416.   ·  ``mbox-hook'' pattern mailbox
  2417.  
  2418.   ·  ``my_hdr'' string
  2419.  
  2420.   ·  ``unmy_hdr'' field [ field ... ]
  2421.  
  2422.   ·  ``push'' string
  2423.  
  2424.   ·  ``save-hook'' regexp filename
  2425.  
  2426.   ·  ``send-hook'' regexp command
  2427.  
  2428.   ·  ``set'' [no|inv]variable[=value] [ variable ... ]
  2429.  
  2430.   ·  ``toggle'' variable [variable ... ]
  2431.  
  2432.   ·  ``unset'' variable [variable ... ]
  2433.  
  2434.   ·  ``source'' filename
  2435.  
  2436.   6.3.  Configuration variables
  2437.  
  2438.   6.3.1.  abort_nosubject
  2439.  
  2440.   Type: quadoption
  2441.   Default: ask-yes
  2442.  
  2443.   If set to yes, when composing messages and no subject is given at the
  2444.   subject prompt, composition will be aborted.  If set to no, composing
  2445.   messages with no subject given at the subject prompt will never be
  2446.   aborted.
  2447.  
  2448.   6.3.2.  abort_unmodified
  2449.  
  2450.   Type: quadoption
  2451.   Default: yes
  2452.  
  2453.   If set to yes, composition will automatically abort after editing the
  2454.   message body if no changes are made to the file (this check only
  2455.   happens after the first edit of the file).  When set to no,
  2456.   composition will never be aborted.
  2457.  
  2458.   6.3.3.  alias_file
  2459.  
  2460.   Type: path
  2461.   Default: " /.muttrc"
  2462.  
  2463.   The default file in which to save aliases created by the ``create-
  2464.   alias'' function.
  2465.  
  2466.   Note: Mutt will not automatically source this file; you must
  2467.   explicitly use the ``source'' command for it to be executed.
  2468.  
  2469.   6.3.4.  alias_format
  2470.  
  2471.   Type: string
  2472.   Default: "%4n %t %-10a   %r"
  2473.  
  2474.   Specifies the format of the data displayed for the `alias' menu.  The
  2475.   following printf(3)-style sequences are available:
  2476.  
  2477.        %a      alias name
  2478.        %n      index number
  2479.        %r      address which alias expands to
  2480.        %t      character which indicates if the alias is
  2481.                tagged for inclusion
  2482.  
  2483.   6.3.5.  allow_8bit
  2484.  
  2485.   Type: boolean
  2486.   Default: yes
  2487.  
  2488.   Controls whether 8-bit data is converted to 7-bit using either Quoted-
  2489.   Printable or Base64 encoding when sending mail.
  2490.  
  2491.   6.3.6.  alternates
  2492.  
  2493.   Type: regular expression
  2494.   Default: ""
  2495.  
  2496.   A regexp that allows you to specify alternate addresses where you
  2497.   receive mail.  This affects Mutt's idea about messages from you and
  2498.   addressed to you.
  2499.  
  2500.   6.3.7.  arrow_cursor
  2501.  
  2502.   Type: boolean
  2503.   Default: no
  2504.  
  2505.   When set, an arrow (``->'') will be used to indicate the current entry
  2506.   in menus instead of hiliting the whole line.  On slow network or modem
  2507.   links this will make response faster because there is less that has to
  2508.   be redrawn on the screen when moving to the next or previous entries
  2509.   in the menu.
  2510.  
  2511.   6.3.8.  ascii_chars
  2512.  
  2513.   Type: boolean
  2514.   Default: no
  2515.  
  2516.   If set, Mutt will use plain ASCII characters when displaying thread
  2517.   and attachment trees, instead of the default ACS characters.
  2518.  
  2519.   6.3.9.  askbcc
  2520.  
  2521.   Type: boolean
  2522.   Default: no
  2523.  
  2524.   If set, Mutt will prompt you for blind-carbon-copy (Bcc) recipients
  2525.   before editing an outgoing message.
  2526.   6.3.10.  askcc
  2527.  
  2528.   Type: boolean
  2529.   Default: no
  2530.  
  2531.   If set, Mutt will prompt you for carbon-copy (Cc) recipients before
  2532.   editing the body of an outgoing message.
  2533.  
  2534.   6.3.11.  attach_format
  2535.  
  2536.   Type: string
  2537.   Default: "%u%D%t%4n %T%.40d%> [%.7m/%.10M, %.6e%?C?, %C?, %s] "
  2538.  
  2539.   This variable describes the format of the `attachment' menu.  The
  2540.   following printf-style sequences are understood:
  2541.  
  2542.        %D      deleted flag
  2543.        %d      description
  2544.        %e      MIME content-transfer-encoding
  2545.        %f      filename
  2546.        %m      major MIME type
  2547.        %M      MIME subtype
  2548.        %n      attachment number
  2549.        %s      size
  2550.        %t      tagged flag
  2551.        %u      unlink (=to delete) flag
  2552.        %>X     right justify the rest of the
  2553.                string and pad with character "X"
  2554.        %|X     pad to the end of the line with
  2555.                character "X"
  2556.  
  2557.   6.3.12.  attach_sep
  2558.  
  2559.   Type: string
  2560.   Default: "\n"
  2561.  
  2562.   The separator to add between attachments when operating (saving,
  2563.   printing, piping, etc) on a list of tagged attachments.
  2564.  
  2565.   6.3.13.  attach_split
  2566.  
  2567.   Type: boolean
  2568.   Default: yes
  2569.  
  2570.   If this variable is unset, when operating (saving, printing, piping,
  2571.   etc) on a list of tagged attachments, Mutt will concatenate the
  2572.   attachments and will operate on them as a single attachment. The
  2573.   ``attach_sep'' separator is added after each attachment. When set,
  2574.   Mutt will operate on the attachments one by one.
  2575.  
  2576.   6.3.14.  attribution
  2577.  
  2578.   Type: string
  2579.   Default: "On %d, %n wrote:"
  2580.  
  2581.   This is the string that will precede a message which has been included
  2582.   in a reply.  For a full listing of defined escape sequences see the
  2583.   section on ``index_format''.
  2584.  
  2585.   6.3.15.  autoedit
  2586.  
  2587.   Type: boolean
  2588.   Default: no
  2589.  
  2590.   When set, Mutt will skip the initial send-menu and allow you to
  2591.   immediately begin editing the body of your message when replying to
  2592.   another message.  The send-menu may still be accessed once you have
  2593.   finished editing the body of your message.
  2594.  
  2595.   If the ``edit_headers'' variable is also set, the initial prompts in
  2596.   the send-menu are always skipped, even when composing a new message.
  2597.  
  2598.   6.3.16.  auto_tag
  2599.  
  2600.   Type: boolean
  2601.   Default: no
  2602.  
  2603.   When set, functions in the index menu which affect a message will be
  2604.   applied to all tagged messages (if there are any).  When unset, you
  2605.   must first use the tag-prefix function (default: ";") to make the next
  2606.   function apply to all tagged messages.
  2607.  
  2608.   6.3.17.  beep
  2609.  
  2610.   Type: boolean
  2611.   Default: yes
  2612.  
  2613.   When this variable is set, mutt will beep when an error occurs.
  2614.  
  2615.   6.3.18.  beep_new
  2616.  
  2617.   Type: boolean
  2618.   Default: no
  2619.  
  2620.   When this variable is set, mutt will beep whenever it prints a message
  2621.   notifying you of new mail.  This is independent of the setting of the
  2622.   ``beep'' variable.
  2623.  
  2624.   6.3.19.  bounce_delivered
  2625.  
  2626.   Type: boolean
  2627.   Default: yes
  2628.  
  2629.   When this variable is set, mutt will include Delivered-To headers when
  2630.   bouncing messages.  Postfix users may wish to unset this variable.
  2631.  
  2632.   6.3.20.  charset
  2633.  
  2634.   Type: string
  2635.   Default: "iso-8859-1"
  2636.  
  2637.   Character set your terminal uses to display and enter textual data.
  2638.  
  2639.   6.3.21.  check_new
  2640.  
  2641.   Type: boolean
  2642.   Default: yes
  2643.  
  2644.   Note: this option only affects maildir and MH style mailboxes.
  2645.  
  2646.   When set, Mutt will check for new mail delivered while the mailbox is
  2647.   open.  Especially with MH mailboxes, this operation can take quite
  2648.   some time since it involves scanning the directory and checking each
  2649.   file to see if it has already been looked at.  If check_new is unset,
  2650.   no check for new mail is performed while the mailbox is open.
  2651.  
  2652.   6.3.22.  collapse_unread
  2653.  
  2654.   Type: boolean
  2655.   Default: yes
  2656.  
  2657.   When unset, Mutt will not collapse a thread if it contains any unread
  2658.   messages.
  2659.  
  2660.   6.3.23.  uncollapse_jump
  2661.  
  2662.   Type: boolean
  2663.   Default: no
  2664.  
  2665.   When set, Mutt will jump to the next unread message, if any, when the
  2666.   current thread is uncollapsed.
  2667.  
  2668.   6.3.24.  confirmappend
  2669.  
  2670.   Type: boolean
  2671.   Default: yes
  2672.  
  2673.   When set, Mutt will prompt for confirmation when appending messages to
  2674.   an existing mailbox.
  2675.  
  2676.   6.3.25.  confirmcreate
  2677.  
  2678.   Type: boolean
  2679.   Default: yes
  2680.  
  2681.   When set, Mutt will prompt for confirmation when saving messages to a
  2682.   mailbox which does not yet exist before creating it.
  2683.  
  2684.   6.3.26.  copy
  2685.  
  2686.   Type: quadoption
  2687.   Default: yes
  2688.  
  2689.   This variable controls whether or not copies of your outgoing messages
  2690.   will be saved for later references.  Also see ``record'',
  2691.   ``save_name'', ``force_name'' and ``fcc-hook''.
  2692.  
  2693.   6.3.27.  date_format
  2694.  
  2695.   Type: string
  2696.   Default: "!%a, %b %d, %Y at %I:%M:%S%p %Z"
  2697.  
  2698.   This variable controls the format of the date printed by the ``%d''
  2699.   sequence in ``index_format''.  This is passed to the strftime call to
  2700.   process the date. See the man page for strftime(3) for the proper
  2701.   syntax.
  2702.  
  2703.   Unless the first character in the string is a bang (``!''), the month
  2704.   and week day names are expanded according to the locale specified in
  2705.   the variable ``locale''. If the first character in the string is a
  2706.   bang, the bang is discarded, and the month and week day names in the
  2707.   rest of the string are expanded in the C locale (that is in US
  2708.   English).
  2709.  
  2710.   6.3.28.  default_hook
  2711.  
  2712.   Type: string
  2713.   Default: " f %s ! P | ( P  C %s)"
  2714.  
  2715.   This variable controls how send-hooks, save-hooks, and fcc-hooks will
  2716.   be interpreted if they are specified with only a simple regexp,
  2717.   instead of a matching pattern.  The hooks are expanded when they are
  2718.   declared, so a hook will be interpreted according to the value of this
  2719.   variable at the time the hook is declared.  The default value matches
  2720.   if the message is either from a user matching the regular expression
  2721.   given, or if it is from you (if the from address matches
  2722.   ``alternates'') and is to or cc'ed to a user matching the given
  2723.   regular expression.
  2724.  
  2725.   6.3.29.  delete
  2726.  
  2727.   Type: quadoption
  2728.   Default: ask-yes
  2729.  
  2730.   Controls whether or not messages are really deleted when closing or
  2731.   synchronizing a mailbox.  If set to yes, messages marked for deleting
  2732.   will automatically be purged without prompting.  If set to no,
  2733.   messages marked for deletion will be kept in the mailbox.
  2734.  
  2735.   6.3.30.  delete_untag
  2736.  
  2737.   Type: boolean
  2738.   Default: yes
  2739.  
  2740.   If this option is set, mutt will untag messages when marking them for
  2741.   deletion.  This applies when you either explicitly delete a message,
  2742.   or when you save it to another folder.
  2743.  
  2744.   6.3.31.  dotlock_program
  2745.  
  2746.   Type: path
  2747.   Default: "/usr/local/bin/mutt_dotlock"
  2748.  
  2749.   Contains the path of the mutt_dotlock (8) binary to be used by mutt.
  2750.  
  2751.   6.3.32.  dsn_notify
  2752.  
  2753.   Type: string
  2754.   Default: ""
  2755.  
  2756.   Note: you should not enable this unless you are using Sendmail 8.8.x
  2757.   or greater.
  2758.  
  2759.   This variable sets the request for when notification is returned.  The
  2760.   string consists of a comma separated list (no spaces!) of one or more
  2761.   of the following: never, to never request notification, failure, to
  2762.   request notification on transmission failure, delay, to be notified of
  2763.   message delays, success, to be notified of successful transmission.
  2764.  
  2765.   Example: set dsn_notify="failure,delay"
  2766.  
  2767.   6.3.33.  dsn_return
  2768.  
  2769.   Type: string
  2770.   Default: ""
  2771.  
  2772.   Note: you should not enable this unless you are using Sendmail 8.8.x
  2773.   or greater.
  2774.  
  2775.   This variable controls how much of your message is returned in DSN
  2776.   messages.  It may be set to either hdrs to return just the message
  2777.   header, or full to return the full message.
  2778.   Example: set dsn_return=hdrs
  2779.  
  2780.   6.3.34.  edit_headers
  2781.  
  2782.   Type: boolean
  2783.   Default: no
  2784.  
  2785.   This option allows you to edit the header of your outgoing messages
  2786.   along with the body of your message.
  2787.  
  2788.   6.3.35.  editor
  2789.  
  2790.   Type: path
  2791.   Default: ""
  2792.  
  2793.   This variable specifies which editor is used by mutt.  It defaults to
  2794.   the value of the EDITOR or VISUAL environment variable, or to the
  2795.   string "vi".
  2796.  
  2797.   6.3.36.  encode_from
  2798.  
  2799.   Type: boolean
  2800.   Default: no
  2801.  
  2802.   When set, mutt will quoted-printable encode messages when they contain
  2803.   the string "From " in the beginning of a line.  Useful to avoid the
  2804.   tampering certain mail delivery and transport agents tend to do with
  2805.   messages.
  2806.  
  2807.   6.3.37.  escape
  2808.  
  2809.   Type: string
  2810.   Default: " "
  2811.  
  2812.   Escape character to use for functions in the builtin editor.
  2813.  
  2814.   6.3.38.  fast_reply
  2815.  
  2816.   Type: boolean
  2817.   Default: no
  2818.  
  2819.   When set, the initial prompt for recipients and subject are skipped
  2820.   when replying to messages, and the initial prompt for subject is
  2821.   skipped when forwarding messages.
  2822.  
  2823.   Note: this variable has no effect when the ``autoedit'' variable is
  2824.   set.
  2825.  
  2826.   6.3.39.  fcc_attach
  2827.  
  2828.   Type: boolean
  2829.   Default: yes
  2830.  
  2831.   This variable controls whether or not attachments on outgoing messages
  2832.   are saved along with the main body of your message.
  2833.  
  2834.   6.3.40.  folder
  2835.  
  2836.   Type: path
  2837.   Default: " /Mail"
  2838.  
  2839.   Specifies the default location of your mailboxes.  A `+' or `=' at the
  2840.   beginning of a pathname will be expanded to the value of this
  2841.   variable.  Note that if you change this variable from the default
  2842.   value you need to make sure that the assignment occurs before you use
  2843.   `+' or `=' for any other variables since expansion takes place during
  2844.   the `set' command.
  2845.  
  2846.   6.3.41.  folder_format
  2847.  
  2848.   Type: string
  2849.   Default: "%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f"
  2850.  
  2851.   This variable allows you to customize the file browser display to your
  2852.   personal taste.  This string is similar to ``index_format'', but has
  2853.   its own set of printf()-like sequences:
  2854.  
  2855.        %C      current file number
  2856.        %d      date/time folder was last modified
  2857.        %f      filename
  2858.        %F      file permissions
  2859.        %g      group name (or numeric gid, if missing)
  2860.        %l      number of hard links
  2861.        %N      N if folder has new mail, blank otherwise
  2862.        %s      size in bytes
  2863.        %t      * if the file is tagged, blank otherwise
  2864.        %u      owner name (or numeric uid, if missing)
  2865.        %>X     right justify the rest of the string and pad
  2866.                with character "X"
  2867.        %|X     pad to the end of the line with character "X"
  2868.  
  2869.   6.3.42.  followup_to
  2870.  
  2871.   Type: boolean
  2872.   Default: yes
  2873.  
  2874.   Controls whether or not the Mail-Followup-To header field is generated
  2875.   when sending mail.  When set, Mutt will generate this field when you
  2876.   are replying to a known mailing ``lists''.
  2877.   The purpose of this field is to prevent you from receiving duplicate
  2878.   copies of replies to messages which you send by specifying that you
  2879.   will receive a copy of the message if it is addressed to the mailing
  2880.   list (and thus there is no need to also include your address in a
  2881.   group reply).
  2882.  
  2883.   6.3.43.  force_name
  2884.  
  2885.   Type: boolean
  2886.   Default: no
  2887.  
  2888.   This variable is similar to ``save_name'', except that Mutt will store
  2889.   a copy of your outgoing message by the username of the address you are
  2890.   sending to even if that mailbox does not exist.
  2891.  
  2892.   Also see the ``record'' variable.
  2893.  
  2894.   6.3.44.  forward_decode
  2895.  
  2896.   Type: boolean
  2897.   Default: yes
  2898.  
  2899.   Controls the decoding of complex MIME messages into text/plain when
  2900.   forwarding a message.  The message header is also RFC2047 decoded.
  2901.   This variable is only used, if ``mime_forward'' is unset, otherwise
  2902.   ``mime_forward_decode'' is used instead.
  2903.  
  2904.   6.3.45.  forward_format
  2905.  
  2906.   Type: string
  2907.   Default: "[%a: %s]"
  2908.  
  2909.   This variable controls the default subject when forwarding a message.
  2910.   It uses the same format sequences as the ``index_format'' variable.
  2911.  
  2912.   6.3.46.  forward_quote
  2913.  
  2914.   Type: boolean
  2915.   Default: no
  2916.  
  2917.   When set forwarded messages included in the main body of the message
  2918.   (when ``mime_forward'' is unset) will be quoted using
  2919.   ``indent_string''.
  2920.  
  2921.   6.3.47.  from
  2922.  
  2923.   Type: e-mail address
  2924.   Default: ""
  2925.  
  2926.   When set, this variable contains a default from address.  It can be
  2927.   overridden using my_hdr (including from send-hooks) and
  2928.   ``reverse_name''.
  2929.  
  2930.   6.3.48.  hdrs
  2931.  
  2932.   Type: boolean
  2933.   Default: yes
  2934.  
  2935.   When unset, the header fields normally added by the ``my_hdr'' command
  2936.   are not created.  This variable must be unset before composing a new
  2937.   message or replying in order to take effect.  If set, the user defined
  2938.   header fields are added to every new message.
  2939.  
  2940.   6.3.49.  header
  2941.  
  2942.   Type: boolean
  2943.   Default: no
  2944.  
  2945.   When set, this variable causes Mutt to include the header of the
  2946.   message you are replying to into the edit buffer.  The weed setting
  2947.   applies.
  2948.  
  2949.   6.3.50.  help
  2950.  
  2951.   Type: boolean
  2952.   Default: yes
  2953.  
  2954.   When set, help lines describing the bindings for the major functions
  2955.   provided by each menu are displayed on the first line of the screen.
  2956.  
  2957.   Note: The binding will not be displayed correctly if the function is
  2958.   bound to a sequence rather than a single keystroke.  Also, the help
  2959.   line may not be updated if a binding is changed while Mutt is running.
  2960.   Since this variable is primarily aimed at new users, neither of these
  2961.   should present a major problem.
  2962.  
  2963.   6.3.51.  hidden_host
  2964.  
  2965.   Type: boolean
  2966.   Default: no
  2967.  
  2968.   When set, mutt will skip the host name part of ``hostname'' variable
  2969.   when adding the domain part to addresses.  This variable does not
  2970.   affect the generation, and it will not lead to the cut-off of first-
  2971.   level domains.
  2972.  
  2973.   6.3.52.  history
  2974.  
  2975.   Type: number
  2976.   Default: 10
  2977.  
  2978.   This variable controls the size (in number of strings remembered) of
  2979.   the string history buffer. The buffer is cleared each time the
  2980.   variable is set.
  2981.  
  2982. +Note that, when header editing is enabled, you can create a
  2983. +Mail-Followup-To header manually.  Mutt will only auto-generate
  2984. +this header if it doesn't exist when you send the message.
  2985.  
  2986.   6.3.53.  honor_followup_to
  2987.  
  2988.   Type: quadoption
  2989.   Default: yes
  2990.  
  2991.   This variable controls whether or not a Mail-Followup-To header is
  2992.   honored when group-replying to a message.
  2993.  
  2994.   6.3.54.  hostname
  2995.  
  2996.   Type: string
  2997.   Default: ""
  2998.  
  2999.   Specifies the hostname to use after the ``@'' in local e-mail
  3000.   addresses.  This overrides the compile time definition obtained from
  3001.   /etc/resolv.conf.
  3002.  
  3003.   6.3.55.  ignore_list_reply_to
  3004.  
  3005.   Type: boolean
  3006.   Default: no
  3007.  
  3008.   Affects the behaviour of the reply function when replying to messages
  3009.   from mailing lists.  When set, if the ``Reply-To:'' field is set to
  3010.   the same value as the ``To:'' field, Mutt assumes that the ``Reply-
  3011.   To:'' field was set by the mailing list to automate responses to the
  3012.   list, and will ignore this field.  To direct a response to the mailing
  3013.   list when this option is set, use the list-reply function; group-reply
  3014.   will reply to both the sender and the list.
  3015.  
  3016.   6.3.56.  imap_checkinterval
  3017.  
  3018.   [ IMAP not supported with the AMIGA-Version I compiled - Faroul ]
  3019.  
  3020.   [ ... ]
  3021.  
  3022.   6.3.64.  implicit_autoview
  3023.  
  3024.   Type: boolean
  3025.   Default: no
  3026.  
  3027.   If set to ``yes'', mutt will look for a a mailcap entry with the
  3028.   copiousoutput flag set for every MIME attachment it doesn't have an
  3029.   internal viewer defined for.  If such an entry is found, mutt will use
  3030.   the viewer defined in that entry to convert the body part to text
  3031.   form.
  3032.  
  3033.   6.3.65.  include
  3034.  
  3035.   Type: quadoption
  3036.   Default: ask-yes
  3037.  
  3038.   Controls whether or not a copy of the message(s) you are replying to
  3039.   is included in your reply.
  3040.  
  3041.   6.3.66.  indent_string
  3042.  
  3043.   Type: string
  3044.   Default: "> "
  3045.  
  3046.   Specifies the string to prepend to each line of text quoted in a
  3047.   message to which you are replying.  You are strongly encouraged not to
  3048.   change this value, as it tends to agitate the more fanatical netizens.
  3049.  
  3050.   6.3.67.  in_reply_to
  3051.  
  3052.   Type: string
  3053.   Default: "%i; from %a on %{!%a, %b %d, %Y at %I:%M:%S%p %Z}"
  3054.  
  3055.   This specifies the format of the In-Reply-To header field added when
  3056.   replying to a message.  For a ful llisting of defined escape
  3057.   sequences, ese the section on index_format.
  3058.  
  3059.   Note: Don't use any sequences in this format string which may include
  3060.   8-bit characters.  Using such escape sequences may lead to bad
  3061.   headers.
  3062.  
  3063.   6.3.68.  index_format
  3064.  
  3065.   Type: string
  3066.   Default: "%4C %Z %{%b %d} %-15.15L (%4l) %s"
  3067.  
  3068.   This variable allows you to customize the message index display to
  3069.   your personal taste.
  3070.  
  3071.   ``Format strings'' are similar to the strings used in the ``C''
  3072.   function printf to format output (see the man page for more detail).
  3073.   The following sequences are defined in Mutt:
  3074.  
  3075.   %a      address of the author
  3076.   %b      filename of the original message
  3077.           folder (think mailBox)
  3078.   %B      the list to which the letter was sent,
  3079.           or else the folder name (%b).
  3080.   %c      number of characters (bytes) in the message
  3081.   %C      current message number
  3082.   %d      date and time of the message in the format
  3083.           specified by ``date_format'' converted to
  3084.           sender's time zone
  3085.   %D      date and time of the message in the format
  3086.           specified by ``date_format'' converted to
  3087.           the local time zone
  3088.   %f      entire From: line (address + real name)
  3089.   %F      author name, or recipient name if the
  3090.           message is from you
  3091.   %i      message-id of the current message
  3092.   %l      number of lines in the message
  3093.   %L      list-from function
  3094.   %m      total number of message in the mailbox
  3095.   %M      number of hidden messages if the thread
  3096.           is collapsed.
  3097.   %N      message score
  3098.   %n      author's real name (or address if missing)
  3099.   %O      (_O_riginal save folder)  Where
  3100.           mutt would formerly have stashed the
  3101.           message: list name or recipient name
  3102.           if no list
  3103.   %s      subject of the message
  3104.   %S      status of the message (N/D/d/!/r/*)
  3105.   %t      `to:' field (recipients)
  3106.   %T      the appropriate character from the
  3107.           to_chars string
  3108.   %u      user (login) name of the author
  3109.   %v      first name of the author, or the
  3110.           recipient if the message is from you
  3111.   %Z      message status flags
  3112.   %{fmt}  the date and time of the message is
  3113.           converted to sender's time zone, and
  3114.           ``fmt'' is expanded by the library
  3115.           function ``strftime''; a leading bang
  3116.           disables locales
  3117.   %[fmt]  the date and time of the message is
  3118.           converted to the local time zone, and
  3119.           ``fmt'' is expanded by the library
  3120.           function ``strftime''; a leading bang
  3121.           disables locales
  3122.   %(fmt)  the local date and time when the
  3123.           message was received.
  3124.           ``fmt'' is expanded by the library
  3125.           function ``strftime'';
  3126.           a leading bang disables locales
  3127.   %<fmt>  the current local time.
  3128.           ``fmt'' is expanded by the library
  3129.           function ``strftime'';
  3130.           a leading bang disables locales.
  3131.   %>X     right justify the rest of the string
  3132.           and pad with character "X"
  3133.   %|X     pad to the end of the line with
  3134.           character "X"
  3135.  
  3136.   See also: ``to_chars''.
  3137.  
  3138.   6.3.69.  ispell
  3139.  
  3140.   Type: path
  3141.   Default: "/usr/bin/ispell"
  3142.  
  3143.   How to invoke ispell (GNU's spell-checking software).
  3144.  
  3145.   6.3.70.  locale
  3146.  
  3147.   Type: string
  3148.   Default: "C"
  3149.  
  3150.   The locale used by strftime(3) to format dates. Legal values are the
  3151.   strings your system accepts for the locale variable LC_TIME.
  3152.  
  3153.   6.3.71.  mail_check
  3154.  
  3155.   Type: number
  3156.   Default: 5
  3157.  
  3158.   This variable configures how often (in seconds) mutt should look for
  3159.   new mail.
  3160.  
  3161.   6.3.72.  mailcap_path
  3162.  
  3163.   Type: string
  3164.   Default: ""
  3165.  
  3166.   This variable specifies which files to consult when attempting to
  3167.   display MIME bodies not directly supported by Mutt.
  3168.  
  3169.   6.3.73.  mailcap_sanitize
  3170.  
  3171.   Type: boolean
  3172.   Default: yes
  3173.  
  3174.   If set, mutt will restrict possible characters in mailcap % expandos
  3175.   to a well-defined set of safe characters.  This is the safe setting,
  3176.   but we are not sure it doesn't break some more advanced MIME stuff.
  3177.  
  3178.   DON'T CHANGE THIS SETTING UNLESS YOU ARE REALLY SURE WHAT YOU ARE
  3179.   DOING!
  3180.  
  3181.   6.3.74.  mark_old
  3182.  
  3183.   Type: boolean
  3184.   Default: yes
  3185.  
  3186.   Controls whether or not Mutt makes the distinction between new
  3187.   messages and old unread messages.  By default, Mutt will mark new
  3188.   messages as old if you exit a mailbox without reading them.  The next
  3189.   time you start Mutt, the messages will show up with an "O" next to
  3190.   them in the index menu, indicating that they are old.  In order to
  3191.   make Mutt treat all unread messages as new only, you can unset this
  3192.   variable.
  3193.  
  3194.   6.3.75.  markers
  3195.  
  3196.   Type: boolean
  3197.   Default: yes
  3198.  
  3199.   Controls the display of wrapped lines in the internal pager. If set, a
  3200.   ``+'' marker is displayed at the beginning of wrapped lines. Also see
  3201.   the ``smart_wrap'' variable.
  3202.  
  3203.   6.3.76.  mask
  3204.  
  3205.   Type: regular expression
  3206.   Default: "!^\.[^.]"
  3207.  
  3208.   A regular expression used in the file browser, optionally preceded by
  3209.   the not operator ``!''.  Only files whose names match this mask will
  3210.   be shown. The match is always case-sensitive.
  3211.  
  3212.   6.3.77.  mbox
  3213.  
  3214.   Type: path
  3215.   Default: " /mbox"
  3216.  
  3217.   This specifies the folder into which read mail in your ``spoolfile''
  3218.   folder will be appended.
  3219.  
  3220.   6.3.78.  mbox_type
  3221.  
  3222.   Type: folder magic
  3223.   Default: mbox
  3224.  
  3225.   The default mailbox type used when creating new folders. May be any of
  3226.   mbox, MMDF, MH and Maildir.
  3227.  
  3228.   6.3.79.  metoo
  3229.  
  3230.   Type: boolean
  3231.   Default: no
  3232.  
  3233.   If unset, Mutt will remove your address from the list of recipients
  3234.   when replying to a message.
  3235.  
  3236.   6.3.80.  menu_scroll
  3237.  
  3238.   Type: boolean
  3239.   Default: no
  3240.  
  3241.   When set, menus will be scrolled up or down one line when you attempt
  3242.   to move across a screen boundary.  If unset, the screen is cleared and
  3243.   the next or previous page of the menu is displayed (useful for slow
  3244.   links to avoid many redraws).
  3245.  
  3246.   6.3.81.  meta_key
  3247.  
  3248.   Type: boolean
  3249.   Default: no
  3250.  
  3251.   If set, forces Mutt to interpret keystrokes with the high bit (bit 8)
  3252.   set as if the user had pressed the ESC key and whatever key remains
  3253.   after having the high bit removed.  For example, if the key pressed
  3254.   has an ASCII value of 0xf4, then this is treated as if the user had
  3255.   pressed ESC then ``x''.  This is because the result of removing the
  3256.   high bit from ``0xf4'' is ``0x74'', which is the ASCII character
  3257.   ``x''.
  3258.  
  3259.   6.3.82.  mh_purge
  3260.  
  3261.   Type: boolean
  3262.   Default: no
  3263.  
  3264.   When unset, mutt will mimic mh's behaviour and rename deleted messages
  3265.   to ,<old file name> in mh folders instead of really deleting them.  If
  3266.   the variable is set, the message files will simply be deleted.
  3267.  
  3268.   6.3.83.  mime_forward
  3269.  
  3270.   Type: quadoption
  3271.   Default: no
  3272.  
  3273.   When set, the message you are forwarding will be attached as a
  3274.   separate MIME part instead of included in the main body of the
  3275.   message.  This is useful for forwarding MIME messages so the receiver
  3276.   can properly view the message as it was delivered to you. If you like
  3277.   to switch between MIME and not MIME from mail to mail, set this
  3278.   variable to ask-no or ask-yes.
  3279.  
  3280.   Also see ``forward_decode'' and ``mime_forward_decode''.
  3281.  
  3282.   6.3.84.  mime_forward_decode
  3283.  
  3284.   Type: boolean
  3285.   Default: no
  3286.  
  3287.   Controls the decoding of complex MIME messages into text/plain when
  3288.   forwarding a message while ``mime_forward'' is set. Otherwise
  3289.   ``forward_decode'' is used instead.
  3290.  
  3291.   6.3.85.  mime_forward_rest
  3292.  
  3293.   Type: quadoption
  3294.   Default: yes
  3295.  
  3296.   When forwarding multiple attachments of a MIME message from the
  3297.   recvattach menu, attachments which cannot be decoded in a reasonable
  3298.   manner will be attached to the newly composed message if this option
  3299.   is set.
  3300.  
  3301.   6.3.86.  mix_entry_format
  3302.  
  3303.   Type: string
  3304.   Default: "%4n %c %-16s %a"
  3305.  
  3306.   This variable describes the format of a remailer line on the mixmaster
  3307.   chain selection screen.  The following printf-like sequences are
  3308.   supported:
  3309.  
  3310.        %n      The running number on the menu.
  3311.        %c           Remailer capabilities.
  3312.        %s           The remailer's short name.
  3313.        %a           The remailer's e-mail address.
  3314.  
  3315.   6.3.87.  mixmaster
  3316.  
  3317.   Type: path
  3318.   Default: "mixmaster"
  3319.  
  3320.   This variable contains the path to the Mixmaster binary on your
  3321.   system.  It is used with various sets of parameters to gather the list
  3322.   of known remailers, and to finally send a message through the
  3323.   mixmaster chain.
  3324.  
  3325.   6.3.88.  move
  3326.  
  3327.   Type: quadoption
  3328.   Default: ask-no
  3329.  
  3330.   Controls whether you will be asked to confirm moving read messages
  3331.   from your spool mailbox to your ``mbox'' mailbox, or as a result of a
  3332.   ``mbox-hook'' command.
  3333.  
  3334.   6.3.89.  message_format
  3335.  
  3336.   Type: string
  3337.   Default: "%s"
  3338.  
  3339.   This is the string displayed in the ``attachment'' menu for
  3340.   attachments of type message/rfc822.  For a full listing of defined
  3341.   escape sequences see the section on ``index_format''.
  3342.  
  3343.   6.3.90.  pager
  3344.  
  3345.   Type: path
  3346.   Default: "builtin"
  3347.  
  3348.   This variable specifies which pager you would like to use to view
  3349.   messages.  builtin means to use the builtin pager, otherwise this
  3350.   variable should specify the pathname of the external pager you would
  3351.   like to use.
  3352.  
  3353.   Using an external pager may have some disadvantages: Additional
  3354.   keystrokes are necessary because you can't call mutt functions
  3355.   directly from the pager, and screen resizes cause lines longer than
  3356.   the screen width to be badly formatted in the help menu.
  3357.  
  3358.   6.3.91.  pager_context
  3359.  
  3360.   Type: number
  3361.   Default: 0
  3362.  
  3363.   This variable controls the number of lines of context that are given
  3364.   when displaying the next or previous page in the internal pager.  By
  3365.   default, Mutt will display the line after the last one on the screen
  3366.   at the top of the next page (0 lines of context).
  3367.  
  3368.   6.3.92.  pager_format
  3369.  
  3370.   Type: string
  3371.   Default: "-%Z- %C/%m: %-20.20n   %s"
  3372.  
  3373.   This variable controls the format of the one-line message ``status''
  3374.   displayed before each message in either the internal or an external
  3375.   pager.  The valid sequences are listed in the ``index_format''
  3376.   section.
  3377.  
  3378.   6.3.93.  pager_index_lines
  3379.  
  3380.   Type: number
  3381.   Default: 0
  3382.  
  3383.   Determines the number of lines of a mini-index which is shown when in
  3384.   the pager.  The current message, unless near the top or bottom of the
  3385.   folder, will be roughly one third of the way down this mini-index,
  3386.   giving the reader the context of a few messages before and after the
  3387.   message.  This is useful, for example, to determine how many messages
  3388.   remain to be read in the current thread.  One of the lines is reserved
  3389.   for the status bar from the index, so a pager_index_lines of 6 will
  3390.   only show 5 lines of the actual index.  A value of 0 results in no
  3391.   index being shown.  If the number of messages in the current folder is
  3392.   less than pager_index_lines, then the index will only use as many
  3393.   lines as it needs.
  3394.  
  3395.   6.3.94.  pager_stop
  3396.  
  3397.   Type: boolean
  3398.   Default: no
  3399.  
  3400.   When set, the internal-pager will not move to the next message when
  3401.   you are at the end of a message and invoke the next-page function.
  3402.  
  3403.   6.3.95.  pgp_autosign
  3404.  
  3405.   Type: boolean
  3406.   Default: no
  3407.  
  3408.   Setting this variable will cause Mutt to always attempt to PGP/MIME
  3409.   sign outgoing messages.  This can be overridden by use of the pgp-
  3410.   menu, when signing is not required or encryption is requested as well.
  3411.  
  3412.   6.3.96.  pgp_autoencrypt
  3413.  
  3414.   Type: boolean
  3415.   Default: no
  3416.  
  3417.   Setting this variable will cause Mutt to always attempt to PGP/MIME
  3418.   encrypt outgoing messages.  This is probably only useful in connection
  3419.   to the send-hook command.  It can be overridden by use of the pgp-
  3420.   menu, when encryption is not required or signing is requested as well.
  3421.  
  3422.   6.3.97.  pgp_entry_format
  3423.  
  3424.   Type: string
  3425.   Default: "%4n %t%f %4l/0x%k %-4a %2c %u"
  3426.  
  3427.   This variable allows you to customize the PGP key selection menu to
  3428.   your personal taste. This string is similar to ``index_format'', but
  3429.   has its own set of printf()-like sequences:
  3430.  
  3431.   %n      number
  3432.   %k      key id
  3433.   %u      user id
  3434.   %a      algorithm
  3435.   %l      key length
  3436.   %f      flags
  3437.   %c      capabilities
  3438.   %t      trust/validity of the key-uid association
  3439.   %[<s>]  date of the key where <s> is an strftime(3)
  3440.            expression
  3441.  
  3442.   6.3.98.  pgp_long_ids
  3443.  
  3444.   Type: boolean
  3445.   Default: no
  3446.  
  3447.   If set, use 64 bit PGP key IDs. Unset uses the normal 32 bit Key IDs.
  3448.  
  3449.   6.3.99.  pgp_replyencrypt
  3450.  
  3451.   Type: boolean
  3452.   Default: no
  3453.  
  3454.   If set, automatically PGP encrypt replies to messages which are
  3455.   encrypted.
  3456.  
  3457.   6.3.100.  pgp_replysign
  3458.  
  3459.   Type: boolean
  3460.   Default: no
  3461.  
  3462.   If set, automatically PGP sign replies to messages which are signed.
  3463.  
  3464.   Note: this does not work on messages that are encrypted and signed!
  3465.  
  3466.   6.3.101.  pgp_replysignencrypted
  3467.  
  3468.   Type: boolean
  3469.   Default: no
  3470.  
  3471.   If set, automatically PGP sign replies to messages which are
  3472.   encrypted. This makes sense in combination with ``pgp_replyencrypt'',
  3473.   because it allows you to sign all messages which are automatically
  3474.   encrypted.  This works around the problem noted in ``pgp_replysign'',
  3475.   that mutt is not able to find out whether an encrypted message is also
  3476.   signed.
  3477.  
  3478.   6.3.102.  pgp_retainable_sigs
  3479.  
  3480.   Type: boolean
  3481.   Default: no
  3482.  
  3483.   If set, signed and encrypted messages will consist of nested
  3484.   multipart/signed and multipart/encrypted body parts.
  3485.  
  3486.   This is useful for applications like encrypted and signed mailing
  3487.   lists, where the outer layer (multipart/encrypted) can be easily
  3488.   removed, while the inner multipart/signed part is retained.
  3489.  
  3490.   6.3.103.  pgp_show_unusable
  3491.  
  3492.   Type: boolean
  3493.   Default: yes
  3494.  
  3495.   If set, mutt will display non-usable keys on the PGP key selection
  3496.   menu.  This includes keys which have been revoked, have expired, or
  3497.   have been marked as ``disabled'' by the user.
  3498.  
  3499.   6.3.104.  pgp_sign_as
  3500.  
  3501.   Type: string
  3502.   Default: ""
  3503.  
  3504.   If you have more than one key pair, this option allows you to specify
  3505.   which of your private keys to use.  It is recommended that you use the
  3506.   keyid form to specify your key (e.g., ``0xABCDEFGH'').
  3507.  
  3508.   6.3.105.  pgp_sign_micalg
  3509.  
  3510.   Type: string
  3511.   Default: "pgp-md5"
  3512.  
  3513.   This variable contains the default message integrity check algorithm.
  3514.   Valid values are ``pgp-md5'', ``pgp-sha1'', and ``pgp-rmd160''. If you
  3515.   select a signing key using the sign as option on the compose menu,
  3516.   mutt will automagically figure out the correct value to insert here,
  3517.   but it does not know about the user's default key.
  3518.  
  3519.   So if you are using an RSA key for signing, set this variable to
  3520.   ``pgp-md5'', if you use a PGP 5 DSS key for signing, say ``pgp-sha1''
  3521.   here. The value of this variable will show up in the micalg parameter
  3522.   of MIME headers when creating RFC 2015 signatures.
  3523.  
  3524.   6.3.106.  pgp_strict_enc
  3525.  
  3526.   Type: boolean
  3527.   Default: yes
  3528.  
  3529.   If set, Mutt will automatically encode PGP/MIME signed messages as
  3530.   quoted-printable.  Please note that unsetting this variable may lead
  3531.   to problems with non-verifyable PGP signatures, so only change this if
  3532.   you know what you are doing.
  3533.  
  3534.   6.3.107.  pgp_timeout
  3535.  
  3536.   Type: number
  3537.   Default: 300
  3538.  
  3539.   The number of seconds after which a cached passphrase will expire if
  3540.   not used.
  3541.  
  3542.   6.3.108.  pgp_verify_sig
  3543.  
  3544.   Type: quadoption
  3545.   Default: yes
  3546.  
  3547.   If ``yes'', always attempt to verify PGP/MIME signatures.  If ``ask'',
  3548.   ask whether or not to verify the signature.  If ``no'', never attempt
  3549.   to verify PGP/MIME signatures.
  3550.  
  3551.   6.3.109.  pgp_sort_keys
  3552.  
  3553.   Type: sort oder
  3554.   Default: address
  3555.  
  3556.   Specifies how the entries in the `pgp keys' menu are sorted. The
  3557.   following are legal values:
  3558.  
  3559.        address         sort alphabetically by user id
  3560.        keyid   sort alphabetically by key id
  3561.        date    sort by key creation date
  3562.        trust      sort by the trust of the key
  3563.  
  3564.   If you prefer reverse order of the above values, prefix it with
  3565.   `reverse-'.
  3566.  
  3567.   6.3.110.  pgp_create_traditional
  3568.  
  3569.   Type: quadoption
  3570.   Default: no
  3571.  
  3572.   This option controls whether Mutt generates old-style PGP encrypted or
  3573.   signed messages under certain circumstances.
  3574.  
  3575.   Note that PGP/MIME will be used automatically for messages which have
  3576.   a character set different from us-ascii, or which consist of more than
  3577.   a single MIME part.
  3578.  
  3579.   Also note that using the old-style PGP message format is strongly
  3580.   deprecated.
  3581.  
  3582.   6.3.111.  pgp_decode_command
  3583.  
  3584.   Type: string
  3585.   Default: ""
  3586.  
  3587.   This format strings specifies a command which is used to decode
  3588.   application/pgp attachments.
  3589.  
  3590.   The PGP command formats have their own set of printf-like sequences:
  3591.  
  3592.        %p        Expands to PGPPASSFD=0 when a pass phrase
  3593.                  is needed, to an empty string otherwise.
  3594.                  Note: This may be used with a %? construct.
  3595.        %f        Expands to the name of a file containing
  3596.                  a message.
  3597.        %s        Expands to the name of a file containing
  3598.                  the signature part of a multipart/signed
  3599.                  attachment when verifying it.
  3600.        %a        The value of pgp_sign_as.
  3601.        %r        One or more key IDs.
  3602.  
  3603.   For examples on how to configure these formats for the various
  3604.   versions of PGP which are floating around, see the pgp*.rc and gpg.rc
  3605.   files in the samples/ subdirectory which has been installed on your
  3606.   system alongside the documentation.
  3607.  
  3608.   6.3.112.  pgp_getkeys_command
  3609.  
  3610.   Type: string
  3611.   Default: ""
  3612.  
  3613.   This command is invoked whenever mutt will need public key
  3614.   information.  %r is the only printf-like sequence used with this
  3615.   format.
  3616.  
  3617.   6.3.113.  pgp_verify_command
  3618.  
  3619.   Type: string
  3620.   Default: ""
  3621.  
  3622.   This command is used to verify PGP/MIME signatures.
  3623.  
  3624.   6.3.114.  pgp_decrypt_command
  3625.  
  3626.   Type: string
  3627.   Default: ""
  3628.   This command is used to decrypt a PGP/MIME encrypted message.
  3629.  
  3630.   6.3.115.  pgp_clearsign_command
  3631.  
  3632.   Type: string
  3633.   Default: ""
  3634.  
  3635.   This format is used to create a "clearsigned" old-style PGP
  3636.   attachment.  Note that the use of this format is strongly deprecated.
  3637.  
  3638.   6.3.116.  pgp_sign_command
  3639.  
  3640.   Type: string
  3641.   Default: ""
  3642.  
  3643.   This command is used to create the detached PGP signature for a
  3644.   multipart/signed PGP/MIME body part.
  3645.  
  3646.   6.3.117.  pgp_encrypt_sign_command
  3647.  
  3648.   Type: string
  3649.   Default: ""
  3650.  
  3651.   This command is used to combinedly sign/encrypt a body part.
  3652.  
  3653.   6.3.118.  pgp_encrypt_only_command
  3654.  
  3655.   Type: string
  3656.   Default: ""
  3657.  
  3658.   This command is used to encrypt a body part without signing it.
  3659.  
  3660.   6.3.119.  pgp_import_command
  3661.  
  3662.   Type: string
  3663.   Default: ""
  3664.  
  3665.   This command is used to import a key from a message into the user's
  3666.   public key ring.
  3667.  
  3668.   6.3.120.  pgp_export_command
  3669.  
  3670.   Type: string
  3671.   Default: ""
  3672.  
  3673.   This command is used to export a public key from the user's key ring.
  3674.  
  3675.   6.3.121.  pgp_verify_key_command
  3676.  
  3677.   Type: string
  3678.   Default: ""
  3679.  
  3680.   This command is used to verify key information from the key selection
  3681.   menu.
  3682.  
  3683.   6.3.122.  pgp_list_secring_command
  3684.  
  3685.   Type: string
  3686.   Default: ""
  3687.  
  3688.   This command is used to list the secret key ring's contents.  The
  3689.   output format must be analogous to the one used by gpg --list-keys
  3690.   --with-colons.
  3691.  
  3692.   This format is also generated by the pgpring utility which comes with
  3693.   mutt.
  3694.  
  3695.   6.3.123.  pgp_list_pubring_command
  3696.  
  3697.   Type: string
  3698.   Default: ""
  3699.  
  3700.   This command is used to list the public key ring's contents.  The
  3701.   output format must be analogous to the one used by gpg --list-keys
  3702.   --with-colons.
  3703.  
  3704.   This format is also generated by the pgpring utility which comes with
  3705.   mutt.
  3706.  
  3707.   6.3.124.  forward_decrypt
  3708.  
  3709.   Type: boolean
  3710.   Default: yes
  3711.  
  3712.   Controls the handling of encrypted messages when forwarding a message.
  3713.   When set, the outer layer of encryption is stripped off.  This
  3714.   variable is only used if ``mime_forward'' is set and
  3715.   ``mime_forward_decode'' is unset.
  3716.  
  3717.   6.3.125.  pipe_split
  3718.  
  3719.   Type: boolean
  3720.   Default: no
  3721.  
  3722.   Used in connection with the pipe-message command and the ``tag-
  3723.   prefix'' operator.  If this variable is unset, when piping a list of
  3724.   tagged messages Mutt will concatenate the messages and will pipe them
  3725.   as a single folder.  When set, Mutt will pipe the messages one by one.
  3726.   In both cases the the messages are piped in the current sorted order,
  3727.   and the ``pipe_sep'' separator is added after each message.
  3728.   6.3.126.  pipe_decode
  3729.  
  3730.   Type: boolean
  3731.   Default: no
  3732.  
  3733.   Used in connection with the pipe-message command.  When unset, Mutt
  3734.   will pipe the messages without any preprocessing. When set, Mutt will
  3735.   weed headers and will attempt to PGP/MIME decode the messages first.
  3736.  
  3737.   6.3.127.  pipe_sep
  3738.  
  3739.   Type: string
  3740.   Default: "\n"
  3741.  
  3742.   The separator to add between messages when piping a list of tagged
  3743.   messages to an external Unix command.
  3744.  
  3745.   6.3.128.  pop_delete
  3746.  
  3747.   Type: boolean
  3748.   Default: no
  3749.  
  3750.   If set, Mutt will delete successfully downloaded messages from the POP
  3751.   server when using the fetch-mail function.  When unset, Mutt will
  3752.   download messages but also leave them on the POP server.
  3753.  
  3754.   6.3.129.  pop_host
  3755.  
  3756.   Type: string
  3757.   Default: ""
  3758.  
  3759.   The name or address of your POP3 server.
  3760.  
  3761.   6.3.130.  pop_port
  3762.  
  3763.   Type: number
  3764.   Default: 110
  3765.  
  3766.   This variable specifies which port your POP server is listening on.
  3767.  
  3768.   6.3.131.  pop_last
  3769.  
  3770.   Type: boolean
  3771.   Default: no
  3772.  
  3773.   If this variable is set, mutt will try to use the "LAST" POP command
  3774.   for retrieving only unread messages from the POP server.
  3775.  
  3776.   6.3.132.  pop_user
  3777.  
  3778.   Type: string
  3779.   Default: ""
  3780.  
  3781.   Your login name on the POP3 server.
  3782.  
  3783.   Defaults to your login name on the local system.
  3784.  
  3785.   6.3.133.  pop_pass
  3786.  
  3787.   Type: string
  3788.   Default: ""
  3789.  
  3790.   Your password on the POP3 server.
  3791.  
  3792.   6.3.134.  post_indent_string
  3793.  
  3794.   Type: string
  3795.   Default: ""
  3796.  
  3797.   Similar to the ``attribution'' variable, Mutt will append this string
  3798.   after the inclusion of a message which is being replied to.
  3799.  
  3800.   6.3.135.  postpone
  3801.  
  3802.   Type: quadoption
  3803.   Default: ask-yes
  3804.  
  3805.   Controls whether or not messages are saved in the ``postponed''
  3806.   mailbox when you elect not to send immediately.
  3807.  
  3808.   6.3.136.  postponed
  3809.  
  3810.   Type: path
  3811.   Default: " /postponed"
  3812.  
  3813.   Mutt allows you to indefinitely ``postpone sending a message'' which
  3814.   you are editing.  When you choose to postpone a message, Mutt saves it
  3815.   in the folder specified by this variable.  Also see the ``postpone''
  3816.   variable.
  3817.  
  3818.   6.3.137.  print
  3819.  
  3820.   Type: quadoption
  3821.   Default: ask-no
  3822.  
  3823.   Controls whether or not Mutt asks for confirmation before printing.
  3824.   This is useful for people (like me) who accidentally hit ``p'' often.
  3825.  
  3826.   6.3.138.  print_command
  3827.  
  3828.   Type: path
  3829.   Default: "lpr"
  3830.  
  3831.   This specifies the command pipe that should be used to print messages.
  3832.  
  3833.   6.3.139.  prompt_after
  3834.  
  3835.   Type: boolean
  3836.   Default: yes
  3837.  
  3838.   If you use an external ``pager'', setting this variable will cause
  3839.   Mutt to prompt you for a command when the pager exits rather than
  3840.   returning to the index menu.  If unset, Mutt will return to the index
  3841.   menu when the external pager exits.
  3842.  
  3843.   6.3.140.  query_command
  3844.  
  3845.   Type: path
  3846.   Default: ""
  3847.  
  3848.   This specifies the command that mutt will use to make external address
  3849.   queries.  The string should contain a %s, which will be substituted
  3850.   with the query string the user types.  See ``query'' for more
  3851.   information.
  3852.  
  3853.   6.3.141.  quit
  3854.  
  3855.   Type: quadoption
  3856.   Default: yes
  3857.  
  3858.   This variable controls whether ``quit'' and ``exit'' actually quit
  3859.   from mutt.  If it set to yes, they do quit, if it is set to no, they
  3860.   have no effect, and if it is set to ask-yes or ask-no, you are
  3861.   prompted for confirmation when you try to quit.
  3862.  
  3863.   6.3.142.  quote_regexp
  3864.  
  3865.   Type: regular expression
  3866.   Default: "^([ \t]*[|>:}#])+"
  3867.  
  3868.   A regular expression used in the internal-pager to determine quoted
  3869.   sections of text in the body of a message.
  3870.  
  3871.   Note: In order to use the quotedx patterns in the internal pager, you
  3872.   need to set this to a regular expression that matches exactly the
  3873.   quote characters at the beginning of quoted lines.
  3874.  
  3875.   6.3.143.  read_inc
  3876.  
  3877.   Type: number
  3878.   Default: 10
  3879.  
  3880.   If set to a value greater than 0, Mutt will display which message it
  3881.   is currently on when reading a mailbox.  The message is printed after
  3882.   read_inc messages have been read (e.g., if set to 25, Mutt will print
  3883.   a message when it reads message 25, and then again when it gets to
  3884.   message 50).  This variable is meant to indicate progress when reading
  3885.   large mailboxes which may take some time.  When set to 0, only a
  3886.   single message will appear before the reading the mailbox.
  3887.  
  3888.   Also see the ``write_inc'' variable.
  3889.  
  3890.   6.3.144.  read_only
  3891.  
  3892.   Type: boolean
  3893.   Default: no
  3894.  
  3895.   If set, all folders are opened in read-only mode.
  3896.  
  3897.   6.3.145.  realname
  3898.  
  3899.   Type: string
  3900.   Default: ""
  3901.  
  3902.   This variable specifies what "real" or "personal" name should be used
  3903.   when sending messages.
  3904.  
  3905.   By default, this is the GCOS field from /etc/passwd.  Note that this
  3906.   variable will not be used when the user has set a real name in the
  3907.   from variable.
  3908.  
  3909.   6.3.146.  recall
  3910.  
  3911.   Type: quadoption
  3912.   Default: ask-yes
  3913.  
  3914.   Controls whether or not you are prompted to recall postponed messages
  3915.   when composing a new message.  Also see ``postponed''
  3916.  
  3917.   6.3.147.  record
  3918.  
  3919.   Type: path
  3920.   Default: ""
  3921.  
  3922.   This specifies the file into which your outgoing messages should be
  3923.   appended.  (This is meant as the primary method for saving a copy of
  3924.   your messages, but another way to do this is using the ``my_hdr''
  3925.   command to create a Bcc: field with your email address in it.)
  3926.  
  3927.   The value of record is overridden by the ``force_name'' and
  3928.   ``save_name'' variables, and the ``fcc-hook'' command.
  3929.  
  3930.   6.3.148.  reply_regexp
  3931.  
  3932.   Type: regular expression
  3933.   Default: "^(re([\[0-9\]+])*|aw):[ \t]*"
  3934.  
  3935.   A regular expression used to recognize reply messages when threading
  3936.   and replying. The default value corresponds to the English "Re:" and
  3937.   the German "Aw:".
  3938.  
  3939.   6.3.149.  reply_self
  3940.  
  3941.   Type: boolean
  3942.   Default: no
  3943.  
  3944.   If unset and you are replying to a message sent by you, Mutt will
  3945.   assume that you want to reply to the recipients of that message rather
  3946.   than to yourself.
  3947.  
  3948.   6.3.150.  reply_to
  3949.  
  3950.   Type: quadoption
  3951.   Default: ask-yes
  3952.  
  3953.   If set, Mutt will ask you if you want to use the address listed in the
  3954.   Reply-To: header field when replying to a message.  If you answer no,
  3955.   it will use the address in the From: header field instead.  This
  3956.   option is useful for reading a mailing list that sets the Reply-To:
  3957.   header field to the list address and you want to send a private
  3958.   message to the author of a message.
  3959.  
  3960.   6.3.151.  resolve
  3961.  
  3962.   Type: boolean
  3963.   Default: yes
  3964.  
  3965.   When set, the cursor will be automatically advanced to the next
  3966.   (possibly undeleted) message whenever a command that modifies the
  3967.   current message is executed.
  3968.  
  3969.   6.3.152.  reverse_alias
  3970.  
  3971.   Type: boolean
  3972.   Default: no
  3973.  
  3974.   This variable controls whether or not Mutt will display the "personal"
  3975.   name from your aliases in the index menu if it finds an alias that
  3976.   matches the message's sender.  For example, if you have the following
  3977.   alias:
  3978.        alias juser abd30425@somewhere.net (Joe User)
  3979.  
  3980.   and then you receive mail which contains the following header:
  3981.  
  3982.        From: abd30425@somewhere.net
  3983.  
  3984.   It would be displayed in the index menu as ``Joe User'' instead of
  3985.   ``abd30425@somewhere.net.''  This is useful when the person's e-mail
  3986.   address is not human friendly (like Compuerve addresses).
  3987.  
  3988.   6.3.153.  reverse_name
  3989.  
  3990.   Type: boolean
  3991.   Default: no
  3992.  
  3993.   It may sometimes arrive that you receive mail to a certain machine,
  3994.   move the messages to another machine, and reply to some the messages
  3995.   from there.  If this variable is set, the default From: line of the
  3996.   reply messages is built using the address where you received the
  3997.   messages you are replying to.  If the variable is unset, the From:
  3998.   line will use your address on the current machine.
  3999.  
  4000.   6.3.154.  rfc2047_parameters
  4001.  
  4002.   Type: boolean
  4003.   Default: no
  4004.  
  4005.   When this variable is set, Mutt will decode RFC2047-encoded MIME
  4006.   parameters.  Note that this ues of RFC2047's encoding is illegal, but
  4007.   actually in use.
  4008.  
  4009.   6.3.155.  save_address
  4010.  
  4011.   Type: boolean
  4012.   Default: no
  4013.  
  4014.   If set, mutt will take the sender's full address when choosing a
  4015.   default folder for saving a mail. If ``save_name'' or ``force_name''
  4016.   is set too, the selection of the fcc folder will be changed as well.
  4017.  
  4018.   6.3.156.  save_empty
  4019.  
  4020.   Type: boolean
  4021.   Default: yes
  4022.  
  4023.   When unset, mailboxes which contain no saved messages will be removed
  4024.   when closed (the exception is ``spoolfile'' which is never removed).
  4025.   If set, mailboxes are never removed.
  4026.  
  4027.   Note: This only applies to mbox and MMDF folders, Mutt does not delete
  4028.   MH and Maildir directories.
  4029.  
  4030.   6.3.157.  save_name
  4031.  
  4032.   Type: boolean
  4033.   Default: no
  4034.  
  4035.   This variable controls how copies of outgoing messages are saved.
  4036.   When set, a check is made to see if a mailbox specified by the
  4037.   recipient address exists (this is done by searching for a mailbox in
  4038.   the ``folder'' directory with the username part of the recipient
  4039.   address).  If the mailbox exists, the outgoing message will be saved
  4040.   to that mailbox, otherwise the message is saved to the ``record''
  4041.   mailbox.
  4042.  
  4043.   Also see the ``force_name'' variable.
  4044.  
  4045.   6.3.158.  score
  4046.  
  4047.   Type: boolean
  4048.   Default: yes
  4049.  
  4050.   When this variable is unset, scoring is turned off.  This can be
  4051.   useful to selectively disable scoring for certain folders when the
  4052.   score_threshold_delete variable and friends are used.
  4053.  
  4054.   6.3.159.  score_threshold_delete
  4055.  
  4056.   Type: number
  4057.   Default: -1
  4058.  
  4059.   Messages which have been assigned a score equal to or lower than the
  4060.   value of this variable are automatically marked for deletion by mutt.
  4061.   Since mutt scores are always greater than or equal to zero, the
  4062.   default setting of this variable will never mark a message for
  4063.   deletion.
  4064.  
  4065.   6.3.160.  score_threshold_flag
  4066.  
  4067.   Type: number
  4068.   Default: 9999
  4069.  
  4070.   Messages wich have been assigned a score greater than or equal to this
  4071.   variable's value are automatically marked "flagged".
  4072.  
  4073.   6.3.161.  score_threshold_read
  4074.  
  4075.   Type: number
  4076.   Default: -1
  4077.  
  4078.   Messages which have been assigned a score equal to or lower than the
  4079.   value of this variable are automatically marked as read by mutt.
  4080.   Since mutt scores are always greater than or equal to zero, the
  4081.   default setting of this variable will never mark a message read.
  4082.  
  4083.   6.3.162.  send_charset
  4084.  
  4085.   Type: string
  4086.   Default: ""
  4087.  
  4088.   The character set that mutt will use for outgoing messages.  If this
  4089.   variable is not set, mutt will fall back to charset.
  4090.  
  4091.   6.3.163.  sendmail
  4092.  
  4093.   Type: path
  4094.   Default: "/usr/sbin/sendmail -oem -oi"
  4095.  
  4096.   Specifies the program and arguments used to deliver mail sent by Mutt.
  4097.   Mutt expects that the specified program interprets additional
  4098.   arguments as recipient addresses.
  4099.  
  4100.   6.3.164.  sendmail_wait
  4101.  
  4102.   Type: number
  4103.   Default: 0
  4104.  
  4105.   Specifies the number of seconds to wait for the ``sendmail'' process
  4106.   to finish before giving up and putting delivery in the background.
  4107.  
  4108.   Mutt interprets the value of this variable as follows:
  4109.  
  4110.        >0      number of seconds to wait for sendmail to
  4111.                finish before continuing
  4112.        0       wait forever for sendmail to finish
  4113.        <0      always put sendmail in the background
  4114.                without waiting
  4115.  
  4116.   Note that if you specify a value other than 0, the output of the child
  4117.   process will be put in a temporary file.  If there is some error, you
  4118.   will be informed as to where to find the output.
  4119.  
  4120.   6.3.165.  shell
  4121.  
  4122.   Type: path
  4123.   Default: ""
  4124.  
  4125.   Command to use when spawning a subshell.  By default, the user's login
  4126.   shell from /etc/passwd is used.
  4127.  
  4128.   6.3.166.  sig_dashes
  4129.  
  4130.   Type: boolean
  4131.   Default: yes
  4132.  
  4133.   If set, a line containing ``-- '' will be inserted before your
  4134.   ``signature''.  It is strongly recommended that you not unset this
  4135.   variable unless your ``signature'' contains just your name.  The
  4136.   reason for this is because many software packages use ``-- \n'' to
  4137.   detect your signature.  For example, Mutt has the ability to highlight
  4138.   the signature in a different color in the builtin pager.
  4139.  
  4140.   6.3.167.  signature
  4141.  
  4142.   Type: path
  4143.   Default: " /.signature"
  4144.  
  4145.   Specifies the filename of your signature, which is appended to all
  4146.   outgoing messages.   If the filename ends with a pipe (``|''), it is
  4147.   assumed that filename is a shell command and input should be read from
  4148.   its stdout.
  4149.  
  4150.   6.3.168.  simple_search
  4151.  
  4152.   Type: string
  4153.   Default: " f %s |  s %s"
  4154.  
  4155.   Specifies how Mutt should expand a simple search into a real search
  4156.   pattern.  A simple search is one that does not contain any of the
  4157.   operators.  See ``patterns'' for more information on search patterns.
  4158.  
  4159.   For example, if you simply type joe at a search or limit prompt, Mutt
  4160.   will automatically expand it to the value specified by this variable.
  4161.   For the default value it would be:
  4162.  
  4163.    f joe |  s joe
  4164.  
  4165.   6.3.169.  smart_wrap
  4166.  
  4167.   Type: boolean
  4168.   Default: yes
  4169.  
  4170.   Controls the display of lines longer then the screen width in the
  4171.   internal pager. If set, long lines are wrapped at a word boundary.  If
  4172.   unset, lines are simply wrapped at the screen edge. Also see the
  4173.   ``markers'' variable.
  4174.  
  4175.   6.3.170.  smileys
  4176.  
  4177.   Type: regular expression
  4178.   Default: "(>From )|(:[-^]?[][)(><}{|/DP])"
  4179.  
  4180.   The pager uses this variable to catch some common false positives of
  4181.   ``quote_regexp'', most notably smileys in the beginning of a line
  4182.  
  4183.   6.3.171.  sort
  4184.  
  4185.   Type: sort oder
  4186.   Default: date
  4187.  
  4188.   Specifies how to sort messages in the index menu.  Valid values are:
  4189.  
  4190.           date or date-sent
  4191.           date-received
  4192.           from
  4193.           mailbox-order (unsorted)
  4194.           score
  4195.           size
  4196.           subject
  4197.           threads
  4198.           to
  4199.  
  4200.   You may optionally use the reverse- prefix to specify reverse sorting
  4201.   order (example: set sort=reverse-date-sent).
  4202.  
  4203.   6.3.172.  sort_alias
  4204.  
  4205.   Type: sort oder
  4206.   Default: alias
  4207.  
  4208.   Specifies how the entries in the `alias' menu are sorted.  The
  4209.   following are legal values:
  4210.  
  4211.           address (sort alphabetically by email address)
  4212.           alias (sort alphabetically by alias name)
  4213.           unsorted (leave in order specified in .muttrc)
  4214.  
  4215.   6.3.173.  sort_aux
  4216.  
  4217.   Type: sort oder
  4218.   Default: date
  4219.  
  4220.   When sorting by threads, this variable controls how threads are sorted
  4221.   in relation to other threads, and how the branches of the thread trees
  4222.   are sorted.  This can be set to any value that ``sort'' can, except
  4223.   threads (in that case, mutt will just use date-sent).  You can also
  4224.   specify the last- prefix in addition to the reverse- prefix, but last-
  4225.   must come after reverse-.  The last- prefix causes messages to be
  4226.   sorted against its siblings by which has the last descendant, using
  4227.   the rest of sort_aux as an ordering.  For instance, set sort_aux=last-
  4228.   date-received would mean that if a new message is received in a
  4229.   thread, that thread becomes the last one displayed (or the first, if
  4230.   you have set sort=reverse-threads.)
  4231.  
  4232.   6.3.174.  sort_browser
  4233.  
  4234.   Type: sort oder
  4235.   Default: subject
  4236.  
  4237.   Specifies how to sort entries in the file browser.  By default, the
  4238.   entries are sorted alphabetically.  Valid values:
  4239.  
  4240.           alpha (alphabetically)
  4241.           date
  4242.           size
  4243.           unsorted
  4244.  
  4245.   You may optionally use the reverse- prefix to specify reverse sorting
  4246.   order (example: set sort_browser=reverse-date).
  4247.  
  4248.   6.3.175.  sort_re
  4249.  
  4250.   Type: boolean
  4251.   Default: yes
  4252.  
  4253.   This variable is only useful when sorting by threads with
  4254.   ``strict_threads'' unset.  In that case, it changes the heuristic mutt
  4255.   uses to thread messages by subject.  With sort_re set, mutt will only
  4256.   attach a message as the child of another message by subject if the
  4257.   subject of the child message starts with a substring matching the
  4258.   setting of ``reply_regexp''.  With sort_re unset, mutt will attach the
  4259.   message whether or not this is the case, as long as the
  4260.   non-``reply_regexp'' parts of both messages are identical.
  4261.  
  4262.   6.3.176.  spoolfile
  4263.  
  4264.   Type: path
  4265.   Default: ""
  4266.   If your spool mailbox is in a non-default place where Mutt cannot find
  4267.   it, you can specify its location with this variable.  Mutt will
  4268.   automatically set this variable to the value of the environment
  4269.   variable MAIL if it is not set.
  4270.  
  4271.   6.3.177.  status_chars
  4272.  
  4273.   Type: string
  4274.   Default: "-*%A"
  4275.  
  4276.   Controls the characters used by the "%r" indicator in
  4277.   ``status_format''. The first character is used when the mailbox is
  4278.   unchanged. The second is used when the mailbox has been changed, and
  4279.   it needs to be resynchronized. The third is used if the mailbox is in
  4280.   read-only mode, or if the mailbox will not be written when exiting
  4281.   that mailbox (You can toggle whether to write changes to a mailbox
  4282.   with the toggle-write operation, bound by default to "%"). The fourth
  4283.   is used to indicate that the current folder has been opened in attach-
  4284.   message mode (Certain operations like composing a new mail, replying,
  4285.   forwarding, etc. are not permitted in this mode).
  4286.  
  4287.   6.3.178.  status_format
  4288.  
  4289.   Type: string
  4290.   Default: "-%r-Mutt: %f [Msgs:%?M?%M/?%m%?n? New:%n?%?o? Old:%o?%?d?
  4291.   Del:%d?%?F? Flag:%F?%?t? Tag:%t?%?p? Post:%p?%?b? Inc:%b?%?l?
  4292.   %l?]---(%s/%S)-%>-(%P)---"
  4293.  
  4294.   Controls the format of the status line displayed in the index menu.
  4295.   This string is similar to ``index_format'', but has its own set of
  4296.   printf()-like sequences:
  4297.  
  4298.   %b      number of mailboxes with new mail *
  4299.   %d      number of deleted messages *
  4300.   %h      local hostname
  4301.   %f      the full pathname of the current mailbox
  4302.   %F      number of flagged messages *
  4303.   %l      size (in bytes) of the current mailbox *
  4304.   %L      size (in bytes) of the messages shown
  4305.           (i.e., which match the current limit) *
  4306.   %m      the number of messages in the mailbox *
  4307.   %M      the number of messages shown (i.e., which
  4308.           match the current limit) *
  4309.   %n      number of new messages in the mailbox *
  4310.   %o      number of old unread messages
  4311.   %p      number of postponed messages *
  4312.   %P      percentage of the way through the index
  4313.   %r      modified/read-only/won't-write/attach-message
  4314.           indicator, according to status_chars
  4315.   %s      current sorting mode (sort)
  4316.   %S      current aux sorting method (sort_aux)
  4317.   %t      number of tagged messages *
  4318.   %u      number of unread messages *
  4319.   %v      Mutt version string
  4320.   %V      currently active limit pattern, if any *
  4321.   %>X     right justify the rest of the string and
  4322.           pad with "X"
  4323.   %|X     pad to the end of the line with "X"
  4324.  
  4325.   * = can be optionally printed if nonzero
  4326.  
  4327.   Some of the above sequences can be used to optionally print a string
  4328.   if their value is nonzero.  For example, you may only want to see the
  4329.   number of flagged messages if such messages exist, since zero is not
  4330.   particularly meaningful.  To optionally print a string based upon one
  4331.   of the above sequences, the following construct is used
  4332.  
  4333.   %?<sequence_char>?<optional_string>?
  4334.  
  4335.   where sequence_char is a character from the table above, and
  4336.   optional_string is the string you would like printed if status_char is
  4337.   nonzero.  optional_string may contain other sequence as well as normal
  4338.   text, but you may not nest optional strings.
  4339.  
  4340.   Here is an example illustrating how to optionally print the number of
  4341.   new messages in a mailbox: %?n?%n new messages.?
  4342.  
  4343.   Additionally you can switch between two strings, the first one, if a
  4344.   value is zero, the second one, if the value is nonzero, by using the
  4345.   following construct: %?<sequence_char>?<if_string>&<else_string>?
  4346.  
  4347.   You can additionally force the result of any printf-like sequence to
  4348.   be lowercase by prefixing the sequence character with an underscore
  4349.   (_) sign.  For example, if you want to display the local hostname in
  4350.   lowercase, you would use: %_h
  4351.  
  4352.   6.3.179.  status_on_top
  4353.  
  4354.   Type: boolean
  4355.   Default: no
  4356.  
  4357.   Setting this variable causes the ``status bar'' to be displayed on the
  4358.   first line of the screen rather than near the bottom.
  4359.  
  4360.   6.3.180.  strict_threads
  4361.  
  4362.   Type: boolean
  4363.   Default: no
  4364.  
  4365.   If set, threading will only make use of the ``In-Reply-To'' and
  4366.   ``References'' fields when ``sorting'' by message threads.  By
  4367.   default, messages with the same subject are grouped together in
  4368.   ``pseudo threads.''  This may not always be desirable, such as in a
  4369.   personal mailbox where you might have several unrelated messages with
  4370.   the subject ``hi'' which will get grouped together.
  4371.  
  4372.   6.3.181.  suspend
  4373.  
  4374.   Type: boolean
  4375.   Default: yes
  4376.  
  4377.   When unset, mutt won't stop when the user presses the terminal's susp
  4378.   key, usually ``control-Z''. This is useful if you run mutt inside an
  4379.   xterm using a command like xterm -e mutt.
  4380.  
  4381.   6.3.182.  thorough_search
  4382.  
  4383.   Type: boolean
  4384.   Default: no
  4385.  
  4386.   Affects the  b and  h search operations described in section
  4387.   ``patterns'' above.  If set, the headers and attachments of messages
  4388.   to be searched are decoded before searching.  If unset, messages are
  4389.   searched as they appear in the folder.
  4390.  
  4391.   6.3.183.  tilde
  4392.  
  4393.   Type: boolean
  4394.   Default: no
  4395.  
  4396.   When set, the internal-pager will pad blank lines to the bottom of the
  4397.   screen with a tilde ( ).
  4398.  
  4399.   6.3.184.  timeout
  4400.  
  4401.   Type: number
  4402.   Default: 600
  4403.  
  4404.   This variable controls the number of seconds Mutt will wait for a key
  4405.   to be pressed in the main menu before timing out and checking for new
  4406.   mail.  A value of zero or less will cause Mutt not to ever time out.
  4407.  
  4408.   6.3.185.  tmpdir
  4409.  
  4410.   Type: path
  4411.   Default: ""
  4412.  
  4413.   This variable allows you to specify where Mutt will place its
  4414.   temporary files needed for displaying and composing messages.
  4415.  
  4416.   6.3.186.  to_chars
  4417.  
  4418.   Type: string
  4419.   Default: " +TCF"
  4420.  
  4421.   Controls the character used to indicate mail addressed to you.  The
  4422.   first character is the one used when the mail is NOT addressed to your
  4423.   address (default: space).  The second is used when you are the only
  4424.   recipient of the message (default: +).  The third is when your address
  4425.   appears in the TO header field, but you are not the only recipient of
  4426.   the message (default: T).  The fourth character is used when your
  4427.   address is specified in the CC header field, but you are not the only
  4428.   recipient.  The fifth character is used to indicate mail that was sent
  4429.   by you.
  4430.  
  4431.   6.3.187.  use_8bitmime
  4432.  
  4433.   Type: boolean
  4434.   Default: no
  4435.  
  4436.   Warning: do not set this variable unless you are using a version of
  4437.   sendmail which supports the -B8BITMIME flag (such as sendmail 8.8.x)
  4438.   or you may not be able to send mail.
  4439.  
  4440.   When set, Mutt will invoke ``sendmail'' with the -B8BITMIME flag when
  4441.   sending 8-bit messages to enable ESMTP negotiation.
  4442.  
  4443.   6.3.188.  use_domain
  4444.  
  4445.   Type: boolean
  4446.   Default: yes
  4447.  
  4448.   When set, Mutt will qualify all local addresses (ones without the
  4449.   @host portion) with the value of ``hostname''.  If unset, no addresses
  4450.   will be qualified.
  4451.  
  4452.   6.3.189.  use_from
  4453.  
  4454.   Type: boolean
  4455.   Default: yes
  4456.  
  4457.   When set, Mutt will generate the `From:' header field when sending
  4458.   messages.  If unset, no `From:' header field will be generated unless
  4459.   the user explicitly sets one using the ``my_hdr'' command.
  4460.  
  4461.   6.3.190.  user_agent
  4462.  
  4463.   Type: boolean
  4464.   Default: yes
  4465.  
  4466.   When set, mutt will add a "User-Agent" header to outgoing messages,
  4467.   indicating which version of mutt was used for composing them.
  4468.  
  4469.   6.3.191.  visual
  4470.  
  4471.   Type: path
  4472.   Default: ""
  4473.  
  4474.   Specifies the visual editor to invoke when the  v command is given in
  4475.   the builtin editor.
  4476.  
  4477.   6.3.192.  wait_key
  4478.  
  4479.   Type: boolean
  4480.   Default: yes
  4481.  
  4482.   Controls whether Mutt will ask you to press a key after shell- escape,
  4483.   pipe-message, pipe-entry, print-message, and print-entry commands.
  4484.  
  4485.   It is also used when viewing attachments with ``autoview'', provided
  4486.   that the corresponding mailcap entry has a needsterminal flag, and the
  4487.   external program is interactive.
  4488.  
  4489.   When set, Mutt will always ask for a key. When unset, Mutt will wait
  4490.   for a key only if the external command returned a non-zero status.
  4491.  
  4492.   6.3.193.  weed
  4493.  
  4494.   Type: boolean
  4495.   Default: yes
  4496.  
  4497.   When set, mutt will weed headers when when displaying, forwarding,
  4498.   printing, or replying to messages.
  4499.  
  4500.   6.3.194.  wrap_search
  4501.  
  4502.   Type: boolean
  4503.   Default: yes
  4504.  
  4505.   Controls whether searches wrap around the end of the mailbox.
  4506.  
  4507.   When set, searches will wrap around the first (or last) message. When
  4508.   unset, searches will not wrap.
  4509.  
  4510.   6.3.195.  write_inc
  4511.  
  4512.   Type: number
  4513.   Default: 10
  4514.  
  4515.   When writing a mailbox, a message will be printed every write_inc
  4516.   messages to indicate progress.  If set to 0, only a single message
  4517.   will be displayed before writing a mailbox.
  4518.  
  4519.   Also see the ``read_inc'' variable.
  4520.  
  4521.   6.3.196.  write_bcc
  4522.  
  4523.   Type: boolean
  4524.   Default: yes
  4525.  
  4526.   Controls whether mutt writes out the Bcc header when preparing
  4527.   messages to be sent.  Exim users may wish to use this.
  4528.  
  4529.   6.4.  Functions
  4530.  
  4531.   The following is the list of available functions listed by the mapping
  4532.   in which they are available.  The default key setting is given, and an
  4533.   explanation of what the function does.  The key bindings of these
  4534.   functions can be changed with the ``bind'' command.
  4535.  
  4536.   6.4.1.  generic
  4537.  
  4538.   The generic menu is not a real menu, but specifies common functions
  4539.   (such as movement) available in all menus except for pager and editor.
  4540.   Changing settings for this menu will affect the default bindings for
  4541.   all menus (except as noted).
  4542.  
  4543.   bottom-page                L   move to the bottom of the page
  4544.   current-bottom     not bound   move current entry to bottom of page
  4545.   current-middle     not bound   move current entry to middle of page
  4546.   current-top        not bound   move current entry to top of page
  4547.   enter-command              :   enter a muttrc command
  4548.   exit                       q   exit this menu
  4549.   first-entry                =   move to the first entry
  4550.   half-down                  ]   scroll down 1/2 page
  4551.   half-up                    [   scroll up 1/2 page
  4552.   help                       ?   this screen
  4553.   jump                  number   jump to an index number
  4554.   last-entry                 *   move to the last entry
  4555.   middle-page                M   move to the middle of the page
  4556.   next-entry                 j   move to the next entry
  4557.   next-line                  >   scroll down one line
  4558.   next-page                  z   move to the next page
  4559.   previous-entry             k   move to the previous entry
  4560.   previous-line              <   scroll up one line
  4561.   previous-page              Z   move to the previous page
  4562.   refresh                   ^L   clear and redraw the screen
  4563.   search                     /   search for a regular expression
  4564.   search-next                n   search for next match
  4565.   search-opposite    not bound   search for next match in opposite direction
  4566.   search-reverse         ESC /   search backwards for a regular expression
  4567.   select-entry             RET   select the current entry
  4568.   shell-escape               !   run a program in a subshell
  4569.   tag-entry                  t   toggle the tag on the current entry
  4570.   tag-prefix                 ;   apply next command to tagged entries
  4571.   top-page                   H   move to the top of the page
  4572.  
  4573.   6.4.2.  index
  4574.  
  4575.   bounce-message             b   remail a message to another user
  4576.   change-folder              c   open a different folder
  4577.   change-folder-readonly ESC c   open a different folder in read only mode
  4578.   clear-flag                 W   clear a status flag from a message
  4579.   copy-message               C   copy a message to a file/mailbox
  4580.   create-alias               a   create an alias from a message sender
  4581.   decode-copy            ESC C   decode a message and copy it to a file/mailbox
  4582.   decode-save            ESC s   decode a message and save it to a file/mailbox
  4583.   delete-message             d   delete the current entry
  4584.   delete-pattern             D   delete messages matching a pattern
  4585.   delete-subthread       ESC d   delete all messages in subthread
  4586.   delete-thread             ^D   delete all messages in thread
  4587.   display-address            @   display full address of sender
  4588.   display-headers            h   display message with full headers
  4589.   display-message          RET   display a message
  4590.   edit                       e   edit the current message
  4591.   exit                       x   exit without saving changes
  4592.   extract-keys              ^K   extract PGP public keys
  4593.   fetch-mail                 G   retrieve mail from POP server
  4594.   flag-message               F   toggle a message's 'important' flag
  4595.   forget-passphrase         ^F   wipe PGP passphrase from memory
  4596.   forward-message            f   forward a message with comments
  4597.   group-reply                g   reply to all recipients
  4598.   limit                      l   show only messages matching a pattern
  4599.   list-reply                 L   reply to specified mailing list
  4600.   mail                       m   compose a new mail message
  4601.   mail-key               ESC k   mail a PGP public key
  4602.   next-new                 TAB   jump to the next new message
  4603.   next-subthread         ESC n   jump to the next subthread
  4604.   next-thread               ^N   jump to the next thread
  4605.   next-undeleted             j   move to the next undeleted message
  4606.   next-unread        not bound   jump to the next unread message
  4607.   parent-message             P   jump to parent message in thread
  4608.   pipe-message               |   pipe message/attachment to a shell command
  4609.   previous-new         ESC TAB   jump to the previous new message
  4610.   previous-page              Z   move to the previous page
  4611.   previous-subthread     ESC p   jump to previous subthread
  4612.   previous-thread           ^P   jump to previous thread
  4613.   previous-undeleted         k   move to the last undelete message
  4614.   previous-unread    not bound   jump to the previous unread message
  4615.   print-message              p   print the current entry
  4616.   query                      Q   query external program for addresses
  4617.   quit                       q   save changes to mailbox and quit
  4618.   read-subthread         ESC r   mark the current subthread as read
  4619.   read-thread               ^R   mark the current thread as read
  4620.   recall-message             R   recall a postponed message
  4621.   reply                      r   reply to a message
  4622.   save-message               s   save message/attachment to a file
  4623.   set-flag                   w   set a status flag on a message
  4624.   show-version               V   show the Mutt version number and date
  4625.   show-limit             ESC l   show currently active limit pattern, if any
  4626.   sort-mailbox               o   sort messages
  4627.   sort-reverse               O   sort messages in reverse order
  4628.   sync-mailbox               $   save changes to mailbox
  4629.   tag-pattern                T   tag messages matching a pattern
  4630.   tag-thread             ESC t   tag/untag all messages in the current thread
  4631.   toggle-new                 N   toggle a message's 'new' flag
  4632.   toggle-write               %   toggle whether the mailbox will be rewritten
  4633.   undelete-message           u   undelete the current entry
  4634.   undelete-pattern           U   undelete messages matching a pattern
  4635.   undelete-subthread     ESC u   undelete all messages in subthread
  4636.   undelete-thread           ^U   undelete all messages in thread
  4637.   untag-pattern             ^T   untag messages matching a pattern
  4638.   view-attachments           v   show MIME attachments
  4639.  
  4640.   6.4.3.  pager
  4641.  
  4642.   bottom                     $   jump to the bottom of the message
  4643.   bounce-message             b   remail a message to another user
  4644.   change-folder              c   open a different folder
  4645.   change-folder-readonly ESC c   open a different folder in read only mode
  4646.   copy-message               C   copy a message to a file/mailbox
  4647.   create-alias               a   create an alias from a message sender
  4648.   decode-copy            ESC C   decode a message and copy it to a file/mailbox
  4649.   decode-save            ESC s   decode a message and save it to a file/mailbox
  4650.   delete-message             d   delete the current entry
  4651.   delete-subthread       ESC d   delete all messages in subthread
  4652.   delete-thread             ^D   delete all messages in thread
  4653.   display-address            @   display full address of sender
  4654.   display-headers            h   display message with full headers
  4655.   edit                       e   edit the current message
  4656.   enter-command              :   enter a muttrc command
  4657.   exit                       i   return to the main-menu
  4658.   extract-keys              ^K   extract PGP public keys
  4659.   flag-message               F   toggle a message's 'important' flag
  4660.   forget-passphrase         ^F   wipe PGP passphrase from memory
  4661.   forward-message            f   forward a message with comments
  4662.   group-reply                g   reply to all recipients
  4663.   half-up            not bound   move up one-half page
  4664.   half-down          not bound   move down one-half page
  4665.   help                       ?   this screen
  4666.   list-reply                 L   reply to specified mailing list
  4667.   mail                       m   compose a new mail message
  4668.   mail-key               ESC k   mail a PGP public key
  4669.   mark-as-new                N   toggle a message's 'new' flag
  4670.   next-line                RET   scroll down one line
  4671.   next-entry                 J   move to the next entry
  4672.   next-new                 TAB   jump to the next new message
  4673.   next-page                      move to the next page
  4674.   next-subthread         ESC n   jump to the next subthread
  4675.   next-thread               ^N   jump to the next thread
  4676.   next-undeleted             j   move to the next undeleted message
  4677.   next-unread        not bound   jump to the next unread message
  4678.   parent-message             P   jump to parent message in thread
  4679.   pipe-message               |   pipe message/attachment to a shell command
  4680.   previous-line      BackSpace   scroll up one line
  4681.   previous-entry             K   move to the previous entry
  4682.   previous-new       not bound   jump to the previous new message
  4683.   previous-page              -   move to the previous page
  4684.   previous-subthread     ESC p   jump to previous subthread
  4685.   previous-thread           ^P   jump to previous thread
  4686.   previous-undeleted         k   move to the last undelete message
  4687.   previous-unread    not bound   jump to the previous unread message
  4688.   print-message              p   print the current entry
  4689.   quit                       Q   save changes to mailbox and quit
  4690.   read-subthread         ESC r   mark the current subthread as read
  4691.   read-thread               ^R   mark the current thread as read
  4692.   recall-message             R   recall a postponed message
  4693.   redraw-screen             ^L   clear and redraw the screen
  4694.   reply                      r   reply to a message
  4695.   save-message               s   save message/attachment to a file
  4696.   search                     /   search for a regular expression
  4697.   search-next                n   search for next match
  4698.   search-opposite    not bound   search for next match in opposite direction
  4699.   search-reverse         ESC /   search backwards for a regular expression
  4700.   search-toggle              \   toggle search pattern coloring
  4701.   shell-escape               !   invoke a command in a subshell
  4702.   show-version               V   show the Mutt version number and date
  4703.   skip-quoted                S   skip beyond quoted text
  4704.   tag-message                t   tag a message
  4705.   toggle-quoted              T   toggle display of quoted text
  4706.   top                        ^   jump to the top of the message
  4707.   undelete-message           u   undelete the current entry
  4708.   undelete-subthread     ESC u   undelete all messages in subthread
  4709.   undelete-thread           ^U   undelete all messages in thread
  4710.   view-attachments           v   show MIME attachments
  4711.  
  4712.   6.4.4.  alias
  4713.  
  4714.   search                     /   search for a regular expression
  4715.   search-next                n   search for next match
  4716.   search-reverse         ESC /   search backwards for a regular expression
  4717.  
  4718.   6.4.5.  query
  4719.  
  4720.   create-alias               a   create an alias from a message sender
  4721.   mail                       m   compose a new mail message
  4722.   query                      Q   query external program for addresses
  4723.   query-append               A   append new query results to current results
  4724.   search                     /   search for a regular expression
  4725.   search-next                n   search for next match
  4726.   search-opposite    not bound   search for next match in opposite direction
  4727.   search-reverse         ESC /   search backwards for a regular expression
  4728.  
  4729.   6.4.6.  attach
  4730.  
  4731.   bounce-message             b   remail a message to another user
  4732.   decode-copy            ESC C   decode a message and copy it to a file/mailbox
  4733.   decode-save            ESC s   decode a message and save it to a file/mailbox
  4734.   delete-entry               d   delete the current entry
  4735.   display-headers            h   display message with full headers
  4736.   extract-keys              ^K   extract PGP public keys
  4737.   forward-message            f   forward a message with comments
  4738.   group-reply                g   reply to all recipients
  4739.   list-reply                 L   reply to specified mailing list
  4740.   pipe-entry                 |   pipe message/attachment to a shell command
  4741.   print-entry                p   print the current entry
  4742.   reply                      r   reply to a message
  4743.   save-entry                 s   save message/attachment to a file
  4744.   undelete-entry             u   undelete the current entry
  4745.   view-attach              RET   view attachment using mailcap entry if necessary
  4746.   view-mailcap               m   force viewing of attachment using mailcap
  4747.   view-text                  T   view attachment as text
  4748.  
  4749.   6.4.7.  compose
  4750.  
  4751.   attach-file                a   attach a file(s) to this message
  4752.   attach-message             A   attach message(s) to this message
  4753.   attach-key             ESC k   attach a PGP public key
  4754.   copy-file                  C   save message/attachment to a file
  4755.   detach-file                D   delete the current entry
  4756.   display-headers            h   display message with full headers
  4757.   edit-bcc                   b   edit the BCC list
  4758.   edit-cc                    c   edit the CC list
  4759.   edit-description           d   edit attachment description
  4760.   edit-encoding             ^E   edit attachment trasfer-encoding
  4761.   edit-fcc                   f   enter a file to save a copy of this message in
  4762.   edit-from              ESC f   edit the from: field
  4763.   edit-file               ^X e   edit the file to be attached
  4764.   edit-headers               E   edit the message with headers
  4765.   edit-message               e   edit the message
  4766.   edit-mime                  m   edit attachment using mailcap entry
  4767.   edit-reply-to              r   edit the Reply-To field
  4768.   edit-subject               s   edit the subject of this message
  4769.   edit-to                    t   edit the TO list
  4770.   edit-type                 ^T   edit attachment type
  4771.   filter-entry               F   filter attachment through a shell command
  4772.   forget-passphrase         ^F   wipe PGP passphrase from memory
  4773.   ispell                     i   run ispell on the message
  4774.   new-mime                   n   compose new attachment using mailcap entry
  4775.   pgp-menu                   p   show PGP options
  4776.   pipe-entry                 |   pipe message/attachment to a shell command
  4777.   postpone-message           P   save this message to send later
  4778.   print-entry                l   print the current entry
  4779.   rename-file                R   rename/move an attached file
  4780.   send-message               y   send the message
  4781.   toggle-unlink              u   toggle whether to delete file after sending it
  4782.   view-attach              RET   view attachment using mailcap entry if necessary
  4783.   write-fcc                  w   write the message to a folder
  4784.  
  4785.   6.4.8.  postpone
  4786.  
  4787.   delete-entry               d   delete the current entry
  4788.   undelete-entry             u   undelete the current entry
  4789.  
  4790.   6.4.9.  browser
  4791.  
  4792.   change-dir                 c   change directories
  4793.   check-new                TAB   check mailboxes for new mail
  4794.   enter-mask                 m   enter a file mask
  4795.   search                     /   search for a regular expression
  4796.   search-next                n   search for next match
  4797.   search-reverse         ESC /   search backwards for a regular expression
  4798.   select-new                 N   select a new file in this directory
  4799.   sort                       o   sort messages
  4800.   sort-reverse               O   sort messages in reverse order
  4801.   toggle-mailboxes         TAB   toggle whether to browse mailboxes or all files
  4802.   view-file              SPACE   view file
  4803.  
  4804.   6.4.10.  pgp
  4805.  
  4806.   view-name                  %   view the key's user id
  4807.   verify-key                 c   verify a PGP public key
  4808.  
  4809.   6.4.11.  editor
  4810.  
  4811.   backspace          BackSpace   delete the char in front of the cursor
  4812.   backward-char             ^B   move the cursor one character to the left
  4813.   bol                       ^A   jump to the beginning of the line
  4814.   buffy-cycle            Space   cycle among incoming mailboxes
  4815.   complete                 TAB   complete filename or alias
  4816.   complete-query            ^T   complete address with query
  4817.   delete-char               ^D   delete the char under the cursor
  4818.   eol                       ^E   jump to the end of the line
  4819.   forward-char              ^F   move the cursor one character to the right
  4820.   history-down       not bound   scroll up through the history list
  4821.   history-up         not bound   scroll up through the history list
  4822.   kill-eol                  ^K   delete chars from cursor to end of line
  4823.   kill-line                 ^U   delete all chars on the line
  4824.   kill-word                 ^W   delete the word in front of the cursor
  4825.   quote-char                ^V   quote the next typed key
  4826.  
  4827.   7.  Miscellany
  4828.  
  4829.   7.1.  Acknowledgements
  4830.  
  4831.   Kari Hurtta <kari.hurtta@fmi.fi> co-developed the original MIME
  4832.   parsing code back in the ELM-ME days.
  4833.  
  4834.   The following people have been very helpful to the development of
  4835.   Mutt:
  4836.  
  4837.   Vikas Agnihotri <vikasa@writeme.com>,
  4838.   Francois Berjon <Francois.Berjon@aar.alcatel-alsthom.fr>,
  4839.   Aric Blumer <aric@fore.com>,
  4840.   John Capo <jc@irbs.com>,
  4841.   Liviu Daia <daia@stoilow.imar.ro>,
  4842.   David DeSimone <fox@convex.hp.com>,
  4843.   Nickolay N. Dudorov <nnd@wint.itfs.nsk.su>,
  4844.   Michael Finken <finken@conware.de>,
  4845.   Sven Guckes <guckes@math.fu-berlin.de>,
  4846.   Mark Holloman <holloman@nando.net>,
  4847.   Andreas Holzmann <holzmann@fmi.uni-passau.de>,
  4848.   Byrial Jensen <byrial@image.dk>,
  4849.   David Jeske <jeske@igcom.net>,
  4850.   Christophe Kalt <kalt@hugo.int-evry.fr>,
  4851.   Felix von Leitner (a.k.a ``Fefe'') <leitner@math.fu-berlin.de>,
  4852.   Brandon Long <blong@fiction.net>,
  4853.   Jimmy Mäkelä <jmy@flashback.net>,
  4854.   Lars Marowsky-Bree <lmb@pointer.in-minden.de>,
  4855.   Thomas ``Mike'' Michlmayr <mike@cosy.sbg.ac.at>,
  4856.   David O'Brien <obrien@Nuxi.cs.ucdavis.edu>,
  4857.   Clint Olsen <olsenc@ichips.intel.com>,
  4858.   Park Myeong Seok <pms@romance.kaist.ac.kr>,
  4859.   Thomas Parmelan <tom@ankh.fr.eu.org>,
  4860.   Ollivier Robert <roberto@keltia.freenix.fr>,
  4861.   Roland Rosenfeld <roland@spinnaker.rhein.de>,
  4862.   Allain Thivillon <Allain.Thivillon@alma.fr>,
  4863.   Gero Treuner <gero@faveve.uni-stuttgart.de>,
  4864.   Ken Weinert <kenw@ihs.com>
  4865.  
  4866.   7.2.  About this document
  4867.  
  4868.   This document was written in SGML, and then rendered using the sgml-
  4869.   tools package.
  4870.  
  4871.