1 .TH RCVSTORE %manext1% "January 18, 2001" "%nmhversion%"
6 rcvstore \- asynchronously incorporate mail into a folder
12 .RB [ \-create " | " \-nocreate ]
13 .RB [ \-unseen " | " \-nounseen ]
14 .RB [ \-zero " | " \-nozero ]
18 .RB [ \-public " | " \-nopublic ]
24 incorporates a message from the standard input into an
26 folder. This command is typically used in conjunction with
27 mail filtering programs such as
31 to filter your mail into different folders.
33 You may specify which folder to use with
35 If no folder is specified,
37 will use the folder given by a non\-empty
38 \*(lqInbox:\*(rq entry in the user's profile, else it will use the folder
39 named \*(lqinbox\*(rq.
43 is given (it is the default) and if the specified
44 (or default) folder does not exist, then it will be created. You may
49 will exit if the specified folder does not exist.
51 When the new message is incorporated into the folder, it is assigned
52 the next highest number for that folder.
55 will incorporate anything except zero length messages
58 folder. It will not change the message in any
61 If the user's profile contains a
62 .RI \*(lq "Msg\-Protect: nnn" \*(rq
63 entry, it will be used as the protection on the newly created
64 message, otherwise the
66 default of 0600 will be used (on filesystems that support it). For
67 all subsequent operations on this message, this initially assigned
68 protection will be preserved.
72 is given (it is on by default), and if the
73 profile entry \*(lqUnseen\-Sequence\*(rq is present and non\-empty, then
75 will add the newly incorporated message to each sequence
76 named by this profile entry. You may use the switch
78 to disable this. These sequences will not be zero'ed by
80 prior to adding the new message.
82 Furthermore, the incoming message may be added to additional sequences
83 as they arrive by the use of the
90 you may also use the switches
94 to specify whether to zero old sequences or not.
100 to force these sequences to be public or private sequences.
104 .ta \w'%etcdir%/ExtraBigFileName 'u
105 ^$HOME/\&.mh\(ruprofile~^The user profile
107 .SH "PROFILE COMPONENTS"
111 .ta \w'ExtraBigProfileName 'u
112 ^Path:~^To determine the user's nmh directory
113 ^Folder\-Protect:~^To set mode when creating a new folder
114 ^Inbox:~^To find the default inbox
115 ^Msg\-Protect:~^To set mode when creating a new message
116 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
125 .RB ` +folder "' defaults to \*(lqInbox\*(rq profile entry"
131 No context changes will be attempted, with the exception of
132 sequence manipulation.