X-Git-Url: http://git.madism.org/?a=blobdiff_plain;f=doc%2Fmanual.txt;h=f6dd5afd370bce6985f42d777c94a7cfc0610795;hb=710039d784d5fbda9371cd1d94f61ed5ff799216;hp=24cf9c683f5228df8247784e556fa764de89803d;hpb=ef6cefebd708b73cf06da24eda4a919448f1e965;p=apps%2Fmadmutt.git diff --git a/doc/manual.txt b/doc/manual.txt index 24cf9c6..f6dd5af 100644 --- a/doc/manual.txt +++ b/doc/manual.txt @@ -1,14 +1,21 @@ The Mutt Next Generation E-Mail Client - by Andreas Krennmair and others originally based on mutt by Michael Elkins and - others + Andreas Krennmair - version devel-r473 + + + Michael Elkins + + + + version devel-r541 Abstract Michael Elinks on mutt, circa 1995: ``All mail clients suck. This one just - sucks less.'' - Sven Guckes on mutt, ca. 2003: ``But it still sucks!'' + sucks less.'' + + Sven Guckes on mutt, ca. 2003: ``But it still sucks!'' -------------------------------------------------------------------------- @@ -30,6 +37,8 @@ 7. Copyright + 8. Manual Conventions + 2. Getting Started 1. Basic Concepts @@ -285,7 +294,9 @@ 5. MIME Multipart/Alternative - 6. MIME Lookup + 6. Attachment Searching and Counting + + 7. MIME Lookup 6. Security Considerations @@ -339,9 +350,67 @@ 5.11. editor - 8. Miscellany + 5.12. sidebar + + A. Acknowledgments + + B. Hacking Documentation + + Index + + List of Tables + + 2.1. Most commonly used movement bindings + + 2.2. Line Editor Functions + + 2.3. Most commonly used Index Bindings + + 2.4. Most commonly used Pager Bindings + + 2.5. ANSI Escape Sequences + + 2.6. ANSI Colors + + 2.7. Most commonly used thread-related bindings + + 2.8. Most commonly used Mail Composition Bindings + + 2.9. Most commonly used Compose Menu Bindings + + 2.10. PGP Key Menu Flags + + 3.1. Alternative Key Names + + 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.7. Reference: Default Alias Menu Function Bindings + + 7.8. Reference: Default Query Menu Function Bindings + + 7.9. Reference: Default Attachment Menu Function Bindings + + 7.10. Reference: Default Compose Menu Function Bindings + + 7.11. Reference: Default Postpone Menu Function Bindings - 1. Acknowledgments + 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 @@ -361,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 @@ -369,7 +440,7 @@ Chapter 1. Introduction regular expression searches and a powerful pattern matching language for selecting groups of messages. - This documentation additionally contains documentation to Mutt-NG, a fork + This documentation additionally contains documentation to Mutt-NG ,a fork from Mutt with the goal to fix all the little annoyances of Mutt, to integrate all the Mutt patches that are floating around in the web, and to add other new features. Features specific to Mutt-ng will be discussed in @@ -379,20 +450,20 @@ Chapter 1. Introduction 2. Mutt-ng Home Page - http://www.muttng.org + 3. Mailing Lists - o mutt-ng-users@lists.berlios.de -- This is where the mutt-ng user + o : This is where the mutt-ng user support happens. - o mutt-ng-devel@lists.berlios.de -- The development mailing list for + o : The development mailing list for mutt-ng 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 @@ -422,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 @@ -683,17 +781,20 @@ Chapter 2. Getting Started 3. Moving Around in Menus - Information is presented in menus, very similar to ELM. Here is a table - showing the common keys used to navigate menus in Mutt-ng. + 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. Most commonly used movement bindings - 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 + 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 @@ -701,28 +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. - ^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 @@ -732,45 +836,48 @@ Chapter 2. Getting Started 5. Reading Mail - The Index and Pager - Similar to many other mail clients, there are two modes in which mail is - read in Mutt-ng. The first is the index of messages in the mailbox, which - is called the ``index'' in Mutt-ng. The second mode is the display of the - message contents. This is called the ``pager.'' + Similar to many other mail clients, there are two modes in which mail + isread in Mutt-ng. The first is the index of messages in the mailbox, + which is called the ``index'' in Mutt-ng. The second mode is the display + of the message contents. This is called the ``pager.'' The next few sections describe the functions provided in each of these modes. 5.1. The Message Index - 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 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 @@ -857,121 +964,134 @@ Chapter 2. Getting Started messages. The pager is very similar to the Unix program less though not nearly as featureful. - 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 using an external pager to view messages). Also, the internal pager supports a couple other advanced features. For - one, it will accept and translate the ``standard'' nroff sequences for - bold 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 + one, it will accept and translate the ``standard'' nroff sequences forbold + and underline. These sequences are a series of either the letter, + 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. Additionally, the internal pager supports the ANSI escape sequences for character attributes. Mutt-ng translates them into the correct color and - character settings. The sequences Mutt-ng supports are: - - ESC [ Ps;Ps;Ps;...;Ps m - where Ps = - 0 All Attributes Off - 1 Bold on - 4 Underline on - 5 Blink on - 7 Reverse video on - 3x Foreground color is x - 4x Background color is x - - Colors are - 0 black - 1 red - 2 green - 3 yellow - 4 blue - 5 magenta - 6 cyan - 7 white + character settings. The sequences Mutt-ng supports are: ESC [ + Ps;Ps;Ps;...;Ps m (see table below for possible values for Ps). + + 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) + + Table 2.6. ANSI Colors + + 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. 5.3. Threaded Mode - When the mailbox is sorted by threads, there are a few additional + When the mailbox is sorted by threads ,there are a few additional functions available in the index and pager modes. - ^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 on the 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. + that you can only see a handful of threads onthe screen. See %M in + $index_format. - See also: strict-threads. + 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 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 @@ -980,68 +1100,68 @@ Chapter 2. Getting Started attachment's content type. These changes are not persistent, and get lost upon changing folders. - Note that this command is also available on the compose-menu. There, it's + 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 - displaying the body of the message. This function toggles the display of + 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. @@ -1050,13 +1170,16 @@ Chapter 2. Getting Started The following bindings are available in the index for sending messages. - 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 @@ -1089,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 @@ -1122,32 +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: - 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 they will be - attached to the message you are sending. Note that certain operations like + 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 @@ -1167,7 +1293,6 @@ Chapter 2. Getting Started > production server that we want to set up before our customer's > project will go live. - You can start editing the email message. It is strongly recommended to put your answer below the quoted text and to only quote what is really necessary and that you refer to. Putting your answer on top of the quoted @@ -1178,12 +1303,10 @@ Chapter 2. Getting Started set attribution = "On %d, %n wrote:" - It can also be set to something more compact, e.g. set attribution = "attribution="* %n <%a> [%(%y-%m-%d %H:%M)]:" - The example above results in the following attribution: * Michael Svensson [05-03-06 17:02]: @@ -1192,7 +1315,6 @@ Chapter 2. Getting Started > production server that we want to set up before our customer's > project will go live. - Generally, try to keep your attribution short yet information-rich. It is not the right place for witty quotes, long "attribution" novels or anything like that: the right place for such things is - if at all - the @@ -1206,7 +1328,7 @@ Chapter 2. Getting Started In the situation where a group of people uses email as a discussion, most of the emails will have one or more recipients, and probably several "Cc:" - recipients. The group reply functionality ensures that when you press g + recipients. The group reply functionalityensures that when you press g instead of r to do a reply, each and every recipient that is contained in the original message will receive a copy of the message, either as normal recipient or as "Cc:" recipient. @@ -1227,7 +1349,6 @@ Chapter 2. Getting Started lists linuxevent@luga\.at vuln-dev@ mutt-ng-users@ - Nowadays, most mailing list software like GNU Mailman adds a Mail-Followup-To: header to their emails anyway, so setting lists is hardly ever necessary in practice. @@ -1237,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 @@ -1269,30 +1393,32 @@ 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: - 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. + 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. - The capabilities field (%c) expands to a two-character sequence - representing a key's capabilities. The first character gives the key's - encryption capabilities: A minus sign (-) means that the key cannot be - used for encryption. A dot (.) means that it's marked as a signature key - in one of the user IDs, but may also be used for encryption. The letter e - indicates that this key can be used for encryption. + The capabilities field (%c) expands to a two-character + sequencerepresenting a key's capabilities. The first character gives the + key's encryption capabilities: A minus sign (- )means that the key cannot + be used for encryption. A dot (. )means that it's marked as a signature + key in one of the user IDs, but may also be used for encryption. The + letter e indicates that this key can be used for encryption. The second character indicates the key's signing capabilities. Once again, a ``-'' implies ``not for signing'', ``.'' implies that the key is marked @@ -1302,7 +1428,8 @@ Chapter 2. Getting Started Finally, the validity field (%t) indicates how well-certified a user-id is. A question mark (?) indicates undefined validity, a minus character (-) marks an untrusted association, a space character means a partially - trusted association, and a plus character (+) indicates complete validity. + trusted association, and a plus character (+ ) indicates complete + validity. 6.5. Sending anonymous messages via mixmaster @@ -1326,13 +1453,13 @@ Chapter 2. Getting Started functions, which are by default bound to the left and right arrows and to the h and l keys (think vi keyboard bindings). To insert a remailer at the current chain position, use the insert function. To append a remailer - behind the current chain position, use select-entry or append. You can + behind the current chain position, use select-entry or append . You can also delete entries from the chain, using the corresponding function. Finally, to abandon your changes, leave the menu, or accept them pressing (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 @@ -1360,7 +1487,6 @@ Chapter 2. Getting Started Pay me EUR 50,000.- cash or your favorite stuffed animal will die a horrible death. - ----- End forwarded message ----- When you're done with editing the mail, save and quit the editor, and you @@ -1385,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. @@ -1400,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 @@ -1503,12 +1629,12 @@ Chapter 3. Configuration own tastes. When Mutt-ng is first invoked, it will attempt to read the ``system'' configuration file (defaults set by your local system administrator), unless the ``-n'' commandline option is specified. This - file is typically /usr/local/share/muttng/Muttngrc or /etc/Muttngrc, + file is typically /usr/local/share/muttng/Muttngrc or /etc/Muttngrc , Mutt-ng users will find this file in /usr/local/share/muttng/Muttrc or /etc/Muttngrc. Mutt will next look for a file named .muttrc in your home directory, Mutt-ng will look for .muttngrc. If this file does not exist - and your home directory has a subdirectory named .mutt, mutt try to load a - file named .muttng/muttngrc. + and your home directory has a subdirectory named .mutt , mutt try to load + a file named .muttng/muttngrc. .muttrc (or .muttngrc for Mutt-ng) is the file where you will usually place your commands to configure Mutt-ng. @@ -1531,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. @@ -1555,7 +1681,7 @@ Chapter 3. Configuration split over multiple lines with only one ``#''. # folder-hook . \ - set realname="Michael \"MuttDude\" Elkins" + set realname="Michael \"MuttDude\" Elkins" When testing your config files, beware the following caveat. The backslash at the end of the commented line extends the current line with the next @@ -1604,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. @@ -1617,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. @@ -1640,7 +1766,7 @@ Chapter 3. Configuration macro generic "!less -r /path/to/manual" "Show manual" macro pager "!less -r /path/to/manual" "Show manual" - for generic, pager and index. The alternative is to define a custom + for generic, pager and index .The alternative is to define a custom variable like so: set user_manualcmd = "!less -r /path/to_manual" @@ -1695,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 @@ -1756,7 +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 @@ -1767,7 +1893,7 @@ 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 @@ -1777,8 +1903,8 @@ Chapter 3. Configuration 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. @@ -1789,10 +1915,10 @@ Chapter 3. Configuration source ~/.mail_aliases set alias_file=~/.mail_aliases - To use aliases, you merely use the alias at any place in mutt where mutt - prompts 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. + 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 + $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 @@ -1807,14 +1933,14 @@ 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). map specifies in which menu the binding belongs. Multiple maps may be - specified by separating them with commas (no additional whitespace is - allowed). The currently defined maps are: + specified by separating them with commas (no additional whitespace + isallowed). The currently defined maps are: generic @@ -1879,29 +2005,32 @@ Chapter 3. Configuration In addition, key may consist of: - \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 + 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 key does not need to be enclosed in quotes unless it contains a space (`` ''). @@ -1912,7 +2041,9 @@ Chapter 3. Configuration 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 @@ -1924,7 +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 @@ -1933,12 +2064,12 @@ 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. Note that the settings are not restored when you leave the mailbox. For - example, a command action to perform is to change the sorting method based + example, a command action to perform is to change the sorting methodbased upon the mailbox being read: folder-hook mutt set sort=threads @@ -1951,30 +2082,30 @@ 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 + actions. When you press key in menu menu ,Mutt-ng will behave as if you had typed sequence. So if you have a common sequence of commands you type, - you can create a macro to execute those commands with a single key. + you can create a macro to execute those commands with a singlekey. menu is the maps which the macro will be bound. Multiple maps may be specified by separating multiple menu arguments by commas. Whitespace may - not be used in between the menu arguments and the commas separating them. + not be used in between the menu arguments and thecommas separating them. 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 will - work regardless of the current key bindings, so they are not dependent on - the user having particular key definitions. This makes them more robust - and portable, and also facilitates defining of macros in files used by - more than one user (eg. the system Muttngrc). + The advantage with using function names directly is that the macros + willwork regardless of the current key bindings, so they are not dependent + on the user having particular key definitions. This makes them more + robustand portable, and also facilitates defining of macros in files used + by more than one user (eg. the system Muttngrc). Optionally you can specify a descriptive text after sequence, which is shown in the help screens. @@ -1984,8 +2115,11 @@ Chapter 3. Configuration 9. Using color and mono video attributes - Usage: color object foreground background [ regexp ] Usage: color index - foreground background pattern 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), @@ -2017,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) @@ -2027,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) @@ -2060,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): @@ -2075,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 @@ -2084,8 +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: @@ -2101,7 +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 @@ -2129,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.) + message's recipients--responding to yourself won't make much sense in many + 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 @@ -2150,9 +2291,9 @@ Chapter 3. Configuration pattern under an unalternates command. To remove a regular expression from the alternates list, use the - unalternates command with exactly the same regexp. Likewise, if the regexp - for a alternates command matches an entry on the unalternates list, that - unalternates entry will be removed. If the regexp for unalternates is + unalternates command with exactly the same regexp . Likewise, if the + regexp for a alternates command matches an entry on the unalternates list, + that unalternates entry will be removed. If the regexp for unalternates is ``*'', all entries on alternates will be removed. 12. Format = Flowed @@ -2179,8 +2320,7 @@ Chapter 3. Configuration fit on your terminal. If you want a fixed margin on the right side of your terminal, you can set the following: - set wrapmargin = 10 - + set wrapmargin = 10 The code above makes the line break 10 columns before the right side of the terminal. @@ -2188,46 +2328,42 @@ Chapter 3. Configuration If your terminal is so wide that the lines are embarrassingly long, you can also set a maximum line length: - set max_line_length = 120 - + set max_line_length = 120 The example above will give you lines not longer than 120 characters. When you view at format=flowed messages, you will often see the quoting hierarchy like in the following example: - >Bill, can you please send last month's progress report to Mr. - >Morgan? We also urgently need the cost estimation for the new - >production server that we want to set up before our customer's - >project will go live. - + >Bill, can you please send last month's progress report to Mr. + >Morgan? We also urgently need the cost estimation for the new + >production server that we want to set up before our customer's + >project will go live. This obviously doesn't look very nice, and it makes it very hard to differentiate between text and quoting character. The solution is to configure mutt-ng to "stuff" the quoting: - set stuff_quoted - + set stuff_quoted This will lead to a nicer result that is easier to read: - > Bill, can you please send last month's progress report to Mr. - > Morgan? We also urgently need the cost estimation for the new - > production server that we want to set up before our customer's - > project will go live. - + > Bill, can you please send last month's progress report to Mr. + > Morgan? We also urgently need the cost estimation for the new + > production server that we want to set up before our customer's + > project will go live. 12.3. Sending If you want mutt-ng to send emails with format=flowed set, you need to explicitly set it: - set text_flowed - + 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 @@ -2240,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. @@ -2260,8 +2392,13 @@ 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 ...] + + 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 @@ -2273,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 @@ -2304,10 +2441,10 @@ 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 a - different mailbox automatically when you quit or change folders. pattern + This command is used to move read messages from a specified mailbox to + adifferent mailbox automatically when you quit or change folders. pattern is a regular expression specifying the mailbox to treat as a ``spool'' mailbox and mailbox specifies where mail should be saved when read. @@ -2316,7 +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 @@ -2341,12 +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 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. @@ -2359,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. @@ -2376,7 +2517,9 @@ Chapter 3. Configuration 17. Defining the order of headers when viewing messages - Usage: hdr_order header1 header2 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. @@ -2389,12 +2532,12 @@ 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 From: an address matching regexp or if you are the author and the message - is addressed to: something matching regexp. + is addressed to: something matching regexp . See pattern-hook for information on the exact format of pattern. @@ -2407,31 +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 + + 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 @@ -2439,15 +2587,15 @@ Chapter 3. Configuration recipients of the message. 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, + 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. 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. + 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. 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 @@ -2458,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 @@ -2469,7 +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 @@ -2482,19 +2630,19 @@ Chapter 3. Configuration Example: message-hook ~A 'set pager=builtin' - message-hook '~f freshmeat-news' 'set pager="less \"+/^ subject: .*\""' + message-hook '~f freshmeat-news' 'set pager="less \"+/^ subject:.*\""' 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 recipient's public key can't be deduced from the destination address, or - because, for some reasons, you need to override the key Mutt-ng would - normally use. The crypt-hook command provides a method by which you can - specify the ID of the public key to be used when encrypting messages to a - certain recipient. + because, for some reasons, you need to override the key Mutt-ng + wouldnormally use. The crypt-hook command provides a method by which you + can specify the ID of the public key to be used when encrypting messages + to a certain recipient. The meaning of "key id" is to be taken broadly in this context: You can either put a numerical key ID here, an e-mail address, or even just a real @@ -2502,23 +2650,29 @@ 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 string in the macro command. You may use it to automatically run a - sequence of commands at startup, or when entering certain folders. + sequence of commands at startup, or when entering certain folders. For + example, the following command will automatically collapse all threads + when entering a folder: + + 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 @@ -2556,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-" @@ -2576,15 +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 @@ -2615,16 +2772,16 @@ Chapter 3. Configuration If I then received a message that DCC registered with ``many'' hits under the ``Fuz2'' checksum, and that PureMessage registered with a 97% - probability of being spam, that message's spam tag would read - 90+/DCC-Fuz2, 97/PM. (The four characters before ``=many'' in a DCC report - indicate the checksum used -- in this case, ``Fuz2''.) + probability of being spam, that message's spam tag would read90+/DCC-Fuz2, + 97/PM. (The four characters before ``=many'' in a DCC report indicate the + checksum used -- in this case, ``Fuz2''.) If the $spam_separator variable is unset, then each spam pattern match supersedes the previous one. Instead of getting joined format strings, 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. @@ -2639,14 +2796,14 @@ Chapter 3. Configuration no spam attributes at all -- that is, one that didn't match any of your spam patterns -- is sorted at lowest priority. Numbers are sorted next, beginning with 0 and ranging upward. Finally, non-numeric strings are - sorted, with ``a'' taking lower priority than ``z''. Clearly, in general, + sorted, with ``a'' taking lowerpriority than ``z''. Clearly, in general, sorting by spam tags is most effective when you can coerce your filter to give you a raw number. But in case you can't, mutt can still do something useful. The nospam command can be used to write exceptions to spam patterns. If a header pattern matches something in a spam command, but you nonetheless do - not want it to receive a spam tag, you can list a more precise pattern + not want it to receive a spam tag, you can list amore precise pattern under a nospam command. If the pattern given to nospam is exactly the same as the pattern on an @@ -2666,9 +2823,13 @@ 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 ...] + + 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 @@ -2688,7 +2849,7 @@ Chapter 3. Configuration prompt with a default answer of ``yes'' and ask-no will provide a default answer of ``no.'' - Prefixing a variable with ``no'' will unset it. Example: set noaskbcc. + Prefixing a variable with ``no'' will unset it. Example: set noaskbcc . For boolean variables, you may optionally prefix the variable name with inv to toggle the value (on or off). This is useful when writing macros. @@ -2719,27 +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 @@ -2758,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 @@ -2798,30 +2959,29 @@ Chapter 3. Configuration All available functions, variables and menus are documented elsewhere in this manual but ``features'' is specific to these two commands. To test - for one, prefix one of the following keywords with feature_: + for one, prefix one of the following keywords with feature_: ncurses, + slang, iconv, idn, dotlock, standalone, pop, nntp, imap, ssl, gnutls, + sasl, sasl2, libesmtp, compressed, color, classic_pgp, classic_smime, + gpgme, header_cache - ncurses, slang, iconv, idn, dotlock, standalone, pop, nntp, imap, ssl, - gnutls, 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' @@ -2943,14 +3103,14 @@ Chapter 4. Advanced Usage regular expressions that match themselves. Any metacharacter with special meaning may be quoted by preceding it with a backslash. - The period ``.'' matches any single character. The caret ``^'' and the + The period ``.'' matches any single character. The caret ``^'' andthe 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 @@ -3018,10 +3178,10 @@ Chapter 4. Advanced Usage equivalent to [0-9]. Two additional special sequences can appear in character lists. These - apply to non-ASCII character sets, which can have single symbols (called - collating elements) that are represented with more than one character, as - well as several characters that are equivalent for collating or sorting - purposes: + apply to non-ASCII character sets, which can have single symbols + (calledcollating elements) that are represented with more than one + character, as well as several characters that are equivalent for collating + or sorting purposes: Collating Symbols @@ -3131,9 +3291,8 @@ Chapter 4. Advanced Usage grouped, ORed, and negated. For a complete listing of these patterns, please refer to table patterns in the Reference chapter. - It must be noted that in this table, EXPR, USER, ID and SUBJECT are - regular expressions. For ranges, the forms <[MAX], >>[MIN], [MIN]- and - -[MAX] are also possible. + It must be noted that in this table, EXPR is a regular expression. For + ranges, the forms <[MAX], >>[MIN], [MIN]- and -[MAX] are also possible. 2.1. Complex Patterns @@ -3174,7 +3333,7 @@ Chapter 4. Advanced Usage margin needs to contain the information whether it goes ``forth'' or ``back'' in time, by using + and -. Then follows a number and a unit, i.e. y for years, m for months, w for weeks and d for days. If you use the - special * sign, it means that the error margin goes to both ``directions'' + special * sign, it means that the error margin goes to both``directions'' in time. ~d 01/01/2005+1y @@ -3216,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: @@ -3307,7 +3466,7 @@ Chapter 4. Advanced Usage all dots in the expansion of to underscores (_). Also, there's a feature called Padding supplied by the following two - expandos: %|X and %>X. + expandos: %|X and %>X . %|X @@ -3344,14 +3503,14 @@ 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. If there are no tagged messages, mutt will "eat" the rest of the macro to - abort it's execution. Mutt-ng will stop "eating" the macro when it + abort it's execution.Mutt-ng will stop "eating" the macro when it encounters the ``end-cond'' operator; after this operator the rest of the - macro will be executed as normal. + macro will be executed asnormal. 5. Using Hooks @@ -3385,26 +3544,26 @@ 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 - Hooks that act upon messages (send-hook, save-hook, fcc-hook, - message-hook) are evaluated in a slightly different manner. For the other - types of hooks, a regexp is sufficient. But in dealing with messages a - finer grain of control is needed for matching since for different purposes - you want to match different criteria. + Hooks that act upon messages (send-hook, save-hook, fcc-hook,message-hook + )are evaluated in a slightly different manner. For the other types of + hooks, a regexp is sufficient. But in dealing with messages a finer grain + of control is needed for matching since for different purposes you want to + match different criteria. Mutt-ng allows the use of the patterns language for matching messages in hook commands. This works in exactly the same way as it would when - limiting or searching the mailbox, except that you are restricted to those + limiting orsearching the mailbox, except that you are restricted to those operators which match information mutt extracts from the header of the message (i.e. from, to, cc, date, subject, etc.). 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. @@ -3431,24 +3590,15 @@ Chapter 4. Advanced Usage set mbox='=INBOX' mailboxes INBOX \ - MBOX1 \ - MBOX2 \ - ... + MBOX1 \ + MBOX2 \ + ... You can also specify the colors for mailboxes with new mails by using: color sidebar_new red black color sidebar white black - The available functions are: - - sidebar-scroll-up Scrolls the mailbox list up 1 page - sidebar-scroll-down Scrolls the mailbox list down 1 page - sidebar-next Highlights the next mailbox - sidebar-next-new Highlights the next mailbox with new mail - sidebar-previous Highlights the previous mailbox - sidebar-open Opens the currently highlighted mailbox - Reasonable key bindings look e.g. like this: bind index \Cp sidebar-prev @@ -3468,14 +3618,14 @@ 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'" The wrapper script should accept the query on the command-line. It should return a one line message, then each matching response on a single line, - each line containing a tab separated address then name then some other + each line containing a tab separated address then name thensome other optional information. On error, or if there are no matching addresses, return a non-zero exit code and a one line error message. @@ -3490,8 +3640,8 @@ Chapter 4. Advanced Usage to do a query from the index menu using the query function (default: Q). This will prompt for a query, then bring up the query menu which will list the matching responses. From the query menu, you can select addresses to - create aliases, or to mail. You can tag multiple addresses to mail, start - a new query, or have a new query appended to the current responses. + create aliases, or to mail. You can tag multiple addressesto mail, start a + new query, or have a new query appended to the current responses. The other mechanism for accessing the query function is for address completion, similar to the alias completion. In any prompt for address @@ -3499,7 +3649,7 @@ Chapter 4. Advanced Usage query based on the current address you have typed. Like aliases, mutt will look for what you have typed back to the last space or comma. If there is a single response for that query, mutt will expand the address in place. - If there are multiple responses, mutt will activate the query menu. At the + If there are multiple responses, mutt will activate the querymenu. At the query menu, you can select one or more addresses to be added to the prompt. @@ -3507,8 +3657,9 @@ 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 new - mailboxes, Mutt-ng uses the default specified with the mbox-type variable. + no need to use a flag for different mailbox types. When creating + 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 are stored in a single file. Each message has a line of the form: @@ -3524,15 +3675,15 @@ Chapter 4. Advanced Usage MH. A radical departure from mbox and MMDF, a mailbox consists of a directory and each message is stored in a separate file. The filename indicates the message number (however, this is may not correspond to the - message number Mutt-ng displays). Deleted messages are renamed with a - comma (,) prepended to the filename. Note: Mutt detects this type of - mailbox by looking for either .mh_sequences or .xmhcache (needed to - distinguish normal directories from MH mailboxes). + message number Mutt-ng displays). Deleted messages arerenamed with a comma + (,) prepended to the filename. Note: Mutt detects this type of mailbox by + looking for either .mh_sequences or .xmhcache (needed to distinguish + normal directories from MH mailboxes). Maildir. The newest of the mailbox formats, used by the Qmail MTA (a replacement for sendmail). Similar to MH, except that it adds three - subdirectories of the mailbox: tmp, new and cur. Filenames for the - messages are chosen in such a way they are unique, even when two programs + subdirectories of the mailbox: tmp, new and cur .Filenames for the + messages are chosen in such a way they are unique, even when twoprograms are writing the mailbox over NFS, which means that no file locking is needed. @@ -3542,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 @@ -3572,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). @@ -3587,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 @@ -3597,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. @@ -3610,25 +3761,25 @@ 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 - would like to use the address given in the ``Reply-To'' field, or reply + 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 procmail and 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 usually organized into a tree-like structure where a message and all of its replies are represented graphically. If you've ever used a threaded - news client, this is the same concept. It makes dealing with large volume + news client, this is the same concept. It makes dealingwith large volume mailing lists easier because you can easily delete uninteresting threads and quickly find topics of value. @@ -3656,13 +3807,13 @@ Chapter 4. Advanced Usage On mailing lists, some people are in the bad habit of starting a new discussion by hitting "reply" to any message from the list and changing the subject to a totally unrelated one. You can fix such threads by using - the ``break-thread'' function (bound by default to #), which will turn the + the ``break-thread'' function (boundby default to #), which will turn the subthread starting from the current message into a whole different thread. 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: @@ -3675,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 - failed message, message delivered, etc.). + 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. @@ -3700,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 @@ -3710,12 +3861,12 @@ Chapter 4. Advanced Usage prefix, ie: pops://[username@]popserver[:port]/. 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 + 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 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) @@ -3723,41 +3874,43 @@ 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 convert - paths accordingly. + correctly notice which separator is being used by the server and + convertpaths accordingly. 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 to - v12.250, the server has been reported to disconnect a client if another + 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 client selects the same folder. 14.1. The Folder Browser @@ -3777,7 +3930,7 @@ Chapter 4. Advanced Usage folder, you must use view-file instead (bound to space by default). o You can create, delete and rename mailboxes with the create-mailbox, - delete-mailbox, and rename-mailbox commands (default bindings: C, d + delete-mailbox, and rename-mailbox commands (default bindings: C , d and r, respectively). You may also subscribe and unsubscribe to mailboxes (normally these are bound to s and u, respectively). @@ -3797,7 +3950,7 @@ Chapter 4. Advanced Usage methods (including DIGEST-MD5 and possibly GSSAPI), your entire session will be encrypted and invisible to those teeming network snoops. It is the best option if you have it. To use it, you must have the Cyrus SASL - library installed on your system and compile mutt with the --with-sasl + libraryinstalled on your system and compile mutt with the --with-sasl flag. Mutt-ng will try whichever methods are compiled in and available on the @@ -3805,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). @@ -3827,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. @@ -3836,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 @@ -3847,25 +4000,22 @@ Chapter 4. Advanced Usage score ~* =42 - This tells mutt-ng to apply a score of 42 to all messages whose sender specified a valid realname and a valid email address. Using score !~* =42 - 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 + end in a dot. This means that ``Joe User'' and ``Joe A.User'' are valid while ``J. User'' and ``J. A. User'' aren't. o it's assumed that users are interested in reading their own mail and - mail from people who they have defined an alias for so that those 2 + mail from people who they have defined an alias forso that those 2 groups of messages are excluded from the strict rules. 16. SMTP Support (OPTIONAL) @@ -3875,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 if it doesn't while + 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) @@ -3916,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 @@ -3936,8 +4086,8 @@ Chapter 4. Advanced Usage accepted format, appending to it and converting back to the user-defined format. - There are three hooks defined (open-hook, close-hook and append-hook) - which define commands to uncompress and compress a folder and to append + There are three hooks defined (open-hook, close-hook and append-hook + )which define commands to uncompress and compress a folder and to append messages to an existing compressed folder respectively. For example: @@ -3946,8 +4096,8 @@ Chapter 4. Advanced Usage close-hook \\.gz$ "gzip -c %t > %f" append-hook \\.gz$ "gzip -c %t >> %f" - You do not have to specify all of the commands. If you omit append-hook, - the folder will be open and closed again each time you will add to it. If + You do not have to specify all of the commands. If you omit append-hook + ,the folder will be open and closed again each time you will add to it. If you omit close-hook (or give empty command) , the folder will be open in the mode. If you specify append-hook though you'll be able to append to the folder. @@ -3957,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. @@ -3989,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. @@ -3997,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 %t" @@ -4054,7 +4204,7 @@ Chapter 4. Advanced Usage so there is no append-hook defined. Note: the folder is temporary stored decrypted in the /tmp directory, - where it can be read by your system administrator. So think about the + where it can be read by your system administrator. So thinkabout the security aspects of this. Chapter 5. Mutt-ng's MIME Support @@ -4085,16 +4235,18 @@ 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 discerning MIME user requires, and the conformance to the standards - wherever possible. When configuring Mutt-ng for MIME, there are two extra - types of configuration files which Mutt-ng uses. One is the mime.types - file, which contains the mapping of file extensions to IANA MIME types. - The other is the mailcap file, which specifies the external commands to - use for handling specific MIME types. + wherever possible. When configuring Mutt-ng for MIME, there are two + extratypes of configuration files which Mutt-ng uses. One is the + mime.types file, which contains the mapping of file extensions to IANA + MIME types. The other is the mailcap file, which specifies the external + commands to use for handling specific MIME types. 1. Using MIME in Mutt @@ -4106,7 +4258,7 @@ Chapter 5. Mutt-ng's MIME Support When you select a message from the index and view it in the pager, Mutt decodes the message to a text representation. Mutt-ng internally supports a number of MIME types, including text/plain, text/enriched, - message/rfc822, and message/news. In addition, the export controlled + message/rfc822, and message/news .In addition, the export controlled version of Mutt-ng recognizes a variety of PGP MIME types, including PGP/MIME and application/pgp. @@ -4127,7 +4279,7 @@ Chapter 5. Mutt-ng's MIME Support 1.2. The Attachment Menu The default binding for view-attachments is `v', which displays the - attachment menu for a message. The attachment menu displays a list of the + attachment menu for a message. The attachment menu displays a list ofthe attachments in a message. From the attachment menu, you can save, print, pipe, delete, and view attachments. You can apply these operations to a group of attachments at once, by tagging the attachments and by using the @@ -4137,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. @@ -4154,8 +4306,8 @@ Chapter 5. Mutt-ng's MIME Support Attachments appear as follows: - - 1 [text/plain, 7bit, 1K] /tmp/mutt-euler-8082-0 - 2 [applica/x-gunzip, base64, 422K] ~/src/mutt-0.85.tar.gz + 1 [text/plain, 7bit, 1K] /tmp/mutt-euler-8082-0 + 2 [applica/x-gunzip, base64, 422K] ~/src/mutt-0.85.tar.gz The '-' denotes that Mutt-ng will delete the file after sending (or postponing, or canceling) the message. It can be toggled with the @@ -4169,11 +4321,11 @@ Chapter 5. Mutt-ng's MIME Support R). The final field is the description of the attachment, and can be changed with the edit-description command (default: d). -2. MIME Type configuration with mime.types +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: @@ -4201,10 +4353,10 @@ Chapter 5. Mutt-ng's MIME Support molecular viewers. Non-recognised mime types should only be used if the recipient of the message is likely to be expecting such attachments. -3. MIME Viewer configuration with mailcap +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 @@ -4232,14 +4384,14 @@ Chapter 5. Mutt-ng's MIME Support A blank line is blank. A definition line consists of a content type, a view command, and any - number of optional fields. Each field of a definition line is divided by a + number of optional fields. Each field of a definition line is dividedby a semicolon ';' character. The content type is specified in the MIME standard type/subtype method. For example, text/plain, text/html, image/gif, etc. In addition, the mailcap format includes two formats for wildcards, one using the special '*' subtype, the other is the implicit wild, where you only include the - major type. For example, image/*, or video, will match all image types and + major type. For example, image/* ,or video, will match all image types and video types, respectively. The view command is a Unix command for viewing the type specified. There @@ -4267,14 +4419,13 @@ 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. - On the other hand, maybe you don't want to use lynx interactively, you - just want to have it convert the text/html to text/plain, then you can - use: + On the other hand, maybe you don't want to use lynx interactively, youjust + want to have it convert the text/html to text/plain, then you can use: text/html; lynx -dump %s | more @@ -4291,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 @@ -4311,7 +4462,7 @@ Chapter 5. Mutt-ng's MIME Support itself subject to any further expansion): text/test-mailcap-bug; cat %s; copiousoutput; test=charset=%{charset} \ - && test "`echo $charset | tr '[A-Z]' '[a-z]'`" != iso-8859-1 + && test "`echo $charset | tr '[A-Z]' '[a-z]'`" != iso-8859-1 3.3. Advanced mailcap Usage @@ -4338,14 +4489,14 @@ 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 status - of 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. + 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. compose= @@ -4392,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 @@ -4414,12 +4565,12 @@ Chapter 5. Mutt-ng's MIME Support image/*; xv %s image/gif; ; print= anytopnm %s | pnmtops | lpr; \ - nametemplate=%s.gif + nametemplate=%s.gif 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 @@ -4429,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 @@ -4473,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. @@ -4497,7 +4648,6 @@ Chapter 5. Mutt-ng's MIME Support # Send html to a running netscape by remote text/html; netscape -remote 'openURL(%s)'; test=RunningNetscape - # If I'm not running netscape but I am running X, start netscape on the # object text/html; netscape %s; test=RunningX @@ -4517,20 +4667,23 @@ Chapter 5. Mutt-ng's MIME Support # Use xv to view images if I'm running X # In addition, this uses the \ to extend the line and set my editor # for images - image/*;xv %s; test=RunningX; \ - edit=xpaint %s + 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 - In addition to explicitly telling Mutt-ng to view an attachment with the - MIME viewer defined in the mailcap file, Mutt-ng has support for + 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. To work, you must define a viewer in the mailcap file which uses the @@ -4543,7 +4696,8 @@ Chapter 5. Mutt-ng's MIME Support For instance, if you set auto_view to: - auto_view text/html application/x-gunzip application/postscript image/gif application/x-tar-gz + auto_view text/html application/x-gunzip application/postscript + image/gif application/x-tar-gz Mutt-ng could use the following mailcap entries to automatically view attachments of these types. @@ -4560,27 +4714,128 @@ 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 types is + alternative_order list to determine if one of the available typesis preferred. The alternative_order list consists of a number of MIME types in order, including support for implicit and explicit wildcards, for example: - alternative_order text/enriched text/plain text application/postscript image/* + 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 will look for any type it knows how to handle. + 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 to - deal with binary types such as application/octet-stream. When an + be treated according to their mailcap entry. This option is designed + todeal with binary types such as application/octet-stream. When an attachment's mime-type is listed in mime_lookup, then the extension of the filename will be compared to the list of extensions in the mime.types file. The mime-type associated with this extension will then be used to @@ -4643,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 @@ -4657,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. @@ -4668,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 @@ -4678,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 @@ -4695,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 @@ -4712,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 @@ -4764,109 +5019,136 @@ 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. - -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 - ~A all messages - ~b EXPR messages which contain EXPR in the message body - ~B EXPR messages which contain EXPR in the whole message - ~c USER messages carbon-copied to USER - ~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 USER messages originating from USER - ~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 ID 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 SUBJECT messages having SUBJECT in the ``Subject'' field. - ~T tagged messages - ~t USER messages addressed to USER - ~U unread messages - ~v message is part of a collapsed thread. - ~V cryptographically verified messages - ~w EXPR messages which contain EXPR in the `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) - - Where EXPR, USER, ID, and SUBJECT are regexp. Special attention has to be - made when using regular expressions inside of patterns. Specifically, - Mutt-ng's parser for these patterns will strip one level of backslash (\), - which is normally used for quoting. If it is your intention to use a - backslash in the regular expression, you will need to use two backslashes - instead (\\). + 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 + patterns will strip one level of backslash (\), which is normally used for + 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. @@ -4876,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 @@ -4900,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 @@ -4912,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 @@ -4952,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 @@ -4989,53 +5271,57 @@ Chapter 7. Reference removed already. The left column contains the old synonym variables, the right column the full/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 + 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 @@ -5052,7 +5338,7 @@ Chapter 7. Reference See also the $attach_remind_regexp variable. -2. abort_nosubject +2. $abort_nosubject Type: quadoption @@ -5063,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 @@ -5074,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 @@ -5083,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 @@ -5124,7 +5410,7 @@ Chapter 7. Reference character which indicates if the alias is tagged for inclusion -7. allow_8bit +7. $allow_8bit Type: boolean @@ -5133,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 @@ -5146,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 @@ -5158,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 @@ -5167,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 @@ -5176,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 @@ -5185,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 @@ -5205,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 @@ -5254,6 +5540,10 @@ Chapter 7. Reference attachment number + %Q + + "Q", if MIME part qualifies for attachment counting + %s size @@ -5270,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" @@ -5278,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 @@ -5291,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 @@ -5300,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 @@ -5312,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 @@ -5322,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 @@ -5333,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 @@ -5346,7 +5640,7 @@ Chapter 7. Reference Also see ``$fast_reply''. -21. beep +21. $beep Type: boolean @@ -5354,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 @@ -5364,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 @@ -5375,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 @@ -5385,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 @@ -5397,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 @@ -5414,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 @@ -5424,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 @@ -5438,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 @@ -5447,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 @@ -5476,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 @@ -5484,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 @@ -5493,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 @@ -5502,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 @@ -5513,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 @@ -5522,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 @@ -5532,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 @@ -5546,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 @@ -5557,7 +5851,7 @@ Chapter 7. Reference ``$crypt_replyencrypt'', ``$crypt_autosign'', ``$crypt_replysign'' and ``$smime_is_default''. -39. crypt_autosign +39. $crypt_autosign Type: boolean @@ -5570,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 @@ -5581,7 +5875,7 @@ Chapter 7. Reference ``$crypt_replyencrypt'', ``$crypt_autosign'', ``$crypt_replysign'' and ``$smime_is_default''. -41. crypt_replyencrypt +41. $crypt_replyencrypt Type: boolean @@ -5590,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 @@ -5602,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 @@ -5615,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 @@ -5626,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 @@ -5639,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 @@ -5649,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 @@ -5665,11 +5959,11 @@ 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 - Default: 0 + Default: 1 Availability: debug @@ -5680,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 @@ -5695,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 @@ -5706,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 @@ -5720,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 @@ -5730,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 @@ -5740,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 @@ -5750,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 @@ -5760,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 @@ -5777,7 +6071,7 @@ Chapter 7. Reference Example: set dsn_notify="failure,delay" -57. dsn_return +57. $dsn_return Type: string @@ -5792,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 @@ -5815,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 @@ -5825,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 @@ -5838,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 @@ -5849,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 @@ -6131,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 @@ -6142,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 @@ -6152,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 @@ -6167,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 @@ -6177,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 @@ -6192,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 @@ -6203,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 @@ -6212,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 @@ -6221,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 @@ -6231,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 @@ -6241,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 @@ -6251,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 @@ -6261,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 @@ -6270,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 @@ -6294,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 @@ -6319,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 @@ -6329,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 @@ -6341,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 @@ -6357,7 +6650,7 @@ Chapter 7. Reference Note: This is a space separated list. -101. imap_home_namespace +101. $imap_home_namespace Type: string @@ -6369,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 @@ -6388,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 @@ -6400,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 @@ -6412,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 @@ -6423,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 @@ -6438,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 @@ -6451,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 @@ -6464,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 @@ -6475,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 @@ -6488,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 @@ -6500,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 @@ -6511,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 @@ -6520,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 @@ -6529,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 @@ -6539,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 @@ -6676,6 +6969,10 @@ Chapter 7. Reference name of organization of author (`organization:' field) + %X + + number of attachments + %y `x-label:' field, if present @@ -6723,7 +7020,7 @@ Chapter 7. Reference See also: ``$to_chars''. -117. ispell +117. $ispell Type: path @@ -6731,7 +7028,7 @@ Chapter 7. Reference How to invoke ispell (GNU's spell-checking software). -118. keep_flagged +118. $keep_flagged Type: boolean @@ -6741,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 @@ -6751,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 @@ -6760,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 @@ -6771,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 @@ -6780,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 @@ -6792,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 @@ -6804,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 @@ -6818,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 @@ -6841,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 @@ -6851,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 @@ -6862,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 @@ -6873,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 @@ -6891,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 @@ -6900,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 @@ -6910,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 @@ -6921,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 @@ -6931,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 @@ -6940,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 @@ -6953,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 @@ -6963,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 @@ -6971,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 @@ -6979,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 @@ -6987,7 +7284,7 @@ Chapter 7. Reference The name of the MH sequence used for unseen messages. -143. mime_forward +143. $mime_forward Type: quadoption @@ -7003,7 +7300,7 @@ Chapter 7. Reference Also see ``$forward_decode'' and ``$mime_forward_decode''. -144. mime_forward_decode +144. $mime_forward_decode Type: boolean @@ -7013,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 @@ -7023,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 @@ -7051,7 +7348,7 @@ Chapter 7. Reference The remailer's e-mail address. -147. mixmaster +147. $mixmaster Type: path @@ -7063,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 @@ -7073,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: @@ -7144,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 @@ -7153,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 @@ -7162,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 @@ -7172,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 @@ -7181,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 @@ -7190,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 @@ -7199,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: 474 + 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 @@ -7217,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 @@ -7225,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 @@ -7234,7 +7531,19 @@ Chapter 7. Reference This variable, when set, makes the thread tree narrower, allowing deeper threads to fit on the screen. -160. nntp_ask_followup_to +160. $net_inc + + Type: number + + Default: 10 + + Operations that expect to transfer a large amount of data over the network + will update their progress every net_inc kilobytes. If set to 0, no + progress messages will be displayed. + + See also ``$read_inc'' and ``$write_inc''. + +161. $nntp_ask_followup_to Type: boolean @@ -7245,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. -161. nntp_ask_x_comment_to +162. $nntp_ask_x_comment_to Type: boolean @@ -7256,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. -162. nntp_cache_dir +163. $nntp_cache_dir Type: path - Default: "˜/.muttng" + Default: "~/.muttng" Availability: NNTP @@ -7271,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. -163. nntp_catchup +164. $nntp_catchup Type: quadoption @@ -7282,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. -164. nntp_context +165. $nntp_context Type: number @@ -7297,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. -165. nntp_followup_to_poster +166. $nntp_followup_to_poster Type: quadoption @@ -7309,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. -166. nntp_group_index_format +167. $nntp_group_index_format Type: string @@ -7332,7 +7641,7 @@ Chapter 7. Reference %|X pad to the end of the line with character "X" -167. nntp_host +168. $nntp_host Type: string @@ -7355,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. -168. nntp_inews +169. $nntp_inews Type: path @@ -7372,7 +7681,7 @@ Chapter 7. Reference Example: set inews="/usr/local/bin/inews -hS" -169. nntp_load_description +170. $nntp_load_description Type: boolean @@ -7383,7 +7692,7 @@ Chapter 7. Reference This variable controls whether or not descriptions for newsgroups are to be loaded when subscribing to a newsgroup. -170. nntp_mail_check +171. $nntp_mail_check Type: number @@ -7395,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.). -171. nntp_mime_subject +172. $nntp_mime_subject Type: boolean @@ -7408,11 +7717,11 @@ Chapter 7. Reference Note: Only change this setting if you know what you are doing. -172. nntp_newsrc +173. $nntp_newsrc Type: path - Default: "˜/.newsrc" + Default: "~/.newsrc" Availability: NNTP @@ -7425,7 +7734,7 @@ Chapter 7. Reference %s newsserver name -173. nntp_pass +174. $nntp_pass Type: string @@ -7439,7 +7748,7 @@ Chapter 7. Reference since the superuser of your machine may read it regardless of the file's permissions. -174. nntp_post_moderated +175. $nntp_post_moderated Type: quadoption @@ -7453,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. -175. nntp_reconnect +176. $nntp_reconnect Type: quadoption @@ -7464,7 +7773,7 @@ Chapter 7. Reference Controls whether or not Mutt-ng will try to reconnect to a newsserver when the was connection lost. -176. nntp_save_unsubscribed +177. $nntp_save_unsubscribed Type: boolean @@ -7475,7 +7784,7 @@ Chapter 7. Reference When set, info about unsubscribed newsgroups will be saved into the ``newsrc'' file and into the news cache. -177. nntp_show_new_news +178. $nntp_show_new_news Type: boolean @@ -7488,7 +7797,7 @@ Chapter 7. Reference controls whether or not the number of new articles of subscribed newsgroups will be checked. -178. nntp_show_only_unread +179. $nntp_show_only_unread Type: boolean @@ -7499,7 +7808,7 @@ Chapter 7. Reference If set, only subscribed newsgroups that contain unread articles will be displayed in the newsgroup browser. -179. nntp_user +180. $nntp_user Type: string @@ -7510,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. -180. nntp_x_comment_to +181. $nntp_x_comment_to Type: boolean @@ -7522,7 +7831,7 @@ Chapter 7. Reference full name of the original article author) to articles that you followup to. -181. operating_system +182. $operating_system Type: string @@ -7534,7 +7843,7 @@ Chapter 7. Reference It may, for example, look as: ``mutt-ng 1.5.9i (Linux)''. -182. pager +183. $pager Type: path @@ -7550,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. -183. pager_context +184. $pager_context Type: number @@ -7561,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). -184. pager_format +185. $pager_format Type: string @@ -7571,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. -185. pager_index_lines +186. $pager_index_lines Type: number @@ -7588,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. -186. pager_stop +187. $pager_stop Type: boolean @@ -7597,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. -187. pgp_auto_decode +188. $pgp_auto_decode Type: boolean @@ -7610,7 +7919,7 @@ Chapter 7. Reference checked with the check-traditional-pgp function, Mutt-ng will automatically check the message for traditional pgp. -188. pgp_autoinline +189. $pgp_autoinline Type: boolean @@ -7626,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) -189. pgp_check_exit +190. $pgp_check_exit Type: boolean @@ -7639,7 +7948,7 @@ Chapter 7. Reference signing or encrypting. A non-zero exit code means that the subprocess failed. (PGP only) -190. pgp_clearsign_command +191. $pgp_clearsign_command Type: string @@ -7647,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) -191. pgp_decode_command +192. $pgp_decode_command Type: string @@ -7687,7 +7996,7 @@ Chapter 7. Reference samples/ subdirectory which has been installed on your system alongside the documentation. (PGP only) -192. pgp_decrypt_command +193. $pgp_decrypt_command Type: string @@ -7695,7 +8004,7 @@ Chapter 7. Reference This command is used to decrypt a PGP encrypted message. (PGP only) -193. pgp_encrypt_only_command +194. $pgp_encrypt_only_command Type: string @@ -7703,7 +8012,7 @@ Chapter 7. Reference This command is used to encrypt a body part without signing it. (PGP only) -194. pgp_encrypt_sign_command +195. $pgp_encrypt_sign_command Type: string @@ -7711,7 +8020,7 @@ Chapter 7. Reference This command is used to both sign and encrypt a body part. (PGP only) -195. pgp_entry_format +196. $pgp_entry_format Type: string @@ -7759,7 +8068,7 @@ Chapter 7. Reference (PGP only) -196. pgp_export_command +197. $pgp_export_command Type: string @@ -7768,7 +8077,7 @@ Chapter 7. Reference This command is used to export a public key from the user's key ring. (PGP only) -197. pgp_getkeys_command +198. $pgp_getkeys_command Type: string @@ -7777,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) -198. pgp_good_sign +199. $pgp_good_sign Type: regular expression @@ -7788,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) -199. pgp_ignore_subkeys +200. $pgp_ignore_subkeys Type: boolean @@ -7798,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) -200. pgp_import_command +201. $pgp_import_command Type: string @@ -7807,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) -201. pgp_list_pubring_command +202. $pgp_list_pubring_command Type: string @@ -7819,7 +8128,7 @@ Chapter 7. Reference This format is also generated by the pgpring utility which comes with Mutt-ng. (PGP only) -202. pgp_list_secring_command +203. $pgp_list_secring_command Type: string @@ -7831,7 +8140,7 @@ Chapter 7. Reference This format is also generated by the pgpring utility which comes with Mutt-ng. (PGP only) -203. pgp_long_ids +204. $pgp_long_ids Type: boolean @@ -7840,7 +8149,7 @@ Chapter 7. Reference If set, use 64 bit PGP key IDs. Unset uses the normal 32 bit Key IDs. (PGP only) -204. pgp_mime_auto +205. $pgp_mime_auto Type: quadoption @@ -7850,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) -205. pgp_replyinline +206. $pgp_replyinline Type: boolean @@ -7871,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) -206. pgp_retainable_sigs +207. $pgp_retainable_sigs Type: boolean @@ -7887,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) -207. pgp_show_unusable +208. $pgp_show_unusable Type: boolean @@ -7897,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) -208. pgp_sign_as +209. $pgp_sign_as Type: string @@ -7907,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) -209. pgp_sign_command +210. $pgp_sign_command Type: string @@ -7916,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) -210. pgp_sort_keys +211. $pgp_sort_keys Type: sort order @@ -7944,7 +8253,7 @@ Chapter 7. Reference If you prefer reverse order of the above values, prefix it with ``reverse-''. (PGP only) -211. pgp_strict_enc +212. $pgp_strict_enc Type: boolean @@ -7955,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) -212. pgp_timeout +213. $pgp_timeout Type: number @@ -7964,7 +8273,7 @@ Chapter 7. Reference The number of seconds after which a cached passphrase will expire if not used. Default: 300. (PGP only) -213. pgp_use_gpg_agent +214. $pgp_use_gpg_agent Type: boolean @@ -7972,7 +8281,7 @@ Chapter 7. Reference If set, Mutt-ng will use a possibly-running gpg-agent process. (PGP only) -214. pgp_verify_command +215. $pgp_verify_command Type: string @@ -7980,7 +8289,7 @@ Chapter 7. Reference This command is used to verify PGP signatures. (PGP only) -215. pgp_verify_key_command +216. $pgp_verify_key_command Type: string @@ -7989,7 +8298,7 @@ Chapter 7. Reference This command is used to verify key information from the key selection menu. (PGP only) -216. pipe_decode +217. $pipe_decode Type: boolean @@ -7999,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. -217. pipe_sep +218. $pipe_sep Type: string @@ -8008,7 +8317,7 @@ Chapter 7. Reference The separator to add between messages when piping a list of tagged messages to an external Unix command. -218. pipe_split +219. $pipe_split Type: boolean @@ -8021,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. -219. pop_auth_try_all +220. $pop_auth_try_all Type: boolean @@ -8034,7 +8343,7 @@ Chapter 7. Reference unavailable. If a method is available but authentication fails, Mutt-ng will not connect to the POP server. -220. pop_authenticators +221. $pop_authenticators Type: string @@ -8053,7 +8362,7 @@ Chapter 7. Reference Example: set pop_authenticators="digest-md5:apop:user" -221. pop_delete +222. $pop_delete Type: quadoption @@ -8065,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. -222. pop_host +223. $pop_host Type: string @@ -8082,7 +8391,7 @@ Chapter 7. Reference since the superuser of your machine may read it regardless of the file's permissions. -223. pop_last +224. $pop_last Type: boolean @@ -8094,7 +8403,7 @@ Chapter 7. Reference for retrieving only unread messages from the POP server when using the ``fetch-mail'' function. -224. pop_mail_check +225. $pop_mail_check Type: number @@ -8102,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. -225. pop_pass +226. $pop_pass Type: string @@ -8120,7 +8429,7 @@ Chapter 7. Reference since the superuser of your machine may read it regardless of the file's permissions. -226. pop_reconnect +227. $pop_reconnect Type: quadoption @@ -8128,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. -227. pop_user +228. $pop_user Type: string @@ -8143,7 +8452,7 @@ Chapter 7. Reference This variable defaults to your user name on the local machine. -228. post_indent_string +229. $post_indent_string Type: string @@ -8152,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. -229. postpone +230. $postpone Type: quadoption @@ -8161,18 +8470,18 @@ Chapter 7. Reference Controls whether or not messages are saved in the ``$postponed'' mailbox when you elect not to send immediately. -230. 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. -231. preconnect +232. $preconnect Type: string @@ -8192,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. -232. print +233. $print Type: quadoption @@ -8201,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. -233. print_command +234. $print_command Type: path @@ -8209,7 +8518,7 @@ Chapter 7. Reference This specifies the command pipe that should be used to print messages. -234. print_decode +235. $print_decode Type: boolean @@ -8222,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. -235. print_split +236. $print_split Type: boolean @@ -8237,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. -236. prompt_after +237. $prompt_after Type: boolean @@ -8248,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. -237. query_command +238. $query_command Type: path @@ -8258,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. -238. quit +239. $quit Type: quadoption @@ -8269,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. -239. quote_empty +240. $quote_empty Type: boolean @@ -8278,7 +8587,7 @@ Chapter 7. Reference Controls whether or not empty lines will be quoted using ``indent_string''. -240. quote_quoted +241. $quote_quoted Type: boolean @@ -8288,7 +8597,7 @@ Chapter 7. Reference be added to the end of existing prefix. Otherwise, quoted lines will be prepended by ``indent_string''. -241. quote_regexp +242. $quote_regexp Type: regular expression @@ -8301,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. -242. read_inc +243. $read_inc Type: number @@ -8317,7 +8626,7 @@ Chapter 7. Reference Also see the ``$write_inc'' variable. -243. read_only +244. $read_only Type: boolean @@ -8325,7 +8634,7 @@ Chapter 7. Reference If set, all folders are opened in read-only mode. -244. realname +245. $realname Type: string @@ -8339,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. -245. recall +246. $recall Type: quadoption @@ -8351,7 +8660,7 @@ Chapter 7. Reference Setting this variable to yes is not generally useful, and thus not recommended. -246. record +247. $record Type: path @@ -8365,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. -247. reply_regexp +248. $reply_regexp Type: regular expression @@ -8375,7 +8684,7 @@ Chapter 7. Reference replying. The default value corresponds to the English ``Re:'' and the German ``Aw:''. -248. reply_self +249. $reply_self Type: boolean @@ -8385,7 +8694,7 @@ Chapter 7. Reference assume that you want to reply to the recipients of that message rather than to yourself. -249. reply_to +250. $reply_to Type: quadoption @@ -8399,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. -250. resolve +251. $resolve Type: boolean @@ -8409,7 +8718,7 @@ Chapter 7. Reference undeleted) message whenever a command that modifies the current message is executed. -251. reverse_alias +252. $reverse_alias Type: boolean @@ -8430,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). -252. reverse_name +253. $reverse_name Type: boolean @@ -8444,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. -253. reverse_realname +254. $reverse_realname Type: boolean @@ -8455,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. -254. rfc2047_parameters +255. $rfc2047_parameters Type: boolean @@ -8477,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. -255. save_address +256. $save_address Type: boolean @@ -8487,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. -256. save_empty +257. $save_empty Type: boolean @@ -8500,7 +8809,7 @@ Chapter 7. Reference Note: This only applies to mbox and MMDF folders, Mutt-ng does not delete MH and Maildir directories. -257. save_name +258. $save_name Type: boolean @@ -8515,7 +8824,7 @@ Chapter 7. Reference Also see the ``$force_name'' variable. -258. score +259. $score Type: boolean @@ -8525,7 +8834,7 @@ Chapter 7. Reference selectively disable scoring for certain folders when the ``$score_threshold_delete'' variable and friends are used. -259. score_threshold_delete +260. $score_threshold_delete Type: number @@ -8536,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. -260. score_threshold_flag +261. $score_threshold_flag Type: number @@ -8545,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''. -261. score_threshold_read +262. $score_threshold_read Type: number @@ -8556,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. -262. send_charset +263. $send_charset Type: string @@ -8569,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. -263. sendmail +264. $sendmail Type: path @@ -8579,7 +8888,7 @@ Chapter 7. Reference Mutt-ng expects that the specified program interprets additional arguments as recipient addresses. -264. sendmail_wait +265. $sendmail_wait Type: number @@ -8606,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. -265. shell +266. $shell Type: path @@ -8615,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. -266. sidebar_boundary +267. $sidebar_boundary Type: string @@ -8625,7 +8934,7 @@ Chapter 7. Reference variable specifies the characters at which to split a folder name into ``hierarchy items.'' -267. sidebar_delim +268. $sidebar_delim Type: string @@ -8634,7 +8943,7 @@ Chapter 7. Reference This specifies the delimiter between the sidebar (if visible) and other screens. -268. sidebar_newmail_only +269. $sidebar_newmail_only Type: boolean @@ -8642,7 +8951,7 @@ Chapter 7. Reference If set, only folders with new mail will be shown in the sidebar. -269. sidebar_number_format +270. $sidebar_number_format Type: string @@ -8650,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 @@ -8683,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. -270. sidebar_shorten_hierarchy +271. $sidebar_shorten_hierarchy Type: boolean @@ -8699,7 +9008,7 @@ Chapter 7. Reference At which characters this compression is done is controled via the $sidebar_boundary variable. -271. sidebar_visible +272. $sidebar_visible Type: boolean @@ -8708,7 +9017,7 @@ Chapter 7. Reference This specifies whether or not to show the sidebar (a list of folders specified with the ``mailboxes'' command). -272. sidebar_width +273. $sidebar_width Type: number @@ -8716,7 +9025,7 @@ Chapter 7. Reference The width of the sidebar. -273. sig_dashes +274. $sig_dashes Type: boolean @@ -8731,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. -274. sig_on_top +275. $sig_on_top Type: boolean @@ -8742,17 +9051,17 @@ Chapter 7. Reference you really know what you are doing, and are prepared to take some heat from netiquette guardians. -275. 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. -276. signoff_string +277. $signoff_string Type: string @@ -8765,23 +9074,23 @@ Chapter 7. Reference or witty quotes into your mails, better use a signature file instead of the signoff string. -277. 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 -278. sleep_time +279. $sleep_time Type: number @@ -8792,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. -279. smart_wrap +280. $smart_wrap Type: boolean @@ -8802,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. -280. smileys +281. $smileys Type: regular expression @@ -8811,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 -281. smime_ask_cert_label +282. $smime_ask_cert_label Type: boolean @@ -8821,7 +9130,7 @@ Chapter 7. Reference certificate about to be added to the database or not. It is set by default. (S/MIME only) -282. smime_ca_location +283. $smime_ca_location Type: path @@ -8830,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) -283. smime_certificates +284. $smime_certificates Type: path @@ -8843,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) -284. smime_decrypt_command +285. $smime_decrypt_command Type: string @@ -8886,7 +9195,7 @@ Chapter 7. Reference samples/ subdirectory which has been installed on your system alongside the documentation. (S/MIME only) -285. smime_decrypt_use_default_key +286. $smime_decrypt_use_default_key Type: boolean @@ -8897,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) -286. smime_default_key +287. $smime_default_key Type: string @@ -8907,7 +9216,7 @@ Chapter 7. Reference keyid (the hash-value that OpenSSL generates) to work properly (S/MIME only) -287. smime_encrypt_command +288. $smime_encrypt_command Type: string @@ -8915,7 +9224,7 @@ Chapter 7. Reference This command is used to create encrypted S/MIME messages. (S/MIME only) -288. smime_encrypt_with +289. $smime_encrypt_with Type: string @@ -8926,7 +9235,7 @@ Chapter 7. Reference If unset ``3des'' (TripleDES) is used. (S/MIME only) -289. smime_get_cert_command +290. $smime_get_cert_command Type: string @@ -8935,7 +9244,7 @@ Chapter 7. Reference This command is used to extract X509 certificates from a PKCS7 structure. (S/MIME only) -290. smime_get_cert_email_command +291. $smime_get_cert_email_command Type: string @@ -8945,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) -291. smime_get_signer_cert_command +292. $smime_get_signer_cert_command Type: string @@ -8955,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) -292. smime_import_cert_command +293. $smime_import_cert_command Type: string @@ -8964,7 +9273,7 @@ Chapter 7. Reference This command is used to import a certificate via smime_keysng. (S/MIME only) -293. smime_is_default +294. $smime_is_default Type: boolean @@ -8980,7 +9289,7 @@ Chapter 7. Reference (Note that this variable can be overridden by unsetting $crypt_autosmime.) (S/MIME only) -294. smime_keys +295. $smime_keys Type: path @@ -8993,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) -295. smime_pk7out_command +296. $smime_pk7out_command Type: string @@ -9002,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) -296. smime_sign_command +297. $smime_sign_command Type: string @@ -9011,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) -297. smime_sign_opaque_command +298. $smime_sign_opaque_command Type: string @@ -9021,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) -298. smime_timeout +299. $smime_timeout Type: number @@ -9030,7 +9339,7 @@ Chapter 7. Reference The number of seconds after which a cached passphrase will expire if not used. (S/MIME only) -299. smime_verify_command +300. $smime_verify_command Type: string @@ -9039,7 +9348,7 @@ Chapter 7. Reference This command is used to verify S/MIME signatures of type multipart/signed. (S/MIME only) -300. smime_verify_opaque_command +301. $smime_verify_opaque_command Type: string @@ -9048,23 +9357,7 @@ Chapter 7. Reference This command is used to verify S/MIME signatures of type application/x-pkcs7-mime. (S/MIME only) -301. 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. - -302. smtp_host +302. $smtp_host Type: string @@ -9076,7 +9369,7 @@ Chapter 7. Reference invoking the sendmail binary. Setting this variable overrides the value of ``$sendmail'', and any associated variables. -303. smtp_pass +303. $smtp_pass Type: string @@ -9091,7 +9384,7 @@ Chapter 7. Reference since the superuser of your machine may read it regardless of the file's permissions. -304. smtp_port +304. $smtp_port Type: number @@ -9105,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. -305. smtp_use_tls +305. $smtp_use_tls Type: string @@ -9119,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. -306. smtp_user +306. $smtp_user Type: string @@ -9130,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. -307. sort +307. $sort Type: sort order @@ -9153,7 +9446,7 @@ Chapter 7. Reference You may optionally use the ``reverse-'' prefix to specify reverse sorting order (example: set sort=reverse-date-sent). -308. sort_alias +308. $sort_alias Type: sort order @@ -9167,7 +9460,7 @@ Chapter 7. Reference unsorted (leave in order specified in .muttrc) -309. sort_aux +309. $sort_aux Type: sort order @@ -9190,7 +9483,7 @@ Chapter 7. Reference not the right thing to do, but kept to not break any existing configuration setting). -310. sort_browser +310. $sort_browser Type: sort order @@ -9208,7 +9501,7 @@ Chapter 7. Reference You may optionally use the ``reverse-'' prefix to specify reverse sorting order (example: set sort_browser=reverse-date). -311. sort_re +311. $sort_re Type: boolean @@ -9216,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. -312. spam_separator +312. $spam_separator Type: string @@ -9234,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. -313. spoolfile +313. $spoolfile Type: path @@ -9245,7 +9538,7 @@ Chapter 7. Reference automatically set this variable to the value of the environment variable $MAIL if it is not set. -314. ssl_ca_certificates_file +314. $ssl_ca_certificates_file Type: path @@ -9257,7 +9550,7 @@ Chapter 7. Reference Example: set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt -315. ssl_client_cert +315. $ssl_client_cert Type: path @@ -9267,19 +9560,19 @@ Chapter 7. Reference The file containing a client certificate and its associated private key. -316. 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''. -317. ssl_min_dh_prime_bits +317. $ssl_min_dh_prime_bits Type: number @@ -9291,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. -318. ssl_starttls +318. $ssl_starttls Type: quadoption @@ -9303,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. -319. ssl_use_sslv2 +319. $ssl_use_sslv2 Type: boolean @@ -9314,7 +9607,7 @@ Chapter 7. Reference This variables specifies whether to attempt to use SSLv2 in the SSL authentication process. -320. ssl_use_sslv3 +320. $ssl_use_sslv3 Type: boolean @@ -9325,7 +9618,7 @@ Chapter 7. Reference This variables specifies whether to attempt to use SSLv3 in the SSL authentication process. -321. ssl_use_tlsv1 +321. $ssl_use_tlsv1 Type: boolean @@ -9336,7 +9629,7 @@ Chapter 7. Reference This variables specifies whether to attempt to use TLSv1 in the SSL authentication process. -322. ssl_usesystemcerts +322. $ssl_usesystemcerts Type: boolean @@ -9348,7 +9641,7 @@ Chapter 7. Reference certificate store when checking if server certificate is signed by a trusted CA. -323. status_chars +323. $status_chars Type: string @@ -9365,7 +9658,7 @@ Chapter 7. Reference (Certain operations like composing a new mail, replying, forwarding, etc. are not permitted in this mode). -324. status_format +324. $status_format Type: string @@ -9484,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 @@ -9509,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. -325. status_on_top +325. $status_on_top Type: boolean @@ -9518,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. -326. strict_mailto +326. $strict_mailto Type: boolean @@ -9528,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. -327. strict_mime +327. $strict_mime Type: boolean @@ -9548,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. -328. strict_threads +328. $strict_threads Type: boolean @@ -9559,29 +9852,30 @@ Chapter 7. Reference default, messages with the same subject are grouped together in ``pseudo threads.'' This may not always be desirable, such as in a personal mailbox where you might have several unrelated messages with the subject ``hi'' - which will get grouped together. + which will get grouped together. See also ``$sort_re'' for a less drastic + way of controlling this behaviour. -329. 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) -330. 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. -331. stuff_quoted +331. $stuff_quoted Type: boolean @@ -9591,7 +9885,7 @@ Chapter 7. Reference ``stuffed'', i.e. a space will be inserted between the quote characters and the actual text. -332. suspend +332. $suspend Type: boolean @@ -9601,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.'' -333. text_flowed +333. $text_flowed Type: boolean @@ -9614,18 +9908,18 @@ Chapter 7. Reference Note that $indent_string is ignored when this option is set. -334. 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. -335. thread_received +335. $thread_received Type: boolean @@ -9634,16 +9928,16 @@ Chapter 7. Reference When set, Mutt-ng uses the date received rather than the date sent to thread messages by subject. -336. 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 (~). -337. timeout +337. $timeout Type: number @@ -9653,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. -338. tmpdir +338. $tmpdir Type: path @@ -9664,7 +9958,7 @@ Chapter 7. Reference not set, the environment variable $TMPDIR is used. If $TMPDIR is not set then "/tmp" is used. -339. to_chars +339. $to_chars Type: string @@ -9681,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). -340. trash +340. $trash Type: path @@ -9694,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. -341. tunnel +341. $tunnel Type: string @@ -9709,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. -342. umask +342. $umask Type: number @@ -9718,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. -343. uncollapse_jump +343. $uncollapse_jump Type: boolean @@ -9727,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. -344. use_8bitmime +344. $use_8bitmime Type: boolean @@ -9742,7 +10036,7 @@ Chapter 7. Reference flag when sending 8-bit messages to enable ESMTP negotiation or tell libESMTP to do so. -345. use_domain +345. $use_domain Type: boolean @@ -9752,7 +10046,21 @@ Chapter 7. Reference portion) with the value of ``$hostname''. If unset, no addresses will be qualified. -346. 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 @@ -9762,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. -347. use_idn +348. $use_idn Type: boolean @@ -9775,7 +10083,7 @@ Chapter 7. Reference Note: You can use IDNs for addresses even if this is unset. This variable only affects decoding. -348. use_ipv6 +349. $use_ipv6 Type: boolean @@ -9785,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. -349. 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. -350. wait_key +351. $wait_key Type: boolean @@ -9810,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. -351. weed +352. $weed Type: boolean @@ -9819,7 +10127,7 @@ Chapter 7. Reference When set, Mutt-ng will weed headers when displaying, forwarding, printing, or replying to messages. -352. wrap_search +353. $wrap_search Type: boolean @@ -9830,7 +10138,7 @@ Chapter 7. Reference When set, searches will wrap around the first (or last) message. When unset, searches will not wrap. -353. wrapmargin +354. $wrapmargin Type: number @@ -9839,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. -354. write_bcc +355. $write_bcc Type: boolean @@ -9848,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. -355. write_inc +356. $write_inc Type: number @@ -9860,7 +10168,7 @@ Chapter 7. Reference Also see the ``$read_inc'' variable. -356. xterm_icon +357. $xterm_icon Type: string @@ -9870,15 +10178,15 @@ Chapter 7. Reference set. This string is identical in formatting to the one used by ``$status_format''. -357. 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: @@ -9886,7 +10194,7 @@ Chapter 7. Reference set xterm_leave = "`test x$DISPLAY != x && xprop -id $WINDOWID | grep WM_NAME | cut -d '"' -f 2`" -358. xterm_set_titles +359. $xterm_set_titles Type: boolean @@ -9896,7 +10204,7 @@ Chapter 7. Reference as you're in an appropriate terminal). The default must be unset to force in the validity checking. -359. xterm_title +360. $xterm_title Type: string @@ -9920,355 +10228,2163 @@ 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 sender - decode-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 pattern - list-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 TAB jump to the next new 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 ESC TAB jump to the previous new 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 sender - decode-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 TAB jump to the next new 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-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 sender - mail 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-Type - extract-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 - - 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 7.13. Reference: Default PGP Menu Function Bindings - Table of Contents + Function Default Key Description + % view the key's user id + c verify a PGP public key - 1. Acknowledgments + 5.11. editor -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. - The following people have been very helpful to the development of Mutt: - - Vikas Agnihotri , Francois Berjon - , Aric Blumer , - John Capo , David Champion , Liviu Daia , Thomas E. Dickey - , David DeSimone , Nickolay N. - Dudorov , Ruslan Ermilov , Edmund - Grimley Evans , Sven - Guckes , Lars Hecking , Mark - Holloman , Andreas Holzmann - , Marco d'Itri , Björn Jacke - , Byrial Jensen , David Jeske - , Christophe Kalt , Tommi - Komulainen , Felix von Leitner (a.k.a ``Fefe'') - , Brandon Long , Jimmy - Mäkelä , Lars Marowsky-Bree - , Thomas ``Mike'' Michlmayr - , Andrew W. Nosenko , David O'Brien - , Clint Olsen , Park - Myeong Seok , Thomas Parmelan - , Ollivier Robert , Thomas - Roessler , Roland Rosenfeld - , TAKIZAWA Takashi , Allain - Thivillon Gero Treuner - , Vsevolod Volkov , Ken - Weinert + The following people have been very helpful to the development of Mutt + (sorted by surnames): + + o Vikas Agnihotri + o Francois Berjon < Francois.Berjon@aar.alcatel-alsthom.fr> + o Aric Blumer + o John Capo + o David Champion + o Brendan Cully + o Liviu Daia + o Thomas E. Dickey + o David DeSimone + o Nickolay N. Dudorov + o Ruslan Ermilov + o Edmund Grimley Evans + o Michael Finken + o Sven Guckes + o Lars Hecking + o Mark Holloman + o Andreas Holzmann + o Marco d'Itri + o Björn Jacke + o Byrial Jensen + o David Jeske + o Christophe Kalt + o Tommi Komulainen + o Felix von Leitner (a.k.a ``Fefe'') < leitner@math.fu-berlin.de > + o Brandon Long + o Jimmy Mäkeä + o Lars Marowsky-Bree + o Thomas ``Mike'' Michlmayr + o Andrew W. Nosenko + o David O'Brien + o Clint Olsen + o Park Myeong Seok + o Thomas Parmelan + o Ollivier Robert + o Thomas Roessler + o Roland Rosenfeld + o TAKIZAWA Takashi + o Allain Thivillon + o Gero Treuner + o Vsevolod Volkov + o Ken Weinert Mutt-ng is developed by the following people: - Andreas Krennmair , Nico Golde , Rocco - Rutte + o Andreas Krennmair + o Nico Golde + o Rocco Rutte + + The following people have been very helpful to the development of Mutt-ng + (sorted by surnames): + + 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 + + , Editing Input Fields, editor + + $certificate_file , $certificate_file + + , browser + + , index, pager + + , index, pager + + $charset , $charset + + charset-hook, Defining aliases for character sets, Configuration Commands + + , browser + + , Miscellaneous Functions, index, pager + + $check_new , $check_new + + , index + + close-hook, Compressed folders Support (OPTIONAL), Write a compressed + mailbox, Append a message to a compressed mailbox, Configuration Commands + + , Threaded Mode + + , attach + + , Threaded Mode + + $collapse_unread , $collapse_unread + + color, The Pager, Using color and mono video attributes, Configuration + Commands + + $COLORFGBG, Using color and mono video attributes + + , Editing Input Fields, editor + + , Editing Input Fields, editor + + , Sending Mail + + $compose_format , $compose_format + + $config_charset , $config_charset + + $confirmappend , $confirmappend + + $confirmcreate , $confirmcreate + + $connect_timeout , $connect_timeout + + $content_type , $content_type + + $copy , $copy + + , compose + + , index, pager + + , Miscellaneous Functions, Defining/Using aliases, index, + pager, query + + $crypt_autoencrypt , Configuration variables + + $crypt_autosign , Configuration variables + + crypt-hook, Choosing the cryptographic key of the recipient, Configuration + Commands + + $crypt_replyencrypt , Configuration variables + + $crypt_replysign , Configuration variables + + $crypt_replysignencrypted , Configuration variables + + $crypt_verify_sig , Configuration variables + + $crypt_autoencrypt , $crypt_autoencrypt + + $crypt_autopgp , $crypt_autopgp + + $crypt_autosign , $crypt_autosign + + $crypt_autosmime , $crypt_autosmime + + $crypt_replyencrypt , $crypt_replyencrypt + + $crypt_replysign , $crypt_replysign + + $crypt_replysignencrypted , $crypt_replysignencrypted + + $crypt_timestamp , $crypt_timestamp + + $crypt_use_gpgme , $crypt_use_gpgme + + $crypt_verify_sig , $crypt_verify_sig + + , generic + + , generic + + , generic + + D + + $date_format , $date_format + + $debug_level , $debug_level + + , index + + , index, pager + + default-hook, Message Matching in Hooks + + $default_hook , $default_hook + + $delete , $delete + + , Editing Input Fields, editor + + , attach, postpone + + , index, pager + + , index + + $delete_space, Additional Notes + + , Threaded Mode, index, pager + + , Threaded Mode, index, pager + + $delete_space , $delete_space + + $delete_untag , $delete_untag + + , Composing new messages, compose + + $digest_collapse , $digest_collapse + + , index, pager + + , index + + , Miscellaneous Functions, index, pager, attach, + compose + + $display_filter , $display_filter + + $dotlock_program , $dotlock_program + + , Editing Input Fields, editor + + $dsn_notify, Delivery Status Notification (DSN) Support + + $dsn_return, Delivery Status Notification (DSN) Support + + $dsn_notify , $dsn_notify + + $dsn_return , $dsn_return + + $duplicate_threads , $duplicate_threads + + E + + , Miscellaneous Functions, index, pager, compose + + , Composing new messages, compose + + , Composing new messages, compose + + , Composing new messages, compose + + , compose + + , Composing new messages, compose + + , compose + + , Composing new messages, compose + + $edit_headers, Editing the message header, User defined headers, + mailto:-style links, Configuration variables, compose + + , compose + + , Composing new messages, compose + + , Composing new messages, compose + + , Composing new messages, compose + + , Miscellaneous Functions, index, pager, attach, compose + + $EDITOR, Manual Conventions, Composing new messages + + $editor , $editor + + $editor_headers, Editing the message header, Defining/Using aliases + + $editor_headers , $editor_headers + + $edit_headers , $edit_headers + + $encode_from , $encode_from + + , Miscellaneous Functions, generic, pager + + , browser + + $entropy_file , $entropy_file + + $envelope_from_address , $envelope_from_address + + , Editing Input Fields, editor + + $escape , $escape + + exec, Executing functions, Configuration Commands + + , generic, index, pager + + , Miscellaneous Functions, index, pager, attach + + F + + $fast_reply , $fast_reply + + 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 + + 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 + + $fcc_attach , $fcc_attach + + $fcc_clear , $fcc_clear + + , index + + $file_charset , $file_charset + + , compose + + , Moving Around in Menus, generic + + , index, pager + + $folder, Configuration Variables, Defining mailboxes which receive mail, + Mailbox Shortcuts, $folder + + folder-hook, Setting variables based upon mailbox, Spam detection, Using + Hooks, Managing multiple IMAP/POP/NNTP accounts (OPTIONAL), Configuration + Commands + + $folder_format , $folder_format + + $followup_to, Mailing lists, Handling Mailing Lists + + $followup_to , $followup_to + + $force_buffy_check , $force_buffy_check + + $force_name , $force_name + + , Miscellaneous Functions, Composing new messages, + index, pager, compose + + , Sending Mail + + , Editing Input Fields, editor + + $forward_decode , Configuration variables + + $forward_decrypt , Configuration variables + + $forward_format , Configuration variables + + , index, pager, attach + + $forward_quote , Configuration variables + + , Editing Input Fields, editor + + $forward_decode , $forward_decode + + $forward_decrypt , $forward_decrypt + + $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 + + reset, Setting variables, Configuration Commands + + $resolve , $resolve + + $reverse_alias , $reverse_alias + + $reverse_name , $reverse_name + + $reverse_realname , $reverse_realname + + RfC + + 1524, MIME Viewer configuration with mailcap, Command + Expansion, mailcap + + 1894, Delivery Status Notification (DSN) Support + + 2822, Again: Scoring + + 3676, Sending + + 822, User defined headers + + $rfc2047_parameters , $rfc2047_parameters + + S + + $save_empty, Compressed folders Support (OPTIONAL) + + , attach + + 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 + + , index, pager + + $save_address , $save_address + + $save_empty , $save_empty + + $save_name , $save_name + + score, Message Scoring, Configuration Commands, $score + + $score_threshold_delete, Message Scoring + + $score_threshold_flag, Message Scoring + + $score_threshold_read, Message Scoring + + $score_threshold_delete , $score_threshold_delete + + $score_threshold_flag , $score_threshold_flag + + $score_threshold_read , $score_threshold_read + + , generic, pager, alias, query, browser + + , generic, pager, alias, query, browser + + , generic, pager, query + + , generic, pager, alias, query, browser + + , pager + + , generic + + , browser + + send-hook, Change settings based upon message recipients, Using Hooks, + Message Matching in Hooks, Configuration Commands + + , Composing new messages, compose + + send2-hook, Change settings based upon message recipients + + , pager + + $sendmail, Change settings based upon message recipients, $sendmail + + $sendmail_wait , $sendmail_wait + + $send_charset , $send_charset + + set, Setting variables, Configuration Commands + + , index + + $shell , $shell + + , Miscellaneous Functions, generic, pager + + , index + + , index, pager + + , sidebar + + , sidebar + + , sidebar + + , sidebar + + , sidebar + + , sidebar + + $sidebar_shorten_hierarchy , Configuration variables + + $sidebar_boundary , $sidebar_boundary + + $sidebar_delim , $sidebar_delim + + $sidebar_newmail_only , $sidebar_newmail_only + + $sidebar_number_format , $sidebar_number_format + + $sidebar_shorten_hierarchy , $sidebar_shorten_hierarchy + + $sidebar_visible , $sidebar_visible + + $sidebar_width , $sidebar_width + + $signature, Change settings based upon message recipients, $signature + + $signoff_string , $signoff_string + + $sig_dashes , $sig_dashes + + $sig_on_top , $sig_on_top + + $simple_search , $simple_search + + , Miscellaneous Functions, pager + + $sleep_time , $sleep_time + + $smart_wrap , $smart_wrap + + $smileys , $smileys + + $smime_default_key , Configuration variables + + , Composing new messages + + $smime_ask_cert_label , $smime_ask_cert_label + + $smime_ca_location , $smime_ca_location + + $smime_certificates , $smime_certificates + + $smime_decrypt_command , $smime_decrypt_command + + $smime_decrypt_use_default_key , $smime_decrypt_use_default_key + + $smime_default_key , $smime_default_key + + $smime_encrypt_command , $smime_encrypt_command + + $smime_encrypt_with , $smime_encrypt_with + + $smime_get_cert_command , $smime_get_cert_command + + $smime_get_cert_email_command , $smime_get_cert_email_command + + $smime_get_signer_cert_command , $smime_get_signer_cert_command + + $smime_import_cert_command , $smime_import_cert_command + + $smime_is_default , $smime_is_default + + $smime_keys , $smime_keys + + $smime_pk7out_command , $smime_pk7out_command + + $smime_sign_command , $smime_sign_command + + $smime_sign_opaque_command , $smime_sign_opaque_command + + $smime_timeout , $smime_timeout + + $smime_verify_command , $smime_verify_command + + $smime_verify_opaque_command , $smime_verify_opaque_command + + $smtp_envelope, SMTP Support (OPTIONAL) + + $smtp_host, SMTP Support (OPTIONAL) + + $smtp_pass, SMTP Support (OPTIONAL), Configuration variables + + $smtp_use_tls, SMTP Support (OPTIONAL) + + $smtp_user, SMTP Support (OPTIONAL), Configuration variables + + $smtp_host , $smtp_host + + $smtp_pass , $smtp_pass + + $smtp_port , $smtp_port + + $smtp_user , $smtp_user + + $smtp_use_tls , $smtp_use_tls + + $sort , $sort, browser + + , index + + , index, browser + + $sort_alias , $sort_alias + + $sort_aux , $sort_aux + + $sort_browser , $sort_browser + + $sort_re , $sort_re + + source, Miscellaneous Functions, Defining/Using aliases, Reading + initialization commands from another file, Configuration Commands + + spam, Spam detection, Configuration Commands + + $spam_separator , $spam_separator + + $spoolfile, Setting variables based upon mailbox, Defining mailboxes which + receive mail, Mailbox Shortcuts, POP3 Support (OPTIONAL), $spoolfile + + $ssl_ca_certificates_file , $ssl_ca_certificates_file + + $ssl_client_cert , $ssl_client_cert + + $ssl_force_tls , $ssl_force_tls + + $ssl_min_dh_prime_bits , $ssl_min_dh_prime_bits + + $ssl_starttls , $ssl_starttls + + $ssl_usesystemcerts , $ssl_usesystemcerts + + $ssl_use_sslv2 , $ssl_use_sslv2 + + $ssl_use_sslv3 , $ssl_use_sslv3 + + $ssl_use_tlsv1 , $ssl_use_tlsv1 + + $status_format, Composing new messages, Introduction + + $status_chars , $status_chars + + $status_format , $status_format + + $status_on_top , $status_on_top + + $strict_mailto, mailto:-style links + + $strict_threads, Threaded Mode + + $strict_mailto , $strict_mailto + + $strict_mime , $strict_mime + + $strict_threads , $strict_threads + + $strip_was , $strip_was + + $strip_was_regex , $strip_was_regex + + $stuff_quoted , $stuff_quoted + + subscribe, Mailing lists, Configuration Commands, browser + + $suspend , $suspend + + , Manual Conventions, index, pager + + T + + , generic + + , pager + + , index + + , generic + + , generic + + , Threaded Mode, index + + $text_flowed , $text_flowed + + $thorough_search , $thorough_search + + $thread_received , $thread_received + + $tilde , $tilde + + $timeout, IMAP Support (OPTIONAL), $timeout + + $tmpdir, Temporary Files, $tmpdir + + $to_chars, Status Flags + + toggle, Setting variables, Configuration Commands + + , browser + + , index + + , Miscellaneous Functions, pager + + , browser + + , compose + + , index + + , pager + + , generic + + $to_chars , $to_chars + + , editor + + $trash , $trash + + $tunnel , $tunnel + + U + + $umask, Temporary Files, $umask + + unalias, Defining/Using aliases, Configuration Commands + + unalternates, Alternative addresses, Configuration Commands + + unalternative_order, MIME Multipart/Alternative, Configuration Commands + + unattachments, Attachment Searching and Counting + + unauto_view, MIME Autoview, Configuration Commands + + $uncollapse_jump , $uncollapse_jump + + uncolor, Using color and mono video attributes, Configuration Commands + + , attach, postpone + + , index, pager + + , index + + , Threaded Mode, index, pager + + , Threaded Mode, index, pager + + unhdr_order, Defining the order of headers when viewing messages, + Configuration Commands + + unhook, Removing hooks, Configuration Commands + + unignore, Ignoring (weeding) unwanted message headers, Configuration + Commands + + unlists, Mailing lists, Configuration Commands + + unmailboxes, Defining mailboxes which receive mail + + unmime_lookup, MIME Lookup, Configuration Commands + + unmono, Using color and mono video attributes, Configuration Commands + + unmy_hdr, User defined headers, Configuration Commands + + unscore, Message Scoring, Configuration Commands + + unset, Setting variables, Configuration Commands + + unsubscribe, Mailing lists, Configuration Commands, browser + + , index + + , Editing Input Fields, editor + + $use_8bitmime, SMTP Support (OPTIONAL) + + $use_8bitmime , $use_8bitmime + + $use_domain , $use_domain + + $use_envelope_from , $use_envelope_from + + $use_from , $use_from + + $use_idn , $use_idn + + $use_ipv6 , $use_ipv6 + + V + + , pgp + + , attach, compose + + , index, pager + + , browser + + , attach + + , pgp + + , attach + + $VISUAL, Composing new messages + + $visual , $visual + + W + + $wait_key, Miscellaneous Functions, Optional Fields + + $wait_key , $wait_key + + $weed, Miscellaneous Functions, $weed + + , generic + + $wrapmargin , $wrapmargin + + $wrap_search , $wrap_search + + , Composing new messages, compose + + $write_bcc , $write_bcc + + $write_inc , $write_inc + + X + + $xterm_icon , $xterm_icon + + $xterm_leave , $xterm_leave - The following people have been very helpful to the development of Mutt-ng: + $xterm_set_titles , $xterm_set_titles - Christian Gall , Iain Lea , Andreas Kneib - , Carsten Schoelzki , Elimar Riesebieter - + $xterm_title , $xterm_title