]> diplodocus.org Git - nmh/blobdiff - man/mh-folders.man
Remove trailing spaces from lines in man pages.
[nmh] / man / mh-folders.man
index 65a1d3e93ad18e5d58e8001e3cdce6311effc427..ec6ac0de2a59db808d7037cb7d825c9883a34c35 100644 (file)
@@ -1,4 +1,4 @@
-.TH MH-FOLDERS %manext5% "February 25, 2016" "%nmhversion%"
+.TH MH-FOLDERS %manext5% "March 21, 2017" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
 .\"
 .\" %nmhwarning%
 .\"
@@ -11,26 +11,25 @@ according to the following rules:
 .PP
 .B one folder per directory
 .RS 5
 .PP
 .B one folder per directory
 .RS 5
-A
+An
 .B nmh
 .B nmh
-folder corresponds to directory.  There are no limits on folder
+folder corresponds to 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
 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
 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
 .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
 .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
 .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:
 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
 .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.
 .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
 .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 ,
 .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
 .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 ,
 .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
 .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
 .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
 .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" .
 .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.
 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.
 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:
 .SS Naming
 .B nmh
 folders can be given arbitrary names, with one exception:
@@ -177,7 +171,6 @@ Overrides the above context.
 <folder>/\&.mh\-sequences
 Public sequences for <folder>.
 .SH "SEE ALSO"
 <folder>/\&.mh\-sequences
 Public sequences for <folder>.
 .SH "SEE ALSO"
-.I
 .IR flist (1),
 .IR folder (1),
 .IR mail (1),
 .IR flist (1),
 .IR folder (1),
 .IR mail (1),