X-Git-Url: http://git.madism.org/?p=apps%2Fmadmutt.git;a=blobdiff_plain;f=doc%2Fmanual.xml.head;fp=doc%2Fmanual.xml.head;h=f41e61e95f4c790ea71eaf1e7fccb15cfe5ae1e5;hp=fc5033fed01af1736473ed73b2a3c9be061cdb44;hb=6f41c52076e60ae7f2b6337b7dc9ea3fa23400e2;hpb=e615c78675dad2429c57862aa097c42160534c67 diff --git a/doc/manual.xml.head b/doc/manual.xml.head index fc5033f..f41e61e 100644 --- a/doc/manual.xml.head +++ b/doc/manual.xml.head @@ -187,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 @@ -201,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. + + @@ -688,7 +702,7 @@ - +
Most commonly used movement bindings @@ -700,42 +714,42 @@ - j or Down + j or Down move to the next entry - k or Up + k or Up move to the previous entry - z or PageDn + z or PageDn go to the next page - Z or PageUp + Z or PageUp go to the previous page - = or Home + = or Home jump to the first entry - * or End + * or End jump to the last entry - q + q exit the current menu - ? + ? list all key bindings for the current menu @@ -766,7 +780,7 @@ -
+
Line Editor Functions @@ -778,113 +792,113 @@ - ^A or <Home> + A or Home move to the start of the line - ^B or <Left> + B or Left move back one char - Esc B + B move back one word - ^D or <Delete> + D or Delete delete the char under the cursor - ^E or <End> + E or End move to the end of the line - ^F or <Right> + F or Right move forward one char - Esc F + F move forward one word - <Tab> + Tab complete filename or alias - ^T + T complete address with query - ^K + K delete to the end of the line - ESC d + d delete to the end of the word - ^W + W kill the word in front of the cursor - ^U + U delete entire line - ^V + V quote the next typed key - <Up> + Up recall previous string from history - <Down> + Down recall next string from history - <BackSpace> + BackSpace kill the char in front of the cursor - Esc u + u convert word to upper case - Esc l + l convert word to lower case - Esc c + c capitalize the word - ^G - n/a + G + abort - <Return> - n/a + Return + finish editing @@ -928,7 +942,7 @@ -
+
Most commonly used Index Bindings @@ -940,147 +954,147 @@ - c + c change to a different mailbox - ESC c + c change to a folder in read-only mode - C + C copy the current message to another mailbox - ESC C + C decode a message and copy it to a folder - ESC s + s decode a message and save it to a folder - D + D delete messages matching a pattern - d + d delete the current message - F + F mark as important - l + l show messages matching a pattern - N + N mark message as new - o + o change the current sort method - O + O reverse sort the mailbox - q + q save changes and exit - s + s save-message - T + T tag messages matching a pattern - t + t toggle the tag on a message - ESC t + t toggle tag on entire message thread - U + U undelete messages matching a pattern - u + u undelete-message - v + v view-attachments - x + x abort changes and exit - <Return> + Return display-message - <Tab> + Tab jump to the next new or unread message - @ + @ show the author's full e-mail address - $ + $ save changes to mailbox - / + / search - ESC / + / search-reverse - ^L + L clear and redraw the screen - ^T + T untag messages matching a pattern @@ -1287,7 +1301,7 @@ -
+
Most commonly used Pager Bindings @@ -1299,57 +1313,57 @@ - <Return> + Return go down one line - <Space> + Space display the next page (or next message if at the end of a message) - - + - go back to the previous page - n + n search for next match - S + S skip beyond quoted text - T + T toggle display of quoted text - ? + ? show key bindings - / + / search for a regular expression (pattern) - ESC / + / search backwards for a regular expression - \ + \ toggle search pattern coloring - ^ + ^ jump to the top of the message @@ -1370,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. @@ -1395,7 +1408,7 @@ -
+
ANSI Escape Sequences @@ -1438,7 +1451,7 @@
- +
ANSI Colors @@ -1514,7 +1527,7 @@ -
+
Most commonly used thread-related bindings @@ -1526,72 +1539,72 @@ - ^D + D delete all messages in the current thread - ^U + U undelete all messages in the current thread - ^N + N jump to the start of the next thread - ^P + P jump to the start of the previous thread - ^R + R mark the current thread as read - ESC d + d delete all messages in the current subthread - ESC u + u undelete all messages in the current subthread - ESC n + n jump to the start of the next subthread - ESC p + p jump to the start of the previous subthread - ESC r + r mark the current subthread as read - ESC t + t toggle the tag on the current thread - ESC v + v toggle collapse for the current thread - ESC V + V toggle collapse for all threads - P + P jump to parent message in thread @@ -1628,7 +1641,7 @@ Miscellaneous Functions - + a @@ -1642,7 +1655,7 @@ - + P @@ -1656,7 +1669,7 @@ - + h @@ -1665,7 +1678,7 @@ - + e @@ -1678,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) @@ -1699,7 +1712,7 @@ - + : @@ -1713,7 +1726,7 @@ - + K @@ -1722,7 +1735,7 @@ - + F @@ -1731,7 +1744,7 @@ - + L @@ -1763,7 +1776,7 @@ - + e @@ -1786,7 +1799,7 @@ - + ! @@ -1800,7 +1813,7 @@ - + T @@ -1815,7 +1828,7 @@ - + S @@ -1843,7 +1856,7 @@ -
+
Most commonly used Mail Composition Bindings @@ -1855,37 +1868,37 @@ - m + m compose a new message - r + r reply to sender - g + g reply to all recipients - L + L reply to mailing list address - f + f forward message - b + b bounce (remail) message - ESC k + k mail a PGP public key to someone @@ -1906,7 +1919,7 @@ 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: @@ -1976,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 @@ -2010,7 +2023,7 @@ set edit_headers -
+
Most commonly used Compose Menu Bindings @@ -2022,102 +2035,102 @@ set edit_headers - a + a attach a file - A + A attach message(s) to the message - ESC k + k attach a PGP public key - d + d edit description on attachment - D + D detach a file - t + t edit the To field - ESC f + f edit the From field - r + r edit the Reply-To field - c + c edit the Cc field - b + b edit the Bcc field - y + y send the message - s + s edit the Subject - S + S select S/MIME options - f + f specify an ``Fcc'' mailbox - p + p select PGP options - P + P postpone this message until later - q + q quit (abort) sending the message - w + w write the message to a folder - i + i check spelling (if available on your system) - ^F + F wipe passphrase(s) from memory @@ -2154,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 @@ -2239,8 +2252,8 @@ set attribution = "attribution="* %n <%a> [%(%y-%m-%d %H:%M)]:"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. @@ -2263,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 @@ -2378,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. @@ -2401,7 +2414,7 @@ Pgp: [E | S | S id] flags: -
+
PGP Key Menu Flags @@ -2511,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 @@ -2562,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 @@ -2573,11 +2586,11 @@ 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 @@ -2599,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 @@ -3500,7 +3513,7 @@ set alias_file=~/.mail_aliases -
+
Alternative Key Names @@ -3515,11 +3528,11 @@ set alias_file=~/.mail_aliasestab - <tab> + <tab> tab - <backtab> + <backtab> backtab / shift-tab @@ -3535,71 +3548,71 @@ set alias_file=~/.mail_aliases escape - <esc> + <esc> escape - <up> + <up> up arrow - <down> + <down> down arrow - <left> + <left> left arrow - <right> + <right> right arrow - <pageup> + <pageup> Page Up - <pagedown> + <pagedown> Page Down - <backspace> + <backspace> Backspace - <delete> + <delete> Delete - <insert> + <insert> Insert - <enter> + <enter> Enter - <return> + <return> Return - <home> + <home> Home - <end> + <end> End - <space> + <space> Space bar - <f1> + <f1> function key 1 - <f10> + <f10> function key 10 @@ -3755,22 +3768,18 @@ folder-hook . set sort=date-sent - key and sequence are expanded - by the same rules as the . There are - some additions however. The - first is that control characters in sequence can - also be specified - as ^x. In order to get a caret (`^'') - you need to use - ^^. Secondly, to specify a certain key - such as up - or to invoke a function directly, you can use the format + key and sequence are + expanded by the same rules as the . There are some additions however. The first + is that control characters in sequence can + also be specified as ^x. In order to get a + caret (`^'') you need to specify it twice. Secondly, + to specify a certain key such as up or to + invoke a function directly, you can use the format <key name> and <function - name> - - .For a listing of key - names see the section on . Functions - are listed in the functions. + name> .For a listing of key names see the + section on . Functions are + listed in the functions. @@ -4830,16 +4839,18 @@ save-hook aol\\.com$ +spam - Example: [@.]aol\\.com$ - +spammers - + Example: + + + + +fcc-hook [@.]aol\\.com$ +spammers - The above will save a copy of all messages going to the aol.com domain - to - the `+spammers' mailbox by default. Also see the - command. + The above will save a copy of all messages going to the aol.com + domain to the `+spammers' mailbox by default. Also see the + command. @@ -4988,8 +4999,8 @@ save-hook aol\\.com$ +spam Example: -message-hook 'set pager=builtin' -message-hook ' freshmeat-news' 'set pager="less \"+/^ subject:.*\""' +message-hook ~A 'set pager=builtin' +message-hook '~f freshmeat-news' 'set pager="less \"+/^ subject:.*\""' @@ -5047,8 +5058,7 @@ message-hook ' freshmeat-news' 'set pager="less \" will automatically collapse all threads when entering a folder: -folder-hook . 'push <collapse-all>' - +folder-hook . 'push <collapse-all>' @@ -5108,8 +5118,8 @@ folder-hook . 'push <collapse-all>' -score " nion@muttng\.org" 50 -score " @sco\.com" -100 +score "~f nion@muttng\.org" 50 +score "~f @sco\.com" -100 @@ -5122,7 +5132,7 @@ score " @sco\.com" -100 -score " santaclaus@northpole\.int" =666 +score "~f santaclaus@northpole\.int" =666 @@ -5197,8 +5207,8 @@ score " santaclaus@northpole\.int" =666 -color index black yellow " 10-" -color index red yellow " 100-" +color index black yellow "~n 10-" +color index red yellow "~n 100-" @@ -6269,7 +6279,7 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses' It must be noted that in this table, EXPR is a regular expression. For ranges, the forms - <[MAX], >>[MIN], + <[MAX], >>[MIN], [MIN]- and -[MAX] are also possible. @@ -6576,7 +6586,7 @@ set status_format = "%v on %h: %B %?n?%n new? ... -%?<item>?<string if nonzero>? +%?<item>?<string if nonzero>? @@ -6602,7 +6612,7 @@ set status_format = "%v on %h: %B %?n?%n new? ... -%?<item>?<string if nonzero>&<string if zero>? +%?<item>?<string if nonzero>&<string if zero>? @@ -6765,7 +6775,7 @@ set status_format = "%v on %h: %B: %?n?%n&no? new messages %|-" -set status_format = "%B: %?n?%n&no? new messages %> (%v on %h)" +set status_format = "%B: %?n?%n&no? new messages %> (%v on %h)" @@ -6912,7 +6922,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 '~C ^b@b\.b$' my-hdr from: c@c.c @@ -6946,7 +6956,7 @@ send-hook '^b@b\.b$' my-hdr from: c@c.c -send-hook ' ^me@cs\.hmc\.edu$' 'my-hdr From: Mutt-ng User <user@host>' +send-hook '~t ^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. @@ -7841,7 +7851,7 @@ imap://imapserver:port/INBOX 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. @@ -7881,7 +7891,7 @@ imap://imapserver:port/INBOX -score =42 +score ~* =42 @@ -7893,7 +7903,7 @@ score =42 -score ! =42 +score !~* =42 @@ -8093,9 +8103,9 @@ 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" @@ -8164,8 +8174,7 @@ append-hook \\.gz$ "gzip -c %t >> %f" -open-hook \\.gz$ "gzip -cd %f > %t" - +open-hook \\.gz$ "gzip -cd %f > %t" @@ -8214,7 +8223,7 @@ open-hook \\.gz$ "gzip -cd %f > %t" -close-hook \\.gz$ "gzip -c %t > %f" +close-hook \\.gz$ "gzip -c %t > %f" @@ -8264,7 +8273,7 @@ close-hook \\.gz$ "gzip -c %t > %f" -append-hook \\.gz$ "gzip -c %t >> %f" +append-hook \\.gz$ "gzip -c %t >> %f" @@ -8306,9 +8315,8 @@ 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" @@ -8456,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> @@ -9066,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)' @@ -9083,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 @@ -9109,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 @@ -9551,7 +9559,7 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg -
+
Reference: Command Line Options @@ -9719,7 +9727,7 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg -
+
Reference: Patterns @@ -10331,7 +10339,7 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg -
+
Reference: Obsolete Variables