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

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