From: Rocco Rutte Date: Mon, 29 Jun 2009 18:20:44 +0000 (+0000) Subject: Manual: Move new mail detection into its own section X-Git-Tag: neomutt-20160307~504 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=caa91aedcac8aba1f8c9e35c0709f5bd839b9851;p=neomutt Manual: Move new mail detection into its own section This also updates some parts of docs and adds missing ones. It also adds a note about the recent changes, also to UPDATING. --- diff --git a/UPDATING b/UPDATING index a41c54f84..6bbfdb7d6 100644 --- a/UPDATING +++ b/UPDATING @@ -10,6 +10,7 @@ hg tip: 1.5.20 (2009-06-14): + ! mbox/mmdf new mail flag is kept when leaving folders with new mail ! $fcc_attach is a quadoption now + $honor_disposition to honor Content-Disposition headers + $search_context specifies number of context lines for search results diff --git a/doc/manual.xml.head b/doc/manual.xml.head index cb0a3cf95..e3c1e1ce5 100644 --- a/doc/manual.xml.head +++ b/doc/manual.xml.head @@ -3099,7 +3099,7 @@ respectively. Mutt provides a number of advanced features for handling (possibly many) folders and new mail within them, please refer to - for details (including in what + for details (including in what situations and how often Mutt checks for new mail). @@ -3121,25 +3121,6 @@ from where Mutt was started which may not always be desired. - -For Mbox and Mmdf folders, new mail is detected by comparing access and/or -modification times of files: Mutt assumes a folder has new mail if it wasn't -accessed after it was last modified. Utilities like biff or -frm or any other program which accesses the mailbox might cause -Mutt to never detect new mail for that mailbox if they do not properly reset the -access time. Other possible causes of Mutt not detecting new mail in these folders -are backup tools (updating access times) or filesystems mounted without -access time update support. - - - -In cases where new mail detection for Mbox or Mmdf folders appears to be -unreliable, the -$check_mbox_size -option can be used to make Mutt track and consult file sizes for new -mail detection instead which won't work for size-neutral changes. - - @@ -5544,54 +5525,114 @@ uninteresting threads and quickly find topics of value. - -Handling multiple folders + +New Mail Detection + + +Mutt supports setups with multiple folders, allowing all of them to be +monitored for new mail (see for details). + + + +How New Mail Detection Works + + +For Mbox and Mmdf folders, new mail is detected by comparing access +and/or modification times of files: Mutt assumes a folder has new mail +if it wasn't accessed after it was last modified. Utilities like +biff or frm or any other program +which accesses the mailbox might cause Mutt to never detect new mail for +that mailbox if they do not properly reset the access time. Other +possible causes of Mutt not detecting new mail in these folders are +backup tools (updating access times) or filesystems mounted without +access time update support (for Linux systems, see the +relatime option). + + -Mutt supports setups with multiple folders, allowing all of them to -be monitored for new mail (see for details). +Contrary to older Mutt releases, it now maintains the new mail status of +a folder by properly resetting the access time if the folder contains at +least one message which is neither read, nor deleted, nor marked as old. + -When in the index menu and being idle (also see -$timeout), Mutt periodically checks -for new mail in all folders which have been configured via the +In cases where new mail detection for Mbox or Mmdf folders appears to be +unreliable, the $check_mbox_size +option can be used to make Mutt track and consult file sizes for new +mail detection instead which won't work for size-neutral changes. + + + +New mail for Maildir is assumed if there is one message in the +new/ subdirectory which is not marked deleted (see +$maildir_trash). For MH folders, a +mailbox is considered having new mail if there's at least one message in +the unseen sequence as specified by $mh_seq_unseen. + + + +Mutt does not poll POP3 folders for new mail, it only periodically +checks the currently opened folder (if it's a POP3 folder). + + + +For IMAP, by default Mutt uses recent message counts provided by the +server to detect new mail. If the $imap_idle option is set, it'll use the IMAP +IDLE extension if advertised by the server. + + + + + +Polling For New Mail + + +When in the index menu and being idle (also see $timeout), Mutt periodically checks for new +mail in all folders which have been configured via the mailboxes command. The interval depends on the folder -type: for local/IMAP folders it consults -$mail_check and -$pop_checkinterval -for POP folders. +type: for local/IMAP folders it consults $mail_check and $pop_checkinterval for POP folders. -Outside the index menu the directory browser supports checking -for new mail using the <check-new> function which is -unbound by default. Pressing TAB will bring up a -menu showing the files specified by the mailboxes command, -and indicate which contain new messages. Mutt will automatically enter this -mode when invoked from the command line with the -y option. +Outside the index menu the directory browser supports checking for new +mail using the <check-new> function which is +unbound by default. Pressing TAB will bring up a menu showing the files +specified by the mailboxes command, and indicate +which contain new messages. Mutt will automatically enter this mode when +invoked from the command line with the -y option. For the pager, index and directory browser menus, Mutt contains the -<buffy-list> function (bound to . by default) -which will print a list of folders with new mail in the command line at -the bottom of the screen. +<buffy-list> function (bound to +. by default) which will print a list of folders with new +mail in the command line at the bottom of the screen. For the index, by default Mutt displays the number of mailboxes with new -mail in the status bar, please refer to the -$status_format -variable for details. +mail in the status bar, please refer to the $status_format variable for details. When changing folders, Mutt fills the prompt with the first folder from the mailboxes list containing new mail (if any), pressing -space will cycle through folders with new mail. +<Space> will cycle through folders with new +mail. The (by default unbound) function +<mutt-unread-mailbox> in the index can be used +to immediately open the next folder with unread mail (if any). + +