From: Rocco Rutte Date: Mon, 5 Nov 2007 13:53:11 +0000 (+0100) Subject: Manual: Improve [un]mailboxes documentation. Closes #2204. X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=610ff724d2395ccbd19eb20c98f575f3b34237eb;p=neomutt Manual: Improve [un]mailboxes documentation. Closes #2204. --- diff --git a/ChangeLog b/ChangeLog index d3c1880a7..9fbd86806 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,18 @@ +2007-11-05 14:52 +0100 Rocco Rutte (3bac5aa1af75) + + * hg-commit: hg-commit: Exclude merges when writing ChangeLog + +2007-11-05 12:11 +0100 Ralf Wildenhues (645fcdd66828) + + * configure.ac, intl/Makefile.in, po/Makefile.in.in: Optionally define + $datarootdir on our own for autoconf <2.60 compatibility. While I'm + at it, fix two warnings in other files about ignoring datarootdir + with autoconf >2.60. Closes #2905. + +2007-11-04 13:19 -0800 Vsevolod Volkov (dc5ec6dbb278) + + * ChangeLog, po/ru.po: Updated Russian translation + 2007-11-04 13:17 -0800 Ivan Vilata i Balaguer (1f72281eb36c) * po/ca.po: Updated Catalan translation diff --git a/doc/manual.xml.head b/doc/manual.xml.head index d6c422a69..f709c2a90 100644 --- a/doc/manual.xml.head +++ b/doc/manual.xml.head @@ -2495,10 +2495,10 @@ mailbox). -Defining mailboxes which receive mail +Monitoring incomming mail -Usage: [un]mailboxes [!]filename [ filename ... ] +Usage: [un]mailboxes [!]folder [ folder ... ] @@ -2508,6 +2508,15 @@ main menu status bar displays how many of these folders have new messages. + +folder can either be a local file or directory +(Mbox/Mmdf or Maildir/Mh). If Mutt was built with POP and/or IMAP +support, folder can also be a POP/IMAP folder +URL. The URL syntax is described in , +POP and IMAP are described in and +respectively. + + When changing folders, pressing space will cycle through folders with new mail. @@ -2527,18 +2536,29 @@ tokens. -Note: new mail is detected by comparing the last modification time to -the last access time. 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. Backup -tools are another common reason for updated access times. +Note: the folders in the mailboxes command are resolved when +the command is executed, so if these names contain shortcut characters (such as ``='' and ``!''), any variable +definition that affect these characters (like $folder and $spoolfile) +should be executed before the mailboxes command. If +none of these shorcuts are used, a local path should be absolute as +otherwise mutt tries to find it within the current working directory +from where mutt was started which may not always be desired. -Note: the filenames in the mailboxes command are resolved when -the command is executed, so if these names contain shortcut characters (such as ``='' and ``!''), any variable -definition that affect these characters (like $folder and $spoolfile) -should be executed before the mailboxes command. +For local folders, new mail is detected by comparing access and/or +modification times of files and folders. The interval in which Mutt +checks for new mail is defined by +$mail_check. + + + +Special care is required with Mbox and Mmdf +folders as Mutt assumes such 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. Backup tools are another common reason for updated access times.