[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Nmh-workers] Changes to mh-folders.man
From: |
Larry Hynes |
Subject: |
[Nmh-workers] Changes to mh-folders.man |
Date: |
Tue, 21 Mar 2017 22:35:50 +0000 |
diff --git a/man/mh-folders.man b/man/mh-folders.man
index d5e3c141..ec6ac0de 100644
--- a/man/mh-folders.man
+++ b/man/mh-folders.man
@@ -1,4 +1,4 @@
-.TH MH-FOLDERS %manext5% "February 25, 2016" "%nmhversion%"
+.TH MH-FOLDERS %manext5% "March 21, 2017" "%nmhversion%"
.\"
.\" %nmhwarning%
.\"
@@ -11,26 +11,25 @@ according to the following rules:
.PP
.B one folder per directory
.RS 5
-A
+An
.B nmh
-folder corresponds to directory. There are no limits on folder
+folder corresponds to a directory. There are no limits on folder
names beyond those of the host filesystem.
.RE
.PP
.B one message per file
.RS 5
The file name is a positive integer. Other files containing metadata or
-arbitrary names can exist in a folder; while the preference is that
non\-message
+arbitrary names can exist in a folder; while the preference is that non-message
files begin with \*(lq.\*(rq, all files that are not positive integers
.B must
-be ignored by a
+be ignored by an
.BR MH \-compatible
implementation. However, implementations are free to indicate to the user
-the existence of non\-message files that are not prefixed with a \*(lq.\*(rq.
+the existence of non-message files that are not prefixed with a \*(lq.\*(rq.
.PP
-The filename for a new
-message is one greater than the highest numbered message in
-the folder; its full path can be accessed by the pseudo\-sequence
+The filename for a new message is one greater than the highest numbered
+message in the folder; its full path can be accessed by the pseudo-sequence
.I new
(e.g.,
.B mhpath
@@ -40,7 +39,6 @@ New messages are
permitted to be added to a folder at the end of the message number range.
.PP
To add a new message to a folder, the recommended sequence is:
-.PP
.IP \(bu 4
Create a temporary file in the desired folder.
.IP \(bu 4
@@ -48,15 +46,13 @@ Attempt to link the temporary file to the new message
number.
.IP \(bu 4
If successful, remove the temporary file. If the link fails, increment the
message number and try again.
-.PP
.RE
.B context
.RS 5
There is one context file. Its default location is in the
-user's Path and default name is
+user's Path and its default name is
.IR context ,
-but those can be overridden with the $MHCONTEXT environment
-variable.
+but these can be overridden by the $MHCONTEXT environment variable.
.B context
has the following format:
.PP
@@ -85,7 +81,7 @@ There is one sequences file in each
.B nmh
folder. Its default name is
.IR \&.mh\(rusequences ,
-but that can be overridden with the \*(lqmh\-sequences\*(rq profile entry.
+but this can be overridden by the \*(lqmh\-sequences\*(rq profile entry.
.B sequences
has the following format:
.PP
@@ -110,7 +106,6 @@ removed from the sequence file. The exception to this is
the
.B cur
sequence, which can refer to a nonexistent message.
.RE
-.PP
.SS Locking
.B nmh
programs read and write the context and sequences files, and lock
@@ -132,7 +127,7 @@ The default data locking method is selected when
.B nmh
is configured and can be accessed as a string using
.BR "mhparam datalocking" .
-By default, fcntl locking is used, but this may be overridden with
+By default, fcntl locking is used, but this may be overridden by
the
.B datalocking
profile entry.
@@ -153,7 +148,6 @@ platform, and it is for popular platforms. That default
should also
be the same as used by the
.B mail
program, if provided on the platform.
-.PP
.SS Naming
.B nmh
folders can be given arbitrary names, with one exception:
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Nmh-workers] Changes to mh-folders.man,
Larry Hynes <=