git.marmaro.de Git - mmh/blob - docs/historical/mh-6.8.5/conf/doc/RCS/rcvstore.rf,v

   1 head    1.7;
   2 access;
   3 symbols;
   4 locks; strict;
   5
   6
   7 1.7
   8 date    92.11.20.00.40.37;      author jromine; state Exp;
   9 branches;
  10 next    1.6;
  11
  12 1.6
  13 date    92.02.04.00.04.56;      author jromine; state Exp;
  14 branches;
  15 next    1.5;
  16
  17 1.5
  18 date    90.04.05.15.14.48;      author sources; state Exp;
  19 branches;
  20 next    1.4;
  21
  22 1.4
  23 date    90.03.22.11.31.44;      author sources; state Exp;
  24 branches;
  25 next    1.3;
  26
  27 1.3
  28 date    90.03.20.19.42.25;      author sources; state Exp;
  29 branches;
  30 next    1.2;
  31
  32 1.2
  33 date    90.03.20.17.36.40;      author sources; state Exp;
  34 branches;
  35 next    1.1;
  36
  37 1.1
  38 date    90.03.20.17.21.24;      author sources; state Exp;
  39 branches;
  40 next    ;
  41
  42
  43 desc
  44 @@
  45
  46
  47 1.7
  48 log
  49 @note problems with unseen-sequence
  50 @
  51 text
  52 @.\"    @@(MHWARNING)
  53 .\" @@(#)$Id: rcvstore.rf,v 1.6 1992/02/04 00:04:56 jromine Exp jromine $
  54 .SC RCVSTORE 1
  55 .NA
  56 rcvstore \- incorporate new mail asynchronously
  57 .SY
  58 @@(MHETCPATH)/rcvstore
  59 \%[+folder]
  60 \%[\-create] \%[\-nocreate]
  61 \%[\-sequence\ name\ ...]
  62 \%[\-public] \%[\-nopublic]
  63 \%[\-zero] \%[\-nozero]
  64 \%[\-help]
  65 .DE
  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
  73 number in the folder.
  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.
  77
  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
  85 preserved thereafter.
  86
  87 \fIRcvstore\fR will incorporate anything except zero length messages
  88 into the user's MH folder.
  89
  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.
  96
  97 Furthermore,
  98 the incoming messages may be added to user-defined sequences as
  99 they arrive by appropriate use of the `\-sequence' option.
 100 As with \fIpick\fP,
 101 use of the `\-zero' and `\-nozero' switches can also be used to zero
 102 old sequences or not.
 103 Similarly,
 104 use of the `\-public' and `\-nopublic switches
 105 may be used to force additions to public and private sequences.
 106 .Fi
 107 ^$HOME/\&.mh\(ruprofile~^The user profile
 108 .Pr
 109 ^Path:~^To determine the user's MH directory
 110 .Ps
 111 ^Folder\-Protect:~^To set mode when creating a new folder
 112 .Ps
 113 ^Inbox:~^To find the default inbox
 114 .Ps
 115 ^Msg\-Protect:~^To set mode when creating a new message
 116 .Ps
 117 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
 118 .Sa
 119 inc(1), pick(1), mh\-mail(5)
 120 .De
 121 `+folder' defaults to \*(lqinbox\*(rq
 122 .Ds
 123 `\-create'
 124 .Ds
 125 `\-nopublic' if the folder is read\-only, `\-public' otherwise
 126 .Ds
 127 `\-nozero'
 128 .Co
 129 No context changes will be attempted,
 130 with the exception of sequence manipulation.
 131 .Bu
 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.
 138 .En
 139 @
 140
 141
 142 1.6
 143 log
 144 @contributed patch
 145 @
 146 text
 147 @d2 1
 148 a2 1
 149 .\" @@(#)$Id: rcvstore.rf,v 1.5 1990/04/05 15:14:48 sources Exp jromine $
 150 d80 7
 151 @
 152
 153
 154 1.5
 155 log
 156 @add ID
 157 @
 158 text
 159 @d2 1
 160 a2 1
 161 .\" @@(#)$Id:$
 162 d18 3
 163 a20 2
 164 the folder named \*(lqinbox\*(rq in the user's \fIMH\fR directory will be used
 165 instead.
 166 d61 2
 167 @
 168
 169
 170 1.4
 171 log
 172 @put things back, do .NA stuff another way
 173 @
 174 text
 175 @d2 1
 176 @
 177
 178
 179 1.3
 180 log
 181 @typo
 182 @
 183 text
 184 @d2 2
 185 a3 2
 186 .TH RCVSTORE 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
 187 .SH .NA
 188 d5 1
 189 a5 1
 190 .SH .SY
 191 @
 192
 193
 194 1.2
 195 log
 196 @fixup for makewhatis
 197 @
 198 text
 199 @d2 1
 200 a2 1
 201 .TH RCVSTORE 1 [mh.6] MH
 202 @
 203
 204
 205 1.1
 206 log
 207 @Initial revision
 208 @
 209 text
 210 @d2 2
 211 a3 2
 212 .SC RCVSTORE 1
 213 .NA
 214 d5 1
 215 a5 1
 216 .SY
 217 @