X-Git-Url: http://git.madism.org/?a=blobdiff_plain;f=doc%2Fmanual.xml.head;h=fc9f0883b106de195c6d9fd1de8201ae2b6b1fcf;hb=0e9b83760fb127dc4c7ba0d0a06cd55735dc37db;hp=ae9572c69d6e73daa46d357dedbc4a04271acf42;hpb=b26cf275fbfafe8a104983b58fd11f90a75b4358;p=apps%2Fmadmutt.git
diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index ae9572c..fc9f088 100644
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -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
@@ -690,7 +688,7 @@
-
+
Most commonly used movement bindings
@@ -768,7 +766,7 @@
-
+
Line Editor Functions
@@ -930,7 +928,7 @@
-
+
Most commonly used Index Bindings
@@ -1224,7 +1222,7 @@
Furthermore, the following flags reflect who the message is
addressed
to. They can be customized with the
- variable.
+ variable.
@@ -1289,7 +1287,7 @@
-
+
Most commonly used Pager Bindings
@@ -1397,7 +1395,7 @@
-
+
ANSI Escape Sequences
@@ -1440,7 +1438,7 @@
-
+
ANSI Colors
@@ -1492,7 +1490,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.
@@ -1516,7 +1514,7 @@
-
+
Most commonly used thread-related bindings
@@ -1610,18 +1608,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.
@@ -1636,10 +1634,10 @@
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
+ 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.
@@ -1662,7 +1660,7 @@
- Toggles the weeding of message header fields specified by ignore
+ Toggles the weeding of message header fields specified by
commands.
@@ -1709,7 +1707,7 @@
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.
@@ -1739,10 +1737,10 @@
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
@@ -1757,10 +1755,10 @@
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.
@@ -1793,7 +1791,7 @@
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
@@ -1807,7 +1805,7 @@
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
@@ -1845,7 +1843,7 @@
-
+
Most commonly used Mail Composition Bindings
@@ -2012,7 +2010,7 @@ set edit_headers
-
+
Most commonly used Compose Menu Bindings
@@ -2137,7 +2135,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.
@@ -2341,8 +2339,8 @@ Attach: filename [description]
- Also see the and
- variables
+ Also see the and
+ variables
@@ -2362,7 +2360,7 @@ Pgp: [E | S | S id]
``E'' encrypts, ``S'' signs and
``S<id>'' signs with the given key, setting
-
+
permanently.
@@ -2392,7 +2390,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.
@@ -2403,7 +2401,7 @@ Pgp: [E | S | S id]
flags:
-
+
PGP Key Menu Flags
@@ -2532,7 +2530,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
@@ -2930,7 +2928,7 @@ set imap_home_namespace = $folder
- would set the value of
+ would set the value of
to the value to which
is currently set to.
@@ -2938,7 +2936,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.
@@ -3230,13 +3228,11 @@ set folder = $user_magic_number
-
+
Defining/Using aliases
-
+
-
-Usage: alias key address [, address ,...]
-
+ Usage: key address [, address ,...]
@@ -3274,7 +3270,7 @@ 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.
+ 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.
@@ -3282,13 +3278,13 @@ alias theguys manny, moe, jack
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.
@@ -3313,7 +3309,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.
@@ -3344,13 +3340,11 @@ set alias_file=~/.mail_aliases
-
+
Changing the default key bindings
-
-Usage: bind map key function
-
+ Usage: map key function
@@ -3500,7 +3494,7 @@ Usage: bind map key
-
+
Alternative Key Names
@@ -3632,12 +3626,13 @@ Usage: bind map key
Defining aliases for character sets
-
+
+
+
+ Usage: alias charset
+
-
-Usage: alias charset
-Usage: charset local-charset
-
+ Usage: charset local-charset
@@ -3665,10 +3660,7 @@ Usage: charset l
Setting variables based upon mailbox
-
-Usage: [!]regexp command
-
-
+ Usage: [!]regexp command
@@ -3726,13 +3718,11 @@ folder-hook . set sort=date-sent
-
+
Keyboard macros
-
-Usage: macro menu key sequence [description ]
-
+ Usage: menu key sequence [description ]
@@ -3758,7 +3748,7 @@ Usage: macro menu key
key and sequence are expanded
- by the same rules as the bind. There are
+ by the same rules as the . There are
some additions however. The
first is that control characters in sequence can
also be specified
@@ -3771,7 +3761,7 @@ Usage: macro menu key
.For a listing of key
- names see the section on bind. Functions
+ names see the section on . Functions
are listed in the functions.
@@ -3802,15 +3792,19 @@ Usage: macro menu key
-
+
Using color and mono video attributes
-
+
+
+
+
+ Usage: object foreground background [regexp ]
+
+
+ Usage: index foreground background pattern
+
-
-Usage: color object foreground background [regexp ]
-Usage: color index foreground background pattern
-Usage: uncolor index pattern [pattern ...]
-
+ Usage: index pattern [pattern ...]
@@ -3900,7 +3894,7 @@ Usage: uncolor index pattern [p
- quoted (text matching in the body of a message)
+ quoted (text matching in the body of a message)
@@ -4093,11 +4087,13 @@ export COLORFGBG
-
-Usage: mono <object> <attribute> [regexp ]
-Usage: mono index attribute pattern
-Usage: unmono index pattern [pattern ...]
-
+ Usage: <object> <attribute> [regexp ]
+
+
+ Usage: index attribute pattern
+
+
+ Usage: index pattern [pattern ...]
@@ -4148,15 +4144,17 @@ Usage: unmono index pattern [p
-
+
Ignoring (weeding) unwanted message headers
-
+
-
-Usage: [un]ignore pattern [pattern ...]
-
+ Usage: pattern [pattern ...]
-
+
+
+ Usage: pattern [pattern ...]
+
+
Messages often have many header fields added by automatic processing
systems,
@@ -4203,14 +4201,17 @@ unignore posted-to:
-
+
Alternative addresses
- Usage: [un]alternates regexp [regexp ...]
-
+ Usage: regexp [regexp ...]
-
+
+
+ Usage: regexp [regexp ...]
+
+
With various functions, mutt will treat messages differently,
depending on whether you sent them or whether you received them from
@@ -4218,7 +4219,7 @@ unignore posted-to:
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 .)
+ (See .)
@@ -4289,7 +4290,7 @@ unignore posted-to:
For introductory information on format=flowed
messages, see
- <http://www.joeclark.org/ffaq.html> .
+ .
@@ -4413,7 +4414,7 @@ set text_flowed
side, the first space (if any) is removed. As a consequence and in
addition to the above simple setting, please keep this in mind when
making manual formattings within the editor. Also note that mutt-ng
- currently violates the standard (RfC 3676) as it does not
+ currently violates the standard ( ) as it does not
space-stuff lines starting with:
@@ -4421,7 +4422,6 @@ set text_flowed
-
> This is not the
quote character but a right
@@ -4429,21 +4429,6 @@ set text_flowed
-
-
-
- From with a trailing space.
-
-
-
-
-
-
- just a space for formatting reasons
-
-
-
-
@@ -4458,7 +4443,7 @@ set text_flowed
Additional Notes
- For completeness, the variable provides the mechanism
+ For completeness, the variable provides the mechanism
to generate a DelSp=yes parameter on
outgoing
@@ -4482,14 +4467,21 @@ set text_flowed
-
+
+
Mailing lists
-
-Usage: [un]lists regexp [regexp ...]
-Usage: [un]subscribe regexp [regexp ...]
-
+ Usage: regexp [regexp ...]
+
+
+ Usage: regexp [regexp ...]
+
+
+ Usage: regexp [regexp ...]
+
+
+ Usage: regexp [regexp ...]
@@ -4507,7 +4499,7 @@ Usage: [un]subscribe regexp [r
against
receiving personal CCs of list messages. Also note that the generation
of the Mail-Followup-To header is controlled by the
-
+
configuration variable.
@@ -4563,9 +4555,7 @@ Usage: [un]subscribe regexp [r
Using Multiple spool mailboxes
-
-Usage: [!]pattern mailbox
-
+ Usage: [!]pattern mailbox
@@ -4594,15 +4584,16 @@ Usage: [!]pattern
-
+
Defining mailboxes which receive mail
-
+
-
-Usage: [un]mailboxes [!]filename [filename ...]
-
+ Usage: [!]filename [filename ...]
-
+
+ Usage: [!]filename [filename ...]
+
+
This command specifies folders which can receive mail and
which will be checked for new messages. By default, the
@@ -4662,14 +4653,14 @@ Usage: [un]mailboxes [!]filename [
-
+
User defined headers
-
-Usage: my_hdr string
-Usage: unmy_hdr field [field ...]
-
+ Usage: string
+
+
+ Usage: field [field ...]
@@ -4697,13 +4688,13 @@ my_hdr Organization: A Really Big Company, Anytown, USA
not
allowed between the keyword and
- the colon (``:''). The standard for electronic mail (RFC822) says that
+ the colon (``:''). The standard for electronic mail ( ) says that
space is illegal there, so Mutt-ng enforces the rule.
If you would like to add a header field to a single message, you should
- either set the
+ either set the
variable,
or use the edit-headers function (default: ``E'')
in the send-menu so
@@ -4728,13 +4719,11 @@ unmy_hdr to cc
-
+
Defining the order of headers when viewing messages
-
-Usage: hdr_order header1 header2 header3
-
+ Usage: header1 header2 header3
@@ -4766,9 +4755,7 @@ hdr_order From Date: From: To: Cc: Subject:
Specify default save filename
-
-Usage: [!]pattern filename
-
+ Usage: [!]pattern filename
@@ -4814,9 +4801,7 @@ save-hook aol\\.com$ +spam
Specify default Fcc: mailbox when composing
-
-Usage: [!]pattern mailbox
-
+ Usage: [!]pattern mailbox
@@ -4836,7 +4821,7 @@ Usage: [!]pattern m
- Example: ]@.[aol\\.com$
+ Example: [@.]aol\\.com$
+spammers
@@ -4858,9 +4843,7 @@ Usage: [!]pattern m
Specify default save filename and default Fcc: mailbox at once
-
-Usage: [!]pattern mailbox
-
+ Usage: [!]pattern mailbox
@@ -4878,12 +4861,15 @@ Usage: [!]patter
Change settings based upon message recipients
+
-
-Usage: [!]pattern command
-Usage: [!]pattern command
-Usage: [!]pattern command
- v
+ Usage: [!]pattern command
+
+
+ Usage: [!]pattern command
+
+
+ Usage: [!]pattern command
@@ -4971,9 +4957,7 @@ Usage: [!]pattern Change settings before formatting a message
-
-Usage: [!]pattern command
-
+ Usage: [!]pattern command
@@ -5010,9 +4994,7 @@ message-hook ' freshmeat-news' 'set pager="less \"
Choosing the cryptographic key of the recipient
-
-Usage: pattern keyid
-
+ Usage: pattern keyid
@@ -5039,20 +5021,18 @@ Usage: pattern ke
-
+
Adding key sequences to the keyboard buffer
-
-Usage: push string
-
+ Usage: 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
+ names like the sequence string in the command. You may use it to
automatically run a sequence of commands at startup, or when
entering certain folders. For example, the following command
will automatically collapse all threads when entering a folder:
@@ -5069,13 +5049,11 @@ folder-hook . 'push <collapse-all>'
-
+
Executing functions
-
-Usage: exec function [function ...]
-
+ Usage: function [function ...]
@@ -5090,14 +5068,14 @@ Usage: exec function [function
-
+
Message Scoring
-
-Usage: score pattern value
-Usage: unscore pattern [pattern ...]
-
+ Usage: pattern value
+
+
+ Usage: pattern [pattern ...]
@@ -5185,14 +5163,14 @@ score " santaclaus@northpole\.int" =666
These three thresholds can be set via the variables
- ,
- and
- .
+ ,
+ and
+ .
By default,
- and
-
+ and
+
are set to
-1 , which means that in the default threshold
configuration no
@@ -5229,15 +5207,15 @@ color index red yellow " 100-"
-
+
Spam detection
-
+
-
-Usage: spam pattern format
-Usage: nospam pattern
-
-
+ Usage: pattern format
+
+
+ Usage: pattern
+
Mutt-ng has generalized support for external spam-scoring filters.
@@ -5251,7 +5229,7 @@ Usage: nospam pattern
mail based on its spam attributes, as determined by the external
filter. You also can display the spam attributes in your index
display using the %H selector in the
-
+
variable. (Tip: try %?H?[%H] ?
to display spam tags only when they are defined for a given message.)
@@ -5401,17 +5379,20 @@ spam "^From: .*MAILER-DAEMON" "999"
-
+
Setting variables
-
-
-
-Usage: set [no|inv]variable [=value ] [variable ...]
-Usage: toggle variable [variable ...]
-Usage: unset variable [variable ...]
-Usage: reset variable [variable ...]
-
+
+ Usage: [no|inv]variable [=value ] [variable ...]
+
+
+ Usage: variable [variable ...]
+
+
+ Usage: variable [variable ...]
+
+
+ Usage: variable [variable ...]
@@ -5524,13 +5505,11 @@ set ?allow_8bit
-
+
Reading initialization commands from another file
-
-Usage: source filename [filename ...]
-
+ Usage: filename [filename ...]
@@ -5562,14 +5541,12 @@ Usage: source filename [filena
-
+
Removing hooks
-
-Usage: unhook [* | hook-type ]
-
-
+ Usage: [* | hook-type ]
+
This command permits you to flush hooks you have previously defined.
@@ -5757,7 +5734,7 @@ ifdef feature_nntp 'source ~/.mutt-ng/setup-nntp'
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
-
+
use:
@@ -5770,8 +5747,8 @@ ifdef imap_mail_check 'set imap_mail_check = 300'
Provided for completeness is the test for menu names. To set
-
+
only if the pager
menu is available, use:
@@ -5898,26 +5875,26 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
- A list of characters enclosed by ``]'' and ``['' matches any
+ A list of characters enclosed by ``]'' and ``]'' matches any
single character in that list; if the first character of the list
is a caret ``^'' then it matches any character
not
in the
list. For example, the regular expression
- ]0123456789[
+ ]0123456789]
matches any single digit. A range of ASCII characters may be specified
by giving the first and last characters, separated by a hyphen
``-''. Most metacharacters lose their special meaning inside
- lists. To include a literal ``['' place it first in the list.
+ lists. To include a literal ``]'' place it first in the list.
Similarly, to include a literal ``^'' place it anywhere but first.
Finally, to include a literal hyphen ``-'' place it last.
Certain named classes of characters are predefined. Character classes
- consist of ``]:'', a keyword denoting the class, and ``:[''.
+ consist of ``[:'', a keyword denoting the class, and ``:]''.
The following classes are defined by the POSIX standard:
@@ -5925,7 +5902,7 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
- ]:alnum:[
+ [:alnum:]
Alphanumeric characters.
@@ -5933,7 +5910,7 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
- ]:alpha:[
+ [:alpha:]
Alphabetic characters.
@@ -5941,7 +5918,7 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
- ]:blank:[
+ [:blank:]
Space or tab characters.
@@ -5949,7 +5926,7 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
- ]:cntrl:[
+ [:cntrl:]
Control characters.
@@ -5957,7 +5934,7 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
- ]:digit:[
+ [:digit:]
Numeric characters.
@@ -5965,7 +5942,7 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
- ]:graph:[
+ [:graph:]
Characters that are both printable and visible. (A space is
@@ -5975,7 +5952,7 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
- ]:lower:[
+ [:lower:]
Lower-case alphabetic characters.
@@ -5983,7 +5960,7 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
- ]:print:[
+ [:print:]
Printable characters (characters that are not control
@@ -5992,7 +5969,7 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
- ]:punct:[
+ [:punct:]
Punctuation characters (characters that are not letter, digits,
@@ -6002,7 +5979,7 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
- ]:space:[
+ [:space:]
Space characters (such as space, tab and formfeed, to name a
@@ -6011,7 +5988,7 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
- ]:upper:[
+ [:upper:]
Upper-case alphabetic characters.
@@ -6019,7 +5996,7 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
- ]:xdigit:[
+ [:xdigit:]
Characters that are hexadecimal digits.
@@ -6034,8 +6011,8 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
brackets of a character list. Note that the brackets in these
class names are part of the symbolic names, and must be included
in addition to the brackets delimiting the bracket list. For
- example, ]]:digit:[[ is equivalent to
- ]0-9[ .
+ example, [[:digit:]] is equivalent to
+ [0-9] .
@@ -6056,14 +6033,14 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
A collating symbol is a multi-character collating element
enclosed in
- ``].'' and ``.[''. For example, if ``ch'' is a
+ ``[.'' and ``.]''. For example, if ``ch'' is a
collating
element, then
- ]].ch.[[
+ [[.ch.]]
is a regexp that matches
this collating element, while
- ]ch[
+ [ch]
is a regexp that
matches either ``c'' or ``h''.
@@ -6076,11 +6053,11 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
An equivalence class is a locale-specific name for a list of
characters that are equivalent. The name is enclosed in
- ``]=''
- and ``=[''. For example, the name ``e'' might be used to
+ ``[=''
+ and ``=]''. For example, the name ``e'' might be used to
represent all of ``è'' ``é'' and ``e''. In this
case,
- ]]=e=[[ is
+ [[=e=]] is
a regexp that matches any of
``è'', ``é'' and ``e''.
@@ -6456,7 +6433,7 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
The setting for the status bar of the index is controlled via the
-
+
variable. For the hostname and version string, there's an expando
for $status_format :
%h
@@ -6823,13 +6800,13 @@ set status_format = "%B: %?n?%n&no? new messages %> (%v on %h)"
operation will
be applied to all tagged messages if that operation can be used in that
- manner. If the
+ manner. If the
variable is set, the next operation applies to the tagged messages
automatically, without requiring the ``tag-prefix''.
- In macro or push commands,
+ In or 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 encounters the
@@ -6926,7 +6903,7 @@ set status_format = "%B: %?n?%n&no? new messages %> (%v on %h)"
send-hook . 'unmy_hdr From:'
-send-hook '^b@b\.b$' my_hdr from: c@c.c
+send-hook '^b@b\.b$' my-hdr from: c@c.c
@@ -6960,7 +6937,7 @@ send-hook '^b@b\.b$' my_hdr from: c@c.c
mail to a specific address, you could do something like:
-send-hook ' ^me@cs\.hmc\.edu$' 'my_hdr From: Mutt-ng User <user@host>'
+send-hook ' ^me@cs\.hmc\.edu$' 'my-hdr From: Mutt-ng User <user@host>'
which would execute the given command when sending mail to
me@cs.hmc.edu .
@@ -7065,7 +7042,7 @@ 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:
@@ -7137,7 +7114,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.
@@ -7227,20 +7204,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
@@ -7264,7 +7241,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
- = or + -- refers to your
+ = or + -- refers to your
directory
@@ -7295,7 +7272,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.
@@ -7306,7 +7283,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
the index menu display. This is useful to
distinguish between
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''
@@ -7329,7 +7306,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
+ 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
@@ -7343,7 +7320,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
@@ -7363,7 +7340,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
@@ -7379,7 +7356,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
@@ -7471,7 +7448,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.''
@@ -7514,7 +7491,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.).
@@ -7523,7 +7500,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).
@@ -7578,7 +7555,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.
@@ -7599,7 +7576,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
(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.
@@ -7620,34 +7597,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.
@@ -7657,14 +7648,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.
@@ -7678,7 +7664,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.
@@ -7686,9 +7672,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.
@@ -7796,7 +7782,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
@@ -7808,7 +7794,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.
@@ -7817,7 +7803,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
@@ -7854,7 +7840,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
@@ -7868,7 +7854,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.
@@ -7913,10 +7899,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
@@ -7969,24 +7952,24 @@ score ! =42
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
+ Postfix or SSMTP and the like, simply set the
variable pointing to your SMTP server.
- Authentication mechanisms are available via the
- 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
@@ -7999,7 +7982,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.
@@ -8045,8 +8028,7 @@ 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:
@@ -8126,7 +8108,7 @@ append-hook \\.gz$ "gzip -c %t >> %f"
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
-
+
,so that the compressed file
will be removed if you delete all of the messages.
@@ -8135,9 +8117,7 @@ append-hook \\.gz$ "gzip -c %t >> %f"
Open a compressed mailbox for reading
-
-Usage: regexp "command "
-
+ Usage: regexp "command "
@@ -8192,9 +8172,7 @@ open-hook \\.gz$ "gzip -cd %f > %t"
Write a compressed mailbox
-
-Usage: regexp "command "
-
+ Usage: regexp "command "
@@ -8249,9 +8227,7 @@ close-hook \\.gz$ "gzip -c %t > %f"
Append a message to a compressed mailbox
-
-Usage: regexp "command "
-
+ Usage: regexp "command "
@@ -8287,7 +8263,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 (
+ what the folder type is. Thus the default (
)type is always supposed (i.e.
this is the format used for the temporary folder).
@@ -8573,8 +8549,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
@@ -8720,7 +8696,7 @@ text/*; more
parameters
in expansion of %s syntaxes properly, and avoids risky
characters by
- substituting them, see the
+ substituting them, see the
variable.
@@ -8808,13 +8784,13 @@ text/html; lynx -dump %s ; copiousoutput
needsterminal
- Mutt-ng uses this flag when viewing attachments with auto-view,
+ Mutt-ng uses this flag when viewing attachments with ,
in order to decide whether it should honor the setting
- of the variable or
+ 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
@@ -8962,7 +8938,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
@@ -8975,7 +8951,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
@@ -9065,7 +9041,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.
@@ -9140,7 +9116,7 @@ application/ms-excel; open.pl %s
-
+
MIME Autoview
@@ -9199,7 +9175,7 @@ application/postscript; ps2ascii %s; copiousoutput
-
+
MIME Multipart/Alternative
@@ -9219,7 +9195,7 @@ 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.
@@ -9235,7 +9211,7 @@ application/postscript image/*
-
+
MIME Lookup
@@ -9327,11 +9303,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.
@@ -9351,7 +9327,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.
@@ -9368,7 +9344,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.
@@ -9391,7 +9367,7 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg
- When unsetting the
+ When unsetting the
variable, mutt-ng will
@@ -9411,7 +9387,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.)
@@ -9441,11 +9417,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.)
@@ -9489,7 +9464,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
@@ -9543,7 +9518,7 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg
-
+
Reference: Command Line Options
@@ -9656,10 +9631,10 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg
- mutt ] -nz [ ] -F muttrc [ ] -m
+ mutt ] -nz ] ] -F muttrc ] ] -m
type
- [ ] -f mailbox [
+ ] ] -f mailbox ]
@@ -9667,16 +9642,16 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg
- mutt ] -n [ ] -F muttrc [ ] -a
+ mutt ] -n ] ] -F muttrc ] ] -a
file
- [ ] -c address [ ] -i
+ ] ] -c address ] ] -i
filename
- [ ] -s subject [ address ]
+ ] ] -s subject ] address ]
address
- ... [
+ ... ]
@@ -9711,7 +9686,7 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg
-
+
Reference: Patterns
@@ -9723,222 +9698,222 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg
-
+
all messages
-
+
EXPR
messages which contain EXPR in the message body
-
+
EXPR
messages which contain EXPR in the whole message
-
+
EXPR
messages carbon-copied to EXPR
-
+
EXPR
message is either to: or cc: EXPR
-
+
deleted messages
-
+
[MIN]-[MAX]
messages with ``date-sent'' in a Date range
-
+
expired messages
-
+
EXPR
message which contains EXPR in the ``Sender'' field
-
+
flagged messages
-
+
EXPR
messages originating from EXPR
-
+
cryptographically signed messages
-
+
cryptographically encrypted messages
-
+
EXPR
messages with a spam attribute matching EXPR
-
+
EXPR
messages which contain EXPR in the message header
-
+
message contains PGP key material
-
+
EXPR
message which match ID in the ``Message-ID'' field
-
+
EXPR
message is either originated or received by EXPR
-
+
message is addressed to a known mailing list
-
+
[MIN]-[MAX]
message in the range MIN to MAX *)
-
+
multipart messages
-
+
[MIN]-[MAX]
messages with a score in the range MIN to MAX *)
-
+
new messages
-
+
old messages
-
+
message is addressed to you (consults alternates)
-
+
message is from you (consults alternates)
-
+
messages which have been replied to
-
+
read messages
-
+
[MIN]-[MAX]
messages with ``date-received'' in a Date range
-
+
superseded messages
-
+
EXPR
messages having EXPR in the ``Subject'' field.
-
+
tagged messages
-
+
EXPR
messages addressed to EXPR
-
+
unread messages
-
+
message is addressed to a subscribed mailing list
-
+
message is part of a collapsed thread.
-
+
cryptographically verified messages
-
+
EXPR
messages which contain EXPR in the `Newsgroups' field (if compiled with NNTP support)
-
+
EXPR
messages which contain EXPR in the `References' field
-
+
EXPR
messages which contain EXPR in the `X-Label' field
-
+
[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)
@@ -9981,521 +9956,326 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg
-
-
-
- pattern command
+ pattern command
-
- alias
-
- key address ] ,
- address
-
- ,... [
+ key address [, address , ... ]
-
- alias
-
- ] * | key ... [
+ [ * | key ... ]
-
- alternates
-
- regexp ] regexp
- ... [
+ regexp [ regexp ... ]
-
- alternates
-
- ] * | regexp ... [
+ [ * | regexp ... ]
-
- alternative-order
-
- mimetype ] mimetype ... [
+ mimetype [ mimetype ... ]
-
- alternative-order
-
- mimetype ] mimetype ... [
+ mimetype [ mimetype ... ]
-
-
-
- regexp command
+ regexp command
-
- auto-view
-
- mimetype ] mimetype ... [
+ mimetype [ mimetype ... ]
-
- auto-view
-
- mimetype ] mimetype ... [
+ mimetype [ mimetype ... ]
-
- bind
-
- map key
- function
-
+ map key function
-
-
-
- alias charset
+ alias charset
-
-
-
- regexp command
+ regexp command
-
- color
-
- object foreground
- background
-
- ] regexp [
+ object foreground background [ regexp ]
-
- color
-
- index pattern ]
- pattern
-
- ... [
+ index pattern [ pattern ... ]
-
- exec
-
- function ] function ... [
+ function [ function ... ]
-
-
-
- pattern mailbox
+ pattern mailbox
-
-
-
- pattern mailbox
+ pattern mailbox
-
-
-
- pattern command
+ pattern command
-
- hdr-order
-
- header ] header
- ... [
+ header [ header ... ]
-
- hdr-order
-
- header ] header
- ... [
+ header [ header ... ]
-
-
-
- charset local-charset
+ charset local-charset
-
- ignore
-
- pattern ] pattern
- ... [
+ pattern [ pattern ... ]
-
- ignore
-
- pattern ] pattern
- ... [
+ pattern [ pattern ... ]
-
- lists
-
- regexp ] regexp
- ... [
+ regexp [ regexp ... ]
-
- lists
-
- regexp ] regexp
- ... [
+ regexp [ regexp ... ]
-
- macro
-
- menu key
- sequence
-
- ] description [
+ menu key sequence [ description ]
-
- mailboxes
-
- filename ] filename ... [
+ filename [ filename ... ]
-
-
-
- pattern mailbox
+ pattern mailbox
-
-
-
- pattern command
+ pattern command
-
- mime-lookup
-
- mimetype ] mimetype ... [
+ mimetype [ mimetype ... ]
- mime-lookup
-
- mimetype ] mimetype ... [
+ mimetype [ mimetype ... ]
-
- color
-
- object attribute ] regexp [
+ object attribute [ regexp ]
-
- color
-
- index pattern ]
- pattern
-
- ... [
+ index pattern [ pattern ... ]
-
- my-hdr
-
- string
+ string
-
- my-hdr
-
- field ] field ...
- [
+ field [ field ... ]
-
-
-
- regexp command
+ regexp command
-
-
-
- pattern key-id
+ pattern key-id
-
- push
-
- string
+ string
-
- set
-
- variable ]variable
- ... [
+ variable [ variable ... ]
-
-
-
- regexp filename
+ regexp filename
-
- score-command
-
- pattern value
+ pattern value
-
- score-command
-
- pattern ] pattern
- ... [
+ pattern [ pattern ... ]
-
-
-
- regexp command
+ regexp command
-
-
-
- regexp command
+ regexp command
-
- set
-
- ]no|inv[variable ]=
- value
-
- [ ] variable ... [
+ [no|inv]variable [ =value ] [ variable ... ]
-
- set
-
- variable ]variable
- ... [
+ variable [ variable ... ]
-
- source
-
- filename
+ filename
-
- spam
-
- pattern format
+ pattern format
-
- spam
-
- pattern
+ pattern
-
- lists
-
- regexp ] regexp
- ... [
+ regexp [ regexp ... ]
-
- lists
-
- regexp ] regexp
- ... [
+ regexp [ regexp ... ]
-
- set
-
- variable ]variable
- ... [
+ variable [ variable ... ]
-
- unhook
-
- hook-type
+ hook-type
@@ -10518,7 +10298,7 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg
-
+
Reference: Obsolete Variables
@@ -10530,167 +10310,167 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg
edit_hdrs
-
+
forw_decode
-
+
forw_format
-
+
forw_quote
-
+
hdr_format
-
+
indent_str
-
+
mime_fwd
-
+
msg_format
-
+
pgp_autosign
-
+
pgp_autoencrypt
-
+
pgp_replyencrypt
-
+
pgp_replysign
-
+
pgp_replysignencrypted
-
+
pgp_verify_sig
-
+
pgp_create_traditional
-
+
pgp_auto_traditional
-
+
forw_decrypt
-
+
smime_sign_as
-
+
post_indent_str
-
+
print_cmd
-
+
shorten_hierarchy
-
+
ask_followup_to
-
+
ask_x_comment_to
-
+
catchup_newsgroup
-
+
followup_to_poster
-
+
group_index_format
-
+
inews
-
+
mime_subject
-
+
news_cache_dir
-
+
news_server
-
+
newsrc
-
+
nntp_poll
-
+
pop_checkinterval
-
+
post_moderated
-
+
save_unsubscribed
-
+
show_new_news
-
+
show_only_unread
-
+
x_comment_to
-
+
smtp_auth_username
-
+
smtp_auth_password
-
+
user_agent
-
+