]> diplodocus.org Git - nmh/blobdiff - man/mh-folders.man
Replace getcpy() with mh_xstrdup() where the string isn't NULL.
[nmh] / man / mh-folders.man
index 52cde2777e794f090956804d46e19d6e0df62059..65a1d3e93ad18e5d58e8001e3cdce6311effc427 100644 (file)
@@ -1,4 +1,4 @@
-.TH MH-FOLDERS %manext5% "February 26, 2014" "%nmhversion%"
+.TH MH-FOLDERS %manext5% "February 25, 2016" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -108,7 +108,7 @@ the sequence file should be updated to remove the missing messages
 from the sequence.  If a sequence contains no messages, it should be
 removed from the sequence file.  The exception to this is the
 .B cur
-sequence, which can refer to a nonexistant message.
+sequence, which can refer to a nonexistent message.
 .RE
 .PP
 .SS Locking
@@ -141,33 +141,51 @@ 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 is selected
+programs that open any mbox file.  This locking method can be overridden
 when
 .B nmh
-is configured and can be accessed as a string using
+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.
+.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
-.ta \w'^<folder>/\&.mh\(rusequences~'u
-^<mh\-dir>/context~^The user context
-^or $MHCONTEXT~^Rather than the standard context
-^<folder>/\&.mh\(rusequences~^Public sequences for <folder>
-.fi
+.PD 0
+.TP 20
+<mh\-dir>/context
+The user's context.
+.TP 20
+$MHCONTEXT
+Overrides the above context.
+.TP 20
+<folder>/\&.mh\-sequences
+Public sequences for <folder>.
 .SH "SEE ALSO"
 .I
 .IR flist (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\-tailor (5),
 .IR pick (1),
 .IR rcvstore (1)