git.marmaro.de Git - mmh/blob - man/rmm.man

   1 .\"
   2 .\" %nmhwarning%
   3 .\"
   4 .TH RMM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
   5 .SH NAME
   6 rmm \- remove messages
   7 .SH SYNOPSIS
   8 .HP 5
   9 .na
  10 .B rmm
  11 .RI [ +folder ]
  12 .RI [ msgs ]
  13 .RB [ \-unlink " | " \-nounlink ]
  14 .RB [ \-version ]
  15 .RB [ \-help ]
  16 .ad
  17 .SH DESCRIPTION
  18 By default,
  19 .B rmm
  20 will remove the specified messages by renaming
  21 the message files with preceding commas.  Such files will then need to
  22 be removed in some manner after a certain amount of time.  Many sites
  23 arrange for
  24 .B cron
  25 to remove these files once a day, so check
  26 with your system administrator.
  27 .PP
  28 Alternately, if you wish for
  29 .B rmm
  30 to really remove the files
  31 representing these messages, you can use the
  32 .B \-unlink
  33 switch.  But
  34 messages removed by this method cannot be later recovered.
  35 .PP
  36 If you prefer a more sophisticated method of `removing' messages, you
  37 can define the
  38 .I rmmproc
  39 profile component.  For example, you can
  40 add a profile component such as
  41 .PP
  42 .RS 5
  43 rmmproc:        /home/foouser/bin/rmm_msgs
  44 .RE
  45 .PP
  46 then instead of simply renaming the message file,
  47 .B rmm
  48 will call
  49 the named program or script to handle the files that represent the
  50 messages to be deleted.
  51 .PP
  52 Some users of
  53 .B csh
  54 prefer the following:
  55 .PP
  56 .RS 5
  57 alias rmm 'refile +d'
  58 .RE
  59 .PP
  60 where folder `+d' is a folder for deleted messages, and
  61 .PP
  62 .RS 5
  63 alias mexp 'rm `mhpath +d all`'
  64 .RE
  65 .PP
  66 is used to \*(lqexpunge\*(rq deleted messages.
  67 .PP
  68 The current message is not changed by
  69 .BR rmm ,
  70 so a
  71 .B next
  72  will
  73 advance to the next message in the folder as expected.
  74
  75 .SH FILES
  76 .fc ^ ~
  77 .nf
  78 .ta \w'%etcdir%/ExtraBigFileName  'u
  79 ^$HOME/\&.mh\(ruprofile~^The user profile
  80 .fi
  81
  82 .SH "PROFILE COMPONENTS"
  83 .fc ^ ~
  84 .nf
  85 .ta 2.4i
  86 .ta \w'ExtraBigProfileName  'u
  87 ^Path:~^To determine the user's nmh directory
  88 ^Current\-Folder:~^To find the default current folder
  89 ^rmmproc:~^Program to delete the message
  90 .fi
  91
  92 .SH "SEE ALSO"
  93 refile(1), rmf(1)
  94
  95 .SH DEFAULTS
  96 .nf
  97 .RB ` +folder "' defaults to the current folder"
  98 .RB ` msgs "' defaults to cur"
  99 .RB ` -nounlink '
 100 .fi
 101
 102 .SH CONTEXT
 103 If a folder is given, it will become the current folder.
 104
 105 .SH BUGS
 106 Since
 107 .B refile
 108 uses your
 109 .I rmmproc
 110 to delete the message,
 111 the
 112 .I rmmproc
 113 must
 114 .B NOT
 115 call
 116 .B refile
 117 without specifying
 118 .BR \-normmproc ,
 119 or you will create an infinte loop.