Factor trim format function out
[mmh] / man / mhpath.man1
index 3cdcf50..1729565 100644 (file)
@@ -3,14 +3,14 @@
 .\"
 .TH MHPATH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
-mhpath \- print full pathnames of nmh messages and folders
+mhpath \- print full pathnames of mh messages and folders
 .SH SYNOPSIS
 .HP 5
 .na
 .B mhpath
 .RI [ +folder ]
 .RI [ msgs ]
-.RB [ \-version ]
+.RB [ \-Version ]
 .RB [ \-help ]
 .ad
 .SH DESCRIPTION
@@ -21,27 +21,27 @@ If no `msgs' are specified,
 .B mhpath
 outputs the current mail folder's pathname
 instead.  If the only argument is `+', your mail storage location
-(\*(lqPath\*(rq) is output; this can be useful in shell scripts.
+(`Path') is output; this can be useful in shell scripts.
 .PP
 Contrasted with other
-.B nmh
+.B mmh
 commands, a message argument to
 .B mhpath
 may often be intended for writing.  Because of this:
 .PP
 .IP 1) 4
-the name \*(lqnew\*(rq has been added to
+the name `b' has been added to
 .BR mhpath 's
 list of
-reserved message names (the others are \*(lqfirst\*(rq, \*(lqlast\*(rq,
-\*(lqprev\*(rq, \*(lqnext\*(rq, \*(lqcur\*(rq, and \*(lqall\*(rq).
-The new message is equivalent to the message after the last message
+reserved message names (the others are `f', `l',
+`p', `n', `c', and `a').
+The `b' (beyond) message is equivalent to the message after the last message
 in a folder (and equivalent to 1 in a folder without messages).
-The \*(lqnew\*(rq message may not be used as part of a message range.
+The `b' message may not be used as part of a message range.
 .IP 2) 4
 Within a message list, the following designations may refer to messages
 that do not exist: a single numeric message name, the single message name
-\*(lqcur\*(rq, and (obviously) the single message name \*(lqnew\*(rq.
+`c', and (obviously) the single message name `b'.
 All other message designations must refer to at least one existing
 message, if the folder contains messages.
 .IP 3) 4
@@ -59,7 +59,7 @@ Cur is 4.
 % mhpath
 /r/phyl/Mail/foo
 
-% mhpath all
+% mhpath a
 /r/phyl/Mail/foo/3
 /r/phyl/Mail/foo/5
 /r/phyl/Mail/foo/6
@@ -72,23 +72,23 @@ Cur is 4.
 /r/phyl/Mail/foo/5
 /r/phyl/Mail/foo/6
 
-% mhpath new
+% mhpath b
 /r/phyl/Mail/foo/7
 
-% mhpath last new
+% mhpath l b
 /r/phyl/Mail/foo/6
 /r/phyl/Mail/foo/7
 
-% mhpath last\-new
-bad message list \*(lqlast\-new\*(rq.
+% mhpath l\-b
+bad message list `l\-b'.
 
-% mhpath cur
+% mhpath c
 /r/phyl/Mail/foo/4
 
 % mhpath 1\-2
-no messages in range \*(lq1\-2\*(rq.
+no messages in range `1\-2'.
 
-% mhpath first:2
+% mhpath f:2
 /r/phyl/Mail/foo/3
 /r/phyl/Mail/foo/5
 
@@ -141,7 +141,7 @@ None
 
 .SH BUGS
 Like all
-.B nmh
+.B mmh
 commands,
 .B mhpath
 expands and sorts