Provided by: nmh_1.3-1_i386 bug

NAME

       rcvstore - asynchronously incorporate mail into a folder

SYNOPSIS

       /usr/lib/mh/rcvstore [+folder] [-create | -nocreate] [-unseen |
            -nounseen] [-zero | -nozero] [-sequence name ...]  [-public |
            -nopublic] [-version] [-help]

DESCRIPTION

       Rcvstore  incorporates  a  message  from the standard input into an nmh
       folder.  This command  is  typically  used  in  conjunction  with  mail
       filtering  programs  such  as  slocal and procmail, to filter your mail
       into different folders.

       You may specify which folder to use with  +folder.   If  no  folder  is
       specified,  rcvstore  will use the folder given by a non-empty "Inbox:"
       entry in the user's profile, else it will use the folder named "inbox".

       If the switch -create is given (it is the default) and if the specified
       (or  default)  folder does not exist, then it will be created.  You may
       disable this with the -nocreate option.  In  this  case  rcvstore  will
       exit if the specified folder does not exist.

       When  the  new  message is incorporated into the folder, it is assigned
       the next highest number for that folder.

       Rcvstore will incorporate anything except zero length messages into the
       user's nmh folder.  It will not change the message in any way.

       If  the  user's profile contains a "Msg-Protect: nnn" entry, it will be
       used as the protection on the newly created message, otherwise the  nmh
       default  of  0644  will be used.  For all subsequent operations on this
       message, this initially assigned protection will be preserved.

       If the switch -unseen is given (it  is  on  by  default),  and  if  the
       profile entry "Unseen-Sequence" is present and non-empty, then rcvstore
       will add the newly incorporated message to each sequence named by  this
       profile  entry.   You  may  use  the  switch -nounseen to disable this.
       These sequences will not be zero'ed by rcvstore prior to adding the new
       message.

       Furthermore,  the incoming message may be added to additional sequences
       as they arrive by the  use  of  the  -sequence  switch.   As  with  the
       commands pick and mark, you may also use the switches -zero and -nozero
       to specify whether to zero old sequences or not.  Similarly, use of the
       -public  and -nopublic switches may be used to force these sequences to
       be public or private sequences.

FILES

       $HOME/.mh_profile          The user profile

PROFILE COMPONENTS

       Path:                To determine the user's nmh directory
       Folder-Protect:      To set mode when creating a new folder
       Inbox:               To find the default inbox
       Msg-Protect:         To set mode when creating a new message
       Unseen-Sequence:     To name sequences denoting unseen messages

SEE ALSO

       rcvdist(1), rcvpack(1), rcvtty(1), mh-sequence(5)

DEFAULTS

       `+folder' defaults to "Inbox" profile entry
       `-create'
       `-unseen'
       `-nozero'

CONTEXT

       No context changes will be attempted, with the  exception  of  sequence
       manipulation.

BUGS

       If  you  use the "Unseen-Sequence" profile entry, rcvstore could try to
       update the context while another nmh process is also trying to  do  so.
       This  can cause the context to become corrupted.  To avoid this, do not
       use rcvstore if you use the "Unseen-Sequence" profile entry.