X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/1b5a1bd2244d3e1c12b7c9e1f48e445de5ad2ea2..07661005b9a36338ab158bcbe7762788a1df4030:/man/rmm.man

diff --git a/man/rmm.man b/man/rmm.man
index d8cdf8bc..d1b12c83 100644
--- a/man/rmm.man
+++ b/man/rmm.man
@@ -1,8 +1,7 @@
+.TH RMM %manext1% "March 18, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
-.TH RMM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 rmm \- remove messages
 .SH SYNOPSIS
@@ -11,7 +10,10 @@ rmm \- remove messages
 .B rmm
 .RI [ +folder ]
 .RI [ msgs ]
-.RB [ \-link " | " \-nolink ]
+.RB [ \-unlink " | " \-nounlink ]
+.RB [ \-rmmproc
+.IR program ]
+.RB [ \-normmproc ]
 .RB [ \-version ]
 .RB [ \-help ]
 .ad
@@ -19,7 +21,8 @@ rmm \- remove messages
 By default,
 .B rmm
 will remove the specified messages by renaming
-the message files with preceding commas.  Such files will then need to
+each of the message files with a site-dependent prefix (usually a
+comma).  Such files will then need to
 be removed in some manner after a certain amount of time.  Many sites
 arrange for
 .B cron
@@ -44,11 +47,27 @@ add a profile component such as
 rmmproc:	/home/foouser/bin/rmm_msgs
 .RE
 .PP
-then instead of simply renaming the message file,
+Then instead of simply renaming the message file,
 .B rmm
 will call
 the named program or script to handle the files that represent the
 messages to be deleted.
+The
+.B \-rmmproc
+switch may be used to override this profile component.  The
+.B \-normmproc
+switch disables the use of any
+.I rmmproc
+profile component and negates all prior
+.B \-rmmproc
+switches.
+.PP
+An example of a
+.I rmmproc
+script that saves a message based in its Message-ID is provided in
+%etcdir%/rmmproc.messageid.  To enable it, simply add a
+.I rmmproc
+component that names it to your profile.
 .PP
 Some users of
 .B csh
@@ -70,16 +89,14 @@ The current message is not changed by
 .BR rmm ,
 so a
 .B next
- will
+will
 advance to the next message in the folder as expected.
-
 .SH FILES
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -89,24 +106,22 @@ advance to the next message in the folder as expected.
 ^Current\-Folder:~^To find the default current folder
 ^rmmproc:~^Program to delete the message
 .fi
-
 .SH "SEE ALSO"
-refile(1), rmf(1)
-
+.IR rmf (1)
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to the current folder"
 .RB ` msgs "' defaults to cur"
 .RB ` -nounlink '
 .fi
-
 .SH CONTEXT
 If a folder is given, it will become the current folder.
-
 .SH BUGS
 Since
+.B rmm
+and
 .B refile
-uses your
+use your
 .I rmmproc
 to delete the message,
 the
@@ -114,7 +129,9 @@ the
 must
 .B NOT
 call
+.B rmm
+or
 .B refile
 without specifying
 .BR \-normmproc ,
-or you will create an infinte loop.
+or you will create an infinite loop.