Produces a one line per message scan listing.
scan [ +Folder ] [ Messages ] [ -form FormFile | -format String ] [ -noheader | -header ] [ -clear | -noclear ] [ -help ]
The scan command displays a line of information about the messages in a specified folder. Each line gives the message number, date, sender, subject, and as much of the message body as possible. By default, the scan command displays information about all of the messages in the current folder.
If a + (plus sign) is displayed after the message number, the message is the current message in the folder. If a - (minus sign) is displayed, you have replied to the message. If an * (asterisk) is displayed after the date, the Date: field was not present and the displayed date is the last date the message was changed.
Item | Description |
---|---|
-clear | Clears the display after sending output. The scan command uses the values of the $TERM environment variable to determine how to clear the display. If standard output is not a display, the scan command sends a form feed character after sending the output. |
+Folder | Specifies which folder to scan. The default is the current folder. |
-form FormFile | Displays the scan command output in the alternate format described by the FormFile variable. |
-format String | Displays the scan command output in the alternate format described by the String variable. |
-header | Displays a heading that lists the folder name and the current date and time. |
-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. |
Messages | Displays information about each specified message in the
specified folder. You can use the following references when specifying
messages:
|
-noclear | Prevents clearing of the terminal after sending output. This is the default. |
-noheader | Prevents display of a heading. This is the default. |
-width Number | Sets the number of columns in the scan command output. The default is the width of the display. |
The following entries are entered in the UserMhDirectory/.mh_profile file:
Item | Description |
---|---|
Alternate-Mailboxes: | Specifies the mailboxes. |
Current-Folder: | Sets the default current folder. |
Path: | Specifies the UserMhDirectory. |
scan
The system responds with a message
similar to the following: 3 04/17 dale@athena Status meeting <<The weekly status meeting
5 04/20 tom@venus Due Dates <<Your project is due to
6 04/21 dawn@tech Writing Clas <<There will be a writing
scan +test 11-15
The system responds with a message similar to the following:11 04/16 karen@anchor Meeting <<Today's meeting is at 2 p.m.
12 04/18 tom@venus Luncheon <<There will be a luncheon to
14 04/20 dale@athena First Draft <<First drafts are due
15 04/21 geo@gtwn Examples <<The examples will be written
Item | Description |
---|---|
$HOME/.mh_profile | Contains the MH user profile. |
/etc/mh/scan.size | Contains a sample scan format string. |
/etc/mh/scan.time | Contains a sample scan format string. |
/etc/mh/scan.timely | Contains a sample scan format string. |
/usr/bin/scan | Contains the executable form of the scan command. |