X-Git-Url: http://git.madism.org/?p=apps%2Fmadmutt.git;a=blobdiff_plain;f=doc%2Fmanual.sgml.head;h=f34b850892c27d08b6d0d30e000d260cd0e5af49;hp=8ad8d3bc444d3f3c92c46872725ab5963cc8b527;hb=5c310cabcfafe551dcad7638c007daae1c7d3710;hpb=6833ce8bdca2d64e14485118f2a4417b7e1cb1b1 diff --git a/doc/manual.sgml.head b/doc/manual.sgml.head index 8ad8d3b..f34b850 100644 --- a/doc/manual.sgml.head +++ b/doc/manual.sgml.head @@ -56,8 +56,8 @@ name="http://www.mutt.org/download.html">. IRC

Visit channel to chat with other people interested in Mutt. +url="http://www.freenode.net/" name="irc.freenode.net +(www.freenode.net)"> to chat with other people interested in Mutt. USENET

@@ -411,7 +411,7 @@ you misspelled the passphrase.

(default: L) Reply to the current or tagged message(s) by extracting any addresses which -match the addresses given by the +match the regular expressions given by the commands, but also honor any configuration variable is set. Using this when replying to messages posted @@ -568,7 +568,7 @@ Also see .

If you want to use PGP, you can specify - + ``E'' encrypts, ``S'' signs and ``S<id>'' signs with the given key, setting which the macro will be bound. +Multiple maps may be specified by separating multiple menu arguments by +commas. Whitespace may not be used in between the menu arguments and the +commas separating them. + . There are some additions however. The first is that control characters in .) +id="reply_to" name="$reply_to">.) Many users receive e-mail under a number of different addresses. To fully use mutt's features here, the program must be able to @@ -1195,8 +1202,18 @@ purpose of the Mailing lists

@@ -1215,7 +1232,7 @@ the Mail-Followup-To header is a non-standard extension which is not supported by all mail user agents. Adding it is not bullet-proof against receiving personal CCs of list messages. Also note that the generation of the Mail-Followup-To header is controlled by the configuration variable. +name="$followup_to"> configuration variable. More precisely, Mutt maintains lists of patterns for the addresses of known and subscribed mailing lists. Every subscribed mailing @@ -1235,8 +1252,8 @@ mailing list, you could add ``lists mutt-users'' to your initialization file. To tell mutt that you are subscribed to it, add ``subscribe mutt-users'' to your initialization file instead. If you also happen to get mail from someone whose address is - mailbox. See for information on the exact format of and a with its arguments. -Change settings based upon message recipients

Usage: -Usage: +Usage: variable depending on the message's sender +address. + +For each type of Spam detection

+Usage: +Usage: variable. (Tip: try +spam "X-DCC-.*-Metrics:.*(....)=many" "90+/DCC-%1" +spam "X-Spam-Status: Yes" "90+/SA" +spam "X-PerlMX-Spam: .*Probability=([0-9]+)%" "%1/PM" +set spam_separator=", " + + +If I then received a message that DCC registered with ``many'' hits +under the ``Fuz2'' checksum, and that PureMessage registered with a +97% probability of being spam, that message's spam tag would read +90+/DCC-Fuz2, 97/PM. (The four characters before ``=many'' in a +DCC report indicate the checksum used -- in this case, ``Fuz2''.) + +If the $spam_separator variable is unset, then each +spam pattern match supercedes the previous one. Instead of getting +joined +spam "^From: .*MAILER-DAEMON" "999" + + + Setting variables

Usage: @@ -1574,7 +1699,7 @@ path of your home directory. If the filename ends with a vertical bar (|), then source ~/bin/myscript|). Removing hooks

