+.TH MSH %manext1% "November 6, 2012" "%nmhversion%"
.\"
.\" %nmhwarning%
-.\" $Id$
.\"
-.TH MSH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
msh \- nmh shell (and BBoard reader)
.SH SYNOPSIS
is an interactive program that implements a subset of the normal
.B nmh
commands operating on a single file in
-.BR packf 'd format.
+.BR packf 'd
+format.
That is,
.B msh
is used to read a file that contains a number
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
.PP
When parsing commands to the left of any redirection symbol,
.B msh
-will honor `\\' (back\-slash) as the quote next\-character symbol, and
+will honor `\\' (backslash) 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
^$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
-switch must be interpreted as a single
-token by the shell that invokes
-.BR msh .
-Therefore, one must usually
-place the argument to this switch inside double\-quotes.
.PP
There is a strict limit of messages per file in
.BR packf 'd
.PP
In particular,
.B msh
-does not understand back\-quoting, so the only
+does not understand backquoting, so the only
effective way to use
.B pick
inside