X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/c59d387888272695ccf163a8057275dbdc77afd0..07661005b9a36338ab158bcbe7762788a1df4030:/man/rmm.man diff --git a/man/rmm.man b/man/rmm.man index 3e7e3930..d1b12c83 100644 --- a/man/rmm.man +++ b/man/rmm.man @@ -1,4 +1,4 @@ -.TH RMM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] +.TH RMM %manext1% "March 18, 2013" "%nmhversion%" .\" .\" %nmhwarning% .\" @@ -11,6 +11,9 @@ rmm \- remove messages .RI [ +folder ] .RI [ msgs ] .RB [ \-unlink " | " \-nounlink ] +.RB [ \-rmmproc +.IR program ] +.RB [ \-normmproc ] .RB [ \-version ] .RB [ \-help ] .ad @@ -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,7 +89,7 @@ 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 ^ ~ @@ -99,8 +118,10 @@ advance to the next message in the folder as expected. 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 @@ -108,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.