Added note that suffixes were removed from filenames of temporary files.

[nmh] / man / rcvstore.man

diff --git a/man/rcvstore.man b/man/rcvstore.man
index 1d1f3e1b44567180215b46213fed740aa9c982a8..3ed56fe3502359aee493cb6e82bb7564729ffa6b 100644 (file)
--- a/man/rcvstore.man
+++ b/man/rcvstore.man
@@ -1,12 +1,12 @@
+.TH RCVSTORE %manext1% "February 18, 2013" "%nmhversion%"

 .\"
 .\" %nmhwarning%
 .\"
 .\" %nmhwarning%

-.\" $Id$

 .\"
 .\"

-.TH RCVSTORE %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]

 .SH NAME
 rcvstore \- asynchronously incorporate mail into a folder
 .SH SYNOPSIS
 .HP 5
 .SH NAME
 rcvstore \- asynchronously incorporate mail into a folder
 .SH SYNOPSIS
 .HP 5

+.na

 .B %libdir%/rcvstore
 .RI [ +folder ]
 .RB [ \-create " | " \-nocreate ]
 .B %libdir%/rcvstore
 .RI [ +folder ]
 .RB [ \-create " | " \-nocreate ]


@@ -18,6 +18,7 @@ rcvstore \- asynchronously incorporate mail into a folder
 .RB [ \-public " | " \-nopublic ]
 .RB [ \-version ]
 .RB [ \-help ]
 .RB [ \-public " | " \-nopublic ]
 .RB [ \-version ]
 .RB [ \-help ]

+.ad

 .SH DESCRIPTION
 .B Rcvstore
 incorporates a message from the standard input into an
 .SH DESCRIPTION
 .B Rcvstore
 incorporates a message from the standard input into an


@@ -57,12 +58,14 @@ into the user's
 folder.  It will not change the message in any
 way.
 .PP
 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
+If the user's profile contains a
+.RI \*(lq "Msg\-Protect: nnn" \*(rq
+entry, it will be used as the protection on the newly created
+message, otherwise the

 .B nmh
 .B nmh

-default of 0644 will be used.  For all subsequent operations
-on this message, this initially assigned protection will be preserved.
+default of 0600 will be used (on filesystems that support it).  For
+all subsequent operations on this message, this initially assigned
+protection will be preserved.

 .PP
 If the switch
 .B \-unseen
 .PP
 If the switch
 .B \-unseen


@@ -95,14 +98,23 @@ and
 .B \-nopublic
 switches may be used
 to force these sequences to be public or private sequences.
 .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
 .SH FILES
 .fc ^ ~
 .nf

-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
+.ta \w'%etcdir%/ExtraBigFileName  'u

 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi

-

 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf


@@ -114,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
 ^Msg\-Protect:~^To set mode when creating a new message
 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
 .fi

-

 .SH "SEE ALSO"
 .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"
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to \*(lqInbox\*(rq profile entry"


@@ -125,19 +140,6 @@ rcvdist(1), rcvpack(1), rcvtty(1), mh\-sequence(5)
 .RB ` \-unseen '
 .RB ` \-nozero '
 .fi
 .RB ` \-unseen '
 .RB ` \-nozero '
 .fi

-

 .SH CONTEXT
 No context changes will be attempted, with the exception of
 sequence manipulation.
 .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.