folders Command

AIX Version 4.3 Commands Reference, Volume 2

folders Command

Purpose

Lists all folders and messages in mail directory.

Syntax

Description

The folders command lists all folders and messages in your mail directory. This command is equivalent to the folder command specified with the -all flag.

Flags

-fast

Displays only the names of the folders.

+Folder

Specifies the folder information to display.

-header

Displays column headings for the folder information. This flag is the default.

-help

Lists the command syntax, available switches (toggles), and version information.

Note: For Message Handler (MH), the name of this flag must be fully spelled out.

-list

Displays the current folder followed by the contents of the folder stack.

Message

Sets the specified message as the current message. Unless you specify the +Folder flag, the command sets the specified message for the current folder. Use the following references to specify a message:

Number	Number of the message.
cur or . (period)	Current message. This is the default.
first	First message in a folder.
last	Last message in a folder.
next	Message following the current message.
new	The new message that is created.
prev	Message preceding the current message.

-nofast

Displays information about each folder. This flag is the default.

-noheader

Suppresses column headings for the folder information.

-nolist

Suppresses the display of the folder-stack contents. This flag is the default.

-nopack

Prevents renumbering of the messages in the folder. This flag is the default.

-noprint

Prevents display of folder information. If the -push, -pop, or -list flag is specified, the -noprint flag is the default.

-norecurse

Displays information about the folders in your mail directory. Information about subfolders is not displayed. This flag is the default.

-nototal

Prevents display all messages and folders in your mail directory structure.

-pack

Renumbers the messages in the folders. Renumbering eliminates gaps in message numbering after messages have been deleted.

-pop

Removes the folder from the top of the folder stack and makes it the current folder.

-print

Displays the number of messages in each folder, the current message for each folder, and the current folder. If the -push, -pop, or -list flag is specified, the -noprint flag is the default; otherwise, the -print flag 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, the -push flag swaps the current folder for the folder on top of the folder stack.

-recurse

Displays information about all folders and subfolders in your mail directory structure.

-total

Displays all messages and folders in your mail directory structure. The -total flag does not display information for subfolders unless you specify the -recurse flag. The -total flag is the default.

Profile Entries

The following entries are entered in the UserMhDirectory/.mh_profile file:

`Current-Folder:`	Sets the default current folder.
`Folder-Protect:`	Sets the protection level for the new folder directories.
`Folder-Stack:`	Specifies the folder stack.
`lsproc:`	Specifies the program used to list the contents of a folder.
`Path:`	Specifies the user's MH directory.

Examples

To display information about all folders, enter:
```
folders
```
The system responds with a message similar to the following:
```
Folder  # of messages (range); cur msg  (other files)
inbox+ has 80 messages (1-82); cur= 7; (others).
test  has  5 messages (1-6);  cur= 5; (others).
 
    Total= 85 messages in 2 folders. 
```
In this example, there are 2 folders containing a total of 85 messages. The current folder is inbox , indicated by the + (plus sign) following it.
To list only the names of all folders, enter:
```
folders -fast
```
The system responds with a message similar to the following:
```
inbox
test
```
To renumber the messages in all folders, enter:
```
folders -pack
```
The system responds with a message similar to the following:
```
inbox+ has 80 messages (1-80); cur= 7; (others).
test  has  5 messages (1-5);  cur= 5; (others).
```
In this example, the messages in the inbox folder and in the test folder have been renumbered to eliminate gaps in message numbering after messages were deleted.

Files

$HOME/.mh_profile	Contains the MH user profile.
/usr/bin/folders	Contains the folders command.

Related Information

The folder command, mhpath command, packf command, refile command.

The mh_alias file format, mh_profile file format.

Mail Overview in AIX Version 4.3 System User's Guide: Communications and Networks.

Peek, Jerry. MH and xmh: E-mail for Users and Programmers. Sebastopol, CA: O'Reilly & Associates, 1992.