folders - list folders and contents (only available within
the message handling system, mh)
folders [+folder] [msg] [options]
Lists only the name of folders, with no additional information.
This is faster because the folders need not be
read. 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. Re-numbers messages in
the folders. 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 folders recursively.
Information on each 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 individual folders. It can be suppressed
using the -nototal option.
The defaults for folders are:
+folder defaults to all
msg defaults to none
The folders command displays the names of your folders and
the number of messages that they each contain.
The folders command displays a list of all the folders in
your Mail directory. The folders are sorted alphabetically,
each on its own line. This is illustrated in the
following example: 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.
The plus sign (+) after inbox indicates that it is the
current folder. The information about the int folder
includes the term (others). This indicates that the folder
int contains files which are not messages. These files may
be either sub-folders, or files that do not belong under
the MH file naming scheme.
The folders command is identical to the effect of using
the -all option to the folder command.
If you use folders with the +folder argument, it will display
all the subfolders within the named folder. as shown
in the following example:
% folders +test Folder # of messages ( range
); cur msg (other files) test+ has 18 messages
( 1- 18); (others). test/testone has 1
message ( 1- 1). test/testtwo has no messages.
TOTAL= 19 messages in 3 folders.
See refile(1) for more details of sub-folders.
MH does not allow you to have more than 100 folders at any
level in your Mail directory.
Path: To determine your MH directory
Folder-Protect: To set protections when creating a new
Folder-Stack: To determine the folder stack
lsproc: Program to list the contents of a folder
The user profile.
csh(1), folder(1), refile(1), mhpath(1)
[ Back ]