X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/d1cb667bddf8d1c5c0721fc7ab642c22946baf1f..c4db59aa4b58bca9cd146ae30f507c16218a67d7:/man/rcvstore.man

diff --git a/man/rcvstore.man b/man/rcvstore.man
index 2a64f1d0..4dde79ef 100644
--- a/man/rcvstore.man
+++ b/man/rcvstore.man
@@ -1,4 +1,4 @@
-.TH RCVSTORE %manext1% "January 18, 2001" "%nmhversion%"
+.TH RCVSTORE %manext1% "February 18, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -7,7 +7,9 @@ rcvstore \- asynchronously incorporate mail into a folder
 .SH SYNOPSIS
 .HP 5
 .na
-.B %libdir%/rcvstore
+.B %nmhlibexecdir%/rcvstore
+.RB [ \-help ]
+.RB [ \-version ]
 .RI [ +folder ]
 .RB [ \-create " | " \-nocreate ]
 .RB [ \-unseen " | " \-nounseen ]
@@ -16,8 +18,6 @@ rcvstore \- asynchronously incorporate mail into a folder
 .I name
 \&...]
 .RB [ \-public " | " \-nopublic ]
-.RB [ \-version ]
-.RB [ \-help ]
 .ad
 .SH DESCRIPTION
 .B Rcvstore
@@ -98,10 +98,21 @@ 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
+.ta \w'%nmhetcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
 .SH "PROFILE COMPONENTS"
@@ -119,7 +130,9 @@ to force these sequences to be public or private sequences.
 .IR rcvdist (1),
 .IR rcvpack (1),
 .IR rcvtty (1),
-.IR mh\-sequence (5)
+.IR mh\-sequence (5),
+.IR procmailex (5),
+.IR procmailrc (5)
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to \*(lqInbox\*(rq profile entry"