folder(1)folder(1)NAMEfolder - set folder or display current folder name (only available
within the message handling system, mh)
SYNOPSISfolder [+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 opera‐
tion 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 cor‐
responds 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 dis‐
played, 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.
The defaults for folder are:
+folder defaults to the current folder
msg defaults to none
-nofast
-noheader
-nototal
-nopack
-norecurse
DESCRIPTION
The folder command lets you set the current folder, or display informa‐
tion 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 mes‐
sage to be current. Information on the current folder is also dis‐
played. 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.
RESTRICTIONS
Do not create folder names that are made up of only digits.
PROFILE COMPONENTS
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 folderEXAMPLES
The following example shows how folder can be used to change the cur‐
rent folder to +test, and display information on that folder. The plus
sign (+) next to test 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:
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 folders com‐
mand. 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 fol‐
lowing 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.
See refile(1) for more details of sub-folders.
FILES
The user profile.
SEE ALSOcsh(1), refile(1), mhpath(1)folder(1)