+.TH FOLDER %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.\"
.\" %nmhwarning%
-.\" $Id$
.\"
-.TH FOLDER %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
folder, folders \- set/list current folder/message
.SH SYNOPSIS
.na
.B folder
.RI [ +folder ]
-.RI [ msgs ]
+.RI [ msg ]
.RB [ \-all " | " \-noall ]
.RB [ \-create " | " \-nocreate ]
.RB [ \-fast " | " \-nofast ]
.\" 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
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
.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
.B \-list
switches turn off
.BR \-print .
-
.SH FILES
.fc ^ ~
.nf
.ta \w'%etcdir%/ExtraBigFileName 'u
^$HOME/\&.mh\(ruprofile~^The user profile
.fi
-
.SH "PROFILE COMPONENTS"
.fc ^ ~
.nf
^Folder\-Stack:~^To determine the folder stack
.\" ^lsproc:~^Program to list the contents of a folder
.fi
-
.SH "SEE ALSO"
-refile(1), mhpath(1)
-
+.IR mhpath (1),
+.IR refile (1)
.SH DEFAULTS
.nf
.RB ` +folder "' defaults to the current folder"
.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
-
.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)