DragonFly On-Line Manual Pages

RMM(1)									RMM(1)

NAME
       rmm - remove messages

SYNOPSIS
       rmm [+folder] [msgs] [-unlink | -nounlink] [-rmmproc program] [-normm-
	    proc] [-version] [-help]

DESCRIPTION
       By  default, rmm	will remove the	specified messages by renaming 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 cron to remove these files once
       a day, so check with your system	administrator.

       Alternately,  if	you wish for rmm to really remove the files represent-
       ing these messages, you can  use	 the  -unlink  switch.	 But  messages
       removed by this method cannot be	later recovered.

       If  you	prefer a more sophisticated method of `removing' messages, you
       can define the rmmproc profile component.  For example, you can	add  a
       profile component such as

	    rmmproc:  /home/foouser/bin/rmm_msgs

       Then  instead  of  simply  renaming the message file, rmm will call the
       named program or	script to handle the files that	represent the messages
       to be deleted.  The -rmmproc switch may be used to override  this  pro-
       file  component.	 The -normmproc	switch disables	the use	of any rmmproc
       profile component and negates all prior -rmmproc	switches.

       An example of a rmmproc script that saves a message based in  its  Mes-
       sage-ID is provided in /usr/local/etc/nmh/rmmproc.messageid.  To	enable
       it, simply add a	rmmproc	component that names it	to your	profile.

       Some users of csh prefer	the following:

	    alias rmm 'refile +d'

       where folder `+d' is a folder for deleted messages, and

	    alias mexp 'rm `mhpath +d all`'

       is used to "expunge" deleted messages.

       The  current  message  is not changed by	rmm, so	a next will advance to
       the next	message	in the folder as expected.

FILES
       $HOME/.mh_profile		    The	user profile

PROFILE	COMPONENTS
       Path:		    To determine the user's nmh	directory
       Current-Folder:	    To find the	default	current	folder
       rmmproc:		    Program to delete the message

SEE ALSO
       rmf(1)

DEFAULTS
       `+folder' defaults to the current folder
       `msgs' defaults to cur
       `-nounlink'

CONTEXT
       If a folder is given, it	will become the	current	folder.

BUGS
       Since rmm and refile use	your rmmproc to	delete the message,  the  rmm-
       proc  must NOT call rmm or refile without specifying -normmproc,	or you
       will create an infinite loop.

nmh-1.6				March 18, 2013				RMM(1)