git.marmaro.de Git - mmh/blob - docs/historical/mh-6.8.5/doc/rcvstore.me

   1 .\"     This file is automatically generated.  Do not edit!
   2 .\" @(#)$Id: rcvstore.rf,v 1.7 1992/11/20 00:40:37 jromine Exp $
   3 .SC RCVSTORE 1
   4 .NA
   5 rcvstore \- incorporate new mail asynchronously
   6 .SY
   7 /opt/mh-6.8.5/lib/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