folder(1mh)folder(1mh)Namefolder - set folder or display current folder name
Syntaxfolder [ +folder ] [ msg ] [ options ]
Description
The 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 command without a +folder argument, information about
the current folder is displayed on the screen. If you use 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 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 con‐
tents 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.
Options-all Displays information on all the folders in your Mail direc‐
tory. The folders are listed alphabetically, with a line of
information given for each folder. This is identical to the
display produced by the command. See
-fast
-nofast Lists only the name of the current folder, with no additional
information. This is faster because the folders need not be
read.
-header
-noheader 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
or by The header can be suppressed by using the -noheader
option.
-help Prints a list of the valid options to this command.
-list
-nolist 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 operation in the C-shell.
-pack
-nopack 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 num‐
bering in the folder.
-pop Discards the top of the folder-stack, after setting the cur‐
rent folder to that value. No +folder argument is allowed
with this option. This corresponds to the operation in the
C-shell; see The -push and -pop options are mutually exclu‐
sive: the last occurrence of either one overrides any previ‐
ous occurrence of the other.
-push 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 operation in the C-
shell; see The -push switch and the -pop switch are mutually
exclusive: the last occurrence of either one overrides any
previous occurrence of the other.
-recurse
-norecurse
Lists each folder recursively. Information on the current
folder is displayed, followed by information on any sub-fold‐
ers which it contains.
-total
-nototal Displays only the total number of messages and folders in
your Mail directory. This option does not print any informa‐
tion about the current folder. It can be suppressed using
the -nototal option.
The defaults for are:
+folder defaults to the current folder
msg defaults to none
-nofast
-noheader
-nototal
-nopack
-norecurse
Examples
The following example shows how can be used to change the current
folder to and display information on that folder. The plus sign (+)
next to indicates that it is now the current folder.
% folder +test
test+ has 2 messages ( 1- 2); cur= 2.
The next example shows the display produced by using the -all option to
Folder # of messages ( range ); cur msg (other files)
V2.3 has 3 messages ( 1- 3).
adrian has 20 messages ( 1- 20); cur= 2.
brian has 16 messages ( 1- 16).
chris has 12 messages ( 1- 12).
copylog has 242 messages ( 1- 242); cur= 225.
inbox+ has 73 messages ( 1- 127); cur= 127.
int has 4 messages ( 1- 4); cur= 2 (others).
jack has 17 messages ( 1- 17); cur= 17.
TOTAL= 387 messages in 8 folders.
This display is identical to that produced by the command. See for an
explanation of this display.
The next example shows how to use to create an empty folder:
% folder +test
Create folder "$HOME/Mail/test"? y
test+ has no messages.
You can also use to create an empty sub-folder within an existing
folder. The following example shows how you can create a sub-folder in
the folder
% folder +test/testtwo
Create folder "$HOME/Mail/test/testwo"? y
test/testtwo+ has no messages.
See for more details of sub-folders.
Files
The user profile.
Profile Components
Path: To determine your MH 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
lsproc: Program to list the contents of a folderSee Alsocsh(1), refile(1mh), mhpath(1mh)folder(1mh)