X-Git-Url: http://git.madism.org/?a=blobdiff_plain;f=doc%2Fmanual.txt;h=f6dd5afd370bce6985f42d777c94a7cfc0610795;hb=710039d784d5fbda9371cd1d94f61ed5ff799216;hp=9e08514252f34f492c084374e0ba5563cac12ac0;hpb=02287931a05492f543247342c389d0a6e8bd8a00;p=apps%2Fmadmutt.git diff --git a/doc/manual.txt b/doc/manual.txt index 9e08514..f6dd5af 100644 --- a/doc/manual.txt +++ b/doc/manual.txt @@ -8,7 +8,7 @@ - version devel-r473 + version devel-r541 Abstract @@ -37,6 +37,8 @@ 7. Copyright + 8. Manual Conventions + 2. Getting Started 1. Basic Concepts @@ -292,7 +294,9 @@ 5. MIME Multipart/Alternative - 6. MIME Lookup + 6. Attachment Searching and Counting + + 7. MIME Lookup 6. Security Considerations @@ -346,43 +350,67 @@ 5.11. editor - 8. Miscellany + 5.12. sidebar - 1. Acknowledgments + A. Acknowledgments + + B. Hacking Documentation Index List of Tables - 2.1. Default Menu Movement Keys + 2.1. Most commonly used movement bindings - 2.2. Built-In Editor Functions + 2.2. Line Editor Functions - 2.3. Default Index Menu Bindings + 2.3. Most commonly used Index Bindings - 2.4. Default Pager Menu Bindings + 2.4. Most commonly used Pager Bindings 2.5. ANSI Escape Sequences 2.6. ANSI Colors - 2.7. Default Thread Function Bindings + 2.7. Most commonly used thread-related bindings - 2.8. Default Mail Composition Bindings + 2.8. Most commonly used Mail Composition Bindings - 2.9. Default Compose Menu Bindings + 2.9. Most commonly used Compose Menu Bindings 2.10. PGP Key Menu Flags 3.1. Alternative Key Names - 4.1. Default Sidebar Function Bindings + 7.1. Reference: Command Line Options + + 7.2. Reference: Patterns + + 7.3. Reference: Obsolete Variables + + 7.4. Reference: Default Generic Function Bindings + + 7.5. Reference: Default Index Function Bindings + + 7.6. Reference: Default Pager Function Bindings - 7.1. Mutt-NG Command Line Options + 7.7. Reference: Default Alias Menu Function Bindings - 7.2. Patterns + 7.8. Reference: Default Query Menu Function Bindings - 7.3. Obsolete Variables + 7.9. Reference: Default Attachment Menu Function Bindings + + 7.10. Reference: Default Compose Menu Function Bindings + + 7.11. Reference: Default Postpone Menu Function Bindings + + 7.12. Reference: Default Browser Menu Function Bindings + + 7.13. Reference: Default PGP Menu Function Bindings + + 7.14. Reference: Default Editor Function Bindings + + 7.15. Referene: Default Sidebar Function Bindings Chapter 1. Introduction @@ -402,6 +430,8 @@ Chapter 1. Introduction 7. Copyright + 8. Manual Conventions + 1. Overview Mutt-ng is a small but very powerful text-based MIME mail client. Mutt-ng @@ -420,7 +450,7 @@ Chapter 1. Introduction 2. Mutt-ng Home Page - http://www.muttng.org + 3. Mailing Lists @@ -433,7 +463,7 @@ Chapter 1. Introduction 4. Software Distribution Sites So far, there are no official releases of Mutt-ng, but you can download - daily snapshots from http://mutt-ng.berlios.de/snapshots/ + daily snapshots from 5. IRC @@ -463,8 +493,35 @@ Chapter 1. Introduction for more details. You should have received a copy of the GNU General Public License along - with this program; if not, write to the Free Software Foundation, Inc., 59 - Temple Place - Suite 330, Boston, MA 02111, USA. + with this program; if not, write to the Free Software Foundation, Inc., 51 + Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. + +8. Manual Conventions + + This manual contains several (hopefully consistent) conventions to + specially layout different items in different fashions. + + o Configuration and environment variables will be printed in a + typewriter font and both prefixed with a dollar sign as it's common + for UNIX-like environments. Configuration variables are lower-case + only while environment variables are upper-case only. $imap_mail_check + is a configuration variable while $EDITOR is an environment variable. + + o Muttng-specific functions are enclosed in <> and printed in a + typewriter font, too, as in . + + o As common for UNIX-like environments, references to manual pages are + printed with the section enclosed in braces, as in vi(1) or + muttngrc(5). Execute man [section] [name] to view the manual page. + + o Keys are presented in the following way: ordinary keys are just given + as-is, e.g. q. Control characters are prefixed with C- (e.g. the + screen can be redraw by pressing C-L) and E- for Escape, e.g. a folder + can be opened read-only with E-c. + + If, while reading this fine manual, you find any inconsistencies of + whatever kind, please contact the developers via + to report it. Chapter 2. Getting Started @@ -727,28 +784,17 @@ Chapter 2. Getting Started Information is presented in menus, very similar to ELM. Here is a tableshowing the common keys used to navigate menus in Mutt-ng. - Table 2.1. Default Menu Movement Keys - - +------------------------------------------------------------------------+ - | Key | Function | Description | - |-------------+----------------+-----------------------------------------| - | j or Down | next-entry | move to the next entry | - |-------------+----------------+-----------------------------------------| - | k or Up | previous-entry | move to the previous entry | - |-------------+----------------+-----------------------------------------| - | z or PageDn | page-down | go to the next page | - |-------------+----------------+-----------------------------------------| - | Z or PageUp | page-up | go to the previous page | - |-------------+----------------+-----------------------------------------| - | = or Home | first-entry | jump to the first entry | - |-------------+----------------+-----------------------------------------| - | * or End | last-entry | jump to the last entry | - |-------------+----------------+-----------------------------------------| - | q | quit | exit the current menu | - |-------------+----------------+-----------------------------------------| - | ? | help | list all key bindings for the current | - | | | menu | - +------------------------------------------------------------------------+ + Table 2.1. Most commonly used movement bindings + + Key Function Description + j or Down move to the next entry + k or Up move to the previous entry + z or PageDn go to the next page + Z or PageUp go to the previous page + = or Home jump to the first entry + * or End jump to the last entry + q exit the current menu + ? list all key bindings for the current menu 4. Editing Input Fields @@ -756,57 +802,31 @@ Chapter 2. Getting Started input textual data such as email addresses or filenames. The keys used to move around while editing are very similar to those of Emacs. - Table 2.2. Built-In Editor Functions - - +------------------------------------------------------------------------+ - | Key | Function | Description | - |----------------+-----------------+-------------------------------------| - | ^A or | bol | move to the start of the line | - |----------------+-----------------+-------------------------------------| - | ^B or | backward-char | move back one char | - |----------------+-----------------+-------------------------------------| - | Esc B | backward-word | move back one word | - |----------------+-----------------+-------------------------------------| - | ^D or | delete-char | delete the char under the cursor | - |----------------+-----------------+-------------------------------------| - | ^E or | eol | move to the end of the line | - |----------------+-----------------+-------------------------------------| - | ^F or | forward-char | move forward one char | - |----------------+-----------------+-------------------------------------| - | Esc F | forward-word | move forward one word | - |----------------+-----------------+-------------------------------------| - | | complete | complete filename or alias | - |----------------+-----------------+-------------------------------------| - | ^T | complete-query | complete address with query | - |----------------+-----------------+-------------------------------------| - | ^K | kill-eol | delete to the end of the line | - |----------------+-----------------+-------------------------------------| - | ESC d | kill-eow | delete to the end of the word | - |----------------+-----------------+-------------------------------------| - | ^W | kill-word | kill the word in front of the | - | | | cursor | - |----------------+-----------------+-------------------------------------| - | ^U | kill-line | delete entire line | - |----------------+-----------------+-------------------------------------| - | ^V | quote-char | quote the next typed key | - |----------------+-----------------+-------------------------------------| - | | history-up | recall previous string from history | - |----------------+-----------------+-------------------------------------| - | | history-down | recall next string from history | - |----------------+-----------------+-------------------------------------| - | | backspace | kill the char in front of the | - | | | cursor | - |----------------+-----------------+-------------------------------------| - | Esc u | upcase-word | convert word to upper case | - |----------------+-----------------+-------------------------------------| - | Esc l | downcase-word | convert word to lower case | - |----------------+-----------------+-------------------------------------| - | Esc c | capitalize-word | capitalize the word | - |----------------+-----------------+-------------------------------------| - | ^G | n/a | abort | - |----------------+-----------------+-------------------------------------| - | | n/a | finish editing | - +------------------------------------------------------------------------+ + Table 2.2. Line Editor Functions + + Key Function Description + C-A or Home move to the start of the line + C-B or Left move back one char + E-B move back one word + C-D or Delete delete the char under the cursor + C-E or End move to the end of the line + C-F or Right move forward one char + E-F move forward one word + Tab complete filename or alias + C-T complete address with query + C-K delete to the end of the line + E-d delete to the end of the word + C-W kill the word in front of the cursor + C-U delete entire line + C-V quote the next typed key + Up recall previous string from history + Down recall next string from history + BackSpace kill the char in front of the cursor + E-u convert word to upper case + E-l convert word to lower case + E-c capitalize the word + C-G abort + Return finish editing You can remap the editor functions using the bind command. For example, to make the Delete key delete the character in front of the cursor rather @@ -826,69 +846,38 @@ Chapter 2. Getting Started 5.1. The Message Index - Table 2.3. Default Index Menu Bindings - - +-------------------------------------------------------------------+ - | Key | Function | Description | - |----------+----------+---------------------------------------------| - | c | | change to a different mailbox | - |----------+----------+---------------------------------------------| - | ESC c | | change to a folder in read-only mode | - |----------+----------+---------------------------------------------| - | C | | copy the current message to another mailbox | - |----------+----------+---------------------------------------------| - | ESC C | | decode a message and copy it to a folder | - |----------+----------+---------------------------------------------| - | ESC s | | decode a message and save it to a folder | - |----------+----------+---------------------------------------------| - | D | | delete messages matching a pattern | - |----------+----------+---------------------------------------------| - | d | | delete the current message | - |----------+----------+---------------------------------------------| - | F | | mark as important | - |----------+----------+---------------------------------------------| - | l | | show messages matching a pattern | - |----------+----------+---------------------------------------------| - | N | | mark message as new | - |----------+----------+---------------------------------------------| - | o | | change the current sort method | - |----------+----------+---------------------------------------------| - | O | | reverse sort the mailbox | - |----------+----------+---------------------------------------------| - | q | | save changes and exit | - |----------+----------+---------------------------------------------| - | s | | save-message | - |----------+----------+---------------------------------------------| - | T | | tag messages matching a pattern | - |----------+----------+---------------------------------------------| - | t | | toggle the tag on a message | - |----------+----------+---------------------------------------------| - | ESC t | | toggle tag on entire message thread | - |----------+----------+---------------------------------------------| - | U | | undelete messages matching a pattern | - |----------+----------+---------------------------------------------| - | u | | undelete-message | - |----------+----------+---------------------------------------------| - | v | | view-attachments | - |----------+----------+---------------------------------------------| - | x | | abort changes and exit | - |----------+----------+---------------------------------------------| - | | | display-message | - |----------+----------+---------------------------------------------| - | | | jump to the next new or unread message | - |----------+----------+---------------------------------------------| - | @ | | show the author's full e-mail address | - |----------+----------+---------------------------------------------| - | $ | | save changes to mailbox | - |----------+----------+---------------------------------------------| - | / | | search | - |----------+----------+---------------------------------------------| - | ESC / | | search-reverse | - |----------+----------+---------------------------------------------| - | ^L | | clear and redraw the screen | - |----------+----------+---------------------------------------------| - | ^T | | untag messages matching a pattern | - +-------------------------------------------------------------------+ + Table 2.3. Most commonly used Index Bindings + + Key Function Description + c change to a different mailbox + E-c change to a folder in read-only mode + C copy the current message to another mailbox + E-C decode a message and copy it to a folder + E-s decode a message and save it to a folder + D delete messages matching a pattern + d delete the current message + F mark as important + l show messages matching a pattern + N mark message as new + o change the current sort method + O reverse sort the mailbox + q save changes and exit + s save-message + T tag messages matching a pattern + t toggle the tag on a message + E-t toggle tag on entire message thread + U undelete messages matching a pattern + u undelete-message + v view-attachments + x abort changes and exit + Return display-message + Tab jump to the next new or unread message + @ show the author's full e-mail address + $ save changes to mailbox + / search + E-/ search-reverse + C-L clear and redraw the screen + C-T untag messages matching a pattern 5.1.1. Status Flags @@ -975,34 +964,21 @@ Chapter 2. Getting Started messages. The pager is very similar to the Unix program less though not nearly as featureful. - Table 2.4. Default Pager Menu Bindings - - +------------------------------------------------------------------------+ - | Key | Function | Description | - |----------+----------+--------------------------------------------------| - | | | go down one line | - |----------+----------+--------------------------------------------------| - | | | display the next page (or next message if at the | - | | | end of a message) | - |----------+----------+--------------------------------------------------| - | - | | go back to the previous page | - |----------+----------+--------------------------------------------------| - | n | | search for next match | - |----------+----------+--------------------------------------------------| - | S | | skip beyond quoted text | - |----------+----------+--------------------------------------------------| - | T | | toggle display of quoted text | - |----------+----------+--------------------------------------------------| - | ? | | show key bindings | - |----------+----------+--------------------------------------------------| - | / | | search for a regular expression (pattern) | - |----------+----------+--------------------------------------------------| - | ESC / | | search backwards for a regular expression | - |----------+----------+--------------------------------------------------| - | \ | | toggle search pattern coloring | - |----------+----------+--------------------------------------------------| - | ^ | | jump to the top of the message | - +------------------------------------------------------------------------+ + Table 2.4. Most commonly used Pager Bindings + + Key Function Description + Return go down one line + Space display the next page (or next message if at the end of a + message) + - go back to the previous page + n search for next match + S skip beyond quoted text + T toggle display of quoted text + ? show key bindings + / search for a regular expression (pattern) + E-/ search backwards for a regular expression + \ toggle search pattern coloring + ^ jump to the top of the message In addition, many of the functions from the index are available in the pager, such as delete-message or copy-message (this is one advantage over @@ -1011,8 +987,8 @@ Chapter 2. Getting Started Also, the internal pager supports a couple other advanced features. For one, it will accept and translate the ``standard'' nroff sequences forbold and underline. These sequences are a series of either the letter, - backspace (^H), the letter again for bold or the letter, backspace, ``_'' - for denoting underline. Mutt-ng will attempt to display these in bold and + backspace (C-H), the letter again for bold or the letter, backspace, _ for + denoting underline. Mutt-ng will attempt to display these in bold and underline respectively if your terminal supports them. If not, you can use the bold and underline color objects to specify a color or mono attribute for them. @@ -1024,48 +1000,29 @@ Chapter 2. Getting Started Table 2.5. ANSI Escape Sequences - +-------------------------------------------------+ - | Value | Attribute | - |-------+-----------------------------------------| - | 0 | All Attributes Off | - |-------+-----------------------------------------| - | 1 | Bold on | - |-------+-----------------------------------------| - | 4 | Underline on | - |-------+-----------------------------------------| - | 5 | Blink on | - |-------+-----------------------------------------| - | 7 | Reverse video on | - |-------+-----------------------------------------| - | 3x | Foreground color is x (see table below) | - |-------+-----------------------------------------| - | 4x | Background color is x (see table below) | - +-------------------------------------------------+ + Value Attribute + 0 All Attributes Off + 1 Bold on + 4 Underline on + 5 Blink on + 7 Reverse video on + 3x Foreground color is x (see table below) + 4x Background color is x (see table below) Table 2.6. ANSI Colors - +------------------+ - | Number | Color | - |--------+---------| - | 0 | black | - |--------+---------| - | 1 | red | - |--------+---------| - | 2 | green | - |--------+---------| - | 3 | yellow | - |--------+---------| - | 4 | blue | - |--------+---------| - | 5 | magenta | - |--------+---------| - | 6 | cyan | - |--------+---------| - | 7 | white | - +------------------+ + Number Color + 0 black + 1 red + 2 green + 3 yellow + 4 blue + 5 magenta + 6 cyan + 7 white Mutt-ng uses these attributes for handling text/enriched messages, and - they can also be used by an external autoview script for highlighting + they can also be used by an external auto_view script for highlighting purposes. Note: If you change the colors for your display, for example by changing the color associated with color2 for your xterm, then that color will be used instead of green. @@ -1075,84 +1032,66 @@ Chapter 2. Getting Started When the mailbox is sorted by threads ,there are a few additional functions available in the index and pager modes. - Table 2.7. Default Thread Function Bindings - - +------------------------------------------------------------------------+ - | Key | Function | Description | - |-------+--------------------+-------------------------------------------| - | ^D | delete-thread | delete all messages in the current thread | - |-------+--------------------+-------------------------------------------| - | ^U | undelete-thread | undelete all messages in the current | - | | | thread | - |-------+--------------------+-------------------------------------------| - | ^N | next-thread | jump to the start of the next thread | - |-------+--------------------+-------------------------------------------| - | ^P | previous-thread | jump to the start of the previous thread | - |-------+--------------------+-------------------------------------------| - | ^R | read-thread | mark the current thread as read | - |-------+--------------------+-------------------------------------------| - | ESC d | delete-subthread | delete all messages in the current | - | | | subthread | - |-------+--------------------+-------------------------------------------| - | ESC u | undelete-subthread | undelete all messages in the current | - | | | subthread | - |-------+--------------------+-------------------------------------------| - | ESC n | next-subthread | jump to the start of the next subthread | - |-------+--------------------+-------------------------------------------| - | ESC p | previous-subthread | jump to the start of the previous | - | | | subthread | - |-------+--------------------+-------------------------------------------| - | ESC r | read-subthread | mark the current subthread as read | - |-------+--------------------+-------------------------------------------| - | ESC t | tag-thread | toggle the tag on the current thread | - |-------+--------------------+-------------------------------------------| - | ESC v | collapse-thread | toggle collapse for the current thread | - |-------+--------------------+-------------------------------------------| - | ESC V | collapse-all | toggle collapse for all threads | - |-------+--------------------+-------------------------------------------| - | P | parent-message | jump to parent message in thread | - +------------------------------------------------------------------------+ + Table 2.7. Most commonly used thread-related bindings + + Key Function Description + C-D delete all messages in the current thread + C-U undelete all messages in the current thread + C-N jump to the start of the next thread + C-P jump to the start of the previous thread + C-R mark the current thread as read + E-d delete all messages in the current subthread + E-u undelete all messages in the current subthread + E-n jump to the start of the next subthread + E-p jump to the start of the previous subthread + E-r mark the current subthread as read + E-t toggle the tag on the current thread + E-v toggle collapse for the current thread + E-V toggle collapse for all threads + P jump to parent message in thread Note: Collapsing a thread displays only the first message in the thread and hides the others. This is useful when threads contain so many messages that you can only see a handful of threads onthe screen. See %M in - index-format . For example, you could use "%?M?(#%03M)&(%4l)?" in - index-format to optionally display the number of hidden messages if the - thread is collapsed. + $index_format. + + For example, you could use %?M?(#%03M)&(%4l)? in $index_format to + optionally display the number of hidden messages if the thread is + collapsed. - See also: strict-threads. + See also the $strict_threads variable. 5.4. Miscellaneous Functions - create-alias (default: a) + (default: a) Creates a new alias based upon the current message (or prompts for a new one). Once editing is complete, an alias command is added to the file - specified by the alias-file variable for future use. Note: Specifying an - alias-file does not add the aliases specified there-in, you must also + specified by the $alias_file variable for future use. Note: Specifying an + $alias_file does not add the aliases specified there-in, you must also source the file. - check-traditional-pgp (default: ESC P) + (default: E-P) This function will search the current message for content signed or encrypted with PGP the "traditional" way, that is, without proper MIME tagging. Technically, this function will temporarily change the MIME content types of the body parts containing PGP data; this is similar to - the edit-type function's effect. + the function's effect. - display-toggle-weed (default: h) + (default: h) Toggles the weeding of message header fields specified by ignore commands. - edit (default: e) + (default: e) This command (available in the ``index'' and ``pager'') allows you to edit the raw current message as it's present in the mail folder. After you have finished editing, the changed message will be appended to the current folder, and the original message will be marked for deletion. - edit-type (default: ^E on the attachment menu, and in the pager and index - menus; ^T on the compose menu) + (default: ) (default: C-E on the attachment menu, and in the + pager and index menus; C-T on the compose menu) This command is used to temporarily edit an attachment's content type to fix, for instance, bogus character set parameters. When invoked from the @@ -1164,65 +1103,65 @@ Chapter 2. Getting Started Note that this command is also available on the compose-menu .There, it's used to fine-tune the properties of attachments you are going to send. - enter-command (default: ``:'') + (default: :) This command is used to execute any command you would normally put in a configuration file. A common use is to check the settings of variables, or in conjunction with macro to change settings on the fly. - extract-keys (default: ^K) + (default: C-K) This command extracts PGP public keys from the current or tagged message(s) and adds them to your PGP public key ring. - forget-passphrase (default: ^F) + (default: C-F) This command wipes the passphrase(s) from memory. It is useful, if you misspelled the passphrase. - list-reply (default: L) + (default: L) Reply to the current or tagged message(s) by extracting any addresses which match the regular expressions given by the lists commands, but also - honor any Mail-Followup-To header(s) if the honor-followup-to + honor any Mail-Followup-To header(s) if the $honor_followup_to configuration variable is set. Using this when replying to messages posted to mailing lists helps avoid duplicate copies being sent to the author of the message you are replying to. - pipe-message (default: |) + (default: ) Asks for an external Unix command and pipes the current or tagged - message(s) to it. The variables pipe-decode ,pipe-split, pipe-sep and - wait-key control the exact behavior of this function. + message(s) to it. The variables $pipe_decode, $pipe_split, $pipe_decode + and $wait_key control the exact behavior of this function. - resend-message (default: ESC e) + (default: E-e) With resend-message, mutt takes the current message as a template for a new message. This function is best described as "recall from arbitrary folders". It can conveniently be used to forward MIME messages while preserving the original mail structure. Note that the amount of headers - included here depends on the value of the weed variable. + included here depends on the value of the $weed variable. This function is also available from the attachment menu. You can use this to easily resend a message which was included with a bounce message as a message/rfc822 body part. - shell-escape (default: !) + (default: !) - Asks for an external Unix command and executes it. The wait-key can be + Asks for an external Unix command and executes it. The $wait_key can be used to control whether Mutt-ng will wait for a key to be pressed when the command returns (presumably to let the user read the output of the command), based on the return status of the named command. - toggle-quoted (default: T) + (default: T) - The pager uses the quote-regexp variable to detect quoted text when + The pager uses the $quote_regexp variable to detect quoted text when displaying the body of the message. This function toggles the displayof the quoted material in the message. It is particularly useful when are interested in just the response and there is a large amount of quoted text in the way. - skip-quoted (default: S) + (default: S) This function will go to the next line of non-quoted text which come after a line of quoted text in the internal pager. @@ -1231,30 +1170,21 @@ Chapter 2. Getting Started The following bindings are available in the index for sending messages. - Table 2.8. Default Mail Composition Bindings - - +--------------------------------------------------------+ - | Key | Function | Description | - |-------+-------------+----------------------------------| - | m | compose | compose a new message | - |-------+-------------+----------------------------------| - | r | reply | reply to sender | - |-------+-------------+----------------------------------| - | g | group-reply | reply to all recipients | - |-------+-------------+----------------------------------| - | L | list-reply | reply to mailing list address | - |-------+-------------+----------------------------------| - | f | forward | forward message | - |-------+-------------+----------------------------------| - | b | bounce | bounce (remail) message | - |-------+-------------+----------------------------------| - | ESC k | mail-key | mail a PGP public key to someone | - +--------------------------------------------------------+ + Table 2.8. Most commonly used Mail Composition Bindings + + Key Function Description + m compose a new message + r reply to sender + g reply to all recipients + L reply to mailing list address + f forward message + b bounce (remail) message + E-k mail a PGP public key to someone Bouncing a message sends the message as is to the recipient you specify. Forwarding a message allows you to add comments or modify the message you are forwarding. These items are discussed in greater detail in the next - chapter forwarding-mail . + chapter forwarding-mail. 6.1. Composing new messages @@ -1282,9 +1212,9 @@ Chapter 2. Getting Started first looks whether the environment variable $VISUAL is set, and if so, it takes its value as editor command. Otherwise, it has a look at $EDITOR and takes its value if it is set. If no editor command can be found, mutt-ng - simply assumes vi to be the default editor, since it's the most widespread - editor in the Unix world and it's pretty safe to assume that it is - installed and available. + simply assumes vi(1) to be the default editor, since it's the most + widespread editor in the Unix world and it's pretty safe to assume that it + is installed and available. When you've finished entering your message, save it and quit your editor. Mutt-ng will then present you with a summary screen, the compose menu. On @@ -1315,58 +1245,35 @@ Chapter 2. Getting Started Once you have finished editing the body of your mail message, you are returned to the compose menu. The following options are available: - Table 2.9. Default Compose Menu Bindings - - +------------------------------------------------------------------------+ - | Key | Function | Description | - |-------+-------------------+--------------------------------------------| - | a | attach-file | attach a file | - |-------+-------------------+--------------------------------------------| - | A | attach-message | attach message(s) to the message | - |-------+-------------------+--------------------------------------------| - | ESC k | attach-key | attach a PGP public key | - |-------+-------------------+--------------------------------------------| - | d | edit-description | edit description on attachment | - |-------+-------------------+--------------------------------------------| - | D | detach-file | detach a file | - |-------+-------------------+--------------------------------------------| - | t | edit-to | edit the To field | - |-------+-------------------+--------------------------------------------| - | ESC f | edit-from | edit the From field | - |-------+-------------------+--------------------------------------------| - | r | edit-reply-to | edit the Reply-To field | - |-------+-------------------+--------------------------------------------| - | c | edit-cc | edit the Cc field | - |-------+-------------------+--------------------------------------------| - | b | edit-bcc | edit the Bcc field | - |-------+-------------------+--------------------------------------------| - | y | send-message | send the message | - |-------+-------------------+--------------------------------------------| - | s | edit-subject | edit the Subject | - |-------+-------------------+--------------------------------------------| - | S | smime-menu | select S/MIME options | - |-------+-------------------+--------------------------------------------| - | f | edit-fcc | specify an ``Fcc'' mailbox | - |-------+-------------------+--------------------------------------------| - | p | pgp-menu | select PGP options | - |-------+-------------------+--------------------------------------------| - | P | postpone-message | postpone this message until later | - |-------+-------------------+--------------------------------------------| - | q | quit | quit (abort) sending the message | - |-------+-------------------+--------------------------------------------| - | w | write-fcc | write the message to a folder | - |-------+-------------------+--------------------------------------------| - | i | ispell | check spelling (if available on your | - | | | system) | - |-------+-------------------+--------------------------------------------| - | ^F | forget-passphrase | wipe passphrase(s) from memory | - +------------------------------------------------------------------------+ + Table 2.9. Most commonly used Compose Menu Bindings + + Key Function Description + a attach a file + A attach message(s) to the message + E-k attach a PGP public key + d edit description on attachment + D detach a file + t edit the To field + E-f edit the From field + r edit the Reply-To field + c edit the Cc field + b edit the Bcc field + y send the message + s edit the Subject + S select S/MIME options + f specify an ``Fcc'' mailbox + p select PGP options + P postpone this message until later + q quit (abort) sending the message + w write the message to a folder + i check spelling (if available on your system) + C-F wipe passphrase(s) from memory Note: The attach-message function will prompt you for a folder to attach messages from. You can now tag messages in that folder and theywill be attached to the message you are sending. Note that certainoperations like composing a new mail, replying, forwarding, etc. are not permitted when - you are in that folder. The %r in status-format will change to a 'A' to + you are in that folder. The %r in $status_format will change to a 'A' to indicate that you are in attach-message mode. 6.2. Replying @@ -1451,27 +1358,30 @@ Chapter 2. Getting Started When editing the header of your outgoing message, there are a couple of special features available. - If you specify Fcc: filename Mutt-ng will pick up filename just as if you + If you specify Fcc:filename Mutt-ng will pick up filename just as if you had used the edit-fcc function in the compose menu. - You can also attach files to your message by specifying Attach: filename [ - description ] where filename is the file to attach and description is an - optional string to use as the description of the attached file. + You can also attach files to your message by specifying + + Attach: filename [description] + + where filename is the file to attach and description is an optional string + to use as the description of the attached file. When replying to messages, if you remove the In-Reply-To: field from the header field, Mutt-ng will not generate a References: field, which allows you to create a new message thread. - Also see edit-headers. + Also see the $edit_headers and $editor_headers variables 6.4. Using Mutt-ng with PGP If you want to use PGP, you can specify - Pgp: [ E | S | S ] + Pgp: [E | S | S id] ``E'' encrypts, ``S'' signs and ``S'' signs with the given key, - setting pgp-sign-as permanently. + setting $pgp_sign_as permanently. If you have told mutt to PGP encrypt a message, it will guide you through a key selection process when you try to send the message. Mutt-ng will not @@ -1483,31 +1393,25 @@ Chapter 2. Getting Started In these cases, you are dropped into a menu with a list of keys from which you can select one. When you quit this menu, or mutt can't find any matching keys, you are prompted for a user ID. You can, as usually, abort - this prompt using ^G. When you do so, mutt will return to the compose + this prompt using C-G. When you do so, mutt will return to the compose screen. Once you have successfully finished the key selection, the message will be encrypted using the selected public keys, and sent out. Most fields of the entries in the key selection menu (see also - pgp-entry-format ) have obvious meanings. But some explanations on the + $pgp_entry_format) have obvious meanings. But some explanations on the capabilities, flags, and validity fields are in order. The flags sequence (%f) will expand to one of the following flags: Table 2.10. PGP Key Menu Flags - +-----------------------------------------------------------+ - | Flag | Description | - |------+----------------------------------------------------| - | R | The key has been revoked and can't be used. | - |------+----------------------------------------------------| - | X | The key is expired and can't be used. | - |------+----------------------------------------------------| - | d | You have marked the key as disabled. | - |------+----------------------------------------------------| - | c | There are unknown critical self-signature packets. | - +-----------------------------------------------------------+ + Flag Description + R The key has been revoked and can't be used. + X The key is expired and can't be used. + d You have marked the key as disabled. + c There are unknown critical self-signature packets. The capabilities field (%c) expands to a two-character sequencerepresenting a key's capabilities. The first character gives the @@ -1555,7 +1459,7 @@ Chapter 2. Getting Started (by default) the Return key. Note that different remailers do have different capabilities, indicated in - the %c entry of the remailer menu lines (see mix-entry-format). Most + the %c entry of the remailer menu lines (see $mix_entry_format). Most important is the ``middleman'' capability, indicated by a capital ``M'': This means that the remailer in question cannot be used as the final element of a chain, but will only forward messages to other mixmaster @@ -1607,7 +1511,7 @@ Chapter 2. Getting Started At times it is desirable to delay sending a message that you have already begun to compose. When the postpone-message function is used in the compose menu, the body of your message and attachments are stored in the - mailbox specified by the postponed variable. This means that you can + mailbox specified by the $postponed variable. This means that you can recall the message even if you exit Mutt-ng and then restart it at a later time. @@ -1622,7 +1526,7 @@ Chapter 2. Getting Started Also, you must be in the same folder with the message you replied to for the status of the message to be updated. - See also the postpone quad-option. + See also the $postpone quad-option. Chapter 3. Configuration @@ -1737,7 +1641,7 @@ Chapter 3. Configuration 2. Basic Syntax of Initialization Files - An initialization file consists of a series of commands .Each line of the + An initialization file consists of a series of commands. Each line of the file may contain one or more commands. When multiple commands are used, they must be separated by a semicolon (;). @@ -1753,8 +1657,8 @@ Chapter 3. Configuration contain spaces or other special characters. The difference between the two types of quotes is similar to that of many popular shell programs, namely that a single quote is used to specify a literal string (one that is not - interpreted for shell variables or quoting with a backslash [see next - paragraph]), while double quotes indicate a string for which should be + interpreted for shell variables or quoting with a backslash (see next + paragraph), while double quotes indicate a string for which should be evaluated. For example, backtics are evaluated inside of double quotes, but not for single quotes. @@ -1826,7 +1730,7 @@ Chapter 3. Configuration set record=+sent_on_$HOSTNAME - sets the record variable to the string +sent_on_ and appends the value of + sets the $record variable to the string +sent_on_ and appends the value of the evironment variable $HOSTNAME. Note: There will be no warning if an environment variable is not defined. @@ -1839,11 +1743,11 @@ Chapter 3. Configuration set imap_home_namespace = $folder - would set the value of imap-home-namespace to the value to which folder is - currently set to. + would set the value of $imap_home_namespace to the value to which $folder + is currently set to. Note: There're no logical links established in such cases so that the the - value for imap-home-namespace won't change even if folder gets changed. + value for $imap_home_namespace won't change even if $folder gets changed. Note: There will be no warning if a configuration variable is not defined or is empty. The result will of the expansion will then be empty. @@ -1917,7 +1821,7 @@ Chapter 3. Configuration differ from different manual sources. Where the manual is installed in can be queried (already using such a variable) by running: - muttng -Q muttng_docdir + $ muttng -Q muttng_docdir To extend the example for viewing the manual via self-defined variables, it can be made more readable and more portable by changing the real path @@ -1978,8 +1882,7 @@ Chapter 3. Configuration 4. Defining/Using aliases - Usage: alias key address[ , address, ... ] - + Usage: aliaskey address [, address,...] It's usually very cumbersome to remember or type out the address of someone you are communicating with. Mutt-ng allows you to create @@ -1990,18 +1893,18 @@ Chapter 3. Configuration To remove an alias or aliases (``*'' means all aliases): - unalias [ * | key ... ] + Usage: unalias[* | key ... ] alias muttdude me@cs.hmc.edu (Michael Elkins) alias theguys manny, moe, jack Unlike other mailers, Mutt-ng doesn't require aliases to be defined in a special file. The alias command can appear anywhere in a configuration - file, as long as this file is source .Consequently, you can have multiple + file, as long as this file is source. Consequently, you can have multiple alias files, or you can have all aliases defined in your muttrc. - On the other hand, the create-alias function can use only one file, the - one pointed to by the alias-file variable (which is ˜/.muttrc by + On the other hand, the function can use only one file, the + one pointed to by the $alias_file variable (which is ~/.muttrc by default). This file is not special either, in the sense that Mutt-ng will happily append aliases to any file, but in order for the new aliases to take effect you need to explicitly source this file too. @@ -2015,7 +1918,7 @@ Chapter 3. Configuration To use aliases, you merely use the alias at any place in mutt where muttprompts for addresses, such as the To: or Cc: prompt. You can also enter aliases in your editor at the appropriate headers if you have the - edit-headers variable set. + $editor_headers variable set. In addition, at the various address prompts, you can use the tab character to expand a partial alias to the full alias. If there are multiple @@ -2030,8 +1933,7 @@ Chapter 3. Configuration 5. Changing the default key bindings - Usage: bind map key function - + Usage: bindmap key function This command allows you to change the default key bindings (operation invoked when pressing a key). @@ -2105,68 +2007,43 @@ Chapter 3. Configuration Table 3.1. Alternative Key Names - +-----------------------------------+ - | Sequence | Description | - |-------------+---------------------| - | \t | tab | - |-------------+---------------------| - | | tab | - |-------------+---------------------| - | | backtab / shift-tab | - |-------------+---------------------| - | \r | carriage return | - |-------------+---------------------| - | \n | newline | - |-------------+---------------------| - | \e | escape | - |-------------+---------------------| - | | escape | - |-------------+---------------------| - | | up arrow | - |-------------+---------------------| - | | down arrow | - |-------------+---------------------| - | | left arrow | - |-------------+---------------------| - | | right arrow | - |-------------+---------------------| - | | Page Up | - |-------------+---------------------| - | | Page Down | - |-------------+---------------------| - | | Backspace | - |-------------+---------------------| - | | Delete | - |-------------+---------------------| - | | Insert | - |-------------+---------------------| - | | Enter | - |-------------+---------------------| - | | Return | - |-------------+---------------------| - | | Home | - |-------------+---------------------| - | | End | - |-------------+---------------------| - | | Space bar | - |-------------+---------------------| - | | function key 1 | - |-------------+---------------------| - | | function key 10 | - +-----------------------------------+ + Sequence Description + \t tab + tab + backtab / shift-tab + \r carriage return + \n newline + \e escape + escape + up arrow + down arrow + left arrow + right arrow + Page Up + Page Down + Backspace + Delete + Insert + Enter + Return + Home + End + Space bar + function key 1 + function key 10 key does not need to be enclosed in quotes unless it contains a space (`` ''). function specifies which action to take when key is pressed. For a - complete list of functions, see the functions .The special function noop + complete list of functions, see the functions. The special function noop unbinds the specified key sequence. 6. Defining aliases for character sets - Usage: charset-hook alias charset - Usage: iconv-hook charset local-charset + Usage: charset-hookaliascharset + Usage: iconv-hookcharsetlocal-charset The charset-hook command defines an alias for a character set. This is useful to properly display messages which are tagged with a character set @@ -2178,8 +2055,7 @@ Chapter 3. Configuration 7. Setting variables based upon mailbox - Usage: folder-hook [!]regexp command - + Usage: folder-hook [!]regexpcommand It is often desirable to change settings based on which mailbox you are reading. The folder-hook command provides a method by which you can @@ -2188,7 +2064,7 @@ Chapter 3. Configuration mailbox matches multiple folder-hook's, they are executed in the order given in the muttrc. - Note: if you use the ``!'' shortcut for spoolfile at the beginning of the + Note: if you use the ``!'' shortcut for $spoolfile at the beginning of the pattern, you must place it inside of double or single quotes in order to distinguish it from the logical not operator for the expression. @@ -2206,8 +2082,7 @@ Chapter 3. Configuration 8. Keyboard macros - Usage: macro menu key sequence [ description ] - + Usage: macromenu key sequence [description] Macros are useful when you would like a single key to perform a series of actions. When you press key in menu menu ,Mutt-ng will behave as if you @@ -2221,10 +2096,10 @@ Chapter 3. Configuration key and sequence are expanded by the same rules as the bind. There are some additions however. The first is that control characters in sequence can also be specified as ^x. In order to get a caret (`^'') you need to - use ^^. Secondly, to specify a certain key such as up or to invoke a - function directly, you can use the format and - .For a listing of key names see the section on bind. Functions are listed - in the functions. + specify it twice. Secondly, to specify a certain key such as up or to + invoke a function directly, you can use the format and + .For a listing of key names see the section on bind. + Functions are listed in the functions. The advantage with using function names directly is that the macros willwork regardless of the current key bindings, so they are not dependent @@ -2240,10 +2115,11 @@ Chapter 3. Configuration 9. Using color and mono video attributes - Usage: color object foregroundbackground [ regexp] - Usage: color index foreground backgroundpattern - Usage: uncolor index pattern[ pattern ... ] + Usage: colorobject foreground background [regexp] + + Usage: colorindex foreground pattern + Usage: uncolorindex pattern [pattern ...] If your terminal supports color, you can spice up Mutt-ng by creating your own color scheme. To define the color of an object (type of information), @@ -2275,7 +2151,7 @@ Chapter 3. Configuration o normal - o quoted (text matching quote-regexp in the body of a message) + o quoted (text matching $quote_regexp in the body of a message) o quoted1, quoted2, ..., quotedN (higher levels of quoting) @@ -2285,7 +2161,7 @@ Chapter 3. Configuration o status (mode lines used to display info about the mailbox or message) - o tilde (the ``˜'' used to pad blank lines in the pager) + o tilde (the ``~'' used to pad blank lines in the pager) o tree (thread tree drawn in the message index and attachment menu) @@ -2318,7 +2194,7 @@ Chapter 3. Configuration If your terminal supports it, the special keyword default can be used as a transparent color. The value brightdefault is also valid. If Mutt-ng is - linked against the S-Lang library, you also need to set the COLORFGBG + linked against the S-Lang library, you also need to set the $COLORFGBG environment variable to the default colors of your terminal for this to work; for example (for Bourne-like shells): @@ -2333,7 +2209,7 @@ Chapter 3. Configuration in the color command for it to be removed. The pattern ``*'' is a special token which means to clear the color index list of all entries. - Mutt-ng also recognizes the keywords color0, color1 ,…, colorN-1 (N + Mutt-ng also recognizes the keywords color0, color1 ,..., colorN-1 (N being the number of colors supported by your terminal). This is useful when you remap the colors for your display (for example by changing the color associated with color2 for your xterm), since color names may then @@ -2342,9 +2218,11 @@ Chapter 3. Configuration If your terminal does not support color, it is still possible change the video attributes through the use of the ``mono'' command: - Usage: mono [ regexp ] - Usage: mono index attribute pattern - Usage: unmono index pattern[ pattern ... ] + Usage: monoobject attribute [regexp] + + Usage: monoindex attribute pattern + + Usage: unmonoindex pattern [pattern ...] where attribute is one of the following: @@ -2360,8 +2238,9 @@ Chapter 3. Configuration 10. Ignoring (weeding) unwanted message headers - Usage: [un]ignore pattern [ pattern... ] + Usage: ignorepattern [pattern ...] + Usage: unignorepattern [pattern ...] Messages often have many header fields added by automatic processing systems, or which may not seem useful to display on the screen. This @@ -2389,14 +2268,16 @@ Chapter 3. Configuration 11. Alternative addresses - Usage: [un]alternates regexp [ regexp ... ] + Usage: alternatesregexp [regexp ...] + + Usage: unalternatesregexp [regexp ...] With various functions, mutt will treat messages differently, depending on whether you sent them or whether you received them from someone else. For instance, when replying to a message that you sent to a different party, mutt will automatically suggest to send the response to the original message's recipients--responding to yourself won't make much sense in many - cases. (See reply-to .) + cases. (See $reply_to.) Many users receive e-mail under a number of different addresses. To fully use mutt's features here, the program must be able to recognize what @@ -2480,8 +2361,9 @@ Chapter 3. Configuration set text_flowed Additionally, you have to use an editor which supports writing - format=flowed-conforming emails. For vim, this is done by adding w to the - formatoptions (see :h formatoptions and :h fo-table) when writing emails. + format=flowed-conforming emails. For vim(1), this is done by adding w to + the formatoptions (see :h formatoptions and :h fo-table) when writing + emails. Also note that format=flowed knows about ``space-stuffing'', that is, when sending messages, some kinds of lines have to be indented with a single @@ -2494,15 +2376,11 @@ Chapter 3. Configuration o > This is not the quote character but a right angle used for other reasons - o From with a trailing space. - - o just a space for formatting reasons - Please make sure that you manually prepend a space to each of them. 12.4. Additional Notes - For completeness, the delete-space variable provides the mechanism to + For completeness, the $delete_space variable provides the mechanism to generate a DelSp=yes parameter on outgoing messages. According to the standard, clients receiving a format=flowed messages should delete the last space of a flowed line but still interpret the line as flowed. @@ -2514,11 +2392,15 @@ Chapter 3. Configuration 13. Mailing lists - Usage: [un]lists regexp [ regexp... ] - Usage: [un]subscribe regexp [ regexp... ] + Usage: listsregexp [regexp ...] + + Usage: unlistsregexp [regexp ...] + Usage: subscriberegexp [regexp ...] - Mutt-ng has a few nice features for using-lists .In order to take + Usage: unsubscriberegexp [regexp ...] + + Mutt-ng has a few nice features for using-lists. In order to take advantage of them, you must specify which addresses belong to mailing lists, and which mailing lists you are subscribed to. Once you have done this, the list-reply function will work for all known lists. Additionally, @@ -2528,7 +2410,7 @@ Chapter 3. Configuration header is a non-standard extension which is not supported by all mail user agents. Adding it is not bullet-proof against receiving personal CCs of list messages. Also note that the generation of the Mail-Followup-To - header is controlled by the followup-to configuration variable. + header is controlled by the $followup_to configuration variable. More precisely, Mutt-ng maintains lists of patterns for the addresses of known and subscribed mailing lists. Every subscribed mailing list is @@ -2559,8 +2441,7 @@ Chapter 3. Configuration 14. Using Multiple spool mailboxes - Usage: mbox-hook [!]pattern mailbox - + Usage: mbox-hook [!]patternmailbox This command is used to move read messages from a specified mailbox to adifferent mailbox automatically when you quit or change folders. pattern @@ -2572,8 +2453,9 @@ Chapter 3. Configuration 15. Defining mailboxes which receive mail - Usage: [un]mailboxes [!]filename[ filename ... ] + Usage: mailboxes[!]filename [filename ... ] + Usage: unmailboxes[!]filename [filename ... ] This command specifies folders which can receive mail and which will be checked for new messages. By default, the main menu status bar displays @@ -2598,14 +2480,14 @@ Chapter 3. Configuration Note: the filenames in the mailboxes command are resolved when the command is executed, so if these names contain shortcuts (such as ``='' and - ``!''), any variable definition that affect these characters (like folder - and spoolfile) should be executed before the mailboxes command. + ``!''), any variable definition that affect these characters (like $folder + and $spoolfile) should be executed before the mailboxes command. 16. User defined headers - Usage: my_hdr string - Usage: unmy_hdr field [ field... ] + Usage: my_hdrstring + Usage: unmy_hdrfield [field ...] The ``my_hdr'' command allows you to create your own header fields which will be added to every message you send. @@ -2618,11 +2500,11 @@ Chapter 3. Configuration in your .muttrc. Note: space characters are not allowed between the keyword and the colon - (``:''). The standard for electronic mail (RFC822) says that space is + (``:''). The standard for electronic mail (RfC 822) says that space is illegal there, so Mutt-ng enforces the rule. If you would like to add a header field to a single message, you should - either set the edit-headers variable, or use the edit-headers function + either set the $edit_headers variable, or use the edit-headers function (default: ``E'') in the send-menu so that you can edit the header of your message along with the body. @@ -2635,8 +2517,9 @@ Chapter 3. Configuration 17. Defining the order of headers when viewing messages - Usage: hdr_order header1header2 header3 + Usage: hdr_orderheader header [header ...] + Usage: unhdr_order[ * | header header ...] With this command, you can specify an order in which mutt will attempt to present headers to you when viewing messages. @@ -2649,8 +2532,7 @@ Chapter 3. Configuration 18. Specify default save filename - Usage: save-hook [!]pattern filename - + Usage: save-hook [!]patternfilename This command is used to override the default filename used when saving messages. filename will be used as the default filename if the message is @@ -2668,37 +2550,36 @@ Chapter 3. Configuration 19. Specify default Fcc: mailbox when composing - Usage: fcc-hook [!]pattern mailbox - + Usage: fcc-hook [!]patternmailbox - This command is used to save outgoing mail in a mailbox other than record. - Mutt-ng searches the initial list of message recipients for the first - matching regexp and uses mailbox as the default Fcc: mailbox. If no match - is found the message will be saved to record mailbox. + This command is used to save outgoing mail in a mailbox other than + $record. Mutt-ng searches the initial list of message recipients for the + first matching regexp and uses mailbox as the default Fcc: mailbox. If no + match is found the message will be saved to $record mailbox. See pattern-hook for information on the exact format of pattern. - Example: fcc-hook [@.]aol\\.com$ +spammers + Example: + + fcc-hook [@.]aol\\.com$ +spammers The above will save a copy of all messages going to the aol.com domain to the `+spammers' mailbox by default. Also see the fcc-save-hook command. 20. Specify default save filename and default Fcc: mailbox at once - Usage: fcc-save-hook [!]pattern mailbox - + Usage: fcc-save-hook [!]patternmailbox This command is a shortcut, equivalent to doing both a fcc-hook and a save-hook with its arguments. 21. Change settings based upon message recipients - Usage: reply-hook [!]pattern command - Usage: send-hook [!]pattern command - Usage: send2-hook [!]pattern command + Usage: reply-hook [!]patterncommand + Usage: send-hook [!]patterncommand - v + Usage: send2-hook [!]patterncommand These commands can be used to execute arbitrary configuration commands based upon recipients of the message. pattern is a regular expression @@ -2707,14 +2588,14 @@ Chapter 3. Configuration reply-hook is matched against the message you are replying to, instead of the message you are sending .send-hook is matched against all messages, - both new and replies .Note: reply-hooks are matched before the send-hook - ,regardless of the order specified in the users's configuration file. + both new and replies .Note:reply-hooks are matched before the send-hook, + regardless of the order specified in the users's configuration file. send2-hook is matched every time a message is changed, either by editing it, or by using the compose menu to change its recipients or subject. send2-hook is executed after send-hook ,and can, e.g., be used to set - parameters such as the sendmail variable depending on the message's sender - address. + parameters such as the $sendmail variable depending on the message's + sender address. For each type of send-hook or reply-hook, when multiple matches occur, commands are executed in the order they are specified in the muttrc (for @@ -2725,7 +2606,7 @@ Chapter 3. Configuration Example: send-hook mutt "set mime_forward signature=''" Another typical use for this command is to change the values of the - attribution, signature and locale variables in order to change the + $attribution, $signature and $locale variables in order to change the language of the attributions and signatures based upon the recipients. Note: the send-hook's are only executed ONCE after getting the initial @@ -2736,8 +2617,7 @@ Chapter 3. Configuration 22. Change settings before formatting a message - Usage: message-hook [!]pattern command - + Usage: message-hook [!]patterncommand This command can be used to execute arbitrary configuration commands before viewing or formatting a message based upon information about the @@ -2754,8 +2634,7 @@ Chapter 3. Configuration 23. Choosing the cryptographic key of the recipient - Usage: crypt-hook pattern keyid - + Usage: crypt-hookpatternkeyid When encrypting messages with PGP or OpenSSL, you may want to associate a certain key with a given e-mail address automatically, either because the @@ -2771,8 +2650,7 @@ Chapter 3. Configuration 24. Adding key sequences to the keyboard buffer - Usage: push string - + Usage: pushstring This command adds the named string to the keyboard buffer. The string may contain control characters, key names and function names like the sequence @@ -2783,20 +2661,18 @@ Chapter 3. Configuration folder-hook . 'push ' - 25. Executing functions - Usage: exec function [ function ... ] - + Usage: execfunction [function ... ] This command can be used to execute any function. Functions are listed in the functions. ``exec function'' is equivalent to ``push ''. 26. Message Scoring - Usage: score pattern value - Usage: unscore pattern [ pattern... ] + Usage: scorepattern value + Usage: unscorepattern [pattern ... ] In situations where you have to cope with a lot of emails, e.g. when you read many different mailing lists, and take part in discussions, it is @@ -2834,14 +2710,15 @@ Chapter 3. Configuration o delete threshold: when a message has a score value equal or lower than the delete threshold, it will be marked as deleted. - These three thresholds can be set via the variables score-threshold-flag - ,score-threshold-read, score-threshold-delete and. By default, - score-threshold-read and score-threshold-delete are set to -1, which means - that in the default threshold configuration no message will ever get - marked as read or deleted. + These three thresholds can be set via the variables $score_threshold_read, + $score_threshold_flag and $score_threshold_delete. + + By default, $score_threshold_read and $score_threshold_delete are set to + -1, which means that in the default threshold configuration no message + will ever get marked as read or deleted. Scoring gets especially interesting when combined with the color command - and the ˜n pattern: + and the ~n pattern: color index black yellow "~n 10-" color index red yellow "~n 100-" @@ -2854,17 +2731,17 @@ Chapter 3. Configuration 27. Spam detection - Usage: spam pattern format - Usage: nospam pattern + Usage: spampattern format + Usage: nospampattern Mutt-ng has generalized support for external spam-scoring filters. By defining your spam patterns with the spam and nospam commands, you can limit, search, and sort your mail based on its spam attributes, as determined by the external filter. You also can display the spam - attributes in your index display using the %H selector in the index-format - variable. (Tip: try %?H?[%H] ? to display spam tags only when they are - defined for a given message.) + attributes in your index display using the %H selector in the + $index_format variable. (Tip: try %?H?[%H] ? to display spam tags only + when they are defined for a given message.) Your first step is to define your external filter's spam patterns using the spam command. pattern should be a regular expression that matches a @@ -2904,7 +2781,7 @@ Chapter 3. Configuration you'll get only the last one to match. The spam tag is what will be displayed in the index when you use %H in the - $index_format variable. It's also the string that the ˜H pattern-matching + $index_format variable. It's also the string that the ~H pattern-matching expression matches against for search and limit functions. And it's what sorting by spam attribute will use as a sort key. @@ -2935,7 +2812,7 @@ Chapter 3. Configuration spam command matches an entry on the nospam list, that nospam entry will be removed. If the pattern for nospam is ``*'', all entries on both lists will be removed. This might be the default action if you use spam and - nospam in conjunction with a folder-hook . + nospam in conjunction with a folder-hook. You can have as many spam or nospam commands as you like. You can even do your own primitive spam detection within mutt -- for example, if you @@ -2946,13 +2823,15 @@ Chapter 3. Configuration 28. Setting variables - Usage: set [no|inv]variable[=value] [ variable ... ] - Usage: toggle variable [variable... ] - Usage: unset variable [variable... ] - Usage: reset variable [variable... ] + Usage: set[no|inv]variable [=value] [variable...] + Usage: togglevariable [variable ...] - This command is used to set (and unset) variables .There are four basic + Usage: unsetvariable [variable ...] + + Usage: resetvariable [variable ...] + + This command is used to set (and unset) variables. There are four basic types of variables: boolean, number, string and quadoption. boolean variables can be set (true) or unset (false). number variables can be assigned a positive integer value. @@ -3001,29 +2880,27 @@ Chapter 3. Configuration 29. Reading initialization commands from another file - Usage: source filename [ filename... ] - + Usage: sourcefilename [filename ...] This command allows the inclusion of initialization commands from other - files. For example, I place all of my aliases in ˜/.mail_aliases so that - I can make my ˜/.muttrc readable and keep my aliases private. + files. For example, I place all of my aliases in ~/.mail_aliases so that I + can make my ~/.muttrc readable and keep my aliases private. - If the filename begins with a tilde (``˜''), it will be expanded to the + If the filename begins with a tilde (``~''), it will be expanded to the path of your home directory. If the filename ends with a vertical bar (|), then filename is considered to be an executable program from which to read input (eg. source - ˜/bin/myscript|). + ~/bin/myscript|). 30. Removing hooks - Usage: unhook [ * | hook-type ] - + Usage: unhook[* | hook-type] This command permits you to flush hooks you have previously defined. You can either remove all hooks by giving the ``*'' character as an argument, or you can remove all hooks of a specific type by saying something like - unhook send-hook. + unhook send. 31. Sharing Setups @@ -3042,13 +2919,13 @@ Chapter 3. Configuration set config_charset = "..." and replacing the dots with the actual character set. To avoid problems - while maintaining the setup, vim user's may want to use modelines as show - in: + while maintaining the setup, vim(1) user's may want to use modelines as + show in: # vim:fileencoding=...: - while, again, replacing the dots with the appropriate name. This tells vim - as which character set to read and save the file. + while, again, replacing the dots with the appropriate name. This tells + vim(1) as which character set to read and save the file. 31.2. Modularization @@ -3087,24 +2964,24 @@ Chapter 3. Configuration sasl, sasl2, libesmtp, compressed, color, classic_pgp, classic_smime, gpgme, header_cache - As an example, one can use the following in ˜/.muttngrc: + As an example, one can use the following in ~/.muttngrc: ifdef feature_imap 'source ~/.mutt-ng/setup-imap' ifdef feature_pop 'source ~/.mutt-ng/setup-pop' ifdef feature_nntp 'source ~/.mutt-ng/setup-nntp' - ...to only source ˜/.mutt-ng/setup-imap if IMAP support is built in, only - source ˜/.mutt-ng/setup-pop if POP support is built in and only source - ˜/.mutt-ng/setup-nntp if NNTP support is built in. + ...to only source ~/.mutt-ng/setup-imap if IMAP support is built in, only + source ~/.mutt-ng/setup-pop if POP support is built in and only source + ~/.mutt-ng/setup-nntp if NNTP support is built in. An example for testing for variable names can be used if users use different revisions of mutt-ng whereby the older one may not have a - certain variable. To test for the availability of imap-mail-check , use: + certain variable. To test for the availability of $imap_mail_check use: ifdef imap_mail_check 'set imap_mail_check = 300' Provided for completeness is the test for menu names. To set - pager-index-lines only if the pager menu is available, use: + $pager_index_lines only if the pager menu is available, use: ifdef pager 'set pager_index_lines = 10' @@ -3230,10 +3107,10 @@ Chapter 4. Advanced Usage dollar sign ``$'' are metacharacters that respectively match the empty string at the beginning and end of a line. - A list of characters enclosed by ``['' and ``]'' matches any single + A list of characters enclosed by ``]'' and ``]'' matches any single character in that list; if the first character of the list is a caret ``^'' then it matches any character not in the list. For example, the - regular expression [0123456789] matches any single digit. A range of ASCII + regular expression ]0123456789] matches any single digit. A range of ASCII characters may be specified by giving the first and last characters, separated by a hyphen ``-''. Most metacharacters lose their special meaning inside lists. To include a literal ``]'' place it first in the @@ -3498,7 +3375,7 @@ Chapter 4. Advanced Usage o the current mutt-ng version number The setting for the status bar of the index is controlled via the - status-format variable. For the hostname and version string, there's an + $status_format variable. For the hostname and version string, there's an expando for $status_format: %h expands to the hostname and %v to the version string. When just configuring: @@ -3626,7 +3503,7 @@ Chapter 4. Advanced Usage operator, which is the ``;'' (semicolon) key by default. When the ``tag-prefix'' operator is used, the next operation will be applied to all tagged messages if that operation can be used in that manner. If the - auto-tag variable is set, the next operation applies to the tagged + $auto_tag variable is set, the next operation applies to the tagged messages automatically, without requiring the ``tag-prefix''. In macro or push commands, you can use the ``tag-prefix-cond'' operator. @@ -3667,7 +3544,7 @@ Chapter 4. Advanced Usage my_hdr directive: send-hook . 'unmy_hdr From:' - send-hook ~C'^b@b\.b$' my_hdr from: c@c.c + send-hook '~C ^b@b\.b$' my-hdr from: c@c.c 5.1. Message Matching in Hooks @@ -3686,7 +3563,7 @@ Chapter 4. Advanced Usage For example, if you wanted to set your return address based upon sending mail to a specific address, you could do something like: - send-hook '~t ^me@cs\.hmc\.edu$' 'my_hdr From: Mutt-ng User ' + send-hook '~t ^me@cs\.hmc\.edu$' 'my-hdr From: Mutt-ng User ' which would execute the given command when sending mail to me@cs.hmc.edu. @@ -3722,26 +3599,6 @@ Chapter 4. Advanced Usage color sidebar_new red black color sidebar white black - The available functions are: - - Table 4.1. Default Sidebar Function Bindings - - +------------------------------------------------------------------------+ - | Key | Function | Description | - |------+---------------------+-------------------------------------------| - | none | sidebar-scroll-up | Scrolls the mailbox list up 1 page | - |------+---------------------+-------------------------------------------| - | none | sidebar-scroll-down | Scrolls the mailbox list down 1 page | - |------+---------------------+-------------------------------------------| - | none | sidebar-next | Highlights the next mailbox | - |------+---------------------+-------------------------------------------| - | none | sidebar-next-new | Highlights the next mailbox with new mail | - |------+---------------------+-------------------------------------------| - | none | sidebar-previous | Highlights the previous mailbox | - |------+---------------------+-------------------------------------------| - | none | sidebar-open | Opens the currently highlighted mailbox | - +------------------------------------------------------------------------+ - Reasonable key bindings look e.g. like this: bind index \Cp sidebar-prev @@ -3761,7 +3618,7 @@ Chapter 4. Advanced Usage Mutt-ng supports connecting to external directory databases such as LDAP, ph/qi, bbdb, or NIS through a wrapper script which connects to mutt using - a simple interface. Using the query-command variable, you specify the + a simple interface. Using the $query_command variable, you specify the wrapper command to use. For example: set query_command = "mutt_ldap_query.pl '%s'" @@ -3801,7 +3658,7 @@ Chapter 4. Advanced Usage Mutt-ng supports reading and writing of four different mailbox formats: mbox, MMDF, MH and Maildir. The mailbox type is autodetected, so there is no need to use a flag for different mailbox types. When creating - newmailboxes, Mutt-ng uses the default specified with the mbox-type + newmailboxes, Mutt-ng uses the default specified with the $mbox_type variable. mbox. This is the most widely used mailbox format for UNIX. All messages @@ -3836,19 +3693,19 @@ Chapter 4. Advanced Usage mailboxes. These shortcuts can be used anywhere you are prompted for a file or mailbox path. - o ! -- refers to your spoolfile (incoming) mailbox + o ! -- refers to your $spoolfile (incoming) mailbox - o > -- refers to your mbox file + o > -- refers to your $mbox file - o < -- refers to your record file + o < -- refers to your $record file o ^ -- refers to the current mailbox o - or !! -- refers to the file you've last visited - o ˜ -- refers to your home directory + o ~ -- refers to your home directory - o = or + -- refers to your folder directory + o = or + -- refers to your $folder directory o @alias -- refers to the save-hook as determined by the address of the alias @@ -3866,7 +3723,7 @@ Chapter 4. Advanced Usage things, the first of which is the ability to show the name of a list through which you received a message (i.e., of a subscribed list) in the index menu display. This is useful to distinguish between personal and - list mail in the same mailbox. In the index-format variable, the escape + list mail in the same mailbox. In the $index_format variable, the escape ``%L'' will return the string ``To '' when ``list'' appears in the ``To'' field, and ``Cc '' when it appears in the ``Cc'' field (otherwise it returns the name of the author). @@ -3881,7 +3738,7 @@ Chapter 4. Advanced Usage Mutt-ng also supports the Mail-Followup-To header. When you send a message to a list of recipients which includes one or several subscribed mailing - lists, and if the followup-to option is set, mutt will generate a + lists, and if the $followup_to option is set, mutt will generate a Mail-Followup-To header which contains all the recipients to whom you send this message, but not your address. This indicates that group-replies or list-replies (also known as ``followups'') to this message should only be @@ -3891,7 +3748,7 @@ Chapter 4. Advanced Usage Conversely, when group-replying or list-replying to a message which has a Mail-Followup-To header, mutt will respect this header if the - honor-followup-to configuration variable is set. Using list-reply will in + $honor_followup_to configuration variable is set. Using list-reply will in this case also make sure that the reply goes to the mailing list, even if it's not specified in the list of recipients in the Mail-Followup-To. @@ -3904,19 +3761,19 @@ Chapter 4. Advanced Usage than the author of the message. This can create problems when trying to reply directly to the author in private, since most mail clients will automatically reply to the address given in the ``Reply-To'' field. - Mutt-ng uses the reply-to variable to help decide which address to use. If - set to ask-yes or ask-no, you will be prompted as to whether or not you + Mutt-ng uses the $reply_to variable to help decide which address to use. + If set to ask-yes or ask-no, you will be prompted as to whether or not you would like to use the address given inthe ``Reply-To'' field, or reply directly to the address given in the ``From'' field. When set to yes, the ``Reply-To'' field will be used when present. The ``X-Label:'' header field can be used to further identify mailing lists or list subject matter (or just to annotate messages individually). - The index-format variable's ``%y'' and ``%Y'' escapes can be used to + The $index_format variable's ``%y'' and ``%Y'' escapes can be used to expand ``X-Label:'' fields in the index, and Mutt-ng's pattern-matcher can - match regular expressions to ``X-Label:'' fields with the ``˜y'' - selector. ``X-Label:'' is not a standard message header field, but it can - easily be inserted by procmailand other mail filtering agents. + match regular expressions to ``X-Label:'' fields with the ``~y'' selector. + ``X-Label:'' is not a standard message header field, but it can easily be + inserted by procmailand other mail filtering agents. Lastly, Mutt-ng has the ability to sort the mailbox into threads. A thread is a group of messages which all relate to the same subject. This is @@ -3955,8 +3812,8 @@ Chapter 4. Advanced Usage 12. Delivery Status Notification (DSN) Support - RFC1894 defines a set of MIME content types for relaying information about - the status of electronic mail messages. These can be thought of as + RfC 1894 defines a set of MIME content types for relaying information + about the status of electronic mail messages. These can be thought of as ``return receipts.'' Users can make use of it in one of the following two ways: @@ -3969,10 +3826,10 @@ Chapter 4. Advanced Usage To support this, there are two variables: - o dsn-notify is used to request receipts for different results (such as + o $dsn_notify is used to request receipts for different results (such as failed message,message delivered, etc.). - o dsn-return requests how much of your message should be returned with + o $dsn_return requests how much of your message should be returned with the receipt (headers or full message). Please see the reference chapter for possible values. @@ -3994,7 +3851,7 @@ Chapter 4. Advanced Usage Polling for new mail is more expensive over POP3 than locally. For this reason the frequency at which Mutt-ng will check for mail remotely can be - controlled by the pop-mail-check variable, which defaults to every 60 + controlled by the $pop_mail_check variable, which defaults to every 60 seconds. If Mutt-ng was compiled with SSL support (by running the configure script @@ -4005,11 +3862,11 @@ Chapter 4. Advanced Usage Another way to access your POP3 mail is the fetch-mail function (default: G). It allows to connect to pop-host ,fetch all your new mail and place it - in the local spoolfile. After this point, Mutt-ng runs exactly as if the + in the local $spoolfile. After this point, Mutt-ng runs exactly as if the mail had always been local. Note: If you only need to fetch all messages to local mailbox you should - consider using a specialized program, such as fetchmail + consider using a specialized program, such as fetchmail(1). 14. IMAP Support (OPTIONAL) @@ -4017,27 +3874,29 @@ Chapter 4. Advanced Usage with the --enable-imap flag), it has the ability to work with folders located on a remote IMAP server. - You can access the remote inbox by selecting the folder - imap://imapserver/INBOX, where imapserver is the name of the IMAP server - and INBOX is the special name for your spool mailbox on the IMAP server. - If you want to access another mail folder at the IMAP server, you should - use imap://imapserver/path/to/folder where path/to/folder is the path of - the folder you want to access. + You can access the remote inbox by selecting the folder via its URL: - You can select an alternative port by specifying it with the server, i.e.: - imap://imapserver:port/INBOX. + imap://imapserver/INBOX - You can also specify different username for each folder, i.e.: - imap://username@imapserver[:port]/INBOX. + where imapserver is the name of the IMAP server and INBOX is the special + name for your spool mailbox on the IMAP server. If you want to access + another mail folder at the IMAP server, you should use + + imap://imapserver/path/to/folder + + where path/to/folder is the path of the folder you want to access. You can + select an alternative port by specifying it with the server, i.e.: + + imap://imapserver:port/INBOX + + You can also specify different username for each folder by prenpending + your username and an @ symbol to the server's name. If Mutt-ng was compiled with SSL support (by running the configure script with the --with-ssl flag), connections to IMAP servers can be encrypted. This naturally requires that the server supports SSL encrypted - connections. To access a folder with IMAP/SSL, you should use - imaps://[username@]imapserver[:port]/path/to/folder as your folder path. - - Pine-compatible notation is also supported, i.e. - {[username@]imapserver[:port][/ssl]}path/to/folder + connections. To access a folder with IMAP/SSL, you only need to substitute + the initial imap:// by imaps:// in the above examples. Note that not all servers use / as the hierarchy separator. Mutt-ng should correctly notice which separator is being used by the server and @@ -4045,10 +3904,10 @@ Chapter 4. Advanced Usage When browsing folders on an IMAP server, you can toggle whether to look at only the folders you are subscribed to, or all folders with the - toggle-subscribed command. See also the imap-list-subscribed variable. + toggle-subscribed command. See also the $imap_list_subscribed variable. Polling for new mail on an IMAP server can cause noticeable delays. So, - you'll want to carefully tune the imap-mail-check and timeout variables. + you'll want to carefully tune the $imap_mail_check and $timeout variables. Note that if you are using mbox as the mail store on UW servers prior tov12.250, the server has been reported to disconnect a client if another @@ -4099,15 +3958,15 @@ Chapter 4. Advanced Usage There are a few variables which control authentication: - o imap-user - controls the username under which you request + o $imap_user - controls the username under which you request authentication on the IMAP server, for all authenticators. This is overridden by an explicit username in the mailbox path (i.e. by using a mailbox name of the form {user@host}). - o imap-pass - a password which you may preset, used by all + o $imap_pass - a password which you may preset, used by all authentication methods where a password is needed. - o imap-authenticators - a colon-delimited list of IMAP authentication + o $imap_authenticators - a colon-delimited list of IMAP authentication methods to try, in the order you wish to try them. If specified, this overrides mutt's default (attempt everything, in the order listed above). @@ -4121,7 +3980,7 @@ Chapter 4. Advanced Usage The Default newsserver can be obtained from the $NNTPSERVER environment variable. Like other news readers, info about subscribed newsgroups is - saved in a file as specified by the nntp-newsrc variable. Article headers + saved in a file as specified by the $nntp_newsrc variable. Article headers are cached and can be loaded from a file when a newsgroup is entered instead loading from newsserver; currently, this caching mechanism still is different from the header caching for maildir/IMAP. @@ -4130,7 +3989,7 @@ Chapter 4. Advanced Usage Especially for Usenet, people often ask for advanced filtering and scoring functionality. Of course, mutt-ng has scoring and allows a killfile, too. - How to use a killfile has been discussed in score-command. + How to use a killfile has been discussed in Message Scoring. What has not been discusses in detail is mutt-ng's built-in realname filter. For may newsreaders including those for ``advanced users'' like @@ -4149,8 +4008,7 @@ Chapter 4. Advanced Usage on the contrary applies a score of 42 to all messages not matching those criteria which are very strict: - o Email addresses must be valid according to RFC 2822, see - + o Email addresses must be valid according to RfC 2822 o the name must consist of at least 2 fields whereby a field must not end in a dot. This means that ``Joe User'' and ``Joe A.User'' are @@ -4167,25 +4025,25 @@ Chapter 4. Advanced Usage output muttng -v contains +USE_LIBESMTP, this will be or is the case already. The SMTP support includes support for Delivery Status Notification (see dsn section) as well as handling the 8BITMIME flag - controlled via use-8bitmime . + controlled via $use_8bitmime. To enable sending mail directly via SMTP without an MTA such as Postfix or - SSMTP and the like, simply set the smtp-host variable pointing to your + SSMTP and the like, simply set the $smtp_host variable pointing to your SMTP server. - Authentication mechanisms are available via the smtp-user and smtp-pass + Authentication mechanisms are available via the $smtp_user and $smtp_pass variables. Transport Encryption via the StartTLS command is also available. For this to work, first of all Mutt-ng must be built with SSL or GNUTLS. Secondly, - the smtp-use-tls variable must be either set to ``enabled'' or + the $smtp_use_tls variable must be either set to ``enabled'' or ``required.'' In both cases, StartTLS will be used if the server supports it: for the second case, the connection will fail ifit doesn't while switching back to unencrypted communication for the first one. Some mail providers require user's to set a particular envelope sender, i.e. they allow for only one value which may not be what the user wants to - send as the From: header. In this case, the variable smtp-envelope may be + send as the From: header. In this case, the variable $smtp_envelope may be used to set the envelope different from the From: header. 17. Managing multiple IMAP/POP/NNTP accounts (OPTIONAL) @@ -4208,7 +4066,7 @@ Chapter 4. Advanced Usage space like http://www.mutt.org/), it is efficient to get a menu with all the URLs and start a WWW browser on one of them. This functionality is provided by the external urlview program which can be retrieved at - ftp://ftp.mutt.org/mutt/contrib/ > and the configuration commands: + and the configuration commands: macro index \cb |urlview\n macro pager \cb |urlview\n @@ -4249,12 +4107,12 @@ Chapter 4. Advanced Usage it is not compressed. This is important because it allows the use of programs that do not have well defined extensions. Just use "." as a regexp. But this may be surprising if your compressing script produces - empty files. In this situation, unset save-empty ,so that the compressed + empty files. In this situation, unset $save_empty ,so that the compressed file will be removed if you delete all of the messages. 19.1. Open a compressed mailbox for reading - Usage: open-hook regexp "command" + Usage: open-hookregexp "command" The command is the command that can be used for opening the folders whose names match regexp. @@ -4281,7 +4139,7 @@ Chapter 4. Advanced Usage 19.2. Write a compressed mailbox - Usage: close-hook regexp"command" + Usage: close-hookregexp"command" This is used to close the folder that was open with the open-hook command after some changes were made to it. @@ -4289,7 +4147,7 @@ Chapter 4. Advanced Usage The command string is the command that can be used for closing the folders whose names match regexp. It has the same format as in the open-hook command. Temporary folder in this case is the folder previously produced - by the < open-hook command. + by the open-hook command. The command should not remove the decompressed file. The command should return non-zero exit status if it fails, so mutt knows something's wrong. @@ -4306,7 +4164,7 @@ Chapter 4. Advanced Usage 19.3. Append a message to a compressed mailbox - Usage: append-hook regexp"command" + Usage: append-hookregexp"command" This command is used for saving to an existing compressed folder. The command is the command that can be used for appending to the folders whose @@ -4323,7 +4181,7 @@ Chapter 4. Advanced Usage When append-hook is used, the folder is not opened, which saves time, but this means that we can not find out what the folder type is. Thus the - default ( mbox-type )type is always supposed (i.e. this is the format used + default ($mbox_type )type is always supposed (i.e. this is the format used for the temporary folder). If the file does not exist when you save to it, close-hook is called, and @@ -4377,7 +4235,9 @@ Chapter 5. Mutt-ng's MIME Support 5. MIME Multipart/Alternative - 6. MIME Lookup + 6. Attachment Searching and Counting + + 7. MIME Lookup Quite a bit of effort has been made to make Mutt-ng the premier text-mode MIME MUA. Every effort has been made to provide the functionality that the @@ -4429,7 +4289,7 @@ Chapter 5. Mutt-ng's MIME Support them using the mailcap viewer definition. Finally, you can apply the usual message-related functions (like - resend-message, and the reply and forward functions) to attachments of + , and the reply and forward functions) to attachments of type message/rfc822. See the help on the attachment menu for more information. @@ -4464,8 +4324,8 @@ Chapter 5. Mutt-ng's MIME Support 2. MIME Type configuration with mime.types When you add an attachment to your mail message, Mutt-ng searches your - personal mime.types file at ${HOME}/.mime.types ,and then the system - mime.types file at /usr/local/share/mutt/mime.types or /etc/mime.types + personal mime.types file within $HOME and then the system mime.types file + at /usr/local/share/mutt/mime.types or /etc/mime.types The mime.types file consist of lines containing a MIME type and a space separated list of extensions. For example: @@ -4495,8 +4355,8 @@ Chapter 5. Mutt-ng's MIME Support 3. MIME Viewer configuration with mailcap - Mutt-ng supports RFC 1524 MIME Configuration, in particular the Unix - specific format specified in Appendix A of RFC 1524. This file format is + Mutt-ng supports RfC 1524 MIME Configuration, in particular the Unix + specific format specified in Appendix A of the RfC. This file format is commonly referred to as the mailcap format. Many MIME compliant programs utilize the mailcap format, allowing you to specify handling for all MIME types in one place for all programs. Programs known to use this format @@ -4559,7 +4419,7 @@ Chapter 5. Mutt-ng's MIME Support text/html; lynx %s In this case, lynx does not support viewing a file from stdin, so you must - use the %s syntax. Note: Some older versions of lynx contain a bug where + use the %s syntax. Note:Some older versions of lynx contain a bug where they will check the mailcap file for a viewer for text/html. They will find the line which calls lynx, and run it. This causes lynx to continuously spawn itself to view the object. @@ -4582,7 +4442,7 @@ Chapter 5. Mutt-ng's MIME Support The interpretation of shell meta-characters embedded in MIME parameters can lead to security problems in general. Mutt-ng tries to quote parameters in expansion of %s syntaxes properly, and avoids risky - characters by substituting them, see the mailcap-sanitize variable. + characters by substituting them, see the $mailcap_sanitize variable. Although mutt's procedures to invoke programs with mailcap seem to be safe, there are other applications parsing mailcap, maybe taking less care @@ -4629,11 +4489,11 @@ Chapter 5. Mutt-ng's MIME Support needsterminal - Mutt-ng uses this flag when viewing attachments with auto-view ,in + Mutt-ng uses this flag when viewing attachments with auto_view, in order to decide whether it should honor the setting of the - wait-key variable or not. When an attachment is viewed using an + $wait_key variable or not. When an attachment is viewed using an interactive program, and the corresponding mailcap entry has a - needsterminal flag, Mutt-ng will use wait-key and the exit + needsterminal flag, Mutt-ng will use $wait_key and the exit statusof the program to decide if it will ask you to press a key after the external program has exited. In all other situations it will not prompt you for a key. @@ -4683,7 +4543,7 @@ Chapter 5. Mutt-ng's MIME Support expansion rules defined in the next section. If the command returns 0, then the test passed, and Mutt-ng uses this entry. If the command returns non-zero, then the test failed, and Mutt-ng - continues searching for the right entry. Note: the content-type + continues searching for the right entry. Note:the content-type must match before Mutt-ng performs the test. For example: text/html; netscape -remote 'openURL(%s)' ; test=RunningX @@ -4710,7 +4570,7 @@ Chapter 5. Mutt-ng's MIME Support Mutt-ng will skip the image/* entry and use the image/gif entry with the print command. - In addition, you can use this with auto-view to denote two commands for + In addition, you can use this with auto_view to denote two commands for viewing an attachment, one to be viewed automatically, the other to be viewed interactively from the attachment menu. In addition, you can then use the test feature to determine which viewer to use interactively @@ -4720,7 +4580,7 @@ Chapter 5. Mutt-ng's MIME Support text/html; lynx %s; nametemplate=%s.html text/html; lynx -dump %s; nametemplate=%s.html; copiousoutput - For auto-view, Mutt-ng will choose the third entry because of the + For auto_view, Mutt-ng will choose the third entry because of the copiousoutput tag. For interactive viewing, Mutt will run the program RunningX to determine if it should use the first entry. If the program returns non-zero, Mutt-ng will use the second entry for interactive @@ -4764,7 +4624,7 @@ Chapter 5. Mutt-ng's MIME Support This will be replaced by a % - Mutt-ng does not currently support the %F and %n keywords specified in RFC + Mutt-ng does not currently support the %F and %n keywords specified in RfC 1524. The main purpose of these parameters is for multipart messages, which is handled internally by Mutt-ng. @@ -4810,14 +4670,18 @@ Chapter 5. Mutt-ng's MIME Support image/*;xv %s; test=RunningX; edit=xpaint %s # Convert images to text using the netpbm tools - image/*; (anytopnm %s | pnmscale -xysize 80 46 | ppmtopgm | pgmtopbm | - pbmtoascii -1x2 ) 2>&1 ; copiousoutput + image/*; (anytopnm %s | pnmscale -xysize 80 46 | ppmtopgm | \ + pgmtopbm | pbmtoascii -1x2 ) 2>&1 ; copiousoutput # Send excel spreadsheets to my NT box application/ms-excel; open.pl %s 4. MIME Autoview + Usage: auto_viewmime-type [mime-type ...] + + Usage: unauto_viewmime-type [mime-type ...] + In addition to explicitly telling Mutt-ng to view an attachment with theMIME viewer defined in the mailcap file, Mutt-ng has support for automatically viewing MIME attachments while in the pager. @@ -4850,6 +4714,10 @@ Chapter 5. Mutt-ng's MIME Support 5. MIME Multipart/Alternative + Usage: alternative_ordermime-type [mime-type ...] + + Usage: unalternative_ordermime-type [mime-type ...] + Mutt-ng has some heuristics for determining which attachment of a multipart/alternative type to display. First, mutt will check the alternative_order list to determine if one of the available typesis @@ -4860,14 +4728,110 @@ Chapter 5. Mutt-ng's MIME Support alternative_order text/enriched text/plain text application/postscript image/* - Next, mutt will check if any of the types have a defined auto-view, and + Next, mutt will check if any of the types have a defined auto_view, and use that. Failing that, Mutt-ng will look for any text type. As a last attempt, mutt willlook for any type it knows how to handle. To remove a MIME type from the alternative_order list, use the unalternative_order command. -6. MIME Lookup +6. Attachment Searching and Counting + + If you ever lose track of attachments in your mailboxes, Mutt's + attachment-counting and -searching support might be for you. You can make + your message index display the number of qualifying attachments in each + message, or search for messages by attachment count. You also can + configure what kinds of attachments qualify for this feature with the + attachments and unattachments commands. + + The syntax is: + + Usage: attachments( {+|-}disposition mime-type | ? ) + + Usage: unattachments{+|-}disposition mime-type + + Disposition is the attachment's Content-disposition type -- either + "inline" or "attachment". You can abbreviate this to I or A. + + Disposition is prefixed by either a + symbolor a - symbol. If it's a +, + you're saying that you want to allow this disposition and MIME type to + qualify. If it's a -, you're saying that this disposition and MIME type is + an exception to previous + rules. There are examples below of how this is + useful. + + Mime-type is, unsurprisingly, the MIME type of the attachment you want to + affect. A MIME type is always of the format "major/minor", where "major" + describes the broad category of document you're looking at, and "minor" + describes the specific type within that category. The major part of + mim-type must be literal text (or the special token "*"), but the minor + part may be a regular expression. (Therefore, "*/.*" matches any MIME + type.) + + The MIME types you give to the attachments directive are a kind of + pattern. When you use the attachments directive, the patterns you specify + are added to a list. When you use unattachments, the pattern is removed + from the list. The patterns are not expanded and matched to specific MIME + types at this time -- they're just text in a list. They're only matched + when actually evaluating a message. + + Some examples might help to illustrate. The examples that are not + commented out define the default configuration of the lists. + + ## Removing a pattern from a list removes that pattern literally. It + ## does not remove any type matching the pattern. + ## + ## attachments +A */.* + ## attachments +A image/jpeg + ## unattachments +A */.* + ## + ## This leaves "attached" image/jpeg files on the allowed attachments + ## list. It does not remove all items, as you might expect, because the + ## second */.* is not a matching expression at this time. + ## + ## Remember: "unattachments" only undoes what "attachments" has done! + ## It does not trigger any matching on actual messages. + + + ## Qualify any MIME part with an "attachment" disposition, EXCEPT for + ## text/x-vcard and application/pgp parts. (PGP parts are already known + ## to mutt, and can be searched for with ~g, ~G, and ~k.) + ## + ## I've added x-pkcs7 to this, since it functions (for S/MIME) + ## analogously to PGP signature attachments. S/MIME isn't supported + ## in a stock mutt build, but we can still treat it specially here. + ## + attachments +A */.* + attachments -A text/x-vcard application/pgp.* + attachments -A application/x-pkcs7-.* + + ## Discount all MIME parts with an "inline" disposition, unless they're + ## text/plain. (Why inline a text/plain part unless it's external to the + ## message flow?) + ## + attachments +I text/plain + + ## These two lines make Mutt qualify MIME containers. (So, for example, + ## a message/rfc822 forward will count as an attachment.) The first + ## line is unnecessary if you already have "attach-allow */.*", of + ## course. These are off by default! The MIME elements contained + ## within a message/* or multipart/* are still examined, even if the + ## containers themseves don't qualify. + ## + #attachments +A message/.* multipart/.* + #attachments +I message/.* multipart/.* + + ## You probably don't really care to know about deleted attachments. + attachments -A message/external-body + attachments -I message/external-body + + "attachments ?" will list your current settings in Muttrc format, so that + it can be pasted elsewhere. + +7. MIME Lookup + + Usage: mime_lookupmime-type [mime-type ...] + + Usage: unmime_lookupmime-type [mime-type ...] Mutt-ng's mime_lookup list specifies a list of mime-types that should not be treated according to their mailcap entry. This option is designed @@ -4934,10 +4898,10 @@ Chapter 6. Security Considerations 2. Temporary Files Mutt-ng uses many temporary files for viewing messages, verifying digital - signatures, etc. The umask variable can be used to change the default + signatures, etc. The $umask variable can be used to change the default permissions of these files. Please only change it if you really know what you are doing. Also, a different location for these files may be desired - which can be changed via the tmpdir variable. + which can be changed via the $tmpdir variable. 3. Information Leaks @@ -4948,7 +4912,7 @@ Chapter 6. Security Considerations includes a step counter which is increased (and rotated) with every message sent. If you'd like to hide this information probably telling others how many mail you sent in which time, you at least need to remove - the %P expando from the default setting of the msgid-format variable. + the %P expando from the default setting of the $msgid_format variable. Please make sure that you really know how local parts of these Message-ID: headers are composed. @@ -4959,7 +4923,7 @@ Chapter 6. Security Considerations behavior by default, mutt-ng will be strict in interpreting them which means that arbitrary header fields can be embedded in these links which could override existing header fields or attach arbitrary files. This may - be problematic if the edit-headers variable is unset, i.e. the user + be problematic if the $edit_headers variable is unset, i.e. the user doesn't want to see header fields while editing the message. For example, following a link like @@ -4969,13 +4933,13 @@ Chapter 6. Security Considerations will send out the user's private gnupg keyring to joe@host if the user doesn't follow the information on screen carefully enough. - When unsetting the strict-mailto variable, mutt-ng will + When unsetting the $strict_mailto variable, mutt-ng will o be less strict when interpreting these links by prepending a X-Mailto- string to all header fields embedded in such a link and - o turn on the edit-headers variable by force to let the user see all the - headers (because they still may leak information.) + o turn on the $edit_headers variable by force to let the user see all + the headers (because they still may leak information.) 4. External applications @@ -4986,7 +4950,7 @@ Chapter 6. Security Considerations One of these is the mailcap mechanism as defined by RfC 1524. Mutt-ng can be set up to automatically execute any given utility as listed in one of - the mailcap files (see the mailcap-path variable for details.) + the mailcap files (see the $mailcap_path variable for details.) These utilities may have a variety of security vulnerabilities, including overwriting of arbitrary files, information leaks or other exploitable @@ -5003,7 +4967,7 @@ Chapter 6. Security Considerations o keep the software packages referenced in the mailcap file up to date - o leave the mailcap-sanitize variable in its default state to restrict + o leave the $mailcap_sanitize variable in its default state to restrict mailcap expandos to a safe set of characters 4.2. Other @@ -5055,206 +5019,130 @@ Chapter 7. Reference 5.11. editor + 5.12. sidebar + 1. Command line options Running mutt with no arguments will make Mutt-ng attempt to read your spool mailbox. However, it is possible to read other mailboxes and to send messages from the command line as well. - Table 7.1. Mutt-NG Command Line Options - - +------------------------------------------------------------------------+ - | Option | Description | - |--------+---------------------------------------------------------------| - | -A | expand an alias | - |--------+---------------------------------------------------------------| - | -a | attach a file to a message | - |--------+---------------------------------------------------------------| - | -b | specify a blind carbon-copy (BCC) address | - |--------+---------------------------------------------------------------| - | -c | specify a carbon-copy (Cc) address | - |--------+---------------------------------------------------------------| - | -e | specify a config command to be run after initialization files | - | | are read | - |--------+---------------------------------------------------------------| - | -f | specify a mailbox to load | - |--------+---------------------------------------------------------------| - | -F | specify an alternate file to read initialization commands | - |--------+---------------------------------------------------------------| - | -h | print help on command line options | - |--------+---------------------------------------------------------------| - | -H | specify a draft file from which to read a header and body | - |--------+---------------------------------------------------------------| - | -i | specify a file to include in a message composition | - |--------+---------------------------------------------------------------| - | -m | specify a default mailbox type | - |--------+---------------------------------------------------------------| - | -n | do not read the system Muttngrc | - |--------+---------------------------------------------------------------| - | -p | recall a postponed message | - |--------+---------------------------------------------------------------| - | -Q | query a configuration variable | - |--------+---------------------------------------------------------------| - | -R | open mailbox in read-only mode | - |--------+---------------------------------------------------------------| - | -s | specify a subject (enclose in quotes if it contains spaces) | - |--------+---------------------------------------------------------------| - | -t | dump the value of all variables to stdout | - |--------+---------------------------------------------------------------| - | -T | dump the value of all changed variables to stdout | - |--------+---------------------------------------------------------------| - | -v | show version number and compile-time definitions | - |--------+---------------------------------------------------------------| - | -x | simulate the mailx(1) compose mode | - |--------+---------------------------------------------------------------| - | -y | show a menu containing the files specified by the mailboxes | - | | command | - |--------+---------------------------------------------------------------| - | -z | exit immediately if there are no messages in the mailbox | - |--------+---------------------------------------------------------------| - | -Z | open the first folder with new message,exit immediately if | - | | none | - +------------------------------------------------------------------------+ + Table 7.1. Reference: Command Line Options + + Option Description + -A expand an alias + -a attach a file to a message + -b specify a blind carbon-copy (BCC) address + -c specify a carbon-copy (Cc) address + -e specify a config command to be run after initialization files are + read + -f specify a mailbox to load + -F specify an alternate file to read initialization commands + -h print help on command line options + -H specify a draft file from which to read a header and body + -i specify a file to include in a message composition + -m specify a default mailbox type + -n do not read the system Muttngrc + -p recall a postponed message + -Q query a configuration variable + -R open mailbox in read-only mode + -s specify a subject (enclose in quotes if it contains spaces) + -t dump the value of all variables to stdout + -T dump the value of all changed variables to stdout + -v show version number and compile-time definitions + -x simulate the mailx(1) compose mode + -y show a menu containing the files specified by the mailboxes command + -z exit immediately if there are no messages in the mailbox + -Z open the first folder with new message,exit immediately if none To read messages in a mailbox - mutt [ -nz ] [ -F muttrc ] [ -m type ] [ -f mailbox ] + mutt ] -nz ] ] -F muttrc ] ] -m type ] ] -f mailbox ] To compose a new message - mutt [ -n ] [ -F muttrc ] [ -a file ] [ -c address ] [ -i filename ] [ -s - subject ] address [ address ... ] + mutt ] -n ] ] -F muttrc ] ] -a file ] ] -c address ] ] -i filename ] ] -s + subject ] address ] address ... ] Mutt-ng also supports a ``batch'' mode to send prepared messages. Simply redirect input from the file you wish to send. For example, - mutt -s "data set for run #2" professor@bigschool.edu < ˜/run2.dat + mutt -s "data set for run #2" professor@bigschool.edu < ~/run2.dat This command will send a message to ``professor@bigschool.edu'' with a subject of ``data set for run #2''. In the body of the message will be the - contents of the file ``˜/run2.dat''. + contents of the file ``~/run2.dat''. 2. Patterns - Table 7.2. Patterns - - +------------------------------------------------------------------------+ - | Pattern Modifier | Argument | Description | - |------------------+-------------+---------------------------------------| - | ~A | | all messages | - |------------------+-------------+---------------------------------------| - | ~b | EXPR | messages which contain EXPR in the | - | | | message body | - |------------------+-------------+---------------------------------------| - | ~B | EXPR | messages which contain EXPR in the | - | | | whole message | - |------------------+-------------+---------------------------------------| - | ~c | EXPR | messages carbon-copied to EXPR | - |------------------+-------------+---------------------------------------| - | ~C | EXPR | message is either to: or cc: EXPR | - |------------------+-------------+---------------------------------------| - | ~D | | deleted messages | - |------------------+-------------+---------------------------------------| - | ~d | [MIN]-[MAX] | messages with ``date-sent'' in a Date | - | | | range | - |------------------+-------------+---------------------------------------| - | ~E | | expired messages | - |------------------+-------------+---------------------------------------| - | ~e | EXPR | message which contains EXPR in the | - | | | ``Sender'' field | - |------------------+-------------+---------------------------------------| - | ~F | | flagged messages | - |------------------+-------------+---------------------------------------| - | ~f | EXPR | messages originating from EXPR | - |------------------+-------------+---------------------------------------| - | ~g | | cryptographically signed messages | - |------------------+-------------+---------------------------------------| - | ~G | | cryptographically encrypted messages | - |------------------+-------------+---------------------------------------| - | ~H | EXPR | messages with a spam attribute | - | | | matching EXPR | - |------------------+-------------+---------------------------------------| - | ~h | EXPR | messages which contain EXPR in the | - | | | message header | - |------------------+-------------+---------------------------------------| - | ~k | | message contains PGP key material | - |------------------+-------------+---------------------------------------| - | ~i | EXPR | message which match ID in the | - | | | ``Message-ID'' field | - |------------------+-------------+---------------------------------------| - | ~L | EXPR | message is either originated or | - | | | received by EXPR | - |------------------+-------------+---------------------------------------| - | ~l | | message is addressed to a known | - | | | mailing list | - |------------------+-------------+---------------------------------------| - | ~m | [MIN]-[MAX] | message in the range MIN to MAX *) | - |------------------+-------------+---------------------------------------| - | ~M | | multipart messages | - |------------------+-------------+---------------------------------------| - | ~n | [MIN]-[MAX] | messages with a score in the range | - | | | MIN to MAX *) | - |------------------+-------------+---------------------------------------| - | ~N | | new messages | - |------------------+-------------+---------------------------------------| - | ~O | | old messages | - |------------------+-------------+---------------------------------------| - | ~p | | message is addressed to you (consults | - | | | alternates) | - |------------------+-------------+---------------------------------------| - | ~P | | message is from you (consults | - | | | alternates) | - |------------------+-------------+---------------------------------------| - | ~Q | | messages which have been replied to | - |------------------+-------------+---------------------------------------| - | ~R | | read messages | - |------------------+-------------+---------------------------------------| - | ~r | [MIN]-[MAX] | messages with ``date-received'' in a | - | | | Date range | - |------------------+-------------+---------------------------------------| - | ~S | | superseded messages | - |------------------+-------------+---------------------------------------| - | ~s | EXPR | messages having EXPR in the | - | | | ``Subject'' field. | - |------------------+-------------+---------------------------------------| - | ~T | | tagged messages | - |------------------+-------------+---------------------------------------| - | ~t | EXPR | messages addressed to EXPR | - |------------------+-------------+---------------------------------------| - | ~U | | unread messages | - |------------------+-------------+---------------------------------------| - | ~u | | message is addressed to a subscribed | - | | | mailing list | - |------------------+-------------+---------------------------------------| - | ~v | | message is part of a collapsed | - | | | thread. | - |------------------+-------------+---------------------------------------| - | ~V | | cryptographically verified messages | - |------------------+-------------+---------------------------------------| - | | | messages which contain EXPR in the | - | ~w | EXPR | `Newsgroups' field (if compiled with | - | | | NNTP support) | - |------------------+-------------+---------------------------------------| - | ~x | EXPR | messages which contain EXPR in the | - | | | `References' field | - |------------------+-------------+---------------------------------------| - | ~y | EXPR | messages which contain EXPR in the | - | | | `X-Label' field | - |------------------+-------------+---------------------------------------| - | ~z | [MIN]-[MAX] | messages with a size in the range MIN | - | | | to MAX *) | - |------------------+-------------+---------------------------------------| - | ~= | | duplicated messages (see | - | | | $duplicate_threads) | - |------------------+-------------+---------------------------------------| - | ~$ | | unreferenced messages (requires | - | | | threaded view) | - |------------------+-------------+---------------------------------------| - | | | ``From'' contains realname and | - | ~* | | (syntactically) valid address | - | | | (excluded are addresses matching | - | | | against alternates or any alias) | - +------------------------------------------------------------------------+ + Table 7.2. Reference: Patterns + + Pattern Modifier Argument Description + ~A/=A all messages + ~b/=b EXPR messages which contain EXPR in the message + body + ~B/=B EXPR messages which contain EXPR in the whole + message + ~c/=c EXPR messages carbon-copied to EXPR + ~C/=C EXPR message is either to: or cc: EXPR + ~D/=D deleted messages + ~d/=d [MIN]-[MAX] messages with ``date-sent'' in a Date range + ~E/=E expired messages + ~e/=e EXPR message which contains EXPR in the ``Sender'' + field + ~F/=F flagged messages + ~f/=f EXPR messages originating from EXPR + ~g/=g cryptographically signed messages + ~G/=G cryptographically encrypted messages + ~H/=H EXPR messages with a spam attribute matching EXPR + ~h/=h EXPR messages which contain EXPR in the message + header + ~k/=k message contains PGP key material + ~i/=i EXPR message which match ID in the ``Message-ID'' + field + ~L/=L EXPR message is either originated or received by + EXPR + ~l/=l message is addressed to a known mailing list + ~m/=m [MIN]-[MAX] message in the range MIN to MAX *) + ~M/=M multipart messages + ~n/=n [MIN]-[MAX] messages with a score in the range MIN to MAX + *) + ~N/=N new messages + ~O/=O old messages + ~p/=p message is addressed to you (consults + alternates) + ~P/=P message is from you (consults alternates) + ~Q/=Q messages which have been replied to + ~R/=R read messages + ~r/=r [MIN]-[MAX] messages with ``date-received'' in a Date + range + ~S/=S superseded messages + ~s/=s EXPR messages having EXPR in the ``Subject'' + field. + ~T/=T tagged messages + ~t/=t EXPR messages addressed to EXPR + ~U/=U unread messages + ~u/=u message is addressed to a subscribed mailing + list + ~v/=v message is part of a collapsed thread. + ~V/=V cryptographically verified messages + messages which contain EXPR in the + ~w/=w EXPR `Newsgroups' field (if compiled with NNTP + support) + ~x/=x EXPR messages which contain EXPR in the + `References' field + ~X/=X [MIN]-[MAX] messages with MIN to MAX attachments *) + ~y/=y EXPR messages which contain EXPR in the `X-Label' + field + ~z/=z [MIN]-[MAX] messages with a size in the range MIN to MAX + *) + ~=/== duplicated messages (see $duplicate_threads) + ~$/=$ unreferenced messages (requires threaded + view) + ``From'' contains realname and + ~*/=* (syntactically) valid address (excluded are + addresses matching against alternates or any + alias) Where EXPR are regexp. Special attention has to be made when using regular expressions inside of patterns. Specifically, Mutt-ng's parser for these @@ -5262,7 +5150,7 @@ Chapter 7. Reference quoting. If it is your intention to use a backslash in the regular expression, you will need to use two backslashes instead (\\). - *) The forms <[MAX], >[MIN] , [MIN]- and -[MAX] are allowed, too. + *) The forms <[MAX], >[MIN], [MIN]- and -[MAX] are allowed, too. 3. Configuration Commands @@ -5270,23 +5158,23 @@ Chapter 7. Reference o account-hook pattern command - o alias key address [ , address ,... ] + o aliaskeyaddress [, address, ... ] - o alias [ * | key ... ] + o unalias [ * | key ... ] - o alternates regexp [ regexp ... ] + o alternatesregexp [ regexp ... ] - o alternates [ * | regexp ... ] + o unalternates [ * | regexp ... ] - o alternative-order mimetype [ mimetype ... ] + o alternative_ordermimetype [ mimetype ... ] - o alternative-order mimetype [ mimetype ... ] + o unalternative_ordermimetype [ mimetype ... ] o append-hook regexp command - o auto-view mimetype [ mimetype ... ] + o auto_viewmimetype [ mimetype ... ] - o auto-view mimetype [ mimetype ... ] + o unauto_viewmimetype [ mimetype ... ] o bind map key function @@ -5294,11 +5182,11 @@ Chapter 7. Reference o close-hook regexp command - o color object foreground background [ regexp ] + o colorobjectforegroundbackground [ regexp ] - o color index pattern [ pattern ... ] + o uncolorindexpattern [ pattern ... ] - o exec function [ function ... ] + o execfunction [ function ... ] o fcc-hook pattern mailbox @@ -5306,39 +5194,39 @@ Chapter 7. Reference o folder-hook pattern command - o hdr-order header [ header ... ] + o hdr_orderheader [ header ... ] - o hdr-order header [ header ... ] + o unhdr_orderheader [ header ... ] o charset-hook charset local-charset - o ignore pattern [ pattern ... ] + o ignorepattern [ pattern ... ] - o ignore pattern [ pattern ... ] + o unignorepattern [ pattern ... ] - o lists regexp [ regexp ... ] + o listsregexp [ regexp ... ] - o lists regexp [ regexp ... ] + o unlistsregexp [ regexp ... ] - o macro menu key sequence [ description ] + o macromenukeysequence [ description ] - o mailboxes filename [ filename ... ] + o mailboxesfilename [ filename ... ] o mbox-hook pattern mailbox o message-hook pattern command - o mime-lookup mimetype [ mimetype ... ] + o mime_lookupmimetype [ mimetype ... ] - o mime-lookup mimetype [ mimetype ... ] + o unmime_lookupmimetype [ mimetype ... ] - o color object attribute [ regexp ] + o monoobject attribute [ regexp ] - o color index pattern [ pattern ... ] + o unmonoindexpattern [ pattern ... ] - o my-hdr string + o my_hdr string - o my-hdr field [ field ... ] + o unmy_hdrfield [ field ... ] o open-hook regexp command @@ -5346,33 +5234,33 @@ Chapter 7. Reference o push string - o set variable [variable ... ] + o resetvariable [ variable ... ] o save-hook regexp filename - o score-command pattern value + o score pattern value - o score-command pattern [ pattern ... ] + o unscorepattern [ pattern ... ] o send-hook regexp command o reply-hook regexp command - o set [no|inv]variable[=value ] [ variable ... ] + o set [no|inv]variable[ =value ] [ variable ... ] - o set variable [variable ... ] + o unsetvariable [ variable ... ] o source filename o spam pattern format - o spam pattern + o nospam pattern - o lists regexp [ regexp ... ] + o subscriberegexp [ regexp ... ] - o lists regexp [ regexp ... ] + o unsubscriberegexp [ regexp ... ] - o set variable [variable ... ] + o togglevariable [ variable ... ] o unhook hook-type @@ -5383,100 +5271,57 @@ Chapter 7. Reference removed already. The left column contains the old synonym variables, the right column the full/new name: - Table 7.3. Obsolete Variables - - +----------------------------------------------------+ - | Old Name | New Name | - |------------------------+---------------------------| - | edit_hdrs | edit_headers | - |------------------------+---------------------------| - | forw_decode | forward_decode | - |------------------------+---------------------------| - | forw_format | forward_format | - |------------------------+---------------------------| - | forw_quote | forward_quote | - |------------------------+---------------------------| - | hdr_format | index_format | - |------------------------+---------------------------| - | indent_str | indent_string | - |------------------------+---------------------------| - | mime_fwd | mime_forward | - |------------------------+---------------------------| - | msg_format | message_format | - |------------------------+---------------------------| - | pgp_autosign | crypt_autosign | - |------------------------+---------------------------| - | pgp_autoencrypt | crypt_autoencrypt | - |------------------------+---------------------------| - | pgp_replyencrypt | crypt_replyencrypt | - |------------------------+---------------------------| - | pgp_replysign | crypt_replysign | - |------------------------+---------------------------| - | pgp_replysignencrypted | crypt_replysignencrypted | - |------------------------+---------------------------| - | pgp_verify_sig | crypt_verify_sig | - |------------------------+---------------------------| - | pgp_create_traditional | pgp_autoinline | - |------------------------+---------------------------| - | pgp_auto_traditional | pgp_replyinline | - |------------------------+---------------------------| - | forw_decrypt | forward_decrypt | - |------------------------+---------------------------| - | smime_sign_as | smime_default_key | - |------------------------+---------------------------| - | post_indent_str | post_indent_string | - |------------------------+---------------------------| - | print_cmd | print_command | - |------------------------+---------------------------| - | shorten_hierarchy | sidebar_shorten_hierarchy | - |------------------------+---------------------------| - | ask_followup_to | nntp_ask_followup_to | - |------------------------+---------------------------| - | ask_x_comment_to | nntp_ask_x_comment_to | - |------------------------+---------------------------| - | catchup_newsgroup | nntp_catchup | - |------------------------+---------------------------| - | followup_to_poster | nntp_followup_to_poster | - |------------------------+---------------------------| - | group_index_format | nntp_group_index_format | - |------------------------+---------------------------| - | inews | nntp_inews | - |------------------------+---------------------------| - | mime_subject | nntp_mime_subject | - |------------------------+---------------------------| - | news_cache_dir | nntp_cache_dir | - |------------------------+---------------------------| - | news_server | nntp_host | - |------------------------+---------------------------| - | newsrc | nntp_newsrc | - |------------------------+---------------------------| - | nntp_poll | nntp_mail_check | - |------------------------+---------------------------| - | pop_checkinterval | pop_mail_check | - |------------------------+---------------------------| - | post_moderated | nntp_post_moderated | - |------------------------+---------------------------| - | save_unsubscribed | nntp_save_unsubscribed | - |------------------------+---------------------------| - | show_new_news | nntp_show_new_news | - |------------------------+---------------------------| - | show_only_unread | nntp_show_only_unread | - |------------------------+---------------------------| - | x_comment_to | nntp_x_comment_to | - |------------------------+---------------------------| - | smtp_auth_username | smtp_user | - |------------------------+---------------------------| - | smtp_auth_password | smtp_pass | - |------------------------+---------------------------| - | user_agent | agent_string | - +----------------------------------------------------+ + Table 7.3. Reference: Obsolete Variables + + Old Name New Name + edit_hdrs $edit_headers + forw_decode $forward_decode + forw_format $forward_format + forw_quote $forward_quote + hdr_format $index_format + indent_str $indent_string + mime_fwd $mime_forward + msg_format $message_format + pgp_autosign $crypt_autosign + pgp_autoencrypt $crypt_autoencrypt + pgp_replyencrypt $crypt_replyencrypt + pgp_replysign $crypt_replysign + pgp_replysignencrypted $crypt_replysignencrypted + pgp_verify_sig $crypt_verify_sig + pgp_create_traditional $pgp_autoinline + pgp_auto_traditional $pgp_replyinline + forw_decrypt $forward_decrypt + smime_sign_as $smime_default_key + post_indent_str $post_indent_string + print_cmd $print_command + shorten_hierarchy $sidebar_shorten_hierarchy + ask_followup_to $nntp_ask_followup_to + ask_x_comment_to $nntp_ask_x_comment_to + catchup_newsgroup $nntp_catchup + followup_to_poster $nntp_followup_to_poster + group_index_format $nntp_group_index_format + inews $nntp_inews + mime_subject $nntp_mime_subject + news_cache_dir $nntp_cache_dir + news_server $nntp_host + newsrc $nntp_newsrc + nntp_poll $nntp_mail_check + pop_checkinterval $pop_mail_check + post_moderated $nntp_post_moderated + save_unsubscribed $nntp_save_unsubscribed + show_new_news $nntp_show_new_news + show_only_unread $nntp_show_only_unread + x_comment_to $nntp_x_comment_to + smtp_auth_username $smtp_user + smtp_auth_password $smtp_pass + user_agent $agent_string The contrib subdirectory contains a script named update-config.pl which eases migration. A complete list of current variables follows. -1. abort_noattach +1. $abort_noattach Type: quadoption @@ -5493,7 +5338,7 @@ Chapter 7. Reference See also the $attach_remind_regexp variable. -2. abort_nosubject +2. $abort_nosubject Type: quadoption @@ -5504,7 +5349,7 @@ Chapter 7. Reference messages with no subject given at the subject prompt will never be aborted. -3. abort_unmodified +3. $abort_unmodified Type: quadoption @@ -5515,7 +5360,7 @@ Chapter 7. Reference after the first edit of the file). When set to no, composition will never be aborted. -4. agent_string +4. $agent_string Type: boolean @@ -5524,19 +5369,19 @@ Chapter 7. Reference When set, Mutt-ng will add a ``User-Agent:'' header to outgoing messages, indicating which version of Mutt-ng was used for composing them. -5. alias_file +5. $alias_file Type: path - Default: "˜/.muttngrc" + Default: "~/.muttngrc" The default file in which to save aliases created by the ``create-alias'' function. Note: Mutt-ng will not automatically source this file; you must explicitly - use the `` source'' command for it to be executed. + use the ``source'' command for it to be executed. -6. alias_format +6. $alias_format Type: string @@ -5565,7 +5410,7 @@ Chapter 7. Reference character which indicates if the alias is tagged for inclusion -7. allow_8bit +7. $allow_8bit Type: boolean @@ -5574,7 +5419,7 @@ Chapter 7. Reference Controls whether 8-bit data is converted to 7-bit using either quoted-printable or base64 encoding when sending mail. -8. allow_ansi +8. $allow_ansi Type: boolean @@ -5587,7 +5432,7 @@ Chapter 7. Reference problem, since a message could include a line like ``[-- PGP output follows ..." and give it the same color as your attachment color. -9. arrow_cursor +9. $arrow_cursor Type: boolean @@ -5599,7 +5444,7 @@ Chapter 7. Reference redrawn on the screen when moving to the next or previous entries in the menu. -10. ascii_chars +10. $ascii_chars Type: boolean @@ -5608,7 +5453,7 @@ Chapter 7. Reference If set, Mutt-ng will use plain ASCII characters when displaying thread and attachment trees, instead of the default ACS characters. -11. askbcc +11. $askbcc Type: boolean @@ -5617,7 +5462,7 @@ Chapter 7. Reference If set, Mutt-ng will prompt you for blind-carbon-copy (Bcc) recipients before editing an outgoing message. -12. askcc +12. $askcc Type: boolean @@ -5626,7 +5471,7 @@ Chapter 7. Reference If set, Mutt-ng will prompt you for carbon-copy (Cc) recipients before editing the body of an outgoing message. -13. assumed_charset +13. $assumed_charset Type: string @@ -5646,7 +5491,7 @@ Chapter 7. Reference However, only the first content is valid for the message body. This variable is valid only if $strict_mime is unset. -14. attach_format +14. $attach_format Type: string @@ -5695,6 +5540,10 @@ Chapter 7. Reference attachment number + %Q + + "Q", if MIME part qualifies for attachment counting + %s size @@ -5711,6 +5560,10 @@ Chapter 7. Reference unlink (=to delete) flag + %X + + number of qualifying MIME parts in this part and its children + %>X right justify the rest of the string and pad with character "X" @@ -5719,7 +5572,7 @@ Chapter 7. Reference pad to the end of the line with character "X" -15. attach_remind_regexp +15. $attach_remind_regexp Type: regular expression @@ -5732,7 +5585,7 @@ Chapter 7. Reference This variable and $abort_noattach are intended to remind the user to attach files if the message's text references them. -16. attach_sep +16. $attach_sep Type: string @@ -5741,7 +5594,7 @@ Chapter 7. Reference The separator to add between attachments when operating (saving, printing, piping, etc) on a list of tagged attachments. -17. attach_split +17. $attach_split Type: boolean @@ -5753,7 +5606,7 @@ Chapter 7. Reference separator is added after each attachment. When set, Mutt-ng will operate on the attachments one by one. -18. attribution +18. $attribution Type: string @@ -5763,7 +5616,7 @@ Chapter 7. Reference a reply. For a full listing of defined printf(3)-like sequences see the section on ``$index_format''. -19. auto_tag +19. $auto_tag Type: boolean @@ -5774,7 +5627,7 @@ Chapter 7. Reference first use the ``tag-prefix'' function (default: ";") to make the next function apply to all tagged messages. -20. autoedit +20. $autoedit Type: boolean @@ -5787,7 +5640,7 @@ Chapter 7. Reference Also see ``$fast_reply''. -21. beep +21. $beep Type: boolean @@ -5795,7 +5648,7 @@ Chapter 7. Reference When this variable is set, Mutt-ng will beep when an error occurs. -22. beep_new +22. $beep_new Type: boolean @@ -5805,7 +5658,7 @@ Chapter 7. Reference notifying you of new mail. This is independent of the setting of the ``$beep'' variable. -23. bounce +23. $bounce Type: quadoption @@ -5816,7 +5669,7 @@ Chapter 7. Reference variable to no is not generally useful, and thus not recommended, because you are unable to bounce messages. -24. bounce_delivered +24. $bounce_delivered Type: boolean @@ -5826,7 +5679,7 @@ Chapter 7. Reference fields when bouncing messages. Postfix users may wish to unset this variable. -25. braille_friendly +25. $braille_friendly Type: boolean @@ -5838,11 +5691,11 @@ Chapter 7. Reference menus. The option is disabled by default because many visual terminals don't permit making the cursor invisible. -26. certificate_file +26. $certificate_file Type: path - Default: "˜/.mutt_certificates" + Default: "~/.mutt_certificates" Availability: SSL or GNUTLS @@ -5855,9 +5708,9 @@ Chapter 7. Reference certificate that is signed with one of these CA certificates are also automatically accepted. - Example: set certificate_file=˜/.muttng/certificates + Example: set certificate_file=~/.muttng/certificates -27. charset +27. $charset Type: string @@ -5865,7 +5718,7 @@ Chapter 7. Reference Character set your terminal uses to display and enter textual data. -28. check_new +28. $check_new Type: boolean @@ -5879,7 +5732,7 @@ Chapter 7. Reference see if it has already been looked at. If it's unset, no check for new mail is performed while the mailbox is open. -29. collapse_unread +29. $collapse_unread Type: boolean @@ -5888,7 +5741,7 @@ Chapter 7. Reference When unset, Mutt-ng will not collapse a thread if it contains any unread messages. -30. compose_format +30. $compose_format Type: string @@ -5917,7 +5770,7 @@ Chapter 7. Reference See the text describing the ``$status_format'' option for more information on how to set ``$compose_format''. -31. config_charset +31. $config_charset Type: string @@ -5925,7 +5778,7 @@ Chapter 7. Reference When defined, Mutt-ng will recode commands in rc files from this encoding. -32. confirmappend +32. $confirmappend Type: boolean @@ -5934,7 +5787,7 @@ Chapter 7. Reference When set, Mutt-ng will prompt for confirmation when appending messages to an existing mailbox. -33. confirmcreate +33. $confirmcreate Type: boolean @@ -5943,7 +5796,7 @@ Chapter 7. Reference When set, Mutt-ng will prompt for confirmation when saving messages to a mailbox which does not yet exist before creating it. -34. connect_timeout +34. $connect_timeout Type: number @@ -5954,7 +5807,7 @@ Chapter 7. Reference negative value causes Mutt-ng to wait indefinitely for the connection to succeed. -35. content_type +35. $content_type Type: string @@ -5963,7 +5816,7 @@ Chapter 7. Reference Sets the default Content-Type: header field for the body of newly composed messages. -36. copy +36. $copy Type: quadoption @@ -5973,7 +5826,7 @@ Chapter 7. Reference will be saved for later references. Also see ``$record'', ``$save_name'', ``$force_name'' and ``fcc-hook''. -37. crypt_autoencrypt +37. $crypt_autoencrypt Type: boolean @@ -5987,7 +5840,7 @@ Chapter 7. Reference S/MIME messages and settings can be overridden by use of the smime-menu. (Crypto only) -38. crypt_autopgp +38. $crypt_autopgp Type: boolean @@ -5998,7 +5851,7 @@ Chapter 7. Reference ``$crypt_replyencrypt'', ``$crypt_autosign'', ``$crypt_replysign'' and ``$smime_is_default''. -39. crypt_autosign +39. $crypt_autosign Type: boolean @@ -6011,7 +5864,7 @@ Chapter 7. Reference create S/MIME messages and settings can be overridden by use of the smime-menu. (Crypto only) -40. crypt_autosmime +40. $crypt_autosmime Type: boolean @@ -6022,7 +5875,7 @@ Chapter 7. Reference ``$crypt_replyencrypt'', ``$crypt_autosign'', ``$crypt_replysign'' and ``$smime_is_default''. -41. crypt_replyencrypt +41. $crypt_replyencrypt Type: boolean @@ -6031,7 +5884,7 @@ Chapter 7. Reference If set, automatically PGP or OpenSSL encrypt replies to messages which are encrypted. (Crypto only) -42. crypt_replysign +42. $crypt_replysign Type: boolean @@ -6043,7 +5896,7 @@ Chapter 7. Reference Note: this does not work on messages that are encrypted and signed! (Crypto only) -43. crypt_replysignencrypted +43. $crypt_replysignencrypted Type: boolean @@ -6056,7 +5909,7 @@ Chapter 7. Reference that Mutt-ng is not able to find out whether an encrypted message is also signed. (Crypto only) -44. crypt_timestamp +44. $crypt_timestamp Type: boolean @@ -6067,7 +5920,7 @@ Chapter 7. Reference colors to mark these lines, and rely on these, you may unset this setting. (Crypto only) -45. crypt_use_gpgme +45. $crypt_use_gpgme Type: boolean @@ -6080,7 +5933,7 @@ Chapter 7. Reference Note: You need to use this option in your .muttngrc configuration file as it won't have any effect when used interactively. -46. crypt_verify_sig +46. $crypt_verify_sig Type: quadoption @@ -6090,7 +5943,7 @@ Chapter 7. Reference ask whether or not to verify the signature. If ``no'', never attempt to verify cryptographic signatures. (Crypto only) -47. date_format +47. $date_format Type: string @@ -6106,7 +5959,7 @@ Chapter 7. Reference bang is discarded, and the month and week day names in the rest of the string are expanded in the C locale (that is in US English). -48. debug_level +48. $debug_level Type: number @@ -6121,11 +5974,11 @@ Chapter 7. Reference Currently, this number must be >= 0 and <= 5 and muttng must be started with -d to enable debugging at all; enabling at runtime is not possible. -49. default_hook +49. $default_hook Type: string - Default: "˜f %s !˜P | (˜P ˜C %s)" + Default: "~f %s !~P | (~P ~C %s)" This variable controls how send-hooks, message-hooks, save-hooks, and fcc-hooks will be interpreted if they are specified with only a simple @@ -6136,7 +5989,7 @@ Chapter 7. Reference or if it is from you (if the from address matches ``alternates'') and is to or cc'ed to a user matching the given regular expression. -50. delete +50. $delete Type: quadoption @@ -6147,7 +6000,7 @@ Chapter 7. Reference automatically be purged without prompting. If set to no, messages marked for deletion will be kept in the mailbox. -51. delete_space +51. $delete_space Type: boolean @@ -6161,7 +6014,7 @@ Chapter 7. Reference Note: this variable only has an effect on outgoing messages (if $text_flowed is set) but not on incomming. -52. delete_untag +52. $delete_untag Type: boolean @@ -6171,7 +6024,7 @@ Chapter 7. Reference deletion. This applies when you either explicitly delete a message, or when you save it to another folder. -53. digest_collapse +53. $digest_collapse Type: boolean @@ -6181,7 +6034,7 @@ Chapter 7. Reference the subparts of individual messages in a multipart/digest. To see these subparts, press 'v' on that menu. -54. display_filter +54. $display_filter Type: path @@ -6191,7 +6044,7 @@ Chapter 7. Reference viewed it is passed as standard input to $display_filter, and the filtered message is read from the standard output. -55. dotlock_program +55. $dotlock_program Type: path @@ -6201,7 +6054,7 @@ Chapter 7. Reference Contains the path of the muttng_dotlock(1) binary to be used by Mutt-ng. -56. dsn_notify +56. $dsn_notify Type: string @@ -6218,7 +6071,7 @@ Chapter 7. Reference Example: set dsn_notify="failure,delay" -57. dsn_return +57. $dsn_return Type: string @@ -6233,18 +6086,18 @@ Chapter 7. Reference Example: set dsn_return=hdrs -58. duplicate_threads +58. $duplicate_threads Type: boolean Default: yes This variable controls whether Mutt-ng, when sorting by threads, threads - messages with the same Message-Id: header field together. If it is set, it + messages with the same Message-ID: header field together. If it is set, it will indicate that it thinks they are duplicates of each other with an equals sign in the thread diagram. -59. edit_headers +59. $edit_headers Type: boolean @@ -6256,7 +6109,7 @@ Chapter 7. Reference Which empty header fields to show is controlled by the $editor_headers option. -60. editor +60. $editor Type: path @@ -6266,7 +6119,7 @@ Chapter 7. Reference the value of the $VISUAL, or $EDITOR, environment variable, or to the string "vi" if neither of those are set. -61. editor_headers +61. $editor_headers Type: string @@ -6279,7 +6132,7 @@ Chapter 7. Reference Note: if $edit_headers had to be turned on by force because $strict_mailto is unset, this option has no effect. -62. encode_from +62. $encode_from Type: boolean @@ -6290,12 +6143,12 @@ Chapter 7. Reference Useful to avoid the tampering certain mail delivery and transport agents tend to do with messages. - Note: as mutt-ng currently violates RfC3676 defining format=flowed, it's + Note: as Mutt-ng currently violates RfC3676 defining format=flowed, it's ' when replying to the mutt-ng developer's mailing + Foo Bar ' when replying to the Mutt-ng developer's mailing list and Mutt-ng takes this email address. Defaults to the contents of the environment variable $EMAIL. -81. gecos_mask +81. $gecos_mask Type: regular expression @@ -6572,7 +6422,7 @@ Chapter 7. Reference to a regular expression that will match the whole name so Mutt-ng will expand ``Franklin'' to ``Franklin, Steve''. -82. hdrs +82. $hdrs Type: boolean @@ -6583,7 +6433,7 @@ Chapter 7. Reference replying in order to take effect. If set, the user defined header fields are added to every new message. -83. header +83. $header Type: boolean @@ -6593,7 +6443,7 @@ Chapter 7. Reference message you are replying to into the edit buffer. The ``$weed'' setting applies. -84. header_cache +84. $header_cache Type: path @@ -6608,7 +6458,7 @@ Chapter 7. Reference single global header cache. By default it is unset so no header caching will be used. -85. header_cache_compress +85. $header_cache_compress Type: boolean @@ -6618,7 +6468,7 @@ Chapter 7. Reference usual diskspace is used, but the uncompression can result in a slower open of the cached folder. -86. help +86. $help Type: boolean @@ -6633,7 +6483,7 @@ Chapter 7. Reference variable is primarily aimed at new users, neither of these should present a major problem. -87. hidden_host +87. $hidden_host Type: boolean @@ -6644,7 +6494,7 @@ Chapter 7. Reference the generation of Message-ID: header fields, and it will not lead to the cut-off of first-level domains. -88. hide_limited +88. $hide_limited Type: boolean @@ -6653,7 +6503,7 @@ Chapter 7. Reference When set, Mutt-ng will not show the presence of messages that are hidden by limiting, in the thread tree. -89. hide_missing +89. $hide_missing Type: boolean @@ -6662,7 +6512,7 @@ Chapter 7. Reference When set, Mutt-ng will not show the presence of missing messages in the thread tree. -90. hide_thread_subject +90. $hide_thread_subject Type: boolean @@ -6672,7 +6522,7 @@ Chapter 7. Reference that have the same subject as their parent or closest previously displayed sibling. -91. hide_top_limited +91. $hide_top_limited Type: boolean @@ -6682,7 +6532,7 @@ Chapter 7. Reference by limiting, at the top of threads in the thread tree. Note that when $hide_missing is set, this option will have no effect. -92. hide_top_missing +92. $hide_top_missing Type: boolean @@ -6692,7 +6542,7 @@ Chapter 7. Reference top of threads in the thread tree. Note that when $hide_limited is set, this option will have no effect. -93. history +93. $history Type: number @@ -6702,7 +6552,7 @@ Chapter 7. Reference string history buffer. The buffer is cleared each time the variable is changed. -94. honor_followup_to +94. $honor_followup_to Type: quadoption @@ -6711,19 +6561,19 @@ Chapter 7. Reference This variable controls whether or not a Mail-Followup-To: header field is honored when group-replying to a message. -95. hostname +95. $hostname Type: string Default: "" Specifies the hostname to use after the ``@'' in local e-mail addresses - and during generation of Message-Id: headers. + and during generation of Message-ID: headers. Please be sure to really know what you are doing when changing this variable to configure a custom domain part of Message-IDs. -96. ignore_list_reply_to +96. $ignore_list_reply_to Type: boolean @@ -6735,9 +6585,11 @@ Chapter 7. Reference ``Reply-To:'' header field was set by the mailing list to automate responses to the list, and will ignore this field. To direct a response to the mailing list when this option is set, use the list-reply function; - group-reply will reply to both the sender and the list. + group-reply will reply to both the sender and the list. Remember: This + option works only for mailing lists which are explicitly set in your + muttngrc configuration file. -97. imap_authenticators +97. $imap_authenticators Type: string @@ -6760,7 +6612,7 @@ Chapter 7. Reference previous methods are unavailable. If a method is available but authentication fails, Mutt-ng will not connect to the IMAP server. -98. imap_check_subscribed +98. $imap_check_subscribed Type: boolean @@ -6770,7 +6622,7 @@ Chapter 7. Reference on connection, and add them to the set of mailboxes it polls for new mail. See also the ``mailboxes'' command. -99. imap_delim_chars +99. $imap_delim_chars Type: string @@ -6782,7 +6634,7 @@ Chapter 7. Reference folder separators for displaying IMAP paths. In particular it helps in using the '=' shortcut for your $folder variable. -100. imap_headers +100. $imap_headers Type: string @@ -6798,7 +6650,7 @@ Chapter 7. Reference Note: This is a space separated list. -101. imap_home_namespace +101. $imap_home_namespace Type: string @@ -6810,7 +6662,7 @@ Chapter 7. Reference IMAP browser. If you see something else, you may set this variable to the IMAP path to your folders. -102. imap_keepalive +102. $imap_keepalive Type: number @@ -6829,7 +6681,7 @@ Chapter 7. Reference Reduce this number if you find yourself getting disconnected from your IMAP server due to inactivity. -103. imap_list_subscribed +103. $imap_list_subscribed Type: boolean @@ -6841,7 +6693,7 @@ Chapter 7. Reference subscribed folders or all folders. This can be toggled in the IMAP browser with the toggle-subscribed function. -104. imap_login +104. $imap_login Type: string @@ -6853,7 +6705,7 @@ Chapter 7. Reference This variable defaults to the value of ``$imap_user.'' -105. imap_mail_check +105. $imap_mail_check Type: number @@ -6864,7 +6716,7 @@ Chapter 7. Reference to generate less traffic and get more accurate information for local folders. -106. imap_pass +106. $imap_pass Type: string @@ -6879,7 +6731,7 @@ Chapter 7. Reference machine, because the superuser can read your configuration even if you are the only one who can read the file. -107. imap_passive +107. $imap_passive Type: boolean @@ -6892,7 +6744,7 @@ Chapter 7. Reference This is useful if you don't want to be prompted to user/password pairs on Mutt-ng invocation, or if opening the connection is slow. -108. imap_peek +108. $imap_peek Type: boolean @@ -6905,7 +6757,7 @@ Chapter 7. Reference can make closing an IMAP folder somewhat slower. This option exists to appease speed freaks. -109. imap_reconnect +109. $imap_reconnect Type: quadoption @@ -6916,7 +6768,7 @@ Chapter 7. Reference Controls whether or not Mutt-ng will try to reconnect to IMAP server when the connection is lost. -110. imap_servernoise +110. $imap_servernoise Type: boolean @@ -6929,7 +6781,7 @@ Chapter 7. Reference to configuration problems on the server which are out of the users' hands, you may wish to suppress them at some point. -111. imap_user +111. $imap_user Type: string @@ -6941,7 +6793,7 @@ Chapter 7. Reference This variable defaults to your user name on the local machine. -112. implicit_autoview +112. $implicit_autoview Type: boolean @@ -6952,7 +6804,7 @@ Chapter 7. Reference defined for. If such an entry is found, Mutt-ng will use the viewer defined in that entry to convert the body part to text form. -113. include +113. $include Type: quadoption @@ -6961,7 +6813,7 @@ Chapter 7. Reference Controls whether or not a copy of the message(s) you are replying to is included in your reply. -114. include_onlyfirst +114. $include_onlyfirst Type: boolean @@ -6970,7 +6822,7 @@ Chapter 7. Reference Controls whether or not Mutt-ng includes only the first attachment of the message you are replying. -115. indent_string +115. $indent_string Type: string @@ -6980,7 +6832,7 @@ Chapter 7. Reference to which you are replying. You are strongly encouraged not to change this value, as it tends to agitate the more fanatical netizens. -116. index_format +116. $index_format Type: string @@ -7117,6 +6969,10 @@ Chapter 7. Reference name of organization of author (`organization:' field) + %X + + number of attachments + %y `x-label:' field, if present @@ -7164,7 +7020,7 @@ Chapter 7. Reference See also: ``$to_chars''. -117. ispell +117. $ispell Type: path @@ -7172,7 +7028,7 @@ Chapter 7. Reference How to invoke ispell (GNU's spell-checking software). -118. keep_flagged +118. $keep_flagged Type: boolean @@ -7182,7 +7038,7 @@ Chapter 7. Reference mailbox to your ``$mbox'' mailbox, or as a result of a ``mbox-hook'' command. -119. list_reply +119. $list_reply Type: quadoption @@ -7192,7 +7048,7 @@ Chapter 7. Reference from (instead to the author only). Setting this option to ``ask-yes'' or ``ask-no'' will ask if you really intended to reply to the author only. -120. locale +120. $locale Type: string @@ -7201,7 +7057,7 @@ Chapter 7. Reference The locale used by strftime(3) to format dates. Legal values are the strings your system accepts for the locale variable LC_TIME. -121. mail_check +121. $mail_check Type: number @@ -7212,7 +7068,7 @@ Chapter 7. Reference Note: This does not apply to IMAP mailboxes, see $imap_mail_check. -122. mailcap_path +122. $mailcap_path Type: string @@ -7221,7 +7077,7 @@ Chapter 7. Reference This variable specifies which files to consult when attempting to display MIME bodies not directly supported by Mutt-ng. -123. mailcap_sanitize +123. $mailcap_sanitize Type: boolean @@ -7233,7 +7089,7 @@ Chapter 7. Reference DON'T CHANGE THIS SETTING UNLESS YOU ARE REALLY SURE WHAT YOU ARE DOING! -124. maildir_header_cache_verify +124. $maildir_header_cache_verify Type: boolean @@ -7245,7 +7101,7 @@ Chapter 7. Reference maildir files when the header cache is in use. This incurs one stat(2) per message every time the folder is opened. -125. maildir_trash +125. $maildir_trash Type: boolean @@ -7259,20 +7115,20 @@ Chapter 7. Reference It is similiar to the trash option. -126. mark_old +126. $mark_old Type: boolean Default: yes - Controls whether or not Mutt-ng marks new unread messages as old if you + Controls whether or not Mutt-ng marks newunread messages as old if you exit a mailbox without reading them. With this option set, the next time you start Mutt-ng, the messages will show up with an "O" next to them in the ``index'' menu, indicating that they are old. -127. markers +127. $markers Type: boolean @@ -7282,7 +7138,7 @@ Chapter 7. Reference ``+'' marker is displayed at the beginning of wrapped lines. Also see the ``$smart_wrap'' variable. -128. mask +128. $mask Type: regular expression @@ -7292,7 +7148,7 @@ Chapter 7. Reference not operator ``!''. Only files whose names match this mask will be shown. The match is always case-sensitive. -129. max_display_recips +129. $max_display_recips Type: number @@ -7303,7 +7159,7 @@ Chapter 7. Reference turned on. In case the number of lines exeeds its value, the last line will have 3 dots appended. -130. max_line_length +130. $max_line_length Type: number @@ -7314,16 +7170,16 @@ Chapter 7. Reference default) means that the maximum line length is determined by the terminal width and $wrapmargin. -131. mbox +131. $mbox Type: path - Default: "˜/mbox" + Default: "~/mbox" This specifies the folder into which read mail in your ``$spoolfile'' folder will be appended. -132. mbox_type +132. $mbox_type Type: folder magic @@ -7332,7 +7188,7 @@ Chapter 7. Reference The default mailbox type used when creating new folders. May be any of mbox, MMDF, MH and Maildir. -133. menu_context +133. $menu_context Type: number @@ -7341,7 +7197,7 @@ Chapter 7. Reference This variable controls the number of lines of context that are given when scrolling through menus. (Similar to ``$pager_context''.) -134. menu_move_off +134. $menu_move_off Type: boolean @@ -7351,7 +7207,7 @@ Chapter 7. Reference of the screen, unless there are less entries than lines. When set, the bottom entry may move off the bottom. -135. menu_scroll +135. $menu_scroll Type: boolean @@ -7362,7 +7218,7 @@ Chapter 7. Reference next or previous page of the menu is displayed (useful for slow links to avoid many redraws). -136. message_format +136. $message_format Type: string @@ -7372,7 +7228,7 @@ Chapter 7. Reference type message/rfc822. For a full listing of defined printf(3)-like sequences see the section on ``$index_format''. -137. meta_key +137. $meta_key Type: boolean @@ -7381,11 +7237,11 @@ Chapter 7. Reference If set, forces Mutt-ng to interpret keystrokes with the high bit (bit 8) set as if the user had pressed the ESC key and whatever key remains after having the high bit removed. For example, if the key pressed has an ASCII - value of 0xf4, then this is treated as if the user had pressed ESC then - ``x''. This is because the result of removing the high bit from ``0xf4'' - is ``0x74'', which is the ASCII character ``x''. + value of 0xf8, then this is treated as if the user had pressed ESC then + ``x''. This is because the result of removing the high bit from ``0xf8'' + is ``0x78'', which is the ASCII character ``x''. -138. metoo +138. $metoo Type: boolean @@ -7394,7 +7250,7 @@ Chapter 7. Reference If unset, Mutt-ng will remove your address (see the ``alternates'' command) from the list of recipients when replying to a message. -139. mh_purge +139. $mh_purge Type: boolean @@ -7404,7 +7260,7 @@ Chapter 7. Reference to , in mh folders instead of really deleting them. If the variable is set, the message files will simply be deleted. -140. mh_seq_flagged +140. $mh_seq_flagged Type: string @@ -7412,7 +7268,7 @@ Chapter 7. Reference The name of the MH sequence used for flagged messages. -141. mh_seq_replied +141. $mh_seq_replied Type: string @@ -7420,7 +7276,7 @@ Chapter 7. Reference The name of the MH sequence used to tag replied messages. -142. mh_seq_unseen +142. $mh_seq_unseen Type: string @@ -7428,7 +7284,7 @@ Chapter 7. Reference The name of the MH sequence used for unseen messages. -143. mime_forward +143. $mime_forward Type: quadoption @@ -7444,7 +7300,7 @@ Chapter 7. Reference Also see ``$forward_decode'' and ``$mime_forward_decode''. -144. mime_forward_decode +144. $mime_forward_decode Type: boolean @@ -7454,7 +7310,7 @@ Chapter 7. Reference forwarding a message while ``$mime_forward'' is set. Otherwise ``$forward_decode'' is used instead. -145. mime_forward_rest +145. $mime_forward_rest Type: quadoption @@ -7464,7 +7320,7 @@ Chapter 7. Reference menu, attachments which cannot be decoded in a reasonable manner will be attached to the newly composed message if this option is set. -146. mix_entry_format +146. $mix_entry_format Type: string @@ -7492,7 +7348,7 @@ Chapter 7. Reference The remailer's e-mail address. -147. mixmaster +147. $mixmaster Type: path @@ -7504,7 +7360,7 @@ Chapter 7. Reference is used with various sets of parameters to gather the list of known remailers, and to finally send a message through the mixmaster chain. -148. move +148. $move Type: quadoption @@ -7514,14 +7370,14 @@ Chapter 7. Reference mailbox to your ``$mbox'' mailbox, or as a result of a ``mbox-hook'' command. -149. msgid_format +149. $msgid_format Type: string Default: "%Y%m%d%h%M%s.G%P%p" - This is the format for the ``local part'' of the Message-Id: header field - generated by Mutt-ng. If this variable is empty, no Message-Id: headers + This is the format for the ``local part'' of the Message-ID: header field + generated by Mutt-ng. If this variable is empty, no Message-ID: headers will be generated. The '%' character marks that certain data will be added to the string, similar to printf(3). The following characters are allowed: @@ -7585,7 +7441,7 @@ Chapter 7. Reference Note: Please only change this setting if you know what you are doing. Also make sure to consult RFC2822 to produce technically valid strings. -150. muttng_bindir +150. $muttng_bindir Type: system property @@ -7594,7 +7450,7 @@ Chapter 7. Reference This is a read-only system property and specifies the directory containing the muttng binary. -151. muttng_docdir +151. $muttng_docdir Type: system property @@ -7603,7 +7459,7 @@ Chapter 7. Reference This is a read-only system property and specifies the directory containing the muttng documentation. -152. muttng_folder_name +152. $muttng_folder_name Type: system property @@ -7613,7 +7469,7 @@ Chapter 7. Reference part of the full path or URI of the folder currently open (if any), i.e. everything after the last ``/''. -153. muttng_folder_path +153. $muttng_folder_path Type: system property @@ -7622,7 +7478,7 @@ Chapter 7. Reference This is a read-only system property and, at runtime, specifies the full path or URI of the folder currently open (if any). -154. muttng_hcache_backend +154. $muttng_hcache_backend Type: system property @@ -7631,7 +7487,7 @@ Chapter 7. Reference This is a read-only system property and specifies the header chaching's database backend. -155. muttng_pwd +155. $muttng_pwd Type: system property @@ -7640,16 +7496,16 @@ Chapter 7. Reference This is a read-only system property and, at runtime, specifies the current working directory of the muttng binary. -156. muttng_revision +156. $muttng_revision Type: system property - Value: 503 + Value: 541 This is a read-only system property and specifies muttng's subversion revision string. -157. muttng_sysconfdir +157. $muttng_sysconfdir Type: system property @@ -7658,7 +7514,7 @@ Chapter 7. Reference This is a read-only system property and specifies the directory containing the muttng system-wide configuration. -158. muttng_version +158. $muttng_version Type: system property @@ -7666,7 +7522,7 @@ Chapter 7. Reference This is a read-only system property and specifies muttng's version string. -159. narrow_tree +159. $narrow_tree Type: boolean @@ -7675,7 +7531,7 @@ Chapter 7. Reference This variable, when set, makes the thread tree narrower, allowing deeper threads to fit on the screen. -160. net_inc +160. $net_inc Type: number @@ -7687,7 +7543,7 @@ Chapter 7. Reference See also ``$read_inc'' and ``$write_inc''. -161. nntp_ask_followup_to +161. $nntp_ask_followup_to Type: boolean @@ -7698,7 +7554,7 @@ Chapter 7. Reference If set, Mutt-ng will prompt you for the Followup-To: header field before editing the body of an outgoing news article. -162. nntp_ask_x_comment_to +162. $nntp_ask_x_comment_to Type: boolean @@ -7709,11 +7565,11 @@ Chapter 7. Reference If set, Mutt-ng will prompt you for the X-Comment-To: header field before editing the body of an outgoing news article. -163. nntp_cache_dir +163. $nntp_cache_dir Type: path - Default: "˜/.muttng" + Default: "~/.muttng" Availability: NNTP @@ -7724,7 +7580,7 @@ Chapter 7. Reference As for the header caching in connection with IMAP and/or Maildir, this drastically increases speed and lowers traffic. -164. nntp_catchup +164. $nntp_catchup Type: quadoption @@ -7735,7 +7591,7 @@ Chapter 7. Reference If this variable is set, Mutt-ng will mark all articles in a newsgroup as read when you leaving it. -165. nntp_context +165. $nntp_context Type: number @@ -7750,7 +7606,7 @@ Chapter 7. Reference If there're more articles than defined with $nntp_context, all older ones will be removed/not shown in the index. -166. nntp_followup_to_poster +166. $nntp_followup_to_poster Type: quadoption @@ -7762,7 +7618,7 @@ Chapter 7. Reference Followup-To: header field, a follow-up to the newsgroup is not permitted. The message will be mailed to the submitter of the message via mail. -167. nntp_group_index_format +167. $nntp_group_index_format Type: string @@ -7785,7 +7641,7 @@ Chapter 7. Reference %|X pad to the end of the line with character "X" -168. nntp_host +168. $nntp_host Type: string @@ -7808,7 +7664,7 @@ Chapter 7. Reference presents a security risk since the superuser of your machine may read it regardless of the file's permissions. -169. nntp_inews +169. $nntp_inews Type: path @@ -7825,7 +7681,7 @@ Chapter 7. Reference Example: set inews="/usr/local/bin/inews -hS" -170. nntp_load_description +170. $nntp_load_description Type: boolean @@ -7836,7 +7692,7 @@ Chapter 7. Reference This variable controls whether or not descriptions for newsgroups are to be loaded when subscribing to a newsgroup. -171. nntp_mail_check +171. $nntp_mail_check Type: number @@ -7848,7 +7704,7 @@ Chapter 7. Reference new article will cause a recheck for new news. If set to 0, Mutt-ng will recheck on each operation in index (stepping, read article, etc.). -172. nntp_mime_subject +172. $nntp_mime_subject Type: boolean @@ -7861,11 +7717,11 @@ Chapter 7. Reference Note: Only change this setting if you know what you are doing. -173. nntp_newsrc +173. $nntp_newsrc Type: path - Default: "˜/.newsrc" + Default: "~/.newsrc" Availability: NNTP @@ -7878,7 +7734,7 @@ Chapter 7. Reference %s newsserver name -174. nntp_pass +174. $nntp_pass Type: string @@ -7892,7 +7748,7 @@ Chapter 7. Reference since the superuser of your machine may read it regardless of the file's permissions. -175. nntp_post_moderated +175. $nntp_post_moderated Type: quadoption @@ -7906,7 +7762,7 @@ Chapter 7. Reference Note: if the newsserver does not support posting to that newsgroup or a group is totally read-only, that posting will not have any effect. -176. nntp_reconnect +176. $nntp_reconnect Type: quadoption @@ -7917,7 +7773,7 @@ Chapter 7. Reference Controls whether or not Mutt-ng will try to reconnect to a newsserver when the was connection lost. -177. nntp_save_unsubscribed +177. $nntp_save_unsubscribed Type: boolean @@ -7928,7 +7784,7 @@ Chapter 7. Reference When set, info about unsubscribed newsgroups will be saved into the ``newsrc'' file and into the news cache. -178. nntp_show_new_news +178. $nntp_show_new_news Type: boolean @@ -7941,7 +7797,7 @@ Chapter 7. Reference controls whether or not the number of new articles of subscribed newsgroups will be checked. -179. nntp_show_only_unread +179. $nntp_show_only_unread Type: boolean @@ -7952,7 +7808,7 @@ Chapter 7. Reference If set, only subscribed newsgroups that contain unread articles will be displayed in the newsgroup browser. -180. nntp_user +180. $nntp_user Type: string @@ -7963,7 +7819,7 @@ Chapter 7. Reference Your login name on the NNTP server. If unset and the server requires authentification, Mutt-ng will prompt you for your account name. -181. nntp_x_comment_to +181. $nntp_x_comment_to Type: boolean @@ -7975,7 +7831,7 @@ Chapter 7. Reference full name of the original article author) to articles that you followup to. -182. operating_system +182. $operating_system Type: string @@ -7987,7 +7843,7 @@ Chapter 7. Reference It may, for example, look as: ``mutt-ng 1.5.9i (Linux)''. -183. pager +183. $pager Type: path @@ -8003,7 +7859,7 @@ Chapter 7. Reference pager, and screen resizes cause lines longer than the screen width to be badly formatted in the help menu. -184. pager_context +184. $pager_context Type: number @@ -8014,7 +7870,7 @@ Chapter 7. Reference Mutt-ng will display the line after the last one on the screen at the top of the next page (0 lines of context). -185. pager_format +185. $pager_format Type: string @@ -8024,7 +7880,7 @@ Chapter 7. Reference displayed before each message in either the internal or an external pager. The valid sequences are listed in the ``$index_format'' section. -186. pager_index_lines +186. $pager_index_lines Type: number @@ -8041,7 +7897,7 @@ Chapter 7. Reference of messages in the current folder is less than pager_index_lines, then the index will only use as many lines as it needs. -187. pager_stop +187. $pager_stop Type: boolean @@ -8050,7 +7906,7 @@ Chapter 7. Reference When set, the internal-pager will not move to the next message when you are at the end of a message and invoke the next-page function. -188. pgp_auto_decode +188. $pgp_auto_decode Type: boolean @@ -8063,7 +7919,7 @@ Chapter 7. Reference checked with the check-traditional-pgp function, Mutt-ng will automatically check the message for traditional pgp. -189. pgp_autoinline +189. $pgp_autoinline Type: boolean @@ -8079,10 +7935,10 @@ Chapter 7. Reference before sending PGP/MIME messages when inline (traditional) would not work. See also: ``$pgp_mime_auto''. - Also note that using the old-style PGP message format is strongly - deprecated. (PGP only) + Also note that using the old-style PGP message format is + stronglydeprecated. (PGP only) -190. pgp_check_exit +190. $pgp_check_exit Type: boolean @@ -8092,7 +7948,7 @@ Chapter 7. Reference signing or encrypting. A non-zero exit code means that the subprocess failed. (PGP only) -191. pgp_clearsign_command +191. $pgp_clearsign_command Type: string @@ -8100,9 +7956,9 @@ Chapter 7. Reference This format is used to create a old-style ``clearsigned'' PGP message. - Note that the use of this format is strongly deprecated. (PGP only) + Note that the use of this format is stronglydeprecated. (PGP only) -192. pgp_decode_command +192. $pgp_decode_command Type: string @@ -8140,7 +7996,7 @@ Chapter 7. Reference samples/ subdirectory which has been installed on your system alongside the documentation. (PGP only) -193. pgp_decrypt_command +193. $pgp_decrypt_command Type: string @@ -8148,7 +8004,7 @@ Chapter 7. Reference This command is used to decrypt a PGP encrypted message. (PGP only) -194. pgp_encrypt_only_command +194. $pgp_encrypt_only_command Type: string @@ -8156,7 +8012,7 @@ Chapter 7. Reference This command is used to encrypt a body part without signing it. (PGP only) -195. pgp_encrypt_sign_command +195. $pgp_encrypt_sign_command Type: string @@ -8164,7 +8020,7 @@ Chapter 7. Reference This command is used to both sign and encrypt a body part. (PGP only) -196. pgp_entry_format +196. $pgp_entry_format Type: string @@ -8212,7 +8068,7 @@ Chapter 7. Reference (PGP only) -197. pgp_export_command +197. $pgp_export_command Type: string @@ -8221,7 +8077,7 @@ Chapter 7. Reference This command is used to export a public key from the user's key ring. (PGP only) -198. pgp_getkeys_command +198. $pgp_getkeys_command Type: string @@ -8230,7 +8086,7 @@ Chapter 7. Reference This command is invoked whenever Mutt-ng will need public key information. %r is the only printf(3)-like sequence used with this format. (PGP only) -199. pgp_good_sign +199. $pgp_good_sign Type: regular expression @@ -8241,7 +8097,7 @@ Chapter 7. Reference text. Use this variable if the exit code from the command is 0 even for bad signatures. (PGP only) -200. pgp_ignore_subkeys +200. $pgp_ignore_subkeys Type: boolean @@ -8251,7 +8107,7 @@ Chapter 7. Reference Instead, the principal key will inherit the subkeys' capabilities. Unset this if you want to play interesting key selection games. (PGP only) -201. pgp_import_command +201. $pgp_import_command Type: string @@ -8260,7 +8116,7 @@ Chapter 7. Reference This command is used to import a key from a message into the user's public key ring. (PGP only) -202. pgp_list_pubring_command +202. $pgp_list_pubring_command Type: string @@ -8272,7 +8128,7 @@ Chapter 7. Reference This format is also generated by the pgpring utility which comes with Mutt-ng. (PGP only) -203. pgp_list_secring_command +203. $pgp_list_secring_command Type: string @@ -8284,7 +8140,7 @@ Chapter 7. Reference This format is also generated by the pgpring utility which comes with Mutt-ng. (PGP only) -204. pgp_long_ids +204. $pgp_long_ids Type: boolean @@ -8293,7 +8149,7 @@ Chapter 7. Reference If set, use 64 bit PGP key IDs. Unset uses the normal 32 bit Key IDs. (PGP only) -205. pgp_mime_auto +205. $pgp_mime_auto Type: quadoption @@ -8303,10 +8159,10 @@ Chapter 7. Reference sending a (signed/encrypted) message using PGP/MIME when inline (traditional) fails (for any reason). - Also note that using the old-style PGP message format is strongly - deprecated. (PGP only) + Also note that using the old-style PGP message format is + stronglydeprecated. (PGP only) -206. pgp_replyinline +206. $pgp_replyinline Type: boolean @@ -8324,10 +8180,10 @@ Chapter 7. Reference before sending PGP/MIME messages when inline (traditional) would not work. See also: ``$pgp_mime_auto''. - Also note that using the old-style PGP message format is strongly - deprecated. (PGP only) + Also note that using the old-style PGP message format is + stronglydeprecated. (PGP only) -207. pgp_retainable_sigs +207. $pgp_retainable_sigs Type: boolean @@ -8340,7 +8196,7 @@ Chapter 7. Reference where the outer layer (multipart/encrypted) can be easily removed, while the inner multipart/signed part is retained. (PGP only) -208. pgp_show_unusable +208. $pgp_show_unusable Type: boolean @@ -8350,7 +8206,7 @@ Chapter 7. Reference menu. This includes keys which have been revoked, have expired, or have been marked as ``disabled'' by the user. (PGP only) -209. pgp_sign_as +209. $pgp_sign_as Type: string @@ -8360,7 +8216,7 @@ Chapter 7. Reference which of your private keys to use. It is recommended that you use the keyid form to specify your key (e.g., ``0x00112233''). (PGP only) -210. pgp_sign_command +210. $pgp_sign_command Type: string @@ -8369,7 +8225,7 @@ Chapter 7. Reference This command is used to create the detached PGP signature for a multipart/signed PGP/MIME body part. (PGP only) -211. pgp_sort_keys +211. $pgp_sort_keys Type: sort order @@ -8397,7 +8253,7 @@ Chapter 7. Reference If you prefer reverse order of the above values, prefix it with ``reverse-''. (PGP only) -212. pgp_strict_enc +212. $pgp_strict_enc Type: boolean @@ -8408,7 +8264,7 @@ Chapter 7. Reference problems with non-verifyable PGP signatures, so only change this if you know what you are doing. (PGP only) -213. pgp_timeout +213. $pgp_timeout Type: number @@ -8417,7 +8273,7 @@ Chapter 7. Reference The number of seconds after which a cached passphrase will expire if not used. Default: 300. (PGP only) -214. pgp_use_gpg_agent +214. $pgp_use_gpg_agent Type: boolean @@ -8425,7 +8281,7 @@ Chapter 7. Reference If set, Mutt-ng will use a possibly-running gpg-agent process. (PGP only) -215. pgp_verify_command +215. $pgp_verify_command Type: string @@ -8433,7 +8289,7 @@ Chapter 7. Reference This command is used to verify PGP signatures. (PGP only) -216. pgp_verify_key_command +216. $pgp_verify_key_command Type: string @@ -8442,7 +8298,7 @@ Chapter 7. Reference This command is used to verify key information from the key selection menu. (PGP only) -217. pipe_decode +217. $pipe_decode Type: boolean @@ -8452,7 +8308,7 @@ Chapter 7. Reference pipe the messages without any preprocessing. When set, Mutt-ng will weed headers and will attempt to PGP/MIME decode the messages first. -218. pipe_sep +218. $pipe_sep Type: string @@ -8461,7 +8317,7 @@ Chapter 7. Reference The separator to add between messages when piping a list of tagged messages to an external Unix command. -219. pipe_split +219. $pipe_split Type: boolean @@ -8474,7 +8330,7 @@ Chapter 7. Reference by one. In both cases the messages are piped in the current sorted order, and the ``$pipe_sep'' separator is added after each message. -220. pop_auth_try_all +220. $pop_auth_try_all Type: boolean @@ -8487,7 +8343,7 @@ Chapter 7. Reference unavailable. If a method is available but authentication fails, Mutt-ng will not connect to the POP server. -221. pop_authenticators +221. $pop_authenticators Type: string @@ -8506,7 +8362,7 @@ Chapter 7. Reference Example: set pop_authenticators="digest-md5:apop:user" -222. pop_delete +222. $pop_delete Type: quadoption @@ -8518,7 +8374,7 @@ Chapter 7. Reference server when using the ``fetch-mail'' function. When unset, Mutt-ng will download messages but also leave them on the POP server. -223. pop_host +223. $pop_host Type: string @@ -8535,7 +8391,7 @@ Chapter 7. Reference since the superuser of your machine may read it regardless of the file's permissions. -224. pop_last +224. $pop_last Type: boolean @@ -8547,7 +8403,7 @@ Chapter 7. Reference for retrieving only unread messages from the POP server when using the ``fetch-mail'' function. -225. pop_mail_check +225. $pop_mail_check Type: number @@ -8555,10 +8411,10 @@ Chapter 7. Reference Availability: POP - This variable configures how often (in seconds) POP should look for new - mail. + This variable configures how often (in seconds) Mutt-ng should look for + new mail. -226. pop_pass +226. $pop_pass Type: string @@ -8573,7 +8429,7 @@ Chapter 7. Reference since the superuser of your machine may read it regardless of the file's permissions. -227. pop_reconnect +227. $pop_reconnect Type: quadoption @@ -8581,10 +8437,10 @@ Chapter 7. Reference Availability: POP - Controls whether or not Mutt-ng will try to reconnect to a POP server when + Controls whether or not Mutt-ng will try to reconnect to a POP server if the connection is lost. -228. pop_user +228. $pop_user Type: string @@ -8596,7 +8452,7 @@ Chapter 7. Reference This variable defaults to your user name on the local machine. -229. post_indent_string +229. $post_indent_string Type: string @@ -8605,7 +8461,7 @@ Chapter 7. Reference Similar to the ``$attribution'' variable, Mutt-ng will append this string after the inclusion of a message which is being replied to. -230. postpone +230. $postpone Type: quadoption @@ -8614,18 +8470,18 @@ Chapter 7. Reference Controls whether or not messages are saved in the ``$postponed'' mailbox when you elect not to send immediately. -231. postponed +231. $postponed Type: path - Default: "˜/postponed" + Default: "~/postponed" Mutt-ng allows you to indefinitely ``postpone sending a message'' which you are editing. When you choose to postpone a message, Mutt-ng saves it in the mailbox specified by this variable. Also see the ``$postpone'' variable. -232. preconnect +232. $preconnect Type: string @@ -8645,7 +8501,7 @@ Chapter 7. Reference Note: For this example to work, you must be able to log in to the remote machine without having to enter a password. -233. print +233. $print Type: quadoption @@ -8654,7 +8510,7 @@ Chapter 7. Reference Controls whether or not Mutt-ng really prints messages. This is set to ask-no by default, because some people accidentally hit ``p'' often. -234. print_command +234. $print_command Type: path @@ -8662,7 +8518,7 @@ Chapter 7. Reference This specifies the command pipe that should be used to print messages. -235. print_decode +235. $print_decode Type: boolean @@ -8675,7 +8531,7 @@ Chapter 7. Reference useful if you are using some advanced printer filter which is able to properly format e-mail messages for printing. -236. print_split +236. $print_split Type: boolean @@ -8690,7 +8546,7 @@ Chapter 7. Reference Those who use the enscript(1) program's mail-printing mode will most likely want to set this option. -237. prompt_after +237. $prompt_after Type: boolean @@ -8701,7 +8557,7 @@ Chapter 7. Reference returning to the index menu. If unset, Mutt-ng will return to the index menu when the external pager exits. -238. query_command +238. $query_command Type: path @@ -8711,7 +8567,7 @@ Chapter 7. Reference queries. The string should contain a %s, which will be substituted with the query string the user types. See ``query'' for more information. -239. quit +239. $quit Type: quadoption @@ -8722,7 +8578,7 @@ Chapter 7. Reference effect, and if it is set to ask-yes or ask-no, you are prompted for confirmation when you try to quit. -240. quote_empty +240. $quote_empty Type: boolean @@ -8731,7 +8587,7 @@ Chapter 7. Reference Controls whether or not empty lines will be quoted using ``indent_string''. -241. quote_quoted +241. $quote_quoted Type: boolean @@ -8741,7 +8597,7 @@ Chapter 7. Reference be added to the end of existing prefix. Otherwise, quoted lines will be prepended by ``indent_string''. -242. quote_regexp +242. $quote_regexp Type: regular expression @@ -8754,7 +8610,7 @@ Chapter 7. Reference to set this to a regular expression that matches exactly the quote characters at the beginning of quoted lines. -243. read_inc +243. $read_inc Type: number @@ -8770,7 +8626,7 @@ Chapter 7. Reference Also see the ``$write_inc'' variable. -244. read_only +244. $read_only Type: boolean @@ -8778,7 +8634,7 @@ Chapter 7. Reference If set, all folders are opened in read-only mode. -245. realname +245. $realname Type: string @@ -8792,7 +8648,7 @@ Chapter 7. Reference Note: This variable will not be used when the user has set a real name in the $from variable. -246. recall +246. $recall Type: quadoption @@ -8804,7 +8660,7 @@ Chapter 7. Reference Setting this variable to yes is not generally useful, and thus not recommended. -247. record +247. $record Type: path @@ -8818,7 +8674,7 @@ Chapter 7. Reference The value of $record is overridden by the ``$force_name'' and ``$save_name'' variables, and the ``fcc-hook'' command. -248. reply_regexp +248. $reply_regexp Type: regular expression @@ -8828,7 +8684,7 @@ Chapter 7. Reference replying. The default value corresponds to the English ``Re:'' and the German ``Aw:''. -249. reply_self +249. $reply_self Type: boolean @@ -8838,7 +8694,7 @@ Chapter 7. Reference assume that you want to reply to the recipients of that message rather than to yourself. -250. reply_to +250. $reply_to Type: quadoption @@ -8852,7 +8708,7 @@ Chapter 7. Reference ``Reply-To:'' header field to the list address and you want to send a private message to the author of a message. -251. resolve +251. $resolve Type: boolean @@ -8862,7 +8718,7 @@ Chapter 7. Reference undeleted) message whenever a command that modifies the current message is executed. -252. reverse_alias +252. $reverse_alias Type: boolean @@ -8883,7 +8739,7 @@ Chapter 7. Reference ``abd30425@somewhere.net.'' This is useful when the person's e-mail address is not human friendly (like CompuServe addresses). -253. reverse_name +253. $reverse_name Type: boolean @@ -8897,7 +8753,7 @@ Chapter 7. Reference is unset, or the address that would be used doesn't match your alternates, the From: line will use your address on the current machine. -254. reverse_realname +254. $reverse_realname Type: boolean @@ -8908,7 +8764,7 @@ Chapter 7. Reference possibly including eventual real names. When it is unset, Mutt-ng will override any such real names with the setting of the realname variable. -255. rfc2047_parameters +255. $rfc2047_parameters Type: boolean @@ -8930,7 +8786,7 @@ Chapter 7. Reference Mutt-ng generates this kind of encoding. Instead, Mutt-ng will unconditionally use the encoding specified in RFC 2231. -256. save_address +256. $save_address Type: boolean @@ -8940,7 +8796,7 @@ Chapter 7. Reference default folder for saving a mail. If ``$save_name'' or ``$force_name'' is set too, the selection of the fcc folder will be changed as well. -257. save_empty +257. $save_empty Type: boolean @@ -8953,7 +8809,7 @@ Chapter 7. Reference Note: This only applies to mbox and MMDF folders, Mutt-ng does not delete MH and Maildir directories. -258. save_name +258. $save_name Type: boolean @@ -8968,7 +8824,7 @@ Chapter 7. Reference Also see the ``$force_name'' variable. -259. score +259. $score Type: boolean @@ -8978,7 +8834,7 @@ Chapter 7. Reference selectively disable scoring for certain folders when the ``$score_threshold_delete'' variable and friends are used. -260. score_threshold_delete +260. $score_threshold_delete Type: number @@ -8989,7 +8845,7 @@ Chapter 7. Reference Mutt-ng scores are always greater than or equal to zero, the default setting of this variable will never mark a message for deletion. -261. score_threshold_flag +261. $score_threshold_flag Type: number @@ -8998,7 +8854,7 @@ Chapter 7. Reference Messages which have been assigned a score greater than or equal to this variable's value are automatically marked ``flagged''. -262. score_threshold_read +262. $score_threshold_read Type: number @@ -9009,7 +8865,7 @@ Chapter 7. Reference Mutt-ng scores are always greater than or equal to zero, the default setting of this variable will never mark a message read. -263. send_charset +263. $send_charset Type: string @@ -9022,7 +8878,7 @@ Chapter 7. Reference character set (such as iso-8859-2, koi8-r or iso-2022-jp) either instead of or after iso-8859-1. -264. sendmail +264. $sendmail Type: path @@ -9032,7 +8888,7 @@ Chapter 7. Reference Mutt-ng expects that the specified program interprets additional arguments as recipient addresses. -265. sendmail_wait +265. $sendmail_wait Type: number @@ -9059,7 +8915,7 @@ Chapter 7. Reference process will be put in a temporary file. If there is some error, you will be informed as to where to find the output. -266. shell +266. $shell Type: path @@ -9068,7 +8924,7 @@ Chapter 7. Reference Command to use when spawning a subshell. By default, the user's login shell from /etc/passwd is used. -267. sidebar_boundary +267. $sidebar_boundary Type: string @@ -9078,7 +8934,7 @@ Chapter 7. Reference variable specifies the characters at which to split a folder name into ``hierarchy items.'' -268. sidebar_delim +268. $sidebar_delim Type: string @@ -9087,7 +8943,7 @@ Chapter 7. Reference This specifies the delimiter between the sidebar (if visible) and other screens. -269. sidebar_newmail_only +269. $sidebar_newmail_only Type: boolean @@ -9095,7 +8951,7 @@ Chapter 7. Reference If set, only folders with new mail will be shown in the sidebar. -270. sidebar_number_format +270. $sidebar_number_format Type: string @@ -9103,7 +8959,7 @@ Chapter 7. Reference This variable controls how message counts are printed when the sidebar is enabled. If this variable is empty (and only if), no numbers will be - printed and mutt-ng won't frequently count mail (which may be a great + printed and Mutt-ng won't frequently count mail (which may be a great speedup esp. with mbox-style mailboxes.) The following printf(3)-like sequences are supported all of which may be @@ -9136,7 +8992,7 @@ Chapter 7. Reference 1) These expandos only have a non-zero value for the current mailbox and will always be zero otherwise. -271. sidebar_shorten_hierarchy +271. $sidebar_shorten_hierarchy Type: boolean @@ -9152,7 +9008,7 @@ Chapter 7. Reference At which characters this compression is done is controled via the $sidebar_boundary variable. -272. sidebar_visible +272. $sidebar_visible Type: boolean @@ -9161,7 +9017,7 @@ Chapter 7. Reference This specifies whether or not to show the sidebar (a list of folders specified with the ``mailboxes'' command). -273. sidebar_width +273. $sidebar_width Type: number @@ -9169,7 +9025,7 @@ Chapter 7. Reference The width of the sidebar. -274. sig_dashes +274. $sig_dashes Type: boolean @@ -9184,7 +9040,7 @@ Chapter 7. Reference For example, Mutt-ng has the ability to highlight the signature in a different color in the builtin pager. -275. sig_on_top +275. $sig_on_top Type: boolean @@ -9195,17 +9051,17 @@ Chapter 7. Reference you really know what you are doing, and are prepared to take some heat from netiquette guardians. -276. signature +276. $signature Type: path - Default: "˜/.signature" + Default: "~/.signature" Specifies the filename of your signature, which is appended to all outgoing messages. If the filename ends with a pipe (``|''), it is assumed that filename is a shell command and input should be read from its stdout. -277. signoff_string +277. $signoff_string Type: string @@ -9218,23 +9074,23 @@ Chapter 7. Reference or witty quotes into your mails, better use a signature file instead of the signoff string. -278. simple_search +278. $simple_search Type: string - Default: "˜f %s | ˜s %s" + Default: "~f %s | ~s %s" Specifies how Mutt-ng should expand a simple search into a real search - pattern. A simple search is one that does not contain any of the ˜ + pattern. A simple search is one that does not contain any of the ~ operators. See ``patterns'' for more information on search patterns. For example, if you simply type ``joe'' at a search or limit prompt, Mutt-ng will automatically expand it to the value specified by this variable. For the default value it would be: - ˜f joe | ˜s joe + ~f joe | ~s joe -279. sleep_time +279. $sleep_time Type: number @@ -9245,7 +9101,7 @@ Chapter 7. Reference expunging messages from the current folder. The default is to pause one second, so a value of zero for this option suppresses the pause. -280. smart_wrap +280. $smart_wrap Type: boolean @@ -9255,7 +9111,7 @@ Chapter 7. Reference pager. If set, long lines are wrapped at a word boundary. If unset, lines are simply wrapped at the screen edge. Also see the ``$markers'' variable. -281. smileys +281. $smileys Type: regular expression @@ -9264,7 +9120,7 @@ Chapter 7. Reference The pager uses this variable to catch some common false positives of ``$quote_regexp'', most notably smileys in the beginning of a line -282. smime_ask_cert_label +282. $smime_ask_cert_label Type: boolean @@ -9274,7 +9130,7 @@ Chapter 7. Reference certificate about to be added to the database or not. It is set by default. (S/MIME only) -283. smime_ca_location +283. $smime_ca_location Type: path @@ -9283,7 +9139,7 @@ Chapter 7. Reference This variable contains the name of either a directory, or a file which contains trusted certificates for use with OpenSSL. (S/MIME only) -284. smime_certificates +284. $smime_certificates Type: path @@ -9296,7 +9152,7 @@ Chapter 7. Reference contains mailbox-address keyid pairs, and which can be manually edited. This one points to the location of the certificates. (S/MIME only) -285. smime_decrypt_command +285. $smime_decrypt_command Type: string @@ -9339,7 +9195,7 @@ Chapter 7. Reference samples/ subdirectory which has been installed on your system alongside the documentation. (S/MIME only) -286. smime_decrypt_use_default_key +286. $smime_decrypt_use_default_key Type: boolean @@ -9350,7 +9206,7 @@ Chapter 7. Reference use the mailbox-address to determine the key to use. It will ask you to supply a key, if it can't find one. (S/MIME only) -287. smime_default_key +287. $smime_default_key Type: string @@ -9360,7 +9216,7 @@ Chapter 7. Reference keyid (the hash-value that OpenSSL generates) to work properly (S/MIME only) -288. smime_encrypt_command +288. $smime_encrypt_command Type: string @@ -9368,7 +9224,7 @@ Chapter 7. Reference This command is used to create encrypted S/MIME messages. (S/MIME only) -289. smime_encrypt_with +289. $smime_encrypt_with Type: string @@ -9379,7 +9235,7 @@ Chapter 7. Reference If unset ``3des'' (TripleDES) is used. (S/MIME only) -290. smime_get_cert_command +290. $smime_get_cert_command Type: string @@ -9388,7 +9244,7 @@ Chapter 7. Reference This command is used to extract X509 certificates from a PKCS7 structure. (S/MIME only) -291. smime_get_cert_email_command +291. $smime_get_cert_email_command Type: string @@ -9398,7 +9254,7 @@ Chapter 7. Reference certificates, and for verification purposes (to check whether the certificate was issued for the sender's mailbox). (S/MIME only) -292. smime_get_signer_cert_command +292. $smime_get_signer_cert_command Type: string @@ -9408,7 +9264,7 @@ Chapter 7. Reference S/MIME signature, so that the certificate's owner may get compared to the email's ``From:'' header field. (S/MIME only) -293. smime_import_cert_command +293. $smime_import_cert_command Type: string @@ -9417,7 +9273,7 @@ Chapter 7. Reference This command is used to import a certificate via smime_keysng. (S/MIME only) -294. smime_is_default +294. $smime_is_default Type: boolean @@ -9433,7 +9289,7 @@ Chapter 7. Reference (Note that this variable can be overridden by unsetting $crypt_autosmime.) (S/MIME only) -295. smime_keys +295. $smime_keys Type: path @@ -9446,7 +9302,7 @@ Chapter 7. Reference which contains mailbox-address keyid pair, and which can be manually edited. This one points to the location of the private keys. (S/MIME only) -296. smime_pk7out_command +296. $smime_pk7out_command Type: string @@ -9455,7 +9311,7 @@ Chapter 7. Reference This command is used to extract PKCS7 structures of S/MIME signatures, in order to extract the public X509 certificate(s). (S/MIME only) -297. smime_sign_command +297. $smime_sign_command Type: string @@ -9464,7 +9320,7 @@ Chapter 7. Reference This command is used to created S/MIME signatures of type multipart/signed, which can be read by all mail clients. (S/MIME only) -298. smime_sign_opaque_command +298. $smime_sign_opaque_command Type: string @@ -9474,7 +9330,7 @@ Chapter 7. Reference application/x-pkcs7-signature, which can only be handled by mail clients supporting the S/MIME extension. (S/MIME only) -299. smime_timeout +299. $smime_timeout Type: number @@ -9483,7 +9339,7 @@ Chapter 7. Reference The number of seconds after which a cached passphrase will expire if not used. (S/MIME only) -300. smime_verify_command +300. $smime_verify_command Type: string @@ -9492,7 +9348,7 @@ Chapter 7. Reference This command is used to verify S/MIME signatures of type multipart/signed. (S/MIME only) -301. smime_verify_opaque_command +301. $smime_verify_opaque_command Type: string @@ -9501,23 +9357,7 @@ Chapter 7. Reference This command is used to verify S/MIME signatures of type application/x-pkcs7-mime. (S/MIME only) -302. smtp_envelope - - Type: string - - Default: "" - - Availability: SMTP - - If this variable is non-empty, it'll be used as the envelope sender. If - it's empty (the default), the value of the regular From: header will be - used. - - This may be necessary as some providers don't allow for arbitrary values - as the envelope sender but only a particular one which may not be the same - as the user's desired From: header. - -303. smtp_host +302. $smtp_host Type: string @@ -9529,7 +9369,7 @@ Chapter 7. Reference invoking the sendmail binary. Setting this variable overrides the value of ``$sendmail'', and any associated variables. -304. smtp_pass +303. $smtp_pass Type: string @@ -9544,7 +9384,7 @@ Chapter 7. Reference since the superuser of your machine may read it regardless of the file's permissions. -305. smtp_port +304. $smtp_port Type: number @@ -9558,7 +9398,7 @@ Chapter 7. Reference Defaults to 25, the standard SMTP port, but RFC 2476-compliant SMTP servers will probably desire 587, the mail submission port. -306. smtp_use_tls +305. $smtp_use_tls Type: string @@ -9572,7 +9412,7 @@ Chapter 7. Reference to start TLS and continue without TLS in case of an error. Muttng still needs to have SSL support enabled in order to use it. -307. smtp_user +306. $smtp_user Type: string @@ -9583,7 +9423,7 @@ Chapter 7. Reference Defines the username to use with SMTP AUTH. Setting this variable will cause Mutt-ng to attempt to use SMTP AUTH when sending. -308. sort +307. $sort Type: sort order @@ -9606,7 +9446,7 @@ Chapter 7. Reference You may optionally use the ``reverse-'' prefix to specify reverse sorting order (example: set sort=reverse-date-sent). -309. sort_alias +308. $sort_alias Type: sort order @@ -9620,7 +9460,7 @@ Chapter 7. Reference unsorted (leave in order specified in .muttrc) -310. sort_aux +309. $sort_aux Type: sort order @@ -9643,7 +9483,7 @@ Chapter 7. Reference not the right thing to do, but kept to not break any existing configuration setting). -311. sort_browser +310. $sort_browser Type: sort order @@ -9661,7 +9501,7 @@ Chapter 7. Reference You may optionally use the ``reverse-'' prefix to specify reverse sorting order (example: set sort_browser=reverse-date). -312. sort_re +311. $sort_re Type: boolean @@ -9669,14 +9509,14 @@ Chapter 7. Reference This variable is only useful when sorting by threads with ``$strict_threads'' unset. In that case, it changes the heuristic Mutt-ng - uses to thread messages by subject. With $sort_re set, Mutt-ng will only + uses to thread messages by subject. With $sort_reset, Mutt-ng will only attach a message as the child of another message by subject if the subject of the child message starts with a substring matching the setting of - ``$reply_regexp''. With $sort_re unset, Mutt-ng will attach the message + ``$reply_regexp''. With $sort_reunset, Mutt-ng will attach the message whether or not this is the case, as long as the non-``$reply_regexp'' parts of both messages are identical. -313. spam_separator +312. $spam_separator Type: string @@ -9687,7 +9527,7 @@ Chapter 7. Reference matches value for the spam label. If set, each successive match will append to the previous, using ``spam_separator'' as a separator. -314. spoolfile +313. $spoolfile Type: path @@ -9698,7 +9538,7 @@ Chapter 7. Reference automatically set this variable to the value of the environment variable $MAIL if it is not set. -315. ssl_ca_certificates_file +314. $ssl_ca_certificates_file Type: path @@ -9710,7 +9550,7 @@ Chapter 7. Reference Example: set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt -316. ssl_client_cert +315. $ssl_client_cert Type: path @@ -9720,19 +9560,19 @@ Chapter 7. Reference The file containing a client certificate and its associated private key. -317. ssl_force_tls +316. $ssl_force_tls Type: boolean Default: no - If this variable is set, mutt-ng will require that all connections to + If this variable is set, Mutt-ng will require that all connections to remote servers be encrypted. Furthermore it will attempt to negotiate TLS even if the server does not advertise the capability, since it would otherwise have to abort the connection anyway. This option supersedes ``$ssl_starttls''. -318. ssl_min_dh_prime_bits +317. $ssl_min_dh_prime_bits Type: number @@ -9744,7 +9584,7 @@ Chapter 7. Reference use in any Diffie-Hellman key exchange. A value of 0 will use the default from the GNUTLS library. -319. ssl_starttls +318. $ssl_starttls Type: quadoption @@ -9756,7 +9596,7 @@ Chapter 7. Reference advertising the capability. When unset, Mutt-ng will not attempt to use STARTTLS regardless of the server's capabilities. -320. ssl_use_sslv2 +319. $ssl_use_sslv2 Type: boolean @@ -9767,7 +9607,7 @@ Chapter 7. Reference This variables specifies whether to attempt to use SSLv2 in the SSL authentication process. -321. ssl_use_sslv3 +320. $ssl_use_sslv3 Type: boolean @@ -9778,7 +9618,7 @@ Chapter 7. Reference This variables specifies whether to attempt to use SSLv3 in the SSL authentication process. -322. ssl_use_tlsv1 +321. $ssl_use_tlsv1 Type: boolean @@ -9789,7 +9629,7 @@ Chapter 7. Reference This variables specifies whether to attempt to use TLSv1 in the SSL authentication process. -323. ssl_usesystemcerts +322. $ssl_usesystemcerts Type: boolean @@ -9801,7 +9641,7 @@ Chapter 7. Reference certificate store when checking if server certificate is signed by a trusted CA. -324. status_chars +323. $status_chars Type: string @@ -9818,7 +9658,7 @@ Chapter 7. Reference (Certain operations like composing a new mail, replying, forwarding, etc. are not permitted in this mode). -325. status_format +324. $status_format Type: string @@ -9937,7 +9777,7 @@ Chapter 7. Reference where sequence_char is a character from the table above, and optional_string is the string you would like printed if sequence_char is - nonzero. optional_string may contain other sequences as well as normal + nonzero. optional_stringmay contain other sequences as well as normal text, but you may not nest optional strings. Here is an example illustrating how to optionally print the number of new @@ -9962,7 +9802,7 @@ Chapter 7. Reference will replace any dots in the expansion by underscores. This might be helpful with IMAP folders that don't like dots in folder names. -326. status_on_top +325. $status_on_top Type: boolean @@ -9971,7 +9811,7 @@ Chapter 7. Reference Setting this variable causes the ``status bar'' to be displayed on the first line of the screen rather than near the bottom. -327. strict_mailto +326. $strict_mailto Type: boolean @@ -9981,12 +9821,12 @@ Chapter 7. Reference may be embedded. This may lead to (user) headers being overwriten without note if ``$edit_headers'' is unset. - If this variable is set, mutt-ng is strict and allows anything to be + If this variable is set, Mutt-ng is strict and allows anything to be changed. If it's unset, all headers given will be prefixed with ``X-Mailto-'' and the message including headers will be shown in the editor regardless of what ``$edit_headers'' is set to. -328. strict_mime +327. $strict_mime Type: boolean @@ -10001,7 +9841,7 @@ Chapter 7. Reference *text to a single space to prevent the display of MIME-encoded ``Subject:'' header field from being devided into multiple lines. -329. strict_threads +328. $strict_threads Type: boolean @@ -10015,27 +9855,27 @@ Chapter 7. Reference which will get grouped together. See also ``$sort_re'' for a less drastic way of controlling this behaviour. -330. strip_was +329. $strip_was Type: boolean Default: no - When set, mutt-ng will remove the trailing part of the ``Subject:'' line + When set, Mutt-ng will remove the trailing part of the ``Subject:'' line which matches $strip_was_regex when replying. This is useful to properly react on subject changes and reduce ``subject noise.'' (esp. in Usenet) -331. strip_was_regex +330. $strip_was_regex Type: regular expression Default: "\([Ww][Aa][RrSs]: .*\)[ ]*$" - When non-empty and $strip_was is set, mutt-ng will remove this trailing + When non-empty and $strip_was is set, Mutt-ng will remove this trailing part of the ``Subject'' line when replying if it won't be empty afterwards. -332. stuff_quoted +331. $stuff_quoted Type: boolean @@ -10045,7 +9885,7 @@ Chapter 7. Reference ``stuffed'', i.e. a space will be inserted between the quote characters and the actual text. -333. suspend +332. $suspend Type: boolean @@ -10055,7 +9895,7 @@ Chapter 7. Reference key, usually CTRL+Z. This is useful if you run Mutt-ng inside an xterm using a command like ``xterm -e muttng.'' -334. text_flowed +333. $text_flowed Type: boolean @@ -10068,18 +9908,18 @@ Chapter 7. Reference Note that $indent_string is ignored when this option is set. -335. thorough_search +334. $thorough_search Type: boolean Default: no - Affects the ˜b and ˜h search operations described in section - ``patterns'' above. If set, the headers and attachments of messages to be - searched are decoded before searching. If unset, messages are searched as - they appear in the folder. + Affects the ~b and ~h search operations described in section ``patterns'' + above. If set, the headers and attachments of messages to be searched are + decoded before searching. If unset, messages are searched as they appear + in the folder. -336. thread_received +335. $thread_received Type: boolean @@ -10088,16 +9928,16 @@ Chapter 7. Reference When set, Mutt-ng uses the date received rather than the date sent to thread messages by subject. -337. tilde +336. $tilde Type: boolean Default: no When set, the internal-pager will pad blank lines to the bottom of the - screen with a tilde (˜). + screen with a tilde (~). -338. timeout +337. $timeout Type: number @@ -10107,7 +9947,7 @@ Chapter 7. Reference to be pressed in the main menu before timing out and checking for new mail. A value of zero or less will cause Mutt-ng to never time out. -339. tmpdir +338. $tmpdir Type: path @@ -10118,7 +9958,7 @@ Chapter 7. Reference not set, the environment variable $TMPDIR is used. If $TMPDIR is not set then "/tmp" is used. -340. to_chars +339. $to_chars Type: string @@ -10135,7 +9975,7 @@ Chapter 7. Reference character is used to indicate when a mail was sent to a mailing-list you're subscribe to (default: L). -341. trash +340. $trash Type: path @@ -10148,7 +9988,7 @@ Chapter 7. Reference Note: When you delete a message in the trash folder, it is really deleted, so that there is no way to recover mail. -342. tunnel +341. $tunnel Type: string @@ -10163,7 +10003,7 @@ Chapter 7. Reference Note: For this example to work you must be able to log in to the remote machine without having to enter a password. -343. umask +342. $umask Type: number @@ -10172,7 +10012,7 @@ Chapter 7. Reference This sets the umask that will be used by Mutt-ng when creating all kinds of files. If unset, the default value is 077. -344. uncollapse_jump +343. $uncollapse_jump Type: boolean @@ -10181,7 +10021,7 @@ Chapter 7. Reference When set, Mutt-ng will jump to the next unread message, if any, when the current thread is uncollapsed. -345. use_8bitmime +344. $use_8bitmime Type: boolean @@ -10196,7 +10036,7 @@ Chapter 7. Reference flag when sending 8-bit messages to enable ESMTP negotiation or tell libESMTP to do so. -346. use_domain +345. $use_domain Type: boolean @@ -10206,7 +10046,21 @@ Chapter 7. Reference portion) with the value of ``$hostname''. If unset, no addresses will be qualified. -347. use_from +346. $use_envelope_from + + Type: boolean + + Default: no + + When set, Mutt-ng will use ``$envelope_from_address'' as the envelope + sender if that is set, otherwise it will attempt to derive it from the + "From:" header. + + Note: This information is passed to sendmail command using the "-f" + command line switch and passed to the SMTP server for libESMTP (if support + is compiled in). + +347. $use_from Type: boolean @@ -10216,7 +10070,7 @@ Chapter 7. Reference messages. If unset, no ``From:'' header field will be generated unless the user explicitly sets one using the ``my_hdr'' command. -348. use_idn +348. $use_idn Type: boolean @@ -10229,7 +10083,7 @@ Chapter 7. Reference Note: You can use IDNs for addresses even if this is unset. This variable only affects decoding. -349. use_ipv6 +349. $use_ipv6 Type: boolean @@ -10239,16 +10093,16 @@ Chapter 7. Reference contact. If this option is unset, Mutt-ng will restrict itself to IPv4 addresses. Normally, the default should work. -350. visual +350. $visual Type: path Default: "" - Specifies the visual editor to invoke when the ˜v command is given in the + Specifies the visual editor to invoke when the ~v command is given in the builtin editor. -351. wait_key +351. $wait_key Type: boolean @@ -10264,7 +10118,7 @@ Chapter 7. Reference When set, Mutt-ng will always ask for a key. When unset, Mutt-ng will wait for a key only if the external command returned a non-zero status. -352. weed +352. $weed Type: boolean @@ -10273,7 +10127,7 @@ Chapter 7. Reference When set, Mutt-ng will weed headers when displaying, forwarding, printing, or replying to messages. -353. wrap_search +353. $wrap_search Type: boolean @@ -10284,7 +10138,7 @@ Chapter 7. Reference When set, searches will wrap around the first (or last) message. When unset, searches will not wrap. -354. wrapmargin +354. $wrapmargin Type: number @@ -10293,7 +10147,7 @@ Chapter 7. Reference Controls the size of the margin remaining at the right side of the terminal when Mutt-ng's pager does smart wrapping. -355. write_bcc +355. $write_bcc Type: boolean @@ -10302,7 +10156,7 @@ Chapter 7. Reference Controls whether Mutt-ng writes out the Bcc header when preparing messages to be sent. Exim users may wish to unset this. -356. write_inc +356. $write_inc Type: number @@ -10314,7 +10168,7 @@ Chapter 7. Reference Also see the ``$read_inc'' variable. -357. xterm_icon +357. $xterm_icon Type: string @@ -10324,15 +10178,15 @@ Chapter 7. Reference set. This string is identical in formatting to the one used by ``$status_format''. -358. xterm_leave +358. $xterm_leave Type: string Default: "" If $xterm_set_titles is set, this string will be used to set the title - when leaving mutt-ng. For terminal-based programs, there's no easy and - portable way to read the current title so mutt-ng cannot read it upon + when leaving Mutt-ng. For terminal-based programs, there's no easy and + portable way to read the current title so Mutt-ng cannot read it upon startup and restore it when exiting. Based on the xterm FAQ, the following might work: @@ -10340,7 +10194,7 @@ Chapter 7. Reference set xterm_leave = "`test x$DISPLAY != x && xprop -id $WINDOWID | grep WM_NAME | cut -d '"' -f 2`" -359. xterm_set_titles +359. $xterm_set_titles Type: boolean @@ -10350,7 +10204,7 @@ Chapter 7. Reference as you're in an appropriate terminal). The default must be unset to force in the validity checking. -360. xterm_title +360. $xterm_title Type: string @@ -10374,389 +10228,402 @@ Chapter 7. Reference settings for this menu will affect the default bindings for all menus (except as noted). - bottom-page L move to the bottom of the page - current-bottom not bound move current entry to bottom of page - current-middle not bound move current entry to middle of page - current-top not bound move current entry to top of page - enter-command : enter a muttngrc command - exit q exit this menu - first-entry = move to the first entry - half-down ] scroll down 1/2 page - half-up [ scroll up 1/2 page - help ? this screen - jump number jump to an index number - last-entry * move to the last entry - middle-page M move to the middle of the page - next-entry j move to the next entry - next-line > scroll down one line - next-page z move to the next page - previous-entry k move to the previous entry - previous-line < scroll up one line - previous-page Z move to the previous page - refresh ^L clear and redraw the screen - search / search for a regular expression - search-next n search for next match - search-opposite not bound search for next match in opposite - direction - search-reverse ESC / search backwards for a regular - expression - select-entry RET select the current entry - shell-escape ! run a program in a subshell - tag-entry t toggle the tag on the current entry - tag-prefix ; apply next command to tagged entries - tag-prefix-cond not bound apply next function ONLY to tagged - messages - top-page H move to the top of the page - what-key not bound display the keycode for a key press - + Table 7.4. Reference: Default Generic Function Bindings + + Function Default Key Description + L move to the bottom of the page + move current entry to bottom of page + move current entry to middle of page + move current entry to top of page + : enter a muttngrc command + q exit this menu + = move to the first entry + ] scroll down 1/2 page + [ scroll up 1/2 page + ? this screen + number jump to an index number + * move to the last entry + M move to the middle of the page + j move to the next entry + > scroll down one line + z move to the next page + k move to the previous entry + > scroll up one line + Z move to the previous page + C-L clear and redraw the screen + / search for a regular expression + n search for next match + search for next match in opposite direction + E-/ search backwards for a regular expression + Return select the current entry + ! run a program in a subshell + t toggle the tag on the current entry + ; apply next command to tagged entries + apply next function ONLY to tagged messages + H move to the top of the page + display the keycode for a key press 5.2. index - bounce-message b remail a message to another user - change-folder c open a different folder - change-folder-readonly ESC c open a different folder in read only - mode - check-traditional-pgp ESC P check for classic pgp - clear-flag W clear a status flag from a message - copy-message C copy a message to a file/mailbox - create-alias a create an alias from a message - senderdecode-copy ESC C decode a message and copy it - to a file/mailbox - decode-save ESC s decode a message and save it to a - file/mailbox - delete-message d delete the current entry - delete-pattern D delete messages matching a pattern - delete-subthread ESC d delete all messages in subthread - delete-thread ^D delete all messages in thread - display-address @ display full address of sender - display-toggle-weed h display message and toggle header - weeding - display-message RET display a message - edit e edit the current message - edit-type ^E edit the current message's - Content-Type - exit x exit without saving changes - extract-keys ^K extract PGP public keys - fetch-mail G retrieve mail from POP server - flag-message F toggle a message's 'important' flag - forget-passphrase ^F wipe PGP passphrase from memory - forward-message f forward a message with comments - group-reply g reply to all recipients - limit l show only messages matching a - patternlist-reply L reply to specified mailing - list - mail m compose a new mail message - mail-key ESC k mail a PGP public key - next-new not bound jump to the next new message - next-new-then-unread TAB jump to the next new or unread message - next-subthread ESC n jump to the next subthread - next-thread ^N jump to the next thread - next-undeleted j move to the next undeleted message - next-unread not bound jump to the next unread message - parent-message P jump to parent message in thread - pipe-message | pipe message/attachment to a shell - command - previous-new not bound jump to the previous new message - previous-new-then-unread - ESC TAB jump to the previous new or unread message - - previous-page Z move to the previous page - previous-subthread ESC p jump to previous subthread - previous-thread ^P jump to previous thread - previous-undeleted k move to the last undelete message - previous-unread not bound jump to the previous unread message - print-message p print the current entry - query Q query external program for addresses - quit q save changes to mailbox and quit - read-subthread ESC r mark the current subthread as read - read-thread ^R mark the current thread as read - recall-message R recall a postponed message - reply r reply to a message - resend-message ESC e resend message and preserve MIME - structure - save-message s save message/attachment to a file - set-flag w set a status flag on a message - show-version V show the Mutt-ng version number and - date - show-limit ESC l show currently active limit pattern, - if any - sort-mailbox o sort messages - sort-reverse O sort messages in reverse order - sync-mailbox $ save changes to mailbox - tag-pattern T tag messages matching a pattern - tag-thread ESC t tag/untag all messages in the - current thread - toggle-new N toggle a message's 'new' flag - toggle-write % toggle whether the mailbox will be - rewritten - undelete-message u undelete the current entry - undelete-pattern U undelete messages matching a pattern - undelete-subthread ESC u undelete all messages in subthread - undelete-thread ^U undelete all messages in thread - untag-pattern ^T untag messages matching a pattern - view-attachments v show MIME attachments - + Table 7.5. Reference: Default Index Function Bindings + + Function Default Key Description + b remail a message to another user + c open a different folder + E-c open a different folder in read + only mode + E-P check for classic pgp + W clear a status flag from a message + C copy a message to a file/mailbox + a create an alias from a message + sender + E-C decode a message and copy it to a + file/mailbox + E-s decode a message and save it to a + file/mailbox + d delete the current entry + D delete messages matching a pattern + E-d delete all messages in subthread + C-D delete all messages in thread + @ display full address of sender + h display message and toggle header + weeding + Return display a message + e edit the current message + C-E edit the current message's + Content-Type + x exit without saving changes + C-K extract PGP public keys + G retrieve mail from POP server + F toggle a message's 'important' flag + C-F wipe PGP passphrase from memory + f forward a message with comments + g reply to all recipients + l show only messages matching a + pattern + L reply to specified mailing list + m compose a new mail message + E-k mail a PGP public key + jump to the next new message + Tab jump to the next new or unread + message + E-n jump to the next subthread + C-N jump to the next thread + j move to the next undeleted message + jump to the next unread message + P jump to parent message in thread + | pipe message/attachment to a shell + command + jump to the previous new message + E-Tab jump to the previous new or unread + message + Z move to the previous page + E-p jump to previous subthread + C-P jump to previous thread + k move to the last undelete message + jump to the previous unread message + p print the current entry + Q query external program for + addresses + q save changes to mailbox and quit + E-r mark the current subthread as read + C-R mark the current thread as read + R recall a postponed message + r reply to a message + E-e resend message and preserve MIME + structure + s save message/attachment to a file + w set a status flag on a message + V show the Mutt-ng version number and + date + E-l show currently active limit + pattern, if any + o sort messages + O sort messages in reverse order + $ save changes to mailbox + T tag messages matching a pattern + E-t tag/untag all messages in the + current thread + N toggle a message's 'new' flag + % toggle whether the mailbox will be + rewritten + u undelete the current entry + U undelete messages matching a + pattern + E-u undelete all messages in subthread + C-U undelete all messages in thread + C-T untag messages matching a pattern + v show MIME attachments 5.3. pager - bottom not bound jump to the bottom of the message - bounce-message b remail a message to another user - change-folder c open a different folder - change-folder-readonly ESC c open a different folder in read only - mode - check-traditional-pgp ESC P check for classic pgp - copy-message C copy a message to a file/mailbox - create-alias a create an alias from a message - senderdecode-copy ESC C decode a message and copy it - to a file/mailbox - decode-save ESC s decode a message and save it to a - file/mailbox - delete-message d delete the current entry - delete-subthread ESC d delete all messages in subthread - delete-thread ^D delete all messages in thread - display-address @ display full address of sender - display-toggle-weed h display message and toggle header - weeding - edit e edit the current message - edit-type ^E edit the current message's - Content-Type - enter-command : enter a muttngrc command - exit i return to the main-menu - extract-keys ^K extract PGP public keys - flag-message F toggle a message's 'important' flag - forget-passphrase ^F wipe PGP passphrase from memory - forward-message f forward a message with comments - group-reply g reply to all recipients - half-up not bound move up one-half page - half-down not bound move down one-half page - help ? this screen - list-reply L reply to specified mailing list - mail m compose a new mail message - mail-key ESC k mail a PGP public key - mark-as-new N toggle a message's 'new' flag - next-line RET scroll down one line - next-entry J move to the next entry - next-new not bound jump to the next new message - next-new-then-unread TAB jump to the next new or unread message - next-page move to the next page - next-subthread ESC n jump to the next subthread - next-thread ^N jump to the next thread - next-undeleted j move to the next undeleted message - next-unread not bound jump to the next unread message - parent-message P jump to parent message in thread - pipe-message | pipe message/attachment to a shell - command - previous-line BackSpace scroll up one line - previous-entry K move to the previous entry - previous-new not bound jump to the previous new message - previous-new-then-unread - not bound jump to the previous new or unread message - previous-page - move to the previous page - previous-subthread ESC p jump to previous subthread - previous-thread ^P jump to previous thread - previous-undeleted k move to the last undelete message - previous-unread not bound jump to the previous unread message - print-message p print the current entry - quit Q save changes to mailbox and quit - read-subthread ESC r mark the current subthread as read - read-thread ^R mark the current thread as read - recall-message R recall a postponed message - redraw-screen ^L clear and redraw the screen - reply r reply to a message - save-message s save message/attachment to a file - search / search for a regular expression - search-next n search for next match - search-opposite not bound search for next match in opposite - direction - search-reverse ESC / search backwards for a regular - expression - search-toggle \ toggle search pattern coloring - shell-escape ! invoke a command in a subshell - show-version V show the Mutt-ng version number and - date - skip-quoted S skip beyond quoted text - sync-mailbox $ save changes to mailbox - tag-message t tag a message - toggle-quoted T toggle display of quoted text - top ^ jump to the top of the message - undelete-message u undelete the current entry - undelete-subthread ESC u undelete all messages in subthread - undelete-thread ^U undelete all messages in thread - view-attachments v show MIME attachments - + Table 7.6. Reference: Default Pager Function Bindings + + Function Default Key Description + jump to the bottom of the message + b remail a message to another user + c open a different folder + E-c open a different folder in read + only mode + E-P check for classic pgp + C copy a message to a file/mailbox + a create an alias from a message + E-C decode a message and copy it to a + file/mailbox + E-s decode a message and save it to a + file/mailbox + d delete the current entry + E-d delete all messages in subthread + C-D delete all messages in thread + @ display full address of sender + h display message and toggle header + weeding + e edit the current message + C-E edit the current message's + Content-Type + : enter a muttngrc command + i return to the main-menu + C-K extract PGP public keys + F toggle a message's 'important' flag + C-F wipe PGP passphrase from memory + f forward a message with comments + g reply to all recipients + move up one-half page + move down one-half page + ? this screen + L reply to specified mailing list + m compose a new mail message + E-k mail a PGP public key + N toggle a message's 'new' flag + Return scroll down one line + J move to the next entry + jump to the next new message + Tab jump to the next new or unread + message + move to the next page + E-n jump to the next subthread + C-N jump to the next thread + j move to the next undeleted message + jump to the next unread message + P jump to parent message in thread + | pipe message/attachment to a shell + command + BackSpace scroll up one line + K move to the previous entry + jump to the previous new message + jump to the previous new or unread + message + - move to the previous page + E-p jump to previous subthread + C-P jump to previous thread + k move to the last undelete message + jump to the previous unread message + p print the current entry + Q save changes to mailbox and quit + E-r mark the current subthread as read + C-R mark the current thread as read + R recall a postponed message + C-L clear and redraw the screen + r reply to a message + s save message/attachment to a file + / search for a regular expression + n search for next match + search for next match in opposite + direction + E-/ search backwards for a regular + expression + \ toggle search pattern coloring + ! invoke a command in a subshell + V show the Mutt-ng version number and + date + S skip beyond quoted text + $ save changes to mailbox + t tag a message + T toggle display of quoted text + ^ jump to the top of the message + u undelete the current entry + E-u undelete all messages in subthread + C-U undelete all messages in thread + v show MIME attachments 5.4. alias - search / search for a regular expression - search-next n search for next match - search-reverse ESC / search backwards for a regular - expression + Table 7.7. Reference: Default Alias Menu Function Bindings + Function Default Key Description + / search for a regular expression + n search for next match + E-/ search backwards for a regular expression 5.5. query - create-alias a create an alias from a message - sendermail m compose a new mail message - query Q query external program for addresses - query-append A append new query results to current - results - search / search for a regular expression - search-next n search for next match - search-opposite not bound search for next match in opposite - direction - search-reverse ESC / search backwards for a regular - expression + Table 7.8. Reference: Default Query Menu Function Bindings + Function Default Key Description + a create an alias from a message sender + m compose a new mail message + Q query external program for addresses + A append new query results to current results + / search for a regular expression + n search for next match + search for next match in opposite direction + E-/ search backwards for a regular expression 5.6. attach - bounce-message b remail a message to another user - collapse-parts v toggle display of subparts - delete-entry d delete the current entry - display-toggle-weed h display message and toggle header - weeding - edit-type ^E edit the current entry's - Content-Typeextract-keys ^K extract PGP public keys - forward-message f forward a message with comments - group-reply g reply to all recipients - list-reply L reply to specified mailing list - pipe-entry | pipe message/attachment to a shell - command - print-entry p print the current entry - reply r reply to a message - resend-message ESC e resend message and preserve MIME - structure - save-entry s save message/attachment to a file - undelete-entry u undelete the current entry - view-attach RET view attachment using mailcap entry - if necessary - view-mailcap m force viewing of attachment using - mailcap - view-text T view attachment as text - + Table 7.9. Reference: Default Attachment Menu Function Bindings + + Function Default Key Description + b remail a message to another user + v toggle display of subparts + d delete the current entry + h display message and toggle header + weeding + C-E edit the current entry's Content-Type + C-K extract PGP public keys + f forward a message with comments + g reply to all recipients + L reply to specified mailing list + | pipe message/attachment to a shell + command + p print the current entry + r reply to a message + E-e resend message and preserve MIME + structure + s save message/attachment to a file + u undelete the current entry + Return view attachment using mailcap entry if + necessary + m force viewing of attachment using + mailcap + T view attachment as text 5.7. compose - attach-file a attach a file(s) to this message - attach-message A attach message(s) to this message - attach-key ESC k attach a PGP public key - copy-file C save message/attachment to a file - detach-file D delete the current entry - display-toggle-weed h display message and toggle header - weeding - edit-bcc b edit the BCC list - edit-cc c edit the CC list - edit-description d edit attachment description - edit-encoding ^E edit attachment transfer-encoding - edit-fcc f enter a file to save a copy of this - message in - edit-from ESC f edit the from: field - edit-file ^X e edit the file to be attached - edit-headers E edit the message with headers - edit e edit the message - edit-mime m edit attachment using mailcap entry - edit-reply-to r edit the Reply-To field - edit-subject s edit the subject of this message - edit-to t edit the TO list - edit-type ^T edit attachment type - filter-entry F filter attachment through a shell - command - forget-passphrase ^F wipe PGP passphrase from memory - ispell i run ispell on the message - new-mime n compose new attachment using mailcap - entry - pgp-menu p show PGP options - pipe-entry | pipe message/attachment to a shell - command - postpone-message P save this message to send later - print-entry l print the current entry - rename-file R rename/move an attached file - send-message y send the message - toggle-unlink u toggle whether to delete file after - sending it - view-attach RET view attachment using mailcap entry - if necessary - write-fcc w write the message to a folder - + Table 7.10. Reference: Default Compose Menu Function Bindings + + Function Default Key Description + a attach a file(s) to this message + A attach message(s) to this message + E-k attach a PGP public key + C save message/attachment to a file + D delete the current entry + h display message and toggle header + weeding + b edit the BCC list + c edit the CC list + d edit attachment description + C-E edit attachment transfer-encoding + f enter a file to save a copy of this + message in + E-f edit the from: field + C-X e edit the file to be attached + E edit the message with headers + e edit the message + m edit attachment using mailcap entry + r edit the Reply-To field + s edit the subject of this message + t edit the TO list + C-T edit attachment type + F filter attachment through a shell + command + C-F wipe PGP passphrase from memory + i run ispell on the message + n compose new attachment using mailcap + entry + p show PGP options + | pipe message/attachment to a shell + command + P save this message to send later + l print the current entry + R rename/move an attached file + y send the message + u toggle whether to delete file after + sending it + Return view attachment using mailcap entry if + necessary + w write the message to a folder 5.8. postpone - delete-entry d delete the current entry - undelete-entry u undelete the current entry + Table 7.11. Reference: Default Postpone Menu Function Bindings + Function Default Key Description + d delete the current entry + u undelete the current entry 5.9. browser - change-dir c change directories - check-new TAB check mailboxes for new mail - enter-mask m enter a file mask - search / search for a regular expression - search-next n search for next match - search-reverse ESC / search backwards for a regular - expression - select-new N select a new file in this directory - sort o sort messages - sort-reverse O sort messages in reverse order - toggle-mailboxes TAB toggle whether to browse mailboxes - or all files - view-file SPACE view file - subscribe s subscribe to current mailbox (IMAP - Only) - unsubscribe u unsubscribe to current mailbox (IMAP - Only) - toggle-subscribed T toggle view all/subscribed mailboxes - (IMAP Only) - + Table 7.12. Reference: Default Browser Menu Function Bindings + + Function Default Key Description + c change directories + Tab check mailboxes for new mail + m enter a file mask + / search for a regular expression + n search for next match + E-/ search backwards for a regular expression + N select a new file in this directory + o sort messages + O sort messages in reverse order + Tab toggle whether to browse mailboxes or all + files + Space view file + s subscribe to current mailbox (IMAP Only) + u unsubscribe to current mailbox (IMAP Only) + T toggle view all/subscribed mailboxes (IMAP + Only) 5.10. pgp - view-name % view the key's user id - verify-key c verify a PGP public key + Table 7.13. Reference: Default PGP Menu Function Bindings + Function Default Key Description + % view the key's user id + c verify a PGP public key 5.11. editor - backspace BackSpace delete the char in front of the - cursor - backward-char ^B move the cursor one character to the - left - backward-word ESC b move the cursor to the previous word - bol ^A jump to the beginning of the line - buffy-cycle Space cycle among incoming mailboxes - capitalize-word ESC c uppercase the first character in the - word - complete TAB complete filename or alias - complete-query ^T complete address with query - delete-char ^D delete the char under the cursor - downcase-word ESC l lowercase all characters in current - word - eol ^E jump to the end of the line - forward-char ^F move the cursor one character to the - right - forward-word ESC f move the cursor to the next word - history-down not bound scroll down through the history list - history-up not bound scroll up through the history list - kill-eol ^K delete chars from cursor to end of - line - kill-eow ESC d delete chars from cursor to end of - word - kill-line ^U delete all chars on the line - kill-word ^W delete the word in front of the - cursor - quote-char ^V quote the next typed key - transpose-chars not bound transpose character under cursor - with previous - upcase-word ESC u uppercase all characters in current - word - - -Chapter 8. Miscellany - - Table of Contents - - 1. Acknowledgments - -1. Acknowledgments + Table 7.14. Reference: Default Editor Function Bindings + + Function Default Key Description + BackSpace delete the char in front of the cursor + C-B move the cursor one character to the left + E-b move the cursor to the previous word + C-A jump to the beginning of the line + Space cycle among incoming mailboxes + E-c uppercase the first character in the word + Tab complete filename or alias + C-T complete address with query + C-D delete the char under the cursor + E-l lowercase all characters in current word + C-E jump to the end of the line + C-F move the cursor one character to the right + E-f move the cursor to the next word + scroll down through the history list + scroll up through the history list + C-K delete chars from cursor to end of line + E-d delete chars from cursor to end of word + C-U delete all chars on the line + C-W delete the word in front of the cursor + C-V quote the next typed key + transpose character under cursor with + previous + E-u uppercase all characters in current word + + 5.12. sidebar + + Table 7.15. Referene: Default Sidebar Function Bindings + + Key Function Description + Scrolls the mailbox list up 1 page + Scrolls the mailbox list down 1 page + Highlights the next mailbox + Highlights the next mailbox with new mail + Highlights the previous mailbox + Opens the currently highlighted mailbox + +Appendix A. Acknowledgments Kari Hurtta co-developed the original MIME >parsing code back in the ELM-ME days. @@ -10766,7 +10633,8 @@ Chapter 8. Miscellany o Vikas Agnihotri o Francois Berjon < Francois.Berjon@aar.alcatel-alsthom.fr> - o Aric Blumer , John Capo < jc@irbs.com > + o Aric Blumer + o John Capo o David Champion o Brendan Cully o Liviu Daia @@ -10801,7 +10669,7 @@ Chapter 8. Miscellany o Roland Rosenfeld o TAKIZAWA Takashi o Allain Thivillon - o Gero Treuner + o Gero Treuner o Vsevolod Volkov o Ken Weinert @@ -10817,731 +10685,1706 @@ Chapter 8. Miscellany o Christian Gall o Iain Lea o Andreas Kneib + o Felix Meinhold o Carsten Schoelzki o Elimar Riesebieter +Appendix B. Hacking Documentation + + This manual is written in XML and transformed via a XSLT stylesheet into + valid DocBook/XML and/or LaTeX to be again transformed via a XSLT + stylesheet into the final formats. + + This two pass processing is required to keep the file size low and to + sanitize use, i.e. drastically lower the typing overhead. + + To achieve the latter, the sources come with a file called + muttng-manual.xsl introducing the muttng-doc namespace which offers the + following tags to be used (note: this is far from being complete, any help + towards consistency is highly appreciated). + + + + References to manual pages. If the sect parameter is omitted, + it'll be 1 for the commands section. There's no auto-indexing yet. + + + + References to environment variables. The name parameter must + contain upper-case letters only without the dollar sign as it'll + be added automatically. Auto-indexing is done. + + + + References to hooks. The string -hook will be added automatically + to the value given in the name parameter. All entries will be + auto-indexed. + + + + References to patterns. The name parameter must only contain the + letter/symbol for the pattern as the tilde symbol/equal sign will + be added automatically. Auto-indexing is done. If the full + parameter is given the equal sign as well as tilde will be printed + for a fully complete reference. + + key + + Referencing a key.. Because it's somewhat untrivial to always get + the right escaping for LaTeX, there's a tag for it. The optional + modifiers C or E stand for Control and Escape respectively. To + still allow escaping, the actual key sequences must be given + within the tag. + + + + Defining a command.. It's used to define a command with the name + given in the name parameter. The default key binding must be given + via (see above). The string will be + automatically enclosed in <>. Auto-indexing is done. Also an + anchor with id func-[name] will be added with [name] being the + value of the name parameter. + + + + References to functions.. This is practically the same as the + above except that there's no anchor defined. + + + + Defining a variable. This is to be used by makedoc only to define + a command with a given name and XML-normalized link given via id. + Auto-indexing is done. The name parameter's value will be prefixed + with a dollar sign as for environment variables. + + + + References to variables. This practically is the same as above + except that the text inbetween won't be wrapped within a + tag. Auto-indexing is the same as for the above. This one is + intended for manual use. + + + + Pretty print a linked URL. As for E-Mail addresses where the text + (mostly) equals the link's target, URLs must be enclosed in <> + (also this reduced redudant URL typing). + + + + References to RfC documents. Use this to produce links to RfC + document with number given as the num parameter. A link to + will be made. Auto-indexing is done under + RfC. + + + + Defining a configuration command. The name of the command is given + as the name parameter. In case a single command has multiple + possible calling sequences, specify noanchor="1" for subsequent + use. Auto-indexing is done. Specify the arguments within the tag. + + + + References to configuration commands. Use this to refer to + commands as it builds the proper internal reference name. + Auto-indexing is done. + + , , + + Screen layout by context. These are used to specify environments + for different types of screen output. For DocBook output, all of + these simply map to . But as a possible future migration + to LaTeX may be ahead, different languages defined for the + listings.sty packages may be used to have proper syntax + highlighting for these so that there must be a context sensitive + distinction. + + + + This is intended for specifying special strings for either + DocBook/XML or LaTeX. + + Additional notes follow. + + o To not fully bloat the XSL stylesheet procuding the LaTeX code, all + tables must have an attribute called texstr which is directly passed + to longtable. + Index + Symbols + + ~$/ =$, Patterns + + ~*/ =*, Patterns + + ~=/ ==, Patterns + + ~A/ =A, Patterns + + ~b/ =b, Complex Patterns, Patterns + + ~B/ =B, Patterns + + ~c/ =c, Patterns + + ~C/ =C, Patterns + + ~d/ =d, Patterns and Dates, Patterns + + ~D/ =D, Patterns + + ~E/ =E, Patterns + + ~e/ =e, Patterns + + ~f/ =f, Complex Patterns, Patterns + + ~F/ =F, Patterns + + ~g/ =g, Patterns + + ~G/ =G, Patterns + + ~H/ =H, Spam detection, Patterns + + ~h/ =h, Patterns + + ~i/ =i, Patterns + + ~k/ =k, Patterns + + ~L/ =L, Patterns + + ~l/ =l, Patterns + + ~m/ =m, Patterns + + ~M/ =M, Patterns + + ~n/ =n, Message Scoring, Patterns + + ~N/ =N, Patterns + + ~O/ =O, Patterns + + ~p/ =p, Patterns + + ~P/ =P, Patterns + + ~Q/ =Q, Patterns + + ~R/ =R, Patterns + + ~r/ =r, Patterns + + ~s/ =s, Complex Patterns, Patterns + + ~S/ =S, Patterns + + ~T/ =T, Patterns + + ~t/ =t, Patterns + + ~U/ =U, Complex Patterns, Patterns + + ~u/ =u, Patterns + + ~v/ =v, Patterns + + ~V/ =V, Patterns + + ~w/ =w, Patterns + + ~x/ =x, Complex Patterns, Patterns + + ~X/ =X, Patterns + + ~y/ =y, Handling Mailing Lists, Patterns + + ~z/ =z, Patterns + + A + + $abort_noattach , $abort_noattach + + $abort_nosubject , $abort_nosubject + + $abort_unmodified , $abort_unmodified + + account-hook, Managing multiple IMAP/POP/NNTP accounts (OPTIONAL), + Configuration Commands + + $agent_string , Configuration variables + + $agent_string , $agent_string + + alias, Miscellaneous Functions, Defining/Using aliases, Configuration + Commands + + $alias_file, Miscellaneous Functions, Defining/Using aliases + + $alias_file , $alias_file + + $alias_format , $alias_format + + $allow_8bit , $allow_8bit + + $allow_ansi , $allow_ansi + + alternates, Alternative addresses, Configuration Commands + + alternative_order, MIME Multipart/Alternative, Configuration Commands + + append-hook, Compressed folders Support (OPTIONAL), Append a message to a + compressed mailbox, Encrypted folders, Configuration Commands + + $arrow_cursor , $arrow_cursor + + $ascii_chars , $ascii_chars + + $askbcc , $askbcc + + $askcc , $askcc + + $assumed_charset , $assumed_charset + + , Composing new messages, compose + + , Composing new messages, compose + + , Composing new messages, compose + + attachments, Attachment Searching and Counting + + $attach_format , $attach_format + + $attach_remind_regexp , $attach_remind_regexp + + $attach_sep , $attach_sep + + $attach_split , $attach_split + + $attribution, Change settings based upon message recipients, $attribution + + $auto_tag, Using Tags + + $autoedit , $autoedit + + $auto_tag , $auto_tag + + auto_view, The Pager, Optional Fields, Search Order, MIME Autoview, MIME + Multipart/Alternative, Configuration Commands + + B + + , Editing Input Fields, editor + + , Editing Input Fields, editor + + , Editing Input Fields, editor + + $beep , $beep + + $beep_new , $beep_new + + bind, Editing Input Fields, Changing the default key bindings, Keyboard + macros, Configuration Commands + + , Editing Input Fields, editor + + , pager + + , generic + + , Sending Mail, $bounce + + , index, pager, attach + + $bounce_delivered , $bounce_delivered + + $braille_friendly , $braille_friendly + + , editor + C - Configuration Variables + , Editing Input Fields, editor - abort_noattach, abort_noattach + $certificate_file , $certificate_file - abort_nosubject, abort_nosubject + , browser - abort_unmodified, abort_unmodified + , index, pager - agent_string, agent_string + , index, pager - alias_file, alias_file + $charset , $charset - alias_format, alias_format + charset-hook, Defining aliases for character sets, Configuration Commands - allow_8bit, allow_8bit + , browser - allow_ansi, allow_ansi + , Miscellaneous Functions, index, pager - arrow_cursor, arrow_cursor + $check_new , $check_new - ascii_chars, ascii_chars + , index - askbcc, askbcc + close-hook, Compressed folders Support (OPTIONAL), Write a compressed + mailbox, Append a message to a compressed mailbox, Configuration Commands - askcc, askcc + , Threaded Mode - assumed_charset, assumed_charset + , attach - attach_format, attach_format + , Threaded Mode - attach_remind_regexp, attach_remind_regexp + $collapse_unread , $collapse_unread - attach_sep, attach_sep + color, The Pager, Using color and mono video attributes, Configuration + Commands - attach_split, attach_split + $COLORFGBG, Using color and mono video attributes - attribution, attribution + , Editing Input Fields, editor - autoedit, autoedit + , Editing Input Fields, editor - auto_tag, auto_tag + , Sending Mail - beep, beep + $compose_format , $compose_format - beep_new, beep_new + $config_charset , $config_charset - bounce, bounce + $confirmappend , $confirmappend - bounce_delivered, bounce_delivered + $confirmcreate , $confirmcreate - braille_friendly, braille_friendly + $connect_timeout , $connect_timeout - certificate_file, certificate_file + $content_type , $content_type - charset, charset + $copy , $copy - check_new, check_new + , compose - collapse_unread, collapse_unread + , index, pager - compose_format, compose_format + , Miscellaneous Functions, Defining/Using aliases, index, + pager, query - config_charset, config_charset + $crypt_autoencrypt , Configuration variables - confirmappend, confirmappend + $crypt_autosign , Configuration variables - confirmcreate, confirmcreate + crypt-hook, Choosing the cryptographic key of the recipient, Configuration + Commands - connect_timeout, connect_timeout + $crypt_replyencrypt , Configuration variables - content_type, content_type + $crypt_replysign , Configuration variables - copy, copy + $crypt_replysignencrypted , Configuration variables - crypt_autoencrypt, crypt_autoencrypt + $crypt_verify_sig , Configuration variables - crypt_autopgp, crypt_autopgp + $crypt_autoencrypt , $crypt_autoencrypt - crypt_autosign, crypt_autosign + $crypt_autopgp , $crypt_autopgp - crypt_autosmime, crypt_autosmime + $crypt_autosign , $crypt_autosign - crypt_replyencrypt, crypt_replyencrypt + $crypt_autosmime , $crypt_autosmime - crypt_replysign, crypt_replysign + $crypt_replyencrypt , $crypt_replyencrypt - crypt_replysignencrypted, crypt_replysignencrypted + $crypt_replysign , $crypt_replysign - crypt_timestamp, crypt_timestamp + $crypt_replysignencrypted , $crypt_replysignencrypted - crypt_use_gpgme, crypt_use_gpgme + $crypt_timestamp , $crypt_timestamp - crypt_verify_sig, crypt_verify_sig + $crypt_use_gpgme , $crypt_use_gpgme - date_format, date_format + $crypt_verify_sig , $crypt_verify_sig - debug_level, debug_level + , generic - default_hook, default_hook + , generic - delete, delete + , generic - delete_space, delete_space + D - delete_untag, delete_untag + $date_format , $date_format - digest_collapse, digest_collapse + $debug_level , $debug_level - display_filter, display_filter + , index - dotlock_program, dotlock_program + , index, pager - dsn_notify, dsn_notify + default-hook, Message Matching in Hooks - dsn_return, dsn_return + $default_hook , $default_hook - duplicate_threads, duplicate_threads + $delete , $delete - editor, editor + , Editing Input Fields, editor - editor_headers, editor_headers + , attach, postpone - edit_headers, edit_headers + , index, pager - encode_from, encode_from + , index - entropy_file, entropy_file + $delete_space, Additional Notes - envelope_from, envelope_from + , Threaded Mode, index, pager - escape, escape + , Threaded Mode, index, pager - fast_reply, fast_reply + $delete_space , $delete_space - fcc_attach, fcc_attach + $delete_untag , $delete_untag - fcc_clear, fcc_clear + , Composing new messages, compose - file_charset, file_charset + $digest_collapse , $digest_collapse + + , index, pager + + , index + + , Miscellaneous Functions, index, pager, attach, + compose - folder, folder + $display_filter , $display_filter - folder_format, folder_format + $dotlock_program , $dotlock_program - followup_to, followup_to + , Editing Input Fields, editor - force_buffy_check, force_buffy_check + $dsn_notify, Delivery Status Notification (DSN) Support - force_name, force_name + $dsn_return, Delivery Status Notification (DSN) Support - forward_decode, forward_decode + $dsn_notify , $dsn_notify - forward_decrypt, forward_decrypt + $dsn_return , $dsn_return - forward_edit, forward_edit + $duplicate_threads , $duplicate_threads - forward_format, forward_format + E - forward_quote, forward_quote + , Miscellaneous Functions, index, pager, compose - from, from + , Composing new messages, compose - gecos_mask, gecos_mask + , Composing new messages, compose - hdrs, hdrs + , Composing new messages, compose - header, header + , compose - header_cache, header_cache + , Composing new messages, compose - header_cache_compress, header_cache_compress + , compose - help, help + , Composing new messages, compose - hidden_host, hidden_host + $edit_headers, Editing the message header, User defined headers, + mailto:-style links, Configuration variables, compose - hide_limited, hide_limited + , compose - hide_missing, hide_missing + , Composing new messages, compose - hide_thread_subject, hide_thread_subject + , Composing new messages, compose - hide_top_limited, hide_top_limited + , Composing new messages, compose - hide_top_missing, hide_top_missing + , Miscellaneous Functions, index, pager, attach, compose - history, history + $EDITOR, Manual Conventions, Composing new messages - honor_followup_to, honor_followup_to + $editor , $editor - hostname, hostname + $editor_headers, Editing the message header, Defining/Using aliases - ignore_list_reply_to, ignore_list_reply_to + $editor_headers , $editor_headers - imap_authenticators, imap_authenticators + $edit_headers , $edit_headers - imap_check_subscribed, imap_check_subscribed + $encode_from , $encode_from - imap_delim_chars, imap_delim_chars + , Miscellaneous Functions, generic, pager - imap_headers, imap_headers + , browser - imap_home_namespace, imap_home_namespace + $entropy_file , $entropy_file - imap_keepalive, imap_keepalive + $envelope_from_address , $envelope_from_address - imap_list_subscribed, imap_list_subscribed + , Editing Input Fields, editor - imap_login, imap_login + $escape , $escape - imap_mail_check, imap_mail_check + exec, Executing functions, Configuration Commands - imap_pass, imap_pass + , generic, index, pager - imap_passive, imap_passive + , Miscellaneous Functions, index, pager, attach - imap_peek, imap_peek + F - imap_reconnect, imap_reconnect + $fast_reply , $fast_reply - imap_servernoise, imap_servernoise + fcc-hook, Specify default Fcc: mailbox when composing, Specify default + save filename and default Fcc: mailbox at once, Using Hooks, Message + Matching in Hooks, Configuration Commands - imap_user, imap_user + fcc-save-hook, Specify default save filename, Specify default Fcc: mailbox + when composing, Specify default save filename and default Fcc: mailbox at + once, Using Hooks, Configuration Commands - implicit_autoview, implicit_autoview + $fcc_attach , $fcc_attach - include, include + $fcc_clear , $fcc_clear - include_onlyfirst, include_onlyfirst + , index - indent_string, indent_string + $file_charset , $file_charset - index_format, index_format + , compose - ispell, ispell + , Moving Around in Menus, generic - keep_flagged, keep_flagged + , index, pager - list_reply, list_reply + $folder, Configuration Variables, Defining mailboxes which receive mail, + Mailbox Shortcuts, $folder - locale, locale + folder-hook, Setting variables based upon mailbox, Spam detection, Using + Hooks, Managing multiple IMAP/POP/NNTP accounts (OPTIONAL), Configuration + Commands - mailcap_path, mailcap_path + $folder_format , $folder_format - mailcap_sanitize, mailcap_sanitize + $followup_to, Mailing lists, Handling Mailing Lists - maildir_header_cache_verify, maildir_header_cache_verify + $followup_to , $followup_to - maildir_trash, maildir_trash + $force_buffy_check , $force_buffy_check - mail_check, mail_check + $force_name , $force_name - markers, markers + , Miscellaneous Functions, Composing new messages, + index, pager, compose - mark_old, mark_old + , Sending Mail - mask, mask + , Editing Input Fields, editor - max_display_recips, max_display_recips + $forward_decode , Configuration variables - max_line_length, max_line_length + $forward_decrypt , Configuration variables - mbox, mbox + $forward_format , Configuration variables - mbox_type, mbox_type + , index, pager, attach - menu_context, menu_context + $forward_quote , Configuration variables - menu_move_off, menu_move_off + , Editing Input Fields, editor - menu_scroll, menu_scroll + $forward_decode , $forward_decode - message_format, message_format + $forward_decrypt , $forward_decrypt - meta_key, meta_key + $forward_edit , $forward_edit + + $forward_format , $forward_format + + $forward_quote , $forward_quote + + $from , $from + + G + + $gecos_mask , $gecos_mask + + , Sending Mail, index, pager, attach + + H + + , generic, pager + + , generic, pager + + $hdrs , $hdrs + + hdr_order, Defining the order of headers when viewing messages, + Configuration Commands + + $header , $header + + $header_cache , $header_cache + + $header_cache_compress , $header_cache_compress + + , Moving Around in Menus, $help, generic, pager + + $hidden_host , $hidden_host + + $hide_limited , $hide_limited + + $hide_missing , $hide_missing + + $hide_thread_subject , $hide_thread_subject + + $hide_top_limited , $hide_top_limited + + $hide_top_missing , $hide_top_missing + + $history , $history + + , Editing Input Fields, editor + + , Editing Input Fields, editor + + $HOME, MIME Type configuration with mime.types, MIME Viewer configuration + with mailcap + + $honor_followup_to, Miscellaneous Functions, Handling Mailing Lists + + $honor_followup_to , $honor_followup_to + + $HOSTNAME, Environment Variables + + $hostname , $hostname + + I + + iconv-hook, Defining aliases for character sets + + ignore, Miscellaneous Functions, Ignoring (weeding) unwanted message + headers, Configuration Commands + + $ignore_list_reply_to , $ignore_list_reply_to + + $imap_authenticators, Authentication + + $imap_home_namespace, Configuration Variables + + $imap_list_subscribed, IMAP Support (OPTIONAL) + + $imap_mail_check, Manual Conventions, Conditional parts, IMAP Support + (OPTIONAL) + + $imap_pass, Authentication + + $imap_user, Authentication + + $imap_authenticators , $imap_authenticators + + $imap_check_subscribed , $imap_check_subscribed + + $imap_delim_chars , $imap_delim_chars + + $imap_headers , $imap_headers + + $imap_home_namespace , $imap_home_namespace + + $imap_keepalive , $imap_keepalive + + $imap_list_subscribed , $imap_list_subscribed + + $imap_login , $imap_login + + $imap_mail_check , $imap_mail_check + + $imap_pass , $imap_pass + + $imap_passive , $imap_passive + + $imap_peek , $imap_peek + + $imap_reconnect , $imap_reconnect + + $imap_servernoise , $imap_servernoise + + $imap_user , $imap_user + + $implicit_autoview , $implicit_autoview + + $include , $include + + $include_onlyfirst , $include_onlyfirst + + $indent_string , Configuration variables + + $indent_string , $indent_string + + $index_format, Threaded Mode, Spam detection, Handling Mailing Lists, + Configuration variables + + $index_format , $index_format + + , Composing new messages, $ispell, compose + + J + + , generic + + K + + $keep_flagged , $keep_flagged + + , Editing Input Fields, editor + + , Editing Input Fields, editor + + , Editing Input Fields, editor + + , Editing Input Fields, editor + + L + + , Moving Around in Menus, generic + + , index + + , Miscellaneous Functions, Sending Mail, index, pager, attach + + lists, Miscellaneous Functions, Mailing lists, Handling Mailing Lists, + Configuration Commands + + $list_reply , $list_reply + + $locale, Change settings based upon message recipients, $locale + + M + + macro, Miscellaneous Functions, Keyboard macros, Adding key sequences to + the keyboard buffer, Using Tags, Configuration Commands + + , index, pager, query + + , Sending Mail, index, pager + + mailboxes, Defining mailboxes which receive mail, Configuration Commands + + $mailcap_path, mailcap + + $mailcap_sanitize, Secure use of mailcap, mailcap + + $mailcap_path , $mailcap_path + + $mailcap_sanitize , $mailcap_sanitize + + $maildir_header_cache_verify , $maildir_header_cache_verify + + $maildir_trash , $maildir_trash + + $mail_check , $mail_check + + , pager + + $markers , $markers + + $mark_old , $mark_old + + $mask , $mask + + $max_display_recips , $max_display_recips + + $max_line_length , $max_line_length + + $mbox, Mailbox Shortcuts, $mbox + + mbox-hook, Using Multiple spool mailboxes, Using Hooks, Configuration + Commands + + $mbox_type, Mailbox Formats, Append a message to a compressed mailbox + + $mbox_type , $mbox_type + + $menu_context , $menu_context + + $menu_move_off , $menu_move_off + + $menu_scroll , $menu_scroll + + $message_format , Configuration variables + + message-hook, Change settings before formatting a message, Using Hooks, + Message Matching in Hooks, MIME Autoview, Configuration Commands + + $message_format , $message_format + + $meta_key , $meta_key + + $metoo , $metoo + + $mh_purge , $mh_purge + + $mh_seq_flagged , $mh_seq_flagged + + $mh_seq_replied , $mh_seq_replied + + $mh_seq_unseen , $mh_seq_unseen + + , generic + + $mime_forward , Configuration variables + + $mime_forward , $mime_forward + + $mime_forward_decode , $mime_forward_decode + + $mime_forward_rest , $mime_forward_rest + + mime_lookup, MIME Lookup, Configuration Commands + + $mix_entry_format, Sending anonymous messages via mixmaster + + $mixmaster , $mixmaster + + $mix_entry_format , $mix_entry_format + + mono, Using color and mono video attributes, Configuration Commands + + $move , $move + + $msgid_format, Message-ID: headers + + $msgid_format , $msgid_format + + $muttng_bindir , $muttng_bindir + + $muttng_docdir , $muttng_docdir + + $muttng_folder_name , $muttng_folder_name + + $muttng_folder_path , $muttng_folder_path + + $muttng_hcache_backend , $muttng_hcache_backend + + $muttng_pwd , $muttng_pwd + + $muttng_revision , $muttng_revision + + $muttng_sysconfdir , $muttng_sysconfdir + + $muttng_version , $muttng_version + + my_hdr, User defined headers, Configuration Commands + + N + + $narrow_tree , $narrow_tree + + $net_inc , $net_inc + + , compose + + , Moving Around in Menus, generic, pager + + , generic, pager + + , index, pager + + , index, pager + + , generic, pager + + , Threaded Mode, index, pager + + , Threaded Mode, index, pager + + , index, pager + + , index, pager + + $nntp_ask_followup_to , Configuration variables + + $nntp_ask_x_comment_to , Configuration variables + + $nntp_cache_dir , Configuration variables + + $nntp_catchup , Configuration variables + + $nntp_followup_to_poster , Configuration variables + + $nntp_group_index_format , Configuration variables + + $nntp_host , Configuration variables + + $nntp_inews , Configuration variables + + $nntp_mail_check , Configuration variables + + $nntp_mime_subject , Configuration variables + + $nntp_newsrc, NNTP Support (OPTIONAL), Configuration variables + + $nntp_post_moderated , Configuration variables + + $nntp_save_unsubscribed , Configuration variables + + $nntp_show_new_news , Configuration variables + + $nntp_show_only_unread , Configuration variables + + $nntp_x_comment_to , Configuration variables + + $NNTPSERVER, NNTP Support (OPTIONAL) + + $nntp_ask_followup_to , $nntp_ask_followup_to + + $nntp_ask_x_comment_to , $nntp_ask_x_comment_to + + $nntp_cache_dir , $nntp_cache_dir + + $nntp_catchup , $nntp_catchup + + $nntp_context , $nntp_context + + $nntp_followup_to_poster , $nntp_followup_to_poster + + $nntp_group_index_format , $nntp_group_index_format + + $nntp_host , $nntp_host + + $nntp_inews , $nntp_inews + + $nntp_load_description , $nntp_load_description + + $nntp_mail_check , $nntp_mail_check + + $nntp_mime_subject , $nntp_mime_subject + + $nntp_newsrc , $nntp_newsrc + + $nntp_pass , $nntp_pass + + $nntp_post_moderated , $nntp_post_moderated + + $nntp_reconnect , $nntp_reconnect + + $nntp_save_unsubscribed , $nntp_save_unsubscribed + + $nntp_show_new_news , $nntp_show_new_news + + $nntp_show_only_unread , $nntp_show_only_unread + + $nntp_user , $nntp_user + + $nntp_x_comment_to , $nntp_x_comment_to + + nospam, Spam detection, Configuration Commands + + O + + open-hook, Compressed folders Support (OPTIONAL), Open a compressed + mailbox for reading, Write a compressed mailbox, Append a message to a + compressed mailbox, Configuration Commands + + $operating_system , $operating_system + + P + + , Moving Around in Menus + + , Moving Around in Menus + + $pager , $pager + + $pager_index_lines, Conditional parts + + $pager_context , $pager_context + + $pager_format , $pager_format + + $pager_index_lines , $pager_index_lines + + $pager_stop , $pager_stop + + , Threaded Mode, index, pager + + pattern-hook, Specify default save filename, Specify default Fcc: mailbox + when composing, Change settings based upon message recipients, Change + settings before formatting a message + + $pgp_autoinline , Configuration variables + + $pgp_entry_format, Using Mutt-ng with PGP + + , Composing new messages, compose + + $pgp_replyinline , Configuration variables + + $pgp_sign_as, Using Mutt-ng with PGP + + $pgp_autoinline , $pgp_autoinline + + $pgp_auto_decode , $pgp_auto_decode + + $pgp_check_exit , $pgp_check_exit + + $pgp_clearsign_command , $pgp_clearsign_command + + $pgp_decode_command , $pgp_decode_command + + $pgp_decrypt_command , $pgp_decrypt_command + + $pgp_encrypt_only_command , $pgp_encrypt_only_command + + $pgp_encrypt_sign_command , $pgp_encrypt_sign_command + + $pgp_entry_format , $pgp_entry_format + + $pgp_export_command , $pgp_export_command + + $pgp_getkeys_command , $pgp_getkeys_command + + $pgp_good_sign , $pgp_good_sign + + $pgp_ignore_subkeys , $pgp_ignore_subkeys + + $pgp_import_command , $pgp_import_command + + $pgp_list_pubring_command , $pgp_list_pubring_command + + $pgp_list_secring_command , $pgp_list_secring_command + + $pgp_long_ids , $pgp_long_ids + + $pgp_mime_auto , $pgp_mime_auto + + $pgp_replyinline , $pgp_replyinline + + $pgp_retainable_sigs , $pgp_retainable_sigs + + $pgp_show_unusable , $pgp_show_unusable + + $pgp_sign_as , $pgp_sign_as + + $pgp_sign_command , $pgp_sign_command + + $pgp_sort_keys , $pgp_sort_keys + + $pgp_strict_enc , $pgp_strict_enc + + $pgp_timeout , $pgp_timeout + + $pgp_use_gpg_agent , $pgp_use_gpg_agent + + $pgp_verify_command , $pgp_verify_command + + $pgp_verify_key_command , $pgp_verify_key_command + + $pipe_decode, Miscellaneous Functions + + , attach, compose + + , Miscellaneous Functions, index, pager + + $pipe_split, Miscellaneous Functions + + $pipe_decode , $pipe_decode + + $pipe_sep , $pipe_sep + + $pipe_split , $pipe_split + + $pop_mail_check, POP3 Support (OPTIONAL), Configuration variables + + $pop_authenticators , $pop_authenticators + + $pop_auth_try_all , $pop_auth_try_all + + $pop_delete , $pop_delete + + $pop_host , $pop_host + + $pop_last , $pop_last + + $pop_mail_check , $pop_mail_check + + $pop_pass , $pop_pass + + $pop_reconnect , $pop_reconnect + + $pop_user , $pop_user + + $post_indent_string , Configuration variables + + $postpone, Postponing Mail, $postpone + + , Composing new messages, compose + + $postponed, Postponing Mail, $postponed + + $post_indent_string , $post_indent_string + + $preconnect , $preconnect + + , Moving Around in Menus, generic, pager + + , generic, pager + + , index, pager + + , index, pager + + , generic, index, pager + + , Threaded Mode, index, pager + + , Threaded Mode, index, pager + + , index, pager + + , index, pager + + $print , $print + + $print_command , Configuration variables + + , attach, compose + + , index, pager + + $print_command , $print_command + + $print_decode , $print_decode + + $print_split , $print_split + + $prompt_after , $prompt_after + + push, Adding key sequences to the keyboard buffer, Using Tags, + Configuration Commands + + Q + + , index, query + + , query + + $query_command, External Address Queries + + $query_command , $query_command + + , Moving Around in Menus, Composing new messages, $quit, index, + pager + + , Editing Input Fields, editor + + $quote_regexp, Miscellaneous Functions, Using color and mono video + attributes + + $quote_empty , $quote_empty + + $quote_quoted , $quote_quoted + + $quote_regexp , $quote_regexp + + R + + , Threaded Mode, index, pager + + , Threaded Mode, index, pager + + $read_inc , $read_inc + + $read_only , $read_only + + $realname , $realname + + $recall , $recall + + , index, pager + + $record, Environment Variables, Specify default Fcc: mailbox when + composing, Mailbox Shortcuts, $record + + , pager + + , generic + + , compose + + , Sending Mail, index, pager, attach + + reply-hook, Change settings based upon message recipients, Configuration + Commands + + $reply_to, Alternative addresses, Handling Mailing Lists + + $reply_regexp , $reply_regexp + + $reply_self , $reply_self + + $reply_to , $reply_to + + , Miscellaneous Functions, The Attachment Menu, index, + attach - metoo, metoo + reset, Setting variables, Configuration Commands - mh_purge, mh_purge + $resolve , $resolve - mh_seq_flagged, mh_seq_flagged + $reverse_alias , $reverse_alias - mh_seq_replied, mh_seq_replied + $reverse_name , $reverse_name - mh_seq_unseen, mh_seq_unseen + $reverse_realname , $reverse_realname - mime_forward, mime_forward + RfC - mime_forward_decode, mime_forward_decode + 1524, MIME Viewer configuration with mailcap, Command + Expansion, mailcap - mime_forward_rest, mime_forward_rest + 1894, Delivery Status Notification (DSN) Support - mixmaster, mixmaster + 2822, Again: Scoring - mix_entry_format, mix_entry_format + 3676, Sending - move, move + 822, User defined headers - msgid_format, msgid_format + $rfc2047_parameters , $rfc2047_parameters - muttng_bindir, muttng_bindir + S - muttng_docdir, muttng_docdir + $save_empty, Compressed folders Support (OPTIONAL) - muttng_folder_name, muttng_folder_name + , attach - muttng_folder_path, muttng_folder_path + save-hook, Specify default save filename, Specify default save filename + and default Fcc: mailbox at once, Using Hooks, Message Matching in Hooks, + Mailbox Shortcuts, Configuration Commands - muttng_hcache_backend, muttng_hcache_backend + , index, pager - muttng_pwd, muttng_pwd + $save_address , $save_address - muttng_revision, muttng_revision + $save_empty , $save_empty - muttng_sysconfdir, muttng_sysconfdir + $save_name , $save_name - muttng_version, muttng_version + score, Message Scoring, Configuration Commands, $score - narrow_tree, narrow_tree + $score_threshold_delete, Message Scoring - net_inc, net_inc + $score_threshold_flag, Message Scoring - nntp_ask_followup_to, nntp_ask_followup_to + $score_threshold_read, Message Scoring - nntp_ask_x_comment_to, nntp_ask_x_comment_to + $score_threshold_delete , $score_threshold_delete - nntp_cache_dir, nntp_cache_dir + $score_threshold_flag , $score_threshold_flag - nntp_catchup, nntp_catchup + $score_threshold_read , $score_threshold_read - nntp_context, nntp_context + , generic, pager, alias, query, browser - nntp_followup_to_poster, nntp_followup_to_poster + , generic, pager, alias, query, browser - nntp_group_index_format, nntp_group_index_format + , generic, pager, query - nntp_host, nntp_host + , generic, pager, alias, query, browser - nntp_inews, nntp_inews + , pager - nntp_load_description, nntp_load_description + , generic - nntp_mail_check, nntp_mail_check + , browser - nntp_mime_subject, nntp_mime_subject + send-hook, Change settings based upon message recipients, Using Hooks, + Message Matching in Hooks, Configuration Commands - nntp_newsrc, nntp_newsrc + , Composing new messages, compose - nntp_pass, nntp_pass + send2-hook, Change settings based upon message recipients - nntp_post_moderated, nntp_post_moderated + , pager - nntp_reconnect, nntp_reconnect + $sendmail, Change settings based upon message recipients, $sendmail - nntp_save_unsubscribed, nntp_save_unsubscribed + $sendmail_wait , $sendmail_wait - nntp_show_new_news, nntp_show_new_news + $send_charset , $send_charset - nntp_show_only_unread, nntp_show_only_unread + set, Setting variables, Configuration Commands - nntp_user, nntp_user + , index - nntp_x_comment_to, nntp_x_comment_to + $shell , $shell - operating_system, operating_system + , Miscellaneous Functions, generic, pager - pager, pager + , index - pager_context, pager_context + , index, pager - pager_format, pager_format + , sidebar - pager_index_lines, pager_index_lines + , sidebar - pager_stop, pager_stop + , sidebar - pgp_autoinline, pgp_autoinline + , sidebar - pgp_auto_decode, pgp_auto_decode + , sidebar - pgp_check_exit, pgp_check_exit + , sidebar - pgp_clearsign_command, pgp_clearsign_command + $sidebar_shorten_hierarchy , Configuration variables - pgp_decode_command, pgp_decode_command + $sidebar_boundary , $sidebar_boundary - pgp_decrypt_command, pgp_decrypt_command + $sidebar_delim , $sidebar_delim - pgp_encrypt_only_command, pgp_encrypt_only_command + $sidebar_newmail_only , $sidebar_newmail_only - pgp_encrypt_sign_command, pgp_encrypt_sign_command + $sidebar_number_format , $sidebar_number_format - pgp_entry_format, pgp_entry_format + $sidebar_shorten_hierarchy , $sidebar_shorten_hierarchy - pgp_export_command, pgp_export_command + $sidebar_visible , $sidebar_visible - pgp_getkeys_command, pgp_getkeys_command + $sidebar_width , $sidebar_width - pgp_good_sign, pgp_good_sign + $signature, Change settings based upon message recipients, $signature - pgp_ignore_subkeys, pgp_ignore_subkeys + $signoff_string , $signoff_string - pgp_import_command, pgp_import_command + $sig_dashes , $sig_dashes - pgp_list_pubring_command, pgp_list_pubring_command + $sig_on_top , $sig_on_top - pgp_list_secring_command, pgp_list_secring_command + $simple_search , $simple_search - pgp_long_ids, pgp_long_ids + , Miscellaneous Functions, pager - pgp_mime_auto, pgp_mime_auto + $sleep_time , $sleep_time - pgp_replyinline, pgp_replyinline + $smart_wrap , $smart_wrap - pgp_retainable_sigs, pgp_retainable_sigs + $smileys , $smileys - pgp_show_unusable, pgp_show_unusable + $smime_default_key , Configuration variables - pgp_sign_as, pgp_sign_as + , Composing new messages - pgp_sign_command, pgp_sign_command + $smime_ask_cert_label , $smime_ask_cert_label - pgp_sort_keys, pgp_sort_keys + $smime_ca_location , $smime_ca_location - pgp_strict_enc, pgp_strict_enc + $smime_certificates , $smime_certificates - pgp_timeout, pgp_timeout + $smime_decrypt_command , $smime_decrypt_command - pgp_use_gpg_agent, pgp_use_gpg_agent + $smime_decrypt_use_default_key , $smime_decrypt_use_default_key - pgp_verify_command, pgp_verify_command + $smime_default_key , $smime_default_key - pgp_verify_key_command, pgp_verify_key_command + $smime_encrypt_command , $smime_encrypt_command - pipe_decode, pipe_decode + $smime_encrypt_with , $smime_encrypt_with - pipe_sep, pipe_sep + $smime_get_cert_command , $smime_get_cert_command - pipe_split, pipe_split + $smime_get_cert_email_command , $smime_get_cert_email_command - pop_authenticators, pop_authenticators + $smime_get_signer_cert_command , $smime_get_signer_cert_command - pop_auth_try_all, pop_auth_try_all + $smime_import_cert_command , $smime_import_cert_command - pop_delete, pop_delete + $smime_is_default , $smime_is_default - pop_host, pop_host + $smime_keys , $smime_keys - pop_last, pop_last + $smime_pk7out_command , $smime_pk7out_command - pop_mail_check, pop_mail_check + $smime_sign_command , $smime_sign_command - pop_pass, pop_pass + $smime_sign_opaque_command , $smime_sign_opaque_command - pop_reconnect, pop_reconnect + $smime_timeout , $smime_timeout - pop_user, pop_user + $smime_verify_command , $smime_verify_command - postpone, postpone + $smime_verify_opaque_command , $smime_verify_opaque_command - postponed, postponed + $smtp_envelope, SMTP Support (OPTIONAL) - post_indent_string, post_indent_string + $smtp_host, SMTP Support (OPTIONAL) - preconnect, preconnect + $smtp_pass, SMTP Support (OPTIONAL), Configuration variables - print, print + $smtp_use_tls, SMTP Support (OPTIONAL) - print_command, print_command + $smtp_user, SMTP Support (OPTIONAL), Configuration variables - print_decode, print_decode + $smtp_host , $smtp_host - print_split, print_split + $smtp_pass , $smtp_pass - prompt_after, prompt_after + $smtp_port , $smtp_port - query_command, query_command + $smtp_user , $smtp_user - quit, quit + $smtp_use_tls , $smtp_use_tls - quote_empty, quote_empty + $sort , $sort, browser - quote_quoted, quote_quoted + , index - quote_regexp, quote_regexp + , index, browser - read_inc, read_inc + $sort_alias , $sort_alias - read_only, read_only + $sort_aux , $sort_aux - realname, realname + $sort_browser , $sort_browser - recall, recall + $sort_re , $sort_re - record, record + source, Miscellaneous Functions, Defining/Using aliases, Reading + initialization commands from another file, Configuration Commands - reply_regexp, reply_regexp + spam, Spam detection, Configuration Commands - reply_self, reply_self + $spam_separator , $spam_separator - reply_to, reply_to + $spoolfile, Setting variables based upon mailbox, Defining mailboxes which + receive mail, Mailbox Shortcuts, POP3 Support (OPTIONAL), $spoolfile - resolve, resolve + $ssl_ca_certificates_file , $ssl_ca_certificates_file - reverse_alias, reverse_alias + $ssl_client_cert , $ssl_client_cert - reverse_name, reverse_name + $ssl_force_tls , $ssl_force_tls - reverse_realname, reverse_realname + $ssl_min_dh_prime_bits , $ssl_min_dh_prime_bits - rfc2047_parameters, rfc2047_parameters + $ssl_starttls , $ssl_starttls - save_address, save_address + $ssl_usesystemcerts , $ssl_usesystemcerts - save_empty, save_empty + $ssl_use_sslv2 , $ssl_use_sslv2 - save_name, save_name + $ssl_use_sslv3 , $ssl_use_sslv3 - score, score + $ssl_use_tlsv1 , $ssl_use_tlsv1 - score_threshold_delete, score_threshold_delete + $status_format, Composing new messages, Introduction - score_threshold_flag, score_threshold_flag + $status_chars , $status_chars - score_threshold_read, score_threshold_read + $status_format , $status_format - sendmail, sendmail + $status_on_top , $status_on_top - sendmail_wait, sendmail_wait + $strict_mailto, mailto:-style links - send_charset, send_charset + $strict_threads, Threaded Mode - shell, shell + $strict_mailto , $strict_mailto - sidebar_boundary, sidebar_boundary + $strict_mime , $strict_mime - sidebar_delim, sidebar_delim + $strict_threads , $strict_threads - sidebar_newmail_only, sidebar_newmail_only + $strip_was , $strip_was - sidebar_number_format, sidebar_number_format + $strip_was_regex , $strip_was_regex - sidebar_shorten_hierarchy, sidebar_shorten_hierarchy + $stuff_quoted , $stuff_quoted - sidebar_visible, sidebar_visible + subscribe, Mailing lists, Configuration Commands, browser - sidebar_width, sidebar_width + $suspend , $suspend - signature, signature + , Manual Conventions, index, pager - signoff_string, signoff_string + T - sig_dashes, sig_dashes + , generic - sig_on_top, sig_on_top + , pager - simple_search, simple_search + , index - sleep_time, sleep_time + , generic - smart_wrap, smart_wrap + , generic - smileys, smileys + , Threaded Mode, index - smime_ask_cert_label, smime_ask_cert_label + $text_flowed , $text_flowed - smime_ca_location, smime_ca_location + $thorough_search , $thorough_search - smime_certificates, smime_certificates + $thread_received , $thread_received - smime_decrypt_command, smime_decrypt_command + $tilde , $tilde - smime_decrypt_use_default_key, smime_decrypt_use_default_key + $timeout, IMAP Support (OPTIONAL), $timeout - smime_default_key, smime_default_key + $tmpdir, Temporary Files, $tmpdir - smime_encrypt_command, smime_encrypt_command + $to_chars, Status Flags - smime_encrypt_with, smime_encrypt_with + toggle, Setting variables, Configuration Commands - smime_get_cert_command, smime_get_cert_command + , browser - smime_get_cert_email_command, smime_get_cert_email_command + , index - smime_get_signer_cert_command, smime_get_signer_cert_command + , Miscellaneous Functions, pager - smime_import_cert_command, smime_import_cert_command + , browser - smime_is_default, smime_is_default + , compose - smime_keys, smime_keys + , index - smime_pk7out_command, smime_pk7out_command + , pager - smime_sign_command, smime_sign_command + , generic - smime_sign_opaque_command, smime_sign_opaque_command + $to_chars , $to_chars - smime_timeout, smime_timeout + , editor - smime_verify_command, smime_verify_command + $trash , $trash - smime_verify_opaque_command, smime_verify_opaque_command + $tunnel , $tunnel - smtp_envelope, smtp_envelope + U - smtp_host, smtp_host + $umask, Temporary Files, $umask - smtp_pass, smtp_pass + unalias, Defining/Using aliases, Configuration Commands - smtp_port, smtp_port + unalternates, Alternative addresses, Configuration Commands - smtp_user, smtp_user + unalternative_order, MIME Multipart/Alternative, Configuration Commands - smtp_use_tls, smtp_use_tls + unattachments, Attachment Searching and Counting - sort, sort + unauto_view, MIME Autoview, Configuration Commands - sort_alias, sort_alias + $uncollapse_jump , $uncollapse_jump - sort_aux, sort_aux + uncolor, Using color and mono video attributes, Configuration Commands - sort_browser, sort_browser + , attach, postpone - sort_re, sort_re + , index, pager - spam_separator, spam_separator + , index - spoolfile, spoolfile + , Threaded Mode, index, pager - ssl_ca_certificates_file, ssl_ca_certificates_file + , Threaded Mode, index, pager - ssl_client_cert, ssl_client_cert + unhdr_order, Defining the order of headers when viewing messages, + Configuration Commands - ssl_force_tls, ssl_force_tls + unhook, Removing hooks, Configuration Commands - ssl_min_dh_prime_bits, ssl_min_dh_prime_bits + unignore, Ignoring (weeding) unwanted message headers, Configuration + Commands - ssl_starttls, ssl_starttls + unlists, Mailing lists, Configuration Commands - ssl_usesystemcerts, ssl_usesystemcerts + unmailboxes, Defining mailboxes which receive mail - ssl_use_sslv2, ssl_use_sslv2 + unmime_lookup, MIME Lookup, Configuration Commands - ssl_use_sslv3, ssl_use_sslv3 + unmono, Using color and mono video attributes, Configuration Commands - ssl_use_tlsv1, ssl_use_tlsv1 + unmy_hdr, User defined headers, Configuration Commands - status_chars, status_chars + unscore, Message Scoring, Configuration Commands - status_format, status_format + unset, Setting variables, Configuration Commands - status_on_top, status_on_top + unsubscribe, Mailing lists, Configuration Commands, browser - strict_mailto, strict_mailto + , index - strict_mime, strict_mime + , Editing Input Fields, editor - strict_threads, strict_threads + $use_8bitmime, SMTP Support (OPTIONAL) - strip_was, strip_was + $use_8bitmime , $use_8bitmime - strip_was_regex, strip_was_regex + $use_domain , $use_domain - stuff_quoted, stuff_quoted + $use_envelope_from , $use_envelope_from - suspend, suspend + $use_from , $use_from - text_flowed, text_flowed + $use_idn , $use_idn - thorough_search, thorough_search + $use_ipv6 , $use_ipv6 - thread_received, thread_received + V - tilde, tilde + , pgp - timeout, timeout + , attach, compose - tmpdir, tmpdir + , index, pager - to_chars, to_chars + , browser - trash, trash + , attach - tunnel, tunnel + , pgp - umask, umask + , attach - uncollapse_jump, uncollapse_jump + $VISUAL, Composing new messages - use_8bitmime, use_8bitmime + $visual , $visual - use_domain, use_domain + W - use_from, use_from + $wait_key, Miscellaneous Functions, Optional Fields - use_idn, use_idn + $wait_key , $wait_key - use_ipv6, use_ipv6 + $weed, Miscellaneous Functions, $weed - visual, visual + , generic - wait_key, wait_key + $wrapmargin , $wrapmargin - weed, weed + $wrap_search , $wrap_search - wrapmargin, wrapmargin + , Composing new messages, compose - wrap_search, wrap_search + $write_bcc , $write_bcc - write_bcc, write_bcc + $write_inc , $write_inc - write_inc, write_inc + X - xterm_icon, xterm_icon + $xterm_icon , $xterm_icon - xterm_leave, xterm_leave + $xterm_leave , $xterm_leave - xterm_set_titles, xterm_set_titles + $xterm_set_titles , $xterm_set_titles - xterm_title, xterm_title + $xterm_title , $xterm_title