4 .TH MSH %manext1% "%nmhdate%" MH.6.8 [%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
27 is used to read a file that contains a number
28 of messages, as opposed to the standard
31 a number of files, each file being a separate message in a folder.
33 chief advantage is that the normal
36 allow a file to have more than one message in it. Hence,
39 ideal for reading BBoards, as these files are delivered by the
40 transport system in this format. In addition,
43 other files, such as message archives which have been
52 As the only commands available to the user are
57 beginners to concentrate on how commands to
59 are formed and (more or less) what they mean.
63 reads the named file, and enters a command loop.
64 The user may type most of the normal
66 commands. The syntax and
67 semantics of these commands typed to
69 are identical to their
71 counterparts. In cases where the nature of
74 inconsistent (e.g., specifying a
78 will duly inform the user. The commands that
81 (in some slightly modified or restricted forms) are:
116 command which gives a
117 brief overview. To terminate
119 type CTRL\-D, or use the
123 If the file is writable and has been modified, then using
125 will query the user if the file should be updated.
130 switch sets the prompting string for
133 You may wish to use an alternate
135 profile for the commands that
139 for details about the
141 environment variable.
145 command is identical to the
151 supports an output redirection facility. Commands may be
156 .ta \w'| \fIcommand\fR 'u
157 ^> \fIfile\fR~^write output to \fIfile\fR
158 ^>> \fIfile\fR~^append output to \fIfile\fR
159 ^| \fIcommand\fR~^pipe output to UNIX \fIcommand\fR
165 starts with a \*(lq\~\*(rq (tilde), then a
168 takes place. Note that
174 does NOT support history substitutions, variable
175 substitutions, or alias substitutions.
177 When parsing commands to the left of any redirection symbol,
179 will honor `\\' (back\-slash) as the quote next\-character symbol, and
180 `\*(lq' (double\-quote) as quote\-word delimiters. All other input tokens
181 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
191 .SH "PROFILE COMPONENTS"
195 .ta \w'ExtraBigProfileName 'u
196 ^Path:~^To determine the user's nmh directory
197 ^Msg\-Protect:~^To set mode when creating a new `file'
198 ^fileproc:~^Program to file messages
199 ^showproc:~^Program to show messages
207 .RB ` file "' defaults to \*(lq./msgbox\*(rq"
208 .RB ` "\-prompt\ (msh)\ "'
219 switch must be interpreted as a single
220 token by the shell that invokes
222 Therefore, one must usually
223 place the argument to this switch inside double\-quotes.
225 There is a strict limit of messages per file in
229 can handle. Usually, this limit is 1000 messages.
233 is not the C\-Shell, and that a lot of
234 the nice facilities provided by the latter are not present in the former.
238 does not understand back\-quoting, so the only
246 switch. Clever users of
251 pick:\0\-seq\0select\0\-list
258 works equally well from both the shell and
273 program inherits most (if not all) of the bugs from the
275 commands it implements.
projects / mmh / blob