FOLDER(1MH) COMMAND REFERENCE FOLDER(1MH)
NAME
folder, folders - set/list current folder/message
SYNOPSIS
folder [+folder] [msg] [-pack] [-nopack] [-all] [-fast]
[-nofast] [-up] [-down] [-header] [-noheader]
[-total] [-nototal] [-help]
The folders command is equivalent to the command folder
-all.
DESCRIPTION
Since the mail handling (MH) environment is the shell, it is
easy to lose track of the current folder from day to day;
using the folder command, you can list the current folder,
the number of messages in it, the range of the messages
(low-high), and the current message within the folder; the
command will flag a selection list or extra files if they
exist. An example of the folder output is listed here:
inbox+ has 16 messages ( 3- 22); cur= 5.
If a +folder and/or msg are specified, they become the
current folder and/or message. A -all switch produces 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 mh_profile 'cur-' entries. 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.
notes has 2 messages ( 1- 2); cur= 1.
inbox+ has 16 messages ( 3- 22); cur= 5.
ff has 4 messages ( 1- 4); cur= 1.
mh has 76 messages ( 1- 76); cur= 70.
misc has 1 message ( 1- 1).
junk has no messages.
ucom has 124 messages ( 1-124); cur= 6; (select).
TOTAL = 340 messages in 9 Folders
The + after inbox indicates that it is the current folder.
The (select) indicates that the folder ucom has a selection
list produced by pick(1mh). If others had appeared in
parentheses at the right of a line, it would indicate that
there are files in the folder directory that don't belong
under the MH file naming scheme.
The header is output if either a -all or a -header switch is
specified; it is suppressed by -noheader. Also, if folder
Printed 4/6/89 1
FOLDER(1MH) COMMAND REFERENCE FOLDER(1MH)
is invoked by a name ending with s (e.g., folders), -all is
assumed. A -total switch produces only the summary line.
If -fast is given, only the folder name (or names in the
case of -all) is listed; this is faster because the folders
need not be read).
The switches -up and -down change the folder to be the one
above or below the current folder. That is, the command
folder -down will set the folder to <current-folder>/select,
and if the current folder is a selection-list folder, the
command folder -up will set the current folder to the parent
of the selection-list. (See pick(1mh) for details on
selection-lists).
The switch -pack causes the messages in the selected folders
to be renumbered; this eliminates the holes in the sequence
caused by removing messages.
If the commands +folder and/or msg are given, they will
become the current folder and/or message.
The folder command has the following defaults:
+folder defaults to the current folder
msg defaults to none
-nofast
-noheader
-nototal
Your .mh_profile can contain the following entries:
Path: To determine the user's MH directory
Current-Folder: To find the default current folder
OPTIONS
-all Produces a list of all the folders in
the MH directory, sorted alphabetically.
-down Changes the current folder to the one
next in the folder list.
-fast Prints only the names of the folder or
folders. (This is faster than the
conventional method because the folders
do not have to be read.)
-header Prints the folder header line.
Printed 4/6/89 2
FOLDER(1MH) COMMAND REFERENCE FOLDER(1MH)
-help Prints a list of the possible switches
for the folder command.
-nofast Suppresses the fast function.
-noheader Suppresses the header function.
-nopack Suppresses the pack function.
-nototal Suppresses the total function.
-pack Renumbers the messages in a folder,
eliminating holes in the numbering
sequence.
-total Prints the summary line only.
-up Changes the current folder to the
previous one in the folder list.
FILES
$HOME/.mh_profile The user profile
/bin/ls To fast-list the folders
SEE ALSO
comp(1mh), fmt(1mh), folder(1mh), forw(1mh), inc(1mh),
mail(1mh), mh(1mh), mhl(1mh), next(1mh), pick(1mh),
prev(1mh), prompter(1mh), refile(1mh), repl(1mh), rmf(1mh),
rmm(1mh), scan(1mh), send(1mh), show(1mh), mh(5mh), and
mh_profile(5mh).
Printed 4/6/89 3
%%index%%
na:336,101;
sy:437,1259;
de:1696,2598;4702,2198;
op:6900,828;8136,1422;
fi:9558,198;
se:9756,667;
%%index%%000000000131