Replaced -oauth service switch with -saslmech xoauth2

[nmh] / man / mh-folders.man

diff --git a/man/mh-folders.man b/man/mh-folders.man
index 4b560e473c2f9adbf0ff57f3c897fc16002e810e..1876107b5a662e7fcb9f9f08739237709bf988e6 100644 (file)
--- a/man/mh-folders.man
+++ b/man/mh-folders.man
@@ -1,4 +1,4 @@
-.TH MH-MAIL %manext5% "March 7, 2013" "%nmhversion%"
+.TH MH-FOLDERS %manext5% "February 25, 2016" "%nmhversion%"

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


@@ -128,15 +128,43 @@ outside of
 that accesses these files must be sure to lock them using the same
 locking method as
 .BR nmh .
 that accesses these files must be sure to lock them using the same
 locking method as
 .BR nmh .

-The locking method is selected when
+The default data locking method is selected when

 .B nmh
 is configured and can be accessed as a string using
 .B nmh
 is configured and can be accessed as a string using

-.BR "mhparam lockmethod" .
+.BR "mhparam datalocking" .
+By default, fcntl locking is used, but this may be overridden with
+the
+.B datalocking
+profile entry.
+.PP
+A second, possibly different, locking method is used by
+.BR inc (1)
+when accessing the user's mail spool file or by
+.B nmh
+programs that open any mbox file.  This locking method can be overridden
+when
+.B nmh
+is configured, or in the
+.B nmh
+mts configuration file, and can be accessed as a string using
+.BR "mhparam spoollocking" .

 By default, kernel-level locking is used if appropriate for the
 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.
 By default, kernel-level locking is used if appropriate for the
 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:
+folders should not be given all-numeric names.  This
+limitation results from
+.B nmh
+messages themselves being stored
+in numerically named files -- allowing folders to be named
+similarly would make
+.B nmh
+slower, and introduce usage ambiguities.

 .SH FILES
 .fc ^ ~
 .nf
 .SH FILES
 .fc ^ ~
 .nf


@@ -151,9 +179,10 @@ program, if provided on the platform.
 .IR folder (1),
 .IR mail (1),
 .IR mark (1),
 .IR folder (1),
 .IR mail (1),
 .IR mark (1),

-.IR mh\-param (1),
-.IR mh\-path (1),
+.IR mhparam (1),
+.IR mhpath (1),

 .IR mh\-profile (5),
 .IR mh\-sequence (5),
 .IR mh\-profile (5),
 .IR mh\-sequence (5),

+.IR mh\-tailor (5),

 .IR pick (1),
 .IR rcvstore (1)
 .IR pick (1),
 .IR rcvstore (1)