Produces formatted listings of messages.
mhl [ -form FormFile ] [ -folder +Folder ] [ -moreproc Command | -nomoreproc [ -bell | -nobell ] [ -clear | -noclear ] ] [ -length Number ] [ -width Number ]
The mhl command creates formatted lists of messages. The command is usually started through the showproc: profile entry or through the -showproc flag in other MH commands. When displaying messages, the mhl command uses the directions listed in the format file. If you specify more than one message, the mhl command provides a prompt before displaying each screen of messages.
If the -nomoreproc flag is specified, the mhl command prompts the user to press the Return key (the Ctrl-D key sequence is also acceptable) to see the next message. To stop the current message output and receive a prompt for the next message, press the Ctrl-D key sequence. Press the QUIT key sequence to stop the command output.
Note: To use the mhl command, you must make the folder you wish to work with the current directory.
| Item | Description |
|---|---|
| -bell | Produces a bell at the end of each page. When the -nomoreproc flag is specified or the moreproc: profile entry is defined, but empty, the -bell flag is the default. |
| -clear | Clears the screen after each page when the output device is a display. The mhl command uses the $TERM environment variable to determine the type of display. When the output device is not a display, the -clear flag inserts a form feed character at the end of each message. This flag affects the mhl command only if the moreproc: profile entry is defined and empty. |
| -folder +Folder | Identifies the folder to be used for the mhl.format file's MessageName: entry. The default is the value of the $mhfolder environment variable. |
| -form FormFile | Specifies a file containing an alternate output format. The default format is described in the UserMHDirectory/mhl.format file. If this file does not exist, the mhl command uses the system default format described in the /etc/mh/mhl.format file. |
| -help | Lists the command syntax, available switches (toggles), and
version information. Note: For MH, the name of this flag must be fully spelled out. |
| -length Number | Sets the screen length for the output. The default is the value indicated by the $TERM environment variable. If that value is not appropriate, the default is 40 lines. |
| -moreproc Command | Uses the value of the Command variable instead of the value of the moreproc: entry specified in the $HOME/.mh_profile file. |
| -nobell | Suppresses the bell at the end of each page. This flag affects the mhl command only if the output device is a display, the -nomoreproc flag is used, or the moreproc: profile entry is defined and empty. |
| -noclear | Prevents clearing of the screen at the end of each page when the output device is a display. When the output device is not a display, the -clear flag does not insert a form-feed character at the end of each message. This flag is the default when the -moreproc flag is used or the moreproc: entry is defined and is empty. |
| -nomoreproc | Sets the moreproc: entry as an empty value. |
| -width Number | Sets the screen width for the output. The default is the value indicated by the $TERM environment variable. If that value is not appropriate, the default is 80 characters. |
The following entry is found in the UserMHDirectory/.mh_profile file:
| Item | Description |
|---|---|
| moreproc: | Specifies the interactive program for communicating with the user. |
cd /home/mickey/Mail/inbox/usr/lib/mh/mhl 5--- Using template MHL.FORMAT ---
Date:
To:
cc:
From:
Subject:
Message Text/usr/lib/mh/mhl 5 6 7| Item | Description |
|---|---|
| $HOME/.mh_profile | Contains the MH user profile. |
| /etc/mh/mhl.format | Defines the default MH message template. |
| UserMHDirectory/mhl.format | Specifies a user's default message template. (If it exists, it overrides the default MH message template.) |
| /usr/lib/mh/mhl | Contains the mhl command. |