@@ -1770,6 +1895,7 @@ messages: ~f USER messages originating from USER ~g cryptographically signed messages ~G cryptographically encrypted messages +~H EXPR messages with a spam attribute matching EXPR ~h EXPR messages which contain EXPR in the message header ~k message contains PGP key material ~i ID message which match ID in the ``Message-ID'' field @@ -1795,6 +1921,7 @@ messages: ~y EXPR messages which contain EXPR in the `X-Label' field ~z [MIN]-[MAX] messages with a size in the range MIN to MAX *) ~= duplicated messages (see $duplicate_threads) +~$ unreferenced messages (requires threaded view) Where EXPR, USER, ID, and SUBJECT are @@ -1871,8 +1998,9 @@ pattern language. For example, ~f "me@(mutt\.org|cs\.hmc\.edu)" -Without the quotes, the parenthesis would truncate the regular expression -to simply Searching by Date

@@ -1962,6 +2090,13 @@ manner. If the variable is set, the next operation applies to the tagged messages automatically, without requiring the ``tag-prefix''. +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 will stop "eating" the macro when it encounters the ``end-cond'' +operator; after this operator the rest of the macro will be executed as +normal. + Using Hooks

A send-hook . 'unmy_hdr From:' -send-hook ~Cb@b.b my_hdr from: c@c.c +send-hook ~C'^b@b\.b$' my_hdr from: c@c.c Message Matching in Hooks

+Mutt has the ability to dynamically restructure threads that are broken +either by misconfigured software or bad behaviour from some +correspondents. This allows to clean your mailboxes formats) from these +annoyances which make it hard to follow a discussion. + +If you want to use these functions with IMAP, you need to compile Mutt +with the Linking threads +

+ +Some mailers tend to "forget" to correctly set the "In-Reply-To:" and +"References:" headers when replying to a message. This results in broken +discussions because Mutt has not enough information to guess the correct +threading. +You can fix this by tagging the reply, then moving to the parent message +and using the ``link-threads'' function (bound to & by default). The +reply will then be connected to this "parent" message. + +You can also connect multiple childs at once, tagging them and using the +tag-prefix command (';') or the auto_tag option. + +Breaking threads +

+ +On mailing lists, some people are in the bad habit of starting a new +discussion by hitting "reply" to any message from the list and changing +the subject to a totally unrelated one. +You can fix such threads by using the ``break-thread'' function (bound +by default to #), which will turn the subthread starting from the +current message into a whole different thread. + Delivery Status Notification (DSN) Support

+ RFC1894 defines a set of MIME content types for relaying information about the status of electronic mail messages. These can be thought of as ``return receipts.'' Berkeley sendmail 8.8.x currently has some command @@ -2243,7 +2414,7 @@ You can also specify different username for each folder, ie: Polling for new mail is more expensive over POP3 than locally. For this reason the frequency at which Mutt will check for mail remotely can be controlled by the - + variable, which defaults to every 60 seconds. If Mutt was compiled with SSL support (by running the variable. Polling for new mail on an IMAP server can cause noticeable delays. So, you'll want to carefully tune the - + and variables. Personally I use @@ -2336,8 +2507,10 @@ following differences: will choose to descend into the subfolder view. If you wish to view the messages in that folder, you must use view-file instead (bound to space by default). -You can delete mailboxes with the delete-mailbox - command (bound to d by default. You may also +You can create, delete and rename mailboxes with the + create-mailbox, delete-mailbox, and + rename-mailbox commands (default bindings: C, + d and r, respectively). You may also subscribe and unsubscribe to mailboxes (normally these are bound to s and u, respectively). @@ -2366,15 +2539,15 @@ in the following order: SASL, ANONYMOUS, GSSAPI, CRAM-MD5, LOGIN. There are a few variables which control authentication: - - controls + - controls the username under which you request authentication on the IMAP server, for all authenticators. This is overridden by an explicit username in the mailbox path (ie by using a mailbox name of the form - a + - a password which you may preset, used by all authentication methods where a password is needed. - - a colon-delimited list of IMAP authentication methods to try, in the order you wish to try them. If specified, this overrides mutt's default (attempt everything, in the order @@ -2401,7 +2574,7 @@ account-hook imap://host2/ 'set tunnel="ssh host2 /usr/libexec/imapd"' Start a WWW Browser on URLs (EXTERNAL)

-If a message contains URLs (http://www.mutt.org/), it is efficient to get a menu with all the URLs and start a WWW browser on one of them. This functionality is provided by the external urlview program which can be @@ -2412,6 +2585,168 @@ macro index \cb |urlview\n macro pager \cb |urlview\n +Compressed folders Support (OPTIONAL) +

+ +If Mutt was compiled with compressed folders support (by running the +, + and ) which define commands to uncompress and compress +a folder and to append messages to an existing compressed folder +respectively. + +For example: + + +open-hook \\.gz$ "gzip -cd %f > %t" +close-hook \\.gz$ "gzip -c %t > %f" +append-hook \\.gz$ "gzip -c %t >> %f" + + +You do not have to specify all of the commands. If you omit , the folder will be open and +closed again each time you will add to it. If you omit (or give empty command) , the +folder will be open in the mode. If you specify though you'll be able to append +to the folder. + +Note that Mutt will only try to use hooks if the file is not in one of +the accepted formats. In particular, if the file is empty, mutt +supposes it is not compressed. This is important because it allows the +use of programs that do not have well defined extensions. Just use +&dquot;.&dquot; 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. + +Open a compressed mailbox for reading

+Usage: +open-hook \\.gz$ "gzip -cd %f > %t" + + +If the Write a compressed mailbox

+Usage: command after some changes were made to it. + +The command. Temporary folder +in this case is the folder previously produced by the < command. + +The +close-hook \\.gz$ "gzip -c %t > %f" + + +If the is not called when you exit +from the folder if the folder was not changed. + +Append a message to a compressed mailbox

+Usage: command. +The temporary folder in this case contains the messages that are being +appended. + +The +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 () type is always supposed (i.e. +this is the format used for the temporary folder). + +If the file does not exist when you save to it, is called, and not . is only +for appending to existing folders. + +If the and respectively) each time you will add to it. + +Encrypted folders +

+The compressed folders support can also be used to handle encrypted +folders. If you want to encrypt a folder with PGP, you may want to use +the following hooks: + + +open-hook \\.pgp$ "pgp -f < %f > %t" +close-hook \\.pgp$ "pgp -fe YourPgpUserIdOrKeyId < %t > %f" + + +Please note, that PGP does not support appending to an encrypted +folder, so there is no append-hook defined. + +Mutt's MIME Support

Quite a bit of effort has been made to make Mutt the premier text-mode @@ -2915,7 +3250,7 @@ associated with this extension will then be used to process the attachment according to the rules in the mailcap file and according to any other 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 In addition, the unmime_lookup command may be used to disable this feature @@ -2991,6 +3326,8 @@ The following are the commands understood by mutt. + + - - @@ -3045,6 +3384,8 @@ The following are the commands understood by mutt. + + [no|inv] - + + -