NAME

scan − produce a one-line-per-message scan listing

SYNOPSIS

scan [ +folder ] [ msgs ] [ −ff ] [ −header ] [ −help ] [ −noff ] [ −noheader ]

DESCRIPTION

Scan produces a one-line-per-message listing of the specified messages.  Each scan line contains the message number (name), the date, the “From” field, the “Subject” field, and, if room allows, some of the body of the message.  For example:

 ^ #~^^Date~^^  From~^Subject    [Body]
^15+~^^7/ 5~^^Dcrocker~^nned  Last week I asked some of
^16 −~^^7/ 5~^^dcrocker~^message id format  I recommend
^18~^^7/ 6~^^Obrien~^Re: Exit status from mkdir
^19~^^7/ 7~^^Obrien~^"scan" listing format in MH
 

The ‘+’ on message 15 indicates that it is the current message.  The ‘−’ on message 16 indicates that it has been replied to, as indicated by a “Replied:” component produced by an ‘−annotate’ switch to the repl command. 

If there is sufficient room left on the scan line after the subject, the line will be filled with text from the body, preceded by .  Scan actually reads each of the specified messages and parses them to extract the desired fields.  During parsing, appropriate error messages will be produced if there are format errors in any of the messages. 

The ‘−header’ switch produces a header line prior to the scan listing, and the ‘−ff’ switch will cause a form feed to be output at the end of the scan listing. 

FILES

^$HOME/mh_profile~^The user profile

PROFILE COMPONENTS

Path:To determine the user’s MH directory
Current-Folder:To find the default current folder

DEFAULTS

‘+folder’ defaults to current
‘msgs’ defaults to all
‘−noff’
‘−noheader’

CONTEXT

If a folder is given, it will become current.  The current message is unaffected. 

4th Berkeley Distribution  —  3 August 1983