Reworked the man page system and some man page contents (mmh-intro).
[mmh] / man / rcvstore.man
diff --git a/man/rcvstore.man b/man/rcvstore.man
deleted file mode 100644 (file)
index a14b5ab..0000000
+++ /dev/null
@@ -1,144 +0,0 @@
-.\"
-.\" %nmhwarning%
-.\"
-.TH RCVSTORE %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
-.SH NAME
-rcvstore \- asynchronously incorporate mail into a folder
-.SH SYNOPSIS
-.HP 5
-.na
-.B %libdir%/rcvstore
-.RI [ +folder ]
-.RB [ \-create " | " \-nocreate ]
-.RB [ \-unseen " | " \-nounseen ]
-.RB [ \-zero " | " \-nozero ]
-.RB [ \-sequence
-.I name
-\&...]
-.RB [ \-public " | " \-nopublic ]
-.RB [ \-version ]
-.RB [ \-help ]
-.ad
-.SH DESCRIPTION
-.B Rcvstore
-incorporates a message from the standard input into an
-.B nmh
-folder.  This command is typically used in conjunction with
-mail filtering programs such as
-.B slocal
-and
-.BR procmail ,
-to filter your mail into different folders.
-.PP
-You may specify which folder to use with
-.IR +folder .
-If no folder is specified,
-.B rcvstore
-will use the folder given by a non\-empty
-\*(lqInbox:\*(rq entry in the user's profile, else it will use the folder
-named \*(lqinbox\*(rq.
-.PP
-If the switch
-.B \-create
-is given (it is the default) and if the specified
-(or default) folder does not exist, then it will be created.  You may
-disable this with the
-.B \-nocreate
-option.  In this case
-.B rcvstore
-will exit if the specified folder does not exist.
-.PP
-When the new message is incorporated into the folder, it is assigned
-the next highest number for that folder.
-.PP
-.B Rcvstore
-will incorporate anything except zero length messages
-into the user's
-.B nmh
-folder.  It will not change the message in any
-way.
-.PP
-If the user's profile contains a \*(lqMsg\-Protect: nnn\*(rq entry, it
-will be used as the protection on the newly created message, otherwise
-the
-.B nmh
-default of 0644 will be used.  For all subsequent operations
-on this message, this initially assigned protection will be preserved.
-.PP
-If the switch
-.B \-unseen
-is given (it is on by default), and if the
-profile entry \*(lqUnseen\-Sequence\*(rq is present and non\-empty, then
-.B rcvstore
-will add the newly incorporated message to each sequence
-named by this profile entry.  You may use the switch
-.B \-nounseen
-to disable this.  These sequences will not be zero'ed by
-.B rcvstore
-prior to adding the new message.
-.PP
-Furthermore, the incoming message may be added to additional sequences
-as they arrive by the use of the
-.B \-sequence
-switch.  As with the
-commands
-.B pick
-and
-.BR mark ,
-you may also use the switches
-.B \-zero
-and
-.B \-nozero
-to specify whether to zero old sequences or not.
-Similarly, use of the
-.B \-public
-and
-.B \-nopublic
-switches may be used
-to force these sequences to be public or private sequences.
-
-.SH FILES
-.fc ^ ~
-.nf
-.ta \w'%etcdir%/ExtraBigFileName  'u
-^$HOME/.mmh/profile~^The user profile
-.fi
-
-.SH "PROFILE COMPONENTS"
-.fc ^ ~
-.nf
-.ta 2.4i
-.ta \w'ExtraBigProfileName  'u
-^Path:~^To determine the user's mail storage
-^Folder\-Protect:~^To set mode when creating a new folder
-^Inbox:~^To find the default inbox
-^Msg\-Protect:~^To set mode when creating a new message
-^Unseen\-Sequence:~^To name sequences denoting unseen messages
-.fi
-
-.SH "SEE ALSO"
-rcvdist(1), rcvpack(1), rcvtty(1), mh\-sequence(5)
-
-.SH DEFAULTS
-.nf
-.RB ` +folder "' defaults to \*(lqInbox\*(rq profile entry"
-.RB ` \-create '
-.RB ` \-unseen '
-.RB ` \-nozero '
-.fi
-
-.SH CONTEXT
-No context changes will be attempted, with the exception of
-sequence manipulation.
-
-.SH BUGS
-If you use the \*(lqUnseen\-Sequence\*(rq profile entry,
-.B rcvstore
-could try to update the context while another
-.B nmh
-process
-is also trying to do so.  This can cause the context to become
-corrupted.  To avoid this, do not use
-.B rcvstore
-if you use the
-\*(lqUnseen\-Sequence\*(rq profile entry.