folder
PURPOSE
Selects and lists folders and messages.
SYNOPSIS
folder [+folder][msg][-all][-fast][-nofast][-header]
[-noheader][-pack][-nopack][-recusre][-norecurse]
[-total][-nototal][-print][-noprint][-list]
[-nolist][-push][-pop]
folder
DESCRIPTION
The folder command is used to set the current folder and
the current message for that folder, and to list informa-
tion about your folders. The folder command is part of
the MH (Message Handling) package and can be used with
other MH and AIX commands.
The folder command entered with only the -all flag gives
a line of information for each folder in your mail direc-
tory. This information tells how many messages are in
each folder, what the current message is for each folder,
what the range of message numbers is in each folder, and
if a folder is the current folder. The folder command
specified without arguments provides information for the
current folder. The -recurse flag displays this informa-
tion for all folders and sub-folders in your entire mail
directory structure.
Specify a folder with the folder command to make it the
current folder, and a message to make it the current
message for that folder. You can also create a folder-
stack to manipulate a group of folders by using the
-push, -pop, and -list flags.
FLAGS
-all Displays a line of information about each
folder in your mail directory. Specify
+folder to display the information about
that folder and the sub-folders within that
folder's directory. Add the -recurse flag
to display the information about the speci-
fied folder and for all sub-folders in all
directories under the specified folder's
directory.
-fast Displays only the names of the folders.
+folder msg Sets the specified folder as the current
folder, and the specified message as the
current message. You can use the following
message references when specifying msgs:
num sequence first
prev cur .
next last
If you specify a sequence, that sequence
must contain one message only.
The default folder is the current folder.
The default message is none.
-header Displays column headings for the folder
information.
-help Displays help information for the command.
-list Displays the current folder followed by the
contents of the folder-stack.
-nofast Displays information about each folder.
This flag is the default.
-noheader Suppresses column headings for the folder
information. This flag is the default.
-nolist Suppresses the display of the folder-stack
contents. This flag is the default.
-nopack Does not renumber the messages in the
folder. This flag is the default.
-noprint Does not display folder information. If
-push, -pop, or -list is specified, -noprint
is the default.
-norecurse Displays information about the top-level
folders in your current folder only, not
about sub-folders. This flag is the
default.
-nototal Does not display a total of all messages and
folders in your mail directory structure.
-total is the default when -all is speci-
fied, otherwise -nototal is the default.
-pack Renumbers the messages in the specified
folder. This renumbering eliminates the
gaps in the message numbering after messages
have been deleted.
-pop Removes the folder from the top of the
folder-stack and makes it the current
folder. +folder cannot be specified with
the -pop flag.
-print Displays information about the folders.
This information includes the number of mes-
sages in each folder, the current message
for each folder, and the current folder. If
-push, -pop, or -list is specified, -noprint
is the default, otherwise -print is the
default.
-push Moves the current folder to the top of the
folder-stack and sets the specified folder
as the current folder. If no folder is
specified, -push swaps the current folder
with the folder on the top of the folder-
stack.
-recurse Displays information about all folders and
sub-folders in your current folder. You can
specify a folder to display the information
about that folder and its sub-folders only.
-total Displays a total of all messages and folders
in your mail directory structure. -total
does not display information for sub-folders
unless you also specify the -recurse flag.
The -total flag is the default if -all is
specified.
PROFILE ENTRIES
Current-Folder: Sets your default current folder.
Folder-Protect: Sets the protection level for your new
folder directories.
Folder-Stack: Specifies your folder stack.
lsproc: Specifies the program used to list the
contents of a folder.
Path: Specifies your user_mh_directory.
FILES
$HOME/.mh_profile The MH user profile.
RELATED INFORMATION
Other MH commands: "folders," "mhpath," "packf,"
"refile."
The mh-profile file in AIX Operating System Technical
Reference.
The "Overview of the Message Handling Package" in Man-
aging the AIX Operating System.