X-Git-Url: http://git.madism.org/?a=blobdiff_plain;f=doc%2Fmanual.txt;h=9e08514252f34f492c084374e0ba5563cac12ac0;hb=34bdd3478859130bc69e3253a03590f1bd0be2b5;hp=24cf9c683f5228df8247784e556fa764de89803d;hpb=ef6cefebd708b73cf06da24eda4a919448f1e965;p=apps%2Fmadmutt.git diff --git a/doc/manual.txt b/doc/manual.txt index 24cf9c6..9e08514 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 + + + + Michael Elkins + + version devel-r473 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!'' -------------------------------------------------------------------------- @@ -343,6 +350,40 @@ 1. Acknowledgments + Index + + List of Tables + + 2.1. Default Menu Movement Keys + + 2.2. Built-In Editor Functions + + 2.3. Default Index Menu Bindings + + 2.4. Default Pager Menu Bindings + + 2.5. ANSI Escape Sequences + + 2.6. ANSI Colors + + 2.7. Default Thread Function Bindings + + 2.8. Default Mail Composition Bindings + + 2.9. Default Compose Menu Bindings + + 2.10. PGP Key Menu Flags + + 3.1. Alternative Key Names + + 4.1. Default Sidebar Function Bindings + + 7.1. Mutt-NG Command Line Options + + 7.2. Patterns + + 7.3. Obsolete Variables + Chapter 1. Introduction Table of Contents @@ -369,7 +410,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 @@ -383,10 +424,10 @@ Chapter 1. Introduction 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 @@ -683,17 +724,31 @@ 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. - - 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 + Information is presented in menus, very similar to ELM. Here is a + tableshowing the common keys used to navigate menus in Mutt-ng. + + Table 2.1. Default Menu Movement Keys + + +------------------------------------------------------------------------+ + | Key | Function | Description | + |-------------+----------------+-----------------------------------------| + | j or Down | next-entry | move to the next entry | + |-------------+----------------+-----------------------------------------| + | k or Up | previous-entry | move to the previous entry | + |-------------+----------------+-----------------------------------------| + | z or PageDn | page-down | go to the next page | + |-------------+----------------+-----------------------------------------| + | Z or PageUp | page-up | go to the previous page | + |-------------+----------------+-----------------------------------------| + | = or Home | first-entry | jump to the first entry | + |-------------+----------------+-----------------------------------------| + | * or End | last-entry | jump to the last entry | + |-------------+----------------+-----------------------------------------| + | q | quit | exit the current menu | + |-------------+----------------+-----------------------------------------| + | ? | help | list all key bindings for the current | + | | | menu | + +------------------------------------------------------------------------+ 4. Editing Input Fields @@ -701,28 +756,57 @@ 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. Built-In Editor Functions + + +------------------------------------------------------------------------+ + | Key | Function | Description | + |----------------+-----------------+-------------------------------------| + | ^A or | bol | move to the start of the line | + |----------------+-----------------+-------------------------------------| + | ^B or | backward-char | move back one char | + |----------------+-----------------+-------------------------------------| + | Esc B | backward-word | move back one word | + |----------------+-----------------+-------------------------------------| + | ^D or | delete-char | delete the char under the cursor | + |----------------+-----------------+-------------------------------------| + | ^E or | eol | move to the end of the line | + |----------------+-----------------+-------------------------------------| + | ^F or | forward-char | move forward one char | + |----------------+-----------------+-------------------------------------| + | Esc F | forward-word | move forward one word | + |----------------+-----------------+-------------------------------------| + | | complete | complete filename or alias | + |----------------+-----------------+-------------------------------------| + | ^T | complete-query | complete address with query | + |----------------+-----------------+-------------------------------------| + | ^K | kill-eol | delete to the end of the line | + |----------------+-----------------+-------------------------------------| + | ESC d | kill-eow | delete to the end of the word | + |----------------+-----------------+-------------------------------------| + | ^W | kill-word | kill the word in front of the | + | | | cursor | + |----------------+-----------------+-------------------------------------| + | ^U | kill-line | delete entire line | + |----------------+-----------------+-------------------------------------| + | ^V | quote-char | quote the next typed key | + |----------------+-----------------+-------------------------------------| + | | history-up | recall previous string from history | + |----------------+-----------------+-------------------------------------| + | | history-down | recall next string from history | + |----------------+-----------------+-------------------------------------| + | | backspace | kill the char in front of the | + | | | cursor | + |----------------+-----------------+-------------------------------------| + | Esc u | upcase-word | convert word to upper case | + |----------------+-----------------+-------------------------------------| + | Esc l | downcase-word | convert word to lower case | + |----------------+-----------------+-------------------------------------| + | Esc c | capitalize-word | capitalize the word | + |----------------+-----------------+-------------------------------------| + | ^G | n/a | abort | + |----------------+-----------------+-------------------------------------| + | | n/a | finish editing | + +------------------------------------------------------------------------+ 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 +816,79 @@ 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. Default Index Menu Bindings + + +-------------------------------------------------------------------+ + | Key | Function | Description | + |----------+----------+---------------------------------------------| + | c | | change to a different mailbox | + |----------+----------+---------------------------------------------| + | ESC c | | change to a folder in read-only mode | + |----------+----------+---------------------------------------------| + | C | | copy the current message to another mailbox | + |----------+----------+---------------------------------------------| + | ESC C | | decode a message and copy it to a folder | + |----------+----------+---------------------------------------------| + | ESC s | | decode a message and save it to a folder | + |----------+----------+---------------------------------------------| + | D | | delete messages matching a pattern | + |----------+----------+---------------------------------------------| + | d | | delete the current message | + |----------+----------+---------------------------------------------| + | F | | mark as important | + |----------+----------+---------------------------------------------| + | l | | show messages matching a pattern | + |----------+----------+---------------------------------------------| + | N | | mark message as new | + |----------+----------+---------------------------------------------| + | o | | change the current sort method | + |----------+----------+---------------------------------------------| + | O | | reverse sort the mailbox | + |----------+----------+---------------------------------------------| + | q | | save changes and exit | + |----------+----------+---------------------------------------------| + | s | | save-message | + |----------+----------+---------------------------------------------| + | T | | tag messages matching a pattern | + |----------+----------+---------------------------------------------| + | t | | toggle the tag on a message | + |----------+----------+---------------------------------------------| + | ESC t | | toggle tag on entire message thread | + |----------+----------+---------------------------------------------| + | U | | undelete messages matching a pattern | + |----------+----------+---------------------------------------------| + | u | | undelete-message | + |----------+----------+---------------------------------------------| + | v | | view-attachments | + |----------+----------+---------------------------------------------| + | x | | abort changes and exit | + |----------+----------+---------------------------------------------| + | | | display-message | + |----------+----------+---------------------------------------------| + | | | jump to the next new or unread message | + |----------+----------+---------------------------------------------| + | @ | | show the author's full e-mail address | + |----------+----------+---------------------------------------------| + | $ | | save changes to mailbox | + |----------+----------+---------------------------------------------| + | / | | search | + |----------+----------+---------------------------------------------| + | ESC / | | search-reverse | + |----------+----------+---------------------------------------------| + | ^L | | clear and redraw the screen | + |----------+----------+---------------------------------------------| + | ^T | | untag messages matching a pattern | + +-------------------------------------------------------------------+ 5.1.1. Status Flags @@ -857,25 +975,42 @@ 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. Default Pager Menu Bindings + + +------------------------------------------------------------------------+ + | Key | Function | Description | + |----------+----------+--------------------------------------------------| + | | | go down one line | + |----------+----------+--------------------------------------------------| + | | | display the next page (or next message if at the | + | | | end of a message) | + |----------+----------+--------------------------------------------------| + | - | | go back to the previous page | + |----------+----------+--------------------------------------------------| + | n | | search for next match | + |----------+----------+--------------------------------------------------| + | S | | skip beyond quoted text | + |----------+----------+--------------------------------------------------| + | T | | toggle display of quoted text | + |----------+----------+--------------------------------------------------| + | ? | | show key bindings | + |----------+----------+--------------------------------------------------| + | / | | search for a regular expression (pattern) | + |----------+----------+--------------------------------------------------| + | ESC / | | search backwards for a regular expression | + |----------+----------+--------------------------------------------------| + | \ | | toggle search pattern coloring | + |----------+----------+--------------------------------------------------| + | ^ | | jump to the top of the message | + +------------------------------------------------------------------------+ 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, + one, it will accept and translate the ``standard'' nroff sequences forbold + and underline. These sequences are a series of either the letter, backspace (^H), the letter again for bold or the letter, backspace, ``_'' for denoting underline. Mutt-ng will attempt to display these in bold and underline respectively if your terminal supports them. If not, you can use @@ -884,27 +1019,50 @@ Chapter 2. Getting Started 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 @@ -914,28 +1072,51 @@ Chapter 2. Getting Started 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. Default Thread Function Bindings + + +------------------------------------------------------------------------+ + | Key | Function | Description | + |-------+--------------------+-------------------------------------------| + | ^D | delete-thread | delete all messages in the current thread | + |-------+--------------------+-------------------------------------------| + | ^U | undelete-thread | undelete all messages in the current | + | | | thread | + |-------+--------------------+-------------------------------------------| + | ^N | next-thread | jump to the start of the next thread | + |-------+--------------------+-------------------------------------------| + | ^P | previous-thread | jump to the start of the previous thread | + |-------+--------------------+-------------------------------------------| + | ^R | read-thread | mark the current thread as read | + |-------+--------------------+-------------------------------------------| + | ESC d | delete-subthread | delete all messages in the current | + | | | subthread | + |-------+--------------------+-------------------------------------------| + | ESC u | undelete-subthread | undelete all messages in the current | + | | | subthread | + |-------+--------------------+-------------------------------------------| + | ESC n | next-subthread | jump to the start of the next subthread | + |-------+--------------------+-------------------------------------------| + | ESC p | previous-subthread | jump to the start of the previous | + | | | subthread | + |-------+--------------------+-------------------------------------------| + | ESC r | read-subthread | mark the current subthread as read | + |-------+--------------------+-------------------------------------------| + | ESC t | tag-thread | toggle the tag on the current thread | + |-------+--------------------+-------------------------------------------| + | ESC v | collapse-thread | toggle collapse for the current thread | + |-------+--------------------+-------------------------------------------| + | ESC V | collapse-all | toggle collapse for all threads | + |-------+--------------------+-------------------------------------------| + | P | parent-message | jump to parent message in thread | + +------------------------------------------------------------------------+ 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 + that you can only see a handful of threads onthe screen. See %M in + index-format . For example, you could use "%?M?(#%03M)&(%4l)?" in index-format to optionally display the number of hidden messages if the thread is collapsed. @@ -980,7 +1161,7 @@ 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: ``:'') @@ -1011,7 +1192,7 @@ Chapter 2. Getting Started pipe-message (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 + message(s) to it. The variables pipe-decode ,pipe-split, pipe-sep and wait-key control the exact behavior of this function. resend-message (default: ESC e) @@ -1036,7 +1217,7 @@ Chapter 2. Getting Started toggle-quoted (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 + 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. @@ -1050,18 +1231,30 @@ 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. Default Mail Composition Bindings + + +--------------------------------------------------------+ + | Key | Function | Description | + |-------+-------------+----------------------------------| + | m | compose | compose a new message | + |-------+-------------+----------------------------------| + | r | reply | reply to sender | + |-------+-------------+----------------------------------| + | g | group-reply | reply to all recipients | + |-------+-------------+----------------------------------| + | L | list-reply | reply to mailing list address | + |-------+-------------+----------------------------------| + | f | forward | forward message | + |-------+-------------+----------------------------------| + | b | bounce | bounce (remail) message | + |-------+-------------+----------------------------------| + | ESC k | mail-key | mail a PGP public key to someone | + +--------------------------------------------------------+ Bouncing a message sends the message as is to the recipient you specify. Forwarding a message allows you to add comments or modify the message you are forwarding. These items are discussed in greater detail in the next - chapter forwarding-mail. + chapter forwarding-mail . 6.1. Composing new messages @@ -1122,30 +1315,56 @@ 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. Default Compose Menu Bindings + + +------------------------------------------------------------------------+ + | Key | Function | Description | + |-------+-------------------+--------------------------------------------| + | a | attach-file | attach a file | + |-------+-------------------+--------------------------------------------| + | A | attach-message | attach message(s) to the message | + |-------+-------------------+--------------------------------------------| + | ESC k | attach-key | attach a PGP public key | + |-------+-------------------+--------------------------------------------| + | d | edit-description | edit description on attachment | + |-------+-------------------+--------------------------------------------| + | D | detach-file | detach a file | + |-------+-------------------+--------------------------------------------| + | t | edit-to | edit the To field | + |-------+-------------------+--------------------------------------------| + | ESC f | edit-from | edit the From field | + |-------+-------------------+--------------------------------------------| + | r | edit-reply-to | edit the Reply-To field | + |-------+-------------------+--------------------------------------------| + | c | edit-cc | edit the Cc field | + |-------+-------------------+--------------------------------------------| + | b | edit-bcc | edit the Bcc field | + |-------+-------------------+--------------------------------------------| + | y | send-message | send the message | + |-------+-------------------+--------------------------------------------| + | s | edit-subject | edit the Subject | + |-------+-------------------+--------------------------------------------| + | S | smime-menu | select S/MIME options | + |-------+-------------------+--------------------------------------------| + | f | edit-fcc | specify an ``Fcc'' mailbox | + |-------+-------------------+--------------------------------------------| + | p | pgp-menu | select PGP options | + |-------+-------------------+--------------------------------------------| + | P | postpone-message | postpone this message until later | + |-------+-------------------+--------------------------------------------| + | q | quit | quit (abort) sending the message | + |-------+-------------------+--------------------------------------------| + | w | write-fcc | write the message to a folder | + |-------+-------------------+--------------------------------------------| + | i | ispell | check spelling (if available on your | + | | | system) | + |-------+-------------------+--------------------------------------------| + | ^F | forget-passphrase | wipe passphrase(s) from memory | + +------------------------------------------------------------------------+ 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 indicate that you are in attach-message mode. @@ -1167,7 +1386,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 +1396,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 +1408,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 +1421,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 +1442,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. @@ -1276,23 +1490,31 @@ Chapter 2. Getting Started 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. - - 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. + 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 + 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 +1524,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,7 +1549,7 @@ 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. @@ -1360,7 +1583,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 @@ -1503,19 +1725,19 @@ 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. 2. Basic Syntax of Initialization Files - An initialization file consists of a series of commands. Each line of the + An initialization file consists of a series of commands .Each line of the file may contain one or more commands. When multiple commands are used, they must be separated by a semicolon (;). @@ -1555,7 +1777,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 @@ -1640,7 +1862,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" @@ -1756,7 +1978,8 @@ Chapter 3. Configuration 4. Defining/Using aliases - Usage: alias key address [ , address, ... ] + Usage: alias key 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 @@ -1774,7 +1997,7 @@ Chapter 3. Configuration Unlike other mailers, Mutt-ng doesn't require aliases to be defined in a special file. The alias command can appear anywhere in a configuration - file, as long as this file is source. Consequently, you can have multiple + file, as long as this file is source .Consequently, you can have multiple alias files, or you can have all aliases defined in your muttrc. On the other hand, the create-alias function can use only one file, the @@ -1789,9 +2012,9 @@ 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 + To use aliases, you merely use the alias at any place in mutt where + muttprompts for addresses, such as the To: or Cc: prompt. You can also + enter aliases in your editor at the appropriate headers if you have the edit-headers variable set. In addition, at the various address prompts, you can use the tab character @@ -1809,12 +2032,13 @@ Chapter 3. Configuration Usage: bind map 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,40 +2103,70 @@ 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 (`` ''). function specifies which action to take when key is pressed. For a - complete list of functions, see the functions. The special function noop + complete list of functions, see the functions .The special function noop unbinds the specified key sequence. 6. Defining aliases for character sets - Usage: charset-hook alias charset Usage: iconv-hook charset local-charset + Usage: charset-hook alias charset + Usage: iconv-hook charset local-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 @@ -1926,6 +2180,7 @@ Chapter 3. Configuration Usage: folder-hook [!]regexp command + It is often desirable to change settings based on which mailbox you are reading. The folder-hook command provides a method by which you can execute any configuration command. regexp is a regular expression @@ -1938,7 +2193,7 @@ Chapter 3. Configuration 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 +2206,31 @@ Chapter 3. Configuration 8. Keyboard macros - Usage: macro menu key sequence [ description ] + Usage: macro menu 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 + 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 +2240,10 @@ 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: color object foregroundbackground [ regexp] + Usage: color index foreground backgroundpattern + Usage: uncolor index 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), @@ -2075,7 +2333,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 +2342,9 @@ 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: mono [ regexp ] + Usage: mono index attribute pattern + Usage: unmono index pattern[ pattern ... ] where attribute is one of the following: @@ -2101,7 +2360,8 @@ Chapter 3. Configuration 10. Ignoring (weeding) unwanted message headers - Usage: [un]ignore pattern [ pattern ... ] + Usage: [un]ignore pattern [ pattern... ] + Messages often have many header fields added by automatic processing systems, or which may not seem useful to display on the screen. This @@ -2135,8 +2395,8 @@ Chapter 3. Configuration 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 +2410,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 +2439,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,42 +2447,37 @@ 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 @@ -2260,10 +2514,11 @@ Chapter 3. Configuration 13. Mailing lists - Usage: [un]lists regexp [ regexp ... ] Usage: [un]subscribe regexp [ - regexp ... ] + Usage: [un]lists regexp [ regexp... ] + Usage: [un]subscribe regexp [ regexp... ] - Mutt-ng has a few nice features for using-lists. In order to take + + Mutt-ng has a few nice features for using-lists .In order to take advantage of them, you must specify which addresses belong to mailing lists, and which mailing lists you are subscribed to. Once you have done this, the list-reply function will work for all known lists. Additionally, @@ -2306,8 +2561,9 @@ Chapter 3. Configuration Usage: mbox-hook [!]pattern mailbox - 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 +2572,8 @@ Chapter 3. Configuration 15. Defining mailboxes which receive mail - Usage: [un]mailboxes [!]filename [ filename ... ] + Usage: [un]mailboxes [!]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 @@ -2346,7 +2603,9 @@ Chapter 3. Configuration 16. User defined headers - Usage: my_hdr string unmy_hdr field [ field ... ] + Usage: my_hdr string + Usage: unmy_hdr field [ field... ] + The ``my_hdr'' command allows you to create your own header fields which will be added to every message you send. @@ -2376,7 +2635,8 @@ Chapter 3. Configuration 17. Defining the order of headers when viewing messages - Usage: hdr_order header1 header2 header3 + Usage: hdr_order header1header2 header3 + With this command, you can specify an order in which mutt will attempt to present headers to you when viewing messages. @@ -2391,10 +2651,11 @@ Chapter 3. Configuration Usage: save-hook [!]pattern filename + 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. @@ -2409,6 +2670,7 @@ Chapter 3. Configuration Usage: fcc-hook [!]pattern 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 @@ -2425,27 +2687,32 @@ Chapter 3. Configuration Usage: fcc-save-hook [!]pattern mailbox + 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: reply-hook [!]pattern command + Usage: send-hook [!]pattern command Usage: send2-hook [!]pattern command + + v + These commands can be used to execute arbitrary configuration commands based upon recipients of the message. pattern is a regular expression matching the desired address. command is executed when regexp matches 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, - regardless of the order specified in the users's configuration file. + 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 + 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. @@ -2471,6 +2738,7 @@ Chapter 3. Configuration Usage: message-hook [!]pattern command + This command can be used to execute arbitrary configuration commands before viewing or formatting a message based upon information about the message. command is executed if the pattern matches the message to be @@ -2482,19 +2750,20 @@ 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 + 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 @@ -2504,21 +2773,30 @@ Chapter 3. Configuration Usage: push string + 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: exec function [ 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: score pattern value + Usage: unscore pattern [ 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,8 +2834,8 @@ 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, + 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. @@ -2576,7 +2854,9 @@ Chapter 3. Configuration 27. Spam detection - Usage: spam pattern format Usage: nospam pattern + Usage: spam pattern format + Usage: nospam pattern + Mutt-ng has generalized support for external spam-scoring filters. By defining your spam patterns with the spam and nospam commands, you can @@ -2615,9 +2895,9 @@ 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, @@ -2639,14 +2919,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 @@ -2655,7 +2935,7 @@ Chapter 3. Configuration spam command matches an entry on the nospam list, that nospam entry will be removed. If the pattern for nospam is ``*'', all entries on both lists will be removed. This might be the default action if you use spam and - nospam in conjunction with a folder-hook. + nospam in conjunction with a folder-hook . You can have as many spam or nospam commands as you like. You can even do your own primitive spam detection within mutt -- for example, if you @@ -2666,11 +2946,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: toggle variable [variable... ] + Usage: unset variable [variable... ] + Usage: reset variable [variable... ] - This command is used to set (and unset) variables. There are four basic + + This command is used to set (and unset) variables .There are four basic types of variables: boolean, number, string and quadoption. boolean variables can be set (true) or unset (false). number variables can be assigned a positive integer value. @@ -2688,7 +2970,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,7 +3001,8 @@ Chapter 3. Configuration 29. Reading initialization commands from another file - Usage: source filename [ filename ... ] + Usage: source filename [ 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 @@ -2734,7 +3017,8 @@ Chapter 3. Configuration 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, @@ -2798,11 +3082,10 @@ 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_: - - ncurses, slang, iconv, idn, dotlock, standalone, pop, nntp, imap, ssl, - gnutls, sasl, sasl2, libesmtp, compressed, color, classic_pgp, - classic_smime, gpgme, header_cache + 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 As an example, one can use the following in ˜/.muttngrc: @@ -2816,7 +3099,7 @@ Chapter 3. Configuration 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' @@ -2943,7 +3226,7 @@ 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. @@ -3018,10 +3301,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 +3414,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 +3456,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 @@ -3307,7 +3589,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 @@ -3349,9 +3631,9 @@ Chapter 4. Advanced Usage 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 @@ -3389,15 +3671,15 @@ Chapter 4. Advanced Usage 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.). @@ -3431,9 +3713,9 @@ 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: @@ -3442,12 +3724,23 @@ Chapter 4. Advanced Usage 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 + Table 4.1. Default Sidebar Function Bindings + + +------------------------------------------------------------------------+ + | Key | Function | Description | + |------+---------------------+-------------------------------------------| + | none | sidebar-scroll-up | Scrolls the mailbox list up 1 page | + |------+---------------------+-------------------------------------------| + | none | sidebar-scroll-down | Scrolls the mailbox list down 1 page | + |------+---------------------+-------------------------------------------| + | none | sidebar-next | Highlights the next mailbox | + |------+---------------------+-------------------------------------------| + | none | sidebar-next-new | Highlights the next mailbox with new mail | + |------+---------------------+-------------------------------------------| + | none | sidebar-previous | Highlights the previous mailbox | + |------+---------------------+-------------------------------------------| + | none | sidebar-open | Opens the currently highlighted mailbox | + +------------------------------------------------------------------------+ Reasonable key bindings look e.g. like this: @@ -3475,7 +3768,7 @@ Chapter 4. Advanced Usage 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 +3783,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 +3792,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 +3800,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 +3818,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. @@ -3612,7 +3906,7 @@ Chapter 4. Advanced Usage 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 + 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. @@ -3622,13 +3916,13 @@ Chapter 4. Advanced Usage 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. + 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,7 +3950,7 @@ 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 @@ -3676,7 +3970,7 @@ 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.). + failed message,message delivered, etc.). o dsn-return requests how much of your message should be returned with the receipt (headers or full message). @@ -3710,7 +4004,7 @@ 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 + 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. @@ -3746,8 +4040,8 @@ Chapter 4. Advanced Usage {[username@]imapserver[:port][/ssl]}path/to/folder 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 @@ -3756,8 +4050,8 @@ Chapter 4. Advanced Usage 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. - 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 +4071,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 +4091,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 @@ -3847,13 +4141,11 @@ 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: @@ -3861,11 +4153,11 @@ Chapter 4. Advanced Usage 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,7 +4167,7 @@ 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 @@ -3888,7 +4180,7 @@ Chapter 4. Advanced Usage 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 ``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, @@ -3916,7 +4208,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: + ftp://ftp.mutt.org/mutt/contrib/ > and the configuration commands: macro index \cb |urlview\n macro pager \cb |urlview\n @@ -3936,8 +4228,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 +4238,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,7 +4249,7 @@ 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 @@ -3989,7 +4281,7 @@ Chapter 4. Advanced Usage 19.2. Write a compressed mailbox - Usage: close-hook regexp "command" + Usage: close-hook regexp"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 +4289,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 +4346,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 @@ -4090,11 +4382,11 @@ Chapter 5. Mutt-ng's MIME Support 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 +4398,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 +4419,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 @@ -4154,8 +4446,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,10 +4461,10 @@ 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 + 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 The mime.types file consist of lines containing a MIME type and a space @@ -4201,7 +4493,7 @@ 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 @@ -4232,14 +4524,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 @@ -4272,9 +4564,8 @@ Chapter 5. Mutt-ng's MIME Support 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 @@ -4311,7 +4602,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 +4629,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 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= @@ -4414,7 +4705,7 @@ 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. @@ -4497,7 +4788,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,8 +4807,7 @@ 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 | @@ -4529,8 +4818,8 @@ Chapter 5. Mutt-ng's MIME Support 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 + 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 +4832,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. @@ -4562,16 +4852,17 @@ Chapter 5. Mutt-ng's MIME Support 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 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. @@ -4579,8 +4870,8 @@ Chapter 5. Mutt-ng's MIME Support 6. MIME Lookup 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 @@ -4770,29 +5061,60 @@ Chapter 7. Reference 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. Mutt-NG Command Line Options + + +------------------------------------------------------------------------+ + | Option | Description | + |--------+---------------------------------------------------------------| + | -A | expand an alias | + |--------+---------------------------------------------------------------| + | -a | attach a file to a message | + |--------+---------------------------------------------------------------| + | -b | specify a blind carbon-copy (BCC) address | + |--------+---------------------------------------------------------------| + | -c | specify a carbon-copy (Cc) address | + |--------+---------------------------------------------------------------| + | -e | specify a config command to be run after initialization files | + | | are read | + |--------+---------------------------------------------------------------| + | -f | specify a mailbox to load | + |--------+---------------------------------------------------------------| + | -F | specify an alternate file to read initialization commands | + |--------+---------------------------------------------------------------| + | -h | print help on command line options | + |--------+---------------------------------------------------------------| + | -H | specify a draft file from which to read a header and body | + |--------+---------------------------------------------------------------| + | -i | specify a file to include in a message composition | + |--------+---------------------------------------------------------------| + | -m | specify a default mailbox type | + |--------+---------------------------------------------------------------| + | -n | do not read the system Muttngrc | + |--------+---------------------------------------------------------------| + | -p | recall a postponed message | + |--------+---------------------------------------------------------------| + | -Q | query a configuration variable | + |--------+---------------------------------------------------------------| + | -R | open mailbox in read-only mode | + |--------+---------------------------------------------------------------| + | -s | specify a subject (enclose in quotes if it contains spaces) | + |--------+---------------------------------------------------------------| + | -t | dump the value of all variables to stdout | + |--------+---------------------------------------------------------------| + | -T | dump the value of all changed variables to stdout | + |--------+---------------------------------------------------------------| + | -v | show version number and compile-time definitions | + |--------+---------------------------------------------------------------| + | -x | simulate the mailx(1) compose mode | + |--------+---------------------------------------------------------------| + | -y | show a menu containing the files specified by the mailboxes | + | | command | + |--------+---------------------------------------------------------------| + | -z | exit immediately if there are no messages in the mailbox | + |--------+---------------------------------------------------------------| + | -Z | open the first folder with new message,exit immediately if | + | | none | + +------------------------------------------------------------------------+ To read messages in a mailbox @@ -4814,61 +5136,133 @@ Chapter 7. Reference 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 (\\). - - *) The forms <[MAX], >[MIN], [MIN]- and -[MAX] are allowed, too. + Table 7.2. Patterns + + +------------------------------------------------------------------------+ + | Pattern Modifier | Argument | Description | + |------------------+-------------+---------------------------------------| + | ~A | | all messages | + |------------------+-------------+---------------------------------------| + | ~b | EXPR | messages which contain EXPR in the | + | | | message body | + |------------------+-------------+---------------------------------------| + | ~B | EXPR | messages which contain EXPR in the | + | | | whole message | + |------------------+-------------+---------------------------------------| + | ~c | EXPR | messages carbon-copied to EXPR | + |------------------+-------------+---------------------------------------| + | ~C | EXPR | message is either to: or cc: EXPR | + |------------------+-------------+---------------------------------------| + | ~D | | deleted messages | + |------------------+-------------+---------------------------------------| + | ~d | [MIN]-[MAX] | messages with ``date-sent'' in a Date | + | | | range | + |------------------+-------------+---------------------------------------| + | ~E | | expired messages | + |------------------+-------------+---------------------------------------| + | ~e | EXPR | message which contains EXPR in the | + | | | ``Sender'' field | + |------------------+-------------+---------------------------------------| + | ~F | | flagged messages | + |------------------+-------------+---------------------------------------| + | ~f | EXPR | messages originating from EXPR | + |------------------+-------------+---------------------------------------| + | ~g | | cryptographically signed messages | + |------------------+-------------+---------------------------------------| + | ~G | | cryptographically encrypted messages | + |------------------+-------------+---------------------------------------| + | ~H | EXPR | messages with a spam attribute | + | | | matching EXPR | + |------------------+-------------+---------------------------------------| + | ~h | EXPR | messages which contain EXPR in the | + | | | message header | + |------------------+-------------+---------------------------------------| + | ~k | | message contains PGP key material | + |------------------+-------------+---------------------------------------| + | ~i | EXPR | message which match ID in the | + | | | ``Message-ID'' field | + |------------------+-------------+---------------------------------------| + | ~L | EXPR | message is either originated or | + | | | received by EXPR | + |------------------+-------------+---------------------------------------| + | ~l | | message is addressed to a known | + | | | mailing list | + |------------------+-------------+---------------------------------------| + | ~m | [MIN]-[MAX] | message in the range MIN to MAX *) | + |------------------+-------------+---------------------------------------| + | ~M | | multipart messages | + |------------------+-------------+---------------------------------------| + | ~n | [MIN]-[MAX] | messages with a score in the range | + | | | MIN to MAX *) | + |------------------+-------------+---------------------------------------| + | ~N | | new messages | + |------------------+-------------+---------------------------------------| + | ~O | | old messages | + |------------------+-------------+---------------------------------------| + | ~p | | message is addressed to you (consults | + | | | alternates) | + |------------------+-------------+---------------------------------------| + | ~P | | message is from you (consults | + | | | alternates) | + |------------------+-------------+---------------------------------------| + | ~Q | | messages which have been replied to | + |------------------+-------------+---------------------------------------| + | ~R | | read messages | + |------------------+-------------+---------------------------------------| + | ~r | [MIN]-[MAX] | messages with ``date-received'' in a | + | | | Date range | + |------------------+-------------+---------------------------------------| + | ~S | | superseded messages | + |------------------+-------------+---------------------------------------| + | ~s | EXPR | messages having EXPR in the | + | | | ``Subject'' field. | + |------------------+-------------+---------------------------------------| + | ~T | | tagged messages | + |------------------+-------------+---------------------------------------| + | ~t | EXPR | messages addressed to EXPR | + |------------------+-------------+---------------------------------------| + | ~U | | unread messages | + |------------------+-------------+---------------------------------------| + | ~u | | message is addressed to a subscribed | + | | | mailing list | + |------------------+-------------+---------------------------------------| + | ~v | | message is part of a collapsed | + | | | thread. | + |------------------+-------------+---------------------------------------| + | ~V | | cryptographically verified messages | + |------------------+-------------+---------------------------------------| + | | | messages which contain EXPR in the | + | ~w | EXPR | `Newsgroups' field (if compiled with | + | | | NNTP support) | + |------------------+-------------+---------------------------------------| + | ~x | EXPR | messages which contain EXPR in the | + | | | `References' field | + |------------------+-------------+---------------------------------------| + | ~y | EXPR | messages which contain EXPR in the | + | | | `X-Label' field | + |------------------+-------------+---------------------------------------| + | ~z | [MIN]-[MAX] | messages with a size in the range MIN | + | | | to MAX *) | + |------------------+-------------+---------------------------------------| + | ~= | | duplicated messages (see | + | | | $duplicate_threads) | + |------------------+-------------+---------------------------------------| + | ~$ | | unreferenced messages (requires | + | | | threaded view) | + |------------------+-------------+---------------------------------------| + | | | ``From'' contains realname and | + | ~* | | (syntactically) valid address | + | | | (excluded are addresses matching | + | | | against alternates or any alias) | + +------------------------------------------------------------------------+ + + 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. 3. Configuration Commands @@ -4876,7 +5270,7 @@ Chapter 7. Reference o account-hook pattern command - o alias key address [ , address, ... ] + o alias key address [ , address ,... ] o alias [ * | key ... ] @@ -4964,7 +5358,7 @@ Chapter 7. Reference o reply-hook regexp command - o set [no|inv]variable[=value] [ variable ... ] + o set [no|inv]variable[=value ] [ variable ... ] o set variable [variable ... ] @@ -4989,46 +5383,93 @@ 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. 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. @@ -5669,7 +6110,7 @@ Chapter 7. Reference Type: number - Default: 0 + Default: 1 Availability: debug @@ -7203,7 +7644,7 @@ Chapter 7. Reference Type: system property - Value: 474 + Value: 503 This is a read-only system property and specifies muttng's subversion revision string. @@ -7234,7 +7675,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 +7698,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,7 +7709,7 @@ 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 @@ -7271,7 +7724,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 +7735,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 +7750,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 +7762,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 +7785,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 +7808,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 +7825,7 @@ Chapter 7. Reference Example: set inews="/usr/local/bin/inews -hS" -169. nntp_load_description +170. nntp_load_description Type: boolean @@ -7383,7 +7836,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 +7848,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,7 +7861,7 @@ Chapter 7. Reference Note: Only change this setting if you know what you are doing. -172. nntp_newsrc +173. nntp_newsrc Type: path @@ -7425,7 +7878,7 @@ Chapter 7. Reference %s newsserver name -173. nntp_pass +174. nntp_pass Type: string @@ -7439,7 +7892,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 +7906,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 +7917,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 +7928,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 +7941,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 +7952,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 +7963,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 +7975,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 +7987,7 @@ Chapter 7. Reference It may, for example, look as: ``mutt-ng 1.5.9i (Linux)''. -182. pager +183. pager Type: path @@ -7550,7 +8003,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 +8014,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 +8024,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 +8041,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 +8050,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 +8063,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 @@ -7629,7 +8082,7 @@ Chapter 7. Reference Also note that using the old-style PGP message format is strongly deprecated. (PGP only) -189. pgp_check_exit +190. pgp_check_exit Type: boolean @@ -7639,7 +8092,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 @@ -7649,7 +8102,7 @@ Chapter 7. Reference Note that the use of this format is strongly deprecated. (PGP only) -191. pgp_decode_command +192. pgp_decode_command Type: string @@ -7687,7 +8140,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 +8148,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 +8156,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 +8164,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 +8212,7 @@ Chapter 7. Reference (PGP only) -196. pgp_export_command +197. pgp_export_command Type: string @@ -7768,7 +8221,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 +8230,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 +8241,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 +8251,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 +8260,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 +8272,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 +8284,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 +8293,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 @@ -7853,7 +8306,7 @@ Chapter 7. Reference Also note that using the old-style PGP message format is strongly deprecated. (PGP only) -205. pgp_replyinline +206. pgp_replyinline Type: boolean @@ -7874,7 +8327,7 @@ Chapter 7. Reference Also note that using the old-style PGP message format is strongly deprecated. (PGP only) -206. pgp_retainable_sigs +207. pgp_retainable_sigs Type: boolean @@ -7887,7 +8340,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 +8350,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 +8360,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 +8369,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 +8397,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 +8408,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 +8417,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 +8425,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 +8433,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 +8442,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 +8452,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 +8461,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 +8474,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 +8487,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 +8506,7 @@ Chapter 7. Reference Example: set pop_authenticators="digest-md5:apop:user" -221. pop_delete +222. pop_delete Type: quadoption @@ -8065,7 +8518,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 +8535,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 +8547,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 @@ -8105,7 +8558,7 @@ Chapter 7. Reference This variable configures how often (in seconds) POP should look for new mail. -225. pop_pass +226. pop_pass Type: string @@ -8120,7 +8573,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 @@ -8131,7 +8584,7 @@ Chapter 7. Reference Controls whether or not Mutt-ng will try to reconnect to a POP server when the connection is lost. -227. pop_user +228. pop_user Type: string @@ -8143,7 +8596,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 +8605,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,7 +8614,7 @@ 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 @@ -8172,7 +8625,7 @@ Chapter 7. Reference in the mailbox specified by this variable. Also see the ``$postpone'' variable. -231. preconnect +232. preconnect Type: string @@ -8192,7 +8645,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 +8654,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 +8662,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 +8675,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 +8690,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 +8701,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 +8711,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 +8722,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 +8731,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 +8741,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 +8754,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 +8770,7 @@ Chapter 7. Reference Also see the ``$write_inc'' variable. -243. read_only +244. read_only Type: boolean @@ -8325,7 +8778,7 @@ Chapter 7. Reference If set, all folders are opened in read-only mode. -244. realname +245. realname Type: string @@ -8339,7 +8792,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 +8804,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 +8818,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 +8828,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 +8838,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 +8852,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 +8862,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 +8883,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 +8897,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 +8908,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 +8930,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 +8940,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 +8953,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 +8968,7 @@ Chapter 7. Reference Also see the ``$force_name'' variable. -258. score +259. score Type: boolean @@ -8525,7 +8978,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 +8989,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 +8998,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 +9009,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 +9022,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 +9032,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 +9059,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 +9068,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 +9078,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 +9087,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 +9095,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 @@ -8683,7 +9136,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 +9152,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 +9161,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 +9169,7 @@ Chapter 7. Reference The width of the sidebar. -273. sig_dashes +274. sig_dashes Type: boolean @@ -8731,7 +9184,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,7 +9195,7 @@ 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 @@ -8752,7 +9205,7 @@ Chapter 7. Reference 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,7 +9218,7 @@ 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 @@ -8781,7 +9234,7 @@ Chapter 7. Reference ˜f joe | ˜s joe -278. sleep_time +279. sleep_time Type: number @@ -8792,7 +9245,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 +9255,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 +9264,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 +9274,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 +9283,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 +9296,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 +9339,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 +9350,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 +9360,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 +9368,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 +9379,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 +9388,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 +9398,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 +9408,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 +9417,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 +9433,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 +9446,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 +9455,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 +9464,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 +9474,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 +9483,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 +9492,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,7 +9501,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 +302. smtp_envelope Type: string @@ -9064,7 +9517,7 @@ Chapter 7. Reference 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 +303. smtp_host Type: string @@ -9076,7 +9529,7 @@ Chapter 7. Reference invoking the sendmail binary. Setting this variable overrides the value of ``$sendmail'', and any associated variables. -303. smtp_pass +304. smtp_pass Type: string @@ -9091,7 +9544,7 @@ Chapter 7. Reference since the superuser of your machine may read it regardless of the file's permissions. -304. smtp_port +305. smtp_port Type: number @@ -9105,7 +9558,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 +306. smtp_use_tls Type: string @@ -9119,7 +9572,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 +307. smtp_user Type: string @@ -9130,7 +9583,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 +308. sort Type: sort order @@ -9153,7 +9606,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 +309. sort_alias Type: sort order @@ -9167,7 +9620,7 @@ Chapter 7. Reference unsorted (leave in order specified in .muttrc) -309. sort_aux +310. sort_aux Type: sort order @@ -9190,7 +9643,7 @@ Chapter 7. Reference not the right thing to do, but kept to not break any existing configuration setting). -310. sort_browser +311. sort_browser Type: sort order @@ -9208,7 +9661,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 +312. sort_re Type: boolean @@ -9223,7 +9676,7 @@ Chapter 7. Reference whether or not this is the case, as long as the non-``$reply_regexp'' parts of both messages are identical. -312. spam_separator +313. spam_separator Type: string @@ -9234,7 +9687,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 +314. spoolfile Type: path @@ -9245,7 +9698,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 +315. ssl_ca_certificates_file Type: path @@ -9257,7 +9710,7 @@ Chapter 7. Reference Example: set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt -315. ssl_client_cert +316. ssl_client_cert Type: path @@ -9267,7 +9720,7 @@ Chapter 7. Reference The file containing a client certificate and its associated private key. -316. ssl_force_tls +317. ssl_force_tls Type: boolean @@ -9279,7 +9732,7 @@ Chapter 7. Reference otherwise have to abort the connection anyway. This option supersedes ``$ssl_starttls''. -317. ssl_min_dh_prime_bits +318. ssl_min_dh_prime_bits Type: number @@ -9291,7 +9744,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 +319. ssl_starttls Type: quadoption @@ -9303,7 +9756,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 +320. ssl_use_sslv2 Type: boolean @@ -9314,7 +9767,7 @@ Chapter 7. Reference This variables specifies whether to attempt to use SSLv2 in the SSL authentication process. -320. ssl_use_sslv3 +321. ssl_use_sslv3 Type: boolean @@ -9325,7 +9778,7 @@ Chapter 7. Reference This variables specifies whether to attempt to use SSLv3 in the SSL authentication process. -321. ssl_use_tlsv1 +322. ssl_use_tlsv1 Type: boolean @@ -9336,7 +9789,7 @@ Chapter 7. Reference This variables specifies whether to attempt to use TLSv1 in the SSL authentication process. -322. ssl_usesystemcerts +323. ssl_usesystemcerts Type: boolean @@ -9348,7 +9801,7 @@ Chapter 7. Reference certificate store when checking if server certificate is signed by a trusted CA. -323. status_chars +324. status_chars Type: string @@ -9365,7 +9818,7 @@ Chapter 7. Reference (Certain operations like composing a new mail, replying, forwarding, etc. are not permitted in this mode). -324. status_format +325. status_format Type: string @@ -9509,7 +9962,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 +326. status_on_top Type: boolean @@ -9518,7 +9971,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 +327. strict_mailto Type: boolean @@ -9533,7 +9986,7 @@ Chapter 7. Reference ``X-Mailto-'' and the message including headers will be shown in the editor regardless of what ``$edit_headers'' is set to. -327. strict_mime +328. strict_mime Type: boolean @@ -9548,7 +10001,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 +329. strict_threads Type: boolean @@ -9559,9 +10012,10 @@ 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 +330. strip_was Type: boolean @@ -9571,7 +10025,7 @@ Chapter 7. Reference 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 +331. strip_was_regex Type: regular expression @@ -9581,7 +10035,7 @@ Chapter 7. Reference part of the ``Subject'' line when replying if it won't be empty afterwards. -331. stuff_quoted +332. stuff_quoted Type: boolean @@ -9591,7 +10045,7 @@ Chapter 7. Reference ``stuffed'', i.e. a space will be inserted between the quote characters and the actual text. -332. suspend +333. suspend Type: boolean @@ -9601,7 +10055,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 +334. text_flowed Type: boolean @@ -9614,7 +10068,7 @@ Chapter 7. Reference Note that $indent_string is ignored when this option is set. -334. thorough_search +335. thorough_search Type: boolean @@ -9625,7 +10079,7 @@ Chapter 7. Reference searched are decoded before searching. If unset, messages are searched as they appear in the folder. -335. thread_received +336. thread_received Type: boolean @@ -9634,7 +10088,7 @@ Chapter 7. Reference When set, Mutt-ng uses the date received rather than the date sent to thread messages by subject. -336. tilde +337. tilde Type: boolean @@ -9643,7 +10097,7 @@ Chapter 7. Reference When set, the internal-pager will pad blank lines to the bottom of the screen with a tilde (˜). -337. timeout +338. timeout Type: number @@ -9653,7 +10107,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 +339. tmpdir Type: path @@ -9664,7 +10118,7 @@ Chapter 7. Reference not set, the environment variable $TMPDIR is used. If $TMPDIR is not set then "/tmp" is used. -339. to_chars +340. to_chars Type: string @@ -9681,7 +10135,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 +341. trash Type: path @@ -9694,7 +10148,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 +342. tunnel Type: string @@ -9709,7 +10163,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 +343. umask Type: number @@ -9718,7 +10172,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 +344. uncollapse_jump Type: boolean @@ -9727,7 +10181,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 +345. use_8bitmime Type: boolean @@ -9742,7 +10196,7 @@ Chapter 7. Reference flag when sending 8-bit messages to enable ESMTP negotiation or tell libESMTP to do so. -345. use_domain +346. use_domain Type: boolean @@ -9752,7 +10206,7 @@ Chapter 7. Reference portion) with the value of ``$hostname''. If unset, no addresses will be qualified. -346. use_from +347. use_from Type: boolean @@ -9762,7 +10216,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 +10229,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,7 +10239,7 @@ 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 @@ -9794,7 +10248,7 @@ Chapter 7. Reference 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 +10264,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 +10273,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 +10284,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 +10293,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 +10302,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 +10314,7 @@ Chapter 7. Reference Also see the ``$read_inc'' variable. -356. xterm_icon +357. xterm_icon Type: string @@ -9870,7 +10324,7 @@ 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 @@ -9886,7 +10340,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 +10350,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,308 +10374,381 @@ 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 + 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 + 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 + bounce-message b remail a message to another user + change-folder c open a different folder + change-folder-readonly ESC c open a different folder in read only + mode + check-traditional-pgp ESC P check for classic pgp + clear-flag W clear a status flag from a message + copy-message C copy a message to a file/mailbox + create-alias a create an alias from a message + senderdecode-copy ESC C decode a message and copy it + to a file/mailbox + decode-save ESC s decode a message and save it to a + file/mailbox + delete-message d delete the current entry + delete-pattern D delete messages matching a pattern + delete-subthread ESC d delete all messages in subthread + delete-thread ^D delete all messages in thread + display-address @ display full address of sender + display-toggle-weed h display message and toggle header + weeding + display-message RET display a message + edit e edit the current message + edit-type ^E edit the current message's + Content-Type + exit x exit without saving changes + extract-keys ^K extract PGP public keys + fetch-mail G retrieve mail from POP server + flag-message F toggle a message's 'important' flag + forget-passphrase ^F wipe PGP passphrase from memory + forward-message f forward a message with comments + group-reply g reply to all recipients + limit l show only messages matching a + patternlist-reply L reply to specified mailing + list + mail m compose a new mail message + mail-key ESC k mail a PGP public key + next-new not bound jump to the next new message + next-new-then-unread TAB jump to the next new or unread message + next-subthread ESC n jump to the next subthread + next-thread ^N jump to the next thread + next-undeleted j move to the next undeleted message + next-unread not bound jump to the next unread message + parent-message P jump to parent message in thread + pipe-message | pipe message/attachment to a shell + command + previous-new not bound jump to the previous new message + previous-new-then-unread + ESC TAB jump to the previous new or unread message + + previous-page Z move to the previous page + previous-subthread ESC p jump to previous subthread + previous-thread ^P jump to previous thread + previous-undeleted k move to the last undelete message + previous-unread not bound jump to the previous unread message + print-message p print the current entry + query Q query external program for addresses + quit q save changes to mailbox and quit + read-subthread ESC r mark the current subthread as read + read-thread ^R mark the current thread as read + recall-message R recall a postponed message + reply r reply to a message + resend-message ESC e resend message and preserve MIME + structure + save-message s save message/attachment to a file + set-flag w set a status flag on a message + show-version V show the Mutt-ng version number and + date + show-limit ESC l show currently active limit pattern, + if any + sort-mailbox o sort messages + sort-reverse O sort messages in reverse order + sync-mailbox $ save changes to mailbox + tag-pattern T tag messages matching a pattern + tag-thread ESC t tag/untag all messages in the + current thread + toggle-new N toggle a message's 'new' flag + toggle-write % toggle whether the mailbox will be + rewritten + undelete-message u undelete the current entry + undelete-pattern U undelete messages matching a pattern + undelete-subthread ESC u undelete all messages in subthread + undelete-thread ^U undelete all messages in thread + untag-pattern ^T untag messages matching a pattern + view-attachments v show MIME attachments + 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 + bottom not bound jump to the bottom of the message + bounce-message b remail a message to another user + change-folder c open a different folder + change-folder-readonly ESC c open a different folder in read only + mode + check-traditional-pgp ESC P check for classic pgp + copy-message C copy a message to a file/mailbox + create-alias a create an alias from a message + senderdecode-copy ESC C decode a message and copy it + to a file/mailbox + decode-save ESC s decode a message and save it to a + file/mailbox + delete-message d delete the current entry + delete-subthread ESC d delete all messages in subthread + delete-thread ^D delete all messages in thread + display-address @ display full address of sender + display-toggle-weed h display message and toggle header + weeding + edit e edit the current message + edit-type ^E edit the current message's + Content-Type + enter-command : enter a muttngrc command + exit i return to the main-menu + extract-keys ^K extract PGP public keys + flag-message F toggle a message's 'important' flag + forget-passphrase ^F wipe PGP passphrase from memory + forward-message f forward a message with comments + group-reply g reply to all recipients + half-up not bound move up one-half page + half-down not bound move down one-half page + help ? this screen + list-reply L reply to specified mailing list + mail m compose a new mail message + mail-key ESC k mail a PGP public key + mark-as-new N toggle a message's 'new' flag + next-line RET scroll down one line + next-entry J move to the next entry + next-new not bound jump to the next new message + next-new-then-unread TAB jump to the next new or unread message + next-page move to the next page + next-subthread ESC n jump to the next subthread + next-thread ^N jump to the next thread + next-undeleted j move to the next undeleted message + next-unread not bound jump to the next unread message + parent-message P jump to parent message in thread + pipe-message | pipe message/attachment to a shell + command + previous-line BackSpace scroll up one line + previous-entry K move to the previous entry + previous-new not bound jump to the previous new message + previous-new-then-unread + not bound jump to the previous new or unread message + previous-page - move to the previous page + previous-subthread ESC p jump to previous subthread + previous-thread ^P jump to previous thread + previous-undeleted k move to the last undelete message + previous-unread not bound jump to the previous unread message + print-message p print the current entry + quit Q save changes to mailbox and quit + read-subthread ESC r mark the current subthread as read + read-thread ^R mark the current thread as read + recall-message R recall a postponed message + redraw-screen ^L clear and redraw the screen + reply r reply to a message + save-message s save message/attachment to a file + search / search for a regular expression + search-next n search for next match + search-opposite not bound search for next match in opposite + direction + search-reverse ESC / search backwards for a regular + expression + search-toggle \ toggle search pattern coloring + shell-escape ! invoke a command in a subshell + show-version V show the Mutt-ng version number and + date + skip-quoted S skip beyond quoted text + sync-mailbox $ save changes to mailbox + tag-message t tag a message + toggle-quoted T toggle display of quoted text + top ^ jump to the top of the message + undelete-message u undelete the current entry + undelete-subthread ESC u undelete all messages in subthread + undelete-thread ^U undelete all messages in thread + view-attachments v show MIME attachments + 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 + search / search for a regular expression + search-next n search for next match + search-reverse ESC / 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 + create-alias a create an alias from a message + sendermail m compose a new mail message + query Q query external program for addresses + query-append A append new query results to current + results + search / search for a regular expression + search-next n search for next match + search-opposite not bound search for next match in opposite + direction + search-reverse ESC / search backwards for a regular + expression + 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 + bounce-message b remail a message to another user + collapse-parts v toggle display of subparts + delete-entry d delete the current entry + display-toggle-weed h display message and toggle header + weeding + edit-type ^E edit the current entry's + Content-Typeextract-keys ^K extract PGP public keys + forward-message f forward a message with comments + group-reply g reply to all recipients + list-reply L reply to specified mailing list + pipe-entry | pipe message/attachment to a shell + command + print-entry p print the current entry + reply r reply to a message + resend-message ESC e resend message and preserve MIME + structure + save-entry s save message/attachment to a file + undelete-entry u undelete the current entry + view-attach RET view attachment using mailcap entry + if necessary + view-mailcap m force viewing of attachment using + mailcap + view-text T view attachment as text + 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 + 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 + 5.8. postpone - delete-entry d delete the current entry - undelete-entry u undelete the current entry + delete-entry d delete the current entry + undelete-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) + 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) + 5.10. pgp - view-name % view the key's user id - verify-key c verify a PGP public key + 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 + 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 @@ -10234,41 +10761,787 @@ Chapter 8. Miscellany 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 , John Capo < jc@irbs.com > + 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 Carsten Schoelzki + o Elimar Riesebieter + +Index + + C + + Configuration Variables + + abort_noattach, abort_noattach + + abort_nosubject, abort_nosubject + + abort_unmodified, abort_unmodified + + agent_string, agent_string + + alias_file, alias_file + + alias_format, alias_format + + allow_8bit, allow_8bit + + allow_ansi, allow_ansi + + arrow_cursor, arrow_cursor + + ascii_chars, ascii_chars + + askbcc, askbcc + + askcc, askcc + + assumed_charset, assumed_charset + + attach_format, attach_format + + attach_remind_regexp, attach_remind_regexp + + attach_sep, attach_sep + + attach_split, attach_split + + attribution, attribution + + autoedit, autoedit + + auto_tag, auto_tag + + beep, beep + + beep_new, beep_new + + bounce, bounce + + bounce_delivered, bounce_delivered + + braille_friendly, braille_friendly + + certificate_file, certificate_file + + charset, charset + + check_new, check_new + + collapse_unread, collapse_unread + + compose_format, compose_format + + config_charset, config_charset + + confirmappend, confirmappend + + confirmcreate, confirmcreate + + connect_timeout, connect_timeout + + content_type, content_type + + copy, copy + + 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 + + date_format, date_format + + debug_level, debug_level + + default_hook, default_hook + + delete, delete + + delete_space, delete_space + + delete_untag, delete_untag + + digest_collapse, digest_collapse + + display_filter, display_filter + + dotlock_program, dotlock_program + + dsn_notify, dsn_notify + + dsn_return, dsn_return + + duplicate_threads, duplicate_threads + + editor, editor + + editor_headers, editor_headers + + edit_headers, edit_headers + + encode_from, encode_from + + entropy_file, entropy_file + + envelope_from, envelope_from + + escape, escape + + fast_reply, fast_reply + + fcc_attach, fcc_attach + + fcc_clear, fcc_clear + + file_charset, file_charset + + folder, folder + + folder_format, folder_format + + followup_to, followup_to + + force_buffy_check, force_buffy_check + + force_name, force_name + + forward_decode, forward_decode + + forward_decrypt, forward_decrypt + + forward_edit, forward_edit + + forward_format, forward_format + + forward_quote, forward_quote + + from, from + + gecos_mask, gecos_mask + + hdrs, hdrs + + header, header + + header_cache, header_cache + + header_cache_compress, header_cache_compress + + help, help + + 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 + + honor_followup_to, honor_followup_to + + hostname, hostname + + ignore_list_reply_to, ignore_list_reply_to + + 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, indent_string + + index_format, index_format + + ispell, ispell + + keep_flagged, keep_flagged + + list_reply, list_reply + + locale, locale + + mailcap_path, mailcap_path + + mailcap_sanitize, mailcap_sanitize + + maildir_header_cache_verify, maildir_header_cache_verify + + maildir_trash, maildir_trash + + mail_check, mail_check + + markers, markers + + mark_old, mark_old + + mask, mask + + max_display_recips, max_display_recips + + max_line_length, max_line_length + + mbox, mbox + + mbox_type, mbox_type + + menu_context, menu_context + + menu_move_off, menu_move_off + + menu_scroll, menu_scroll + + 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 + + mime_forward, mime_forward + + mime_forward_decode, mime_forward_decode + + mime_forward_rest, mime_forward_rest + + mixmaster, mixmaster + + mix_entry_format, mix_entry_format + + move, move + + 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 + + narrow_tree, narrow_tree + + net_inc, net_inc + + 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 + + operating_system, operating_system + + pager, pager + + pager_context, pager_context + + pager_format, pager_format + + pager_index_lines, pager_index_lines + + pager_stop, pager_stop + + 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, pipe_decode + + pipe_sep, pipe_sep + + pipe_split, pipe_split + + 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 + + postpone, postpone + + postponed, postponed + + post_indent_string, post_indent_string + + preconnect, preconnect + + print, print + + print_command, print_command + + print_decode, print_decode + + print_split, print_split + + prompt_after, prompt_after + + query_command, query_command + + quit, quit + + quote_empty, quote_empty + + quote_quoted, quote_quoted + + quote_regexp, quote_regexp + + read_inc, read_inc + + read_only, read_only + + realname, realname + + recall, recall + + record, record + + reply_regexp, reply_regexp + + reply_self, reply_self + + reply_to, reply_to + + resolve, resolve + + reverse_alias, reverse_alias + + reverse_name, reverse_name + + reverse_realname, reverse_realname + + rfc2047_parameters, rfc2047_parameters + + save_address, save_address + + save_empty, save_empty + + save_name, save_name + + score, score + + score_threshold_delete, score_threshold_delete + + score_threshold_flag, score_threshold_flag + + score_threshold_read, score_threshold_read + + sendmail, sendmail + + sendmail_wait, sendmail_wait + + send_charset, send_charset + + shell, shell + + 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, signature + + signoff_string, signoff_string + + sig_dashes, sig_dashes + + sig_on_top, sig_on_top + + simple_search, simple_search + + sleep_time, sleep_time + + smart_wrap, smart_wrap + + smileys, smileys + + 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_envelope + + smtp_host, smtp_host + + smtp_pass, smtp_pass + + smtp_port, smtp_port + + smtp_user, smtp_user + + smtp_use_tls, smtp_use_tls + + sort, sort + + sort_alias, sort_alias + + sort_aux, sort_aux + + sort_browser, sort_browser + + sort_re, sort_re + + spam_separator, spam_separator + + spoolfile, 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_chars, status_chars + + status_format, status_format + + status_on_top, status_on_top + + 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 + + suspend, suspend + + text_flowed, text_flowed + + thorough_search, thorough_search + + thread_received, thread_received + + tilde, tilde + + timeout, timeout + + tmpdir, tmpdir + + to_chars, to_chars + + trash, trash + + tunnel, tunnel + + umask, umask + + uncollapse_jump, uncollapse_jump + + use_8bitmime, use_8bitmime + + use_domain, use_domain + + use_from, use_from + + use_idn, use_idn + + use_ipv6, use_ipv6 + + visual, visual + + wait_key, wait_key + + weed, weed + + wrapmargin, wrapmargin + + wrap_search, wrap_search + + write_bcc, write_bcc + + write_inc, write_inc + + 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