+.TH MSH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.\"
.\" %nmhwarning%
-.\" $Id$
.\"
-.TH MSH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
msh \- nmh shell (and BBoard reader)
.SH SYNOPSIS
.HP 5
+.na
.B msh
.RB [ \-prompt
.IR string ]
.RI [ file ]
.RB [ \-version ]
.RB [ \-help ]
+.ad
.SH DESCRIPTION
.B msh
is an interactive program that implements a subset of the normal
other files, such as message archives which have been
.BR pack ed
(see
-.BR packf (1)).
+.IR packf (1)).
Finally,
.B msh
is an excellent
.BR msh ,
type CTRL\-D, or use the
.B quit
-command. If
-.B msh
-is being invoked from
-.BR bbc ,
-then typing CTRL\-D will also tell
-.B bbc
-to exit as well, while
-using the
-.B quit
-command will return control to
-.BR bbc ,
-and
-.B bbc
-will continue examining the list of BBoards that it is scanning.
+command.
.PP
If the file is writable and has been modified, then using
.B quit
profile for the commands that
.B msh
executes; see
-.BR mh-profile (5)
+.IR mh-profile (5)
for details about the
.B $MH
environment variable.
.PP
-When invoked from
-.BR bbc ,
-two special features are enabled:
-First, the
-.B \-scan
-switch directs
-.B msh
-to do a
-.RB \*(lq scan
-.BR unseen \*(rq
-on start\-up if new items are present in the BBoard. This feature is
-best used from
-.BR bbc ,
-which correctly sets the stage. Second, the
-.B mark
-command in
-.B msh
-acts specially when you are reading a
-BBoard, since
-.B msh
-will consult the sequence \*(lqunseen\*(rq in
-determining what messages you have actually read. When
-.B msh
-exits,
-it reports this information to
-.BR bbc .
-In addition, if you give the
-.B mark
-command with no arguments,
-.B msh
-will interpret it as
-.RB \*(lq mark
-.B \-sequence
-.B unseen
-.B \-delete
-.B \-nozero
-.BR all \*(rq
-Hence, to discard
-all of the messages in the current BBoard you're reading, just use the
-.B mark
-command with no arguments.
-.PP
-Normally, the
+The
.B exit
command is identical to the
.B quit
command in
.BR msh .
-When run under
-.B bbc
-however,
-.B exit
-directs
-.B msh
-to mark all messages as seen and then
-.BR quit .
-For speedy type\-in, this command is often abbreviated as just
-.BR qe .
-.PP
-When invoked from
-.BR vmh ,
-another special feature is enabled:
-The `topcur' switch directs
-.B msh
-to have the current message
-\*(lqtrack\*(rq the top line of the
-.B vmh
-scan window. Normally,
-.B msh
-has the current message \*(lqtrack\*(rq the center of the window
-(under
-.BR \-notopcur ,
-which is the default).
.PP
.B msh
supports an output redirection facility. Commands may be
will honor `\\' (back\-slash) as the quote next\-character symbol, and
`\*(lq' (double\-quote) as quote\-word delimiters. All other input tokens
are separated by whitespace (spaces and tabs).
-
.SH FILES
.fc ^ ~
.nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
+.ta \w'%etcdir%/ExtraBigFileName 'u
^$HOME/\&.mh\(ruprofile~^The user profile
^%etcdir%/mts.conf~^nmh mts configuration file
.fi
-
.SH "PROFILE COMPONENTS"
.fc ^ ~
.nf
^fileproc:~^Program to file messages
^showproc:~^Program to show messages
.fi
-
.SH "SEE ALSO"
-bbc(1)
-
+.IR packf (1)
.SH DEFAULTS
.nf
.RB ` file "' defaults to \*(lq./msgbox\*(rq"
.RB ` \-noscan '
.RB ` \-notopcur '
.fi
-
.SH CONTEXT
None
-
.SH BUGS
The argument to the
.B \-prompt