X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fmsh.man;h=2416d7a5fcd0afb6afc649ee17ebadf895a6094a;hb=5e5e8b753acc7ff1e16c7fca172a2151a6c01353;hp=2f01f6d246764f0c102d162d94f87889aa1801c1;hpb=278a48ef53b5dde10d7c88f67f51ce15ad11c0c0;p=mmh diff --git a/man/msh.man b/man/msh.man index 2f01f6d..2416d7a 100644 --- a/man/msh.man +++ b/man/msh.man @@ -1,12 +1,12 @@ +.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 .HP 5 +.na .B msh .RB [ \-prompt .IR string ] @@ -15,6 +15,7 @@ msh \- nmh shell (and BBoard reader) .RI [ file ] .RB [ \-version ] .RB [ \-help ] +.ad .SH DESCRIPTION .B msh is an interactive program that implements a subset of the normal @@ -42,7 +43,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 @@ -117,20 +118,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 @@ -147,84 +135,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 @@ -255,18 +176,16 @@ 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 -.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 @@ -277,10 +196,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" @@ -288,18 +205,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 @@ -314,7 +222,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