1 .TH MSH %manext1% "November 6, 2012" "%nmhversion%"
6 msh \- nmh shell (and BBoard reader)
13 .RB [ \-scan " | " \-noscan ]
14 .RB [ \-topcur " | " \-notopcur ]
21 is an interactive program that implements a subset of the normal
23 commands operating on a single file in
28 is used to read a file that contains a number
29 of messages, as opposed to the standard
32 a number of files, each file being a separate message in a folder.
34 chief advantage is that the normal
37 allow a file to have more than one message in it. Hence,
40 ideal for reading BBoards, as these files are delivered by the
41 transport system in this format. In addition,
44 other files, such as message archives which have been
53 As the only commands available to the user are
58 beginners to concentrate on how commands to
60 are formed and (more or less) what they mean.
64 reads the named file, and enters a command loop.
65 The user may type most of the normal
67 commands. The syntax and
68 semantics of these commands typed to
70 are identical to their
72 counterparts. In cases where the nature of
75 inconsistent (e.g., specifying a
79 will duly inform the user. The commands that
82 (in some slightly modified or restricted forms) are:
117 command which gives a
118 brief overview. To terminate
120 type CTRL\-D, or use the
124 If the file is writable and has been modified, then using
126 will query the user if the file should be updated.
131 switch sets the prompting string for
134 You may wish to use an alternate
136 profile for the commands that
140 for details about the
142 environment variable.
146 command is identical to the
152 supports an output redirection facility. Commands may be
157 .ta \w'| \fIcommand\fR 'u
158 ^> \fIfile\fR~^write output to \fIfile\fR
159 ^>> \fIfile\fR~^append output to \fIfile\fR
160 ^| \fIcommand\fR~^pipe output to UNIX \fIcommand\fR
166 starts with a \*(lq\~\*(rq (tilde), then a
169 takes place. Note that
175 does NOT support history substitutions, variable
176 substitutions, or alias substitutions.
178 When parsing commands to the left of any redirection symbol,
180 will honor `\\' (backslash) as the quote next\-character symbol, and
181 `\*(lq' (double\-quote) as quote\-word delimiters. All other input tokens
182 are separated by whitespace (spaces and tabs).
186 .ta \w'%etcdir%/ExtraBigFileName 'u
187 ^$HOME/\&.mh\(ruprofile~^The user profile
188 ^%etcdir%/mts.conf~^nmh mts configuration file
190 .SH "PROFILE COMPONENTS"
194 .ta \w'ExtraBigProfileName 'u
195 ^Path:~^To determine the user's nmh directory
196 ^Msg\-Protect:~^To set mode when creating a new `file'
197 ^fileproc:~^Program to file messages
198 ^showproc:~^Program to show messages
204 .RB ` file "' defaults to \*(lq./msgbox\*(rq"
205 .RB ` "\-prompt\ (msh)\ "'
213 There is a strict limit of messages per file in
217 can handle. Usually, this limit is 1000 messages.
221 is not the C\-Shell, and that a lot of
222 the nice facilities provided by the latter are not present in the former.
226 does not understand backquoting, so the only
234 switch. Clever users of
239 pick:\0\-seq\0select\0\-list
246 works equally well from both the shell and
261 program inherits most (if not all) of the bugs from the
263 commands it implements.