folder

NAME

folder - set folder or display current folder name (only available within the message handling system, mh)

SYNOPSIS

folder [+folder] [msg] [options]

OPTIONS

Displays information on all the folders in your Mail directory.
The folders are listed alphabetically, with a line of information given for
each folder. This is identical to the display produced by the
folders
command. See
folders(1).
Lists only the name of the current folder, with no additional
information. This is faster because the folders need not be read.
Displays a header produced by the system, in addition to the
information about the current file. This header is identical to the one that
appears at the top of the listing produced by
folder
-all
or by
folders. The header can be suppressed
by using the
-noheader
option.
Prints a list of the valid options to this command.
Lists the contents of the folder-stack. No
+folder
argument is allowed with this option. The contents of the folder-stack
are listed automatically when the
-pop
or
-push
option is used. This corresponds to the
dirs
operation
in the C-shell.
Re-numbers messages in the folder. Messages are re-numbered
sequentially, and any gaps in the numbering are removed. The default operation
is
-nopack, which does not change the numbering in the folder.
Discards the top of the folder-stack, after setting the current
folder to that value. No
+folder
argument is allowed
with this option. This corresponds to the
popd
operation
in the C-shell; see
csh(1). The
-push
and
-pop
options
are mutually exclusive: the last occurrence of either one overrides any previous
occurrence of the other.
Pushes the current folder onto the folder-stack, and makes
the
+folder
argument into the current folder. If
+folder
is not given, the current folder and the top of the
folder-stack are exchanged. This corresponds to the
pushd
operation in the C-shell; see
csh(1). The
-push
switch
and the
-pop
switch are mutually exclusive: the last occurrence
of either one overrides any previous occurrence of the other.
Lists each folder recursively. Information on the current
folder is displayed, followed by information on any sub-folders which it contains.
Displays only the total number of messages and folders in
your Mail directory. This option does not print any information about the
current folder. It can be suppressed using the
-nototal
option.

DESCRIPTION

The
folder
command lets you set the current folder, or display information about it.
It can also be used to manage the folder stack.

If you use the
folder
command without a
+folder
argument, information about the current folder is displayed
on the screen. If you use
folder
with the
+folder
argument, the named folder is set to be the current
folder. Information about the named folder is also displayed on the screen.

If you use
folder
with the
msg
argument, it will set the specified message to be current. Information on
the current folder is also displayed. You can use both the
+folder
and
msg
arguments together in one
command.

If you specify a
+folder
that does not exist,
you are asked whether you want to create it. This is a good way to create
an empty folder for later use.

The display is identical whether you set the folder or display the contents
of the current folder. The following example shows the type of display that
is produced. The display lists the current folder, the number of messages
in it, the range of the messages (low-high), and the current message within
the folder. It also flags extra files if they exist.
inbox+ has 16 messages ( 3- 22); cur= 15.

This display is identical to that produced by the
folders
command. See
folders(1)
for an explanation of this display.
The next example shows how to use
folder
to create an empty folder:
% folder +test
Create folder "$HOME/Mail/test"? y
test+ has no messages.
You can also use
folder
to create an empty
sub-folder within an existing folder. The following example shows how you
can create a sub-folder in the folder
+test:
% folder +test/testtwo
Create folder "$HOME/Mail/test/testwo"? y
test/testtwo+ has no messages.