4 .TH RCVSTORE %manext1% "%nmhdate%" MH.6.8 [%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 \*(lqMsg\-Protect: nnn\*(rq entry, it
62 will be used as the protection on the newly created message, otherwise
65 default of 0644 will be used. For all subsequent operations
66 on this message, this initially assigned protection will be preserved.
70 is given (it is on by default), and if the
71 profile entry \*(lqUnseen\-Sequence\*(rq is present and non\-empty, then
73 will add the newly incorporated message to each sequence
74 named by this profile entry. You may use the switch
76 to disable this. These sequences will not be zero'ed by
78 prior to adding the new message.
80 Furthermore, the incoming message may be added to additional sequences
81 as they arrive by the use of the
88 you may also use the switches
92 to specify whether to zero old sequences or not.
98 to force these sequences to be public or private sequences.
103 .ta \w'%etcdir%/ExtraBigFileName 'u
104 ^$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
120 rcvdist(1), rcvpack(1), rcvtty(1), mh\-sequence(5)
124 .RB ` +folder "' defaults to \*(lqInbox\*(rq profile entry"
131 No context changes will be attempted, with the exception of
132 sequence manipulation.
135 If you use the \*(lqUnseen\-Sequence\*(rq profile entry,
137 could try to update the context while another
140 is also trying to do so. This can cause the context to become
141 corrupted. To avoid this, do not use
144 \*(lqUnseen\-Sequence\*(rq profile entry.