X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/448dd2a7475f0009820f874e8da381cfaee4a679..58eaf2c2:/man/rcvstore.man?ds=sidebyside

diff --git a/man/rcvstore.man b/man/rcvstore.man
index d1de3564..3ed56fe3 100644
--- a/man/rcvstore.man
+++ b/man/rcvstore.man
@@ -1,7 +1,7 @@
+.TH RCVSTORE %manext1% "February 18, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
-.TH RCVSTORE %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 rcvstore \- asynchronously incorporate mail into a folder
 .SH SYNOPSIS
@@ -98,14 +98,23 @@ and
 .B \-nopublic
 switches may be used
 to force these sequences to be public or private sequences.
-
+.SS LOCKING AND \-unseen
+If you use the \*(lqUnseen-Sequence\*(rq profile entry, rcvstore could
+try to read and update its sequence state while another
+.B nmh
+process is also trying to do so.  This can cause the sequence state to
+lose track.  To avoid this just between asynchronous invocations of
+.BR rcvstore ,
+do not use it without an external locking mechanism, for example, a
+.IR procmailrc (5)
+local lockfile, if you use the \*(lqUnseen-Sequence\*(rq profile
+entry.
 .SH FILES
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -117,10 +126,13 @@ to force these sequences to be public or private sequences.
 ^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)
-
+.IR rcvdist (1),
+.IR rcvpack (1),
+.IR rcvtty (1),
+.IR mh\-sequence (5),
+.IR procmailex (5),
+.IR procmailrc (5)
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to \*(lqInbox\*(rq profile entry"
@@ -128,7 +140,6 @@ rcvdist(1), rcvpack(1), rcvtty(1), mh\-sequence(5)
 .RB ` \-unseen '
 .RB ` \-nozero '
 .fi
-
 .SH CONTEXT
 No context changes will be attempted, with the exception of
 sequence manipulation.