X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/1b5a1bd2244d3e1c12b7c9e1f48e445de5ad2ea2..4a78cbcd4fa986d9c1e7bd0a5a4bdb619faeb7cb:/man/msh.man

diff --git a/man/msh.man b/man/msh.man
index 89e52e70..66e29fbe 100644
--- a/man/msh.man
+++ b/man/msh.man
@@ -1,8 +1,7 @@
+.TH MSH %manext1% "January 26, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
-.TH MSH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 msh \- nmh shell (and BBoard reader)
 .SH SYNOPSIS
@@ -17,12 +16,15 @@ msh \- nmh shell (and BBoard reader)
 .RB [ \-version ]
 .RB [ \-help ]
 .ad
+.SH STATUS
+.B msh is deprecated and will be removed from the next nmh release.
 .SH DESCRIPTION
 .B msh
 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 mmdf
+format.
 That is,
 .B msh
 is used to read a file that contains a number
@@ -44,7 +46,7 @@ can be used on
 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
@@ -119,20 +121,7 @@ brief overview.  To terminate
 .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
@@ -149,84 +138,17 @@ You may wish to use an alternate
 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
@@ -257,10 +179,9 @@ substitutions, or alias substitutions.
 .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
@@ -268,7 +189,6 @@ are separated by whitespace (spaces and tabs).
 ^$HOME/\&.mh\(ruprofile~^The user profile
 ^%etcdir%/mts.conf~^nmh mts configuration file
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -279,10 +199,8 @@ are separated by whitespace (spaces and tabs).
 ^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"
@@ -290,18 +208,9 @@ bbc(1)
 .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
@@ -316,7 +225,7 @@ the nice facilities provided by the latter are not present in the former.
 .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