X-Git-Url: http://git.madism.org/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fmanual.xml.head;h=5079bf705e3bbe774e44cda7c4608f3962551704;hb=22601f25ede6703ba7cd06ee84eddd2045308570;hp=021d40d3aaa9c78b229e2a537b844575f4a6ab7f;hpb=2b58e84853dc2c0df7079a348cdd24d26b24fa57;p=apps%2Fmadmutt.git
diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index 021d40d..5079bf7 100644
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -14,7 +14,7 @@
MichaelElkinsme@cs.hmc.edu
- version devel-r473
+ version @VERSION@
Michael Elinks on mutt, circa 1995:
@@ -62,7 +62,7 @@
Mutt-ng Home Page
- http://www.muttng.org
+
@@ -107,9 +107,7 @@
So far, there are no official releases of Mutt-ng, but you can
- download daily snapshots from http://mutt-ng.berlios.de/snapshots/
+ download daily snapshots from
@@ -169,7 +167,7 @@
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
- Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
@@ -189,12 +187,15 @@
in a typewriter font and both prefixed with a dollar sign as
it's common for UNIX-like environments. Configuration
variables are lower-case only while environment variables
- are upper-case only.
+ are upper-case only. is a configuration variable while
+ is an environment
+ variable.
- Muttng-specific commands are enclosed in
+ Muttng-specific functions are enclosed in
<> and printed in a typewriter font,
- too.
+ too, as in .As common for UNIX-like environments, references to
@@ -203,6 +204,17 @@
name="muttngrc" sect="5"/>. Execute man [section]
[name] to view the manual page.
+
+ Keys are presented in the following way: ordinary keys
+ are just given as-is, e.g.
+ q. Control characters are
+ prefixed with C- (e.g. the screen can be
+ redraw by pressing L) and E- for
+ Escape, e.g. a folder can be opened read-only with
+ c.
+
+
@@ -690,8 +702,8 @@
-
- Default Menu Movement Keys
+
+ Most commonly used movement bindings
@@ -702,42 +714,42 @@
- j or Down
+ j or Downmove to the next entry
- k or Up
+ k or Upmove to the previous entry
- z or PageDn
+ z or PageDngo to the next page
- Z or PageUp
+ Z or PageUpgo to the previous page
- = or Home
+ = or Homejump to the first entry
- * or End
+ * or Endjump to the last entry
- q
+ qexit the current menu
- ?
+ ?list all key bindings for the current menu
@@ -768,8 +780,8 @@
-
- Built-In Editor Functions
+
+ Line Editor Functions
@@ -780,113 +792,113 @@
- ^A or <Home>
+ A or Homemove to the start of the line
- ^B or <Left>
+ B or Leftmove back one char
- Esc B
+ Bmove back one word
- ^D or <Delete>
+ D or Deletedelete the char under the cursor
- ^E or <End>
+ E or Endmove to the end of the line
- ^F or <Right>
+ F or Rightmove forward one char
- Esc F
+ Fmove forward one word
- <Tab>
+ Tabcomplete filename or alias
- ^T
+ Tcomplete address with query
- ^K
+ Kdelete to the end of the line
- ESC d
+ ddelete to the end of the word
- ^W
+ Wkill the word in front of the cursor
- ^U
+ Udelete entire line
- ^V
+ Vquote the next typed key
- <Up>
+ Uprecall previous string from history
- <Down>
+ Downrecall next string from history
- <BackSpace>
+ BackSpacekill the char in front of the cursor
- Esc u
+ uconvert word to upper case
- Esc l
+ lconvert word to lower case
- Esc c
+ ccapitalize the word
- ^G
- n/a
+ G
+ abort
- <Return>
- n/a
+ Return
+ finish editing
@@ -897,7 +909,7 @@
You can remap the editor functions using the
- command. For example, to make
+ command. For example, to make
the Delete key delete the character in front
of the cursor rather than under, you could use
@@ -906,10 +918,6 @@
bind editor <delete> backspace
-
-
-
-
@@ -934,8 +942,8 @@
-
- Default Index Menu Bindings
+
+ Most commonly used Index Bindings
@@ -946,147 +954,147 @@
- c
+ cchange to a different mailbox
- ESC c
+ cchange to a folder in read-only mode
- C
+ Ccopy the current message to another mailbox
- ESC C
+ Cdecode a message and copy it to a folder
- ESC s
+ sdecode a message and save it to a folder
- D
+ Ddelete messages matching a pattern
- d
+ ddelete the current message
- F
+ Fmark as important
- l
+ lshow messages matching a pattern
- N
+ Nmark message as new
- o
+ ochange the current sort method
- O
+ Oreverse sort the mailbox
- q
+ qsave changes and exit
- s
+ ssave-message
- T
+ Ttag messages matching a pattern
- t
+ ttoggle the tag on a message
- ESC t
+ ttoggle tag on entire message thread
- U
+ Uundelete messages matching a pattern
- u
+ uundelete-message
- v
+ vview-attachments
- x
+ xabort changes and exit
- <Return>
+ Returndisplay-message
- <Tab>
+ Tabjump to the next new or unread message
- @
+ @show the author's full e-mail address
- $
+ $save changes to mailbox
- /
+ /search
- ESC /
+ /search-reverse
- ^L
+ Lclear and redraw the screen
- ^T
+ Tuntag messages matching a pattern
@@ -1228,7 +1236,7 @@
Furthermore, the following flags reflect who the message is
addressed
to. They can be customized with the
- variable.
+ variable.
@@ -1293,8 +1301,8 @@
-
- Default Pager Menu Bindings
+
+ Most commonly used Pager Bindings
@@ -1305,57 +1313,57 @@
- <Return>
+ Returngo down one line
- <Space>
+ Spacedisplay the next page (or next message if at the end of a message)
- -
+ -go back to the previous page
- n
+ nsearch for next match
- S
+ Sskip beyond quoted text
- T
+ Ttoggle 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
@@ -1376,18 +1384,17 @@
- Also, the internal pager supports a couple other advanced features.
- For
- one, it will accept and translate the ``standard'' nroff sequences
- forbold and underline. These sequences are a series of either the
- letter,
- backspace (^H), the letter again for bold or the letter,
- backspace,
- ``_'' for denoting underline. Mutt-ng will attempt to display
- these
- in bold and underline respectively if your terminal supports them. If
- not, you can use the bold and underline
- objects to specify a color or mono attribute for them.
+ Also, the internal pager supports a couple other advanced
+ features. For one, it will accept and translate the
+ ``standard'' nroff sequences forbold and underline. These
+ sequences are a series of either the letter, backspace
+ (H), the letter again for bold
+ or the letter, backspace, _ for denoting
+ underline. Mutt-ng will attempt to display these in bold and
+ underline respectively if your terminal supports them. If not,
+ you can use the bold and underline objects to specify a color or mono attribute
+ for them.
@@ -1401,7 +1408,7 @@
-
+
ANSI Escape Sequences
@@ -1444,7 +1451,7 @@
-
+
ANSI Colors
@@ -1496,7 +1503,7 @@
Mutt-ng uses these attributes for handling text/enriched messages,
and they
- can also be used by an external autoview
+ can also be used by an external
script for highlighting purposes. Note: If you change the colors for your
display, for example by changing the color associated with color2 for
your xterm, then that color will be used instead of green.
@@ -1520,8 +1527,8 @@
-
- Default Thread Function Bindings
+
+ Most commonly used thread-related bindings
@@ -1532,72 +1539,72 @@
- ^D
+ Ddelete all messages in the current thread
- ^U
+ Uundelete all messages in the current thread
- ^N
+ Njump to the start of the next thread
- ^P
+ Pjump to the start of the previous thread
- ^R
+ Rmark the current thread as read
- ESC d
+ ddelete all messages in the current subthread
- ESC u
+ uundelete all messages in the current subthread
- ESC n
+ njump to the start of the next subthread
- ESC p
+ pjump to the start of the previous subthread
- ESC r
+ rmark the current subthread as read
- ESC t
+ ttoggle the tag on the current thread
- ESC v
+ vtoggle collapse for the current thread
- ESC V
+ Vtoggle collapse for all threads
- P
+ Pjump to parent message in thread
@@ -1614,18 +1621,18 @@
in the thread and hides the others. This is useful when threads
contain so many messages that you can only see a handful of threads
onthe screen. See %M in
- .
+ .
For example, you could use
- %?M?(#%03M)&(%4l)? in
+ %?M?(#%03M)&(%4l)? in
to optionally
display the number of hidden messages if the thread is collapsed.
- See also the variable.
+ See also the variable.
@@ -1634,23 +1641,21 @@
Miscellaneous Functions
-
+ a
Creates a new alias based upon the current message (or prompts for a
- new one). Once editing is complete, an
- command is added to the file specified by the
+ new one). Once editing is complete, an
+ command is added to the file specified by the
variable for future use. Note:
- Specifying an
- does not add the aliases specified there-in, you must also
- source
-
+ Specifying an
+ does not add the aliases specified there-in, you must also
the file.
-
+ P
@@ -1664,18 +1669,16 @@
-
+ h
- Toggles the weeding of message header fields specified by
- ignore
-
+ Toggles the weeding of message header fields specified by
commands.
-
+ e
@@ -1688,8 +1691,8 @@
- (default: ^E on the attachment menu, and in the pager and index
- menus; ^T on the compose menu)
+ (default: E on the attachment menu, and in the pager and index
+ menus; T on the compose menu)
@@ -1703,15 +1706,13 @@
- Note that this command is also available on the
- compose-menu
-
+ 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.
-
+ :
@@ -1719,13 +1720,13 @@
a
configuration file. A common use is to check the settings of
variables, or
- in conjunction with macro to change
+ in conjunction with to change
settings on the
fly.
-
+ K
@@ -1734,7 +1735,7 @@
-
+ F
@@ -1743,18 +1744,16 @@
-
+ L
Reply to the current or tagged message(s) by extracting any addresses
which
- match the regular expressions given by the
- lists
-
+ match the regular expressions given by the
commands, but also honor any Mail-Followup-To
header(s) if the
-
+
configuration variable is set. Using this when replying to messages
posted
to mailing lists helps avoid duplicate copies being sent to the
@@ -1769,15 +1768,15 @@
Asks for an external Unix command and pipes the current or
tagged message(s) to it. The variables
- ,
- ,
- and
-
+ ,
+ ,
+ and
+
control the exact behavior of this function.
-
+ e
@@ -1800,12 +1799,12 @@
-
+ !
Asks for an external Unix command and executes it. The
-
+
can be used to control
whether Mutt-ng will wait for a key to be pressed when the command
returns
@@ -1814,12 +1813,12 @@
-
+ T
The pager uses the
-
+
variable to detect quoted text when
displaying the body of the message. This function toggles the
displayof the quoted material in the message. It is particularly
@@ -1829,7 +1828,7 @@
-
+ S
@@ -1857,8 +1856,8 @@
-
- Default Mail Composition Bindings
+
+ Most commonly used Mail Composition Bindings
@@ -1869,37 +1868,37 @@
- m
+ mcompose a new message
- r
+ rreply to sender
- g
+ greply to all recipients
- L
+ Lreply to mailing list address
- f
+ fforward message
- b
+ bbounce (remail) message
- ESC k
+ kmail a PGP public key to someone
@@ -1913,25 +1912,22 @@
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
-
- .
+ in greater detail in the next chapter forwarding-mail.
Composing new messages
- When you want to send an email using mutt-ng, simply press m on
+ When you want to send an email using mutt-ng, simply press m on
your keyboard. Then, mutt-ng asks for the recipient via a prompt in
the last line:
-
-To:
+
+To:
@@ -1953,10 +1949,10 @@ To:
-
+
set editor = "vim +/^$/ -c ':set tw=72'"
set editor = "nano"
-set editor = "emacs"
+set editor = "emacs"
@@ -1993,13 +1989,13 @@ set editor = "emacs"
- At this point, you can add more attachments, pressing a, you
- can edit the recipient addresses, pressing t for
+ At this point, you can add more attachments, pressing a, you
+ can edit the recipient addresses, pressing t for
the "To:" field,
- c for the "Cc:" field, and b
+ c for the "Cc:" field, and b
for the "Bcc: field. You can
- also edit the subject the subject by simply pressing s or the
- email message that you've entered before by pressing e. You will
+ also edit the subject the subject by simply pressing s or the
+ email message that you've entered before by pressing e. You will
then again return to the editor. You can even edit the sender, by
pressing
<esc>f, but this shall only be used with
@@ -2014,8 +2010,8 @@ set editor = "emacs"
-
-set edit_headers
+
+set edit_headers
@@ -2027,8 +2023,8 @@ set edit_headers
-
- Default Compose Menu Bindings
+
+ Most commonly used Compose Menu Bindings
@@ -2039,102 +2035,102 @@ set edit_headers
- a
+ aattach a file
- A
+ Aattach message(s) to the message
- ESC k
+ kattach a PGP public key
- d
+ dedit description on attachment
- D
+ Ddetach a file
- t
+ tedit the To field
- ESC f
+ fedit the From field
- r
+ redit the Reply-To field
- c
+ cedit the Cc field
- b
+ bedit the Bcc field
- y
+ ysend the message
- s
+ sedit the Subject
- S
+ Sselect S/MIME options
- f
+ fspecify an ``Fcc'' mailbox
- p
+ pselect PGP options
- P
+ Ppostpone this message until later
- q
+ qquit (abort) sending the message
- w
+ wwrite the message to a folder
- i
+ icheck spelling (if available on your system)
- ^F
+ Fwipe passphrase(s) from memory
@@ -2152,7 +2148,7 @@ set edit_headers
certainoperations like composing a new mail, replying, forwarding,
etc. are
not permitted when you are in that folder. The %r
- in
+ in
will change to
a 'A' to indicate that you are in attach-message mode.
@@ -2171,7 +2167,7 @@ set edit_headers
When you want to reply to an email message, select it in the index
- menu and then press r. Mutt-ng's behaviour is
+ menu and then press r. Mutt-ng's behaviour is
then similar to the
behaviour when you compose a message: first, you will be asked for
the recipient, then for the subject, and then, mutt-ng will start
@@ -2181,12 +2177,12 @@ set edit_headers
-
+
On Mon, Mar 07, 2005 at 05:02:12PM +0100, Michael Svensson wrote:
> 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.
+> project will go live.
@@ -2203,28 +2199,28 @@ On Mon, Mar 07, 2005 at 05:02:12PM +0100, Michael Svensson wrote:
The quote attribution is configurable, by default it is set to
-
-set attribution = "On %d, %n wrote:"
+
+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)]:"
+
+set attribution = "attribution="* %n <%a> [%(%y-%m-%d %H:%M)]:"
The example above results in the following attribution:
-
+
* Michael Svensson <svensson@foobar.com> [05-03-06 17:02]:
> 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.
+> project will go live.
@@ -2256,8 +2252,8 @@ set attribution = "attribution="* %n <%a> [%(%y-%m-%d %H:%M)]:"
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
- functionalityensures that when you press g
- instead of r to do a 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.
@@ -2280,7 +2276,7 @@ set attribution = "attribution="* %n <%a> [%(%y-%m-%d %H:%M)]:"
- To do a list reply, simply press L. If the email
+ To do a list reply, simply press L. If the email
contains
a Mail-Followup-To: header, its value will be
used as reply
@@ -2293,8 +2289,8 @@ set attribution = "attribution="* %n <%a> [%(%y-%m-%d %H:%M)]:"
-
-lists linuxevent@luga\.at vuln-dev@ mutt-ng-users@
+
+lists linuxevent@luga\.at vuln-dev@ mutt-ng-users@
@@ -2339,8 +2335,8 @@ lists linuxevent@luga\.at vuln-dev@ mutt-ng-users@
You can also attach files to your message by specifying
-
-Attach: filename [description]
+
+Attach: filename [description]
where filename is the file to attach and
description
@@ -2356,8 +2352,8 @@ Attach: filename [description]
- Also see the and
- variables
+ Also see the and
+ variables
@@ -2372,12 +2368,12 @@ Attach: filename [description]
If you want to use PGP, you can specify
-
-Pgp: [E | S | S id]
+
+Pgp: [E | S | S id]
``E'' encrypts, ``S'' signs and
``S<id>'' signs with the given key, setting
-
+
permanently.
@@ -2395,7 +2391,7 @@ Pgp: [E | S | S id]
In these cases, you are dropped into a menu with a list of keys from
which you can select one. When you quit this menu, or mutt can't
find any matching keys, you are prompted for a user ID. You can, as
- usually, abort this prompt using ^G. When
+ usually, abort this prompt using G. When
you do so, mutt will
return to the compose screen.
@@ -2407,7 +2403,7 @@ Pgp: [E | S | S id]
Most fields of the entries in the key selection menu (see also
- )
+ )
have obvious meanings. But some explanations on the capabilities,
flags,
and validity fields are in order.
@@ -2418,7 +2414,7 @@ Pgp: [E | S | S id]
flags:
-
+
PGP Key Menu Flags
@@ -2528,7 +2524,7 @@ Pgp: [E | S | S id]
and
chain-next functions, which are by default bound
to the left
- and right arrows and to the h and l keys (think vi
+ 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
@@ -2547,7 +2543,7 @@ Pgp: [E | S | S id]
Note that different remailers do have different capabilities,
indicated in the %c entry of the remailer menu lines (see
- ).
+ ).
Most important is
the ``middleman'' capability, indicated by a capital ``M'': This
means that the remailer in question cannot be used as the final
@@ -2579,7 +2575,7 @@ Pgp: [E | S | S id]
The first one is regular forwarding, as you probably know it from
- other mail clients. You simply press f, enter the
+ other mail clients. You simply press f, enter the
recipient
email address, the subject of the forwarded email, and then you can
edit the message to be forwarded in the editor. The forwarded
@@ -2589,18 +2585,18 @@ Pgp: [E | S | S id]
-
------ Forwarded message from Lucas User <luser@example.com> -----
+
+----- Forwarded message from Lucas User <luser@example.com> -----
-From: Lucas User <luser@example.com>
+From: Lucas User <luser@example.com>
Date: Thu, 02 Dec 2004 03:08:34 +0100
-To: Michael Random <mrandom@example.com>
+To: Michael Random <mrandom@example.com>
Subject: Re: blackmail
Pay me EUR 50,000.- cash or your favorite stuffed animal will die
a horrible death.
------ End forwarded message -----
+----- End forwarded message -----
@@ -2616,7 +2612,7 @@ a horrible death.
another
address, it will be sent in practically the same format you send it
(except for headers that are created during transporting the
- message). To bounce a message, press b and enter the
+ message). To bounce a message, press b and enter the
recipient
email address. By default, you are then asked whether you really
want to bounce the message to the specified recipient. If you answer
@@ -2741,15 +2737,12 @@ a horrible death.
Basic Syntax of Initialization Files
- An initialization file consists of a series of
- commands
-
- .Each line of the file may contain one or more commands.
+ 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
(;).
-
-set realname='Mutt-ng user' ; ignore x-
+
+set realname='Mutt-ng user' ; ignore x-
The hash mark, or pound sign
(``#''), is used as a ``comment'' character. You can use it to
@@ -2759,8 +2752,8 @@ set realname='Mutt-ng user' ; ignore x-
-
-my_hdr X-Disclaimer: Why are you listening to me? # This is a comment
+
+my_hdr X-Disclaimer: Why are you listening to me? # This is a comment
@@ -2790,8 +2783,8 @@ my_hdr X-Disclaimer: Why are you listening to me? # This is a comment
interpreted
character.
-
-set realname="Michael \"MuttDude\" Elkins"
+
+set realname="Michael \"MuttDude\" Elkins"
@@ -2817,9 +2810,9 @@ set realname="Michael \"MuttDude\" Elkins"
-
+
# folder-hook . \
-set realname="Michael \"MuttDude\" Elkins"
+set realname="Michael \"MuttDude\" Elkins"
@@ -2841,12 +2834,12 @@ set realname="Michael \"MuttDude\" Elkins"
-
+
line1\
line2a # line2b\
line3\
line4
-line5
+line5
@@ -2887,8 +2880,8 @@ line5
-
-my_hdr X-Operating-System: `uname -a`
+
+my_hdr X-Operating-System: `uname -a`
@@ -2912,8 +2905,8 @@ my_hdr X-Operating-System: `uname -a`
-
-set record=+sent_on_$HOSTNAME
+
+set record=+sent_on_$HOSTNAME
@@ -2942,13 +2935,13 @@ set record=+sent_on_$HOSTNAME
-
-set imap_home_namespace = $folder
+
+set imap_home_namespace = $folder
- would set the value of
+ would set the value of
to the value to which
is currently set to.
@@ -2956,7 +2949,7 @@ set imap_home_namespace = $folder
Note: There're no logical links
established in such cases so
- that the the value for
+ that the the value for
won't change even
if gets changed.
@@ -2989,9 +2982,9 @@ set imap_home_namespace = $folder
-
+
macro generic <F1> "!less -r /path/to/manual" "Show manual"
-macro pager <F1> "!less -r /path/to/manual" "Show manual"
+macro pager <F1> "!less -r /path/to/manual" "Show manual"
@@ -3005,11 +2998,11 @@ macro pager <F1> "!less -r /path/to/manual" "Show manual"
-
+
set user_manualcmd = "!less -r /path/to_manual"
macro generic <F1> "$user_manualcmd<enter>" "Show manual"
macro pager <F1> "$user_manualcmd<enter>" "Show manual"
-macro index <F1> "$user_manualcmd<enter>" "Show manual"
+macro index <F1> "$user_manualcmd<enter>" "Show manual"
@@ -3019,8 +3012,8 @@ macro index <F1> "$user_manualcmd<enter>" "Show manual"
-
-macro index <F2> "$user_manualcmd | grep '\^[ ]\\+~. '" "Show Patterns"
+
+macro index <F2> "$user_manualcmd | grep '\^[ ]\\+~. '" "Show Patterns"
@@ -3048,9 +3041,9 @@ macro index <F2> "$user_manualcmd | grep '\^[ ]\\+~. '" "Show Patterns"
-
+
set user_foo = 42
-set user_foo = 666
+set user_foo = 666
@@ -3062,8 +3055,8 @@ set user_foo = 666
-
-set ?user_foo
+
+set ?user_foo
@@ -3073,8 +3066,8 @@ set ?user_foo
-
-reset user_foo
+
+reset user_foo
@@ -3085,8 +3078,8 @@ reset user_foo
-
-unset user_foo
+
+unset user_foo
@@ -3120,8 +3113,8 @@ unset user_foo
-
-muttng -Q muttng_docdir
+
+$ muttng -Q muttng_docdir
@@ -3133,8 +3126,8 @@ muttng -Q muttng_docdir
-
-set user_manualcmd = '!less -r /path/to_manual'
+
+set user_manualcmd = '!less -r /path/to_manual'
@@ -3144,8 +3137,8 @@ set user_manualcmd = '!less -r /path/to_manual'
-
-set user_manualcmd = "!less -r $muttng_docdir/manual.txt"
+
+set user_manualcmd = "!less -r $muttng_docdir/manual.txt"
@@ -3166,8 +3159,8 @@ set user_manualcmd = "!less -r $muttng_docdir/manual.txt"
-
-folder-hook . "set user_current_folder = $muttng_folder_name"
+
+folder-hook . "set user_current_folder = $muttng_folder_name"
@@ -3178,8 +3171,8 @@ folder-hook . "set user_current_folder = $muttng_folder_name"
-
-folder-hook . "set user_current_folder = some_folder"
+
+folder-hook . "set user_current_folder = some_folder"
@@ -3191,8 +3184,8 @@ folder-hook . "set user_current_folder = some_folder"
-
-folder-hook . 'set user_current_folder = $muttng_folder_name'
+
+folder-hook . 'set user_current_folder = $muttng_folder_name'
@@ -3209,8 +3202,8 @@ folder-hook . 'set user_current_folder = $muttng_folder_name'
-
-folder-hook . 'source ~/.mutt/score-$muttng_folder_name'
+
+folder-hook . 'source ~/.mutt/score-$muttng_folder_name'
@@ -3235,12 +3228,12 @@ folder-hook . 'source ~/.mutt/score-$muttng_folder_name'
-
+
set read_inc = 100
set folder = $read_inc
set read_inc = $folder
set user_magic_number = 42
-set folder = $user_magic_number
+set folder = $user_magic_number
@@ -3248,13 +3241,13 @@ set folder = $user_magic_number
-
+ Defining/Using aliases
-
+
-
-Usage: aliaskeyaddress [, address,...]
-
+
+ key address [, address,...]
+
@@ -3277,14 +3270,16 @@ Usage: aliaskeyaddress
- unalias [* | key...]
+
+ [* | key ... ]
+
-
+
alias muttdude me@cs.hmc.edu (Michael Elkins)
-alias theguys manny, moe, jack
+alias theguys manny, moe, jack
@@ -3292,25 +3287,21 @@ alias theguys manny, moe, jack
Unlike other mailers, Mutt-ng doesn't require aliases to be defined
in a special file. The alias command can appear
anywhere in
- a configuration file, as long as this file is
- source
-
- .Consequently, you can have multiple alias files, or
+ a configuration file, as long as this file is .
+ Consequently, you can have multiple alias files, or
you can have all aliases defined in your muttrc.
On the other hand, the
function can use only one file, the one pointed to by the
-
+
variable (which is
~/.muttrc by default). This file is not
special either,
in the sense that Mutt-ng will happily append aliases to any file, but
in
- order for the new aliases to take effect you need to explicitly
- source
-
+ order for the new aliases to take effect you need to explicitly
this file too.
@@ -3320,10 +3311,10 @@ alias theguys manny, moe, jack
-
+
source /usr/local/share/Mutt-ng.aliases
source ~/.mail_aliases
-set alias_file=~/.mail_aliases
+set alias_file=~/.mail_aliases
@@ -3335,7 +3326,7 @@ set alias_file=~/.mail_aliases
prompt. You can
also enter aliases in your editor at the appropriate headers if you
have the
-
+
variable set.
@@ -3366,13 +3357,13 @@ set alias_file=~/.mail_aliases
-
+ Changing the default key bindings
-
-Usage: bindmapkeyfunction
-
+
+ map key function
+
@@ -3522,7 +3513,7 @@ Usage: bindmapkey
-
- Default Sidebar Function Bindings
-
-
-
- Key
- Function
- Description
-
-
-
-
- none
-
- Scrolls the mailbox list up 1 page
-
-
- none
-
- Scrolls the mailbox list down 1 page
-
-
- none
-
- Highlights the next mailbox
-
-
- none
-
- Highlights the next mailbox with new mail
-
-
- none
-
- Highlights the previous mailbox
-
-
- none
-
- Opens the currently highlighted mailbox
-
-
-
-
-
-
-
Reasonable key bindings look e.g. like this:
-
+
bind index \Cp sidebar-prev
bind index \Cn sidebar-next
bind index \Cb sidebar-open
@@ -7124,7 +7038,7 @@ bind pager \Cn sidebar-next
bind pager \Cb sidebar-open
macro index B ':toggle sidebar_visible^M'
-macro pager B ':toggle sidebar_visible^M'
+macro pager B ':toggle sidebar_visible^M'
@@ -7147,15 +7061,15 @@ macro pager B ':toggle sidebar_visible^M'
LDAP,
ph/qi, bbdb, or NIS through a wrapper script which connects to mutt
using a simple interface. Using the
-
+
variable, you specify the wrapper
command to use. For example:
-
-set query_command = "mutt_ldap_query.pl '%s'"
+
+set query_command = "mutt_ldap_query.pl '%s'"
@@ -7219,7 +7133,7 @@ roessler@guug.de Thomas Roessler mutt pgp
mbox, MMDF, MH and Maildir. The mailbox type is autodetected, so there
is no need to use a flag for different mailbox types. When creating
newmailboxes, Mutt-ng uses the default specified with the
-
+
variable.
@@ -7232,8 +7146,8 @@ roessler@guug.de Thomas Roessler mutt pgp
-
-From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
+
+From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
@@ -7309,20 +7223,20 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
- ! -- refers to your
+ ! -- refers to your
(incoming) mailbox
- > -- refers to your file
+ > -- refers to your file
- < -- refers to your file
+ < -- refers to your file
@@ -7346,7 +7260,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
- = or + -- refers to your
+ = or + -- refers to your
directory
@@ -7377,7 +7291,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
know what addresses you consider to be mailing lists (technically
this does not have to be a mailing list, but that is what it is most
often used for), and what lists you are subscribed to. This is
- accomplished through the use of the lists
+ accomplished through the use of the
commands in your muttrc.
@@ -7387,9 +7301,8 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
through which you received a message (i.e., of a subscribed list) in
the index menu display. This is useful to
distinguish between
- personal and list mail in the same mailbox. In the
- index-format
-
+ personal and list mail in the same mailbox. In the
+
variable, the escape ``%L''
will return the string ``To <list>'' when ``list'' appears in the
``To'' field, and ``Cc <list>'' when it appears in the ``Cc''
@@ -7412,9 +7325,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
Mutt-ng also supports the Mail-Followup-To header.
When you send
a message to a list of recipients which includes one or several
- subscribed mailing lists, and if the
- followup-to
-
+ subscribed mailing lists, and if the
option is set, mutt will generate
a Mail-Followup-To header which contains all the recipients to whom
you send this message, but not your address. This indicates that
@@ -7428,7 +7339,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
Conversely, when group-replying or list-replying to a message which
has a Mail-Followup-To header, mutt will respect
this header if
- the
+ the
configuration
variable is set. Using list-reply will in this case also make sure
that the reply goes to the mailing list, even if it's not specified
@@ -7448,7 +7359,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
than the author of the message. This can create problems when trying
to reply directly to the author in private, since most mail clients
will automatically reply to the address given in the ``Reply-To''
- field. Mutt-ng uses the
+ field. Mutt-ng uses the
variable to help decide which address to use. If set to
ask-yes
@@ -7464,7 +7375,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
The ``X-Label:'' header field can be used to further identify mailing
lists or list subject matter (or just to annotate messages
- individually). The
+ individually). The
variable's ``%y'' and
``%Y'' escapes can be used to expand ``X-Label:'' fields in the
index, and Mutt-ng's pattern-matcher can match regular expressions to
@@ -7556,7 +7467,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
Delivery Status Notification (DSN) Support
- RFC1894 defines a set of MIME content types for relaying information
+ defines a set of MIME content types for relaying information
about the status of electronic mail messages. These can be thought of
as
``return receipts.''
@@ -7599,7 +7510,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
- is used
+ is used
to request receipts for different results (such as failed
message,message delivered, etc.).
@@ -7608,7 +7519,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
- requests
+ requests
how much of your message should be returned with the receipt
(headers or full message).
@@ -7663,7 +7574,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
reason the frequency at which Mutt-ng will check for mail remotely can
be
controlled by the
-
+
variable, which defaults to every 60 seconds.
@@ -7681,11 +7592,10 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
Another way to access your POP3 mail is the fetch-mail function
- (default: G). It allows to connect to
- pop-host
-
+ (default: G). It allows to connect to pop-host
,fetch all your new mail and place it in the
- local . After this
+ local . After this
point, Mutt-ng runs exactly as if the mail had always been local.
@@ -7706,34 +7616,48 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
IMAP Support (OPTIONAL)
- If Mutt-ng was compiled with IMAP support (by running the
- configure
-
- script with the --enable-imap flag), it has the
- ability to work
- with folders located on a remote IMAP server.
+ If Mutt-ng was compiled with IMAP support (by running the
+ configure script with the
+ --enable-imap flag), it has the
+ ability to work with folders located on a remote IMAP server.
- You can access the remote inbox by selecting the folder
- imap://imapserver/INBOX, where imapserver is the name of the
- IMAP server and INBOX is the special name for your
- spool mailbox on
- the IMAP server. If you want to access another mail folder at the IMAP
- server, you should use imap://imapserver/path/to/folder where
- path/to/folder is the path of the folder you want to
- access.
+ You can access the remote inbox by selecting the folder via its
+ URL:
-
+
- You can select an alternative port by specifying it with the server,
- i.e.:
- imap://imapserver:port/INBOX.
+
+imap://imapserver/INBOX
+
+
+
+ where imapserver is the name of the IMAP
+ server and INBOX is the special name for your
+ spool mailbox on the IMAP server. If you want to access another
+ mail folder at the IMAP server, you should use
+
+
+
+
+imap://imapserver/path/to/folder
+
+
+
+ where path/to/folder is the path
+ of the folder you want to access. You can select an alternative
+ port by specifying it with the server, i.e.:
+
+
+
+
+imap://imapserver:port/INBOX
- You can also specify different username for each folder, i.e.:
- imap://username@imapserver[:port]/INBOX.
+ You can also specify different username for each folder by
+ prenpending your username and an @ symbol to the server's name.
@@ -7743,14 +7667,9 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
script with the --with-ssl flag), connections to
IMAP servers
can be encrypted. This naturally requires that the server supports
- SSL encrypted connections. To access a folder with IMAP/SSL, you should
- use imaps://[username@]imapserver[:port]/path/to/folder as your
- folder path.
-
-
-
- Pine-compatible notation is also supported, i.e.
- {[username@]imapserver[:port][/ssl]}path/to/folder
+ SSL encrypted connections. To access a folder with IMAP/SSL, you only
+ need to substitute the initial imap:// by
+ imaps:// in the above examples.
@@ -7764,7 +7683,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
When browsing folders on an IMAP server, you can toggle whether to look
at only the folders you are subscribed to, or all folders with the
toggle-subscribed command. See also the
-
+
variable.
@@ -7772,9 +7691,9 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
Polling for new mail on an IMAP server can cause noticeable delays. So,
you'll
want to carefully tune the
-
+
and
-
+
variables.
@@ -7882,7 +7801,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
- - controls
+ - controls
the username under which you request authentication on the IMAP
server,
for all authenticators. This is overridden by an explicit
@@ -7894,7 +7813,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
- - a
+ - a
password which you may preset, used by all authentication
methods where
a password is needed.
@@ -7903,7 +7822,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
-
+
- a colon-delimited list of IMAP
authentication methods to try, in the order you wish to try
them. If
@@ -7932,7 +7851,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
If compiled with ``--enable-nntp'' option, Mutt-ng can read news from
a newsserver via NNTP. You can open a newsgroup with the
``change-newsgroup'' function from the index/pager which is by default
- bound to i.
+ bound to i.
@@ -7940,7 +7859,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
environment variable. Like other
news readers,
info about subscribed newsgroups is saved in a file as specified by the
- variable.
+ variable.
Article headers are cached and can be loaded from a file when a
newsgroup is entered instead loading from newsserver; currently, this
caching mechanism still is different from the header caching for
@@ -7954,7 +7873,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
Especially for Usenet, people often ask for advanced filtering
and scoring functionality. Of course, mutt-ng has scoring and
allows a killfile, too. How to use a killfile has been discussed
- in Message Scoring.
+ in Message Scoring.
@@ -7971,8 +7890,8 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
-
-score =42
+
+score ~* =42
@@ -7983,8 +7902,8 @@ score =42
-
-score ! =42
+
+score !~* =42
@@ -7999,10 +7918,7 @@ score ! =42
- Email addresses must be valid according to RFC 2822, see
- <ftp://ftp.rfc-editor.org/in-notes/rfc2822.txt>
-
+ Email addresses must be valid according to
@@ -8052,35 +7968,27 @@ score ! =42
--with-libesmtp or the 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
-
- .
+ support includes support for Delivery Status Notification
+ (see dsn section) as well as
+ handling the 8BITMIME flag controlled via
+ .
To enable sending mail directly via SMTP without an MTA such as
- Postfix or SSMTP and the like, simply set the
- smtp-host
-
+ Postfix or SSMTP and the like, simply set the
variable pointing to your SMTP server.
- Authentication mechanisms are available via the
- smtp-user
-
- and variables.
+ Authentication mechanisms are available via the
+ and variables.
Transport Encryption via the StartTLS command is also available. For
this to work, first of all Mutt-ng must be built with SSL or GNUTLS.
- Secondly, the variable
+ Secondly, the 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
@@ -8093,7 +8001,7 @@ score ! =42
sender, i.e. they allow for only one value which may not be what the
user wants to send as the From: header. In this
case, the variable
- may be used
+ may be used
to set the envelope different from the From: header.
@@ -8117,10 +8025,10 @@ score ! =42
-
+
account-hook . 'unset imap_user; unset imap_pass; unset tunnel'
account-hook imap://host1/ 'set imap_user=me1 imap_pass=foo'
-account-hook imap://host2/ 'set tunnel="ssh host2 /usr/libexec/imapd"'
+account-hook imap://host2/ 'set tunnel="ssh host2 /usr/libexec/imapd"'
@@ -8139,13 +8047,12 @@ account-hook imap://host2/ 'set tunnel="ssh host2 /usr/libexec/imapd"'
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/
->
+ retrieved at
and the configuration commands:
-
+
macro index \cb |urlview\n
-macro pager \cb |urlview\n
+macro pager \cb |urlview\n
@@ -8195,10 +8102,10 @@ macro pager \cb |urlview\n
-
-open-hook \\.gz$ "gzip -cd %f > %t"
-close-hook \\.gz$ "gzip -c %t > %f"
-append-hook \\.gz$ "gzip -c %t >> %f"
+
+open-hook \\.gz$ "gzip -cd %f > %t"
+close-hook \\.gz$ "gzip -c %t > %f"
+append-hook \\.gz$ "gzip -c %t >> %f"
@@ -8219,9 +8126,8 @@ append-hook \\.gz$ "gzip -c %t >> %f"
supposes 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
-
+ compressing script produces empty files. In this situation, unset
+
,so that the compressed file
will be removed if you delete all of the messages.
@@ -8230,9 +8136,7 @@ append-hook \\.gz$ "gzip -c %t >> %f"
Open a compressed mailbox for reading
-
-Usage: regexp "command"
-
+ Usage: regexp "command"
@@ -8269,9 +8173,8 @@ Usage: regexp "
-
-open-hook \\.gz$ "gzip -cd %f > %t"
-
+
+open-hook \\.gz$ "gzip -cd %f > %t"
@@ -8287,9 +8190,7 @@ open-hook \\.gz$ "gzip -cd %f > %t"
Write a compressed mailbox
-
-Usage: regexp"command"
-
+ Usage: regexp"command"
@@ -8321,8 +8222,8 @@ Usage: regexp"
-
-close-hook \\.gz$ "gzip -c %t > %f"
+
+close-hook \\.gz$ "gzip -c %t > %f"
@@ -8344,9 +8245,7 @@ close-hook \\.gz$ "gzip -c %t > %f"
Append a message to a compressed mailbox
-
-Usage: regexp"command"
-
+ Usage: regexp"command"
@@ -8373,8 +8272,8 @@ Usage: regexp"
-
-append-hook \\.gz$ "gzip -c %t >> %f"
+
+append-hook \\.gz$ "gzip -c %t >> %f"
@@ -8382,9 +8281,7 @@ append-hook \\.gz$ "gzip -c %t >> %f"
When is used, the
folder is
not opened, which saves time, but this means that we can not find out
- what the folder type is. Thus the default (
- mbox-type
-
+ what the folder type is. Thus the default (
)type is always supposed (i.e.
this is the format used for the temporary folder).
@@ -8417,10 +8314,9 @@ append-hook \\.gz$ "gzip -c %t >> %f"
-
-open-hook \\.pgp$ "pgp -f < %f > %t"
-close-hook \\.pgp$ "pgp -fe YourPgpUserIdOrKeyId < %t > %f"
-
+
+open-hook \\.pgp$ "pgp -f < %f > %t"
+close-hook \\.pgp$ "pgp -fe YourPgpUserIdOrKeyId < %t > %f"
@@ -8568,8 +8464,8 @@ close-hook \\.pgp$ "pgp -fe YourPgpUserIdOrKeyId < %t > %f"
Attachments appear as follows:
-1 [text/plain, 7bit, 1K] /tmp/mutt-euler-8082-0 <no description>
-2 [applica/x-gunzip, base64, 422K] ~/src/mutt-0.85.tar.gz <no description>
+1 [text/plain, 7bit, 1K] /tmp/mutt-euler-8082-0 <no description>
+2 [applica/x-gunzip, base64, 422K] ~/src/mutt-0.85.tar.gz <no description>
@@ -8670,8 +8566,8 @@ audio/x-aiff aif aifc aiff
- Mutt-ng supports RFC 1524 MIME Configuration, in particular the Unix
- specific format specified in Appendix A of RFC 1524. This file format
+ Mutt-ng supports MIME Configuration, in particular the Unix
+ specific format specified in Appendix A of the RfC. This file format
is commonly referred to as the mailcap format. Many MIME compliant
programs utilize the mailcap format, allowing you to specify handling
for all MIME types in one place for all programs. Programs known to
@@ -8817,9 +8713,7 @@ text/*; more
parameters
in expansion of %s syntaxes properly, and avoids risky
characters by
- substituting them, see the
- mailcap-sanitize
-
+ substituting them, see the
variable.
@@ -8907,15 +8801,13 @@ text/html; lynx -dump %s ; copiousoutput
needsterminal
- Mutt-ng uses this flag when viewing attachments with
- auto-view
-
- ,in order to decide whether it should honor the setting
- of the variable or
+ Mutt-ng uses this flag when viewing attachments with ,
+ in order to decide whether it should honor the setting
+ of the 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
- and the exit
+ 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
@@ -9063,9 +8955,7 @@ nametemplate=%s.gif
- In addition, you can use this with
- auto-view
-
+ In addition, you can use this with
to denote two commands for viewing an attachment, one to be viewed
automatically, the other to be viewed interactively from the
attachment
@@ -9078,7 +8968,7 @@ text/html; netscape -remote 'openURL(%s)' ; test=RunningX
text/html; lynx %s; nametemplate=%s.html
text/html; lynx -dump %s; nametemplate=%s.html; copiousoutput
- For auto-view, Mutt-ng will choose
+ For , Mutt-ng will choose
the third
entry because of the copiousoutput tag. For interactive viewing,
Mutt
@@ -9146,8 +9036,8 @@ text/html; lynx -dump %s; nametemplate=%s.html; copiousoutput
instance, if
Your mail message contains:
-
-Content-Type: text/plain; charset=iso-8859-1
+
+Content-Type: text/plain; charset=iso-8859-1
then Mutt-ng will expand %{charset} to
iso-8859-1. The default metamail
@@ -9168,7 +9058,7 @@ Content-Type: text/plain; charset=iso-8859-1
Mutt-ng does not currently support the %F and %n
keywords
- specified in RFC 1524. The main purpose of these parameters is for
+ specified in . The main purpose of these parameters is for
multipart messages, which is handled internally by Mutt-ng.
@@ -9184,8 +9074,8 @@ Content-Type: text/plain; charset=iso-8859-1
>
# I'm always running X :)
-video/*; xanim %s > /dev/null
-image/*; xv %s > /dev/null
+video/*; xanim %s > /dev/null
+image/*; xv %s > /dev/null
# I'm always running netscape (if my computer had more memory, maybe)
text/html; netscape -remote 'openURL(%s)'
@@ -9201,7 +9091,7 @@ text/html; netscape -remote 'openURL(%s)'
# Use xanim to view all videos Xanim produces a header on startup,
# send that to /dev/null so I don't see it
-video/*; xanim %s > /dev/null
+video/*; xanim %s > /dev/null
# Send html to a running netscape by remote
text/html; netscape -remote 'openURL(%s)'; test=RunningNetscape
@@ -9227,8 +9117,8 @@ image/jpeg;xv %s; x-mozilla-flags=internal
image/*;xv %s; test=RunningX; edit=xpaint %s
# Convert images to text using the netpbm tools
-image/*; (anytopnm %s | pnmscale -xysize 80 46 | ppmtopgm | pgmtopbm |
-pbmtoascii -1x2 ) 2>&1 ; copiousoutput
+image/*; (anytopnm %s | pnmscale -xysize 80 46 | ppmtopgm | \
+pgmtopbm | pbmtoascii -1x2 ) 2>&1 ; copiousoutput
# Send excel spreadsheets to my NT box
application/ms-excel; open.pl %s
@@ -9243,9 +9133,17 @@ application/ms-excel; open.pl %s
-
+ MIME Autoview
-
+
+
+ mime-type [mime-type ...]
+
+
+
+ mime-type [mime-type ...]
+
+
In addition to explicitly telling Mutt-ng to view an attachment with
theMIME viewer defined in the mailcap file, Mutt-ng has support for
@@ -9269,9 +9167,9 @@ application/ms-excel; open.pl %s
For instance, if you set auto_view to:
-
+
auto_view text/html application/x-gunzip application/postscript
-image/gif application/x-tar-gz
+image/gif application/x-tar-gz
@@ -9302,9 +9200,17 @@ application/postscript; ps2ascii %s; copiousoutput
-
+ MIME Multipart/Alternative
+
+
+ mime-type [mime-type ...]
+
+
+ mime-type [mime-type ...]
+
+
Mutt-ng has some heuristics for determining which attachment of a
multipart/alternative type to display. First, mutt will check the
@@ -9313,16 +9219,16 @@ application/postscript; ps2ascii %s; copiousoutput
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/*
+application/postscript image/*
Next, mutt will check if any of the types have a defined
- auto-view, and use that. Failing
+ , and use that. Failing
that, Mutt-ng will look for any text type. As a last attempt, mutt
willlook for any type it knows how to handle.
@@ -9337,10 +9243,147 @@ application/postscript image/*
-
-
+
+
+ Attachment Searching and Counting
+
+
+ If you ever lose track of attachments in your mailboxes, Mutt's
+ attachment-counting and -searching support might be for you. You
+ can make your message index display the number of qualifying
+ attachments in each message, or search for messages by
+ attachment count. You also can configure what kinds of
+ attachments qualify for this feature with the attachments and
+ unattachments commands.
+
+
+
+The syntax is:
+
+
+
+
+ ( {+|-}disposition mime-type | ? )
+
+
+
+
+ {+|-}disposition mime-type
+
+
+
+
+Disposition is the attachment's Content-disposition type -- either
+"inline" or "attachment". You can abbreviate this to I or A.
+
+
+
+Disposition is prefixed by either a + symbolor a - symbol. If it's
+a +, you're saying that you want to allow this disposition and MIME
+type to qualify. If it's a -, you're saying that this disposition
+and MIME type is an exception to previous + rules. There are examples
+below of how this is useful.
+
+
+
+Mime-type is, unsurprisingly, the MIME type of the attachment you want
+to affect. A MIME type is always of the format "major/minor", where
+"major" describes the broad category of document you're looking at, and
+"minor" describes the specific type within that category. The major
+part of mim-type must be literal text (or the special token "*"), but
+the minor part may be a regular expression. (Therefore, "*/.*" matches
+any MIME type.)
+
+
+
+The MIME types you give to the attachments directive are a kind of
+pattern. When you use the attachments directive, the patterns you
+specify are added to a list. When you use unattachments, the pattern
+is removed from the list. The patterns are not expanded and matched
+to specific MIME types at this time -- they're just text in a list.
+They're only matched when actually evaluating a message.
+
+
+
+Some examples might help to illustrate. The examples that are not
+commented out define the default configuration of the lists.
+
+
+
+## Removing a pattern from a list removes that pattern literally. It
+## does not remove any type matching the pattern.
+##
+## attachments +A */.*
+## attachments +A image/jpeg
+## unattachments +A */.*
+##
+## This leaves "attached" image/jpeg files on the allowed attachments
+## list. It does not remove all items, as you might expect, because the
+## second */.* is not a matching expression at this time.
+##
+## Remember: "unattachments" only undoes what "attachments" has done!
+## It does not trigger any matching on actual messages.
+
+
+## Qualify any MIME part with an "attachment" disposition, EXCEPT for
+## text/x-vcard and application/pgp parts. (PGP parts are already known
+## to mutt, and can be searched for with ~g, ~G, and ~k.)
+##
+## I've added x-pkcs7 to this, since it functions (for S/MIME)
+## analogously to PGP signature attachments. S/MIME isn't supported
+## in a stock mutt build, but we can still treat it specially here.
+##
+attachments +A */.*
+attachments -A text/x-vcard application/pgp.*
+attachments -A application/x-pkcs7-.*
+
+## Discount all MIME parts with an "inline" disposition, unless they're
+## text/plain. (Why inline a text/plain part unless it's external to the
+## message flow?)
+##
+attachments +I text/plain
+
+## These two lines make Mutt qualify MIME containers. (So, for example,
+## a message/rfc822 forward will count as an attachment.) The first
+## line is unnecessary if you already have "attach-allow */.*", of
+## course. These are off by default! The MIME elements contained
+## within a message/* or multipart/* are still examined, even if the
+## containers themseves don't qualify.
+##
+#attachments +A message/.* multipart/.*
+#attachments +I message/.* multipart/.*
+
+## You probably don't really care to know about deleted attachments.
+attachments -A message/external-body
+attachments -I message/external-body
+
+
+
+"attachments ?" will list your current settings in Muttrc format, so
+that it can be pasted elsewhere.
+
+
+
+ Please note that counting attachments may require lots of data be
+ loaded. This may cause noticeable slowdowns over network links
+ depending on the connection speed and message sizes. To fine-tune the
+ behavior on a per-folder or other basis, the variable may be used.
+
+
+
+
+ MIME Lookup
-
+
+
+ mime-type [mime-type ...]
+
+
+
+ mime-type [mime-type ...]
+
+
Mutt-ng's mime_lookup list specifies a list of mime-types that
should not
@@ -9357,8 +9400,8 @@ application/postscript image/*
configuration
options (such as auto_view) specified. Common usage would be:
-
-mime_lookup application/octet-stream application/X-Lotus-Manuscript
+
+mime_lookup application/octet-stream application/X-Lotus-Manuscript
@@ -9430,11 +9473,11 @@ mime_lookup application/octet-stream application/X-Lotus-Manuscript
Mutt-ng uses many temporary files for viewing messages, verifying
- digital signatures, etc. The
+ digital signatures, etc. The
variable can be used to change the default permissions of these
files. Please only change it if you really know what you are doing.
Also, a different location for these files may be desired which can
- be changed via the variable.
+ be changed via the variable.
@@ -9454,7 +9497,7 @@ mime_lookup application/octet-stream application/X-Lotus-Manuscript
information probably telling others how many mail you sent in which
time, you at least need to remove the %P
expando from the
- default setting of the variable. Please make sure that
+ default setting of the variable. Please make sure that
you really know how local parts of these Message-ID: headers
are composed.
@@ -9471,7 +9514,7 @@ mime_lookup application/octet-stream application/X-Lotus-Manuscript
will be strict in interpreting them which means that arbitrary
header fields can be embedded in these links which could override
existing header fields or attach arbitrary files. This may be
- problematic if the
+ problematic if the
variable is unset, i.e. the
user doesn't want to see header fields while editing the message.
@@ -9494,9 +9537,7 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg
- When unsetting the
- strict-mailto
-
+ When unsetting the
variable, mutt-ng will
@@ -9516,7 +9557,7 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg
- turn on the
+ turn on the
variable by
force to let the user see all the headers
(because they still may leak information.)
@@ -9546,11 +9587,10 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg
One of these is the mailcap mechanism as defined
- by RfC
- 1524. Mutt-ng can be set up to automatically
+ by . Mutt-ng can be set up to automatically
execute any
given utility as listed in one of the mailcap files (see the
-
+
variable for details.)
@@ -9594,7 +9634,7 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg
- leave the variable in its default
+ leave the variable in its default
state to restrict mailcap expandos to a safe set of characters
@@ -9648,8 +9688,8 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg
-