0
|
1 .\" @(MHWARNING)
|
|
2 .\" @(#)$Id$
|
|
3 .SC RCVSTORE 1
|
|
4 .NA
|
|
5 rcvstore \- incorporate new mail asynchronously
|
|
6 .SY
|
|
7 @(MHETCPATH)/rcvstore
|
|
8 \%[+folder]
|
|
9 \%[\-create] \%[\-nocreate]
|
|
10 \%[\-sequence\ name\ ...]
|
|
11 \%[\-public] \%[\-nopublic]
|
|
12 \%[\-zero] \%[\-nozero]
|
|
13 \%[\-help]
|
|
14 .DE
|
|
15 \fIRcvstore\fR incorporates a message from the standard input
|
|
16 into an \fIMH\fR folder.
|
|
17 If `+folder' isn't specified,
|
|
18 a folder in the user's \fIMH\fR directory will be used, either that
|
|
19 specified by the \*(lqInbox:\*(rq entry in the user's profile, or
|
|
20 the folder named \*(lqinbox\*(rq.
|
|
21 The new message being incorporated is assigned the next highest
|
|
22 number in the folder.
|
|
23 If the specified (or default) folder doesn't exist,
|
|
24 then it will be created if the `\-create' option is specified,
|
|
25 otherwise \fIrcvstore\fP will exit.
|
|
26
|
|
27 If the user's profile contains a \*(lqMsg\-Protect: nnn\*(rq entry, it
|
|
28 will be used as the protection on the newly created messages,
|
|
29 otherwise the \fIMH\fR default of 0644 will be used.
|
|
30 During all operations on messages,
|
|
31 this initially assigned protection will
|
|
32 be preserved for each message, so \fIchmod\fR(1) may be used to set a
|
|
33 protection on an individual message, and its protection will be
|
|
34 preserved thereafter.
|
|
35
|
|
36 \fIRcvstore\fR will incorporate anything except zero length messages
|
|
37 into the user's MH folder.
|
|
38
|
|
39 If the profile entry \*(lqUnseen\-Sequence\*(rq is present and non\-empty,
|
|
40 then \fIrcvstore\fR will add the newly incorporated message to each
|
|
41 sequence named by the profile entry.
|
|
42 This is similar to the \*(lqPrevious\-Sequence\*(rq profile entry supported
|
|
43 by all \fIMH\fR commands which take `msgs' or `msg' arguments.
|
|
44 Note that \fIrcvstore\fR will not zero each sequence prior to adding messages.
|
|
45
|
|
46 Furthermore,
|
|
47 the incoming messages may be added to user-defined sequences as
|
|
48 they arrive by appropriate use of the `\-sequence' option.
|
|
49 As with \fIpick\fP,
|
|
50 use of the `\-zero' and `\-nozero' switches can also be used to zero
|
|
51 old sequences or not.
|
|
52 Similarly,
|
|
53 use of the `\-public' and `\-nopublic switches
|
|
54 may be used to force additions to public and private sequences.
|
|
55 .Fi
|
|
56 ^$HOME/\&.mh\(ruprofile~^The user profile
|
|
57 .Pr
|
|
58 ^Path:~^To determine the user's MH directory
|
|
59 .Ps
|
|
60 ^Folder\-Protect:~^To set mode when creating a new folder
|
|
61 .Ps
|
|
62 ^Inbox:~^To find the default inbox
|
|
63 .Ps
|
|
64 ^Msg\-Protect:~^To set mode when creating a new message
|
|
65 .Ps
|
|
66 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
|
|
67 .Sa
|
|
68 inc(1), pick(1), mh\-mail(5)
|
|
69 .De
|
|
70 `+folder' defaults to \*(lqinbox\*(rq
|
|
71 .Ds
|
|
72 `\-create'
|
|
73 .Ds
|
|
74 `\-nopublic' if the folder is read\-only, `\-public' otherwise
|
|
75 .Ds
|
|
76 `\-nozero'
|
|
77 .Co
|
|
78 No context changes will be attempted,
|
|
79 with the exception of sequence manipulation.
|
|
80 .Bu
|
|
81 If you use the \*(lqUnseen\-Sequence\*(rq profile entry,
|
|
82 \fIrcvstore\fP could try to update the context while another
|
|
83 \fIMH\fP process is also trying to do so.
|
|
84 This can cause the context to become corrupted.
|
|
85 To avoid this, do not use \fIrcvstore\fP
|
|
86 if you use the \*(lqUnseen\-Sequence\*(rq profile entry.
|
|
87 .En
|