.\"
.\" THIS FILE HAS BEEN AUTOMATICALLY GENERATED.  DO NOT EDIT.
.\"
.TH RCVSTORE 1mh "2019-01-06" MH.6.8 [mmh-0.4]
.SH NAME
rcvstore \- asynchronously incorporate mail into a folder
.SH SYNOPSIS
.HP 5
.na
.B rcvstore
.RI [ +folder ]
.RB [ \-create " | " \-nocreate ]
.RB [ \-unseen " | " \-nounseen ]
.RB [ \-zero " | " \-nozero ]
.RB [ \-sequence
.I name
\&...]
.RB [ \-public " | " \-nopublic ]
.RB [ \-Version ]
.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Rcvstore
incorporates a message from the standard input into an
.B mh
folder.  This command is typically used in conjunction with
mail filtering programs such as
.B slocal
and
.BR procmail ,
to filter your mail into different folders.
.PP
You may specify which folder to use with
.IR +folder .
If no folder is specified,
.B 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'.
.PP
If the switch
.B \-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
.B \-nocreate
option.  In this case
.B rcvstore
will exit if the specified folder does not exist.
.PP
When the new message is incorporated into the folder, it is assigned
the next highest number for that folder.
.PP
.B Rcvstore
will incorporate anything except zero length messages
into the user's
.B mh
folder.  It will not change the message in any
way.
.PP
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
.B mmh
default of 0644 will be used.  For all subsequent operations
on this message, this initially assigned protection will be preserved.
.PP
If the switch
.B \-unseen
is given (it is on by default), and if the
profile entry `Unseen\-Sequence' is present and non\-empty, then
.B rcvstore
will add the newly incorporated message to each sequence
named by this profile entry.  You may use the switch
.B \-nounseen
to disable this.  These sequences will not be zero'ed by
.B rcvstore
prior to adding the new message.
.PP
Furthermore, the incoming message may be added to additional sequences
as they arrive by the use of the
.B \-sequence
switch.  As with the
commands
.B pick
and
.BR mark ,
you may also use the switches
.B \-zero
and
.B \-nozero
to specify whether to zero old sequences or not.
Similarly, use of the
.B \-public
and
.B \-nopublic
switches may be used
to force these sequences to be public or private sequences.

.SH FILES
.fc ^ ~
.nf
.ta \w'/etc/mmh/ExtraBigFileName  'u
^$HOME/.mmh/profile~^The user profile
.fi

.SH "PROFILE COMPONENTS"
.fc ^ ~
.nf
.ta 2.4i
.ta \w'ExtraBigProfileName  'u
^Path:~^To determine the user's mail storage
^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
.fi

.SH "SEE ALSO"
rcvdist(1), rcvpack(1), mh\-sequence(7)

.SH DEFAULTS
.nf
.RB ` +folder "' defaults to `Inbox' profile entry"
.RB ` \-create '
.RB ` \-unseen '
.RB ` \-nozero '
.fi

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

.SH BUGS
If you use the `Unseen\-Sequence' profile entry,
.B rcvstore
could try to update the context while another
.B mmh
process
is also trying to do so.  This can cause the context to become
corrupted.  To avoid this, do not use
.B rcvstore
if you use the
`Unseen\-Sequence' profile entry.