]> diplodocus.org Git - nmh/blobdiff - man/folder.man
Added note that suffixes were removed from filenames of temporary files.
[nmh] / man / folder.man
index 8fd456df944005d605cfa6231c1424481e21dc2b..401ab5b80eb27e64cbbd08e582f1bfe3779ee377 100644 (file)
@@ -1,15 +1,15 @@
+.TH FOLDER %manext1% "January 1, 2001" "%nmhversion%"
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
-.TH FOLDER %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 folder, folders \- set/list current folder/message
 .SH SYNOPSIS
 .HP 5
+.na
 .B folder
 .RI [ +folder ]
-.RI [ msgs ]
+.RI [ msg ]
 .RB [ \-all " | " \-noall ]
 .RB [ \-create " | " \-nocreate ]
 .RB [ \-fast " | " \-nofast ]
@@ -29,6 +29,7 @@ folder, folders \- set/list current folder/message
 is equivalent to
 .B folder
 .B \-all
+.ad
 .SH DESCRIPTION
 Since the
 .B nmh
@@ -86,9 +87,7 @@ without creating a non-existant folder.
 .\" If `\-noprint' is specified, 
 .\" a `+folder' and/or `msg' may still be specified
 .\" to set the current folder and/or message,
-.\" but the folder summary will not be printed.
-
-.SS "Multiple Folders"
+.\" but the folder summary will not be printed..SS "Multiple Folders"
 Specifying
 .B \-all
 will produce a summary line for each top-level folder
@@ -121,7 +120,6 @@ mh  has \076 messages       (15\-\076);     cur=70.
 notes  has \0\02 messages      (\01\-\0\02);   cur=\01.
 ucom   has 124 messages        (\01\-124);     cur=\06; (others).
 .ta \w'/rnd/phyl/Mail/EP has 'u
-
 TOTAL = 339 messages in 7 folders
 .fi
 .RE
@@ -167,10 +165,17 @@ for the current folder (with
 .BR \-norecurse )
 or list all sub-folders under the current folder recursively (with
 .BR \-recurse ).
-In this case, if a
+.PP
+If
 .I msg
-is also supplied, it will become the current message of
-.IR +folder .
+is supplied, together with
+.IR +folder
+or without
+.BR \-all ,
+it will become the current message of
+.IR +folder
+(if it had been supplied)
+or the current folder.
 .PP
 The
 .B \-recurse
@@ -255,50 +260,71 @@ and
 .B \-list
 switches turn off
 .BR \-print .
-
 .SH FILES
-.fc ^ ~
-.nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
-.fi
-
+.TP 20
+$HOME/.mh\-profile
+The user's profile.
 .SH "PROFILE COMPONENTS"
-.fc ^ ~
-.nf
-.ta 2.4i
-.ta \w'ExtraBigProfileName  'u
-^Path:~^To determine the user's nmh directory
-^Current\-Folder:~^To find the default current folder
-^Folder\-Protect:~^To set mode when creating a new folder
-^Folder\-Stack:~^To determine the folder stack
+.PD 0
+.TP 20
+Path:
+To determine the user's nmh directory.
+.TP
+Current\-Folder:
+To find the default current folder.
+.TP
+Folder\-Protect:
+To set mode when creating a new folder.
+.TP
+Folder\-Stack:
+To determine the folder stack.
 .\" ^lsproc:~^Program to list the contents of a folder
-.fi
-
+.PD
 .SH "SEE ALSO"
-refile(1), mhpath(1)
-
+.IR mhpath (1),
+.IR refile (1)
 .SH DEFAULTS
-.nf
-.RB ` +folder "' defaults to the current folder"
-.RB ` msg "' defaults to none"
-.RB ` \-nofast '
-.RB ` \-noheader '
-.RB ` \-nototal '
-.RB ` \-nopack '
-.RB ` \-norecurse '
-.RB ` \-noverbose '
-.RB ` \-print "' is the default if no " \-list ", " \-push ", or " \-pop " is specified"
-.RB ` \-list "' is the default if " \-push ", or " \-pop " is specified"
-.fi
-
+.PD 0
+.TP 20
++folder
+The current folder.
+.TP
+msg
+\*(lqnone\*(rq
+.TP
+\-nofast
+.TP
+\-noheader
+.TP
+\-nototal
+.TP
+\-nopack
+.TP
+\-norecurse
+.TP
+\-noverbose
+.TP
+\-print
+is the default if no
+.BR -list ,
+.BR \-push ,
+or
+.B \-pop
+is specified.
+.TP
+\-list
+is the default if
+.BR \-push ,
+or
+.B \-pop
+is specified.
+.PD
 .SH CONTEXT
 If
 .I +folder
 and/or
 .I msg
 are given, they will become the current folder and/or message.
-
 .SH BUGS
 There is no way to restore the default behavior 
 (to ask the user whether to create a non-existant folder)