5 .TH NMH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
7 nmh \- new MH message system
14 is the name of a powerful message handling system. Rather than
15 being a single comprehensive program,
17 consists of a collection
18 of fairly simple single-purpose programs to send, retrieve, save,
19 and manipulate messages.
21 Unlike most mail clients in UNIX,
23 is not a closed system which
24 must be explicitly run, then exited when you wish to return to the shell.
25 You may freely intersperse
27 commands with other shell commands,
28 allowing you to read and answer your mail while you have (for example)
29 a compilation running, or search for a file or run programs as needed
30 to find the answer to someone's question before answering their mail.
32 The rest of this manual entry is a quick tutorial which will teach you
35 You should read the manual entries for the
36 individual programs for complete documentation.
44 This is best done in one of the files:
50 in your home directory. (Check the
51 manual entry for the shell you use, in case you don't know how to
54 command. If you've never used
56 before, it will create the necessary default files and directories after
57 asking you if you wish it to do so.
60 moves mail from your system maildrop into your
62 `+inbox' folder, breaking it up into separate files and converting it
65 format as it goes. It prints one line for each message it
66 processes, containing the from field, the subject field and as much of
67 the first line of the message as will fit. It leaves the first message
68 it processes as your current message. You'll need to run
71 time you wish to incorporate new mail into your
76 .B prints a list of the messages in your current folder.
84 specific messages from the current folder.
87 current message, or a specific message, which may be specified by its
88 number, which you pass as an argument to
93 display, respectively, the message numerically after or before
94 the current message. In all cases, the message displayed becomes the
95 current message. If there is no current message,
98 called with an argument, or
100 may be used to advance to the
104 (remove message) deletes the current message. It may be called
105 with message numbers passed as arguments, to delete specific messages.
108 is used to respond to the current message (by default).
109 It places you in the editor with a prototype response form. While you're
110 in the editor, you may peruse the item you're responding to by reading
113 After completing your response, type
124 allows you to compose a message by putting you in the editor
125 on a prototype message form, and then lets you send it.
129 commands may be run with the single argument:
131 which causes them to print a list of the arguments they may be invoked
136 commands may be run with the single argument:
138 which cause them to print the version number of the
140 distribution, and then exit.
142 Commands which take a message number as an argument (
146 \&...) also take one of the words: \*(lqfirst\*(rq,
147 \*(lqprev\*(rq, \*(lqcur\*(rq, \*(lqnext\*(rq, or \*(lqlast\*(rq to indicate
148 (respectively) the first, previous, current, next, or last message in
149 the current folder (assuming they are defined).
151 Commands which take a range of message numbers (
155 \&...) also take any of the abbreviations:
158 .IP \fI<num1>\fR\-\fI<num2>\fR 15
159 Indicates all messages in the range <num1> to <num2>, inclusive. The range must be nonempty.
160 .IP \fI<num>\fR:+\fIN\fR 15
161 .IP \fI<num>\fR:\-\fIN\fR 15
164 messages beginning with (or ending with) message
167 may be any of the pre-defined symbols:
178 The first, previous, next or last
179 messages, if they exist.
182 There are many other possibilities such as creating multiple folders
183 for different topics, and automatically refiling messages according to
184 subject, source, destination, or content. These are beyond the scope
185 of this manual entry.
187 Following is a list of all the
195 ^ali(1)~^\- list mail aliases
196 ^anno(1)~^\- annotate messages
197 ^burst(1)~^\- explode digests into messages
198 ^comp(1)~^\- compose a message
199 ^dist(1)~^\- redistribute a message to additional addresses
200 ^flist(1)~^\- list folders with messages in given sequence(s)
201 ^flists(1)~^\- list all folders with messages in given sequence(s)
202 ^folder(1)~^\- set/list current folder/message
203 ^folders(1)~^\- list all folders
204 ^forw(1)~^\- forward messages
205 ^inc(1)~^\- incorporate new mail
206 ^mark(1)~^\- mark messages
207 ^mhbuild(1)~^\- translate MIME composition draft
208 ^mhl(1)~^\- produce formatted listings of nmh messages
209 ^mhlist(1)~^\- list information about content of MIME messages
210 ^mhmail(1)~^\- send or read mail
211 ^mhn(1)~^\- display/list/store/cache MIME messages
212 ^mhparam(1)~^\- print nmh profile components
213 ^mhpath(1)~^\- print full pathnames of nmh messages and folders
214 ^mhshow(1)~^\- display MIME messages
215 ^mhstore(1)~^\- store contents of MIME messages into files
216 ^msgchk(1)~^\- check for messages
217 ^msh(1)~^\- nmh shell(and BBoard reader)
218 ^next(1)~^\- show the next message
219 ^packf(1)~^\- compress a folder into a single file
220 ^pick(1)~^\- select messages by content
221 ^prev(1)~^\- show the previous message
222 ^prompter(1)~^\- prompting editor front end
223 ^rcvdist(1)~^\- asynchronously redistribute new mail
224 ^rcvpack(1)~^\- append message to file
225 ^rcvstore(1)~^\- asynchronously incorporate new mail
226 ^rcvtty(1)~^\- report new mail
227 ^refile(1)~^\- file messages in other folders
228 ^repl(1)~^\- reply to a message
229 ^rmf(1)~^\- remove folder
230 ^rmm(1)~^\- remove messages
231 ^scan(1)~^\- produce a one line per message scan listing
232 ^send(1)~^\- send a message
233 ^sendfiles(1)~^\- send multiple files and directories in MIME message
234 ^show(1)~^\- show(display) messages
235 ^slocal(1)~^\- asynchronously filter and deliver new mail
236 ^sortm(1)~^\- sort messages
237 ^whatnow(1)~^\- prompting front\-end for send
238 ^whom(1)~^\- report to whom a message would go
240 ^mh\-alias(5)~^\- alias file for nmh message system
241 ^mh\-draft(5)~^\- draft folder facility
242 ^mh\-format(5)~^\- format file for nmh message system
243 ^mh\-mail(5)~^\- message format for nmh message system
244 ^mh\-profile(5)~^\- user customization for nmh message system
245 ^mh\-sequence(5)~^\- sequence specification for nmh message system
246 ^mh\-tailor(5)~^\- mail transport customization for nmh message system
248 ^ap(8)~^\- parse addresses 822\-style
249 ^conflict(8)~^\- search for alias/password conflicts
250 ^dp(8)~^\- parse dates 822\-style
251 ^fmtdump(8)~^\- decode \fInmh\fP format files
252 ^install\-mh(8)~^\- initialize the nmh environment
253 ^post(8)~^\- deliver a message
260 .ta \w'%etcdir%/ExtraBigFileName 'u
261 ^%bindir%~^contains \fInmh\fR commands
262 ^%etcdir%~^contains \fInmh\fR format files
263 ^%libdir%~^contains \fInmh\fR library commands
264 ^$HOME/\&.mh\(ruprofile~^The user profile
267 .SH "PROFILE COMPONENTS"
271 .ta \w'ExtraBigProfileName 'u
272 ^Path:~^To determine the user's nmh directory
276 If problems are encountered with an
278 program, the problems should
279 be reported to the local maintainers of
282 name of the program should be reported, along with the version information
285 To find out what version of an
287 program is being run, invoke
290 switch. This information includes
293 the host it was generated on, and the date the
296 Send bug reports and suggestions to
297 .IR nmh-workers@nongnu.org .