Factor trim format function out

[mmh] / man / refile.man1

diff --git a/man/refile.man1 b/man/refile.man1
index 5e837f5..2909230 100644 (file)
--- a/man/refile.man1
+++ b/man/refile.man1
@@ -3,7 +3,7 @@
 .\"
 .TH REFILE %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
-refile \- file message in other folders
+refile \- file messages in other folders
 .SH SYNOPSIS
 .HP 5
 .na
@@ -16,7 +16,7 @@ refile \- file message in other folders
 .IR file ]
 .I +folder1
 \&...
-.RB [ \-version ]
+.RB [ \-Version ]
 .RB [ \-help ]
 .ad
 .SH DESCRIPTION
@@ -38,7 +38,7 @@ multiply\-index messages.  For example, if a message is received from
 Jones about the ARPA Map Project, the command
 .PP
 .RS 5
-refile\0cur\0+jones\0+Map
+refile\0c\0+jones\0+Map
 .RE
 .PP
 would allow the message to be found in either of the two folders `jones'
@@ -49,7 +49,7 @@ You may specify the source folder using
 .IR +folder .
 If this is
 not given, the current folder is used by default.  If no message is
-specified, then `cur' is used by default.
+specified, then the current message is used by default.
 .PP
 The option
 .B \-file
@@ -60,12 +60,12 @@ to use the specified file
 as the source message to be filed, rather than a message from a folder.
 Note that the file should be a validly formatted message, just like
 any other
-.B nmh
+.B mh
 message.  It should
 .B NOT
 be in mail drop format
 (to convert a file in mail drop format to a folder of
-.B nmh
+.B mh
 messages,
 see
 .BR inc (1)).
@@ -81,7 +81,7 @@ is
 a tty, then
 .B refile
 will not ask any questions and will proceed as if the user answered
-\*(lqyes\*(rq to all questions.
+`yes' to all questions.
 .PP
 The option
 .B \-link
@@ -119,26 +119,30 @@ folder(1), rmf(1), rmm(1)
 
 .SH DEFAULTS
 .nf
-.RB ` "\-src\ +folder" "' defaults to the current folder"
-.RB ` msgs "' defaults to cur"
+.RB ` "\-src\ \fI+folder\fP" "' defaults to the current folder"
+.RB ` msgs "' defaults to the current message"
 .RB ` \-nolink '
 .fi
 
 .SH CONTEXT
 If
-.B \-src
-.I +folder
-is given, it will become the current folder.
-If
 .B \-link
 is specified, the current message in the
 source folder will be set to the last message specified; otherwise, the
 current message won't be changed.
 .PP
-If the \*(lqPrevious\-Sequence\*(rq profile entry is set, in addition to defining
+If the `Previous\-Sequence' profile entry is set, in addition to defining
 the named sequences from the source folder,
 .B refile
 will also define
 those sequences for the destination folders.  See
 .B mh\-sequence (7)
 for information concerning the previous sequence.
+
+.SH HISTORY
+Since mmh-0.3,
+.B refile
+does never change the current folder.
+(It used to change it when
+.BI \-src\  +folder
+was given, but this behavior had usability disadvantages.)