5 .TH RCVSTORE %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
7 rcvstore \- asynchronously incorporate mail into a folder
13 .RB [ \-create " | " \-nocreate ]
14 .RB [ \-unseen " | " \-nounseen ]
15 .RB [ \-zero " | " \-nozero ]
19 .RB [ \-public " | " \-nopublic ]
25 incorporates a message from the standard input into an
27 folder. This command is typically used in conjunction with
28 mail filtering programs such as
32 to filter your mail into different folders.
34 You may specify which folder to use with
36 If no folder is specified,
38 will use the folder given by a non\-empty
39 \*(lqInbox:\*(rq entry in the user's profile, else it will use the folder
40 named \*(lqinbox\*(rq.
44 is given (it is the default) and if the specified
45 (or default) folder does not exist, then it will be created. You may
50 will exit if the specified folder does not exist.
52 When the new message is incorporated into the folder, it is assigned
53 the next highest number for that folder.
56 will incorporate anything except zero length messages
59 folder. It will not change the message in any
62 If the user's profile contains a \*(lqMsg\-Protect: nnn\*(rq entry, it
63 will be used as the protection on the newly created message, otherwise
66 default of 0644 will be used. For all subsequent operations
67 on this message, this initially assigned protection will be preserved.
71 is given (it is on by default), and if the
72 profile entry \*(lqUnseen\-Sequence\*(rq is present and non\-empty, then
74 will add the newly incorporated message to each sequence
75 named by this profile entry. You may use the switch
77 to disable this. These sequences will not be zero'ed by
79 prior to adding the new message.
81 Furthermore, the incoming message may be added to additional sequences
82 as they arrive by the use of the
89 you may also use the switches
93 to specify whether to zero old sequences or not.
99 to force these sequences to be public or private sequences.
104 .ta \w'%etcdir%/ExtraBigFileName 'u
105 ^$HOME/\&.mh\(ruprofile~^The user profile
108 .SH "PROFILE COMPONENTS"
112 .ta \w'ExtraBigProfileName 'u
113 ^Path:~^To determine the user's nmh directory
114 ^Folder\-Protect:~^To set mode when creating a new folder
115 ^Inbox:~^To find the default inbox
116 ^Msg\-Protect:~^To set mode when creating a new message
117 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
121 rcvdist(1), rcvpack(1), rcvtty(1), mh\-sequence(5)
125 .RB ` +folder "' defaults to \*(lqInbox\*(rq profile entry"
132 No context changes will be attempted, with the exception of
133 sequence manipulation.
136 If you use the \*(lqUnseen\-Sequence\*(rq profile entry,
138 could try to update the context while another
141 is also trying to do so. This can cause the context to become
142 corrupted. To avoid this, do not use
145 \*(lqUnseen\-Sequence\*(rq profile entry.