BSD 4_2 development

Work on file usr/src/new/new/mh/man/scan.1

Synthesized-from: CSRG/cd1/4.2

diff --git a/usr/src/new/new/mh/man/scan.1 b/usr/src/new/new/mh/man/scan.1
new file mode 100644 (file)
index 0000000..4216108
--- /dev/null
+++ b/usr/src/new/new/mh/man/scan.1
@@ -0,0 +1,64 @@
+.SC SCAN
+.TH SCAN 1 "3 August 1983"
+.UC 4
+.SH NAME
+scan \- produce a one-line-per-message scan listing
+.SH SYNOPSIS
+.B scan
+[ +folder ] [ msgs ] [ \-ff ] [ \-header ] [ \-help ]
+[ \-noff ] [ \-noheader ]
+.SH DESCRIPTION
+\fIScan\fR produces a one-line-per-message listing of the specified
+messages.
+Each \fIscan\fR line contains the message number (name),
+the date, the \*(lqFrom\*(rq field, the \*(lqSubject\*(rq field, and, if room
+allows, some of the body of the message.
+For example:
+.nf
+
+.ta .5i 1.2i 2.6i
+^ #~^^Date~^^  From~^Subject\ \ \ \ \[\*(<<Body]
+^15+~^^7/\05~^^Dcrocker~^nned  \*(<<Last week I asked some of
+^16\ \-~^^7/\05~^^dcrocker~^message id format  \*(<<I recommend
+^18~^^7/\06~^^Obrien~^Re: Exit status from mkdir
+^19~^^7/\07~^^Obrien~^"scan" listing format in MH
+.re
+
+.fi
+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 \*(lqReplied:\*(rq component produced by
+an `\-annotate' switch to the \fIrepl\fR command.
+.PP
+If there is sufficient room left on the \fIscan\fR line after the
+subject, the line will be filled with text from the body,
+preceded by \*(<<.
+\fIScan\fR 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.
+.PP
+The `\-header' switch produces a header line prior to the \fIscan\fR
+listing, and the `\-f\&f' switch will cause a form feed to be
+output at the end of the \fIscan\fR listing.
+.SH FILES
+.nf
+.ta \w'$HOME/\*.mh\(ruprofile    'u
+^$HOME/\*.mh\(ruprofile~^The user profile
+.fi
+.SH "PROFILE COMPONENTS"
+.nf
+.ta \w'Current-Folder:    'u
+Path:  To determine the user's MH directory
+Current-Folder:        To find the default current folder
+.fi
+.SH DEFAULTS
+.nf
+`+folder' defaults to current
+`msgs' defaults to all
+`\-nof\&f'
+`\-noheader'
+.fi
+.SH CONTEXT
+If a folder is given, it will become current.
+The current message is unaffected.