From 9c6b9968baa6313051ea2eb2d69e220186004e1c Mon Sep 17 00:00:00 2001
From: Jerrad Pierce <belg4mit@pthbb.org>
Date: Fri, 30 Nov 2012 18:40:52 -0600
Subject: [PATCH] Added description of @folder format to nmh.man.

---
 man/nmh.man |   35 ++++++++++++++++++++++++++++++++++-
 1 file changed, 34 insertions(+), 1 deletion(-)

diff --git a/man/nmh.man b/man/nmh.man
index e15f1cd..c8414b9 100644
--- a/man/nmh.man
+++ b/man/nmh.man
@@ -1,4 +1,4 @@
-.TH NMH %manext7% "November 3, 2012" "%nmhversion%"
+.TH NMH %manext7% "November 30, 2012" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -149,6 +149,7 @@ Commands which take a message number as an argument
 \*(lqprev\*(rq, \*(lqcur\*(rq, \*(lqnext\*(rq, or \*(lqlast\*(rq to indicate
 (respectively) the first, previous, current, next, or last message in
 the current folder (assuming they are defined).
+As a shorthand, \*(lq\&.\*(rq is equivalent to \*(lqcur\*(rq.
 .PP
 Commands which take a range of message numbers
 .RB ( rmm ,
@@ -194,6 +195,38 @@ The first, previous, next or last
 messages, if they exist.
 .PD
 .PP
+Commands which take a folder name
+.RB ( inc ,
+.BR refile ,
+.BR scan ,
+.BR sortm ,
+\&...) accept the folder name in two formats: \*(lq+folder\*(rq or
+\*(lq@folder\*(rq.  \*(lq+folder\*(rq specifies a folder underneath
+the Path defined in your profile; e.g., with the usual
+.RI \*(lq "Path: Mail" \*(rq,
+\*(lq+folder\*(rq tells nmh to use
+\*(lqMail/folder\*(rq.  \*(lq@folder\*(rq specifies a path
+relative to the current folder specified in your \*(lqcontext\*(rq
+file; e.g., with
+.RI \*(lq "Current-Folder: inbox" \*(rq,
+and the same profile, \*(lq@folder\*(rq tells nmh to use
+\*(lqMail/inbox/folder\*(rq.  If folder begins with \*(lq.\*(rq or
+\*(lq/\*(rq when using \*(lq+folder\*(rq, the folder is interpreted as
+a specific path to a directory on the filesystem rather than a
+relative folder location.
+For example,
+.TP \n(ttu
+.PD 0
+.BI "scan +" .
+scans the current directory
+.TP
+.BI "scan +" ../<dir>
+scans the named sibling directory
+.TP
+.BI "refile +" /tmp
+refiles into the /tmp directory
+.PD
+.PP
 There are many other possibilities such as creating multiple folders
 for different topics, and automatically refiling messages according to
 subject, source, destination, or content.  These are beyond the scope
-- 
1.7.10.4