Functions The following is the list of available functions listed by the mapping in which they are available. The default key setting is given, and an explanation of what the function does. The key bindings of these functions can be changed with the bind command. generic The generic menu is not a real menu, but specifies common functions (such as movement) available in all menus except for pager and editor. Changing settings for this menu will affect the default bindings for all menus (except as noted). Reference: Default Generic Function Bindings Function Default Key Description L move to the bottom of the page move current entry to bottom of page move current entry to middle of page move current entry to top of page : enter a madmuttrc command q exit this menu = move to the first entry ] scroll down 1/2 page [ scroll up 1/2 page ? this screen number jump to an index number * move to the last entry M move to the middle of the page j move to the next entry > scroll down one line z move to the next page k move to the previous entry > scroll up one line Z move to the previous page cycle through all defined mailboxes to rebuild all header caches L clear and redraw the screen / search for a regular expression n search for next match search for next match in opposite direction / search backwards for a regular expression Return select the current entry ! run a program in a subshell t toggle the tag on the current entry ; apply next command to tagged entries apply next function ONLY to tagged messages H move to the top of the page display the keycode for a key press
index Reference: Default Index Function Bindings Function Default Key Description b remail a message to another user c open a different folder c open a different folder in read only mode P check for classic pgp W clear a status flag from a message C copy a message to a file/mailbox a create an alias from a message sender C decode a message and copy it to a file/mailbox s decode a message and save it to a file/mailbox d delete the current entry D delete messages matching a pattern d delete all messages in subthread D delete all messages in thread @ display full address of sender h display message and toggle header weeding Return display a message e edit the current message E edit the current message's Content-Type x exit without saving changes K extract PGP public keys G retrieve mail from POP server F toggle a message's 'important' flag F wipe PGP passphrase from memory f forward a message with comments g reply to all recipients l show only messages matching a pattern L reply to specified mailing list m compose a new mail message k mail a PGP public key jump to the next new message Tab jump to the next new or unread message n jump to the next subthread N jump to the next thread j move to the next undeleted message jump to the next unread message P jump to parent message in thread | pipe message/attachment to a shell command jump to the previous new message Tab jump to the previous new or unread message Z move to the previous page p jump to previous subthread P jump to previous thread k move to the last undelete message jump to the previous unread message p print the current entry Q query external program for addresses q save changes to mailbox and quit r mark the current subthread as read R mark the current thread as read R recall a postponed message r reply to a message e resend message and preserve MIME structure s save message/attachment to a file w set a status flag on a message V show the Madmutt version number and date l show currently active limit pattern, if any o sort messages O sort messages in reverse order $ save changes to mailbox T tag messages matching a pattern t tag/untag all messages in the current thread N toggle a message's 'new' flag % toggle whether the mailbox will be rewritten u undelete the current entry U undelete messages matching a pattern u undelete all messages in subthread U undelete all messages in thread T untag messages matching a pattern v show MIME attachments
pager Reference: Default Pager Function Bindings Function Default Key Description jump to the bottom of the message b remail a message to another user c open a different folder c open a different folder in read only mode P check for classic pgp C copy a message to a file/mailbox a create an alias from a message C decode a message and copy it to a file/mailbox s decode a message and save it to a file/mailbox d delete the current entry d delete all messages in subthread D delete all messages in thread @ display full address of sender h display message and toggle header weeding e edit the current message E edit the current message's Content-Type : enter a madmuttrc command i return to the main-menu K extract PGP public keys F toggle a message's 'important' flag F wipe PGP passphrase from memory f forward a message with comments g reply to all recipients move up one-half page move down one-half page ? this screen L reply to specified mailing list m compose a new mail message k mail a PGP public key N toggle a message's 'new' flag Return scroll down one line J move to the next entry jump to the next new message Tab jump to the next new or unread message move to the next page n jump to the next subthread N jump to the next thread j move to the next undeleted message jump to the next unread message P jump to parent message in thread | pipe message/attachment to a shell command BackSpace scroll up one line K move to the previous entry jump to the previous new message jump to the previous new or unread message - move to the previous page p jump to previous subthread P jump to previous thread k move to the last undelete message jump to the previous unread message p print the current entry Q save changes to mailbox and quit r mark the current subthread as read R mark the current thread as read R recall a postponed message L clear and redraw the screen r reply to a message s save message/attachment to a file / search for a regular expression n search for next match search for next match in opposite direction / search backwards for a regular expression \ toggle search pattern coloring ! invoke a command in a subshell V show the Madmutt version number and date S skip beyond quoted text $ save changes to mailbox t tag a message T toggle display of quoted text ^ jump to the top of the message u undelete the current entry u undelete all messages in subthread U undelete all messages in thread v show MIME attachments
alias Reference: Default Alias Menu Function Bindings Function Default Key Description / search for a regular expression n search for next match / search backwards for a regular expression
query Reference: Default Query Menu Function Bindings Function Default Key Description a create an alias from a message sender m compose a new mail message Q query external program for addresses A append new query results to current results / search for a regular expression n search for next match search for next match in opposite direction / search backwards for a regular expression
attach Reference: Default Attachment Menu Function Bindings Function Default Key Description b remail a message to another user v toggle display of subparts d delete the current entry h display message and toggle header weeding E edit the current entry's Content-Type K extract PGP public keys f forward a message with comments g reply to all recipients L reply to specified mailing list | pipe message/attachment to a shell command p print the current entry r reply to a message e resend message and preserve MIME structure s save message/attachment to a file u undelete the current entry Return view attachment using mailcap entry if necessary m force viewing of attachment using mailcap T view attachment as text
compose Reference: Default Compose Menu Function Bindings Function Default Key Description a attach a file(s) to this message A attach message(s) to this message k attach a PGP public key C save message/attachment to a file D delete the current entry h display message and toggle header weeding b edit the BCC list c edit the CC list d edit attachment description E edit attachment transfer-encoding f enter a file to save a copy of this message in f edit the from: field X e edit the file to be attached E edit the message with headers e edit the message m edit attachment using mailcap entry r edit the Reply-To field s edit the subject of this message t edit the TO list T edit attachment type F filter attachment through a shell command F wipe PGP passphrase from memory i run ispell on the message n compose new attachment using mailcap entry p show PGP options | pipe message/attachment to a shell command P save this message to send later l print the current entry R rename/move an attached file y send the message u toggle whether to delete file after sending it Return view attachment using mailcap entry if necessary w write the message to a folder
postpone Reference: Default Postpone Menu Function Bindings Function Default Key Description d delete the current entry u undelete the current entry
browser Reference: Default Browser Menu Function Bindings Function Default Key Description c change directories Tab check mailboxes for new mail m enter a file mask / search for a regular expression n search for next match / search backwards for a regular expression N select a new file in this directory o sort messages O sort messages in reverse order Tab toggle whether to browse mailboxes or all files Space view file s subscribe to current mailbox (IMAP Only) u unsubscribe to current mailbox (IMAP Only) T toggle view all/subscribed mailboxes (IMAP Only)
pgp Reference: Default PGP Menu Function Bindings Function Default Key Description % view the key's user id c verify a PGP public key
editor Reference: Default Editor Function Bindings Function Default Key Description BackSpace delete the char in front of the cursor B move the cursor one character to the left b move the cursor to the previous word A jump to the beginning of the line Space cycle among incoming mailboxes c uppercase the first character in the word Tab complete filename or alias T complete address with query D delete the char under the cursor l lowercase all characters in current word E jump to the end of the line F move the cursor one character to the right f move the cursor to the next word scroll down through the history list scroll up through the history list K delete chars from cursor to end of line d delete chars from cursor to end of word U delete all chars on the line W delete the word in front of the cursor V quote the next typed key transpose character under cursor with previous u uppercase all characters in current word
sidebar Referene: Default Sidebar Function Bindings Key Function Description Scrolls the mailbox list up 1 page Scrolls the mailbox list down 1 page Highlights the next mailbox Highlights the next mailbox with new mail Highlights the previous mailbox Opens the currently highlighted mailbox
Acknowledgments Kari Hurtta kari.hurtta@fmi.fi co-developed the original MIME >parsing code back in the ELM-ME days. The following people have been very helpful to the development of Mutt (sorted by surnames): Vikas Agnihotri vikasa@writeme.com Francois Berjon Francois.Berjon@aar.alcatel-alsthom.fr Aric Blumer aric@fore.com John Capo jc@irbs.com David Champion dgc@uchicago.edu Brendan Cully brendan@kublai.com Liviu Daia daia@stoilow.imar.ro Thomas E. Dickey dickey@herndon4.his.com David DeSimone fox@convex.hp.com Nickolay N. Dudorov nnd@wint.itfs.nsk.su Ruslan Ermilov ru@freebsd.org Edmund Grimley Evans edmundo@rano.org Michael Finken finken@conware.de Sven Guckes guckes@math.fu-berlin.de Lars Hecking lhecking@nmrc.ie Mark Holloman holloman@nando.net Andreas Holzmann holzmann@fmi.uni-passau.de Marco d'Itri md@linux.it Björn Jacke bjacke@suse.com Byrial Jensen byrial@image.dk David Jeske jeske@igcom.net Christophe Kalt kalt@hugo.int-evry.fr Tommi Komulainen Tommi.Komulainen@iki.fi Felix von Leitner (a.k.a ``Fefe'') leitner@math.fu-berlin.de Brandon Long blong@fiction.net Jimmy Mäkeä jmy@flashback.net Lars Marowsky-Bree lmb@pointer.in-minden.de Thomas ``Mike'' Michlmayr mike@cosy.sbg.ac.at Andrew W. Nosenko awn@bcs.zp.ua David O'Brien obrien@Nuxi.cs.ucdavis.edu Clint Olsen olsenc@ichips.intel.com Park Myeong Seok pms@romance.kaist.ac.kr Thomas Parmelan tom@ankh.fr.eu.org Ollivier Robert roberto@keltia.freenix.fr Thomas Roessler roessler@does-not-exist.org Roland Rosenfeld roland@spinnaker.de TAKIZAWA Takashi taki@luna.email.ne.jp Allain Thivillon Allain.Thivillon@alma.fr Gero Treuner gero@70t.de Vsevolod Volkov vvv@lucky.net Ken Weinert kenw@ihs.com Madmutt is developed by the following people: Andreas Krennmair ak@synflood.at Nico Golde nico@ngolde.de Rocco Rutte pdmef@cs.tu-berlin.de The following people have been very helpful to the development of Madmutt (sorted by surnames): Christian Gall cg@cgall.de Iain Lea iain@bricbrac.de Andreas Kneib akneib@gmx.net Felix Meinhold felix.meinhold@gmx.net Carsten Schoelzki cjs@weisshuhn.de Elimar Riesebieter riesebie@lxtec.de Hacking Documentation This manual is written in XML and transformed via a XSLT stylesheet into valid DocBook/XML and/or to be again transformed via a XSLT stylesheet into the final formats. This two pass processing is required to keep the file size low and to sanitize use, i.e. drastically lower the typing overhead. To achieve the latter, the sources come with a file called madmutt-manual.xsl introducing the madmutt-doc namespace which offers the following tags to be used (note: this is far from being complete, any help towards consistency is highly appreciated). <madmutt-doc:man name="" [sect=""]/> References to manual pages. If the sect parameter is omitted, it'll be 1 for the commands section. There's no auto-indexing yet. <madmutt-doc:envvar name=""/> References to environment variables. The name parameter must contain upper-case letters only without the dollar sign as it'll be added automatically. Auto-indexing is done. <madmutt-doc:hook name=""/> References to hooks. The string -hook will be added automatically to the value given in the name parameter. All entries will be auto-indexed. <madmutt-doc:pattern name="" [full="1"]/> References to patterns. The name parameter must only contain the letter/symbol for the pattern as the tilde symbol/equal sign will be added automatically. Auto-indexing is done. If the full parameter is given the equal sign as well as tilde will be printed for a fully complete reference. <madmutt-doc:key [mod="C|E"]>key</madmutt-doc:key> Referencing a key.. Because it's somewhat untrivial to always get the right escaping for , there's a tag for it. The optional modifiers C or E stand for Control and Escape respectively. To still allow escaping, the actual key sequences must be given within the tag. <madmutt-doc:funcdef name=""/> Defining a command.. It's used to define a command with the name given in the name parameter. The default key binding must be given via <madmutt-doc:key/> (see above). The string will be automatically enclosed in <>. Auto-indexing is done. Also an anchor with id func-[name] will be added with [name] being the value of the name parameter. <madmutt-doc:funcref name=""/> References to functions.. This is practically the same as the above except that there's no anchor defined. <madmutt-doc:vardef name=""/> Defining a variable. This is to be used by makedoc only to define a command with a given name and XML-normalized link given via id. Auto-indexing is done. The name parameter's value will be prefixed with a dollar sign as for environment variables. <madmutt-doc:varref name=""/> References to variables. This practically is the same as above except that the text inbetween won't be wrapped within a <sect1> tag. Auto-indexing is the same as for the above. This one is intended for manual use. <madmutt-doc:web url""/> Pretty print a linked URL. As for E-Mail addresses where the text (mostly) equals the link's target, URLs must be enclosed in <> (also this reduced redudant URL typing). <madmutt-doc:rfc num=""/> References to RfC documents. Use this to produce links to RfC document with number given as the num parameter. A link to will be made. Auto-indexing is done under RfC. <madmutt-doc:cmddef name="" [noanchor="1"]/> Defining a configuration command. The name of the command is given as the name parameter. In case a single command has multiple possible calling sequences, specify noanchor="1" for subsequent use. Auto-indexing is done. Specify the arguments within the tag. <madmutt-doc:cmdref name=""/> References to configuration commands. Use this to refer to commands as it builds the proper internal reference name. Auto-indexing is done. <madmutt-doc:lstconf/>, <madmutt-doc:lstmail/>, <madmutt-doc:lstshell/> Screen layout by context. These are used to specify environments for different types of screen output. For DocBook output, all of these simply map to <screen/>. But as a possible future migration to LaTeX may be ahead, different languages defined for the listings.sty packages may be used to have proper syntax highlighting for these so that there must be a context sensitive distinction. <madmutt-doc:special [docbook=""] [latex=""]/> This is intended for specifying special strings for either DocBook/XML or . Additional notes follow. To not fully bloat the XSL stylesheet procuding the code, all tables must have an attribute called texstr which is directly passed to longtable.