8 date 92.11.20.00.40.37; author jromine; state Exp;
13 date 92.02.04.00.04.56; author jromine; state Exp;
18 date 90.04.05.15.14.48; author sources; state Exp;
23 date 90.03.22.11.31.44; author sources; state Exp;
28 date 90.03.20.19.42.25; author sources; state Exp;
33 date 90.03.20.17.36.40; author sources; state Exp;
38 date 90.03.20.17.21.24; author sources; state Exp;
49 @note problems with unseen-sequence
53 .\" @@(#)$Id: rcvstore.rf,v 1.6 1992/02/04 00:04:56 jromine Exp jromine $
56 rcvstore \- incorporate new mail asynchronously
58 @@(MHETCPATH)/rcvstore
60 \%[\-create] \%[\-nocreate]
61 \%[\-sequence\ name\ ...]
62 \%[\-public] \%[\-nopublic]
63 \%[\-zero] \%[\-nozero]
66 \fIRcvstore\fR incorporates a message from the standard input
67 into an \fIMH\fR folder.
68 If `+folder' isn't specified,
69 a folder in the user's \fIMH\fR directory will be used, either that
70 specified by the \*(lqInbox:\*(rq entry in the user's profile, or
71 the folder named \*(lqinbox\*(rq.
72 The new message being incorporated is assigned the next highest
74 If the specified (or default) folder doesn't exist,
75 then it will be created if the `\-create' option is specified,
76 otherwise \fIrcvstore\fP will exit.
78 If the user's profile contains a \*(lqMsg\-Protect: nnn\*(rq entry, it
79 will be used as the protection on the newly created messages,
80 otherwise the \fIMH\fR default of 0644 will be used.
81 During all operations on messages,
82 this initially assigned protection will
83 be preserved for each message, so \fIchmod\fR(1) may be used to set a
84 protection on an individual message, and its protection will be
87 \fIRcvstore\fR will incorporate anything except zero length messages
88 into the user's MH folder.
90 If the profile entry \*(lqUnseen\-Sequence\*(rq is present and non\-empty,
91 then \fIrcvstore\fR will add the newly incorporated message to each
92 sequence named by the profile entry.
93 This is similar to the \*(lqPrevious\-Sequence\*(rq profile entry supported
94 by all \fIMH\fR commands which take `msgs' or `msg' arguments.
95 Note that \fIrcvstore\fR will not zero each sequence prior to adding messages.
98 the incoming messages may be added to user-defined sequences as
99 they arrive by appropriate use of the `\-sequence' option.
101 use of the `\-zero' and `\-nozero' switches can also be used to zero
102 old sequences or not.
104 use of the `\-public' and `\-nopublic switches
105 may be used to force additions to public and private sequences.
107 ^$HOME/\&.mh\(ruprofile~^The user profile
109 ^Path:~^To determine the user's MH directory
111 ^Folder\-Protect:~^To set mode when creating a new folder
113 ^Inbox:~^To find the default inbox
115 ^Msg\-Protect:~^To set mode when creating a new message
117 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
119 inc(1), pick(1), mh\-mail(5)
121 `+folder' defaults to \*(lqinbox\*(rq
125 `\-nopublic' if the folder is read\-only, `\-public' otherwise
129 No context changes will be attempted,
130 with the exception of sequence manipulation.
132 If you use the \*(lqUnseen\-Sequence\*(rq profile entry,
133 \fIrcvstore\fP could try to update the context while another
134 \fIMH\fP process is also trying to do so.
135 This can cause the context to become corrupted.
136 To avoid this, do not use \fIrcvstore\fP
137 if you use the \*(lqUnseen\-Sequence\*(rq profile entry.
149 .\" @@(#)$Id: rcvstore.rf,v 1.5 1990/04/05 15:14:48 sources Exp jromine $
164 the folder named \*(lqinbox\*(rq in the user's \fIMH\fR directory will be used
172 @put things back, do .NA stuff another way
186 .TH RCVSTORE 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
196 @fixup for makewhatis
201 .TH RCVSTORE 1 [mh.6] MH