FOLDER(1) [mh.6] FOLDER(1)
NAME
folder, folders - set/list current folder/message
SYNOPSIS
folder [+folder] [msg] [-all] [-fast] [-nofast] [-header]
[-noheader] [-pack] [-nopack] [-recurse] [-norecurse]
[-total] [-nototal] [-print] [-noprint] [-list]
[-nolist] [-push] [-pop] [-help]
folders
DESCRIPTION
Since the MH environment is the shell, it is easy to lose
track of the current folder from day to day.
When folder is given the `-print' switch (the default),
the current folder and/or message may be set, or all fold-
ers may be listed. When a `+folder' argument is given,
this corresponds to a cd operation in the CShell; when no
`+folder' argument is given, this corresponds roughly to a
pwd operation in the CShell.
Folder will list the current folder, the number of mes-
sages in it, the range of the messages (low-high), and the
current message within the folder, and will flag extra
files if they exist. An example of the output is:
inbox+ has 16 messages ( 3- 22); cur= 5.
If a `+folder' and/or `msg' are specified, they will
become the current folder and/or message. Specifying
`-all' will produce a line for each folder in the user's
MH directory, sorted alphabetically. These folders are
preceded by the read-only folders, which occur as atr-cur-
entries in the user's MH context. For example,
Folder # of messages ( range ) cur msg (other files)
/fsd/rs/m/tacc has 35 messages ( 1- 35); cur= 23.
/rnd/phyl/Mail/EP has 82 messages ( 1-108); cur= 82.
ff has no messages.
inbox+ has 16 messages ( 3- 22); cur= 5.
mh has 76 messages ( 1- 76); cur= 70.
notes has 2 messages ( 1- 2); cur= 1.
ucom has 124 messages ( 1-124); cur= 6; (others).
TOTAL= 339 messages in 7 folders
The + after inbox indicates that it is the current folder.
The (others) indicates that the folder `ucom' has files
which aren't messages. These files may either be
sub-folders, or files that don't belong under the MH file
naming scheme.
The header is output if either an `-all' or a `-header'
switch is specified; it is suppressed by `-noheader'.
MH April 22, 1986 1
FOLDER(1) [mh.6] FOLDER(1)
Also, if folder is invoked by a name ending with s (e.g.,
folders ), `-all' is assumed. A `-total' switch will pro-
duce only the summary line.
If a `+folder' and/or `msg' is given along with the `-all'
switch, folder will, in addition to setting the current
folder and/or message, list the top-level folders for the
current folder (with `-norecurse') or list all folders
under the current folder recursively (with `-recurse').
If `-fast' is given, only the folder name (or names in the
case of `-all') will be listed. (This is faster because
the folders need not be read.)
The `-pack' switch will compress the message names in a
folder, removing holes in message numbering.
The `-recurse' switch will list each folder recursively.
Use of this option effectively defeats the speed enhance-
ment of the `-fast' option, since each folder must be
searched for subfolders. Nevertheless, the combination of
these options is useful.
If the specified (or default) folder doesn't exist, the
user will be queried if the folder should be created.
(This is the easy way to create an empty folder for use
later.)
The `-push' switch directs folder to push the current
folder onto the folder-stack, and make the `+folder' argu-
ment 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
CShell.
The `-pop' switch directs folder to discard the top of the
folder-stack, after setting the current folder to that
value. No `+folder' argument is allowed. This corre-
sponds to the popd operation in the CShell. The `-push'
switch and the `-pop' switch are mutually exclusive: the
last occurrence of either one overrides any previous
occurrence of the other.
The `-list' switch directs folder to list the contents of
the folder-stack. No `+folder' argument is allowed.
After a successful `-push' or `-pop', the `-list' action
is taken. This corresponds to the dirs operation in the
CShell.
FILES
$HOME/.mh_profile The user profile
PROFILE COMPONENTS
Path: To determine the user's MH directory
MH April 22, 1986 2
FOLDER(1) [mh.6] FOLDER(1)
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 folder
SEE ALSO
refile(1), mhpath(1)
DEFAULTS
`+folder' defaults to the current folder
`msg' defaults to none
`-nofast'
`-noheader'
`-nototal'
`-nopack'
`-norecurse'
`-print' is the default if no `-list', `-push', or `-pop' is specified
CONTEXT
If `+folder' and/or `msg' are given, they will become the
current folder and/or message.
HISTORY
In previous versions of MH, the `-fast' switch prevented
context changes from occurring for the current folder.
This is no longer the case: if `+folder' is given, then
folder will always change the current folder to that.
MH April 22, 1986 3